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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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
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

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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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
zcmV+*5Z~{KP)<h;3K|Lk000e1NJLTq0021v0021%1^@s6j2MH30008WX+uL$Nkc;*
zP;zf(X>4Tx0gaQ(YZO@&hrjCFppYO8w69(amsv=VB$N*{B0kbdY@)Gk%0!bONT>RC
zcbS{&np@Rz6cNeBrOq&W@v(5>AK=1;E8Qp&d?AQ?6-5->sI-gfbXV|sR$u+jxxaJH
zEiQE0#URir33GmAoLp8;PEE@d&q%SJE;4i#-7pv|6vhCGL7@32K0d($c-Z&-{7<8+
z6uNU@t%TJ3k_uhu_zcu4lT*_mG>|?S1rdmIK-$Fm|3G>s=IcP(j5|XhZUL*@z(gSK
z0RwKeSb|Og^i~ozGYOv4b+<XsA3(SACk_J}Aaz!SBTcpzO2y#=KtEWoN@{on=mqO~
z+1ob?^Z?JxX5U22)<!QH9gjJ6#Mk+;Ca?2n@`sw9B8alil7BdVcw|XGQQThuGGIBg
zwF3^Y22y)ZSI3XWZ0Xb0p?s4cnYuFp`~|6Nfi8^2v!(7Zg+}4wqwtY9<jB%TfT2bi
z4-bt;4uy}x;1M$W-AYX%!IB&=@p*~C<8SIHBo0T&=2_@%IY|4d{l<Q5U$(E=uP<im
zJ?+ebIqtcO7v51oVOqY;Y;&gA-=)SN8chYoTx+K=F==ADvVSqtc5)Xlyi@1%9}`=u
zM5jJxP=w54@R&!T2~i9ty8Y<(6#DL&TkG1r9*djD9(Lb7v+S;F-)yB?TP^=?*Co#@
z@u%1%M#X^GffRehUa?yYivh7yjI~Zo;Nx);g(0Mf#^)4r+5cOrC4OrFq;tww#&e~U
z%gTbOl|8KzPxKe*-;BwrX&KXW9d3lMc57Sv;9vpPn#Hyj9fVzPq2obY>&d|COK@|W
zTQ~DfYs<P1k@_bB7^(%Qj8~~fa<gr3mxDo|l^pfm{$5$sS{koXjY4TusLZ@7^%Iu2
zY>r*Jv(WjX(fF_dR{RHF{%tfqU1>DFT!oJ3a9e)`&gs+100009a7bBm000XU000XU
z0RWnu7ytka{z*hZRCt`-S_fEER~G)?R2Zs=f}k-rFeWNuqU+l7u^M%w?rK2A#1>0*
zjZv1kVneZ_sMsN535rx}qDzc1+1Pv3pjc2T(tC4Y>Yn?CYQO*wcJp!h28R1?IsZNV
z+{Y!xT-2kPH!dmWQu7D-;{N644>I||mF5pJCH7jAgJc_UuY51xl&f(@<2Ek!(Tyer
z$#EQHG8xorHUC{Akw8_df<!7|52046nsR#s4QY>WH5o_-s<^lqSAV_)=YH=&RZ@!B
z`>`1C{y@b3`T#0bDSG#PkGQI@WNlN>kskL;lPxbdGD7ISV0f?a#q60=P@vTy;$Q@}
z?%IT)oqLe{A_bABB4BUd23n1_smK7A@$7D+fz((0GBhJ&V+8v7BVcO)MvonZe6a-4
zr=qdK+Y3hyg(D?34F@BF(Z#VdiL<7Xs76*)E;BwxI7q!7BC!Zk(mk$<DKS<UW5>D;
z@b}#gSND%lKp;;XI|<+QD~ZF0kn|!MM^8n;!Lds<kUE`?M7i;FmCH(aAQ+@XB1Ud*
zF3v@tMM`=G%5A2Yj7!XwtGIjRIy$}86&hmEvnO%*)1dx%d@lw?Ma3BAItG?4t)SED
zc-@qW#OTqZ8~P0%$V-J@FPsNlPSQg`tBAw|FeeA|=6NFa;#F{>3XF`wFp`QPC$Ji(
zbJW4CYDuXYGU^u*=%Nxew1lRd{~U2qD>uf>d9yM1i#fz$Ej<$kl*>teB47nQj7jhI
z?cRgUK5JoRrufat8}zh#AG5mU<9PArs!!0<|D_6ZM4bpnyEoby4oE=b@=~7)IwoVX
zpi8}1<M`fvu#ijZc;;2ZgBpmUPo7MHkkA8ga_R{c`B)*1%TIeQ45YCUmU*wi(LF%~
zQepr}oYK)3G0!pGt6PHg)cmY$1fk5AnII%A7(EH3(13v}$VhA;NIfrhrWO`h?6n+G
z0fDeEl9IpEKqObd*s3M+(o!MTt09$0dGXZIhZD=8u(n2iW(GvWA*odK8xdz93mC}o
zLvZRvoKy+qWMNiPgFuSO;AqJxeE;2d*u8NJG85x@F*CEULf;Smg3+#Hq0wrwZlM=4
zlaq*WaxwI*|KI@_Gr<ianH(DyE=EFJ934V+(JcpgI3ff+dpVKu5y;8n?BsfbWEM3m
zGYgC6ds4`D0j44yafGaFsSe(LzOb-rfj8Q<h4Y`^$M+|XVD6OZ;7H_Vd3wO1s{`!Y
z*`xQMp}2hZG^T$v4hnKXRYjLcNCD|&XjCY1(n+|u7U!fk0Hg>7`T1DCY8|4(qafw9
zkQ1RQGJ?)7E@;!S1MkeW#7Sj-0j@<yLrboqd;k7u-?b|rvoedRQ5NI+H{U`-0IRx*
z3Xn&_%0LPf*Oz(e4H8$8NW=#L=g<9w^~+Wu?fFx3<Q$ZY`0^D=*O-AZCN499EFtl(
zB$uKj>Q&IQ-w?$>l3s@$35Sz&FX14S`3(cf4xZ_b+}sk&y_O(s`;H3h`l@rNy20z7
zRg7UeDK|xUIY^;8sVvA8<U&{wzGU$-MDE&M=|Tjy3Xn%5%0LR_WJ#egkaDA@0~v8F
zvT-;m7$oDQR}+Hl-AlN2{Ud`scKQUmJ3B*1)>vJtYH&e_KxUQE)iCm!1|$bHCqbW~
zLt);^8Y70dz-8D_ayy#epIm(<@R3<@PO_dOcfcYNc7$AcTF(B~A(v|kko@+vcWzM$
z^0j&l`EWQ6Q((aSZmnQ=Jcix*Fp+#O3o!H)L~})%@%rk6IUX<%ma7EM_g5WP0g|#1
zGCUED$w~StrTs?y?eDO*wZYI)AEHMuXFe`2m$>p2j*pZoK$ZVrJ@DrWtAVW2sue~n
zxywTpab<lXC=|rWr7I{v4}gWNu{g;x6%KaY-iE}~41XQ*0j7OA*&wbAh@oU)_;3|}
zYSme;Fr#6qR{10a<K)s+I2sfLbGfYXDvPvGCSg)iI5=wL2m}OfgGQ%qkm=wG(}m=d
zdOjEk3qFjco{L~(YK)pQ#Ci}!Y*A}<FtN14V&By;HZg&NLl;<Ex8w_44O%ll{h6>D
z4~cMTX(^U^c;U<sKSIPrs-Y!CqC`jQDJTtFvTh|Nd_0a9QTEYl8-9FTL7K4g2Wu=?
zXN26ja}POLSrCF!Bod=jmyYP%xl^?=rI5zur^X2e$rfN7l}e>#kgHzj)SDcBrjA^N
z!N>@utZdc%6d~2Rs;#aiECZLT=8rY?HRgR6mzVOW9w0eZNe0I<c_vEQ`iT=W^)lkN
znC5F}zPfC_Od{hGaTNvP%(&DQ-s@|ARjAHQu3K@LlNherl=os$eETj;`}T&BV`u2=
z43xx~*0^=+HezC8F<?MHbm;gdUn{zP{U%-{rC{*j{;;sLsGAjK2gY0$v&O%ZigCF~
zv9ATm9Ir?&M`?T_GByQ5os<T}0B4xI*BfR7`x;K3k2WeVSNVvL{nAw~%?SGL^cj4$
zHyEvKS|cYT1L5Ic<6zJMT)uV-cOE{5=iHh2c<LmSl$2CCn#whSO75|H&aluZh@=vX
zA2)_F6-}*N<#H15*9ww1C`NJ=U%H9p`Cc$}830=!FXS9P3f0pj*sWazO>Q2<rX~gv
zE~|9w3Apa15@It`a3qFw5-7|ofcwPhSnj<DJ-c^<$Belc?lu-@&;5+mE4?sn#yof|
zn1dlhT@3N2h~vv1d>ND06cZ>NNsV65@z%VQGLzvSy5iHx6ES_pWGIy-wS&w`sQp$;
zB$J}#!DA#&oDEAlt=8TPpnj2x_zAOM=eGj-VkL5qokp9L3!zQVhOF}&;OJ0tgOB0m
z{rj+8_&GG0IWXzk5qIzY3ePW>;nayRJSVB}U9%CU3I&$=EXDnp2UxRqBaR&pg;h%{
z66rh0&C5ssetjSz9hMTePM$c0Gjt$+>sRst$dwD1u<&2YvHw6I9N%)_gZJ9<2`(%C
zUd@jvFxQi;Cyt*3X?q*k@9+gjo27aCL3#5Y+Mhazv}Nm{j!%KKl?`5Ay@{6poPieZ
zV~{laOG6DvCx-HN4BD(;2u-iIvBAd|-abokJn}ev*KL8X-)gu`bj2qVXQFjWOKjP`
z5rMn+A~fO{+S=P;^zb1V>+T9Man57@B4lOfAUHS>NiS01HD>{`bMoLmV-nol-S{!J
z-GFhK&uhMf6&cBp7x`~wuJ%X!llvia?118nWFW@RMr$8WSWFy?gppIAD^;T1fo;g%
z7Xp!qDXjl774a_a5ZhV7e$OVP6BwiJZ===hDNq#@@;W}rZ7QrREfIL=D<mf-VeHsX
z;P1a4-MTqq)M$5X-n0hK;-15Z^myV_cf{U%0H5V+kWL`C?ev4AqXXQ=O@Ygx{+RQ{
zXZ$+|uWMY!vzo8dIhhQp9^S+eG1~6k$ct^ps+~~BC7^BiHt33rku>I0*zQ;d6EZ-F
zZZl!MXfElX7%9^i!2WO`WbN#b=sF9w{woM*SIEd{Ub=W0b7sxQ!H~V^)9+n`9zKGg
zuMXgwZ^Llw_C2gzvI-twevV5we!;RO|KwA?)jk_Aa>Nj<+O!iMb7#P*$2%DBJ{>!D
zY($Tq@1R7f<aM`Jkm+$XzZfARkSX(*LY<lkt7#MP^2!ZJJ9R+e>F?2I^D5-+i$u}c
z3uw9cGn8Dv4Nc)o*ev=SnZCPF`XCNgp3_lu<|i^f7O?!-6{_b6upBlBGiT0+m8mKG
z{MYg!TtL8noI3L(f_7~{bo3AK-?AHyT{>X{iL$~}fvvt<komF%qel#d-`Y*s9_Wwr
z|G9v}!4WtR8ieeuY_zs%1qaegO)X&{m-ggl%^=BImc%?nZpcxHEzQwl@^}`cBKKev
zILh&gqP~T+tsTT2Y-ud{P!ltVD7P%!9|^hBTM*f{<k#TLElDbjU_Q7HO4{0B*N#1y
zG-*8Azxf7lMKd$A5E6O>ax%gWT{`pEbT@9^K?`#;m=MSoEi4f8@F^s$NKLNHl4$AF
zxg+8dl2Ab6+s3{PMvNQ=GqU75T`fA9_V{|Od^Q9CB0fphmnEzs(i2s38j`1Zz}9a$
zjC*xAJR>(z`sf+b<}QZa*IOZbvmNhB^rSDmdtnRGNi$c#^io$=%3$t*ML}v>g9Qdm
zJXzez+=rB`JF~9kW7#uiMcFv!Ewx(195z?~ngD`JeR#EAu`6>C`60)VA9ez5BLav^
z65i>v{_M?rp}c+z_8~hc<YSu(xRQM(&VMzkt!qffk57rM-wT9{yTuo-LH|+(lVJma
z@(LQAXwlj85GzbzJn&tfYk!o+y@)wqzbu4}CNbjg{i_yz%lp|^fo1*1Zd}5h9~+Qr
z)g~<e%hv+y-ni#C&oud4lK=0<J-v3i`Gb6N`DF74`RKyY<_|LV=g8&{^8Qa@%^zgU
exx>vK<bMIIc-2Z3`}Dv70000<MNUMnLSTYj4b7VX

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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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
z-`iN(_SElYAF46q7~5+2k?&wFzkwW|;@*vO`o>XzZWH^ioqhj*>PvM3HCTU=#AIr;
zPnl!B(N~Q9F4i%Y-m7lE>zjS`sQL8m|Ir>1BWRK*MK<s^LB0k0JD|S>@;$JL{r5kZ
zlF$=HI^=JH<G(fb!R@=?);B*hrJE-Gq@?eIr@r(}kZ*(e``}LB28;9z-vZAz-wJDD
z>3lat3%1U6FcV$6Dbjz!(tC7>%DY$Z!@~Rim-2}!c9lP9l0{6dyXn#^dyeM@=ULth
zV(5HpmUM%yim7)()!Df7{MY$;>nz<kPYd+H8Cy*G7QYKQPjjy3jIH*jj~LR)(c~M!
zmL&HQMdP#wsNu#_{LMa;;~Tc(PMC*p=!%2&0p|TDkk5IMpQwttarVnG_*UTBn(CYh
z+Q#<%#*c4kzd;rBX#qOykk*NVl_=V`nIRwjT7ouq_d_?1EfMcn=j_UVLLT>HUYMUM
z*h7;&tGx?FZG1DvC+C^#ciK~VPPS~o{SD*5cE{!Z-}IyZt#8+uMdZ1yF+a=^*Ioqk
z!2B>L+}B(8JNG^J|La+xHg^0iAb!7rInRFDz*s9_Y}2H}47Mb-!Vv2M_Uz|+nFr6O
zB{nmqn=ZWs<VVLggDp9##`q<hX#AcLJj=US7qH_eZV39618laFm;6iP7}_voYr^&1
zBsHE8*Tp$!MK(C?L)UI<%&8^okn#F7*-eqonzFXvP!$K>AM7P#8-8*vLH;SIX$h`v
z3+9G7T7voNg1KgHw_qJI*hcsZe#JNSCErk9#yDYY>Y%P7y6yv*>3(qSEn@Hy!*gbc
z7Ls-iAAaJ<Nq??$Yb>tMYebvzt9;ZzOjCObBsThzgIqvfa2ucf_GLeD)X05aITP@^
zQNJID{$37C(C%Vmm%r-o(Ot|#V#7xc;+mk3nbJ*{UPR81Zy%7udGOPxs-_u#<1hSu
z|Nr?vx!H)}`w-L%_GP&gmmzN^`*Ob;<6tA^sUCd9Y<=tEyH^o>1M8v+zKfY5J%c^B
zZ#przIBetx#+rh$sR4%Ag8HVenSH>#cflHL!TK)2db92@gQD{#&?bgHuN=xn-Xa*6
z@lUYB6vQ<##HNqxp{AxhKy4@X75Rvz57Yo1A8}i-m#B?vW1n#y)IP)(+!H_>dyQ-2
zx^gTro%=@=y*Ewc44v50p>n@*wieubg)??AC3y#D3O@CthSwUz^_|znH7#8a*TVcy
z)x$VV{cAjjkmR1^6h%-2anxD@`rhcW-&m@RdD@K2JjPrN)xw^kZsxfNYGm%skd7Vy
z47di*bB~<l1={2#p1#g=lgvqGrZ(}6yG2pXEw~P@k85Wxkbn(e6VyPw>C(*%JGHxh
zZ1fwVMlSN5OxYNdbucZh2k})<2f4_(mD|t;d@CTHep8T}eB|DOHSdD;2lfK6FQ(Xn
z{bEM!p(R=L?tt@s!aL<1TYhMIHx01_@3<Sh<IK&UZH}Aj!+SHs`x3?%IQGxV5;c6v
zGoq$_)b`ZR@u#H!$r(eN7|v3rbEbM=$!>CtZ8w?Y&>eHy?L$^UZB4L#tR;JceZ<~l
zkFtN++uT#!uT#A4G1=J5>{<3Fd$V8mAp4EIMt;U&JjPvu^W@|VsWao??>+i^5Puuu
zzaM`BKM-3FwsHWupotPpjlno8okyGWt?>=*Z*Y8;Q+c2#R#lB+a&G2Y1=l=eD~cn2
zKX9uf$I`bSV9T6-w{y(CjPJ4SBfg8Jx}iiH`x9HfcX*6<@~Qv3KK6}RXUnCwvF%AZ
z?yr#kEyUh?$GbTDEOQ>)ZqoJpI_t6D^Zd?O%O+U@>q~1sv~T^qK(e2^?8M9q*xym)
z|AwV8h(rE_uJ}*Xh(W&YOI=eDE1ri%&n%u@JQsO(aosb~r2}^BSz_mT=V#tjoBYh(
z2)5)C)b&J9zO3hX=gqdP+y6<9RPQ(XQ$EIi@@0D-1AA^~y&XQ<+2;07WKoX4l5^}c
z_v!z(J<_#*+lRRFB{|mlM;dcWzma2ZdQ-nA&iJReo4v$!-F(=_n{m%RC311Uau4%7
zcmjV<_x1cAwG;jpxc;deVhFwmn*9$wQv$vRmSFu|@dsUPs3EOCeIIQ4PPo%|K=gT`
z%a$o>XZQw~vCp;<|89`)f>X5gO>pTf2l<<zb?jYio#TdR4;0y_&T;(>RldyPtS81B
zw%&(R6wU^}6f0`5t9(I|gc2<6j~;BT{Ro;Q6ft>Uuy1&Gh^hBT;Vi5(@(^3+<tbW7
zbZj;J#Gqp%X6c*_CE7W5DURIGKQQJ0Ddar+Y}roEm>#v9_FH>LKIX~{>9GC;UIXWF
z&Qsz)ZA~_CZAjZJ$EDwr?Swj@Cv3BQ%E#V0VNZ=<ha`shoWpvLG4K=D1pR8-x9CGQ
zV!5s&*mFp(4Lg4NvDcS4_dot37^g{+^Nhnr95LjqA!%<xKV%o4vl6})IlFTFRZQhF
zz8>!F6Z@XzQ@nGZvTNKbxF#4uljQnm%mLS4HUF=5;J)WKIDb3hZ%O*iT|^hO8$LY~
zcoyVmKw}NX6kCw*9V6{m#)mGZ*a3CAX5<oFkFS$?@|+CmutTCZQ3Cq(03AF25o}3t
z8%djIa}Snei|04b@%;OTXTIC`V2UQ_M~*6X<V6nAM6S&>B5Q(niFo>D$boMv#{HNp
z=By<=uSn+E*q&q2=?}I$j($BTlCaWxqO-oHN;lY6^3k@Bee(n{#4f?uQ@BRviEC#L
zn2RB{V7{66C5qO;&<1=}Y{fRg+>w*qj8QHyK6T_er|ND&k>tLBE~?;OG1!SG2l=;P
zj+fv%r~yfvT8JUGrg-f1%S^SqSP{z@)RJ*c)CIJgVs=36pjO@cOMh!#`kVREcND(K
zz!XJ{zo{O9Y-$tJ_}hH^t*+_sc0*L<Fgt8TvMY|*SAO*yg8oR`EQzC!^O2`T4&wP6
ze-T4980rDHku~wozM?NVp?`_vEu9CM^GxO23EEu{SB2-9d1bDb<`}xDV*jVEOEggu
zw7+2}&TQ#9=V@n5YM`!Hjhb(-1#2+1HmoJs&U)`yBi61RYc!S5*M>aVvJH*Ld;q#B
zF;~pl4#*Ge1w$J@anKV*y7N}$2IogEK|DFQuEAc@HSzao-i13r$F}6d4@GV4yeF3^
zx{ta*8rn11l0dr$w5#5+yn_p8?|^o;5x1#<xu({1UAOCDZeFqUQD1Vs-s8&Obk76r
z9^)Ymu_LIG8R~fD)Ad$CO@lE+IhZj|Rg!rHYMQZ!*e^?UW>|v~ar7hS7F}b(K$o37
z#M1Y5tz2(F+t`L&f-$F{7V@{q%{6gtFyk7FB<sq!HO8i%seXV?e<U@L50-KRI=+El
z{mIu-Zfs95-j2Ra@`RiQUkT7{-_ps$7#@3S{4H2hud(Hlt;9aqlHMo0BVYwp?-Agg
zGDUvpWE~$d8OJx?J&7IfB;I@dhwu(8dKaEF*-oZxf0q3r2V?%(G05RO*0Y>3#+E#>
z@0~pR(5{?Gf+2Zg-zRy?ZQG3N^0|e5!2V!=P3<}MAp4X3%D&C_0egI=`wX2u-eN!V
z{PMnKuh!UmNSKVnc(GroX>qpF`D=1E)S15VH=g)g(UOG1-<B@eZ#kl0m4vNaGazpf
zOJj7gbv_;Odx3K*<3mr-#@8OeXB<PDexnMmP1nn{Gap<(?WXI-H#v7Ijxjx!^WCJ!
zc#^k1*lxMWfe)Fv*{F|m^6R;vYv`hC4Ou&`ll-4@WdErT)c~jcUEA@<C$@ZmKTF$B
zxfBQE;Iug|OaB%{vcJAzDlX$b*@kZWH?k`JhHD+VwkCG$x!2mVz5#2A&(JQSYMo#A
zYCNZk_QQ~^%SX&kIKOT9O_%<TBL62AwfrVS{h$U}e?5nEU0hq$-ZnjSKSPJ+z&bJb
zm!Mw@rX=hya4nx?&h-?VWBw|A#<iT1{MfQYe}Y)Ze%nraj<KF&v)&>v(v+mz_D&N2
zQ=IRqpZ%7^p<7y~ZLq=oH{txJEHQ4j+lD+L?q<XO#C+p>>Qml~gYT)|&3?;u=AgZJ
z#&J&3S%@=E)9;n4-!5Cf`2f8O?EH=?Iwv)qedx3GUabEk`A_+RCTWUvz6JK6O0K{E
z!H{fUu=(bfn9{o_iKXv*FdnF~e`4#K-xE_lXrhRv?}1%Zv2|7(0s0O6O%yS8R_k$Q
z<J`75rzM8;PgKQhz58G$nsg`$-i2M%cn^+W${#dIC}LK{i5e{JjS;lidt1-_nRvYm
zINz~{cu#0Qz!Xgsv9wR1vtKw91|#XOy_D?ujN_5S<=AYq57~c{b@ZcsLhdRUyNRi@
zZs+_Tpc`z1-wFKI6@%Xz{N@nE4D}};V=!01yq!$ho;YLOE-4TC4aUu5yM4->Yep?C
z<+p9ic7wg){ec__`>+-5E%ua|vDav?$icX|KH5`|C+DE=7T&u^^1NaqM~Qyq#z(yO
zJd!@x@DW2_ljE1-fcTf4ysRnf8~cL2Fa`UDddW9q%>AV#{^Z-f)CS`L`z@d1Y<Jw#
z__@xmx}gZqW7YMucC6)VPBb^XSC;OP$={H~;`g@XrmcGhKXceLhxB2Np$qbyu)c<|
zV2T}3!w9I$P^W92(s#f$FTrz?=cS*Y<JTWL&ry8D3_(17$>BWM0Do01tY~{2r2XXF
zf@e6-a-QwC=X`$d6Gwa%^c|v!BBsXcq6&}OqNY<)2eu(rfR240WLuYyxnypu@O(4(
zO_TtA3*v~sfv<|GIO3lu@<HAMwjo<!o8zkX4SNYj&?KP*>^Y#l1%1i4MOSSl=7PDp
z%~O+~m>a%ke8kO=w8_mFBWj--w+m`s)R7p}rW(6gx=(oTAZg>HFS!_xaki+cH-l{k
z=o#Ca?50R3pX+SOU&L9bYhw<n2f0O4UGQpif9pQ)oH03X>RU<uFG+nT>iU+n{zKOx
zs`Mh;7DX{rY+`j*9fH1`S9dTau`T&B*n0B0KQZ)qop*KSU7Uyc`?^3M0^e4QAs)IY
zf*eDTliHw(5}?0h%5Qek-6#9-8`~{yN9J0xo!BPI!P49_|3mZ48cfYQ>%jbHuo>*u
zr*vSg40(pwg4|u8V=D(OVyKO|WPWSRdy6?{t~a{uQ|rUtLC5Bp9&5mLa*gCe-vS>w
zh@E1G#J1!E^cMD+B(_XZ+vL8sAsMfVp|MMVPA!Hu5J#S^e!jk;-)Eh_OAFqQC)__<
zRQ{eFpc{PlJ7&obJ>qUL_#DT37%F|JMRQJ#`TBe<NUj;*YwcJg^%<&ze2qNuoGN-A
z7@k|1p*B>p)h9F6CKvUPm$|8o!Ef0h&l}_8U-CJIYsmYCdYjndWtX2mP5HaV@py&n
zP#*dZ?Yq}Cs?UtRwCP_WKW(7Bv8gXPsGIu9UE+GsvF-3TNn)v=eug%7`-Xhvo&h>w
zckEU?xt+g7|Cw@;k2ZZg7CAE5Ys3)ic={M@<O0TlEf{+Vt{2*cDccsT{SxetE@rSL
z4et@&Gq3{QlLmVeXMB!DcYIghDR`gpUdv#+*@+n!mTXn;NyGc{Tc%=f&>uVUq{;@i
z&qL2`$GnroXP#nnjP)FAn`QRZs5wjfXN=Ez;~kEBC!Mn@C+h;N+16UK=IjCXNE4ks
zr~SuXW#7K`vi39kp8KGt`vDt!p14IUePaLe+#(lyn7mUAjZ-up<1#*Vajxo|ud94I
zyK|=R`dd%Y--(9U2UUMhg40f$cxXY9oXSN$sA4Jqh~E=4elsxc`X#%lf?5C_8>|HJ
znd~EWt1oBbp=)E#xn8atx@fxgiCzAt*s4DC%Xv;ckJqE_EVKVf&p92Fb6Ce`9XZ7g
z&`-K-{|<g<oU>1EyT)w$R(D^d`|OyLcar^l;{A8pziHpbay?o0Sd$`YSpRXs`@(TQ
zmF|DbjjdkT+V?OYu;20)*VOlkBA;=L+m_s;H+UXlN1B>++fGT$ySOF)jef~}i~C(0
z`9Jk#PNw2ML9S0R*-!i@a{QD2DF^<VaD2AC)0dvbkYjGP?C)v3Y`^KwZF!5at$#6R
zKZzkP@mZqZxLvbt-^igkG-o{a)AmjKcl&XD&Y$&nHpb%JJb72^?6NuE@LPi4IQm^@
zwsd|kEz#rm%}`uZ{P|sQ|3m!(z6%zSzX{gAYb}EO-S4JPeFKCR6iLJPz#Com8#TTW
zZhhZ-V#t?iYMUZ`rtgAF=dy9oF73^^Omx8+ZE-FOh9uN4*m}3Zyx@0fk#EJju!pRY
z`_~`veriFHG_xwN=%NNo`)LGCa<f-N7bRHQJ1|5Qo3oza%m+m*?JeLeSbxAz<H=2*
zZ<!H`H11nv%fB13V|$(H`Q4y%|KvBW_J84b0{4RMiyeO#$T~LKi~B~gh2IYJS02Xj
zm^0PEycy=v4C$Y6>?upi$yjdZakJi|9^#y9Bpn-V*a3S0`UjT$kmG23Up4Ko40ilg
zFfO&#fSR#U1Nn%f?>yLQ1NIWMu(8kC?}j$i1KaJ(?G^p8k$0#b*0%}v4fVQiulp-T
z^-@zk#-hEWzMG^^JHTe}Sx4^Rn{jS2+2&l9<cIc#A|GqR8r6U`1LgsmD1tR*zL+=W
z571ZOxnw?xeFyo-JAy6A_|ySQP@8L?(#@9c>mISbrOGe1@U!%tB#!tZR^&j^&UCe>
zAlDK+w|Rz7!E+t_oFCFNwj+z6A34a?m6P$R;Cjr6T8jL{%mi)h^vlo(svu7j%wZMG
ztLL~$FM{=9-8RoUoi9fGjijsnvdQN)q|d%EWCQ$A5_#RpQ-${k5*zVPeeo051kd9V
zbs{re?J0;Gf^p~z)){A0Tg(fRxxqFLumS!hh@E05nsj_s(0|5Q)N4Gp>)25@a}Cr@
zz4Rpq<9RIBkhNS1*4$txhMHUp{b5BOash3y4_O7*$hb`uK^@d;Xam>tnqR#aU++h~
zPpjUSoH>hFI)8S7#5UxcoKy8a<?nLHCOS6xUhmxK$2W==-(2WVKIe2^as&1m`N_3o
z43EQDyz>E_F{y*tk|ghX>L(XtxQ3!S3^l<Bwj@-=gWLF9fNuLO?(}!%0moX}ZfQHY
z|6gw2E?JTtN3Z2ub+_F?@I0wX(jYh#4uwPEP&gC}Mc;~p?>0nv#E#5UC2P~eGJqfm
zf<NxgaL=8@7|G6Wc<29<P4K;s?|-d8*=*?{@Lg{pmcI@1eGssj+727_TQucVAxH9N
zj+y_-ZxPO9dM}Hl%=)k{tVPHV*dMHqp^g|W8R>`JKE$xTWUq9U4e^OZ3`5zrCY?E7
zITpsnI6@rREBKCVOMi@UX*`T8a;%IK&INNY6W&wvj+=MYhB9{hASv5Mym8@v?0d%~
zw%g-Nj*UE(b13(nbd|ADhYx)bYl)fnt;W6f0^94JCZC>!+5l~vpnu}g|HvG+`l!$+
zb*`V}kU0+JI5pRi^Nu_!lY5gNap{Ntfc}U>9b?3|XM5rh&tt`hzVK%bM~Q>pG9Gn3
z$8qOKtS-oxSRu&i2=peXCl_SJZHS3KtZcW{ZoYwbu&#KNfjatqYEN7ULBI4zzl@J@
z?gHZn<^q<8gnePy1MG#mN4ClkN#_|Yc=j3Us^492zoRxy&m@@nd<se6IrfRA`kN!0
z;hBhztW1?*Kj6B5rR<r{Pkrpn4?pyu{9WHO{*$cp;d#2{-Oh1$=3&WM#QKw*nR74s
zxUZFKyS2_uus_%@>^Jrydy@Ui-en)Nubc37P$k!duM7O}XTLYaSh=UW;u3qP5Bi$9
zzsPNIrsDkdhwM7bbJm}FN5uQ1B_iS5;3x3Ie<V$ED-N-E=XA>N2!1<6{@$R^mcJpE
zav+ZiHaG&mchH7$yw;-3sjoxE&Gp9IGv?9%?8oulhs&q*M~-GoH@5vGTaK^B#Aax}
zFGA&a+`jM1Q!z~SvF(=lU_(~0nO5{6{bpy|kgV8_#9qt)EZuRD(6!Ghw(ruvZQsb+
z&iYU+U~Q-97ucw?UzJVm0Gst&Qg?$7F@gA9g!c2g7%G3m-R`OEI88AtTi0AIzti!%
zxqWLa``X84%c*!bu6vU2;@H>qw{-nqm5%!q$90ys5BA%3m)-W0q|K-LPjz>Hl;@Xp
z`F)FHzVoM^I{Ued4Gzz<AF!X>d@JYGZ!HspGSawgX*&{|srFm{X)I6m?_yN@Q@eMz
zrTH|~2isk?U#+V)>!-xD&2p#?Lg$ml`AN@g&Phw>m&rLs=bG0UN9UXn*j{I-|0!MY
z9q|4Zxc-NHlF+xkn=M;q<afX-+hwB+Ti^T4)AvAZ{o?2wpIP}Wkh1k5y%PL=py0cp
zzYR|5O&p!gDyy8;IG62mCgWUoIFCKRS*_AlhTy!G=eHqgnsl@EOoI79mkoGct&5>@
zbhQ;zwB+deSPA<!v>$fvizW$2d&5lW(39Ytmkdd01<u}_gL}f+&^mV51>4?9d}|%$
zO09d+Z(s7^?Aj9a;WKR3g|7ph`T0#S`7O>ngnXaFJ09Kv^^{Ha#k&Ie@;ia{#P!&J
z%FFZT`K)r4xkj&bE$6+C@kw|8wa#s8JoI(-K{*okfcL|Z{)G3CB|g?i?la^rI`#NX
zL0>~OQS+uu9X|LIBMMtO_D;S080(TGE_Id2cG#$=jbo3jtM~L<r+veZeAG{9t*2nk
z7keoCo{CGnoiS+#zV6Ve8!6E%*rC0_^~n8;)Hb2E@3`aA4qC$e0b_-pFgLKo5KS;I
zhI#7+t`%VZth*jx*hxqlV$%m4LI2K$9LaTw5X}1&=Yi4XE4B#Xv%hujuSamd<zCzp
z^os4b#Ak~T+~=1FaX$;NQ3pfdPdk|6m4osiuPvHjJdCRsC<FB)!Qa?+(vSIJo`zul
zn9CuU^CnoAF4*h9UT=ak0{1)44oxh9jrzKlUQ<hA-pp%Vqm;LF>J8-(<Ot}19cI!b
z-RCV=?l&ZL$bR8E;s9~CpwA`PZ(B6Y8=%9y?5;;rcQS9sp-jBUKIoTu9y!m<HBg2S
z2Os<uZzwM7?{#NgTbEsU&5@L$34Cc2CHJmaW@p@$vGFyu0qTZm0)N^v4#q`pW=kjE
zt-QPT2Ybcu;do{~abySTcn3H0eVyOUA$dM`v9EXcE1%Uon_-9$hv#^Cr%y~Eeq3Ou
z590Gao_3~Xf5ard&jUUaP~HW6D%9Zv{R2nemH5^K==joR3&%sR<)OaJ?L*rx9GCA`
ze6QoXUlaTd=gsSHI%SW4|3BHX!AOZ7Nmm=%5|8+=e$-zi^lfZIjvOnwhhWW^Z^Ig}
z?oI0htk1~$DPP(QL3`$fF&oO*sSk1Q2jUWsK8WeKO*+2Bhh8MQS&B*gu6|fEV6N#O
zJM}lTCH@xl&%O)xp7uSz$9941rs6tmLoBW<ez%qTGCsuViFK|k`k_B__v^UCcKnbI
z?x#xZOElqr=?@+IR9@!|#G(Do$av11c`=Nk(zCCYZRpqS@MD~;uh+BA`&J!3v~hdd
zGAFD{<bD{E=m(qX4sqp2o*@_`cs$sNi68!rHfl>A#5!gDv5$;L4z=yhJeGV6G0c%Z
z<wGCDSP8nZ4T+7IP0*G&jLT47f;xQgjfA$=kzHk2;t1x0F-Oh|;{eKr@)FDw^VRfh
zFhjao(oIN*u4l;<JW~K2yZw;Wk9yNnKax$)CE)oKqU*W!1kbcj9Mwb9^AF|&TQ(EY
zjcwn^`4G3-zKMZPTs*a#KlF9iH~HV(KHrw_IF#LXOE*z;+h+PUNyFN(eqFHEtU3FD
zeX{dfWk0fKr(h4WpV{+Ga1C%haBU!`7_w6z3A)Q%2TgH^M_l&!P+#mh_8B>HcG@~q
zt*-JP(mCJj%)j++Xz)HseEK%%I{cQPP4HeRA<h&{5SQN+J%3X~{-zj`E#bEXdGwU%
z*j$gVu?>k2Z9?N17fWTJeu~<Ta%BBTiR}pdMqx`gA^j)p`$-PPX;&ZdCN^>GPaB}T
zMZCdvmbV}Fe+I-Q4)Ry{l{WZ(^8Zv9C9m6$@+WBfR6k^gCfG0Ro1WDDbGLOnOWHp{
z3^PmY=zs3#A!(X)uHzf*?{M2HZ{HekKE$u}PkQ`Do2NMcuiKcXU&V9s)UK|n>#<q?
zN$xM!ZOZ4S$yTA><*M8EB#)j+zXP#;r`=PVnpds2z1qIj-S)4_`Q^OhSNp1YR{J}>
z`hU`w*6XIr_Kw@v<#+zJht4aoFR=Oh-;<30{%1XMUksJMrODTve`v22_zw6)m%YMw
zK(nszfS<kz-roiNZIJJQ{w5eYd+j`fHAy&}yAsY}rc1Bf_TY?`=d~f(lC5VI%m=z`
zeqJG0G9+)JD^4;cn>gC9E9sIDoKM9NO&qQDOgigc2%W2eGd2v-E;x6a$r<<o*IU}B
z%a^k=po8mvl3Tt{d}`Mp;$x%#!5Lm>`6-%M`TGHRlF*sI34Tj-f#i1pK3i>Q4>Q~2
z546WlKhD|n$eiBuYMW)tIj8M>z%i-oS#OCAwjd5M*AIm14g10S!}7=m>>uwT+bm~k
zXWNs+uM7GkuO@1~*zlpBEkbxNdp{4^i0wE?%CrIWDTviI4@>LtTJwy(<r5dgUKiN#
zCEie5VzAaN*Sy9Y@^f4yWoUx-hBCPBscc`%>O;F<Vawk{(QQMH4>Z*QxpWbl2j;cH
z+_2wRN9G%tn@`|_KkTF_4zbM2enOJIVHS>bawGpOLa=5>a8Km^$bHlI(IcIEY`xFA
z?w0oTeR``M_&&}(eTgXC&x2E*7d#(aPaE1dL45k6|4qJv{6Ep;b7TKm+M;){G%rms
zcPHnUd1rl==z{yz&b`h3Yvw(0$OcVd>!l8x>ybMNNn!%=Pr>C@);@Cm$qBpt(E&T4
z-*vU#ewJJQ;Bw0tE>j1Tn;^FH!xq>yU(6fxHw1IZoHDm?lDZz)sOuuK4Q-q78nCyC
zPrvlp6LQ$tRKL|P?TAB6`WPRe9zXn-+R>I6^w|Yt0d(xthnQDv$H5Mc*W?Q|p2tDX
zFhvuLhdsf5;hEV4&rsf}4dM4~=*Bj`gPVF6=XZ8n@9ajtXP^1qrb@oQRH!?Gc7ET-
zJ3k<1Q*5)+jvxNxqNz+QVnTmI=(`Z`ZD=G-lJ8Y~JK}p1@GS{ynQu%ZL8qQJTM&bI
zD+$Sp?UqCJw0(Vt(|19>-SIuo-}U&WSMj$#`waQE4^V%zOZ=tyd@HPfH|TGKNb>R+
zJqJi~ZaFsQn|WtFLa;`x8<H}0tVQIUFlL~=^^lGaF=!iFbML*K>+hJv?HQZ+v@t_E
zw1nKcSf$Uc+zmMxZ0PvXh8SDWA2}@Tf3AxyxJI~EAh=%gUdw$KC<Aq7rGJy;d|IzD
zUsoRURDX;YnsoP1JK7IHyb$h-e&Jj+UE8+Vr_0CKW=Tw9j|=)HkJp@Njy#8+H_zQ`
z&U4OA&KYAxcbQn|#AA%1c^(Pzdyajoe#mbnQT$(d&{norZaFtC^Jg5uIJWA@fjEvq
z`<eR#Sz!#J`li^lAwF>d9otqN^<F0=dD9M-bn2%FF>(yFeS&)Y@V{dbkJ!esTl#NF
z+E#2ME*#O6JNe&i*@AItd?#UlY{CBF`LI3^s^d8_3)tMo_4rh<8@E65;kg7u>?9;R
z&qTqq%-CjWJMtt=&(Is5jj)SEe+Rx#G}$Zo)G~Utq5s5|58!8s{*I=)O7*LD=ELQ8
zKCZtdZJASGElf`v^>DYNjC~c{b}P;htU2pHv>&(+c@HAlhsYt=x9nr~`4C(uvp~6J
zo%jFBea{{TVnB#jT=m(M1Nm*`x^!;h9JNJs^~1Se=l`wW1&jAgZ}9g)OZ@O3BGi`l
zFhvu@T%wD}-z@ai@^{AkL%yOX<YFEB5%|)^Z0X=~la3$IrYB3W7~j!YBiDy@n7IzG
z^~m{PE=KlE9AXlGe?iEn;x;2=w3IGC$({Ygn^>;5#LxP#%8~iBlrC4fOC5Tp`c=L9
z#MOp6Y}M|vZ7%Q2kMc;+pUSpdj?(6xZeL_%+-j@(P<<2LV@U54?9^Ab$`#i&*}?6n
z;y_PAdk~fwq6zl!d;@i0zgosdj0(0-xP6U@f3;hmZ*uy^PK<B-?9&+Ih3l%^@-fwZ
z>#fA1j<RK~d(!dySFsiQiQ3;?A8*>+elE|Fe=EA}Pd3+C;`0ReTDa?Mw_Nfuw%yY8
z|7=M=#6*6>ulU~aJP)?J{7%k?^{6(t!-noU+rN?If}eBxBv;OrWmoxM0ncaPYyzXu
zq#MpyuXC2Z-9_SWgf1gjG9;nB!S%P#{>Oi|L5G=i$%?=KJxRU^!bn1Y0|<QoyP2|?
zCjI2!3Qox==Pb@zEve@%&Rjj=-1P)!F*Br_&@%~kG9_EWvuY*i;5tj&?bqcK{ZF<e
z4AI14@8#a@k`UTgX0bm7`(P$r@+bcPy;08KLwe}UceCHvCTC=w54X<CoYNr$XGQ9O
zworB3KG~~}^_g)jZAW5jg1*TK(6LcxcIw#e+vUd?j(%70+hXw>L%#+1-O%{$u6G+S
zr1QHOAKDO;cqXKS%Tv0cFWN9au%u&a>EkxHjEs3p*2=81hUnFPRQ6u*{@B_dKY?!-
zw69>J4tCKg_XPhT$l2qejGZ>@*CE)u5Q2R@%Ra|m<D*w*=@0wJShO=C{R!%apq=A5
zXY!qy_fo#pxAaHC-Hx_BW8wb|#4wIKGCtC{u1eSaBx{=|o&L$SCyWCa_Yj_oruhK&
zEBn@amom71=Dcmm5X1oDnIj$OlfGdW$kXFm(jf%<;|T7F+#9#xzRA6m`|8YlaipY7
z-4c=hqqM_*x8q)a1kVMY53t`rT~BDovw^;e={}qKV^5R+xVXnfZq5%$TgFR!e4Ajd
zm^<cj2<DhMZ-O=Hf_n@1G8n@5w9q|``x=t_*G$l{8_MT_rdU8s6VmC^dtfUMh?KRA
z&5(P=ep5bxU#<T}rw#1H<(~88G7{S=wA_cR(P5r7=R08?Zd}*pga5i94tx5j5BjP(
zVPhRb(2n-RnWaC+x1=6l+7Oratw0%j2>K>wjaTz0CUwvSzO<n|ama6F-sBF<*$_>z
z)-(4R`+)s2w10Si)_8xW=Ogdex(Gc#C(ls9dpN&~ql~@QE!B6yGxqhao#(CK8v=5P
z5MA%#smCwyeR#h|-{eqnKB0cimOcbAX7*1^Abul0@BOoX@@Q|U-#*Z%=z?!$<N7v;
z9Uo#X5rT06I<`u!qaEMiy1ota_k#03q$lz3YA5)<*Tnv}Kbex>V1L>YV~G%skEB01
zVyJ(<6_N{oTiEjZpuc}k<;qx*Eypw@83T5}e#Ff2uk^ER%g#CgYqA7u#k#SMUhAXv
zh9$63hfhmbV^i0fc*JdjzQ}{VoyU+K$`gsb=7Vl%Pn;0+v(+!Ta7}E%HNrjiaINT?
zY2`lZ`zf}qI<6`FU?h=orX(@zSnu)DKVz(U(2iIu;}V;GV2UlA(^4Llk-1WjAJE3w
zW_wp1{cQEgIxNiz^Vu|y><z97B;_r-<`Ey(ig}|AFfQh>jurb5jE%Xb-AIWJA$pF#
zr9bT)%kxKEpv?Rr@pEkAHexA1)}LI#dx8Bx-4riB^|@)Um|L-!@5tEnP2DKa4|y*2
zVVpO<v>_I<i;&GwZ<=&s&5TD3bZpd(1b^$dY*!t=A?TO>k6?bLU~G(w@v+XQz}ip2
zUa5QNNe}sOegK{+NNm;adds_>c1Q4R@-qs#MF^f{a4uRt>n!j3TE@pr>H7`T{X{FV
z-swNZ*l+s($sTHV^VDX@4_fkWF6{S7-Z6TfCswWxW#Z#k<G3A?`kC!sYs;FmPqfe2
zdtD6eNA@Vp2fA$RY4$nS1=j~UdmMk-v#%i%;@&LT*x&Te7|1Wg(iy7hJQbX){!p3U
zANoze?+4yNEpZC|Cdm6L*eTJwz?U{dMEMQE?~W#jJ@YrmP+wbp&Nom8{5HXt+#m|J
z4cP#H#<DdwuCdp+HBT$&khufO%sKPKdbFGq=3@0f;}EaLcRqJcQSy1GI}UO@Q0vj-
zf$DSDziVT^+IBqj|C8;heYI6RO72~24b}EecZ_%Sx8458@j$Krq({m3)@!?weKbjM
z`IEG-_s-P*?8(tSgOv<Pc<o>Iu$T$^5*=G4_}*<D!*T5UBx@}6PfXSSD`|>v{%Sw_
z%JnW2zx_b<L4OBv?mBF?Ti!mkyygE_3B{;<iZ?&x+%ot7YLegkzXQ*=${oYwyzM`g
zKgIm1?WcO@^CXAX<`cAWJ^B;1@2C1|tG@5_srfbdShwu5y~941_TyagI-77lNroh}
zLj5L)9{>GMwxr>kU!|%1#QBHzmzYJOn=ajizVjKr`@wji$@av%Z-Tvi4_rD+4G}s=
zZ81elj?Pi*qN@y{XYGE&kR4ib^b9jodZnuj=Z`;GlEyasR6pwQ8)ElAnUYN$?a3}e
zdtxU;5}G(#+ga$+E5TX%3zmE;L*<rio%1SFWqyY(!EdxJrf3P}!MR;@`F;a2zhReL
z@ULZbY&}7T{Q!24fqcom>r5N`z7R*h3%XdGgOefI1aeX@e~*>%LMRS4Xky{R?}&^=
zTjJ6Obu)cK5>}bFce%4JjLGYR93NP!tAxr>_lb4er}oiF(6J9u=d!5`*q4ZeSm@ZA
zU>uBV=UCCP<HsImFK-bE``vpU8+Ai8K~CgDTgN9BI(7IjwLgjD)b{uh%TRubH;W(b
z9mDOAw8hWuhw=dOi7%j?A<jweKCn|?xqYAV`z8)Cd!gpdIEH9~b?kZF9IYWbwk@c~
z@8-5I`9KKwN&l6jGLSoCf-OR@o^^e>M*{cD5Zpt#m-;?CuY0u1TlNa~ckc5m3CVA;
zf0IA)9RDZ>a+%7Bz36?&7=ZDN0%h#@8Ej23H(fAqL$ri>XZ~4>k=Iw#HFk7g;okB@
zmz{fDg?mv;(6_+vh?&<clGwxy)dN11v2PKAJiIr&FUZ%qcI6ARU|Y3s)q}_SN!r(P
zX6!CWF3tx#afVnT66O|;V7`Zl#A~r~-#tlu@TVQL!glQJlYUP^pVZ^O1aantV^cpe
zE^R8brw*SG#5kh$|AaD7_e7VS_Ko%>XXlC}_aQ>_xS30_G{3Andw~7Gz8GTb8TWcd
z@|=9&=sCFZS-SOJY4UDK@984n!w26G#L+u=<Pg|azJK5H8}fg>-&0#ZSLv7jZ(8Q$
zyqw#e2k*IvxdidahrXIP>YM(%AQy7_i6)<^F+_d~87V1u*{Q2z-13hH=#&0O=7YpW
zd}8tUdVH6ge53mh`Te{6|4n7lFXC@%BW`;w)6N{}P4S57Z-jgk<eMbl1Vaq<4dl?3
z%M>lg$~Z@kiJXBl<7WKS17+;5acO+P7_|mlvL)!O4|^tZ-PuQm^}L~O2-?iDzQiXU
zjN~Y{nK_aNI-Ek2ZwU4XkR#=Nft~sz=$ky)ckIn2LU7F-F?9WG!L@{hA)1(~2YhKm
zTNp``WMB7$@q5h7k;jds>^x{koDjsOkCV_Z{qH0s!R00$>~C4^#Os3iLp1tPj;|av
zCqwhqa?Y45=BX(^*a^PqQ#653WvSc~)&MADKY}(udk8Vg{GekqJN;-&4B`#Z1p8oV
ze{Sv5DUj?}Y(4h}zCHUTCUec0S)ZBfgU$WYA2dOqw587qc}&%Zpq-&?wse?+I6ymO
z%es)HZ$lhxyD+6!s0)EF?HCK=U_8K@vbHM;NyGZHFW3{K?44cokZyWDODwCM=L}G1
zY^#zw%17{g0(6+tw+O*=jOW=AJ)d`<Bz}!&bzw^XE7Vxu=yzXkWBXm+%I}Gg9b7ky
zUTsZwVC<EyGV?eR=5wWw+f23l3CAYhYfY|r)DvT0V52{Bm|9o%$q?)}_F=FuMb~~E
z>}OpATu)03(UPre7PzjtehoH!U+vVMSi~guNzh03<+{y&XRj$Y&QhB*RaYGS4jB4v
z(DfVPh^BW=llM+y>HXA6_!fBMI{b#94Qw%!CP~~SLjBNJ6Z{6DZ$lZo!4LKuTu*z(
z@>++SbLRUs7dgjWa|{QGO>?v4!y3`<Xg)Y&4$hb=Lx`Dk)JvYx<(Ht7_nl`b=O^}?
zu{`-=v;UBO<GLqVeVf{T0$=KpH`q<B+p^z;Y){~K+p(D;y<&T$kEQL%@g=oQsLd1h
z85#2~H`$GSEU~lxFq1ABT{$LA(y&k2Q_z0^pDo<h@sPG5@%ag2eWI%#KKa~rZu3_q
z*PgGxZ(`LvZhz`*tA4j`A7rh&%dW$I<GLr=uDDM=PqwXgf0d`W*jmAJ{*7F@KDRIS
zCvLyLQvQ{k?OXe^?N?=uVSVLz-<55zk~X!Bj?LV4cbU9xyT>qdJ&{k~Zy)r3CeEqK
zRp!Tfm0k7U!n1daku*uz`ql^YqO1HZN8kNcG9+)}@9HC&lBP-j#Nk`t#ZtM_RW_mX
z)XHyyTW2Teg`;!RN`@o^XQ*UL!c3av&C&B|6}og2e<+sN$&jqre#^MpoUR;17omN&
z#7Nk4TkAfrwLe<R%2K&9REFT}{flhQ-lB=4^W74mbMFw1^Dk#{5jqbKe*bYU7ufLG
zZwT4n(bY$VJ}XD%3U!o`H`t%RuNNp+8+i}G_!!&fjLYu=erur1)>Q}857E+Zs{Y7t
zh^h1O;&-*q$}QQPo%x-evGAuYF_s8HT>2&l=80UL<B|Rj)@c?f8{2oOw+)H?CS>#e
z@gBlwiYCZ|yt*Jy=ZYO4pnm6EGA_o*SkbW)huGZD*x!bIzGNo`@tF_iW@bC$(w6$2
zF^>Fc&voN#i0cPi&v=pkNaACk31wmtyN<=a#IMknGVQ>zn_`@j-&FY<w)`N(C~+PC
zCwbHc$jiCeR^=+OhjgG%`kn>Kwxh!ojIHM!F;AW=Y#w)$pSf+sfGr|%9#yW)^GJG3
zQ)AnL`yp!!OGLuDa}Pa9`$N8Bh%G|+zWpSrfAXpJ_3#{^ev2WF`tE|9$ZaI#P5#ge
zlw11X?>5+W`Y{L0#}LdJ^Vh`6wcuJBZ=lZL(*)NO*HWdcT&Z<jdtA5N3%O_czP0k2
zB<3oFbYM>a`Vjl-lXA<tC5a#Yvv8yX<26INv8_t#?lQJ5BI)d_gt>(y8tWlg7v|rD
z^pWd?{si^5@6vWkZ-V&l0~<b(&~}M)fsH!+@ShjhsKXD=1Fjnx$C7rmhbG8v3C|Jp
zWrlRqqyy{3nz43Gu%2D8FM?;A;Ca|DmdX%%MsCqW*K={@b8_mvTrX_i<*APP5R><H
z*_If@qA&I({jyid;XHtydVEjjMGiv{ljk$>O_xre^gRT*kl*3`q1b#E;QIjI2@>?m
z>)RdQ?-I)R;&Td3afmk*m-x&9eZdwjb08OV?14YA_!g({a`7MX)i=B@_@=kSD8%37
zbMaJ<jka(E@una)H1#tC{T;qX=C{DETs)4c+|XTq%~u%*V_;m2qk^3=vIeXR>tiUl
zYn_h#uu&JH=ei;(@2tZw6nA95UHvl8<b^bpEBKM$7UV|zCCIO3Y$WB#I_htzCl~hJ
zzV<2C%@kZiTuTNUb?jyDUG_Nb*~6wuC+>PPcIO%DpLxNTwp)bYnjk*?0DT&Afc*gW
zUU2&=SH>QaKz|i-n4$^tCr9Q9hG?QQ*P2t-VrYFLuM@8mwk_LCs6W``&zg9xh-Hpq
z0(H;@Yc>RZ0lLfXyD2u;E_)qGnSR|T?LrWHle@;mxBxw58wKZsq>XbS#>!aOsKdu?
zxAYs=Rat#PZH(<hwkF*7-Ix7BJ|4@_I1KB?`fU*f)|$0vf3Qz>g6^{S`OuyRm+gxT
z;d<nH;K&BG&Nj=Q=L()(Jj){Kdggu0l<!Xv3!f*6?HimMvii@`|B+sCU4Q7qb?@X;
zn|C&HTFH<EmyuB*##5i4ViONqf*#^27Ph52d^TrA?E&@-`)+72vR~QX?CICFr2D}X
z+#9%e^t^8jUB6t%C$DK=*IPFH8ut;=6^D4lodUU3#`fw58~a{)kTYkj)|FEsq_02J
zUcV&<@168cs^z<@kgV*q4@uLco1?Zs4Co>ha|vQM;+OYT{@sJkZ0Qx+7~Apfg1q^i
z!x)<2?8rD7FXLuTn1?17QfqK>K3E^t2^ww0(fWCg9FKD)u_9w|UwN%7eW_3KAfLa=
zR*c`_UB6xNeueXg#`S?a*1LXhdu?~uxx9aK?6h+X<Wrody;Iwu_lsJ;uekPSu9gVx
zfhqW{)AKhC`w)g`4`8Q01Z`GA3}}jXW4nEx<SMbg)w|mKF63V!j?4S1vmIIes{Kj-
z-P~xma%@QJ*#E0AmCIk@r*S;Z=lZZN_Q&TN>|f<K?QWl;{{AX=%zsw-r@Vf(pSb4V
z?Qi>CwqKRE&%1JMGjeS$YhBeN^Q^XC(Z?^YX_LR%dJY5S`@5jad>ceZ-tavTR^so0
z@ps*y#4b$f?FWv&@jWqRuXL3wd=ISO1e?lJ=cS%-R)Up`JTGm|NpJA;?C7}!tI(yJ
z_(Oe*T^Q28p~(+U|C1@%Md*HIR^C&GWJ@;dRp`>+!CA{J=`fPuTvp2Hwf?TdA7;`d
z59e>OIKPR|nQ(|Ej?Uy}N(Yyz2Yk(zUI~?rW7je^SYP58?qg)%O%f=FxZ}EPiO)`G
z(*$E%oP~96T{;hQjvbPR-v+W_N5|g8>o*1O3-tS<<?sD1J3gF!4eiihvDF8C(KorQ
z2Ts~<dHYiTEv&QGd`rJ^o%`&HO^!p5FOssM+%Bl2T~quJ>_hf6`+O&qvD2UX2(?@E
zmu>LpS_#3m#5Dy+_*$b({Sw4Jib<cuK+=a9rH*?0V1I)42H%-9Npo`U$(wNiIvjx?
z?RFB9PklYvR_1;rf5N`VA?W85&gYg>?Z~?e)&psl^e2w&(A1XpcTCE0L5|M(<oMVV
ztU2olO=~)GZCT?=@A4Jw1z<mn2exeA5b^^*3wTCY$4-nPrurg}mAMVcCdju7kHvD9
zvEYY)q>Z{(pv@9pFlWqZXU??_gKHzfHgmq4{3^7e4j*6*-3~dDCh7Zl*S!dK-jndb
z*Ekk&PePv~LB~#gPg(t(pKVpT?ps;gqStn#<g}$nfjMPv;RxoP`8Qj7B~%91tAfpb
zQ+i9#%}$??Txx&bKphN$Zv|V0x-Djc4w0ZY!T1=v=K>ufCHfF8K{w227p!{|?1!0q
zgLgnto_jpshCqf``F!M=*U}Fidl&c}y?gUJ@loE5^Zc9%G4Uq`&r13<lxLxq(L*4i
z3Hl~CVzvj!hkoh5=CyfGD0s&>621+fBYCIDd&VLBO%Ta<!7dwhO+GVyX+v9L65C^6
zIR}>5U-j}`#K~`hoxk1FcRIe?@ePmfd3@K4>pS2#<*hbm79CrNk+JE6zW7eK#LT}R
z<U8TWalUd?o=EG=&C0PhjfXKsVWrNzvo5R;>jbPjV6*P>ZL@vny0V7!HOsm&@8mNt
zuu;dFkn0h&YijTOhzI1^)Cc{L0}@8!GBU(c{zpvhzhDpY?o@F781A)PR~2m3<2wXx
zw;+yb(uqwUUC<x>w!)B(9UpvYL;Ed=OZ+3~4{8q9x9k<$k+xS`&sdhkuYF*rJVazZ
z<W<K(&alO6&RGlAMth6vialp`xz1Qi){pC^t{pMVNj-9X@iRku6W%xMi$+YYKY>04
zcJgsQ#3pW2zJ{_HIhK%QtpFXUYr?*k*r?kg1a0aZVZXtza@SKHq9yb-OYZg$)jLo6
zJc2cvAK0pcu613x=1probDxBy8G4>r-&tR!>yY?Xmdc+vs^_^i^E|NhObgNVEc}Tn
zA9JL?!#>FV1;6TFW7f9s^y>df|EWFm^a<t?-uZm0qs_bA9FO)lu5;Ua4A}9ZT@$Q3
zdteCm6!)6YzHDM?U$fsMp9?#$ZSE=DM@-Laz2`OF)rM<^_FNY;;kp>P=coF5otKou
z;OwO{+wRi!JK>0}-w;FZq=NTS`QD1}enadeijIvsXa(MP(cbiY=d~1<_|Pus`)0~^
zgHN?}l?`K9g7JjL)dc5F)`NLx?998bKbN_NSp(*Y`GPH-wHa!6)Smf5dJSzqoO{(D
zIn=z+otNcZ|5V;;_p1<xHpowO)f?vO=Bds$%b9(+T&3%NS8l~N><{Zd$(cF*<VU@I
zExT+L+mZVL>^)hU!>v8Wb;NHOu5<PW1p7^8_Kd*?*h_)G+R+wHp(*A!)Hc?M1^t0f
zcDJk2F={*VhW#b>zolbaQjdQ7J(b<&C%GQxVm{2vPjRS!%ELMT)ZTp}zv0_>Kly!I
z|88vmEc?>h{=|^aO_S|k!QIbYu6^EhcX@p=w%aG(w84H;+m4(M?kkbcvez?;=Q?Kz
zY`X7E)f>v(kA|QPJ~!B@$L|Q@(|(JlKI!*~CHqf=e4eQ7M#gWFPw)-!rhX56`WDDH
zK-gl4mQ?-xH;q@!-=Ka2M6cfgSN?rq{T9fXXeC1uLeDtZVv6>_(X$5Dg`Yu|p=XiV
z(knydcQn<R)76)lg)Tj~|0PS(4C$sxzu8*P`GzjLIofAtNq>U+Y9A_Bg8eOaG9{Z>
z+S|dkAsS~t&U$Z{Tt@}Uw=Xe9#tX?Oy85KwlaPn?D)BL0dgYG0ufFW-_LkW3ZGy4z
zJ9j*QJp?|C6G<6g&c2iLub_<ms2=cLDz}7sY$Nldf9GO(WHYwivOl!5&ruz7$eQj1
z9h#sX@V9P>4Y~;B$lQ=?6CO*~IC-A{oc$SF*O>6ZKLqXRYl{%<J@zAecnhur_CICn
zrhM>+EskvXEquD_#YxbiCm|oln`%Q$`ihJ-B@MA51pVSiUpK@6?D*jCw#X@(@LVzO
zI(F<Q=K$XjLvelw`ad6_-i+*n{+`&fSMYJUNhjz2hABJXQ=#2Rh!usde8Bl3PoZg!
zr`SnI0_zD&9O1RLWc^_a?#ClRH?}R=Al~5mTaJviv!5y11^JNINXT~z#?=cRYs-3k
zwuk~{>`l;~HqZt0$b7bhIk!G!1DD^`VV{C)5>~;so<8_iXlHD9f0nja>AEL5GH>Kl
zy=~R+*6s5o@!d&CGLOvXNtovw*CDB!A|BYX0riG*2=)Sd0?q|{<^~^p#{=)|^z+1&
zy@{^;89!^$MO|NPO?A}o0%h#8v|*1l;rl($wI-JC_2zZomyNn8@O%So)HUk#oM^mf
z<2_xzn@95AZsc>Mm-k33pOHJCpFCTzorE&EA+ZhNzQ_xfAm&zl`lvLOkNT#6=TyHF
z^n91dcL&3_0lpFNt$^<at3Vl=>UjS+vK`+N`1W8Z!xUW*+i_{jJ4?O^@_%^NZ-PC)
z3HrMr-v;@P2l2PhRG%&1C+--uS>g!#<~!jQe4~8jrTnJyBv(t`voa@)pK&ox=5z_>
zn7KZJbqK-wuuklcnXrZ-SWiF)>{B#BJKD2`#3erS%be10<Qhy#Xo=V8UMJRp_Cbuy
zkv!22W%AyFzMVVySICb%Ly-RxM|i)oXT5K+8GHbL7=jpPXWS-9fAkMskPo?$V=uJK
z75|yBh)et<+&B4rL(6N;k{Cd_w%;m)ZB=iw(?8=HITrF`EK_vBc$jzg59>Fyue$bG
zXwTLE*Y;)4YcAx++Ow8`?($TbSgi5Lb!M&WT%luI>4QJ*dV-FvsUFa4d1PDSY{7c0
z0%Q6H#?L&Q0%h#9M*_BY*vFD~tKdAScZ?&Qy#=g`+0u<|NNkaGttV>=N3h1MJ?kE<
zcb+$fBxURsZ05=Cc1T#sDUxR$&o7>1OGLu+@EuciH%GR2+`e7D?&p)l?-ModdB~~O
z|Bl|Xf7)8NBya0Tk7LO`M7zL79mEG}%v+~j?dy(1Y~#AA+>YRkGxDs1j*VFO53%zM
z!yaKzO~L+Tf4{Cvu3xTco=^E)n7W7X++7Lx6@x7VK0HTg7ivGbU+9|RI%w*HefjEJ
zxoq<5vi%{UcTijKo@$6Cy53_Q!S_GD1MVaw!Q~+xT7h;jMHi7ViG9;#1Nw(~(N(@V
z%6SzSL-aq{l4eSWCOE4`u8Y^hYvF5@>$By$vwpOpJ$=!q^SE<-SHArzSKqC&@jSef
z_Ir}^iu<nIALi0Fx1o$~dzH*VXg->l0-d?3KGx@#Ic@pf)ctVReJXqI-ucWAIo)mS
z+th|}Gfu|4MH8LhL)s%#*V56R0rZx8?6rT`Lm~wJGdYq#oL}KxJKK@-qN{9b9X86Y
zvm{p_?~ydgitSadZ1W^Tb>^x5wvFu9_Q>|m@h55jZzQpv{O&&NbK711sos9G%)9j}
z?N{Yfy>0LOsCS)pOWTpo`=2S-!(JG<rtf4^{ZDM3TM5@%1v}*`(ale>skiSZ`6<r$
zVT{zT-+(?}_ZQ9$Jj3-Y2XvlY5GwPG=e#=vXXc}4{}7>b0A~ScMaRBWkMFCE&LFQi
z>L<j?`&ut^>$xE(#sljOAv-+nH@6w8hxWkG_d(O71K$Lv=t=xteTXIa256e}%GS5M
z%2c`1RlYg;-uDFG0bz*9v(S_T&Ow}gIQRJMvpL`7*~ibQDvzEql#ymWJgd5F5P$p$
z&m=RX-!$1OyDN{2sWSA!(R~3{VMzZ(X#FZ%WizEe(aM@1?Xf48?EMX){RvwP(FA9>
zq3dDlTHtpcbm^PxLw4$bGCtH*KWx<5cgZ&j#IH=14R-u#OPo8_ke%4r`vo~HF$CxJ
z#czSUe!Fz8YuXWmKFpC04XL(=>t5G2zxDkdAkY<yIFs1&BbM`cwWDp?N5*$-%awgm
zW~_{Re*u0!QRA?VtmhJOfvpMriP;n9_)e00<d_*hb36p|%DAZ`7IBGhDBCt<U&3-~
zU$V!$t__IX^XzNt;H1w|ee1G`eSw{NV&UIKl)mWCeXg`ONrNo}?PyQ`Fbb5Zn*u-l
zX*UGp>w-BN1<FUvoD=+M2gGokDs8{z%)W1VioLdRKkwvH4o?i(84o!#rV6$vw(O><
zJu!$KqULn#Q@NiD=6Q<{><QKts!sVNbx(x$f#F`hl2deS)ZJje!6y`Ri<vaZC&-7q
z$a{!7F3KKHm(Nb0mVU@eZOa_>g!%jy=6{GLSR2-@3-%-XlIwLR=p*ga*#{eSU^{Uf
z4?p`L@u3guZ^+{l_Maubb=Q58)t7NE5sBxIx%`GBKh|T2Eh1s<tXpDZ-B04Z;r+6^
zVmv^76K+Qg=!xT3>AEUizcW|l5R8HGGZ#%TcSy=N*nv6pnzA<<>(0Gh_jup$Ti*96
zV+VYA1^{i4*r*$VXDZK5&eA*2&s`GyT*Z$zQ|;+H1bYh5u{Gh?UA{mYK;NamnSHK2
z1JDnB1NsoQk;l?Ao@YMq{dngOv&bf$Zw>1W)B%2O7t)DI?2{53e!Q1_y>HZe$D?l^
zTYr~#^xchbZ=r8+e2Z%d-{%b9>psy{|B2AI!JoL>yT6lpkXu)tO*sd7lfS;*G>rv@
zSfZEjHq6Tw%mr((H2<s-dxN!S?Yy3>^GxcRN3JjJUhNf!`JFkZUGvH}BIdR-RE8#)
zb3-}AYdsW$SnP$mN7yIy)ic+o9AJno;sM5S1i24^v`%>!C{u_3ED*!c#}Y#{v6TyR
zfTV02Ig;<x7}#%sj*U9}mWYD;aNkG$R<L(L8`_#0!#cjSy~pVBVux17Tw@Q#Z-Q}6
zag=u*5BrC;V$Hmk>@hfE$i8z;m;CUpV1u5ZAHm*a4-r2^&$(-wJLCCWs>280mJCUQ
zjhMtXl&Rmsv00Z8OJii5tPf*0J9X?}A9U(~x$=D7wrZd9y{Z1zk&bCO)W^+|4I*I;
zz4l&P<Q5@%o()z?%EmUNZM1p9^|z!g9MSUpz%y=%bJ6oG^(5z)=Y#6!IJF;aF2Bpc
z^=|K&TWyVPzasm?_}tg8N^*xGI2$nUT;E=IbZpe&a|(AJ)Y)dgCEJbb-brH2oTJ8>
zCv|Mp5igVvIk6|$M@_Il$$N;dea^MVwe9Pf>yzuWbKUA5!o8$%Kgs9C>mHNOw&33>
zh(j4awIvqUDDml!y*QK$`Eg$349M?`mhYvu<j^~-C3w#@1@FFwSP42bu~l#Ig`OPV
zeF@?P@3#c;VHTS7Cyw$m<k&@Y#S=}O>s-qDlKJ*rGfv9Exl_KhbK9vh_LVRf_z-uC
z5cCO0)cn55-TwGmM-t0WrXF@7q(ik;eX8yqE$fh`_GjBI?eio<b1{-Fxikj1pC59$
z>$ZH&U02KY`BsMF!tFo5$gQ@qe^Wc=p^Nai*&o^~LxlDelD&hCy#q7ZlJ97W2jdIu
zYxxw@efG@Zog~j2@`oW9(-vGWN7oIsEMudt5-R@=H3qt4ki$F3@mD!&1Ham?`a6at
zb8Gz@S=XZaSG#rUtt0JUZSQpZ{)$|Gac=JRL-9W0b^b}RCw^ke=O@06f!|NDp6Y*!
z@3`OiMP3J==C9Tfv(YBcKCd$bXJpa!tlxU(k32{C_rc^hSAvam0e(yVQ|*?{2gF%A
zBfQR2oD&qEK6swe-xTy6!uhNZ`{<|+-uaA&JwxpMk3ZpiAT)9Qt~g1Ttc1StnJpd0
zMN=8-cfYCce9%7-I^)1fhGY|*c{uC%jI(scsc`0j$Y&FB7v`lmm2aM&#XNfr&!?(W
zhUkB?C1G4NmEmxoDNN~4blDB{){&t#G+yVYb-is(?cTv2gIVa(c_y(Jhu|E|S(bD3
z5S(pqwrnBT&q&G@*HI5k9MKfpP=;DZ-+)h7-Ru0W>nQjgt#f+l>^&v<T|IS;asF<)
zzPQGK-?Kxu#dRnj{C%FE`M!WSLv>uMkuiwFwMwiIo!>cPNXJf0`fFl~p4at}594OM
z9*4((+`mA`*RT%Ya+SNpoYHS<eW;!|OPmB98-BEHNnH!;uQkZ=F-C)(aSy>9%$zTD
zZ1~{=N6-g-nJt|h$mQODwy{sy+e>gg9KrRrMI`7jk|qiGPC;AZoE&qgU!ZR!dCUYI
z8~x+o)DC7s9B>&Qe4psD6Kf<*(%2TV;pg^8I=FmG*Ei+x4(H~2x4C0|Q|`(I$a9zc
zTk1pd34BAiz56;jzABw3(z)-P=aBUJvySHEe%M-HuXmN$jqR(ey@&*T2>g11GIsk}
zF4>H2ekNFAAEJp_VxkilyKxx_Q!uWP`_*%SWIpO#;A5~;Ka(a2o@3^|=Nhsm!1}-t
zO-x;%T(7XowTqo=7eD+XA>IxB80zq)T}!zovD@cc=~%=w#QFyO-RH@^kvE<*%b9bz
zB_Ra!y~Gh+YgMt0HQa(V9%3aSY3g3VhR;ZvBoM<8vnTX(vt%0&kTbbY(S*mpH2(fT
zo!g;#Yr^|tXiqf3J>K{Ep7(p?JA19e$Is`kXX(&0lrwWr{4C~Kd-TkuzYtyf&rn{;
zkZgju_*dv>B<QZgwt2=U^aa=eopV4ax0>J5S-}KnisZ@Wx=+$$MiPVbOz3RF_cOk$
z4Sipm`Au;ByUN1f1-HJ(nJFE5g1#@XnVx>g^EdUEpnt;c@UcEK?v^Asa`gAXMgELK
z?@Rec=y#`<UE^e|O=D)<ukmXhm~-|<%e4qeub=l4lJ&$+{Z3!6+iM>wR?B%kI{z&(
z9-!|{{|P!a{5d1;JSVb7z<QD6t1tCS9_&Bk+^|=$<Ff^Ow!%JM4`8<+?P%YH<D%E{
zQlH}i=7)Tl*R9-J?(Hb!pzR&k@sYD&JN~pYpV~VH<6&H8UE{{y#8!VWh2zrC5R9jZ
zmE&Q(eI0qtSv#m}&ze%kJ`?+3zw5SqhzCQ2nCgr9V;-4L=5;6+asqVIq?03l_>(6w
zi0gilGyAFWS(~YL#30^I(4i&t50tTQ(aV}JXMoK_`q`g0*uXxPwm(VxRJqj85iQp)
zB!P84!uN5WE4x4$dP?ee{`fgWnL1+BIMsIBse>(uwL}P>ee>ZAfUR;==DF!-=O<}D
z`_T4|h3&RiA9VX59djrLa2aVo+o-SD{v_SD%6a8`m#gos<IB8`0%gy2SG~a(&I7Ld
zBxzU2<T%xK>-Z3}i>17pU|)>9&#+h7x9ssDxSqK7xCRH;A@}^eZeQ1`u2=3Ai+hRS
zdBJm|3BC=^gfjM*ui7ugqK~cq*puY6SxcSWLgzcqft(Ge*n;;}OLV>GI=t`F`>+ta
zD?9nV4814R!A^!GG(r2B5HA!Lh;N2;XoCL9qo=e^`6$mJ$hmPYRsPI5b2~LIuJ@U|
zu1V%S$4Fb_7*jEr1ALH_sl$(cVJB6$?ORD(=mpv`UXOiA|AhUJ?Sfd9yZ+m9je$N3
zweF{Qqm1j5zRH;G*RHnJ=T~&cdy+K{^)2z3yT*OA2Zms;ZNc973H%@u+OLFo727R`
z>Ys2dOX63i%Fq(_@y%p!i=Kq8nabiC`T)M~>WAung&HT+_IL4Eo+M-a9gf<WPxEP?
zCpok4r@H@2Hs@Jo&;4Op>u%jXRsOV=Kl!pZh=KfuA-~EuZQl9RIG^-)?cdpn<vMhO
z4ZTWq6VkzR=Cb8d-Oh6b&%UKI#n7{lGcjk0oo5No6TRq7bxYvq^D^ytb`pc<=IdEX
zOwKEu6~xHg=-)Y6&L6Hf`@NGMQ~!rz3%&`$N`@rFfBR3ibeM%E-QNM1zWo8;07K`L
zC${XB>VtiVCXUWAQ*;rWVZ;*SfhHSlJyYgISGjWjQ0y;Q@-ajDP3YON3sZWfseJT&
zfb}I^emBAWL3U(itNf0kx=%FK!_mH~boQI}-P9fo_9c5%dv+HnclJDcH)-tOi>)#-
z276kZi>^MfQHL+_nqm(@T-s8PA3jaxscUF(KG!*X=-kb_rY5;W*V%g}N3wBV*V&!l
z*-LGvB<=8}%_!~gr!K@%n=M~{zYkr*hwEB7F>XL_1#Cz8PUXiq$a^SXa%Ud5XqwZX
z7+mj(eO*SbLbY3Os;|)R4fXgh5eYgre5dFI&p#5D7=ke}UdH`etDKi130q*t2VdF|
zm-t&mf{qQ)Ly!;qa0~C#DcyS$iGAvt7+roM3Y4)!OOAZ;hb~s`f8y5hlY{dh7sLGE
zcM@_y$A*8`_!?u?xLeLa*Z8+=Q}rW#k&a0_>Hs~2{f_+1%C;_lE6MSOSfk{Cj_p@*
z4Du%bPv8R~+}}~3p2IuGYM&YdY%#QEtXl}y&=Q?>HAgz@&ie0*P#O9k|0%8GI|@xY
z5YO0#-%djE9mIx}vi7x0j3K=h+~3S`bxFoPzM#nmm^0?C3)Yvp2i5^tlUbk)k&?P5
zkXwYHJ+a^v=%eDgYD33P+lqawd}`-<w;hTD<YmaSVms3QZhzF)xWB0!D_dp5oO=G3
z^mu@EV(nN<);EOrfcF7=0c^)_h?dZPCg_f5AKUQh;?9HIM$#mmf6w{%Jk&X{ZC!K9
zTsCoZf8!p`y_|d6Cx+^q;Mu@EkbC0D`y%&7!?S$p`MP=MCXlbP?6e_92=1-)4d{S<
zCquG{S^8UQPYk3X7jnY?r?yS)$gc~|0M4-~N0^x}_PD_Ij;XqqaJ~SSsdGJNme*N?
zGm5^eo%}Yq^Sc}0-uMOw=imOs-{)@WdgNW_a#tP1-`-=NcXDPP<V1c;gy0(?`SXpF
zzawNk<}kKG%kPJWGn&p~ynkgbn5WSEus>K6)&_Qh-jgFA{OY>VzKfw)O%V5WHsm}g
zMna#voFh3;QU>Z^3FpOn(HH%*XGZR~Q}*4GPMQ5zsXpja_3UHz=St9BMz&<j7k}c>
z_FI;GhY00M&dgO$JPzuKM{N4|MC~8_hPJyv8G1_U7}F9Vd~I7|qpk^jX;;U<ICg<C
zHNjZ6*5<WuwBD@y$u(!)4eJP$L+c9Yw!f2GKEw?6QeMOCPx=l~=g(vG7^cQR{mwia
zdq{DJ*%NePzw*yLM(inQ7h)(z1)H&b<yxLxPv#FDs2jp<_CsuZo^U(2sgiiq)9wiR
zWXxMI2P0XMtn(B+V@AQx9O}$TKk8iHWdr-5hvHW3Q{|B#{e|dy<^j*XlQcam-|^&w
z?I(YHR-sFONA<h)qju)5>m??2_9M4>v9pY{-lV(DCrNBz{+LV8E$dR}v}Zo{r;Kii
zelDJJz^~#q_?nsHLE472Z*AWdk35GU=b8J4J=qfWEc=(e%${bCPtk<$FI>AkSGax~
z_X1tFNB58+{M_IfQo$bL<wrZkIJ#fa4}CMA<QmGIv)mD!^|tUCkh3B>XUL)VTZeaF
zyeE4Db!JM3CTIssbP<YWcIwC>nmFojK0qEz`H&+yGw;kVbIW*;3q8lhxpl~&HqZoZ
zXF@&W26XD|AM&NYo2R^NJMu@jtafaMF#_Y=Ul7HIHqer-xWB{9TrHnsxR2VOZBG)v
z-{G5B_Nnog`m5AB>n-QW<#!T4=79O=;%NPcU{B1lPg<6-QCA6-fp)7vEWl>n5?f`c
z4334|7gOa*Q`vYwbA5Ed^<CL2gKaLqlS95hy>-hb+l}j<<jy$X$dK<7w0*LFYhz9f
zbM%g*y1z<|U1L@IJH7g&+pp@jA+bNz*;b|XRpO#!|CYP$UG9oi`F4HY`RyO}4(+N>
zjf1_Gtz-XJFn%Mh+gR4Tuszx1VO+FpV(J-q^eh}=>)8k)D8ou={isZvEoeW)N<tFq
zdj6zOtv~$a=lb}&`V;;h*rdb#EwJl5AoyD#l5c@9lKWd9-}~kpYF*3kflFtW&^cun
zhID8T9G)Fwik_T5l%rU`h}%_3jFCiFZiOv<CQTBKo(E=0hyH<JogV73zhkTJ6C>-9
zrb&mRy=10z=pwZDhUnUh{I*&;8*^SgoQF9dqv!8CpPyf6S<cXDpK7;7h@t(y#3@h)
z>hWtxV)K4NXXM~_wsiWVZd`3AHtO(^@8LHz=WsDoF4?xu+)MRSG4b7!l<~*6CFq0m
zyqIcJ+mRDvr@s)4k^Vz42IdLo#a0;_*K<nrZ(#nR`r7ubtZmV24vw*8H@3C(oyxh3
zQ|8`!wKE4W66S^ZVV=5R&Q|UVe27aQ^tVz{c1*`P>5Cuxl0CZx*9g}V9Kp55wYML@
z4o%?ec3pa8ydg>K^KcE2*H*rOPA;%SB<R$WH{)&Wk=!qg8$0!P8_MGXTlEW--(lZx
z{cD`sw(9s$wybqe`jBrEjBh?*I}-2(+AR?U*4WHk3)aN2M!<S)5rXw(U7ujhS^F*G
z0-KrAp{2A=nYc(p9k^_XZ6_fKE?Z*r^W&CJ{<NEgCY^k`VC=v=j6#zRo-^dkd1bDd
z^N}=3xXZVFz46BmQRvwhl71_$!)E=K)KzM|`=QT~G)eER`DXu7Po4c}L;F>TOQ%fV
z<Z=?vE%UuaB&<hescepP){S-CA|AjFGij2vbBun)r(gPqAzDJ7<ok}UI>zO(4(T^d
zwj0kIbJzv<Wmp&7=YaeF7EN&f<NiMc_r<CEVlVJ)HQ0UMq|H%Vo+HGH0_B$A<31eU
z@sPxvg1RBL2tga#5@!~$QQrjZh%p4`2F?%_Y)y3)d;uHvKpQ0X5aeViFF{?UsZ5*0
zIY{S`!+S-(m+6}t-`KXkwZSMf>2Ut-GfVZROaE1-+Q9h&=j1#?`7Pz&G!Dix^7|m)
z1-r)Q?}O-D@b9;HpUU}+vsvVMu4`^8Q)RQI1LZE5L(Y7(owU!h-{8zwXwuDVzL|5;
zQ&P7D?O7Az5u3hPyCshBep}i@z3emg7EFP?!k%-P`Xju@kt5lX72BKaw4p7rOjjAO
zKjC_E9b)J8f}~6w+MNPrx3k1{b4r^}dTqxzJf>ZAY}Db~1$n_rhGY}u-34nAxd&Jy
z<9#r+cC6v+yw90mbP-x#SOwdt2Yk;1#M`20f9wnLnB=3}$el4TmO7qL9r?fZj@r<k
zIHSayxyKkAV`QwfF-tnc2beb?59>&`q5Tj|xDRx|ZdTE$GqkDLjvOL{`#<WJxu`HF
zA$YDF(e$h_l;2T(XxlHa-EFI%>xnbP79n^xuH+Qmw!5C^E8ttfA75eu@eO6_ZtOQz
z-vl{s&CS%jt(;FJ^T}LNhY$X=CEhByd}IUioMJzK9eUz8!~mC(l<BiG$I62>ZWrW9
z-sE^P$E`NB1N0EY0^&Y#*Sl;<oAU+u(S|<hdx|E=jX7j2>_hTx<gDDuzYE4PuJN(w
zxprUIyRO~HYnOWj_Y3YNP3-bK;hAD)+NmG%qfN{E2-iKa>6cu{DFiu^FZr`hi!)$X
zooIUZ#XGXD_h*}Le|n!bF0fGtQ}pDh-4d3>fl$mXW^(?Jk648+9YQ&5F+>xbWhdv^
za$e=!8Uj1@_?ha9pV=BG>l+#~>&LjMqy1KU_h04u<A2Zbr}B|MFozY7+cx`I+K$Ax
zmaW@&WgnDXXK5d#{g5}*SKR)coL5e@t##U>-!WW|TwnD26yuKRzH00z-R(xnAHONO
zh_0MO6PtaIP&T$%Vjp59A$j9E<R~=h?{NI7988yf*rQ?<*tZbc!@%DD#8ka$(komO
z=C->`ebw!M%j#qO|CXF(jQg68P#HXLbuO(R%_q2Q`DCMR{D9j($=dc^J@)En{mH-D
zj@ngf-8cGp)9*KS&-3rd{btRG<+|UATiZC!ze3KEC-Es)u>C~!ull=op_qpCLASL1
zUnzgJucL2%EAcl#Wayh8?8M&ypJbB{9KQ33DSCmjsrJwrWr-o0m^zpA<nZhgl&vFI
zVMvGgLwP1VM=I?q*ScHZ86zZt@=TiK>3^~$p%+5W1+(*+g&ZGfs{0krbsu?Gp7Jw2
z_aJ+2u@^-XoAZ`fI(u!-o}5K>9zLAy6Z9tA5Y%<~;Me3oIja^Tbz}vfDQFiNi<sb;
zOLfNaTWRykM`z}yv-r?iIyhGsC?C$*I%DH=Btw4Kph@3?w&=D6x_mcrIhTvg?|Y4#
zT*-m_Lk!NS33K+2qdLR<zSF6@!S}XJ`9ZZi<~wO$x7}**HAk=D(~}wx8+H2v8+G;_
z%9%N0-B?fd4D*M4m05S{%h;B5Y*VysTi1Q3KRE~cHLoYGw^Mk!Cb=#R{*l+;)^)(O
zuoTY>;$P$Qcp0a4d<?cJ7|&3iJ@@rw{FG&H>4WdLgnUiSD-?6F7xkNzJ<48Pl3nxL
zRM)Z(x2<wN^gm_0x&5N#LLL51ux=IRpyIk}qaE#G7eYGYWGzm@`oMf(%f>z!7fWT<
zn6*BFJu$@oMea6~n>dO&3q5u0Pi?T7Exi(1wybsNLo{)+k1omB7~>EvVJ?j4s>|ki
zWKLoH0Bi6Q_nO(C*zV^@H@D4Y<Vb8grJZ%xAxFXelFv+<<c;erw|q=UH#N5VJed!3
z$-M5w^UfN;N<z}GR+XvpNmx^ZjXKk%196Bu68a_wa;mvL=_~Wb7abpu^GWWUlPP)Q
zy2!b5xv9)`-39kK?mgV|xc|NGPr65O-{-z`bgx>;;J)<$^+(XAsVy;xMNDEJNx(+k
z&bT#}V-UyCKQZyI(8tJrhzFFLz@PR*yq^D@0Sb+?M}fL6LeK`#0s9kE_9i%EyzbwU
zp?f)SPq%E+Imb+$Tc*C1ZN8)NU5&rP)3>&nbV&$(v%6VovvfUWGo-f*Z0}g5ZAdrH
z!*XVRTM`<7J1F=@$T&`ZBMiP1@_kS=#wkJ^o#i;AaW<Qp2hL}PaxYM(jyW?U=X0l|
zjL%ZM&76v!yyiG<Ro}7=`O}x<J8mc*>&H5dT<efr+5;{39{cHueeFq?Lw5Eed-4eO
zJj`TEKH>VVdfL$*M$v71lK9cLal0csF%9J<sJE|k#ztMme)}4)+u(byHk1wZFcRW4
zaWu!wbI<FI`JZ_mEv*Y{1gue)9ne?WscT|uU0GZ9L_DlNHlY6GKA;V4i2+LxpZ<^F
z+9sd67Z@+&IKpehm^>bjW2+s|-cV+&M@+@JAx0EDS5?;fC!H8GX_D_C2Oys(T-Q|}
z%DaL;akn71Rpw)Bk8!UbVkPLcj6Di>nL2D0Y&SzT`tzPfrwz}u`39bMz_ZT`>1IoZ
zxWG2Vt1Y=`?92o6bHr2`+tFM!)sqL1(`%0KV^6WywEr4=QTIjQ{y1}QvIk#r)h^Wj
z&b28AAeWu=JR@*Us9>)|`qQ4cQ_u%_4$<f@_cH6vb-;Du>!hoUopoo;fiW|7z|L4%
zk9#fZILIByqf&ir$Ioo(23r#zN596xcnsqrpDD<VyvY;DAIQB4=6-98tW{|2tk>k3
zp*3UOw$_QYW6ivNx1<gq)-=RYJ7Tc5#HKIuA!o)Aj78_d5S$k|M{>4YV)8zW_h)*S
zc6g_z_ii`XVI^JCgxbOu#A)IvCJ_5%KSL7e6I|Xs^N~Dxp6!x`e4(Wu{$^&I*SS}F
zku{qdv&YTer0%FazO;*ib8t@Qk3aM6%G=n6{A6?8%yGNy_Dk*Gfe&@aCqC8T?|Nj_
zsRP?@>H1sVes|ga9wXAWCt3ZTeDC<RT;o+cdaZlX@fjk@n(y2PQ?e!AV@UQ2xDG$q
z54aB5e!y{&tI(x$U9wL{(j?8%9)>B{&o^A#x9wedW}J8OZb$52WvLDP)UNjRE55be
zJ&vRCdESuY2e#@z@l*SMRedY#Z=JrZBPl<zWq;zyw_P#cm6_KY=H9j~{T+_^uD;r*
z;#6wguj)09^{)8fvgMP_b(Z*i%hCRaZ~g5zf9S*Y$e-BqsdycbKiR8q)oVNST37X<
zZ-Fg2eB%@IfiBxk==@=pbQpyu{buVtGV@GwbpBWg=Me}!pDH__(KBU}1V2M~Zu|~i
z?M!s_nb?NJwl9Xt&;-wi`2hBt>ep3&6I$z^Sn~OXk@t$3dzAe>#O932nJdr0M`zx}
z`IFx)oOQ)e8Jg%SFP%}5lqct8omF4wRmE5ZVn)_ANi(Fw79sEh+MdFzUVR+S+d3O_
z#^&5ScxR+{Nul>jQ?v_g)D8Kx{5R-FZHC$sqjPT8`F)EiUa>iQqpL5*6*;z+d6FCR
zG!y3STSC5uIR}^DN&8u@Z0E8i?RQ}o-FAHNC&m%|fAR80SC*u(wyjJdf36*vf+?7S
zDVTyOZ_Q|}aWr_bGqbAuoR2vKLI@!Ug4o&B+5<>K9oQR&I`+^D)VHX1)X_5zV-695
zoUw-9Q{=U?p6oH&WOD?Pb!RX1guGK;;t1NYW1OYfcrJLJ>a*zQ5NZ7>W%TsnIpdiL
z;dyrXHN;e5%q_45$`!X)T`kjY8h!-+nNK7=$E3}+TjkJr=IN(g@a%Pdo6>$B`j%v0
zQ|GyS@+M!{8pe9V?X!&O@|MorI_gc}b0xQb>$}<wx+Ca&`}7=#=DU(337lQPn!zrx
zmV<pDSl^j&Ru8cS?}lEu-xt_HOX)tgqwh*6qqjYM47x37$Iehk54Lfgwu<%GLAyBZ
zpE-8PC@_B@7fp~Oa@7;((z*Rf+P+Hn8CsKy^(WU0>2YsaZQReYwtXsNJA@_WPhev^
zm#aK#H#N?gxkK)RoRZr&mh|BDU~Q&2g?k;TyB*s~S3Lwi8LtV);n=$3@?1vAfpwmj
z>y{&JL(=T>th-E`ZI{a6dSqXoVV-B6Z_ei?o-<qLJNJV2!qoZCor3r5$#*c4vuj9y
z1U6f^KjohNu!-#dysJwe>^&}h<_GWvjAg3MW3-GBNqiNzac2lIbbsJpadZv?WpuRl
z<hJ9?Ui|jQog|@*?m5rZ9%Ac!51sS;Te_w@P0#zz*5B6#e`6DezYB_)bV(B`f5+0_
z_RLWEH`pG(9%rh23dBWxumtxsVxP&8WIo*Gy5@ES_cY#V$L}@nY)Q?L^F)4TawLJ=
z8`faItOM=j8Q+ZM@n#vz>(GmT`q`h?_Go?C4_mM|4Rx3W+px!0awNT1xAx@?dwL0;
zt(hFjiuGN36Drfs&qPz%pj!eP+gqXo+TmPSKct5y;+NcWqfXx?Jig_T4rnt&<q-61
zqAPdglr`vrwek8;_u35En5Obd`;avB8={GOFQKO$u<v3fM-rd-55>cJ5}W5nycP5?
zMN8-dOZ0>?I_$8oplcWCu<=+!<5sN42HPg^kEFg6%IF!t7pR-6|5OgySFk&R@feGE
zh;NA_SobNm;9c^@;5$Hs-Z{X#=MA@GOP`jKx^;}hxE`N6ZEt<upEkyu;)teqU}dNd
zJK<gFGJ5(1{h6b3z&_%fdCni5L!3wKzpcIGJWX<?ys-zH+Wj8zIr_X4basaN2WJ}R
zAb!bz=9YPyL78=6&&ns~8&GyX)~74Rp?q}W6~qpdLp*KR$R9C2<E7u=*}!L>vClcH
z^2)hkPrur?t1mv9+8BS~mptW~FfQYNf_BqY2G?&%TO_OO3FZWh3G4}CAQx~H6LCQZ
z;$$x5llWOT&H?h+Sp(LLIV%_B<B$VEUP6$USzvwrKC+}8d-{{tU>tHpOqv7x>u8^G
zH;lY99!c(z+%x&UX!;#(^Lv_pXXE#_KY>0WhWg{@$RAA6MTnts>K&K5bz5;vK}_of
z$BGTM)eq(Bi#j$pwGZ}7AaBqU@1MdvVP2q%1mB;q%`I>H+FskN?-~nSM`AY$?pJMG
z#%{KM_RG=!W<RsP8|M|@I%>nlKB}~jH(Bj!dC1p|+u!{3oZl_yrKc}`>^oF8TXUGA
ziF?mcH?#w`uz$dIw`}SM_PcVAcgaY|?MRv=@XY=j-u(RJcXCdMUL<7`D&H*ajSB5|
z-8#$K?y}pEm0rfb%TsM|gy%a-E?supzm<$r!QWl~w`17npZXau^ZulJ^IhlhoAS)u
z|5n;(weRV}vbOzHK4pB$mAAfKHs)?ef9t5D|A~;zzoGiKpQ`)Q^87HDBfatZQ+N4q
zr2AXq<NxCCf!t48!o6iCUGnDWT>vW?k|FljKTOH*c(ZHjb90);xae80l5)JT^)7g0
ze53!=W<RvwH0ciKRx%~u=+eVtkFcl8_sP!tFL&OiJ3`lebL9Q@`8H9x33NA0I_wX3
zRQhsn#!vcODnI(-bL!3v_BpdJ{U-Nt!F?S`|0f>Zg}3g-o%^xAeI~yh<!@w5zb%E>
z`rWC5t_#}vZkh?dL52GAZN+a;jr%$GcjlLKU|b+3<}ylL+{0mA9M#`w%JnC($4?g_
zm@`mEPe0b`=Jt2eo<5ac>ey6&TYhgsd&3Ns%~Bbt(`Sm7(mo>FYCB^R19NI(DxV?9
za}!%@k3>h?5nZfoXK%3nK$(8D;|ssUaWpQ^!4f==^_iqR#VJq^!Lzh^ZZd9ST>@#k
z$`C16w%v1g4v6Q*ZOFT=)|=YR(Ks$+vjzEej%g=f>{<41=X+7`{dsaPJ9pUd9P`W}
zsgqA~iH}kC8-8JlE<&(&NOVWkxQGqV(T2@$z!s{nEg!%fhgivx^!YW*`NrA-YY(jF
z61^!V!I?h97Q7>RzB7>MOl@0fV|i3>dJh3*a9htZI@`>AcfHBm2mRv*u&H2A+(Wd&
z(R^VhAxSRCNfYFW-1UT<I={E1t+u=FzLwUn558!(?I&p;e=0wXiGE}}mY-~o?10#2
zVXJJ&9XYHl)s6G)x+VHbSN#*!jxs(*(j?z-e2%;4y1q%<d?(-fRh@H1E{6!gvpPi+
zJj-2hR&X|Ru0U``>73blh98|hoIgWw9xdMM`McT4^J}P%p7uyPpK<&)#`}5+?9n&b
z;g2(oahk^CY`Z}}GY(>~?;{_*#4+W!<2xnwBZ$jTM<0S%hznYglwDscW81S&?T5|I
z-vyB)ZJWm13FA)nrH$VTx&Lr~;T|(|pE<tk<lo>LcOm_K4)|N$O_%OBobqo0-^%u3
z|66_;dn8K|xQjs-Q*a+6Zth||?_x)id2uJ>j`z${`5-6c$kbe+BPUCcpCiZ{`9fB<
z>a6ohLJ~Xr(cgY&j)@L`^urb?1O2S;>F?lAdvWK!?d-`5_8i#8b=xhqHSJOMDSJ7t
zeY{kMBYHk#TM~HgT&{AaU6-Vv!4FWU&309yH&svBdZc~c68|HiY^*~@f%+0hFvb?l
ztAY-?z>YrTioB6W)_}E`0(q~CbB<&ku)k^P!+!7u)D1S~?!VOrj6qCG96^jT*EKS3
z>gYc~`_4Yh)x7oh82F-}`_doi<9^g>r;p>KPWwnGSDTP6cz*Z1sW)N$E;;CBoTGBf
z@$tW}ahJx0ld#tF1@-}ZV~CZ6-b29qsN!~PZI2y#>P_IUj${9{xxLHA5T9d3(idO&
zodx2kW39A757hCGk0&?E+tL}s*~Izgvnf=jj%>UubXM{X;5^+rSAlbtvvlbU#kS!`
z`_^j{DsRp;K^rW5%Kq`8Gn})Y|Lz0Hng00Yor7KaBF@P5Ig*rFW1f#LW=i}MKk;;d
zBzER-GCq9Tei4tbj<}cnvQHRe<(RC&lQZSbd7PPZ*O8Hs<BIjw*7n#9(JprG59T`r
z`<6T~?-1;F;zhdLR6d!DK`xZ{E|@#{9D@9ilau*zp2!vD5WE)+dip#*<dZR*Vj(BY
zi@RCVosfGZ_s%K!Uf{cdZwS6ArZ{5gn}xsm^@QK!K4F`X4gJ91HTc7Ch^2Ar_X*<y
zdZ66IR$No`0(IC0Yz=M9i}`Uc9g^#1o{X^)`qJ;n4qN0_9lh<4Ke1#3%<;x^_xx>(
zPnZ8UB>o}9)|_V2QlhsFa%CNTlg%c7+Ar+)5L5eyygEnN!T5ot_BX!khy4-c?oXi~
z;A0d*WwSNEDZK8TeR8pKKQ!3^_LZ&rCv4ZUFXL43-II_c*T9~ImOS|;=l=&xjqx2_
z?GOoj<0l5^jo9oR?IHG(St^6;k>w-FUZWrVSK@Jz!~yf-s9td%KgnwQR-P~ZtImC_
zyX)5fjkK?SE9>0x<$5h!hkP4vW*%yrbyd<{>z~S9cE&c;DO+0q8%ZDYW`EN6Tbuj+
ztql488`#(Mvvk?}{Y}1&)63i`&x_hl+j+t3UiZPDly9G1|1Pi+s#muD4d8g8Nmn_#
zPrxj6l_T*zW9vNu^8>s?&euOINf?Dt`KGqJTy1vKcuA9d!)N}~8GqCB{J-_CyZtBm
zTl>&>u=I?-;kJ?Qo}K&XuusMF{?9X;bGvh1bMMuCmpkTj&&~TfcXsZ#OK=C?V#sDC
zp*}$0Lx1_f*G@?tJz#T#9(&#y#Bwqo>=<)$kJeq7@1Vy0Sl>O+1>Zqa-$N&VgX$@%
zqkq12USy~rJl|20_~mZSSj=~F*Vp*OPF%#)^d2K`TaZKK8*W3w_<-&3(FAkvg7JX*
z%(1Eu`qjR!TUYCp$2Tms!AZLI3AkRR+iE*~KQYt>%<tr!$fwu8v%cCx?4>5ySI`CP
zzS(yPW%St6f6I^a!x+TG8OOe#Vl>$ZKjZ!Df6C}-ZvtET&=()fg?Pz(yCgc=BIm`p
zKp%5d2G@U*L$;Mry+RvxWQ91M`70NbyeMBG$Q!vNw?UrN_UQAQbZCFW7JPp@uaB*A
z$~rM`WEbRl2xO?fg!542Ax2`N4O+pvD!1C{V;@Upb5v$6X0j!LHG*-mRQI|cttIQr
zx~~t=)@0Lj-R&Pg^zUlt-NXBc_fvgeQAP(x?QbmUVH84TsPDC=G2m!CW8IV<ws7Ct
zAA8~qu{D><P#u^HOy(paVV>l$3FbaO;Jn<Det?fp{Kkg9w)?HTW4Y_|mvixW#IO?Q
z$C8{G>yYT?FTl=J`z`%%aGx&wqZol$$1lN_KJ>pqZ$7ore-uJxL*B{t^Q`K54W8wE
z=BLgG&WffpV{u;V3_5u>aXxjynZ(&M3h0|`ZBHBLROdG|y_<&!l_$Taq31U-+2E6N
z?iq_SPcZfkdYGaM-X-+K5B^WyEt>8XhdV*uGq`swK|8<GZNXgu>2i&&DK_F;7wBl)
z{1#YXJ_bED*scq7v|&rUQ{xjCcOhc!iuw5sSNENkccQ6#5O*So!qV@(pQv^&-?r9U
zcKM#kksRgDMO?6wBT2mTLw>vF#oWkkXrAPj`2yt%x}N!S?#K~kAZMZVWsOhLv}Y*K
z)Gyg!M?atpOGMhy=h=_!$t+X1j{RKe>?^S@j_MWmdxgEvUViqb_UGaG$$iV-Wlvjr
ze-EBB!87+8u!Sb@WvIhQ=`!^te)5eCU~ihrw}0!V#_obS0%btI6Kr9KC29=R(PK~l
zC59k><gp3ox~_wDv>WUz=;_l%T%fbw<y$V<z!CV`A`}}C;~PtQI0?CM*%F=g*bWf_
z|1gu^j7Q(fQvHZJ26gm9glO`A&kY^(MBfY4(bGN)TV;b!!x&2(K@3yui>CE9to=%k
zBy>FkFvU(<zL%(@@1ojLx6b}<IpjM8@ial4Ax4?I=gQoA&I4Qe(Ent7EB!D}zy{yw
z-G*Pz9?n3{cg{=*o%fuLKKGC<ZKm3Lg6-3f_ZDYno@GetA$-142kJv(adscQAA-LL
z^0z@j8Qs>|zSPcG*z!&s>f7)uI8%|Fy-Rx94E~9gKD@VpGWwopb<Z;yA45b+^qjTq
zFY;^}dCDA)%<tBEdd-p4->}V)4Y-c&k*^R_Ys310*K27!=t)Qd>(06n(^QNhh`ANE
z=HVQ9e&niUzJgpTALJ&;O}-<M)O&Iy2YJI@eer=m^0YMG6N}=1=Egluceky3Am0T`
zAVZ)7%17}1!FR?KM>Kusz(`!Tv<;FzT`c*)&;0tw=aOH;7<{(??FRi4A!<xRb=s;u
zWpuP*+me~{K)(bwcR%#B!`<#!s-*vo+pWisvCcL~bhTc~TWvSwu2S3Gx2xaDd5{C<
zj*Qf;5)*b6_eD2EQ@^G?!oKGjdiFlw;Mbm6vV8+T2H!9*tbdcX-Ri@<$1nM9j+WvJ
z;XE;4o(DsH3fi$7FW}=R=obb20luLX7<(mMG6dgL-?7v_{u26r;`WK1bxq~1y)b{E
zvtN><vlLdItL&>OTEhNv8A)5DJw6y~7l;8I(^C1jxKEYzt@T=NITo_U;BsxRWw+n5
z+Psy=hgg>MK)cI7No>tewr}n3Yx!nloo)VBHpL2m+yCG8^Z37!UQ=vcMt<t+wrcw~
z<xl<{$9L`H%I$ioqvPBG%Ac^!C%dD+^O>dc8{_)>V5n}k?iMf;?h>%_KEa(LlC5_G
z@Q&d8uhQl7rT)V2m9Fw9PLpk78`qcgBMHejINyQu{oi0ef9tE2cZ<tM>k8`wUHV9N
z?vIn_@6dV7xy*flJ23ZM?zr4-yY98zX^-xjNbb4lY43RtKIQ(49Sqq{>A9QY55HS5
z#>#sK?*`K~J`l$)P=D<4!8rKVJ(xQ&cVxaxn(+4!-z(4WQRO!(zGI-N4QPi|2z}%D
zJBK^@bH`@B8aEUtu@P6x_Z;s#2<6aF9|hakuFKZU%)KT0DAc|#yWRCFM;VuLZF4`y
zn8}eeP5a>!wn5H+L08`p#6=!iSJs}~);&kQpYIv%8}?NfeB-d6fHFGo!IpappNzrY
z<~f-8tny4RafF|FOLRc{5FzMCf1Z_-F_X_$aQw`HGVRQb@n?bl-%)LAx%RQXU;e8N
zW$dsazr<sn7<u-14wbvD=cgxA(zMJiIp=vDS{LSqzmQ+R|0is7kMB6%B(`ARQ~u$I
zx*vzuly&v_)wMR2#aao@!Yx=!*7OM0dKRdoUt)+5^a098V6z49m?d~0@m`wZ2)>6$
zLb*aaVB19q`*4{$4ABbI(PIZanUZh{)VshQAH+KavBPO<6GMbxep56-uE<#zkx(}1
z$TyICaNYJ*y5B8-W8*&6_EXum$Tu6uh$LocrEJ}s+_JlUdc39ajCDxsENff5#OQYH
zk6<lW6W9gT3s^gF9h)ZTYwXMZ+>X4NWsIF=`?f@nT@xPTmW&yKoHfBS8^X^s&pPMM
z;tbK*!+FB_!`TvoGid4eE8ej)f6t=Mxx_hyP3Iiqtmll94ZnTy+abT1ErBl7=kCWC
zLu2tC=?P`V2g*zE-XJ#f)YZ<Ik6(?!m`&r19A{@7Q}>RgI|p|UWLKU02=US9B*Y1>
zSBYQd0Qd#Z=VUIBD;biNP@O(a;J1qq{7%UIg&2v;aW=)d{d;k__xLUp(gF7*m*1rC
zQkK<brQah7J?~W9s~DRY%uv~^%pozu5zK+P?1Z^7$CZ-u-FBp#C70xgIyo}v4!O&{
z#(tx0hU)BrQ=kr`K>Y~zDH6~@Ef3X0AXl~>N&3MQjeVDUll|Gn6ess7dvoMo<-Wvo
zb$+1f`Mdel2Y+2efx7jSE9j5FKhL?@D&M%R$|gJd<EM*w!Otaa*qEg<oC5VO=tIuP
zU!<Ipa0=AB2tnQrb)apEQ=pC>+aa3Rxqhr6YiX!&fep4xME1we`2gz-<HGt|;s<}w
zlaK`0r^*%UtEBxTb&NX>>Tbs#AI!~jq&^GOquAIEX`0I5`cfI_NB=2~@VH3gFk9u&
z+5>xF6^_cle!Fqo-Cp&p`06S{2*w0rXo47n7!@~b&pzN8H`LM7jve!%FHr6RJ(4;;
zX+u({4PTsHoQa&5oT)9L9OXQv>~`c(eRH<zeDwL(IR{n8A7?J@lsQ))J0yM7pR<1H
z?}0s`%-;uL=KG?_j<_Cw>0{wfKG4HS(3!1rr7=H2Y{a@m;|`GcoDSt<h$YA`Y%xlX
zok!M;wOir{pGCWzSHX9Pu+BEf_HthBYmHbt_AP5n9K=I>#7pcgp=_)>IZx(0@?FLJ
zS&I<ll)N}kv*fR<Or19D=tJKvKln3@K|JJ#ypRj#%AC2c!4gMw-Q_lSI^FRGcfl{U
z=^KM@jxFl<&UfWezK!VT@0Bfo_&n_&C{KajP(Ny4q9>HmwXc8du>tBQ+m@v1Dg*T+
z+;4yVGfwUMoeg%jZ7TnkljBzTU0=p9JIhFy-BxA8PUCbD31xKW2k2YDo_-;?|4+U%
zxZg`sUxK#&4fL-Z)$15PmB*L%oY*3?=X%2abNNk%+6{dHKc=Y+Q}J}cT!z@18}ox+
z%IKLhHj#bk_r{dIf=v_{3-AT4z&J23y6WV96^6<;A>B{7kL_HyT<I6-vfHYR9E-C7
zW}&HUI72u~LU6{wNQtgz`;ok{59Aa(@z^yUmsiGZX?>NEvHwPT%r{9)Z?x1Sf1>u^
z*Zl7I>KyL!y4H*OZS$$_zW=3UEc{hT`A-Pho7&I1PqNznw*1N0Px{;coBeI`Qym|+
zq5NCi=WpfGSl@B3cIvmT_V?fUev(^v1K^HeTHY6q?g}sy?hR2`I_pQFsa)A#@|{dc
z=*emFEmlgGshgqlO{5NKw$5>wDP5*+&>3`;k^cqw`p#cdyE(j1k|kN`s>9aWHqmt^
z4bEwu+1!`8D+ZEp6Wt%VbGL*$<#X4So^KWI#enV99hkc=cTs+SL2?hJf6$)yP>;bl
zBgeuA?eL5(J$5tSBS`ABHEiVXXgqu~2ID>VVeZBH?%4W1;adi}@NZQ9&C1fhTVYSX
zQ2!&ihfn$Jnh*2s8t)lfafEV3zE-}^$Y158{!Lap%JT<qd+PSf_(N>PM1CshBHOV$
zqWbc<TmFE30Ha`?ZQSQ?WY4&XWrz^O%bG5MY^B~+55c}*y~#iOE41D#zjKhA?<@A5
z+Mho7)mTgOnA+n*&jinJFD#XhXkW4^P)EO#F3I!8GsW{lZkPwLuZ-;(S7Y-n7?LOB
zApgu2d*VSF>c+Y^iOrkdI@%4oqw$7dY;sFJk<^KqHYD|v`6aiW1Mx%8d60YNi4XT*
z>VFc-5CWfu`Y8IA;~}x3?IcUmpu6X`H81udxo1rw^88|bZ;o`V7wgX2MUzj#njXO#
z-|I{p^den8(y>P(-#<r^_Y?1`EqI6deTG~wpvM;I2R*^xDvVOb2HP!K8OLMzor{0k
zvBy`4t(bw>p(RK2fhD>iN93v{<PXSePeRhUuhM#?>80PlDcj#~WR1yX`cZa&>xXpE
zKHzrby0EX?H}zilWLIsb>~D^AUI!%WVyfO{w{6+|hR8K%-C2J_9YWv-zwHCW2*ln+
z2y(?a#B)6JS&wpd`+VVC;e6pYsiSk8yF%y;=l3gq$C|?T2JQ|+P^XP|JHL5Nfn2I%
zk4@+Ok1yU0g7-D=ge|zgFdpL?&T61O#Sxr?NI+-0$|3N9PvT~rXS|F(6bJDjiHVpE
zb?7N6pBJ!aE?bZj=5&Le_G+`z4jq0OCj{}3GiU{J=R9_m`HglZ&;94RJ2l;ljPFoY
zx(zv#EeRoC__TjZbPxsWmUJf}zM1h7GcXtCv;^}6<_xY+m5&&iD{@1*CA3jSKb1e$
zawI$VQP&!?)-Cr@X#Lp(KpCF>rS>H|?13_z0{Rg6W*m=!&R_#e9Kl}0KjR(2K4edB
z!CoD_n-iY3&U;$$j;$Q&Dz%L=ZS<=)E~7VH<xgO95`2!rR@sEk2j~Urw9}^v{NS&D
zfHpW6)+4(JL5|2(%~{PGW!u<}99P_zc5GKd8ED6zHDay2Cs;#hT0_<{$~xL-^=H3t
zlKE7a8`u^<Epa@=)PDhXZ*1u+_Rm<~jYl3<&XsbPAM4QH4Czd$4CK&Icl%Nqe=~7>
z#OAmxmvrRFd7CQ##E}iK54|6~C*6jRF7WTMn##mPY{W?HtU2qyl9oE!n9mXP!AGP|
z{8Fba(vNNN{gl~LIzyJuuFjdKbCC10i=i`@vw0?zL;9w3^RdG=p)Y43?-cxTCLNVW
z`o(U_W(#bG>WqQ!p}zrc{uU^Z)K~spFx1|2eBz-G<4<u^CLZ*yKpnQAePticd&YGv
zj&~5N^59$|$!|zU8*}L@Pjs2fD!X(obI*Euy;<|R?ptlNvo1&Lvc$7ql3V>DR0j0M
zI@%d$<ysQsR9wVHti(yYO_2L8SP#P*18c(ESqs*L^#Jm+1UZ5b<P1rD3GB9@KYl8V
zv&G7M9b!_9PrQozFi*{$oN!Jb&TZZGg8ODuS>G8=-y9>qQ9|D!pXhv_6qd?>F2wVV
zBR^9<@yj<1P=;B`=-1afLwde-p7@$<@;-Ycr|Ps}Q>i-2TXrxL%C=cw|1<7T8U0i{
z{)b>Z>bvy8&bBUFF13N{pX7ITP5mo7$G_#wIJfTXeA}>=+~aG^*z|-l?1FVYZ7iAp
zjoXkj*~M3ld3^oP94MQmvSHn!zu>kv>Hf%3Xe#fFt4orHAwrO&3Ob;DiIdRJpmP~H
z6YJauxn3C3MN-S?91H8!#L?QZhK9BLQ{w7lU$?|BwtoV@+nAv;w1jiyjVb*NcJ$qX
z@rk9fREMey)&Ca80mf_zG2C%|s(0D`g!^vUdW>5#er2g{?zz>u-{orSHtSr!<y8JE
zcl)Qh`?x*II-sL|OWUCT4cPz2?mL^AK9J@+`|sMK#8b=kng0U%{|#?r+K=0)zm=`~
zFXhm?y~4Zx6WjrACU*kSlB2WVER~@rAqo5IAAHtx&cAV*e2JNKNr(@umowWs`nddm
zDTiYE#2p8A?V`R{c(-)1v_FQ}I&)5*XU`pw`>^hXL-$$k*4$^gGa^H}&V5&R#^=7A
z_eT01mC-G=LEuL;wE^wu=#O9S$G#gQ4R>Z(v|}fG{L!Cr!2a;x(=Rb`rzK8&P2G99
z2Xi;(p3I$@?~|VJokAHM?Grof)$a&mc;dXq-x@zMUrX{6<g~U?hnDXf<b0v(ZEHK%
ztHfsr@<NVko`|)pZRNQ3^Cq`qc>~+_0mi;zte#_1zT0VI{a82F42F2>(lZa*XRa-h
zI(j&&FWIw4S#S2FdDfpc`f8lueB~~s=YeN;igUr4!5QMSgZ3^$@ND^c;<<VJ$#0kc
zt?`e>9yvaeI(piPIfx-4cH#;_{Ma0^r6<;vP&U>b>7cFy>r&UoHeGi3#5ZGvU_2!C
zBZviB;`&w{LOuXrus%Rr2>Q1Rbhj`3oTSdBmOZbn`H^okR9@l;)?z31tYf{vYv(fS
zc?9dc6UxxUR9mNAec3OJMI6LMyh!3<>?RxRc?a>%;=Q-7_aF5e>>$KeKcIh0j{H^7
z)4m0Lfc~(=5ncZV-%v*%f`0hwA_{fx%=<LiiY`KsFLJ;ffgF=-ATK};)(>C<?(<tY
z%Q$a+?skv!Te*lS3CRlUTkE#_Te;-_jUzoY%@vr_PC_|{k<xYRmh^9o)LUY63aoF1
zHrH)OpCO`f*NKyui9f_p&SpOUle0zV%+26D&a?7)pX<Ha^nPA?*EYfLR{re@UFhA*
zI~XV%+w(p@yw4@E8Rd7a=iTpniq7JdXL8f{#Bj5vtI*yA=Qw>s5HpN~F<@#Q+!2_|
zEb%(dnQ?Nrh-66;J98j@=5MIO6g|P#(03%1(PK-0#vJJj9c|b~vUSHX+;@z1Rk{t?
z67EX;UfV?!_$}AJ=hAkAZEatwAA#RGP94i*y4`j9xj${pZ;6voMh8tf2<77l_K2Zw
zmdX|M*s+$+{w({7wcok^E>o|df1^o%xJ!y9pF89Eld*g5WA<n0dE%Ke)Y-${yX;@v
zEw%B^=h@uien+Ew(|@wVc8Vjv_#P>H>S@CU@G%NY<<MDigC4ML!u>6$d@)|7ONZVz
zNa|hKZe@HSNq&Ix5N@MvLS?vZX<y<9{MRwi(FP&t+XQC^YX+2$m@hHV-{8ZHQg*w?
zuH#qx$nlARu_{gV-%$J1a_!4pDsHpA>&zRlt!?PK;MoaDpbnJL^BnQq+|XwGC0pnP
z>yC89!MNmQWIm5%&7;dR_s?&n``~M(Z~X5ZkFkUC6>HZs&-;mIo^u5#bH4EI;9Ou%
z#C_*zWPi>K{5(EAC)uMPoMAfeHs_(>jO?6~oXh$5Ipk0sJ?)&Q*wUxxS^4;pFQnfe
z_=S@;$WB@Pf^p<G^!GsiKKO?JW{4f*KmF7{1aS~!6I1QjAORir#7m6C<Fk_Zf;khX
z^61=<$0uLP3;Ad5kzJ5C+FF9GLAS)jMtyp&DQjD4+8@UHC7Uin(AR90(N$=x@h~Q1
zPsP%SM{5bsno6=qI`h*!nKMMPdFSUle&w2wQ*w2Kz6<QmH;`k-a88Mf_zdw9KXW1v
zp>z6hX6yd<+y}WkeyP8{HAeYf;alVrU2Sh*zvKfyO>FtZuc2ObUG<}}mmr4SWGh-i
zxq_bhzCcGC9L)!oV17;W?A&uDxdYRev6cuiRS((DycZ*f?CAfr$p-t1`!)47TV<fl
zSof2h>h~Q#^=CY6@WI@f=QDTaE4p;(p~>buY<EldVGOfXe#7%0U;mT0r81m^wXazJ
zNz&I0l_A8=c!+n2E<!MG7%#XDi7kC#6^_a`wcX{OeJrg<qPq#{z_B&Oz&9DN_inm$
zzv1pjz4i;$m!1KhgEv04p*MHGrZ(7mzKnIZ?J9nV<xi;daM}Ism+@MOWh$mOy7Y!~
z&@7c<h!C^9H~jvvJb9K<#}3@K)W&;+GnaQ0l6Od#9y|Oq{uaaxtKfP4sdQd$`JErz
zerH1)@%>~&dryw+{}z1E*S>CPzt-E<()udh$I@-CTUNcxmbS4(PucC3wcWa(<diS-
zX6rV~H=DoF+25PAzoYkfWvc!gy6hm5rSl#}p{Wd;b6m`%UuEhyr^#P3Bq5T``T8G&
z?>C=Q<CweM`ky5Is!dbf9K9bXBX5>;U2N^2AsYLLXH^W&7|t`DIg9g1_rRgM;np2>
za!(aa_290^{ZKa8HO?<Vzau(l;l+}E%BH8^#ho*u+~so?7#siie)`H^<NW&oZ9x1L
z;vlAx<KypS+{A9s(Y6J)u*4BPeR}Mrao!+@6>O+mx?JmB?Z0Kp7O<~n>XG1k6yC;i
zU*svisP`8_I)guB-7S0iK#%Q6nxtWk$Ze2g<vz&2_LTS4WS!K8o%>jh^tU7{=&@hv
zbLSpqU0K5?F7`gpMpF*I<U7w2%23aYC7U4v+kC#J`iGdzP2&uW!E@2``CuP27viUV
zYTRcIl7l+2sGZp8`}CJw%%3*dwCod_56~Y!K$&^MN{%GF)kFHGKKLE-e>9F^Jak)x
z+Oat~zQ<xbe85Oa89jc@R2jCgt?kh_ar?&3woBzB$m<rIOO}+EAn%-AtO1;)o_n=z
zXw6u=E|xfgHQpk$?l<UZU$P5<U;IVl7|_x7*kI2d;+<9gK1X@+ZJX3K{)R_=sI3Y5
z&ZJ8o`2+ld>$G7<ANnp~zf=B9R~cx>ZmW;|+UJnpNIdVRxtykcqKgn)^CXYJoZ)2N
z$wR*g)hlkF(*G&vrH}m~<AU}13Hnr<p*}ZFy6?b#C6s@Q`&4<);jP{kGt6%|Y6Gtk
z>s7HHS@o1_o7=bam7zNRiJ=STz`S{0d2UA%lAHncnde;LoZ;MSoOQhSbzbrtROk0T
z{Z<wH#w9ktd+}RXf#1g9h)KV^FW@WWbLQE}7{K|4j<!lq{gH$z(1lpURlqlFo#&R6
zr{Ii-qd0(gcn2^iVkFiO%&+k~o94wlnWLdT#Sz#s?;G?@V1s=Kay5i=hK{x=j=<i~
z-=L!%yDlOn^^;KU!eiXOFHU}+6<s{P>GHd-7)kIOu71m{psU#SU@Je&C30NGrfeKX
zlMS{oud(ri&VFY4vX6s5tp)4C`mle@RvD-_fz1-VK%F-1R<1YFYmPotciYJ_?S?iu
zf_=jt0?O#|!Ptx&Vr#7ob@WR(j*-6bF|<e7zwG5x=ql63-i0NwX)o`3-pv)>(*`}y
zas}Oz4bSy1&l_Vh2G3xq4I4NK{VMp}FQCVce)fUv7qnNfF+FWVk{F2znmCFPD5Kji
zpufQmfA(#O4yqseHo-XLq^GRoV&gvcQKj3E*c$4#>p8aTOKpH{OBiz(X2w!wZGS6Q
z+gk4ORiSMs9v_L0wwt4U8G>hlea*8l3)DmUH?W5zn)>rRz!vx%VkJkCv5AA+EJ4o5
z-@HKgMzwQ$T(;El&72vJ@rh?CM&@$#9P>>3T;@5i&v)c}=mV|vZR!vBLC^dG)aUW1
zbF%08h}?p6uxSj&^tc^eIa7Uha#pUiow7gTiP<q}+^1c3^uY%_WAQgU{XLI=H`o%&
z5czk$$Bwb(hnNBXz<672#LPP)63U$M=!u(o5(DzF$6wZa#*E)5Z{%KUz*-=?AYZ49
zjcpezp>1Yvv3LI=AFxDS^Z8-#cpqR-Km5!Dzw8TQVJyakE+TPWEQfLgEpx?O$-&h8
zkJf<o2tl5vXo9@KN=X?#V6zkYEpY_?$mhbh#$Y^RTH+L_lVj$<e3<Xx%;p}bd*SA;
z*reAtM$`8P-yp&F$_MyP`2>CF4>M_!N4{5~s|+Fdrt$X-add%%lh6*MFx9qn*X4fO
zH5b<JuuhsI^Ftq{f9*>de@E?8^a6D_0-M^8dhLf@FNDfZOp1##ZSw{6p9r-XY-Zu8
zT&ZncZSjXVR%Gp4_1~4<hq31iM>=rc$mK40{i_a}H=6X7lfJuTh@m+&!F~q5ec)&x
zfa_B_*ai9lK42yI1=rpFowRM0*tZMDCyt&FBYXB{NcS7=e$?GBR0e*h0e=fFo|_jq
z8*UoE_56Y%8`yt<`&9Xx{!L>L=PcZDyS>XM3X3yBa8{U|cZBENQQiejX9{q>tP9T7
z$$85eth1Q2nKOE%q>PStAZIo2hRt~_|4n00#l$?AJ9GA0S)%)|vF}@cH_mPQUA_AG
z&hERmuKfzP4Zd$(t-IZ_w*9vJZ~Fdr4D9+ZS--UV<d3loHnmLsjV1lkyBkIllAqYT
z%U_t%RhsH>zW!lJen(e3gxKwW7%I0Hj?P&#RlafCoBYXN?ek`9o$cn!_@8udeY*Oa
zP#Koq7ej2V&&;(udM1__oE4lWoO7HloH3kRI&ZelsHL-~Cx>%Ly1~7ccFr}~cKYZX
ze9l7oI0An_xr@O$DZ3$ic+N8E7?bvu97*?`>JK}m>n;7#Cz38n-`gG?ZH#|3{!EC4
z*r(>eT!8YUQ=8|)SoXQIj1Ir%w!!WuGS8N@Q#K>l0%@IPZCh%u)HauE`)|wcd&{`u
zar??Rj-;^;IZ8j~Ix}ZWc?;24d-6=qmHWswAphi^KKNz7vTwb2(FOYS=QY4@Pw0<-
zuk}!w_NSkG9iE3K-Iwh0Z1MSmu8R;`Hcjk&rg)A*5Ch|~hX!%$xoEu4*+bGzwGG9`
z9GVE#(X;QFZ@czC_V~k=eug@F+Kuh1?UvomkPaK{y9lwA2XaAfHgOiZ%7AVQ?C3+^
zDewjOHP%&m(w_eKVm+h4{CUohNBYN3eelWptmMftc@|A;#y$Y{0c!x10ewq}ehJP%
z)@?M|YAspQBfQ?@dZ*Bi-IDz%P)AQY9DxtsX-7=HU-|CkZ+-&#9oPc>n!pDv(M5<Y
z|HKEB(bJAS{kCANRiF+bXa{VeiIYC?gTD|ShdIrJIfhtG{scLk1@d~7Uqi0n7}CG-
zW_#=0@7CXS+gXOjG~OGQ>=9@M>wY7*`u$rz#rEdcwr_G=xm{%qYTH|1>uh(_mo<gD
z&Xm#7jx90H%$=W2p4Bcw>^vVhD>yUi^Uw4CobNg(2fyR#yJjSmr@nET^h<<nkl1bM
zfiicHp)<DoJt2ut&fTdt+L72i`aENX&KS-a&Nf4RarTHvC|A&PMm4cC4&&n2P=}RJ
z4zV@9V+zH?Tz-Q2K}(o3Iq71RT#>WLI{G89!Pe|7qX%qkN1b+$=P_s6;&X_&ux|5B
zT9_&~ar9f`68!_TV~4$AjFnJEkIfd;VWgzZW7vkaC5~WT%)#?O2V1(OoO*8{%~Y9n
zf|L4?thu318*9qi!YF;{OB-u{1bc<O&c5-!qC7+s*eroP&=-IA_)Rerdrz1bpd&ud
z$+1m*$$!_LJ)&u^1Lc)ap3?DLE^!3UX$74@KgBMfqkRZ`;WGqd17o3Imv8*szN%lB
zZG$vjWpG^hcKMdH4G|YxF#)kbODNyA)OXq;E1ztu&CI?{lKha93Ob;@;(k@Sz3R65
zeTu_&?&q=oRIU<pR~f4As1E3QfjWA|ud$$yi@|<n-|G1a&OPmIV4qX>K0hkMDp2q0
z2UGAI@*IWy@hmj?#y@+~<93Zt97i}m#JCgZ)OFgRrL^95NOahM+bx@PjOTe0A9E$%
zIv>x4HqWElcIgd$vGF{eKXS&o$r)*e>YR^Ja<$VgWH<EpBItQGciG~Hv6jX-%41~C
zm<MHav=N76TJq0X%el<oqFMp}j5QgL_+&R^zv(Yu_(S50wj(?2=?B%<QoXB<aU3hY
z7#|r4zCu2Um$ewVPF?jWJ!88M68kC0>&V>FpSZARFX3wm))b$058P$OTM1<oDg*te
zz!yG=i+##IVJyaE>^DMsVq^})P5jKeY2C=*669tpM^C<$FLF9xAeYvYQ|#%BANC1;
z@qYyQac+o<ILskd=E2-_PA}a9xf3?s6}da|9nta|hHntQMa)q7PoN(@W`4h{{6-o@
zhRR#tFHJCZe*yg=t}prefcrPyffslGoKt8{=tBM1<zrvI@Nr}l*yUXsx$!9-ZGc?`
z-AZ~XTSxm1ZT%utH;f6c-?mG(V11|z?pOP|&9+GEup6R@sa%n-q5P4<p1H%uU~8;H
z+Fu=GX`EAV&gPf=3D(|FuV8c2q^lhHUZM+Pa9mC0qu7}bbBF?U^yh*;fR8OgK5x()
z>~31o+0N3o*uXtLG4&)Q$v?0b?LWfL1pcO;kE3UwdmHE6(U}lp=}ZI46P?<y;rAZw
zIV*kw-#1&jPu#ZO)qBQGEH|{7yN&uvhGYoNKVW{wI_r<-&sj+xco&R>_W@8RcTe7Q
z)^q-HzH>H*SURUG=!e>y&giMLm>h5USea+yBEFM&K5x=C$l5-y{O@ma|6jL#+N+^G
zcaLQq@+a=T{}=VQ_!#%QScm3fzO!?iZT}0oH1-?+#`os^{DCQb`-bzSeJobeB|i~r
zdt*0^pA1Q8KX5o-U!dQc{yW{<Sl`*xHWS;qZuv>?cFQh55Mt?_FvQjxPtlX3{Rq^N
zgSyVMrt_q6e(Q``I%`5~olQvUGw;sa2e;1qfh}hlXPWwU`B?bT*)o$YY0$NV@c?`1
z7wC?_o_>ZpdfIzR>Oh@1CTF8!o5ZMCPtK!p*X16~S<0DPKsU3EIn#%EcKO1u#|X;O
zMM8ON%q2ZB?!O?Ef5Tcp|G<*|6Gv^|@u{EnJ;w~mH{6a~-#~kap<J+DQ@J5;tW9H|
zC}-@QrTns|$aRyXP8;_4Xxg9q1@1aP+sUy!4t;_87Q}%s?6Bu~;Q8PgU7~-<{sr_Q
zmTa1s>T}eW{)|0y?3Ml*;}fAa;$i+r^JeZyazS2*_hifiy9@f#j-73PV~>rYA9N9d
zSf+AK93gmC*zc^tvo863Z`oi^U*Z7Aw@VrQkxds%zVUCG%J^Yz84nm6JNl5HB@TH~
zUdb)&A}N!1=by55*3$+{9Ko9HT<g))U+c-bR?xvxJB*}B8gxrw*TodP!}$B!^R23H
z)}8RTxf{1xPT98n&Rz1+^II2x2Hg@zU<+H|dn8Np#%+;t&}Sz20DJ=eyWm|t@}11w
zm}7|5{$WVAgnW`$=oi-CZLGx`tP|XA*1xrVXIuLX`8A>Pcij63TlcNfKCGio*?J_t
zZfg5m`L?g|U_X8dw)Qpi*|D^~`dhL;AE0fB5cp_<=d;2y+l9}8=ULYC%yZAP&bh*w
z5`y2BIOjtQy<fN9wLp1Fx7FUu`9m4#Tfq<S3i?3x$NL+fE8pMrTY|HVSVlsb`%5cl
zUQb)>kD!fyrrKgt?P#m*UF{*5ljA*#6^I$S2tllk94KynmxIOk-Z#(=U41-f=4~Ht
zKe92{0(Oiy66#af&V5IY?>Z74@(6qZeUa!Rp<LV0FZ~u731xnd1j;*q2R`~YDEuCb
z-4V0cpc`q2J#Aa#9`cy$fh6C~FF6Km*fX?wJ*Z=6umRV5meJ7%-#uB9N3iBYY|*u+
zmT21dyxWk}X~T{_cR%#_>0)aPVq#p@hPllPbU^z`9H(Q%-^h3l<0}rHN8YvO@O<XG
z8cE$)KczRjl(8EEzxWTqctDwX(~ckdeS-S}d}>EuZDz*MCEsxTmP;{IM#dc(JMkOZ
zs;$fDza!GulrQFO$jcI4kP|~4R&pe7@KJU4dCMs~sQSBZKkJ7vvBQt;Eo(o@*4Hu7
zeX_H?Z9=x}lc_x#!uy@Q%$~0M+Vzkgy!Y!ffsQt8kC^3I^>eUuUv`acR>piJ!Sf-1
zK)tqEe@kq7VO{?4gN_)8hdHl2OI#)gfWE7J3MBQd`S5%j>O*?^9)Vx{19^Sgl!vbK
z*5@l_@<SWG>5IQ3J!dTEDomtw<aDYX+dFrmaSUyYNgQ1?`DYD+b-+i`Bn`SPut5^T
z&^gZ7OJ};z_vUk6?}M43!=`7f^n3ct7xN)zBrsQEW4-+R9>q?q#JO^O$1{o#{22S&
z(naQjHRZXtU&?Q|9l0+1Eg!^&FXHM6xvhDf8WXx;eC9>`#OFCQ<#8#G&)V@$6y&Cn
zpUf3Gi*ImF=|f+9b#X+^(NUfln;3|PxTZLQxS0#NID#{pGkfq|s5>I}NxmoeZsMC`
ziX;3@Vmb7E@*P|4fK3zl!Cwe}!|X5VMHfe74zcyE(hAhkFM%EQpV--U(og4Zto!id
zUMxRLdir9={E!CyQG1A!_i66b^m}yZMf>^(>|I{chZw|~_FZ-KzX4l_WXs1VY;#NO
z85{1tw=H$sG}%whlUy-hpnSxeFZ!W3)WKtP`G%DoNkhKK+b)FG0npLDWZ$zd<x|R`
z@;zSF5fgF4OuA$UBusIVCVQYCY=J-M1?y-BY)w=7#%)O2EGdJ>Cl=FHHlZ@GZ-G4w
z?U!u6^)9CBaP*w>ymPj3_HtJFj2b$lU~^XK3<=ILY&ZvfMsQ9Pdiu5hyS_iffjzcA
z!C33U<GU}u%r4_u*ULEg8Y09d58uF?o8X+REY+bWwN9>hPmo*AT+Ut~kB?sM*yGp!
zJ%;^R+V8pS=?Bb#xh!!6^YomN`~L{`<vo`7>aBOZ_NisJ-*R4atM%LVZ|aW0asO71
zd^VA*ly5z4720e4yRy%NPx8CIciYGqZ~a?+>RkRrQ=6$a)}1fy$z(}Fe<7r+?54f+
zONQ(!>#EnbpUO>rf6LYx4)X=KeUfi|tn207F!CKRwO%bbdIsKDJm)<BIup9i7w&mW
z_rJ{<p7%g>L+28AzbTt7n$8u@82WLZ9MR-w2>e0Fx3La6L=*I(Zx>OZegrnyR?xvz
zJL3}zaRsq)PAb-;xCim;UDUYW>b~3auDo<d9_5})`3P*bz<!C&`%FG~$8FBzoHt`p
z=S*h2kvSQe3u4=XdH1B|fHLj2aoa6>>AzI29MyjVYmc4fcYRil(Ip`Y)*+WT7wAk^
zIRx_?f^`f*e!N!XZ?UJ8Th?mkK6`Y^XOk`K+pav?xBWAQK}Y+#II06V*n($+XNBjL
zvttU*osswqLekd7l5G=P{rsHy8N=sH7=y7KLsz*Hs*@Au#r#ZH*?YO?enyfn@<tnk
z>;U^C@Pj`?9caUbKJ;%XDI0V%$6`Hr#zSna$+PDrS&!$rl3mE(6!->@<*_ZTuhM-i
z-A13CkQ;Kf#1Z6_+*Zi>%JrLhetJDlw$YAV1>F(!VI5h|`1=2Y-q7AJj_T}-E%+W?
z;)t2wt9-NaH#z@(?oHB;9nh}{d{ofUw#6rZ=s&fMY_ko1-e8O-7<-8>nA;G{b>{p-
z5>``N(j>R?`4i;abd?S3@d?%oYP<W{m!<XCx{RcbkIGQ}zaY{N(&g&c`ahAi|EKbA
z{P}s|`2pAOzSbkLgC=<Pcm^Q^&nM4mOG(+F<C*Rv#LDx9bBp)nb9U%#;a$o3(gkM=
z=l%1YnD5$|-;B?DTkV`doJE{J^u56s?btWHqj_KR{^s2dyw8VpjM4Mm;xi5374&ZN
zn2gI9K)Hg>@odEg%+uwO@zSS@5cnrnVhORhR|sNf?kDpQlE6KL`LqwvhRqxHG34in
zF8_@232b1Akx+&s?tb_~Z;9Q&PVtcUmT^Vui4mRGg*tssX{TQo!Ma_)5mQI+_N_WB
z>85;n9DEY%A-Bpmxre2)VJ*OIlpAZKK1(2H*)RB^{RTaKC;iJF=-LPD`=<R5EB6I9
zN47wjJpwx=`X!$`_sBB`#S+A$Ikn8W^M;PLkt|8}7I8+7!JZ@*o<-jIJexeHa8w3#
zLxjK%D5J-27Tk}vk@n27=Ny@j$Hd1Gwf`=@(Btn0J?w<@#aL$>%l_hru`5e;7$St{
zYKe}vB~C&ahKPi6#d;*ZX3`{=@<MLN$xpBk47T)J;uNSuFIabq9cAl#+PYrlx%%97
z+g3gEdZXG<rf(M^yvNxeO-$`i_9*)uMoO2dH^H;Ov&g<axzE}2TYJAg6FeJ$ZVPO9
z9_T|~{CEt;?SdGNASU7?R$@LM@SLaS&sx_#;4*r%b01(2P2ig`dLdLM2I7gNOHxN#
zM{a;R`XlH^e|$0qWA7a2nUidsM<jjSuhCa^@<Z;r&Q8uz<Ppv%IW_1iyX5-ulQ9w}
z<4yTS&swl1^z}F%3;Dbobe{7!z@`5ODgPhRo&P^l>POJlIP(SXfg_&2^2s_6#w$4?
z$K(Z$aQ?{|@zG~yJiL#9*ocu>mmqdv9<T-D^c;sV>>K|uk}V0|4{wro+v8^ne1;%S
z){3!+w+Y5K!~<PC^UwJ#&4IiypOJWemeyM~*%|9Bx7sTBCQppxTrqx>yf7E$+wu&L
zye}Tf&7G3FGxzhRGT#|u^4%f$78%Kw1b@SPC+X7!e)xvLC*Lsm=NqPp#dzWwTQN*=
zG8Xi-AAv1>_6zu{*v9tA?`UfOEhl5@l5a6@<q$&caM!Dz{@>xgRl2`rZFBjpZD_0}
z$nVnk1Z&<C%IKVX@(<YG;HR=x2ak#D$&!SV+&QK#g#A@N_G?{FTkH*OBWaSv%p7`w
zI(opy_FLtOeOBpq_i5@=vEM3bcipzGTTaCSy$~t`>i{EZl7@BqTUhI%XMO1mc+NDP
zVVql>6HSuyZ0UUC?8By>6Fw^z{lzKZcM7D-)M2M|y~?gO`x)}by^(PlpR>wP=iGYY
zmQBbO`*p>DznfERu!oU^<j%7Y$@uN!<hYDa98ca9TTiGv&Zc&3w&=2_FaGfT#+2SP
zm9eKUK3RvI@0p`@fysJ_$T1m%ep@i7liWG@RG%+vv!#0j+c*9HhVCAVy7@F-=ovBC
zxcnwZvAx@AyIGfx`oH0*Kj6dVPZFCyWvI^^zxC7fF1;C-?tCfsWJ;Q@@=Zv0vzq4h
z3+{fke)k{p_it$G|B0RNiYW=M|0Hd1+0_@0&iNs>)~c}&v}Y^mZfNgf^PKCM579X<
zIJ0#=gwF7xvm7WN5jrnu=ZtDPFP=W?Hw8YLd~tSE@L%hco4}raU4&Tj2b9rGab7?l
zV#szXUSi=4TZ)Ys8!>Zt<#!{#CG<@ZV(a^2B(0Ru)86yjW908mhr6$QP5JDcl{s&6
z#F$GAk1dJbIU#Q5O@2+N4Crr$bQRjMb>AwN^p&Ife?|4%U&g2X9;^0oxyvpD^I%@&
zgEb>RtQom`^2z&0u-~3ME7!=)JBl{h9c<Ny{!`!!*;7)kG>yl&#KNARVyC1G+>3Z-
zww@i%fGLi+&nfEYY42h+*$Dd0eC}30d-w##@_0?<lQ|=vo`hu04Rc}dGf(!B_Z9PB
zf}D{%Y$E4-B$?~DKxcnL_7!}14D#x6c&2%NycSLQ2c9QjeP|~Zd`yk)@fojz-k^7R
z7QJ<r*lj^x$kP$56M1w_o!_AxufoYPdWgcUbN$GMbCWfMEk;vctubqT1n(%=N#r-@
zl7y4+J^Fl;N^bG#`*oDR7up7Un2GCdr_V}`q_NI&6yGj~bT{}%=W#4&j^8AiR~I3e
zKe-?$U4&TepIkLb@^*v1LVK;(eziPh*M9+ae?s-iy1%ichw*~jZh6~=`T}}O%HOfn
z4(9{JPMht9$|h6>o)H+LC6r+&*!6<@VZ*c5dG7K#<~fD^g4>Y2aC9cDJX>0xUq0V^
zo-3T`z`4>n<MkUHzb}R0eeL%xZP;)Yaps%^KlGop>%ELUzgh7cVNW6@I{ZGr{V|sM
z;cIZWDKwSAV^~hvnyzvM{SoxrB6KD~FHon=zUjXd17~Rn?o`CK6eDpmk6C`7BmPz9
z#Ju=h*l)qUC-^xZXgMxp69chShU!an#Y((}`jH+eyN>M;_`+xPi@p-7gKeAa?>LD)
z#653xw3)85IVwMXiA%XA@2pu}FRvBrgr4<jvcn!GYs8)@P&ZW{>TCb_Tlmy7z&kti
zOpJswx})|k*dHVJh~<$lV!{8;SeEw6&fFj6Yl)tcI&JKyBWmpU!7uSR7M{_Q)aMsH
z@omLt#)}<&=ueyNJ)h7xP{+fzj^i@=PuOOb^N0Jvb4MsT+RaYA>&TvX9O^EwoWsa@
zM5)tu63Qb9N#}<04Q(wU2cPI_dm}P`RoZT)KkBrzciIcAH_(n9(8ny5-#F6$Z^3vW
zh^q<qcxC3E4@qF}^PI8&+0*Rp->_r{NAMi@S-=ne@QeRm@R;bPAU@}=E9MIGIAZ2A
z!uk)f63Xa4!Tz8xw3O&<kDf6Ye<Y42q^Hg8#OnDRm1#c$zd+eg$M;SsqoaKZ#tQi$
zZ;dmPGeu{y3Dpg{AzGf*vz)t>X@7hu=fp>xJ!54ZSRc+S&Mn5Ne({NqrT1JDQ{Ure
z=eId+J;%hBK8!i#6aP=Xv<80mSrg{VT)PO-a=wm-zQp43?U&e?%P4zlYK$(Bum$t<
z8ZgF6jwEC63$J&T*kIcP{qe(G@ay~yjRTAq(gWoth@}&YVg+Ij!Q7a`(p)Ocm-&%9
zpp0&blTeNXn~^k0puPn*U0{C%V-f>#5&vX9T8F0dH*}5<am3V}^SOWOUOJlUU+Smt
z4Zc124jE#<P`_zvJNCf$%M|zt!8c43`0tFNu{Pfs8uy8TSTeR%;-Y<U|IXO9`r_v%
zq`Seka<{vV%}g5plcO=sQW<&@lE56^AZF84Hb?U@*4fT-Up_zSZRd6*I^@i}lGDTU
zhs?Zgt$EWo#}efCk<wwaa*trkzQ9kDzY6|uwsaM8<6JG3PeK_z{mFy<(-%GMC!uV*
z%5g!T>IYwMFiuNb`urArLlgKg_ZZgS(stIn-sKA-A^$+W-)Pbs*6vT>*@7;3u6FJR
zuQT-_J#9DWLp0fNc0_@*l5-Mh!v=eNFxCxve4X^cxy(E7=zQY*ZsKrWNlt;TGO*(u
z&U0**@$fwo$_8B|%##=ypLiWV{z5F?M_EP^+thf(w-U;ovos-|COd3l3Hl!4oG`AL
zDnrXSh-GCw^uZrFm^!~X+c)p>gmWG}?ZoiJ$a{*p$RG1$zBfxcb5w@9HZ%8!<yIZ2
zSLw3#)UB&!+D%uvV*M>`bL;=KzB8upq@SZI$A{<clYYI}qpP@Y)!k)3|DPoGwe9Zz
zRv%YvZ#LFd-+mWX*~>e1eQAD$q4G_W&g`cB@rTftKK5bx8$VP1;3r$#A$xK--;*V2
zhRWdjoBY&{KE&1;-vl`i!QLFXPpLys+-@7}VDb#>8Rtw1&Rd-`Q)kh0R_Z($oSB?a
zoIiOUZ`pFr3_)KA`7xbypwz8Ly3OtGZ)scCM~>4Zr^a21Vd^{!#nU(|6<cJyOZU>F
zv#jY{3w=i%{oSwgx4#e2W~RzVG<}B*L4W*o&PwjQ%Ee)vJb#JH^O>605l#85kYCqn
zzo8$XciDCKL*mD5l|SJ%|E;|Jc#JoB+rHInzm{|N+(L6CXY8|~HQdT0>v*(|?5*eh
zr2O_=PbBO6th4OsLtpm57VHQ70cG@tI^!`mF%c^{>EZ~UnJIXFc$Rop$Co7E5DDc<
zsJ>*wxiMvb)Q`USz*kG~zY@j^!T3NdP1Kw)ms9e={sQvjIWwOny5<A(18xtsV?PA`
z!MW)<UgUE`?#c1sexRJs%s<cl=01>64%%2N#fCrpGtLnn+Y%jZL&OF83VpU9Kje$N
z9YIcq*a>G|zd(l#_A{ydXrm6*XZ5w@;|SI@w7#q}Yd^&nP2ZR>#Cjq0O$uGi<VaT9
z_4hmKaND5UBL1Jo`v7e>^nsBy$x0pPyYf`rA($(3Cl4ocG9<~*ZvW(JrfiZGa(PqR
zDbJU_wa=0d=pS&q<#`#i>TWyNE&GRY&_`*b3|srDGE{$~<=(4pyY#icDtj5PmTlwy
z_-vx?eVzg8hIZRjyDl3OD)a13p22)pIWvG~7s>MulmWe=PFoY4WlM0r49*Fi7fWZ$
z*4fd;%5#PHX%k4;BGg7ZXAoyU(1)`K+sOBO<U4-y8)9MSJA37OyXn2nodCa#PaIwG
z5R;(}A!r{tE@K<(kgx>yK;M}hNrOHF_KeM(j^bc0%$50c#m3!&I}7&=;vRx|Ft4L~
z$nt%JJ4u$&(RS0-=M8*q!F>i8W2K~Q&>8D2tta=yI>iy>cnIdf`Y<PQ4(G!9E<I2`
zf?QP4hp4$>Tw)-eCYTTNGF@dLC*)@&)UhW<_5o|>_v`bH)gGljbG=%w7n1d39f5LP
zOV$({bSrIbKV^HcmtUTPE>5zt&e$FwJ7|J_UEq^3y6~PMSLB7cG(rA>Jdv}hJYu^9
z{pgP$;=w<$%#35`S>?H{&oDZkVW7N4*K=OM9z8br!lz>={w2C}w7dUOpBwwcUxhxd
zW3!SY39fgQBcW{lCy9-T?8jIzQo3%59-26s6Z8EJ<_%FGAExRlTmL49`kAIOY^@`(
zo;PkoVoTq3agYBub$s6a?s2M(+lKlzL43sC#qqO~dwpuZw&Z9J1AF<Vv%iy&gsr`Q
z<2G!UI0FBSvqflJ7)36Xk03^3C1xQ0C762`GdYs%4@3RNwq0$J;H&zh?Y5(R6g&D-
zCpKavR`N)k_Js|;fHKerT7o@3=!*|>L5?_II9qz2wVbynp*+OSGq;tqcV_uHYgK-1
z<YRJPm7J4%#u-{G#_D3_S;l#0hygu>Z1BU{(tqT<9W%aYV{MrW^JMNv%$z^-J~_`N
zyT?AqXRMj?Wqy%RUgC(YcH%f02Xlfh4*nDu{_nAgBgE49K%JNjb@WZJ9#8!ENvOj~
zSTDe~f)1M@Cb49EO?e@AT@XLAg3dVK<ij+T4LKlB6?A~j682T)VT{ZXaWdbnd2<FI
zF?8qb+&#IoaxZT3r*96vKaS}6J+&q4_e?F*1~ciBK>sE1#kUMhfq%Yfrr>*K>b}kR
z#KL*cx}1!25~t!@+@lrSW3N6(;O7Q?#bZ_7U7qS=y2>V0hNW@MP`T1nhs`$$^C)zc
zfxHqwi~{u|u&MpF>c6G-qud341K;FLAh+_14jOBnZO?bVa=zIc+P}zWZ_qAV{CNz@
z73-_qvH^19JS~--%bHKOBX67jrLlzj(GDYNl8ocAd&YK{cL6;%`vdqfw+;Pz0l(zr
zC%&^A>Tg2j3Tp(jz*+(8^@){jmbRl_>8eB3QMMi#1@?wP?{bqKMz*_;+tIttI%Gqy
zy*Bi0hxXda^O3U)#zk<ZCA3e@PtJVx<&5wdhF{=3>jJ%@J`3nq-WNCr@xz%IV&*e2
zbcRoj!&peaUz*y1@nI2%puHuw#orN(!JHirV?Q}4axxcUkgs4|&TP%s=lf6@-B7-W
zX=p6QC6<w6;Qxq0jxV<Az&iD0Nq*v7ZPeeG(nA+<fvz&Mj{HQmzssNcpg)CbSM@IY
zd9oaOwmyN)r?yY}tv>$+^<1cB`?ij{%YPz!J$v*X-Cw_F%J!y7XHNU4jC9#;x18#C
zbK6k2FUys_UH^@wkLfC#P#Ny?|E>?c3rthl9OV+Ga9)?zr4@$C=zww)?A4>^a$V1B
zsNVD}Kj)L4Z=Q3WcbNIyFLbp1f5g1qwPY=>Mag5g7vxjBAyY5~Q!oWnFs0Xw(z>Ol
z_l|S&tGe9}b4UmwK>P%8Vq|i6=q}-2q0KC8VhG}a%a*p^a-_fQ_MeK?1%1&c_Zwqt
zx{tWayY8sTU6mY3$_>doUVjVXH@=ayBGLK3N-C~js)Lhs#c6!!QOr+Y>YF=}u`s64
z*cdD0U*d>RuHT>@@U0A$!L}paF<86GRvB2=H(2*4mh4dLy2`|JA5nDMYQ1f@jH_L3
zLmhKsj!m$(<c>Wxl}Gm25ae~|{v*$PCU!m-`K*$?$(Oy#z90s<hn*1HeW1I1q%#JO
zgYs0FTyVBHpPc<IhVH1v_l5#x>`mY^#Zj9nR-RSjY@JK+`8<jb^fN>gJM;7zlg7b3
z*yGMcu&;#A+swH#$6y{}6^LVOkMy%_D${<5qj({f^5{Ove-q?*DevT-oRfd(;%M&!
zI`#N(jg#?tZ1jHw(nRUIXa7jX0$a57XHCe{5#*3u`tGZ8WX`Lsd5>HJY)^J#EfM|y
z32Qq3sEuH)Lo9Jb*LTZV*r_8;(|6G!7T-ye(C>3*N{3yr&Gw$Z1ulO3`@jB0NE+Ly
zhmq1{+pt%<%0S=r6$#@+_jnom5KS<zE|@=gXoB1Td4istF27_JiT*c){7sV%tQCyJ
z<tOPjj$t`VT-(}%&2>oX!Tq@ZTXv1hc+dS-y4@|u%UrSJd+%$`421SP%#<!$;<J(=
zX_|EIrlYgSdE{(%!F^G|M%_-(0iSreSGw+%qdSAUC6Xq&xl0n?F`xUT*e0L3`n*5<
z4T`_h>GPP+<iYPf0=Y%VMjfBkO}<O;nax`v^4_BF$>)gft|8U~*r|stUqic|px5$I
zTv#b<Ib>^sxq6O_XK7r1$1qmr)^mQV%rW#9>3Xls|5Ni2$RmbqEC0{6CLh2TX5mOD
zPc>KMiyV?O`ZA~J)rOt1ky{|YBXfK*&!6{^@@+YbZW|K&7R-Gl<bs@>Tqh(<5uyov
z@TV<t=%2ALwh&D)uW^BGsctb&;%F^c<H=hh;d9V@KGS4B@_A#G{lPxiqREE+ZqxaU
zOx$0UO?`uH`1b7o?uUKFUSc1SldgP_Pu2j?$r1C!hdmearyXNtZ1gkK-%6@}WaA9O
z6kGH>-#+I^Y}DaL9AdNrwj+q)_DgNv7}*EDH`Fb`om9d0M)k9P`wq2-{sra;%)^9q
z=4O~{WvE<nUA3XNg4g~hIm_N)E!iK2GIaUiN37b1b?o1;-<y1DJG0L!tDo&%e!w_G
zG{L^?>`m>_DcG+~EbZMVhU`7r+UMZ1CARs1eTlII{oK(16h|<wAs8p)J%aIjK3lpO
z*ScfxVm-8*Sw}pBFHpC|oqz1qhuSbE#>ZG;3T)KjQ`@6sTdJeJi7nsGywr}IIbWfi
zaes8~SluUE_iInMXJLvaxMz2M&hVK7Gr>-M$d4FX@#urG9{N<@jM@Fu?^3_?4d}+U
zBb#F|S0EPaII}%I=&Wz3jy{l0V52>884q*(d?sj~E$7Nu2jflIC7A<r=?P{0TaJgg
zi~;C}J{cSNp1BsR0l3WCvR{@sDX~#cJJ!f^?22WMVjJpr_H(kYp6#iNGG}rUIrpJ)
z19><PV5h!`nRz;zFS&w9Ts|t}M^0%+`;(v>Y>c62o|p&o{ES(1Z@Pykcf8)AU2oUL
zJNJ*u`p&`kkCETA_+A1b)(g}@OZXl`d+36AmgrN2Sn6+g>FRrG9G~%MT#L^Ly^R^y
z;q5ISe2<{r-#{Bfj5mhrDoy3Beqk26bi>%pk{%B<**^Kzd_wu=^9`8e;Qi0{0KPk9
zTjKmJv~Af>C?0VEoxY(-r++?IeGb?I*zlcY9JT+WxZkkvlMi_!cUzE8Go%CMs#Ct%
z{a@{;r0LSZeTK#e?ZWmY`x7VamiR>4kfupzjm8VqeWSMP^1V6AeTB6M(UPV0G1#nI
zKKZ$>%8~m5*$bO}`2(MQqW$9i%ib9m?CB%$of!{V+p_mQcaZMP$^DvlIrk^`?n=-%
zcd8`!ZE#;}@6xB^BY}Rgw}kQy^^BbuJz*?O5dU*GsxQVwzl>wbP92~(!MG~;yAAdD
zZhbBgmob||Kgp78V(=Ly|4(1^$z3h@{D3V6<s1)ri;TfMm@o63$^q+H*Y}&g<on-(
ze!j(`zS30w3H<RvKCxtf<CHq|CpcUG6yiO#or(!NrOQ=D_FH4PerMaik@r2~GBK>*
za+Eu4{ZSspNa?a|*q`XKS9aIDf1vuKkHTGd$D;nWeJf9m#e{S?y2D{TFl74;JMZ}^
z30)lJdR<^M)P>mW#k{LHyS@uTI%PoTZs7jl9trLSfj(u!K2(nn?Q7euw$ODSz)0@$
zlKl<Z*x!<vvy6-JaQ`*kN!(AoH+hTlKCSQgqj&q~`-tB0C%>=oouwuGEv;gEmH1C_
z#8#Y@-*0&T^1khPH#WwUxgjr%nYr-UK+d~zKMItAI+!9vD^SLMk{V;HEi|p`H(2+|
zQn_+eegdBmP0-IsYQNN1@co9{5~~a5)&%PuxxP)gW1o>r_8e;+g8UAx`O%t(VC|=1
zA5dR&Pppd9g1%to{zE_Xf6Z?(XU<ob?;pj=?+Ztg?-2eTF;#AYd&KvH&pBtD^W4NI
zR-V;*UdbK#A|EryHQ6`H0rO#An|&^M1i4{e<cqz<JeWfW+P^`4^>Mk$P7LDFFZ-6h
zcga6vpnt~Uv8)^qV?vLVjCs*sv55PvPwEZhsL<{R@<M)C5Arqzxiplar^HUq$-Sxh
zw?BT^VWjVoWW8Yv){}Kzf;EOHOzB6k7lzmud=KUO=n^OC`8(W}Z2Dd9iCQ=0v&2dK
zd*Cfy|0an6qtGs$GSL4_x+G&~4k4OguFQFB?&KiIL*|KGkuzuy?EbIZ{zgvunl8P<
zTER+bopQBdho`pH_N2S*-TwBie&|a?(j@<e-?YPLiIWl?8?diGXCS4^mP7WQ9G$5t
z;(;dH(%Iu)oSelxt3whvx5$=o-nl<|-XYupQSOnc`=N=UI|NqVY1nM%F86m2KGXRQ
z!uO7opRe5cl=-ah`s{7`tmkialfTW0#b<MY&wc9g^WUo)e~%KM&u#VL?>FviWq<U=
zcmN$32le9xx5W=AH^E%!r(ZAzvvOR#VHhiK7{)&|pRIQXZ;;RLetNHT{SLVP57`Qo
zvG4qi@W{{9_YF2;!4$hd8A8xzBux@rMlNv#zHYar_sl<IKbe2lU?eNoBQ!^tDVrqJ
z`lIq-os}E%L#~`dbifWFn!ul!#OY#d3{Ox;fAsNb%Q~^n>`{G&wcNk#;|hD4x^L9a
zPCgHTnBcN)yVOw+)EV1$sXH2@nbJRF)_LlJ{p!8PzB`#4=C}m;V^0pjo@UN1<IxxM
zTZJPXIM<x-EjaU>{R%ef@pGG7y8T;>J039&ZH#UBuL9*-SL=`JDyy_ZA1^f7jr&K=
z7rN|EI2TK~j2D{hKz)_ABiRQP)(m>$eSySA-4-=QWFMA}i?7?D!%pt@ZbQBOkl*O4
zhdRcY`<KrHJ{JsonZ3z=W}mXBy{}j9-zLc(pVz(09>+!<J{4@#aV|IyfZo%8$bSj?
zq;L0+jX1P7lwl-G@(9{6e&*6NKj!E;*BoHKv7e>uBlAR=7$ZU7vH^9*Hv2C5!4TN&
ze>BFGW8FDl=D?ho=O-_Dr;fZ&KX<$Cd4D!>|Mv?%8w_>$wES#1e5UDM{@l@u%^J`j
zd28fMd~&FA9S38XqRDq9=-61p%4gi^8}h+#XM5`KrC*4I&)zQhOyDylF0fILU(2>f
za%4X}$4^c}YvH^yA99Pt#u~8(tOtw)opUwCDNx3aAM57W#3N59bHO~#l8&7*8OqeR
z0y$y)%)?N|Za@3<^qZNlMh=vVA;=5TtkjW!Z<IcW1w(AXxRyAA@iMQGxnl0zsfRmT
z@6pd2wyVt_+4DOH-$nRdvcwU5SAltfje3K>8PcI8#GGQOpQ*R?;kziG6S)qIi!t$@
z9yuO-PmarDBgPGNfUlt~!~?gz$)~c_|0s0nmBaW8%%>76H}RQE&Xf7EC&@kE0r;*!
z?(s9U`v!j0BX1UY%kLue%lD9`zPI|LU(U(V9{B8caxVLR8Apvxe=|9fKT-4K9Pa+_
ze4;zo=;q1hx+;g-bWz9Q@%<ASniI6blZ|?E{99OyO3$^~T9-H26A*&)0qeiOP>fb!
z-9Ky3`loK&Eoo;PzCA(5?zr@^3Y4J<{P2ffxNV>FUwpT8L!26Gad&W!<$cCoLTtw*
zR*26&mml>@*xqFewdGs_dc}6mj_I5mog>Z?IzC4*4&s0MkWQKSTXjgvOH?1~g0_kS
zEkR%6Q>QkexXg<@gmSQc!I94sPi^u0W_P`%eM9Xk*lW4!O?7YBk9zA>F4=#J+cmWz
zUocX-d`o<3w;sT5p6aXZ$hSgWh*rRMM9*`+CI1te?v&q9@1gjkas7brV&v*SGvotL
zzBSgZ$De<X<*vKSPqDF$q)WoqJq@!+^!S0JT;8nAFKaXlT{`P{uO&X%8g+ReaQ<hW
zbtLSR=tpP$hVwrJcTE?(b9tXa2y89e)tJ6(e9v%qRBT7uZX5TL$4dY7eX>9L9r-rq
z9lP_bx_QG3zIz0J0}_M3Rp~oP@SP^V$4q^Hx#9bazvry{K0_OzJ#mOheEK<h_tGzK
zT;96q|5N5&uJMu!=EWIj4Jz11a&m2k=4_ZhZK=aI)PAv!7p%Q;oy*86_6zOhyx#uA
zFkSi^_OaZh9kwnQBlBpYGcV1LxiarAya(A&-fNqD=6cWk4#E1f_onj9-i)$`KY7o+
z%-*4n_?y1eC%A9=pJ|WGEqURLa-QcO`RXk{#J<2r-Ih;?BmW_`+S0x!oMX;zWWGnq
z#mroc%tg~ULt|#IGjHaJT<m?>H}lH5(1yAE27J392h0~DAs#F-L=*Hw9(#c@b@-eM
z$09EMn4NuL$H(o^sl#uGRU~_Zys%$b3-U((4CN<We^hU5v$UPHVU4zEU1JceAM41P
zv!<-=4Qmcd@Le**6esEW4hlnT(exWzh?N|Ea}!;^#Z{)tupjWh53F+N-w&E<e`^00
z7rW`w4de58Lpt+dK3y<Z<_t}c2l7F_$Q#51N4YgiI*i0+%aipkTMpS<!n)nK4ryOx
zg}O?OQSH`8`Xisfuf{;1NtZO<ci-f_M_sn8Z5_ADS^CA7b}iXDOWZrYdpKJ+C(m7!
zJBjnjIemgN%z5TMXoCCUaNmlddzt&2d(2SAzD46Mlf*XV(+ZR!#OI#Zo!|5s`}xe(
zXYUYv4#UxBGVs~F^cl_PbWho`&Y#yaKco4aMt_1jpg*u~J956zWv@K>QO`X1yICZS
zw?xi|F>k#$c!TgB+4)xa{QE$D1JrMU^8xIQ-wuC(IB&S^kPo<gzO;!PALDGio5T=H
z9KrjE`LHg`Z3@<HB+T2oB{p(GepYfMf&7uzExblvC+zq){1k(}=+paxF`#=4^b;9#
zX{{HZwc3yDVfM1w(t$m0y-MsbQo4-9Zwg|XB^_!xRQ7o|x&M6*C<A9@2>g(gv4?1a
z@dIb3i_p0lxsS;aI`ce&cNBiKB@QteQ_s2H^IMwB5uMNMJonf_G*SI;oqGIWB}dY6
z&~3L2*^F%`+t6-`ouFf*-cSbW_5;`}U1h*#9Z9_P3x4AliUUmy<+<m+n9BPTr`SV!
zdx5%HIMV-?+Wv3!DE-pzB#uG-VsD92=+d|L-W2RX@7tz5xwSV9`?S(k2KF$ppDVT_
z?Q4Jhn&9pjq6^<C*r<2AS^A|tby3>V-q4mhe2#FxHHP)ASj>^Lck=v^1M=bgEa?^O
z{R`v~h!Y7qHrhHCIyTo4^R8PO6XR!Y^&Sn~quig|<=pE{OujRVr_TrMfDgVy(9WL)
zC-32<JGiSa@<vYRpS+-xD{|TdIYx$HeAMB`9N1%Z-%<8l9c$vRw(Ej;#Quyyp9Sm(
zm>1NK90M^t2FAHWD6e%aoNb?Pp8@L0J-%DC9QT$lcS5}%C>!d5cvEd?$NY#z-%WUa
zE$72nw_tvZ_mnZ?U)xY`@FN!NLeKn#>WNGIE}W}SzFNYXg3Czi;RxE%9=0GR{nH11
zGPWZ=`O;jOJGnXJMDJ0)8;0JsTkqY|RsQpDw)B?Y&yFPDSGM503lgw>BUI1#8e%QQ
z=PiBIFYEC?dFSj<);l`n<9_KIh9Cx@SDMO(b}*AJ2}dz2*z99j{g(V8E}F_ft|~)i
z=ns76%bW{SI#k=OQy=&!Co4h6zJ>cj#}*f~>3r|!bC`Xedz_pP&VcM&^^WNnL+x5Z
z4B~F#{%$#P?o0B9T#>_BIH^~Oelts(kbcu-tNnQ#e<Qob%-nur$_FALXW(*`uDj*R
zHrUb4kX~sj18Z|LWvjTp+N^ih{(^G{OGJWhPU^^t<2d%4tnF!o-~PfKhc>46Uv=tT
zUS;g)ku*v6_h64F*uXwW%J%E>gOS)ibuaN*ak!&6LwsK39g07GjzbxL?zSZ#6U0bg
z{N09jjALCKm6_*Ew&dU9eRRw5vfpk$%I?$SsIqHJZ!rF!aNFO;wEu4;eJ|0(P`;1y
z&$=KfhwQ|0-}@oI)Y)#o+vfUj(s@LV!jk^RQQbeK-bFL-Ez9_$xnDGu;mz*)Tdw}E
zcG%G?x9?loZJuJd4mk>4I&3~`Q=-qmAmj^2`MFuLK@(f+FhzgCbw_(8#L&J9?XSUk
zPnKk3&xx6mGIo4I_XKayrT6F1J1uy#3Epsq@)XqLx4DbdW~%MD;=2#zO~}>~`mbXc
z#3L^8c{8fNpwE1xe%_kAIr;9Ae+$}t@3`nHAHLU!B_e5(72A*O#2{A7*h><Q2)%ug
zwvE)c?7@3iV>}u&d1QX9!4q9}^1+<R+tGYsXFKY*Xt|b4l68fr^|#%Uy<oO<_Kz8<
zBdxp6k~V*X+uhPJX6{+W7lNEHf7YKIFmLA1y0f3iVH2!-6MUDL3435-%l+5o-_(wr
z6N|hPw`W`=ebH~vaV+WNmpn5T*A3-_v&dQI9yp@wO>ahd?_;BW3Ves!bivv8d0v@g
z;*yJ+2gcAc7mS&Gz}%S^^JCs2IA_d}{4hV};&C&FH<%an<fxq?2E-Sd>MHh~vY*7U
zt8^U_-y7`s53vO~fDlWtM&yc|0Xa0bRY~0u<ec2^LM^j4z&b6#noV(p*Y}pJ_ZCgx
z8~N_|`TodvNO1(;JwLyl@f}n&{iZe&erG#{(C=_Clg;mP<+ncn=Jy-9N;_g0V!mOY
zC+Rj*?HMy;AEG794W{UVxs!tsO^_$(<SX+^ZXv|!|7J-yZ}yQsNYkW4U0>_2LyiZQ
zY*6c(%9UF88{KU^hAL<7#V%Q4pZ+cE?+WdS={}H@vE$bg&d}!^Nphy1I67}I3n9G~
zmd+?}Uc1;jzahAbd~ZkI+e7!%=dRM-jogB}d5O>craP|rUd}t8wzLbi;jZJ(<E_D+
z-^I}9JfE-ibJw50q0irTL0y;s6ttr~tOt&4^kFCizLB&nW49mDKJ;Pmjr6D9KG>iM
z`&Ky=<7nK>hqnjs5Z)w9e^>4NZ8iVi8j}8-EWhE60%bTU(MQ2`wca-5Z=pRf7Bi(Y
zPR84KLkZ?E@-4-@m>=_G-p&J(yex4<%`au34qQf7KXh#PG(jId^Eor8NWf107LjeX
z+Oy}_f9%z+ed)c*{${_vF;oXjoP@Ihl(7#%9O9ll3+#FL^ryW)>02!Af8;kp^)oq=
zH`F!3S(^EVKyJ}x!%jbuF?>!L&k>As=DZm@^YEPRc~M_kS#FZRya9cPm7rt0>#@Ts
z68#AJ-WM}-O&w6KY?Xm~%h+Z)(+BxRsO~2`#&3T3FrSe$NpjE=@_(~rgGg!J<&$k3
z!_s!kRpP`Ik2?EVI?hjWYV3fY+Y&ECEAUwW-1X3f_bU65y~!TEsrIU~ry(9V`F)k|
z3efWNWaeGZeF5AZoPX-=drP;)*SNjq%6OD##w5<Vz(#-g0I?4?&4C>FOp=%V0(Gt@
zhbtl9FvTf&{i@A6z7T>nIT{1wVLsfIQSMLlCO&sM_d9pJ_}u;Z`Gmd&_92!y_~d88
z&d-FU&jsSqN6Xwf7py7yKz_!e@dRTMJ?n<XNxq!3$efTDbnHzy4()(=HD*)UtP;Pr
zooWYL5SKp46*)WPP5Yj69A8*jhadi|33-Pa13x$^UA7F_n;-`5g8ns@o%3hzC-YM0
z;JM#(v=8;vITuL#GIuz#g<$`7!CwFDclLZCq&Km&wnMPShVl~B1HMxnK}`6>r$6SQ
zxsfC0%iO!};l*99_bl(+DURU%yG3-BMgOBZu|?B&k|oXy)WHxfp)E0jSc<#UAN?{0
z#si1(Fb?_95ABI_gZ+t?ebE-C=)dHs&nH&ek(E#xT0*X1B+RiwPH)Kd8=*RK#P^87
z`e>a1ee+!+<GBy_TP1bGCk|~w5RV)a{|NizOBrAMK5HX67(@EvQ*qlZJKSY*LylH*
zByYSvx7}@!QE1Z5-LL!qN%k@i=Ir?)t4<x*US-G**sT9n9_19s^*4s<p%qw1!&(~K
zENw^j!qNUQtZ^k&2HQ^h(%$j5^f#WyS#95RV!DrB#%tYmmbQPB9zW7^sxorENbE;A
z9y<1+GdFcFaZdqv6t<?iRoJpo*TmA@isZajzf=6t>1%$;Cv_f=eQ*D#oQ~W#w_LIV
zcFQK+V6WJ2xnIW0m@54mH*@uT?>fq^vtN}@{<b}}bDiU^mz>X+xiHtQI?uVvH+%KD
z^>O9&t-R#-#F708d~JWaces~s;*a*QXb-He{vW{i$&RhYxqXJ};kG}O?OSD6TjP6v
z>fSaX{SADmLt3Z&#!;?di6NTU%I_4NJhMl|DiS?J6J2|3>a2%AQXazgrMqDB-pV)T
z(p#tT=HdGRZ|ejd+ZIFh_#OPzt}Dh6E&HLb3jLlJ@N0r`5W{0(4D@~UHXM3~PQ4Wu
z??&E`dQ*lt`c46h?<t}Q{+>3IF3I1eDof=Gb@<U{3t|v!iF1Li3H<QyDcz3x&A2qi
zrg1lopIk97=1<<Aa{tL==DTNpKY36a)@cjYk~Ll8B&<KM7k*;P2iQM9VPE9TcGf9Z
zu>S_P>GEg%%!PR|zghM`SFYGok^7N-z}_4Beh|uO=X;6vf}za!6>`n~T=J(a`6Cvf
zo0V%p|BS=qK{wc73UakLb2_8kDKm+bN3!c}57c2_U1dR=nP>ZCoRRt88J|ArcZnv3
z^1+#y8Z-0pyqD(5IUomHxgal}T;(329r-krp(pG=AlDG0CFtL<pC!ICIg;RhEa@9u
zw%;vXkM9<d>p)(}QO%QWtO>XtNtxWjNw`zVKWxF8zz|EcKk6@;lBeJ`9a`7Tcenig
zi{HUa6dS*j@q5`${978otHDZ+WaMvx{Ql<O;+}q|!#2wAeQ!S49fz0@3H`ZG+w6nf
zU$9@uhZsu?(Gup$oVy?=<bzz1Gw6bxI>*SCtgbdM4B4OPvR7DBV0|M&hn-Y^^znlI
zs9zUPZK{v!yV_Me21~{j!uxY+pZ*Oa_ji@Gz3okYPf&l`tIcPv>pTJX(o8s)(8TAg
z>dc22dB<{J@j1r*%iY8~0no8?|8n=zW+rYQs>83#KXi|OJ~ws8^}O@B`~3OO=PRH8
zJwb2!yd7etM2B{PZ6!yN&k*8n!RLsfj2+)5=)-RTKI2WKj(h^YlX$#H;u*^L;0sL*
zy(@T^G{N6h`5S8peuv|CyCK>IHnXIk3v9L%>!)~4{@)m?hb2xz%$aOS|4leF55Kc`
zD=|;zO>W8Y5s^9fTJTv1tclkHA2X$6_nO%si5<UD){Z_S^UE0gW;?QNjRjwih1iQY
z`L1AJvX>+Ga@T%kKR4}X!#OZZ`pLb{9tX<UhoCJnmf{hUy+0J6ex~;S(!S?&-%ze}
zl^GkL5Ak{bsO=HNA>JL+?c8RmU6eLkZGiDGwwZHe%#7c2@qDl?K|P=w+n6g5tEWVV
zEt=W@I<}tDb;MbPBi-Ye<u0+lWxMek1IgWGY{%d2Egi!?$R|Jh-_q?Z?|RB{!Q7bZ
zNSY*hASdQ%T`H`TsrIV79vKg~{;1CV%v^_Bwr*)3%dIxxa+gj_ppST<$;O`Rg1tKh
zd$I}k=Me1Id%t5h)Z1t3Ohj^YhJ7zI>A>9pobi5vjk*dp=r6e55<l*d5KVBm06I3a
zq~l9F<jJ}wSqYU_`fg%t4$O~yFn{ty&W<35Ly%AMO1_U^9lRz;uM73~(vBF!A||<X
z9?2Q~b5AbrP2J_tr4R0M(XtL3cRjxYwiozJ@aMvjKIKmw?&hI9F<){r)GuT397AJc
zj7Ko$IydIH1h$rvvTgX&mROz_atr2aD4S}-7qBr7@<mKTzvPs2%bDhE@0679GmYO7
z_QTg;3qgHtM;pLa!PW%pdNdATJkTx}FZo-U2lf){ORf#&C#YZIq@>J#WUczeVZR9W
z4eM!|bk0H-?5BBw4XB49wjd7uk$={4X&%gN3i2MBKlxj_qj|6Hgg5NS?}k%v->$d!
z$nOQMs~!B2zu>#dM@nB=*Cb6y$8IQZ#Ud_!vTj>rVJ(`*!8;q@mfwYzq#0>Lwu{@w
zn9P*^M3?=IqcMDAsU9L}lFZAHubVC#9L*6vIgkv|#OJ#MYr&c*A6;^&jGcN|sUPXY
zr{BM2tKAK;hzVUf<;s3&V_WS%G@d0+;Vs9u+n084gzDM@9>Z^C&v{PG6Fg^^-(<-5
zpU~8fH5)&`8b9GP`8V=&t~gssNSdSl#CZqy)(!R}@OS$yz4A29pKK%N|IM%V;l8V+
zzLuYKe9Tk5Z6Uv(AP*Ji1{-=4oKendJ+IUe+kM?~moYx+)!+5x4ZY^iIsK=y#`;P3
zIG*Hum}|&(bNf+`?e_a^nYQL`V>|M$qg?B^%9T48HNSV=TlsEN%S&tdH*kl*+x;_D
zS2-#h-?3G0-J@^d_g432pNjVzLVo7x9$sG<sxwVGY|ZO8*x&M7o2i(ceC3*iq-lBP
zhW1AnocqbyE?}b$`_Nr*c+c{lNojrS%>~$(IAZetDo_q#J9o<)^tB32{Zq!?1u^J@
zzUY^?-{H-!_xRAe^XPrpMCa|O?-7Rbc!2sT7T;l#!FQG~Q2$0Rb?6n^EJ1%;W7)ia
z^^OgVziA%4U&#~mCGV^OphFYnfVp?iowqN!P&?}JW8GNWov_|s`<46QCwb)eH#lBo
zUoInO;<~?;OY>k(%<X9YLonaE7s$aUf4Lu;ayt0_Mt;T8-e7-x_6Xlk_zowZ$ow6(
zhb1B<<xXDJU#M?#%Gf<0%Oe|Sjq?~f&%H|*?T^|Bq{~bCDNs*c7c1`r&Ns1Oh%V@Z
z{z5dtSZYo_>(AIVpRVsjpSdwVfj(p#+B2V=kw47`h+%!I9KV1ys4SI7(j+UkKgsna
z&RutkugA!Ew;&hfgxt*JNRqb-wj1h)Am^+dYj6bX0kg2BoAyWT#1cnLeQ(=*kJE2n
z&;>R_9X6mITK-;kB%$Z;X`A2E^cx%STiYre=}>?BoBF-)rq;Vnje{N+P36j6|5RRT
z1LpzkAzFdC4Z(avG(j%N3%LqGKFRA4E!q9wxv%<D{giK|s|>6w>kIJ!_9N_HWBjD=
zYkVFT(seaP&oNojuVEY}q(e)#_A0PvztL5H<Gnxgj6_PxuKSI|KSUEtXOHt&?-9-<
zXA>gfJdeB^xP!P?xohivi){=1@INV=ByG5lLu}n+pSz5^yWDq2cls)D|2M&B0Fv^$
zz((Da&(Y@spA(UiGIr`|cM^0Mq6vIxH}rY#_s9L#;Qe8!TMuA=qRYPXopSOG(ImJ2
zUfRXcZ);1$15LJ_zs+^Y%1FEARvCZdEO8QaY}Di13rGJy>CKW2uvcH&!cK@u>?4>5
z^I={?gyze<KW{nSNunvoH=j3D*4roK2di+Tzky$fCRoERSjXURjT(dV&l;d($H)EA
zj`l~e*Vr5W%;ocVip@UFeY+%E?&T@TzGm-_-2d!%_?!jVsKW=}5VR*2v0HxD(`V#<
zL{fg^sIKcxu=8E8_#3J?DTgF=%)wA@#m{pZITyyp80#EDbGY%`ESV$JITFhd6R02Q
zi$6NHP+d#ri!XgKj`a(Ue7@lrw@=qSXYRV+l%Lw#_9Pv1<(xvYiJBYoMou99f+k;J
zpH*xp)_j4wZ}qf0FHmP9;~?8b9TWSn3-%-Xm%YnAWxpEA#<r<?&H-m6L`yioBk7Wy
z>6z!7Gu~dH&h<-o!xOZ%U-cb%=WN|8Fca<>;0`iJIzGgoiU&1T=U&S8NMcjZT$m$s
zUE+wI=bPLNu>^O@7UY$@dmYfRQHKxy<dPV~BX39jeEOqbjg#-Wd|rj%Ugv&?QSSOB
zJ3jcfoF{W;p2XnJr4D+6ZBZw`ratMH`5DIY858r<SeM3q7=PXyoRNA?y2{i8I!x)b
zqdocYJR|ex+>rz7VTmKi&kb=p;}D<tI;%r>#!k>V=bY;)e4aVe2K!0yy>T59UlY=y
ziKV%Xoa5FUnI~g<V&wcoa~hhb_Y89f%H)H5!zgRei;n$?>VwWY&Lkw8U_W_3vnPPH
z9|g)4_7817F*H8L&Ky`9=vs>{mgYwe$cb|_l_S<7c+>L6)jRr#srR?v>d37!U|+no
z<@;F=#Ud{24fI1EBl{ut7W8wlGo~ElXFSvq_mAS~yU=(5`!|l-K0(ZzkPWK+l=j%E
zf1=60l#7vcNpNnQpU-?USGOLr134y-BSFXJI_xc>jyOAG+6QU7$MQ|m{x`hE7&&jt
zm1QK5ABYEBhu_VR&2;Hcc-+j_MA54aJGnIE4@S}?e}nz2yxVP^1DJ)+*--iDOsxd{
zzk%a@lcBz#3C`c=oJt;@L3C_pO9y=2Zb^qz@SJ`tYd)%8+t>Kk>GyA#^8arTiqiyn
zSqU~n9d;yOpW?hw=ZXI2XZ!76%R}ueyOhyQ^?B2~{44Zd%eU_FRXKC+w+z|gw*RJl
z)b1yU6M}W<g3lD#5BqwkzCs(?RvZsoOI%N#skS3KJmu-O-Q`i%&HB#uql|vvFD{4f
zteYj9IbGxW4_IpZMyT!vU)!2=vvv25q)S$g#{0%p-QVyQ=bN4Qku=Gb>(R;mwcbbj
z1=u(2ug^O&-;Q0f@$L~v^xTK+MRaUHeH6*tYb5B@;YXWq5VwLav6~>?)Vr$d-PL&a
z@vhVxvWb!3D;n=bzC#G~NGNZ87YV+T=sQXU+YR-%&25+JDz`6XgP(QUca7sSCXKoC
zHe@cE+txfsSqIjl335T+BIh5Pf8%W_4!Z2*2;YOh)|T~Uona(P64(pIwkK(yTi!9K
zukFXx-|b(0tL}DP?G5wrUJdEYZwPWlPMG^t4yNAO?1!WM&<gC2#U3e826BJYX7PsC
zzFLX}A=s~7kY6PI(C5?`80X44GEU0m;0W#m?u!0Lz5;1lzV%niojyzcA!s}D4j~rI
zBqX5;_f1~N3He};FmA@mzG&n`FpraC$B+EchIt?jc38<>#y*lJ37>qB6VVHlD_dnl
zJIAra2KZQa-IHAMJq6|hTd)@7hdjZNPTt;_s@sCRFTpw-;We9o6uZEh)pa~t%g}FI
zfbO*&Wv!{3$(HQ=7Rc{nVu_~T%R)?kHxpgIr@<&}>Cp6Bpb6=frE<k}O?J1hF{|FQ
zFXRn=w~aD(*a`jIP=`-1FvrhaJ%35^LXNs1has9E-$V4|^nb0-Pjbr7g!Cp@Utq0o
zT!){b-4j!GI2RtH<<q#`)-tk>CTTnt#@JtA&jR}wLa^5jX8^`8v454cZ3*YA3(g(q
zFA7aMXLmf{GmXFfy8Nc@B<|Fu`w7rPU^kSTpnep(bndpp=ceEe=k6c6&$-h-pQ(JV
zid`gnaNiebhrK80)PFut_*}?7=m*<TU5G&}eTEGE4J-2PvGbjA^6i0~vY9U3*tWAC
zyW0)5gC@4#3zIj4;0?iBqKU2F)CRw+@%x&7Zv*rSwwZ*a!FB|`BiTjAMjhaXe~6a&
z_rISc{<OQ9vcVDbwFPsEoZpcgn(t!%<VEkg$y-UeHd|$EH<32{n%0Lkngz;lG}SG&
zBQ|~Vo@|9Bo%qDYk2q7X7uZMajn3a6#maqxojuhH_+!Hd-_IV_{@Q$Q=l<u6n3Fc@
zI0x+gmHUzSM`Q5Vk&)xVUi(FN-=B7B%bwoJJ#LSkv7!fk3H&)1!TUlmrX`|`eQ5mq
z!ZxJo(wW~IGh<rXk8%_A-IIG9_!1x7A95$$NB;!wvcH9X+y?!(xXm|7tfe^t^Xr2A
zKqN;wdSj^$MxjZsxNgaQe!zWJNt;^!Np~Og_r_42Y0^0tNBfeq5#qB?*{g!R&EAEX
zgk%$ovzTY2OYS^BoTDa&&N^qFd%?`SXKopJcW{4Hu!H?wM&ifaGDJ(b_im`e=Lq7o
zyoXNSMaU(v!+!8#PWU0G*n&Ba%mKL}S1t2MJ}b`a$-EJVzPkEaW$b*OMSgy9m;3W;
z>TU<_dceN(uAged9P9jsVgr3JAI}NfN?eZ*`Vq{HIWZsR!aa4^BY7??y$@YR+J-;-
zi?-~op45EUMm>9Q3EC593(h0wa|+&1L+k_{x;Ux_{6aKQ&ogJ5SlFn;$9|UBpKu)7
zcfq)TF)~NSJif4V{>*z_gvy++Po9-)a_;@qRL0JJGL%D5S6R6S*^jIpYq)Yfn<VSb
z9%FAr*=Iw02H0<KwC4bQQ<g7r7!&=T0%KzAO><ywtfkj6lpFHK+VCdkjm>-f2;S^S
z%AdEl>W^|yZkzH*Jm$tcJcp6<`Pi7N`X#UQ!@7LdkhivC?yh!!q~~`az6(`sza?${
z34BkXouzfkZ*<kc)>vl}l24E;<9e5?r0y=;HWY((U_Ho{*JW#6n(E-=BT1Y21NfMu
zHgDJmIbYbagLCp5={CrD(TVi~_js4)0P#SR?S{OKq)Q(5@B`F+<8Ct*!-RBb$>J=1
z!G6Dy-{K7Q@kEz>=e@}uf}^v?Ip+)_DNot)!~c%6uJPBgM$Y$^^TlqzR&sRfcYkl?
zyWL%;oo#P1Zu`jjcgY*-R>83?pX%aE9;WIl_||gOsry!M-}5DgeTZY4ba45W)YW;R
zkL0#L`9AsJ_ePYl*aw?+q+@y<UE}$N{cgF+T3UBME<edpa?rDH+wgacI#%1F%nyAQ
zj&yjtdq%mxwshlruHLDqD|R8I|0guHudKX#hh$GY9_0K&sO}rJ?KeN_sxSICf9H28
z$1p@ow$^PHy7a}J$o;7I3U8K~@0KPzP&Y(RALI@7u(OUBO?17P{KiD`7Nw6vU5P`v
zGF66#pW5(-o4l)d>*?*)_2!y-Glpnl=q)()CXDh<^m}pX%{cP=iodHYeLpcr`V;t?
zS#*49>o(N~znwJo3G}_hXMBvAw<B*=&1o?=&C&TIC!RO&)vY<>J2Y?JxyVqNcc|Z(
z<eW8REm_+wyxvIGe_awAbvM}84;<B-pL}cmP`jHZn_=9Bd6+K!XnxF*{Yb9v9I-E&
z^178@_67Tc@)V~)4gvp9UX@4oSLA*}vL@Kbzp)Q}GX@jV8RybGw$3GY#}xNFasN?W
zzV(qqWqj~$!uJa?INuN#C-Y8UBlGs@yX1xOu^)i3ogCjT`J_!x&~J9y@S#0%ns8kD
z=;A0>fDYJUKR|nP*JBT{3Y6cl-;s~U&X`-~h1{4W{Rr~86Yg>Awv&I>f%RZr>Uu@4
z+mbwj-?5N@trA(L4nP0yh1{a)_b~r9c%(z*Z)RH({CgU|t*zw#?TvCIQ?g=vl}$dx
zB4(wl4DS0k(rt*d65>BWJ$_v{_S76hc>d(03G(B7kw5ZEKAT`YhG1>r^ndHN*-qUQ
zQE1X(X`Kygj_$gjWT<^*s%(yQQ^!-sM7{m1j1sp=2gb$tOqYJc9%lbW!air;w--Wo
zSOwdj>`i_n?|}Jm9vkOXXC2TXk|}AhH8JEj^L`z=U%6+wZ?~Y%v5=IzppG_2zO>;!
zUb?gS{Np{)#o@D5aGzH~WoY8_`H(t3N6?-)A&7ZI&pRIp*!>yI=f>wVMV~LL{GE!=
z^^>3RAqjlmW24Sc2I@>mZ-O_&xZW63Z;TL)_lAB)`~04!-_>@~WdrQ1KpDIJ_&x3o
z{+*wH>l@OceZfB8<SH@I@vXL_vWXlUV`a>Yo%u5Fo;e{eum!m~<V$&F4S4_YdC%uQ
zphtp^jkmyh;K&yFM&O-*K4jzXip1{;>&N?&xQ%*&{}xMoVrnn357{Tc-Wswy9x-7R
z9OL7MzuK`6Kl?k+1^Yf8_C9?CeX0-Q5W6MlOVGE+$T$Ii`df@m?HM;?MM4wQ*#{jP
zgqY$8kCpSnc$>ys&obwh^ZQ1vN3UhK!RE719t`=QFYW?E8IGVH-z|u>E*!tsaX0-F
zxYsIE<w~tXZ%G|f9ZwyTecYx>VpXWKKQVej4#<TG=|G-<oWZzgDp#mq$&m!d`mLO0
z9B+D!<$ivWE63F&ce%5h_9pw3{mR~jmawnA&)Mre;f!!*LYzEDoTpacK7pB7?<#X|
za3}qSD1PYB67HUHLERE3p+Ckz|32@G+c5qL^V%2KD&&EDEJ41y^2c36E{$`F4{e9~
zVGN9i@iF!;_*~=uo_UvZp95vHrQ@>%{@m-dW$wgb&Jcpw^wHGc%DEvcN9D*lF^|c5
zYwYX`_R-cJY&siHQ0INw%Nd~^W$Jc;7(*=Kvp97QVGF)H0q-YR1>3r8_yX-rNH-_@
zpdX+Nu78sD!5>D_B!PJ_ALu{8{9%a@O_0x#XRW6^$}`N|D@*%^z0%o3S_jsGJq74+
zv__wG$~EiPeq=pa-yvGUUYljVu|L==?3pguLxwW-b>GkjdzW!BR_4Kcm>2Uqf}CtY
z?zYzA^A6S<yXg%cg(V$ZR~_q1o{2?l=Jn|-=fGSjZ$aH*?(!pNOMS8~tR;Kn=-vH^
z+vP9XAK43(t8J<LTSoCkziAo!H*)9rET_shcU?~(q&dnVxNJGohdRFNkYjRmlq>S|
z$$PfL*U;W=(Vxn;Thhl8AzFfd68lZX+sSWo^ycFj#JlOTeZynA<<eN=2b${1<w(e3
zg}wL2o8MHMH-f$V|0C>~%4grm#<@0Add2q69xKomR>5;)o|Rd0QteNA%ltU*UAEoQ
z_5a(_{UJx8+Uppq9lh4Q>2c-lZ_2ae_)V|zZl7BBq#w-z?s@&D>~=`&v~$_ET7DXX
z$NW@R+x{o|Q|vce?Pq0fM#+)u-`dZzW?TAC)H`RCdkcLf+-c@>|LOjWU(n=ZHuvHS
zLw4vFNBx^A9U^Ixzr}6-6Y0M07`7w7)h(^XD0J3F>l*A?K6498It<ao*5`2-hc}am
zq)BexHfhHPW>VYG4vwfkTfR4LN8C<)-f+CRcvtf763C|VmJGeQPJTb>dJi7niDD)p
zx%loOCf`NG(RY)Tpab>_zFW|a_Dyk!Mcgfh`l>9Ip=m7PcdXupjE}Joy#>h^^Yfgi
zbjsw0`G)2?HCN`f)DF<GQ8&~cU)mq7&D8p_j=-9ly4Kd0>ffmQ$a>vRwjrNlxDRBl
zujT54-V2PMxj-b$Z;6q6kX+S#k;_R=l-HAc;gc`k;>nh5<WO=XkvaXeQC^qYfAX$a
z>^E|ZJSt<ab@a(PnIoO?edeS4gL|p}(YVBZfZsa&dk20;{vn#+e)1i3l;>Fp>Ezxl
z<<2>D?#LVY18hH0eZ3aMG`0~3U)IBG!JcLAs}Ry}T#rAnemiN32gEc>`V&X?o5*o7
zKJa)w{-wE)FLE~pxg7<{TXw+CI<O|J&k#q1ezO98x3Z3`b=8hOFSg3i^&1$!g)M#$
z%iqZOo$T{l8NZhaen$g-Q-dw)?`~0kheL<;z>&>RA4!uWrsH?%hW_8M4{{`1l6c_w
zme{Drw<pA&BIqacKrUbiazyUBAit{+(wpE+jfAx_wjpghUGXkL<w{c-s%@(LPdI9K
zQ^!J`%T;2ZNk~E~tZUDD-?FEpaJ1jq^L77I{)r=>8`?C%x$gy^LC$DgXSLQ*-vnp<
zbMAFFOmW1Jjk+j4*eY(bbl+~>!TcSCd%iuu+raQS*}2p8c@X)T(DnIwbmtq&z~^d{
z557mxmN@Q%GIc|KQ|+5r`MJX9JD>f$19%ghd?O(JKA;XLM?$@Qn{?h6yfb>@cS-0y
z(!}O>z5+Ib54dbUeq-z6=r=c*Nk}%~-|9yGc2{MW4W4YSv&6?bvX;?dUC_T_JTS!(
zjG3`-;W;6h;}PVDd@bdzXKq;o-drc8*MywE(d3ICZKl?-YfV{K)|WTJ&iC6&KYY>g
zr5?W!Q?QTNAFu`cDRMut57|S2?!9!fJu%Q}N8OeWdz|+Md!9GQ5XhNlfW1jP$6^e`
zX$5RYcud4cuVuyv!~yi%58Dxpoj#G)8OLEPWt^PVmTv&gy5Y<NXS$y8t@0E0>8f{I
z#|p)17uZ~Xu6~~4KiRmCp5TtEJo)^_wltTUQS$MvuKHQO{c9PYp6tvGIl7r?vvmE@
zIs)tYhJ7sEwo2kYv1K=|kB9M9oBO%t$}u*{uDuxAliT|=_jQw8<qY^NblG6*tZ-%^
zL=(ObkevCR_X2l7e1SU!xG!KNP15YVyS_>8uAZRdOROVm|BPqny>v82#?L&q@ciE7
zxN>5@+IGo@{7u1KU?_(m202<9*XLf={XFx|=H50<`qI5#!3I<KZs#-6_dD|@XF+Vy
z%UtP``5MogIn*%^?S-X1!Tw-BaV|I?W=V&7hADT!-lPqCjP~5gfR2rN{Dz<nF+xmn
zUZAdGzxu{P9|^jB+>WyKTZZaPlMajx7$@{(Yy6%g^E{f9p=|I0%G5J=^1%Jid20pE
z9yw=!unz2{DOew1y;!@E5*=Fw8;qn$vd7u$?17W}fqel@e9lLnm(E!c*noQbB9|c6
zA-=}g%N}8V%ylQ^YKf^lZmk9H;;uJ0Z||Lwa$r|I`Tn$5em;9o@jY+)BNtoLeabl^
zUyOq`<aDY%`3}V+cFXUlyUXv-zZudiOXa_%w*RL0?00JnFbg3as_i$r+kKNYj{T1E
z0kuqySc{WuG}5QGN8b<F$8l*(JV0L})DA!A!SY+qsI%WKw_+LMRyzG$9F4&+9)ry~
zGLj}~*sCxEIRf%@GiAF8*$j0jxnodgqO@t!VR3#6wpZ!;YJ1b8^kLn;#IgP)-OrF;
zFKo{F1NOn+Ea~9*agArHd~^Fem7CiA2HM&Wy_RkNC(`r!NxsFdIeGJWvPaJ0zb)O@
zZ{pgw%AfM^RR7i<`#;T3jcGk{4<P@ya9=;k+W*veZqADhd&T!tl_T%2Dz|J;a0ga~
z%BD*<*sLS(SX1$%P{)YAUKlU-+n*S3;Ojc{8|rSG%R_Zfxc)bi_DyWvZ&P$}bT2N^
z1n<ZS?<C$mP4GS(`9|cO*t3lN^QMsxzDLk*KR_Rm&?mUuq|;^yVh}4tOC1|^u4gPu
zZ>ps?*5Uo7ci7SUFGLf(2P;Em-i;wn{=Lo;o0-zL@O$zTSMgiE<+k2(yp2bJ@|2yo
z9-vbnycaV+%*QY%^46)7&z3*$Mc%Dj9Ok6<_%LsBa|CO~+5ziWVQp`gY;Y3xJ-YY*
zt=sRGE88Psh?bx~;rc2)ZsZhQFs~(;qu0NeJwVQa90+pB-kV}6KjfW!vo^fJyY>L<
z4^vQH1$;ifYD0dBLp)$D$T$7be;ot;!x4;;@iK>_xpT*~u6BaA;1>L@aZ`Wi!0*UE
z#LD|>Yi;H)?<MD(+%k@TLS2`ibmGrktH^aCKjaF?4WOUIIUMpMXS5@4C+Ug@E?0@4
zsdl$P&cc=s%wvfo$R#<gp9NJX?^F37S_{^O^*VyzsrbF>jjg&TTK?X}Z(fz9@+t5;
z8StCgPW)RMlHb-~CH&@Q{5zcGRNXi1*W^b$$L`WA9><%sFYQ<2*p~F+e(=G!3t~<Y
zf;^CqAzI>GI^VtgPRN=-6Pzp73c5J`|IL)m{8Vp0WMsRiHr0l&iK5$Pc~ti|xLv4S
zOW2>|x*O{K5P4Uy*A06g#sf{Zn~=>=#~B);i+b+RXL8$J7o1t0^UrzL9k2y@D{ZHA
z{IKDRj_stx#vQ^v%$>~r9D=(VmKcK1OYZ%ZpP79AH^E&$1owUg+e++5866@eep{a#
zM{fn*3oYS2(0LQ+-4LQB=todD(}yzlCiq=z2>uRwbMkMb{GBvJ6Z{=@Jn;1QRs8QZ
zU2S3OcQ?cDa1i3?cRO?chUfCQe%t%0T-#OOs^fEBU|d^x>{SlUg*i?^9?2{DCD*&)
zbz;p7^<Av87F#h`7stV8sm&3*8IY7)G9<Bm_JsBZ`vi`3K;L5N%{H|c*^@)CKb!Wc
z!FE)SAO6s#*LJiCwK<~ao~KL<+IK-8E%!X_9n0}X#>5AR57?jRvO{ejYDZs;$Bfh&
z4`bVcGkQemymDr5wrpMJ*%BSb1Fo~A4NMV&e!zX!e%<DdyVTDUzI$9p8R7-k+y9oX
zM^abI*4<`2%-y!Gy1#*TEBlLU?03KT;Sc?RJKxSZ`5p;+<){q!&ZNe%&5}C$u0A0f
zF-L(ioENAYqKR3~3467Rqy0M*_A)fV{`X#=I)Cv3=bF!fCOG#q>5|{zo`5AnG*R!U
zp}XcMdfr(`e0PC(#9iVD#<B(DWV|aml7=}l*DZY3$-_#>%`8xMo&Axcv_U5x{e8xu
zF>;@BKX2XBadC8quM2GWaj(;c&&HK^^HeO)pZPM^sd<i^SDll`#T;0B_5k<g5$p~2
z$zh*ppRw;+o&nB*S<=r1HtK29bB{*uIrbe;K7!ayzO*?>J&#job0@s3D!jFz+N`?`
z?H$89G9GaMj0J{h7tF~pcIbk+++cUTeVY9E45*(=JNMAh-e`h7$Npe{vUaTDDtJws
zd{|dQ8ULQ3zhNI@y@AhNhmDw_z8LG^-q3tP^I8H4EkP#-<dU4TK1=X!J_&DU>JGlz
zd*ox4T#ygbIg81b{ER`qM{xe&(_Z5m8W(+UV$+Ad51jnoy1Ux``8WP<v}AkY$X=;F
z<7z|MH0iL_-xNJz9P0ub*yon6fAb;!H=g409e-#&*yrrg#X4oK@W112*(%g`5gPYY
zyQy5W*2H5?S?i%b7;|k$PRyI#^_JCdX21OhS#wtPrSUuwvYRFyJ~`rVAqjh_@|ia|
zd!RkoZa=q2x~@qF^7l{pC+%y0ZvP}dYs$KcE;wIrupfYWd}#yg!u>?%U`pP&?r&tv
zc(g(P4fuZJrx^F#{<q3?96ycsseWpnzk#;D^*dTuV9wV6R{ke#8Ed8XUG2Zo-S)|s
zx;Hy@D;bjDGV%!8&SXm(-!X4x+mUa+gFC&jr2oX=o=ec7Cr9loQ)Ls<O_L5wWBV;`
z^VDu!aVX#XwjalG`%eDE)>_=S&c3%?*SIL-)5T<M#nOE@xcB&6O{OGegMH~UxA8{N
z+h>R_j@~VXGIo59pv^2XTJ}SK=A@1^u0z^}toEUD6O50(=###u#<TcNpf}ah`)VXj
z5;pHI-eThDZP<7p<~y<Lod~=c&EV}Q-zB=*PC*RfE^!2UD_{@x&v%s1STrW*hB2ah
zocK5fae%g6a|pHD_-l^L^$6CBJ;3_0j;lbq+UkD&rbjs!)}Q>{m-|6>!FUYiCtQ!5
zg^<p?mSB#oC-Y@ZVTnk{1$(WLm&{vJzE~61Gz4qKnz4ROto$w#(plS`>xn;YiNjhD
zn||oeIPZ+j<C{4?#(89CuH=k6sCDULiT+11#nA5=>jIm9=a}+2@^7?Jj9J#AuEA12
zH$yhlue_6IY?gPu%cHbIuVwonU03UgJ#+m=u3wWxuN;*leewSZd}*^T?l@b1l^Pd2
z<6eUGA+MEF){Ok$>vgn7as4*v->;Bezi9!#Z>?X@^qZLB_c55sku>~{X82vrY<^!8
z{_V}b#Ua<lQMpp<Lv@bj*p|KYZT)Fn)X`>_@ifIX*bRQr1@jHj66cK^_5%5xNl3C5
zD~UWiP4aWTbbdy{8p7%C*r)nU`B%QRcU_J1pX$VP{~^7JrMrMTg*yRu*}owjj`p@;
zpFc6a*qiDqK1=l+q4(tJOmap;G{K$7oq2SJ0y;M8Phm-~P~WImn?}3*eB|>Fjy?;4
z&r;v}d<M_F@444cer9ve``#bA`+@Qld@d~E&j~&&C}ZE*uFKzli$$;HslR`k;BTP?
z>^niH?(nx#(F&BSjo+!J;P0Yv^f%I#grsTGVe9Xy729jwkWViheh*BhWF=IFR^T^0
zGo%~akoK>(TOZl>w!1C;!W8ERm=E(}o=1=~^18$kUHK;OO>4HqDGcd5*CXUx^Su=Z
zn`0nXf=*20v47YjfKGhu$VfYTi9LD5;EgEQr@S+OGWFhf_ygrA?Lxj??-KU<=Y1kc
z`N)2=(uRzrNgDcpgYi`GqaAUUpwF3OU>wl$9C9wV7&@z*S%_px!V%m7BSEjc*=a}n
z5UoJj%+!%b5ZCdL`vvY9xa(~X)m3b-@^1T9u5GG*`;W{E^8nAu^XgguO%j7XLM(9}
zzz!kW13Pm@Ea<{x`X(8#seW5_AkH`N39+=7*iY=M#=gojHe)+JUGTXu1pAV`+Qre{
zHSA*u(GvDK`@R=Wp1+xAku%BJ97&f1-vPI*_1q8K3BDtS?ueFf4;k*3H@fO7_S>bs
zW3F-!(YMFOn1)z_`7pOFm^bq`OFFqBN3%egI{bQp7{m%eeEK^Y1LJ@p7$@WBE^T7u
zXWP`>9fEt@P(A`5-^aA${w2oDIk${WZkzh0f5yc)S$FQI&^};aus@de4f~4y1?=gY
zC0m7a!TFd8Iy6DsE{H|kqxkeOQcl^Z$JgzUQ=G(asi8O3H|$rXV^m3O2+<PH$7SkV
z@4At5VZ6Yc7(bxbGPZbt`7?K)Mb04Wz#eLXeZxLExd+)RhV^5wR@g_T+N<t*BzBjH
z=h#TfuCs5K|H(bdJ_X8CcG`UQw8qUoVh^>PA9DoC%oQk;6LQQt^7fwjM(@1ORc7tT
z^OEn$+>n>go-KJ<>iY=xGh?70Kk|5zp)nETFb>vP@i*TA^xc5(4txh0g)JL(EkVa;
z3BEi11b${nhn{T3o)@7q&`-toCyC#a-L{#1Y{}n1yQP@qg|$FZb{y*Ou~D}lz)st)
z7_9G9&H<gZJ-OaPKE!k!=jfI-f3?ni)BYx8d&Bc!jNo#Wt{bXvf_%VCm>Vz`ScQ;o
zn)IKrFY+hf#d-NJQTrlhE&o>cSccm7Ux44uk_~E~kvW`_zr}4Vf7|YF{Tv_JzTkQN
z6FD*`&WmO3@2CE$znNe1c~ob<`MEAiEc8lK`3d{X^tZJA{|iZ<Py9{acl)E5KjHi0
zzB_99_Ho@$a_BC)*|PmD+;`B$;eHb{3CWu#+uu;z*LF+!gYgUO`x{BTUf4QUm8o)E
zV1u2~I%Q(rF&*FjA-|>1yPfaDmG8gJ8>rA^cX{y6(c5V9b`neP6+n-)A4&XZ$NT9B
z-k*~<sNiig3XGw0R0hWP2K7S_m$7~N*ZZlyy|&(4oj0G}ej$)2L2truMD)0*_4rYq
zf|x@P9|=7{=Z$y7)*El=ZMO=%^+MyUOqECGklZmJ=Z&1T%*QP2y0pH)-n6XywC-Q@
z`46Zu+Qa$r7)I_jWEWfGyut1|>n`KV+(NLfOE72l3iD@;*+b-{3G&kgxtfBt@9ab6
zb}Hvfxo_nES{v4g^`VaSY522eGUxO`pP|0NV;Hhw2W&w75=SuhruiM_t~_xswJy8h
z9k>O*X&kW<%1ux=1b!iZ+7g4@6A#ue81iWaa(d%>e1F4w>G#NP>@zZElcZlHRC}$n
zeaWYSy$NDW(FHjM=i6oK06*9l#33H63-ZfnN9&3$SO?aFbuml&5xx9Y#qU;4zhm)x
z7OdnH-E~biaCu2Tg5SqrCR_3w{H|vBooyxlEso#&o|v*jt!w!ko?{@1S?MZ2QO8*8
z-FD@;-XwlqFz-mn2YG=ZT0)*-CS8)X0M;c$OISM?qW>kQtB*oRzp3@skNk}Lr2jXz
z>Yl*ACnv`dl1qD&{mET0^FCnD0_BSBM|&K+*N1ddZRoaJHraqP#98VO_}p<0o8Ug=
zZtNG_qu4C**@8AvpnS)n%@j-b`{!=gz0PMQpQYT{A-Ko+tRDJIhX45tm(JfL{kKHw
z4mN!A-skTBd=AJS`rG5u-z2wwa{_e!K8c;bNfN8c577Br<)@7#IzE8D66%}aZ=A%c
zbd^oDqub8kNEydWLejL<YaKRzGc#TKjq5C__iu6hE(eh`Nw|N{`&RaEfVXs;YRBe2
zkWr|1*G<)*#PjkzmgYfjj@Zf}YcRDQUU&A0S-FnX<44ZPBkhrtiNV?#{8(SspO}D-
z4c||@%speFjGcD$gYOaEe@lDNum`cjyugMZd!0Sc-wN6Pp>x1l;LY;HPJ5Tc50;3e
zNgCq8NQv$``>$+Y<&llP8|PANy`6^6D(Ceiq4NuzW7y)pBc5#dV5bd)aLgLtHe|Ka
zh8Ux;Qb#_4Z?*eQ`mL;O(cLbtd+zpoDi5{qKY$M`;l3=f*-rmc9O1ise7V!{rA?)&
z433K&iES=-*>7C;CU1YrJJ-IhKWjWh6MQCg!QNXU*n`@SBdL3TvR5xcWoXILz6Z`h
z7hC6TiqF|A=XFSLd1g7U{R{Ox<F|ANgy25d+#L^aU%c77>MBR~3)nVP4_nX&{n4+-
zv86M1!(5g)33Fx6umyP_C*V9GDGz}Uz9EP~tRd)!evkUEFeb(t8gmoewLS08raRL_
z-o;0fdi=Ja-4sU<2S(17e(0BRFfPV;SX=E2_6hsuuy3@l*jshau`g@6>eMa4{^v~i
zEciT7kAK~-j(@kEY7Zyzc|>w1VgG>rkp04O=_5oFjNMSi?mE{q&R*sa%FhkCTR%XK
z`5YkMoJn%ed1M_T_f6NjuxGqqTJD#rwYy<GpTMt+r8PIKKQ{b{IRt%Fur-0tOlSkN
zud%4dpS?6ScJ3DD#N2MCY+Eq@soarQ*5~lP*4v#od=tFYL$=SlDc|^qVv?Jh7skw)
z0&+zi`x!rAJe8v|xn_N)`tIt7K4B#2Cv7clly{epzIUu2z^Bqx-fH{Al>H`TyTJz=
z($q4#alPeMU4`*f>R4~R$rorpe*u1moRQy8o>^<wFxMU1)cOWK8Q1OJ<b3F#wm_YA
z<freH=r>C?u-)a5%{1w-H3u`KGbdorG6xgPN3_Dy-hP99U+dfs8+xs?K2-OHeUSF4
zwrZ#TuA}TRJjq&L+m7t7OKz>Jp?qUs<VrkO_ZgYTDyM9J%Tb#fubtP=_0?W=*CS^V
zl9i_NH$2ZOng2Jc@00$mzo)v$G0&WX<#{M$yY2RWl992I?V{G9&*T){He@`|Wc#N)
z#ltoq`g!xUoi=cOpzfclyB#*`$m;XA`cN#hr5oQ}$hfF=Rd*a@Czi(cjrl`8F>V}>
zwkD+iH#j;|70%5NE%|&7>3-sk*LcV2GwJYol%Q{Hyzk^kJKC=TW$e`V5{q^)L>I(t
zg7?qly`eWz6Px!(>O&HiID+@h7DH`l8-h4MOk!`r*rTwdSB}cS_+Tbm(qQX?cEqKR
zrG6PN<6umTjknX$d#Z`9_Z9E0SqSMZL3erRO}O<=oC!K_$0hJNf_Os^+iaCh$bJMl
zV=Nw1lMdJ!Ur&kch|e4}ALd0Kn6uaMXzhUg=KWXYE_>R0cRcLlT1WkFaGNS?f7U&o
z$aBGXml&c6uc0NjH}IK)JcMYu-Y54}NVbH1NAAG-C!geB>%!Wxj$X^AHJrJYUPsn~
zHcK(st6hCFwvl7>SXPe5V`5weo7<5K?x-Vp*A1~n{83rIWlXUP*p})V_41o)xAHC{
zRu@RvNy~bdU2oat2S;<Tj+_@;Ww`B>U5BK<-(vqN(WmGM`v1+#+g)3>@>-U9yJZIP
zRA~mLU<#&S3Z`I6jlPaXyGnA-wRfEFW<B&KA%yr7EMm{rqJo{Vu0ogoM999iM}Q91
zZ>f9)@fq_FOPoU28ne!<_Yz%eKLvX+680$cJ*tbvcPY{I-D>mgO5e3$B<R>@f}g>*
zliFsf&EIm=2D-kl!Ay>%Y5Ml}TejL&W{GLN%XZ^&RC)VQo)2JmyQR4d5rQ>ht)L0k
z8(90Ege3a{-lrxVj`k1ON9Y%!@=vU$xS|y(V+Zt#?N4$0pZ{|V*zD`JLou7!nUmxt
z^n|=6f5%0rY_@X!8=QqoQyDlXzlC!ZV(8q>au;&<RYK*ZdldLRqdW!oBW-<dd&Z+o
z9WiLb?>cvReS-|{X#KA8`^vq|?{VmEKm5H>EYWn&W8=<0-23wJ9Y3?};<s9MeDIz8
z#tY&AI<}pXGO;&*&*bltDbeBZcS{lc4U_Le7enQnH=oAeL&f166W_d&kc6f0V=#)W
zdXpWtzP%aB_F2*$t4iz!-<CMWRJ@Aq_*q9*pMI5VoppQ+Hgu%f(mfW-p+3!$&OD}I
z-Ikcz2llAvezKSB^GMj&x~KS$TzA^Dmj|0-gkrGwN6>~?Zc85_Kl)}ojMd|%%-D>_
zNPLftI6!RrFtsm_`)KUsY$%601DplkjXmFvpZAX5zwH7$ED>V!CMq=P73#LYw`V&f
zV5h#N#OGkow?A*E%2Anj8fSSYO=lap6P{R?9bce5ag5_3yPz-khmF|WIov1Tn5zGu
zp!V?=&pt<E1DAi2_J5LYJ2j7;aF0GQWMAB|x^r*1)2YL!CFsVsD%~HF{wrN&sJ3sq
z{Vkd65~D!bHuks)@+|~8NbZx5Q*;qxDOYdEVbi2<ohLK%H{$T`2J!jrkc@;gIFp{g
zA*<XiRp;!Qop;ClB02Y!r~9GHCz74_lgm}&2S*Txei=&_D?!Ir!M4N^P4i>EtU=E;
zV!ga(Z)-&x+5&Nam|YBwgK;r-?${}~Lw*0YyoZt4R)SAYf9_8hf;f?LojKo4AL@(#
z*|#IuU-IFQ7kO8ZLy<XkB%OOm%CJ&mn__=~di*Nbc2ds{`bd^!g|m2{PnW5yV6SEC
z#B=;6{Rzg!_@E2VcWBO$utqb_8t1Ko9k_RW4##y4r`Ef|9&q-a@`yYmcWS<{k5OQ6
zfjnx0{04OF_|j&HlQ<WrVjFDK;~Rpu;{qG?_|cB>kxQHfa-TUY!TgvvcM!P+tjA_;
z$RXBW@9eI(ddqh`a`BdzoqfWW`-_<LL0^@nG8{qQ<g@!{O^^8Wt^PiHt+>SJ-w^ag
z-}L2iY}rmz{U61;z*gxhKXKF^)(;HTo49n!{|3iHuH;CXr}1KQ{Vi9<7?N+;=cF%X
zd_%CF6>LELZ*iL%=S`pL@3%Dh!pZzYnn{i%T@oT$<PiCpkUOw-=fM1zbhWD-<^L1a
zhrVhV9oyfq<^K~kUe7)m+Y%!|hjU?n$Jh`3c@2@{2bSt@Xmi_K_P+gAx?Pn+@!KzX
znxE(XlYDCXX1m8z$B2HjzO0e!{$`Evb-TZn<6(TZwQHS!n*URMjX~U6zV+IkI{cUL
z{Hpxz`t<A0xZAn@H*zYLIns^quO~Tlul<N(4bcim^S+s~z47FG+gx^xu6RJ%dX*u2
zW$C^EY}PG@?3KpdqWh<F7wPS`^}B!chUjAJ?a{>4d!h^E$HrTPw_dh;YD;@qiOaT~
zVs}4B@qvDzC+LiWwzQk-Kh*z77)#}-{1f=wr_N()PKNp+KK-d*#<O{=@owS`rMFxc
zk+R7asyhjOBSFXBdFKhF>qB-J0-Js8M;VUlD)^4lX7GMv%`{f_k+Cy3=CcKReN%H`
zWzIOaX67976rBH@g^KNO(!Ou?)lPquk@WvWPdhRS%!7Hg2W)3OSeGu?=asN#Ay~gg
zo@*_G^;G_iJP+g|P-eZC)}6ih?7wnh>zzONw}2o&$P@DA<0Ics9;q#PMZb)NaWRJ_
zNttm`$9Rx{&34LDW!h}kiFaI+p2Q!u5k0?eG=1wZGrw=(JGuANek#sU-}H~{Dq}O7
zejcE{KY$(fMcw0CSM6^);{?~cY`L<Ya(lr2F)rwd%T?AoVi9vC=-8_NRxE7zu%=CG
z>peKy2fit>?yv>lo+?A-C64I%-D>mgO5d`8?^?z->Suwnu@BPimh_74x3o{_+ZynV
zZ9Z^hgQxF<L*EUbsJ?FhBxm;5B_S?sN6w2{XFcS@yqIefUc0U}1J<4OA0i6u6|iqN
zO*Zxx)(>>mS3>38{$WV|8{FQKn7_gP$dNS3&mE%N4M83cK~9s~;Cy$PI>7H6_Ir|!
z+ZEsUPw4*PZaekv<NixR(r{0M%S&}f(0+42Dprk$-;h7=2<~<6aqeUO?!i4CV(Yh-
z-`=A;y^H!=zjUX!0>AxJaQ6c`w$J^qzx&LDzX4UScd_(0ry=<J;}q?}wxhpUuKe32
zf4_`m>+hO3Q?@1!-}x@O%6voG`liIUrIwuhK87??I`qE)e_|4we&}zBlag|Xt$M)E
zdX@N8Kl?WMSC0C-srBf0y~|I2Q}Mt)Nc#=NVoX!8zN|ZYaRmFvUb3(3GdY6fZ;B!C
zVb6xz0D2eL-Ig}arIGp6$uD9mK5gii{(G(uV`6;wc$aMW;J=0YBA*x!W9^Cy#0UCc
z;*i72d-9*NFmxt>^Kk^{WeUH6kUMSE;~RpuK1-aZmY`FQ-x4Q5w?BO^K^tuN&<Ag>
zRiJEaKe9pB`JTMp3QcF9^S=`A19WUnR9|%3cj4IR*zu<w5Th5Sbc5acEsyG;>7J_C
zZvQTyCtQzws(-TKdkU1H{{s7-Y|ogjTY4Ttb+8lP!$@q@H9<QhU^Bbu)H(i?|4-PL
zb}$l`sV7Dk>?8ZhzP{xRb?ko#a<B>Vk$mlikZ#D?A;@2H`H3leC(m`(ecrdu9?S>2
zY{vC2AD!DFB0+~!SZUkk%=_$PyK!Ap9rxG`cZi`5Kes_{5$dyo?a7C+F&BPASr68Q
z^*M>x5gYVENC(={p0yz!eKD>sxIc$zf;*S{ko(k7hMC|;o5=P{l2}bKE6j!Y(I5SK
z{ETM`@_;;<d3TXZt=t*TLvk@hy;CSt52s*Tm#u>RJb>L$&pFtFv)IM@3-C7~9f<Xf
zq5784zsJ(0N8)+=JaQ(Vn6k5mK94?&oI}o@&m3#t1^WQ#GeNJpa&rIJM{<V!Wxu<K
z0%hz+;KSbIKe9bJKrA4a$%mbiGJYXwXK0U&x|JMBLpzv)++r?AIIoyLxy9YYny_Z9
zFMAYvmv_D8cY=<M{a_uB){Aq+dJva283k<A9l^S?#<X!?C;Ozl$!~#dIfll+iTSrg
zQ`<lPFeU#6w>ygQjivhWF9@~q`XKMJZP*=uNk0XT5n1g|`cgX>Nk~>~U$Vn_;jP~G
zp>_~O)_G3NwL)DjH<kYlNBLD*Dnq{rmEZ8cFNg96K6#Y?K0L~6m_?#Pzp(wO?)Ie|
zV(DyfK9H2({GRHj{NWUdeuK{wU3Q3sF;uYI2RX$lc%3X+JF}%f@zWmsrp>*#E<eS7
zif7v><E?s=y;A3FowcaE+3}&y(tb65)yK=2_QQHU&G#pp*Xl_=wSDUM&Gt6-cC9C6
zd~HYnPjM{dQ>-of8+G3JP_{(xUs$R$NBVF0cF)y25glLKhIH5|m&STCUgm$>?{-J+
z%w0DgVuoy$tsJkA??2Jx14s7`aQAc(V(U#Y#L?Tei=p56t>67Fj(+ozl(8?t8=%%N
z`G9?=eDT2_ZhyzazLM%kZ0fLu#xn(DYZ{|ryf?11q>Zty%8@a)Bv5XGHdBOP42*}l
zg=l&sE#6Ba#Mb+%CFt0Xn7pNOO=v&G%J#Gyyt@Q#mdeDX%}!{Gj?MOw@rc!POh>j)
zY>kt#v#0Dc`LGMlpK7!2x^d;+QW;Lt^K4E@aQP=`f46b@Zs&fG^!vn+9pVejYl<e0
z*27RX*jOv}z3zF>eP5Y><Y8s!y0a(j<J6nF@s8(x&%YOV^QSzLpE};%+Gp~DJ@kIj
z7k!7uvC23-uA_R7$G)FB&4aaJ9h>f_C3p)?aYXy0enjXSM&~<*X!`B}OFDM^Xh(bR
z%PDKi8bc&oeWGJq3HmqehddYG>TX}>3FF)a#{PtTs6&7AA>LbGZZ{NTiO_m=F$<Kb
z1N;CT`w?{ySa<dTycd&iQTjeL#Ns<uq3b(VWvUF-W`Eim+wA9dw{-n2@!O*5n;MLZ
z#kaOX<o_SqC2!_~?e?kV$XJeF`)=y<KY@8MSJsEM8X}UdeE{|YnqZ&UGw6koZuTFw
z6YR6G&C+&cOSW=jie7jsV}o5FMveKV*S_4IST|j^lX)AGpS&;U!spcIq;a0ae1Nt$
z_G{UWIF8w+bFU0>bpK7k{T79#`_T;P(8Si=2<X_BpdIaJf=(TNNB4LL?%pPr?%^)@
zjcxqK>Tc$@xC!p`E*5{6;qNoL+qvHX9b09~2Gkku{*}K4TYpoU{B22pb6leHx5s4b
zZ<3?Xq#Nwkk%#X?Nl$s(LiWYCAu;(*biucz^$Ui4Oh`A_s!n-{lidALcHJ!*-xfn-
zWy}?9Pc+$qc7{0L=&G-MuQFcjlq=Y1<Cr`9qTeOh1NMeJWIvB+{M|73nY~7*4j+8I
zPe}H13+nOh$`kU1+zI8@5{JCwZJ~VJl9chGFJcVFQRY?0>v1Eu@VI-9n;4P(4aFtb
z>4P`Q=S`FEQO*Wu<h;N+0_v9tG1P{44(I6!>hK{p{(#;D{yo7DdsqDt?(0cXZ=b30
zaL!?*w7yj49X0db;O+qK2cQlg{I}vjZF@?4{N0{A2G$GQOBL>=C+zbU$9DT!+FqsW
zdiLdV^|3xQ?skFgX36F_mbO{i-pd@PbT}8bSBXz8qjwRB$JEMrZL4FTO@;Q<1O81+
z?IC-*3f^OK0Vod<g4|omwJyj_7@`%(Tk<%>(s|-c8OjD*6P&x5a1N_ZnRCA$;M{_L
zcbe`F;10nSr44?RsarbtJwdN!?39ln7NBE;ei14g>XtZ3)g6aA?EL~eV`Gd*Y|WeX
z@mjq}d`y$h+AZ4W*y(5MejRxqbMH;jx&I23D^ukoXcswF#%NaBda0vN`ex4<2XkOd
zOLXM|c`}tZLpjuyOXL;#XPR__ZHvf!J(88B@<{NjgzPu2$L@AZI_F~x|C<=eTkIRv
z*E%t#ARckyWPEHD>=k^6h{R)^Wj$KzteIKTp$qP5?*HIiYOPP^MWkd8usuOt2==TA
z=MQ_${)QljD%hx7g4|~BLwjH8Dih044uS7@0K4m&bU2DX1(GuL#9^F_nX!{wQ!sCG
zY-OGW>q2g@{=BpG{_c9;^Ty{bzSw82IcrB7;*4AiVxxa-8IQY<+y!E@_TCqCY_6wF
zZ2F+z)+9yz`ETC--BRsu{<agdGF3KB`fu>ReOCS($g*E$?1!~0eeCSt<9U+fkJcio
z^|YNylZ0AEx4qVF*?(e|Sm-Tb{J>nGKM=Cru!m1nzq@{@jcMdSfqw(mvUTh*FS^Q=
zP}z`UZ{Ty+jlAEmTW`{VvobHR-PqslEtg_=T>Z<K?Ni6+7?v%^^d#|FiDT9Nruu&3
z$Zovm$Z=8Ye$wx@Z{?rjQ17ul$@wy;p6h(H9yeYiOX{s#VgtuPKJ~R_{~Laq@7p^4
z#{LwWu|3&s`<t=bcjlatx9;*T>q1|({G@w4w;WdvzLl5!-l+G{t@rD$n<@i#>s21v
z|AwV?cw)$ITG4Got{-^var>sWu$99w3r}VHRY{vJj_x{Gg&{q}*6(=}M{kNHI&Ta8
z&chIgcY$c--$qON#Fjot%Gm8Ud3%VX_XnVFG2}zME@*Rv<7~wV^$(2WZ&_*sPwhf>
zpbzSoVBRx9$7Ub=>UeA)vNyrlLojC~^PsLP#u3Eb8JjY8>hYU`7*Txjw;%RO&-Ru}
zWyZ_?v8U`Yd;J@>{G40l+A4(3AoRkNZmRuBw;$5=wz>RGhT7eDe2ldfn8zD$>(JE(
zj@Ar@V2@bKqcvq+pXjW&_KVylmnUy%z14@_?1#5|A*2JgDezgm>(!34K^*#u?0>zC
zBjiKAkSop?#zs5l$GWhVM-1I*(PR_tkLm^AGL|@e<Ir~xK*zRKf8^T*ZD+2#*BZ%M
z?_4j|j6ShdAM4}6j_oJho;_zS-(ZYKG>w-r-@Mtkd`)P+Pq=<$T*~;dK1&?ob!BZ?
zze;FLVdVO<#z(N`Q|zSayA<$^3YG|cy8^ypy)jjHW8ZjakMDVbx*PlYJDk7IZGD?F
z{)Sg&{l>TSjnAA*r)==4^^|)Ol0csxLzV4cd@E#bT|~l~d;O73us`fmOV~SLA5CXJ
zMI?3qpY)*|xoNVU_TNnDH?<!B8e^+`Q|p`R;gmjZeX6dD5G(V&aYl5uIAgtVu5(S<
z`0OIF)pj)wdM)EW1b55lPT^iD9Nlj&qjNt(7m<?kc>%wn``mXncjw_Zn!8u;kEMH<
zyLjskZ({0h_FdlcKIh(sBd{%jkD-kT>D=-7fBtU7-*)tOr7rkeV`cHTN5MBDz7+xA
zd{)ADoHs&smCd&@VH^4oN8g3`KGc(tg!&!qO&|I`_C`}3Jk`6-^7dJ32aIEimSbhS
z2HQ~`pc~geN&CD>V$okuLh=dfry$PV59_-Gdo@L9|9ZlHR-LkKyX^1D_SmQ=KSFsz
zzVJ6dAb++Xm&hq{4qKBi{hu7W*Ah9tP}iHbTXQ20W1xTfra$^Rf-}L{IAZ2Iz3c4k
z0%r*u=V^(N=ZbedaK2~{#Hvs?)35q=`I#dfAI>VVVTmK?m;UP*Y<JyO{S&;omf%j9
z$&m!gJqbztcy}3W)K75)Z$-mBQ`ss5_f&;DX}v(*8*X#tV{Chp_Nns8uPa^%##+aZ
zj;-2V#^2EXiTPm12Intu8)Q#b8EcbnhIHyeeqetjW$N&OCbss_u&3a%CAKb3<^ef1
zMHA#4IT?aH9^#X?<ZeP4n(B;gwj-wq!QbS8-y_cAOgiUMa2Iedw7e6zFF3zQ=sL%r
zyCVJYr=8o=mipR`HelOOoF_td*t#>oWqj8IM>gX=+z)ozj0<e|Y{6I=_Y|zh6RcGQ
zU*=4E_YsQ8cpG<J-pf@U*{G{vvz@k#ld%!gU<*M#^sJleJ2VEy!T2kl3;W&48|4xA
zO9=AGxkMd#wqz#<$yf4r6(~b{pw?Mm+16)c>P(m;9sJ&UllFU(Q|-H;Kh6*5#$%`N
zP~A81p{;2dhZw{%lq<H^Gs^i~c`iA3toKPMqhkxPGPj&N<Q@6bN)EBN-sh3If&_BF
zdruqopZ4ScvB-mypks>!KSMh>nMW(*5<61I*0K$8j$qtd_#7~wo^vIS$T8N4^*!2y
ztv7bpySwQ<zWpZW-Om2W5C5Zfw1p*DPweC=46!bb%IpjKMy#QJ`1e5Q-xNpiZ;gH7
zf2aH>(lKYowybt+Jz*@BrLq~)qrm#qGWD>;5spcGv!z$Q&CPypi|h&U>1T*Y9UJxd
z?H8zn{s8S^6*@5sA^i!~;*FuYN>ka80~Oofq<yE_-E{KwfsoBC<=qXr2)DhKsc*?v
z{!Y%r3)JCD8?&UFZ)35K+x@4~@!Y3nFY7d=SB}b+doRY9{k(mNbK7c}Sd@`f$5!!p
zs_oY8Q{~LLbx9M_D_)}~X+PScBP&zoCywlI+~Xc){{IvDR=mnjG26A)cbWFsEbsce
z%)D>ge_9^dzvWi>C!X%9dYApAuW}FG`gy3k<Ix7c)+BZQpCIR+?A6w<oU3(j`YQL$
zztx9gM1gw`nmGK9=NoM3cirsNn<T&ahO%uT`{3Q7w?pvW;!PqV<>!qeedyiN1n(Fm
zY=Iv>P4Ad31~GWY<y(Z<E1@rNnL5{Z*{3+d;~Qlz*r><v2K#y7j<Xdbv`)Z!nI+vE
z>2I*sX6E|ul-?Wm$$RBGe4!=iJE5K1Ea`AAY`Z0X&c}J(eY>1{pVOst`h@E(Z=cY)
zF?Zcvc8n^U`US=W_gK4Zrp}%Deq*RU1Z&BfHo@L?5u)agb#j7SA&0hd^pmg3Uvin;
z4zcuZ|GeGxhM!`KAzN1+J|ADT;k*!oSj3;1J4nW`WW!FMfDW5n&D=*WY|KIHu(VD`
zbglUoqp6=i|1c$+zGZB_Yv{YjO3<-U*X2VS+D<_%Vs6E5;ykP=HtOiV@>?5i_5-1Q
zzcF%bjPE2>$HqDs<^x+a%@LUED#V|E)_`@Gg(DqUBN)k+tc2F`hV_M&97*6i)Z|;#
zFYvc4<PfVs`6uju<O^Nj)vP1eg?;dwVi%ge*O?)`vL4FVO#CmckGRXXy~c6hjN_)u
zR-wL@(eHT<%{2sT53S(6@m?W&A*6%%oIGg4`B8JG>aMSn`ksU&toDw5ki9Uaf5W~Z
zzskzKh9qz<I3GQ!XNq$LLqzg)W^J<%{$@!x*g|mjp%u7KpbPFb?q%-8$UBky4k&X^
zQg;M?qxf@IPTiGDcO>^L?}{!y_bzV@!Mo$=E}o(nmhST*n%Lag0^QuU>f7bZZ$Jp{
z|D(ShEzvJR<*mOz4*mwIZ!}#5-;4CkW+aX8Kzt_?e9w7e$_~8{(qZX45Dd}yCZz92
zm3ft^!}dm39i0FAKUuQf*pD{E+y%yCmUK9x&g0gn=JbU9Xzy5-L$*q&eB=71x+5H~
zO8R9#*rO?qX#7n%_m48vx@zmHt5C=OlN;m-`9j{z%(bO_i_A^rA*bZa7#J^W$(lk-
zPT7}LbldR_wPl{3&r-b4929$~4|3c6&g}n4@;;wBKaIC}!kN0kr{_6~luK=46l%H2
zzUf1t<3~O1i3L*}G1PbHOn2Ts2|6}&m$BQ1gd-a7xFon!et<g#mN*G_&<%Hz+0udg
z$#)d@)Jj74T*Y=vd@I<iKe~N?l25*l-4xejW$f1L*ztM8ac;TP#@yrnsqA*dL`Oms
zjEix0aqk6od;tFnwx_m^fm~vUcz}H2cZJ+p${~JRI1l7!6uNYSoqQ&*oA9~n%6D^g
z-fy@A%-}u{oKNlu?gQ?N;LPT~Gmw<KIHJk#bDpy;?P-gBr60a=;dn#wnmD=}D%gPf
zoj8Weme}cIiF1K11inMG0%hzy+jt(V$9bWyC4RJ_4`OxAVd=gdd1rIy0p%sAhnb*<
zpbpTnO~E)lKE{ZSo%-rS9rLSmbUVhyevl9354psh#QpZk5slsL*e`PCD33mQr@SQZ
z$#X!5J9o)dAdkuCCGf$Qc4kWl&Ib6rtfJd?OMIZ7Wy(zupZ@4OE>@1C_UmyVY1<QG
z0BvB1ei14I^Bsb<WKBcVGs>A<c@D{!k$G~oAM8mlP_`|kd#{`J^<*xDWX+MOGWGb<
z_Oo}|Kj$xdUco*Ee&_0MWIyB-{Q&wD)OGpOhW5lEF7sL9Bu#T9cQ$k7?qUAQvCkT@
zX4<E&-;kj<_~%W|yIgd!@?AbvkI#`WdpmM(SMCApj^4Ci>>Z%@v{NPq@sAk#HwORS
zh$bI#MEmm(QxaUZ#OF7xjM<CCW^51HfN@k9TT8qStOa8S^eK+OkG78G*p^H2&5>U5
zysD%g|1Lrhd*oQ?3mqGE_$+Y}^h#IRMA5NPHpByBn<gEY<4>>_m98?xzkqxLa<S4f
z51(wVLvH05c?MmOuYg{`wk~cz`waO#v1G>w9DAytUAW8CVSA&$)X~n+79Cl^R;lY!
z^>MAO%S(2+_s#q1J-y4fKjrFU-F_~=N&Edqdd!{!vK8ujpwF^KRlofx*Es0JzFD$;
z!*h6>Yqd|U+c&B&I=+_ZKY{Pxax}l+@+~$o?)rI+d0%DfvHcd`S(c;RXa6^J_k$$<
zN{({pW@hf)^7f<Lv{pAye%R)Jh~qj=SG*A1cl>5|G4vbGn`%D1sd%e?-mAP>1@BYf
zjRhgL-W))ACbl=;BYKzg1pT~#?+{DSo>=thG3?Zly!m>*|5}cnIq*&~%*)v3dC~@s
zV*D2Tr`UpcOB}%(PQiKty6Mslwk=ruCD;e{<7O5cKKL5S_~Uba03Z92Z$s=t=<Gd#
z&y)Sh))k|&RECqd{9D<tc%d?Q+{~fUR0eF;t7MJ54qZBg@On0_EwC?!eS$97WA>Uo
zXYZj2a)$gPH_21-mfYrD9)kBe?{>r69~*VN+wmpGo7ykMA?_%B(Fg3bGmev>hj86z
zteVr-8nAv#9KpS{xx1RmV*Zg$-!hiq8^<j4{O-Z`jx9fYX){EK$=#=zA-vW|pkHHK
zm9C>L^u*;`;$Lm{f09eF&I`;R82c8?gZaP`NAy4c%#}F<>jSKVS<=mIV;!GhJ#S`N
z?;{=fHZ{JmRR?^}g8smg?Z$r9e&h#D-^_0Ax+x#Cr9=F`|0hGX3g7i^j%+_s+l-7E
zlJ47Mxuxr?q@CO1-xB7yL<rWrCEg3<`~_V;5Q4lQCz@~$y~*k`Gw+aHoc0f^$S2)?
zwD}G8w_J)3BMC{)25?T=h0hk}te11^GtD`-UeB$4pJXV`jbk*$<G$v8=3e8T<9_5f
zpSzN~miNKt4WWB<BrEULF1w-rhI^O0n!6W>MVWZCBOdoO?7XkBnUId%bxUR15f{);
z`s2g>--Z9q!{2rI`wm3H-<F!#`TgkVdkx=gU?d^=#MU<};9Jk<dk^2R625a8z6W&?
z$<}wGH^xgHZD~V&6X(DFVM^Y(&JusxnJpbW9>%r=WA|Kk>Q$nfne|Qbs4X!<5ZC>@
z$-8gbE^!3$91}Uk7VO0leB+yZ+k1h%^nT)lZ%@#%f&Gv}kP|Kc<~Nl)<W_TDNe|@_
zzKn<Q)_FF~8BXrWlcau#Eojf&m=j~8|3hA?5AwG5O<qTy6VA)ck*(`2!A!8(Z(KU%
zH)wN2jpdkIu|Mx6-2=S6ra)F~3)!E*7oQ{izT%Flbd_NxF2`l3{=Cq1cNy+6*xYBj
z*M{JJgYyOZR5|1i)rNk);CC+)KTEfveZ}@$+GoiBjVN{YN1mjPrRuIn;t!(`(krYb
zu&ym(FDPTjm-g!dn+fUo0_`eIW%f4&c|y)OZ^#|!V&rcUIZN)s5FvJ+UCuDS37o0U
zIWBP4Zfd=Ce1>QRep{yCURZpK5a?YTfiG=#fwF1R@q;P4hzE!}k|tTfz69-PKgB6f
zhAu+b7uykx!BFmkm|J(zOwe2QLp^@X!E4iVT`iZ&23rXFm}*D=#5=n0xPw3UdH%Nc
zyx(Wuhl@M0K-pmLWqib(0$Z(P+{`D`x1nr*>KWJ37!SFVcbjvIT-q8tZHT{UtMZb4
z$+zBN<SX>d+mU%2nWw}yw55+D$Z^_{^F9Mxy5XD{Y~!M-4A{58w`Uv5)G;Q;N}u%2
zI2hN?{*UV2o;DTiH%&I$OhIgjLbWaROW#v{9rX*0Aq2lItTAVlTp_Q>mBXG0_NFHx
z$@&BP0Zp)%-cR<Zf*pTi96@~8g1n^9RiKO=pDBO(q@O!JW$e`BcSKVgpe-?`U|!>e
z&73uN)`0aOUk+=jy_@>27<!8z-s5_&^Y4Ns`1gXLj2)kyZ+7<0dqo}`@u_=>(-m)u
zBibLe{RQ~h*SaNf%#_{>l)qu$ke^|WBj>rb4y;858*6|MzHaAOmb3JIq`y)9y8J4k
zGT1hypM?2aN6zBcQ;#CiZy3Mvd?=$o(PTHQgQ@F--V^fVX36%%ko|86`2)H3#FV`W
z@)4Hk1<KTeeQ$r-J>fRAyV<hc;DfD7^f&MY&+&g+j$G>{X^wQ`{j1V-PZGZ;`)#Z7
z&}VYnDc^1H@+xB=IUi&QuitMaZ7RgMS+bc^blZ^FO`V_T`8RTF4SvH<F}vdY29Ntm
z*7i^R(WWV1`7Pl$cj&jJOY)n{Ia{iCyZytwe82psa=hGOPxd8W_*QpRZ+yR6GWXvw
z<!83^Z+!D}-QUWlKG}~h_}%7B#UAkv;9bVvRd^%tZ}7w0Qy_Ue@Qz}SsW;d@?+W>Z
z;H`l)yh)DUCtWPPSAaJQHtOu()n+A4eGzkCeIE4%<e101rSs;iFfUjI+nQ{&ar-X)
z4f<M1NHV5V#)*z?P^UPdHDzsi7qQNUa!b%7_kuk+g8eadZ>htVHqg@_pPhuxm>JT+
z<tnkSf5B0kzrl9~=N=vT8}Plk`}O#T#$-bJ8(yO-SvzP6YrGQH7ecV!O?>V)?d#`G
z%Y1sut*!khU&xcDoFJdc@2NZ|-+8MyvGsm8*r><%(@yax=TiOd#ABfUD3IG8$EQwX
zW=>1%!Fsp6*OnyjKklq4ct38@^&R8zJtMz^Y)O~``w}6Bd}%Y)HU#mAO&|AuxqLEb
z7z?=UdfL8WpWjHw*op^?3&zFDGLkuT!F*1_{Fvt!%o+L%OLlXl->{yBwS@gZ@U2f!
zXML!=3P*aS>w6YVu?v)+s6MyOx3cjImVCh9+K~NXs(f=~tF-^6bxDRKxLo~eoURyA
z@K|nHeP~m0-OwDGU>#U1)|Is$A};EFz3m_NmN*BT7hQP~f_yTRjcv%0G|AKccb;t3
zhx$sbtNK*jn=Tt1oeAJ<zz|XJ+2X9V#OK+PGyVkiZevLtaJfqSi4(NbUB+F^{l}fi
z9f#a0x&NB(+|L_<-(lUOye+s>0Ufw|tBzmGHwyPI@CL!geGQb6O?>X>61yoT_xCIe
z*?PvU?T>8O>7O=TeEybG{?60%_Z|L@=)X61>5=ev%aJt63V+XpDfoM4q_j@iEWZB;
zz5{K251NASLU8_{@7T}2Oa3q}LghEA@5=T^l9*F`zE5dvbq>s<;<;4GykH1o?2JcT
zppS2OESC5(9^w%f&|RkQDcA@0g?(bbR&pdw-Pe$PXB*m~_w>cDvdIVXgM3l$kWb|3
zajwcn?tS8GER2mYGj`8oNH-z9f_;f2XxG%9d9@r<sBhwv)8s8!XFNN{v~pZNL&%xq
z<oz=ebjD7d>s{`$L0n*)qQ=>Z1H6-<i<58<+_(-|>umqr9ct${)X{yy9dpB-Q~6f!
zI{bH1b?&kumf(%a{br_gIEi)JU8erl?L(ch?Ut_p8_8W<{qLAv{r-g8oE#%DM}czf
z$NtEkge0(j6|bo!b@<KXNP^2<x(Vq}<5?$O6YL@RL9T?@%A1)vM?Q5il$+!$c}xC=
z;EZs7TY>WfQ*?23zMi1YxPIkX9Fmc6PXK4OLOp(~K)DhsLygfC$8ZnbEZLw7?y6Cs
zjNLv*I<cnM!u`2V?9c?hhBDN;Ui#ziqpu|!J|pLdbRV`Y+0b{!bRWcH>{ItJcQW_-
z%DX<wo&T|y``Y(Al5s$_S$7?M>?G7DV`grQ$75v<*pS#6Gx<U8kW0=f^2m1bjT|Hw
zm+}vvojLQ7DwCI=`pjMYgM3xpQ6HbNXl#=;kYo(lL-qLKztq-u80Uer;WJ}d&q>!=
zfi1A()5T2CsbgHsVddFypPaGw&=37qhz%|I#8lk*0`;!z(vSLKZXp;;6Ra0!n6a>i
zpS55wv@V~u(cYbe@(p#YX&3DIXH6xY6Ue4Ab@<Uf6o0T6g8uq-?y-lMWeo0ve$Y?G
z!Ux}*A=?s1IQ~>W%#oa84}f`3v9t!P$7hXLU){~T$$6jiZ-XQF_eA{B*agyT*_&AM
z*?Q-X1l|9x=&A#Jj=&$L*ut^KpMT<8+Wv1Pv7eZ-n_BOFs?B~)Z5TiEfGF6uWHU!P
z&<-5uO+NW-wfl*0W2P_SLLE!Bd7P_^y-R;1RCmK(*S&WRG}$ZU)6JCaH+1<`g4}#z
zDSs;?-x}og=03W>4)|4U|Ba;G`X!9}C*QZZ{U`Q*t)a_P_R3NDjk=%S=PLJ0E>s`%
zCT`nP8NVkyzB=w+<`>e<PisxReUZH|rQaOc;2xK4uD8T*BwMm#`%kjAxpms!HkYZp
zX|nxK!(3TMe(yuSA^iRx$srqcjA0kJLnvEXzwef}axZrjJ}ximZ{Xv)Bfa7~(Q>x`
zzO#4HtNqrQYZP2Y-YnT}@Ts<=a)mm|$iHF8pF6LKo_o{sP1Jc8<$GxIRusGkc&qJv
zA2i7dcIuCyO@;Q@m%zs{W{Gw5_UODn1aA@~<s;~aHh_+udO*h(8K1uBdndeMMuJ|;
zOJ(K?^OD#?;4`uvafxpz+s3@6#&I;Bm7p^&{E2gjskLUkk*qiU6934Lc?`{+HyUzN
zrhoa-W{H!af6kNI6W2b}PwlB;k3)M6>^UrPQd;jikF&6)gKb@U1^Z6gb$4L5%|1`k
zK2P%Y#|PUKjGcKgM<jFTIhMPf+t9AkRW`%};*1wUcK6xTC+o}}Ko{%<djKs#-y%vq
zbzS?_w6Ej^`9YqL^Pjgl?{vN4N51uuUAB-9`9+@5ZVPf_5l8XJBl5sd4q=~9nQ>_B
zO>+;e=Mvn1Q*6=NKP<`qN3q1<n}xn{46zb)Y+H5I;}?P$#3c4E`#~AT1wJ!jOxCfx
z&3_{A{+9YTM>=@^tN}0wXieiymL&6oE@pBhpJ-Z>3Tw0z*3ES3W=TI6*bH?|->Bvb
zTXqxrwl%&`>zDlCJka&6%uMNUm$B`n>ATw#L-utM|4ZxeLci>8OPor}{@g#3@l>$c
zkGAMY>y+_<E?5WFBLwT|^={I^d*ppV+V<qrRS!{cE|3@P1@ekK>xGd1jny>vzhKDM
zH0f{nOmIFbU1i`Lajr%Zl7_Qfsb{>NbGKa?%MyDCd}-@@n!DOyYpSbIH+0u=_a5Dm
zQ}-pmu}JR3uDcP?8~17cc6Z&gpZl0{`qKs<%3XxO|7OV6G7d3diV&aQbN==sX0o&F
z`+n<hIFrBS@V6n+lg;1e_`8uf`a2}dLYE$5@h#{A+ih>MnXSKb!W3PESo$XPjluUZ
zz8hU^eNU=Pm7ymt@5_%k#9QJB#=&^DV4Nf8uq2tMp$ydDG}&km#4=qvebCnsalzQI
zQ3tDVq|@H9kdBAkf^o1PN3dt?9s9_hHvUGJP+r&mdXL#>gRQbvrX9ILE|FKg<QTaX
zycy*483W^CTpBxbV-MQJ`LF-oh7Z1xb7$UDF_vNxlm0*N6ZO5sXAJ6>Jf?4;o-$)3
z&+$2e^RPJ&Iwzc?DNf2Rxn%b_!ViD9q0IRLe3qb%V{k@Cf^M*F5uAImQc^b6j<4I`
z+jLLxe%c~<&pkk$x$A9j@;QnJ=(DsLin+uQyeDB6wshW|+-a*o8M~njON8z~=s#e;
zzm@dy24i@l$!_lYmGR!j;d<JkBcTb_=ZU(8{g><Mm^E&VgH9}9&)7Tml07w)Z6k-e
z2;tmv&Xc?3FhoLbljGns(3ShZ8G@Az$w)Y7PfXcw@WWQ6b?nf@(HS<JXVaxe!d+Cs
zPI-u<yJ8CNBS42ETKeE;wshJPzk&^@$G0Wu*r>CA^>cl#!$$ue1O7*NzW5RoKgPOr
z=WgA5ox4wWU<mGdsJhEX^;5o$yIO=|5QqMdU0?@v?DSQkf5ydFR!VG5;6DXAK8%|j
zID(uZkB(Tn$H==Qrl3q6dBpynY`fI1(*_^qGHm59{^TEi^x3mt`dk7T*mG_0VGNOR
zw$4ZBY#PqZQS1<$6Z!-6Pk*xGgZ~gKWs_~lhqxo>L=1fKy9wD~s~#WIq(8x!U?p7=
zLNG4+Zepr`#?Tmp){Aq>`ZU2Bh8Vf7Q)|-`bT|om2=;Sad&(MDSX2DE{E1B;Jwb;p
zJ9SME8(-qXQrjEs_#8nS+PXcqnYezd-u*81cLZ||&Ho7YgneYqw$}J)?RkrLz1xo%
z`ZvNB(KHs({-_TT`nQkSX`}AQ2bSm;k!9+Ra4h1zfsdih6Rt;6@AB=tRM(S`1ecfe
z^8j}Hgml&dSQlssYXy{Dx1}4}f@3|&rTTBs=B?g!Ria1Yad>R4jQvUXe5#z9U!|-3
zM9BUdmhx=;K>c@N)wkY7Z%oyhp6@5}dWj(-A>VJP!{^3rEU90~k!<Rxg014ZnPc0M
z->@ID`i0iZ*zWS19N7l>8<zYkN9CJ)-{+MZ-^zE}Z{^xAV;UEsvhjMbW<c2z9qem4
zO1vfg=Ew%$#(3AwJQv6(ZvVG3{W2cLO|FG-zM^AmIVb#pHvfNfkN;`Twr#D+&C~sJ
z+eW!pZ+)rG_`Z9S+=(|+wkMA4aM#)1wf2>%@*7)qe?!ZCe`<60(G~k-K74+|^Zmoy
zhj&lUw-4_hbZoqdsQ<=RJ?|*q21}d*W$YpFBhJa#^bvwLDDMksV(Z;Cd8_iy6_fXA
zzDcU&ed2e@mOkXW1nqzr#3Jsxz-BvRU@TLdl$2@HL{|*r(#OiT81JSKe%o!{aH8og
zhMoHQrV6#={e`^?{Eq%@(1icp!M`b%7y|ucS4{e#4Q+|TdN8KY7+Fu&mvshomydL4
z*ZY`y+O^z|r84&fxj~NHd9!6B&niRZB|_)4f(@uQP5KQn@3{82TvrUYv8*xO=9cz(
zYC|3NDY{_(H!IJ}kc3D$KQm!{Swq$}3Y4+KDTH)#jr{xUBl)U*b&ilHH`I~u<RR^7
z@BKp_m9bSqWpen_kMu1+#(Xpf=FYxNaRhhe7QLyB;BCAGZ}%lm;%^;DY(s>Y@}(Uy
zHZc{y(q#kNR_<-&9v}fboWhf>*8fI#|5IatebF>-)&Q0W%>}xc;t1AcB&<z^HMr@r
z!Fu7y4oz!03tPGgeUE}sSklc&y-M`1Z(A^5*nImEjc;d#C!6bs{GM2{L+CqOrK=3<
zfg@W5AD7W#ik^hz4RyA849HQi-F`^g8Qa~isV!^Jh1YawJwtd;>RwrQou%z9&k6hN
zJm}IP9&k=khdxC61*d7eVqSEWO-KjwyXJVcxvt8Q=K|RZ_Zgzh*{XDv4d>Knc@*6?
z>H&Z2L**z?UdfSsg8CssaJO^cb-|s@Jv{i`)4lk4GjP}H_qFMF)_<=<^4rYs`P6Uj
z)ZN>4@3wqT>>{W13hxf$a-VmxuDhIj9QzbUaHkJ}#1?|PfAf3KTO!BSHJ&K&Hh{t3
zAcfx!UGD~11?m7>7m@hyn}cshNs|P=2YtQ?@m(mn%UyPe!qPXTae)o+!+(k++!uZC
zgt0NknH))Aj&In<ZEo4s{w8FDrGDujnqXWNY_4C@E4CwvH3eg2pO%>Uc4HqaOJ#D4
zJsml(ElHar$VEWE!9E3fK}_<bDPKBoLu_h8tfR4X!PuH$&Aaekut)6$>fi|4(S8ww
zc*Is8Bm3?phskGhm$9rIA7i9EbDZS&$4~hlIxD<qI5WWc0+*?)R3H3&?zZ&cEhSch
z4pE@I#7T+nGVi9HpySgMe6VqEEZ$n8>mD(bpTHM}2;sQIgO>eKe+2QS*a`1SbmS1+
zVN-CQ-C#FOcb*y2e}nyz_}4PJ`*R;i+n!{tM~D6e`<yH8+c>J9+x8Maq{Gs>0qa+>
z9Ur%w(!u4B4)(3>o8kfc!=81)9>NkMiK15<_O1OVC&&XhnHM2B%2}8?2VDf`LFWei
zo3VACrs$k2oxLSEgB5I*qq4z{ZdvWvMiP>+b&i4aY>94~bl}``2ZY!U_u0rhtfwFT
z#xZU=v!5ED*u-+Yr8u>oG7#JC(P=kzkA>)><#_CiPZz|+Z|UCS?rRrYcOv&9RK2Tw
zbY~)A3fdEkm~f<12KP_DjQ@tQZ{dBQ-s2-ys2y$bAs2X0kR#*<dq}%ao{&e%FCee*
zfg_z9B#+5=p8=%L!F?9U`>i(Izn?hjgK;sAnd2aDyZXX!Dd&k#yH7uP2Iv>?IoNUx
z^f$#x>OEu|^*3F%N~jFXYb2cAn~)9YpD{MUc!04(7a=BN)x4M+gy77wj?8)Gx^Aui
zXWh&BWRF-U_K$trnGZ<HKpiY`651GIEUotuz4U=@sKaLn{AYnOMAqYj?@5VnusNnB
zHkj%!$RFmb`A^nCYr{IRhKu!N{dtS?F4x;W^lykGc2oI}eD!ag$-j3Bl(8SxFM(f(
ztu_^G)Gcuel(FB0Y_JulO6%BNSAA{&Ca2oMZ+!4;7p%z=T?FfsYegBBIEA}?EfXJX
zbGb_DYS}t=sD075>Czz{V9al@_ohiVw*5xB4e}_TfV_gL+x8^8d`(C<OYfYUk#8Y#
zxQoHPp}Z!)xv!8XbA8KBJvn~_{(uhH0o`@Td9hXg2KON2y2o0}p3|G`Weuiuz-Ed5
z4gBDwbh%2`Ax+)CCw-J0`KE9ARjO|*xm9(K!E%<dcj+di->|l~?JoBc?-c#EQwNN#
zj@!D&T>Wgr2i<iu`{~3iIe~5%`zVBTaE_6GP1O9vMw=t(gFfloP&QljfS+~OS-QT<
zhnVXD?9|VU<F=#pyQKfb)4ha^JIhSz=12$Mdv9{Ie|#+MNBM8q@`w1N@ra>$-|QC~
z_FCt%<tXiJLsq->Ci~GoL(lzhx|{gj?g=`!kvK;vbKg;4=_+#{u4G6;2<}VXO-&rV
z6JUwp&A{6s-%cS3yeXUD&2hg)wroH>ey|d^ujQ_IQ#9VH$(E#V=*g0VlM;If+MFC$
zQ$M_WJg%X45O1j_c(d^y_uIZn=UwM_oa=e>hw#5EcK#cIe>3p6mhms39skxKCVet4
z)`hV%C)S=lU@w+nueM-+k(9B+DfR625#-2xV9N&N6Odm^gw8Q=rf*z_Uxl{x5%ihk
zm>O3dLsvcE*W^zdBxS~l@5=FR*{EN_eOlgQs%89XM@(Wd29KvnkL=@QKV5zm?6eyq
z#8w+14m3f$B|@+-FbYjNc}NbjhvYB&N$&CXu8@n^$<2@-xw^<%wIx3N(5L&i+_C}V
zWc<wgXur5~w}^6Qu5wS#raJB}u>@~*-t3k7e#f_|O;-%!5+7PZpJqyjDD<?s?x_3|
z_WeoLIE=?*+tSUqb=bKU%yAT!bT|p?QK@T%zF*)Q5{$x<ZumCU#Vj1@mBzQe!jN9s
zDp!K<c}bVNq0Y8dbZnF>N9Cq(Zu5mL`x9^ewl}pSc7=Xxx$4wGe}TI51?oevPOM!M
zta%q9*bnx|`*KVB*ssagc<-GP{mK>R&@IU?Go(L3J@!a;)3`61%I4%b=e$?C$`$Hd
z4(Y~chI7;&@OiuIZ2z0{N*nuk={M9>Tc`}&bM=nrj^>W!uI;)zxl6n5Sboz(zv=vr
zcl};(F{Dpy`S%m<;Vu8AyZ6&p?RQ~H$Iji2AO4ZCPyTHONxYG4Nx(*37mMF?fixjI
zP;P>E#nJCSe`~zqT|k|oJ}!8N_$~5zOXNEwBw_1&&=a-p^Ua9wMi+cfS_wMXhc;$E
z^x^(3m&S5L%XgE<{Um4lAX~v@%exM{p^pB5zF`y{`;FsmwPmfzANGj-I)c3>4_1QS
zsbh~6kM(FtSD85MulL@2PEH!)kHmhIsV6Qmi2aF|vFpBc?TLw^V_Od}K4MMcDn5P9
zoE!6M%6HDvVQzw)X5QpAlJaNXs;mB?v*Po_S^B(TdB-NfyC$&>pO&Cwx6du9voG<{
zk+Xn}c1Q3w>-mmC`mM$r&0q`ekPB?4)?r&}GX#Bf!MKJ%PL-*n%@HHtYV|$I+imIY
zYI?g(u?v)|Ep+F>_yOOGNb9vtWSm>pzO8!<me{RZHrarA^aTARu18{Xd8)iGu-)Ke
zTa#{xML*CVz<vsDcT0Tmg)TyT-qgISMHB4b8&h>5$OS{$U~6J4AIJ$fnI}P>WX?A7
zSe!gNpYy|Sk_f?X&k&qR;7nF*|EbP?ZaWp{i7q=tVddH9j^M5f!9B&j0WCpaf_nU5
z7TslR`vO}C+7ssn`w>X$xEp8Qp_IGYQs2<?-lU$oC6L&;(?54I_i{oxWCwIZ8UK|M
zdlTHnFtZ)?#CE^5iR4Ib)iDO<=sT1(WsRp`Z-&@{JvZdQ5+@}-w5Ok?{{1@>(&?|s
zKB=S6oCi8K)`z~hrw(~dzL#@2^NevGI18MCPkzgvanbM59CpTGY~(QUx^kO5AIf)d
z-rLscPkdr3Hhs`PXOe#Jad<4$e}fpr>IKTTjrvG-o^Qs(xI(Nvr;EAfdE`toKR{=`
ztUqhm#VPytSy%Q&YvWvt%sI-e+h_e%&-xkG6h`7Q^|mk7MfOQQ^b3tW5sb+?c6|CT
z!52>Ac*KM)$iL0}wZH5u>&4o!j;u3##qZ1!n>V`t?ZCe;_;(5ac3I*G{*B~+FCi&6
zK^;E*0-HI~jcq;sL$b2f?-SMMw|b2;6!(o*>d>D!S`#y+KjC^y`?&lh>Fde<W}De}
zmxK`P+0Bp*T7mrq+pOFEH!>6#+-557Z)xd^1ahykRKDr5nIKp5Zkc&6a5uFCo%^Db
z-{J`0L+F6Lr$onQpTU{<0)F_L+HR}PFiwxT%2nofq<bCSBtGA8yP4~{CI1cH(<eE!
z*JfQh<tOZ4Wysffj2`zb+e?0UEmp3h%T>Cq<sJJj?`zFG#wTfCVzi5IW5Bo8SAA(N
zU4*FlL)lOdM-YqtpT<{hTRwnq6SQ3-h@o8V%444$<PzA(ZN`Bw?JC3oY*TFEK1b%p
zx^m*E48FH4XWnO)Tje*nD_vK0Z1v6_@^iWBwjr^@D*SK1E6nK^us+8AE>}6^chfE#
zW!AhWzF&~GeUtdD!jKLjruLQJeSZIW<4wH>f;V5jnY!KxycL3XVZKRtS9B3#>m6f8
z>eyFuB!M!rmG{RXrs4x{5!2K+{WA{6V|d5m%Xo%B_H2(%?4~g^y~{rD<MO8WyME~1
z%sZR6v)R%|zUyd<{m3r_|1RK7&Rcxz?<*t!PQx4h=x;FK_qruMW=jX!_X07A&3Nc<
z(XZZztl?+Pm>+wf`SXtL+MgTtj5^+L__2T3j%eCf&Mj=gUN3P(Qy%Rklv^;8B?+fM
zc?jCft1b3QsEkh&^hf`U`!f&C=d)khryw6R-w>XAmyLZ5_F40x9pfezace);vG3B~
z$6tNcHSqkqVlgIUB~-?Tu|muCll}#3%-UA4QD^Mqd6LVA{7iy*CA`0ZI{bR>U01v#
z7{eBf%VR@!aTqIW%R1*B%iZdGHFW3oygN_cf81wVaF6w5NuC1b5L<q<BZgxVADZA!
ze}b{xJo!D@YP+sDPuORd{uz(Qwxox~42=C|%63H4{6@ljp^KFqN&fv(;omejTedes
z-;&HI-=U6l;2Rap!j=wv$ExscYbAW|f}Tvtf5YAWD30Mf-bi-&7I^>Pp|#Hbw`^(;
zj$P#}V}G+(AM~Ew_EW}>?)s3<+OeLjE$iI{d$4|BsNRHh@AaJrF1IUZ$fJt$3)wGf
zoppRd?DpUJI#O?vKt7Y#JqgJQXX3`^rK!%;GiBZ9?M>Pb`Q+1I&hgQ`1>9dSl8^-M
zHkc1I*|-O}b9o<de{!d;yhl&|UUCQX`#~AMNYJ@!spr1tzMX>m-ghpNJD5H`ern^p
z{BvjPH;UhBezVMx4qf)0;6vF^Hu%zZ6hit>@J{jDWa-_&-vW6<@UGx}u^!$Tu5&#;
zH$yhSj^C57eVTlD^UNe9Z>YnMc=SKT5kq5T%oS`c!N=G}y?tCaiyt<8?RQJ+%w6a5
zmJe?|*3@q?_Raf++=90m@0KNr?XzEM)0vy*3LjnZ4*R41@}8m_+p45)3dX=#7&CJt
zUSxdMbZc!5>s-N(4=|RM(0&pl$2F8|jGwnMbE+^mV4l3krWm}}bjD`VCE<vn_si!E
zqjR!E%k#zAf#97aT%NMEUvM&BmkdE4t-Prs$1rmY_z`=kuajq+^9_{Wu#f$gd;x#!
zLptLpKI5V<#xn$C!$v*+#F>IS#rMj}x7^g-#T_<&U~|vuF6>`esxwc1)IHfl_Mf1C
z^EOuAp`E)pCFQ1eW~yvl=UBVMf79)YYzc8Hwm<p0&eH8>j+Z?dxkv01P=<AZtqJzE
z<^}sr`35@-5rVvF<VWTXIRnn2JFl0{+uy+XgxZGlQE{DpZ`srycAoj;dqDDYSLnVt
zx;IwRC4ur0P4)Oyuu)g*L-9t&{@gRtsShz8?nvL6NPLj^aldwfr0hD%A(rks!@bu8
zcVNH3R_*Bc5`$Ru*VXSTW9%8<aq&m5ZSZIQTQFzldW7%OrM0ei828u_<bt8xv9T|T
z(=?W?@o}$n$NRqLu0O(KXFT{J853inKkled{&QaH9kBB}VuzM+W;hE+IZXaKXUSu7
zn%pMGf!IfO`1q!sw!RZNNAyoz`k=4<0(Cb{wi{x>Ou8g6Zq6)yuN({G^msfbpXs13
z&m`+UbL~TtwFCA7`$;Gd**|-#y=9MP?)fNt&c3t%6>K+8^*w)wE$IukXzCjngLNcz
zfL~AO%kf9iZ9^V`KkbMUInT&F?YVxe8GFe(vmfMA%YT>i?~TU4Lz?1={YR?)Z8XG6
z&?`-4ga6G;8?w?>hLe5W()G8TYGdxYI|k*I49QBUe6w@zNSG;W8JoH7l<zwG{2S?5
zmQC@G_Q<ebrb~yo;NN)0buJIpnI^r0oig$b>ftDd{)Q=k=t)SLrJRJ3kfX569l`xT
z4o89xN08T3;16z#jvad9@>cl?*H_s~dvw>)&k)SR^Lmm~^>8kJyO!0@`p7-nk`?c_
zWzQTz+IGv@9{sL&xtCbqbo(P~?2%)>Ws@E5^|{O6*3dC5$4g(fZ`J>XdoFj`@hrc^
ztZl8o`MdtNlK#8$i=5<4Z2nD??_YjHfiiZV8}b<cC1?vFC<FQwN3^n@9&;UA*IuvW
zNOEt1?=fVxZIyq^eP@3wJLW8X+lHj=5Gx7I3wpse<ksBHkPa??llHZ2tYLDrwiVlv
zwompX3HG9}v~Ole-`elVU8ubc(X`jW`;LF_@;=qOVCsEv^iEh}h!9)vhYB`>eO@$`
z;poi-=vxr)5Knz9_0`oUeGlGeg0Xb57*m0Ah$bJ}(DoBUv4}l*2kSlD^)6m|ABWhy
zqZ7(U4EZ#CdC#dG&^{>Z4c=6bpW9EhZ{q0hFMq?5zo8v5fOuOh#;38;=cjLtVKEoY
zi+z~6E|$!jHCnkwtVI_yIjoKLa<HG;*DjVg>~Zcndk>*J0P^Ap=gyn__$dyt>1Rt4
z2Y>Q#lzgSUGZ*psj7xJO2M%*hx+HUFFPJ~|<OaDn<j=fAeKD7oV;(tX`kfcd0~jlQ
z5EqPRK0y2@SUXsvi+BLLVO^T&8aI2@Gf$aMT+}(zhS*Cmj$N2JHY9UmZMka>_l@q(
z;GPm)tmH_V)--3allUWlF$$Eo>YE@&7sMXi&4RvWg8mb4zSy7I+TXIv?+Mo<k6>(!
zaf{HHfw7w<-5lx6ZwlsWJa;4vv0gZ`L)X7)U|wvMpJ@8V1blM}eWL=tRn6o`R`{l6
z2H&?5zIpXz@%`&x;P$s9)=BuTH-E|7cR<HOzR^`@>~qREs!n|^qr2}a?bB7yy0Lz&
zEo<FHh^2k_2Kxj}ct7vGcKNNoXO37pcgQX4uA7-hF1vonH<H~nmco=yPLtmuI0L|W
zFirXsoSk}>y2>Gz?(Q4zc4!Z{4!M$QyLJ0idHb}hAMQKu`YyQtj_$~*`*rC)?fKi!
z?>9PkEWeY~5AI?4;?JGR{mJh^PZqI6%lPzxjxEHbt>O^R_c(oWZ}aXr^q2il{dVzp
zxShXg{I(t5B9bu07Q9ga->x>a<9829ISTmT+XQWi!~5p*X3)EVHwy5M=nsT!H}*TK
z<L`%nURfC{B!}K9yj`Z~A`0uj{wX7G@WcNI-a1{eh+A>|rh1?+e6jcRJ(6{tE9<DQ
zV6PmN4ee*LC2vA&Is|LW8hfAE3-;s)@@t4so>A7GoNPzi3UR0-*1W*>W~Uu-7$4(h
z{LCo?>%#gp!I~lg8|;+SP0<UK@g+_pF8yfy%x&k~m>2pK*pZ7lE6*G6Fr5M3Gfynp
z4`)PYWpiG1?l^nv0vmNVw4p6Ah&4ort$tw&#_&1sI(x_?u;V+kPx=d;S<d_u)B%3R
zwkL_t5X3*~X9@a)NQsTHdkpv!YYOh1ExPWKCAe3(Uv8?MJ7_1Nd(hl>B<1yh{c4?U
z@k2cOSyq4R9vkCi++9RU&x1PCq=U;_y1{1sP2%&!?QfqZ|2G&PbiuxyD<8Vb*w{B1
zDY4BjP+!5fixAGCro7mhC*;d1c|?wr-{ds84Lu3TH~0;Lw|d*{_ayCOiBA(Vf7^WL
z-S@-M{jm~s?hM}>+#TrHpZusd)Q4!g7rB?X15KA61<KUfK6ICHpY6QUeAk}z!Hy62
z=oDRW2LgI!stiZaj(&)@1>-|DLEo*!yxZaPnX~Rr-Uo*DL}zVB?pe>hK9X+?<pp;Q
zd~!rFmd3-pmhN=!^{x9I(6M#RfqKTuS}>;19JKE2Z&$2OUUCL>7RJLl?7Az=R()`G
zl*8mL`O0`cx^kJkUTMGQ!I<&?)RXs$!P(*ra!#N6rawcyY0@i<y)soMZV;QfsW0wj
z`tAbRRK~`bL-j+f1f9AgzYvU@@iV6o?AzA*1N&$`d&_U7h?GmxU<a2iZ9_(Z`Xjpf
zAvWv_+mZc(w#0a2s1Bk)d5KdX?iS2*iK#VUO+M?RwK}Yq?l|sA*8GUAJzC10#=j@@
zZ;vCk{%tav%76Z$OHOe_)4zLQyx@9Ew?V>upvwkNb#FGexn(GhS(-y-sN4$7^Np#x
zH=f%3<V!v6p8UG(751RARE8lU+1jt)GUW>`Ioj_E`|onqZF`dV-E`T$5vm7r?q=j&
zF_n`*ZnkoNP{!ULz)n5>#BnUQx9v^hNBbun!xEn<dV-FP`XRRPJnyww4{P>sZBwyM
z;(bMqWJ?<7%r|M@-^g!q?z$Rpl<`%)$!<I+OYGJy?K?7_%eQp>mfsupv9zD((RJQn
zU0@60b}i>XnHbaoer8=d<!Zz4E@O*?xbDYtJlLl4BE%;jGf$81{FR`SzdQ4m+y%-o
z6KqR##WKVN%16-uewi<0H_QQji6dIM3-`m_XxleAON^E}66k}zpckF;5%%*sR=G8=
ze}iLuYdaPDrn8n>=OIF{{!Oq?751-|yUHON|9;_3#5+mvprhaXAvW(+y#u=VybJU;
z;Jq*lem}HQ*Hs^4>HRrGOG%kJ+7OS}pFZeI{n9_<n1#=qLuDi|)={90y^9dUXkscJ
zbNIYt=#MwF-o=}Dz6j|{O#UsB<72FV4d0_T_2AzLys<?HzrB&;g~r>wfS=3gunNRJ
z#8-cet*d|5YHHl9D~y!rtRJ|}(stKv`LcJ7x2)EJHDP_G)`>M_@5zUuT-gb_b7!g!
z@B!@9!xrS4>C#t$GIjX2#O;tk%n*!)eKhPPV<k62<7YlygqTR#B6FtBr7PAH#J#}|
zU4&TbkA8uEtuN`+<7Z#WuD8SwC^xYgvtaB;Ys@;2i(u{91IDhou`h@DB}3(2=0*IY
zzPHv2nwTmx9ze%_SZm#(M{rk7vBl6mwnQ}9#S|xLe`GEU>Be?^r|2RCv4{yx&<Fi}
zgE8Gy|GVy~ycFXN`#a{$xidastSey-z<kV<UO6gz{$3B{7NLK$^cR-wm80@E_|7!>
z)+G2oHIl`*Dse>DcPuldn=QTRTh~aIB!s@-8QYMf_<gI#@6Ese^4lPO;C?KhY_6lv
zZ`kiQl74R7j`^{6U9i5a^AI7}2gAPHG}(YXt^3@se5iHkcYQ5KsmJ#`fW0RnX~;+C
zXOmtz?Vp?uNphbv0PX)H&h4&jX>|l!-pUQWr*;EVFa=XE1yeAk=UhkXQb)(io%__e
z<37wGA%yr>khy}x9r2!cXY&5!{hHi0X~FX?@_c)A-X4i{2ePek_6ypj1-6k{=;%^y
z>e|eAEASh0%!TG&a_9708Q<~4x56B2&NU~Sqmz$+<ZJa7x%`uJ&Aaf)uf#U*&d9&o
zJN}oxjP19`e*9kh#<;v2M&SFx^5;E4{e^+AGX1;nkHGegy2N(Y8ONBuUApfV|JMh;
z7dG#c#J7s{2Wj8MSKao;Sq009KDIr)O%{CKDe-Rc4b%P--#o@K<}<E#IR$+-w3l%@
zX2)rre!XB>_JbP7b)4XuO6o1v+I<t(-+gdT+_TU7gEQ8^eHZuiQ-`1X)QOklQ(87|
z##8PG+7jyqG;mxsUY&1UD|Oc(=dQHunqJo3{i@Wx_>7gloacynDo@N^>HM7Yino{N
ze{!#+d%wI7Q9elDKi(7X)`|P&9g`VSyXYewZ09@4xW-&T)f=|Ndi%{jjgx)YkL(|?
zzCC!erOzqjbgU!BYyXKh=VF@;7lv=Ol1n!E#N73bQF7cxH}56p!Q>P@ZNHWM7j5;a
zJY!qu_+-HV=a%!+_T*yw6SdFOYnvKVdo8CvuuFUJw0Fkq{<v4}uV+ZqXY8SM>WSqG
zwp%}7y?**nXhHUK;|zIr=HtwJwkxBY`^~q<zZVj}MPfPi<G1Mt((fl}d++?^?r)gz
z$phrP9(k{k8zwoTgE>rT`G9qa<tMeS>u(;4oNi7te~EgFe16Sqkyp))awv<sxpNY0
z)Ax=39oMGLb_0yDVLs3%7xXoz?Tl#*Szx&ZlY09V{gu`^2G?q{C!4)pvDfZ%4^G)*
z_cyt=iT#`*wdrrHW{yF+Kg0E>Psi;#C5`foxi}x|6W74`<yhSp_t%)iv&x-V+?xa5
zzX`iw*?RA}=l{}1dgz|>PaZU$V~+Vaheg?bTo3(h|A`a*+2?Pt|0e^RT*f8FozTF3
zhU27P*KmUC=r}6Y&$#~``SD@Qjj`W2|9<z~+s^vWn45dy8fq7H>lY~HhTVE&%(zEN
z(Pmv@S$4!a#Bdy<z9Qy`HcHW7vfR)!)|>3~;aypQy0-MSy%=x91^adk&fh)uY`Rvi
z*=C)OXMuG;>_?s--~0m>^!QtS@OR0D)$xV)&%f~Rn+-R}zk|L>{c2sdGltAU+I}l*
z+teHJDu=Pl`UM>yao)S&TD(zxQh)Q))(ZZu_r}DY^zwJ$WnaYoNe22i8g-Jn!F`tg
zg{)7x@%u*lyvZK%txMf=CMy_7@eHP3<u`k$O|l}^Qy%R9DKd61{i<tEdC(hkb-v2f
zEzADGpX#6OE^&TKo{3e?%0W*&S5nKV|GP3{*0>pK#W)61ET{gTl*WDX7Qe2e{yFv;
zcW)!Vp|3F~`_TgR9s6Uv6ETfv9A(ncD``);!?*evPmDd_(wBX<Kt0QzN6)8sXnVi@
zfIe~q&vjy)1NO7wg8k<h(x&}6wrpqJp^fu%Zsx$Z{J5|`(bsmiw@>?PFyR?jzaGB&
ztBdx^rfl4XPjVb%U~F||V)?gZ%%`+{+G?zcy@P8#Tx*!@MF+przKuTbBfr_ck-%?w
zgT?pUH<90V-%OY9yx;rHcfZFwWW+nfx50!4z8x0$j_^G(f>w0x`siyr<M^g9wte_c
zwBH@?3f~rvr*bGePMNR+^(PIRZH<?6u@CiSfAs4(a=gBaJ6zuLGJMzb*7p6}c~ASd
ziT_{m|0&6g|Ftxvod5b43;B&+>eAn~8?G_v$G5xh^~D$*m+L6%Sys+6-X7)ZYrSaO
z;QqJ=pLx4)tbdEOAFPw><vMP-Fv@w!b90K#`t;H68S|{|Kt1W``si<bQP-9}%Jj4U
z3GVr2Y_060`*-26m+o)J$FaAFyNGF=UC6lBWo-S8Z(C#7kMTxeIpaE(9jIqp+kZnJ
zss6?@u6^WLoSenQUWj|*+01*9^R$iqT;e$g*G(pK^qza?%?Ar^V7@vq$WPaN*#B=1
zWvOr5H(ejwb}-I<V0>v{e-rFm97~mHpW&xWn=;4#C%GPTO@Ct;^8}75$EVzI!MQl6
z%As7zwV3}9GuTC{-=O|IviSWbIp~tVD?R1pw<g(vzfp}~A>~5%w?LS|K{kHpN=Er@
z?V^8UKk6+1M8@g--X<$J$R}BsvPYYrWX4ziG!E;kuli4Mf2uQ<>*sp9wgXy_`|u{+
zrw+NNDOcI=e@7psy)o@0v79XQ@deLep3RBgg41aa3p#lAy#wQghRu89{psMH%6m4@
z+aJ(J7Tmx%m9#7MlL0N*<T2kciFvJ(_KjV#+|f_GdCZC3{1~~mBhAC+PVLG8GwK()
zRUiHJvu^*ur7p3JxqR?FGJlVF4^6(aesAUS?G<eYTKH%iu=z&&{jT`kw(J|=@)qzd
z;{P1|U!HH0<nmS!-wZNe$hu2iwo|SLhq7qb*I3VY&)|)c_-2tTH}s#-?}BffM(o6L
z+U)bfh%u<|u&Fz?L?7wlt6xQbv0heikd5`+;5$!TW6Lwhx<j3Nv7wcHbf0&@vis|P
zx^Kp7U|+RA;~B?up}(lh#lFCLv0r1^#xXi3V>*wVoAVuoR&?ub!Sa9xuJ;PmwHtR5
z-@fd3!(bfOu`oX8*g4~k_sNA5Z%5zN>I=LF)+x0$?uKs{?^@ok#{H>iw_fyJ-Y3}c
zUeEZ(t7xCT0ii{^Ui#T_PrdWYeDDL->*u|;-IIY$8svEGOLELPZpSjpcx-cFM*qz>
zTX~yq^c!^Fat{_|InYYZGyi>K7Qd&SZK}QD|BdSR8{IgLRUEgd*Z7uyL$*z6n;PG;
zb^R~Uzhc{5fA^(<XC=>r`@Y%d8T)<MTld|vbu0F_%G7VvDYYd7T^eLu&(DoB-8|D!
z&%5RMAbl2hql0%(b}+n);NKO~zb)W$k40UypP=FUB<u8BwA<u@MNTk3OfXj{Et|JQ
zU0V;-wU1ySD~GaZ8(=&0T_-1*o6J!Yl$oz?<ScWdc}r|_VUfe^(|C^8`8s}4|JbaL
zylRd%|Jk3Yw}^H0!S@y{cQ9AlU+vR*w6ebTH$a>HfA-0}jdSE#QkManI``E*y|It(
z$)T;NZ!nHN2h=|{edynLIsTlJYvnphdqMk!!@Qk~^K;C`b$s51&Asrh9Pkd#An&7h
zs@^62y-(gH&;2IOVt$@s$1TqD!e{RI=xaM;)qd>bN!DlomY=K`Q%7Fn)-lZ(SG|MI
zbrvk=zBumVdcbA<N9;*w&E4Y#u32K)y4*Kq`s&jH&!S9l@1#drAAK)mtQLJM6JyU3
zU;h<t8&a~LD(zExko|wokmm?SNPYA*ma#85Ci|5WxGoo5C)dk8-tgIb&p_E{_ayg5
zdE6(zAN)Pw-y!}@vf#q(*kSxbJh;&Ld&s|wo@lRiS+3IdVytAK|0ig~shk-5L{>WG
z#5s!d9S<7iH#Tcjam~Kb<8Lw7_Kk&o{DAwC?9i3TK$rGQ(*G%U#Hsf7%b5CkhGw9i
z<&G{hY})_-;@f;2kK^m$-N^f4Iqm9lf@iGpvR2yO*w}x=4L@aKyVReubB;Vuf8yZt
z<gHDQSSjCps!hM&QrkWC8sk}aewd%_a!u52tG~2zM|aV^x0au1w_OKg?t<mCXMZW*
z{8o&?c+!Y1Sx&jAOFFtSjW@t^H^H;Hg6CPaJfOk$n;ux!E(<Q?S#HsX{n_^^<T$^L
z)i$-AeiJs_;F(h`Tc^(i`*V(tBkz`F<676kXGLGy)vdF=ac*Gj6&$2-<^yg26K=Fm
z`HVG7e+@lxZmZz>Z}y>qZ=%chdBl6o_mAIg-)Mfr{gyAj={w#Ye)l{07Vu3lpanbL
z3;DK4S>F)0HHIAUJ(KST`^oo%{fcGjF$R5YlWnv8#-@+H*D*7P`nFSl&TZo-_G5eJ
z<U45c7WQv|hV)&m^o{J_3BINMyTt!%E%1L_(qRABznI9sCEFUuc%43cquZx%^g;j9
z!14s^lvz%jcG14^_iqE|biwzXb5zOz?MllB+(-A;JsPpDuF(b8^+01iCtS}9XQy+H
zJWEeDHqY6B6<lN`?IZjeQfzCyLwx(#^ku(2&ZpxM%Z|x<eQjsVTd-`*H|(RAe(cLQ
zPqZh`x@S54QV!aR>s9Bm8UN?Zvd*4m*W7dH`YU_f6ZhdlJ>QEti*t8fa{hyPdgsj#
znXAlG<|lKL@6ipvefQ?O);41MN~dgGv5#b+n<Hn?kWaGiO+I~{%WuiH8F$n7EjTvG
zu^x1BF3xQSIrpE|YW+i;!bN{0{}!42t#TeTeghh?;TAf-Q!P0DUgd9qFkuH5DTCj*
z-dNb>6n^@x?5%F{yWTf8bx*2qr~ZxVqpnZN9BYnUISOe%F(=z*dt+prZ}zOWy>VU3
z2ClJd-N8L@FTOFTlNQwdbboV?Q-8`+_P_e3J>ynsoxVv&&vRDK-{Aa73wEbX(2?R<
z&$B<!>)oij_h!D_+lI}%xPp$9OU@B<k5ZdH2W(T(W}Wmx#>hCv8bL$8G0AtnYigc1
z4@v{S37O~3_3GLZZ71@3=IScV+w#e=<XgWx&2JCyjTO1u{GDv_wz>S1zayWIkmmLi
zsB8C)<oDNavGn*JD>r4|BiC;^jG!U6-*}kNgX918f`ybUr%y`T$%Y!wdfQ#zA-;DG
zZ;}=GKB=T#sr~-ff0KUI=cza1C-zm@lto)BSk`{QaXMb-A?nUo`v_?{eKz&Z)pcBO
zq5DPxrDf|Hr0+tvzOfhXhkMo7vwSP%e%8Gl_}Ru-#+flTr8et6d+Qz(%eKa;XGZ&>
zKF@*uAKG=e#4t`XR>bZ|=PD~0NY}~rYH--2#Bya)zF=EpZCEkZ>wFlG<MYgK&i>#I
zEbu;5v`^pT`049C`PjHSBkqxRNi4T7__i@_#xsr>dq+&`R`lQTukWGGo%UW!EBF4Q
zzp*1HOk@jeyS{MC9PC$SkmGP}&T)hO#xk~jUC2D8T){z_&&+E(q<WUkfteE*`jf0v
zw%}>2<)@x)l=ffC|7ra>znr7?-(nl-FSwSuo^SQpHf8!`yG48V$^B~X8GG2k{T*db
zJtyC=U9IyB^uTz@MwbT0@8H>P;Cc7#i}y;Y&AI{lJ<;AkKmEOn11@)X$2V#s+YeZu
zKA-$Vj%wtAMLziCA##NIrv>H=^U{gDVb0Rm{2}T|+ESY5CYbXEeVG3e`?Sus=FS`a
zWuB|@MDA0HV{=T~+(`^$uE@8}y`vjD<4*i#!v%AobG5x=)z|UJK{w{WZoM&-mbKfL
zeYj_nJy34S_J64pb#2zUU+&`#M%h2>SD<b@_cpQIVOU4JPkhGl*$d|3TJ*p?FFRzG
ztzV#Tu7PXUWA4YX+9zjpa;`_@s?FUqH;h8&3hTUI-YxG{-YMH(;&{%Dne%h}3qEsU
z{@#VjeYyBIVi@m2_ND%Yew9gC8ss>7-0u;0)bR}1_8F+Ruv?e)9lQH8W8EFEa}ej?
zp1Kdp8(4M?-E(Eu>yvfv+X!}?k&bWj*;nk=RjgkTw-HZW-vOReY3QP@qHR(y{lPc8
ze%9G`!v)7MA81Rv<GRp1L*V)y&p2zjSX=kGu@@UWC+^qcOilhq@b8BeTx5^G+gm3l
ztbg!{zmYbwGRxmiRd3kk&^9qn($W7!`lhV@H^%mq8+&C?P8z!ScbZIauHw8U*P+UR
zU0SeNv%kf4PCEKw?Vq?G+LS*rs26=wPkGtbL|f`rzWLUA^>1yTet#-wU*F`P+Hc14
zCni40)AyG3_>*4SHriz_^S+3-3F&tqvA@l6#a=1(spa!1Tc_<w+Mn|2=h;f~y#0;*
zQ(Nn6y!8K*tZh=?k639}TK8MBUHW@Z^UkJR*yIN40~%zzjFU3$PuUrp`{4fPSx{OY
zv3L4B+f8gz?e?Ezu&zPI9>klRJHMgk??WCJ-?$r=c5^u#{bD@IR<KT=4%hq-O6?oJ
z9%Hs|$M9rhyWo1sddO-&)MZXp*Vp!kKAe|**=KUmMSD_hE&9&5=ImX_oNkWa#{R;6
z*e$0m<$m$e_N{(Wmo#)a%w+}Lxw+=9b1;z7g5w^#AMPo8yL=P*-R7O+yJh%|=lj2S
z4~V*Nf`;9?iuMWmC@t%^;DYgvZ-jV9DJ^U7ppU)-8rWWp)!{_{maW&<cE<R;%ZT@R
ztMUGD4zpnS_>O}c{TgF9FW>e4UE|*bypKoFLTXF9@9GYN|F<;Q{9mjxDJR<1m2cSI
zI145*?azL0&>4?7E~R$s8#oTzh`P1`7qZQvO=DipZNm-JWk3tm<$`|`9BBUS1Ma)~
za9J<+Y{mP|ck=PPaBe(17Y^sB$C=tl&sm<ilzH})`gs0CJ+W-85$DoA#Qr>^m;D@p
zx^?<y{|nvm%xGu5Sl)0!e^J+#XglB-#4)A*Cg19N8UG}9j@ffKS-%d8wRAl_!=7b1
zV0mk!PG9G_!Fl$Wzw00^#=T;^*Lxi~<B+>1`R~H<o!KeFhW5|D7)V(!Xm7!$%^MTD
zbg+*F1MG7@a4c!7dfKYAz6I(@+TLXP?9z|=EjTvEC<h$3<KK{T9sm4mO@1pE{&IuP
z-yO+}zfX>Tiv<4uGhhc7>F-niPL&*V@i(jq{+=bb;O|_re!;;fdHW45e?QB*KS}-n
z)Fyp4zDe4Y9db-LhY@p9I@elOUoj8cR*WarcEUHMZ3noH6I@@{yMud>`=K1AtS;>b
za&J@4$G&IVjP(|;)@6OhOPO&y@$<ap`5SR=8*+1=CwRv5ybpA#_dz}FDYfljA}ft@
z#T>JOUUY5NJ$<z$`baO_$Xy#LqtMWO-^_T|_&v$ot6Y?Q^XQZ4tIfQa=r>ARbG`Xf
z)U)jOz`Sk#y(L$hqccxW^0YbJTy0Jlea+wcT)vxrJAJbxmIrk!xRe`QzO{aHKmU{C
zJG|nX+>o;Qo+lGM>F7_gPPrdsyp+~=Sn-C)w?*?^0f+a=6W=VAPWk@V|I2={J^gGe
z886FKW}WiDWL%Edam$IZU+gj{Td&>v3C?!}3;B&pUA}=vyn#AzAm5+vVeXy#>mKI*
zecnm<Pu@<(ZeYK%L7VTY&px}~kY_+S9$3F&f_-md+upG`M&k`=V0^JJsq5idHE`X;
zHB2m9r_Tk~tkd3@_T&7U{X19BweOaAi%jl@_zqF}KJl*TBkCQyZ<GPb^wnQI>#P@T
z9c<eI^&7FWoxVHh<?haSubB^$i|&0F?|wy__4>}BAtlQjT`V`q{BR#*u48P}S-%*Y
zZEU;YLLJAU|DP~-iFs^8=EFrUOwyLJQJ19cPcr?L`qpyl+JDRX!Pj`s#W^J%T`X_V
z=ZSXFM|$A;trxVX&zm&H8yV02a<4sK?qy<Gd!t@vpuc3fp^Lr?Y$q9K6EjJhGHngL
z-i67X67QCG<LzE}f4n2MTXBDEbGW+$Zv1WG_sMUUR6T7ez4zv!Y5p<qJaUUUV??es
z@0gP&evQ0g?pPr|dBj{&?A?4CnBUAZ8#;Z;3e<;oePayGzRXq8w|eDJ{`fE+$6(yX
zT;-zMuVXUDIcDc2>e@C~f5EZY{xFV=q3-xTajkP~pd6I#L!V85=1p<^ZJ%xQ>*3SO
zp1QBn0{7cJ6m{*^uizp@oAvf%T<1NQk89yRZTBi@$V%Eb_6x41>$l;=8h++P?9ch)
z91qU6_pUwe(WabuzpQ`a9lLQiwrAG4u{NLeU|n3B&pKhVZh8N_PZ9ef$4idUF1s+%
zrNJjBMBm;`@1yt3wX~lT`{Y>MKgaV~OXO$ouwQVE7wF$;XWP#>Dce?G+b7w!M;qIz
zPy7~spSgNw;tW;Uu*--w(f2-ZjAE=LZ7FSITN%*6GwT`mtcZHYCf5DLp<aw5#$0g0
zK9!<PMo8-pxK7J8VC_7+o~vQbV^2<;uO8=XvDcHo6E@`E6obD-WI^ZenhCAr1N|Rj
zK;!SEZ&)wu2YS>gFLA$N{Tpxon>dw0`ANejC+6k+lFNJ(=Pn~?$cpRr6Rzo#j!h10
z{wLg*%6PexPut}l{)TM#^nKc&<){DOl#QkTpJHx&zG3@sb@PWh+x>=&Z7gX)mN(^Z
zT<VgXqjG)Wyx6t<4SAk^lJn&pZfw7ywyplv-b;M-r244uU*P@9`?k;}%fFHOU&#CX
zCao8JlM%Z1B<r4X;M2hQG;n_hdv8AVJ35h;rGei?<pzCi^IVIJbHm>_n>;OkO9y1^
zj5i{tZH#TX1?shIn<RZUJ{Nj9hn_vhGU0-A&H1ZqlMOSZW$S9aHre2u?Poyyf@7P3
z`qnSvx`+FL`8)IaLbs1U;oQFQQ`=6v#CbS28HI)}bsjmNDm!y?A3uBQ_t<YU-|5Bo
zdISyWciiv#e!LT!Z-R$yKFYT7Jz$ItHSVN*;;o?1#aDl0oP4L`8$DzXyFN9p<ILC#
z{RW@67jrt``%RpqzRSLe=eyT8aQAPEcsF1EUy^L}H>^+lM3)YS|Akc+<tNtbyWxWU
zp1^U)gbl;LR|0j%YMuVJ%eJ<8L*HbhOO}<rl&ur{5c^xuS)&=aUW5H`FFt$a{<5Z?
zAK&<gv(zGAWZqCt^GBdw(QZ3gp2fg;qhQ%OebO&|ntd|{vCXxNpZ)AWJ^M1wTifY9
zC>S?m8OQv$UeKOoy=B`tj!z8YF3#X~z2JBbp@H|odm`!=tRJ3P+BsHZIPMiVml<R7
zK6~%4_n&;#$%8F&)kT`4KKTiG3i+Ph|Ii22cXZk&_8y!^+ge`K$pHJzTshI(gTwf~
zv8a>&1@rkg-r8im6MZ@s$0QqW;J7Q!B{}Gl>yXm5ksajv4gMyP6<lPc^E=ZFj=wqi
zJ0J|$!9{j{!;%#of7AK{jo-hLiJolq8;t)&Uq6t3Pic&Aq;HM8=;J4{jWH**KcJ87
zAj`@Yb;{JWC)!*)*V46hod+~<4<z@bqyG(cZ`IeA{kD%}KKgjZcq?aI<$wlx_B@9j
zPN)B1AU)rnbD3Xg*z<m*%zN{cJ?`aCckr!lb8nO3o9cyz?Kk*-diwnoPyZS3rxkA`
z-$Ul=%-fe-DjS+Q`PST<Ior2`n7_@-+Anl`l-jH}r|-z)=JId&{<-nq@tf*5_QW?g
zzrB8cwfPNx!@A1T$C%&HH`@;4-1z=a-vAHldt>nK@ZBQ5VP?>fa(Lgo@u#|sqtv&e
zZ9|WDl4IO(19fc;>R8paS??TI;JkCKT%Qe%J#Zgn!RL+R8xaQk<X-u1Y>z#)T=()u
zjD|FB#x|z0HgUS|rr3YusvE;t8wO{{bELGaU7v>UB*wE3=O8_Be$I7(bDyy;uHR)H
z#r2ddug6*$!?EYM9p_{m$FX_VeV2gJJ0RM<2Q6g!HSW@i_ls|s860Gy%{w<he^Fo1
z!{2*3yqnOuyW$;|6EyC%cRShWm9#hPwy|voW9}EUKS{qv-P^cx%+75@d;76J`*jTa
z!KFONO>da9Du?nL)knSh<ll}d-|DLEH+sgZGTT+#Q(rNkfpp%9W$VrttdkLByG@J<
ztzcREeL;Jzd&Zm8yI1bJ`{zEo&%Ka)yJLSnLlxUvCk<+h%b6DAO|VX%iZ<&#OAVfP
z&3mWKI??YI2D<e<?&Xc|S3`P-E83FJ{q~N-joh=i`^Wqh`NW(m=2tPlm}{<iDDtIk
zq?tFcb@;?EPN2;?ee}&dIOx~D6U#I5-=J-yANxxd`jd~3zQi@RI<L(<Z>)p!Ys9U2
z)v;`FEVi+K*TpvGvJ<EeFx~`xa@~5Yon`IT%LdEVJC{Kp_NBD1PaS*Z9_E=))-&Lq
zyPuB3F(j6?Td!^``*`k|du5*QKVZFngFU_Ov3t&X8!N}#iM`z)`uUtW&u+O>d7rAh
zQSZIecg6k6`|+7K<KMAH?zw%qj-UCt7POhPHSU4~=9XFBcb2t_J~9e94#)86oAqAw
zaoLCN-ZM|nSVh~3`Fl3>O<W7liQ{&h?t$cfZ1hGS1C*AnbL|>@`i{9eXU~Gnkf~el
zg<969(bo1G?gMSsJ!#mC>73l#S+JZm>Ltr52R7U0xayeHPmIfc#PXYu<NDkS)?>t3
zcD+3N8_bIXE_enGZ1&H+bbk-DI0OD2;NK|zO>?1l`h=tW=U;5(eL;IN(BEj-<q$8W
zy37Y@S7y7EwXW*3#OUaWb4eEZ2pTfk%v)x`wUEQQBnw?e;j(^DHnzWI#y<RwY_$1C
z#`#uX?Vf|5sJ>O7KlESy-t?dP`>Ad**5oHY>(cKh`KK6fV^7<RJ=@6t1eZ9Hv9kOp
zS<hqYp3~%@SJM8sa+GubQ`=Me%X^e}YjdaG$oiCTKHBom<~^=*ai`z7*x&MjcKru5
zFuwhF_^i3#OmgQUr(V822f56t*n6C>JU=b=Z6ejvzR_>gX*2iQURq#Yeq!AQ`>~yI
zT>rZ6mW`e9C%V2X+NeL#C)v@~I0u}!sILdL-Zk2Rx^46~p8Z|MJ<8mii?&An$4`IO
z`v&e!>dM@!iCul!?h6<DlW)G-N8viwU?XJ~8v0?}3x;!GpOQ{lvb?FA?xWvZzP+9m
z&rI{(!nb+wjo!X(Ve#F*eA7qJ{N9JYkvGuqfNf^MvRKzkEMrXG71#F|4BsNWzd9`6
z{&0Q&BQ0yUUO(H|))<b#xW>2NU9c<-tY5*Wjc*#_P5S7(fw%8rXu;wCCNc|Y`^lc|
zjg_P=+h;lJH@<RVF_y-doV)WD*TC|I2@MW@`Z{*oWsFgD?beIFC$N2zHtRdsMs{JK
zC))M1-E};yq5I*Qe%6}vb2vwXbLH8ZoH5VYpU`)64nJ+pUtrldD`M#*op{ErXxFd7
zj5sUeSk`X+C_dJ2#@m94w5&Y7+d--AGcIG(@8IruhvY)uuQ#dhrCnzX#_hz*^XQpW
zmjV01rJVgcR_EdPoyR9;tgGW#+;4M$Ibp*EbI2su4RY8dSG7(ZTv-473x8jj54OKK
z1X<T8%b{J8F;aHw<VHUmIiSIze{mfB3zu<Lmbo_=$Tzb7KH9#OvtP#`=YiuC$DC~R
z<f2Q?Gv|H&`PZ7{8s(ZP_k&AW2EPrh@>`L=8FhZAk{N7d()dlQGAJj@-@AUG^ShY%
zJK2H8Z+0>sGVN9B|HL@bLuUC<&bG!*HhQA11^SEaJG{-oxg}Yz?~|<iNoJfzOxM+Q
z?%>+H7nMQz8`ZDs)j#(+rFHtAKs_1g>9@a}m#kOnGlPco{CO5T-2UHebQwWICZ7Gg
z2R(G99PW~=FL!SIV7E<@ewQ5dWcvmSCbIp3LoR#s(O%KVc)MU(yM7DIjpoP!4Gy_;
z#{0;8y~(Q`%(Ld(8+li`p+P4fU-Egy??ff*2KE-Y|C96iRxaN#d^=Bk<NeO7YukQP
zA851gNy8@EcW{vv?G0*QoxT#k<H<&s0qud`{2BNLxbZG%NZGuVWCk7i8`6K{|BR(g
z(kG?1L7x|LEDK$msLKWG4>%|1b_3_{n#{+#`NmA#r_Ni^_vUcl;6UfwomjR`pM$?`
z65DRD-Hh-3MyhMGt_2fm9OL>XSl}B#IiP`c`q;)k+-Juxt>C;??6LE9{<%)BPtwrE
z^;BNV_~+VeVt)FeKga!fzi^g4(|N9aqsV+gyMCXy7Wc+GbslJw@q+dPzPr4ajr-{x
zl?6A*x0m-gIiaW2-UHj&URq%MZ|IZ#SD#KB$LBZ)m>(wiUNlcww%+#kb-^(>CNck1
z%t@6^S?&v2_a@)`JGt*0>HphU>Hkd{XZ!{F%l!rEJ0gBV=6X)nRI>bAX^g}+9o#SX
z+C9$wb&tieSU17_9f5jcd+YT(rJZdpi*=PvIhp7U^nWt2-8f^Ov!ojnEKl(6-Ix1X
z?`-Fuiuop4k$22hH}cIOADCOr4`MD|1<Nw2)A#C6o~oEndSJa+*2f(9>8s?+!8md(
zpB%(^4)tO_bbQ(ye#+Es<D7QnAlG2B7T!%!7ws$7XN0b;Qz!bIps}7KP}i<cwr{kv
zKbb-5hw)s-w;1<ko-I)S%*XK>kG*r>Z?KUk_S!xtK90{m?azLktFd$b#xw3`ZP|<F
zp7<Rkzpn?{62B4p>A%1|b}t)yG|FDNhvFPMeSOxNaXHT8z2W}k{aoCwH?qD_uYcY-
z=WQI<+4XR)&U;~7#Gd%tCSzXox4foZ^cz7#Cia>A4&oZ$zCP!Nc{yL_{#=6<Yhk_m
z)sM9pt~a>$jlFO`+;jJT5LX(wUmdJdrk;B^ZReT>>WQ{quxy=e?9UiAZjC+SjOeFc
z+0m!t|Lm#z8}n3l$|v?)narZwZome|=-3)@Cm8>}pj{@kkd__W0mr|=braWc!3EET
zcfqr9!F%G_xa{%dTj!hKzXN*wO>&UZ;_sb}lv}W@&yBwqJXgjVl(nsw7`D&9v1+WJ
z>`y<-yD-tE6>|JlW_`82>5Fmqz<J0H22$D!hq;Su@Sma+>p#I^pOa_2w7<z!+Nsy_
zGftM@;{0UGxHa}q{=ca+)+ks`4*GA<zxqAPIp1$`#@;C_n{whgN?rMOuD;nuoW)h7
z`jd+-$#eabSzqOfSk<QfY&*FtZ=AUQzma)2l_N-7mN#~}h29y@4=m~``eu7$HE?{+
zYd{OsS8$O}ddUy^xpy5rFEjSHVHeAuog3d!^KJ|L{)=Vp7mQ)NLEATsseOUtm_d%I
z${W76F{X0Bf(z-Zu5CaoSiWE%2VAejvUclj<2)U^INu)q^=LPut^U^g4O)DQ@|)Bs
ze{8JBW*vrW5G>@MNZ)3^54QcmEOhkb(BHDp7pYAy<C^Xl<Lr)=H&BD=H<fSefbF*y
z2H)Z7cbV_=f*xGH^8*gw{aI+(Ht3t^t8GAo>fdR5c~30g8L)j<!Ql<Ie1pQ~O{yG$
zdZO)sZESBG<J*sYUU1Ax%L5Me`q`IljWOxt@CF{R{eOt>WBxy~3LU+2|BJYVjs7I-
zZD*|WK-<%9-{LqN&jQCL>I1Bk2@NuC#(RsYuWc?EBV$>%u01ejjhDK1Nq^gR;`#T(
zg;n;%HFm9CbN9jX<oWWvdG=OtEqnerYwn*hjCY7D?$2kB-A8;ppNlxQ@!TFTW@6bo
z`<nXtrZl!~;exgUo^$0WK8^arc%Rr_KV#mQhjVD$rxB>j341M1Y|hp3IX3%sJodNf
z&ovUu7aUu|PhU}&1<r4Sa~{D$e&W-Q<1rVQFU&d9d}XdPe|74Ejg%Ysn}WYBoWS23
z^0$YS+9Z9Hwt1stmmBdnazKN_SR7CP!ezYHDJ#ySQtPVzEpFOp^#3Lgb>cWHj$L+e
zk(He9Pjdb9ueEaxUDFL0{9Q==o#+JqUX}R!Rb^9t;%{9~2DW6OU&!CnCcmwnAb+Pz
zsXcXN`q@VM52Vj2F$OW@Tg;5-_#Ed58uBO7Z<ThbUu;iC#B=Rj&mOquu6;7le?$6L
zX*>6{@>8tpw`n(nhCG}X<)6^cv(@4Df1S~RlosT<u5!jb=t!w|sNS=|y_5D!(!a`V
zyM1fHi8s+enyZ@mioB(~k-PMH`spjSTS5AD;)?N;v}K%Zqa0wY35UMz|3310=JAxB
z96QOs*Bl*eWaeh;%+ZHjJ-|Biy?Nd5%Hmt*x9<3TEcm^=zGwV)@*V6@zp2*gZ`&QH
z_lRZt0ZRR}*Lv$VF{W`Mwta}-@1&MD_5m&Ue3ShyLx;;7V8{C*-v^U7g7o0>K6)eT
zQ`+W9*1bu64-EQW;8>J0f-GOkj@NNJ7w6?X7aVZSU6%{FhOT4f#F}o_wZ)tABK>Yp
zaBr2;!8-R^`SjCQpGKW=H~l&W$Kp6f^fjnA-tbMp8Cu|3Qd-vjiOra7V;s35jg@8l
z5&fEW*1+{}ZN#-oy{?mMWDL)feQo;m++X;dd&beQIZo$vKp)5FIOV{^zjGhFAHG`-
zc$bv2V8Hcmg^xDt<a6)v-{4&wzH{LICAN_P?F;rX1N+S}q|}!6%3XXHV;zw5NU2?4
z`?UWHoqRI`^UpA^1?DAnW#v--|C-w0-{^y}wZQpE&M#%!_0wN=k?P4smn^4Dd)5tn
zT9AEq`c7ty!@BfSTF$yEwP&6C<bE}9pF6mh6>TzujZAF!jr4hw*=Cf!pMLsin{eXX
zZSKwt)IEQLI`szL!4cmi?`U$(CBZ^g2IV)lxrv<6$tm}dPt3Om26pSrZKLEP+sJ|w
z((*OeAe;FHmhsIg_7&s0F-~QUUpXV!w8%{txtOo>p5PkXKwah+vOcALEl`&Yu5F$L
z^&58U^pV3Da@`$guA6go{_@e8>t~%Ax9yDU-sZlmO9$(2#5eXXd%9x38gjC3uA%W=
zfA^xrUYX~Ujs8Tx5iDf)`}Bu>oUvz)!EqhO$vO2tc~8HwsjH-4!`^AT%02K-XtOTc
zTy)8@GHp-$pe||XQt!L>%Dr?=-7Dwh+BtvMA-U+H{lvO>esfRNZP#Ffaoi8jsj*!j
z&#3x<2G(8H&VKuY!#+MqALF{;18kpn;l!O#YU>ey;iJFU*AwH}*JaGjJ&kjE;;d>@
z*WO>yZoPgRMvUFK_GP~V)(hILPb{yX>Ia+iab7t$<%Z>YdiU5z&&%e#T=seL=0AnT
z-wHBd2bMcNlQ!PB?Oh~ZH!gkJul=}Z)4NR{p3mi3DseKN@&-NrhjIK{D*pc3A!kVK
z)-TZiiLs11f>!jjS)W|=Z!z>4K|@MipErG$^;1vuO<mc+HBT&8w13vjbp!WEIl^w;
zeNfx~J9@@5_Mb@Ke@E8Xwy)*i=(c(C)^6ZesXjMiq^<fj>YiA?qRssxbIr3p%Wra)
z^Kj55ZK<cd$~=d8E|uD9IrWWQ?ib$9{hxf-%bm+O*8Mvi+Eu*c;+@~YMLx;@<0#i3
zNMB<Zvw?lSjn_4B-9|{u{l!<Ce$9IJ&+{?joT$qM>t^h6-Aiq0H^wL!SG3tizYQ(y
z7nwMY%F{lnf8$`U=+hr)t3K-5vX8|$lC<^k`AEime3S4UIDU8h2JwwseDivsezASN
z8GbKpQ?UGGU`t%%H#YXlq?|N#-!<!jHmUWO@i*{$cl~C9-@OUl?<n8774MbC9IxL&
z=5v|Xh87&Y^{Fc@Pq@4V#CJi;;rjqSZzJDFFLZ2+w^hEicD%W2d14dmM!dz0Wo-L$
z41=-AM(>uf>*Kr4Shmd=sW)tkcd`E$8Q}k${J&Gu(cif7Kd-mCY<p<iBCfID*w`<0
z#^5;Q1nM31v26>CTgm=X_87lDwzIu)jCVrb5-Z!KwA~x_pYd!j#+59m)VAP&Ywn(H
z_QJhszO6W4o;T0kMIYMSH+}GTUy_Ti{j;C=T=yCO<sGE0XVy5PKH>~pXFm;&?>g{I
z+tzbEp$DIs#BG7+NLFx>`r2;O-k6`UbBDZB8@ykl-XQ;mYxvB#UyjW&b;tfPmKxu=
z*v|Ie)r^xd9D}heI~IK|9Pan9|G59x96_FG<~wtm-;ItBY`B5HEr`D}$a#>zS7@*G
z>QD5Mw0HCy{p{#>AR8RNVc@u=zmRn)4?bf1C*SN(zh`+6OVXa@Kgms-<eP8SD{tVM
zxIPD5+X)*k_<NGSIUVpfEPu<A9klqJ%ip{5H?OoQ)4tFvmvZ87a`{_c%JcG@Uj1Fq
zdeOhXpj}Sz_Isdp`t-o@IK}}Da*p4mK8bDqMEV+ULjQtmU2*+?qWZq+w(Wnwy>`!K
z1Pz&ZHe~*Sj*r~VxPyUA8oF%mO)}A?7Y;c>R$-w3r|^9>!JO2={4|1%w7js3_1b*P
zn9pQ_{@ShA??8)~>VLvE_G1iVH88I6&Eb_5`P_HYG7pn$FL`%E=4kEa`yHs8kM-4W
z`u&M~zvG+Zx1~Y8R}SwLzj3kxZIWfBW#2b`FDu3w#5*wkPJyz6eO>DH>5wrm-_;2X
zd?(3*4t{rK$G6yTx!?8t#w%C62^w<qZb)XlLAq}V-bxj1N&4+*YaB7|1^b)O7{e%7
zevZdB72DSs`rB@Ub9BxdF7&d-u8lO-X~vqlZZ~j^#Wg+P`nt~hfi~;(N#E25He=iG
zpnu2W+Kc*ztBrd5wteILT<|QNz%%8zKK?Pc`<S17*q43Uzu0COn?4%M*zZAG*SiO<
z*JoV#ItJ%xpE-uc*>)_JJ2*a3*LFak0X^O`-is4>Z?1QwU|ApQ^sD#Eca8V4-cNOH
z$+x<JPlLRpPdT}>qFrg<j$u5|CI>oxiRA%~e+JG=n{~$Afo-&<-LaW_%tPj*WTPh+
z{okdN@8sWY{~SY>s~n841&6tqPencL`pABe_LNzF@k`RCOj}BA0~*+8hdc-B+74J>
z(PrH@I(4g@8~3p8ow~LSo-OxL|Ky-2#**4s+R`W6J>`g)=~v^ZYuCrIc&0jd_MQxE
z&9li}yxhsWzj=4P+sQzG!}=ST56mTl9AfS;Z=A@(O3NFTb&=ony<q+^za^G?LA!bD
zldB?cnN#i4apgG7GaJk?>kH<d1J3_~>!XzY!oZef{SE)8G}eLxEzX1cAeOaD2V=SR
zpLJ&r&L!t`oD<_8_^c9Z6GM!bw1}&paUGNGjO{wO9`30z<<gINzp<X1wRbPv6Z89w
zT<?Cp;T|UXZg8*P_SF4z-v<43zccQad*j#~vuBj^x}n~~r#|AID&I)|tXtui@@da<
z%J#?umK~F0lMdb|*SR@%*OU3=Id=`j^++tcE_u#p`KIQ2X<ObE)~Cfe&OKV}(+Jd`
z_Km-7{0@KCw%iTv*4sYYy8lmVO#Ng$xDm^kC;GC#%BJtn9FXpJGQG23$_-!J8OOLY
z`mw(pLyqZBvicv!?>s+ygtT1it@FNlw?6lS{q){!_IAa2bpIDznC0&W^?}W^ux&>S
z<8Q`X*XJ@XS<K7%*q{04(&o^YXW#zBSjV#!{rO$CpX8MO)wOqUY@(i6UeE&1aH4HI
z(D#DvC!D~)on(ak_P12FQT~aJk7R#OJ<HZ73tdLgkV)E<>xGL=vfsD(Z?+mMWBjeG
zebzpVeZFAbZyER|wmAjMmwgv~ELTqWR$J;>mr{G`RerPAdF!uV^|gKm8~GD?2J;+x
z7XOw-o8+QP=YJQKN%?QE?ceyn`5L3fIh3XGe-|0B;X?2KFWRjikZrTQcH5l7iWvI4
z2CjRL^|xGOs87iCdXtMbBjOlq2I>uaqR%Q={$^{@?puA@FMd77=r|K?)qW`diN<<}
z>muqi;utHj&lO{TjzgbpqmSo)_$?vl`(5z+w)hr|Kz(BCd^bMdAioFP)y3L<V^CLV
zu5+;IPiD}Oa)>D_7)ZH%YbwwB^h>GlgvFdLV{MMtZy(>Y?RSmu>1Hm+xx!{{EjZ2<
zI$YiXGNAb;;N3HQdj{9{k?)~kAX~6`M?IOot>Ey^T7hNlwzK^O`>;Rzb{rLL1N2$=
z?h@0u#?xjzF}8he-p0+pYxqBv^uHk69NLI+W?<YW7u%purF9cpQ1y)WCiTz0Qh)ks
zH{K4^lZGzYM*D^v(sB#bH(YSs6>Va@sJou7vuo=bANPU%`0Nem$a8f$U)}o@%s6-2
zKlS(xePe%D?DzECS;rY2{+-3y^$g2^!#VD8mK*iPwI9#)vQ3=r=3R~RZM=$SUaXe`
z`cK%7j~K?bFYnNf`=@N`j3e)pelozhIu^%qBc3r^kp0+)KKk447FNWXF(>2c=bW8?
zj>o%h&e&j{xiHCPjoh})gXG0ye(czTjl6~N4{cvq*xoqUrStp76Ybe%px@|cBV|AX
z$0YNGjxDkN1hz|zQ`wZ0i~hvAQE2Fru~WX;>KM{5Z7I{P%-DnYvf)Di=fBs+b@I2N
z2^U8EM&)l>{<gItfA4z!E|&Hx^~thrD`{W&T*%++R{XYiLR!u`rM}f)n?998S+sS~
ze+2_64RSn_vGoVqlKo}uHOAA&atD9A^S8Q+w!fjaRsU1l^dFCYtKI#T4J~m0SKzt$
ziQ8!(Y-BRfr9JQrdM=;zuql&Ej*t}$WaXQ^`c%Eq{>dgEJuyf1!Xj^(zszHDBcEwM
zkiP2LMxd_EdSi;ZHhqlM;KW<1$2-a#E+caJA-{Jpx0+*b<XiJ_GtXNW{`#8x^)>$=
zd@^6#ZbA$EhIAO@`po<4=KcnqZ_eghmv0&0RK96GW$cS@mOi$%jo%An??Bx?v|s86
z=xaOU9>1p%)7XBa7Yw+3w|9QOk%#ZO-}FlN8xQ&IZ+!Rv&s%~w(0sg~F251>u&KXc
zy)j04M;!WivZC*epS~4sa>4QG+hQ)x$@w|Y#+-Mor)$w!6H(8y>y+y}Sv%>FZw2-9
z1$`xbjWeLd`cGrimt#0FCdZ{dv0bp<G1=zYmOXSYbFXKdCHK~`+U_$)=NVk2F^7HO
z<Cw+%n|;Sxx=yyyUun5R+Mh8FF&xjQZ)A_N=9%;CIkpWK2KT_b;GOW!ct4bulU?c-
zb>hAAezmw?dC%(IwEpS0@xNcNF55TsLwhk!($Vd|j?wXr7?*YGZ#3*V7xe|kwXf{g
z@{Ky>p={lSMIJII$s|9Sr*6>AXJ1Gk{hwsrQ&zuPSMBPxPCe@fdV?JAH>pp>c0aMH
z{~L_;S+B_9E7saIRd-#x>-mMZI&ETGV>EEzj{5~2-LiJ;FJzqBR(saf`Wa(+`Wowv
zjA6SIw3xSL?fMMJaSq1$Ig6a#{1*8=>fpWfehz5hy`A7aHph6cr4>DG3!7|mz#=c1
zTRJ(WkvGg4nR_R?HuK4~P9Jkr<Ti7VIm!H{-r*3-yk|_YtdISC@>a<^j^PH5+c`KF
z=Onvu(Ve&RKYu`<^lOo$>iu_J<vwyko(pAVQBJhGKRZzGkp5ZM*vE?g)=3Zlj5%T~
zGxoVNe&_BQxF#~e^_r~Tbv<2I^FMpyzHIhK8XWe`y?ett8R2hRV+>;5*w?yepEE+g
z_ALWi;F#Qt&)hh_-s8OY>Xo!#>`B^wBS(qX(DM#e=^c_Dcggj4ZJTT9IcI*kMy`{%
z4#|!+Sz&9)MB9a2uVyUh<&4{h=UnNT7x(H|j&tw+=`*p5K9)On>nc0ixaO5yf9sR9
zDYbR5U#Yr%IVStH{|4^&6YWXXt?<)+p^n==a}1-Lk+d&ta)T_Vt;accuf#Jip0VV!
zkJRmgcf~X4-SIwqr@UXD$;JMAK0GhtxtQ4X{lsD{u8s2;kn<VZqhH5RaV)j&I^O8l
z^Y-b(eqONddL}{N&%JRxU$9>EwT-MV9PGy5;9a>ed21YK{N0pTPOO*y2aKgpmFlZ7
z&>PslV{xoG{+wTyFLQDp`c3?8XZsag<df|GY5%FbO3c*Lzs7s&wXDBwvz_|C!=Rnm
z_7*HRaNUwYS$pMDmTFUf+6K0yp&QdRmL8~Y&~HVI`-5~nWPagbPpVJalzIND9GuI_
zrYtw;{LkUZivMRk<-so6Q_r%tCmmbGK1b=_I@_dFuN=zK_@9eR*uh1L^{#944wENl
z<eE;dIp!Sl%rJjYub=+^=YK!8cfH-GxGV0J>!V-o&wjH{rR50?I=;4P!6znhJJdb5
zJi&U`;eu^f!E!~Pq}o$|)-Bqfg5&!eoRjQ=<p#zzep36Xy7i8$IX~v=Juoks!#BD8
z#&^>_@*AgY*v$C@pHI$;HQKg+Fsv&ybUE&CFp=Nr)Lr)+8cg?|@r}Yl@8-^6BP+JE
zY<&mYHs6?jD>-k&ZyIyD&JC8|bH42Zn%{WdHPg2ZT;7JVd?P{&HgBP1qDv2%<+N#k
z!+PTx+y3l(!+p@*hcZUT<ydy<&-liZYX7`-dGGo^r4Eb#Psu1;{-0IL>iURnY&(dt
z;_Ylqu}{ge^)f=HZrK<UjCY9p8}zN%UN+o7UFHv@&y6-pZ4-Ks<FTy$g5#D0&U1qM
z<=WravlIK~-i_F|!(I)}*YvH&S!<lT?wgA<=zBb|e7twob1pajo=a(-QFEsCp516?
z*;t<C1p_92pMGd#pLw=7XInhyjz=lgrmy`j+8V=H&GFEO<Lus@xJ#e=MA<RuqrdGE
z%g)0XiRJWb)Z16~x2bdd%UIE;{Tg4Xt$}``-?7dyc(1wV=8FyH81v4BZhkY*!67%!
zjt^WI|NP%*d$a4e3I{#u{MI28cAzdD(l6T&+TQ4ABV|Gh9HT7g1<T1nmu!==+A?O!
z^igK}Z*oOn9qGFLyVzcgcfh_Kk8HSsYvMY&UK<*}Gx=Ln{@!%a{q0NU7p&87J<wL$
zXN-ftzqiTw1KZ#Bf{T2^`T;F4zRaK_CC5|8ls-SnY@f3FYO8VAV+}0V`oGb$zn^5r
zv!C&xQFc!!xWD3FFL2*){}&sXyxFpD;wP<0^~7@~p1Gu>SG3o1J>Q%2UKy01Sg%c)
zy5%<-_9us&^kia_r@fZbN7=()Ddsv^Frb0C(42V4jpoN2x!WA>yQzLh2KjWFSINtl
zyez{Ujm;da|E8TW63a57fj;JA<L>xIHNP9QH+P@N`Je9$-=4|0aq*qpd^dgb_?9_*
zOGVx9s6O5A731lV`;Fyzm37R1OOmD@eHh1hi?}l2^8McV9Y^|Ie`8^n4!#4nZ-Jm8
zCEp7x-$}le3TapBZ~F_zH1;W2)^7bS*yf4#7xcH?0pBIg%{d-$U44uAX7nx6Sd%BN
z(_)R?7uQYHYk8Kn-RPFn&$b;daVo}bQ1{s}t%7Cu#&Nn&EB1WEnC!<h**u4!w14}_
zxVE{EcKX;()E&z(KK(uS-L-qJpMIY+LmS89THG?09cS?(J&Owtc-FV)y_|pb%AmZ0
zi}cP+IDvO*{J^H}Lg!Aef@QHzpYa2YI>|n(bS%=r@#R>RIbLO=T`b$?fPL@aB6Dmh
zwPn4w12f)l7b)hk%F~v9{}Z{R&!6PPM_R%0R%%`Pf0O&A&x<X2*3U2fF2<1bqH8;a
z^ilRNq>uHvH-kNDf%*<E@=4Yytus!>RA$_4H}I)!%9Z<waY{Vv26)aqa}E4PdH=kN
z-pME4*9i^$4vD#;gZJ7TF@C`NZ;mq;n0L%2jhtn!ZRPth&^x)qd}dzS`qJjYf)?$M
zx#)qmj=yd6)89TP*ncbIbG*q#7w6-=oTGEyaKSZ^6&&O@%wMi$<}jt@Y8$Ng0_79!
zH!v5>mwe#fwHMq^{cV?Mt4zwqx1RwyzRnn(lXD#4{9TX1y10J1_O7jKJlq@iD82{o
z;q?0nJ;<_kJNEVHPdnSYU(;BzPxdA5)y3Ap{zM<gu^kU%`>d(+<XkuI_jt((=7C$V
zoDB5#KwBm2y*tT7mk!>e1-T!tt!vs@Kga3#ou}vAb-J+*1L>NaSg%|sr8et!aFODj
z$hBLsZlCz}0qTkC<+_UcqRzE*U8TdtmRQ#A+F#d~eU}c4vi25i{A7adjV<auY-u0Z
z8r1RRn6y>2ckoO&Ki5svwHs$eANK7S#Bn*k1-IbXYgxVeIKKmfv$O+sZPxWby`sIA
zTeS7wcqZNd1D=Jvquo14oj&?Ijs|u7gR*E>u0UN{puXUOV>#fsuW=t^uwTcrg4B1p
z>xVYdusMF~F4#tYW5^6PQnK99tDkk=3Gaw^=|blnA}eH;YhBvjq<%lKsh0sK?xt(+
z*qq0Rxj1I+j?eq+81+wD#4t{>(dCBB@;5miezyA!&il=8KjK+_^V9Y%M)e=~HE_<o
zFwsT3KD%JK@~pGXXH8jO&rXB+I7hDih;w243(vh?<$S3B#9Q0+KeSC6f7@4P{N2Bi
z$@TAlc>DjuH{0U>5^{dv6PI~9ckiZm)%)M$&S~3}MVo8q8ZFwiGNxxg{_kbNhWx*c
zWyjJ3+eiz)(TN}QfAE7WFYKdmX(KzBNXfGDzMy?V1N(L?pLJy}&L{U|mVH*&ZvBWk
z+s^jqfwrWh8(Y*R>rx(U;&|T3vA)%5%l1{SANr|&HKz6so3S=<&Yu6_J_qUxdaTEI
z%*{2jU7}y=-=scriTfMuf5%<^oLTcfm_rX}+ktvgZ4J9^hWDRy{rNuetvc}zIPp!t
zyor1Viti)weKP~!JHC6?gF(5{D9etwlv1=UFpjb9=YsEv&zr(`1!xoNrIrWf29D`Q
zJY$YPJ-O&&xj|<P{=aGSKdWy{>Joi!V7mj;7!lLBV!45Hv|f5(n+3KP^;*vODW84^
z|BRJ!wY{-k;#Zsc0Q=fsuudO+?bkk?U+$TE;dyECF3kPf*u}DSowMbe(6`Zy_s}Gt
z`W@Qv?F{F+eaguh_8fcW#rB`vOf2Jiu7`P>zB+u~WAyJB8hF-4-7)EByBv!#jc>o^
z`xD<qzrWr;rM4U6uz%Y&IK&a-^)KYuT#Lpy9j|R{KO#=XGET<QZ-H$FSk`~pzw5!6
zTI3RQ&H?k;1#{dcXI^uErwo2$ChU;v746daO+&K$lh45KNw%%+I&tMNjui}~I7Y`h
z3$?8NjoL=NJ;?f}{ad+yGpfE`zB6e{KV$CTA|>aTb3V*B*CN+v|HHUr&6T;H3q85$
z()s=A8<V;Njo;5kVf%a93)-Jlzs_%em0G86+YvORWdB*t`b}L$dn?%PNv(hC={sqc
zq)p%P7d-tpZRHt5Kd~SC>;?BG_iCWGz&+0WcJCMTg5^rBOFhq0%3aRcPx|ouz0k1b
znVp>L)T>Op@;7w+67$bbEb2v{)Kk9M27XCH-{d*-T{q{E|3<u%8hN^t6U~jy{79Zm
zCc5+>%PFsUH8}W~>+?HsiEAJBm8|I3Z^Mc{jb#k;xB1#{(T(rVF5gVQlM_ySFRi=5
zitp5?U3{xP->dkp&Byo5as$7)Bl_?=J)rqrF7LO)w|s%$^vkzh)U&+fo8OQp-T}S^
zzR{`6w@ZCjs9R^d1I9CUWtP6IPxODo`fRh&FF2P2z6YIezCT>c8SCiUj9??Bv#xT{
z<*6^~PQh~e*nSkU?EB)UJ#a6?ams=`2aWN%cXiyxwNJ;<d^dpl#cp2<{~hN@X<OUq
zH^H`_HNb8^_GiD%epxTq&V5(r`_4GVHpcS&#(O5;B+4B$&iN>JChtz#E_Kq&ee+%o
z?v?k``}M@T`-b=HfcHDGtgkUfVWW$7>)%)}_G+{J2pTeR{N8cNxm@aPd%#?<f5FAa
zd}0nUpP0wYXR;rpy~>Wyzk@N}+Bt^AG0FHs)>m15tNp2;(vNzM<!QIwc;U_NT0W_J
zFsXl1>(#Aq;2!2)DiiJ2Ke62|Se6#pPBKo)wCkt;hWkL9b^3PLoHNf{2k%+~?_#~1
z>ODBzU+?gZeBhlnf2_d#kfiNR>NChI<`?sb-;);K6!VEW!#tDuDq||OnNMun%ulul
z^#KcR(DD1^9@^NSZEuh<SB(82#X0T3c{*R`?HafiJGe;6veNQk4Nu8YuB~NRLDo;|
zWEac}!}|{x+@}fdnWU~vw2S2qwtKd>E~!2ZU;B3)b&P|tI-lmeVxL{V2CnG@*V?uJ
zd;=o?_sIVTDY>uiv3|>MMeLdF-6LbJ*cYYo-NO;_>mF;@f3jEIv&i@yzjGSpym#)p
zcl$hO<SWr`eFyJ}cS9-KtV_}-{RTeLf)i`&x)1k^@wjfEF*29KoLvXs7X#V@ZIw;=
z8<#r2ub+6Xd93GTO|N?q>t@-0tygx+)o0;%0{6iEbX`a6Lw9|Hi)}@n^;K__-`K=6
zu6;PBP5<H;B+C~)Nt<#84Jno{IPT|IFJs8DDsy}}u0ehJOzJCn-}A0}-#_Ona)9-6
zXjjP?X-mHm?JiP`bzpmsAaj8CYg(qxHpVfgvPF!Iv`%{uoQJFjIlpXg4E1bh*}ifd
zjlPXP@yVF_TGrRP9J}MZF?Mr==i7W??pU68&cAn{-Un^g>64_de%_zNa^4}^$pmfk
z=C4gQJnw7X+c&ANT-qg1+n~;V9YbPS8g-)2h8tvzXKd@Wt>7Rt2mP(IZIba)rag0;
z<r;sI^PZ${#!$Y+(Uv|P-8tplElbuP^jWY@{{;<P&mL^#z-GOEwmUE6IF;WR)Kxa+
zCl{Oam;Vv0Vms(b<9`sz{PKT`jr|+8X<&TE)4(~p9<GIV!tdATJ|RCk_Rl)d#`ZP#
zr7ZbBn8p8H<iPCzVk4#f^WUVcW7k*IWj?U((<fv7><{De-pl6>yGM*|JmO^Bh21e4
zV?qnmpIG;1(_ZT~<wU#vcgQ_ey2eSZQy1$F%!qZ7&Y_}Bb}*4ovhGrsZJl$HHl;pd
zo79!n=jo^K8<%yL&Rmn_ybA|i($>+FZ*8+arG5h@XLNX1Iirg+FhH65<veVdK|>zC
z6P7RNuhcg9_H@51e76qog6-Rb?|Fy8`=t3!;XNZ0I$Yj48;0+l;PC!Q(q{cGEcC=W
zv209ZXZ-ZJ)FtV2@N-N#uGF(^jPx1!?Lb``7;6xFGUg69{(m))(!Q{;>u<YVuq-{e
z_*K%b)NULZ&>m>BPHvFx=Sv^ys~pj;+TL{iq`i=JDObciNc(r)TtC;buBq$pURih4
zsrMXR&y(lM_mOWH&s&^D&*6c_Ii7*KwguMr(6v|evCeb6p~ZP##J;|#z_VS^_Ox5R
z;9W3|aW{Q=zs?sHc761<|Ll7@FEEz2w0Fw(G3>|p8@Lwg+V#8Od@9;xf5Ey%n_0&D
z$qkW<8aefvTg_YMJacNN4IJqI&^Fk}O8%ztO{Q<QSEkK2qmVJOUf&*^7|TMA7aX%V
z{>r4BRQoqQeV?)sCvlx*{SV1F#(nm;%RDZ+)OouOav;~p_1ZzMrR%#27hU|F%HOLF
z<ZoEd-?p-x_4@uq`c-L+EN9ypeOH-v>1(@6+S5;&?bDV%Rc76vWVRWPel73d7Crs4
zuF9-y_)CtnGv-|X+>^mxNCWrIJ?wD$zxH<^bN}m^NImQRB%l6Sev`AD$A&I>R-fm-
z+N-{PxEr0i#Jp2U`%~((VFV3%;;p2dfp4D$E!ez)q?XNn=4|tGMcX%QQ)5}~VEYlM
zCnsX*XWx!VjG>R;D08?uyMg(An&->=%Ky8xz;EO%SeC5US9VD4*86>3@eNjLOFw;P
z_zdbc-(#7D!?)UR`Snc#yWn@e1%CG>-vQs`z(?NdPsC7W+^4KQsi)6dyBXuX$i+OI
zPmg)J9?swOSiC(NYyWwF_y&Q&w^#W@`|`UCexs{Yw{C#3CbYo!js0}E^tr*l-IETv
zPws_SPAs=TT^88R_Qo-$@kL$Rv<^S_)VaF`;u_dqAIEoL$2hb7rq0;*(d>_Qu4k^Z
z@r*xh%R2ae*)Mp$S8zS+FrdNHUz>FoCila8GGG@hSFF21=WbQfuFrr5hqx7Oi9Q={
z!FZNy+=Z=Tz3pT`3!eR0f5BL`KhVet<_U8{<x-Xrx#J-H8_!&~3+BS4+N+=XZ|V3Z
z_L;00N0kGc<XE55y6Ug4?a9+_IXUQWWc}aB@#y<G-pzW?K>f+ZmRL7~hLkLCbg|sP
zeRjVS%SqN}`Ar&U2Nx;M#kuF4(mts(MhDN@0MB6u@0Itffp>4h;oGy|a)<o}We)4+
zH!wH6k@YM5($_pP;6$$LAuVgSUSHcCX!My_wqD<5Zh}pY5%mGu<$|#%=-+7f#)v+R
zoBi6KbKP)ZFn`yf$C|h<$wqg*7Py8pP|r2JQLmJ&)AvA&eQ+-}+`v6rfqPa-d&iz+
zJEgV*js14dE7}%y`VDXlj%z>*xni7-QLJ~)pEYr<SX0;AweP`<y>R`lcfDQT8*A(O
z{%>B+?b?=92dsQL4En=)5DK9X3ZW1Rp?J>KlCNB@wfE`v9sZa@AcPR&RcGzdE!KCm
z*)9!SC)X|g>QCQ?_eCsksQ&e{^vOCIdviX_Z8JyrevfnDS&$Q0)<)YNWWOG^O8NN0
z*1TymOCS51N5?g1o)u#<PTy6(Ee5n8zf0a^+N88!vME=3yw#s~mT?C8nI$*ov4MHB
zZ5vD2WiGX^`OI^ooX`u_U8CXL9;i$GrJQWa4eV<?BVuyQBxA^WO7$I#bp_Vd>qmd5
z#IzVkM!~Tw*|x&=BHfP%@~n5(&ovaw?kn3y(2&}TWy!Xb7hU$Xtgpt|x!xO`CC}Un
z+&A6xMcXN3>Z?H=Yg5;sQoZpz7p3(PZMIM9+q_2(-2>**+zsrtF)n4(N91-zdqeLW
zv`MU2)aSfToIU4Oaem^wou^n<SM3({`#@dV)OL0HNH*o9g%8i^@D3>C`L!*XlqKuh
zi2ZiqQcm(-$a=N2JfML-`-2?Ic5U;nIovaiZ>!(XPFB!MIooQx<@7n@J8vW9{zBSK
z>>8xsj?ZLKR{tdJt6tj<mwAuKkNL=)s52+FYbW+e4(00CvP{?yF7+q*`+#yiIR0kv
zAb)3={3ap$fxmq`b#L|jo#da$f$z$*Z?-M$F7*C4mTfa$=Wh<puV=<H;`!*-Bgf`+
zVrNb|eHwjN@t1!8sWcAJ*MJ7*#<)J?L|MJ<E2QN&F80~KQU1n!X{+mM`vu2457fy3
zZK^NJvf+X@+8%hzje6UYL0M{F+s*@Z+NJ#8W!7kY;h;~_W}v&Q?GyEHXt&)9a6E(T
zk;7hD-mTp2hxcjthH>YM<>i|N)4Lx#Z7+21V5GWEo3@ia$2SMAZxtNgoy8k9d2<%;
zPlL@H)qU^%R`HvK@0?wjlp7qrht><~ZMV<S2R=Lg9pl6p>EAK5v0j<fWk0yo^|wG@
zmbKH*jWLzhYk$X3pD|y4!`d(c%j%quHfd+Q{~`AOW@}qgZJvD`PpXaO)W6B|(rzDp
z?_h*fC$?7>^#kpZL-ST?u^#5#{BQS-`-gqxesW*AzZ!dO#~yWmx(D6E?nfC9QvYVN
zu&q4%T5m6;-KEX*;8|+kyRgCYl~^A^LnbrMk-m)0c_cIDlzPvYbFSRT!74de_{x~{
zZ(Nn<nEH2o`)Id_Z*o6)R~+t=?K{eS*txSdw2nP2xZvL_W^j<=-!m%yjblGhCk^bA
zK9ttQHf?snx-`&6`wqAN%|gm}(5QdIdHoY6_HT6bl|$aXVNQP{`=!4+-i~;`&8N<N
zG4C6gCoyMoz&s}Ab;AY!UX?7$PqOWsO#5%`j#1IBj%)t|`FFIGGybk--FDIT8)@^D
z>90y{YQ2`Hf6IHYsow|cQeUOz2@Nuq#dsZd<Xt&}hID;gryktSJYfV4>0WSe^uV(0
zU$AfXueRU%s!uv)$vyff^4ne?err9r+&O=W_tS*-z`JV&9qIQ^;@y@E%FVluJ5MaD
zyI?<k9H{=SC+Z!)qR#dO`q5wd_ioK`8hTOJ!Mk^R2giHhy*{|(yKf$EUytvp!JC*|
z-bmlc7T-UMceA2i8{bi}pY<KsuKnlRhxa$%W8dN@**5+Dfewo|-FMyheFhzw<TpXe
z)GKGf_EmVZuYJFj?U!x(-v#585iH~d=iz(~4CdX*$0sl3YR9+7^4lXANY}$Qu`CO2
zU^y9-rNP9$!`oWSvM#QV^+PPi<NE9e#wrbr{U@BCba3A0Aai4$5_Ps|>%MTm7_+g9
z^SI!ioS;;9%vJ0q<Gf(}_SMdPT)$m9d;7S*`Tl4yDKBgqXfG%FU36)CvGshMFEq|i
zWm11boAjZ-C$^=oN7+8<Yg3l{V8nM`O53%Yg+^Kb&c%5<=gnN5=Qba-+y8*~g7?D?
z^3G5WSa6|p*UWM+dH;A1Rn%3q|3;_n8;(~ohBpTKq*1P<KIIDAl&SwFwUhfowtbV&
zKH7~J8oDI&?^-0OOZl`-ecE^WChB&<y7V7No2T6L$+4BAka}(G*TH?|{<`cl_nQ0M
zedif-Ke`VW3~1n4?4C!?`2x@T<y==b^`z=8tDgnyPi#+}{vGFlV<*O-Ub_Z8?i}x(
z%B3#0%L<wG)Tuw9uL&3G*p62*4)bANR?x|pc{6``PbfXx;|1-+cJqF~HINBAxJcJX
zR&bD#b#1h7!HoJS_O7?<o>-Ukqpd#ds~=;kaoHvpv{hO+?hekw`83GAV}8t2Vy<pr
zd6P%ic9U=OUvW)b%LX&vKHtBJdO0v+tv~(n=XyDYYhrw#Se+wtz6I+O8g$x+^MmW$
zioIvaera#p0{dty8yxGi7nql^7~AJvj(4{4uAcIJQ@?e7E88#8k4)HwOWAkZxBc^W
z#~ZwmJKlZYe#--$`fiLRf3AbEcetT{O53#a%)BwsyRJ%Upndvuz0A!FjG=N%+{XCC
zcKc@BGh%VfTd?lfj=LCBdl_)Sn6i&|iu<v#cifxzfw~zqq}b<;^rQWT8(5YZ(mm>V
zS)3d9&I~LMb+p;nJ_B3pAAQ(eY_|PrOFN}#Z$INR2kT|-7yZ-*+XMEoZv6J^Asf0I
zcG_xZeZzznSiVr>Y;iU`A7cFwzjHKxSs~R;7}#9!jL8YIuIzz6wNIZ7U(RI{hZw8z
zs2`vd^QK<g6<Ds=uHC}kxLS;5Y{?GYKsGQAZI$Y5H`W^aiTQZ%%)q<lf_Kd-9Lo6(
zmfvYvPpQpMq+QDS_~zTx->Bb>ma9$r=<$u1<F68XmTgPBl+}LF?%d5mD@@Aj^^^9>
z^r4)E9rJj`{j3k>Qd!jR3!UF2<`)inY5WHAWTUT4>Kz;>W4y#_4C-vtUOxj?aFKsX
z@AxT9$|taFn|>W<f@3NhIvHTQcG_1C^*5@`v)t(;H+(zpF~_k+O6P72w&nQ7@Wi(E
zz&=v-+C5pt-=&;!eUp=zCEM+jK1M00&h{kxq)h!&W_y+MF>cmV9^1*;lO6d?ne82Y
zQqNA7vrVaP!2r*j=dO9~xTn0oyw7gjo8E~x?n~vQK4`N&?>+B9@ecIv{M@77#rYQb
z9tXa`;v1z@@7wGf-F&0t+rT%!`R?=Wa`?WfsIyI*Pe0!~#_~P#4N&$#z3*O**BNh@
zu^iL-4YJMe4Zl$wV}ajLerNgp)xdAF{D!kU(fK{5O~=+4l^M7C0ov>@=tEi|zX7YX
zUArAzWRhcK{U^Dj|3p5?wv@MwVcBtH!6{f*pZ#X|wyxgxCkLIm%DkC7*Vnw)?>_g6
z>o{S9-zz89{j%PR{psFwkM5U!n)}-QYrA$m@H@c%GD23Jdh7OakGtP}=Y88fKeB_Y
zH|mn_f0c`V(&6H3!+78rHRk5Hf$<x=u{!shzcEVA%XsZ`!Sm@D7aaSP7}Pt~!cNkD
zqu0(kd0$NKkG#hlcj1ovaCP+Hz19B04mR9E{+%P`^6wpA&?fupCsCLE{5y*1L!FE-
z{p>%3hLjWWDp#RXmb}NE<4+9QlScU)hxaR)l)uqwdn4^n_;DP^-7j2pPjX&$t|#WL
zOw7#;Hu47M)*PP)>Yh}aXIs{*&9}1aJN<hZ_;<95I@_fGfbIJWwk2;ijyL{*h0TTf
z|4RK<)=v8o<haJs!CaW50hxQ(L1xg9C)R8sJGkDt7Y5}gw%r%hC(riOzsd13Mnm@`
z_p8!9+#je*YTNbuF{t`1XWLUQ`Xqz0v|yL-C-1WS9`c*$$%=0zrFQn!*9t5@Y3Q_5
zitVYJkMYv~<!+T-r1!0NwD+&~a`RsH{o$_n&GYTM@eV2z-^Bq9{JxstH&0^SHv4aU
z<@=#e^~>)ezI#r*zXK`0#mdXuyaUV6cH0{G#`~R+-vMuOM7wtV@m*luJ`JYdR}Y@w
zL)wkNesY8A`{393CK#*S7jn*i1DX%N4>ND(Dlw0jylohPWw|e?AJE{$x|nkrg+|$N
z-<aro;XKyIxixUEvcOzqUQ!NpEvWg-a<*yT@u6SGHBR@D^KkyHe1CNIsQb$N*nVRk
z#wgCmy||q}Hrl$c8{a8@tH`0QE`1Gbw7X$zd)i;@{a!iHIVTl$PqN)JwST~NZEOF9
zzX3|y?C*Eef*W+dl?r}4J+Zw*_EGAiDe?W8C;2hQ7x~ErV`*dG#@#Rq-W$oK+_|s3
zTTY>I_jvz!H_3e=+a_(_XtX`4<7C<KpLBGIaaK~FeX^eNo8I=EbK3qU^_4amL)L$i
zZ~b;zhf&r+efoZrw#z8AQnu{|8B^AkwpRxAifuQ@{#Dwh&432(QTL>K%zf?tb}w$u
zmuKyH9vf$Ia(+Gk;y(TCRrhN!N;%upRvX*ju&r{b+wZ_AcfqD?J!8?%ehoZ3-ZS4g
z+)J`x1eWE1{Wc7I>DTdR#9$m1$2X1*<|*%{N#10KwA=#kFsXIR8@yu<Ox7UpnBm<3
zx8QmuwrQh%_OskVZ$E7(9B|Dm>csXA`b%nG+Y)ULy!laYdk6hAFs=^H%{flyYQD^y
z`Rw5OneztbUnaOF1AIRwv>@NUd|%XSb3uFi*<XKG-;CwBpIC@(kca((`o#7Nd44P>
zwhd_DoO9mh%y~P`XHDH7#$jB3Z^XO1`L6kI;9EUjSm@+}Z@AwBoAFn?#pb9Jm$8}m
zWsabMx*1p&^|h^|TlmnAQq-lbz82iTvJ7Z2u|4#0y<E2m<|xT^O=;Y3*lyno`qQue
z9qSgX+cvbpHhnpseS7q?&x~{4T)W^R-&p7eG|0VN$F=PKu0FN5-+e*7?JcDB`M5Ji
z+!wvv7nl9!zLQUxw$J`6w%S(~^(P0NdsiQ_L7l!Dyxm{MmuNHKLXYtrLmv%aGyEFo
z0q=>#`T)n&*8V&EDXr_rcI{TddU9ioiPYYH#$@a@&h+V6+E)7<x6x0sZ^uWXE`2zT
zeq>R;^cm4l`^!2ivyV2~I;LcKQ@)V%JIrg6qYd6Q3odvk%^x_l{R#O^H~79wHs#8t
z{zkRQ@+jYlj{hyj8e1!UEN7d2v#d-z$JhnyPg?j<Zn#0`-{s#}v?bcu$Nt7)-lazz
zwjFHp_lwPM89$MB4ZDi^3-vdZ#cwI+1@+n~<pll)Boj9H8<C7JtfIGE>)-k`>}2D=
z^3+Y*jm!8($gDfpLEg-xd)mG2*>`V$bmVqNUU%d~KX2$evHd`2Y{&mo_G2#gOI?<g
zKhbIb4f|`8(z5ZsVO!d2|74>xhl%-mBio;{VK1I1_qDjEZ|v_@*2X)?yJ&*<Ti$8j
zYnIh{UuoxB$^z?R-St&kZ`gkN#eJCXoNuG}Ru0&_#lF?P$w}6I<3+u?WK*`Ues;NQ
zCu4oyQ1q+#&VHSK`dh_s>Qe9bf!_&!Yxv#J;qooj{9T0aD!;QD{PaCHXxHxkg8q`U
zwV#X!slUZ%_EpZ{l(IV8?34Wm<rY{@QdecpvFa?3(tlCD;5ZfaX;=NI6WfzZS&Y{_
z4>0HE-?i8<Vjtw%AJ><4c3<5ezMI^G$#}fc?iKrr<py1!?k)C83v$d)8#eAUeR@{h
z^PVH`G|yF@uR&S8_uT~T#PjiFp_2jEa|0XnpR!TzoWY!f-xkt{qf+(SO15vx`7NSf
z$2*X5S$9m&x>&x}(K{FC=N;lb<D1#Ix9i<q?`7|<_7}FWg3jMMWEKwP#@|CK>O{K^
zm;OomvTmC;CrBUG)%PI#DzpEfEDd)550i4zDZky@i~GDXs3(`4B<4ougVg`2eD=?}
z{VzCn#&cfY8t0MZ+%`Jr{$!w&6<lQI@t;c9K<t<0lm}g|*P9&d3E9CdWp%bm`-QaI
zrBCW=Uv=6fm$G#K-uEEeYP)~yJB4RG+thck?+ymCfjJR#)WO_KuEn6-g59x$9^|^`
zK6sO9^OSG4srzQz*=H5^;j^wzc41JK_5*%v|JJU}8}>{6#HPdLzFOeDB`wJMqMlsJ
z_Ic~4O}1sb_KEEST4BdG*Yf_1x1b?qmb!QB@-7DN+zrjUmwULwihJC*r-RaaU43F*
z{fW2C_i+Z6WzhC%$5y}kzxqJ$yVrSVM|}TG-rq`o3n|r~c%QZRjsCpT(bxCew|w)a
zOD+4(C$(K0^&R{+7~r?V3>vbce!~UrPhfxj$Oiq&2rlwDheq6W9_GPsLf`&QURvbu
zMh=z9j<%<q=v%>WmSv9N;#WT37RXU(lpT8p#v+#(zp*2J=is`yKF)E)+|5IW%&R%8
zn8zgb=0EeAxip9Rbqr%MZs+NqbpLJSrGC*b+KnUgZ69^c?UMuSavu-++CP2h$F>gc
zSFx;Kn*|qU>|xK!C}&2!`&%1r)86_UX)|cAH0p`^3;K2}&#Gs(p5@J%mir57r<~9p
zsQbpIZE&A>r^pHX_DuXv^X`#)A9+6|i}E+p=1sP8zggBMbvdTvzwul9Tc4+{<J&na
zpJXnc@;AF|pC#_prTo_R9IMu|@0+Z4E7tNUtBvKSpW6QHYd!nC#culm_frG+@{V(K
z%K35sd+zcq`c`<xx92xxmK*iF=e+9@bx*QQ*&jUHtRHZ^3&xQ5g5~juNn87L*m1Y!
zz3TlV(|ZWK$DXLS-9Gle-e>sIuX8kx9kCdX<*XZvF&!{xGJ~uuZ5M4vU|F5^8@zK)
z+&P;y@t#Y(gVqZdop;j=4pLm>@eA5W_R)vslv%c(sMGI;`+|Dgwd-Ka%@~=_ioMmC
zYc~hv(Hy&O=6t}3b@J^P&<dM3MSN$ntc|u8T*q8X{Ve=7#xT#0{fQ-F_B==rEFWm)
zPRMhl&bEs79h`5|Cv$YoTtnyfnG-P`-ca9TzgK)~eRoH}dgW4oQrj(Od&g%b-|xnF
z|JNICj>w1mHus$CU~Vot^E6`}%$v62Jk)2~KsU+liF|L$>Z<L*{)zoNENolx;riXO
zp1H11Ib+>Z+J3>cHy(Ws(El5@8LRg8t$vI_A6Fmb!Sypo=11m()N7M0${oz*j(nO^
z^PrRwY~+1l-^4a;wbQTTf6k6)D9*d*OWb>&H|3MmKhL83)bn`QtM1p2{}|u#4&)qD
zYO~>jePo4Hm->TF|DJhcoj=5Bd>bx!mMZFOYqmL0=Z)VSJEbwGpWwKXW&4c4a<+AB
zM7zqSp7u)XwmXJ%Z-HgUKQXq_dfJ%34w=h~y?*q0gN3x-f*eb`M4dL;-oRX#(?MR$
zkvTho_tf+L+UTBKbmF(%KVf12#wq$vS>KL1paquI-G4y(s(sY0FWB~MKj^-(Ui{c!
zjMcoFXLEjBC(7#VH~p<4@HdXiqW;G5_lgJgca+KREc=D0zIDcf6<lQh>u)AfPLTB~
zv+Xxo`((MtI8S+rK^6>XVB8&?v-ucc&dgnd%>N;u*0(xr?2~;hSJdyoF~spIi~2vM
z_OIpk@Lk(#S-T|Tt1{cN&-xcJHu5z7A@)g*dm1M6AGq#uXt3Gy(=*`S=Nu@lZ?OGI
z>IZFNyM4UB8g%ZoC)c|Z8XWG*4x9UP1PwWT3w=ui%N?D1If3OHHpg!h-*w)1rS;Am
zFRQd|-~XT?kKYx6W!tn7%N^a}8|(7@HG+nGV%r73#k6nn`;29Ee?rGD(O06*{wGM^
z%GBB3!9EKHG<beb{#2iQZ+1BU<Ns!%lWfygUykE=atqc6v<K>JyI{P=?>vUz&cQ{>
zC->yvwQvom-)ylL+%N7O_mF#Ozy<f)@m-BK)V;XD`a-{B->tIG{1)7SWyd(M*<X%x
zwRNA;x9NwoQTP60-%FkW+a`F12GkggBhgo4%wmkv3(jjq+{R)|HLkZD*x!DMJ{{M1
zj7vPLm8af0$Oh-;J>s3zxw{Wc?(gkg&mFzsK<|GuksI1yw8Mf6{{6$hgUBiPcar+I
z65G;F*}?u#)F;{{se9V5h$ZEqo;1p`i94B;lTO(=K5_2JpqyOazz5m(Cf64~Z?@{H
z{h^*1r)1p99poIxU;ml+in8*baIt@qc~|CID9?jj@05e}|3=y<^^?-FzLRXL_9OhJ
zPMaik+U(#Wzv18a{5#))_CNnm)QRm$r!46&$7qaU3==wJ&PQ1j%dN2c-)lILJ;?P|
zt}j%ZYB#X2)P0)zRrb`0vbtnYuKjl02UQO5hoB)7?~jUl>)D=iy!6esl<8+ae5zL`
z9WHm5SWf++oTNWx)n$2xpZ<{gT+qPptrKs7_h#OqjdI?vtGo%@J2~(zINZ}Rp+nx^
zmep(X#Qy5+qy2gz{b-YRzMq{p&Ue-K)pvIMf;Jsn?Gx+v^ZUs+JKt{0Ss%RT?S&oR
zEr;)cCw?D%z7e9$?}ia*Yukh!=-+W<1s7=yGdRc=b964Z%%_nDbJ6{#^xHDt|HXUz
z6Zszdy)ePP;y1(s{fXZe$)-G@1&16~)Y~q*V7)=wF8XzFE(01kN9Sw~8knQZtvURO
z%&R%IuMAkAPko!SPfX0wJ+$GFBj;-@7hC%~uIR(QwrQiSeH#08#9qz)xu~n3w2OAy
z*zUePk27FhY|~~z1N(_(bv^9r*|FcVuHD5x(Qn#q&e(<Sw-b1d4|ujE&$@EM1;3kQ
zg|w_*w0UEqZw2eAbIcKE-B^vyxQt_C=Qw_+c@KFXC4;i82dS&l@{@*6cKB5$j#W`#
z>$TizlS7=9)Tf+br_6G;)qYvFEz5r@)1Pv}exUA+j{Zp<GuyK7e)!4u+UKY8B3H?v
zoTTnVF4J$0`;@lZ=f-|=&$ypk*-!3!&&vSM&x8)1S?@XTxa3B8A{%_pw&(kSZMA*T
zF8zgUtMXvy7>;io#$#NGb+K*1#a4U!b?~mL_vVZ{(|b%-!MgX9HV3?G?W>Oq`qQuT
zag6;yT~gcBwHMTDcft7?zw>ZD&Tj`7>6*AUa=`O1(>nlM#}O>#eb8C&8MyXI>Z;5(
zrTQM|Q{Rbo+q97bE$*%nQe6l8G%#M{b`CPYc{VT)4eGkN4z7pmG+^_VOy83S>TJ^{
z*Rj*ja@O_bI-2uOZi&OVJrkaz_BgB0Gqh>1*xsOfE<IPypE)`w*K)d77;h1S@%fH^
z-d5g4-{Jlbx$(Qp=eL(qww`FCU*B@y-@%xUeTZQZi}^Lr#%IpW!v$kjPOxpnI@m`p
zI3IC+26gkRUuAo-(N6mVj=KYWTTeeT{FtW!mw06toI}zmC#l=$ZlI5h%h)nbb+$>`
zDzmN+QD;oXXUv|-7P&D$74@Qxc}qHFx%AKZI%lyi`-O{6ACB?aM{!21pYWOewA1Eu
zuH1X<!To~!JN1KdgFKfb&g3fV?>NTMz_pvPhL+Wh2b;QF==8P!CSHAd-W}tDV;aW=
z-y+Xkp1UloPqNK(mZ<BXALrqj>!5$fY2f|h*yctKY<0GUeU<jLO$Id3-q@wvH+(7e
zmwL<UF7tKH&3Q9_^N{&aXS;U#vTtHt{Rki0$%Y9n%G%h+*pf{>QMbT+m>2US=4yd?
z^RCJ~Zpw0l=Qm%iukuZ(z5OP%f;#(X`-W|Dv3p|Q#I}yzld4}|#;E%9Vx#USYJba5
zTXj9i_EvsR*pzQ!@LR$Pj=w8>q4QgcOxQu|<Tn_|%Azhe=zn1vOr#uW{@xYktgHLR
zpzTT8RzI~oV?1StOH2y}v@bl{oU?Q9V2+fcuCl48Pknr2(e@MH`u(PFkNKqi`Z8X&
zE8lD`dZ}$c>CCST_F#K(I5$6$_V!IS<s@}aneEDKYm|Q)tF}$gGk6Cz@1eM>XWV1Q
z`wx0x-L@UrcDMrv_i2OU8w104$#0Ot@jIfhC~v<7c+Wd5-*xIAJ^l32Kpz8J+nViR
zt31(1KiVAau-~AxuHN=%-|8pJ9e?8QB$e&AA&f$!EGK?T>Bz)yJ2?;1zV@|`-<u8m
zPMlxpemg?`o$pVie;1UrO&`knU{f~+8L$G&>JsZ0jNAF;Tv85lVm@cA$!GoC5AF;0
zi0`KFse7u$KDx-ny)}b|bdPP{SNbjb=U#KaS(XJCv}wN8;omVtANm@8U-0g_*Tpw@
z2I>>ffwsnBzY{+6WBG~t4vss(7{v018|7|%#OWE?VB8sVwY87vv&L<_lCft!b?OJK
z;37TWo_X&D?}!VFcd&7nPq;9+yBC~bcE*9heRiSq_DtU^-zWY?BBQV=zoAV7``N#P
z{*pymtlK8qN!HUgrS?w-x;Gm7WcR=4G?CH+=WJPN4if9B%kochmA+XX=$>So@&t}=
zOtK3Z`}pfW^IMcFmwJ-=QEakJX--pGHqXhSTyfpra836Eb(I!<^_TvivW`{D*|++u
z<^34j`h6k)*5}^?C+r96Y&-FH!Tg(GmFaij-xxcXzXjt#qb|Fw-=v&$%93mTC-SY2
z`$k6K`At%nHYrc^$@=)xUq3sT$OebIBJtkHveNb^_IvWQd8?<t>VGoEpHTbMvg2f3
zKRx)|fpH&tCnk-uZ0^hHy&3nYcj}FIq9K>>NWprd{_<wLv3-Nen=<3gSn)nIr0>Dt
zUGU%YH@;(9e9J7pWqSFZ@tY<YzPGRo+8(g~e4svkWnX23`SJ~PdDmruZ@jdBf&EtD
zQcm*wOKA*pz_>Q#e4NXL<@aH{rRL1{^nmZIn9C$}wre-w(sx4hEykCO$or0bHKe&(
z1?%c%!iG-21Nzgi{&SpN#<<bPzSVEXr*m|!&bxzo8bL#DzPBbQMV;*z>|@^x#;SkE
za&E?BEGMvTyxN)H6}~$@7vFY%<0-8>j<Fcua*p^I@onP%6~9w1y4=UMTUKXV+NG^J
zv0b|cu9LovGqLWvZ5ZLJ#rgRr^L%Cdj<e{w%rjbLp4V*meEU7+dH38uQU8X0CY&;k
zJ{{k=I;YKgxJI9RlG8@{kk{$@I6v$i&$}n@qAEwZt9~liK9;@Dl5ETRH#y@D?8wR?
zK3NY^pYqw~H+%bOGah6=+mq_s@(ecepJLx$$T6OBMSM>=O1!q!x@C1w4mzphzLmAH
z?*R9gd+W1D*i+|mhCCmhBk{b{^EB9dp85U2eJ2gPyAtc!wkeDC25IA6P)U82_POBR
z&$Db?k}-D5wrMk9$2cATpYsy;<n)|?_t58#<Lr2Tl0{j)?I-XK9B@H@#%4^8A(mUP
zVm{g>>JFrh(mt}`f-xt~;XuyuPo#Np&0N0=-W9H`_t${+1>3ZFvgteZfiL~)-#C<s
zbz^l7EwJo7j9)wBS)d=WJm7{OeTeq@vak8jpZPQQu8Hg8+w>&wz?9j(<6a!}v;Pfp
zT{nIm!!eD?{0z>9=fv~UILpe!dNL`?4lFmY@5M(0&zCuM9h_@}I<L?8#NZw?Hsdt*
z6K}EarA%mW;w`=WzB2rc<p*rn&bQb8`ZNb4_V0}SIGFz@CSwEhaAJL25A$>BBlb!A
z9&2RXeJ$GlhW3fJ_Uo|l-yDNnxIX6N6ECuXYxxaxCg0lC>m#wQz4U_m3j^B&#`1}a
zINc-e(H(hGChC($S<Ib%GEY0^opYWgXXfLAwuya3UmGrXX2iOB`<Or1W`MDN@<~7K
zJ-fp_4W4D!RlWU1U+T1TpK7Q4^iz+`(HG-v7%#Ml!Ev3F^oYs0EUVK_AI`7g_d<{O
zKIeq<;<>2|>NDOcZ4PX7o-xl_o;lBFo;&+A&^G(7n49yntS{TNtJtU3tDhTv^&t&1
zPv*$n<lJ-4hk2{N;96?u+?Cd)gY6r%RjS|E<@)3rZSp0K+d~@5HI|r@vOmbS6Z6~5
z`$CVrnZL~ECa)LjH{s&DFRA)0YcKY#WV?OO7i`lmeJHIb&${+c4!XoP%gQI}pJ?;c
z{Yl+^m1iG+AMkeq+2HR7qp&E;4LZN0R1Wpl>GNPymka%`zgfs{9NLn`Z%+SB(ywww
zEFF0xzA6{G0h@W9n0w}6P&ZGm^#=2Lshbb&rO~&dum2x7X2vjyL$a>?)0h^1<o<xU
zt4!)o4!ZvhxjN>nU_EK%@lTl8RW|h}_o36iy^v#f;*iVTvSE0~1c$q42A4Z&z~l})
z+-WNqMPA;b2FrKDyAcL7INX;VE_bbRf_iN(boyk!5%$^+*t}2EHwspKb8O%J@~vQ5
z-G$-z035JSMV;;1*+*J%_@+n}<wTt})m~kP&+jn)76UCfe8(;54=&$$$);Qx)RRV8
z4&Q|ndg1c7J@IdRqe#n%ZGXbWu9D+8=97a?GPaZ>VpYn9`@lSy8}nrj&A;p5nzmSD
z*V;YeUO4Q9>32=+C+mrOqzBrHI``d%+>h>0%Zc^WDLebPv7g=7vcUTGjSegibWhSw
zA9BLCQl9!7b8!yOIBiq!p7%^-4kr4HvyL$yvG+Ki%EU8!z;o<*mJJtH+&kV28!im)
z@Z&x1{SF%%cjkZvy`zT%jeBhrHsuTcon*oB?c#4IGJhfM>|<Z)fj-lB`nN6Zp0f7S
zUe*f(UD7Da?tjm3B0C)BEY7_$9(8SgBKz7eNnOg+D^sUD1!Jlh=Z1`b{Pp*oR>-VB
zrR^8Y)qHTMSH899nkmN@cF}96-|DYZPt+gKE*Yi2<z2XxpV<D?S<k=gE&kqj0{{M(
z`1e4uZo76J?5odYP?iS9YV79G{I+2Czt^P7iS9{9Csm)iy5_a)eyG$o%e5`b1ATHi
z&sk2nqF>gP+KK01vYxt$u7P(&vM491(?+yUtZV0;(;&Y;l-AYv@T+Z-KJ9D!4O?X`
z+y5JbHfe=AewJr^3-uT2-TApck>iDiF4=J>pLkbpyeF-^6`gzByMMzdG|H3rz;`X*
zgvHx<c`HBfrEg|nJ#|^$=)}76!l8eDZ|QUM&UD`z^!iRljANff9}PP1^)BB@`R(KP
zkL6ldS6S4PK{-j?4g2(ya{9gS;86El%vhG+am41_oL47r`No<@vHoP1{5JYY&53z%
z-ZSRz{KapU#Idt%o3<P5Yd(!hzboQ$%p6x;j;UQQYhnNNaVXoi!`Fy@_R+?1yE%wl
zSii7JKl|JgL(PTpEZZC(KcBqwt@inj<6CdT1?#flfZuZ)KI`V#jOQ5c<6GF2MV<Ry
zR&bDsx(?blFs>eJWPBOFv5&CPPOR_1az*_G{X3TDZ-d`+3p}5GD|ue?%w{>|rA@M)
zGWGQ?ux&z~`;LFl{%1_2<2z4dbY7plkw5b|$)~wB$Clmq?kDqL?8fVuhkM3*YQIqL
zw`W=Vs>}ZR`i+jwpI~eYl;5!ZiMCIj^{3wY8^)G%*pGSEIX}zVR{N~a@Yj*@jAIeU
zfZPMQ?yh~JF1eJox1XFsj#1@|@s+8!&j5Ytx4~ymxSzp2GQs`jp8xE7q<gKwjx*)H
z8=k4SSG-#ib&0wOEwFsS{wJ`kZiDT=q1^??*N1z12F54Gn(^A!A;;1G;ja0d8_tI3
zV?YD%ujw831>3aI)_xs7`l>Ov@SkHSMg5<U_O*}xH(YSu&PC1xb=qi~Ov(-PXZc#j
z&b*i_dFIP@eTilBmv$p^JJAi=^u6#cJ-Fm%fO$%+Z@8e{0prn!<2*SruH%UH9b@Us
zwU7?JT?4%DPJAaQ#rH`4=PpEQx4bX4r|*G=KYi|q&2c{ahchwb+~s-8v*fwje}H!O
zsb^20dG_*t&wJf*&4u~Nc^YqnP5jQsd0p>!@UHLR8|zy;9;g#-8uo*}=EC_qcj;hV
zX)Z1}{wLqY0>(4~>+Xld_35!jX?Mw?=wq5s(5I{*>s8ljbA0D+EHys!FoK2@b0W@3
zvi?nK(|^F+t_SMu<Ji+&85{F4AI{tP?~s<I2j<G0)V!FJ%tz+Jd5iS}6C3Srq1GK+
zp9dOaiDm8eVeVW{F_-rB?0V1NxbMB^Ke5tp(%u4XKmNkrJ(~M;)90YieivKq#j<q#
zCDsRg=0sfmg=xIl?C7g+$M~EH#y&7Shp>Z-OgeAcD(|6Z&AR%udG@nzn>M1oSXOU)
zvz@UQ`7##gKEb>hpZVM+@6N$_I$!7SdYDJ&b3uFMh8AeEB40OhV1L=+M_c<X`a7<&
z`l@ZVXMELG`^pMC=i}U*<7BSR*|}#<8h4j>*oGU7__y#=ersRFUK@QSGs^1IpY{io
zGQN=Qhjy`^<^P8Cw}L<Ar}2!-`Q@CIIbZut#@R6ZeFJXL`8{O@2iZC{u;D`g>pv{Y
z$v1trr#$qL=I>_@sZM5*mJ{0~>nT&OzZG<(Tw<0D4V<6z&3Rjw=UlZ<ZYifO<)AG|
z-Ji-!-^4xx+5_YI#?$t#uFnk@o;j&H+g5Opl6if~%==<b$q739O6CvL_F8`S+4!hr
zdyg@y%<+w7z~(-c2@MW+%kqAK%YCySq;8-;-bv7d%Uw0RuV8wA!SP;%QMlZv8xHs9
z^*;7}fx|mEeHVkv+qeSDsaI<E<e(FMrN68@hN!on{suJIem4}XKe4^T@jC;y-)Yd`
z_?=hikMiZ)Zo~8&4-VgZE9idv{XqTO-R5t3m29iJw{qJ3B#q(OUgKI3Z<Pm~IHv&@
za_%Y3%XwhV#Qa_JM?PH#*J`;Zd~ex1?x7vhdZJ!7xZf7sAorruy?H`fPaEw=piZ0S
zK1bT7-wy8GH*Av`Sgw2A`Uc0)Ut+xlmepI=kLRN?Z|ARcT-zrx8N2q{={NPpyx<l*
zw=x6IbTTM!=$w1ce~Y{4A_wo=@jd0fmkAphcj|xz7kZ}+4m9sQ7_ftj?7TY*j&Bfu
zPnoa-%TF3Q(cXSPq0OI=K05ZsBpKtNEUj?*-*cKs>49@j%z;?X@_$3>?@!2>jPC?>
z4p|<5{XM@bH@XYvLoz?-C7;=*v^}L|ajjg#U9kS7p-Zx_z9j3m+iw>x<z(=;I?1{+
zbt$uLzw}%5l><Hg7MOn%w65Ov0s7I$3>wlnGv-d&Jet>5II$KJDg9sI`e(oAURW>t
z?P*i%Py0dt_CQ_b+5W717l`*l(kcH$+9~%7>iYwAPtwNwY55%<cyA>;?y`w&aN>^h
zu9M5Xm!wX)9;B`J<oJa~yPUXdy?4Efy_01?3w&FWywknMz1O|d#rs`a;qwmg7Ig5N
zNk+)5r>>!&@lCb(&gqn`t54fOIqht}*opQ7HgE8g?z_zUe9L!{-$U(zx(zq5tgZ#V
z^GWJ#-w)JPvi+j>n{E32X1vU0`EEwuF7nBYT$)F7c<E!m6S=8#cm7GEEat-Tq=!^z
zo3<C8d3GG*k^>o^v1B~z#CFlP7p$w-e!rmJ_S(m?^GmERIN(@f`O{9^hg>e##P8Mk
zhTDA4z2WzrHWS<Jx0`E59?YX-7|;EJd)&P)2mGE9%jyQ$S04?Gv7&y%4J;?AQ>vSR
zWqo_rJcpjg1NGa;Z=@aMSym2MAuT73@;9oDJ{@Z_wlNq>Galw8IX7dyfx5=pxvxBH
z?s;?Ueplz3HT>!O5=Y))ll!Z3sEc>tZ=~&Saz4h$dPo0;@x7t#pXlFwR$ZOH`WYOg
ze4F<mCvQCM(@*+UcF5Ql^OFG$T$3JaUiX-KZDbWL<wU=~k$oHe^f_a!!5+Kp330Ev
zKMwn?$9Zz!4QMdgUme^>3x@mY3!5{Yq|L=vANoq4?pb|Szbkx?koK>>)N6BJNMBWI
zXCHkW&xU6q?%~h<<sJ4yf9SN8NniWxYsMSUi|>IxaV+g@cl<^i6?OB0w)U~_2x(cp
zwi}#}tiW;u+q9{67ky<#A9b0h$r?!3ZPTuSzKlmKt3TN8SVzkPU8l`>Wr20EpLO--
zZI|4e&ldU2K8|5O>)JoDzkL>cKkvEs9B+`n11uOJt*iHYVR#S12K#jS+Fw8V|BP4W
z<^J~^cqW$jFz3ZH<e95yZF2VH1X)kn%h|NA=x0C!{q{JEpK%<|vB{~qKaqn;jONOi
zor807uD+#j@9yLc7T@6;<ony{W4~7N)bVGoTI9!Z9Md)U>;c!9^}b+ko~XCI!Nj(M
z`^0@=|NXKTHvW@KS+YJUC+aLWFb5r6L-R1en9awZ;yk5;IsA!1yQIyfY~KTpZ!E?(
z$dh}>c{*q3E|!x<+4lL!g*mprTzrXT^#}C(C+IiP-oEKa{bhXD=CikAy<EowdGGI7
zKV#l8u6?cB_p{FI(Hjh;{nfv%z5Qf`Y{>NM{ERQ>{G7MrYHwfnll~pY@$y_Y&dvnS
z(G%NzOFdT=b+*mubCI6O^FZAI?VRsq+`;&pSd8byoJPouu}40Q(SBk%8I&7nr@vWz
z-N?1R9mn<+G^Asg5AD*{x_a%!vgku>7t88rv9Y|tF+TGnt_$YqGjHZ@4$O^r+6KRM
zp5H(Vous}|e#8EvuMYZ6tlO6T($@;#Kgo+trTaVNKfu1#zWVyDY`@=ZYWs@$3}of0
zZ?spm)n+o@_BW6CP3IurSm?DG*tQ`1Y2P}&;KKR~9|eD>`i+TA@@AX<^qmaKKd~dG
ziL`u!XCM7Nb#L|T|8L}u7$)*J()LZ-H}&^1ALsFnLtFC9Z|1$q&fZ9-`=r#>U(QxV
zUD`e6Pi=3u+NbZuIKy)coAX_%y6)NMeyLR5^4{eh+HkxtVQ^<o??dja&wa+7Hn<D7
z?_^<8R@b~w<F1_Ade;RP*}eBbzc<*(gU)vCH~qx^(!sk|EN^JoCDvs^hlO2(jPdv#
z;~Vc=&-cUj8v>5s6R`QVXfXNK=s$4%_JiTK9BhAEfewdnz7-6lJpVTLQ$72<$?Rv_
z`hi26u}H>MW3zwyO8MsVC%YU&|8)$@8_bP49OTp7n&-y8a7|oW*V*-UZ@I^s-v+VY
ztUq-No%>|O9<jeP>Y{!JmTjAX?Y616T-(y-64L@@58vANh-DI6Qe(}y^sn#qr__&g
zbuYRH7yC}GXT*JKJAJb6d5o*?138}37%mLI4<2})CuiF`;DYx><INhrTfUV+=S@1k
zOT0xJu5VQ*HaO6^|6~RmDUEkW1}wPH<L@oUzqkCr47-$1+tl|LyKGCTjbn>(jG!SU
z<5kW=r(8MARaP*N=Hd<8o@Bq2w%4-tH(yn!P3>p@^M#DvIc>=KDhI3w>fX@q2If*S
zw}*12@wc^F&+<2YZTIhT`xmrH8s#MY%!nuTJN#Xwe*=8OHthy9(3gIsgL5|r0~(l1
zbJ~N`|Iam8)cZf6u5ay^`W@#^IZC<e-^w@kX10y!pR!T^H+UDwe4(S0x3;P~*i@cv
zS?}Sm%Dk5r_fut1mj?Us&1AizP1>b?MxTy6+=rigv3wVKS5|h^8`8UUK?m<!*)I(5
zVrVeS8|7QDxzCl}@sc|4{U_R{z0&r>+u{4+TXFp6iEkO-60z=kT2YsL-kGq?K8^Z}
z@1N%PPkj6MMt|OE-|FBX2R0r11B1Sz59|7|O)hrHqAXc|v$0M61brHF^PPmnoSnP$
z$b)6|18&%9e`5X@ANvuTzLP^)j6E6A=OR}b-!UBPfa~D8E$FPTxXu-IH*B=CoLC=_
zYpOrXqTco!SXS4-_72A3d}m=(R%e?wvygqX-^|NA`<t2HVmH3k8d4@~$ZxglH!o}M
z+L<fYL_akT#wNzO3YW5ZNUYo5!1(lGyrW=Uy)nOGzr^+pBgQ$5<+<C1OWE@(o?SWM
zd6xNwxAr%k{nhK=^X~kN%e631EwJo7jn{k_=R`VR_nzm=?_$}O(U}M5WXzi}E_h%4
z#G?J*a!TKy#`vkt7?Y>nD*kKvps&<6%eFmrskcoU_qo(^>i((J$AS(ym(9FnK!eGe
zR8HAbwriJc%5q<DjORG^YoPxQ%l*tg5cf=S*lU;lG@*g}#r@R5{r6;}b00SFZmXQQ
z>+GWsed^n@rQFaU$H;LUE3xl}QLwIF8~Y^LN11($L1xgAi*xWfAKX3OTi!#X&?tLe
z#IkJ*x_1>!@ZJ*rc&?PP(MjqTI=SH3#&Mt#ztXz&2in_j6s)V));<UHBLj9w%j#?w
zZ4>LZX|usxz2)zqcWvtWXnW}++0XVFSXQs!@t{$!u{e*MOD86=-oX4#=wRN>|7R^&
z58oK?Gv5%|A=NFgy<s=uYENH%>GwHajyoCKc%8F*)3e~cn|QBY@I2<3%QLp(T>m7~
zww_gW*7Y~a*>oJo_0Bh+H}Yoe1DuQbaGry?Pk#Tn`M&zbLJR!uB+E+MHe9e@qrW~b
z^q1V3`^=qVugGEM%e6MfZJdGS2@MwQ+Bk;|pB$5G`#T@~$$-tg9IHQ2Cp)C=uBkb2
zeRr(2`S`}7E$NiSIafCIWJEb->XkQ0Kl(k;A`as+#uoFs$RzihQr!xhQDmbm&bOkj
z+GTm6m;0dV&A0i_{p}s!+2hK@J?}nWptSCq+Q+^P^mD+nI@i~=9^r4($A0=$w`sFo
zA2<5gS05dWaX^Ed>x^}-(l%|hy<mUG@Az%_?~K)q7mVNc&37(2F)!Q2`Ki;cqJ85m
zt_Pk^se0=Tc8sH+97q3-(;SQVoU^g#oN^vBa%payOEM`R`1G}Z<WRk~OMfA=uWi!p
zN1MLQv24)p(6%FA=Im0=F>G_3Y<CT3<ZDH)obQFn-E|<pfd=15KaqC!v2PFbB`c(5
z+qBC*%IuT2X|G;e$KG%Yoqwl)WBt(fQy=?Pp0>8BOPf>5sjJfVZ)n%Sc{OmJN!Fde
zIT=v*VeVt~NsIDA+Hc@f|Bml(CKndJ>-am;hVd8m7cRPQbbjNiq+R;S`kQR{J&eDJ
zqk-~Mk9a!L_|#e6FzE9e`u%^wapdXaP4_L9MGS9T^zxRoXWO%0`%LmKi*@a;t!vDE
zbiIebvbr5ut}N;o?Cak6Ms2rTvA^g`vi_UYc0hx=hrM%}v2zD`7cCgxNpTmhxa+*{
z#QW_H+qCs=v+o7{=u^C-#j^SxcG^k<`)~X=7%|QXpZd2=K4t9nW!#d!d-zU&H+<<&
z8XWIw-ihWL7vDG2Z`kt9;y20R+bzHQR(#hrq-?(VWWLbRJvsdMf>QOh?+$-I$+S<K
z8b`*JQXB0%IPQAk8PBtBUwv#C%y~g4C+4M*A9Lh)n%`!Am-&roKK+jHJv7(XoU>N0
zi|aJlYwo%83)<~iTl*!K@{=7p`{=iG4&U&6y7xT?o`)NFzOt--1Pv+n)35%G!+n?g
zY%n+3fpcB%G4|GtZ_DL33Hcc4ZA&J5+P?Z)pkMtvKgU|&xEZ&x7+c1b^<|9Ap}sZV
z?KAH8i>!D0?6koyH15X%3+f%1ci!RNYy7Q6wtsUebp9suZ>fIX%8oUHh7@Blu3pHP
zjsJ}i^Gn&NS9bqTJ|^WS9bLuttov5}M%t#dzwDsKGXDC{94_S~=bQC6sg1cgV6HNE
zn{wq+Pu|up+rG){v;2Epq1G)+5A?MoriL`e8mH~rX1_yO8h;m*88Y?Sb+DgoXrRvt
z=4S;1DGhf2JNL85PC5Cumf8NN@|&NkU+kSX(&pJVzSyg;Jo{O%?cNEM9e2eyS#4`M
z?NgWaiNB;#uJ|pSEXtKmJ*oOEXPfete}`<!-hT}accFMEcDUS+-jPoRI^P5D*B*H1
zdiQz<Z}2{@H0s{f-r1MCTP&+P57bEq?RFvis%zj|aLe0ZIqQS6tb%Pxqx|`|yT6U_
zHv3k~fla;hJ`dV1bl+!WgZw?ky6^Vjo$}q@UvL~5!Dn1-ecSApSl?j#g8K!(<DB;n
zY7XqHAAS0M=36@bjRKU(rhLKpwUratUqAXg`edv@zRmxP^>R%&bk^PVZ|sFcoo(72
z?3Dx5CDv`rb=JRYnpnSJ`;0NQx4h6h|7DJda~mrdzjDHexV5!Uix?c&7?kQhZH{F>
z^5Gi$o%Z==V=uTj+z<KP=K8z#i?!F@96IiHe8z0}a?BpFp2yfZZjODi9bms6b29d1
zQC9C7IA`tNSm>RL{x7&Dl|x;gI@fH%4leQ=p8Y3joBfp&9Lrb+aXAOqrLK?pa*oc$
z92xUAZs$SUHOH)jYca{WdDhnWjlnyrlJ{2CW!bi$NV`9ghp`jwzxjRh_06{GH$H#D
zySld9x7Ka1WLwpZhfQs>Y<pr|ACA+(xvyX##XXSH@=s)+6+RA9zln9*2Iyx)1NT!0
z_sJ9YO#}D;WseN-taxU6NXxQAsz2;M_on+$EFZA#v)Ay`@#+55zgSkcVjRax?2|ao
zbFB2O{~1_TFDn>G&xd#x8hCaVcn-E_!Fz{0$hYZpRyZ%CuqdmyeS)@$eMk7wmt5#E
zhT}Xr=#0a7cF2s&wx@m8d$grI;U|5iKYfbzO4T*mvcERAnJaT=K6k-&sOyq#X=mGo
z$y)w|Yi+wyd;Pdhj&Cdr`U7>gWsJrt)}?{%iFNfGoKI(r##jp+cLy1VdfRg@mJevR
z*rT44S@7%(&QRw}dA?el=Z$=0M!R-mp9S{+hG+FN24i_nJ~1+n&U~DgbL`ByvCrJ6
zpYJQ~cHh<ppWjJ%Z!f=_NT)37lS5fs`&|3@PRH*k?sI*+my_XGK?`Y{ahUsIOvKlS
z^SZ9&FtNU2LW6_da&2Nh_H|AZKl+o4Z^^oCm9!bycosdM=As3)y#3CAS*Z1nJ~`we
zNnOer{Wmhld6SO4z&vg+#yS^cuXD-rDSB<}v%vm|_2g2nsJCuked^EL?gzO}!+p;_
zcaPm5_q*?edr&N^_dI;g1^rx8*VDBW*HzSQxS)TrtiFZZNOem4Ug9&(2F7gc&cpf0
zctQOQdd$^%F87pv88^?c=hr!GxXy*MryS4<o3i?Bw?0a{<<xl(n2%2Wa-NGZ9XE42
zXqU{{jQJX)ba2kjqk(%xERP3^`UU4|em?zTz74-m9BadcjLTTX7zfx^QI{;r+8Voa
zxKQ(Gjt+RgZMcx%Id5{6?;zW?7yC}o*9t7RXw&ut`mm4oZ`h`d|2ChnzmRRpZ*<x!
zX}4c|+LrqIJHuN!?Vd7i2ftM$>hx_68guKBAIs`aV0lMQY<rTqy|JHNN7r)|tatS8
zYxlTg>2u+`$NY?E856(dv`#x*=zpOP4)QmezYPZdPF7KG|Mb^OIsInao77%zi7j<0
zvrV~RGavIjowMiK`I}qU;s-zTufNAize;s-Am^wYKTz%dP5J5jIu97oLRwaLp|h?^
zQ8xn1atqJ;v(0uHLDp~aQOnt`96>`Ka}JCAH<;cxg-uy(d!oL>;jX&eTMZ6(+Y|N4
zq%0eTcOvLxA=TM;1=UaLI&GW#`)~(OXqL67|1f^$;+({ChlO5jZ;&xNzS#HEADJ->
z{9f;T-vi$UzAFabADi!#28(aE?l&CYa~p==b;04=Pv(Q}H(_x3yPR0p?!dFZx@@yt
zN!y=f+Ur9)<hWI?m%kC#_AF<AWpXGF=4~#_%QZjdikx+GXAW5>*UYtZ9bK<h_JHfL
z-2<*otexxU{;cG_Rqo&-CF_l{eG}`WQ0p801<&OQ4zi-YgLVTN=zGE?USl56z&T7f
zv9H`qGjPt%-#oZyCHHXmdxAWfE3s^wxw`Z>Kl;Dm*qa!Pt8rJ(2kH{rHVp3A1>H9U
zHnjM=z(U@jciJBu>eBxDn}OVLp>wy&f&=~y#=phfVDL8@@$WTH4!S4Wr0(s%2Yb_L
zZ@&>ZwlPd-U|eF1{eg3Mve3y08uE?Z8K*EQf8$T=(#ElJY~>0rQl4{|%<0KN=iJSM
z+!wMf+dKIabNQznZ2kLOMco_ev(ug!*8t;po+IXJy`itM+5ddOHtB(W?K_}>{>+_Y
zG}!&`wd%+xhqI7)HpF_CpVGE}i(~&u-x}jL`}Go|wpCyIrhZ@}mpkGA1@Dw66Wwn#
z@1h5XyGp#XlGLTXd!GfDJ1+U$cX0=LkLTU({asn!p)d-KvUs<5@Lu;$Z{YVq2k&F=
z^#R`LvtV6)(kM&Xb=p_l{o6MYd<WFork(b+fA*cUNe^!H8^}aI>MOSSzBJzA<L@WD
z&!@cA9o^^6MnBQZ&<1_?-^KRhJ(>}#{+2!?o`cMJ=3LcP{bo+)&K$~(IaYhi75h)<
z;CL<O;oE3Tv*4RqW7Pgej7sYb%(wGUj%Xhd+aWI3`nuM>vw{1dqCWS<#5T#k_P4CQ
zfqrw&`!PrBJ=)X895`p=bxxOgI$z~y?!<m+%eWoGu{K;VwpFlhyW^Ns=WV_gYwH@j
z_O5s0e(?LPuD!81ru}Qor^IgjqAp2YM`ypB+cE~wZ({v|bD!W?VxJtdJ?81$obyj)
zK8|_t+X+15_1rJ&lDbB@qTafFML+WKX-vepjGeV{&6Msj=jMED-`Lq_;YV)tSKssj
z`crTF0q-uELDv6NX1_Q2r#`f^e@e?wY|HjdIcaeZr~IbR_HWXD-`a-XxBrlZePZ7h
zWPCH`;~FHcN#&^@v_Gl#wVZaYwR^&K?++Gr_0o#XaG!9VJX6<wR~VGrgYEu{bENHs
zNnib3sN-5!Z@d1rmk~6iz9w`y?C&S)ZLg>kZC5amH_u6)n{wZI=M89ZxT~iBo_wHA
z4rp7kpQzh#p?mLvXS8`f1M6a2(kYAmL?1F9r2e9p?3aF&C#d6PxyngA$)<b*b7kHR
zm`8KF!S%?sQCgR5Ta;bL11;8eBP*`A?Gv=U^cms9@r<E?b5PER$#^mr;}PxE+egyI
znDpy7j(5R*w;rf7Hf^MVeT+*csM}y)&&7rdo+;1RDfBqUDYH$xCj*`6>n9v<!eRUy
zF*-Nr@0>e%a!(H5P~X@1raJyc5?p_W@i!FeE3iFj^x63x#@oF0gTLJGmen2FR$y5i
zQzm?3AQtzi>-UK-_RS*Z%&B=5>*`y~$MqbrnO6gStb%p*vtV7D&zOvDtP6~#(x^YN
z{i$=F&gD0>OZ1^HSzqYHW<J~FJddaw{|$PXvt_YO8yOE8^>1i<!5o>ZYre>_xlT4~
z<T`BDW4PDBz2^Ct;NENQd2l}_>a@|`^&Dj#9b*KR9jh^p`&KNg7wZ@7uapfFY&Yf&
z#(yF=Z+Y2|yja)HegitbK7NVS`5FKCLe9~4=kGl2lX<bPHa*UE<Lvv6i)Hn;+h1Fm
zC0EAb+;U!%IE~e{63Yi{H||p~FZMTIC)Uk1$QVbghv&<7rR&ooe&aBn{a`%mwySHw
zp<kkp#CC0+bLQca1Mz$38>@U5)w1^X-GOD>PvF19Evp+~`x~}vH?f!f3-xz_-)ytJ
z_IZ{EzcYN}X<O^|sddMi&;#qXYxl+~dTnKfeCubsc`}C$PVDK+nhtQybFG!Gw{25f
z`swq+<aeFc=>r%1{p%E(zq5V8-^^qOSy#4bQzq4KEjy<4;1Y-I2kO#BX?p|b&>`od
z{uXMVpUUg6|I9z*-!Zpua>hKf{XXoU^|bpYa~+k5>+8BDoAQ%vYqY(QzEZB(FDZM}
zv;FBK^;ItVxTiL_zjDuY_FKjMCnvDn!F$<z&pU3%ednELS)Fa`fjViRUG{tHqus>D
zJGXK7dMEp)H1Ll8+|RTveG$)M4$h~?yez95&_EmGKG=)p3F?*VhQ1inJNz=HV>p&?
zMdOV)d~5g(;&+(eeFOZao6rmS{kQlAe3EUy$?W&EtK(!jZR|6GhLp|U{={;&UCK{Z
zw71eH`=+#QL|?}~;CE~%AC0_R@O$j@eH`zqx$|9h-3DCqNnTx3-_-8<#$H%uU0gHQ
zZvBAmZ#49-Yhqoy1s5iJ#IxWz887E?hu(JWwC`Yl{YZn{JDst_J>(oN^KtLGk5=Fu
z)orkxZRWszw#dsiSLAKE*T9^ar;j~;9oJYg=FVHNz&GLZF2uXiinQ!oBpU|r#)1QR
z?|S#{cuTyKWdsZP<f8K~p3t~6N8Fni+4+0Sg5%$2_<N1a2b=m&T-s&ux2I%Lek0qJ
z*-yD)1`TOE#?=F3-GT8Zjj|l(R&lOxbo9yX!~j`W&R;mRS91K6BVyY~x!@d}iyUx%
zlJiZOdTlDHPrFTDxeuzomcQ9e`nNCC@jLN2mj=$=94W02uuYp4ai`C3{?oVi_Ori!
z(s#%A>i7ruy8GV!pIBF4QTM0RewO!t0b~7!{%xzWj#>K+?2_!G?bJt*d025bDAlF3
zob}WxlOAPdVq2Ck_fD3TwXNzcYx}vUysHY0vgBPix$`<)?&t;H)p<`J?#VY6`pTd#
zm%CebFyk)I`@H)ufp_<ayL-kr!i_h~y7bTw@9ki7zx(EO@cmOJ>NjY+;1;Z_w_Q8w
zaPW~V%A;UCIh3`x--dxNeHy24iWu+5r|-4DCBcaI$G7`}{`I9F<IzVlD9Z)?9xz86
zZo#^GZR~42`cr<R)8^R5(SnR=#oX+xKj)F-D~+ca6YZki2)jeO@%UD^SbO(@d*i&2
zdqi9NI4|cSmQVPx-Et3`O<S{_@j4i%F&Rt7lx63$nWOK1kF{7x=lf}+&!w-v9M>`G
zxb9iUPi$KymT3(5(EsEc&F{6zcUxk8f#0}}Z{Cg7xSfMz?!u)kRX3<h3yjrqowxHm
z_;fB}*?80s+O=^k?d_+Z4RxN*u~O%%o!sbSd4V<?TtnB^?>O<UkX`T&c_VGIPs&bT
z{eH$K=FfasFV}1^zt5b}8^<LE?YDgxCwY#S`rl;st9A>&KasZWWuDpgl<OCt*?zJ6
z6TGu4_NnzOfAeMgTiZANH`^TNl=%(Ha?74@y{uQ%$qX9Oy_GEYM8Wz~=YAN_;IKc$
zx_bMbg7qD?)4jwV_k2hTHv7!8(}NS|$+~R|yI#g|EPXnj(z-F+@N1tL=)?2rIh~Jl
z{MqwyhHclbqVC2yx34tt{Ch?&XT^KZGm}_P)HU$lO00`*8!mM3lOI^LRkXF=0R65X
z=(PDZe#7<&2U_^t$mCM~iKm@$9xzuMZeT9O{GJzFC)dn9F@jolZQTRzp`UOcB-(Y*
z-wyvu>*>$-M0+{V*i#kvSf#era@wR$UmbEh>l<I5DbJqgP?=c&Q?k!DS^a2}=h8EI
zV?L93%!ljZ+I{wezZLPmE`A@m{7xb}n8-@%l@~gF?C0Bj^})N`eV4(qx)#2*lM|><
zCgp*>@BL!`x<B1(?k!_AW@9&>(!m_7ca1w}=N@dqr?343>y=J@ForpB%m&+B{D3wx
zg6w159a368%*Py5)QRois5biBkYg^!{j3==&qCE5^v)}3ltq1IQt!dV?-Sd!x39h~
zm`ig!;!IES-rP^%nz%Ne1^2vrPTYSo;S|&@+H*bip)Y;9mfj_^tf%E1*Y!TwXeXA{
zCDsQRYXjHa^>z*$8aTHZ^LMV6)eYL@g7dZi)rbBVW5irr%+0g5;RfCBgz`2I^x8Oo
z=bU-5u6{?qTV(oJ;Y*tn`P#An4{?~YOH9Vqf*Ez=6m8@LmIv6!IXSlhlesSDydxLp
zL?$$I0p{?4_8aWm@v*>h_3b{GL6*(cC|FP3rJT7iAI@_`E}Z{?#<!Hzvh^8kWJP^@
zpiY}xsCCN~?fiHB^561-|L)InmHFF1)mdJT{?GPWPv7aQ%4+v4ug4f!ALzyUf%G?-
z!!G#S$_N%RNnOeozrj>#+k#uLuHG>m^MBEHu4j_0N`gcbS`$P;6huK3L_w4_%j>@5
z6B}98XU^;o`yBj*^9Uj;`#!8;vX-5F^c?3NyU(_-I_%bIjPbLh`$H`32bcbn?(cAg
zv_E6*kI1J?8tucF6FSuS*jFzH^v$@Z)K<|yW2!#e<0aP)oie$!bAF3?e&hIC;ujjf
zH&(v+srR{i!{;xlc6GIHdlcN`H#Yi;KD9sTC#lbV!zQ15k+amnyJSC5r%hJzQ=k5W
zc4dc6d&U`izL0s%;oax`>V4?_>fJa3+a0~O4f<VujfpYMm2}$H@J6+5d>S0`c;|W#
zJBH(VPkU$kK0DmyzUTd>@H^x3-Q~BJ-(-H9b@01xLJJQ6j#gRpr594CJP+P<`ego;
z>hzUfuzv!5C+y%Nt=ZbMer+RYNU^_zi!|nd-=EHZ!*v~46Ti7yd=KTjZ<lx9WIf$a
z_p!0guC;sUy1V}3UgUn**QU>a2JXH4BlZ{QGasl+{h@8n0XOiR_zZ05FVA2;liF_h
z<ufzmZ0*QtZpU}L8#N82w2%vVA!|yRarz$C#x-)yTtCm-N78rQjJN&~HGB7OxZu0O
z_rL+)9m=23XM*pI#(Tqehj(}H|1T5WfyP}r9&Gv-dfc7flQY=J3xj_zTK|GeZ0Fzp
zWCjQMw`5F@94BhAF6$F({fUYFjfP&H?}XHUllo^|^_gXyO*^@?t#|ze`hCOr1Fl7`
z%Pwto+A8{2%uyNit*@dkN&UvB!D8;78PCoLnP<pzl;j#sV#N42v^6lVv6=UD;-G_P
z+cVz4Gw=DY<a02vSB#OWYxE^!Y^QzEe&eEl<IPuH_09T~*{*imsZXCbnK3JB9LOgP
zo%4D!UvxkD>i@U&$6naayKBY0Hjv(P-gh#g!HK)O-qYTXhdbJPx(D{v-?%%|zxwK5
zG1mKbfp`4oe)qmkI_<-q?A?8NALYBL(e^H1zU#p6h*7YAL7P7M8+!}(&m+DOlMLGX
zk;6O_l*y+3dACrb_12p8b$s)fuZ666t-)OSX08?URi|BSU;EfxAJ=OHwjI|vb2RA0
z<e2{b?BB<JXRW}tI&CMgzO2n0bv(y(4Ck6-)Y{c&ZCgKTy5N2{&V=VcdFVg)z2=>a
zD~@r&IcYbiOmG}+O?%AKdF1?ZZqCnk1K;x<4)1*BhNT`K*U9xVpYw1$*HoN`GRJm&
z?TLN)%$<1GZ;*HRZQ=JCC_jD1v>wNE?RJdk9L2GnS7JYP`pOI%(z)N*GshMC>b2`{
z{DK3|nm2Vzo$F$*w_tx18f{74qAeHPSNGdJcCR;F@Ge+|6YZ4R_0xX@w$*7%`zNns
zF)!CoY&!?XHb&o7IJBSWV=m)dAIThz9M7?9zHDbs`}0AkFX~g;esa(~@y`7X^9<+8
z96s|#Ui#*G#*Q!fp5y-8ejWEM*Npjhq_r+^4lShp3u(8lZa{<09B0h;a0ZfGgQrZp
zGHu51;4SC!Y;h(g_`EFee2qA7lk@h(GpN1eYmBj;C9(b1Z|Kc!OwI4JJHR{1yGyxY
zq3bcW<2A-htVf$Z#x^iUjPG!`bHui~4f;vOWM5m7c70a(D!*}ypE(?J!R6kY;JsV%
zE|&Em^(kA#Z{#fuazD|o-y7QWKhUXf##~#OTU}?@T4qSse87eaxqr6RC28|KxYv0O
zs@&*r!F~hJMdmYq&7sfWjCxKz*J67V?5EzgV;CnhuzkTeeJbj-RlCoR&yCN_lM&D8
zQ!ez0w)UXvp1JK$I8mFmxDJCg9_*F-czv((o5=9D5q>Z6cN6h9l=YY7?=8m7M~=)_
zr9S5ijXJEQQ`4q4&!6YZ^JLxb<%<1uF1FRV*V;X2`ijp{wo~S_<yrOYdX6V!`0Vt8
zeV?0#P4uaxUa6n{9b8Yb_5lq(zd8B4Q=m@1+4VC<(l`B$+2B}?>G-uS+dH_(`dq8m
zp4d;+H8|v~sMEH=Tq~Y?_vCYiSjWj)A8`HM2lr&g*?&G0J{O+H9%s|@X<MB(<64~4
z+}lmg29D!C*0FN$l~0V**FE3Vd#K$x+?b2)L|y9j^K3Xr<2)<Qb%D9WI%d>jZP&4=
zVN?5x`8ltgr_Zg=>IL7;^*ydF=YNTJ9a5^_<XI)|5TBT*gZ4MfJ!5^%*}!!g)ax9a
zm-BSaE7l{|BG)6=NU2Yfdi$<di?zx1Sd8PEIOcX-=CZ&!CHAc=vEQiIIS<z*=DnF?
z{Whv?zs(lhp!?fm{2i`N+kh6>Rwwr_FxLzYQW}5z{}VE<${9I3GD+Q2rakMe^=nIg
zN_92Ip>Mq-*hslS_qUl~A?5r)>*RZ3K6K{k;8@mRea*FJU)|@<e#?Q64x4rBZ>;%t
z;nE&|{=-6^U(hH0mDyK5(O$WXl~ny(JN>HMrEc44d&aLn|9#xFtFIjT;%|pD*#3?f
zJazuoC}~%w?l(EzhX?1;@ANB|XH=HYDs=XEyRSaq+ylyKpM9U&JOkmYw69(|9Q^cE
ziaJSq_EV<cTTJ>WtDn9jNWDHY*vLd(2mOq>%*FXMILu9)qhvpA>UzQT5Ov!0Gndqu
zgH7Frtn(H>W6iO>XJPs-@?MASdkU8CG4E~P<G$bhe(?K)?~CoX7A(HU25i3hrvH8h
z`EPPc|Bde7lKIRnIZpP|UZp-8tj#(nShLc;-;r7S#V=8(UB3;@Zz*uj3of_@6B=vc
zx?FIL4oud|H5<MgVX}^{XVO^T1;_Pf-RnNNSMHJ6Zjk$=uX`l}8koa<Q`%R*;Rf!n
zIEKu~>v`}jdL})i7Y5JKf)m(Qr%m*$O!}>0z7=OXYj?~A)?-~Gu&-XbbZF{a8@~tq
zF7UgGbyd2auHPr#bzxj<^A4G?3ypWcfE8S1qAuIY?z<&uyfcRH8@NI5_`nJdQre&Y
zV$x1FZ5iB`3l4Pd(aNMR8yf$H^c(qaOjR!bJqqf-Vg1&gkAL$rUd)vY+LcECjp}3j
z&F6or%iPcS)K|Gm?U#0?+On<vxlS3AJ|pJi{v_^KCH2bo;;&x+4xRze!hjp+=JfwM
zN1hk;Vq0cut2b86a{}AywCjJ!xu8RyU!~`HKm*VE1kb+Dg4kB4O`qS;Pcr5$&hhqx
zOFv25KqswWe-|$8H*%iJH!`N?vOR)^d?V-gZ>8&#^k^%^HLti2$)GJQ@NV;t6Yu8B
z-IsT-cW&Oho%Y~v^gf+&ui96yPu|t(ztH_g$LHod18Ke-!#jI%XM1mN-akqAeZ)OJ
z;Bse+ZSQvVGklHv+~?l=!9|LC^XYH=gcj1ixg19yeb*yS+lbg*;>{txm&Nvk3+8k@
zWwy;T1IMbU@5N>vu8C{kVx5$SeqAf$%)c4a@qOQQP}W*%?pEfQ`8T;QC>_T!tYJr8
z&LwkXys<;yFK6N{m-UKyGtY|kc1*Fa&GB4I*VZ`=-rK&*lh5~2yw?Zs_7<#o&+B*f
zC&wp`>qO2$?i}+*TU`TdbFL$BZPjT%u&K}W5!+es#Yevm#$^1Vz10z`ub9XF0OJz<
zYJ1W*KJz(;#QfUyF~*#e+#9TI6jo`gw|~KX`$o0fHf9v;tFL=MxJ$fGy5CZ;0^900
z=yM+9+E=en#$`-HH?fOteaw5HafgZRzri@^fw`Wf?SCrG{~HINzopL4yw*ElN9{ev
zd*;*kiM~nN4!UooPnFfT>a*R;7`9WdOq+ACe&^A^{m(tFvZMEmdDas9-_T!bj&E)K
z%rn4e#^=Z9s6pqs%I9pyGpDXTZ$7`qi0uK!?+2-y=#4jzIR`YzyKQk#iTBmyuG2@~
z71TImGu|9x9^-n!zIyHYOZ83v^sBxb-wU;dLoKpEy*>ks>tOxO`u)4L;NM(wxR=HI
zIZ0j0^sRD6u8pjuzDNG-r;oLaz}n=3wN9|^7ISbO&gX)2bDr(7m+r0msQwLY7d#7|
zi4%C|%LLC_<IIVDee@k6?N?vV=Yk8K*^0Vk&~9LU^CtGyYhV9>i?3r%*x+;O^D3*f
zQ}>h&ALESwjgHTW+N{%>T?g0Fv*up8x0l~Y{LN&<?=6$xR-}W!x2$0JJIybA^HqPr
zoS8qRy3`-qEq>GK)U^E#$8$)no}ppw%%PRN`0Q=WYhxGvl1AHe=lT1bM{=3ZGwhlE
z<d3u7qu;P;U%?5f?u~{%bNS2-a9uyYKOqlusWfzn`UM>>bFZk=rmwknaFLE7D>%rc
zF%OwwT{omU{YPLsV^XT?fo=6QkMm#P8hVDB`vMCtxX!Nmb=}z)&)o&jpwxEu)g?Rj
z)>v6VN1AgN?5o%31h&&}Xty5fI@Fx&pp=}8Hs|6zoWmsMfYQGD7T8{3UVR)R>rmRy
zSbb*rSZ9lQF4n>4H=plA-@5g6oE^0oZ@!E*ZWDL82WEU@<oDX(n=MhNT|e&(?*i9%
z!eJcqZSppAJ4TF|`+4bGi#F$KJ=&y$>*d<zIzHD@e{&jdo>Oql>)6z?1MA9~2DTkO
z%QeB~IdKlo<vI79^N#r|pXk%zuqL@~wne@6WYd-lJ^toD$R~~82;QiEE8?HBqZh|;
ztN|^stxj%`{y)j|RqD6k1X<^#=Iw7AkiW4keq%X-Z5a>rPmGuBEA`LVj90JUga+2~
zsmr;s?#r{uo_5c)`yXf9{n5`D<1d*1K>ZDAc5(+BDecdH7|6;~zp(#AjlJZR4Kt+e
z<kEgp<Fozr`I~;mR=NJL7SQ=!QD$M&mgaAsFZ^WtZ~m@7jF7fHk1~UfOni=pd+I&I
zGwc1ay;Hek4|r!R?tsode|*^ckAKAZOmEKv9CC<$iG6MQ$PKbT={L|XQK$Wew5?8B
zV0#C*NZU!;Cpu}6W4y^l4VSa*opn6d;F@@sC7(5l{y;v_K8b6QXCV`H<}{{rPY&-`
z)_bwWH}2&YYu{OW-{Auq<oAPe!ijGVzqwX?hxsk$x0-AiztFHt{dc`@?eyLFUvNx0
zLH1K;T{FIk{0@=<8{M;JW7J)6Ue3{Z%L;6_qH}#*E6=Ly*H}l_((~)O`rex5U36G;
zS>XELhs}LSAKN?j(7n5{hXX0<I%j3Z*&dv$UAVNn&lH?O<GD-JYww_c#%Ft=6VIvR
zC|l@u@z+Ov`qf$+bvlpAq~8PE`i$^%O}gvmdX{tOUEn$o)^_7#jAL56^O+AeeYxO0
zBr7;bsr}A-VnT~|(T(@T?Dz(ad-HD?_{oL~ojY|E4sG$yoL{);#eb_x7Hv6Sc>cTB
zxBm0r3BURMZ|I-3<{bX1eCDxV>r4AH@4)YEE!98KZ^wQ#q<iN6xt9%2oCEvnwdX!o
zslLO;$GAz{;yexTd@1dB^xD30uo+)bClfl{$YoBycRa&+mhCt6+QfGHJf8ud1$7xa
zBbWY3>QbgYrTN9NWCa%~S+DK14cgKQ_SY9K`rmMz94qq-;+`~gm7K>nIb%)!sqDl_
zuDR0nP6qA7`zrDNnvnPO<-YT-^`7mp;?DG);rm1u<ejQrzZn>3yzB>;{u6yh(2&NP
z&%EBho4ebwI#`2aTZ81gE&B(Ze(7s}g|9yPr_9*TJ&%6zK1dpU^~RcOL)K#7SbaY4
zVBQsn_eh83yTkW1*l)f^K)>p%f7*NxIj%C>IlkjquXV_Q8MO@7MrvL97&GCNyymyB
zUZ2ddh`$BbeLtA=^>G~MK8R1ubpmq^d=8i+_cWzCb7|M_;=cp?3)1$<MczieuA6H$
zS+g7K>l!!Mysv#{i~R)`26S|OOZkm;{f_jz3cYzY`CN}p{?0f#52gK!et_ePzR9AU
zXxm_%H9IHg(V1uBoYaj#pAGsyX~xI+<`wHvm)KX|U{XuB9_EwSKQJQp;O{saE?7s_
zqkMAES-X2B`wQAS)Oh>qci{8v{x7&MXlsyptj}6ygMI5Ur+((}TWo^&mDsMN{!Qwq
zURhCBdD?2fKVqxxr}imh=$HMsn6y>dxT7oM(bqR~*{;4dPxaHkN8C?7`uz==<IT5|
z!~GlJ`EXB_;@(zLube?giszx8xwrNRpOh!gwE5~dwnvPuO(t|OujkO`&FAUHGd9Yz
z<};^$V)uFUncIPFb;gQ5lKs?mbZ@yGr<t4kst2~!X{)IF#wNx%=^^#4@!3wjvc}m~
zx8Op~<2gU)qR#+h9Pe=FuDFxEmoNA7jywBvZ+mxx_w(nDj=nb8FI;qDz9e-icf?I(
zlDZqQhj?q853D_D%tf42O4|#ZZ{nI{`(k^dO&{0HvvC8@S7p)viG#hB`!UbB=hbsw
zQ8&PQG}#fWRHt3^70<r-93-hb#m}~+@5Vo$r^Pds_<SX;JZt8zd28-P-Vs=%wN7Z@
z+U$6)+z0p2{cP}g&-1&Azpsq={blo;%Y^RlH~yXj!{2uJ&y)WR`igM}%p;jI^H%-F
z?(aO-U@iXE)BR0{T0J+`?_8YM4QYSIS;(`o@EiJqXU8+u!1L<7SHXTqpXej|3+5Sx
znm5;TQL}40p!p5OJjAx7zS^d91?QdESAT*UzsV!_1=matO!v27Us^#wS<s>8w69J7
zjNP<5>*m_ESg(t8U6$+2n!5)+bMBMp(sL@dJLLWi?Czny?xWaNr)|RxY|AJ#+WL36
zW#2b7bnBoV_tHA8x7MuQnord1d9iM>ZM^npe9d#o@$tjoI;`!&hDqN#%<;)X`%^3P
zZ#>5r@)`d;*XTbv$Tjgb_F4<MM4QqzG}do}4fUJFwz>)04|j*Y4YH<A9&_2xy%=Q-
z?IUVfF@M*<x#oJf2A6Z-Sr{ShFZB8z<EY<tG?y$e_l)tKOO9)M!v*JOy))Rz3$B&(
zabC`EL(Y9LZ^?d@)n<&biG9&uzXkU}=Qn@}=RxClgEy+5aY?6bZpRqVAjh|!9@ti|
zUEd4FR@7Cr%?F468`i8|Ibav;Cyn-#v?-r9`>D@y(<l2Wt-U!f=DFBY_cn2lwdpgd
z)0`I;zX=_G7wZ3EB6o0+$@oLeFD&fe_$^lZE#ukF7;|R(P5x$o#^^7n;P02o^tVj#
zH_>F!t}K5qg&SnQ$`LV#HJ23(<c;&_xs>+6{aQgU?aw}jZ^owFkt_Qx{GPeY=d&-~
z1Ih3{2-IE3vFo^Rc~{h^U$#@KOH$X-RUFGP2Q)a`SJOM0yUTkl?@#Z)yvOqnyrJ`c
z?7>1d?|L|KN1DTSvf}>S`rtpfV<&g5cklEaUA`-Jd^h<0Ajfa1U?D4mzTaK5(EJYj
z3u;VlZ(`-X;CNDNIP^tbwkLHvj|+pjtrwiLb8oDH@1D+jxF*Way9k}OjZY8sw?86A
z{{yb4?=APl_5G|fYrcIK`c4A(SJ~k64vRe*$i#g!Mqkf_=fiWdgNyWBc`iNs`!Bfo
zB<VlVwcx}#_Kcd}u?Bc9JJg!3&oiZT9@_NLR~m7W{fVxF^U-$%H7@<Nea>k)pYDUW
zC$6vS+VK0tSTA$%uJO*1&V4W5`-%N(SHHn`i|>XN_>SnjA7*(^jE-+`kx$ZAW%~3#
z<SuvzH}BdY?_TfUL|gi)^IkpB{Wq}(lm1U^?3KoUhwzPo{-3b$|He;w+L!Uw*E*e3
z51e~No9rO_RrZKYnYQd_zU8{Yb)6yC-u0IW9d7@Rw69)2{gYkV+C*RDwr45Mm(u<~
zuPt*g+Ui<h`we3~o6;fkuE?((aN~S?#>Kw+ioQ~H*-qP29{elTAl8#?+Bpwp&ZFw|
zNiyyynZDm-&23x1%-3m){cKlR=kwNHu}*&@$IE)U_LBRclv!xBy`Pr%SKz%iz`OZ!
zpDq}2x9+%85BH#WzpB%&?<B^!#Qq!FeFr#>*nXmqvF0_u<IEV}akB>HDr8;hqiuY_
z_uUMd?-lSJ<GVm<U;Bm&<}$x^WG(8n>;HL2@Sd2wM|>YEeJ3lWhg8?_8*rhQG0n3;
z{Vq1^u!cGp$F4kWC+bb9uWi?6L+)FTwRX)D_rvyt4*EK0b2#4?*jA^l<}}WD^Nd2~
zbzd9w$Z3vbn2)@!OLL8U|MDJQzLVoS$nT*fzl#obzl$3Fl|kPeu7BMF*VnantP75-
z+@P)nw$&x-bDxy<CtPq2u7z`R%~nYJ>JN6&FB!CDM;`N;x1vsF@#*+DhXJmW=PFUB
zO`jDtZelMumSZ1q{hwIpe$3%gzvn>doGR+mR_(UaHsd^;I1`?OL|euUVjSC=tj{{L
zR_kgpwt3Cv+1hab0s6o3Q;s+PZ#wf-+n_I1_ix(wk;{JSvi+0X5x<b*3)+67#_3o4
z&vwHu?(<^*+*i-GXH-0+o^8)&_e}nR=Rr=;I2WFc-`MzEu!c_^NY9a2TavmHe#Ti-
z);!}L@h*9y?YyAAvgubE>maF1-;SSmmv>kL??JJxE~z%}z)HrXOq($a4mgh3PEz-#
z-}qXu`}ZX0G4YX%ALN!BbFdz3Y2e-M{VpT$uFrN#?FWo8wvu_2lD6!>$@JOyUsy4J
zYnH4(`>u^X$)GL9nj^8VKK-gZ=*{aoE%5w%wtNPjsGl#S{~%_^bK~>SUY-NbZ!&4?
zBl<7!Y@5TeGjHb9E+;T<!-WygM}3}rX7c&T=c&rH<+Ek%0P~smjfuVm)^cOc*6Z5b
zID<R(%yoAk8g$Nz-v`a_1%7w={4T?9Gn3zJ{GDe&gU!G7&0o+bF~-=RSlADA#&SH_
z&=`M#HF=gjTc0^FpC0S&JQH=_=Ij}A-kvA(B=+BQ+S8VDqccxpU$l4d?B<$&>ZRrp
z>*<<`ziCy}^}scEz5|?pu7Q2^avx-@c`Ap#>$YK)d%(TU+Ag+4KWTyS&wQi!cXDQ4
z&ye#z;5xV_gLU%Ejj~sV{qcM%6Z@XqO4VI#Z|tJCJ)yxO_h!s`=2z@}?veXcYjr>M
z@tL+><CUNK(HrOdZp_oRtiqw~yf6O7T8A}Rn{)l>w3&}_9K(7q_+0B}KkK&^bBX?9
zdzM)5gzdKi-wX%*+jN${QS)zAZTbwj_*bU!W&BC4x6I!$SJdFxE!IVSQy**N8JK}>
z*DBX!;CBM&v7JkqzvF+_f%!XrckRIS7_gz^qu;SsYIZI;U+26F{=NQ0yM7&9594Kl
zebKI8#@ZJ3iM9a??q8yBGH6SK%%9RRdSE@awdrfjdf}pz&Tkttu$}s9JLns~vxx2V
zPubClF$+dW+v?Ju{s-SAb^7U_)VN-9H+-DiEb|@A*}YBd*L@kpn9s4C!-fmJGhT3z
zN&AD}gGs-#>HoyjH~a08xAxQLpUVAG%S9*oTV|Du-!bI`{#Gh8*hp#o-ugz`t6c0y
zWzd%vZ1?CdnfN_<#-?3;whw1Omd`m{pZQ>hRF~)@`ae17M7{nS8XWGF#QqH1MLyYK
zt8$_<zQf?II^1U+E_d4sY$uKO^bYhL!MmdQ?%<A04sCU_u%n&6-FubyZe{y!_g&1p
zxd)ebw`>^D;PBn>WTKN^uz$dqiaKr5AMMMx%7PIzWU~3Ln||B<FJUfon&0sjT(G7C
z&UXd2or8L%de>;e0oQGSYnWWuGWNptcfU6K=Kj?^T)y`T>E{{PoQK7^@Qiq7#>=_%
zJSK;>be;jpzV;E^$YstJc>ZiF6UXgvsX?rz!Hlyxm`7#N7j+GsYtC2Q1!K)&F2}Kk
z9oV)8$JMT{@ve{S=h^ja=bC=jjGP1CPaN~}x%YnYo>_1U>a^b&#~9aSyH>ml8t;M)
z-S+@2IMDjvqrY*|;rgB`XrJV}u(*rm6luGA2P3aO_*;`XHhpc)dl<%pMPKfN{I{^l
z-Te~>`~Pq9-v#S9*3<)QAJAYj*IWx_qJGCZte9)YS81-K>TRdq_yOiKzx(03kH9sz
zuRd{aq*=p*Nk7r1pK+HQ0~&Y+l=km~9eVAbvx092_kR@z?Mk&}JMGQ0<F^iY&Y!5?
zpr2&iqAl4^nfi-OtWRd)&=%+MH>CgH$e;3M{ES*UGV9D*Yd>}RRo@kJPpMzFl_O|K
z$^M&6AJ<r1?@FgHC+;loE$=G1+)dt34L)}`ch-!1*}GZn%jZ7Bz60;MY(J&8&fRCu
z1LjZcCsk+6fWuhQqQ8;aD(aFEZDoUJZ2G0GlY4om!{!~}d!UE3uiiUfpBosHc{7hT
z{c4WG`(g#Q&0Epe7-P+;T%fK6wq?PES;ijB?}_z@eqvt9{)x6y^fgDurA)t$kK;Q2
zfEL)kpx-9`LT4{i+D_Ez(_ltE<DGw957$Tr%y<_M-ot*|3}_+k&-m84@vWo3?{BeP
z`<K4#V$-f}#lBdJb6W*#RHsd5)SGqo65~3F@y6+&bIGwCKgZN&d?oW%S?w#<#yrj1
z`Bo9z>IQaWYfNoV#@kV|HC}K(+?Nr1<UZX(?qSNb>6Z-JlKmU;8M8PGatc1{_SG9_
z9l36`#zl>Z>wEMo`7^KiChRZVFZ%S?{{Mr_|4(GC!#MjXvu*!L+LYgT#teMlsDAfL
zzUuRA4`Ny{-Dmdfu$RsA$658c-Qe>r4gB6t>~D3P?~A|Z`V(t>!LxE9&xm7qPCQRL
zXpAkM8|%2xsp*M&(Pw};%sU-}8mxO#Pq!v&6Wg`F(8+i~{RRCe9581^opya2c+VZ~
zyA{}$j$WHGbx)}+{oZ`jw()bUCj;Gr3)VCPYs{KQsb76X{|?5RXMkf_%TILd&Sk*m
z@7;>JRpxKL7P-xDThu#-xqd^x4aP0FVC^}_DsxUlA7ZT2daSFW?gTl${<32%$1~3Y
z*Xh7!Jv(Q8#a-^X7yFge=d<7$-N8i;&aKZveGY8*K%1<<7;~7ngLPPswOOaqzBc`G
z4D)U9dGXnKK2yK-jaguPd%@f@YIZDZ9+366sCmWuSl^{~>mM<Pn{!}4w!fk9d&>5A
z7k_{8cNl(`SulcD+Nn#aElFLK3wv^Di(^c1yrePyrv_^A+_=VX>+4))J$SA`U5DI1
z=ig!t%st(|zd*mrp`WPtEO?H6E?rB1pAy>*-2`QlJ~!q(kcn%MT-u!+zp=_VuAR?W
zK3ko-^0`a7uwUxgr8aAFoI0jDYo6gdO76j&Jx9*pHQg{dYp(kUZ09~GFC6yGGkn2w
zUh&MUSE|pxx~f0eM4ySRdnU}y_=&aL*l%m>g-v^4>-gyR^gYbWJ^jp)^;3$v1Ln&d
zj&U4|@ja7`dc^jQnsS^*U!C=4&BmLrN6uxReERC+{G6-b4i`Fqm(G8I@ryj0_q};<
zsrNGG0LPZkyr{>T#CfQzc54;&#$IslPh67?jwchG-^O2TA829I$NH>uJm!9wgEanb
zuMGO4PP=n`W0v@5j5cGG>33+GQ{N5u7xejC2ENh?_BUMU{Jyc^yr904KF!~L3aNie
zV|!pbIkd$bGuX&C(%!IVT;}PKJEik+UJYDR*SD8-RxhJ)X`9ddj(=hG|8S5=|3j|A
zq+Qwc{|On}OHSLTjA=XV>0jl>Kgr)JNBm}~tStJ;rCsU#Mp~Kl<pho2RFgqFNu5$%
z?Qhmy+=B*(XY3o^7t&w2JfA+JZ)nSynj>Qd_69!Z6MEc7i)UZF1JsH3^FW>S2dP({
zz;=I-x|EKWIDUiaUFN;!z2`m0Jt(%HsP~@q-QauT`tE=h*iO`K-lyGnD(~0CzIy#u
zU_1S1#ONo+Ef{clUr*oJaQJpuem?}Z<%G1|gX=e6u#qx?+E&-#@C`Q$J=#jS{O86N
z3}}JvWYJDir%avl7Bc@Kcdg6X66fNaoV#nV;ezYp8o5>*TuWJSp|eko{kq_OUg*A$
zV$Uai_q4~}>f?FXzOOtVoT>dF&y#jpg+cogYrJRckjs3ImsrDw5!hDuW^d?a1RHq^
z_S4pAdq$sVzuID6S)+B@KH!{uR-NmokL?pfzR%jRey*i!I+2UMdCj?qH`cqryT*G*
z2H2nIy$keP_&4Ij*zS1P7w>`1dtmvVf!_a%N&7eSH*UZ*5BYA?(P@8l+VI;j{=C!B
z%fzP_cEnt4o%{RAM3)@ePa1c5Wzd%mw@BNS&b=<{2cAB)pY6=K$v=XIv`*`GUIQ9z
z<|;F=tzMrVb2EpzD(YInzU&9;8aTH37I{Zt`^iQ36XuwKZG8u9>drH9ITMLzWPvv2
zlYvg(9Zcl$I|V#To~y*ZoS@-bQNO}Rzl_^)HkInM=_lufn$voAaFNz4&v_hl|Ac3J
z?T^Txvf54=Te~%7eZR@-JBfQEb7*Ve8V%OWd*ySt#QM2z+ADP}jgua@?ykSN8h8(N
zxZYK97kWQ=Pd4!G67MbVcJ<zA-j|~91n<JneTOtxWzm<^Wxt`5{fO6|`pm8FLe9TR
z>(4ppBiT2uJ#f4Z)<3{GIk#4@zu^Y@$$|sMTbtNcuRZ-!nnUbs*YA8mn?8yC1CFs@
za9r(){>h;2xDy(<f8t*Dz<1q-5$`77Pqx)v&`<vpm?tssHE)b>Em=>Ft*`OsF<;H8
zE=k+QXTXg2ukYK$_p#qAi9RQ25odhGT-qdkQ>xQ$4F{}s2hK~fubj|e;kzT&c-uFm
zee=&!+jBg9bKXk(HQpRai+s-Ab!ab)SQmZGcVaHqD)uX>S8llAnQ<Q{dw5~+y!hNC
z_7m;03zK#$*iZYVow3RlWIJufSj(i|6>D&vKYjJq*B)bJZgU>+nV-L~v5R-#H`3=f
zneqC~U-&6k#(wijyE1*Uoi_EUvz@5>TQcTvWzJujF^<*2{cvyH*Y4S3A3M)Q<2!oz
zcOHMg`1eeM!{0cG{Q(#B`S|kvZQM0B&bw#CvoSauyWm-Iyak>a$#Y{Zvf+aDiEWwC
zz*uvB&K~1zpJ&E(Y-`wo?L=LJ&);Co@5bL|O6mSx2HFqIh&AVW<kqH-z8x~xj+{?f
z^XqTi32dt~W<Ue~b`;y{HeApzG46nKvYs9FT5ED>KS|q&IVo?%o2P+!&7as8ZHayD
z9jwnf6Z<#n)kohqv~|$enDK&o?fU6|z#3+-k%_tn`Wa(B*U@w8d3~aOf<6u34aPZE
zC3TMN7}qgkZGD$`{=_>z+v+Q+SL!$5LOvrtCt`mF-DeW?TM^Tc<~^}*Ip-ZU<(S&V
zzOgNyJD(q)BiV5O0{xy$bke|Q*k>~7wB<79j(ItL&MoIOtP8p|Qmb=l&VzLx?gRU>
zy?f$!q04VE8)jfz?hmAoa(+SE1%KyRfn!Q%d}(ptc}6}pS}%29>UUlv=IVSa>ZJv_
z2D9vKu7i8!o(;IHgX|a5rl0Fp$yno>IjGn3?OJ;NS3C#y=L2=x2Q+Z)lSx~$uU)_2
zxcHd&fO~2^`E1$V1?>&=onY*O29BHK+aGYj-1-`0tT`@th9>jxtdIM2*r&~!yAMkH
z7ri!FVZYcXXZL`zqR#U!<H4pc>Khoh%2?)i%+A=k_roz6y9E=ePG9AvukJ7hS>Sx!
zfA_bdPP=}_7;7HKOHSlgZuEotdd$(9t$l~gcIW-O9<(ptEcuP0yfFCgkOk)j^)f(z
z<7Uv1C&s-|({oK-BU#{_oTt)$lKNTJU7e_NkIZ`l+a1&=_SL&4u7`D5r}bX2esL}b
z{9As0LA!n<u&plt{<p2JGU!**b|TKP_Ak_We)E0W^S6uP?;OEJR#N|zZ$59jjH|Y6
zcYeQ-38&CH&km$cAM=b-r~S-RrM?yYoVV-bx+bo5wv|16S{cVYGwQOQ0UPdL(Em_#
zaFB_*{tGwq?-(y->Xqg&mmFyP7Wqd0R=KfPuD@Ld{zh6^^poRnr;xwxKIP=MVtMLo
zf3v<agN{7j11~I}yWsLX$}UXW4Gz!j^0|f0Gb|U>X|F!&(?>ZTv`4?%^}k<8n>9G@
zDPw01S%)@#q=PvJG??5;mpiL@mvMh}?=jyGh2_0p7_>L<ga*s^Aza>#I~d3Yhj-?L
z?)%esZ(v{jll0s84d1<Rcpp#S$-(8FEh`wv2Al7y>9<wk@cs3q+G|_C^`ORT8-f3(
zw_!qq{QoFi{BPA~Td7U-dt;-Q3+8qVIbdxQcHkVv`O1O|u8r%o;DT#<!1WjR;)46+
zp1H4^Js!TNz`a*CQ12PAt?qC(JZGMnJU@qaJzv>Y|Bdv?^Jp&5pt%RMz_#ol`z`EG
zX?>pG9%uMQ-PZm@AN|eU8DB1KQKwXAZDPNvCs%`fE<F2}b#yJ2bv+$p5M%uIp5QL=
z-tqqN-kIJF*gxw}9&?%3{ElON#u|5dCk*cY3#<RX9CT0g>tNjU9Yv0gJidn_k1_2J
z_JaLHz3qdaW1DA?XMuS-dhPnjhWmx#9gj^}S@bK1zI5+;n6L|tJ6^^Eb#H#@U+v~~
z496WIZD-$kH0aDPS+ozRmkAq;KVZ%oJoD>gZqYZ<ucCgyjojw{jbRPpcafD|avf@S
z54UH)^8}Z3Sn+Jmz_zyBZ}&VorL9l;>08lXU+JEgf;#OPzsV!>1@$)=5of%ZbHXk(
z<|*UBqA&LcI_s2Fzl{AR$78HUU#!de-uPxyUu~U!lJicPdS$Lh)qQL0yMlpqeO>1X
z4ZL?2^uRl8c#m->&4T?W4L|*jHHVxB>UwbT6=RY?yFE~s_LLW0=C|&w{W)It(<l9m
z?O-0I{Yu&#Zxrljj6Uh7PMZv9kZaaitK~bvcgYLdXIW3%qW<Zx?)-ppZ<uGm_8sWE
zCf@VDyE^zT8_){&)!#rrF{TmkJIp+Td}7`i??3BI9DBXYTb(sY3#{)A^O}DJwx4u-
z<f*UyMce@E7Uz)I*KQ8S+b^isZccrTZQz=$SRdC&>>rphM&>sz;|Fcgwgdf*Gl%Qn
zV8-{g-*JiG-0Ghkbb}b<8@bG#V>+%l2XQ`cZ1nDldvhW8(zA8Gpsmu&8Bl*7_>B0h
z?1KH&XWQ|u(RFf-oR4#`K5gdJcYooc&u4YTb3T#Dq5Tu-_rERcn9uvE_Mhz<_tsAT
zv}OOBOuujPTijD$<7eEB9qIZn7~na$?4^6?8QuJyvibYv@OMo2?-~Bq5!(yY`}fU=
zziaYuneFr7vk_<8^WmBO<PJGF8!I@TlhRk8x=u}r^@)9b2AJFP_Nm#k7tiKmeCN=>
zXRyQJ`IH6LD$dcr$)vxaeuKWo9WYm7U$nh3(7&PYfy|Rqz5bUm9lOC{eG~hlZNmlq
zjgtfBn!!ej>yWrE3vOUL8MLK=apvh@-kLjYPrEf(leIO-x|Q}PT+q*a%28sp>zBO6
z>+@uzyARaqXO0E^!R73}p`S60SaVpPbyn0R>JPY1u7_*4z&qaaC_W3xQ#X9xf{naE
z_gw(1piLhc(7=2XdSE+sH}=xntg+U)(GBeSU-I}Y`CR#Y`JC;7{ol|(eL8K)=eSD8
z@GjWU95bF@=j42>r-N(QtS@T6?1g*co{hMdCU=nck@wOnj7QtPw8G|h9GM0C`slmB
z+>Rlq(4q#<m1o2nKWk0>?%4t7H<+vQP3%j~f8rzU1#{%uj98nxuddH{psu3bzOq5C
z<=`w>x9jN~Jo92(-3)A>(7Wy%oO`Z??aBzBi+r++&9TgD{tdTae?pF{?<&|g_W<i~
zZ^U*Bz4nYdWt_#lT?5zRxF)e*x&E$shg@&%3nn^!25h*69{Z`z_JR}GR&PuL^O*le
zUUQ5697DfT{L-dQ>^J>+Mr4Ei5v0xeNiTl-baKqdrMwYm9_@}{-9FEL7x;Z3r(l1;
z#YaDxA=PR3`@(OH9ppF3;BP`%!9`Y5U*(9Hh7|KUhGTYW9c677a}ej{{9I4%;@rCP
z3m@CsH{6i6N6?VQ$OQe(oB7on=YCs@b9Y^=E!V*LJC_Tczw2jkkcm3&`c<Af`$_uQ
z@5GCFp1kP~eidV~-}v3)$(wE9C%cfkDyu!)+8a1-&L`*LSlUFt8+3lV`H6*HPS83z
z3aMAB&;E)yW$KhqpN`I2tSReu4{F`HPWo&xCUZ^3+;G9)2NU~A>Xa)urL9ieEiu{N
z=$@oaX`JyV@V7{rf62zL()g`Z2CN5{{*%t{!GFudSGs4raCw$0K3g)N!Qr`+8Fb|5
zKJrcqhR-N8*gm&`?L^(-xn6M(T%Pj{6AsUR2k%So*Xwtb@07syf(sM-!0&Tk5Np0(
z#<7N^j_vq~{?9tBC9$Sv?!42YK5M*;E!Jus)@x1D1M3uPPMWp*z36+H_viK<3WxXV
z^4<Ev<^4N+2ZP^EC$KNsS8DHY`QA$W_DTlriuw!2B=*%0Xu;v%>XJ#jqTaqTv7dC>
z-$)<j0mpM(*>EB2s`IM0L+!55b$wVr*U~kevA!2M{O<AlhqZSP+>h&CuvhM%dwRe<
zcmMB$QO=iV{DRLweGWWto;A<a8`|_Se!(r+mjU|CpyoN$AfDNZx@T_lw8)kDl<DVK
zw_tyS{|rBU)oDxAea2&bTrbzHvgrHFxQ5o)@o&VtPK$fQJLe*&Yllt$!ydR7xhM90
zuFPW&<2U}(`^tBO?+Y0HKV-W~+Z!4zV&ptx7xCvGpub~gZrkemA8G<+<zRaweT+#q
zZE3y>qMcHm3|NIryYoJ%O!~>8E%rO;|BP2x8T2RPJ4e^++qw<rwqkzzTdT1(*IU~<
zvKH;DFlb8y^O;xrgKzruOZ$l$2h#b-jCozZh2V3h;ysvc&!=Z~1Pz&Z4zs<&FXae-
z`<`?29dMkV7}zC!j4@XF7xdBJxD6M2oN@O}8grG}cK)(oxaj^3nRCV%4Vks9I7`YN
z?J8|QS;g;Zv+tbWa6O*9`8{>U3~1o`=K5duQ{2}94Lk>8Uw!4$7xylu?aY_@>Q{A(
z*Z~c4oRsRc-ybknGGkojd62eV{B5URd4j5Yw)II}r!Cef0~%QWESz|!45Tbj*Nad3
zt9z2RDyxsV#JoxE5A-wMWxnfu*UWgAUEVzll)l^4SDSiKcY>$gzB$e9JIt{h(;Bko
z&AeP2*Ju^&s~3Ir?_jJsF1gItqW;f&)^}~ead*MK=#%ZIJ^KT{MBNQ+t8amG?}76b
zbx*r%IY8;U>0_P?S+ngOdCjArF`I9J<F}f>FG1%UZu>nK-*zj$=>|Uf`90T&TMx{o
z-h4_?cOmO>eCt`kL5k~~Ypp%&)=&M0+*|i4_iB~>%6(J5p>NV@n{z%;mo(arU+Yn)
z-S`77&dw}y)4m1InykX1U8y$PBgj12e@cD7p|7@-womAkN!};Ve(F=E{hO?Q*{<?i
zT-EFU?AILCzG5x|nd{`*%M9G3>wdA1i*wlh2If3_w*5PB`S(o0zi-t0_l?g$^Y2K{
zy|JE4a+$NT=u7_r<C3SJ`e9!4$Me~Jei`%gEXDJ=sKfd<H4W?XxrAQG=hpd&{aett
z_KiPa&I{&O+HasuY>z-&<<d7!R*-p&F@8b^$6nCDHJ15c)7P%AapuS|%x~_*{t24*
z4oq;}Zo$6#2KpP<!MvH<{u|miG_W4)S}+Rs)t^$YaRbyD*9-b4RsYsDHc5NNDp$#6
zKYf(xmp<waIF}99Sl7Y6`X}jkSR>ca^}OI2^|_J*p4(*7mL0S>+sY9v<OOBw^f#`9
zImP^rH(^nO^*N7O$a#&Z-<m(Z#F)!5e8zm%c6lCs{*wA^`b>W#{W8vc0~*YDj-5{f
z=Thh3+Bpx`QaV_xb?2Piw*fv29lWCkTz-ey{`M5ow#=X*CHqggv0X6NiM!7HVt*BV
zi?d{H*6bQOC+|V$=vs<%uBg-AgG-ELKV|9{wgC+`W4K<9m1{O)?{nQ;yH?0`T(Op$
zdK+}khUeaSxRw_@FWM6O>K8Pq>s{9(*J!d%`Xm{XeWkh)IjzAlPGDQzit#4?9hAnY
zmjUL|W*wCi`<5~KUT}=T+*}9O=YnhKn!3gZa_wjAQA+o3!3EE@a)5T@<e5X=js0?*
z9{c3DJH}VH3i`E(u`U^rKWno;(O2K}u^#<a_?X-AdW>P5zWV4}{ng(xUW>W5_-43B
z*)ZU+4l~~A3*TLG8hb$>WBe9re7ndjY}%D-tL>*xBhK%j4%X8kYjIpzFrb089p>j8
zUDKq_x8sxOEA}UB$UOGdugIrV=XlQ7dUC#5_oZI{u9x+Kc70pS%emQ}p})wCe@bm{
z==Y3!j(zY+-hSUm-Q>59|0$c;#NT7YzWF*he%3W;i~SSmlNhrh^C-uIMPKe;(mVP8
z0p>OTC|Hv<T6fm2P9Obi{>fM;Xn)%0zu)le5A?DN_78D0ur2M+e@8#rg-bi>{I;1a
z+JDQzR~o;c%7p#GMOPX8TVGQ3+1`;O`zbr;S}xB*vVGoR_<X?exrYvyXKw_}=g{Xq
zuwO~PRbuq*FnE@?&p-D>_dewAJl@y5H-_(y!1su{j%`B2Pu~s3EokI1mpKoZe+G_M
zQQu+Vr+-DA+{ibhKF4sZ8)I98wJH<))+ZgTS*(9R3nuSI-;oP^Uv8MtVey_FaCx_G
zn1x3B@XfS>UZm}c|CW|ieYVr~O>W{xq0vs%zqM1R^xyY>!hZvNlK#ezU?b%QS^r|b
z=Yi|vdR=fG54f(f;lhY@@9e<__vM0nc3`ugd7j*R&s1`0dsaLj2RuU+b=n5#JA)Hv
z$J}y3oqnE0pBJBx`;h8n6jFE5`7HWOp1|ky8|m|u_1QM3V>Q@OmpWqxxo@yz9BtO`
zTpPG<;@lF~z%|Kvn*S3QHQVmw`1r?j<6hK#Fuy*X81Jdg-9NbVkM9ER{26Ry(mFK-
z>h$TwPuqYMT;y-0ukttFH+#kp;*-=}bo~!?{($zU&p{{6_XUh#BPIKdwtmJh#*z#6
zGrsyx^g}<_Io=P-%i1^AQJb;Jp)ba5FxQ3~Eaa1cPV^UJlTP~^C&pSx8A0|>v1`ly
zw{G#=e9jKivot+Zp7A)(o>kk+vx$C!_C(#mrcYx3>6iXKV?IACo*&P!V<v}oMSX`G
zF~%7$?SZ-l7mP8_U{21<y^_v6Kl>Q-b`2)%;3AV;%YP%ymANPFR>-xl(%Qb!v3<js
zwAHz)%f50K2JQBO`iegGm9D8w=-^tr?hV{yrTrV|qi=F(i@B22rH?XoDXXov)1J9T
z)T&gcZx3wi|K^+i+VrUy_dlT%m*je^Sf7S;y*jM&?AXrdXO{IG_#68Z`n15@#%KP^
zbG*Ulxji_%lYB3A@ckkiM$nM|_Z`OjY{olHy*~TFjlQ-98EbpncN}VPp4Mlb$)=ri
zP}+ae(HT3yJW2L9I+>2~GPg?&&Q(^(>}#{eW}VElKTxM_1W!M|XEJ7%b*eEL`zAA=
zvF0(~0KWsSza#m365nnuu<f^8M}NTYY5fl0ahsSG^_VX)Z|2VY4Zmd2UT{ln)_<9I
zuA6I@>*rj|X%5FVhy9NpzXR^a6Zh#B?8}4(j#YDaa?1qAT5w@HHZ|N*pRx8odVH+Q
zIP0?R#rc^p=PS?O;QaklGWMUy-^N(f@#LVZ<UOOD<=(0K+BUZKzqRWa|Fpec>K^DW
zYc4x*52S(5b$4IbpU*yVjy>C+_sQQdJ^mh4+V}ix_uPBtkLQ6s_YAqe=6u6(D*AS~
z#2Gt+hO8Xx^6WSU=g9F!oUO*$@^7eZE!4EYXVV%_)N9SQolj!FgMX_f_9tjdKjnZ6
z&e<^<V<q-0sZY7_y)UTOXGOi6{Nh;Bz&fm_!}4#+f;w&bZJ1G)c{}T|+!t_t-td`}
z{Xks<<IVG|-TY6UJ_8@uq{E`NQLuj>^%`%^R^s%jn9Kh90qy#|G11HULfX^ET1M1m
zZ9j3byH>8*lY`Fn6xVhK7wH*ZFL=JiXK{jO-upBew8g$QeL5Ipz5$No*d46T`UkWJ
z>STkpH{z_#JmxjOV_on$^cmf71E1d{bt(0$4Ejl<ZN3TSUf?(l-sWRX&S^rkzL=M_
zyQl8`fCfGnr#vh9+zfPYXjiX1K|WubTw>lNbu(;^+o_?&8d|G!a9+7)&f7Ux)TKVx
z!u60|WNn)>*U7z+zge$bH`mT{k?Uv8*1nj7TyQ;I*9|wYt*(LgjA{704$?zzr1}vo
zq&)knzu3f_GT{WawKXuWjEDaU`^4t{xsQqc{)jWD^Kee}%=`SfmY%`7w(9JwU*P_@
zZ=U-ZT>1-k?45gLoH;!Y`+@sWN&7`FKEpnP##gK(Yj7-UIZ>B-+v>D6>Ji%=u5&Ox
za%X<))HWV@jH#IG!eP$!{cc}eiw^n>&_7wUwHvqL7P{X>@r^Rjo9p5)#;D5}{Z^21
z_76<H!FIuZ1MT{nr-3<pjA30epar(oU8sI(*QWk}`NXz5nPA`XHaK?Hcd1AG+jl)U
z{v8}>8!xD@w#=6~e~QW2Do>23^mmK-7i@egHKyw8?=H`_eovkKjDO~Q^Zlk9<VhB7
zxk2yDvyl3qWc8oKek1)d*LoS(*b}rr?Z5q-Uh0)I=pohVKMMBM&!8j4e){e|%>4`6
z(%$(UR90}1Z#4c5FPY`v1oPkW^56e{lIg3|ulC>C&F9BwtT1Uyhs(3JeBPi1hi7yK
z8=0i;o9sT@aJl;y4A|U@-Mf)Ha(j1rm-7xCelLaW-sjrzX%U;blrz{!vCeEOCv-Sv
zT*t0l@Ajy}v2Kiid@s}9piViUfwsiH`VAMXSt$c1zSnmnbl$1UckP4A`!w0KWkL(;
zzlr&8WJ#y(zoF&7r&Xyw?cZd^4t%9S{(D`@{P(=hzwITdJLTU4jm<o7Qo9(Fc`pB3
zquHL3OCRHRVC@H73)kh1i{5puYioP5-otMla331`vA{iQ?Dgl|akh@<E6%}2%7uDP
zRyjA?^qE0JJ~8KI49A&_cRUx4iLYnU=W4+PpEvQ@OAhTPPn*y1DA>>ETHpQ!$E@h5
zf9AX7Np|Ga-)G8oaNa(X&SwN0sqSOb2j51_h_P}ErMiQUYu1S|&UN|dur2M@&O3ek
zZsxt#x%cN6Hu@xeIy$kxp>@U$7E*2@b$=sA<f-zfxaw#72K^6Z{lL?2;w$G1+B&SL
zuOX8Wy0j@1ZLZa4t^JOQGv)eU*5CEJ_~h7i9CK)M-19(PML$_Ef`*jrFWQN^2DyLA
zCuvtd!Lu^_ma^_(B9CW@d40|yXY+F2Jb#C?r<|bfbH1^A);+&s+w<HD>hhfWteC$s
z&J*<u`WK9Ky_-4WIaF3=(d)OteCEyZoTF{!h70-J^jI6$C)u=JySjeaALuLUpM7;=
zo{IT<;jkCqu)eg}elpOBb9v$%zmdMxKJjlayy*|?Dz0x2Y|D8e^O~!oKK(O3WiNU4
zdCM_~m$cd5!40XdfjMTO=1jY~CpD&HPi~ws`{|Q5rFK~`pn>PKdv?9Q;q!b%TfO!j
z=r6{~dZ4a_E!+0R9OfV3bJ@UmhtICh@PG!BXWRG7=e-;6srGnh`QA!Kv0d86nj^_v
z$^)A*I%7Jvb$BP-z}l=a=bdv|)PDop0~$D|3HlqiAag0rmpD!X=j-^+S!rKRLA`a>
z^{{@KfpZ!7h`vf~i#2HQ`F`QM>BP5_{T<&>u9<$B&s>dorA+8>!_R!3Sii%r-^Rg4
z`i&;Nv|F?{au8!&)?p2fZ*IqNTx%EGN$OH>U1E$<KW!Us!L<{0+8T8H9n-OAtU-?d
z%w_C>S<Zy}dJ3PtB(HN?{++-#>*3o~dBJ%*&SzZwti`-5>awQh{P8o+@8c2Q!-ss<
zY3+{VxSlc3n|SuVQGNc#*E|`MXW6k5b@I%$h?Dyl<o)A)l<hZZt~b59=Qxi2hJNZ(
zrq4k4Mnj)-bk4Sw(gW9jfX}Y`_SqZu&3$*TrPKcGn|jWKd%xJ<fxl<TeOz&V%xlgh
z$9a>+47kKk&q6svo)7Es{EBDIGd<#*cWa=QOHH1~7Bz3`^~`nn{0-*03+$_(pig4I
z2l`Y$ZRyuM`>`IbiL6)~*GKFpopz$`fORJJMVq+R=64*)ajn6c7L1U!MtzOzk<a`a
zE)3S_H(bX9u4zSm#+u8VG7G7@=$>e6kaHW<DAudoa6$V4eZ{uA4*JOWLPIZU-?Zfh
z=130hN&XEtu&u5I`czV{toqtcpNY?g`xm&buCJWHwV#3ar+D6F!3}&CWWJEkiT*NR
zm%NTOz&aZ^j}CR+7JY5bL*ErxUn8Gm`0RV<`^<jsj(C3Ur*5E=9oTL``aR_&z6X~v
z9LIZL$6Qa$>r#vJYT%r#v4b^luzu&^IT+xx<a5*m+u6_dL6<aQToc#EJSU{>>^p{N
z6WaqWSc`R8r|Y$tgL8BKuES60<GSeojgHNn&-HOE*C^L%&=%Kf2G2Fy)NAdNIV5#H
z+T|AP4``rohsAoiZn>VD^^}25TXJc?@n$z~#kdjZuk8dAslBOZT<^=|(6+9uM?d|o
z|AObo^||1BxqhzYPwd!N_bT@@_b&IxvpZu?R_uji?6Mav+BvRy-Pa^@Sc^HV&79gD
z$1!)DDccomlNsoLBe&xu=Ifw*;`j@UGmrT@@9oCBeuLj0t6=}4pWr+G;-A<*piLj+
z4t)DIQm<XV%xQdwnrlbC5&0%@vLC3+eCE`@<~3*5x=Y=uQ#$r@d~=v9^I1=WgRj_@
z2^;h~U_JgVEaQb$bhZ8FtF8s#?CRGqT<p^Mog<mFf8u<xtFJVF;|Z!h<DWYF>0jlW
z-!n)055|)nT;$)<J8KXalkF-O_TM=8JZXR0=il!pQg+Dfx3DWuiBEm{?Gji0v}?P+
zpih#%gMSy4Rj9gyzVq*T$)qhiX#9JhJpX-g6<zxLCNpQ}xw$@{!A6dtArH^ye9(Pf
zgS6Sd-h+koN%>||w_tl8dUtvkb9b+x(ZA5Kx5#b2862cot7Pp;_4;+laRxceBaSH(
z%<uS)<(QrE2k);|IKI=M!{$9VeAflG)m7BB;P`Iz9SYa?C^X-lzC)o0wkzuWcd-@N
zev-C<O>X&jHUE9hzEpd*Q)bM>Pg=o$%X^|deXHE)D^J_SF8XL|1^cq$2G+M?&aQ=P
zv%$5ij9Al)be%W2_7^7m<vwn3U-L{I&l~&hnMm?nDCMd5tQhB6`G$7SQ~K?4rgHp`
zkLS{J>pSZU8+|4H4$tiZpWl3jH@Onee|tguEoA&5kGUO7*<hj5*E~K$u7&e=-aaSJ
zOD3H1%-VPU3xA(M$8;R?nb-U`u&rL75q|m%-r=41<=|b_c}E;*{lBn3gS2hz$tb?Y
zslU+w{5#C?jUD4Czxk;Dr!}lUtkDaZ$DA7mv=>~TT(3_1vZi7?`;Go#&D|IGWXB#%
zzgw`G_kv?8H<&ZyGoQMFO&Vxl#E-ys`c7<OjOd@FPJ5-(H$E}n2pV!zuQhvioX-O1
z(%^EwJdd8sU7k<Rv(KY=z8iLZJoEE`@h#4(=XHU3Cuev#1~{f;SJX)lvY%4Du^Sqg
z&%BP&0^18Zw(~Mx=2ABI%{5?6>iX68W-TSxJmu(&`(Qo#>8s2<HMi~lz*?T9PwE#w
zl|jGaoZi^zWd_+--oW;R797^;jkN1q+4SGI=o4$Toqm&cd%<ztC#81%cHz?gMqQ5_
zPhaCFG^lyirC!@l824mFt;!yFR`a|L+R_5s8!n`OmF5w3`sh0f_SI)h`li3Wo`0VM
zx$#{1oNS&?pW749@Q7#q^IVr_zVoani?-Omyt`zFw5|R?Bi?)CLf#LK=eYS?PU^8X
zW!7eWw$(Li&-pn=u|J@}dBmDm2DHF2XUtQXHKbi#&fhv^#5y<!=aTc8F(>C`Tf6gZ
z&YO4o<(p}NvZ8JT4VkE0#kTqOI(&l-_<WQ3T^86^@AtIv#@+|kAQKK)*8rvcB=sBp
z1?R9H^US$k=J;fzlhnIjm9#f}%xiwfal8RpM@n_t^_|3+>$nH(jr*DB!TlEd?w{kE
z({*rNE^D+{BiE;ueEMZh^NPC9c&v+Sxxjj?qlLd`qmDmg{H!C-pncm<Mx52(q;Z+^
znd`UMO>A;$OWp-<@^5^eaT$|x$Cv~88x5aivrd&sUwUxZ(~4^^H=fbsSz?d;8^z~D
zIqAD!?PaerzjDV|Rrl2QQitPu{yup*FFnr8b}X3G;@R_@<vF$%&!T6kLDuP+^lbVJ
zH_s@4clF@%_t}%QrPTi$2U}w98RK|YIIf&8Xd8iTIU#M2ptf&};aHAqUA6umI&HNU
za~*I^_Jd158LXSQhRLBV?tPWo2N?UznSE{gi2hI1>odW5I=>y*R+m_RwtMkyu@<==
zN>N`)-9Vpg+84}ce(SKFT4&a{(Kpa9v0q93!bh@SeI_xo;eNp}pXi&qh5dkg;<?{}
z&w~tD!9^zO8t8A_la9{3=6AdXoq06YXnLk%U0pZlr+tII#u&fBaePKUcRA0i&#m|z
zFYq1Uvz<)ZVqcp+$<w#mJAQJ>J)ptoo?>ik7%|_RXPw`OIZkSK9?r+J;M|<AjOe=t
z2lU-=!FcC<AoHi(u@3foA?+#mW35~x=dzfSYq8<N;6ALV6YaCmXy^Lmx|mZ2G;n>~
zo6FkNHL@1#>Vflej?Ptb-r0ZZs@=GXz7t%-8|&)Y=K890jaQ&wlDdxWjT)OVEyi<P
z+0oa&8LL5_XXS}=J<w~v;8-7jVpr^Oi#6-9hOXsLxaJq!3->hlB=^ERxexAz?HReN
zZ4{e(xFhF@bK<@`jyB`WF=$WhLmTvXpZjhV``XN*Ut*pWboAO2ZJXSVA-45Zudhrn
zulXDA^b3pckOTQ`V_TiJ3Hpic3nT3MP5$;0V>3=^e?$I_Xj|RFHo!bPayF#c*RJ0L
zW2EM=ugx*^O`d)A>Jt0Op#6;-by&|~jU;O`#vDCr$l4Zv3s=UYpEmV>L;C+FFZq6=
z^BY1kX;)74mD#TLXFL6xzw-pCdrIx<((i9%^&iB`h8y($pLWXBr&PZlXdBQ%?#QKH
zjCsZ#bnVYO6MeF2|3v!zCf{;ga_7J2RjK}O$e8Mzy2ZZ@o)>!gH^Tbwg8rM}lWKpq
zTm0MNQ|7a@yw?Kny&X(s`$FDt$`y3v8)-k--}p9$dTaPUq@3H8ZK<wh^;u@HKdS7&
z6imSsOu-aPsnJ(zoTkf}b4BdDAH4}AA;f#do-GqxMm~X01t0oqqI1{k-sMe*gtF_r
z;k&%ue*1>ru@JmzGv89)Io`WS{0_Q~M0Yc!gI2K4dj2k%qVo+bp^OeFKM~R|eMcLj
zC0pOvDo^?;pU$^9eFI!#T%d#V0PTPn#=5GfT-)2WrLQ@mr>~LFW~R^5m>45tpW-C<
zTr&4d9M(YV#rpA^iuIjZZ{A+sUG~NjM|8m+iLytQ{Nb=K)Q-I~gr&>G#AhV5p&X*A
z-@1<udr5lYecpbZH{P|KZx`=Z1wHQ?bm2E}s10u)`24!eIc7{D*!v@)4ComzKD1p|
z|MYn>cEc_|+BCJDnjgl^m>DDI1sKy3M_^-)7~iL@V$laN83SXX560<tI`m$`6fNH;
z-h}&I;BDw4gx@yGOSJY6Gv$#E(4*T){Q0Mh{4GPimEX2=pH<E)7h*Z~9k;flOxspq
ze2l$|5Oq$_8QYj!|1M#!nSZZ0>%-ch!-rT)G3bwe-8VYo4cUnYl+ks89jFs0#3*Y`
zzv$g=tL+UoeDJNHyTRT?B;-$jjH`>mxU`RZ*~6T3v$R)%dKX9doUnfn?bMzaTZG~P
zW%Mvp&m7V({d>&LhkCm}SM|)lb0$7<>EBRiJowPh4e^-==49l&vL<h^PL;!&74E%O
zZIoBiB~4@*S-IEvH+9Bfn#z@v<Lr_*NAplws+*B>eoO2pA>K^3<W0?k@+eTppY~l4
zlh_q>*znonj_11Ly8cZP2Z;HNE<2FJ8#UJ<zb8Wao7->6r(%0Z&)%I$ONkB}eoLGS
zbRqEX*BSiJ8PR#^BE-tKkGIQgo$u+hu5-_O#(VsEw^CA%ych5%&Q!dS=X|Me&N}&%
zv-2i5ppLC2l+oRwZ-Q9F>`6!(?tuz9v<t>geqBUD&WyP$|C3|ko}-M;`k{IV#@qz&
zIPdw;yUy>G$?vCxGMtp?Lm(^YVCnbQ4SrJ`!S5sb;WtFj-w)(41^F22(7s@wEg#0i
zxL}pCbw|3XIbeQ9LiwiJw)|;BTVhs5=>t7}_|u;CU~O14){%AfIwPOz_zgijuP0@6
z_FrmidWnf0h+&@Uv^f{-#lM05dvmwH?Z2sS#RZ?IDu>S38%s8G`$RdL#3qj>JO@j2
zVbHmZq;6<qtiuQTMW_y5hbo8Gr?H+|SN00~hJDm2vlnF}-V*15nmcy<peG?ofAr&h
zMBKWk*{3J_<=prTHI?}-&t1T|48b|&+y>{CzlHVpRp;+4{VfZtFjR)PK(~@p%IL5e
z>PHZNi*el})Xh?voGR#y{aR^b9TGi#z!Y83w{t<R%m=&UEVZN0E@pBhfqM;@vzslQ
zVO}ff@o&Phi0yKf_~82ncG`9kf_%pdjEV7k?2MOj#{=kLiIdc_b;R;~(Koq}(<+er
zmLA)Y4}L)TuG@wj51>DyD;5y5vQ-CipkHJK9k3o<OmPa-pLAXN5VWoFYT11wry$QD
zU(H{L&A)3%Hq9COg-zf~oF(XobICakomuV+&Ms#-bgntu=K=IL)vxRRG3fCfA`<Q<
zpdV-neFJ%P5rW)C-W}vSls9AUIcATGI^$yA7!&P@>pqbC3;3SWFMS(g!4gN{TjMb<
z#>kkr;GQ+qXF|DxzKfIXN6ruN$dx|mi$3Y!bHVuFXslB(FN~WteS$eNE$5Fpq-^~v
zW&5yShS<4>DA)O(iUG_$zJPs*_yK&5p#2u~X{ZwuANu~B`IOFu_}F0y{Ao87hxuTB
zm@npS3FeTw1m<;r0Xu%Qp=}o-h*ue^-(bi82x1V6^<<5`_LRNGLuK{=dx1T(#1Xu?
zGv8fw*l9yt;?qw{$N?RFb@?o@DW@O4pLWs{XJ>zuKXJ2P`s6pj68yI51?oe3Q+=jv
zHz##n65qRBNDtVW*x5IJw3*^0lq=R-HvR1hu3OI1uB#k^{^)}~fqsFpGtVKIpCNe?
z%FGk<%KRSYS9R>PCGHXAuz$gj&%dF@erjLsp?@=|V54qnTbJ%{S!(l*BfDw(H=CRJ
zqN{q^yB+$?zx}jlhV)M?>EX%trgNL4cKy#kOvxv<^xvRO{{ei=&UlS)cBM@HjUij*
zC%+|s6Z#H#)1{l@h^Fs*FvR`=d@A_6-c&Z9xOr~{cUj(%pSz1YE9=}}P3LS}pu>iL
z1sz~_yQOkvT(Q2@TgE}&eyiy0N8jYbJ-Y;B<9_BX;!X0~hNNCOdbg$s-Y>mnP4Le7
z?c@FH!oP!Wx%4~l8$<Rt_?-yz3r#k@m6@Y5xNg~{gZKj9=SI@_4)=xneUEbWbqr+H
zQ?543TaXjE9l>~z=%?Z?{$Ha7>YeX}vM>2DH(P|}(J-GYIg+do>%`jedxSOJTIa)W
zGwlWT1$!iN?;y=*-^$kI!&}b2p<QLF4%Sir#Ls<0pWZj*;aqy=!Eb=i9?iEc^lnXY
z1n;5YO+<$+u<^#JP0#nwIoEMGf5y0StW)Dz8e`+_RGh82tGts_?-4Y?+t~#<xZkCA
z@YFxCTY>r(L;aB_ZD>pW(8UqN5A{PH^gZ&O>UvvvV=Cw>yhp1*9q>U85h>BNCVvsS
z$NMjs^0|3y7xFbL`?=*Pdix@KQgyV&AKD8u$GLKx9xL@xbUWA8Ys*}-w(P4})`I<T
zq$kc1#NRn@NcTr<V&MzK#~&Z^T>^<ez6(F~Ltpe6s-tUa2gJHTPi(-qQuQGldx*G(
zx<N<3LEr2_?ML<|XClPs3~~;WF5Sm2KhD^_XNh%k97yUR@Pn>0dip0f=*e3h{gyw_
zt_k82i<m>Sl+;6d?3JTBZRv}-3(fmy?j>0p)3qiQ)@Tc)>6Z_6+p2u>d(ye@H@Vm&
zneUK{2e!rp^MbL$(YV2N<V;(&<FiB;A((SR9sLqV&>nVj=S8k&scftZ>1f*o@rc_~
zI{t5B6Q|-fmhQ*(pX5|Nre$u<j~po*>iq&8oWylxPpor2r2mHfESLP@B;@H_(RabR
zwLB}F37-?r?G(H_aCDYA_q;`%?V~f!Ip@p|(FAWe?>A-cg^wR?bl$pR)6Xb-g}z-6
z<pSgclvmn0m$R@lRwGvGPoC{23G}%{m;K2f{YgK@+H#DHFCNCoI2jW#Zdj#^o_Syn
zx>(n5Vd_te^lOs*R_6E45K*8GOPmKjzlCT^4E0S8tO5Dld6TE<D$fUwbZ@-*kNmCD
zHFxU;Y|QQEH;rhC`=XBhh^h53)R*W9b=EA(I<uB<%-kcE><5Fc7pNQS9e1e@gYLH5
zkM=uZk5)$RY2>=NZBIUTn_9QOrENY-u3Mrvy_`Gio}}B397mG`kC(BVt}@iQqHepT
zeehcsw{8?WHlV#BCS|1ADue5mz35!7lGyaeK4kwz;(f?IX3w&JyI4MRI)9u)=z?>}
zIgdQ!O=p#J+(n43ziS46V+sD|f_Y&*J{9ZV+Tgnd{m|b^>3*?|0{&oKZRfVgn=V}>
zTkYR)T<rKC!F+J{?Ua;VN5{N9!JNWMPD<-T^&8^d;6t1B0DAnVXksbf{s3bE#??e!
zkIvuGBE;g~917?FJIoi3^voT796>(Ln;Z?gnlHYvet~@%C(y^u&VFm(tIXR`nLQ8e
z|D8~N!gfphbompD*dw7_3DwDuv3cH^`#MjpjDg&pKQWJ>U(PM>8fTd^?eoo<|A`|X
zXyv`)zMyVfje)M#yXqn67e>+~!FNk2zt4M~^T_;oju;2!mg67}eUO7WszVnc@Ig{H
z=-elgI*f!eZQO3DO#C6X2=3y9as~Sh?V325194aO)g&4F7E^TL`;~FBZZH$Z56p$R
zbxXE!fvys&vq#uBJ`c!w?H$^T^kx4=?m_k;WkdZ2TNg(-F0o8xTx^w{Iau08y{pX;
z%tvT`PTAAUsn=}gnz0sMFC^=LpXZsmrp(*}Wk65-o%2qAl!tWKPC^-IOW&v996J4$
zH+W_l-I9$QKfcO~SRv>OX^zV575wO<i;?3X-%ZY{V<R4MPeMOi@LOhyBlsOOlU>Tz
zJxTm3{yWRkwk|*Vps%|>eC%K4o8CT-J=MM^^x=Mn%8@YEDHuQV5P~^j?U_I3iMeF{
zsAIFwP#MtCmN>+wPjVoiA=U-D-_RcX?pXYdj?RC_-}Y*=Pgk4YFw+lNIjTd|)w1oD
zP5;hQ8LGoh>H2RZZ6Mlz)1?D!Ra*Z|F15Ki(n0&9u|BY+3w>kz3H-n@n#$&6A643h
z{}y-rQN9DN{Kj`Afp2=oI{W-2?eF%;DRzDz^fx}_`hn{EwVc0A_<hm@zv=kR7YXGl
zu;H`u<8IfT$6XdWliXuXXYgi9XKcgwW=Yq7AY_M~cLDdo6HR*f-0{k<=`JSM`i{BG
z+hmr?=tJ;!@ecAPGH%9y${a8c=m9<81FlzHmmWgY-`OssuRc$HL%+|PnEFQ6#nJaN
z<Qw=sQT>TgS$u;l43(om-7J;Q1v>1JlKM#~yG~w=hj9Yq8nQQi2kd+gO!zi<#Fm~o
z_^r~8Ih)BLPFWYqL$HRdC2Pw1vKM%-hxWx1$VkvnfzP@21ABfEr}RM?9kyzxU-B_c
zb#%^!Jw`w5(W5<mc=z;f@pb`a;B9Pzx2@;9h<_LCefBxOB`WB!aaJaNI)k(&4)KV;
z#1Vd*Z;1`?8-jLIkf-zTc}CL5&VKN5KePqn95M4<=53}=bV%xvZ<^nrrZ<K+4Lx>z
zLl7IeO52w2G`_T<EpJqBYIotg{cj}ifT``Qdz00-=CQ7vu%UyVgd{Ky7@~=z@pZvi
zk!BV>zd4u_=530e^Eb-;p&Rl!YDawcYw13T8v<YAc9qG4+?K$fvU9_ie(8%n(*$eA
zdYudF$Yl!J8S1@2Tl~itLN@xMUug8J{mA}YIuo7uN@u<0`R0sM<__S@u$S?7d&{jj
z^h^I0bdjJZU-I69`3K4s>=kUa-c>(}1tVkAKSb8i!xBf(h8SDWC+oyIuvSwX!TOk?
z@*7*WC#pa8T6g(x^eyutHy}^wA`-^&6GJ{vH0gmkVQ#*GA2F7oZ*qW{97%A_x3t~<
zUA`fRN8DDZec1m^66cAdc&6H|vt07~#*iJNz<fQ;S=HNa-J6_c-kZu`-Ohe)NiJ1~
zKYN_L9)few1n&^%)o)?&<_XUE5$KUa@IKCbC$VqYR=!tLaSpK*a|q(oPtQK-_ct8*
z0lr;?ARck)BLsbp#QoDZey|hTQbvcJwzT6tuVZQ&(<;ARw(c_H-!zt8e)t;dAqMx~
z3yy`oiK+XN-!4PHccy;#Ed8e8w~g`dn<abaH%@XSE9m<R_|X@A!WQI7zDKZ*k?YD_
ze1kmz%$wONw`(0(3+5NF;oF7hn*J*6C+6PyjLd^}v?tCItXmf|Ii-x=V8_;S%~|&+
zw)E@`L*3ZFNoUZxO#BLZ>{~cqSM17C{pLsqx88Nzt896Ot+Vfwv=0({ty8{Z-S)e_
zO0HeyNEkQcZ-RN5U%2gEz7Ut3svkj2$EAK_`^X%STR1l)b->mNcP#gZ4Eol-^WJ6u
zQg)qv%HHJ+dH=3FTbwh_o6o7wXy`n0o;mX^;p}&D^6#3#-!=(lI0C<&(AH)2*w+i#
zdTC2L+5mdv81_ex4{YIl$$bgNV$fm7w+mw2peK%*DjV7oqk^vLm+JJ_lPP&b(>w!Z
zgYAhfeFdK*XwP~X>VOTOF6f_p?)<yP0iM61u|p(Vf4jmgH2$8|-`+Rq!M<B%Lp<Ux
zL4V{ia!w+1L;|@2_9pQC20noQ5{}a|uH{tyB%UMB+0uN4_J5^c^=f-7)8+~M>4W~Z
zav+xw<jmNn=;CO8fO#4s1aruowv^Pd)9%n-afm(D2WNWeY&V_t$s3e#{-3bDO4>!f
zUA$kEcZugXw80mfv9Igc!FB96qx402i6f@&u$@ru0zLK+#6-GGULl6&0GJEvJ;zQS
z_%3k-F=3~4{gz#JpiPB1qY%VYA5E<6m;QlVpb6HA{lH#;_QI3hdx!mVV_TOE*c;&b
zlx_?9bH5)S?IreB*O{JTP)4Wy1xID}8@e0xQ$C@7R`yl<xyR-)xqtG(zo(>*ZHcZq
zI?R*ij5TClw_whh`;$-(;d%F*)8=G5Bz4xn^G_eZTF{q4H$+Q`o^_+`%6Kz#q3^A|
zvGgtjZ!~psBUjqc-tmY%sb@ULB;LqzP^KU9MN(&c^feXRzX9lrKKU(k1iyzyvL$cs
zzo%^frhoc-(Cv`6cm1taSyvrfTz}8iI3x3Jl8j}F5R8#AGoSbTgy!ZmzmiRJ<auJQ
z0RJPp+7n~v+<DIEgTCmKT*!|+*DtZ}lz-)@{%>jg+rlpx@_AxQ521fk`3+ruH|s%%
z4|+IPnR;tKQ~jp=pKzS&YaOz-*{YlP6aV>dGh80h!4l^$xc#Y{q4E>hPoeAk-xT|z
z@%^qaRIXsFb(hh<*_Lb&`VI)aFiROdbwmBu+4d;8=Xn!!=O5mPBuaUzj2*wB_h9P2
z>$>ZP&S=*eJ)-5=<a`=*1|QBc{vo&nY2O6reR8K>9PaO;qkdyM`o$f55vp(QXVJvb
zTLepV5n^jhz}T8N8t3QzW4szSW8XOkE>j2Q##mP+wqBra(DQqH6{uJL+m7!LA$EQP
z^fy1gp}EXAIAb05pIGww3CD0;`k{<|2)^gdgfcp8_>uqCxY<k0GjzecGA?{tveTdW
zq74#ya^z1L2}^{a9dVE&ZM547eJw!_^lhffa8jbjk9PD!EaJlw#3WW_l-Qy6#DFP|
zV2`oye1<;fK<8xfp6Oj|;;0;gbL8`b+zEQl6IkEnPdnOI&|!<hQW-t{Z83P0MF{G&
z$KC~f(%%!<B4g2ZiLN&nj>?AmOtxg`Ed|PE<onw7&hgG-CmwmwPs<#Z>LESt@N4;Q
z^`<@wN9Etp{wT&TAXfDo*#_yd?f6z^=G9ZyI=V`z4vY6!@a|9Hd086s_yY6B+%&=b
zF;^qklXay&Wg`Z0J%8?#{!YdxmRXlS`Hjqv+_2+&vQPFA&^P@~t(##@0X=qd>SA4>
z!-fx3fAl-`#3FVG_9=U1>uhwfc|Uj?%017WPyGnq1m1`yKi(tS5r>%cNgw2Kv!sKQ
zFyG88><jCg^x!r~>b6_jr_1g!l1r$*vQ2GA9P~Y*jE;C)46O_6a|CP78rQvr4tnDH
zR{b{+>k0OUd9v5o?i1M)@+EH=Nk{_Y0>;=9#te)fdMTsFmp0%y#9f7>GX0asPMrJO
zSn$K&bd`Zve~a7xTY2}ll*1@QDWj)e@%+@evd*&lzm@SNMk`Q9f8!Wck1uQHbqtj`
z1DwmH^F4J=Ij>Xa_UQZqW!_WHf0tjAKW%{Wlr9SR7;H!2w*~!G(7{M<pWEK#M?B(2
zp{tCZI5h@k^w@oeF%H9c85{Q*W981;*KgXX`^@-m<9-_nWx$4C7fZiKAW~-=b$+Yx
zyT!kOntt!_yQk-GASAktp5ICGr5!Q0`XR?V&zb#nNeJN_oCo?N$aN&dqm1l|>-+k1
z$7^nwAD|AdZ<Q;|=gR%TTtnoX<43!rd5*HTmijaF9m4rg#>Tn~wV`d#K8N}t_7q33
zCxG%3*oI)=^#{BkpKR!CUm3&ozmdd&`NEO@C!X5U=1Kpg!}ouKV|K*}!F&L7+r-xV
zch*4b1MG(z+p4tBkiW5xcvBGjH#iR@dBG}J*Q9&GebDDoJ|Wn<Eun1CefDMU>(5?g
zzvf*sb5E~4W1n-T^S8w;e9oor1nvdSdKX9M9ytGoI`;-X_}24HJp^{>0)Imt{TBG)
z?>5xYzkwZ=ID&kEG3<mgI(&u*;dnFqwzM8;KWr`itS63R;Rn=@sC_rhuc`Uq^F+^F
zZ;9^~j%A4sU;15{Lr4O7J9qMDzL)4pNCJ1c87f0dj_!Nz|C=ctoW%aL-GaFEa|C^p
z2RRL~Qc^}|cKYF4X{rOdE%2x9N{*yqE?^4gXo!_?Z+F4oKM7^iRsM$kZh1;P%Gg8D
z_s(3%i5!Or!8jNXw1l~0&X_;u(Q~=b$!Dn@<02+_Z1l(5$QkDi>&cR=9Mw&|Gq^`8
z+#$9jsaLk@_%Crp&wG%2$#>K(u~lsMJ?A<;T@ZT+`l@}Ce+b6QxV!N9J9_!krshUG
z;=)cS_d>PdLtaSef^h<IVI(0*e)LOjD<PK<zHiAh1Z&oEUw9p<do7pB23;$@to=8-
z>^J!DY{%aFoJZ}g#lMq@(D`kuv+vkvhB|~`KjP!FZpr?{hrLNZ<jok(Jq~<&fxH+a
zepBs^U|oTEWB#V_nzF8*=fm8pj*c~eo>0ctX{$J0ah)6eY=NY2@;RCpWGlJgQz0L6
zsr|WM_ZPAs#b8`B$M)$TJ-KAQ<he3e;*l#7{Shtq-N@etN7C^7hTl3{wER13NrL~T
z`nS??s&uTbzZsvH(nGa{>ckkCAGubV^sdhw&n>(3jF~y$3^FIoS%tZp(ntE?PrDk+
zah7b@vC%)dk!Q{OZ^|>rUFAs~@^5JRcY`N}^p&mp-w^t@7}Hg*EY)wS-R0ZoH}#{~
z-*Aj?KG<6OhbalW5P#yoz7wJwVkJk?pred5qm-?Ck|+I;6}}DD?}PQbp1<W)Ij(Pl
zwuQdmRjhxL_Wfq>fBQ|ad{6w`b$LHF-D5p}uY}|h=(yuP_a}aNH*$}~bw=xXb-Bw2
zeD^iA<9_U7DHid#dwas23a(G-Z?NIB#7IJtJjs_kp4@v%>a&c4Hn%^%ylq1qy>peR
zI&WVjOK+jE?n&ZfeOKH00DAmJ(ylUfv-5ZOl<fQ#*P9OidEa^C9~jaBe&9MX#O9k`
zLjA@zB(@=zID$M3I(%k{g)jD{aU6}+bIiCmdfD-b(w6qrkC^iLHYc7NB)*?EYQOYd
zGDH_g5OZWq^1%;Q%1<uDP+l$ffY$~aZSV!k=xSc0tdnzEIp)ybVqY%pJN7dBero@7
zhBzC%cSG!a-@4u|zhN!kM(Wm6w*9D#&zm21u)lrnAF|Q+Q65u-SjvlYN{*b<qkNIn
z(K}~iZuQOky2N<^eF*%fus^=Mr!C*ZtunskN*-H%`F@~(a_X|tF7mw?O@6;5bf5oQ
zy4v2<Sk7T6mr5&j%7*uDiv9xQTfG08lg{r8<|Sc{U?i?1LommzORzR&Kee2D{D?{H
zp+0I~*l3S05YPU!nF-~SHtaCO&UW-q->f6+Hj>X8N{9Xk_T6Vq<?lYLBo1~H8MkHZ
zAckVIFWDnQ?0g%z-?{fWd)(=q=_R=5Ig6e5;yR1OBRAsH7yT}Ag!7sj<4z*S&DfcP
z%E>ym5VWf?&@FKi%0q;}mp<t~l9f5oH-6^HpLu0|dqSPQkJ@qG*jubUWneE<tj7md
zf&FsR%RatsZ*|9XA5DE!$Y+ZFvey_tbK$vSzJPI}!^Yeg{9%bBhzs<wh5L3sE64nn
z|E;$_(lOdKrnkENf0C=je)4S({V_IRoX{_r3(twmu3Msiqbc4u+>Th^=(2|xS~u3Q
zvzB?zxi@$Zy5NjAom<ZD=Zs6Pd>?#nXYK=Hu@8_nZpaQx@i`lYI{nhVg02#!ZBrZA
zI%{TLWzONz7=ZE<*cj&!A$+HGjV<zC<G#8XMMwE)KA4-KJC1wKY?YZWY_mWe{Yu}@
zZxw$3=(h{MX+FPm^joL?R+_3~<F^ub>gJ9u@tg8+Ud|mI{klK*NxLS9fuz0!c6?zb
zN74{)GhXH==k7>)ZfC9mYcpQ(y3vmLCLVqD?2kT1_QN<T_}bQGYifVz;T-6nJ;NTF
z;)td_`8Uw!Z=fHz+x*lg=j3KT=<I{dpu5ZH-l)EBK2LhLv#dT%{W0b)mgb!`W*wH+
znDt?uKWoihqWTf+8L!n=nKn1*0Y76MzC$b#>h~M?82gbc%#^N2#<Kq{n_`gzV_1pD
zgRJ_YdWfCl=iIPwy^ovrv(FaN=YX>SAvl+u(W$d~^7qt`i~{v_aa8YWQ$Yv#x=h?%
z?g8!sL%+WP|0T%x20ivB=!gD#;vC4wScgP6F3`bAh(%1|(+~a6LRT5kuk^vMg8mKK
z8OL!fw;@&&`(a$<AIa9;&HW8caNom9x+FxxJ75O){{yxo-HsSb96>)@kjE->cCW!n
zJAUy1G0<Z_!t>7D!%jl;0L+P5Dj&i8O~JnB9$$j{oip(be5#-8RoCS+OB`a;$5wyz
zOAh4YJe@aVSxJ`+F*R1^4H!52gI;4K24lI$LH|dLe3N>)8@Ll-y@0LhPN~?x%l1S_
z57>^N?G&N=Y2<x(B;W9TSEYTI+Jzt<vFU?5tO>@+yfS{~6}bgEY*XMDnG<n{cP`M4
zgfg6@=H#+%NPNvu8Fr4p=F3_D`LH%YZY6i}uVcW*ILs<#Y>X3TwqqZxgnjWuwTFC~
z_RwcP<r!Z(w}$gO#mIffUS$7qj`5lNyBYt^R_M|-**fv?Cw}Hgp3W6r)l)ttf6DkW
zc8{AeQ)k|oKjv~5SY!4EbIxA5_sc!!#CJ?2ISlp7yuivFR`yBX_@F;xXMX5uk92PC
z3m^OAgMQ^+WRFDd7xoNg?;9k#m9X!&;CIeS{F{e5e>d^>(-bGEf0J2P<(8kZuj?~o
z-O_fX+dRpkzX<`G+YqaZbLAi8{{_YkQ#5hvyr|5)HO&`m9|?8z_|lg6qx69e&>cZ;
z<Vn8HoAMj@Jh7zzM(FQz?8qm&^k%C36GuK!{j7VEP5(|~hRXW_ooSb^^_JECR<<v)
z`c!=_?<=2Z|DB_Ku-Sgc=&~(={0aQbQ5o7F&8gTT^xf|_4Ee!Ij%3$2z%81-w;AeB
z*p3{(@PCSN>uSuqOdpk{y0N}V$2pohPn;=3-B^d@?ydFTmT9*{7u@OG?c9}}`!erV
z?pN+m!`(VX7u?5#J6Z1yzm0f%_`SsY#ar}wk0iI=Cf+ChEyGYBB4o$^2;MwX<KSbu
z$}q)A@CDbA*r69f<)uDv$iq5(ZtfVaPx;>179|d`>7xn8KVRt5n^5_NH{Uw@P5Es>
zZ2F;JazN52_7MKP(9<7Z{APkbafbT%e7np4hbaFa(VMC7dLKXe*M5l!Bf&;Y`fnL`
zC|)F#SH`DL;=&gAA3+RqJHqQs&h&$ADmKv1P#rz~rmJkG%5cPHzi7YmJAu6&x$mcB
z(>dTwOr5R4In<lg^j<CAGQC$w7)8fhc0_%jsCRVoYl+*S$KLcVRX_S#yq|g2eMUq1
za6ZXzDPPW^&miY<NO#Cx?K&~k-^@OU57gfv4|3lHbj11OqrT~vzTDsE&QPwQxZyXk
zyd}}37x&v?{g4e-;izo-AB`p9UHFFmEQztiD6y$mu!V4bQ@NW~%GNE7k@;aRyZFqF
z=7%*k=qNYAT7K3-bHqN1l*}jkE$}_~DjxGa1ak?Vf8rdq0m>nN+O32-v6>)u2=))M
zi<3|u?2p__?57HQjQvL2Roc;>I_*OcqX~S8_1OoC)dYLcuvddU$==jC<8SBA-zPeI
zycL|k&)dNpl6x3`+8wcor}*?q|BSCPRo@A7V9-$>$&x$?>juns1)Y7Wq-`Yb%ki<%
zZVRs+lDNdcZbpf5$~<<;vJqpctr?|ko%cnRUHb%PawMO4vs+(f&zK<z^xp(I_A)k)
zX==V16Eu~nGbX@iiIdRYOqI7Fc4epzOE?GTG?kAzrHt;b+t0GgCkl>lS#7mUyMIHC
zK_5?y94oSA8Tr43d3}R<hyDQT#Cn;batPLRX?;2Sp)<)D<;~$OX!T8y9y|BL7VK}@
z)xANiN>d$fo$Fh+N>iPfA?Smg=&!=PVJ7(&y2>HAU%0cja_-`APYKHCunmD9(tb-m
zAx7dhv@_^d+PT}9Bkn-(d_{>dRHlxv{rPQj|F+)c_e{^<Geh?&_v+w&Rhy|8#99fl
z0UfcilLzr5`)K(aekzXPeg<r?1^zwT(jHFIGI#n}Vro8^H|E>(&%7ISteMx(KBwrh
zQ4e&v2CM^Xg082{<)b=n4E39q_ASXCVlN%RzB1IS-usWUKp9!F9XTJc{kB<OW8LMU
zz5qS`jzQVJ_F3}z3H!du$i8m*+gxeqJekKXm}};pwV0wmfF4eQKa3x+pXKep)gD55
z+>jeOq**G%xj+}f@!St}%9c%KkKsu&M(83$y<1M6ogv9N0-ssV7iWz#*F}g?&TZFO
zjb!C-Eb8cIq1KP|KHs%WT(ir$r(gO%f_$74b@V-<Y>vu+@60w&?Lt2EW!!(uF_PcS
z%yD(e8*H>C4zbCB{<mOW?>Tl(U4B3tpuE0tWCOQ%-EF#TA$E?9oZyt)LuJ;?aHm5P
z-1)QI`$vD{8vfojL*<I~$aBHlVTip2{gFo(<Oa^w5*_vsD|18wI>0`YBMG!0$&$Qb
zet@}};t1w*l=WI#vm<y{fOjBx2Yvx(4D3r=APzA*`$2utFa4XYGK3&!#;`S>5X=|z
z#{Bh^O}dUvezYSdv7NVbc0Nlv!4cdC+zZ?vOK{h8F%!xV0{am7ZnXj06UR`$b$36+
zAf97SmEjagxq`im5adA)Gy7iZKLqpIa&A}7FY`bdJwD_{TjCHC&R@{<{=s;_Hl$+`
zzZXJfU=DW9)lgon5$hF#^=ksT1v=<riBq5sJqbzL(6%K<d*WtF$6oRNYPrW|?y;u5
z6`XDU9gTnI5}axFA3j@r_MGbW#c%1~&!+z!P4z9f2RN(rMNZ`BJSm&18`6_Ac|yxJ
zj1zzA)_HB2$I2?}?frr-#MFGRGFL<Ki0d5OHxlT}K1g(tV542l4Ik?C!`ea<M>-^V
zvVYkJ?1#EXTt;u(RQU+@))xHU>G`|sNSda<uYkX`_Fr<hp$;u^{Y~!DU+C{iGfEjB
z+BZSYE633#BcWVbR~<j*fw^H_InyWCnmGk@UTfwWJNhMm=5pjbGMApuqqyWo-sD`d
z4q2%_Z{?*nm81G^sDJ-Y{d>R@Tly#Xx5Oug^k%92gzc6sW4Zn&SBd@R(=rw^9;oe>
z>^J<|Y1P?3G8S_|8T}IH0v!wyDXDkGonnjj=O2dTPD0=KpeL(H$`yR5AJOy;a3*}S
z^Y^xYBZF^r*S9?4SYIXjn|0}^{}y5`of{K6H!fSEtNOwD6q_^3xl1U+(RnnBvnhs%
zWb4c}&aUpuF1GH@!#&KMtoLW?O&R<K()-fH;r$W)0-bH4^5z>4Z<N0I0Oe7zjqgHG
z{jk~Yw!|bpd4%#=;s}11RnTFBUI>-9+S2|B+mMDfrp9_IFZot(pUD1);y1xqV2PfD
zWCi^Z_|tBuq>Szc-^x_|rb`DQw&oc|nQyNLk~P4NFKv#XPx{{l>ge&opLSjC`3A_h
zz;=PoER`X0AJCTmKJheXUR&nYb4cHm4|A&Z@BHS`eqDlnyH%gbt;ZJ|ev{u1+Vh+R
z&JAa5@>cN{>Wx|n<w&eQszcK|GZV^CZCiB+-Vn)|_LcDl?_r*E&M|qMJfrn&az4$<
zvr6vhmi%dZxEo4dO??6R&|d`|xscaLw(4E_t~lHsQ}+UWa3{d0U-FZkxU@S-=YCJ7
z<jqbUveKGji6K@Y{`}86Hgu-?QXUV4bjE#7_1}`E+@Tk$ZfJ~C^AXIQ)(KdzN>hDn
zJ|=TkI9iV(A|-YFXiGfe!V%0RP{zLG+t`m<*M5QST%ZfVei;JUiw|Y&*qUI^%!E3&
zCFs)})qA$VKg8m9b-oYCA<*}XHPg@U$I|=3`RzKVOHdB}rqTK1tl~#Z+L0UmP36Fx
zF$ZR-e1q*2s2l5959XXT`pheHoAZxE*91PZP}_voq!*^jm7}`X4t*CPh<`(0?uRnI
zN3hSf2<^iPx*P00S(25bx~ckJ+B}s*c5q)q{X!E{`H^QNlnpw@I11Dac6_HG7BTk&
z=#A~<L#|7l0`=d}<!3@=LwuK!?(f$3(*CWy<YVkZoFPt*8`)Ba&ER9uQAXb7s>A1|
zN%utct9Iwrl~)MX?%x02qnxAQjO9JRS=~Cbyqlc=&w0-?JMt{{JV!_%#>zNbXPfiQ
z9fPD!JM8wKrJdVi$1eo!d^d&q-nut{d+g*r)bk#SOOii~0(Jao15=zA=mW-u^_H{`
zK|jnDcU|y%L-*bml!rinM3;}DjtyUae|N#1$?qKa+@Gqqj71Eu2mLV~)3SeJMu|z>
zZxEaQx1ik+#GoJgU~G($d0-8C;__1cB<MUJwCjR-+E-ir*$=F-*Se`rtey~yGP)z!
z3$$@N+TPfXFKuYs6Ut3`z;3q6;8^5imdfWZsQY?rZ@0WFeMfTsD%hdwYT5R<e3t5!
zqk5&<D3A0<-ev1Twx3{3oY|HzH_TBNA(+P|nET39-BkTuwvQ!t;*A1*n5w62eU;=@
zAy>1qT<x@NiTiiGN^H)vt87B$rTzZd_jv|5qo1?Hc@kS^i}Pig%D}l>qKgomNzSLw
z@6uWBA|6101pY9SEeS(3flu{A4_nYDeZvwbaelX)%6S(U+YNU7njju=yNCjP19`N9
zbDhe$Vm-dJA=VM}!#po>67C?%=t4Lj{9#?7BUd0E{)YAj9rh+_tgiNv?97im$(b?q
zLa4lS&kxbK^Z6TB%tBZB=x<=NR0h{?iNC3FC~rYO^hq8^cn+CIpbprk!0#LQRF3Mj
zCl+ks`Cx9AID)xj4w=uD97)z|CR_4`b7h9gtGq2fk4I+^sCN+pUt)DZKlB-b9B#<1
z3GxiVc$fp`jroI-bI2GO6K#g#5qqi+a&&&=2;@OdhkWwB;_l%dGF@eKu*;o>f2G=7
zw!O)hKIqH+p)>dqpT3qj7u@evhffzFcE%xo7mTY3#?0IT<$+Fi{AquL-woan*e}?A
z`+R$!YAm;Jif`zjJh~t!=Aa42L7pB9c{3i^8pjP|gDzO>C0O@J*h}mMXo5Y&{(vq*
za3<I{oE6Rv`-<~9bgsAlJuLEkv&XRG3r$cDbh2@tfigO5CnaV4>61M6FCp)vHY=fw
z4qDnaQsZTAn6D*}%vogpNHV9$A@F6+m@npP2+AiVI{KhLpfBp5zEtmGYdn#5{AmyP
z{Kr@IngjhC)|qu@56s*Ply7d^k<ZXxV*hn<#LU0>w&W9`ztw(2ZR?m%vid!hpZdbj
zv6{-{y>bkUBa)rxkTKTt!aSIs^AyZQo}I1v1m?91=6U6M56Q?fdVFX{dt%ZL{gMy4
zkt<^u7gblwx8Ge~iUTL{-|V-X`n$e@z1Fwt75{r8a=fsl{|&!w?|;|)O-y_ox2a6-
z_ju3)e(MYF7l|MKP1KlO@s0bT?)gVYJ7Ub_NSgLX_GC*!=sO>Du?k0JQ@;c9J&=0U
zZPnxYKKJ?NR=&|uzgelX#7_C<NcTklzsfs#vp?zAQy-i&&I)HvY!Ny$#&zV)kgkcz
zeaE>Ii!)egDsRrFINar8>i+E9!@M_oLl(ao^&auPhi^4}^BLmgHypkl@%`r}q%;2R
zV>!w<qVs<gOUw&&Ex#QR`w048%3&&>;N27C*Lf#-4+S|_&|yFFtI!TcO3FtN2WaDV
z*nR`;tKU%lCZyZE^9f^tmK=?bF;>tS>$`Mufew~9g1B4Ir}LnU9y@+rgt*t0wexx*
z>l)DJ2*;<7isR!~_X;tHd&jQ*V8d^UR=y9C|JIrWzkv#k-v-*RjdwqPWAHn}9QJhX
z@g})c-~47^pQ{|42c46{d&JwQcWCieURc-ko=mYt=x#IAjdg>2@B#Gr;NJv&bwU5+
z!TILwa&9@V^^B4~oC5VoKII(KP(1Rc510>Z>Bt3^ILVO2pPa~N=l!u1d#c>YQ?c=(
zE&eMxl26!v%j(<pR=iRD{-#{}8<}fJGIn4LO|TAzd1HLc;nY|e?`O=6JF#x6ehSo~
zix8|O^9SrT^hXezKDwYkBz5<B?*aBNOu@cj9q@7d&$_TS;>eDypkw`lwu-?X>IwS>
z&>8Aogz%XeIycY+zqvVkk+?iKlRBeAcQI#n7CvWK`oleaon89f<fZ(!a%Zj#W1MAd
z_%Jqfupg*4+7oLftPAUa1nZI1r#OPO*w;F-R)#f$NGLCH6807QYbTT|O?6}amX7@i
z>{pkO*lzoh{wKzlSdNLDNt5&#EEyMc5u#mZgE>QY&lmo*gCppJzJM_SW%PiLX{uv$
z{wv3UG}z)nZ@Z=a@FgZthW@~k4o*tfZ`oy!!Y5zFZelXtg!&NJE9jo|)#om|O;cOr
zIYYWnWKTk}vb0up4UhIda0UkFKyZed_?$PLIqsj8XP<LF1$E9Y_X@tWJ+#ep)Fpoc
zU;EG&mKemz{ugIHp)cUR7=paWp<e`f6|m3ZV;j07i1h^V-3NY@@!N^>L88Yeh^M*X
zUfjA5x$~CbZsa!%|CX`x4rCs8!re+cBzoH8hd=FF#zIoxV#s!|ml(AFhWo&$_Fdbc
zCuUD5)2`<nFy19tcO+xSw&Vkpr}+4*{>f8wz&ilU2jlwmBR|^Ln5_L4NcsT!!3SSr
z!x89?z}IY*Z?NIl1#O7aN-W27F8G<Ha?6;J`;)y2-oI6%Uy1#ywC~KbvL$agqc=mk
zZ!FnOJ@d6}`;#0Qzg>Obxpn31F%FFrLU_)ZYhcc9j^+}W(;M5Wz00q%vORI>19ri>
zpQPK6H!y|@I{Q>v_4Lt_nlok7Ro=PR*sq;ED>x^dDQL;(JX~jw^Suh3CC(0a0CxfR
zOXoZls4sB@KKSkjhy&R0X~JzNquT<XA(l7=?g#D$^7a@!Cd;L<F<!=fkKN-Xj^ok?
zj3gw1Jjkad<ay_c9Y6eOPh9#S7w0gQ2b_`*cKq;%qqfGnDg72rzWA?<NnFb4n!pdb
za16_pd4(i-G8V?LL{CBzxF?5b$<g1!W~$sDhzA|MHz##SLqGIM9!HSd%p9F3`c<HA
zs{UIUf8uSyJTNCmw4Aps89ATK>k&QIY)f)ye}nsbiMZ|!&LK>31m_k>J*cbARDAjy
zA`<d3GjnW`<lU2@u`sSKLd+Z^_P4QlT=Yx6<UvkDaL24dSJ_nkk-q6JegYfdZ`oC@
zgz7u{^nBDD@IB&=Kd(OVSpt9J5ySI3a(vA35!fSrX>$beiMbzm(?9u!-YxXVo9a(Y
zXoCL9qbDH=<OxGGLGE2J4%UltK}*=1z#i(kk67dNu%FmR>>>8X$~_d4oC)?)OW0GC
z(ZNpewZC<562E@+Vcn7bhP<4cZPaJ#ZMUpGTRx1JIbbe;xqvB{tCe`}(A&pyOJ~p#
zGl*OApx-V+Fm}q=hy3tIl8<wuZ`O}>1j<pMKE)BNH?a2m!aDW~`)3RG+7kWx8*Dz*
zw{(EbWlR4}=Q?s0PWCg({-#{}u5BIfmX6yM+cAk@M(Kxg2*x?fd0862VJ?^_=En0w
z{iaFBoU^t^>%-boX6|W6oFhig=~2IopL`?#ULGmeRk!|4;$Jzc^EbSiSw=pwrN803
zm>DX=`hjTQeH_QKWgpa6LX0PDza?#(sQEL-o@2EhAHW}6$G1W|<}ZZzlGlhi#&-+a
zBV8uu%Gi{Fada`o5qukjA^0u`p>KfDlO=g`q<i`v$Tz_^X0e67#esdX*>2mA9oEHB
z9ry+~#eM;s=_&*5h&Mzelwm!vIX_8oo-TT+Q(gtzhT6B}=w5^_LJZEN&gS9n<c`(d
zI{6LCZ$-ZCh!A``;#<whZ#R6y+4^P#qhMXNQ#Q7{O;g*7zZLr1ApZ2*`JSb`mhx-L
z6UcSz%`~BU1$`5=>$KIFM#A_i)-UNpzJ|JOmgp+>{jIERiP;3-(-@;+?qP``;sw?P
zY{z#A;t-SAW@mit_|uNLU1d${x-s{F4j+8yLtiKRBR+lAeuiwY1b&o55C@29sAI#A
z7|bVYI9PA((a>IHzam{e>|gC;_BZ={3HJRIb^qhTo`)&$8@xZfJ-myebC+?)B~5qP
zxLB&gt#7GAf@2U5x}cB2+m>wJJJG~a9-DlWcL>Hqo{Vo5sCx`M$AWH%NQs>o#3Mfa
z(eJuAssp)^;}(o-iQuljz{c1N^_9LzK-XR%zNtQMZR|TUKTGtqr`-~Fp48D}ZwYN^
z-v#q9L?o<3g*o$jv|JPKCH4(4zf&C6N<PfB8Kuo<pRw1n4gUCbtv7v~l+<ZQOxiTT
zI<mH_fDT*858tLXhS)dwbP@PwO!f)qi8~)T#m@6Z8Crq*7PK?yXdlGLyLfRI>&#Bk
z#nD}WM2GEgU(0u?4eg1w1Y_D_D8EIH%9XqiIct2(i=mFqK9mhQAO^8oLKz)4`y#1F
zLiq^dht`7iU~Sk7><#Y~Bzvb)ZIoAXB!NA5V;jCBp$zy=u^;e$uG0J5(l+WhwpqFl
z`s?DT{~PBuWDCK3FfYu{%6V$3!w&eGr7{p7=*w7VdE^K9k0d04`VsijekUGFmE&RT
z)>S{3Z9}f4-YeEw+D3hd5aiPYIl@YMN_5y~g1@oO(t1nlt8AsOyFb=w2-byldSbG_
zMHfr^p1sdG;Jk1iIhUMI&Z*BkXP)!RxrZ*W;Ww`{OuQk84V0VM>SGG}LIQg1p<E30
zoqn9(5cF}>7ySWcXwn;ep1_WNC&Yu1EJ-*C<q-JOt|gSwVH*NJBsy~0nvbb@;djf_
zoyXnB@6s-~D;M{r>`i|7hT8N3^~#VBzK6LMv?T_yxKoiML603j+T85Y-%>y3sO<4o
zIdiOx&Exf$kH*Z}u|{6kt}^<SxE$2!gZ`D<R^Er-cA_QB6MFKG%!hU(S(3!3FGK$)
z?c_-AjD@~{GCJbW9$z3%#d>@I8?j*v_cwB%R*B6%mQ_a?hFB>n<2yw!kVnmdcC_J)
z&g4iw!CC(X_rVk2+PEM0-PO0pKyJ?8c@O0ek+3Glx+<~N`ftl4`&p7lcn+Npb@T>5
zV;w&DZ^2kb&Nbr$>Oaxs1H>R!7sPj8$RR>7)+W3^yY^-jIGaOob~z)QY0frh;)y9e
zbirBT{EQ29PaNriws-rGzA`cfep`?exvdLw=IoOHNjUF}iLo(O#=H{B=&<2O8`?ro
zLK5hUK3hT_^Md>;*teh^?TL8=ebs!(<1H83z$_30h%*w$V>|{OKKR!5E_dlekQ+HR
zLB8bO6V|A*RA)Ux@VmO@@9f2I?Ia|Pb(TxEn<E`@%v5<N^h19~I42}^SYjlU;iPn#
z`V)>f6>kgXfVp5!n4=?@zj4hmYjp%?X$a00(lnJT=y$?7gf5O~I<K7F$TLiRr4KRa
zhyFsW%!8a@XP#XWLXbb>XoB%E2P5Z$abm-Fik&zf@#$*{`X+C3B~Nl(%8~o`4d2mE
zvbH&jV~80!cF)659sLtWdQ)T8KGEYt`yq%sMJrH`wBvV#<JDL$Z^gW^&C>R__ssSu
zNsM0dCMOsdp?Vz;YtwVTu*X<4)((!=5m-;tRR-32yzHZ+J+cIQr4p)xbw_3PlA(U<
zY^!o+o0YL5C3V_AfvtiMF^OfUyDjA{7-Qs^88>B*9ckN4AKSa?=uYDKL>Gd#P0;t<
zZ_NQ8{Cl>eJjG^xv~KJ}Xkz7BvYrOr5!eA=Q+4c%!`{#y;y2b3p}+U|+s{mujddX%
zzJLz<5%q67bT?f(pj{L6i;UFce-dKBNa?zz{k}=!K^GxL_UUuO*#YLDf({?ERR-!^
z4EZyUL+ioXj9f43%zMbb1irLmyyS7nA;)C-HXii$*(%@gx4Y>oo27E)s18m4zW9wP
zyV)xL8{Gbz{B2xfG(qlNL`ur&u-Q(1C6u4Q-tozK-C7IQqzlUEr|iU>VvA`1FeJ@V
zxpGuD{g2{ZOx5{52u<Jr#)ZEThQ8(X{GP`*y;ErV##XTnzb9<BblZ{N?6xF?zU_g(
z^DVyhiT3{#w?G}R*|*A&9vt^48Jr89512`leB$Vwfo+tR=pw|{d4rKO$*FTVbS{tX
z*`_;x>bFeiw;{h7#VOyET7K6#`MqdJ{siBZdVUMqlE8N$V$e1c%78EZ4D}uSzT%Bh
zexW><<kbDKdBbGm_m^4tCf0@O{5EU+KGT>Y$Hmy5pii*v$sZkbF~#`{@TVQPkEZ^B
zd7e4foo{2w(p&&_m!Bkd+D&ni8kaWAJ@dOX&)_)^m5p`CB~C)SDTvV&3x*&rebX;=
zK^?tq=wK%v^T_#LlFZF!tytS!bN1#**sHLUA&HHB!TxCCvp=ZI#(rnt*S&B3k$!Nl
z^wuoyHSRNUMAN-C#4ZGPT<Wpohkqo*Fhk{=CLK)mchv8v?>xgRb7WlP2kpXhFg3QG
zV`i+3x$8VIUqE?ChhHcz_W*s-XII}q4zLsFhFqd+OpK3lj+_IJpE&^Zm8Lq-4ral+
zDywhR-{tud$Ng1FTl~8S!B~c1oQ$`Nm2)4GTXO@mtb^Brxiel5=F}XOS)(oR>jk$%
zw^CnqtVxCb4f>PqXhVGZH}22z-lW?#wf*b`<?H>zp4r+b+@sz*NI(a!dtV_}VW{jo
zm^+sHl{<}d>@$s|j{fA?KHSH&rH`D$r5ugN(=~RNr^<D{&O;raE{MaJw_+3DP#@Aq
z`XTL$KiEzz`rCqi(gpkG2=)=|i_ks;_M2HMvllBzI)k1vv4|a_XCEWmPWfz6_xVrd
zk!O*1wf&MFs@*>L^#`2mQa%;(i-i0sqg&z#Vi9vEEpxi1?f61Zh+&BN1a|ysx5XWs
zal$HakD0D=#d=HH(Y~dmj1KHmrEU0;54iz(lK&`B$A({%KhW+C``~{wrGqZ$i+<Rn
zO|0Bg?5&Y^%Y9C!&IaeBo&(MTb!^-l+zFijNKT&NlWz^av{{0)RY3=~yKWtN{AZp!
z^1O4!2WSIL^vrE22Ot-8<h%>i(POWmgPqj)^x-k|%#HkjIz)lC#98WtyRChJxx^>r
z3nQWJ6WAl69qpT74UmBDjV&87h<yswE7&|Ao(smvSf@Cm<=X7L8+~W7&yGMse}Fc$
zCsq(kb4H&-kRwDX-{Zly#AKdXf5mVt&p-Je`5^HF%7b=_-vp96`Yp(V_J-VueaKPy
zBBu!I@}o^{x1_^{5B`iZ%J?a}jvP4$#QKa!`E;%2$iHcLBl!*dd0(Z+2VdgT*0Gji
z!AUspz}bIe$o3mr#&YbbK0?rc6FbM-B||U=Lwxeo{4lpic~{WE6uUqjJy3=%Lh%fB
zgKmf=&I{OJq@;WVa|l~74q!~M3fBEbHnk%jaeKja`lWve!8oR1Zdlu%gyi-f<$l#3
zU>~p_dSR+u!4_iiH?9~7zsX#-ME9h(eaQ~Q17c4>9!s!KO|Unm8v?tb4ol!W1?P^j
zF-E9k_PB@aN4`KC=t-@Ibi{ATR(=MZ%a-VtpdE3@g}$7}Qa&f4+y%MfgD)JlGsLK%
z#|Qs?fesr!wT;VF-{lh*<PD?HRAy{boLu9O-1?0@lP1Y;?>CNY75r(t6XI3SQy=1p
zo_$kZ31!=`136Y%_1LyxJir*2U=EmznH)*xkhx`TSfiF_h_l3*8V{iNdBe}X_CK<7
zMmfJ`=Q&1?eU%tfF`Dom3FQIgH3T_2XUneK8584Uyo{eQqr*lU+HT=^$S#&R#HUZ?
z(KFYjeEW6h`@VjY^&Y1!gdi4-oCC%WEp^!N1KOCWvN<Y0fxRaoNh}ywY<%#A^GodC
z<sS)UnBoY}#mG0$btHC!zv(JNB+l7+H|1_TSF8(rWeC=aeNt(vvyQCiO=o>`53m>D
z<i7VFvP568|H$^pUBHe%?R!GmI_uesBljr#w3ew`hyJ!vj}pJDOx?aK?bT;y4&(=;
zKplG*NNmi}5zM3K5?vJV+wuouPzRUsoh8OrtgiKHx!*(U%6d-rey%5LYS3W=bW8M<
zwh?0p_RkjVyWsD<Wb$`e!TONSdlZTO_FK|}ZAU%^9k!O-eocQD{w>6w1^O^i`eU54
zK;5A4;%H9HDrM`C=$TvAg|%YcpsPG`t+3-qe8xzAjB8w=J0)NIs8`=DpGxR&Z|KRA
ztemVPpJ@8G1T$5BW6O5)=6maFyJ-K!v8=YA%1t?VJiUy!j%%epB$+2<7f0OfSJBTh
zcJd&<QJ{Xaq&wpN7U=r?qxrnps`GuYej}{k21DQadimbxZ+po0@_o=gv$VU*_Hm4n
z-w2Ua$M-$H`5jTe4N~^^L4PA$@&WuI3R`i1qMjp{o6g9MZJeQ=gd}XvUNR(`;GW}-
z`<y?W!{AKne(l`pqVao1zxf8g9r-<}Z##qUJNoX^`SzplM590*eFfi7TgBnNKk8$v
zFW~G`Ujj*eivQdP%58E7b3b5Hd-58}i`<YEbpDMx)gQV42K$Emm&VF?p^2?=lRr>K
zw*<blJA!_JTwF#E_;e8oZ5_8O9&@^KUPBT-bH=<0%D;hjqr{=j(RzeveBaZ51Goy*
zr}SIk(+kwm13tz&>`SyCa;!O#8+GfJ%FHSA!5lGfTd?<7=aKt@z2W__b8m$91h7xo
zFYFzB*dyLM>~Hq{5}Xs>l%Y4}<h!!<UIh1^7=@*B1zQOGd1sJriw)nCl6oZeZ}R6Y
zqyLj<k=)qVjDfvP&PeKAU_-j>vx*)+=HW9|jd^RXKIcMZ<^db=BHPn;(VzOJf97I5
z5XzA}r}AYCjAe-<coz(H^e__FEz!GNC3*<q`Jq3`fZjfq=)nF>elQ=}R6o|a3&t86
z_rB(oximd(%-byci9L109HR@-Ma%g<Y6~kRu}AJf`loDI4|F}DT*2Oi^V^DL(7CT$
zj?AC@*cU?}$<_H<_ROC;en5E@&~Y9)o4&`m%Z?b*t%NfAp|cE}Y3iSLYVWwr75me3
zgmjtlF$YJmX8YQsP4!vktIiQIh<kEOjG5e9Lb>KJ<x4L38|v0A=_!Ze_FTuVzR7{y
zI4kU}RX8fcy*KNgtb5ja{E5>umfK?=;s~F;sdM-fTRt~#)AJk?6P6ev#Ln|Xj^qFy
zQ<doP*@AWzVl8om`>N7;SlWiaq5aK}&V<Sp^eZ`%72?y^7W}3i1?smByY)!g(Y_1f
z)_%}oGt|NT<2ytM=8Ab^9$9Cg%sk?A1a0qFcf2LPCx{WmQB3wHdv)Y}6Dotx%V$5A
zdxEoZbVfPnpSM?XCLzfgN222lZJi75AmZ1!oL^#_qdqu46MsRwp*nhe<^?)zt5AKn
z>@CMc-_&U{<R1xT+Q1Uj>9-~10q7uP2YiV&1#yYLk~)9rTY?{L=!2NtBitK6xuvdC
z)*N@u9~@EdBYbI3J{5G8rurN9+wx&N<n)at`w`^-#FU<KG6#&mi<xXm?m^#$OJx`-
zDTnr<^-Xo!Gk5e!uE89!p9<`=&wIi9l5Yso?+Eq^Z9nsxb4^_4lKEzSvC&VHp7Cyt
zDU<{9Gd{_WUUqzFy99Ep-qoh1FaB<Wj&T_DTQEN6>m-c1&K2`O9X)NP`WcLwzbW_~
zt>4p!-`y(n+nB#KKJ&o&lW#D0YR4FAUo-m|iVv&6I`kK?J%PXV#3Ckn(+^{#Z*pMF
z(1hn=DaZZ*dVKKxiJ5Wf!|c>q-g??VyFj-E{!1M3ng1LQW4ghP-wpc8TRZw04}^5&
zLQYLECm}}eJ@!LqoyE%iJGIA;)}MV6g{?CJliyh7ymZcsh=e@^BWWqo;e+oICm|Lw
zx1c}zUE+wYTy~y0&K70zLl5}a4?W<=SQr!I<D69(JD|hf1->`vE7*xUN*?sLUmy>_
zpSHxBf_~|L3)aF=N8gf@{<K{ghj_I=>Sn0C3e;_L8`qK6A!m*O{U|Z$`|clK=6s1E
zLa=tMBWud~hG4y)z=jX3!co}}>t;%~AE19&$tjXDbmjbn$Ne;B#@)pctV`Eg9l<%`
zJnh71j5>N_I}#txC(`Am@)5|9`Y6)vo7&Sa{j*1ae4q*Pn=gd)b*&j^myR~Ht#N7{
z{TB2||KviR+(lcom;2s#c$NR-ZOD6_IIS=<F0oC>7e-R!{I=}2k+CeTU(z4J`|}Na
z3~g?(J?YTbxYWNvjFE&S^U}o8+<)euH7JD2tj!Rt6Z>QqSicaftTk)flC6CJvq;Ka
zth@(~B%rh3PX8x~571_aC{VYKvj;8lS+zvJh1=tcZRMG!j1KU#y-UwM!TnM16Li>G
z`jbb`aWEe>XKY8HXa1N|=90PFFJs5H650Ve+S8U8tP$(QS{}jL-s|f%MRu_g%CrS+
zN6>bPov>%vL*8>!`x>_3Z$U%73w-T=`{82-e={cN@P%H=#Kwoe3HukY-z>EQ+Cvlc
z1M~x3kn2dC`%&FkH_|7HuYHJP(BZ>;e%459%bs8_u$D(_hK+f~k9Op?#61S;=&?`v
z!4{+VcKJ+kMAP5iW~f}*Sx3GR`ELctO3ymdES1es8C<W@wkO%zKkcfmwx!&YkbJ{F
z>+<)QTh7ZUb3iQG(FRU|ykI_1^;>p`KmRZ!*B9RGM{S_%JK;>WBs6{F8)99AzPF*X
ztafzPyIf_L9cFSQq3L^`*?im6H^44da!MIJM1eMDs0{6*_T}=-Ji5-r5+`XoAM*k1
z_->t}!C5L$H(O<cu8E_&&P?t-(R3yccQE%ecew8J!CRpFJp{igk%v0(f_xU|n)A%L
z7RW&y#iLL1tAy%+t>)4*2ig*k92V~h?~0($n<<^?<aB|~b|iI(gz*f~gnv&{Mu!i+
z^i2+om-!$kBz3?x5`1B1{2F`eH#;2tTLAEH0z*Vf%IHo?%IF{p{Ck3#D)Vm)!M8iU
z>+$~uz38gL5%|DJD5Jlrep^1o?_woKlD^4<{Ep~3K96w~{g#cnU_O}}=7_mtkFjUA
z)|+)-tiATZOpfXy*i-BW_8U-!E`7_kTW#29oRyvL$<iBPj>^0rJKv0<cLE|oUu{cz
zgI~pZOKc&gV$e^Bqg>eEjENj0$3V`X@kob_vEt`*vGQD?_xPuLi2<~&pu^5Q5wEKq
zbI~%+Cx?vB{7gY^%oBOG95-V*qU&v_pu;vqBz2z9V+YD1u)`EhFegB{f^LZ@^weRi
zzVnJjJA6Y7)|)YDoXpwIIbmK#&M`J%ZkQ*0ny7P086EA+RypJkl+m}8=#C(6sDE-W
z)JN&lYqHW8iJkTO#8KZpaUS$z=yw;W<42niJ`<EzawLHmwY}Todvp$0-dT%#ufUlF
z^qk$DXBYYZX*r`~%TgV|VhZ&&V+N*R3Z`HRreMmfbzACC5a-;?SKafmLLdnt1nhlo
z?x?!OW`7Z95YN~<>ayY-x>oD5;0B&QaqnK#>({^<8ON9>)@<IB```b7K5_!bnd6N-
zCo!c3wl_H6&)zV9=IA*~Ja@9;g6Gupnb=ofZR&<PVh&i)V(h`@z488RxR7^naUZ{t
zK1#>D7;8cU=U8AKN#?l8<7J>rv^nO0v5YA@xJaq_yzTYjx$<pX#!CAxbJ?EJPrEYb
za~?T`&Tm?o52;Vz96KUc=W4J@&8)#hmvcHsfBWhi=#yh^)Xu)P4fjFa3>^F7*rd}I
z<5sHP{c6t3J@W4ToM+B;=l;~Y<K35^yX*apzCPY#@56<`eR%PnXxGm><sI{`Irc)s
zrjOjf_Jq908$U5G_0HkFyMejeZ*Z`ELR;E9KF(o$^D>VS*lyVLF^+LBcn|ZAPwHj+
zpwp($DlyHoGR-@5&SM=X&r+X<$`-ZlQ5$RY<A<;L7%O8O+Aroiz%|KzWa`uA+RWGW
zNsBdXq}+#m4!Pd923ZGf74?;ceSq<u(_CD~Vtu*R9_v)9vmTx`-#cPkZuG5P545Xa
z*gap4pTucVi&}$$PJN=SlhZ2oXyhpq%vo-b{ZCRK*ICJN>K2@WeKFQ0kDt6<hrfmS
z-Q45%v%j5vzb?*9zE^+Vt@t{|vCfn6bDuW*;2r<Qz?OXTF@{Vq_sn-PpL=QDDxJRh
zSl5@~8jJqY)<4G|+Ksps=aF5wv_;(v8nR-niZ*>O4Avp8Mb1O&Qx5FOr}6q7P$q-6
zzB}ffAsbR^ZYyeLZM+wkJzdaXbDqU>-QjS?J?HOTXq<(g-&pax>*x2FzsY_<pX8HY
z+Ae-Q&Ytt+eKQAhIbd$)n0aPfxxuxJSl2~*&s}SaGvV4_w0V#9U(fiAVH~k9BWOtH
zmCPaguhe&eahxx6+RT3+)D38$Z_e$!#&NC=)<mq2j3E0dU;Qa#(nqPE@_=)=2In+y
zrKl6_9rSgK&qnvmz4IC3e!8~<+JidT!9}|F;@DHLpL%7s)gN#^nXusogPaocOAhT9
z*W#LTjjlJjwCkR^H{K=h*5HoG4zmBswEreAF(iEkZE4_KGw$z-bK%+8oDG@fjF|6v
z81!AEH5h?4P^V3QV`RKeTiptqeQnNdF6P+ddDP;$?X%lwxZJ?!ezujhuiu0goQS7X
zr%iTnk(GR>)R<LQ^>tjvQ>H%0E%HqcZOQ&C2eudE)%e*~|N7d0{onp%Tnntrf)3W-
zvytbbm$Nb0Bk_DB?%fRBOWVqd`<=M&G770X#V=zSPcmNim5%dndER=kkPV&ZPi&{%
zJ3Ip0>AUf{;j2zta%sP4YvA+3=Zj3*BYb=0;=IN-&&=PpbLE`&U5oYH$U}dGk5ap1
zwWW{kS#*Q33og_<<es{>Vp}>~_E&75AZ_lyq+Myhfw2ct-yP>}#aZ@mvl)N4ojBWh
zF4IT-C!6C$+W^n1(!Tl~H2!`ZA6Q>>Ri81G#*_}uu^!Y*`lO#ZnOkDNj<sKPwkQ79
z+4{LZ?v?wO`}w1LYU+F&a=or2*P>3_4ASSKm(Jhm^8*LnCmR1=@QH!`6C1tUe@XA;
z_%HZ0-y3Irh+D_KdDrpP?`=EoMIXmIXZwem7dGv0Tx`GLcfn+R_%7J^ewN<?ZGY;k
z8xM>AH!ik{-|_sOcfjv{JGe;6{-7-_(EsI=&DfRx^tD}ogYjIIO?&e!9o(DCGiZ9B
zxK|r#dvSlJza6kIo~=HA9q;qlanolg_f8+j%g=Mndj}`*o_<2Rek1razK+Xyj>&P3
znb6?)oQ4%L`>E^bf1VGl$J~8ixUS)Q!}SENGdZkPR^ZyLfwh~^AnU1IK}RO)^}XPD
z<7Is3w5@J|cKu|-ga*b~5p(nJ00SBv{tZCpgF5X}ef7Ki`+=-rl(sti4g6-;!S8qr
zMo_=`ZN32}lXffE*LK0N#yDWi3C2&H&v`GHqj_(zhOXTjSc}9uS-YQe$zJY4^SlNZ
znW$^v-b)>m?ScL0oOqr%XPdJ-xD&_s4ey=Grr&s93|Me|ckr&L9QsN3T@rrjuP)K1
zzJalw%Xt^vawiA5{p83RT>qsG8?1-Y{_#v}kM(#59CPWr#s;}&rG5450~g(lJLNrd
z{teeWs8QC*JSRC1@^?)K8t=yu*j6{on)Q3J4zj>lEwCoy96h9cee_N2H%MRo#lHF^
z?OEeN{z<L3Yi(c+-#U!YTiaSYYnEusaZ2_2Di3{QWE}g>W&Z}&cs*pzYrc&$;uz;>
z#O`rEe7<>3X6&=`c6{^`+vYRCvrxz7SjV40yG+=DeSMqfFP>SGdwaRV;yt$SJszM>
z=MEomjM!eFUg<e@4)e1f*1>hV&KYcE<yr&Cx};P$!STlViAUV5lWTL071tx?vCRcq
zwAJbBy3Nrz)^9yr`qub37i-vH4m)x@oVm`q{99(6<&=(dZP&O_r$%4>;;ehu4tV$K
zUEK6v?xP#@r4@{2OzFX89_OkI`qF|Od7GDO&UH`v`YgC$Ok*E#-pnE8Mwh6|c9rUr
zM*Agg|B2khxxdi;-5Tg;Y}etM-nFTh9(H|1-2un$m`j<c*Zz*PKVz(Rv2V;_Y-()%
z#d?eNU!FbiEY5=c>lq5We$}^W^B!{MJnwn;y(<SAI?sKccYP;#?qx7Ov7cwxF~(Dh
z_ujiRm`9(E?~EAc;8^?GH-6I0DSWl>SjQ=AxG}#mGLF89x>2z2JUyuGs>^ZK&G{O2
z7TfA}na>!m$=uD^b#^#e1D+|?(&tP*ck-FjeBJ~;doEZv#~Y`{GM-f1#z&l2%;9CB
zyWskAy-GQdYrU*VTwi6;KS9<ZrF!iha(u?9{So!*%x69gT$}Wu_N{^S@VRWQc6nCY
zPu-yHyT<p7@1bPUcZ}m}U9F$<Y%qrb=3^}yIhyB&3$96A-zT)`_o6;Y+s1D|18eSl
z(%~|{n1^|J2F%^HEcjU;>)7ZA`CA*YEeC$aG2YnDbHN-AxL31~d-qCxUskMTNABip
zo-J~<mL1GtMLy;v>a^*z9|q%%bHSK1Fn?<#BjnpodzFrpjPpuu8D|r>a_J|jAH~PE
zw7^)2y0mZFN$MK9H<#>p;<$cmVSTKVHFTd_oc+$eOP+VnMKWl&!1L}M@VtzmAuHeX
z>9hGwSMfJqMVr10oX@$<VZ(*Y)jKB#T*nMt*QayQSbrtYiuI5lb#bg%qZ4RL)M*=V
znalZd?kd&4Ty%~#)`T6Hm-~}sp4#=34$fWYZNzi^9juKt8qh-8zkxpM1L||UzK$6o
z?K{SK-nG>J#IDbYSjK4J{@pky?(4hHxz{81TVKzYI99U%%CsvFINu1IUoN;d*C6Is
zF=um^4c)zg6=c8aTI`2=wIJ`=j=S$&%zLR^PhWfDm>l1|@5EE4E@j%B&w1sN#|HB`
zPrf(S<C<g?8tp{=hFfs$#><%YQ|DaHX&&b0`Y!Z%e$Vo3&*%Q&o$!tHdEW>2YpiO|
zG2deTNuT3uOxvl?@teHm{zCeEl7n&WL0u*7nahlIzp|qjYb^^JZ1%vj;dyXhX2HF3
z4?DQO?sW@kdw<}fOFr3Cmp)44=N#HcplxA0VOKx7f8Nm@cU#%$ueht;SM5J{nrFd@
z=Yf9O8Zma@J$78jw&MAb{*F)5e#?7Df9=j?47p%_#&<pDuC(vG+LUQe+X%Z-oppcr
z;!|Ip`{w?+m+t9($bI)boH!eK4)m7+-o-;K<K3A5=S-kCrei&8p1ln>r2W^XUHxQ?
zb1Ch2{w`dgyy2s-ZS{@6A1nSn`9H;YhuGpA9h^^@?d)r>q)+uT-(=8EtbuE_o-OLR
zN<FQqSks^TrVswcGQRVgtLxnlbq&?$;+Ob$da`KC`2+cH2g><{js8!xPVRre7=QB7
ze(@W~Kk=L2it#D`6f5oef8wB*{ttC3Y}%E^H@;8gH^5JFG3Ew6{+q#rOd8+w{=~#b
zcHz>N!S}asENlll-~48<{r>lVh=okjrtE>^e#6*Fca9JIx4nEH>a+*{cH4Zu@;vQ4
z69>=4=`$(r&f=Nm9kTCzY6bg=`olQKCib;oFov;y?yL9lLH!9I{Wm!FrJ*x^hfA)q
z9@J@1><?%#eeT20`^fhj_%7Ljb&v*!caE%}BQLeu)+?}fa^mkG+iBahFE}n^DBn1a
zal9<(1^;b*2kzC+ej)w-=XW&s&~IuhzOVU>&9>Y^>IS-`mA1Otx9zt(zvK0S-}n5^
zCj<QUCw>QfNt=H9A26Qmhn)K|uj^{D=8K%vV?-U@n_Jkl)xD^9Z`VWWJOdjRXTtO0
zSvlaj%X7LplNW~XRNps+LwlC@lkXP$-_YK8?~LcY=etOqcH=vz_n^Zi7cr*>GtPXT
zW!K<(T&w5G^X3_{UP{m2Q6IH9_&R2S@*5kQcO`K?S#Tk1HOR?4y}Q=OwY#3qyYhTs
zqSKbxKcG~1qZSQmENg6B$$eO~J2ve*(BHN?$LNz|9G7F&CF(XbsP%R|k~Md&uDh;X
zopl({0^8ZQe#t^#>t$TAb}i(qQ=bgl+Ao;bf&=C)_O;K*(|mGn+vX$-%tOBu*uG)Y
zr@<t5&q<yu&(4Gv*uJ2Bg`YZ~X+Fn1d)>3gy%pQ)J&QkQ6ko?Vk9j($*jB%>H!$W;
zAH8|H#&_+mfBu4YYt^GhuDipE`8u&rtYJLzMh@N|^LBm8nwN3Rt&yAgIgdFe_AmMY
z`pAZfevsP*&#D|~oL})A%YI0`vVmhd80!#IHf?Q#J8{5!<^7Tkt^9T!@!K`!DmMMZ
zF^MsxKR8ci(I0RlfAf7Y$3)u&#~Ir>oO}EQnP<uzQ~QfJmGr4n`-T4HxB2`_z2l9w
zS%bKiY%3c!8G*iXAB<Dc-oSX)$$D+Dc8UEP*jC>l&xvQlvy!wpH+fDMXLEp3)XRh$
zHqZOv+<W#1T<<3|*r2|}SmQg_4s5GC5!X2eC@(mVHhuJ!4HwpPN9^a>cU+ILj?rJV
z=eQGXbsL+0V*7%6v7P-DV_vC!!zkESFV#O|Y9G+RHD=DP+w~7<LDty%T2pH)6E3K?
z&Ij`OV+?Cx+>EWxn43M*FX^#|j!)EW82H~3>k!YJ#r%^^`-1Cpy$3vNiG9(Qq^{~a
zcH_JlUsA7MqTakZm}};%Z07DdSX;8Ac0TJn_-r5Gv;F6}&buk!U59tp3T*p68`$;J
z-*Lt;=3)-#nnA6fd(g;pJZo@0=C58FxEB3gPm=3etS1?<KId^>_s%uu`toe3Hz)m+
z_J8s<@5q0WzcGyI+~#6^7vvuPCJ%mzW8}t~POQVc&Ed_nF}Hi6G>;9gLqBtJjCna;
zE?5`yG`3hbbN<9eFWOSterf0=W2T&CuJp;V8~^*D?q#5BLB>s)@vHn~>*OKnXWLo~
zXfUI;H|ki=xBKi_72ApZ2Gid%asK^nR$25t^OZ(_a~Hf1{-&$<q}~^8`slwP?~QXh
z_l67Jp%vs=sOP~oRq}i^*6g}HBNcVhz;h(4U|*Z)C)wAp!}c6P3v8>C3;I+XCkHa_
zChi6INLEPO>O~)!(7^E>oMS-l<DyP2@Y$27({^FTJ#t+81Nz8@8#u45Ap830+rT-T
z%Q>5KlFN<rvDs^J&$I2`4>+;^o&j;(OX@c^V~?2UBBe98n1dWJFWC>5zT|oiYs&iC
zUZ5?pe?XrN?$Lp~bKYO?v8-Q6pOic9tZ|H&*#Cs~1p_X5OfV;NGe_x=>#K6G-WJ%_
zrvCwB7^|}BUvNHi+0e=wFYV5=d_J7$D}UqDJ463Z`qT}6H~d?Sk@?IgH*GcUreC@A
zzft{0iPLE3eBY#bB%O9*ZC_TLtAT9bes~_-qXzC{?x(WDj{WvN<ULW=J5tYt{&GXw
z9tHbyKajSR>687z81H2FUXnvAc&EMJJ_qtyFyo%D$k*{1v(Z-X7@r@qK5)x3$LEfy
z)7P=v@x(FKjd_eM=4zeHSE+71Hht9p)S5l;UW#`|+?&MyEa>OGazAr#Q(km=E>4_P
z`<@SN4SvSP{yRs`y_}!8#?s&Mo<+~8=d+&6jV+n9d-U~NAGqi`e^X94LGy1_7{S}$
z#g;zbWRA_)DV<OH2h2&#cN7}!T$^oeH>h#cEztK+vrFwJw2;|8)KxZm>y+`#>ws(8
z1^eo?zdje6bpB3H7VYHFt~CC}f0@7hJHy5%-+a>kzacO4d}4HJQdp&(dUc=lX|FPU
zUs-*!oj!;7Qoj-Y_HD3!3-lXceg{l>%QwOIyI|wHo{U23Qu_Tc+xl&|P`|_F_c!GU
z8sGQ)&bQ&h;9KA-*jKMzX3&r?8S|TT-oIh^Y~}A>u|0XFUZ1Bt6PM3VpOw6WrthJ`
zr7go}R<MxCp)H-eHob2!xO2;U=Q9oFgSs0&`nHGE8OxZ)A7CDt+oUZG%w1eZrPIHx
zZ~NR2j_(cVzC&C;w7+0eFR^als6HJ(In-L#gL@!1_QZXeK|}f-P!@FX`<d)uAd^O0
z4&UBBk@j!WF%x=l{r(sDeJ>fbr3LSILHpYDSztWl$|+<Xo18DWM%Qc&tjSxePyK_R
z^_}4UxtH#-d!4xd2Rt)9&S{>}8|T!sCJRm>&+X={4&EQ@L0#pwXJ4NN#xbUIIG=ee
z?@eI)1h%E&BkEnlbS<oJ1P$p~UaZ|ZSdXm9rY+WHM14H_j=f-Q65}55E+vDub6)6?
zm$_{7Hh<RQ8Yl1K!8>!qh3<Q@piZ=pLZdB?zr-<CWjuX-didJb-oUz=i*+?GYb&--
zVBN*OHrHTHU0beE`Hg|i`dBY(m-SPp&2cwm*2+1Y%Q@@Z7rkg(1^bEm1CHClj5TO;
z`~=tFe9kSl*TbvRZ-BYGjsZKKhbPX8=SA#m)2}gR2RYt)G;BY9o;C1ZPNd@<yRhpw
zgN$>DB^%V4kJ7$tIM7&QWz)Zq^|40Dh`Q)A!SOfZ8QUDpWw;hFH<=&k=1u<c)5hNz
z#%siOjtkD|{O*(c^P){3{b!6(xAFD-t{~f&zV|^q>v`VwYv8yJ##lkd)5me%u?yb8
z1*g#Xom!dnD`|6#V=F!S%8GNzh5-#utigPe)G0+j{V!zf6>}V<WIoE8=ca#uVelJQ
z(ntSKq&@w=$we%A?K%F9t^POP9H*>f>$tQ{e5{4Fu~r+bUkA^N`z|A-I&F!4Sunse
zG{N)Z8TMQ@@V>}`4&KAzd563|mwVtnnxJ0$h6|2ye4g_`e9x-$Ij=cXR^+3tMO(Xh
zPdLz6tJqf8L7yDsI-J8hQ0H3s{0ZZ{7~gqvF8h@eaW8YqhVfx8b%}nn;F#>2xBDO+
zcI<=ow6@k=TJ$$kn|tJ*4RDOykm?$^7eD)fbWAeo>!ZJOCgzZ&E~WYdEpore#TpM-
zAM2IaSFe45zB|S_UW{eTq|-JZ^D^f}zMiojYyZ)e`He9P_KoFu$NG%-{p0V(pWl@H
zuJre%3{ZCi+YS7!Jp=olvA)ZErzO7EcD&nsFF4O8$De$ouCC>P`E9s??FQ!QTK5NX
z{kd=MmAH35>q54|pxv?S--zdUvF#XZc;e3LYb@;-%wtAwxsUE$MSZejPn9F~)$y*i
z!zQMAIBzpA>*78Hw#~(yteHOMq`zx0H}f_>V;R%f)@%ni@^${qL0#IF>GSF*wxrQc
zoZ}N|S5DY)zo1R#2O7Fh<eZE7J6zT*u3fU9x`8h1Yu&72t?}hNCi}y0nubme_d@(_
zBmE)uY4f~${(pYgaUZ-Fd3S8jxFh-*%W(&s%RDZ;XTZE?oCDWkJNtPqR-6sbh3l3^
z4Jzui_rSB1sIzUHByFi5*m8c)re`$iA9B)P7F@`A%^^9o&C&hZ1^d!KpAN<`o;f(5
zb6YR#HiL#tQg_h}d=EG-bDfd1au-_6<9vxaeL7?u$0h2`$9bG@M;`92`~349EN8>>
z;W?2J=yO5;1&(dRnSn8rOIw^zocn<JY%t%<x%Nj{)202girseFt^Wk~!hPA`J(Lr8
zZ@tqyxX2`R%2{Z%bNnLCH#)W(^E$sYFds3u4(6L{7_=q(DK9#G9dkn3&c1P1;Jg#e
zbHIihbe^lS9uEC~L*sq&pEBdO#74fP?KjzC&QCu3iFxUN;`OWj#u)2k?Q##5?WtkM
z=OydB@pZg3II$;}JsPmx$JpnAyqtgeIrm8KMTht9cz@I{(5K-$|9~;&7IIGYGiXS$
zzu`jqsdLVs`%4ZDCU@PtzvBLT_XqmSu|=GW@zalSgE8#`n`eyp&gmiT>+6^c&g=Xe
zYAvjXIi}8b_RTAwP1-lP9qR5ri1$crdzX^bE7dKicPsaJv&R?mJlIw@z`ghUICd25
zU(nX@bIjpPP0nB9SyZ<`X+P0t!~MYEZz@^A@o%hO==|+De?j{vGG@+`axj;9ncoC+
zcYU=Uu6x2M*iU`d#I?7GWz0{pJ3c$&JI<KKvc6(lyLp(CF%Hyq+g6vPZKH4ejV=S$
z!=+#8{5wK2pSJzv(EdjH{7HTr|4H9EYX}B1*|h(b9P^v3u`aQt>IVG=nWJrW8!q^5
zP!^n^@tyBwqDwaIPh9kaZ+w+SKRNN=5O%-$1rxc0#<#cHwm-`ExJ$e9O;08qzwhzw
zPy7b>8|kNXoESrTVEq4-Rr0It>+=p;VbYeWvweI%2KM#YaAEK)TyUWK{PKRmhQ>Wx
z-aF{rH>vIHtCIzz&}bXWn8tT5=M?9kK|@OBm~xS`bhtj}VL%Ix?+m!UtNuXqJriu+
zJ1^6B5%j;{@D8gi`pKZ}-&-4||1J^u?-jCOfZx&lo|a77(hBxB+z+VN-U@!RTR}%&
zzUh5q$9KO`WTP#q+qCb4ah>CUbDKwxwYgr`Z!Kya4}DQ*jomBv&3$w~H@L^S--ot%
zCN_9JJwtgWJ!77=in<o(%`+$V^||0#ok8;*1jF}7!G1-X{RSt_zwwOiS)Sx(-mby3
zsB{hHtX<ilt|#02_25Pg9N%EZxwb~OE9x%wtEfBRcw^=q&OPCR`D7h?sin1XeVzB{
z<bAo}KB!C5mi>vX!C|~HF0o{PVW5{5WL?d}+79yxvaOUAq~3M7CfAttw3b;{>riW8
z9qeo0_=)2jZ+(uj;@s5vF7xL3G2cX;w#2^7;&W){T2rbM{W>^)1r52$!91h~=H^<>
zbCa(*yFS<AzI#SI6W%Sco#&#(S}#&uvvn{=lCiY!U?3YP)zxvAvF2h<=RsZ4X;&O)
z|A6b;a0~X;YhR%Mh6c`W9_HkFU7zdxgm(QdxVFJ~V>!2RlS8{PpE&P^3#07Gp)Cv4
z>(hc6zV4&@yWr<8d7r?0@uL2vqq{NQ7`7efJzM^kEi`_k{zm$K^3kTg%Jf$*=)o=b
z-aHcZl75bnQ*e$6JGjV~!EfgEpiZi9#`sU=j2vERoEzkPDO0bH%pm(W#wk-bi(j_W
zcEi8M*QP#wQZ{tf(b_ia%l;3}L4(ct659(d)H9>aGwRv(e0nY$c+R~)lRMyD7{Nkz
zbn3ky-Y@Tnz84(lcw>3)XUy%qp36agJFqP+$o?y}&p79<!<>zq^k}Oe*cUjT*nV;S
z#*<S>UCOj&eks-K(;?>=%=6;B+V#`FqF#S<mPT7_=YIH%v9{JaYu-w&^BLrxy|@S3
zWfjzKxF7Ht<(`RceI~TP_6BVSX5{TUR&bF?>IS+NI7T`+&n2F5TgZ(4BV+xpxzqmf
zjX5*kj#%1U>yCPPUh`S+^Iq)lz_vQEy@SR$+sZuao^$uW{s_G}IiGpD9@n_a+THVa
z-&3cb{*F70H^z?j8*@Q_xXd>S_Vv?$GS=}wHH&<#%bU}U{4x)vx)n5JGHA;Rd5LFC
zb6%0NHP5`w#he=CdG*Xz)F04C25fMxuA{kzh}oILd0Ncr+!r#hl<E?7*;ejgA}fu)
zoS4IT#J;4xj;Za<*!uzXub;X^Tl;`>I)4XiD!X7!8dxK1wW5BTT3XX?UE^GOMk}7z
z%Xt>hb!|`2IUIfq$qL5PzWnXAp+Wvl_Vc%zf13sNwd>boyfKaMJQvLCfH|AHXFzOA
z)erQpQ!cn}nGfo;i@ufA4fHLrz2FA6)#d!=XPzUlt?pB9#;7@+lACRD?{Y8eKF-M7
z`5PGDd7RH$?ZDdohJF_Y<HYeN=){z_pZb((SE`$^L)urrU<A%*PA%}<xaT+a-!o8A
z|DK5*IUCpb&Xd?r)J@o6ojx(pFSyXDYhqu$j6&)zI?><#IN&{VpDuVOy_?=y?{2bb
z-!FW6205+;#;Z6-2j_F%2Ilc%e$s=?+kV=V2aI8?H=g|s&Swthw1bO$$!F|}_rTxE
zgTK7~ssASHduj4++K|7wM*LQ+Qky<Wj>-Njzu9w+D&Mj8tKC?`_YL)IoFUJ%_rde*
z-n6K-c56MOzK(gZ?i=)Ju<&=E+)HB(<2gs%gDSln-WBJ~J5y!HF8U>}Zey#Y->d5p
zOR0}`b2CR-k)!rOK3Nmr17dyDX?t`0?^uj=yna422G0)PIWw^RjfSuO8!oJv_a|1V
zQ6qlETslnmk1@`B;L_Lcf@?cLk2|-KpBU_&`|drPLAKpr_xctFZE0|d|2w9~y=tCC
z@C;^KdBU!&`fSe_bCH9)vmOrpZ*=~?e3|HE2iZ^AW6T>f=QWQF4P2Y+w{9(1QAc&Q
z)lX_Z;+(lR6YQ(k&lo?kh&co6anX-JAM0#?2kJy!jyJapqtwZE>Rgv=biEt=J6wi;
zj~6cOr1NhSG7E>cwEkaY|C^j;?A!h}=9@m}OgYFwc5snNev?zC?vvbQ{BP|~W7T~d
zqb+k-|4_3+;~Ss-lxedsv#@F3AioK|-vZxnf_@LI-vs?0*!adKBfhm=Wa76wzu_Io
zZ+yRf2Ta@MJ7AK!7T*w+#uH;phn(|o<ceHhnPU(4>2GP=yPvy=ywJIW3(hb6++pu=
zL0wYE8cTY?d3IpClKO%ErP>;H*Vy64dto3O_^$9h(7|_rEEv!}px$>)#rMyI4*9NH
zytgF#+LF{M^+^Wp%eS!|_?@hQ-vj@ag|DQ);}dn-I^6gsH=gf;ey^KBN6Pzc?^9pD
z9H%^i-~JNk+Hk=<%xl99tiyputv1|(b(aI~m3!v?EpT6FQ1>`(?*9eP)(P^Askg07
zY!7sfkzMQuo9Fn#;C-^d_sS=<>9@ggH{zM!h_mM!T+b?~(|+OLn|au-O!^)4%Xqug
zWTBU8Gj@OG%zCP?<BjcngS^e%+O$}Y>&mtFc%Kg5x$EK5@9|D<ygPlD?!dOXiCrIk
z#TX-K$W8niIG43{?h*CP8e8Yeq%W;te;2)La&5a{zoXYC2aJ(p9dBQstcyBxGQZ4K
zxgT7QxV~)bqi-*$OTUG0GGc7XM!$})wJ|4|K|{J0*JR!U++X+EGveNR7QAya?%$w4
z(QChj73WI5ZMg+w%7hkk?NV3sFfa3aQ7;Yj>yfYH<whKB`h4>r_?^hZ{2I6x*SNs7
zxz=6Qs$RSFxDUf|#4(<8FXqj;l}XKIlb2lZoL1C{_69YcdiT&hb&n6^{n^}+%A~Jd
zzn}BM7{|(_eeG+*Z*kA^cdNf$ZC`Ziy@Nes>2KWXf6DLN#_w9m7{;+(QCCS@)j9Wz
zc72UM%J1h(yYu^3Y`>%}W!g8sGJc_9OHRz4{gmp>t3&2&Tm6VRZpa-{ebS<>?ZUS_
zwU6R!zmhg(>M!kz`Ud9LsImL$Iq*DqE>@w_&NEoguxD}v+Qq&;p8p;9TG_l0aW6Xd
z`GLmR3ymDshx0Yb)qJh(D(Av>GH8ou*|Tb#T$gJT`vbkU<k0>`^)aUB-uR7qB<EDx
z*CzT^I{lo(m?JQsnv;HYoMZIWXBKvhQ*YaSa}TWTpw>Q%4$mZ?Y04h^;NG}L?v?dU
z9NPlzFUC!@>Fb!6f$kIO=XvscnXl_H_pC+AT$46^q=91`-<ZR7c(z>Ih;=q}+Vo%4
ztk&{G4UJ)boi!}{N5S#N6!qFK=qt9>H_%79U}7`oiZxy4cP+{d=F<Y_7k!oL_0iv)
zUows{9J5_t<X-a_<RRvB!F=^QU`-r%BgdTc#=OoU&V2%F_u{#%I(;28z*y#JY}eJn
z`35vF5A!iM^R#{wdSF{NwD4I-{X65t@du1&+zl73i}O1FhFdT<G0!A*%Jg;Igci7l
z7w72@`Z&(<_d#9dlYQdTej#&k?xaT!uH71pLZdC#NvxSQw3Y)JSZALLH-5YLd#AGL
zYx7=-ZS4*G?b9KD6AgYBz2t8tee@M|`uTTTkH23Bf6vJRbq%{?4*t%!A@6o4XEFC|
zD>t~V>$+mS9VyvQnR<N}I8NFJj4RsoS#U$zZ=iibheMrY1(~-xee`vVV^?sHnbRvX
zXJy*-ckF<lcrmYYI^T_&S-bWZ=(mH5lujHm=7DD3Fdtt1#-5~a`WVM}9h}2C2eiQb
zmKAhlMg0NCTrid~bDosWXM4j1>m=4pPQjX5+g-3P9nv?)zB29lisQU@-o*=(JL<h2
z!A9P{MBik@_=Y^h6k{iyw(~7$u*oB_|B|*(Qr`h9q-}NjD(x@0;QXgxe&)J^i|jmK
zW&JO6h?g|pN#eUHrES>{m;QfB#`x2?^qVnvm1$F^-u$hVwe&1`b~k5xdI#b;=y~@n
zH+`set?$oR$49*zQlAdS9N@lnF#Z7VL}J|e7wGrmxYS+RVt)p<lhi5IU087sXF03p
zsa~H3J}az;HApUP_1=AbCR}iw>)SEz=UG7wcf4zSx4cYrvcdPx0PCK$@A1rO%;~(V
z%;~(+oICQ=&%JZ*UHmUThumDN`{=$@)TMsWcK>EzTMoG2-XqVAvV(h{`#)m;8*+no
z{p3I^XU{WeU$iBud-W5)4Hx`7X9WlOpWxqb;@@(gNc%VGT+ThfTpD!p-_*w%dWOXI
zfr(zUC-$xL4qyFktJ7v3Z`4n@K%Ll5E^X(Yfw^ojKl5y?QEaQL`iXuA7diM_Tvp-u
z_j&w#hH}C#v`+jlR6pB}O{(o3Kc0BmSH3KC$)%n2e@F`^<hQnz>b}uq+~3IiVZN$c
zPi{5lJO5$c#P5NXL0@)!6YTNd2Ie=wlr6pi=C{E2d!XM0lS_M)Z-a-n-|EEgc7Dst
z?|P$r^V_uV2h>*veQ6)qF-Ok#Nt#d1srsaCefU<meGY!$qD#8ZOP`xQt9@pB?}CF&
zQl}gbX-oZ$SjLkXG-O5nez^2Mk$y8`9C9}ITt}{Ru(k$==Y2AL4+QG6U1divmv_a0
z<~xIT&x9Tv-b=EA?59k>D$_O?<F~R24g8*`w7=ngL0d&X`!i@rV~OA8I{1xl1`R2G
z(_7I01N4`Skuj^(W`Dy4b1)Y%H}l-EqITAE2iACjbwA*~xqp>S|9-*!_Z+l16Ur55
zqQ=O!vE+hd^-T_K&zNVq``!s`pE&QHJ^dWtj6u$x6>%Lm)-ua_^c%2?ypAP~7%y27
zTmKd~PJgl8!1&Icyz`xyKc!=2zy;^AR<74O>-t=8^IZ$~q5ED9Ch|bz9Xou_!wqc9
zC^XvoJ5D;Rn8&#q?5Ec5L1KQD)St*ZrTPJ`DY38J_|E0L&Y!t#+AnESYBPVSYpU(E
zSLwJK=Wk-IFLM~zcpY4W`{bGybhxqJiS!(~w;eY7?EZTu8+h-07Wr(l-?4cn^z%%J
z?PSnyfo=81b&lq_37p?N%;!M!90lgO;RfcPsMFShiA>ZP%b3P@uF1TM99)yRyRHQT
ze4e;Iaeb0&-L&;_%m!n)4&%uQ8goeYmD<I2+RbIdg&sNPy3K#X1=qRYfO{tscHq7a
zaNotgcKsb|oW#C*$Lc%zO*{DgdZF`Mbrm)`W0{-lb^X?3f^BQosDbM+ZYP#;4l%@d
z#%_V}w5$Ic7JkX0-T2KsVZ#juzkOu|*;neLZ<76n&UhWnX+(Z4+Ujn>{wTJzo11YG
z`#rFoePh)a#!{!RJ_pQce#mvByB|<5Gib;^;atw^{KvgwZwGi5JQMEWd)`*)CTGaA
zndh^`nbQAH7}q#rdo#xIi+Dd$o4GtSF<<FH_7D9;U58v(i?w;KU7vAVFq|Vu-J*ZN
zv+EeK{SEETVXpf@oisT3iT*GBi%z}yn49;v2e#cK_2UETwOilmesCXs)(q~Z_tWQ;
z&mEsN-sRj!+xn_kx*us%+E+iIfic9sdhPDtc200_%|UFd)7Bv4+E$mo2S3+Y*XUa8
zYpZb_cMJC0!wmZ>agAkPTQ}!tEkC*v$6Pax^PdvS+$8s6QTq$-UERNq&n+=G?V8iY
zJ{aftQ?Q>5+M@5zoJeD2+(n+7wYVRyNo-%xHe4_MEyf$m*atFS<qWFsPi<ou%iN6b
zJg%|9w0_XRT*SN@crJUv{ton!3ywWtJmcQLd91++W~|LT2KglBCfQF}^^VzK49S?r
zmmWB`ISgoleeEq`T%_!f+5e_X{lve)Ay%^fFt>TsTr#JW)@_0{6zjR7w$|GE`%JjJ
z)2F{<{7nPb_dD`{`k!}x_%x(??V_*00g^#mS|N3*pZsR@@3;J$PC4jb=<zq5z86;H
zaGBTVn3!|6l?Pmp>vPT4WIwf0Uzs0jG8o?qc^;MOwO7=o&y0F@r1{7y*w?1t2FLzJ
z&a?27?6)#!&gDD<tdV;)p@I99*jN9Fjs6ylCB{8a^EUUF8SB#TZ!xa%2jtx5k<7@o
zA(PbY@ViJchOtgyJ{zo+bz5+Q&c3_%o`pOoo|PNabEA*GIo3EYX;bPeEzX{?d^UKG
zz0=-r@viSLT=bRnn=ww=z<9>(53a*`Wk4&~uV~9PnzwDKV?Oy9V}o;>!vS-un5XQ*
zrJeX3&S$XFev<m^=a?$fmNLg2;=JTLEZ=WC-gC;A^!X;!|1$OyX-_%vYhX?tat*fC
zX_FrtHTCTJ%=0<uGqHivzdf60-7|<^i@F-mu`95>(P<a=W<rObePe&S`y6N4csK5g
zcgFdp73}ZeA|?Bib|v+{$;+6ZbuhPic=j4=GQZ4msmITI-N8FQz#9D20eL}tiyWNO
zG4>s!zwZ!hH^KLdtU~Inw?6td-#hXCaeVh36y)>N*s`4ioKI}4OVk}OC-ZY%)_=#E
zUH6MMSiwb#`{!P|--kU;KJB~vt*_@md-{6LW?(z@uXIc$$8E;Q4EeS%dhu_cRXF|~
z^acNBlWMPHZC9J^v=7?OH^F>e?@x`Wmo>D;%1$l33j>td)>oT8Eyi5i_+043RA$>b
z4z!rld0#d<^D@U1*iKyQgdNzfq~5>bS8$Qi`L_(24~PCs_0eYk_4(9qo%KBo`k&b7
zlS{jPf2-~F4{P}s)EL?R7ANh$$!}xTpP+shv^|6THaOz{Bf82r!p^t8ml@v*cYG6U
zd`ruAN_8W?vHAUN!ujxRFu(OF_g_%`ZMVSK73ZsT`oD3>wX!02W$FjdI9Xq~=%xF7
zhf`=i6AQ!pTS!}uaeSrIPf~9`=lo6PIAxAiI%dIu2AgNO%%CHa)NOS7isN3=rk`Uv
zEZ!LdF7KIL-Z%N)Y3N>#@3z4A)qorCv5mB?uA=S}`cG)V@i)gqzBfDi?cZ#Ej|&dp
z>109=F5mfH^826qY%A^OIAhc}sjpJ|0p~Xtb28sS{+%^js|(ikfHk(($)@eTTzL1~
z{)&B5rq4kyGtNcBW<29N&j@U*>oK2x0~Q!tjN^IUaN~@tyWwkoHFm}{u5H&QBj(cA
zF*(lui#BtS5v<Zqn|?{^QmUWO!CZbrAAL7CenGC?buZqv$M>!8XPB_z!s5Mq0^h^g
zR$m#upJSY3Wd;pteCO$4ot<|;1MB?>ZTjrshE$hSo3WkCxi4gXhuq9v<|9-8N$UIZ
z`Wahtu9Q_bqBiDaTc0;h_TO=?rMZ@<TVw6k%KdX62e_y1t$W<Tvp6}Ehx@nU4yx1V
z;_LXVU&fp0#JKvbz_vQkE(aXH;evHHzZ3O0UzxDs2DJ{_8aT%B#%f@E=QP(`i}!0o
zD{FFHiR;uR6E<9M&Fev3^4jcI+o5j`<|2)}M${u~P}lEzHuTuz#`%#MWZylm`+ONQ
zq88Rs>@WN_V;8?=JHK5wG=8U!U?Fc{yV=IyvDVR?a}DNg&JCM+7;nVb?(bUK#t`+D
z)GO}?9G^_ua-i{B_ut@HF^=;MaP8)NsD<^YsM9t<zfUw`h&KH?I8KaZ-6mL@4I^y&
zJO71FK4NZ_8G3EsSd2H0@fuR>%L=lu&y4)c!+gxkGt=R+hdXeuZL8CkcKcPQPlFlv
zO(_S|%Lq2oI0u~D`t-=#Trbph+E*{5w6ovPxu%NiGv*<7u5rd1oi|z0cKzmZBOh~m
zF^+bzUG0bdOSRh`Wqig-If>bvn|wN0D{Ge2n(3GRxej%SG4!|oKJz;Fa&bS!_J)Ce
z1-A85ue5)mGhS(5n`4dPT^HLkV(IrYAM@5+Ge2dIyj+vMiTygpwe47sW3*>3-{x`c
zInFv;?-S%Xu&-W5X{RowwoAO<*fC#2*0mkhWv+{Qi0uiv#_L*G(*nmieg?)A`z_E%
z-%6)%oB=tX^VrULHn!x_cDyl-e+#bl-(no&H87{aJg(I}8qmOVBc78EC(cbhL!Kki
zuAk!;+`zRN*Y!Dv>vBHVbOLjb8EoWB+CIsKzp;$j!8yeFq=ECBM`B;S_6?46{3#gs
zrP^&fMmpSxWy}V3&dz*U6Qwnh@dp}q*-_uz2lwFe4xj$^h<CZ~^G_^)t9-!ULE>+s
zQE0UN-PGaox7q^#W@|9{`^~@Oe*Tt=zv<LzyO6)PjAvZu&792Be3MPvb+{(ic%kl#
zb*#12_SSSUW`N^sjf|PK%67^bwzMB|kQJEIB{wn0M7@6RICT~6?IG<eVrR@r{07!&
z#U5SimRQ3P*j8^%6UUsuIL5uu%@dsO<)HhNpMD)2{|RkU{hV(=`$Dyur+(^W2Nzk%
zIm~gw1^4*`-lYi}yl3J$S;0k${Q>&v--C?v%Csx>-_RH@##wL!?|U+7Cx^D=b0hm{
zPucM?mN8`%8g1tm^N{`vu4BP?P^axTjJ?76%|kAjUnTQCWqpI^W3oRyv;U;Kj7d80
zGRc0GY5N<wi18Z-d(!;f`UQPno4N%ZcC1~QxvIBqjjX9>*K_{gcb2>3URc*r#^reB
z25l`c)(qSi_h&!@_s)0&Hgkz{zBF`y;>5l7ZYS#MIQyw{jt#e99*KH=jO9JI4h?(;
zOz45_pBiE7F}G42r~l%aH~pKQ_sj4-!~3S9uA<)o$82cv{2WMQ$pv$8{!cisd1X$A
zd=l5?`dsS?I(s4RNwR6XPsyU4d+%BCEJ^OWd#+s$Z2H;{)U#+`ebQ-Hj3?@<Pt_f4
z##HLlL#BRW+keT$?@#!*U;1R+$+!m2?^<2+rA7m+oprRnD{8FH8XlO|2O8tVzT+Gt
zS7|)s8lQPOIV3l7R$ocIQvHAiSr>K2Sa2THRnqRi0c;rjn}@8Rwo~_;Jd8_vCy!tv
zzp=4>qW#laGH8Edp?|sP{w<yFbd~&WS9SlBcE&r*^U~s*V166i^pi`w^9^wQfrDKd
z-_m5lhQT+v1=nwLe8-!?L4G3b%KlJo)t<3m|Lh;;{>F;@l;aE4wte=(Ep(oD2O4+r
z6WS{2Gx4ve*KY+KS;;vwhd~a1B7LjOF^%zZe3!rsy3h89v>o(0PB~ydT>6!?5A-cC
zjxl@T@?J@n?-*#Xc^}P!{nT~Z{#~_T_&$T}`z`3m%HjQ3S@dQ2-i&W?evg~bz;ATl
zSlE(IyHdXg>T?Rlt$eaM{|56if7j+(UAMKdZq`t;rb=tPgNv+aYcNaAjdO`7>T5jP
zX?IS2?5p3z@vM4&2k#SE59&5{&$IIm$D4obmGZ>8W~@yg=b0aJF@|$%>w$gs<}<!f
zZTiaVoBAq^{TtQSco$r&HF4dwCWl(c`as&c@92Vk{Rdp)CB~l6!1<&H=8&k<c0hmG
za0A<kI_Jq8HggYtBP@R>K=*e<aQxlykhUs2J}<^fjGd(JmG5}_>62rX>eAQt0N3Dp
zT$k%?g-KhijWx1n8wNCR-zRt$J(J!$&#Gru?04<>8pk<u9{Vj~EA4N%fqo}ytz0oy
zySDU8sZO5*uICfl^l{7t*JW<5CD+lsSLO|_VFZ`wi)@(C;PBj0s=J`CV=C&jiGGrO
zZ3mpoITQP`!MZN6jt2(0cJglIzrpo1);nRt1^4yDUT@AqWzv@(tT+cbMqhtVUzq-G
z4H~~q2W+_DH<}e3WaGDGVqcqnj*)ka_Wt-Z{3?$7#>OT$FqRni1es5jY5OD{D?P~A
zIoBxpG}>7krM2oXs9W>z1?njF7hKRT_SI{jfqiYpz3}FsF4?q4(2$b-O<S_BY)}8S
z9p;^2jy1PVZk{90hUd!jl}y@spL*OY`|2;`d2+mQGS;G>XmkB7>Y?29WzfE0UZ3(;
zCz-o`Vn21A_KMiXYk~2dw}-TyY})!c?!p_>zHznb)4(w~-u?)*XIp*xb^Kp)yi%LB
zk*t+9-C%uN!M<#`Fc>4Y)m0{a_sHj;&yUG-#Ak`}#4}}t&3@H6#(fss8}!x3XQ<Dm
z&GX4;>4J$~yS|cRo!^{X+h(2CrJ^qN)@}tCnRU0F{oJ2C591H#UHkq8?HS|5UYmnC
zne&SJDw7eq8}+u%Eo$w07bw+<_GHt(V2lHudFGcIn8$z?`Iys-W2J}8ewErPY1`-%
z=lDkYq?~20PTRV;F4yeddkz}pnX1xr(&G$yZahcITh34~_4`ye=aX7LbISa_Nqv%5
z+Er&vF@6u+FV{DMhD=ho!{;J%oH3F^yW;${pMD)bV;FBh1M51$x`;JirOwuRQ&X|N
z*;X$jWa{;i4kz}YA!Wb{4pN`=&oSCBcYpdDC4R5?yXD4jn2G%PofE%>2ET!%fxn@q
zf4>EnzvpbL)2`oz#n?t1W9Dxn=V~#p&mMC~Y2N0$$=CH>ux8fJI#xD)QP+a=huY@a
zd(_Q-k~-(FEc(fyT~U9)v2UD=mr}oqW0OJKI%F-Z#|#=W_otWr8L>~+R{bXy`V$yO
zGVZ1=7o0!IoKmXSr}B=|_x01~6B$SU7vsnYYCmhdsde6m6=x*xlxM{=;Cb*|Y`Bp3
zvfkCaquTXL25o5tV~X*U)aj@H4lXir4(E2>_gQ8C)AJ+q%6Q5VG^FI*nad~H$<_Na
zz<PZ`o2<g6?O0<TaPAEkay=<mtS{v$Yt8j;*7=F~;n}UOeL(&Gg^TUw_1EruI9as+
zmV@t$ziSeI&xn0vHgk=AvVPXbd`6kyd@9-;`=VYy$2YLX#!K00i~HkT?wfn)zP1l|
ze=3uHFW672-ge&0lz+0PUzIEF_(1wB@EI||=akQ|U7l<8`IXNxrTQMezN2QmqgK3o
zeE*33%BA1&bxezSoUcAZjqMzX{Ys0RU59nr50}2RUvR+vXt6i$Pi4`+;9k1FJ@#Me
zo)4JV#JyMN`8Yx2yd~<i^$)yy<7^l~#?`O-syCiG=a~<i{(s74Op?Fb?bkSyego$<
zhX&TbT3NGNx0?GW-=F6g`_SWAHi&hI>l`<zc~srv?~3F^Ti+e|8K=><uU=pMD(VJ&
zimTt`-z|2*fA<*it#B22X(zq^S6lgwiR~K)Thjh%|NTwS_V|U3?Hd={H~hZ$+SL6G
z3%|-K-}$P(wtK{`x)b9X-~Hx8eiKw)sQqlKm%+C{S%KdM`(Jz)^t;{(+W-Bpwz86T
zeUl#F3NPRAek1+<MrItp|H=45+Lbe&XFk)KcPZFNvH$bD!|pS1`5c4>n`h-GwCVHm
z>h1px&M_Z4{p9fMUco?0_LZrtGVKSu80(#5qx;62w|*UrHG<7MW<m=N@1zAixV*1+
zFnoXU9-F?)3YWjVWEDoVl`Zhwn@s;^E7<==`dz;DC5!e58nTl5h5iH?Bj>QMEq&~p
z;{w;`daZ$VxnQkUVC}5ojJjuyt*tuk`Z{idF{DA()tY8~)g92T-v#3j&Rvi5?is&9
zJ@49AoMGp8?h$hv%b3P?jvm<0dGs|`$#I)8$)&BnqAu;TwAE>o*I%9X#J;58VvYl@
z+Zwu-tZS9l#P#05^?ySjecJ~{89#|3C#3OmoOy^jNeA;x?5lSUV>-_9#*_2V*u&gQ
ze@C?VeRYxkHjw3SgfD1II&E?6%SI<vpSqOQ_O1P=IT~|x*TK46x9hhKFX}7Wcht^W
zF7P~fJ{ovly(99|MrWNb<D6>+18ILVx7fd6P7_Yl*gS2k)2?5G$r$rKk)L^0R`iwU
zA#JXsgX<XZuEA$X1D`80;l{IOJkQ0=b4Yv^iS|!?vM+pZ&|@y=b$+>EE%W}HXOG(d
z)Yf%S3+rNytd(`!agIE9CushLEo|DAOMmdYbisknZ_Q-VZv5sP!9rf>{Kl+I`ju+4
z?U=+E1Gc|u3-({Cy|z2PiTXx7<KDnIYd*EDP4solfEMf$OIzC2i*t3bR@TrOTkEX%
zL}xv%qrQ$Ywlc@*<G6<0U@UEpu{{d*6ZOVcs&kC7N91X)V!uJoso(s9wiEG;J<W&Q
zJV&0VUhbfG_PvAGdk!P+n?CEqdF;eYjPE?o=iKJDA#=8$ISuUkZD^3W)pM@y1hzY5
z{@x4MaA1`Cp^v@?X2f@%6?M&=lu4&8H8=B194jZt{-AGcWnzEB{6IrzUgp<>8@aoN
z2CheDpiZ<)_N$-I37;1}H}ZL?Jm9|O-m1%e)#jcK#z~GJj)~`}?*p-~-uU`m=ZgGn
zj~H*;{9K#s{8j_&pzVTnJB3whnKe}>2i&LJw@v#K+EZ^k>9mdGyw2}F+^DJbc1<hR
zlC@Finl|XG9MB5()nCYcHMTWq%(KBcM_Gq!c`>(dINmri3yrq(IA0HJC#h4K-zTb1
zwp~vH>tao;hx_jt@+^pLIi;=MGq%BVqqMKzjPqkW>$;=1gLzhPkxAw<$^C$9{f2h^
zq!%()$`$hrq%<%Onb3nnjxXk|P9OapTgPXApkH6mrk~?wLJy4X90M-3vgX$8r*25=
zoHY6`X;ZGpH*M;ZPTRe4k4A8~@BSXS{4N<mL;n0;@oyIB@w;&FTc-KDCVo%-{NCZW
zkH3M2zk&D-mDoSv?=HvrJIJ`s)yn*}ZBF~aoDW!&4c1Dm+W~87O_N$%?fMP4G2S>0
zjJd%0mpR3@y!tmM`=en0207jsr(i$nw7-#Yl*S!FL%LTo3)XW{S8JOL+Oqz@#V*DW
z<DS6z5_8D*-$?x{pT?wp<0}`eN!CbtqOW{$58cZRx8Poj`+gwL$L5T9551=s@|p2I
zL$rOuaWbHR@g_KjIG>EtR-g0h>lnux<Nm@5n^H!h(Ke3pdXV$fzPgtc`B^V(*WgoK
z)hGHToA!wH8Qb|bn3I_2D%h{OOF!%Wo7C@beRKb+JiHIYcgF~9t6RiwVBWSJm+zSL
zO}QEKa?w?^*S_t}dp)tQ&rt7N&dJ;ZX+G+;zg%>c8c)6c1B~GsDxLl%zH_)v_v*5D
z?qA)@Y^QA4^Ukeu7vD2dZMJ*h9j<t<ld89!dgXuyK6`uyNe_I6HSj$o8|;rjd$!eU
z*YEJY`FZd7cR%>f`iAy}zhfM0oQ%0>U&wrFZtByv$#=1a8PBS$rTyg49@O|+XZEDA
zH=c#Wy}GbGBkW;|J$9dMZ*&Knc5$E8FUa$e@`hg9%Rna$YRo}Q<EvkAL#Cg;BlONQ
zKalfR`N^;94sja4)nC+$zCFmC%)@+U)WqDaqjg=Nw4Un4b_0EEEA7kASmG>VI*;?6
z518METd+T%`nS-j7yB>Y{5QTAdi)!}@!tTRe*@X{lk2~KJdDn~4~zac4z{HK!`v`G
zu+jZn8sFkRVZ2ZJsvC?=7VYFlTltCftMZdy=Nn%#X;%*Y#`iuMg-tuTw8d|Nvfx1T
z8yZ}{wed}F6%K9b@m;X?)m75=Nv;y}Pwj#4OOAQ<=A5KWU)#!`Hg{|U4JoI*W4g~e
zo_WjX9{8-E&;#4*8aB~qJ*d;B-;4TcGu}5kw!<@8Rxps2)GN;~Xdl0zJvkA_`IDOC
zF6&aSk7FD^VDgS>uy`+B-cK8v?<(I}(Bb;G7wj(#^wJ84ztv<09r+3Eski;2?Z!8~
zf&7Nw{Pfe`7$?Y_GQZR-)m?Lrb@zBTZ|Y%fUJg3zXB~G)`&mcF4`R)zo3#`Ba)O-i
z=ub?~nCJR(z8CL{6LjAl=x&_Pg|EK{%uj5qI|bvVkJ7$A<|(sK`)Plru^n$5<7Mnk
zJ4wAhpU|HAh0lSU+qDl^1=pK+#}jq>4QPSw7j2t$if!!|GLF*z3fsibyv)-zWxj8&
z8PBnk7zgsXq;#)jyJz5DHh&wy^>>250igRk0A{dDJ9Q~Lw&QP*!12kT{WpB_H=j=!
zFZC0j2Cl>PG_ZDq^=EyvCM{~IP3))7q`n>8_W{<}v%doGjqMia#BtXc%(ub0#rq)U
za{}`-&&0kqeH`QX0q&K1X8y*`95c_Fqj|db<|>{Cb5<tyCp0j3*RbQ+>0S4^lFyvY
zvqmO#IPpC5nU$#fg#O}K*+KSuu{Gvg@l4C-jn5jNN#=IJJde4WH*0hK)}%$PtXZda
zGU0$V9dNBJ=fktP;Rb`>vMZ>+J3GHKXW;KnzuU-&-<}tlbbe$0iS%7Dejpnd+j&0C
zt?d)~C)$l;JXwWHTg)xn$^`=&I6h-3GhW&{I_qP-terLNanE+t)*8!z3;O8qnlh$R
zj3>q%5m#T^wVyiu4mif~l}+DuEVzF_9~scVv0}Uq&f)xxTwI^)@f>;ocDa9tGq>Un
zde@uJ2k)A9inA%+D|OmEpNkmAvo?#^*2j4^xIS|*Cv&T))Ar*Nc@69P;e2oONqc-8
zbHR1x{4?fv&Bi~0wQx?^LH4Wc*j}oA$5_`O*;ne<!8x6Kz$KrGwJ}F)m6&@kxTcqC
z&$d1r2KZcXKipIIa=>Mu+*AARm)K4wef^c9e!&38=J+0d&HaV}&LtN-PtM;WAM-Lt
zr3}dYjO83++gOf2fquq(;~HZ}Jf)};=dz~O+uG+I*nU~)2DlF=ax_NHpEC0>KQW(%
z-;VhfV;wJzSYi&wz2H2_`H;saoq1>OwVl4k8<D$nCC-_sYk|3$=Z(Bwr)$VHrc@`|
z#dfa0vF^HOo{f4wJR=(>v<LO>^NfAAhQ`ggHuKz|N3Q0ZsQaW(yYhs;ev<KwJ%Wam
zT(3DKy_`4mds*m4(2%0eaguRfd9XQW=Ag7M+S0$%zQjw6J%WbZ)Xw_32Xf-xs7q3B
zt+iL5jbEkuUiQa5a^L*j;j{hnjQ4kl3~1nQ6QBPbR{VBp$Ykf=Qu$kl-#@qDZ!S6D
zZy;kB^BSMI2RWO2(rG8=Xj|KXR@QAh*|aZMy93r$Y_C9DqHp5Z2F~GJ&ROSGpH%w}
zzv{33#jz)Fo<A`kAIBP_KRB;Bj6$P**vDD+(>lv43~OJoFRO5Ai|4|4$)WuX=daY<
zKD9Ugl}le-t7|@BJvQXtDc1+8z4{z{Jqr^ycn7_Y3ohidWAgm?M*4h`#xT|Z<2#r6
znZqUT#J;&?9+^vv@y2*D=HJrrHMaAALR*q{^GO!%0oGb($n4)(i$2M#GsXeqJJ$yD
zT3@*6zfs2w{C*>SZ^X-e%Kbd-t>n8=sm*b&uXCmc&!x-r$$QYyHEeavV2tdCOaG<w
zp8k#W&sZa3E7jfLw-}#nInEd(XvkcDXU*1VfP3Wrxqh*o`>IS^L+?HGKIZ*Y=Ka+6
zqD^`kV_VeADQ)#)+zkVK#!PT;UVJY7>=QEIO;y_7(A-O~-QlpuzJJ917We!`y*>wO
zEa#L37tG5XrRHe=fa|e-*3!En)^^j+x>|=BJ_lRg8}E)>@SM7Lvta+A*OvB;&V65S
z3-)C^H2Pv(V-0YAabD+e%!L)$7yF*U`JnD%6Md3FTUyA}U;2`<4&#%?Z{kGVjMxKz
z*J^&Q-Mp12ux<X$bx_+8_1?%%jjgk`sT~|&alEk`^Q<Q~^BJ(=2A#hJ6Ls1Kw1WMY
zUHo!=uF<x>+AkP;!GXrVd&vC4_TNPcqZ8{33%#5V^naK)n8=rn?xpcv?*Au)_<v%3
z_(quD`l`J6)xPanIJBklolger4_tJ~r|*F+z6nm`{_u^>?`!#u?a=-c>o0uX7>=oo
zGH2>j_a~YDDNo6##XVDQo@+9LjyyaMSKu=~QLkP98e<SgGTs}@ajTH=uFqcBMcST0
zLyG;Bws&xm^2SrA&x8htcYydlsC4=_-a)>5Mzm9^y9NEF#;9#=`a9ltQiq@4D*j&i
zz<P9zzHI*ngB~3IPFpYvmw)%Jq)oq<Q*`<{Zo`E3pza3x8q4uwPO=MC=XzYTYqth3
z8=c(1+8uDOJRc{{i2G(O8-9~mVoYTR=Sl4AXH4U{-^Mf6^(=EPr|)a{d8fo#{W-(f
zop%I|Y3TC&+E!P6()X2@IX_`8FB6?KaQ$Li-3~6YGq+MwpHiLn6&&Ozay^^1$Sq9T
z4UEwX_T>cnB#x0C*lwV&ISp_<Gsv}>w|3*|@3;$#{cw-|A8l`UY+H*XTJm<Qx}6}O
zZdF@>DVTyOn1U&o(qrtDq7?L6`<$#>{V+m85<>h;=G<q+m+9WPM?3Jnzv8_=dCxcA
z^L|TQ=)UV8eE-V{8t>*x+KuT2^Cjm0MEX-^%phKDr{2&H^;&ZWzgwKg2%Mkubk5_!
zwMg{2KCV-9omjUHuA^(*z_so0bM`s^Bc228#@Wvthg`X~t<+*&7p&8I<$OTDaRaQs
zNBwWDo3W<jMXi?_tYZWXX>IeVdqwTmFAaRw56}6C`_TJmz<%zl_x^g@lX%&2r*(3?
z-0&%lOVXb4i@wQ0Z*d=5qqSPIbIJ90&s-1pz_oJSTtC;*^>nR0Hy1pYo>9;2gbg?F
z8*>%%8+P)YxdXp7WfZCYVob&U=IL-^499b9>qz#OTC6MMGv*SjO`jYvzc`lcqTB9Z
zoY?0@d+lfZ(8gFk&pvl~emA<dx}L^KgN4sEH%@7+Hhq$D_SY`zwVk$%x6g(P)@8lc
zXw6yoMo-*>x;M7<b+GRObD493V_R#pX3kCn&y(lM^VK|KaX)zeI(Qc4KKT6kT>kW-
zzi0B0Z*v|O`6puy#&rB1wOCWurA?nP4UD(8VPA6eg6(9Zi*pd;FLe5w<AhXy(dSr>
zxr2-R4eOK@9AqW!$`0l-_kaeq9`)Mpw5@%`Je*6?&=YMdP}lAn<eDfuxc--YXwcb{
z!G3y=PEfj6+Aion1<!yseLGMWea6nnt*%WRYr|k{SzsO3v;*s{HCwB3#^2~~ZZVf!
z&@aZ?$9#)iuG<8q?Zoy0*InF$-!R7b3HH6@8c(e=#?`LhIQwM&O%Ayq@H|vJBj2cT
zub#ObXMp3+s6#!`R_V0Gx@8pxdeYFHr)%t5yZ-KR2hYMNH1s@Eoila00}|Ua&Y9=N
z9OlYBJmk*xbWE{^^?_<v|63Zdn|b7X9Md^jgJ;TmWCjgsofU18F;#Btav^i3Zribv
zgD$RX>gjvsATD!PIT@z~*0_G5<8$4`IOFYGb7;@F5qs&rt@ys$-0O$Cet6&WEmGOE
z{XS{nw~DOb#@}-T={JqvHi>QR8+!CJm*X_X^~`K)u`cVYHEPc~jjNnEYx*zPFW1UB
zSF|7eFKN#)&DFr%iEZsWxFNN*2W`m?T`4!{WuA`vqW>lPX0Ac52G%&C7knObKV4t<
zRD5Um*x$w4i~C&Bb^>GVBl{N|BN^z)iaJtW+SaM8Xmbv`;M|<!1=nK2fx$j*xX^vJ
zpgv0{+S-kg8gHyIc@JHlP5E@ctUug4_S+AWb_2(;2FD)I0(ET{^oy|v>}P-3A4p%r
zXS~?=rDGGvsHDA0{ToKmkcsR4qR-e}u&v$L8K`HR<1IK~?UkI9a{ofcwK8|}CEAVI
z!9_~$t9zMfGuFO6xYTd$hqLMV|2gxXRqQ|U<=wi`lg9g4d@ujTdi?g0PkpqTf5tc&
zx3J57Nc$%_h?N#(-cIfl=i9Y#o-NiuIbg#LX}dw)<IZ~de7<P^#2c6GMUG^kH}Ed-
zPUx_nd*o-2+^3-W2R84j2Hs`;3zzqg_#R3IdeTDIcfmZK3-kV*4deyK6KhC4r8aR6
z&dD`#4P8^up6k9{d+>}^w7uxpwgdIrC-p;|`|DokzAJO@C-$VHuNd3B6Y{xO)TqsT
z#_u3?bB>2Pj{U5$fzR1y-lDEeU(J2VZ@vZRA-{>W>mOhpoiWTcOU{MOyh_Iyj)UJA
z#}@Y>v3<Zi#%{P^|Hc@OlkBL`Iws%q8ybIaR|aj-rr)?E<1;4Z8*5y~>Pw8j(D_?`
z!U@zXX>XmrFoKPg`-T1w!oRSv%PF)kzXML}@+W`B{ZGoxxN^TR_^nS~zqS<|q;!7s
zlUdm4(){lLgMpL<7dpTHiN6J&FEoBnlNk);{=&unH`w2}D%Hn-1N;4{Z^op&^bzmC
zy#G>a`;Cj=JO6<1fep8iZKaH$Art$Gd87yCUO}y)VH0f&Zjk+yY11zQ8u%XQf$s)c
z!9a@d4&Na%|ALHFUdTK(mw8$t{}%gA`gfXtd)@du%)iGP_&3^w{sn!;{DyfF<Lu+V
zd#^(NJNPSm<hK7VT=a^y%K_)U;Xb%V3l6w18{8-N%zd1}r9D8uamFY1H?R3+L@wja
zk!Mcb{`Q;59OEa3SZ($-M~htMwvV}tzYq4EZ~}F0#@a_xZ|D{CN(XClti-nHlL;HL
zzq)8oZ0lcO4c1c8cEfLs*iLK@Fi+;Pt-t2;xphr9T&Ula+8Q{n`5IVX57f=A&zuMB
zV~!KwT8;O-?0Db%p6~IFZ@k|}d?y@arTcC1y!U<ge`A(d^$zA+!9e;=@d<sE?4wNk
zrtgFXE52WxlXG*v&U=9J#u}_x2iHO}uHkpBDz2Y<Gh&@xSJyeuj%%&2uJI(N;}5Ww
z<f2RcuCjLL@S<HB{OnE4ZO}h!c0LORSo@~d3Dzvuy@H0UwdXT1IR7`E!x_)y;x6&d
zX;AO1!M)Y|4e$TP9(3d<^zXnv_FWI!qy-so-~OO2{l?pGf%l{}TC4Y>_n`A|Uhb27
z<C?fmuAA%cnqKf6c^)_T-R$@Cjqle}zF+;elpWug`JLJMwtUei8LN~5<}|-!wLpEr
z#HU}>J6!CdU#aaApW@6RCumWFby!bg`y0kwsB_e2PRDGJ&$LopOVO7M^iM48(#co3
z*gj$GfL5@r{T8X7`P9?5Lf1D7w)G9j`s-ZOJu99W&yLUU<{bGfHt>1B<vH|O9N?ML
z-s6t3-C%PbMO~YI^IY@AxwMX~_fl8Z*U+s;4mD+6GitMcMf-*equiTS*H<xKCN%K=
zS)df{7aY4sE!LY@TeVyBDA<;aPia5taAIzbQT0K4KXujGtT)MeQySL`uJ?wYd!g)&
zcjw{W@a|Zk?tbN78Sj1#_bd8OY|?`p`)WJw+D43Hu7mHIgPNVwEjUlx+8a0rV|R>a
zUUMY2t;HDUX`dPWFVb~%T{qOd_**^qETwtmZC88dUhK8pAfL_mIjqlQ)oXm}>CblN
zex>7%pdpj2Q#qjro;7j3l7XJMmKz#)mImwX{@${;o|PGRmc%oZy1or9_V3+0_d0Q$
zWX9MVc?0#zq+Lnh{Su#k`!w+EI4{r94xD2P4s#XfY~2-YNygiE7cTmX<IO<5l6K_@
z)O#WGEpk@|ZE1x~jiN1eYwm%%_Sz?7^_|#f_t5*n??1l<{hsROTWZ9&RD0yl_X*!9
z9Twj!19p7F_#Gp*{hks13yin#Cg0C^jD0;<)RVQR)RuMroHNgwvGfu32^UtxI=5Zs
zJ)SkwpZV1jZH{H00p{EV+uHS?f^8W=wo{&n{WNBdU1i3-GV_>sfc4ZGC+!yG`YhH+
zI$ZYG@8%Z!JY%18uP^(NXw!ed_}>`#zp?SjeXt&}HaTGJ&SAp^=jdDyxE8rao?-WN
zK|VV^M{+)p_8Q~;Fkr(CI(OqIR=Gb<(bI09%u(~H4`|@n9WFJCwM({@`i(naAN%gY
z4PBY~KyP3l`}PO(I?f2xE0=bX_JM7)-jZvcQd=uIvafQ%fCk1TwzaQ9wl6m8wtnZb
zV{Z2k(l{B=3bthj7b)(MxM!(rAK=*5kaTOIt_Id;jQxDK%KpH`mha|oa+UXY#@O$-
zzWOFOzMQB-yZMrXo}_L3GTx@Yn7f&ayw20PFXs$O=dVp^dwii`&oiRzAI^^U{lV_@
z?Q`xk@3Sv6Xh`n{?}#4Kw&?qWK4Tkq&f-p+@s9Gn(`akUdoHCm86VJoq27t(%e|KO
zoa4)aV=dIWoeT4Htz6T_dT-Y}_SL<0FO=?w_Lm!d7E)dRj5ynAJJ<%fcA%cL7$f_c
zYe0idT@$QNsm(DmU*<?@u8MKSU;3?*(|m_{i~5Fv-?&M<IX2v&m$RMcxk~-U+t2<r
zhd%REzcpEpV>-4qENZ!&$AJ`e&*;zlCeEYhQk${0Zu6P{FqYr%8!o*6{-7<<w+bh8
z{S#Wjw)SMBYZGne@!v8g>|bb|yf6w2J-O(WPrnP!e=yDm{^mEr_RH^s`bMykFX{VN
zrFm|l`y1bb{@1pMkps=&{t6RacHyEY`MaRM4W19=Z-x1Lp}!e!Xz`m}{<fy{x3y0!
z?B6i{^$lz<#%NQ1<Kp{9_8F0<%Jik|-oJ%|{)xu@IN`$Zj)cy0r<4UFP)`neVti%#
z+y>f>v)>3DE639=r(j$E4koe{avsjF!{s}92g7gX;PBo^CVJ9+pA^#m%8a?ZyH+re
zFU@xwZ2rEIY*(B18FZu^{ytlUfu3kT1>4^+E`0<2Z^=G~KGwFung=YnL9Rot&tdIy
zja~0#qq`sOk9+3+-GXiH4UAb4tCS9x97+1^lYLLbG{>S2>$Kh$I0xsF^U-gtIqmD%
zna`ZJFgSM={l>NrXs;M!erxVg<7P}5g@#^nEt6T!q;s=v?1l^Gb_`MPpj}zfmVMH`
zh&f=*8=R-lrq5~P9V@#$v-*v-k9~Wf?p*a5bBv1|iyWPIb&GF|&inpAi*JOV?*w#h
z75yXFNV(8?$FC2hT`9(j{RWtOg5Me=SblTBg&zJ!tk@?>Tjns{ehs$YA>cemte0!(
z8ss`?H)cMuE#h4(V+XhouA}Q&*E#o8`%fHw9Milnj+1QkWJKN8pYzQ*&6vM-F=mzd
z<=pZ-{OqrL99X}sz#1>L?lKq8OP<5Qd2HZ$zVW>JoO<tgS6zO8+b}=SupNH0ll6i0
z8JDCjW%ldzm-~M)UNDeJ+LSji{(!kJcxPI7r+(+){o?$byX)0hN7vW$biwm^p!u!p
zceCHeu=tKV(D{~}u%YoS`7$1xag{gTw*DD(q~kbVj%mA+zJcA^65I00pZ0^_F&u9f
zvaV_~rp9GVN@Fv|ypHQQiFIw5h1zb|UozIX3z_Sa)Gx-)2W>AGn|W5$sDDBO_gofq
z@GK-d?weDdKc7L#XY!SvDLEnakMhiRp8dle;XQFVhn~fs^N93W?ZMP;Ed8y`nv<+s
zd)A$`4{B}?=8$Ut$xB_{A>Lm;^FAX7)PL>*?+NO#)*1Jg^{ZQ(&yYC3iZ)~HSLddF
zur2(K@A_V__N?Ew_P=EiYpw|$%xx{!kXTDE*p?kKeLuBP-=)rJtz|#FH(!44lCZmP
z3+y8;a+pVKr+uT}K%f0Gx4O3BI)T#o2KLwQxD6(Ex9=m{Z$Ibayqu$J;`%h!%Jq^B
z7hLxPo~g>DE&Gwx)}oL7leDGG_)YA6sL!^~=KmBmuX-KVI%d$2lC`fmhaKtKi0dRH
zXh_dno;BCkb#|}ZC-*M*$vx?Tx_0-`7-Qvvd+dHq@_2ULuUoL4Hpg`@twAZh=-ICQ
z(|<~wHZiVB^%<nyu^Tv7YjnQWD+@;8T*P@Lw)Go#!2afWF~5w$LYGgr^d0<St*NI^
zISQ9?6UR?IrM3y}q1v2-b8%h`+*hAJpF_W;R{4hV9_<g_ui{-h;KujKL^i)u{AMZS
zcZ~iG_OY+I{Z@0#pZkDXtjXGvthHks_&k3duJ=WtKI2?&VvLm)9Hiu$Wc!<3#P+~?
z%$Z|5j+_`zyBL$CE$tVdnA6;qQ`-6^<5Q;nlgyZun{fs-u+9#ykBp!pH)}p)zYlxh
zo_|8$i~ChE&nIfks~f)q>k;c)a06?14$j3nZMfh%EI8n~-f*ElC-wO`@of2gz09~L
zHqv|X6M1i@T*S!@ne9Pa+Jm{pu{v0f^^L&V6Xznf^&4v+`|jY)U)#nQYrj=6mpNz9
zkdp0<ehaqsxyG(_57f0uix}gKzYp5<HTcvgedZM7uCdhW9CBVG)>WA{rE~3NuGvp}
zrS^ICQF5!NU;Tpb(aMbPgnaJ~-o2Gg`x_UZeDiCsF;yS<96M`V)b`UZ`7-{K+!1G<
zN~0}@+~#x6jxkw7&yV}D!SiF=H5PRlfpN)n57|$jRi9hg@!V=}_>EB}+C2mIY2b4&
zC!T+8>K(ivyeBGoXS~uF@0sB}R^C;Y_mJ()JLnc{ClkG*{lZT!@_DD_J=PfKWnhyP
zT%`3o7w733xQ4EEW6j-D*FUi><Dt<`^sR#SJp1~3oLBcZ_xQ&aeT=z`|5HQR^Gj_z
zP(RdZ+#!CFYlG)TX}g2I75TD;W*_=GPxI8g=I_{zsk!q^DhI5>ExNv>p^NQRux*Xj
zm$gmCbIh!%QOAt4=e~4wS?D{?-1OYpCU!d~=4oEXbi50l@ALzWe_I&k-zWUH26=6^
zrGfqIZ>|wJZR^Vz^<<-8So|A|oDZ~4Jj{np`v&75<o^RJ{K~2y+ArPT+k%PwSJ=e=
z4UOOJ{x)t9o2;UztxEmLMVHQRe=^}f<2OGUA!~bMy9L|hmpFeTT=Cx%HhyQDu!F|`
zw_q~RCEK55_IqW<rajx2asE3D>ad^kZ|U57m%B2tEfWqj??f11NPm?XyXljp?UmJ^
z`lX+Ao@t+RQP(!0f%RFZSo`ul0<Exl4<r-4(tSt3;hm8z^q1i~<>C6S3bya5U?P)-
zE{k_r{{{V(jJ^DgmTdIOpe@y=uC2lG-^v5q+Be)ly^{7%(t51#fOEUfiS@|!t7}^I
z&Dy#b?#T)+(*1JpPM|Iw^cy>%70i`rH^z9+f#+ev4Q&7Th&j}0z3zkc=NzoxS{=t+
zatrpC8DzW48n3SJKx2Gs*det|FlNCB8qyl1gSA?hj0fkCY;>8>9<=GR{|P?j)282X
zt;3pDaFNc%n&rSdC)>u@Z^s;*N26_j`#Ar}GuwQ3!|^@tcLogK@4lyl?srR|uFsf^
zHBNg{+xFYgeBVE4*WbZDEAoy<rrq&&@M&ywByXQazvcIbb1nDPVjW(*%Zzbt<c%Nn
z*{q>!yjV}yS=0|`*MEt#{{_c(jT7tnjT!SCu@=rJ=ccqR12(b7o4dncyh;7et36n|
z_8X`tX-lbnK+e@UHqKG!Y<iY`UORX%4QN5$ZIe4rdT{+suaI`7agw%-Tg1N%Y|^0q
z7Whp!&iDm6mbF^5Y;YdVXE3h|K7-<XfA*Gj_*q-moAY`(%ad=-#&_l}4D?TA%*CH{
zzCn}a_h=#Qugt!$+)=~$Fn;=8X>8gqx?|NEQh#gEejtAjOsP$uxtjU>7H6Hr^|D>j
z_RX)a`i-+~{|P5huV~M9N6$PdwMoV()21|T!T19Wzjv3<U_O8O%wC>F@!8aWz&p-(
zQP-y5z6}=7ZF0&zk$T7GJ+k92ne;J-bzHFaoQv%N`eZ-j+HVEckh*rUZGOk{+4mXn
zy(PYvu5IkzlPzlci4FZC#hR_(`MoUcVoYM&xD6Mq#r3lO#CC(MHKjEt9X+Wwa}M(|
zj`a=jZuhSA&hx%gIxp?|a~{?>!M>utqrd$c{Hzsn1llI+<a@z8#B~$f-E}Ro_OZRd
z@mtiVv_5V6jLDpt&)g?+W(~)<XAW6^V+~}(1=q+my|6eh2kLpUtvwl`r#!TiRpL?~
z*k1G<@XT)Tz8Jwm$_=tT!rzc$dlfGFCo*P4pHH&kvktMQ9$2Hb4sd;TFp<*W#CdZ)
zJsX~x0h{&Dy>tIQp+EQ9KC56`TEX@zT=X7ivhJz->NAj1J=@kfpcQP(4zgXPz6+V_
z&F9=bV-;(&M(b|DjyY#r-+H*T?VGs{x-`cBjS=<lsP%rRSDXIIpe^kKSwoMxSew+E
z2W{u&9$%kr@5gxNxA$c{`^phCr1z<G?^W*C0WH{kk4(Qy_&!;1`94bgZqep<i!t_D
zU>@^1j^qE_72E~ZX1&hgosYFQn8bK*3~&y~qOIMziMlrR4d%UnfpL{VyMZ}sUUQ4%
zXs=A#$ws%om`m1!wg$%9uLtU~LBAL)>p@!!jJKb)4RDP%Oz;j~-os_zbFW|N{-jO4
zlJ=C<r=E6Y`Yw9n_+l-|L6;V_TJr_xu*y2uHE|v4c{%0z%jaeByvY59ye}qqP;$`a
zZKvIPbv)!<oBev+X_-T*&04aqfxhF+JC|glYi|*2Kl`7+u@Y^mD~;>mII>_sd(fs&
z)EhXaIDUsy&YHS5{bIb>SF)|tKcR#BbmJ^5Wfa>EoB8c~!TOz-b5T~bB^^EE)w8WF
z(KdsFtZSvNO@9xm?Lv=ttMAwI3ypX2CwxyQ8(p$pW%{bT#3tGsSci4(s7>1h{r3y{
zl8K%)^cUxtV+_V{O<cnjYiT>zN!x(-0r%d0caIx;>+^fSeRhxa&4^JK?Zz8pALErW
zLz>4s!MkCERM*z=i7|2lZOwS@pTqm-@-C7Q@1pIyD458kqf53odLze*d#rO;%^>eB
zYpQJ8a=|*R$+<XB=kFT2o-Ov&z5T=v|3D^bQ)+8)O0FJz>3)jsON?w7(7-;II(FHE
zOO3MJ5A4=xAM>2Zr+%?%A3;N!&v<h>KN%m;-ib5b9M+fl9YbuV&9my+-GO@2(8cyH
z*w)_3a~VT2r#9<!A2xG!Z(5nR^Pk1;o;7N=&mfOAXU>%7c1*wLJO9qGKl~en{}!Qr
zf-%Rx3FtGTR;B&*=f7KIAN$FL5x)&yWbgmQM1MKhr2XUn%fR-Dja}|v(97?FufFiT
z9Bh^OwA0u4jqW9VudH!{e!sEtC&s0I(ItNuT=Bc0zYSKjcTj5Y{0=z5-vpcgO(0Uc
zd9AaqVUM{wjxomjJ7MQ{w;3Fy<nMXP{5`JP{#8A5{3hR=ZynWN^K5GTg!f)Dz5gEc
zrER183|6%1?}ZchX|)+s<BVAkZ@=u5vXdkG4f<a0_Z@e9Lwfi3;PO83ouGWtF5?3Y
zTjKjj=0o@01o^Id+spTte^bHcZ!A&&4P&N%j|Inn%Pwto{Vy3)<Bi$ic;f>Lo7}+q
z=LZfp*TQwW;QG4GuK5M`pt52=57NDQ_f31nm_)ldCmhCcEKzS^-$-LdjI%=8S6#n-
zHnm#2^O70!(B30w<~6t2mIcl=>0wL1()bA%95?5>nU74crV%w|esh`EItDbbPV37$
zm6Cf?_o>>nkJv}`+TS>BEl9s(T0@<K^Qdgv6@3ltvjTO|cfmDq&ck;y@8Q8ayYnt?
zzKcJwvAtwm!*`;ux^efR^KMV{8S};sYz@qn*w%gvJ8b%ln}NEvQK&JOIXchnw;~+o
z?)=^V7W@BmHas7oo*Z;BuEy%`fx0o~TV-7xw|}Y8`V#A}Xdl5w-oSNCU8zq7G??UB
zjM*I5y^T4}s6FRk+ge|=C;Bd!L)7&-PtTF(tb4{dr#qg5JjdQ?-gVw{>tDe57yA#m
z{GKQK7c$29iaF$fwT*b@tXDnjHD<s&PUh9`yc&I+vuofwdA3}CQFpyO6RuN_v*Fqq
zdtF2P?$HJJY}0S~9qczc->lt#pN8gl>tABL%tA+(v~Bdnyz1Zb55J4QjIDhYF1n;`
zpi2YCm~i|S2fxWL^K`B<p@n{tpV;A_$WJuva#%yxQEA+U3y$g7r(j#V{+Ed@b9Hjb
zWsk(YO49bq>bI}Cq?Nq(F>Zj*zGuO+lXsN&l)C3c`+^Iemqs74Uk81nu6={!%8Ica
zUtOF2QTjVhKI1=Uw><Nn+2)yz^E`RxeHTv7zo=i^*thorv8$YKYmx~kP}k;stb2sa
z80R1vpR(GGO?u=qPhwuVA+tSbH>m5JYpw0I>r21=%yYpp>-gG@^VxR(%1%2;`@rrU
zAiI$5iB0sG$NuJ3+PCRroqeZ^x_6Cs`zcf3=;pBhpuQ7z*V=OqoB6oD3odw0=7Y8u
zW5s?08kno1P5%Y^9~e9fJD$DHbLjKfypIar8yjw*-rz*M{p3b2^VPiOG}b=zL0iQ*
z<E4YS8cb@nZtEY=z%}dOo>yGs8~b%wch|n6O&T%czU<&4CEI_J#yVb(f6&FctS{N<
z)@<zyZo#(p2FBT^L*}YdyZ#NvS85LZ#z`;KT&XYW9R=Izt1|Os-kQ6{rEYwU-L%D;
zt+kRiWyYnP(N8HI9Akj{Gr|4r;IsDg-0>{>&R^bzuzf~9FtPOqzol;6tA}rl?so>?
z8-Aa(FX%JI*aeOL8%Es8)^Nf5yWR(Rew>TgmJJP7nV0?Kf^(Jht7}i+p*`vUVqSUe
zw$t9w?VmXZd0U{qgNqd7WCaIl4w;3t={L4R=6Iz(V-D0DshdlmG4|as!1bN6_pbMX
z0WI(hxaXhHCpFe~#&+~1ZGR(o$!RUgLcicSwPtH?F%Rc+p~oDZt8;e#7d$H~I7soi
z5TB7s+EZ4a`u;#ZkM$W{JexQ8^#0Lrd<)bQZ8?r(cChB0gEHr!-&p%DxPfE(9>}q^
zr(ZdOhLmi7lg2oXwK)C&*LDYWovkhFGkym4PhHu;xXd-lmFLv6Ds?X%%W)QcTFIrJ
z?Ts$xHMRv4xj~z#k3ij=lYSQ#b3Kr2r=Dor;Ct5hcCyebm-dVAXl=^Mr2V%XVn1R3
z4mqZ}w!g)Asr}Pd?JMT&8cc9qR$-uv>*zkT!2M94#n!R?>^IMDKFgCmcRw!ZS5^jX
z`*iS`udK+k%iW+Y$yoa)+6H*1c-I`>K|S!@CfZW3vKPBCE$%<>Fmril9Wb{wRa(@l
zbo>PuoZEJe%-wbTblw_!kmNqN7h=2mdhF5pl550%+Q+^!!G0_D(S36-a_y~AeYrpG
zDX}?b$~TX>oX>vFfajs2-#EuNhxIME1=}qcVV|7c^My}7ZPLNq<`nZaa88$6uJdGH
zI{W8-x`&>fhFx+kT%Tq<9O}2fdCa$hi#&|C`HuJB9ghFr!0&f6P#1ld7-Q`t)@ncd
z7{3E``-u95(f^Buo>aSf+Lfo!|G^xCiG11EK4F~p#&2B7K>x<Vmt1t|{{9BDkhcGh
zta*;Vxk2-HxBmkMeJh*x1*Q3&hx6(&mOg(Yl#HABTrc<2Gni-HzwfsDN&iN_MW4;@
zgM;4#*I(jqc1h=VxtEDeUi;s)&HG!Nc`KXtH`;$PC!ebiTx^r)uF`!Df5AS#aXyT*
zzSstKX|TP+3myG%$IJ4rhs*shJDA9%q08ZKoWEfamvr>Y-$=4y1Pxg^{5_TU_m$XA
z{goY`T>tGj@ZX9@!M47P%^ca*muS;}z`C-|jh<X|=i}VY7hI<eu4{`mcm3spd$K-o
zut_~1wv8QN-xqVvpdlsqv@?EUEpnnJrETl9UgzW7a-K@tqR*Hf{p)z<$z0}3tRv%;
z8!k8x=W~KO*VOeHV;}pPzk{_7aNQ^LsCiN2fEKua;$BLJKkae$S1!2VIF5HA=cTls
zN~6X^yD|3JL63OnGGgAFJ7Dn+p1y;5?{4V6ccJm_l^N7_wWnXX3%BT>?E3#z%rn9I
z7Fg@`+v&l1B<V9&>?i8_1~~ugw-~r4?!9ZYSu44*X4+O@%!_A7n{q-UpLq}Yt;aDB
zI0xr)gW>lXtdMCpMrNUfp1w;v`=`_<6CBTR9p5_YT&>SKv+i2E_9Xp_xs8JD>{DZ0
zGtZ#suYu2rXW28|VDl^_J{zA%|0|8vrj!mV?%MpVZpZJ0wg*1_#u@MU1AJ}=wfUS_
zuXAw@vca_(@G~#xVn6aUavuJ-NR`P%zuNIT#s<eoY<I8@dE?COI=No1+oT?Ax}`2_
zasPhy(!KRtnD3p=cg_T5VtW^Cr>{!Ci<7h)o1{(o#$~%o<LtYk@jW(R1?t-L8@CvH
zfZyc1;JjMk^U%SwyrIQ;_Drj5(|^EN+j-u7wq2`=wgm%PV0%Ws%x@p<#_V`zl!LZ*
z{q{N0PhDRpX1Pyb{Kclvyx$lxk6q+NPxL!Z2lF{j3%QWm^yN6lyC$wju4Ar`Qk!eM
zL)uQiV{S0VPd;)_p9RlioKJP1dFSbTFaCke=gG6}b1;ye_k0e1eDt?(r>{9Z&vlIs
za}dXMP9t!R9b1dKtS@WSmhr}k{aT=|?S@p(cG?Cu>u@gaoAXL+Pwd7R?^q{L@32bF
z>aTIy?Vqs&T^g9*u|-{WLHnn=w8?<Ydj8zQtnFrv-4D6oy_V~3F7rF?1#5IIJLe*~
zv=e=!(9k94_BS&7{3b_?v60r{dGw54@Q(0~@y-zMkBT<$5@YSt0(EVo&Ag6d9m)&u
zIL1!Uz9ZJX>#={zI%j>Zqv#X$1q0ec-B<PMH$GYDatoRNlQhow5z@AC6An0M8G&<?
zThQ0QKGK8Co%tO@Y~L6s$1ukZE;7+JpasUiq)++!vOS}=lxa_?y_dSJuadr$#>;^m
ze?+ay9aNio1N+#wgKIIsJ?-E#=`-iE=kwTL`d$a$@3zN-acMI~I(Y96*xautzA3y{
z=LcSU-oJ}}-oX=E+~bqnj(5SkBkzbt{m$clLEkJi^iM3-;Ianh-Jq_`*bO&OpTE%X
z$)T^9ql5Vdv<Geb3m1FEJQaP}cc53aUvT^bwdSnPT*esNz;*puTh|vlxZW%Fx*<3F
zkhmvF+Kl-djL*I)JGM{g-;jAn)T3N*1M9VJIpCZ|%<m$_IoCDW?9~OI2l3fBfzOKA
zPMN;6Wy~b*Wn=T%^BG*hMS8c({6PAYH8$Jk8PEd9_=JAr7F@9Zgj2BniH`jf##Xy|
z#W5N<f7fMzYg*S;+X{?H`j>Sxm-A8@WBdSf&O$@?e7mRat*9R`Za--EOn7EIKgvxz
z<1@GY9M5sBW5hh2uWR61$O(LBR|f4}xadju`=H?WK;_U*8s7`*%1ZTD`zJkPtNawF
zt;VFjp8DQ)$M4*7z75@V$u;We;@Yji_00Wsk1L(_a@}KZ-J6DfV^8!|25o(_#4q|t
zFXSDNQeVcsGW!`jJRjUAd1gE}&2#h1eO2!)<134H|8Pe+PO{PEg0(q+=jl4RcCM%E
zy93u;Y->+!YafAn$9Bje>e^PpSZ!i|nP9AATZ8LAV!d6f37dAqXI}f5=gnn~h2K1v
z*bU~hUy|+I<HJ}Rf6aTzEh}h9aa^T#&*k~$*-4*r#u>KXDBQ@SKVv3iSflfIzuZe%
z=<d^nPR-&RoR{@GZ|lq2dW@N49NOEz5B#@>_+8K6gk-|OuHQKEd9CpoTjizS=>KFP
zzj5#-8DqQu<DdAOmFytfuS|cHKfh`DyH;VKR~GFX`1_f^lbyid!%|ni?boM28AVUq
zCuv+|(-v*1D{mox+f({`-8b~xujU!FWilV<?OM2I?w5P&8N8es&yLT^&so7|tobIt
z4PO5n!uV}4fA_1hKfm?W-{(^IH#+r{X;=0yWQ_jQzsViBmHzJcw_KhlpRL4aOR}wh
z!wg!{wWUv)Xg}P&KliV9@CWqCDcJ78jc?K6_h@kV8$~Aczu@wBO|sBs{6fPgo4<=>
z`u7nW|Bd!x(0=(AbN%<PU?XKh3y%Lr9B9+GgNyuIvYtb2)@}V8a?Y2zxo)nZ>$>3v
zuDg5DVt;clQ{J+_+UA!y?dCC``P+kITf?Fj$(m-=rQbgGy<i?$fwrODIQl!+ocD@(
zJ7;tM#6+I#Z!UA2Bgay|w(*Ua=S6-(e}l|tAKS^KZLSRsX3W)E-4E%7w58nmlC&w)
z_Db{STpi0XN5Qu9tYl33I{r%@F^Bz~*L7ZeZ}|Q_FykFNyeoare&AwDCikhFhvv7#
z!yEIq%_IE-={wIj8E-w-I$$#g=h4AAiMnWi+1RAoJ8k>j_#Qjlm%ZTqS<#=kp2_rE
zF4otaj?<!6YqoyZX}}FOvhvzT#4Fo_whi|K+NFWxI=;17*KqHtv(6!Fw|+^#^X{-Y
zJ0qS8&yvrD_?&3he*^Uf`fr@w%{la3o;cs0@!=VLo&}$cN~2xTx8W9S%LMNa@$L}y
z7Cy(bhWb3X2G_NSb2H;C<Qh45=i)qCV1ISz;27Pz{@;;s|Lwn6=oNj&BpF*{^fi8W
zG^g(jYd@|P<GG%$t$Sk4?x*{E{N~}icKHqLckV;l2X^Cr!<ZN2_e17Ld$#Sn%J`jc
z@8pEfSo_Vu`j>w%I1lDC;@sBf-+5{m?RlmbYfy1b+`|=T-2EGWIE$Ax-f>1I@@LKC
z{QT@My6<fFV+88@jQ3o*N1k!_>B8~sJFffWnWC;u-8qL<=F`xfkMkICiI)x2zRX2h
zw6$L_-n>25!#w7{;95>NAINoH5wA=}*s8Q{$I051E85obv(~J$b6(8db(n>^E}a<T
z+>@WZVSRec&0NVu7u$~K9Ic~KpQvloXN<88a;=os^&1_(&(VhAJ_YL9F4*6^=6~7P
zM0*R=wOz<{a;+q5HP*2mr-5>Vwgcv{f3nfF>03d@=}Ui$m`+S$ynP+}e84sQhVd)v
zzT^<|i1q{7cao=~U4M<q_9vNnl;&}d7kF0d8E)JeBkm9H5Ow_%F7X5GE9w`_q2IW~
zcGA(4MZDuLYIogSKljExYJvKNqc7GZ>)uhnb2Nu*W{kO7pe{SO$PuyXFZ%ul$4d@+
zlC?RnPw2Ow<4$m1(xSbircvrJ*0%i)<QSV=75AZ%zDZmU>@S%s+xm^m*p%rv{u2Yc
z^;vgCTg5oZ90xsd?8I@Cv>9i=0gf@jHCvvEI46@k(L2ufzyj~Q2AlhD20!<q?~B0u
zbHL^P^xpKn(tWr1o+<C9>AMGdA#EuSKHp{bv;Tz^?<((S$8mgXvOeq0v+X=yoZp|w
zK0Y704##%`w0LfM<Y}y#WX|lXU(Att%r%0B6zlD9qkiX*XcPSzV_W|ST1ah`OFR43
zzUmVkdx161AnVnxe-kIhS32zz<29sbK_<8tl4s#h(pdW?w#9xc7)bFvCARgSpwTCp
zk#8e!FsM@&9B>YabKBsY2RMJ%;y~{2V2_iH{_^@RG17Uq5}!3W(8}|;(dEM6u95Wt
z?Z(u2+llu1ffhDpV%&xc-^Tk^gYhpJn|AY>e?kN2-N7~4&<Z1L+Fvd<v9Fltd_bRl
z2Q+Z+=7)3b{wD784b&TW4&JjcuqPMYypD6hdYqs0yx{zEEe^Wmd-;_!-rpNp$?pTd
z3uFZsDYjEj+4;NV8`;NxN%pI<_SbH^`cq#ePwMGYY8wxYwm4_k#5EehyKb*<$NDy;
zxc{!Zd+r|mhWpeY&qHVL+{0D&H23zCH12}^65HBkKm+fP4&E)^GkNdiUDTfYX+QT;
z#w)#}%w^upukN{Y9HnSmj!kXbIkFzERjzB57kg6exz_rA`r1EY5BuYO<=IqkW&b*U
z`#7$9uw!kltq0bx-5BHTZ=RY<yW=~qakF5%VVCOb=8HIe7gpqV46&WLcZqTAtDp0j
zXMR4<kL|RbILr1sQLAIl7=Ogr`WrabVm+L@=fVAKtcQE$TIj3wXa5~FIi6TwVx5hD
zhgdNEJ+NT=Vjp0PEa(x_I<|*FyRvClE^YZ_)87B_U%YL7>jMW{()cYandr&(x3J(M
zW$-)MD&%i|o!`*DF~g^n{e|@ZNxuD!Pg~<Rxnz{z0<XXQ6}tbMpM@2%*(YPQo4+yl
zpFQLpc&<EqiD$(#q2Kj(ovi1lFJm-*8yv8Mi<Hi9ag{||&cmnQ>fV@dZS(!cr+%Nt
z`(&H{$(($S0-rHyaCpWh+<4}O&t2esn@sd1Z7I{P?EfNui~3DEAiq<0{0;O;zA=+n
zY2e>X{+*L_bpQ5A{99-g8oGZgiGMrwg6-s>|A~z4k;8vCT!H^~*aG!rp<l31_D^|=
zO@GB0{m#WXU2x6^TnE>~^>i=X%LVyvaj%oKUHoEO-}!)c{l=NE8BhKj<JI-gbyr%K
zoKoA4`rP|^UTn*P0mj+aIXYk0AlIwKyd5|5*+*{V&vwd#&+&Gw%U}-TToQesnAnq!
zzG9roSkA3SorAipt)gu|T-stk`-^iipKQ30wX0Y3x8UusPws=ctlRpX?{(hX0T=up
zYJQJ=;9`?}|1RF)$M-nzY~R}#2KVeY^jGYYO!OpeDYdu4+qMR=o*r1Ia~ROzFfZqp
z*iQTF>-by?S<ql}=JV`({?%oJ{t>ap-v{$KhP7O<PV03}8!otJ`F`rYp9&NG8@u>w
zpI6V^i*aOt<2rr=Yue9RWzDXseo;40pL1>CIvmc>g7KiO$66UDwrl+M9LBTM<9W)n
zs~pfC(w1j_@!W`QWA$&ifx14QwFcfJqCP<TkDoZ7jpOqHjdrKsjyU7(H=&1APrR4B
z&o{r{E&uyLfA9M@+W+gHjF8#>lQh0!`~`C!nB>1O8P9sG*FBi*&vbt|AD3?+zsJvm
zwx92y57IuBH?I0t`PSBMthwbB{I(ts+Ke%_gZ<4nz}h{>o?XvtVq5zR)b%;vQ_iVp
z)#okG>)@<<?mTO*lY2SXE7#7w8sJ)rx@Z^mjlF^E?)uA({irg13%~IbuKmc-81H~%
z|C}r8nAEd*CWg-+b8s#>$2$LwPruJ$&dIx`K7-Cre9o3Wa=H%ov;T_RuHA;lI*aSA
z)Gj^9w)I%oC5Nb+D{T{-Ykxo74fT0n)HdKU=frl_Y~2~JbZ-62-RYP~i}9VSYva6s
zo&oxLR}I?QlZ!6KuLo^XW2&v@IK)}QhFh@R0%IyGa+_y>^;v6&pFLyFu7himYo*Nf
zxUsMH@8n7@?H7FqvX)6r$wrs^3mG$sX<#mMI*#KHXy6=_wlAz0)BYDcD@mRieG?jF
zjkdMlhaUYK=W@dZ&+G~gQf%uprpAr1SD*g*3k~04T*n?!W6s?<s#~`{>s`bdZ$I<y
z2W|R|wa=vQiZyfH#P$Vq>o<QzTL)wQ24n4Wz%h4V4T<wh(q`O%2KG0P<E;m6`iwb&
zeZ>Cz;nMy@j{ix%@ipg&ajI<CtVept+SXR7>-feWV$GM-anyJ4+8cKJPRMl|td-CC
z;raDBA8>ijebyWFxEF`-Cz$aK;&;g9Js}GQG??){vv`;IKH0qg6Te6N9uW0UZ0s`V
zYYyK><}|nC{CxlTZUSptV4WMR-8pz?IVaf<jrpc6b>lkNH#sGbai1`ceY3xPvcGb`
zrLKx~PH1qbJ#ik=Kj1sb`O0|EcE4ag$GKoV&N1tKYqnO|#L9#goKl-(Ip%oKR_%?p
z9KTmXAIQpn+ST{!pJKJ$AlJ<~i#1!n^GG(jT*&#lE~l)`W{q;M2m3B7xJb!%mD+ty
zD?Vp(0-wLcXLG|17WbW;LfSgEjQb|dHG+nGu?B6%Y`B5B|AvfD`K^!s4FeiDZU@(D
z1nPCY)U{Q#iG5`TCuG_)F6E-n0Qb>-b$`c$``<hVoSg=q(ZsflU?V+GKYhq+9nQ@;
z-oUk3W#4?)Cca<QmB~hz3w{Gs{8o55*k1g*<mHXAy}nRm-#oUf|4(`yqcdLRXO7IX
z6$bha)TO~;4QJq*=K5B-SaWHx%eio0@=P4|$#ZZy1D=B!XQBI?f5CHdpb;zfk!<TT
zMml&Nw)aTTkm9}Ld6Dk9;rxiY%!jlq?SH{BPK;%H2kEme=jZ%KoWUFG;@Z3z(|$p}
z>+Slx7ducF?fT8@m_K7%12tOP0Bf@@_uvwjxf=Z?bLdOVmke}i;20I{7p!3h=CrmQ
zsB3eaBx7yszu;LtA84F;nFZU%+i!z8MBOv4Pi!yh8=kv38}8qYeR56Y;1}oSe9UG4
zI%evdvHf?61DoH3r1gKIKK-32P}i1zrR}sW+H(Iz{2eNp=*dB^_`B9OhQDJy+-NJM
z^IM?gZ-V)IptAY98Tk9zpV-96{R=YozbkVLf9p&9txirMe;=IuhW8uB+1I?zyF*<!
z+uE%+$Nq_>&!(@x4KDchyI}tha>6Xs-|asAHusyY_Wh>+)_?pbH9u_H^4h&yyk{zd
zc7qf5sdwyxQE2Edn|J+hO#GEjTMmDFRMM`Tg=(+yRbS*9aQ!#j{QJhgap3SbkNo`Y
zgS`ALl;qz=DM$RRl<ga_-M^duf{eHSfEM^~f%5}D|3(<G_W4H5Wlq}{oRf2O-p=23
z$n|m!H@IK!VZIOD=Op)f#-7{u3~cD}zVzOG-`V<%G5(U<aU9#VKe5L9sdM7fpLHJM
ztugDf#uccWvxD*WYmvL|gJYTZ>WjH67uZj`Qk(hAd!bWzWybuK+KpL(dZKNBbvwo;
ze+#Tdtk1ovxE7*K|BBd2UvpTa`K;62*4h|H)V1j|<`Q4Ae?{MjSo`$opE<36f%Dw3
z*vA=rJb1tEg74d;^PUyow=KRWF4Aua-_-|t`JPaJF(%1A*{(ACRh#hx9Mku`HCW36
zYqahG4Lq~rypoRoqVGItGtPAx(7<&Pb?q0juVXrP<<b^wv&I=UTf1{`E+=rV8yep(
zKi@BY!~DX<_b1-|BXT#SV>zZZSW9AU8?3bjwl5fa0(ET@oLh&%TwM>>#Wk9&)!~du
zo;7Xy2CRZ@X<&@>pyn`-47i->pYx3Dobl!}!Lv0A4c$BU^1Dxi?Qc6ULuOm4e}S<*
z?rEiM?J_>luqFCepl;p{<KNN!jR+3EBgy(pGB*2}V+Q8Du*}am*Rh$icZ6%%*dO=%
z@I5^E_Ps&p`&Y8<cX2ZOMh+UXlJ;HVQ@_|GbH8#i-b=>V&pZPfOzQ368P4<SnXS*r
zD83oz*)#1K&GYHA_w$T$UOXe7kHZ>G*6OfkuA6(~8j9;VgNCe}zu32oQLczrH|GV%
zbf2u@=WOy0@ZN5mVbAsU%<~NW+#~Fr^Kt&JgX@uN;yO6bO^kE&*|VR|kU2zMn|IL9
zb4q;Xy5w_>E9TZ-(N<abN1$$O+8TQ9gX^EQc{lv*gSBFJP8p|OW1Y8i5%n9G<G7dP
zFz<yyu8Ot>j%B>4Yn!m)f_)rQ&Ii)>$~U(9)7RXuAZ=CZv%R2$^;p+{2G;AG8+dLn
zdnoRsXge_QJHG?=HHWB61AQ~dxT~FUtz&*6>reT{X}5lJZ5YsgLBDY~aNhQ}j*7OV
z+8xgtHVn?#0ng-w4c-?o`ixsa_OYMX9$-$nk=uBE>DR7*LJQQj**{}bX8tPEw}`)y
zqcd06q=9?X3+|QnQ7|^C_J-YfbL6wKI2&Tyy!wo@-v-Baon7NPr<|8_Q`cvV@%A%E
zjx)&J3bq|j{{hFkF;<Ra&di(oZ*mi#+@fcnhE2>bE9gka-q2u#R8O?+2W`>{Y1`N?
zm^<^Q{z~I2_8s85bXc)&JDz8s>*aIKoju|39`Ie@_sxKx?{~l9eSi6l6D;KL-2t2T
z$OQkc@EzwjzzBTLNVY%8h5vy4&9lMW7pC75)FIX*o%&k5W4x2xf9K^HP}&yt8&X}y
z2ejY7HF`;(aRVCU`Z<2m(dDq771virth4V&*V;LVYyRRMIL~j~SO@*a9x$(C9Iy`S
z+7H?)op!A)>oTXg#j)P;^nc^vt9+Yh+LeyGKcM~fU2KW-73U!5!TBY1-W$97=zhwA
z3-0}d^M&ebJXhlL^(QiJ6MMnucEN$XOT1fBf2DC1`$`YYY3^_67vodUwl;IgDN<ds
zmOuGAv70d(xPBd6Q`a`vx2~Ttwxx&E_M%^UA#G_l|9}SWv*%!d=VZqjYDmwlXSsoQ
zOWtcrIWX`UXFt!BXT|)E@7!FsS=MHh_rpa`I`3TZ-75#0-weMn@l`hMPh9Lt`e*6e
zimp9ll=lzR*iZU=a@TglC(c!z_e;l?<XUakZ3GSJSxa2&4zBxp7_=MgI3p*{!DY{W
zo^hY^U?N4k+`x15l0K!e6B>A~JQFV+n|NkM;CV}3xdZjQAJxre{u^wh?H1D7JbTX7
zb*NlyvOs@>T#FfNqSPk(jWx#s*Zc+>DGg?<xAC2R)?ht3M{EA66W=AqKK8vK2h#lJ
zdC^|c-wXO`KF`XxGvs*b_uS=K%yXFSDmQV-MXzX|aGo(8L+bpjJJ;v1KCZLv;d+#H
z%l%vWTo>~AZw>zY!-NgZ-}-`qyoKJ0g|wxf()boEr1lA?(EdTpFARKt%O+NCk?PX<
z?QebIU{4yqd&vy8zk|UI2EU1YBK;{p#Vq>%PjLL*F6jIwCo|aoMhDIRj;}EM-40f8
zk<$P7KV`O4u812*F{iap*1@%EWnFfxjWso5FPL}2f%YHd_`t??|3JnllRx$O<nRAU
zO@CnF{}Y$@Z|81IY`<)5<Dt<$zT2S(mv?$))BY2S7`c#n%v+gX#>l>dzS4r@-!nn?
z?;HNkS;6pco}eK=q5qTplg-!~pY615{@#-5-(BGEfGbefCi?e-HhrQl8yaISaBdr1
z2iMCzx{!ORw7o%}sLKtESr5&34lLh`+_&3zl6P)Fo4!Ge{T<)+w=Qe!fx2sP0&A{%
z*6$uSY8rvMwo6W9>~qOwKIMvh`UWw^B@10!3)C-k@|p8IW967i$NhwT#QxG@kuz%>
z)bj~z{SEu%Tsm`^U`}hdZpXNR?FPo3=x5)|k$LnPV;=h~`$XN&&3SHc?{ohTy8Aw3
z?|=4{y*+-5u+QRtZ}1!}xX^jm9^b>fqX+EZB0r)3lRa(S?+jQWwcBSvgX#Mo9DhIq
zYqGXVr)}-Y@|*?(DVMn>JLc{DrF}sAg+pJ*a%^i@a06?z#sk)C?Q#pwZw3b`&2JUh
z!9~8L?~{CEZFjz}Bz^W9(7-V}Eb1B$+N@W9Vq5zN8gl1ca}8n-T<4#4;!NE*Z=O3D
zup!T#>+HHFwq?=x6ZX52!(1nxMbEkCzVW>Io1DML<?lZJ_9N{B``@Sss?XR3=8zfk
zhFyOv7^^SiU#V|Iykqs?{4Z*T6%6E`F!q2sCYY~9{)If$>U(AS?7Kefh5O{bAI`$h
z?{0h(@4`h-(mt_$BK^1Y8GKjE`h|n9lCdNDW<JNX&OEpEyym%`<y@+tK;1LiJ(oV8
zoTKgeU@bfsyPONx%(WBOG3n^y8h>Nq`;CGB8}>8*h8z2J<99;u@kXuQ*NeTo)bIV`
zv(}lL^LIVOIXhqN&UrHD>zu*oFYl;B|Dm5a`(1EtU1Mpicak>cDtxkc{O0<^#y+5d
zb$-HnE_GSESfe!XyuN5pe~oe8J#emK+y2I{;39j}VqMm^gNsbkrX0|MoP%|n$9$Q4
zpgW#4blVq<&3;vC*T29%9Ts(qx;As@S4s=1ExG8D?S^h&nIF(^Y-fCHuqLJSLfTU5
zyU}+b&6C((1=~rBxVI+T=`(i01;=x}UH2Vaq-V|ZnCGybSMB-}+j1b|W;x@ZY{n+`
z?FGkAw9j9t{ZhB@f(Fj-I9KN1!Tt7`^{$c)BhJA=HrFYzZM=TtjQ1J;L<|2#cH$HJ
zn{UE}TzhMBkHs2AUHgi9?Pq^;?qDFLL9N5K_N$#fj+bMZ&%8O-W}I)hW-l2#qek<Y
z+xcv8ENS4_)+{|xKY=kBpMA8w)EM<$xagJYn~}@$9M|=5U4HK7_(odZ@xG_{t~uWM
z@tuC+yWQ`a%R50f%%CB~Z=U7%KIGpS+jpJcLC}6d|I5a919O`DfMYrKbxdorPQTHp
zeKMEa?;i7XuE}fL_>zoKrcGJxsi%M7Z&1%%u4$(h@!gqN<A4^p)?)oH9h<lp;(K_+
zzBp&ug&Ddr#@ly;V>#x63t87UX^gQ0>_5R==3E8GdC`9Y``EXlElK;vCbivSeCzlV
zml(<UOxFB2jC=hDo4A+azHYdI=O$V43@Ov5w0)q(v-V1T#=K-7pV1v$WW{^M`=xSd
zC)%q%Xp1>AXUd69TF7kwjogv%BE>OQaFB_%0me*dkn``Xf$Qq}jzC@XB{yu^)ze<3
z_KZtif7;wr&xYsAvzgD0=hn6y==hZbe5Ufw>)bE0f@~k!K5zDK<aeCKxSM(QSP$3W
zKr8Q+i!OurNwPv$Rt{~+_xHE={pLI18}`wse9``r-z2ZhxU^^cZ{=jH4mqbPSImDP
zbA5JMvx#15v|U%%H|gkNTj{xTFGifZJQIWS(jGQ@Hv@J3#${~kuWZC*-%h_z9L~mq
z0hcrO3D4$)78qkL^E;+8$5JksoHgg>JnMYlIU75o&qcZpVt+Z1d0ac!wyw4MiFI`>
z^Ea@sxt+iBlZoya#@J`m*F8-xZEfb12FAT~Y&q75F>PyKCEgqxZb)@)qU|uY=kD7X
z)%VTsIUj+#IgIUKURg0W$8BJJ*6Z5jT5sC=X2dv;78q+EedcnU3;x@LzwP-OU$W8V
z2EEhwL7y=LT1aCK%zylojg+^o?S4Re^39+2!EaZxe!<_jlFn~il}TIn{|_{OKPwFM
zWT98I*LLa`d(!#MPG)eB6@RNs270pNH@sV<zvm^|tKN)bT-U6z7xJ^d*c@Nqin^@D
z{EK|;KmN%?$__5FGX9g=9{%(@-EV$#)%@z2Kl>eG{yQ|^wZZWn9i&aEZ3P{9c~2)B
zy)tP3MvYa!U~b2#W7cth8#Bjh<dNgwFY&ibN6L-AbNpLpJZSsI8*BSptoB>TxPh$&
z{_XV}8CPY-Ya5Z@dEQvJ$^L8@yx$g_km}kJ?UVP({=o2k1KsxwG~Zu=x}?3f4}Hw%
zSnk(;_P{!|4RB9x%pvFGeB2-Xo&o2Qcph%)+d?;1yX>$vq&UU|<)D4RyyjB&2mQ%L
zZ;(06^NEh#d90X=Qk$`-U|V`%pHJAoVvPMxpq_Me{WZSo`iwc?Tn0EVxsdaBEl%LR
z4Y=Sw)^qadTrAE)=N&tP<9pY4^anP!<f2RWo&JT4QEq5pe#g3u>)4(@&!T75Gb`3v
z(RRR?`Jhdo7&qX4cqTm8`iwEhU|egkmYlQoB?DbHIKKs_U|V{~^fkUwX0VaTMgK(l
zXY^?yZKqFp3u&L&8aTGKNH4l}F{Z{Db7O8f&$=(J&CeRSR&gJ6&XQ+p2kP2n#W`!l
zihWZ5Bu~WKuhMCo*R$L_<NmuAzqKrWBisMZet^FNCFkFWeb8szh70-Ip1QUH4L<eL
zu0LaJCu!f<<Ob>u%-7-ad(q3n_8Z1e`VR6~ufKc!%$+rG{eI3W`{jNQzpeew_Io>M
zehUX_du93uaVxmUm-JQn#&o`$lk^!sf`)Yb3B9nW`!WaT;dvDG9n!Yv(r421x1BrZ
zA<shRchbh%OxDQtcfE4$U4PfG(rG6*_GQIhj6dv2#-%h~TEX^$3yz!nH>lBCC+FAu
z-1?n|^J#JCH0GJlo_aoiow<v5ldM497}v*Vdbn2Lnl{#0JQtGfi7iQg$M1UEzXj@l
zViR)<w(Zlvdgd4Mu30f(=en6kV*9n})3)G(Im~|o$8_u${l@jccE&0tW6bRslC>x&
zbU3W{2-Njii~TowT*npb?V77=`@|*QJ~_VinM*kXby?U4G;mCr&;x6c6}64f)1ETp
z?VD_LF?W)-8sqpYxX4P@Y262$(+Hen<<fRNT$>ZTXVbQR<BYFp%YMrBpw0dhGH;Df
zJ$+TCPq}`f<Flp>4V<@Y;QF|BuA6&ty|1ACg5Mq;F89FC-R6DZ9T#nV_BYQ3^Y*f5
zqwI@%Vl8sNpl?6}>-CHba2&@wjQgT}!i7(DIF{@1o`Jy{iEAbLGbU|mpRtzaS}>qN
zuB&rTtU2{R$w@z{acSGw#c@87zKm0La1C6G4Gmnc6?CMyr|zfUF+cAu?)>R@Irsna
z9RQba`3*B@$n)WEfbO?H{Co#Ie`gNbl^y<!eP!ly9LIC)3)W<Pesg&Sos;wPY&hS<
z_G{CZ_P_Pj_|$VvXRK?kt+lLJSJ(DZpX|VTTX5ogvdW1q>FDA-E6aHo8oFp(U>|dw
zf@3;%Wz+t|#V+~=G%%MrdvF;iNt^x?*vG!v-*zQ^8+&rm#dUKH<vh5~71v+(2h!J`
zJ|ki;@;7>%rGsofdj)MT>7T?U+KgKt$o|G;{6?=_+TJe<4)nNtl(sABOIx-xb`d|o
zoH@oUW2=9&r|%LY=Bb$bfKo<~@jJ%JwdkyeYwupT$1`YQ)1GYf3-*y!NSpqOeat&J
zPsg*$ec_$aLfZCO@yr_2iEZ>5fqfTt{l;Z~?;h`<9prtq%}cEFIMnC-UH1*XH^yI(
z@0pBU^ts@>eE!10_ler46H}=^_46-~-y`-({grP%$4EMQ;{2Sa3~1n*y-aLLN0-AI
zOSY@jzQFV6*>g`kD|tpdAJV`*OKfYuVEiiBt{7wNfL8GAn6HEPndeB<6WaqCcy799
z$FoM;{^osg>;p6A<h;ao($E(%_BD@Kn{E5+t2wUmWgTa%bFQzx5$os}_PyjXXU=aj
zhPgL>`?-hiXJycq7Hr~@8GC6hncp$Y*|2H1h6CoepSf00^J?>Ko#$*0zO}`3s&5AB
zm9%&4H*#sSpZ#}8`)GH(2G-;}B<nMW4E)-29T)TXX=~R{&d$F*9GLtYh3tn*dvwP8
zf<9yHr!=nrgIvKzCTXiOea+vZV0_@`x2a;!wld?ZP5lP>TVVbUs60XAH?AaYe<ST<
zT*^;<GH;cGe#u6!T-q=G7FSuc<$%B8RVM9ZqstA(|7Kk9H#|9C&}W}!e`{q8-OnFf
zPi&5D4eCqKC-L^}|3N=!|4HA%LQgLGe~146kRNK_%=yY1Q}wsMzO<!Gn{8>lgAeam
znT3v?T;I*V;JZ7?INPbG%zTb>z_ADHf^F^k#aQW(dCWb6hRkn<$+trf{M%*)1NlEe
z<~!sQ$8yXaQe9j6GhR6g`S)1<otCoNCx62w+Rb5Z=j;4kj{~mPb-j4U`OXt{+33r6
z2zUN`*t7@lf#rKA=)Mz5Ti<{N#+$?U-hfN)X@16W{M@s;SJr90uFIi*=TLDz`gY9A
z*reLjjmsQ^Jh@itnX^Y8$8~+O7IWJ7?W0Xb_;y+IiQd5f7UxB~vG#LJYujJ=e~CG}
zYsqpO&GJbl)i}X==~9)PpeZzkrqC3c0#oMOk@(aQ=S19_Ev=r1y#RtB2!cF6anH*1
zdXV@*e*pUy_D9EWX%09Ews%bR?Zk10=3OEZ>f+iQ>FnFcGsIqUemFPmF?-#$=RPZ(
z4bI3c)OOSJ_w_8!_lc!vv+2@rLVi18TuV;ICpKr$=Z{=go;`A`M9JBC<6oI-gKhX#
zu+z_c%*#5-X^D8i>zP{H5xlSPPGV>SeHGj7x8-9Zb>w&P`;cWFw-sk3t?1b9wr%7(
zMHj3chG=4|CP%dy)JL`Qel*pe^Rx3jajp#K3wu{ToIGcv>>)Z3$NDb)AssqrGNIkD
zD>m0UXFu|q<vStYUCyua7wd0o3%(C+eVYMvY^y*UJN<max#_aO`Q=}+z53f`-=#4X
z+mZHV{4UV0&_{kjo_zb_KE%C+nsT<aKkOBI$Np{+g0ry%@7puqw|VC_*lZ8!e7jru
z?%eg>`vmXR_*Jl(r!m-8j$xkt0C^ncO3viY8ej;{ChH5Wm2>pEpK;Gq9hUCZ?76=O
zF4YJIwMwWT_3VXn?WNnR?AMU~GsIv1+aJ9`oFm93$V)ksJ8R%R&wg_444v(rd&<4&
zwYR$NuuXxC3$9DwyL=8_HOm^_=YU$X2gp|H?pjaP8(NMJN!VhDmY`z`!5lZ(0UsDi
zlO%qW`wQy?*4$)g9q*uj%g?;?U-ApVTqp6oLw3g9G3<|D7mM+li~4#GsDGD@81`pv
zte<*P*Il3uEjjWtOS<XOBWpyy&Vf0Yi(JWtx#8r#lg|{bz%!2fwC|hf*zn`LFqRm^
zt6;0pw+l^q0Qs0D9il+(SOa^#1?yscto0<W2a@`jU3A-!?G3~uZWqk+ZZ6Mz%cr>Z
zSs5GI1#1~eldO2Zs6`Xhj#_eds5$$z6ZYZ8eW5;J3^4u(ViA+rLoiPWYHer(eK15z
zw#HV7Rq1Lo4|9@B6Pz1Bp8|Vemru)h%y9%cP=lRN8)~&Kut7`gZ%K?Uh`9vuBj;jH
za%BE4$OX``(Ld7{NgIy(jBQoU921gH?CeKQ(FE~&LS2SvVya$U@UF5F-dQ%!F2TFY
z;$AOy`OR|l4B$Bsywl`6{giBiX9T|qOqYH`U$yaGRH3i7tL|~cID$Eu`}Llo91l5b
z4XiK3D)qeU>b51mm0s$G{;7|-b}}TJII69o*3b*o-H@{x<S*C<m>2Agai80-_2<5^
zcR(M0`vRNo%m>W9z5pL+NsWum{m3Okux=z^dxw3hWGuBi1?o$kD_iYI*e~>Z53%9*
zKY_7up9RjvNzjdLNUlRe8=qdF4JWbh%<I^4s~v)S4fmWQxDT0K^lHOiabGX@FXB~3
zwvoWRKn_hfSL94PeNph(PZEE|H9-xiG5gaJ@4MT`kv<{WH3k@K-ID&wR-1U7Kdu#i
zn=ReTdV=0$3&FYO+!2f1X36svlXI*XM`Jekph8G@tRWv_z1BgVswMUJbH$Qpjlov;
zi}n&x;5mOYWqSv{^dT#bX&XM~NH^H5-;#F|Y*jwJuh>?{&z!GIg7aa$L$svUqw3TW
zdU8}>a2wggKka#z+0T<_hW+Ghz!0rKJA}{F)R>CxmiVrOu}!e|ud~E?O743cZO&yA
zud}B!gN{Eji0L_){|L_I$aA?<r)`>ae943PVGG)UE#u(7MOSTB)^Dn2J3*(0KppXk
zoQD|XM(i$H#-*Qe?BNmKUrTH&!3RSATM(a|$dPzMbk>nMk^`~vW!y<t#=(ZpTw4sC
z&n1x7-EOi~u-}YpY^Xi;w*o^OpN2ipv2$_`^Z{+w=^9ce^d=j2#*uT#m%mpG{as><
zNP1Tc!MCAPBzlGZE*OWT-F{Pk$(H;sAz$FT)K}P-*fVL8a54{MWvN})$GF!wFusH3
zoFSWW-%(%J_rNK3q3QeBcNp@kto*hXlF;>y4QAm;zu~*x&5+G(=@3c(U2z59?%;^_
z_a98j8~X5T8c&X_m$f5b?aYZ>Ywq|nC-JvpgcyHlOmZYE{`U5jWDGu*)&I$6-#VA|
zPkq$~zbTL}UC(Hq-@r55@I0>A{vA0LXBR>`&+pfBo@c%2x-SDdb{Gl%K#VDxa4x(L
zm@XZ7PvG4FhG+@DZ7NgkufX3vz3ABCj!oNhTH5zXdVC#+UVUfIi;bA9@d#=`O+rws
zBc^IN^n5${jN{n>TdaJBG~FAy=bJ4ZXg6{4`Gw>;#501i#Be;zrFmX+GPm+rS^vm9
zX*b!8`?vZ5KV#dF4cZ0k?}Fd1ON;~^LQt!_PWRlz#SedvBd)QXKKI+!n1gSG`WtTN
zZ@2;<#vV~~racSvZP8T|>Tt3)NZO&k3cf=$L99C-v9ZyQ-%di(bj5`!j-VDp>?9<+
z_70Zt849jN?JaxGdqU*d;Y@HwI4ipl(z~9wJabRNvlnLKw)>Iz_k<Y49HI%IJ?16{
zpFhqV`E9}3Ybj}mpr711qf;=>G{t!bbA(`C<|h|&BTuhmYb_9h_o17W??~9u?|#PJ
z*!RdEc$cY6wZFrbpRs?JjhHJLk`>#lq@Nt8Xu^9$J-ja~>qw2MH??OUI76H*&R9#(
zv4!wC!<R83hQ<@a(8dn<RBU%&Q$KSOn|V0rocE<`po!NtqU&=Au2o;VT)#^U5x=T0
z;agG@=WmK5;;-s^V93_Q`Q-;w@`*0{{{&(YpLs$o<w9QMx08@0f7a2owqSj_AFy_=
zb!t+t=ht3o--h;)GtC~e@0=0N4e!xNZ1lgbb@`v%8|2h}bDeZuBlL5va2ANoK25>i
z;731ahk1@-5})^P-tTz_2lOtmuLRxgA-xImB2UgHxiLTUvDd7-Qv=n5eWO;;3)Il;
ztZS1rC+kfc{b!i+zv;4l1!In2&MnA!um;Yg*0i;koM+BAwSTQydl#Z!i`=u=14A2M
z>d#(x)r)J{`~BJr_Pa2pSLov$FlHoM5*vOy{qZ9n&<EJ;6Vicww7%7@OtqU}EOWf}
zmvfVAMJ~ZwnwVM_>+`yY*4q;FB|_kbKjW5o)j@GtPtQDqd6gSykh8eo(D=Pr`tUs(
z$Jh!s=<3JEW6+^r;Op^2I*`*AQ?$a#`bMb{Yuj0mqcsDyVeQyiKN7HYfzL|pPd~oI
zTZNEL-CR5N<{eFW0rlM?1a)R#$(^;Zrk#YO@!Bm{smqgYKgL^sl8(Qxd7pf%&Et@D
z>{Q#d)RDj%f%SI5`l&+`GtV>irPkgD@5Ru5K;-?^?Iqhu7&CL9*dy-^vArkE1+=k4
z7x*%!UGvxY%)=b}f;q9%KMIVs|H$~v!+b}O#}*-|2T+@L*av^c!4ORlZwg`q^Q?rq
zn;>s;1@Z#7w{(2)HMH^Zy79gJmVDv^^pAwG#2}ubM(pVpJQJJXUhZdVm(KH&XIbO9
zse64d?=!8u(;S}bg6BI75qd@d&kF0<Z|q;k*q^a53%11-mpE_)&nDiv$osV(t@W;-
zYeSukZOA5EH)_`lw4bOxwa%l|ntDUL!TnSHP1HSE+7svr`*TzKw)#f_U;1l|+lRLO
z9P5)LmO0YNncR00lB^$Aq1FWdPdFAb632AhquAg*V1IVPUK-ozhkoHW-;o~sE|%?E
zb9nxd=M8Dx_fFbx<=Bt}?l;_fj^KU-Tf_sthar8RvyNm8W5+jW@-fU!4qcGbony@v
zAADiIk?ubkYp_<;52)i5UEKTAvXB1#0Cs4?W4q1^=V=PgFlV3p9QTf`dkCO&-y7=V
zd@qe5ek8;j8sF5<J(2s*)4d6MS3K@b#9euRVl44kH?@y~_XXR!>{EMogrD(Ga^&;h
zeRtdTCyB4w(tn1K{}bPdG0ME?O|VYZ3;hdRKk5ZTw1hKvL*2XZd1GIvU|)Ss*mH0j
zNk8BVyXdwx*}&t7(G$*{btG-r$&lo{b;11@XyZf7Eh6C>Sr^!h`|xLMop0q@h=)JE
zM^G1PMg6E_6llW`_)tH_5#!`q$e(#8^U*I~_VM0d@3Hq8ANCm{<CB-;k}vZRv#FoB
zfN$3r#uLkNX#?#LOYiUJ4fOT$eve<%?;>-L!@iS9IVGVb9<xf^p7S7Ic`0|+GILF=
zrRIzu<B7S&&~Ltz-}z>jUEj){*y;m(dVw}}j~TxyrdUZ79oyaK{-!?i2<0>j<cJN(
zbzRtI*)td7cD{2J`0fQw-@afJurp?BJTYL3@!JnO{rK-BBu(dgpWu6%Inr;MzOlhf
zw&W*5{buM}9IT6@cK`hcQ*syh_6H+bl2Pb?{Agouf>_KqMN3KB^U`malld6Ocw+gR
zn`Qe`{e>a@3H#iAwtte0x%+P$?N4m=gMC8JRI_-#mNxdzbNnZmJj;1T^XwN}gjn2%
zdDiP*jO>Cwd~TX-#9?0Y8KNay?*liJ-!4h#eL)=k&iM-aTH-(WeWbrF8``VH!gnX+
zWWCC%ep6#^#hv`!y1+c1!}BnfH3w@}EkaPQ%2FFnLS47$JpaVxc_N1H`HTC$o(1Nl
zjXw7y@n_u9_{ey~Wgc>1U+bQ%%n=)qFSb!=(ks-d3+e)_8Ad`qsLvEFK{s1Egka1O
z)Qfqiau~`JnxOr%Q&0IZu8EoBmu%!hP9t+B*H=8^%J1;EXc7DkH=zwn5N~I^NF7_X
zdmiShkUP*1;|=sNj=Xk4p5(m5DR?hf`xex}P#0LDYfq;b+F$mXJ#X6koo9wK!g-mz
zpIkIOZwK!tNk|%OqtH@Ef@2Z4i&f4Y=e7%S;#`wsWX|N>Qg{CN;0wDD(ksLS;&Z;e
zM&>6U=eU$#h|W7vGI^&+8t+I2+uzCRYklxem2629(!Zkf9+n(QaJx%qJn@ET7uYKF
zllK&?nYA~;zOeV9IyFJvs4cbjUU05BUtQF*XB|8JTd-&B7h~DaDToE=pYVLd8am^V
z*8tZ+OOCD$=z{BSh@<Or<~7PSJCY`Oe*M9e>`CZ5&Ffo@WV_%y&J<moU*spoH;BI|
zpNp-wnW<MF;vT_#%sVnK@*`Jr-h%Zk5rX@W*NX1;<{qRPE!B;Epw3Hs$$g%E2ChB!
zVN+L)CAQ~buA_O$fm{}ne)(~4qs}3?H!%+}AOz=Nu;)5ATw|}ZsQ2*wz>tk|%=yKS
zbIAE4*RI@%^@^{#$dNrHNAilS6Zuu9+F+a8T{d&F*58pH^OdZzmf}BwPg5Qts4web
zUDWY)%}_J0KdwX7qI2(&9D;il*Jq=T8YSr1@!@)Y)sb43Yktd4EQ23x@!Fr_OM6@p
zE5y`3v0u>mZ6(;lEkbntcDbPspC%Yj9O5x|7vvqvAFOZbtf?jF*dPRcOE8`|#Os+C
zb1`Qm&SxpNBbt6!O|eB3MpxXV+O1FdHbD%>p=~?5vCopP>C(xG++c_%s3o~m7uSaM
zjI7br`i|DhnpuAn>^YJ)cKWGB1=|wz;|DWwJ90dJjNPK;+{{lN5C!&-oXH(n$G*T;
zaev5OvE8!vz0>VG6sr};$=L38&6mD9mcE&E$tUXismBm4p=MK1Z`Zo1u3VoyM~8U5
zd+45q1fH$1MTlOmWyZ2Ub#K@o;sZJifzK38a3+`&h)3)pT1s?m5CR{3Pk}acfe+9o
z{ua!61ZRacvv%r0JysHu@YHr+?H}@mCWuE|V4fwIleu9gO%iDDH_!)7oLm=csbHty
zzEy77O%xp;$Lkso)N}~%bAA83^`(3K5RH31&t;yKJfnGE5<Ih^Cp=TlmOc`6?D!#R
z+eX`QPKihVC{%y+n~;t1o4l0gR=%u<wN9;@IzUrRV2dcw9-;~S7}LK1pUP1is;y^?
zm31ed_7iMfgR{`3!_nF*OYJ8HHORhG#^8&cI!)0MbZjB$H?(i)TjB_EB2U)F8bf&P
z=(Sz#EB%LLdjoy23LzbcHIpOB{;`i{OMim?R$y$!F}v)>^SNywq;1ZtO8SrRe9Zk0
ze4hHY><~%k-j?^BBiZs^#C-`u_<m)%%DoQ#6x=st1I9bnCpqQU1UanCiM)XJcRBK{
z5Yu2MP8Y0yh$g7%4fc0<9R2J`7wppzTW6Q^e01*^+~agF@%`jwQy)Gn&s-hL+2@++
z8q2t)dr?b<ByETSe%wR3Up2-m#w#ZIXYE7M?9|yC_UefH`R{jw@5+0;+ut3(^$zk5
zzt>p4^Lw(->m7%+0_!$Ix^az=)M+M75`3;WL!tV@PU*I7L-te72Iqr)xv_n!5C3=2
z-wTX`mC|k7n(Ul2&I9*W!#x%|<A~XmC%HaB-wk7q#t!CH9B{0yKH@A93D+8Rqkco|
z1RWbp_2b7lVst^=mM~XSAAXGQxqnBpX^#ONmI(Ra2SYGF`49t!V7^xT?2CUeCS&^y
z?L4ErM=x<M_^ks^_9^==&^Fll4K)h2jgAlgT@au7hltFH^>^~kwX$B;v2!h~2k>EC
ztce)JBz}nA)hF6-|1a2K7HHd-?`Zo0?DoO`i7xxn{N&*^B8S?xvu4%{=+t3n?)Zfu
zHuHt(`kuE0-}S1*zSWOk6GvmFU_5gnY11D9e~)kaCOFG?!SUgHVAprG%FOR=mRs$c
z_Fu}WFr=F${U&7dce?Yt)*|>`2P4^%k?;-g#(nrTK|JEVi#_CnZzRN9;)wR=zcSUn
z*~Nzbj(gmHqWv^ijr-4j-u*9L&)0m;qK`K$*&)R18LsE}>zSYLyq))gg!?h?!9(B!
zJiloJI<_ggU{0R(JwgA3{g6lR3&!>>ds9q6hnaLq``;2Dav>-3gIU17)Q^v25^wR&
z!r%P(`)OfI$3E1L5A)&ASYi;HdboCeCRkEW>pP!EJTEFdpLnJ`J)d|ktb8W;*@J&5
z))d5N?w$J)xi0b~XILfYrv6H;0qZi1XB^|H!OWT*{oNN<!M2uu_=jLDF^D;{X3R~F
z)a@kf33mL6wfWn3(sP~~8$UBO54nW=hdBKGmcL0~V56_4AHG|JU=HT3bL?D06v>>m
zjgD=Rx4752w5E4Z1J><2a6R2{uGm+ft)czy+WRA#&dba*!?_5-djn?$j^G_)zJWe`
z!2TXn`-b|7-vo1$gU{SjZsgd6_tFv@{p3CcV+?KRDX}-jg<aM-b6w;|PCIFOSEvlN
zD@*Nn+<uYo9lU$Y0`DO=yvN+OyN%Bf`wjHr1GCIm^)5S*8|xrv);@F3yeHI$v*3N9
zp46P$bFTWu(V2S!Km2z}bZoaTHu`|RA-1mTCb$N;7PxMvXa%k<u2HTtt~ai`A)4Tt
z<l2m1<s(L+Nr(M6`G}sJzsgsPLg+hAWvdPIqNxq%FF&ZdZOHWj`W<I0RtRz-FLESb
z*0Dq+=-8T|f96_{_NNZiWvWg?^`oY)FKzm}{F!eSwseSuT$Ug<bB187q3%Kba}M_M
zb#`=?xYjstN9T_--1R=Yc&8Pd+1FXrxtls`?EfoI#p;T`G!OGN!J3$#nve@QnVKgy
zw~@Q7<F?axQ++<^p2xEK-Z5#@kM9z!h4pccLuZ{@aqV$Ea(zBst39vPS3UC{i+%*x
zGUHrh>P&5kgPj`RG}#yj=u6;F48{_}&^AMQ2==h)HwnL848Kv(TXJ%*@dd^)o;jFr
zlDG0_?Je&;+<#VrjlO}8d<SDne#GmF%RJ1<{2_*Z*8sn9j_Cad{MLDgeeh@85X5?d
zd4^~O+BdbI9APG15?-~;x-`kH^>uNyR@NK2N30*%Z$o>F5cobpUj?5fj$j_@$(+nR
z1o@Dc^E}eOLtQI6W2$`WuW@J2S#7s&pDtfm$`#1_3HOKkZy0YIej{m;Kurua>Vle4
zJL)+F`>;e8n{%3Hc;+*d=V<8tV~LT_#*Po?8yL5fkR%>)-$6fqFhpaF;xWh8y@dNo
zWvY#xe*8|(%~(SW>svZ7&k;M%5NoFn)B|?nnthV?_1G%A;(+Trvc}Yzxv6yp8-&33
z3Hqm?hP7UybyeuY=LUP_T|aedg8gJ~m!QrSYz8}f!T#`WHN@8YPs?|p&a*S&*#JDV
zhiC=b*bQxiEj~c}b<M*Vk4MrDf$tII_{x>sIcr%*YD8_0XsWltMjyD|)anUh-QX96
zr&#wG&NZ+X<Ord9gWFZQ54n;dX`1vW+`q~=bnH!Vz197tZm<M)`VH-h?OS%@5tp2g
zV7=6(a@T-%yI^c(mNvc~gM^)gBvAV$&I8y@mww|I$o;^O?Z$q#H~Bza18w(j=^^g9
zzuR89F3v9Z4A>%)rF+atn(k9D3tReE*uUj?q+?n#PZ!L~{3Ah!NbsrH{#|*GCH6>~
z<WW85PeQHPgO&TTb;dZmM`xaU8}}3LE8I`GmvGK~wmat$--I^MAM$JXDo$t|vA7>C
z!TpJt{H<gPWK$da%a7|#amb7HE!C~o-}=;Egc#*L;5+(~Kj2&ClO3NY>|5o@c-3Zo
zTyboFC(lEy8iRG4Eqx|U5{_yH)DC(Qs;Aj`cBpX^K0llZ&Jk_fUVEYaXoZny2HVzt
z%>><jD}9hR@nFNp_92~^oUf5^wrKa93m^RNd};T@@s|AXZ-N|&K`dY%>>(I;1T_Kb
zvy+g#p>HINBL=aEJH!&SCw=l`U)ZlGZ0Uf#34GWyVmCofE8`;XSd24UI%kEm#W||*
z{yYWm_2Va5@{fzo@3dq}-nfr(j2~iae)1r{k$GBY4K3F~pYvtROt2a3#AV*m6<b8o
zf0JLq_MLu6Z1^m3lBVxzKpT4(TYlpK>=k^Dav>*jjNA)!)=oX>$B%I#h!4yKr|8%t
z{dSH)Vxtd#=R1}2&6X|1(l^1bZ-G<ni^g}pw4uXzV991e`V;-XG>@3ck*u`e75ieV
z9ZCPY<|rKL(Ed=&WJ}(JY!&y<GS0gF#-GaNfhC(c(oO$|)+XG(<tpRQ#{;*|Q~Q)T
z-|0`|{>7HhTAsJBXD-j(Lg!h|Gx?(N+!rGWp2d2OAHluM(8f-`sqLNPn<VovcN3du
zyyVDSoX1lx&J7>NuLK<%%)*fl*on_vfbOwP`joAgzQ}lvMH_#{;>Y_5EHOmr@1=l_
zop{6@CC*k3K+K+Us1~c#D^j1TV^eLn2(j{6G<BcfNk|So1I*%iP{584W18UE#$FMd
zIh!DtlWQYaSOxkj^bOGjwP2mD$6br5dNje`Mh)!>K066X>PH-65_^kCm>0bZ{203w
zd-L~darAds{~a4i8+!%ct}%=Q^pRt`{OjMT{kLi)(1#E4LO2GpDHqsDNRp#rO>jh0
z{<Ex!b*(Qr>Ia`2_H7r~OBiAauDf%cq1U^O&H(3Oix8X<&P?ZhLd;}K-nj2ccKM%-
zMeHUxvz%Y@ARqD~zjlGmEa}djvuc`jaC=J+!J5pG&b-X;HIeHUP47)+NH<IRjr&@T
zaoc_&J9ItAVHS?`CmQcu>a#?j1^4lO13Pj1mM!Bk?vB-EBR}$Of*P<t?6voXT2VLZ
z*u=~|qV_kTJpuN{5`Bm!>OF+(bLaWyj6+K}`(1F2oV@n9j$YRi*HbbiD@|?Ky7s2v
z8jQRixh6-UNe6#p>VMN*e^qS3H=Fq72V2tEhO`Yi3$}-BKzk-l(wx6&z6acooXM69
zL0;s@H!;?7k|jy|UJGl&H_{(J#!we(v{WnVOP#q7HINN|>JT|Ey64^MgBp{##_@?W
z75jA`)7~%65ob&145H|qzmqnuM|?RqoDXs%4!IJOyvd(=h9HkAnjlAV9T#55liXUP
zalhM0+rBHi=KhW^e&kB-tc88x-afcjsRq=?b)h!sBWtwPSD9)zaWoFlLojCQ8sB;U
z;Cgoq`q5AE;a&mNpYhn1@b9MAZ<DlPkL)}8oznC>h2JV$M1eMTd>GF-<{>9?a9&$^
zP0<8vS)z-``!)9^bZqpq4ss;kEb}wh6XX$s-%=}oPw|_ob;T=fbo!wuj00i}(S+B-
znhbeVPHEfcmiXJoT83z>DQiTXT&r3y*NS?<79m#dExzd3=$oPyu#NQHnuB?Rd6f_A
zW1UaXXO4WqZOf5k-L@aG-_g}qseaW?j!Td)v;ym>)IN0l4ejb%^-euh8*0W`TY__k
ztY8D5(Z>1Y9+uBco|}g2+broOq*tn)SY}E$wlQvqt!Hw5J|FJ8Vu&d3fV>Z4qmO5J
z%ejer3an$7YmGWYIWN>_mReKGn_B0)k6JSxdct|FEVbDK<M}OZ$M42{_`*(_B>U%m
zL()EiK0vR~U!l*w_NU)xV5n}?l09NC*`Fuqiv+z1_V7IH8}Cm|yx#BitOz|HO;?-e
z2YpD>r5oF-JnAPV5dQ`{K8&$1J|Q?i<T{iyYprL6noO}1bZkKFfO?rO9b7+Rp})ia
zRoa)aW=IF}o4FtCiEEAy^cmXj|0L_UqcPAl7og9KvvOazY6aA+3-;Jxqwfa0`<mhq
z>xiE5ch0#qXNbEV*oUanI(CE2MA2<SVz1P>X4yY{@Q3lhr@klu+tw75byHvHMW?+5
zK2PIpTk3}>*jDYVk+mJc*&QO1p7)$1+44TNC4YvQ;}}mISV@-z=40L_$b+1~xlifX
z@p;ECG4S_Vi9=k*;Zq5<EAAWVk8FauE5tYC*aUkNdFHuyY|(Z8n`|S`v-b^uW827m
z>LoThg!<@bj@Pw9Z0=dQKLYp2mh&+ezT_Q(S|36Ef&JJb5<kC?t6)1e>&Uz9KJ4G&
zXZ>qTk40AdQTr3scgWYc21sf$lO}mX4S{+>PpI)0L!8_%@7uigudy$=m+aANpCqUD
zmA!rKujCfD?~)%x;yEmt>m=y-H9>6dr+`lEkumUVnY-6OyT<AASs9D5#OT5?(Xl%w
z{=_AQV~1iwtr_hthG>E@k@FC9agN1H$1a}`M|Ed!_5(Bb4<F_tHgU<#Int)@ju9FQ
zJ}XD(#P8$0qwmD;{7ditH||5;eYG9x_iwJL-(H`<m$6Nd1G!YX+MH+B?%J>pe1^s_
z-g8ySoJa7xa3otY1mDj5{fuvDKs(;_AN4hTM>DkRn5}UzQo3!4z0sGoKms=U++TfW
z`XZ0kxC*_D_ZV#U!GEjm*p^Fku}-gNXid9(BRu6hA>Rwll-|lW!LPmp-rolKCI~aR
zzX|eP&<yFYlaK^|8}#?U_J_tK{<gQ(j*Ic9;)#FxK33Z2(rH&1SKH|IJD|S{ekJc1
zwAUM+eE$=+f6jOP9^l!^^E|}RGkpnU1=|r_&wF@1rzM;2VX&nGcIbjJ#31$*E#Y?v
ztO9NN@!JL3(1geEJ}?A-o8<4FH%qo5ko+CG$#)CJReH{k#Ey>{(xD0FnFV4R`tSk#
zVGGAzij97^Lq1?T>kC26s2?@u`LHfR?aA{gpGhsBDYOm!UEoWMoqIw2{lJv%i6*<L
z{k!<n&l*_^>jvvXI(1`zyeI67!4|nk)UnpmZN^)-#Ku_vT{-mk<O+XdhFP!;8OhM!
zqxriupkt?hiY8uv*ZuW}q>UZFBbd7vHh=%k^{^(dt1DOXb?!|yp)RmRBt9cZ+ivNz
zLcNcud&8cD;CefP>yLeB|9xgSE4(X&=z33B;v~F(m??dWcmTWmtvA_-wH22$=(D#p
zcgyp~nI<pJH#r*GaD;Pa%*ecn1yda1H7v~qk<vQrnh)z5$`QyJBH>*LR)O~nx9NL=
z{*yGlj{xr|`vdfwCLL-F_ifoD@w+_Iwp-#4Q#3(L^6Lp}9ij<pL(PV0g4!O{dS%U#
zw5u)hEODO9%>C@zH_qM^oJr0m=XMCrJ=a0YYnAKfzRtL&p5S`(^|y2lcEPtI*xz8t
z2U>FUtp=v(1=^<C;}^~Kf$EEH-=#4yz5t&P%zcFObl%RLK78;UNlUpTL-g!N2gbbW
zMQ!uG#C?dp7=rs2`%vq?<r`w<{mu8Yt#Ms@%06=rxDGixTavTl^Dv~lkMqTKh+GB6
z;ltT!IxocLY&aisAg3mt_P*A{b)h!*`XlS`zag31kPG`5g0%$C2i5MiUag&Lkn56b
zw8HgzgI^b1yM{LQlb~ZW)ej%;2O*a39VdV9ApskG?&o*bPWWwQY-{>WVX#?8((Ym?
zCUZ8y{FPPm>_x{1|DA*+xe?FvEX@%KzjM&BjW^I&v0szDg1xqx?}_SjkEwli>@2bH
zp$}UZu0Qnx)(q63vHq;j*4{rcWQV6d+o&<Mof(^&Iw$gB9jie5X9=wZwjegN3)cD_
z$j|hvCe+0Y>842sw~@48>t^j)$E8|<YhoYTL-yDE0@r8WpSYKCU*oz3bnbPHdsl*v
zt&33qCm27IA$dbTL_$o*#rO4Y#QRaQBxhn9?|x>dPTvttF^IDhVv~P}qcv~ctEod|
zji?K?qfXRxCn5PA>_2jRlQc(hZ<q_ZxN~ry`|+_KzDu-(bpZQmY{LiLzHZlk_YL`i
zeTYS!R-O^g3AKZrOvxsWYP$rof-SQC><9ZY1$)H44bjBrdBO8GLB|gGm?b?DbQq!u
zVjuzA5|J<;^BUTfqc-_*R=RR#O{|f%QwM6YL=<SlC^YFneHqtF4T)7bY6Cvsfp}nF
zVuf;?f_$kpxdZwU*y-OQ9>5MWB|anbbbic(jXr#vAU1P!;r*p{Fhmp7)OE!MyAaZW
z7{oe)*i%HpyyU@}>-w=RL4O6?5w4NPSlW&c;9se>p+4h$w(^4cP3(`1570kFyTC>t
z#D(qi@*(FX&b2n%r~&oZg0s7lkTl$Dxc3~vJ<Rts<h}^C&D}TD*Aik8lR1W9e)8xA
z+SsAV$KVeuIg&p^XDu3oyt(5n`3(`u0h|wVl2<}K*^?n!g1!^${n`)qg&4%zg^<p?
zhISL7cvIH~*H25(VF|7u=A8098c)4f*^@|}_luh;Tji)-abJHJi|teFcVis$JJK=m
zMXzIy+Fw!qZ@p(s)<C^rTr{;|>)e<r9lBtzHgzw1%$@<~gS}_}*dHWR+bDh5js2Ev
zCvjZl6kCM2&kJLSbH`vD{!2M?PJpq*p^tGD$JolT3GUBkWZw8N=7^~n#3ClKsgG-g
z#I^+ek-m&0PvX_s#3U9ms6YF%QlewqSA5UGIL3F;&@~^vj1R%SBP-ZAAH2s8u|<fk
z-v_Y%2Y9T<H~og2f^Srn;J01creqT*=OqW@c(fb2DPPtE=tDNf5o4ElZij5f-^P%9
zAA|D&zMsJq`vLc#5^w#4&bS-K4?)gb%!{TrHK7*lWfSc4ki7SDQ!n}6^&u`W7i-{K
z=Mp{tPf@-NHogNEhIH5>3SHj{!QTmw^qZz{fyUnjkvj=V;9H<s(oe$oz$tdZx4@As
zNr*z%w>Fp$9NGRiX#dcf#izNR^2632@_zC?*IGR1J@3<4+qQly@S9+j_tvTBE3^x2
z`vRNoAsuM*4oqC)w~L`R(C4|4H}oI<zTt1oP4G8FGx=MkIQp9+ti<|I8?fWYIQ~w(
z3dHqqF6Ig`1UCBY+wjZzh=oo(OLTljjtNOvrQH>ixJR^{$8#c0NI$9tHKdk9&!3gg
zAU}_28~X9v3FDxNRccCH7@{#p$z^9B{Wt6hafnCUEh0h3M!ud43APb$2-Z)1sFi7I
zV~Yfz8~RrIHA%)!;eF=su2VF@-?L4ZUJ3q2Ti|cDPYl_Cz7WJ9Ch<3O<ar_o=h8DD
zazd|t=x*;EgRC~z1*2e_C4EbTm}T#%?MkS1SM8^0+86ex=h>P0?!tS=>pem52vhLh
zU>ffXY9o1H;T<AG*YgF?v5i8L&X_5V-aUq3uA_OGdnL4OBd;OI5eZw^A3x4Iahxx)
zpXi#`ki!<_^a<y`<Oh*>ol|RtBY3_V+St2b3}Z)1+Suto!ecD40sYVu#yySQJl92B
z@Xll0hu;uQ)HyttC37;@5<^fcYUaAKcR<ap@7#yFckERYT;rTI&Rr9nORnGJvzq6e
zYlds*=sMz>;`(ZW?>@7@cP!df@_hwXVMwnuwGDRbmRsLyfNwU?zsb?JrJE&N<?g3V
z{M+t1Z~LeAy5@3w$PV$BAJXlW{>-%nwV;+qP;>5Op?wJL3;V_X`PySoBSCM%_mS7$
z>zr_YPM)F8b;dc7UsoI;-fL{0AI=qi#%GN)#kG$AD-Z5#c~-cGlH(Bb&3Or}YYEoZ
z1Z#zvbjh2e+F(O|!akNyzIPw(DYhUdYQCtq*1|PGO%~S`*PX6WuHTi{apbj&eGA$K
zTN7Nr)E>}}zz*oxy70Bl^=+`@L#)7G^YYt)-v%%RZS2mer*2<-LJa+uSP42d`WUwr
zn>nB*%sUhEFt0i&$5t59vExsS5VPdUTwQZku<c|>wlBcvhB2(uFeh^_K^}k}f<F8h
zL!2$*3u?aT_%jZMXo8r;hAx<kd3V<As4iwn9|hX(qrTLyLX4(ZEAwYQ=G`KM^IN&E
zmbTxLF~)sv?~FSnp(XeFSR-q#U<1}pu0u3I{;Y>JveuD=?kihxPcgJ15_}ow8aSR~
z61Qh;{8oXn#39}kO>jTsI_`pd827)a`xy7K;2M7eeeNI9H}}be_R4<Z82sOX&rHzq
z8%dKS_7pv#O+S7|{)79k*1(!rA8TdpM^F#y0$Wfs_F^R=`GotC^w;)K8?ae#(r=jW
z3Fm@@F36RfVTjN=reICpC-w>*`%Xd<e~+R4j@xg_*Ri|ehU$2;WrHDFLe0Hj$eyqt
zORzUhc;Akm%}WdsdVU}Q8yvyjPQe()62m;jy2mgM90Q&4A;|Fv@@E}eu-+w_Y5-eM
zpCi~0LmSpb$baTo;#7{>hS)cZt8BF)#Lzs3_7ud5QhV0o^{^KDdgg#{(->eZxLtE{
z-!48Y=NUN{b%QRb<0??wC-8}caX<_>NmG30*doN8yK}Q_WewKp+ae0Iv4hvjnuz}n
z<_B_tku=Hg;xWkm1^Bdr$AoN8Y}xUt;OF(!^`XNNE$a}HK2P@<rhNoweI{Gd_c7nw
zR^IE7k=QoWh9(&6IKAk$RY^aP!${EKBu)L`_E*xr9*3M6quLy2X`U{q(WXvGlLYE$
zru3em+ivMG$WhqRAp~;)^PZHn=_d|xp_MVC^kK)JHBs{;{GMSs^Sz_Cv3-U8Z^;~$
zyZ@;@zcC*^Ph+d?Q=FZ1Ag$m2J?9|*RT$DkHN4rfnJJw;3e~*s0sF&Vu@^|%T#rj2
zO_v?qM%q^8l+Q_sSz+D~?D<M)V{f94!v-PnH?+5C0)OV~MWQd|HpDLXYVOyxZ9}$P
zAF+r@PDeD=3aA;NV<(3pKhME<6U<3Y^4aodPuQcApjU?4k+DPL8e^6FM$hpcTP0_J
zbFl^Q@4UyaBqaULKlOV7&V}tyefYW`oo`wG78OOe4LO9z^)lXZumQP|D|wTDlaB4E
zj~MZR-W5aeJ?uMF-=i_@H_a(_N_1>TeeYQ6`vl{N0mQ4&*9G-qeKTu79cUZcW=eM*
z7*D({_;-Q8_dhrVz6b977Ra~1_3+(~Z+~V=f5%Z@(>Fddr0<JRyZ`>*@D0%40o&g-
zR`4AVb`p|se-Au=Xf2}u`Gcza+gFuaemC`d+O7YL?>+WiyT+W#=eyK#U+JFv$<KXN
zcHPHdCMP8}-dlNp9Z8b}|F&@3vi{z{Hm-5lmLN9saPLFX#?EgQe*bL!CgSgE{GGYy
z-wyev(h~lL2utucxYyr2`MYO=jeh(YM+{;$#Wcj<V&v~Fem^lcZHVkc0=_dP{U@<6
zeJ!!>Ik)WiEz!$wGU@@Y8!_>*A9m_e8R<_P{Dz3ki+Rwo(N{TY&oVc$f%%Ea9Fede
zFa>)w#1@gDV{781AO6H>f_a#46vzczf5-uUpbtEjwM@~(%5yNZpX{yoedXVho8;Et
zlPlO@q@=Hlqrctq_uF^SKjp``5X|RuL>}yG&wQ|x6SM^X8}}jc-Gz{Dh|3(Tc?)Xj
z+PQwzh<d?JsQW1U$G)&f?A7aiL+=K>BTT_NLR<{JcPzpCN7wtqOwbK|fZq_r;hlr{
z_j%y#kOQDYPuxCgbB3H}WUj=7rua8gHnYnb$cfwx`Q5DSw>;TyS|iM4OF~>=o1zKE
z5~p88=0t9lp>`|K7lIhXBR21Jt5DzD&}$$15TS8X5QCfm9k7Gj%mrOAH#rQ^5^6q0
z7t8ySdl%)}<~(vXeO=zyLeqJkd5v-naV>GJg}$3?F-1#`zNb`{+NMj7zbc;xiOt{x
ze4jBxI<yZQeJi3L`Hrc+C!YMD=DPieg$?;cmmQw^o@__Hz}!P@L0zct$om-gu-E;D
z`w905t~1Vn&Iad-_i6CEb#3#WZ9Bg8+;RSB_Z*L`{kxn$pF7SQ^K%d2-o;r8<%Mi&
z1MSH@ko%%?Zx3gP^&PEqm2+^Phfpnmn!vbtXTu(eV_GsFoC4>WTJwB)<*fX<*RfWv
zKkCA7mzBR+_}zj|UFkcehBIx{k^NyjY(aa-ZfI8<W6Y6$!(7DQ7uXp`tX*PaqYr=b
zCvSdlAZfq)<nO&jwv0g>GcuQX%}cx5nquzs!QK;e*ah1Cg7w}uxACuF#~)TokH?Q(
zmI&6VHS_!GBu&4|eg?)dz9+;4;t$cp&iu$FvUXDvnmDR0^#yeI?ex9n$aS$!VlxMG
zEfK=GkQbbkw&P=L`y}yQVu&WFAuvBsTh>;=X0V6W0(C7@?Iu_=c>UPu+agk8>+*rn
zwTHwXPJ$157q9CxpLH$oNnE#vdlc*f?Jkb)qpQGu6|fzF557A=$3}l}k4x?`_}~jW
zA-5;+>4KQ%T=Ng^^;+W=uX}ISg&I(ck+nnKY}rEeYv0(be+S}yf;pM{X2{kO@}Ien
z?Da~TBx{}5n(_6TYYc2p;150V97FNz9Mskv)f$$d?k2QHX6K$xNuX`LNoW6ho{_CH
zVmL3@SMD#qP{-PK#~2z5#Bv-YZ6GdVgZY&=>v8>d){!-{_9a44n<HFHOKcVV@MkQs
zh|L`LJS~0jTW<*2ftbuu=kz>`ZTOUV>Ri~#1Mq_()&tnx7t(vK1z+r*V`)9qZs&eb
zOZI@hqPDI%I<|9x|4fJhk&HY?%u(0TG(V7sS<;PdPqO7$YQP$x7nrBQ+y=Y#Asw9S
zlVmNG>f`Z__mw=Fi#(n4mJV)r>G<4Wx6jTou7T^bRFe?wF=xrpu3$fcvp4b{6_WLS
z_H=J_Kfe1Kcl+Dd(qo#&F+cerZ%)Z;$QKxc9qjKml755#6Yh76u5r|gn!!k#B)Gk#
zhp<0-#r@TWFHCU+bCc69(6$}jU}FqpdrE9uP)q83lBRbOm=A2(-ckKq#`q+Md;lLy
zbc5|3TYcdECY}6ef{xAD&vKWs)rS4X{jJ3FTwU`(sE$u8*_)v5Lwn3M))Mp(*pX9k
zeJ-x$l(bv+ZAtvVW3bIaZKFd7{EuMoz5mv+S8Tuimi&fzn!~oHxyYIPxu5y|Hl%ZJ
zpGnJm_{5)>%8NRU3vBd}3-gEknPX*r7>^x4_JMuzKHd99-^{&Y9^%e~@geB<c>E2q
zwg|zyJe;KI_ko%DTVYE=q;&h8Z1N)>5+A--tvApY@|iit;~0yrg3WoZ%p2Pl#PK{w
zI^Wfvn6f{yWruft?YH*N?|7r=jBy|O&6Mq?`gklcVZDLACZ^)`1bqwoR)P<<DbPdk
zEpX`jUx=RH|M&*@#F4#y`2M%mXF~c7-veQZliva7@5<+aEgQ7IYfNED=UZU^L*oSB
z{Gk2$gCS{b`y}nVH4bQ7M@F`h75Z-I$A<h_821%JKE}Rx8+%-_+(v$)|3h^Zw@=qS
z?1p#P@j&Cgr{5FM6TVsSw>?9fK75Ho?3o<N#<L)yO+SA4GnT&%`tQzsCyD%y!r$Ha
z=HkCQ^LN7~M*jT}NxRDjU;buIoXy`FGbU|=ZHo{?^BT98Y~<s0TF$b5eDEg@<MF4T
zwG6SPSLo}BV`DS)5tCTXqxx<26Wj5bV-;xQ<9L?X?0e)x&8OG}_GBbW@+M@1u4h#R
zzafZ6Z03oQLnCLwI$*tF<eI5vD{uzb%dI_SU*GM2)84=SK3mQMXQE;szE>EJS>^07
z7xUIUj@r&8)ITyGpUIk6WGrmtjPDj9SPOCB2<BkTA$rzmX8pD#xLqaoNT@kbfA*9;
zVULdBU8mA`&q&*r46*e7aCnE{-GO(CluZ)o!>0@UhamRMv%tAvP8gyUKAkagBnGis
z#@&+4VQ7yx&__<>cK!{#&YA1pl2I6Xhgt#&^x*?dFgH2eblJQPOKcU7IkH!XJ97@^
z331PlkH?@-u@iJ`^sh1}c~G~JG)Z6&po_@8WFOf-&K2jY>AZ19htBHM+2uShF+>wP
zzX_ha?zp!2*3P$+_*MOa?>bPwulSow|C{0`{yu}O-)pMfI{h$`Ci#i;i{^h|%2w%W
zn`%D~W3g4APkMjji@ov`gLSda5Y&xYP7$K3&Pz~p?r%f;z@BiA;a;)WPxf2qA_Qmp
zh_2rQFjJz_htCxFZ^8M)AHOXc@A?9rG4y#H{$^$j&LQ)2&W3W~T+MQ(xF2@GnethB
zt%2`ug7s~!bBHF6)=v%Iotdo~0rmO{`ywMD?i43sPUa5bT2p7vdno6lYlG`$WQ}{)
zYN$rN{H8&NBRhT6&$VOBtJc&zYZ#J%9foKLI<^qho;ZfKv8}Oh0(%#XV?2zaS6j%=
zc=C)K-(;KIFSOpRJ>=eiq>X*D*YaTw=3@NJ@vM0X*8ha-;~L?E{}9Yi9)@<s_9^>2
z>=W`KCJ?`J)MoxEwrKio`2@c`pRg}ufjB)OHggR@4&>PcHKJbBZBTR7kUI7R9UHX=
zbc6pEj9&@yhzraSf;pM{TwtRQpIz`6`oMl}BR!^R9CMRHWIp6XZl*~m=b4~mqkoHd
zgJaT<pBd7daLiufVl&v6uFI{nd35gy&TYcIh<jt_JQwWO<hOLM>KCE&4z}ZS1pc#t
z4WA)j?h!LV$F?(u$K!8^Rl$xQ^D?#-h(jN9vmUNP?nNP{)=v$9wrxjkGo=G<>Pn5H
zz#deV+MlSt=-=^WKIVl{Xwt#CcIC(#mKaHsG}xBFZ|0gj_MOD9($$8@Sj6P~a7H*A
zK%GZ{wr!DTfc?AolRc{7W4y;b_nEy0+Dp)nug9Zf1NwWxW2@YXHAEBWjM<7o-mHyt
z!#bPRYgl__sU3;yMD0$3jvYVZQ6ustR|s)rV;<rX3xDuf^g0LjBYYO>d7uxvV9XLN
zVUCLJPjYCCSs4czsnbWSDafCiu{PE-SyR?NvbNM0Xj5m_j^9p+{sjFHg80mHM9;as
zo~C@BAkQc8#g23g)>7$e8|M53d5wfz4Y|*xNgCU>Y!JfZiS@+E99mg>NZ-j!JN<w^
zaqe;U+wzIzuF+Cm%t;-eYU7M?*0$gb4zWZe_kHhOd+MI}3C0nV*iA5}@!Z&9Bug?1
zw9Sy-1Y^Omo}_)M#IGmRgStFXYjxz~F^s>V4<E+Z7a#Hja$ZSDK2ht0e@k}8K@t<t
zm-?yu5xldEZ?MZdk^LF_pTO~uJE^uN8@U2`13LEV_fFp>?kC;joBV+}fcd(3sy($F
zS#RpgK5~8e8uPxgw?oWwefDylVh@3Tg)!J+CsVSCdYxm#m$655<?<cyHH;m?^H_#r
z8*Hu2%^J9e8SZJVK$|=n$2`<%UtohS$bq?L&QZrU)tNnDKiC)c=xNW`EA|C{7$OAY
z>fX|ZBZ#v_h@S8HN76L?b^(6Jz!q_V?Y7gNNlO`${AOAoz-J5QU!o`EN1h`kc6^8p
z_yRV@*LjZSGrcS315>ujR@>O__Rq?Hcl^_QeCvaegk;xuzghkrp#M!^(|16=2k!hP
zSicL_?|+}Z^F4j{!&bll@eQ!T_dw{s|A23T_cuVk{nhV(d;_dZwcmXU9Dgcaf)4E)
z*!L^BGxpEO(3nsBOswztGS}@_ZRnNT_io#F<h_jd+F76t-0Q4&wO{YKde?2d_vY_h
zByIX;jv=mN6Qi=_1H@Yyt1HIQ-!Yfq@6TI*C**I?M}K$Y?}eeibMiOC!QVR*{w@c!
zv4_B)vBV+f6EpK=?vs#<nVBCsvxX<?dX{`bOg#qxeJcjBhX~DA!M4i0o{ur;PcR?z
z^qd39JchQJ>4U7cqc+br7!SO&<4Ygo9n<q#uFP*pLK9vObzr^J;8lA`_S!V|qrl#U
z_OOZ0e&+tN$1U;RPwjsNdu?~MA^7`p_7R7;#OJK^l8bX92cVB!hTv>5E;RlV_)LL6
zFpnWl5KD2l)?Cj5bu!e8zL1ZhZRm%dXO;T1H|*0EUGEvd`-VBvP0M!@-b*5Ry+=sj
zf_}zz5gC)Xqd@zn$>wuHK0q7$NEj1>*vxSR^UVTn>`;BG-<D7OhhXink|Wvm-UR3s
z`&iOveMqm^eli~KV>@Yj#{u4TZrq2oza=sH1@R4Y4nb|G(G*R%o>fv?)1|XF>=XMI
zc^w~}GtMg41Lv2s&H3j#+PbEIYwPG5TO#<5!#65%ew9u1B=oIiCwzOUw1+mfCyu`1
zJh5cI>BWX#34N2RY_*}<zS8mk1mmCjv44egKgxS#-9nO@Ld!Z+^O5yuAEx$Wu}9i3
z?h{RW%2{aT{6*@VC(aK2oQ)}voS7j4JLd^MoyW<$cY+Ssm$+kg&SHtn8ROdLj2-S-
z+`n|TxX(7_+I6<by9w67T38qB^LgSdQG=aOmrpeHzr*8p#_~CJeUIh>>P!xtbI$$i
z8c@F6n_u@{>Xr3*{Z7$uldj(*mEiY_px-qcSu^&ava|h)S*~Sj*%I^+Oa1H*;BTh%
z5X|9ucE+Wz6=>5J0^fCwsdjYcWd3?y(6RN*<K?F~NAx@=TXJaq)B;=|^d*L91^i)(
zE{H{LW)z)1eDK|(#v$&_x@@!|g!8)P)Sepm;eU^@ZDq_M*#vo!AGy{wP^&4}L+Z!A
zQcKu^HqhsOw;9uN{FWpZSZ5yQgI?wyYU77o*^f^JfAU2d_cLY)&ovbbcEL7eOUM^i
zQuDVTeXM)xOfB6jxPNs$lepF*-+7QjZNN@He)va9o@4Y?zoRyGd`I#3n3Z<=@guIG
zU9p{*m6daHf9tyc4&5hs=WCMa+&8fEY;E$vZzmx+ay)SiHhl1Hg0VOBg<#B9uB^q^
zrO%7&-c@73UcrWs_lrF-yX@_)+owu=Xd~Y-)CWx*%?mT>lFn@@&mo%FIu~8AXTUmN
zYn8-41wQx!<5m)qhWG}XeTH;sf;hzMf;p%wXP_nM)y6)t2m67pK45>$k$&U8p8mu$
z*yukAIyUATqNSuA2|5hXgwI`|Yiwu@tc^9YUSREY{ZqDzeW=q)A|*EZk75%0HHYRR
z2XdumuUg8djwcT78|?87@M{V4lW%_mxse01f<I%Q;&{x+b+L|?>tkKibBI=;jh%k#
zfd77gSoE)?`iA;|c~?R%m3y7@!@BD@$Fm%Yd*ivQ9orT&X_7$RH+4<!v%kk%ZpAPm
z9mwqnud%KTJN-l8TgPIf4^Bc1##f$f^zQ=aVO%V=xqnP?1otrDeg^2+0UtoO&sKjW
z)Hc|gU`%Kp<^pu+vRCjs8Jlr8^x@M5<B4TxSFn$yNdmQ?CeRbNk-OkAj<GcU3HKxE
z4?%uFuI5PhdWO~pJ8|36b|f}p5TE>-ByIXabiKbA-e;aTvRCZW%UE>cnc8Q6<oQ7D
zpT!Ryx^T|6y_2VmuX@va+!NKu`YiJ<tqn#>>rL&gdUnD7y=tsFbFH;J50R2K*P*Xb
zWY25TzB_%V<PAPRY~nEXj=`8MLa^tbzz1J5r9%^*gL#0qZ9V7ZKGQCS+D|Zs@yz9%
zsF!tQsE>Z;U-D%PI(@G*tXhZYxi8)yBsT8}`++}_{lV^W_yKK0dx|55&c_zP`@Vj!
zz)Fr})9;^m_;-;devGN(>5F7^%_rR6vYRR0H0i`4C-Q8{otjXq5Uh2{M*c1HXHLd#
z5sBxsT$&qbBhNSKzo{<CEc!j(K3_?Xd-8MN${a0iXUr5^H2yuHSV>4i*Z06Fn*I&o
z5W5i4yT0!&aYWO1JeXoX@XmhwhQ^xlyXF;39MS)-_+lsR5A_$8bQ9A1pYl(R<U8=G
zeYBtGvVRwkKi`Ob`~16Y{-00Bu#SAfexKx5F>2hQd0^+eEAOwS>-`RB(?3K@_+2qY
z7yQOG*zgI#*p*mE0{y$hs&V+;+{D!HX#QTf^!GRZzRBMWxBhO(-wu!dHpkx&E7<va
z9e#|70&Rnxxc;5aT+F!yc{qP^Kce3Ir|$c(MHFabZ-Oz5WsSt5Cd560HP^WK+P_PO
zl{VrLH&R+3dR|oM{|d&=q)C2-eYboo*xe54<gpUxgdOmkqKUdj>Ovi;4K<-Qk@aUE
zTEhMx?bQ(M>%H&%eHKE0tA+gl{YPw#Cl2w53q9j6*(&%!Xbj_K&b@LzVghYL+j-o%
z(8iBA#AV(seBP+R$eK_WbZRpn>cY60P$$R0pR+@~*@q)K&&-5pXw$Q_f~{g-OZw1z
zLd<pTHFLeA?muT5I1A($f>^|79-i~7K)c#P?XOrlrllO0r2mPK-E_TU0Ph-r?mos2
z(F(L-6+${N_6Xi%Uhguz&m>#25^CSn{-OR>ATG>8m+raAXNV@KFLkbTwJS$^Vc3@;
z*dz9eYd7*ta^5(9oMX;2=bG!TiJsqY_Wx0T!uJ%ut4tAplYhbAWSVT1t#4rFot^&q
zhAum}-|Z)Peo=mfCH*Ugd`$JV?JLQclQ<{m`Xsm3QlTaz>ll(<wcUc6FA-w$JuUA$
zi@nmlguUcUaBetTk)UJa%<McDoCVGYZS0)0k^U=xL+}m`GjW^ubKc*(Aa)as55*x?
z%Xye%D<|$-+yi~K$d~(W6G!K(=e?CP#=2M^Yh}%xE7osL)`j|*m9{F~XGz}?#A_L!
zc{tOxmZ6-u2a|78?$n3%vF4G#NkZ~w%SL|__)?qDxK*HSun)0SH)?lOvypXcnv>cA
zx}m+2o)Q~5QunSn6=L4t2P6CNZ<z}@g&_C&um<wQ*ZC5AYdm9EcL;v3@f(ldY%mM7
z>FWaDQD8iEgE}{{X=BI7e%6O<I|)f3KCB0hY)`p4Pxs+hsj<5HjOTO?L-RuuPit`v
zshgpu*elqmb5GD=3;MwROFD$;s?!rQ>q<^Qeowd`|1OA0?2$A{AP?u%r5nx!tRm4z
z!dacy`KEn?UnCw|<Iu;LCVX9RP58Q4(y<%-3^w|E5?trpI|bJ~@Jy^swYiV+oLpig
zTla}BhMt?;H(I{Cp@-m}2Pc{GWenqqMNDEF+J=5u7q%nuWh}X~CTbFbS{dqx&DhSK
zv4^|B-g>X!Nqj1|-%`JEU&}Gf#hlQ^QEos^BlFz3SKg=4+V%xD){74`jhPAKLl6&$
zU9laX3gcjkCOkj$^a8mI(ZnfxhyDcnQ>i}H-sN}iH*I{F>z)(;N<9}V&kX%XY>j6f
ztc&$+5e3%-iJkuHgMEpU(59ang<=!G=Es~Z?bNPiJjR7|VEjypj;+q&xv;^=vG~Fi
zO^^d?V;(@iai9AcM~o1}t+A(U^b>=%)pbp+%X>6b<5r-(L<s7RZ>_^tEaCzB5KZ7?
zKib$UTWyHMYau^47vx@T_Cxl>v5>ai(mp%qACk}#=Z%~X)P8i2tCD!IMF?^@f;E^S
z9ca@x1-^_~WgK?;!DEq({SI4xQRsQzY@@wI%lp@sG&60tbpI_w{=PSIuSCZ-MJt?~
z&o=sDi+BJ#{Vid<A$Nn#I<hC!V2E~sjXo37pKzS7By*m`xso?*5k;a?AL<0>4fJ^&
zF-H3F9%Fc~F;6!4RcXH`S^cbU%>le$S^tjo`&jjzC12~c|4Db8ujaq~h~I_lOFe-)
zx~@%iWp6nLEg9uppmY6kE%wCMBV*$7ZRw93*@vt#hy~SW%O?__HMcEoN7}Z_98Eef
zm*?|b$S%0g0QZ>+Hu~`+#t<Pq*G?ODpbe2=J2@Un-=eOnFEwW$*pDr|Pw3cA*%$T(
z7=!(Zt}(#aEr>Tn2>*^b`FqE|e=M<EM~=cSx_#)!9!c*%bmSBELo#j%<|H?Ar5@CV
zT2u2z-Bc&m%R0!v<yc~X=UJMwa@2mJ`k>>}ep9`YEeUQn>E|I9cCa7Pw(4)&EvwH`
ze87g^6kCMwx4~1s3G#0R`7Q`UED;Ic1z{%sJ~;Gk4|e&+$G5)z`w!58{t7mH_zno?
zf%bRJC;V+Nr2E?--vp27fBq{o+ep|Sun)37Q2RgW`@<ZyuYOZ|r{n*w@Bf#5{6lsB
z4*BkSBu&>lo58jULwe+IS$@x=(~p0<?v>m(M?&AucST|nr)g}@-_Jw8nf==t8}K{2
ziNm)QvGg~(QJ{@|3jD?!w(P`P;t1xgxswn1&$0&YJKUcuGw(&LtFDJ}uoL=*z%K-`
z7)vZ9^b6bHN&6G;9rn3nU}ww{L$o(Ie@p!EUm^;g=a%1@m)JAulAImR0{dY?IyQry
zeT&>*_M5-gvj6oAu>bgYui0;Oz`k>QlOzUbhw&}heDg@ABy@4~_vwmlOZFkQ{+4WL
z(?1lGIhd0?n$|FLjjXS-vyc8(I62NX{6bJOYRLYuH|)a}JR?V8NjJ7P+3<x~xX0rM
z`1As8e5?Ir9^PB_mHcSe{G0=FU4+_(cd4I&apPiL@oPVQA*SZxonr8tA!(A>>-@B_
z+h<D$x2wb+N!Pmy@Xk^>YCmD0p5q*cm@twi3FPivS&#AhkY-4K;_h$MMf=O1hW77p
z9qP<+4V}F1xL!Epod3wP-z4Ga+sYF0t8x}YG{HBR*LN7c#r&Iejfc?pv&vH24C(J^
z>Z|NuezYxX-;<8t&6LgDeY72ClpI4ku$Eerx<2dnIr62R)HVdQo~pa=JKWE<_UU!+
z;5y`5)j8q(M1t<~)72N+bL2@s&R@&l47`g+f!`0tc6?^Sx#k=bgZYLa?i9?yT%0-1
zSyygD=Zt#=_cZQpEzcVF>y->i*3`voeL8zB&!6wV)WGMDGYGV??*eVxLi*wUO)S;z
zaIQ7S6wJrG<iYuGTnox|C~wxn+E}w|futU_7ESG14{8D{p$}+xLCl>{H)!HDpXOz5
z>bA@Mmz)-P6=-8;@9_^o3^<9~owcM7I`eHoKIFz4SW{)H4b_H@?f>#}ZdbD0NS3v~
zo~bG!z^|z$Yjl7p5Cx(@6o>**=Io@MZfmrAWRmPPAA6a>UNAg7GUECoLpbk9_wO`*
zpN;lATM`&I(edf`9DC>*u0yRUT1v*m5WABp35=N!s0SW9*1pi3z}z#bx^1WUu@Mtu
zsrJpd=4DR$>Vmyk3H?XHdT#I$vl4V-nmBnrUGj!=gOd;sGue`^UF&-u<VkEB8b_I*
zdalo0JqbzUJLWMlt8k=K=c(3H4*A%rJ1)4h+}|$zTp&Z^8)D`KHsYJ`bHv|0;F+?%
zG#*Jv0)HF*xwZ1Mi_cyDR`S`w=LnxEUGVwBXG_RF@#S|rK3m9bS&N#~_FPLkFb?54
ziFXdZBmCU+?1$Df1Zz8q*T1!9_Km$<qVD<BKEn~5&q%i96ZYToDfYHGr<J?F++ENY
zJ<>D%vyLG`u)Yd5d@DJUhJ3GkO5eG5Y8!0d;anti!5qvvM2Ol`)u;Le&S;4!^t53&
zM|!*BId?-2{w<ih&hI>G7;G~khhE89f^}>$v>)pmLgxaUPi5v9AA5RKmwD>E=<8bJ
z%wFh&9OE(jOg;Ldwiy~@$4~#nN6yK-z}PnCG1WH|v&0c~u3py1oXoecxv1y;?OIm|
z&SxYopHC#VEr?mkk!-2~)PkL$w}iMFiyi+KtgkXOh9%Ag`*hnF6Z^!F{SzVo6ZB>1
zvkCfNxelat>_7|<zY}UR{}M;g{}cF#86t%9k&Lm!5=Yb;_qh6|=GzH(t-^iq7#)`2
zuFL}W$oGeM*F!RP4sp&q(xHAPGREIU2=biE82e0)q;rvs4KY0lNubUUO|a%J*cb1O
zdqq}1ae!_A5auv<j_o7+S(5INo@e1m_Zr9b_lfT+&|k3sQ_P*aRO^j9wvKDgQH}pe
zTzjf+g*omqHruUNIlt)*e@{Yk<({+moC9Zb^4vnwXNzvIO~JiddB0lT8|UE1=KF_a
zjD4rH|Eb2v9;&RhU58o~?9fD=+w<GToFV)fGxQl#@n=p~46)SPVyQ3RVdTj^@frH8
zy^=e{$XxcBz2_|86c~3=&jtO7$XMdZJEHNsNer<?=yyynzi*E8o2K7DH&eDJw(Jn?
zclg~0D>;%C>_dcbE_LaF9$CX;UpNo_{n+~c{Pj0h=YgGdEya@aG%vN81I`QfSLxXP
zi{=*d!gfo?TQ1Et9>5Mqkc+Ii-jolvXuJayLxkP|b}<V_IyAit9Ab;$zYi2$tmH^S
z<K5oH)Yxq4@qd12NLH4{C+YuG{co7^@1*^^Y87}t_(c4wxsxvWQ{HlxYMhJPc8~9P
z#y^R9%KM+PP4)1^AF1Dd)7gvpgub`V!jaze%#8#cTaB^q*sYk*v)M0}#wS4!LEX+A
zdZs7;=FIPDo^KJd<3lcu9mBuTjfCIV;PH{(RfAg8AfGvyuj%t+CRMLC?DR-{7g1nc
zhMLd{jEN_gnxW5g*wWu1t`!(N_V%5u-Ahl*XRt4EglpD%^fI!i+FPB6+zRzfmkx1Z
z`^wlO$^6uHZEX0v2(fej*fVr&H?~{i?+H4&N9Q{ebYmN`3+@khi@U*H+4{GclmAw;
z_3yz$G;w&xae@8zO~nNNmR$aQxn~}=qWt?$y_597J?3scL7$O5)3=$@k7&7X-V^p?
zi6hu^@B1$I2pfLljN@mCa}G9g46%;KhJPpM_`0Ac`lDAs$A-`O&h`ECo#b9ts{cu^
zu}it;q>hBn_l5#-A?P1D#1X_yu@m%4)AzU`)&tm|sIgD}(08_;OiAz<d2%l2HjU}8
z_SH28*6_s2H4e#0e0JW0E<15YG}Quh?8I<(Avn*@x$2Jc`MUD6mw)G6y6@b1?mo{3
z&q94Zct69tE8b!8E(?Z;0`Iy$QDf0->{M>M@cTB)^}jT4(j_aQG3<Z)8IFIGt}|56
zU~_!WK8~ch`)6#QrDJC96?@pVuk0_MMeP0Nb4+K!`S2OTxp9V^C+7-FFb4D^rp`U`
z&T;p+k4@jL2j8zRut9rZD-Xywb=+mA{wfUV!JOspxj)NLkG{J@_p;^PoLbw;yXntV
zK1cl-#QL}HEq50?pyRKM+^5An>Vy7HfxcmiE$Z5_;k)Cp-w^i%xy(642zp>Ypoyct
z=&k2I)b)4H_aZa~_6E?2nS$IcBI{9;+D9-KbJ7F-(CZegmor}?_+2KtIHKwImtkzC
zbc1auF7!KXiPq#3J0;_eT``?l%`<baj`}d(J9;7}at`Vn^0Ct^F@`aA{8KO&J?-p^
z-kzYZH;5<yhPo{|IUn<epbwz0c7Y8aal{*J_*gf4z}dhMk!+nCFvh-;BMIKSseIT;
z%esuwnFm&a-UK<+x$Am7<ckluKley1InJ}cX${=R;6Cb}a&NiAJfld)=iwgTcbGcd
zY1iV;QxC{DQ#y1JiRWX^CU$;a@Y!+n8DbdQ#%D_izUT2b^6R^wK8L^F1?JyJzDt@V
zz01z`(WdxOKAV`6xj)U%yj#%o5v;Fky{vg??KfLCVBfnqKcI0Z1ZTesjBoH)8{<mo
z4negM-;&x7{e@r+Q|k%VlxMeDYvS`<@)6So@rE(Ph3&T_uG*%?Z#a&*Yj5t!l3u$w
zd7hk^iL@=r8{!SV@eoU0>NEdJ(6LQ{AITWp6ES9GUgX-n-lMT;ItRm<z)m<P>qva$
zg<w9<O&_d-wNKyOvL@C_4Ds|ve$O7LNp0rxeArsfH8YkR@S3OtE&HH;FEGZpgy*6r
zwYTtmUGoBCd?)9jHvPITYhaB(fmruKzS+{j<1YOP`z^QPSPMOwB^|skZ_;tdabcfx
zd+zlu@jKQvnrhJ(xX+&JVO(|lx9sFmgPP1UFOJ3){9S|~@1EB+mwZ6%4Y@bO9KoFc
z&K`Dh-w)rDrF&v*BZpeljAUkQYDV5M^7u^Tv+)M|$=cK<2hd@ObKxA@iGeOc&=>R5
z8-3NiW8X%e1HBT1d;;GMaks5$F2lUmtHiz&dNlOB#7S72_h?H8{>F^LlKvBFPJhY4
zZdQpo(v9tm(QUVE`d;@(aNb{)-_7}5{gvzKk|w0H=R-6xbuM3Lq_g7;VTnjPl5rDT
zcLUH3<H?=L=M>q~hVPA`8tVcZG(p}hxDK}d0P|Mv827ib&mn0-I?oLf+Y;n67yWoI
z=CvnFK0{o~zIWzz#k0rkH~W7Q&J}$L?D%1%^tj4U9FTLwR1FAz3kiO|tiq8FZ@+`4
zeg{>y#{8y(ku1q4;uqB|%%bCil{K0qwYv!Q!y4Ep{+9CHyX*V*;oqeA{*8@2)4GT!
zZ?yl~gX?$A0Uoashs}QE6z2i#H(j<6OZA3m7ufI-L#&z7;XH8rcsIBO?*&)B3-tRy
z-U(Kw#<0sf!g0ML?0Wy_cZEpCFvS*4@Bd&VOA_LrzvFj;y!$%|@BS*ceaQdxE)ZM%
zs`<tG0REqH*E!1l{{?eD&E@xUPx2}L&)8i1r@4-wzv=8n{ml}3wnl;u_-$Vrp9H;v
zz3cOF3O*-q@DW4KNa?X{*rVXz6iq!GeGb4%&}a5WZRYdma_F-adP+X4@wMdct&XSa
z7~7p!CG}vv;2w}qG4|8rjeSUbQ}B5Rqww_^nSNr3t%Szl`RSK6vA!<Ye?Y&%zLFsc
zae-|m)nCtzv-9~`$4@PCpXNQX1HM^$!$wYJXdGhZ9qGCkBmbRd>2Jo?zs2zHG5ovC
z8$&)5(l`I+o?t&>ss{h&10xCjUHbal#J|gH&d}V<4@<CK`nuV<etNHKIU0M-?Ydu_
z-3>8Y`vdF~^nz_$HgHX3&8>d>?C;8>$H+ZqO>lCJtP|aK<P=+wGsF?pnc0WuLo&}0
zOZdK8V#9An#&q53nH<R{e)7CfV+%i5OV3vQ9(VLTqcY2PJK~6U4&z?1A8Fr|eiHPa
zKGzxfY&S{zqQ71wy1};vv5seqy^Ev0S{K;x6GzU-Tx`U0K1*lC*>R4XYZu(@sXNYn
z=l=67tbAs8PIyOUnsolVtl&Mm-eEOy{`Nal5_%Gnf0U*7WM)W*mTbLyLr0n^9r^?3
z-_(~_FW6t@Q=KOpb5^#-mD)3QkE<NHz9q>%v2W}rd;7KTItR{$GvZm}{CvioX%~z~
zo^9iK6FcL$1KdG=Q}CU;i<J@`Tc!TiAg2`=<0qcnRbX5RjfuU%Ucui4&kTLSQqSC9
z*0sdf`eY-<xkEX`eyuO>HhbWB_J+Iv6?64LuIHSpVUBcTTbJ#PkdI!OhdzM5f%&_j
zcY2~X2*KIF6peGr&rhC9V;g?Q;Oim;&#z(p#FCxd%^b|De(0C=%v>w`z<zAO-Y#(j
zzrFn165Z_lt;ugp|E{dR&qBX@%xcOL#8Hd--uI*V(P8BLJ?CdG;+e}ZZi3z_*zob2
za)_0EF(=$(+p8qzX2=#7Tk`<(HQ_#1_WdLsLwp50@ga8Z1AD@`Kz{)Hxo~XA&OJ1Y
z@p*sQWA8I_8s^5{#K|1;x(GqNCVZcf)_dM>?v}x~1v%udl<3eBVu<Y@z;B3Sjv=P*
zGk3c`P@e<)ZR2?v<?r6qXDaa7YJ$(%0)H1<{%u_PyBPVmk?)KAee4N((`PmQBgmmn
z(|pWNFDpT>VCOkyU969FvTpW@JzIja;9O3DGc%mwC+@hVc<?>2w7tqvYTNGkD)BkC
zN#EIXr{`P;>w%qT+a#CP3q2+42Yl=U>>m>BRYDHAtw7zCbV-PW&q>aKvx$Q53}=as
ze~MEe4~EzYIy6yZpLFUO;<s>r?h)G?tikb1`i*@^d`GZ1>=FCLnZQbpB<JR{!$++5
zl3bt;J%##bf41&Cd&Jo5u{^SQUF3#pdY)PCis$v*#4tbc<h7iab#xKgL){x}_&v`m
zb8XF4nYm74cGf4?b%)m15_IOl*AsN?l{;oB#yAfdFVvWoxknOM{|)PeYA4pYNXFn8
z=WONO*oSNd@~PDeAstw=se6HLJ8|S5L0!+YOAof;Cyw|?s8ee*#z)K&N08?l-^s05
z?$r>SKODi``wrrUphnAH>-@F0Yx>^t`Dpmev~IuUyzZ*)pCmb5(A#8v?1}cNK8K94
zuiP*CH>?3XrUrOirG1uLaS)pOhJJ3AY;XiUdtK}Y`vU8Q`nRX+I}OYij_mN}?;m_m
zIn=7u?{>Fd<KFc7Vg9F_dyY?I^6^*sRC8tzT{49Coihl*z2cmpNoVZyLdS-0C5~kr
zf_pKNr#n(@UGdJZb+Nma>owK%o&BjK=jJVU>RB*ddI;nZLv@yVV*Tt9?6McEf&TFW
zI<{&j=di!p^DXLGGREEoF_on;*hUPoTTo*Ne#3MzlOqXD@6^oT{aRs5hiJdkCEr-`
zogdJCQMm#+E9-_N^V8Q-&tGfhoY`x>Q}FK}eD4;E@8kOHVjo!_dE`^;B+O$SxeB(s
zm-&n8Uqt>ld;E8M73@Gf`KQ$F(km-{#1IQp?1VbCcGZ`BNAO;7ik;N=f!2rK2f`}v
z1v~Hl9+<MhNm{-a?0N^td%z>wKYxdJfR(MWsqX`M|97)wi(h}IOIB>RtUmNvxP2bi
z80$xQ;CElQw9j#WMc%bNeyeH!Eo)D=?;h_DYr|KW8iQ?jEyknJ^qj%rI|APe#L{>5
zk)UI%bd4)h<C9QpBwNzhX4&L}npbVq>>?8Ss9?uG#SzrqBJ`Pz1Z?<-aa>C~K4OSB
zjImelm>P?(a_24ift)U8fpG=jd7<g^a3ttJEIH6cyx<<_ZEGL8@ID^x=@a%3`J0&h
z?iEMB@7BfOH(!G92;yNELUn+eW=TJSo(wkfs8j2O?0^sZ=HF#5R(XfPJHZfxf1648
zH}#t-ThI3!#PM%AM|qpSH@puibD(>?rHA_H;)s@OrAO8Pr%2W}#THFx!Fk-Qa#wtw
z*qR`hdP9U@ALa!%z)#!}bzbK7{MM&z{RQ%u2;uoy>&kVrcJy}5ODwh;cNB-6n#{?X
z#szC--P~uxxW*Av!T*UV{}Fy}?q|oop=WA~uJ0DBz_=0`n`*ai-z}*P%mYm@H~m5X
z0RAJ$G1RDFCx$xgkM|5c(mo|Cj%|wJTsUXWsf(feeaiDR^-P?6K0>lSM~n@2o+tj>
zHr`{+d_TDUCcEH0mtp*b{Xdmk@6RfJuhwKgdiOTJq09e7$X<Dh!8Qv=IxsiT%P!P4
zdF@O4V6dSd!QQcl?B&#+vd4U`4ZaU^HaaKH?Cbn=w%j@2L+%D=Kk`hMVrM>o#B=t<
z9PTr}FGT12w?JQFh)6cSQAA77u@Q3wc{B4}!*=_&{5Lamh;=+R$JxK+AA&jQVdZnU
zwFc9qf2~XF^XHmBYgqFT?1|T2_sjc+&2@;4d}c<O$Mad@gO;4~oG}+Qo}fNGK@;@K
zbI6%-u6$k^#@Jy!fZeg2GkA<_f@hn10E|O9UvtufdS~rZoEO;lAvlAc=jF2+`P*{l
z??-+^wx)QoMCi8<5{77^6RWchYH7}%xCiFKw?tDMb9uh6Jk1$`xo?SWi6fZj6U5w*
zYld`SY#kYbKIo|>C;O%6C-56`$gN<*-v#^39<&RekL|>mExm%h33Aw1?=3dKzaPL3
zO*nVu{ocCI+;#2@pikMlIC-Bpf8zyrm3vn2BI7O&c4D~u%B5DQN7M5@AhE5SkNN9-
z<iiluqb_qW=MYH7tI#tBKhH%^qR5rs_qIN3pWrjNi^F%tgwN&*K4SRZNNwh#A9`Vb
z=(jR8#t!I_Yh!O&xA$mjKi~+?h_l*B=<Wbx>z0lo{yUmto*)l9@@C6+<CrEN{nB?A
zA$+DS?-7!9!W8`i8*EW?&_`jVj$|HSPQ%zS<h6vl)bFC+DW3~+=eZyO8=!Mu+`~^0
zLu?bL+)3Y0?q<~)+jh#mp^l**%nNM946zD~O%(r;&f3|7U0`f%f7&zhU85@pJ+P_o
zNR}jHK=+v5iCuy@I2WJW)Omfv=Sd!Oj)Zzp_lEJomUA%A`Y>0|yTW>1e?8RoUQ@fP
zHlU9rioT>*j>g2#WJ`kQ#7<1jsXD$Vdgk3e=T>`TKEYhD3&H;6`msCaO*X}tItRMv
z?yR|t@d0_%-ASDrJATKml5f4sR>6J}a;dQ|yf)8;9Ab$hxC6d_=oS1xY-MO1;-1T6
ze8enK>od<z_{=o6eUgqvKE=)Koq5@lp=Yk^8I0sea*x?F)1^m&F}@?3_R%ml*k-cJ
zUe`6V?oS+g6!gqmytbjWRhGs#{(IN+yVR6?<H%RJ<M7$mrH5cXBw&MCIMNN@>2B~<
zn`13!sr5;Byd|;LtE_X~`cQur`^m35<5}p^L$DV^v;-X+pmTOzaF)m^umNN4z(~-E
zL&6Y|5*^zS<N-RiAwqE1xOc5^-&6cG#&@>H-7(a&%@P~beAgg`p6Ib@56mom<J;+H
zpTKcQ#!IlzN7S>J8e@MVWCwgx96|07TkyMOB}cOHTTRT1t#Kuqav$LLobBkak|X&<
z|3&>>5Vr(#(n}Nc+3At~*%QuLpEG=3@tr;Ny_)agO`tEn?{ikHTY1!q_Ipp%uiW!9
zp2;o}z3H7CjKpIke#dv|=bDG{DpWu5W=e;hcn;6GG*{?-px+H1>AVZ{d%!LI6Y=m~
zaLESsy&&%f`R@ip?*vD_8|?p-O+38^<elKtdqCa=n)p@qL{FyV4Zhp<lkum#qndw(
zr}t;Jx$exqJ+|M{_B#$cF_w<EwEdR$f0E>wPjREX3#|H<J^rQh(zABM^SAUJf$t72
zLB~FYKNkm|ffqcR2H#Qq4K?~jXw00<xApAL3v5vPA)Y*H%>?}k`;Yw4)Em$vc>E-t
z;~L0bc(RB5P~*^Tw{OY@C#hq4p*M5)<{YGbHI`Z-M(%0X{vG~3gnyq%hNQuEF0kPb
zvGsX8MH5G##ej|tKXEIi<F|ak*f1ui32OAhk`5t8{@csczp?P|Ec^|CuYYsl-(4<3
z<E4K;Z@k~rzoj4kO<ipMeLX=RvQ7C1?>v;lTu0PC>Cf0ca((RM%)7|mau1OeY{33^
z!C9OOY?ZEYh^9Q|Sh;7+PcQVive%}u`y%cLa<-rk&u>Xx>Kn%RnqV#DQ)h?}o|Ac@
zU0@@Q9M8+#)HC;Z$Y+*xbEE^kO~GCEJzhn(&3=4*C+r2r-$CA;JCz4VG<|0q1;(b@
zt=m^+^-+`BJqgL$gY{9?>i&pzo+Y+VklV!0{bWy}3-&og(^+wLKI@_L<Zf*}U$Z<%
zJSRLyJTnj}v32?I8*D3Mc-{{0x5W6H<|{D1sebE6@6})?9$OM;{gyLxx@7zTmfr0>
zF=W4ST&>T1m6?4YPl4Wt*n&OkVu_}GV~^QK_IHb~&on;!bVf&KHgtZRC+9qM7f#*>
zZ1^}^&Xsu1wR6sy!@c32hQ4bzeTNQx?_SB^w}aUHo)BFz#BId`I<_PD{_WhO9N>Gr
z^`)_~4S!|w{ax@oVDMWYLC1!Vc<Rs-^U?!r=6)}&iO(2d-A8c8eb2GMO8b`2kpIMx
z9ah4AfycLe^HHM}Jnt<1(J#HxBWsv~^M#dojE|TKww5`>cM)RexpVg1feJR_$YXB$
z>Uk%8#_Vw~Ea^vZCpd?Z=k2rO+@k$XmxNh3(%UbpAqi8E!`V`k`G)Qnp!b|_mbs>4
zJ)iFfccg+HRuY=0V!Pw2Y^4_S0CR%JmR&aPH20Fdhyr6{J9`GK2Z^1Sb%D)sO>q_W
ze?5TRaWiv}H;zHpT3z`N1@3|2Oq!Va3~*oSz2)w5k1E(8QsO&;yU%mMGef<T_l`L#
z%!jYWxQCFP8ejKT^{72WP(PmsKMUM*bng02h&i(1^Yg*?Dws)^46*c?JNVp9iH;3F
z%;ZSI{hY-$KYbq2)i-+qtOJ65Nmw5&aRmFY%U&(*kI##<o5_)cde%N~`>LEJ7rp-l
zT<c^_OYA+N?;%(VYwCja0c#y1g!jY}8~!860rD$bW8j|LFy|7XJ^&rCLlfjuuM6g3
zz7X^<FR<Yo8FwVjN*lfqUPG1C`??2tZ@Ih1_jKr<8f^HNI6t7NJ}}P~^g%xrY=9qX
z?2;W$N{?-0k1CEEiVsn1Qn!h_Z`RU92(OPAa+!y-*n+e1Iaw~*ZklZ5kV_BDYp4kx
z<0p<akOS7Y^g0i^YZF7>5U$r$m%afVJAUGxII;t^z++2nGue{BxQnH{5T1LMHB}w|
z4S7!t*_Sv8^DrOmg!O~R`1&`v9<|2>wrUTJVWj;?x<0yD>3@>MU>`|HdJoX?!Fj-Q
zu`aWvd)=QTaZvMYv-I8((-U<3_=Z@CKcoDaS*3lJpM0)|q`qm=nR~Dw+*y6L@VAh^
zRg=GojPoux-6P*^-*0R)?^meC6V$FO<`S&k>t^kSo=mmT^Ab<%o%$SybK$>zL*H{M
zTjM_i-_;EH)NG>8&lvkoh_AZyyX-giA)Rx}8uO-;^X9wl{pw?Cd<u-ACm~r`n#&C7
z&|dgDqdZ5S=gBc=i!D;3R~vU>UU!Drith_?O&so-2*LA@WDKjoI0P{;3N??MlT_U{
zBz9vv{m>`t>AItEa*WM(_GcFu+s2-<x9q*o0=d$T&s1AWJ2vM|<sH%T_e|*bPS4*-
zN3znI;x6Vj#*fWx=@7sCCqw!lfm~|L0(}Mjsdx5?GoJjt)$droe>bs3XpD`|F7}>%
z;rAN(P4x`5_XYF95KEjw*E_j+fejo-4vZuuZ}v4OV`7}Mq@Tp~nYZa3;1HpAe_hPv
zNZvHP=L6gCSo@JfY!P}7*u_eYBs9GjoFep2aEK-1-~T&ZwwWBsoA#^nlP&p#{Yd-c
zH_i2dpT>QvVIQ@uTXxM2>jnEm{@Tl(Q{#yB_>){2XZaM1?}?|_YJ1A5wxhb0uFu6K
zj+pwK+XBfLU!+`;*joCDsXAlZuoFuT^cSi>6a!n&_u%^pp8@)=Vi;qGoe<x}Djeyb
zptqmk8q^NKoON!-O-%I&^vT#U<UmiBq`^i$vCxvI8sr>7&r@s>{O$PwF~l=Zl)0$i
zMTnvAf?J=b(4;Sc4`zZM0w3|j0s0d7(5cbI(&sb`KCcD;uCmHIJapd2VFz^kk$}y9
z<P=*_574nWZ|D0!{w;mz-_&_8(evE|atr>gop%_#5A3Q>K0O{W)i<yP)>dI{?7?B3
zI-@PvPgBS2^%Cs+6GuKE#&qe_Xkuy(=31JQc`Mi={lpPJvKML{!JP8~8$KYe7ecz{
zK3SVNJb%-i>`C1h_vC(RPt<T<^aj*t9_Brw?hCzc@pg~#5z|sK?z;0!9MSY0>j`|s
zm@YjE)M1Rg!A?9ZaT0WF5Er&D*^l_t6S>Se62`scO|9u>7hA2(Tu&_7Lof$>&i*f*
zLlZO4mow$=FTryFA^cqNobbHx-0(~Rx(WGs-iSE`#@LDDxjTPXt_Z<<uvuu*p}sSF
z(;a)u8o&Ox<}KiJ{48@hrpsRmjlnjLzmtw%%7r65FOs>pU=LskK9{Cwxu=o)#{NOm
z{)axNI1`>Z&X4o#I@fx>Q)fHmJNc|0#RKQtb=LUF;SLRbw_XAXM{Isa=zF(ej6DQ*
zjk(AN^dqR{+@{<mLf^xoCsPtm()fO#x_w>aNYG(kV52_s%<OH@H$7xe^k!D}NbkmR
zAs>6#^0{DdZjNl=7<6KKAyUT<M-X3gu;B~wb$0puZO%k+Hk=usqnxjaqT@T_>l_tN
zF3&KaKh+@r6C-O<qpP=(cZ$7YPtBALjM?wbZ>_v5k!N)zIoBa}5>4|9#@3NNS(1Q_
zT+Wu-OLH&}@|5|${F;Zk>O6OS>h%Y(1MwAVK}%_!F)-f~Q}!<C3x;S3`vWs!UDmM!
zvE-}^Z1{+Aj%Amv!v0k3bNrhmj=Uv?2;uWaa^6kc&kJ{%dpz>))jNoe9Y6PJij(j>
zaK9>BW1d6kg;jKX#F5to^{CrLh?RZt49t8EcozIT@XV|WY{WVqe_-P~U;ZuZ`rPF6
z*6=;Ef_;f2$RT$N>c9|(nwn<|_QlY%Inr4RYubV}vR1RCgZF4^KaSvRhS&+`*TqVX
zBsA_>;l2;}9Ba8sohRLK$S40NTUSm9`lkOTSWg#GV9nkGBx4|kSeO?_V?$kF4rALL
zW4opOGv^6O=B5v53Fmd68L@^O=c3o#TBEBD_h5(++!yW*G{HSu3F9q@C5K$Y_{P3@
z^-4b#db??|!EN{YdhU;<?W^RFzcn}WyBB&~Vu&cPF4kwfPV%TjUFMqNBtElI&KVzZ
z?&GNkYSPor+N0Db*UU0cox}6uC-$C;Il*=DLnzjecM{k0*b;l4cjp-URBq3D%u{I^
z1M6d*UMpj;pPVH^b*OiQ=VUJ6d96Izu?^7@>KN)m7a^F>bJj7vwB)TvYP>ODe9T4d
z?;sB7i8-iugxAFS-f&Efx9yW8-qg5}b8SiQeb+gF$M`C?S84w!y*KH=yj`#_Jd;z;
zUf1Ugf5-f{jL#lFhs0F6?h(xEPBqoz{3_VK=3y=|H81QJ+@s~l{+A@{>tg<pqd5N!
z9Qu0)TZF!2Jz-y!=x;Rnn1h}onK|bud7i6lUhw#@$hV$sr#5<(b-tdx+;YkOhGV0w
z!Sh)T&3V&upV%Ari8JN=xd%N#=gfW1j>Gm8i_MVR1@~*^eG5t8E?OVyTaw^$6dfBr
zID)#ak8ZGiM_o_Xx`B1EMz0gw5$uuo4ZVVWi@N`e?-=3?KJ=Y%W=kBw@0TqifA=hY
z>m*OVpQ>#(<-f3HZ@>Ik{NAg|JLVqWb(~Aw)Er;^vKH+d=h67g$?p$*Zt>lMbDZog
z>(<(O>6!XKJ?oa(m~V;5_kZ<09q;N+zOO?9ww{C}xj>yJcFuRpDLY^%jvVr-HN_FU
z6WpTfJ>a_D1^PYT)cd_ZgWn5|@=mbpT_EsI5VmOLy&&%aAueo3&Wu5tBfb6lJ3|uu
zKJAwAo9c`Hg8hF~-u0gH@0g#CmwK(7YiwUHYkIO(|986cEstv7*jMEp^J(1vr85IP
zPdrom0vkR+f5S0H&+1INq_OSDc4J?aJ#&|y^(MZaf1Z00>2v(i*z;Su&#j&z^f_Yq
zOtFr1jB}deso6yc=5!CW5A1+#Cg|A6BYzecLnJHniATrom?<5OpdWgpS9)LKJb)d4
z2;#jC>U0r;x#+Pce4bXYGq!(f4A_R?`y>B0;(s4$8Uz1k5@PVqt^At`HvWC33Euft
zu-QI&UzdJt=)G{HJ09Q4_ksL7`q96y1Med$*zkY7=THv495L0easNo$wsh9Ynzz;-
zc|J#yePln)mhSWMo@2XlJT-g<-qWsm)(41d>VsZZ_TYI}-V4tB4PxlcH0k7bK`%aE
zdY~6TH>c?M41V_&xi0EiU)d{bXHK|#z(*f9*tZ~_J3R&8w_yAbVo&B$Ba)?>1{*#z
zrB{x|&;>b7&>Ns*!#7_b*L_#X8ny_&;}jTI@U07M5D9gFnoTe#J%w=3>}4063HOL|
z3(ik>z3Z7+`7HXm<N4yb39<DI8Ep7Yf{qP8&l=C%5WE*`;_E%w-&IHOehfy^Bn|J=
z>N_=$t8^@KJg{Y}5aTiPcR@c#&>PH@*zk1`f;{qDQv0ZV5<@JINB&BVBy$WA`PsxC
zh4zbm<MVCvS;ps`&VaKR3D4NqbIEh1JH}Z8I_Jn49>tii^Hl5+E$<|Eg5L@JHW&gq
zH9opGfX?p+Vz^J-pIPn<cbt2}9Xiafm{oGAw*>D>_|4(p9ZlcI&5+LbbHkY5CXVmY
zfjUD_6A3FNHuuT=^vc@kw>^N}&^K%9*Sgpzo`n$XrC~e@jBCtPED&#>rE4IGX~O5T
zbXL$sh_Amf<-9p}Z1{*f#3+AcFDoTB*L56Y?6r^i5{I2Q>T$lIv*mo*BlePgTMw}3
zhke&w;apmtVdy+L(|W#jeB?8ZK@LF;&X)T}ZNqp7e9Se8%bZ%{WbNLxuLav{>`(NO
zbA;s0&h^ssQBOc`JqbznhQ0wEup45RID$G)wH)hw<Pa_K9wD*egPoAy6W6kI4Dn4&
z)#xGw=f2Cca`IkqH--qoX90HxnmD>c75nx>9PvO5e(F*820IW#Y!l4EeKlP=M8e&F
zW5@^Xg6FIAtm&C+g3n+64#Lsrv32AWJ0W)Db4vac)S~_t^t8kg^v)W*Cd;Aqtq&ae
z_`Kqo1oX<*nDgS?IKz{0rkpM8qTAMFGtNO$18j4Q<+y6u{v=%kNloY?68diCuCYGD
zx^9RC@{GsGzY24A!Jd2H8DqDv`iWT=HIG=w6E{Q@cHRl@2lpfd_mexsU4kySmk`pA
zAf{)I@0DwD#|$>+V_sN=Bi+2&?QgmMEqOE3M~vfLuWJs7gnpn2);tC4fDk-0tgYo9
zAeX>@#K`qf{|M&vyx6)x-e6~5@&P?c{E<$bDYgjRrJEt!66XQz_{pV46V!BF#?@AR
z#BUMGe}cMZNjKO+kV_3{1<$e6#|=Kml1Clt!4jvy^LjI7yK#(jsRN@B(r<R@oxbR`
z7b11+N6;^jXKbqypT|u)x&4Bg6=HyRAb$&buIpGD1GcI&{;RlNl}B|A`)nP#9;p7R
z6FUTJVr@;Z{t!G9JYzg-JcC=GGc!T2&*IGIu_*^eLJeTt3XHKc5A!iE^Y0|GFZ!#{
zE7*3V`<~VNx3wq6_FnENKK?%Ow`(Q-9)#={)%Tt5dX|p&_?GtnRoT_^AE|N2Gd5GY
zu?=b4Ct2gIN9pZozbov=5S$6;$sIVl6H_3E#$9%NEzc0icqRBl`2LX71T{h|-L)I+
z(8UqN8;_9{{6jDobDBE$mLKjI$1dfa#Os-5UD#~j(j)hWeX1OdfjyoH`W=JKvG~v(
zgHA5LHHP4KO&3!f(VFZDdL7$tx#h3KFYzD$eO#AbSsK4l<E+2M-ge?c?CkYxJ*;2*
z&Dn95oCE8}*Az!Ad4_z0ZHXhA-p2v&=FFBJ{C9g7ytf1F#1P*Eb*R@xh~55ke@E)r
z@DT$`96>&HwxF)(KrV3v?+N|i1HQ?v7~uWk5UUV+7dXp*8#wg-ufqF4{#!xl`ChP<
z_k4cecgw996Td1y8ImiB-(<h&8Xx&9*ybOA`0uFoo?@#XeJ8j59y{($694AA?Zlcc
z9X#Gwo&R`m_b;8_U!c}`(y6^5|CV<>U-1C;H{boa%y@`aU<@nq93JCqV(WVd@O|VB
z{KNuzOSm3APQhmdj0@XO#t}<S2x?K&^LNbyhu<y<<0*FHc#r>xBo{{Fv8C<ECFqe}
zr#QlE@ftnGM@$#wH9=ofbm6riS283a622c=M}B=@l&$MGEB{u~k|7C<`FE9>Fy0~*
zPmW=X9X|}g7`yQp*#tEg|CX+QQ=k01dP;QIqRBr*l=(;2rp^=0*ToV?@ZFfTE^!2V
z#hz`!9*!h(Z`tDt`)xuxu>a(dPaSGfdx#L;XU5o>k63bUmTc5yjwv{A&VCmdpY#(;
z4d$gTa|81*AM0h^>;ZTWu-Cp;_J$-c1b)L9`w`63viI6AJu`Mc^sy8V=;YAv6i0Y%
zp}+OO-~7td_&XdQie+CuvE(PtIY`FFW8z$==1j!`aW$5h8h7O9yWvRqes~jnxA}nM
zU8AXn=ML4Uzb4qr&VJ^;ha~62IfZCCL(ZLNtmiYvGsLr0pQ)uW@N8AcVT^BN&f)zR
z?+O2*nqvQ5KGBl%H}z2H(jhLE-WOJGKV$N4rff%eKIW&7#(PWp5`1Pf^$V<%aToZO
zAZ{w29M<s(;&u|5ON~>YHf+IO9qk$W&hx|lZ#oms1<*O4p5SL(A&%#Wv*oP0Z`^^d
zJ97lT2ev>m<}UfJpfAzI&U-_Rty<uEPxq9ZBV0f7H^-8^;kO7J(ewAnPKj-a5bm?7
z*V-4ox#uRGex^WL@6tmo^-td|VI5O+;k&<cUxU5W-iKJa_sA)*@jQ$K9UHz7#PXbM
zom~YRjATi6#RIw4BWn;xJP?bWm?@ZZi=OArIny_?i6uMz(<8A+v!z$CxAbGDCUtyo
zeAetAcrUFV+1Pi^U?-9HhC9HyaekcR5uCA^dCtfu8}UQ<%&F_zOFH#usZR}RZPD6)
z2Rjhc6XvMcPRtvQsd-CvV2BX(<-U9N&Hmi|vj*Y}c{|rc9bk;TCFH<Lx+KH{*jI8S
z!F7<fA(!YP68hy_o8X*hp1+@?`uzAA;yE(dZtPq6w}yLrbmzFU+&v_B7&|fKZ^1K*
zoLQ4P_(Kpo1$l<?PKc>-_#DUFhPk_lgy(_h<K(l)Gsv@8!3JF%;b)0F@~KDNlXza_
z7WB2m5v-N<vDP8jXM>HHN$;x5=fct7h_26>Asrh&YLLrW)n}7)ge^E<&e{09t0WG{
zsbF)Q^N}m5wvY|TG1O{;-VD9=BqY6NBx`x1#*hQ9aZ7wPo_ag?n*BD|przmA+i$yL
ziNAB~W3DCc{un<&Jh@$PFG6rnn&2LBpSV|?H}`FpdxsrAvE&TpQsWefPHmWC7w$FS
zcMLvyTLt&uwU(KnV<(mz>bs6>VZ&z_ci}!mJ=Qgc)--a>tQ#HM5>x9WehKoa12d_0
ziMiv*xoOJXf;AlB^=+*SxWB+%zFD$W@Ha7)N3E5hySD8i8}kDCDlz1LM_0@f)CcN~
z2e89=fO^ck6V}3-{w(CXR+V)Q+p*CTy@g<3X2JV3GKN^Q()LLX#Y94_THoVa5>MVr
zjwE#TYUulB=l)sVevf<Bab3@IOZ$l@cfWwI@)n1kxGtD$h!Ay8cuqnLJ#$CTUQebZ
z<Hl!>*ahOdSOvzm9qBF4l=+zVB=ka0u#0XxHsDT~r+aCiYdDA4CH!~Ff4ipsW|<@X
z#^0ZA`*-7+b-N^Z{3g%C+)p<0tDW&p^`qZ@#&^s;_PVPa`VMJ!(QW%ATYjIlWWFvq
z7w!P}Vd`!m8FOwvFXBQl269Z3K8Ynq`P{Kp@SXF$V-Dh&XC&kr+bppk(KQG2RIuSQ
zj@hyUy@7jO(v59ZvPRZA#Sz}CTMq5z&i%(ne9gfR_^4wTW8Z?`8eJUG%I}{oJ=*UK
zNwcJzlX{itz`Ly{rtCLQao8MJ{nR$LI}T}EmDPXiTRDKeCnx*I&U?9$EJ+C7#TBOX
z3ce8JHR0OSUCEG)#Cwg+Ea`9reNh8;LS5<`#-_$#BW4MDqBoeL<-0=O5w?6cxFsXs
z3oc0*ycbN+u^ln>j&LVU?*L(ZV96K1{!W*ih58P#{ia$ML*qB@SdYJ}NnEYzyxU%5
zcFC!_W3bt7{g$KDsQMjuk8A9$*Vy=%_E_{6?Ee%)ZjG~UJJM`@&d#Js0^==0pRprB
zH~5HY;^?~r60pG*j&**O_=qESiC$ogy`>+$f}LDyP;-eRI-l<s*zpe$$yP2<qX}wv
z5ij6_C5|BH20Q+qpkp(R_ZWW{A-2AU8OGR`IKp{Tb8f*pSkDn&>&!J{!$%x><hzFR
zBmInlI3R9`F6d?O-B29;Zkzme6HC8a0lg>aL$<Ad&zMQm7+VD!IIdsuOFqv*4F8Tk
zk|oKw<`83;hx`gQXem8j8q@osZ>=wK&8*$)XAcZE_J_UNg8lOzG6sB2oKhpCvyZ?$
z%*VXU?_Q80+Y~K(p$4^F(>ikwaSDvF6AR>a!F<%KFhBD!pL=MU-_Q$oV#ud|Y61F|
zjT${`AQ@v{@-zPy^aJSb2|sn<h*n}*!xG$O?(t4S-@9PEuw<_gSI1SyXF@u2AZ=UH
zPty4wnxJFHKSUH5SMX8SYha9jiBqWcJr8n=rtf$|tP5=T?|8;tFb8utalD_BK8K<G
zX5ZO=?nH2IdVYAWHt(!>KPIMho;jW~{M?Bf?uczoI?SvUJg2-1<NcW4n{~1Np?J{*
z@9SV*bd7nhXO{Hu7$t^0YEYMXLi0BDu;@i=Vx2A5#JWN~13Jv4Ngmc9$O%Dy%RQo=
zVV&$3en4*mJD`(K?ZrOjGc|Pv5P23nM<e&p^CIbsyea=uE@#O3a@O3F(0BhSPRcIH
zy}{>u!QHUV9Sm}*!Sj~)#QIi!=HSi{GZafc^~N<{({GJYU`#LcKrA`1GLIgegJkU3
ztvTG=*1Yt{+^fKN%6GDFdTrw5UUo@fPuZ)jJv-XFVBgutJj-#N(bPHh1f6p;oFDN!
z&ylk<UHTJCcDQ}m=z}xmtm%z&H=HqS!95uQ$ryVV<iIN2bsUEzZwvN>z2cnNL-z6r
z&bBi1u5cbczbZLP&W!Wh!tc|9-<dyPlyeW&q24ICK6isy=AbU~tmH@n<DP`%jeRR)
zEl(LcCS+r-3iCq~^uxN{Z&T0SBl>sWQ!zK>zTw!O^+VE76R2OYy-NF=Vu9W&GtZgl
zDFn|L_rNsi6`rwAaF4nO!E<=>+2gt6-U2$$Bfg=S3U`q)5@zOyq;ajLI%Y`6-^DIW
z=@tA(v9JVrJO{ut(S@I*p=Sw}z*ZraoX8r~ay@E72x1(EpZQrA`!mH6?C*F1-%>pF
z_<Z>KyizY;>rigb=e6-%UU0T%ORt3P!V`|EzESSkk`5=O$3x=~<j?Gb&k^nwJw}3V
zu<f#L)>;`F<9Dv(vDt_2F*ehrv$yPV7a@lBaclqCJI>;;r|7a1L+lacQU?jxjs3{m
zwiQc{U999tnx=h0w=bl79%^+Ff_~`htG{v|xre@sE$^P!z}m<opE|Q}q*uJITRH|i
zeeHxkp_krQj)@_j+$nk?ijJ@1IAVbQz2?xlOs$VKB6nfPw*+TM{Jn1K&IFy>fb9r+
z9oe({uJ$e8z1E|(0_Vrw-h#Vc!3OxD3368MQ%FKDFjwt`ei&D_#z5W@r@$C{B{X&p
za$ML)T+O@nCI2a~9$;;-U#On}j%|vqwVrh5>mtNc->l>Aot$%lt-lbm8`q+4yTE2Y
z(mBYUEJ-*CYy5=cET{5JmtF~tVQKCs@J(?<os%(k!`Rd~blZsyF&_57wyo!;i?7d@
zd`@RRe>{We&=T}eoS)4j9jGw{^_u3RK6CekUMfdpL(fC(7w|z#$m<2h__nCeZNL7G
ztsI}r&KR1$hy4`itgO`~{|wH5lAr1kkN+tT+euiD^;_bb$(H;xguW*m=TozZP7gX8
z?gICNd&2#QJg>O=CmyhKmLt!bv*u1wV_kO-8#TfAj``LFa{{%jTVk8y6c|G<*iT<T
zkA|L&ZNz}b_`6tw{Q>sMc)Vo;?AVBhQ}VC_Hp6%d&SQwhZ<vJNJTuvnttm#VLg@X}
zO_$9~>E@)4ym5@>?XP3U+_J{-9;}Yhv6)fyYQt`y^YLTb1>UUz@75|yV`Dpc<TpXh
zDMBpm<G8?fLu?o1!6`a+z;2Fo<^tx0okaF`BzYf*G>jwv`@x>?2l?*@f%k+h-v#nM
zkpE^7df`aF-wAHL1AHTXRgI)e!b*-LwBMeYvOn<_|3~fj+;y(4xqkxh(1=4;KIP7b
zb=~o`)|)<ZPUI8ovNNvKoHsi$)ps<8`hC3RXYY{YbJ&DFdx0^&Cj7ktxfAU8SHZbm
z`QUMldD0y>m2*V>?C0~}Z0Qy3O^`!wPeRi34E5I%_g>d?uZdW4)&sS!{n$J&lJOhl
zP`iT7@l&}wVO{9hpr^!!kF~EN(L;aVjD1aZ@{i_e;^;RSzs*AMo9&4vdxd{b;rHy<
zzkBj;pCYc`xWqfI%ZK0p4#K~M9R1trEHI`HF~pNgFI&(Xl5rFGkbn))u`kgRbnIJD
zV~Hc0?yS!o9h<Rl%g(v5Pwcf}yac`w)NzfjI+f5EnEwfU#2?{#sRz_%jwOy@e)KIL
z@#}&*%rTOCKJ3^+aW~{1^2@x;9XVf<eaR1wqZfLbWpBJk$Rj^7CbE|2z`qs8edKO}
z?`qHQXY-QStM6$16PmuK0pHhPKM?w^W$-(;$|k#E-kG4=PW(<>@0MM2nN_~y9qEkm
zg`ielpXc!0p?Qb)jeYdqv)?24nse(qv!-)jdaiih{H}!eAYEggMV^;W_ajsTxIe_5
ze7<;IskwNclJ8sUe?y199vHIm-``Df{-KzpOGdK)uDJ?~0Y7m^P=oqk?|A5eUUEHC
zJp#P~dtg`t?8IYa6V4&O3u*%Et+X=6Pb@jqpw>>%v7M|(4RW0yX(yN1rM>1Hc_uh>
z?nM3W&u;+6+!O8^_XM~z*oa3m#%~xK;<-m%`1wO`S!XHs2!3|}^C7X}i-g+LB5#&@
z+)JQ#$PVb(TFUCPAK%w!Lw@G4hu%N-rwjJWd&rq{j}Pzj@*Xzc_vv0#xF=5#Lp*nA
z3u?ehjwJOBW3Yb|9XoMTY~k}=I%|5S_gOg7pWv>%!CveHy^eX-56`Lgjy+^Ad!8xh
z)bs2(zZ-lZhy!$DICJjX$lsd$&g3_yVGO;%?^5Eoa$y#zcd|D1(eX3K$~kJSs#BMk
zaq-hU=Z5m#m;0d)LtkA);{Ct|OB_Kiy;BR&E4Ei(Qw)%QL)|yJd?Dy%h?byZ1N+gj
zH*s|SGvO{&LSvpm7=ruaza`wC%Hs1#3=x7m#@`p<&LOekKf-^H(3ij-VwM~}=eV;`
zU~HE3BgmmP`P8Xk1N_866XcQKMI<~oJTL8fZtN#^U0}1{`P2Z$_{d?-ExLL+qUmq)
z6zpf@{<6;};T+}zTehFT*;Y7jSP6H5JM$e=F>q3PY}sWGL2de_|50E~fc<937J@wh
z?}x|uR_1lpuAKA@NfXj5uDP_|Lwi4U4qY7Kv%uGKe%DzKHR+8w&d%pYeR7U)Z|EMg
z9~ENo4M8q7p$TdRy{OONzHoo^`48Nsm3N6Xu$G>EkiSJ_-6aXkVM01F#6nAn%`r<c
z^hdw@g{CtGVouhlhHJ8hCFspChLaM#i%2*J*29@}!P;SpbMdt|S;uQ&Zo@k13s}n&
ztgWttn3^*+t}%`s`P?i??t29r5Yq%TsB7+i7%wqIq(rYQjgO$#E-<DpK4M@bA$eop
zlJ5v|YrU#Z`HbzX2Uy$s0mKpS{5R=&`n4ANti3wUb*OD@tCD!e$V%53*aPr9RodrR
z<ScCI;Q62ATa4{h&aB-f>)h7e8)IUK--3C^#ZxcUMjrV+`83BJH#Gm&bH+2ra|}y#
z;pdlU7(LR*Gf7S;m;99+N%!z3nSYDA&ZYG}G4ehTPd(-d!Q3O~q7J$BneBRp&6E!3
z5AgOq?Y2|5CsB0U@SAEwxBW>v_LIExj%va#xL@QbEa`j?{*L|<gZ=hVlX*Jxb6z?h
z?h*{0*VozUoQ{~;Bk}ah7`nj!b)LlLc{k<HQp<ObIj9T7-Zbu+m>-~5{7CDJZHw%O
zzUU9!tH+kaRBR`H3)VZtD%@v)k2vCM4tWMYFkZqnIFl)kX!=by#1_%icVS64N4jah
zC^YeVD&+nXgx+OUc)#WGTRr=4S#xinYuQdLtdw<pWb1mDHebL8#E}m}gkT?<INGlz
z`bB7L>|3(INyw)T^{Bg2GTyQSe#02w5%jzT@BhC38$s#V+%J-`-w#f`BRu)v5DvW;
zG`u5>d`HNCFUY&WDRy};$bS>~6GHF)po@8N$`~EmZ|dU(d_SSqa?MY9Z}Zu{HE$*U
zr8WIYYMnRTwY%o{BP_+6r#$=qsyvzp_{@e7Tc5pr{@!2*VxA!1*zX)_wTq+g7`EZx
zr8aer==z+WVvDBF>2ZM#9}ov!kh`*<kfb(qFy~6pO-ny<;2h-0TGaI%TRM2$rNdEd
z#dgc77<zW!&hZ?`_y%Gef231mm%6Tx90kVAPY(I4lXcfU>DrSJTff(aX#8%|?^QFU
zcYeQKEd92{hHr{fV2nKkaW|vbh$H?8=B_<p#}AQIox0R&iR(INDhH0B?iOCFb=H3b
z`!WT41fl&hjPW(G6iW{IO)!`HKt`F9d0`e9kL<-ggz5pck6<3=+X*^0d|i-Foh~Ao
zlGuR0hyirNc#EfbyjCRhdQRp=$3Daor@+_@=@r|nJc{A|axb~V;Cs7tUn@gne1`E7
zd}n*2^BwMiS-!V5zNbBKGRCn;>-HgUTOHqZN6v#ZTYB)F?gBe8%+UqwWZmqO_X^ns
z`^g#kK5(X-Eoa{a&%xAtiNX5{y|-v$3&vgcEx4=m;jU1_bs}pu#gaqr;{8X~TzaR{
z6Le#nCH9k`V~-1LW=TJS-s$-;r{-o|^bPc8y7ZZxqE|b9d`<fV>=&}eJEq#YazZdC
z^H;C|{+T$w$?pAP&%6f5GWQldi#%T=pNr6$bN<|gt~)Xl^e>xyn`b8P1@VV_B70NL
z%Dkiarr!zsV({BR;HPE?a;Qx{k}=?`{;fHfhyIr4bRXQuo_BKad7(8$eonDY7`a~T
z_>X9c1$1mnF(>z$^JdS62*F)|Cb%2ikq}$&_y+I!#L4&0ynF6NXACDHmYkhXr)SM0
zd9%__3@|=|Ug&8HdZgDSPBOIyU@hDS7-GF}Was|OWJ|Jl>`TA)jD3bJ*n92+cY$-M
zccGpkXUh3DQO}b5!<p8+sk8U}34UXW{sKPk8F%X_kKA4e>A?JkF)>pd!Cd5<E!|*i
zg18!s-@Vly?s(@RXVN7h68aj2+9$f>Zb=QW-Qy{nInoWbo`mFgxR2UfQ$N5N-si~q
z4-qfms}RR?3{!BADo1yV=Q|Sa8*uk-?6bt*5<lbIWA5`PFb>)A&BBomu3>4r<y1@;
zAzZtuCh!d1U?0gUI(8s_ie6w0TaZg0^D*xfN6_CEJdf-f`?y6t3-*2`N3vr3Po(qw
z-1;t5>3ed^QSLeVy1>>1wWvSxj<BXx);7!fh;iTOQLyjGW~gg@W$wrv_6(@s3ZB2K
zhe$@=FV2Fq;WHG_vEe74TxwC%xHdjwI6H_OFG+KxgKKQniLyp&;v>F`5Y%dd`_Tn=
zhQ4Nk&RwEU{6~zOzs}{_)Ca~pB|0=gPR*k~_H<ofgAmjK*Qj+?Sxe-4=nr=GiM=O|
z$45*{Sl1iG5l;>BkDv$osXd`@LElSoe_*COX~!Q0#!H-}=56J2&rL{wf;i@Bf;!ZL
zo_K6q$WE_@IDAJ?;|YAkbn&%L<u}28Jb`Z{#E0^L{3q<Ubj(ux5%e?*wMYEKnJ(Qt
z*+Tvb{Tb}N)H>3^^LhLexk{by^!^a*IXw3#=~zq0dThCJo-P>)y0Hz3Z6!z2HD@^o
z>-IfKa;ei(qQeoyBMtU0LU1NSv}Ee8brE9enFO9sBsTm<5KrE|peD87Sn?g=HOyS+
zmV5#~@yx@#Jz;+4XeIA{Zik-b%F@^z=}-83*^>|3Dh%mQIOfTR4ZnTp72A=KRNK1Z
z@9~izybk0nZ0W#vY2bTurP{53Ctb6vZZN;jg}cFB;k=Mv=f^qfyhg6Uy;`oc<0p<f
zAx_pnQWsknt8k=q7m!cj`-F4WRdXtD3wm;YM|#EfAv<_{GLC(jKiGHnkyz&;YcBqZ
z&t>Qgm*DqLznB`groO~}Ab9_jbV*njM`P3Up6U(9SQ0l2HP11Y_SN`Za;yDGCpPqM
zY=~80Y-~TW-PkuWJ|wBx1U+^UVrvgag8m6|$fd><)B|c8+p4tBawvX@lc2*Wgml2R
zMAtjS%H*A5{x^k(cZK=i4)Shr<$J-VcY-tjJHgPqyj}jA!D`1h#3~%=KcVYgoSD*p
zigP|m=Kth>n`>Y12N^fLAA7Rf_sL&lh<ju34(@+|r5cs^zq$)awWE)uNj|L)JAB3I
z^R|hjzx`A61RdLuZ;Rk>ak3<hZ6O<R#G59a8bH0Ck}*EVZRv(Ou*4CK&-}tHIx$^D
z;u@B=6LYiDhJ+*TdA8;X{w^d-@&+Gq^hFJ7^^}aE)~!0eB|;4CLA$_)uP4O9Nop;0
z+a1>x7lQqu7W*Dz=yzI6&^?~|je7X4nk>oAZ&^V+(lPje*hq<Pn<c)j-|4f!82iZh
zBMB>|$CmT}jv0!BNa^uyTUn3XExcwVYhHr=sP~b*GVEE)eVe&=<N*0VUH9hsBl}{0
zd@~`og1r}C%i3LYF`xUYJ>X-0V19C3=RC}ZpSUH+bxqdB-QbQ)aT0XsVkw3=K##QJ
z`;MuYBYa2EvGoFD?BF=$xNr>d_J^K3=s#pB&K&7Y-@5=E?6bt?n5noM`>MQSp2l0X
zAoM*CJa%l$o<j3)?E~ut_JH+w_CRNGbe<ua?hp6u>(1%9YU1cU#7cTfY$KmLV!_X0
zmwp7bkSl%En#v1udDo%$AHBdk5p2-pH@4Z2eGBSP?+Evaj?HxG!1xGyrcZjLFF1l;
zx%Yq$*d6l}w-p2I8;s;0FWFCmKE%xW!QAwt-d3&&onFn99trwayz;0)y{YGL3(gTn
zK3l%uJ?|cOW9g1`eeXAnN8TImD0hUs5G(6&UtEJbcGsX5HhkQ-r8<$dsE2+8zA2Cf
zdl#e3%NqD>VV^>HpOLJ&<=$~V);XUp*iX)wJz}qV?i+i{z2OdZ!MnH+ewR1(P7j*k
zecuvYM6&;(*u*ycOPqvUpw1gxKEQ9CK8BztdfR#bhx#@258MOR1V^w=*1HAkKY~3m
zj91#W?7lDDk*{Z8`_A6`oH&bBU>p~>ja+KfI@IuaZ=H9&H&gdzCyn2lVx&a34@oR^
zadf{%-ZN@erp90!^ASr9xvo=dE%^*_j@gO_kGpgrregc;b4}#9sJ`#?que@&b?oq#
zKdw1HjYF~Q8GF|R=f?T^Oq<RXjy?}yC$`@bzip1Ka>@@~9Nj_gp$X}R&oh`8P2;1_
z1nzOAYizKe0^=L|tKBwawRepnE_j|s;^)m{OP;?e`UN&}wxISBCt;1i+P7eTmSEr5
z+acCPT+e77JC;1tif%uWJkEcLlW;GrKS}&G#^WLTjpMp%(~Iu{_rdF<5B#(AfF7dB
z$6l~6-WzhapdK+@5D(~)P?s2L5D!xv)nkvFYH}8w9p?t<*zkp7n7d~#b*NbxS-;k$
z&nfEpGNvB$o~%g@>;mI1n3vcP)N5If-nc{b+C`*v?;-yZo{u``1I$%n{w-Lm@tCz5
ze8lzwV}qT!#|5^^xyHnYpntEKeMATBJ0Z@Hx5N?5?LLrOcr8`3mL<3|NBAE5&Q96z
zMS(GPIE9*PedP1tG4bSe5ef5Kx5U<j*U)nfL$(@E9YZcYAg+m;PmKz`{Q>fg<H#}C
z>>oKNawT3%?F(OxZ5o?e4;y3S7|W4$mgINTKC1pH&vAE5UCStQWAAyMmQOZ(M|p2B
zA9X{_-0PN-y}*7${1Qh{ALa}8S4kdFV<hN~xog=@4)OFwueDFxcpiJ=XVY=y5Eog8
zTEO@T`<MK1gnOaKo%mTpVkd40=JI^xllzq8{89dvE$KIWk1}1lvF(=5$8Oznl)2Dt
zzvWXdG0s7nCcR?&D)no<+HWuGnbOUX-t@h=GBk!=u<a+ZWj$(lL4TZE=#01{EzgZJ
z<Gk<_2T}04Y#UjJJl8=|7aQl#JV4#1cqCx!7ud{}euJ-zquK@=anz=tCFqad-?;r#
zu}82^bw796Z*=^`brH#w#0L1E7^P0=w^&b><PoiD-N}{&-f>li#%4)BFZ6uJHOqT0
z-f1zebdAlM{mD=4F165~XnObchTn|^|9{PdcV&PN+BZ1PvF@p>ANGbl8VNd_3u0j=
zThcH;wbujm%zL~ec$YWC7Quh-C(yCs2XyR9^z?t(sjZ$`lhi$cEu9|l6Fc+$;Ly84
zIHH&Lga41Uv%8WW*P$!k?I1V-I0uHpP#6kBVJHm6XZOWfhH0s~dafV#0*F6?6s4+a
zt#5{RgH7+-V5GFpcqO5CX%*~sjNX4?%Kr^_oo{j+b2LZA@4<eP&Z%+O>KJ`|!G4Ir
zR{3k4nv3rDf=I@$*Q6Wzp9Qb+mZ8u8k>A~sOYoiGV9)1q&u22v<%*x9metpJhKmq8
zKO>OT^cbJ9?JtsA^hv*FN;ge@AkJ**%-O{fCu#Z|;Papod>-Uy1D_8bTk_cf<TODo
zYML&+5;;Z!z0g-HFos>I@zrjf_$E%Sool%Do2-k&Z_)hC%-FUi+tzQ>CJukA6j4~x
zvEz3P{=wfk6Z9>xcd-gbx^tb6-}b4xPt+XrEkeE0FTKwM9orE20euyYba38Qj?Z{#
zub?OB>>K`;`$s%F*zWPn`9t;T(S0%=g;nM!$8_lx?5@pR#<rcg<Q&zcZUq}Y>JUpF
zHI`tFQ*cH&D_i(1E}g?le>kJW1G&aFB(=b~mMd#B4ngcweyxSSj;)hVoh44fJ!iNF
z!DC`-taFex#&&Gv@1)-MOZPsE7wmtNcOG%rLU=w)dT4^)L$LlPxPDwuuJ6#bo;q{f
zOWafSzG|`q{!kpTtAK5%pEz>62*JG!+}BMU-p>>mW5>S*Ipm)Ny%!j}7v`+<Vy}7D
z9X~Uk9QTZl9oh@{w(z>SC+hvceeQdKeI3_%!`8W1xOcQy%)?sQhrzob-cgChJ1g;H
zm!EYL%e>6_lV9#V&$+mkc?L(GwXSo(nc(+8===T>UEk+m78sxO6ZiA`A#=&E9F3dm
z5d-M>LohEr&<pED9?n~-fxZ<-Y`Y-0Xa3e+{XApXXRV)W&VF%5n&8a%+%UF{eG9=J
zvajr?_qJ<)kKV_@N`|Bf>9F;lZzfIB@ZX&UkBQldbE|ywjhuU>Jd*SV^h(e4zC_nr
zSkn<+=g@k$;B0Wd2WLreo_oR>JECd-Lg(cOUlaD2>%ukQTJ*d=M-sTEhVc?zgdiRX
z*vyiC1ZTo$jWboxoAoMZo=0pxgDcPCkc?!jE>NF&m=Ai<vA2vNk9=4K#*t79oU^4n
z9{E>X7fCH+JL6ffAL$t6$o_15imSF+=6bT@ziF}od**!%>0DpVMH9XsBkxJ>XM@f5
zk@q|2tAgFEl8dbg?s1-9U2s01Sh9!USqt+4&Nz1b#8$B3Yl-g(#@KhE=6OzHh$YXg
zyvKTxA-!TBHttQsc!?uC|4`4c9yqeGKkO5G#@?~-{leFy$~(qm$E>X9x{QfAf-}Hb
z;7oLZyw3-570wKh3tKpk8pd_V4d%)|?)jZdolczgg6AF2L!Og7H=E?ovr^AP_LV(k
zJ=CQh`^R4Y<nbAzYr(#=r^FFs7-MIiNYJT)edALMwdrSGV1p2@Nj#7{#mc%n&mHr4
z4*bNm%yA7%>fm!N`XZNFO|bqDLu&-qijDQwIjBKR`lR0}PD;ihkT46jz1c&tK<#nO
zK@L9bO?VBg85m>7Zy1APyJA?gVLVITQmlKh#8&O}F$MAs{73i<bN&pr3U;4U&bReD
z-edcb*hbPMKS4kA6@@Mxu%8QTrb`dOK8!+>4z?}n-{Kt0ns-!(IiHx>mwm+EP-`Sn
zbZq!;j%?JU_P)SYss3tz(z|kv{rjq4$HXwUME5o2IzQ>QSvsFJvCbhv_#WWA17qy?
zmpG!Axm~ZyQO;Y{m+XM8iKiZzW2!ze!~%Lt&^;!fUg(KDK=(MLvxb&y8CMLsFvU)Z
z{t4pfg&vmheb)1HhjHzXc(~)8_er|uR82S!`1{q9e2Twq)V;Z582dY%<x`Ap^QGof
zkJUExJrVW;{*K!9ofTGcB%iSVP4=vV48gqg%{Arv`y8Qj?Yexd&pjgB3&e%sx>LvJ
zuGX6J1F?YKMF@IePQw^G5Hl~Z)f~rTukrLt-}?evwX+}IpCuj6Mbqynz}^KlUB|T|
zefVJ&j&z{LOtxgS|1czBB}WqaKmTD$!Y(wuJE{zgVI`q=PH#Bo-^yCIYo0fze3hed
z<2_k|4%nf_{-$@uKM}HfT_g7dX&e3<>Kx(Twt5QQ<rTVgSmKDrJ3GOD_mh9yx5N>h
zcXv77@)PHHbdRYuG|$X_xxTB(CVsBB?8MBRgZk8-qUl}W5Gx72<Lk+kyg9Np-jO9k
z@{K!YE4C7PZ{;z19ozmS9eYb+pK9E3U30-I*!CA$^WXGS=5S24p}#?V_1)v@d(w%A
zE<&(BBWWqI0e&DB`0R%zLeFC8Vu~Z0p3yMGE(Fh9(G#AjpCArD5+b1{wVPl*U~cFl
z68fXhsox!)-yZrch1{a{PY$_9Q1gbl%$80sOB~Uz&yD#oCgut9E7a^FE|`<~o1jN}
z?S+sItQXMjpVBKwV}remNYE?TsW$|B<~>~eCKX%1Pn%f$Ugd9@qKTv5^DrO4P7JYI
zgmO)n4jx-#Tfg||V~WVW(6OD&B_FT>e%J|lz`B-TtuxOGYX`<%oQxsPV8cfoOu@Lu
z4#h-*Ucv71k>0XS<o<IFd@YdYg6n1*{t(nys?|jlupL2<#0^2tNvJgoTRLYCIESW=
z*Ja0N$iK1Aa%BFJG}v0f<66sp+h*w-9sd&CQ&XH5@DW2SjFisBchhBqDNccVeOzpf
zZyeL|`A}=1Q@1A}>AsqJ1J=hi3$9yU-=Xu&neUwUywAATLgSg>H%;;6{04F4bV1!F
zcHZAz5~jcg_=zK)Jo1g_+Oh%T_6Mjp6W6AOp;nD?EV5q^NBmB>PrC5^$NsX<JI@lb
ziy=EP#8cyEty=fc-#3H5aq9gKatZc^JsH}M$oa@yWghA=7xlT$Tz9TNXM=Oo^;=*i
zN3!XA{uEn;zT*$EzJNH0gna5i6Vzs&E|{13fBH~Q^yp{CRG*wld^bln)1{AcR+nmo
zVDH#x_Ktm-xp(Z_6iu9bpT@XiAO0tn>`!#rLu~!+dGPmVaq?YZmozhN_=($sJm;hT
z2C+*VLGSe}uvX4P)4E~hx%k-&okO1u&Ig=4C+yo1oDuf4o)h+a<XMTleq2l7x*EnS
z{arE=Uu&*6wUF3|<!o?XmN=rf|9}qIVI=4$u{|{2szWV$nGZcI=6ir1yEtMf7xo1<
z{PO|q&=g~cH~Xr^*uHONE48am{-<&E{kOW;-?diuafnvfx~|-hM`tGl=cvLx-4f0j
zI<{TFhVP9fUl);V-RCeaxc@oVQ-oML_cz#~U)=U7Kb!*N{zAy^xyHl1)rbGae(EsC
z6enSwte5q(50#Z;BpkthR;I?VQ=+$oc!P}?U&k&VeKhqu^-KkHdZkBtB4_Bja|SpI
zJ{#zOowKnLbih6n;(%PvR|OlsE{5{x&pk56J~P*G_&Eza19`4*J$u8?VxFCPPSXEW
z9KHP1Rs2!><Qe-vCI5$VC3#l!c{{Y`U_WwxBs6Ns&R!YD_^3;LL$APi<-8$jM%wM$
zIfv_q>OvPw9Krm|1&&8=330@S__<!JleLQwTuavWvp$XS5l7w;)S=!M?$7I(x%aoU
z|7bnHdLp5Yp)Pn#%t#!6OUEL~ZGt}O_Xax<L%i!R%>gHIzu!vdQDY?Na0L6YU#Mq%
z<yrR`C-03e-_2Vr_B*!82KcPgtD$$(rH5e8U=*5kQ|;F6L)x~bKfxTpe82H24j=VB
zUzPW~#MW9%<5OS^T|`QBY`<|7Q}I6k8|mwWG}Li@dg&qr>urLwK1CNHmhR(`pyMN!
zyd$Uwu7ArdpNV`9d+gYjJuTIvuJ=1~4&t1HWc*}nvbzR#tW(D|k&LS!-Qy$OP|y03
z-C)C4dthx(Y{h|nBk$K+;&<#*{K`BeoEP|x^&8~gF>m#l%e=+dUgNA+>9{KIKBoGA
zg1Bnm8uPt$BunyJoKs~}J~f#q*jruW5I#3uIySD&$h{}_X3Az*C$*Y#$gj0#)^R>L
z=;SOhGMD)bwXmPWxt7>h#t;XLZ;0Q5H5<m&#@;N!?<3QtSEj~*Ed)8#n2GCQcfGqN
zc|Z-A;)vFiBX$!1$e%1pbEHGlJ1&^XmVD!W|Mkt-wWx0$`II~K?y7Rf;9KG(o%di5
zU?+yyQDBT6|0jqs<d`8n60ZRp{v&ElkEiBpyt5Nagx<^bgm-l2NN;*qw?*)8_{0(?
z;oTiNHV8rNNXVrI^_b^pey*|3(9v1$qH(@BBV23s6^bRltJV?B0aI)ddjB`XdV%+Y
zUGI~gn6kr88t<7dMvkjQ|3tfLFs||Uxcbo71NGn9-MZsl$7AFj``g$#Ra*ZoxBoBg
z^Tnqe>W)H_{)Vp+vc@?7@ckxfdLDzvNZW?&;4zZ%7QwSztmH^S<6H`lEmy{MNr;46
z1{?Yi^f5)hz=p47968i8jE!weHglxY-%djJ5O_RgziF}oxo^0BR}6S;iH)_<_a}z@
z#6c*>*mldIxSJ-M_b#+oL*G^T9m?-fey2|TM&)mrU4+>Btv<xjZ+U*tSFpA86GJSJ
zN4{&gPPN-#CH^~xF*T`g>KsRYdftNmN3x1UKLz{76@$HUH166P!+3}g%*VWjF}@{^
zAZLm#8ovklogmoro^Tz`1K1ry4*Aq%j+J}FzMwbRLcUSvB|cPxI!AELp`L}Uv9Y~n
zT$T1A-|UXrS@Vu1&pyi<LytG~4%o@RA%6?*0q&nwI7P=7f>?5%!1qLr#ZN72`<{P#
z7T{lkSaPU=jI`l1j$w_#I(6MRH%r%&Ys%T;eD`wAx$caYID+d>TxDxq!PgRUjBS?0
zZNXWh51(E7GT7WBeOAbeggVq~f?f@Cqj$l5Y#8Gshg?8!0=rp7w+)HCf{lE7qUXaJ
zbRAY+3nb&8GbY~<Q*p$T%d@8I`8M)>An$>;V9Ya+zL}5ySaT;&P$N`pQBT)&Xb!IP
z5uBSX_)O_yi6ff6x4{&<5c>W$9>8v&b)<8tLtX0kBqW)8<Y!gTk9uQYSUaF&tNqgV
z6xc#6`C*8y^>x-r9_K>qAJ_HzxenT=5Q{y#V4s`V+Ee!X=WoEd=j`_rTnp2s^PX;q
zNO<R0!H$0k;<sQP=3{R6!1(9-%1_+PSZw%qiC@ZNO;fN&*1hvAa30pfd0?;DU-pl^
zWKZFUr?bKJgOfB}SK#_?;cJf$*r64PPQGjP)Uj`|bZ&Z6o<LTPeCEkc?hqknnTI(d
z;mm=@_+W`6=!0B(0crs{_9loU-qbu|%$9y*-*2+zT$apnV;^!B7(2GcSifU!|4mYJ
ziJpWc_b+FKGc)u2aE44s2hLc<cKb%&zdWP3?^l8QITD_oz;lgzyu$O2bKXS=&Oi47
zG{Jqr{ZYXN_=(#I`9Q6e9LYLg)$tj}TXy*%3XInS*sJeoY&_r0^>0b`h5cC<M`Pd~
ze}a9!?Zi`Oh)Btp*rw~lH9}&eC-y2N>4#eQdtUn~c`mR)PeKwrp3=>cUg3-x+q+^`
z_Ql-j*zglO5_IhJNZ(w4p0PjAS+2MG-|UBCCUGJJHCa3R;q`J(Sa(wn`#_!{wu>V>
zKJp?ZHsahT^(*ua_zh#n^s6V&LtTSy78qBSVj<{7{j&yOZQ${Iuy5H$&cz&CH1!Ac
z2}jW98~B0PkwnpL!w*N)T8wXqgOP+Jz0u>zep$1@*0O(M$y?%xI@i=X_6Imq)lYn-
zYfN1j5B2dAzr}r48M{6)&<pfhslKY$7<BupeaQ~v4}@abWA8Kj3EuBd(y=r1_Xo*5
zf5B^Tj%zd56ZTi>T%_w+Vtb3lXYLs1FU7z~d_Dduoo`9aAwn>B6I_EOx(M-e|CalD
z<~=`TBZeIEsda>VnlI-LKfW96Kn+993U<dm$(eQSBcA+`ge2>n1;+S^JAzzf1)mwx
zAyQ&Lf;`WUbRGPT!R~u><Y&y2bj(&fcwD7@_ETpie82K{t(m%|?Uo_`CtR~i=6b?0
zPrg=i9LK!$F+XtRgQpn#>i5r~@34PiD;}KF@;h+Xob=4K^O=dfmR;9m=Cxt1k^Q+J
z<V?CG>!lWXLp6N<s7D?Ajz^LcnMZwcch2c~vEf^S*a|j$&{ATnF<m)R9O1P;$({S-
z-!sTAR)TIqI`J*{klN_us!`*~G1!+lNo(p+Y!UzbhatHV-UUME-OvNP@A^d3`>)E-
z*i<_@b#5Euku1rI?cYjrBj54yo(oP&^e&>n82b(O>N_RIzL1Ui=&cFw(ainAhM%}8
zPU3fhySx)zyt@-e@IDWw*n;<cFbb>awqvtBq*q3csmZ%PdTQ#k>$(TmUeI@!9Y1m8
z9MSbY(D?me%lCtRM;Lm4WV&>iFC5vSzHhp9zkhm?ckFNDPxC$1f3j`8L#sT++_oD3
zq}O+N_G3e@zHfBrKgm(v1%A@o^`4N}U2^ebGmL}hH_!IMl-?e|P8>Od=e0PZ>zO*m
zE;OEb7u8R^>C!9IG|W-4op|S0S?m0!lefjUeG+TPHC_5QIR2L3<a*ug#SrleTqod~
zHL>`9%6B|{S3Ua98iL>9{Ou;h)bIJ0pzj3V5bJ?Mo`28t`&SIH5_D{ppWptnA%XlZ
zsKq={SXrMs^b7rkr5NI#z-RC`!Mw}~%)bS8;yf3UvGM#<_9Gg<3q;qxvcE^L*H7Rh
z&imiXI;h8(d77X%)*h^1*8$M6;Twt}{s`)Y>aLu7Ykqh-ANC<<Qf=r@d4ILln#|J@
z_Ml?>ll&A%&7IWVY^##k3O>e7uxDI9_L2RJWJ<P|eI?(yUHL$rBe26PF@ZhjpswfP
z8v0su{<yZ>b6o2t(1&bC;NOCH@|JL~=zzUKe5DmX@$_+Wotz;<ueD$1p)R$$pdb2z
zNVz1B!0#BwfNvBSe}eoin3K8bbAA9nalpC&{fMo#_}XxN(77J?n&Rl|=p9h-9!T$m
zfOkWTm*83iF@m0`-Lp1(ME$OMT<@XhG0*j(&%7l<-}QSkB~Q}yo&Jd-yTMOR6d0SH
zcIM)<i+TABp$E<%J&nAMQ~lDj`=;k3|5n^mJbBJP8dC!wb%--7YX-Hn7wiiR!T4uC
zbN|uVFYN5y%2@W3{bp~wh?I<t?K`gp*W~28JKo{l@J<hoc)E7XJ=Mp^Yv=tq*(-Kf
z0vr28%obeZB|>YTf<0kxy7q{@1N0Es4P$&wdmFkwTqjt`k>na0uIo<FZFgMtJFZHf
zCv3#_3vBp^TO!&sU3NnZvEzao)H2kjPu3R6ki^zY9C^kyJ*HNzL%vz17WJrW7z4Sm
zFKn-}E5^7^mG)IRvp(|8j&J`0F{WoN&%LxR7$OQg?@!Ls(U}6yRu?{R$Z?&&kRR?C
z?q|+2XPUD;63#k0lC#e}!2Q5|VTSZbxTjj)-`wK{+YPZmE;W`o7ud}0>*}RKZ?IEZ
zXH5SUY!zZ}x@;BvJ7G_jV842TUa@`3eiC%-A;_mrD=@}KT+8csUqi0(N{-|c_(O1=
z$#)HG(8WrQByg5)W;tg*YvlEki=DWA@pN99ho0C2uN}$wT(qlq^30HqpPZRcW943Q
zov6zgJ8|TYPw(!3<vNh(1$-gMrN&K@%`ndt%o&3D>BHxSGgQIeG6spSC+OIyLrvyj
zZhGm0zD|OUt%B{1BOll86GMI=hIp8wUxdahd-FcHSM2x=V}q?HQxZ<Wz1ilmdvagS
zMRq~`k)VfcfNzQ;$fb_i(ks}TAeNj8woee-#akcM-b%0IgHGJeb8zy!M4lJU2{0aF
zi6eT(b9Tt3#$RwhOL@S!J%Am*VGK<$?;H3H@#_Mc{ZG<<B&@{tR`T&hUKg%Ug=>Y+
zFoyYneIXw;nTz#x!Jf1C<03TPd5wIn7-J`X=Cz@o>%YzYWXDFHedv+>Q4<(rpUEjY
zb`#R?9DLZCV6F6f_dH8IbaG5&{!o5}n)ra&d4bK~JA!)>xIbaPQ2o{|n{ucH)CF|>
zd}ejAUcmQPLOEu?^!sL~C)0{fJT+HxB;RQIPKgg`X8F#E{${VfPce>Tp3YqKr#<zV
z;kx(SXRo8K;qK3MhU#!_s6`FVA8>Yl?3!x{;++%Hsm(k<9C$or+X=DI6OXIkzNHvo
zA6PH!B=kGx#y(5?hhkTP4uMpyCXVI+baL_i_$9ko4;<Nm-)U3qr2V71Vikh-L4x-}
z=14cZ-};7;ame3zs^^@Y@6vd8^#(CFj^*7JEO82qKSAu1ANw0qKIlnEg2z)j9KriQ
zn8NP_c?UO=C3!^GJ2~FVZPD~zuEM*zPb~Rw9N$VVG1##&U)Q|!1nAftPi*jS1+Vvm
zM`OPq+<H$4q4#}VtbF(9cXCK<)y{jR%GCI;)chyC&X4Yxs@sN~|0Vxzjjj2CKCJ&m
z-tQ2<$z`sVpu;ZMR%Oe0<j)@S{1r1nZ+gaV5qh@55=S&W%cj^b;Cu7i*A!!@dBa?l
zevKVpW2#O(R2%wjKeB;)LC(ZB$5gql+Fj!)FoyL7j{P?>%ADw2FBpX;o$I>ztmQi@
z-(B^0n6AIo4F0C0zt{f!&6dC0iY6QOouEUz2<0EKRcojwbpbsDcIIh<I9N%SG}x?%
zbihU)`TGItSBN{A*Hbd4#trrgxzrkBeZf(Tnfw+ILwgJCF`zerpIFxo>36U6d*i*Y
zGBS?dH|td`=7@67`o8t`=h_2yGmCE9Z}O?mokLydB82zBd%-@jAApXX7$Dw|Z?M(;
zrdYscR>?=V-Lm>!j~>{+A?|Ckw7<Z)!AG2Xrf>9~`Aa?^2Ajba*tu4^Z#wst-hWKJ
z=ir?O??JF}-x-gOY(qIw`ryoP&4Ie(1$@Ld;dRghHs>A1xKB%LOAtdWIpl|+mnP_w
z9^EJ7Bk&QkMbA9ur_N5$E7+L}hB$&=X0j!@eq1|WKO{C{h$V;I5KZ;mGd<Av4gJw)
z6ZBod2KdQ4f|`bYnTt7r`Q78>tn-Z3^Ow(zExNwvFTVSK0Dt8v7JnBZs5=C69L>di
zJoAU<-t>@rL$6EycY*X;*rz4v`zV$ia)JI0V|-nN;+o=ra;c?#3&HtCGT!W`eBLW0
z<C%0xV%XoFxkLHf58Mk+aG!L+`@S3O_+blbxt~ctqF%?Le(1j^=<bm|f5v$|S?>_+
z&(!)`*&p_rJwFA;75lhGTraL0*ALbMM>f;+dk^LdTlNZZO*kL9L>EzDjGb6=wuttB
zYGJE(`)q%bO*z!0HtS@)W|VakbAG{fLUH6$r|u(T?63>O{~KzJC*3u>>VIO%UpX3A
zs?U1Qnjs0Ef8_d_Bygs>2*G{HJ;_<*zT{kTZ*oRgf{qQ}zQBf$m?1*&448s@8;<UY
zRql_?^G?+Jg!`F$86sJ_rz_ld6?~2*ZwhKsoBIxWfga3}4(`$YB4H=2$7{lduO;NW
z-YxMN`?_qApjVd0)TRDTJohc_Cziae^&YLAJ@7s-W*?a25JRlias=0l>$Vd=hkOp6
z&H{N)xvpVZYb~8A&e#+9jQw4)^8xHI$Wb4xmuGR)^Evbk2cF|R|5<m_T1V-(KdhI2
zv9l&(gSxrz>??c5-Z58{JtTIClg!*hdi&|Gtm{axtc(ds=5Gl#Zm7>ZA?Ry}CYE}k
zAJelpe8k=H*hku_$DGWy1$_)bU#GwrMoNz@PsY~kW!=}RO5*P^HtG!#2|ZP8w{$G>
z6E&W=CC&vlV;|!o*q<hj_6yLl!4{Em&hy&m!`a2=wLAVvuF}uQ`p9^JK7gJ+(d0L*
zg)`7a2+qaP`I&-qgk+3;=b0gvoRhd#mG<4T#=Pm|bP<Ai4dW$Ffid)y9#?tfW3E|X
zjNNfPb!_1HtvK(uuK{E1l{?0<-%8h<s@t+R`dFfixZqj<d(#rGQw2MIa;ZaI>hA;{
z8`$P`Al>_t4ktkmLC#Fjv5gn-J^9Hy>aFMckc_E&*IZX^*F+Ng#M7Lk)LGKuT=@Rv
zUfnO?a~zTy)EXiZ^dpGfiNAAIiLZ{o)m;-gMSlSM8+SZ$TQL6+EAjWoDsNxU@0!T@
zB{k=h9;(NDP0%y@>g(O5V{`BHABr0fy`Qw<Bd!VZsnx^~E3X$Z#M77aBJ-FF$Ty64
zLfp-hZzv9y@cO6b+Xa66c#IGF1K5d$QE<L<kvn4@w-kTF?=tAgl!PPvUXXW#JBfTR
z*d<rN?*)<A>$vJI-v?GXWqZSMZ~mR{{6g>2-Wc*3$J9K0OB~U8*Of5FeuLdqA2#P&
zI_^z6ZsvQoruS?xQd(ymypt14%;ZP{@8zc03Gd~sBke<4#}4<{wk997nX4!0m7_6n
zm7y_gK_5dbaYX089h%I1Kgc`6#(TJANItP-H=%b-|G#nVr@67&?|Hj=_$$u+t9+Vg
zYJPa~eX=<Zc@o?D7xh9hQ1|0#e}H@>z9B+zeGOyVLeJ5jOvxi!J}dpq+!{mZSyp+o
z_baaEJo#M5a%ish0{xk9VjPQ{59{-s$dS~#HUCK`)_Ims`OFRdfsn1@7;Jq0Ha;iI
z_bzOFc0NHYpRrx={Vw>9r|+gq-&y%R-T3|f@b?PrH~gNzV~N?Ks~$D$_h7~$i0R6W
zoQE3NhQJT~3mnUQ<Wl2gPt*j)fDed!V#^N9yTlRxKL3qm4|jgYXHQ3ArS83^Hgkla
zmnP`7i}(d%h&>6p)SwnM>4SNW@R{J6!+5|x&O`+}WBcDEF*DCnT_-&Zfn;Ck>tv6}
zrm?}dg>zQsl5emb!CcJgd0Wm+95txrdW>yr(wVn{Z6@|F#dNW?r@-E_*X(-;|IL%}
z6z7Geyb7`8@{WSPh4J2k_ZN|p@e%ll;cuy-oSvXprp8Aw2R*_ngw{~OSL5(aaRh7k
z`n$%CZOYj>KfSl?f2u#AS8(6>4>8JNF6sbtQP(gw*rqsw9)<{AOJ8rUudi{J9Y3+;
z5Kk<iGgoKstIw?-vEiEuy2tJ6)4d=K^?`Xq4CQRq0P?Z@^q^iin}_>{=d+&wEAi(X
zpK(u2+0P67cBnXx9O^R{bB?@kPwor-voBM9a&1=b1O3x;7c+ZjAIW3CXYM;XtgOcx
z$z#pzAN4}8$A+;P(w8_F*okjGKY1^3Kk#nPFzyMqpT8yN-<A2>a?ign^Y>=_j$g_-
zg8IzkKIoaf*n%}!{_K&~H8@9FE9>8a{ak{*<#U&P=JUH=SN5MVcEdRGI{R92{m^|K
zNBM1tZaXpaqSkO6l02xkI!CpmyN)HfJBg;A3thUYcH+r{R-on-A(qx}829wmc-OGB
z?<f{#=7l7+*wdDv!zvJ0!FP`x|752gI0i{vznB`|oCg~*wj&L8=!KBZe9R9`aMq^a
z+;RRmhmmkLIiuXKA&$;2XLtx?y{|db#B{NeLrwvE7jdzbOFs2ynWJeA?xQa1y}j~&
zx2(QfCzl#qxbMh$m=Buf271_n{^;|KyMK?#1?n{6`tzF4_9}@9!M?iBt}!vxV-EUR
zS6{Z{17gYhS+kx=JlBSvSv<Rtj3>`S?IH6}pBk%hq_=!FaRv-$0Xu$p%klXcI!D0R
zdX-CdbEE_3&}XrZIis)(#L?T-8hHLrJ*TJsJI_P^zrp=K|HG2r^xt@9{j8h)4fRf5
zFY~X|v4vorQ*p#D?J2Og#y0%@g1jS`gId&F7e`}gT0;dJu|0_*sRu)}0&@ZL(pM9k
zJrU?bU=R6k$T@<V)b@Pza0I>0WV7EdIL7jhi+t8pyJIbzY6J5EJ@h0bE4Ev%jQ>VD
zr^-98`q1r155ZosXDuZ<Hhjb^aT2c!IX`g6F{TE!dJ>X``QB*q-3-}`eO!CaKnTtX
z_fi*!XM;e;=5s_`&zwWf!#uZ*ID>D9eSytXAGRi@YJ}h%k8+-S)+Po#k0rK|Y)NAq
zvI*j6(u<BAKXJRjxPs5u#j@wMvaEJ&#`Y>b7jw8b`U=4w0Q!yhhdnabpvHFP9??`E
z&}Z71a|`-$k5w+&;S_8O*~oQG<ant?><zg<PD{{<TR9)H(lve~<g3&;>>jUD^GG*O
z_w0VShl%f^_PtBru0!sB3(wLg-s;Y)-x_!OJSN6-49&NaBYE@YtKU8OE?TKR^t<M#
z@yPYlEBn6kdbQl!ke?W{vS;RT51tcW2-o5ohCose-@%``<dHK3KC{c*wmr#_xyW^K
zG^Rc<-+ll)eqzBjJZ|z4vlIW`;rCAn+byvfV$70$b7TX4uT62p{cbSy&JTKFNr#j0
zF3&ph_Tj&o<=x=UcYT(>`5cD~y_+*b`Ws8WCr-ZG<2@btz1^E6-Z{jOQ@Qh=Vz+V(
z?*aWTFv`0)-oI7+9`1ez$9uR>bl%MsYAo;ZT+j89b>3Ot3s$@1oxjU_LFQo2C5~vk
z2TZ1<*$?lJ{2s}2<ol*uF4^B8_Q{9+H{vCx);o&%3pMwzI`fc&yt&`$-F}a2T(wzW
zIR|olAmlS|aa>cbZxdX5n4(vBE{d7YyryTH8PY4ZBkMD<+R?`!x%2O_=c31+gyfBV
zpXAJSo(G8!x`;0zj(Ed3#M0;06GQgKXPG|#W_}LxS%_}7bYOh=jwAT)2<X`G)wm_w
z=KE!S7wwXU@1_P@ys-5<Wbj*r-z5At;kSHB#^y)|;=p6%EL6L7{9Qy!#z(jgzQNy<
z^!Jm=-<L(>Z%bkooKNmh4_?!j&KS_aK4edpq`?-&ex$>?z}B?K6>MFEV9u$2SOfjh
zFMWG0tf!?7KXFqWK`yk!W8@Yq=jQrztvLfd&xp?f(q{{OCSCFg`z>n>^@re0v0m0m
z4_!opUa9saA9+(y1E>e9aNCZ2Kn%VR<Wi@Jqq@|FE<&(B>{Ao$rD1O?w%?MNE<*U4
zaoxC9!1b%x#`WxC>F-`63CXR$0V1&zL;Mg+Fvrt8uJ2f4x|rfzuuj$sJ0&*223xQ<
zb$_Ts%}D5nzL=Bw=@oj)+RIdq>$`5xYp^7rus`w|(Gy_jT5?@|eUEI!F$aAP$)z#Z
z9ni7i>w@0hH@%}{!$%Ej^#mPu+N;koNbKZNW2hF?dWRUD$EN#f3!d*h?|Js`3)}b{
zTq5{hFJ^wn=X-u@{|Cl5#D<{8&peuw`G5LQFH5}+F>^m^&-m&dd!L8)67T`Frs%9q
zP_JdplY8L0RWAAPvp+x&NNmJ~;JR?0nmFbDn7TiX{$9L9Tx|V~c@!8E(=+}^lHXO2
zy3E6zTXWMpYhXP`us+thMc2Nqa_vIbZV0X+oWjpuU)R&um+vJ{*OY5zdeN&5dnBBR
z8~c#N!jsLuDgVup4X}3+f_adPr#QlAZ#1n(c#MyjF320A3D!Rg*Z@B)5t&Es6ZnBx
za_*Y7zI9@ZZI(}V+mKCjyuti$tl~p|<0-$DIq6|0UD9yYhTs`;@?3I%a#lIBoL|l{
z_pt9rBxCIOkMP;%e3Rd^7BzwA6mp4P2<bo`HK^4E^|_B$-n-mie1-w{TLs$@#7wah
z?#Cgh0Y~s$n4;x+?sc^6gI-`i;GQiV;~ZoYtYzkUSW_i52Ie1vepoNPK^L`OV#q(j
z^K8vw9odqZwW-Hmg!X3WImJG)56nd^;taXe*uv}Td7YNzNziQ%=@slN<BlZP+)U{=
zTeh3XvuHaxEpxHqU*cR0^3*$f#&h}T-Qd*wKv>e7p50A*z<w;PpT4O}&6}C?A)8<=
zutZNn5}1>HYl6M>zB0x~4mE1c{V---z&c>1#72B&WKUDIp{GPYsfXlKPfI=FgI<`@
zk7%k*eb|EedqPh)M>c4BrdYpY7=QBJ@x<EJrH7ywpf6|%`Yzn#>a*TT{;jhI74J*6
zIR_j5USN#9Lj1@cSqp1|B~F3y6J7QYJL`CUq~~GYC%Wu$f$fHvp|io6*?EqS?vo1V
z8y_)G=jfh?7<2m=PjN(Dk9F+$pXjo?u4R<iQ}m~NY{cAP?;^xd@6b|W!#Bk#)PAv7
zKfWOxV~Onv`(3||yK0AEz4QdW79Lw-hgq<Vm{Ia=x3r(RrZ|E=cEUNVa5g_d?8rT!
z7By>Ke6EdT{04sNJ<W$5KRCZh|Aga^yX1L{jk<NtrSTg*W65W&hOuiL#oX}htk2Ke
ze~%si7wH-`$2R1;s6KM0*dogJ(Wmd6w{2bVjLj+fxZ>(KE+1o{A9|zrp8eA|HhkdN
zT4N~}MuLynDaa4OwfFVMhL1S%%#e<aT<2Ry;;Vk!Eb)zGNtz?w__vG4#0(L_bB&z;
zu1o9@)R+&v*|%c(4OS((3HkV)whHl&<`Gkzr0IR%NVa6~POi|U|He|x&5^Cr^xh4s
z?UU~KDyQ=IMd)1|jKY#`j&$(2O8byq@9}P?Y{tHtQ}vZ|R2w<uZ!z>9Zi(RE-ia<|
z;Ye?K$6|)`Z`fBH`P8bltB$XNuNN4bld;r<A$AgaKh(u49NrlvP4AjMF(3TcD*GB&
z->tWYdcWE38e27fqvjA>$Ded!Kf%A-gHJJ^d^3A#l3W8{mo7anY(v5l=NE{9E&@Hz
z1LvYL80&df85$egkDiAW+i&T-Px8*Gb*nyePGp4`kGpj67-^ej^&R=)w;pPa_5M)X
zHe%4@fu+wn82K64ukSL9&CJipmhni~vRk*rMqcoJQr|zjzMH}lC&3OL<EwOyO-SGR
zeKIZ@zghBcDEu7-7#sZGKztV=_?rogq)7tfC5W5iB(6U+*G}m73D&c6UDa><n-Bjd
z$UB1loVl;W)7#xAWBL!ldXQZlK|E_9mzustNXFRhJJOkJi=peh@;fls9p(odgY@_2
zDy!cy%)wmD$=vG$^ms%35l#7qS`eyD{n|s-mwXV($T1SIQ-}J@8-jftf<5)#GOjlE
zoompNA?a%p#n<^e7Jt|K0{;H@1i4F0YH1$kc3<>puuXxVxK?_L^btcmYq{C7v3~CX
zwWu=$`Q$pMDVA{;_#8)U6a4*-wHx<Nj^|mL3r>OS%k|jh+WJ~OT`&5f7oe`|QODGJ
zzTWtVC5N882G%h(9<qo0T@VN8Px0h-aYR!dxk&0@w{OWtjVX?xhmq?%oJBp8m*APt
zvmbWCXUh_izYmUNr8U(nRG;;(oDf5GsCzWm)P20w1AWo+R=*W&^i9viHO15C5J>V@
z-bbv3brBn4WWAsDYhRJnc1>b>#ve&D(;kw{P5jJ#^f}{voxET8d-2NmeIe=hf&4A`
z=--(D`Vja!e|IKMc|SF>H|AkZ`d}@rm-E8<ST}3++LzXT9>889rk873uOruEmg`ur
zU)4{>5DPsC$tUnnaT3=WP3uZ*tJ3k7)rXF~3(g^D2%^j}9_o`bGmlt94eLGq$oUJ7
z4aK>SrdqyFKFL|`ry7U7(lx%pzZ2$rW5`!o8ds|CO>bG>^D%c%eC9Y~A-2vWXOrhg
z7eDuCxevR}GG`jl&6IwUrg-pqrw(VHnuam-BqV{Hk@?i4Zitch{?WY^JX87X%KMf3
zZWKcHF7O}G6iYmLLr{Zf2hRZ5f_ru4{mOhj=RT6Gr9ywO3+|uwpj)C7M|>+#7iO8q
zwvf&1r8oCSkJu|Kd+rZ)Tn{-#jiDEM`j)L&@Y<Hv1^rqpe!#xO5u7J8rNb`x++n-@
z_{=D}^Q#a45=YeYjlD6S`ez>^_o8V`kIWg0Ar47xY~;Yb2F5qkfi6M})jqlJ%!!T-
zA91zz(fEcK$8GiC{#N!$uYlbU=YFU1D<|i`)<q=fFq0!`s5Jz2fqATZjIE1RIMSb}
zF;6-<wpSe+;~VT<L_$yFqW0;yCrMlrtlfL@o9v2(NYLlS(HN*b9$;Q@Pd(SPBtJo1
z2y)wn=e&EV<F1|{URXM-oY$Ra_~<$F^Q@8Nc@#P3Y!gE)IIl^^*AvI!uRdaiZ1ge3
z5v*rCfE_<^zd;<_d*iYF$eFR#R(1ScgrI-J7(2|uk?whrBe9KfwcCG7VxFKrFlQI^
z!ydLTsMmyR!`OK{$JmYik@L}y``pqwgPg_RAg;zPjiINVnyjg=hjlT=Ugss2xq+HM
zo%H~A{6IXpO;8hNp%<MPVk=u?*P`x9j^q>ehy2uO3A$_bml{pq&%kw`#`ak{W-9OB
z;u@B&jl|}<TYBhwCHQ;iy1twKw`1x?fw67YtBj1LM|uVHE$}&ZNjFD&#r9EZvGy)}
z&6ad*u1&1-kc@vLvc9F`SJpa`#=lW4v7_6+G#(-ZYpr01l^jWOr`QF4kJWM2@84~8
z9Lj@{EXM!*hb}pjBMJArLEaDE?+AN&Ke!&=17h=gKEKQ3J>Flr-}{k&+d}W)ZpOoV
zx%!UIy5H|v^4_kp^F1E2={;T@qt8N@4%BA;NZc=D>~I9JJE1m=!jc~Oj*fS8e&52o
zmI`*pmi95e@w+`s>Y`g#J2u;E?X9}J3j*E?EpZBrO|^fk`(0L*=>I>N`QGf7`^A38
z{hP6CBR}DHg5SIseCwlW4)&Yt&;{3Q=k-MTdM?>3k@4h^dxJeLoIg|xTERAC=($#@
z&%h_$v7P5(=34(&M&`Nx(6bln*!m|)&P|gIZhIXs`JbpURc~1nx%oUxCZA=AZB^RW
z6?636rGl+eeYbwcExrfwJxt&8Lh$|5Fy{LoK0xmxgkzB7fhHU9n`MeF_`UMR((f7b
z6l34u??ef@v2E+`O28N&wYoUMJ-Oel{=nl_^lBs55L2mka<*W9(21+_I@UH~YMlM#
zId^9NtE?5hXHVpBQLjn0E%nm!J2lrCLf3pGT>m$Si5FbUa^@UO@@P)x?IIqa-zK~^
z)`ETncKQc$sj<WnwKleDXa1eIXOHojCY`(xJLh3e_rl(qP(M9E_cdsW;f&4X@OM!D
zwkaBa^VHu#Lu}qh2=p$Fz`q5t6>L-B2gdk^SV_;bJ@PEj!;z0z=aEAkF|~Kb^o?AC
z^-OUDd(B<|dqLhEPmXP@n>hfzrSGm;>$2ZHVgJpM4qTUtuNM-37xYKJ%mZC8W}e78
z#B=?9cBx4&>msN2>Rj^i&#XyYg&g*oz4dkZ*>|md$=4N6?n$h>FXjh&ge8t}uS@+N
zG4&kZg3k*+|E3uE`yiTfMgIcFBKZx`1oeJuYaZsOH}}ihx9Fv>o%`tC=nohVf!})@
zS&y2Ade~j_NGIMf2K>a5=YH5f_H}E2hxVNNhI@#6X_R{kTeY|1U-C`e7vytBM_wo9
zU_R!hmn~QiYh(X?4g5LHwOE4h8SEjFG5)T2?+21x?2ey`W$(ELpRQfKUcIUA3&gn=
zdW~Ben<E|CKmRZGt&H!I@xoHygZ^{vtRGsgXDaUqB=jUC$#p(8D%go}Jd*K^^PA%7
z0cJuUaJ1jx@h$OjJw_6e;4yL~M-uKD^I=Zs{2O`C<1y0phV-51u}N}1Ib&ULW;wgu
zKU0KQI@5+RbTN}7NsbxPw}`AsU0{qIe-qB97KC7)A-3+NUhY+%i9Mf@BR`W4_o3(o
zY&=I--kYI&ll%Q7)T~VIS<!M{=7yEfQ-wZfawJ&?>oJUPhy(I^5|ZGtCG$2xU+x)6
z&$Ult%#i-ZlJA~}vB6(srhKMne~gb{U0$c9*Xr?B4A*%jNAlmmxrF%v$5;}(Md*A3
z=lm0nBZpj|S9<RcglvX&g4f-ovq$VzB;HqS_=qLPFm46L73Nx^mHuk4^o#Fg9I-u#
zqGMwWyUcGJvR^EXkDxv<*Ugp<ypR8_q*k5dxB8B6%A;3$?kUl+;j3UX#F&uI-nYC4
zb)T%`H?73lwq-Na>skLueuDm{*y3#u@!gQq1htol2k3|XTEaQ3R6FOii%9%z82Nl@
z<vHWCO+0x!L9e(zJpgg|drHQ{EJ6SC;%E%myKoKiD^p|Fq8@RsNnRw_jBU4kil<(?
zzy_;OYf;Bc>EGfUWIVup%-aNOX6?Ojbe)XtjJalpF+Oq)W9&olSp$(d__kn9=BKwQ
zj^GTA!j}F-jUf+Q!+Mu31agX2>N+1=weOs--aFVvLM$BBGt_1stckTPt&_D+>7%TV
zI72RVT=$mygO9u$^2w=v|69H5vkuk^zxhAq-M*taT7GZk`|D2K5}WPVKH=Cm*_8hY
z=Mh6+K)>!0`xe3Pg8Z#uy~<I1#FIyz5L_d!6)^4s9~?pK6y%v&yXy8^Rv-F!;EwT_
z8Z&8<@LNCBU*cTwJL$GD#{Ne2PsMG)@4_M0Mey$gMNg*WDKx$F8y8#SO6dI^^aqw~
z-*6OXn%<+mK};_!>BP=tOG4-!98{h0NR}j=Lf5-Fm=9ogtaB}gYJ^~}DVp$Fkc_c!
zLF^Hp%MzQxw#Cppot1>%wOB_ozNvoeL$NpZk>8UkS*i9TU(@@cA$Aga7iDbwR#FEX
z?>b1^Zs{28*8d{AYX242uX#&#Ott@2ca18KYD2ZX>AkEcqyu|11lNn}7lLbzgei__
zim6~Two}LYlO%o?y7WqD{4=+neer;w)0V{Wj5J+in1951magY{hUSPD@ZAv0=gf_3
zJjL6Gw7=S_9Y5o#Iht7dF4Gfqf49L$%q}o~qsa&4gKHss5|Wjz?^k@sYRS=eF7Ozi
z{n+_V)<q<IS3^g_Ncg@wMNiOSUtsGAe_L6FAsr&&@5IJ7{OjUqT%kVmz!vmKuXPPg
zW58c^#!nD4#1dYA9rv<N#NfMWvQc~H9E_KsUd?ArE`DNrf{qQ}N~-QUhkRYfEx7hR
z3rqSZh>L_=LoH~6+B5s52j+JVRqq++cw$@Pc*jtWIAD&q`G|-45bM4z-7ock+T=1f
zeRy9vH$y~%j?H_Hz65s8BJUiU;BTD#O|*gyjvxkz-$`T*#@H)OV<5ka5d19__?znu
z{v*h#b+*Qy2fynqbj{DYcAg_&4<xoJ@WW9otdt%j@e{iR`?*Av>%v~M=Ujsu?BE!5
zVs^syvyN}77PXn@274F8oB}pt=`++X(D#om<B18;G7f*`Cr5kM1$)OHFU8#JrjDT=
zFrMNF)?gTeeM3Ihy9Cd8J|~XY`aB%@TOpca3O#jXg&1<0Ab$!zA6I_vFh@^L&bJ>v
zTd?t21?a?X^-15o^zJnwS%=xVCgxfRI^d(u(w=j6*zdufYHv^Obx8WmBiVm^O)-ED
zD<!#HD_<L~C-v!-xtNo=k6@2k)6m-3m-7I7X4pd@j`&DMj)~jizE)h9`6a%FTt9<t
zij(+#A7kwO1Ne#aZ$W+!Lal*+7P|BhOK0akL*4_{$=UK+i3Rd*h=G=Pyk6pKJ~4*8
zCYT%Ci>2+Bwl~H4nsr^P%F1hpJQwzL*(3QmFPxbIHbb0s%aO4j6GKfvuT&d(oKw#0
z(z$J7>I`$14dY!PW+dc*$4J|dp}J6Q#6T0&WghOIk@slJ`;_|&x(LC&*mV!`x%Bid
z(C-DO-U<4>Ao1jpe}tc<JPUxaY0@j$cM|Fi=y4@SlHO<88`g7!-!ayaT~Gt4S@ofD
z2zsEWrQU%x05*JE5Jx<$#A9S6!~%KXF_IYPtgLY)fj)tr_XXDwxSmfe*?}{_8H1S|
z$xk$$%?f9gG4hEmd!?TFs@L;xyYp(@rh2tM_uX?H$VgZt>t}!1C-%+zIHX5{e#E_(
zjC+BxV_NPZ^G!itK(E%1?1q@0gyg@)HD;-Oq<c>HKp(I#ytm)VJO8g^dT4?k>A5H9
z*znz8uMi6%xTZH;W7DLYt?LDh@h?G*o=_9c1GT529$_c!o%L@dxlMQ;=Inxg4E;6X
zo_)?d?pg<DbmduPObnm{{->BNAGMhS)&urc*%U|aOwjR1_Rktv%MJE*<#y!)wWv!S
zVjvX%E!1|b^QqMY{ZSvu81R`T-MQ3xW6D<{u8z+&#zzc<U>@dd!aa5M^a)?L&^7dD
z0Q$&liofDo)i!hO%uNqR(AyTAKj19Fy1+&p@o%_}YgBpHdm7)*9Ac=^a&GDydZ2&S
z!n#=JN}9&lLcS$>_Dn9dfVyT$f5ScDN3YU4_Fiy~?f1CGTA#{?^IzZ^x2!e!&TEEr
zv!&kz-^0uI>f7(}D0Qs2GS96$26_AF)i(TFboEeiUzWFz9CE3}UWD+q>e8{Bma*jA
z_0}~n^Ed{{_!CS1lb}O?AY^0y3bq<s$4kB=TKhXwIY6#;%Pm{{qrEFE>2Q+zZjkqb
z`+|3bFbYe$3B3b@UYOEvj%<c^W;gh5+u)tr73&&~$G<-idiMrBS(0#)R^A8lUam6J
zM+`XUH%Wcy1#(=+buDd2V%s8kw<CDZ0;gb`<&f_Q`>Q;P^}C#z?|8N(Fs_n!L%b`3
z^(B5^Rb|ijS+l&?vaQO<cU_-kjepbUH4o!YJk^P-1~JsAvBW^Nz3DUat30xqYDdR@
z+dS^_MS*MM>xA?*?7E&X%e8ItgX2A}^2tX{L%n{%xdNZH!MHq^Z=L6KWorBh$3DgE
z@~nOG+t$jQ?x)(Sj(>?rw!SYIZ0Pn`+HYT1+#5A#s1~&3<o6oekvpljC%u&#)S03u
zA<6frCU$<O;(Jwp06Q_njzZ1#ceJ7JX%K?HX*6;FjRgA}#2e=={e2}0UAn;sM>x+C
zoBdTfc4{vAbkE3L=BExZrjEDlrq)=h;XP#E-XP{EmiQa&hB((i2jW98KRvM?ugN`G
z&Z|#yso`t6bUir>hOrqh*V;Xd(ue1}C4Ca-d8g*yIe$}qU~Fu&wB54Wr}BD%G5+zu
zlFi_6qUN9Mk$zc26P%e4TYs;FkrEs91YZ+Vf7=YP@?Bk%1jhKtcivL&5zI5oHA2UZ
zzl#vA&)-hB{+7D<cZd1!p^hYfU-dl196>+K2k6X?Z)8uzQwy9+9P=^v5%hLLf3O96
zHFDop$|DJlYa!U<%GNmY`qb;eH358PNk0j??bLuKn2Wi4O2)IyF_g!c7<y)1Q-s*L
zKj_$p{LqABmSS#*$Nv=5(|#nWL%l8BA3f90Z|qzH>*krwvz*U~DTY3~_|3p?g$lnL
zOtp8}Ly*Vk+EEREzM&gz#Owqe8~&MuB&_^wp*OCJ*W<o@t=NCBVdgsgxwJLLb`(QA
z*N(kn@7P<zK0>vlV;c{I>agEG^|<!*mvhs1FY7tdStGFCHylI!6n72s*kks36^``Q
z{=<|sTY4q_QN9>|<SEa#C;2p|<M2(<5_<Pqy7Ze*zB@LQzjL3xmyEF!yTo|_d!=g(
zA;>qQ=(gRG7-)j)Xt<u%EwP!N*SpG)tzw^ToHG~?U?<MfIkg79Cb&m>-XlZjnER`7
zrt^&ZoOAzi4-vz8KMA?c$Nq$4k@$xQK~3%<=HNc#p6i0=VH5sL;d2EYn_+zP8N=tz
z&u0vuGs(=)9el(%m%7xSg1PQ{oBJK`8De{aj-8mDME1WVSqpo|y7re4OAfizfS!aT
z^Nj4tz0^MF1wV1bJ9kMpN4mk*MF?`pZ3%0u>m!EPC61s^_gm$bo$Co)Tksg4{n(H2
znVC8}uwUSOeqzX9SsH(X?+44boLakOFZAlZExT;M+F*$xBJmzf?L`yprS}wll>H-z
zm??WCU9!d<#W43yLcIZF>^Due8^_%Cr!lcR@m!We^TK-I$o2_8kE(S1xAh!1vJcD9
z*gey~u?@e$W<Sy~me`tL-&fKl4R-vFVQg$i&Wo)vxQ}tIp^le)=170TF(cQ<oGo!r
ztMne1&e&|7L(V2=Z{`_9uW(k0Ar@-Au3D>bQb!v6y%5qXu8EDfC5~WCtZf$<W5-Wi
zPePI&fqK}FAeNlpAP&e`f_w-;y;>U^zLgwF=hu0*>X~YP(j8Z&<J#31{WRfg=Id5_
zB<Ajue!IX<Y^~9C&4F6jpYo6L3_a1`P9o2>&nEH|7!N@_xwQ`C%G5X%3*_7^+02pt
zg#E~ogydFj>N6ibtlSUQI}-GsYbBN(Am6wqa%KH$v;D{itKhMH-$*|{XMU&LlK%~S
ze>LCKaqP(Nzf02aJ-TB1EuUgW)<d=r)VP&%V?)1v%+tjb=K>q_2SPU2YpTn>Owki`
zY=#)($#cCa{rmyqp(p6)7l?r_qQDq?1)ITs1i#J37i`6VV?Fk7z5b7CizQCd^uF&m
zcrOS$iSjP+>Am2QzdyVW+_F{L^=^-Md2bN=<Xgp#{zT~ATcy62LqAD<4`+SoU7XqZ
zZVnlGzhP{@$F^JE{-HW8K_|{J$o{~R4UTAf2Xn)_8Dk%@&T}p{<G3na1G$sXdn54s
zA<HG(w;aV9-eXl}zVpIn9m%-jeB>&4T>aK-e${80tJ?pK?zt>oqt0>b#N4*OjCaYW
z7BK%3<03Q$uBY`XM~QbFv7>OG1;;t2DfWhQHXrDE7JtiBtl83U?CTkK`|Frk#+J9v
z*boCPIr=;?wpG7vj#-NTM3?`Kkk4#=A2CC^Y0@jUBW*u?ce<DwLl+_VUeyHOr6%8}
z3a9+Oz>a?><QQ!Dpg%yJAwo?3eFL^&j09}0;J<%ZRv)q7Ko0p!^aLFnK58JXZ|P=A
zC+^O}4vu48a0F{-4|d}HxuyNYllR1u-3;l#*g7(V`)OBS_zba6EZL8sj|w)xKQ2P!
ziuVEA9n0AECH)A`v&%lA&ocIY4V|$H_NP4Rj>K~iM|{n%IzHy?VktKSd&xClzrdN;
z`upW5_-~;|{>B-?e-HKFKv(|#lU(LtF0Pwl{w?SQ(6JHcIjP@Oo4>R2K9Ki=fZk<e
zE@+yI`RRjx$QudzN!zBL>aXm@JutU%Kgc1DVBgrkov@!3+utOyL#%{n5%64^;yi$l
zcxo>7KtJvg$#{q(diFO{GRBUd*d|yrYxnv+W>453_6@oS!Je|uBln#BWiQD)0_j|G
z0Dq*v_DCNPDLq~q(<}QExd(opTk?$Gg3pg5`0Uvt^qT=j0s9ohEkRBQ@+;V>L+o9{
z^{~4hu_x<Mhik_5r0=c%0euO4O)=w|lRRukeqy>Hp1i4i_QKbS{WV;>nb(^bVuy0b
zr<P$(=3s5~%G&53>Kd2U1*g#4|2@V>%n%`{K|MeR?D&^Bf*NK@hkeoh(R#&5mgJ3n
zmMwEEZC_c#_MLN1$$o+DH^^Zftm!6XtLyF>uZyFx!Pi9y=OM?nf5Z^`8^py`tJX!w
zU$LJ#p$X1KWpYkLPg%#<Oh~U(`_h@?>`l(1&Lwa*8Dk%Um`bgMofzkHw&MlgYxs#<
z!gG<o3ykp{#Z<_-8M1|-KKEA>NB7##^GPzq&wa>qPtUlW&pV!Z=!55CKKpq7Rl3G7
z#SugI^3MAi$rxHf4DlhT>AKkF#nG7DEqeA#&v58D*TR}$C#>}o#5F;U3U#{(!JPE`
z)D!k0h#{UlI2YKuAddJZSQAhei4A{bEb(SZuN;k`u9dYgwvBZ!aT3l5XT@ykP3Q4j
zh`%A1GyTSr?>Fi_V*So>{g(aKK4z}T>$GI;W=My)uzh7LWA>4~?IOeyO*V3gJEG^D
zwGVW9!Dkp(w#J6Fpx<k%@#v269=yr*VXw)le(!UCc=pw}s*}Umxm98xNs|QnHeScQ
z7RNfijz_6S9yPjP|G5tLwZLbH0mf782e8}6yq<4KuVAm^TYuVzrW|V11AUGJ9b1<V
z(6Nm|NC(a#_cCz)tRuG|<|)s%CI1n1F2>kLO6#F9b8zkf9cHp6iEU-iw)7`v#t>_c
za-kP$J?9|z3yx{>Q;YmadXBN<cdX^knxX6R3F4fCWc(IiW0`klFC+Jk{R768t#Lf`
z+cX!r4!OP_RbqFI{!oX$%-#FY`e7wU(qIcg?#vpD4R-5DVot8v{m?sh{6nk)W9;}_
z<`NG*rN_2~?5wxzO!{+k@!6>{a}q}_YQh%G0nBF@<AWN9|A?N?LG&B@EbaHW%BecA
zFP?0~@Lkms9Y#uz|02nSRjA*U|DwCbQ%(CUiLrjqfxX(gzQ0d#lGe2Dg6+hZE}c5e
z!+x=!;Jw3+--P0U{F8W&p}B7CtI~N$>VR!E4&8RgS@x1^+j+6M=E(lGWc>3E{u<L2
zYnF64iQftO-QSb+`@kyicY~|^TS49n)^~$5-v>6mx2ufuPS5&!dADb~-|u<+CLQ-A
zyWRs<rp9mt@9B6)=l68HtE+_GZ$N*+e#<*<DetDn+&+(w@}8J_53|33xJu2jz1r&g
zBI`r%jg~lx-$Nm1zLT<zn5sL+(mwKF|AOOg*{^x;aqZ*weLH@uF|+q7pK98V&-!n2
zU;FVC-*fHsw~`?VA-JBtw#asYZ70MV?9dXAZL8<dF-ZGua~xxI+wZu|v%4^*n=ZX2
zw%u}<+~4$?OKcri9iOT8mc3MI|9;8AU*nHHpDIgZ)1{k`4x8^NVkAw{9DQ&3M3)~z
z@SO;GgMA3TH%-1%iTb^gvB3}f;<kI-GahO1S@%4P?{Omd{-*D7v(Thh@a+U0$RmHH
z#E+f7pY*~ie^bFv9C%*qjBO*X6&T-fBj-Mntc^9o7LD(sxyS6Y$M}dLX9;Qmy0NXw
zke~U1Ud%nljt$5G*YVi?DreSglE5AUI=(GxtyTIx(xGczhA}bY3!KZoY~j7Cl0B^8
zBbNE<Jm|HaYZ7a)^~?*!vo_YrdO0gygxLB!<Veu5nd)ouRgV5PIz{j|(tJm^B(V*}
zQvV3%oPzm*UWPzoUpXH+)C6h-b$Bn8pkwO=<^yb=v*kR@;dz(~7%y>BqGJPe_KSVn
zg1xWTV&xcV>hq@S`E!JyWk{Z7*bL+9uQB8^AM?`-d&OGVLtw8$_9NV5SL}~X{+>9N
ze0)Iel7HtOvtR5bd&j=El-Pdul0DVCSKi0|NR5wt<cI12y2o8(>L1}g>8)u!tc!K?
zykCOP3qCit2>mXoV8eG52gLUT9a}58BlG_^Z|`<x%c^WyB0yDUiNN|VArJ*o5Cu^X
z1yOSJ*f#Q7ad4kA*4>pKy_sPz4E!-Y7HywH9(Mf1oj8x$#GbeZ?8H<-jlz7#H5^(G
zYbqhVwifYRQy`Zbn;NQzY@!JKTlw5aT+6O&RO4E+e~hs+2eIUlPj4%rXLKa{utlqi
zNi69n*?-fUa;P-}bb~KL{tD_J^>KhLgMS9-C-sPb8ar=Z>XEb5(}-T_y@j47_9?nx
zAK6<#$7V|Sv7=+3Vh6b<I(Ga;kdwjI17hAFt^}^(ahAkEwmE)iey9oVqs-LUH0h>D
z&tRVk#@w5OdsO%F(*4Rk%QOFTU&~(QCkD`$Y)#-Nj`)^fyhM*0#GP!}r~yN)18mTO
z9FNU@OZ=XrO9y(WV(U3<L6KZMn}TN*$rw8^Q*1%rxZrxkK@&w#gIYiDPTrsK9>s>A
zSlGc+edb&jiq><&8c!Qz@~KmW=kxqc^BdbvxfMh18{`z>HM4H0TCc&kV*SLnfZQjx
zeDuybSl>L@8vCBelKWsCaIgA)%|6?oWRH6tIWPEm!iRo~d9w9X+j^Ca{#Zj3tP#$&
zciBvl4oiDw*f(_S#LbY{s$g%~cO+x%#BIUcunw@bfVd}!A$A2%y8Wyfya%7;RBVR$
znqZ9I*XB(UcjEkPKd&t@PvpFBb=Rt@%f48mvwuyn-}7PL@t^qmU|)hcrg++q>}$H0
z;fy7QI#rCAGta|Z*qM(QB;zKC>p_tO?z>YbW(Hdl7<W+u=V3GWun$p%?{V()CV2nw
zUTOh4?<IW1lRpK$(le|i(KGnpX!65T%sT2ZCbkLsIN6up*kkB{$F}9M>oW)X>BE*|
zh=V5RrHc}<&o}TBH^mm@x{hmMC&u|D#@K+deMoH7S;Fh;Y0alT<%9Fyy^V96^Qv;0
zEBCvj2W;+xxE^ykmofe(W?BntV(dEj4fdgR{@jOgk5)<US8Oxx&mMc;qRxn3mLxj0
zsfA=*qPH#i8+h(v1WWP_zD4opZ_-omih&t;e3NI4$CmlK*m{faW#lKE<9bihaarct
zLvuZ`<%3%Pp-X1$w;YNsqQ_o(KN-^>z7`N`wsi13$UKkro8Puu4g1JPcg!gr_eoMG
zvotP$o@w%(Oxa)u_43~d-p&MV^O+#$fzX2~X|{C8|E(bU+qqzkv%-Fy5&FEZ=&TOf
z7v#91c$0H&+wxbP`I-LVJP`j%6rFQGOHAocZ28{Ed1qX^oX@N{hskFw=zz~uo%j5f
zt{j*l^B5bHIFsUR%4b%m&N$nMv+cCwgZ+U0S?1VmZ^u0Ur^jb6jOiiUf1{HNTl)?@
zC|rjFUw7_<Dts^H`>Vx0iw!?<#IJ;Ni6I_oo#&tmo*|x#622`7<T~GamN{<3-1vvy
z)tRmF34UxhiOqImGWPv<Ws5nU>g;1)j~&n0I<h57=twj5Z2<kCYP|Sf5<|3L^DPrh
zNz?hJ5li1UfQ~JL4e*bkN@ljcquwCa{>gXQ0XEoy$4%p<Z?(?%n%Me&8$sh+E;wyP
z_9rHPqlg+XCbp$oTRQV)=mA#3w$n~biQXO0nDtDt1$#1rB?*jcKwJr^!5k-5Hh8kz
zf0N{7J8RC2*pDK~9zhT3J;T=ov9JX-sl5dKBX1C6s&pXVwJcq8$=_6uefcfqk>6t;
z<^sk`6#0p996si4qKLfysy*<zj^)rfPfKtPG({IB!PvGDXG)wap%b?SwV2}*c}{d#
z2d>fM+A$_>YMvGIGB-W_*yU%<tlcm+BiZqvdpNa++`qgpc!$gYJ%fD<zn`-7dka5t
zJt&gk=Y+Y6;2P2ky%oV)^FFZV$-42S>%FAYKXyRJPt7LqZ`ljJsL39+0G)a80e1G0
zeJzqdW7)|!E#_g4DcCF4<25nfVIR_2JA1PP?|T0hZ2cBg{!Wn`L6d~7xEa3#Re4)A
zfPF2p<6nv+zb6<|%lTb##3Nx|u&>BR{TbJXHH@HZ9Zhz6Sr^Eq_C8=O^i-<y#RwQ<
zC;q2q+Orb#borb=Q;l55^^iNLf3#MCJbAL8anu^3i6T5dIyN(;JD1vj!&2S}b*k8^
z590&G5KkVgz~id%jv7t!q{!B_$J|rgKS;)`8_=u34(QmXAlLOq(y`;uU^~fv>s@*E
z0eprSbfon>cE6TGy_+VT`)_^$_o6A%c?O2ynS}Wu@o|3xdJ{ZL`Po7T>?<gW1L9!@
zTN0?p{IC-AmixnBh4ZqUs?$Uf%$xfv>IbIYpC`8So`o8qPl3OQae(bcksZjThB<3(
z#nkANUf&=tlVg{BC-!4UuYu>xV{E4#zwO9z&@?WA*SYjNvh~|C1#-miO4S}1Vz4{T
zu}wC7#C1XKE$DqExVBv584}%KJK3_m!Mz0BSH`x}j(>f?_v=l5%C(<)YC!L-sR{PM
z*JWsLGVB##YoY|`Taf2{>`}+H@aGujV$OYG$ObJ@q?@VQhL|C?$m?NjTTlCm{teX1
zaqFc<_Mww!+j))buZl4}#p4I(S-1U7=A0bYRS&W)>-J}fKaZ=%?B@_o6ya-Ni4E|N
zU`vuqt(9=EpCmctQs<<~ZtNRr?j{{d;65#FCuT$}I(Elc_PC#i?&B70y+dZaOL(9B
zyi+83_tbd*@D2jTMZPVnYEh5c%mw2ETYk93HQAvgY#R?bwi8z_V22TGN$`GiO}=3%
zE<;WYsOS2~CW>HRfIWgLmiC;z2Xt(Je+u#pb;bcU;)r*S<95U{E+X6Mm7Zb!67Fs1
z-0pMxEW7GgK|dL6fIow6D3*1xFWi6pzHy(m*rO8bX_Bm)xF0{io%&mC@;7k&-B$Vg
zE`C#q*@AfLlfT7?dPNdi*tR6S<#jf#{}WR&u)n0n_vbAhAB+o2w*L-A-^##ua%O4_
z*@j*M&*`2R+h^$*k9(>&rNe%pRqe4D!Ad$dd^wj|T`*@)6xo`<5Bq_tdWQODB^}#2
zcHEP!QP=Z&Z26RjeLYbAl>ayv^xt-tQ!#Lkw`|aKE|~H8pXEybyP;KQeb6sV*)m1v
zfWUbmj9^Ow=YS)zq@NU>H<-@ZLog-(JDhd4>SdbFIADnNK;_&+^b596`Jm{m!?Za6
z7$F(sbL<(9?*@58Y*FKUXi1**@DXFMS^q{74=YJ@Q*>4ZKDV-*vYpuXNjh(H4)!I^
z$+BJgda@P8{+m3_WBb&6-#~mJHuk?t!ty;3_t}>8eSt6gi+sM9xv#6>o=0Nu@;l!(
zM$|`Q!#@SF<P1T+pB={KsB^28>t_8wV)gzW7n*D)`){`FM|aF8>AX*IH@|bUTxlKX
zdF;5B`pdund_O?8S+}ptU&P{@N$|Zg1HNI5ZI;-xp2yi<6vy{fW*y_~vtAXm^^L`M
zRy)9EyJeAW>bnfOr~%)7L$n9{cgWQD-3dPO$X^L+GY8Co`Jn|vGGlv*xSMp$NV)6-
zdomM@p$03(lS`c<=*@jr={LMC)@ZO5#h+kzOq0(3uxCBN7<-l9FgCU!hgbn~^)#pL
zS)TnkhdkpLkEeWQOFyyC62JEly$gC6N555L*3<-NKF|+rx5Qt?=4_4gprA;C&xz3O
zJLQmX3+hmB33|w2!&d|J5;0qn-hnlF9aHv9)0jHURhTdRJw!cX$zOqMVK0JwYTJ)2
zv7g@KrF#^(kGY?DSMVNzk>r-n-*o&P#d`|SjcvA*TgXvO=3-uY+3Jb@=&b~-F@v2L
z_f9T!F-1!~)B6xRV#pys@7ap~Emrn$JX|;S6CW{6Fy5-eoXpYE`dM=o*k<e-lJ#QS
zf*9WEyyJIB^d?G3bi=+;lUzW@wiUzgO^?5MT9qyR{WGQGBZk-_deotpLNC!H*TVbN
zSW_@0u@grQbJG{~_<f@`6wPCpbBcXHe=q|4#8%}~lir5r0Ca53LCg%u$#s@$LH+ZO
z^!St`;%q<T8E3l2Co^owlcK+;!1kW<>!C08G7^k4_BGjoHRtu`J#Y+i1WPi{nR~%U
zEHyIO_BNMui0KK&_^2}uu;u#15pTNmlOo&6d9R&09zW%AFHr*tHQ-*Jg8QwArF$=f
z4e-NEx@|=^=Wy><vEyF$J<Zs*!aW|(-jrlK0>^mV!j8<~-vRS6@4A2;97|rNX<Pz&
zabHzB&pz)0-l4o-f%l%V?X+kARy;LEK+TNpr*sT`0Da91*#9kxY8lUuw2gUYg7J+K
zb;zxPJz$TTD1zVHF8ECv`YmaK-zLL&h<$-PYHTrLFFjxGWvYiQxW4&%FO4%*_lC*#
zQ+JGIkNfI3aw_NKmS2BSn^-veWjsU^>;wDJMG3ez?B5A?Vu;;>{0z1keqzwE5i^AQ
zIpvbi*vFWhCa7T;V_yg4bukl+Z&cagn;J9fQHS^@+{--Hc-G5f&q*C>@?QJ~Vl!_!
zIqqA%t9}*qI$~`tN$XxS<IK=_1=OM56mNavBL;|v8o1U?G8eSKJy~)+x+noUww)mN
ztq$?zl?2ZL?-brGykq?C;T;9oRzOS>#MgL+ZqJQ-$dca9Ua|cxxi&g=s6S(kJtSl7
z_=#Hyu8XhHDd&Ta9LRO3YnpUmPD2k}6v2M6=TH;ushQFNKRM*PE_zROmSXIuubyzP
z**4|R<a;^Wv))rpbo+d-TiWjUs@RqG1|1umG5A;`Yhg`Lq<d}nGCTI+XOGxB{btVi
zn{DgwV&LyL{%$i(F-5V|9jO=hlqLO5!P;6dB%j#wfxj=2J$-Lx`zM_|m@nk-UB}&Q
z_95+W`p(V_jZL;^y<EP{v;U?K<?KYQ|24Lb%yf-!5R+?B8=5Ey#@I7kW61N|^mE>&
zIe!EB^#I$+N_ESh@*n4Zwl(=qrfiw5@k!O+q&J4_u!5p<K45I!vLEMyGtLCJ<Vijg
z<ZN&SoC`u1^PuRw!Zhibq4CMS*oeWN!3Hg1o8^{|vyL9DIP2iN!*DJFGqI%uXB+u^
zV`+Tia~+@Uoc^JlC)%Yxb-I`@;Lp@!Y#;U~95Z7c&Z-P&S7t~*$v$-amgrAx`7${U
zyT>^Oz5c)dmFJk7Y*7PwV{5J0k$*$3IbyDFrE}Tu9u!I6FWe*6u^Zd)|J;+hFN@$_
z_I+KYbI-Sc`yO9Y+!W+h<)2{3-!5Q>EzUf~<8RUL(-14c_(qfcZ}4w)macQobF<r)
z<(Zeq>(YPDbstmT4Vj+Cr(Wb+`Ysuwik-fTigaj+Dcx-8&Orx!O%$>GO%<|#kX3%z
z`c@mFJy7_T3;b={`MwqWZ7~AtP2->MIeoA7#N-<<VIQ_F$fFi@fcnfc1-*?2w(Q{b
zcum;IX`&<;!w9ydb9?OBk~G+A>=UskuG8czf_~{6s_=SP8|!4<B|yi9&v8h`P0WZ}
zd>acSx!Cb%sDr&9V1pgxoUD(SH_IiPVJ(KW0b~2Kyv60%(?3-Q97C`4+=bV^_4fc&
z?SUCd$2SAVGH#-X9_MYyC9rKljTQS^Vov5|ezT>w*o&?{xz4`UXU|2kxi8m7GG7bO
zJ*FrAKL+{VxZHyNru<bo)S_mOe%#AAu0LaXnSy(93+~-~A2YU%_lDv9VX$q%yJiXA
zS-1Drj2!AQANxWNQ+?8}*G=CB-^Qmn;@QItb$05zs`iK&;-L!inXAQoKYOJ8Vh@Yp
ze=ihSwU6vE^Ak(X3i;EA_Le;cV(`-sYhpiGV_v6wnbA9A$8N=rW6ya1n<;%C@O#2<
z4!<>3f8)$Vsp?sb03C|xiX(@7>N79%yI*7zOY2|{cl3#!*b;rw5A#!xxv4*bedvs#
z{`pUa?BrKLJ?b)t?;p>DzX!ylBa8B>u|=-m|0qV-hW`m-9G~Tq{f)xkPy9`Fi97AC
zTNS(2%MeYJV8?p$+Ry<X5Ko?2(t(=59M-X$5jjoLP><S0a6cfs*auT%IPJIb8SA-_
zXS`#PJyE1TL7$nYIP8ua%7OX-_ZLjjK0plYz~d~Nd?mqs3_YllThCGvJYP%C7obmp
zy&YhCgFNH>O?}OEg53=1&_of`sDgfmXo;=&mf;-+op)JCbdPyYn(Uv7*#~(Jbmm<F
zy+9A9B+%;<jzRXIN*dQjG8eSK<1DjpDb97MJp=dRF}^B@rxrC>dl%)v`(!z^cUABk
z(?ki-vEe6{TGXUA^DrOt!VH@BX#`vHyca%=d%ADmbn4vv*q?kk-f@=n`h;V0{+sUj
zTyLm;6GeEh*tZ(6p9UK-#BY)74UMsv1Y;N%wrt=Ux4!WaLw*a;VGI1^tuG)BYQkgW
zI<T)sJo7Pc5#FEkUc;XEhZ?Yg{4UHo@5xN|ox0;r`#EM#Y@YiZSNXjr)@88a>(MiL
z=-BWX`#mpl;PI0rhFqu@?8}n46+Je3&_1)*<pA3Zwj{AIQf?k&XH2Xizlag<siybJ
z&pRgGLqqQ!-akm*P55|^@&17=$fZUPs0mw~^ScMf^vFTlX1P-h>fCBk&n)Q~+gs#X
zVqXXO+T?5Tr287>I@E0kUc*g#on7lJ;^+C&Ub3g&-zL2zuy4Vh6K`tDL#H0S&?jq{
zUvS>TEuPbC|EA7c481`8683a!Ei+(E*kA?Ny8P@**Zs-;%HL*<zm@g39CC@Dzt?0h
zaX)h}vscunmizX4J<bxJ_hm?j9r!!bV@un+zC%CZ*er9-QjJXh4sQDPg>19_mNS)O
zw)7kJTi#-xY_)2iAILe58H#;_xSW^unbu+*ziWRh&-s_;g!1QmoRekFzuCL$zcJ-E
zTY9GH@6pVNF*39GyERdDz6U*|b;f2&zfpAVXPWd8Y)Q!Hft(4#N)(+>JmE8pshE>3
z8`z$8+dfHh;OERlXCzA$opGFW*<gw-n$A0bbB`5Nozp=77jUg7$s99Lbp8a{X5Bu^
zrnnRPoYP|sRT4a&mpQ35f>URlah&CrAM%-=ZU0?))*R8}x3Z<)i}b&N{c>KehdxsM
z>?^Xf-`rQ+W881P=eXYhAF>JV$sUxX+lIu>z0JK|cxLqcAsLT!&l5Yv7Sw(MzsWHp
z`ubKb#b=yn+c<vf@^6@RVoZ~M;@{vbr+%+*<e0P0H{+3dL0=ExYXN#5y9f8zQ?KYJ
zMK)Oao`MnIRa4(Hd>5TyKiRTn@HbJ!(zg-cR`rFUZzyPdcP1F$7_vhN_@?cm3ckq(
z-*5r?Z&}JQ)CB6o6wKSAhb{Suymn$o<hRfnW6yEcd+gtm%wVsAJa7%`jN3ucnEtC^
zee6pUTi>%?tT>b4?1FDy#(e8$u#JRckd=7la<0S~2s*X!Q6F-xC!M${c7UF--MxF9
zW3t|rZ*1SGK6Q-kjze})#LzlePfIXn-S}9iVO#}%m_d^)!h6I%0b}f2kVhTn-OQ{0
zxMp2&{kV=?+aY#>aS_C=bX}>FnHsZRVyMj=_?ed;IM3oNs|PL4w3d3D(c_37sYMO<
z=N{>^sTX?UKIPu!eP9^(1Y=`6W8NcEY*FLg#5)SG;U|8lwbM^~A@}P($*-zo=)DO1
zBYez*A0PImIXoA8$X>9ITsy8K`?a-q>?d%Yv9-9yMX}`Ne!A*HjrvI2ET?Sl4O<P+
zv2U^HGxn@&ul$~G@q4f(Yy5UBNhta|r^nwvrD`l%z~4X_+lTx+Sdxqz<ETa55md<;
zzc=(`mUN&u`Xb(aP>Y)Dp#D*NFA(1Zb?AY*Ko5+u)1#TuFLuB_Vov7iU+_)bRGk||
ze@}hlmS<Z}{Z;8JdLNSDv1PUspL2+@&359OV4v7O_HiD2TEd4Py$9qxvE>75L)LA3
zlg>xZ3tcu-q(9-9o6I?^4MtEUPq@$68`F}G&)9#;rWjMC8$Tz=E~?1yz@g`!cL49D
zB8fgllb!e0jCaD&d%^IIzz#(^V|+Vc4q(0$`;f$w2Tf3~iyAETK!5bI)zb}n?FZNl
zKJ*<>i<+>K&bTGJd!QdPr9+8+=@}Rs{KQv5eb2%C^w9(KJYSB*elnsKb*VpJz)u`G
z)M0MsErRO|{C)sBzA1J{#*V4-^LyjpoDy-=W)8EWKP0vpurKTp46zgWUhw^3Ke0I;
zfB(Q)FOOX}OZ%y79Y6Cn!5Vt35y`lOkC>fs{wZ?|I(g87BAH<h!<;oh$4=f5TX-&X
z!2Sj?&O!DUh&^#`&ReSSMvk>!(|%|D^fUiReV`Y?UU2_$zcxv9_6a+F;;6d>??Jy8
zv-JD%$)97b=bYc<IX_GCS?^Du>UTxY*zjehY}la+VskwH9DnNgp(kqS_94$akMVU;
z1$(<=uX)y?Xgo!e4?nC6*jvJ5*P{;C^5?qh+VZa9J!BZSU`oOk<m6tc)1#*ua!Y1x
zNA{pd8fw-AV|-Jv271q6JMBw0GmiLk>^LO*{I|Fc^;@vjGtfJDoc;E7`Av~-*kAU5
zJug9%WV}N%E(yl?*hliIy9GURKTY9#%(BJvIwWt{U*x~#-)xS>*JE#ynHqNFX{X<8
zpD6|(48hviFV_6?`>Ef}$=|&Eeazo>qHEk_=XaGD_6ymCZS2=n9cnT!^8xF)(PGb#
zBeA8!`K`&g2TKw>M%s4TbByC|Hh=pzeLEZ5s0q&Z*nT8AGuV<(d=ry%Yt>#PvJV~K
z_!8G~jrq{C?T$k__cqs?kN9;^{*;gBgJ%xor@XFuZ%p~0*z!Ts-=&#x8Dl$HvYpg)
zK6vW=a#mP${%4wWGvaJ;U(N^f*&sUS6emr#lPMeQ2RP$<;>>XzXCv!4AL%;#FjG2g
z(c-*>GYp?!)O2>nnU0y#fwP_)_J1pL4RU(IHO`ouy*->sVbA&K&d<^@#G4`ghW(Z~
zW-I6aG|bPONR!7+_8Ud^-@tzL1mm2a=fLjxsyOZ|?yna3zQcwO@O9mf+_&7v+{3`w
z*jAIzHp`Xbi|PS&r`TUYFDFB`6UUtPPvfoMt|x|kPc->Vk#44bpP?Vv?znGcOLd87
zY=(5$FF2;9ydvGWr(3^g|BQ3IbE@pH^gZ*&xcISceG_$2#LzcV6;t0!O_T&<>=|rD
zAZ_2$fpHT>EPa!8vGq;X_(luRVTdiNVm?8fW2w0W^W2!SZ^4@0VBN3+^eV`84cEbU
zW691Q8pc4Z>rgA#!+wIliShvJWslgi!k+2dx9J<W>sz?+U97VW!#M{wKsSsxv3yGl
zB;y%mAAZNQh{KPLo%v5czHvZY7c(SdL%zv*wmHrcJG%Xr**_F>u8HwUm+hp;2B)3z
z7Sx`apKHLi;F@r~xOQ7qU30@2dlAHSK@RtDi)+Yrq!u=O#ALAH@0zn|ZhEV_o}6nT
zxvum!1^)HWA3c~BeYsEWQ((O1!@p7==s-R`Vu)V{-2d39GZjO;`)8d`*Ny#bu?Ico
zVjgNxYY1xhM4pFOL!Zpad_Q}kePPeoBld?LV6ac&V-Jbh0w4X5PfsI2$A+&ba;#(U
zGdFWEC$dJ(ts3;Y1#4hkQ?z(TcfHT~&Df&q@0%`GP^x@l20Q84@SR}a2lbC?9}qJ{
z5zM<Z{}4#`F=fXOO^n2rZqC|yObmHVP_M^a%yZ6#52~OSAO;)x)S`AztfXiAsaM6B
z9kr0QeUklUo+Td;WBru)YOs%a8J`T<nkd41!d`e^nsmMkfO`nJ1$JWCL-MAe22k$_
z$5=Yf<9|cai=j8D57?h&j$K+Ku-10KJ{b1p#J(qa#xw4TA|3b!tAgj5=bC4{2;OPD
zlK>rC6GQNRgD(6&XuJ;&w#L*R2h4fe7*|2g3|y~h%v{X5qX+t+A2XxR74N>mJ1f|F
zj{#%+c|GKpfEpRwi5X%i=*7?*tbl%vZCTp)Ns`k=70h1*y|acI>&1p|3*v}B>#nd9
zLu?VOlUmfFUapDnMvfmThu9YLGZ*u>*aOB@FgLObY~VOzPo``qTQ=Z6IpO~KmNPex
zsn5JEK*yG2P96Vmab5DzGeu+ehrI&!ZV2|+ForFvVu){1XG?<n^cXo4O}fFpg>%L)
z_LJCK-jY4PXBhVn5R>Do#?S+N;CGkp^gcup>=}Ck=-667%qAw)v`$@c&rR>gPdN4_
zKjmisEuUW88#4Dsy!|!eu;rTH=;UOmX|TJ-Ogc7vj_b;)f_-J5r}o^GunkFKGUOTT
z&Zh<xL7k<0oOjI6J4){zzt531-b1{bcpkXk<T#h{NtF$-&kNY03g)IRpc{NJ1#^wW
zmTt1$x_w#NhqOKK)v0^mKFOTty3El;5%k{!)?;j&vA!I8iy@x9*}4uza9w_Wb9IgQ
zyQ1^=M93Du$NYwH-J0^qrziSlO-pc(0ry*GYHYAux5V}hMRCAf%xM^deI8qO`Ks7y
zAL$)NfX^}5ieQc2yW3t(?F+C!W=r>8TA$i8YEhRt=w}J9dA{sP_HD&M)wieNTNKtW
zaE@ip#a07!`-;Aq4d2Jsk&dy<K4PcX34iB*Bc1n6tYb#io{05;|0c5E@lEmIIgz$m
z+Q)bVOY*n42TSLB{5P`y(Y+;RNRP9`ccbVmFVoT);7DhGwr3mqju_+{`AjgM2coYF
zCC&#q7o0&p6RhdK6FkoaJuW)$d!x$_GqI&Nop1b>d^S?!JcKim%+wf)&N-mPdB>LI
z45ud+XF3=1dC;ln^Pwkwa&Gj%EvH=0uyP!=7$Z-xn<Cxhb=gMT6gzPnW4n>_{zlLL
zO(6OwKFx9V*wptM#N#g)*sm_C;9kl13%<7;VjDSe?{WX3V;ccFcFy&97X18J_Vlb3
zo{xB5YMc=k<@QvU`qaZtO`Z)T;~wBQr)|skgmbcVEbBO7jaQp~<K_cR_8Ud^Cl=o)
zK~K7E&ZDmNZzVZ1v86-hw>9)EXNqmop$PY4NuQ=l&)9yGIWFrt)^=>xH{U*@h^lX*
z#kZu`d{>Gh7T=_aAsrh&$5@}T?Et-t5|Fp`-8w}}FvjjVh(pJQuZ2X%2Kb4iHgn7a
zY_@OdH)iCVKGqK-@c1b%$2teO0^6F#XAQ>KiCGE8CrvgWXNn#a$rby--ZZiF?b{D3
z-@{_Z`2@OSur*Oa;#-1R-tTkInLp2s-}Ac%YIqLxHyl?LXKuX`XFrlLtVD@@pbz(w
z*XVV&STkos2A>(yw{U%GO>x@`_G1QH(qQXi9Q#vL2dKHllAk!oGiDzAtc@P3XzGVv
zs~B-M*mXW=I4i_X484=j+^$W1&w-t}XJEZ(?D?1zs5Pi3&=>Zo%YC^7?-0L7w&p2<
zn#7VrZVAw_Q5%0#+)u1(l6TT&gBfhe489_~ChC=#yVI)}nvZz_9UJV!MjpMeKIDu#
zj`RL=me>;PJJ$t&QBA|RhmHA~>e1&^zw8}*)&=ij-p501-pTR1#qR~bEkmrJROJLy
za*OuoABp}3ab|>0{1jc3km%Un*z)IE)XOZ5jqOb~^13L3b+Nv!bppC=Q{xgeNye}R
zG2~A{P4FCVaw*O@u0?*9TXkW+;231ib=^<0{`qGP*O}B2CBYc`4#~KPrS<m&W9+97
zJ2@~Pu)oL;9$U`CM$8+|JLQ=}Z_p2_#-HFG$PDg@ph=n{{l?Vu^(|eorlxNw^cBzS
z&vUEicnaQ!yq}s_de(vW6JzXE{=u^!lK2wu0rGdyR6D~QurAo{m~-5eL)|WlU`~24
z^fg5h^xH)Zcn^*X*oh&&MLsol(i!7}a$q}hiY=;oqBnX3`h8={4?AI7mR<fLsQpCt
zkJy_k3G@c^Sp;kD36GILObf^XkMUQ*p0<E-Q4Dh}K`-=ta_ezKkL04iu~O}+`mhD}
zM~3^yWc$CNGv5h)0QNkGdw7z>;zN>4jV@T{)_(r%Y3z03eofy3TffUKe*cmDRs;5*
zZv(|oYN#Hy^Bl}`(q)4Za!ZnPV}u=PmUM%yJ%I1G+-kYTih9J*GizY~YV0BVIO4vU
z@_AiI$Tn*6UiAC&P2S?L0d<URxA=a{<=C5jr1iOHY|sL)C;OLtXFZQS-zmwtG16S<
z#E|P)Y|sQflmOj5ZRtRa<1KAN0&(OO!8PPsHqrG=@c!og!*hXT%)4pekL%qcpBm`Y
zS@PjWT4$WO`Kn@o9>C)sxl5Az%#)cKXST+sYK<rMWqHPow0HOzTiVAMavke4dTK|n
zMPt^(`U?A~{p8&~)4q~J{tk(b4bWkS#74cQT8nGN-z|Dq0s7{BCcEcg&cVE~m(*cB
zOBCH_rXSDEIiB)o@E1WX_9WNDcS7umW3bZ?HN4KLK3OXi!M(s5s@Pf&5|+SE+zg41
z4Ii=W0sFze0Q-hyuh_Gty@MWmM|@W<_2`NI+$(avfWHXV1L)Yc;2U%tERD_S`|Y@;
z+OBziH`|WPz8>G)Q!?Xk^z+-Dv3<Xht}~RM*&2UC&avK<`z_Ad$9&kaS)TrH$NUYK
zIrFj)z5fMEIi~1r&ot?8O!?o~59fsWd~oPI5PU9pj(s-RbuI`qv86YiSB$`C7~jaM
zbB#=obB-CZaE9@LCchcdVT+p1KDzW36rE21W9yt(OtAybeMZ1}&(oPt*V)k<GyF*F
zZ}D$F*Z5X$&6&x0{iW|5_mrPwKIyr}lTMB7YdQ}!*^X|z<>}Aknd+kVgQ78<_S={^
z-wVDsEbHZdIb(fqai3+H#zk;HR>A$-5=A=C1J4Q1nV&(PJDxf08Dhzy#t>Ujw+rTA
zF3*PzAE3h$j<LiB_-lZUE#vqs@e>O*B(@xbKK0x6EnTshqVeC7>zw+Go=!Vs`;hw=
z<UI5q6v@Rmh8Uv0fd4l<)!O=&nS9TP%6E~zj~d@zd?)d}Bo^OT3C1;i!~pS-bBW2g
z&ek{D4A7yertL-Jp>MXzcN^bvqDLHkP_rNN&ah#}pTRaC@H*}H8dwL60KEvuSz-hH
znW1qe`?5~VPH+t%+pH67n)H%zKRwpYK6y{syK_(3S8RaaOzE%%`9Q5DYScyt>`f30
zJt&el>_^TN&$tM#GkqDx*zsqu8QZ69nXR#LkNBy%`MW^>_S5<Ip8y?}X!1`{73&_z
zr4DOe!h3;a&tV3>E{v<7k0M5_jhbC!YT~2rS(7~G!bdE*^hJ-HL2)KE)0rS=gN(6n
zL0pM7Fc0<Vhx=v=?y)Xbz?i;&;uKE~Y(Wo5#`I1v$e*!%<c+9{WFG2}QzFNC<nGvC
zWQ|%~am+(rS3Wgc)XlZA;Uk9FA;@DcGo@3n2<G+Nd0zS;hFt1Y)jOd!wSIckepbQW
zB2N}Rt%o^(@>FjN`UUhnwtdLwYr*xHqUl`>TXenWn|>Ggo!9~6m3|u>gMaAnyiye}
zcF^>9g&ES#l5TAKMmpyv$-mjL;cH??e_hhd=oJY?RIP=z^4sM-`O#TFf7dEz3u;pP
zjV1p#xJFa_RP8Rx0XBU5fSeQ8L#_+<H~DtdWo=x`5==?1Yd_{AJ~JbqI4FWzfR1fm
zz<zRz!{)dmJ>xlSa~yJ}Jlo49-@V@C&>AvTWA+HxA81Lp%@W^9k?n-%D$_NF8t_b-
zA>B0Th3A#`X*};m&phuI-UnOn1wildF38V5&pr7k)P>W|*uEh>vo$`+e)J}aVBQ)%
z^G=%TjlSu#M&G;xZ+K0_5x)ev&_iOwR|Drz&pJM0mT>N-hxBfI+8@^N39t1jj@obZ
zmp!8Iv-hdq>EAFmg>@;1wU>asz(&lu=1+a)-j?=@eB>Kd>mkp~Sikp&{etlU$60=g
z&wl3=&B6RNpeM%IjbpPM(c2D*k381jwU3p1iF-`H$z8wABfgi4zLEC-qxFd**8luR
zPU+Z3{C^H_zOCXny>XpXv&Fu;SIe$>VFu_$_!`)^Wy@<ow{65amZY(*$#!BNavk_x
zmF;I7<8Np&H+^QXlW)HzHdw-aSoV0AW@(=#KI_ylwq;2y%!J?P*>>uVLE`Izd4^z(
zT@>N#hdxD%eu#HXbW^2+YY`74k!?%%oWmG~*fFR3Kw@k1oe+OQOs>Im!TV+Dx!~Ct
zymNRyLUNA-Hez<Xi<q|uQ}V>VA|J44*0aP;57ecPB6{>fKj_Tc!e1jk*RbA?ezwNO
zd&Bsqdtb7D9Q)_IEQy~nZ;^x^U_Z$|>sb=N1#{fy$7hHwjI}rH5!Yzy?-$^jv489v
zdrT}f$wlu8`<QPD-+MjX!>2yw`!{gi8qWvw(??4%HrVO61gwKGphFS9uee{P_JDmj
z!M+6&ANLyj*0q29Z3pPswqTEc>QSFQVh{3r<J5^^jl{Ettz6dN{HAx!2)5)K#NkI8
z#%~ap{d^xA?AA}&6=#<8C;YwMs@5eKTerlPv3<&Jwsfd}zQggqk@GU&Z}M-kxn|aH
zv2Ql7+kf}{ja+|por03i3A5g1&&<mi;Xcj<o6i4iLpMGP%yOl(!m4u!@VUg4Zi>z)
zIJ3xbX7P!w7{l2{50>N!XC0XqW2BkVVGGV6MuM{llg}hNXA)wIrt=*b37_v&oeQ0u
z=SNd9nWFP8z-ArU!fs#A$+~lLKDpmA6bm`N#N4-e>_d{1$2UFK=vpJxkRDHsGp>Wp
zx@AkfV$0)G$Nw#!EBDc(&zdCqCwxELr0<)S?jLN7fqRU5tpwbUU2wm`5KR;@^$b*=
z1D+8*Yen$fmY~IR%`?h#*c3->R}T5q+M=qyVXhU>gY`G*UQbC*Kge~?__uLWFF*{x
zao^As2gF*pEV3EfzLg_tX1QfE*js`z>_cWdzLT1MyV0|s+$M_fcM0DePuyav;(>3I
zPmJ_E!#5Y-TYMY&d&=Kbd{+Tu*cY6KkC>9+o6DSbzRCDDo9TPa-)-26d_xdNjTZHp
z109NR{VcKLpTU--&o_v1{3)A!P(pe<BWFu~!gCMx@h#4wHgmN^k)HATyY|XdzIkJ8
z9m$@aoObpenkd58Y3biyfNRwSb|8k>5o}5DydGzXuOB%6W<PTsYkBiy8=?sMtYWDD
zt$zoa{96$Jjuh*`-xNm<HQmFMp7)wDe&VRxqb~bGy&g1;@lkW7ny!cJQHy%S3_(1-
zR6%dlq3%qz(Xru&C5qyij~dkG{^9SbDfrt3&{sU`%*|Znz|Xw04c%Mh_6y_!zABnx
zsk2lk!+HQ4b<K!4eB`mO)Yvg6HC;RF_=%fQmpWTL&%kRyV#Dt_$SILOB!ODYPhad^
zV{bVJ6pMdX)EGOph@l?w<kDZ!J~mO~eapMr?`2DDCE%Ux_pT*AVrGJ|ZACh<%(FBn
zpl^YlxGfgH8~RNdRbx^0cZBKEGfQKG9UXb&$@gS;jjDQPM^C53k8OySDAHL=4;bSg
zi7lP{ey}t){%%6r_DOc-*I;W77(tWFVBdmx@@_2IGmfdU?^M_8t+8gtE&Rk0Z>VAY
zNs==}OO!)rY;xTHAG+sZU6~&1J!O?0xUauuDE3B^J;U>2rgYP#LkU(q*QeyU<N2F{
z_W<varFX-Q_YRWr&$~rF-WOGIKs>BOQJof0(`@M{RdYW<Uzr?79qKkw1oP8J74*mZ
zu?qU;JqPFpA9OK;qC98;cKlU1&k`Hp2lB=Nb+FMB{n0Bu?}NOqC;iNM8dKji=_O!(
z=%R`pz0qSyFdl-K%#sb?j&%?1WfR;R=tXvX#7*TgFY}ur{f7O>BFH`IVZ%?{2)1PA
zY45VV$NgrB4;|Kl?Uq%3V2ot$CRj7;Z#*ab?n-uz>3hiUoTZ#Mdeo+Fp*H(XE!C_7
z$@dYz=}TvT^?xYt|CauL$u8MsEBwamdU$T;Z>|@*$Luq4fc`UQig6rv{6MT>?3|$(
z*n;(Du$|cNH9yI9*)!f}*?!B-e(SgQplwgmxyYxO)BbHv(>lzQp4n-Po~e5O12#*?
z7ulG<2kiS0EhJ-n#1Ly*=-8_u4u)u=gv922q*<vRI^e5<96-mm9>7P;h`EX+_gED?
z3qS7|Jr5<Ak~|;0e|X+Tyn9;8cMa+oY{U$)FW`d`<UDMQt6)C*nmp^wuRd<?LTZhJ
zt#O8R8}`90>EN+tmCgC+fNurpPy=Gef%B1$J0&#$yK6MX7l9mN3;e`!KXEV3kSlVD
z@7gn9{}|sGQIA^W-oRHAj2*}P;PEN(H8CG}@?kH5YkGW2`;k4UlB})8y4iyp>`xU-
z_Z9daLozPxUGU@6eaADv?+#SmgH>^x8k%crUV7gmzbl5u*paXk*y)>mdUhS+y52iQ
z-?7jV9@~dpDK^_rowyr0uBExGPuXs4*}=XRxs0*bdS}S~#0no0%AbGel5aTf8~Iiz
z`{ps{TWxxU@qqo7)IuMD?MTnl|J>I+Wj{G%Pe0?G;7lMhG=5_7ckn^gS%T?F$Hv%9
z>A;ypOAP6mtua)cOPJ0X#lh0}q;QTQ+QHNqc2GIv2sraNS+YTivx+HsvSkCGLk!L#
z#1>WOHqb9D*)oMQt)NMoDIIpA>ijA*G=^+LC&&3uGS@{vYrKum+&qVUZ~58hc;ra5
zq~{pxxyGA*iyyIX$TQdRZ*rvGnsig7!_+kfkKg1O>v30pJy^Q8ZgAgme{#=qkLUZn
z%4V?h%<#NbJ&UWVN4=l<EvV8P?*jRVA%}Whb%FYZak+rqF;8+UCUeGh`AzoiBkwlO
z@mX(LpBd7@<8S2u=eIg?Kh+`UtnHj9xm4Q_WBuQd)PpAIZ3dlhj0;6JSbUd=tPhQ=
z*nIB@B;y;7DT?X(Myg`-y>tPe!9PShz=n^wp5mQ{#8008M&Nsmzg+;`e>W_ByFt}A
z9e-04<rv1;9dpJ}e_YtILGH&rIlf);>_g&*a$q}hL<|yk;PI0r?#b8WD}uH6FYx{h
z?O{tW_I?rLIBfWu@HOeW9yf~YfNu-($alRgu^a4N%)skmjJ*oSB1eFZkC-XQb1t?_
z)i{%V=&noO(4s$lQ@FO}&|Et}Cx$%!4T^tX;@_Ws{tZf!aTE9^F;SBoXv$xLI_TKC
zsKR~G54lAQ{)Q1-HDN{FarC^SHZ`dYOLRSNJliAQ13d4H@sY#aCFVwA!#5+3*i4Ht
zex92~Y}6nh`UU&!--;oZxt<vE5ku@uHPNvFejpZ>V9oBIesj<G=$km_AhEGdVu#qG
z>z%n0jIk2~L-0-|rs-Y01@G|nFTn49kH61aRow*N1yKL|BeU<+o8qSGP><dKeTx+}
zsM8Oy-5_U(b^$y7Ti(q^Y{oI!_M{Wr#k^4To%Duth_QZ?J?5yAFw}1o?5ANLu`l8H
z`RBjt+D1MQH$)52Gf#HMEXBX!IAn|3NJGCs|JJi~oO4Iic#=6j>$&DlpV0%d2SxIU
zr<mKb=KH+rUeEA+nkgNcC?Y@Sj5GLpdiHs@@V?;v!#msWYTnoAyqk-BGu}_UUwGe;
z(-Vx%lwQ(%g?9_=FRAM9hV!Xa1oJQ_{m@qvtb<<Znf1_r4Yt-}9s9aKUXL1EGBd-6
zAIbyvBd4G*dhEx(u%5h5uFH)abL!M!KcI>70DHy!>{o`q02}_9U_9hw4MpVr^4hlS
z#E?%e^V7#jFg7=Pk^h|6weXSaye&O*?#FM(J?;5QI(3+*i6ZC+eF)F7V~ovUv%jZ$
zOS;MStXIXrih50QYhJKkq;oyE7B%i)u0fZ5q`6(o_0F1;Iv2KV8OL<lf$<j1m1!CS
zwk7iXr{2@Poc-ne95<Eo1abE9u4{?>?mP8w<8mJJ<S{xnddOhAL412)$PW7j$5`fA
z+nVx=pr0z((<ZoXNWcb55JT(@e8hm`oipWQ9_BNQ0bj;;`+Azswdt=5-bX+06v-C%
zI`3}iy61oHfBA?dhrZlfRoxrRVV?ZdpxzYJ26V$X_eLM|2k2YSH!&sh+Cy)7{pd3|
z?e$?j*w0vx@p-N1nzs7FcIJC**`uEs^RN!q&-x&*j~wEfuKP$Z=6X|$ewY`@n0S1E
zUIqRZF^s#w2k7MDrw{fx_rkjH6HCpO@I02;hdvS>pD}OaqI@`e9nmknov;r2t?D<E
zbEfjTD6CEE1$6A>6H6}hGXD@eIKLH}?8Lx`m>z%IA&KANYmz`5_9dFWXJG~&-y|_N
zdkMScE#{MLrXJAuFR4{)3WlUv(lg~x`QK+^-{@WOC%3#ahVgu1%V(bAddyuU%}VPT
zNw?i`-^i}IW+ojQW3!WP8xs2yKj#3P1q4IVEa`7>u5hEvZl-iobl#BR{9y!J@<!!+
zLi7uqT|m)U$4Qe7X0Ro}=OdOw=N_;Qiq0UQ2R>ui$Js>Fc?@tavx0n<!`Y5`IxlMJ
zT*>;7Z3|0u@EKOuc^0e#+q0~3_T?HkNsM#WOU+!Xsh@IyZ3J5~*LD3<=9=U{u3;PU
zsh(?C_E^suZ~vRj^P!J~eYQ3Epd3tHcXRq~W5-(dbl;$3x2;O|y~ce9O>mEL9}n(%
zJr`9Vo5t9<|B;M~==k*9@r*aUBUb$f-Wj|DHqWtQ$f@ys6wLuG@Hk8RET>{KJI2T-
za{Qa#q89Rr5<cYAZ|NId{tU5s{9B#;TMgU)R&LeJ-0Jj)-iz!fE50{=zB%~rNNm25
zG)89l?tvzX;Cl+tGx&||oo^?x^({4m#&=a<Tb9HFxhugK`#$Ovji<iZD&KDU+W^q9
z;d5>Dp5llx<cx%C5Ko?&8lT{6!H@)x9ZQ{z?OEE-+-E=Z)>40riOFEQK}=0+^*pxW
zC$EXk-+h9=|B6`pTM%lnIalI5De(A|#E*pYv8{mmrb&k>D*Z-J^kuMZ`A;0X<cASp
z2jZ#Q0(5MSTZ$=M=eR~wGSkC{pV$mFYJiUK7Kbg<H3n?t7kbj3Hc{AHo!gnAao3)?
ze`0^)V-3tn4gADb<qn-ILPy7@eAuCL4R++y#}r#|-}?S#jISgZ!xURM9vwTqi~zmJ
zHU)k^6PC=gVm|y`<b3M5Mv)Kfr}rB3khg{FqECVS1bb#{Odfqqy<2#1<#!miOxM^w
zkLaDT!G=y8b++hwr>+EJ?D&bR;uhc1yT9u1FW6!8c*vGn8lRM^b%`!!uq88m7d%1S
z6qWhaGizjD*+<sOI{2NT58{Y-Ep&qqx}ZnaLLU236WH((L;Svg{YIDlMv?snu~WF;
z@ki?jmgK($HK~P!CZ^`?f_1WYH6(fo-<Bj6$TN($eDk13UXcW913JEW0sHB*?M)Wt
zf#<Lsu@28m%r|vh3weVYwx4r(&Z@aH+((dYH{Ef_d7;Tx4)Qadb?#@VV(Hm{A$U%9
zJnK9+Rs6hvc#iZg<DJHP+3#w<qw%$P-gxH7gK=TWR$>m`DKlW+|1Q+(q6ExE4^_}t
ziFNQ^W-aYtXl(Ek*AvborbVnJHiNAk;M?M?>H73WkMzqLSPSfcYx4<TLtjU7U8hSg
z7uX|UUQ?x?*oRyJF-<+Q2G#{juoi<Krr3fU*PtKzng`fyw~j1<=l9q#Gu7GBKXL9S
z`<KC=$63cm{lYw~P1m-^v(dQrve73o&RY-lu%F~-)4q}NoAeX=ZTHyH_AKddiXIe6
z`sNy$D&1gPf;i_)>97NjEp12UxzSJGNNcq29LIWm$}=9nZA&_^ubCe2Ld!SbEhfiX
z_dK36OUGDdpY!bNM{kU$IN$TPF~0|Zj~sH(`izHQUyI<{{@lyyImM2@MJ(~Kf~vY1
z+mW_2_lbSCczoE0Xu(W9PW8t-hv$rEZs~6Z;CHFWHn7Kgs413s?qBZP7VD`|A9-Vh
zABmqmpa=4c=&A+OMJ|CI&;ff*FwQKEiJxK%=E?IejiG2ijBQVHq#B=Mn3K7iC<(^c
zYpRv&W<Ag09+BA3IQzT&^C0Kc$i?Q^EgfdqisTLEC7(60_gsJY(PK@-zzB#p*w(>q
zo;O=RdZQk7>%mq(^jQS=LKpNo)Gus-?Po2iC)b*hOAc!+0Xn(VWls9xT`&%8Lr%pQ
z+n4NJ->b&orPvKN{PSOcI#1l{6MM5i+5ByebPP2Nwj5)<DSjljbf|y+p-URuek+}C
z>3okZm*&b8{rh+(`%b+_pEdg4mo;It|F_chvs{|X<UVhDi?w8l4l}W(|CV~35e|)E
ziK4TIOxGA@VoN`1oLdBg^9ivIDrXi4oimSMN}8gxjZD)RMzAF_Rp$uM#X2ZDhXKxG
z%;an)*pi&zm?7OP&UM7?e5mVu31+Y*Gfn4RPYn4^Zn3#u)*b5_d2HR%c{BR#lHf6N
z2hJJMA7lHnB<GDBd(&Ol^JPiA{W*6Yb7mj<>3<t{#h(<}%+oc`e%~9GBi%PuI&g1+
z@3kiV=l+cQnR}mSh3BiqGgjmI!48ah-iRrJ=XdD2FT4lzPBBemeAFSQ#PhTzd3Iok
zC3se#2UGHIag9^fnBz^-i*avxjE&!5*!o>Iwq-dK12>y}Z!+hhpRrFi=iTCOzNOmW
zc*mU5YrV;**csn0T@p&L(l-;jznl0bf*s#S9-k7wnbJ?1Y>@5yl0!@pOW$dH&l$ek
zPWW!KjktAykC?&tT`={xj=|Q%7Q|8`gY6{ym;B&<Jx2CRF7u3ld5fSI{{Djcfiq_5
zZ?_EoDX9BY+wuI}*TmM}f&5)q;%`IFmrUjF#57*gi6ed{7(=;$eG2Ac?xOza6Lw;T
zjhG>b2XwQf7sZ(#IUe7nW2RzZ3-*2lOA<VOl1(uujy>%j+i!`T`RSvJl3;C{eG=@m
zDY1W5eqsQfxURUZGeP8Jta@8aLEMg9Bsn9%$K1pLIyPd=kdDo9^v*iGhOQhlrEh_M
zi5mAm&w#;(kC^rVK0^#Osh#UT)y95fsgA)v1<&gUw&d+y)?_D^+z~YxV<(q9aBkN-
zl6Pqfrli4E5{&U}QR6+oBuo5##otz$t?>=V+<dL7Pq9SRH^3A4KgFE6&apiGjPZ>N
zO*Z;<??`OKt^{N3XDnmvK+HPu+}QD-G5C8hB|qWVo2<%T$NYIbV*V!Sb#(QgnHuBE
z5D(5rdW;0($?c*f7-QeUu_JOkMq>K}anv!4PaD1&IPNAL(-m6+-}4^hn+MoT2^|UK
z8{1CVBR1QegB(GX1fEIo^Xc&^@fWf5-1F@79^k!DcqiyR!8;?rzw$c_pZ#6$w<3^D
zc5->oP^U#bbdR@mU_QhA;PEHv8pv^>$yNk?bU{xmdUo&hy5rqU|NK_)n^6V7MbHwq
zWx3Pul7DNc^#n0Ft}E8e=w(aN8-3C@>)3)lVUJGoUg67QbaG(?O%lohd-X(@&*T_v
zRV?*N&$;hxXKf|ciq6`|A%+_CLQmsMh|QE^>^eK@A)m<m#r|cM#$a2G{cNg7->iYP
zv;dtoO+k$3B##;^!Lw(w9i3RHA8_0^a$V{!^#~(q^sL@bu-nJldVo%>{UhouN$}Vb
zTV4}==P^3AnP86?d#^mkMl968<Ein<>2tlN`foVyZzMgO^X9&&`82oZJN-FlD1Tq@
zZ^0>vZK4SJstK+U*OF^n1otv5feoLppVvSg>J702bkn4lfE;venbYqvlAInr=Kko3
z_vFtzCEnS*iw*DaF7WfdAvUjrTEKctjk!D@V`Ce!<Tb&506MlM9FLCuj3Mp@@#HcO
z%m=(DPk!6q;;3(`bYOmCo9*t`J!U_8e_+ZE?uEEK2lgh0*a12;Q4X-d2)5)6`-}XZ
zlQpyiV^{~aTQ>Q94SlW2sagwAA7;RuZ#a$|>M##=r|6=Hs(YJzmV4LV3XFg5dHFp*
zHL9RS6V%uO9h>cpVF_|t>|58j;u5#-N__U`n5J*hH>Uh%OV6Bk#`fFyN#=O#H|aVz
z-)VDfi?tO=@EAG87PbDvkc9O>`BVP)f0Os5J2(6Lk$1-6H&Z(73-<LCk6wcH()Z0r
zUbedqvLDz-ymew`uq8jizw?_R9o7T(KgpcO*@5ZOVJ0|x;B3JR>1IpMaQ<MrbXWoB
z5~guBabd~^`$FaX;(&7kv!p}O`Ge_k&S5#@ykkpdIG=$LEY53$&vTGHn36sZLN+lj
zY}riJd7A0czrpcO@|zlOF;8{f^Kaz%#rmJ-z1iKvt^RLpP5pgCQCx;={e<s_EUV(5
z@IA#n)&%!r7e!Rvw>%F#E0yO(&lRBe03R@}V({#x=agrbXSay_d}D)+ow~|pE}k*w
z9mjJ+Pln!3>_eVDo<C|*dtT<if8rXao$&~&<bM#q$NpVLR<YAJ(2x$c;Xkp@vEN8?
zR&ds1oPE~c<gLbO%lRYL^^I(bg{|+L8Su^XMv>p}jbw&&@c2m*Qv<%gfH89NJtj(m
zv9X<RyPv;L_**M<#`ZgYD%W5ug7_-<8)pRQfc;j7Ttkf$eDeZ!QzDQ0&_xyQqiOyk
zrvDBLX&d%T*BI&p_Ro}O+bw75??D)%1)KAxU~=Y^u-&rDw{$kef4{c%->xBtz*gkL
zPb~GBpI%to5L>Vp-jAj+K4OTaFGGF?J25Z?dE^_$U>`cZ5o}5D{5`JCl7xKS&}~0u
zkN&CKqBc6UGd1FD%Q5Ihuol+He$CiBBw%au0WnK-#e>&KZTg`{B;zLV6HkpUN`O8E
zHC@lO$Qy#bU6Z;7TRp%AOL+fUJPY1K{59gvSm(USsd`)RJ~8>df*)E?B<Uy5g`b=y
zc&GWjm)~#Hc3q@v=3Mfo*a12=>Kew_ci?v~?`huWJu#(2Nq<)j>A>Grrq=(`Ph0k(
zLl2f@`E%#Vhy8D0o_655U9YQl6|9eSSFyA&V4Zzx0eV+Vi@hM9TCRIae5b$t`6nLv
z4X#O@E~;S9>6t#t0XBSZZ22L_G>tR%?TEGX{EV9@!8qdZpSGNf-(ZJ+VEZYZha3;&
zn5;X#DerG6$^-6~8}@&a&gFgr?zw!ganCU}OFA%ag6Em%x`?6YeaCx-cP8)95%1fr
z_bd93?RcLy<?ucM@-w`1sLOk#YYt$({Q`c|rJs~!LpRI;%vS|{&{Gk-JN^FT9a<AR
zek1s;D6#Gyze&g%@Y}*306O+5$fE`|pK1^JiOXQyf%_pJ=(&k4SP$#U>z=U(*t}lW
z42;(W>`(=D4dYKZ_DN3FgBIlRioIs7tl8^k&0Z_<ThPZyxG#M6+h&P<igp1z>>%e@
zM|QCeuo?T<?{<OfVenf=?qiIti6W@W9Q9$Y9OF1*4Ym~!OI^d**k(E91CNVz>bUMF
z$$k#eLNX?&r+!xIi~7KP){%}OFN59j<ji18W^8Y=8{1B~QyqLQ$Z^Cxk>jlASZqy{
z7w{7Y`wJX<i?8wib{)pN*O4dK4L)+H*+dcSeGRgXjqwVICyyGgXSrni4dm5etL6#w
zKoiVQAKYi$bG$p6-X%rv-~3Ky>~}Kn8RDiW$^q+x8c~zlMRS}mFW8=SdLe(S4xj_}
zCCDM(IoR;kkm%Tm%dy1IU`vAc=(p1OmNV5xZ-O4^<?N@(XNZFtpp(bCi(pTCfZk$H
zh=CIM<iQj>U`<ODeY=>E?u&2M?0Dn}`OL+fPy}nG_Yu%<5xzGV<J+PtHbX8oTGZQ;
z8Rj$ea?@=?l3N6GFeg1!_E7h3*S*YlhVO62*omRHrJR=fn9><zr%#|Z_B`j%ys!j&
zKE)PI-=j#z&;#@>@Q+|gg2%|)7@Ohy+xl<iIOfXZ-`2Xt=X%y#n)A%@-x6JGnh*GI
zu75+eKiYpW5?eY{ot0U?$)T8*DAHjbecOJ@mU7Xb{6juN+=+c#K6>s4{<nSGJ+|cE
z|4;0*><=}a*Hi;$VoQh0xkSJj1gwLiGY06vl)SNJH=IeF4B0-h6k~iw&~;v5rgZQ*
zL({p%$&k%#>85f97<9=M6rJ<5V8$8I=Ilr3M=*jVnJGH^GyThRK*u@nO%gkUEeRfH
z*=09H`VITDbR284j?8PcKGHs%Ix)`gsh3lC%uRY8B=u{;W29Nq!Q(7z<YGfVrTs{*
zGx)kATcSuezF&~GA+x>5{lz`k1ovtc+|x~To*_M7JbU8;cKk(g?Eo9kCNWdb{EBxE
z&p);BZ!wPNEI&_Oy#RfgqCQXP-8SOLse)Qa#xM`avCT1-Rk4OT?lafKUxa;@MZd+F
zso(J~D!=Latse*2@DVc)u;ByZjBWUDOxeGM{HNHwj+=hwQ7cn5KJgl|9I+=Yq<!RC
zcTAQ|@v!wR1vBv2GRHWsD;7$y^v%XMUKLy4a6jL1e9H-J`0QtFY=4u)Qm2U`mcA1K
z9orN;@l@OPH%T4pWpZuXn_{2@?y2)_D{5lv+ZJv%`z(ne|AzBj%Q=?zJJ)0TEwg>7
zuOd4C?#I7_K7fxHV#(QpI-U#37&{R24aB<6QvMU(XZCy^V9VIQWruvdZ9~q;E0R6>
zN74f}bB?jw)>4g19_xv{L{7mzu+A?3ja+N0-cC@z2=b`IHQ-tRwVQ0%k=CnXsYx!i
zy#8@KgV{%n{gz8MgRLHrKNI+g=e;n+PB6C3?;XoCt}C_(YK=4}IyQXss5kT;Tf*-=
z#?;>_mN9l>dN3tn2aUf46Sm)^<A&nbLDk<^(8Uy`{wGbg%+MIJ4ZS27k6=rh`bS|2
z+by&2)E$Eysb;p@haXy^NN1hw5&O$E;@<H6#hB~GwScOaqFDBiy`kO~XJ6;I|Is`j
z$T`%6A&Q_!t`pY_(5r0N=>v!}O?qZ%Y_JngE;u*Gqn7}`V{AKP84q!@+lK!ZgKY<n
zv23!J2izC3U&wyzx46@Gi><29o_pUJ{}$(;a>O-llIOEJb+2`?bl-6w7SVN2*1-2E
zW9;hy8`J=OiI(nX?t8=iZERa{&vV~@1M%e6faeB0w!}6?6D6QGL$6h^#u3jX(lqHX
z<F{$0-;=H17sGFjb^p!`#S+i&O&8QCQIGnrjm_9*Ipm{1`ehAUcx}k>LXJZxH#09|
zY~Mhgr?@5`6hYr7UA8J%TV5yQ9pERA8m@<&#~A+&VzE=BU&wZJlWS1}MzAG;aT6sZ
zWAAm>KAR=|4aXsCBHQiTG1pYDKl{YJB)G?_;NC-Wzirv8;@ls(kmvZMJ7>haMUuIZ
z&<<=T#yD;$cE51;l4Hqj3C8%@7g&G6`F=TTxb{st_N?(VZv2k_B~y7O*C^>7>3)#d
z&$w)#^6vy=;*039pGa~%X0O@vCQ3+b`2QDg=X&N$s&rW#n5zYp0pkOvU<#&S3Z`Jn
z?4^!9Ck}^{RB!h;Kh_gL+z3dNN>%oSJo0Z$*-wbWwiA_SjKFqcpotQ=r>c3GpMH9L
z7Pz-^_KQ9Po!?>U`F~)Se+uq3e0G+o$|WDHPw8IcP<`eB<~-@KNA8FCBB)^)n<gDb
zuq89D@4CqK2JZ`!eVSiFER-P6!JJjl7k!qX#TYyO9D|QIWcH7+VJ|_Cy=MQp4lSs%
z6TejZ(>jRRQICD5HsdZkK45K@UZ-uuRYA^(I=L@;GxTU$==g|dZt|(+xtivki7ow!
z9GCT`oD$G0b1)x$a9`)FbDjZx3Vg)ufZiAbI_v<wixLw1Vjnc;h<^Dzc2V^F2`!#W
zvF#MccpY(5v1Utu2XWb7tM>CC`-wkkvYnhUjCbTBe+&61uHk-%`pztkq5S*{+eY}_
z`H3;aow2!Y|Izh2n8*0^GcLjDo3aCTOY|p-d^d9Zj9TyHR!r01@L>c?5<EsSuKGKF
z2Ad(~hW*a#ykp=U!a?D^!$H&74C!V|uX@*Dx^%OopA`MQ|3;Jj9aH|y*4X%6g5}VA
zgBAGQMc4a?%;fz<uq98L-rv9wE2w(M)5Q#m-WxSBgUx#+QT6W24C%kYc~A1G*5Z9#
znyX8{QDuL^{aX&L1sEfnD1rCjl=z8*5o}4%>7G{fdrJH3(I+)BuKgr)EVVp#d{ezo
z6vY_U*@G(SGhxX&$+Tl^A9mopasIj}g7eCGE}UyVQ+y`5=TzyU#Jz#fYm3hupEKfH
zFhla0!$%!r{rN`6PW%@Byxb&y>Vabi@8i;EYlV)j3gTMI!EW$7=B($KQ#vQ-Q9o1C
zcuFsPA19W+uYvFODz=^}W`eQ7Z)`(O(L@nEE8M_G3{0^Tp4YWcIif%03T$I+{ghR{
zOrG<do^!J9oEdAdY#L`u8l#)rzF_MIRb#{R7Yxxv5tHXRQ4@?|2E-ZiPV6I|yn28Q
zrf}?8!{c$OZ(lk3U3wmE!Qk0cV0%aIjW}|k1?VftvFQE4e#d8NUzTS+<M{w<1=j9$
zQ;Ru9^t$=`i<lwNTlk0}7RY-CF~ma)T-y@+3QF|hF%p~U(ogI|I&Ub?xW+Ay82Xs3
zFJz5e*Chu3((iI8(t-FLkYjzy28>;6$xl7^z!)FcH|5_4*vKIUMo=Z0qr_Z{fjL`%
zpZF3rs6)LSaQ#QHB*CBO+h-j=@#Iq{gAE^f+++4H84-_!CT84Um>1}c`q(oi;<u#l
zgI)L36MWgWH0C>|i5YCks^3ZG9NYdRhjMQ$*-fdMSM*=t9Oqe1)i~L*nf9agC5Cj!
zww>a$J}<Sit;-KZuutrN<67y=aqc)DTr*#v7T2c`E7+$hnslxO*9ILMbtiRy0rAj-
zBFUaJ5A#vGBpA<NOA<#sd9E>~XRs4f1-Y)lcqAADbu+{)L7iOJI`)$y8=Usvj9r7d
z-2?gwzE4!eWZuQ+IQAirf1@+U8Sj0aaUF`J&(Y9X<J@t-;NHRgsSD0#2_4%=_ZH47
z@iRdUXa_@M*l+mccW%|W2aheuZ=xg^XY8YAdS|Vy3EBbcHB)+~$DR~P_UOiw54-cH
z^d02+Z#Mk&xkQcrS%=q@*J*ud{owH_i+tV-_TyW~dBQbLKlUQ%pLJBh`io%yM(ktL
z82b*019Fz2#tHU!kP9_IedaNqFH7Q`yQH&*d9XG1zM|*xi2X<A80%S*H{a0ZqaXH)
zXO_<MRlM`4(lhvqVzzk2Yn`uL<rmeVmgm~iPweXvd&+Xyi9chW#>B!7&ON~Hn4V&Z
z8)+Y%hYePcb=y8k-&0O`%cDND1KU^han{P?9^c=8SLT|Y_a=#BE+qbOkaO@g;p>wn
zcKn91ZA*IY$8$2TnbLvp9whb}pku?A!3OxD3g#MubHeA6&urn0>$AbR=loCc`kY`(
zpYs_yIl$*)JV5QDIeNf+@7VGKF<p?KYhXXwvayH2n!aTzHp9Lc_URiO?>e5lsWyGN
z*Dk$?+j@v2-Z{juuT608;U45`;_HFmwU9$pF(VJjn0cv7pR8vl7-PpzZ^SbvkWWqW
zbAP$dDIa7%<08o2ssYpmY_LR6xkK~AO3)Ym!4&yCTW|3kc1rt^<Whs$^hs~@#J+OY
z*-x|MUhlQjr`Lk5h^`z!$5s`yL#HNoY)$hq{}w$x_oDM$IgZ{L6YFPA;>=3<Pdc&L
z=jZQM)ysi>jwd%$H8!?S+04!6nwHFI{gkeAlf;q>BiNGP;P@<ap6#~PAGP>~F5k&-
z;+OI>XRX_~KJ;^o#kSs1^ga)on129yPf%|Q-ZzYcrSVD8JA_Q<okB1r&6W<0_YJ|2
zgcUN6v3;WI@B5jqv6<3OirzUu3x;H7YYbKIU(Ar6S-hJOMel4(mku-7l1=Y~VDN4z
zsCs|Y#pFGb-a(lr9mW?p_BZmIy2Ma3$9jx}BIq4hM@_Is#@Ow{)`a(CNH_Q#Kb1pm
zV4jiKNzZocP5yE~J=0S^*566zAstuf?*Z0fSX&KPGv}d+@+F+Bo~Y6}k3OSKIuya#
zuHyB%;`6He#i)NtKEHhK_&oVDL~I5-{uWS&oE{QikIxYEWoFoswzudFIWA;Bc~#H@
zpt}}vMKFE>|H)HqSDg%T9#`p$XNbg*ZZ^*r!IZpVzolb};&~RTJeTk+Ax21a>_E&4
z$T?}UnVEXn(xIwf@Yr%5v5vb*=ls)>9$HW&jcr-l=e<C(H<_xjVK1SHB6w!&JfjJo
z*9_wu#KH`yk?Yu>V;qZgEIKh@dyBqCNRP<@=g{LgXc`00tTX761{;3zmZ)idddOqu
z*~0S=&24PM{|%1M(zTZAp4eyE6vI4IbWsHTXRw)UN4NcyJ=GfQhuCTF*e}M|ff!@k
zDe<o$&u1Hw7^s5!o&(zw<RKYXK_5+&0DTMmfWGv*eCzL4O_X5jzqx9#<M-dNrgEsw
zT<pUW_#HE)Z^8BOHDQdsh^2ZNY#HJVc49~5Fzx{{TX6mP%;wLr^(ni-wiHWz?h75;
z62uVCy<!XQW&KOe`yTl)f+krKj9~;@(lwZKC5nFE<*{|_(8LrwQT4lP1WOV;wzS>S
zc4SR3UZT{0agOozH{{%R`mM%P-7VVBe}etSeCP$cIrD7q54pBG&T>Z&j7y?R$F>i!
zLBCLBJ7KT6232sKx!y%^4v>Hivd(yl9gq*yGWdvTq6FvpvK>j>6x3P5z24T6ZH_}?
zpBJ!aipCk{gORY!5?>WtJpwvl&)EJ>y2efByj=G;x@%1JS?E>QlY2r*FdkwH{D$#6
z$Y}@IoZ~u{UA2vEme{SI()E5L=_AuLE`ob6_uv|EPxigpI%8-_q8q*w_>SOvqYA$F
z_#U%t(u?3bt_HX7JAc1;o}oEvfWAcGyCQm?lCTBq`3)oON6w=bP`8V6fbEGX-xIf-
zqIlNC8d-aZJ!BuzTYztiya!M9sA;GT<UtLnm7#u16zPC%iXD(ooh6vVJ<M45mh@ic
z{k4wYIY`Ibk8HwmMKQp9z}!GT^p(#WXU%X1@wJE}zD6!}x@yjte;<<hfnJPl#FCde
z^Yi#!oNFSTW7|k`qpuhv-$5+Ai#dJVTTYwD=Y8iKJI->%{Fb&`=KP-Seb%RJH|&3s
zHQg&cSC;lWpK<o1577kIqKhJY-jJLhSYqN+EcK?~dj!z2)sT#DIKC;z<b3CxaUR>>
z(|oUf)Yq%WxCiIYLr<Rxe;!y1>tww*Smze(3-#YYj3FmOot|I}TR11np;{}bv7hgx
z_W?O$Pfi<l@E&GqUzMMEnV;Say>?Lqd**$^zAv<>fh1-qhdrO739f~&4fiR0uE`wa
zxCXr}(WC!!4UF*_V#%d1>X<Iw*tTOH;$estpkpJ(I4?_l#1RiGQPmgF+YIu)TW{%e
zfIco@FM>MM^gPVj1U(hOUbD|7_SxS9J<dA&Tm{!*YVT{h7U*4I=bAKXYA*WedX`-W
z*!(<+WDGON&(T@8|4BNwRrL@I$rJmEeCDa9?VsZ8Z)slZH|coSx5Pfg4)|MkKUisu
ze@E<y+?#X^@zBLeFn*%ScO%EIRLi>kHRaoeTo2@!tmpWmzw3XZDF$Ye=${}5$^o`1
zc7k_<W<0zjEP9UsyiYJQ-Yr;ejlu6Ac<1m5-WR-szv(~Wzx!u774LTmP45*>hHPd_
z2j0s-epiFO5`O2?<2}%pgr@gHhWAC8#k-?;?=*Se6z{co$CVixn=Reg_D(t$S^v*p
zWE=W8Xla~v;uvR&#u?U;$v*UV>umCm#FlR89sSc9nqo>K_mcIV_C4Egx??R1*DBx|
z8eiMWbrt{b48;3D&PzT+K0hV-ZOgG$d7MMeWfSFqGtC+2v&3hOclQ3gqGM~vXDxrG
zYWfUiyLJ1S1Ex58$YXjmL;4erDT<+HuAk>1j+h(7olvJ9V0*%`tatF89yCd_d5#c0
zC?T<J;W$fd(1Rkm^vrNFcrN*ps<;e!OHdn_YbF?D2lN?iN#lOA9BJLQJ059UmS;|m
zKlPb<LGMA4G_1?8&XX!zX6v~PCeLr8h{bcBsAA~3tz9T#!@vK4oX0#T%n#UIAKi9K
z`>AJ|^r^pHK)-;!M7(RVZq{!Y8{4LAH*Wr|*u2ly#~0Tm$67~H6Q*cEkzCprKz{;%
z7d6<ie)fvJ@LpBz&C=f!hiD1jr_BUoVu*c$TF}J|nCqO+ac8V^ES*Oja|62l==4<t
z{}09?`2R9a(L&bve=`zC-{fxf#NOn+^IjouEZO1oRoSQq==j$GHrw;{!&Zg!U4xh@
z@>$6GmhT2R*oV#z_XqA5GuV>84{;A#iK^dbU>p9ECL1+euS+k2xeR0MFoP{guIsHd
zuWeN}gKde<@6=#RW}1E*!VpW;`WNV6JF*4NrzX1X#F!=h6OL`E_LJ^dOXAR%pyw%y
ze)oI}@n?>0r|gP-;*8DXPrc;WTm7nefi(i_&Dd^Vli&CnA-PV_4{YDE1G(0_#zk;`
z4Cl$zLuYK;l1~1Nn&ar3@e-`f>ps`&vHe-vhop|{H|bk*X0T=O(N|9}He33Qvqp}|
zzMDQ$k6FLPW*c)%Q3QL+{&ElS{eUqHu>^6SAkL6iMXres*ztb@u_vxGqu-YLwk=Ei
zP(pf~B|fusuk07F8~jzg?&I9cgC=Q;^r`QS4BsUNJ269SK|R-GjQu3X(SupiGpxm9
zuM63NtlMUZ51ilAJl1RUnx%cGTq!@tvld{DO%%c2RI&6u4d{S<3Sx*IVvAfa>-dN<
zO}Z)4sRvbfF3X{LjcvqEK`wQM*ur!6SmToP{&_!7IkmS2AGy?`CNxom`=gg8{5-XJ
z&e9k^apdd(9a>0_EwLMHTjVv+zbWdC{xaBL#(Mi9vEOiBu7z$p^7IYa_LmTA+Cwe-
zEqBVXtsS|xBX^2F<MOyD4$ghRM%)Ot<P-Ux*L4rP;TUST=5J(s$irSl)wO(`kvRLD
zf6fke{DYY2ZAqTr57>I(IL6o=+w{Ex9wYG+R|9lo+t%Db4^8ywmCpp94L&2U-w={j
zW5B*dQOqVzYawsOdZ=@QIWjwq9gp8SvK%na;`5f~uE)I8Fw{Wb!MX0!&i)XSCHl9J
z3)F3betqrPQ}!+I9p`}cum)m*F?Rc~m8gfD5i{9))#Dn~xE|!xs6(Eimo4axwX6s7
z`9UX^9P&Ny&>ZYP>nQ;`Hhe3f4|HrzO!-+mJp(%V*vTcvu}D~gI?PQE<5&m%!AhKK
zVB8KIL!N6?>FiMv%<F!u`ecuvJ`1dc7(makzD6zePyMMrs-87hVo1lf<--r?*zm2O
zRP`3vhW`YgZRp@UWPc#XIL~riYT9>`xz^KsPxhRfb>e5RCEJhId4LVJ{4hlqB|wKM
zcHo>`YyJFZZTyaXCyC1}jR9K=w&u2uw9nGMDxbmkjwS!M`2Akj`@D?pS>pHD^*u)7
zhZ$_iOw+rD%!qe|yn}$M_Yly7C25NO_I}c2JDIYXE&YVQ<)5~5oMZgAf6JkKScyF5
z9Yp7Sh1eIG-qpZJEa_G6czR+=hobjH&@K$#A&DCAs+J_=_gm<^^D_21Hpe^WCZ}o`
z{ML~>jqw?L#<nbr{7(>f^SSSv?>9ErLG}w(w!Z_{1$>PxZEN`B8v9!J7$Z%Q&iTma
z1-**f`N}rVAT+^w?SivD;&W5@ti)%I&mx~&KG!wwFGb@fJD<mv@~m&!s%jd>BWhBw
zM?LCLn_7!`q8{<|v=T+V0zKcb-_p6%sR6p}Sz<q_DG!~VehX_R=Oy*b!1ueKA$X2B
znX+Z@J16H6(}EnI?e-VNEj?TGgUa)U*n0NJU?X+~<e#|ql+SGGko$e7JKpkLZ1y?+
zNzT;MsW<tc1YRTSg_`i54DC-7g=aK9tMvfg<E3Z1CiorHMLEERZwum(C)kHrqN?@@
zcKj_tjhSGKpE$!f$92V+8M*j@SXhGjSs&|W5B3L$d5818$L#kK=e59gLhL81V!-oQ
zx~Hc8GDTxxjXhw^Fk&CrAKsBw-jl_9HQue6CVd}FjSYF@0yV#(X#Sp{AGq1FuPDaY
zj%<Q?t8kBJ|M<wQ+5`4w3-)cq{xO~c9~8lPF^sX#1Y;<IxDoM;vG0I+vd%bzZ$?fJ
ziS3NR1~X!MNXFQQ>T;eqd)yC(*a_cny6)FY6#dr9G>tRahfWT;PzCjin3@yNvF$IR
z2DMhg^I-G*E&7_0u!E}KW@aSaHl$;nd&?)+Ea|}5y2sewQRO$D*V1<Kmnc<h7gOv2
z{T(?D{VBG~mnj+>?A9%9Lz*f51YZeQ18b>Y;(b7Vo8!21o?9*3n(7z9`Kf`=BWKfK
z>v8VLnZcF>&yBRNCEt?Wd-08Y+B@cQeM@ZF-ZVBvdItNvVEdNuhSxW=j!!uD8_8T#
zG{H4sk9{4`&5FIZEQ&YSh^yju?eaAwhS+zw4tY)ZeueC!3htfUZ@G^G_f*5!_hQH8
zSo`r&i<(mu%>~Sf#D=em^$_cvGd9nQZd&Lo>XGLf%xi2rrTy>ZnZq1Ubonw*aZh&V
zR@KR{zD)MrbjJ?mHNiFFdUjEgw2p5J;>kU0V#7zw3Av_AFM*#OcrK_Hu)`AMP@}~>
z%m?nHAN%TY_D{w5T5&zmu~CP<c04EXY*YgN+X_wk>)8pvdfAF4r$la*{_0Kk5;RF{
zTi_oF=k|x5ZKt=Lpl8O|p^I|C{w*Jn2jc<zEpyyb4segK{!R|XHsQIm#16y&I{q1S
zNhk^1X2e)-jWgK$0k)f+IP6={Lx#R!9k71$&X;3c%aT0%v&{8~ZGzs6$MoC-e8jG(
z+11|+{5^rhhOZuA!}k<R-3)U9^U?=rm~+h;_gS~jxCH*}I%cQOLy20{Y*C*%nFndk
zvF(=lZ#3DB`|g^{%$Rp6F7FRxlkHjW+Pgo6I@D)=?h7;a(0jwaqI+zKo%kh6S_kW)
z7N8eFOpeQb>?8cdZ!y%*$+-utcOGXZpC9y=U`!5mnTL66;PqL~STB7Q#S#zb9#838
zP>(%yKS+a}zKKBsHruWDhn%K(7%BIRrG{<j#L^qRvz{hO!1?c@CWgL8_)R|fJs$Ae
z8$0pr5$mKj`?=XiJ%?uetch<#jN_JK;pw>>Uw^|>eyi#yk?T9>CYj6jtmpi!=Q*s;
zG_P%zMZOGkF~&c|PMqWH%Q|uG0ep`2-^Ry}u0sO*2{|*t*qpJ9?X#RI9$U_FjAizX
zpMURdY5WcRo&L9cs_S|^-T_R>o#35-8Hdhz1y%11cn`t511S1?`$?0{jQD$emRq(z
z<$O<&$NlnN;j}Hq_?-o^iJ92af%iIo*R!Mp?|}S12sy<Lc#o7B@y=;U8o$TlJ=Y9)
zS7!Z5=6J{4-mx{+f+6++Hq)ek1MxYoXl!yH)}LfQ-s=%(TTMDP#>V@`URwXHbS}~~
z>BiR&$@MH;PtHSnAH^ABY?}O;5@X~IVzE2_CcEkz{OEjUsy=t4iuk^1()ld&ndEc0
zMT^hal7y;Upav4#5G^2w&o23f@fO4p?;5T{t(ovTu~|PQKJu!dF7*v#?D!qS*wBL^
z)->riTo*ZmY(vj^Mc?r-d4>>KXWT^<OV0y_F+S%$Nn&nv*{g6p%b_`%*n0jz8ti6C
z2l9bh@0ju%uk9vpYsh&w|F<^R=^uKn@`KmtH8-u7J%Jf?$s&fH^I-A3m;5;nA2D0c
zc2l&VNCM+2_Jz~VxQV4_#jR(@AzH{PTjv?_peP=&<IiBTAK8K_xf3<kz*<<l*SDpg
z*oVwM_VI*0UWxM>WZ$Wi`;Hd#xd->v)fbe&*N1DwI>BpaADZyqRqa>a_rmkL{yx<C
z8&QIBw(;-ffn)5SiUaDn7US&4KExKx4_&MT<C7`d6U5d8V`59Jmo=k%yrp;TOVggs
z0Ns0NxfDYjdkE+&a163t>JUdf)Gwj0%+MH`U_GpB#r`!(_Ll3wzaI$$oohg>=A7z_
zb5`PBF(pqLzxhPfcOmq^W6Px&LwplE>iXO=7xnQGV;G+{`<8q+>_@t<!fzqb61G`R
z^$$H^8`5#EF;XqtPDxB=Yiw#&e_zrSmsuJ^`S};Nb=hy&|4HWDs#?Z<BW*+WAltG|
z{18nPa<!LS|01~lm1`fLA)ouDGstHHA949?_?lCvA8?(3xtMbY?#E;NMG#AkDyZwT
z)1=d51{;22$swOQBiIiTe-Y%s6fMQlTMyjlO}aky$S(o)z++2nJyE4Uk>k*3!u2d$
z^gh0j#D1d0IxLx+9;#T{?+mtg5X&`c39cdM$M~8$hWL!_mc$p%0_Tx?qwbM>5Bd8E
z$+*g1;=ao{E{f+28^)Y#YUKMedEA=;y+72M%HM*|1g!XM&>JwmVL!4z;F#>6M=UY+
zH|aNsf$X!*^6ark-^h35Jl8_nPA)pqROyDjgAuet+D=Rcdkc!><P3;@fDJ#fL+k`&
z>`)GJy{Z~3&d`YOZ_WyAor@Wu+fLjH$nS!h%)@-+fh{}O-$KXcJ+pKiwK<=h`Ko7z
z!Lx%vZ}B;xNB2aJjL9hhI<_t7o1W=6&(C~@9{R!37`Xl|m`TTe;y6qDJ+{2rZ9647
zQ|ut?ww;m~D1tRSt<7u1@4c`b+MgDnV<(OrBvgSN(6OxqW2g_<zaow?I?#Iy&@<R)
zuqEqpf8}0_-7!eVov}-?8FDjKW61TI>XpQd`sA&k=zHV@A2F_lgeu#KW19TnJ>pt$
zmO1~Naqj7_?*{JeagXQx^SR)&)Z+U1I-S?5M1AHvdpO6$d}1o*i57Dq9dp{Ye0g5R
zCflu#w0G!v?3gD>-6;xl>ddiM>@E9dYUtRD{D5v453vO`dYoUb7cjPsd6*BHV2qDk
zK*yf@-5MM0BUqAMXAI_-a30B{&P?-H%?r#AGboB_Vnh$*^~m3mPu@yvcdqS2zQ+2r
zXTTUAwW;gc)C1crZD;N!ScBI=FZi2a-X7$+nUibv`W}eSOpDLW=KDk-U(ZJJ6HguL
zGS3$E&2uO|AZ|u)<TZh9$hSnP{|+{=-(yS1cjbM9<DHKjiEPih^N{B}Q#RNM+j_)%
z{7!Dgwx55&*kpUw?YEpM2b*KZkJkAC$C3y0f_-PK?O8hJCdbcTy&+Gk{*Dhzz8j9W
z&+)&J&OIeH`oYu~iry{UXtJBZdkL|Fs=u$BE<Lj}hN8dS8~zqQ6I;6f_W!4Hr1uBZ
zV0^M<`v$+u=z4DhGuV<%?*d`OdqLg}R=qbeT{_I5=zSCTozqC~qR@BXcVSEK!2F)g
z65BU8z8&xG&heDr;6u+6y#(LP>zJ-SO-=9ePTgxh<+pL<jW0RpxaBt0f^y(%$o1qp
zbN!2`I!Bz}A~@?c@HxllGtC+FnIqTOmL;+8AQnIMU!T9KdE&dJNavoxXPD0=y|kkb
za;ahH1-%OTr7oZw+nQ{^nD`NOkWZ|LK{}>Nr$(WUdZbs@vZ7~v`vUeB6iJh9tl3QI
zPdN9KuEq1k2+;jpvGgp!^Mv8q09)~M2hSdY_!H`6PCw%rG)YsWf5NdhIa6Kq9oWv;
z_9scq6Xg6?&{WqH>A+rR*#8=Ao-5;d()uZf{5P8HP(;@=U-dI0&wpYD_Sw&KB)`4*
z+XBC{{QC<D*kC5MbbgQBpjKvS3^yA+&=)<^`w%<97+Oe=cZ%`eA=yh<7vA}v;-BnQ
z^$oqyS34*gv$if+J9~ESq4yC#d&GVqb9_<W&~@OMzKO!Kz5aG|qbECY#Lo*`wt8IO
zu6a(F+u)mGi?iRRp7E8SM;vQmP3*xuV1L-NonTCy<B1sw{MZcRk=W9~wkEv@>e0)q
zKdrs!?{DjW{l!byzOf&y!9CaLgIsjOn3~M76Zt$e*@>BvH{zO78ykMdP_JRv+^`cb
zyZl|}ZR+0P`+1h!kMXT^Ceb%G`S|Vj4q|{hLpen>!MMfuGT+ZrFfIY(8o&AS@2?>n
zcKpP;ev`fheprFWRpS%;R*KI$&kH@6lHWl5H*tSAhIybQZ2OIz$_H|aU{Bart`%pF
zbF_6vI9Hq{&R9)wo|-5j852X!P%bq99b1VS#Gp^c@^LP@&cuvsNH4w?RXuTSo1i!1
zI6ttJXBgunhS(|g0kv2otP9wyAlLbfvBMJdW_r?d&yKH(f5I_HV(8WLHtEK;oz_A;
zdFz*ubCPSEzN+{W_u;-;>eae^mbMqg!isB^uc5CWzHjNN4rjJ;j^ey=zBrGZ&93{e
zzmr}z`8bor7UjT{{yK}CNyYPhH~+VE-OFn*B#Ug=dC#)qT}xH$D_)ZCMdo5&&UuT^
z0rgLqm!8d#{w-Uv@F~8f`bD~-7wf-~c?~_*g#1&gat-@$hID9Rb1e_B8^<9HKHHr;
zQw{u2I37t(4@#2gz%_=EsL~DR&0r(Wxvtk$XC}7v8(z~=@7^;cV;Hd}a;aCS6X(D1
ztfupc<Qa|6gyFnmGmHU0=Qy)uGuWr_nwYaiFS)-S=cL7X-IAFRc4Rv!8qajT&>eHe
zGk#*rXSmmZ$M58bnoY6<xgXY6gM1Cx2N=gS;o4wdf?R4*7ipcjKH*-dQ3drp7c$qU
z)(~5;Zr?YTbYNTse&U)a0XnuVh$H@qe1Ct6p$1gysHS0#7GT3a1J`ZwUBeikYdDV@
z<N|sVTYJMEd4H<*hI6|3ET*&FILCs|C_ZA?$D-URs71{s^1Rf?kHn9!r`~6bvHb~E
zdEY=^hCa}pch37{&v7%>kZsP((tg{Rm-(AuUy5Mw!Md+O*FNvq^Tsvd+9;k}vo$u@
zhFHS$S-OuIeIq$1J~O8r@@2Nha6a!mjfo|{3FfMT-rOU)$JlHqu1EYzF|3ibzxE)`
zCufl}>9dIrMR0HS{h57aPkZcDo{u@0Z;GN`Pq5p^T7VdARgCDJ-ijEShkF>G5qhcW
zqv^W?=;zh5V(5VyL$%n$9?z<NcFuBz&yv`BfDM1nd(vCg{K1rjeZjsgTjW_5jZf$!
z_u|-7PUXVBV4vj~Q-3t=0e`<fZO)r9hy9MVyxH-=3X1+VZr#2ttK#-$Eq`jG9x%r#
zv6&?ua(}itrbZ1*+gId~3;n?MEYFy!oF}$?pJ@8qJ@9vYSV7g_;QIsT-{$#Sy#M}=
z9Kn_Z-Wyn={~fyWVIBD0%sbii&g90FeT&NbKrsT|8x_4jGQ3NI8EnZ6@1e$pB^&r1
zSx@iUPJPN}PM^p2BmJ)LH!|mEy<hsOvKg-<ud!)e-$2f~?88}`7-HKWlCOuaQ<goh
zVUgrIbKN-;oGG7I%cisIvyP7aJbNCOs6#FE^L!HL*qe{qMew=fGwaVZI-g7I^g<tl
zxT9X4({m9+UE;}ua)50FTk?b&PdL{3P5Bwyv$TK5dRP<m2a4?A`_d`x&$36YDY*~2
zzW1RBo<DXx*YJ$OvjcSLJWudkQ5C~;2C?5lZS#~vO{fWa$>4L`Z{<?%ja!{tT(;eE
zY;&B)?_`a&dX4PwjV5~$OV@#GVHjh-fzJ?Mg|Fw(HH9Xoo(-W$2W%rihjPJr$R0IZ
z=a%Dm$6DHM$z0^a5IdlM)?pYw;T&X+aqd#?ZO^jpjA;-1oO7&``x|<!g?@)<Us4pu
zKCbw!vHd$ka_Jd=h#GADJ<0lSC3TkIH$&50%vU%w0pkpI`r0C|Wrp3prT(kd?)9S^
z`|S7Lo^mS3wief@%SQeXuH!gjhHxx)s7Uq4I*0ydy#I&ffB%ajef>}MslOo??LoP$
z&2xFau6jW2Oo<+uA4XzJhkRea-vaB@tAe>&z?itMdy4P1zNce*`68!FQftXRb#LAm
zD!&B-eiuHm<b%TRJ<)?Hd9r0Q__}buYhc4?KjUw49&!h*YVE<0{D!4CLwrjxK3PZn
z=|9IU)qAHq?~K8oZC)$uF04Dg%em&9i>>p@nH_PTK>G8FUIq7#DUgiu_c-UAZR&7t
zW=Ql*(Og?_=9qsR=Yqbt##K!DiQ`;mIFC(s{96zUL#%*0&=WK1_=qK^2I$z%JZhXa
z#z4HWEz7Q$zspn&v!xr`kX@9({bV`R=MBf4z8dkC_|Y@io*<5E!!;^`YX<1h5>xso
zi02G&c7|v{;VcQxo5|-59Y66SAda)n87}(1+q?_ZeS7Nu4d~p*3-1O6I$-C1&wak@
zp1%aTbBN_TVNjFLh~{8^&%HH&)f!j_djaUiwolUW-^i-^z}zqnY=0+R<6Rx<whKkJ
z40~_bn@rUh_`U+}C*R<B%cmUsk)A8hhuyhNx_O<IxW`Sdso=gh1oyxjT>lxM6T3uF
zZVRZjMWvrK_ekR<9c&|qI@D~U1Va)Vy&#+58KnxI=^D><dM<gLPn}Wpmn~v)9CkCv
zQ%q64A$nQ|eE{oW9rW0B{kGsNERoL+`iL{)7{<iiVx4QhrR_a^cIKfohNAlhc>JyG
z%B_MqN9uWMZKg{v3C1uJTY8Ip>QE1;eZziYZ#3Bre%F|)2dtHQ<qdqs@m)CvoAZWZ
z_XGGo(G+8fbnu*6dTu0k;+&VI^NCxrH|zs@U>LLid|o(@Meupx-12#VEjY9Ii6fqC
zM2#h?>I3t@6i+?T-$*b%ZTNS9{)rYfki_P3(b!<OeoA~#5Sx8N<4pEhFOh>Z?2BQa
zs$dV<%X|&kXQ*)xE8!=`U^7!X*O6;MUC%wD&lWu}H-03xE&OcK_3Ux7WCK4VA=?8v
z#=2uYMpBP?s$l*RedJ#7+27=+-zv7&$@!bwn<h%Y+4Pw$I;%78&rA1V=-kh-E1tb#
zpQu?>8<=BU*s=lrE|J%f*Fp^WO}JOCN7r1;$=vk7cfyd)b!9!Qkvdz{`Y-qmlE>DG
zo1z6JB)0vAobNc>hUQui;LB8vouB2@+)v~<@^9ohR_X=2$K|KI{<|_=5*S-Y&cL=3
zF{iZOa;Dr<-|~U&T{@HpR_Yi17I(&+W9PIVU1u>vdi*4bGdt<nTB1ldw$F&)lBVii
zz!QV_1Y!jq*Go>0b9~V|hD_HOW@1Z!qUrDKnW6C#Rqq6PFeNiZ?-rhD^1)2l_DK%q
zz`juRZpIAhHx}=3c=s1{$s1Gl%+?s1-YuEIdnU1hs`px-=!!8@`a25m0257mW*p<}
zvtEw;JbpK~d#uNrSnFv!$Ii8!vCcd<y6uiTWj*HhxXA83w;XXTPFZE=x^XRAqDTkM
zL#AsCHNkiV&a<=~Nt~(D!ROTHw&~mgpOq^3%<(zpp3vfcz-PG2&S#DoVoT&X-*U)q
zY%8(>d8SMMEzUjVyE;|#814};0@h=&Sx5TbGvl7b`b+Fh)qZfFWRK9<AAH12u|=*$
zZCD4JXEr?}3_TB&pzC>|>3L@9S%Ke^L%%s+e;b#+#f;~e*RzH4U(XSGmKX`!EVB<C
z`&2H^D1h!U{p{2W{m>gWe8la*IYnc@4>f8a8MlaMUeAvXJA6;lF<CnI8#!W5%Ue#K
zd#ax&O02PKO~Bf)K?~_IK0_?j1NQXBkR9xEp2zl|@|{2XnrcHy@SMuE=2@Ea_c~{s
zwF~&o;H(lK=ft&7IbuDmg}qpT_v^NY_Bl37`?Adb9`l?s$DrF^rSIs`z2-5tc2G3V
zd$wb*x}+)6!Q&Y*r^L@^eh5D2eD+I7#@NYWzpM88+;95JY>k0+<+a)Fbz3gQ0pps$
zmiPFkw{-rAC%+4HAcvToi=7y#g1&}m32gXoal`^KIc_OFL$1f}gI-{YEqqVl9<hR=
z-*Uz_<SoYbDnIpr+D#PU9?-X-M(4NUg)Ljt@4}Jbw`Zp6_f`-5yUSywZKZ1d3-*7K
z)cS^8=Qdwc51FB{+0sw!YeydAcfMQv-?442|A~KFv*Ng3P1lYyz;)(q7JW{4e6INn
z1D|m|$G&G0H+4qId*!Q66|ZxkdP{bEoEu~p*i2CjkUIsr^itH5VT_MB@?3-Q7Wh}-
z9FLLsO${BpV=b{c4#^noN1o%;=bS8a%#+?#J2N$Y$Ce+?m>zYCBs~mKA7Jk?IgY&F
zkaM$6{VAH@+Hnr@St#MdZ>IFjKE{qimII$F&It1i(L_1GhHr=D9{2iA(%Ei0=TpzE
zz_Tk78)v`j`-|@|J_CFnc(=lPLf#R=kly2+Ai3n#_{?;Do~q`d7v_bkK7oF3-26+i
zCpp(SpCmas#{IZA<Vd|{J9&AWb#j_00rv;PK4+@N-?DVC$#Cz1me}000^1#Tlk1^|
zb6snyW)DizZ9`(`z6hKVsDgVa=cR>wogL1Pz`sPU$vEdZZbU48bjO_jT+4kCPaJ2M
zbIX~oBEK8tykfsmIO}niyK0=2SPyfv&s_U0d`^aRXrhQ2=fL|<4mxK6A2Gz5k#yUT
z*kKEw<$n1rt@zBG_lrDs4AM2~p)+PK=4_$}uZ7;d2K4^07V=JpY_J3LCW@fGYg4~O
zUHnVX>lCb|B^YDBK~5FqBN=-ys4)^-I^_F$*6lxIY#+*P2Swu>Q+)va)C6Pf&Orz4
ztYL^IcI-R*wBz$QbT&D!E6y-_i_aeCwZ@*3OPv~ZsqgtLoBAGNU&woM)15;;v<K|p
zmpQQ6-yZUBcITYZv8VlM?D$g_^}>F!ckCg1$@TDlVuvN0u`Nq{<TODI!x-PBe(a0)
zxX1I2CHActB(`<Hvk|lhrtIcj%qL$_9p<N(CQ8U5X&dWdU94}$*)5XhbwAPhoI0nR
z)y}<NXLsrh*8m+G{=vCdJ~g{)Qy)Ax^LkI{52n}&#@N}n8jzQJ9@N)7ug{L=-J0J$
zOxXu(jheM8PK;nB9UDI8XI{e?I}o!1^iMbzS$;m__z|_Mq{)4t8~ZIs<Yu`ZY_=oa
zU;oj59?TdcPaJ#NJ;rYxxsNfn9u&!?UJPU77|SW&Z*gvxxd!%<V4VF=I&n~fr8QW$
z@03%qCtJ3rzkvgP3(uUkb@+2EKB)TpIrLyknxem<XPxnlCOZtV1@8dzdxE7g_}#=Q
z+vWYnH!<YRgRODK?_#nXdN*U1bmR9rUGIj#<5Sv?oI%#H?SrOwQE<Ma@_5Pj4!{4h
z?0OIOEi>N1<@nQ9)B85}L2uUouFUn(`-L2H&X;{R{fr;6*G)2$uM5|#2+jg$rUmHO
zd@g#@Z9`%=*=`-5bxUmZz;hSPJL9ucCHXw@`780++>%SSE+28kw_r%_18k;6T#+RA
zPhswwpr1TO$42ka1bxGdb@U{&t;qf@zPDBGVTlp<HR^OR6I(j{82U3y&nlDW60zc0
zh2N2je}_hYBjN8P{Otr@I{%C+&oVsY@Jy~}j2+K0Jj>Jo8w}Az3DAM(51yMg&r5>m
zBIBMq^Q7McJiib_JTZ;u8Tt7w%<tkRogC~la1OmPCsffGM=jT6OdS56Acy{k*dOrv
zkx#MqWoexp=4qn*0^&1gE^EkmeOv?94Cpo1ony1^y4ZS9B~M(psiyatGsE@Z`f%2`
zR$JGM>&7+Y%r!CN+?6<cNa$jUE%=)V@xJa=wTkLi&B58|x|Yn#{4jzg>0ar7#u|{;
zt90Vsx9ecb`NTmFJbseoQsapxUuLWS6M8XSdJ(Lbb+flK!5BM?1KXWb6wCEsANfpi
zO-jIc$xiL1I?THTy)NNBnA!)QkKf7`XPp{doHg+qY7=J|<73<-w}$Q*+v(Rh#=a5z
zk0b^=%#c;mG3|)O2VG1-PbQD)6NcCUpZzXYQ1rX(#6IH4BOj{9#`Y$=Dbfu#Vy9@D
zgWrFEZWwRj-<13gg(Zr9TR{^u{m$B<V|${>XNvTU?N4&1x?B25_TO~J*Q#|ThICj5
zwrA;>Z2PTV)7;kS&H9tf{aZ)Qph$9!xOQCIq3irQbDYCCkG}RLt}Qvv-_mb$V+Y4&
z*<`<wW6+5yg7d?<qQ@4p%0}P#iGvxS7eQVI8@`O=s0GB|;+%u;^fS)$xW*Yf6}J<N
zPwc<#X|_2INsT6$w<oIf6Z}gQ#hY`C9UJryRQZAHW4KP}$R>*5Y-O<FyD?-p*<WNg
z)ar>U9hT1TCphD`80@A=-#Y(Ya6g~%UCDPIjF4U5X?%~i@Hf8a^qt4|9^Z$=l1m+G
z(_`-Yojw(7avU~~?Y~LKoYJwUy{ay(v=4bd*pm$VW2SWIq6F-lbxUj~_Vr8t89S7J
zqsngVUon@*S=NZ(x;9)Nu3r(aXB1siKjR>|#@K-vW1H>NfSK6R0b3KqR>8S2jIkTW
zL;k|q;n_)`x0KTrLp|2v{X;H|StoPiF9Ef8)Z~2bcn{ckJ`>DAeJH_@+=70X56Kw2
zeb||YIk|pYa7NB^gWXK&MYz|hT%cz_$JbM>rJCULiS9X&jKOEP$7f_pg6|ujB(daH
zLER?kH?uW1_^lJuBNiL^OHd2YvAv_oPcF4gKWb8|C#H1P)#AR11Z?<jY}vs%BXTX5
z#=nK{ft=%7$aaDG>CL@(++`~Pd-eqTSOxo3MAw-aIzLlqlJm)#=4?Zkj;+KQBbFR;
zx1bjDF!xM7xo@v!#lHA^&(iiM>3n4SK#u*SQ;Qhn3HINzlyf83X)%{=9`Cqj>?xmN
zt_7cG_L=K+?k(}o&62w7g6-b({^r?a%9r7prX_~-lYOy$%E^A~Bh@L=>6bIb8Dk$f
zZ%BiEi4rmFUrVr;oav_X%Q=QE7%$E__hs!fIn-e;_S5_2y?phdUg+uUb*G-$H*%=q
zYvfu;Y(4e5)F1QHCq3ZnszJ?O|HYDilKrRd*z%*E59~Xo<C@|#wr6?f_UN^yp0P1L
z!4B&WaUbnR*Xw~T`#(jVqp5DDXbjnAeaddObc4;hCAKG;d{6@P8Enbl;@lGTR$K><
zo9rj}PTQ1i3;#WwzlGmevh(-xlP+6k9)COE8bh|D_n=6E>tml{3;yQ51n&pBn1Xi^
zH~g;Rltb}5K!1nhK1sie;k}Gm$9o&z5t$}EV>|L@&o=b=fi3?@)jO<DjCkL*Br`?t
z+4A@seMGHOl6%@djmh~9^qcu6H^-y*RO6OE(mJYi!@m3a6zSkIfvo9_FkY82w%<Z6
zs0Ti~KIbhyFMM|R481;2@eT_;f3Ao%CGtGBv>oZ1)F@G#n!xxIj<p=oSC!=R|GEcA
z7Qy|Yi~1$p(=tza)HJsk`<CM9qXkoPKY)+8$$OS~_fjRHiz53LL%%^`iLPh#p=X++
zXPL>f1kXQume~P%mkm1<jj_#;jPY+hgA}n;r}KQInoy-fV-9{3#GH)r+fHA(XZmH_
zWUtC0cayK2Nqy$w8CP@Cx96?$6E{*E{-HP^p1dlMjJH@?LtYp9jTvkIBzMFiGvu{^
zIoZ1!`$r$>*kA=k@fq8z{NxN#1nU{vmnJrQF3Fg+PJB_HeD{E)wrh6zpa!@4>_7Y4
zw9l_=!!^>i;-Aqk;`QI~(m%7$f71)9bm$j|HRJ+yrs{DfrsgQI7O#V~8rEg7H8I2v
zSO>Z#zIK3(m~SDziE@EndQc_J(slR**QyDw9ebR?hCkQH@m>BR_<R_y5uXM2kZV;!
zGOqFw@4EENdRW^QoPi}c8~LpGykNiia;#&h^8_*Y`Ui+P>s8r+e%&{^$4xqnuo2q>
zbnN&`;5f%D#Q^iR4@~(pTjQ$VV=#gxX|Pp6T)V)$^idOAebQs@lU!<0&$TU!elvD4
z`Ry1q{XR59x>?dIzZ)-L2V#JnmS7Aka6GaHQxZ!3Pg>X<bCdn3lWUQGGGzM}=a%Rr
z%UdtD(Np~e#KSzWJ<EF3wQtIv`?KCIdvMyuu_yMISU0sj&nb(1Twktp4LDPrt(IVn
zpEz=I9oImfz9}1EU#UKG<a+o&(G>&4Q42=kv1>RMIlo{l<{i}NL6L+!e@(s6ll!sE
zIj8OPkzX&cXNK$XM3c`r#^WrD;@;u=P1ijLYTVbjFP-3fBF7HyX`%@3flc>4zWW;A
zS^EC!JiqGsfak*<&xwqu>?6M4_#S-4E2qYH=hXKc_fPJv)Mk#&9MM<5^oQ++bF#d}
zeX^~izU$G~3H?G#6zMRvCSbo#7W;R>aa}pawo{(@r=M{TZa&*wXQ&_3q{G(r;Tl0t
z*ml};40=g9jHlRw+MbIsKF$-*Kb#THN{{Cy&W~x*i{M;w=8%lHAZKzO6P&Z6+EXx(
zVQjFW56&btIJ0q%k&Lmw`cquqm#%RM&|h`5wk5p3Q`Z1E6P%L~5*<5n#JlcRoeXw^
zojDBS5pz+W+FP7w7Q21fPh3wd>EA*wHH+x626}O?Ncsc!i)4(CSk}%S<lg9yal4S?
zm>>GV(%5{uPm)^&a~j6jmmt3dQ}V_;|4_~+oPU#rIn~Dr{ncQp_Zx#XX>YkU>^1vd
z*#G!^)%biNi)>xzpX;*}%Qb1rr^Z>^^U}i<^yuD4TJM(r1aa?t_*;VU4Pvr=YYf?j
z-X1vP81IC?&uzQKx2Ro?Ic~Aoh$oi)<N8$XH}@9yziI!uR_uS?dt%8UADUpy{`(r(
zw`HgAetDi*$>!&mESsK>ZcN#CqE^ijWP8?~gZzf3IQpZ1*2bDos%)G`_N|K&pnJ@I
za*o+cK!+`SwyD9sv1i_^qWPboH$#u)klTVyziDsLvEeVmeREBLF+S>0cZ*S<S@OXd
zV>`0^{6!Dx@joS*V+1wnww-bvF^qwJtdEBn#}V7b6#EN^JNYKhF*&y%wLC`Nm=V7v
zq3LhMW=IE*EghSseeYzBw|>TBpQ1m2&%BG-ii2D~k4LO+Nml*6yC3j(a45VF5Km+5
zJ*bjEP1m=?J_WTJ?+8TIdxjn?-a+u*A>Lge+ZRmUW&8nKIdHy%VLTE``VGG?`V-mx
zu8H?eADHrg;#Py4eWB_7*UkQ9BmNW4&2b~WbNj8nlzZb=C&yL22L#>+W^8xtS*Jy>
zNY*k%7e)9iRGkB#nJlqCL2gex#W}|QT;KZ8S#6?-8K0RdIrKTotmAV<Y>vl&#`IK=
znn275n&j4J7x)ZA4?Nx)XKe4X7vXzC)xClH&<q;)s4ppsJ9(EoFLPj{2Q%VcwIt~i
z==sDxB(Yt;F$ce6`HiXP@S*3Fu4kCdbBrir@$4edGqxkEnEZz2SzZ+B*tT+po{y?%
z(y`%lTvhDW+=Jf(f-x{I!PM{T&Tnk>xz%r>XWj|v-B647M7%4S0{fJo_)abQiXMud
zeV~W*ctwBo3iL|PfDasNNe%G$Tj_ep5w$H(A9nj(pBQXau&#`I$7gbEkG*f&*Vq1N
zkI<Kx+N&1VY{i~YgZvesLlw-$+(i&i?XCRRb*C2BPW8E7TobMj@BFsj0S?hbxquyp
z*a3M<Py<>pCAXmd5>0be&a&o(mo6J|C31-8{BV|7_uwqDFIq>7HL)&(?Zmz<pRvs{
z+neHw@IJ9urb-9)E@Qjp>C0nu;(FAwzBD%2h#R7bBKUl~J|mLs#XE>2k2<V{HEqFJ
z;7lyxGuq>`ft(kz|4A?Dvqf#gTn1Z?v+meal2?WMMov+J7Gvx%!_FS|*h^yYQHOdf
z@Z6TRXNj)|^Rh3t?eGyxKJzhehJLsnT$iD1*TmGB?{W4y|BSH{!}T5sav4*H`bBdw
z@8EYSzjK4C--%sJQS^HeS}-I}?8}mvEvkNJLKo{Ff?B3Z&tP9csp|a;9FHX5ROuPk
z1FY>vll|n3+fgIS9D|)X-2*cBaO(J1;I*FPragd}u+8$xS7QID$y}yN2l}P|78FTf
zoTcry4f(fl9oJo|2_9S4hxw@ETGTU+x3t}IM4si+_{6zA^)sd4aLmnz&3<GJ&iUL+
zmX5(@-4ff4CcD}C44?41zR_iWqHr$=e4ogY`^SwcJ8+-*6Q=SqO=Bpc>psc-vFd&{
zb-$~+?{N?8`kv=`kY@v6%>9yk-z#2u<O27>5%<|5IaQ1MqhahE=A2>+uj^Ym9`@&x
z{jAU2;69L<rf~`Q9s$-_AJ)qHGOU&T*n%8#Z~4S!ipCjy;|qu*&pmYYQxCA2nffI!
zL#-RcIFCB$NLV@(TW9C>eJQy(Lwt80;GY6X3}?+aXUpgBSkBt(ym96N#!I*d_l2bI
zE!gWN1~$bq2WJ|FbZq1k|B8_;V#<aD>|4}y{ix}4!5Q&6!A@LLJT<DIPv-G@(6Oxq
zaXsc_zD^C*<-9(f>3o*AVxMpvb(ZjbCrjIrFa-6cD1v@~wHd}MAO>16CAX+ii+bqT
z@MW+)+27?m&$;J##yqyW)>0paJ?MXfsoZZl=PAmij}d!QLuYK8duJ^zQKYl~oJ-Cb
zXNk`fpPj9<Jq2g|_4$&o#QEiVQHOe4cuwRAJ-`z5dUCFZ@qEKA9$QNk>3KeUGm&H8
z`Eri+tvc^;9J2j_oOjb*tEi^2&GNL*qgTd`wa?Eg>+&pvt?0Q3ct(21lppplab7>_
z+itm|KI1Nmp!X_vtdq4BQFYchpRaq1&MfyrSRtDvY@K;P$45MQ<Wq;b%)veYa~gV>
zVh8BZMG?eTF;$}pB=xWv#`rj^T`;d<yhMpSYHq=AgCQ)@zhx=b)E~`tq05#zW1Me^
zAKlXSap~)fbBuGcw6DFXll!zjf3(*hAl5O3zteuevB;e3@oB@J$@Q}xJ^QRT^<#$g
zEs&X;twmmue8MqEV(6g<RT4Z#&R^g;^BhBSm@U2P@7>TZEdCZA*zd6=_L`t3^<5i(
z(fb9Mf!{$4y@xQ1cM^j4AN>~)|J$6YoE@~|y$@p;7nW={s@@|(_BlV>tlMX4`>js)
zp*!Z3UGv|VvP03kFYEu5q~;U6Yx^xjIp5;i#P0{5YB{$k54;~et|8Z@3C;*-rN5!b
z=d+6>b_cG(cm~;r-`JjG$?1tA9fszqg3psbTgWE%8-{!t;xk3#sn09$xiwY#iqCc9
zvmN)Kd|xWEJ+Z3h6?|XL2k_O1BbFS)80s$|ehGT&VqU<WeOqH-jW7;ufBE7!QrGjz
z4A6@h^3`C+vkkuk`Hjf4d*c~Cey<{VuE)l6e&P2c&p|u`sRs3s)Z@8m$Ulfv&eq>;
z%#6R|6v>k&+u-j#%3%(Ac>RWuzGb5p{w3&xK3{Xi{H)7N>A={!$JkE$>2r)_QO*;r
z8%Dq$81@I|8}JiP{z^5-X$g;uZ0x=9m}|$rd(YT^?<3cX{o0}`j#%=^ZNZcT#zo*K
zjvVr-*W-G2y{{X37stQvx8j}O{%?vE^8tK*H^}=z@~ZNw(c=9cvP4}ZU;}hwd(7z?
z)WHVC@h*`*>6taKCSQ*%x9s?uD1ul(H;k)b4-DgefXz7WCW*0qu&1I0=vxre#S-+<
zf+=ZiE3y$s4!P85K}ou8_<?Z|{)|n1*03`#wV7uN_KP#g+4pDRl=JwEG0rh1K0DY>
zA2$1$$6&(;Gw|55$Zp6Rq6+%HfzSS?m?GFaK%WBt5bF&+>JV$Noh;etuN`2+x0#du
z*1q#Oo#`G|xevxYlJi`}*4Z9{GhPDpE$|b^J(c_Dj(aJegV*Pl`?=<+n(sAdtd(B)
z?a1%N8NV5uerv)`HgwyEe2d?s`Y!B&zb{KwtpockopZ{{cdMYb>)Uq5dOQ_>;`v+Z
zgBWsZ)Nh&tSeKcx-Y41RF9AAn`vGc?2RwI<S&BWOSD<fTU91U)*uQ{yXa^<6NSHAf
z^U}|_ko&y(ZEMN}kC$|y_B$Mh96?LEZO9co)w4fK$6~YIW8F77<$K~5pKUd*HTN)%
z^|WJr`aO0WGIO3o&Zg<op?rY98x6tzVC%kM=Akowhx3rs0_uXtr*sZ=TTmo{dnHuv
zr@C(~-N&}>XMAV9?w#p-ix~3vg(;h{|Lo%&kJS7BFP$FTAN{t2qOtd+$G-4gG6eg>
z{k;qB^%-na5Yr-lOJ=YWLu?Juu@(6YV}p&nk=W8RTo=ZUY0`~t`^aHTo?)#S?8J~?
zh*eKRX8|}PjFC<7oWpnQ>w8u@G4xL^b#h&F*KYC?*FWI7JTGH%=!+VjXQ?*Vlk1wn
z2IT@d&@b3$>6oh69rH4O31;-=e(4dL{m3E6r<W->k1Nro=QFw^2788>Gmh93$C0}Z
zu-T71bD!ou>zw1RTA!#fH*<^xW9Kf#fX7w(Egl;_$00pl(&4;6H{Gvc1|FZXr2G2m
zdpDk6)ODZqYO>91ZCYOuQ|D&s{BWjTpE2&y0rzWcoH@=IXO+AWY{?AsG1qz^uN&QK
z^|~y#d{Ftme*i!6EhtIHp4l23*Yh~Xz0)1<{7=&Hmbcn1^@(1D_YQrEEpBsR$KOOr
zFg8>APEcngmh?=~vyZ`UJ<Fb+yXNtnwKazGnU(RA-LcNSNyprz<7f0$Bv~VC=PYto
zn<y7J`<!Vce&U88uf)Dli<(_92W;V9MpaIL4PO`RAGz#5y|e%wTb0jXD}s5e*wF{Q
z7<}YWn|anj{ZZ}%XDs8V*sdBdAHY|G6+JMveoDt8yU1hf<XA^C&Wtp6TvuFXYHW)B
zz6$=ks>e6!m{X4U8?Ei-sEPe4hS==i8lQ}aA<kffo#1ce8UO7ZneEPTjh5;b>2R~L
zXL%pdZ~Hiue`Cv@aZhJ|j5AAP-V5Bw?+#9V@-E?czmQ|_ZNYmC;GKq9(*3R@%bwna
zWPQq>u`k=+>09|v`2Eb29D0XyvSj-f=eBs?gv{8V<$6=U>K#^wcUopj2fz0^rTxf$
zA^T6A_|wLiIa(smneAC0DL&iL@xea8)<ikLmKhp9;kXhtSQGo+ICpVQ^O?nF@|h)m
zKAb7+PriN0ar`^klve~jR6&m;!8rF#jIj?nf+kr+)n|X{z5(cYJkoupac_zH)2fOO
zifq=0Y*p~RJNa%DCEz=_$9M41cc<Zd7dw7p$$=?$K+O#HJVqa4eSlt}Cm65Dvv10_
z1J<3vj=zJR#i0s*yEd`)oDS$buj8|yG4||h>GxvOGX@l~^c<Ao+35A#k~x_}f1BoA
zUKd3=fB(h?P2d~)J9dx1e@`TT7f&(dVuK=k<sDV@&bs_N!+p>f&?98sHsn0m#~43x
zrbs_wPS#w-)*juUzb1;9>`Q_%K4P|@4)t6UJ26%Gx^UfCe+kJLA2B^x8k=lK$4)$X
z)L=ik9wYV@A8~*_sV^UU&$Z$`#MXPbB6vSnMSdsP^$yUK(5K`U#FAr{bfDIxp5AkC
z7GCGzGEa^89<hb96X#{oqk8Rvo{eoApVq{Fv)91>7U8uLLmrZ~ub`!U;A}R5-0X?w
zJ?AFhko%4yKdgXW=yOJ|E&8O_9iT%CiX=JYQmZ8xpWvsz8K4v6d8tS3AvU#jCf5i2
z+2HeH-8qc0&kNY01Rh(?BL{m)cn*53f_@GCn<l*o_SJjEetFIKiQOR?LlI}riaqr{
zdM}aIyL8S4=fh_N+Z4zms(hR!?rog;#k;=vEby7&voQkBeg^vz#PNBU!IlKx8}fOg
zrax1S&u@HQ=woaBlYP@~#U=PnnX#?OKE)P%7xF#W)AwJi^2PVy3_FsTcNF<ys2;VM
zqXmqyGZ!&4v8BHw$9Bb1<D8?YKI`kEimfvR=-8HUFH^CwMU7h21IE~&Anyt1xaLx=
zqJHW59W&O?zURH)vfDP~`-F3;=lP0spqCT-EVF-H;<NwMU8Bc*9wT!sb#LSt^r!qB
zmt&svuK7=<Y?<sYm;SNkd9yx_^;C^B*`Mv!eP)oHD@*i~CR-7lXU_FIeEyN+4NX2M
z3EPHjTYNhYv4&h|q6qFw+|!YO4WAj(VFw<cvPB$r^dfRi>|4C+`CDJt9>cfsIgTEH
zewrx4eImQ4Vx{jV?%%I_IQQ}RE-R9zhkZ*9<&jH`4E82w<ZXQ~@ZA7a-*bG|QO6W&
z#rGc)KQ{bRY(YKh!V-Bt>pj*qC2x5Bmc%#*NnOv;qyux)Ll^YrKHVceVjQ3Iv6EL0
z$gLvpi*+P054lrNo4PBg>J_G7E$t0MKG+GyO%y?m9`&ftJnexU{m_%?Nykq<y-}0;
z%(Vq)cs(#>H{4sSBfF><R@6p<V~D>oWzXDVvMtA2&;EMp>9o1Gq5fKeF+Sp{IR)!B
zj17KMr31N!vHdqW<p<Ypng=}oMmopxQ;y@ZbPhdM!5%b$%xgi%)&yshGs(Fs!HhFj
z<inrY8Uwl1Sc18Ld8cq6xwlgv+8@{ne^-7holBh}nA`I=jj`|GQ%%R6k{WQ@|77f1
z$QE^x8T#)5y5q(}53Flne8lG*;(D+of#;p}2Kz0Eoeyl;q1M0P8P@uLg`|FlIp~db
zvF;+O_K!2ldF2cv8DsYzbAGWQv60ur7VKA1%@%9(`jFQ1+OW-trw{V0pw@VRxr&(4
z6TP`7dgilP1+u9};+y7R?MsxO?;-xodHt<XHL{!<-^ejVF`r<r%%}J#KQ-*@niu8+
zTlV}nRrGQEo%Qtp6JzFh$C97FfA<6bUEGp5W80bYG<Ll6kt1>1n|$mSu%FhE_+SJp
z>Dh+ec>dg<ZI<>;?E~<h;Kq}WcMC&o-Y>*^h%R}uWV^w84&a@~H%!Gn;e7kIVly?~
z$z|KA=NR;F8At3{*W;P`Z%Mb^ahA9FnG04>crPb-zm=I9-*8NcJWJb8i9g$Bs=K8d
z-nUst&cHUmkNb@r$NN3cLG3O|fDZG(_EQ$cv42%eolVX$pBp}RP^FjnOl(QuGXSsH
zIPX5^mGe!FfHA(JYYZ)MvyJ4>vFMJsoT>}duYx&8n%h0xByml!o-T@D-K;k=G`>O1
z>wcs?Dxz2A3BGGb!1rMZroL}a_#TFAcRaafM7=Hf1TiIO5l2rq=+od|7qA=rtnmc<
ze~{i^6#bUvZ`PSEThs4beg}6w&jUKYd4XsA&2t6MMtZIQo-eA##Pa)?dL#J1w4B?y
zEUB($_1HHfC{Hj2Q!oWnFa=ZkAG!6PtwTrToU3a0!}uh0Ll8tp&Wu{sB!ThDznz=n
zx@v9N_&t2<H)`JNM80342DL)-Ac>_0F}#yH;*&?de4iM_etO`$j|lZtp-0A5qMIch
zJPzsLah3Kl&k)SZo=njbdWWU{O|@<H{pp>x3igIEcGg2|7gL<nsnY~8fKDt-je|P5
zpX|?P&$4cppM7N>B>B!oCm-Jskr0O+KXieQy43gesP8g(H^F-f-d8lid%y}dL(CST
z93XdzBY2+yjEUo&VidY`Y}5*3h%e`2sZSWJLH&APTAnq=tcCS~*LGxQZ9oib-GW$Z
zApx6X*$3Eyyqe>9=aA=m*oIi*2>RIUabD9Uc@oZo;Y?Jp6G!|IA*e&WR$vVKqQ=t)
zkVh;&Y97Hn%)13=p0mFSzAv6+jpJUL;#^?+EnTq?4=`5~^h)3K&ze~e>teq{a2>c-
zTt`430v|EZGY)?Ut}~xMd=6DUXHT{eexJ>|xX-zi<V<sxVI<aV_c-L|%yYIm<D7Mf
zWd9%4cmW?c*11c$)T8be%)xy0cX$V{b+LZd9OYWGk0Y-!d(EC7!QZ?);qOrXzC2>;
zdC7BbB|{QCzNP)4n5|r(Mk_GJ4#d00k^T+G4aLP(pPJCVz<O?$Y?bPNs%1Yp{Q?`D
zf@{#*PSAgY<5{a=?JGHwmEP1-V!Ovk+ur2Lx<e8op%3e~ynW<7QS-bmOMJDC?SCR&
zpSi8yb@9Qvu+4tUxN0%}lb&X|&P{rSGvcw&3uEg`{w}yDxi@`(M%wWiY*1sHa=5Q&
z-s2%@_&mL_4|)3-WA9>$bAj!NE<1#9&5@r!NZXLaIDSe8k1gY})foG*!4d3%8M%iZ
zTN3xDIJZjIm^pu!jD+>E-j?vZHGZZoeMa*+&2tU;jUoRMN09GYNX8Xnh#kVu%%f)l
z@a&w|e8drdM9*5(h2T2nT3F9|;mBTLFY5Tt3&qnj^M;^LK<@(kxoD*)>ec!~WBMhB
zd}_7AkPg_U_F?Hc$+OZ7o|~fQ9))Tw!JIG?<^cL<&dSQ3So^%F`$0|!>bP!`4)o8w
zy}%f|W2&6l3v+wkt+_d;EAeN=E%DoS>x@UzB&i8g^a5kp39%L1E$thn{*wMijdP8e
z^Pk-BTlVxLiQS^*e9TkV{4}rUB!}ET;c337Io@pahR;1(_WbPk`0q&S4$*R5^x7X_
zKRHiBgxGn;7-K)ed0y`>`$T<UE?A=W>$N<|sdd6h>hlqspP#qHSMwZ;ttYpi7~^@K
z>fXMZbH{sp$9Qac$6=q@XQb>8(lJOwTogP;!YnZ6dKkt>41EvTg6})Md{;WsVO<ad
zk<#OJ#T|{IwSP0E{~c<L-{{QS1#4rSoJG#5&n)AReG0CJ_kevs#|G%3I!jQ~eCxq6
zmP>hE?5sykY8$QrbP<B<(@MWR?^EtQ?nCZLKL@xciKjL_ZE^pO=<)bV`C_F+j~DR$
zmbV&z$No0wQa``pDDI7}-;{4^?CpCSlY_6yTF3U8^C8Wa4vek0{EeL7$zgpV^qV^H
z+xipu$agJd6g(&M|3p*F4LMuXn%0@?HxTc*CEc9Vk#Bg-Q|sIb?<Rov6mKl~jNfnY
z&f^<Pez;?%Y(H@n^91jKY=5g^Ka!X_woaWl9D|$})z;;M8iOC+YGWVCmNdNQg8qPg
zmd>G0djLD^#Cb^Dkhb@SIhSnaNWW=%-v_syv3<z-fb+UyL(pqW&~JA3ip19h``$Q{
zI_unHD?hi;eShKOymQWpy%`VZeLbA>&|HA8)*v67{m5Qo@z;2CdYKQ<r>TD1klfQD
zrq<}sOV-QSFn)s^_Nj~A6eoDb@@$3p!qW5cX2@2-?;6yb$&vgCdT~F*lG{b3M8{^1
zbmE8D7xCA>Z1|cW7RYrTcKn9%$ENQCk>3&c`;fmKL-6-6zX9;~FOt87vE%3a1m7$8
zE<rANOZJXWapV$@WDNL-;d==2<WU11|L5;%ewWwp(zE<F&)?iT$HdSNb)ivLW9*;&
z^f4Fn?3{<Wz+>iJ;v{@uvTo_`P<;ObkE<khi4d%VIpNkB!%<%$=$$<^tjS>8tV?mk
zleYzPz(~-sn|n+iw3Ht2lJle!*AnIjkCBYKphxzfzPn)mxlUd1Zei=aNE2P}8b-bk
z>3aXbdx#1)GkHIeU<<MI?qY~0W_d5N^v(l#?|~gZu`S<k@ZP4LBli}v^ZsKij=qre
zNU!A3yJN89cMN$`arlWl2|6}>OEEw!HL(*%FZ2NDy}-C>|02%;XMnvOf_;wMbM}3S
z^8!BTA_TcW9b+4QAhxo~*s=Jrp9`OhnP-Z#xh}9(ZvT;=dy0Dus&1R@!~!)ehjfT!
zs~7sASNdiR>?eE6-gB+EPF>fB>w2y;$N9rH^1A!_Be69>Ocz0%&fF86N3-*c`uz4B
zV<(3Eb%70<An*9ROYZ+In`q+vum27<d|QNKN9NsgGPmbvZq{R_^dnd^=Xm7#9Xg|3
z`^Z`1Jh10Y*DUn+B!5%#_o$iDH-DSz8QHJr5YME_%x4vG5Er)3E6(;mk&(6Qv%A``
z4}p9F-%mKtb*scjeiQ5u`_#qJ{u#zM_}Jr$<B`N~L0w>ul`wxV%-qK#>F)uz98EO}
z)lXi<^(^i4xaZs<S*iV1`#0S=|7lt0?Ah<1$eLgEZ+(uuPEWGQ2VB!x;5t|A+p<?|
z?-^guiqDIEme`jV$<EJY?(w60y@KtH8i($<shnM43@ssciT(?SgCm@eWQ;u?;Mp+p
z*)a9_1?K`kxzwQE7NPwB^gm%L9-eZrH*s<<=IbI7dack`OX!*2y9lxPJT72^DaaxB
z4f`z}=dq>jM>V@(KAr>Mxv?`RF~o1ddRW^LUN8C^#NO0c`?}(Snwo<-gE`epOSYa<
zlV^TDukh1X?TK2az?ho!UTadfvU1JTG}s)2-g7=`dCsodz&zhL^0QZ*5#zlhuM29n
z?31}*CfG-rHxzHkvre5=IMSJqv(9J0N{*!Av%>mMa%G*Znzet=PcPs;h+%%>L%B$3
zg5Cffrq~Iw&>wJ}Pmc1L`?ELNt6laC9sA0Dm}`{!uDvwJ4ZdnS8XN3gxK~SRL%Xnj
z%O06aK6U<-qnv-j+k9PhL(uEY{X9DJk)Sv2BYWKojBT6JSv%{b9&?=sn$DYf@>d&i
zGue_)gr2ESjI@)}gzL^y2fdDW@u5G}#dgR2H2!VQJ)i5&?6XON$6Go$Z>Tq5Obl!8
z$tu?ZJrexrTsL34mUXGM#1a1PH1%BycH*&RPrt|C<SupU_tE-2^*4IWt$MAGZXbFV
z?9<8h53Ro?=<Ex7%i8Z;#<tb|R?~ioYP<C&f5o+C_S7Yr6IL=LL)2^Peox+a$S(N2
z1I9~hpayd+&D;NaXUbQpu^}HU)v#Xu=(hhxQm5h^>cA`#{l+oXey+Hum>Q2xjIr;?
z2K)wX-Q)Xr>FT$B$BZw(XX7(l`V;(K4qdFmk^UQ+es{0b9M|ir6)!yX^k#diL2X##
zJb?WT;@$f!?;N&t2;N;3hV;tP7*67`ZFOwhDe=4uxyRVdl>Vn|<(NCSm)f`P*!?Bn
zF~}Ns>-hU0Le3jI=i|NBH+c8;M$L1*D)D<fvlowRuIn$wgU3k5yszWE9n8PMQ4aVW
zpvRU|zAi#AXA|^U=cf<*kcM?}t_PnzP5lbw*5^^^Ug&xMG{rpO`(@<4(aZVge7{l8
zIQkuDe^Y<eABz3-OV0&t75kd(K%c;RLM*M<H0e|8?Fl;TH;iw(Y)AVvL<pXDEjfDr
z8J>mT=<-);?2*qkEvM$#1?<EDxiyE_JKnvz#_hMAxQgvfHJK-pUgo40IM%Z3yUo&f
zgCVxQC-A-g@OP7B$j0{uVs55vU^{V+#lDkoG5E+Cf_azb?E=Yo3w#iQp0Lv&vVsq`
zAQs451;*HcIKy~}ll1KCZH%4xA*j&=Jx9_d>2c;9Nb5Uo_#1yu@%u%--{kj<AshKE
z<CufF&KK~%G2~-T>Q$J33FfMV##=oA`VuEW?;;BHd(?Lqyd&g2m*0Q!UJQ6A!#jo$
zTkmFgKf`+m;5|+74uW?PdMClVi4eRO;r+!FJ>QS`9my*1J<#zJ-<9{Nqk7E4oON#I
zT{$1`K8S5)UgkE`LO+5SAl_{0^xjmHbukxn9@(%*O2*7f488chAbSKm-wpZ<u#cPr
z!`QZ#*TvU{YXK{z$H=&_Z^?cHXJNj8j~HUjowF4Kq4UKVGpn4%BmJiO$4eeDHP1PY
z5BWX+%r&&^*?o8Q&e>$|*ki5_*MjTDH4VXgu^~7+H=I3~g7XEOzxxb^Y`lx(om{){
zyF2Xoi5+5P9oMb$q@TDDu1l>YdVz7}Xk2@6E)sU>f%+>slI~$^o$Lks!X8b*el_je
z(*7OJFlSQx%XMh_tQ`8glE0g~{yye!QrKeX`NQ+5>$!6-W<HPbg{acH?Tle29^W$L
zXFkLH;4yyZpnE*Cu4T_S{5P)U+HbPPHTA%LurFP(SNtu`zJ=J@L-vt#{@GK`wDy-h
zMw*bmbfyjCo*YT;fg!e_P8TPy(NulrI?R{XhIP*5NVfJbhNQuUjx@wR;aa`awe3w3
z`$Wio!=7UE-g<n;-Q%8fU`MZh`@YGy_-eQQ)>G{neI!k?a-S2f*An9b8$QlcWolfp
zk60iN#zkmsIFFnc&SZtNWR`UE%~tcNX{x>EchwESIp#cbt}FNXUfBnE#<n9H^LWlJ
z-FU5*wj*tOk~QwuXU^3m4LyK+>e**VR=8(b8?;>aEcbUv_kGWEttDHZ#pu|G>DPXp
zm+?$Hb9vq^9o(0DwY1%F&O_RUB+fZY`Vrm_OKgT1=t)RcY`0_%))j)a&-{+Wa|s=`
zU{CrF>!j8YEo&kf?*zS4?M*)VFpOb{Em*@6N3iZ$&V~2kwi8PZbP<Aj)cq~Q@0_1}
zLp@mH2+zIM7jWK3vLxXo{v5fb{kJ5yix4B%&74#80%Q6B;<g}%T*DYUF?aq^K6%7A
zjxly(m-gYaAG%IcEbfy$Gn^C7$i{coaXn-&Ea{b_G1%5iEP4ofr>7>E2l@pz{KV~)
z))`aBQ1=^4{+lD)Z>hPx%oWn<<)~No_2fRb>watU;b)C?UF6q#OJg{q>A3~-1^b_*
zbGCASL+F`H9P;KZ-#KsoH~YNS^A`7H_ng#Vj|^kt@7`;ClOKK)OWiI)_^dHr;-s`r
zP20MBz?gZMe~BabJ~fjqX>5Cwj(d~-4$61Z%F@`_?lID~Ti(8=Sh(k}{dTQ~bsEOR
zQ=58#-URlUe#T%Qaupc=hNd{`x;FK@VBd$>dF{D2T+f#GEcY#NPloV4`nl%hsRsS@
zzy8gX4kz*0^39IFKj6G4S>r>wu+$G&x4p~v#FX8fqT6QKOFp)9;kY;Hcz&O*jB8wd
z&OzEv{2N=oH~5|0@Vj|sX?*?w{|<l4so&-eKG&pve;{P5)EL`Yk9FidCTCroGR9wH
z@X?$5+|q$}5kD~$Q&|u1I{wslRHM@Mj^t0_y$?9g<7%_-mNmA<S35a%T;uRPQP))U
zr`X#@JT^<~PjzPYwk3^imbP2=ti8(h>qYlG#KFwkE#JraecRI5@V@R1-sk;>sW{{K
zD0P|3bBA>B7`by@oadGdNnkv6_JeyPKSP=%41taNq(UrIoAoI>96@c*Q{|RDxRwul
z>pfoSBc>7>lka*>`VDg%dV!vVBx?fJ2Tg2!mQK<6{BH7#@j%GN^9^RwB!TCqpXHWa
zHWShf&(@of&)d)UAifLbcOvY>l1r^sYBIL%NT(0?wTq68@eS*#c+FlXc}-Az<y`dA
z1by<|z|b$fM#k2DhQ23Mn#N}HJ%YbY62=Bw=X=KsO>@3cbC&X<f59<NvgU<q+|chx
zn&jc{nuIaFnnS%hw!Sl#+$lmV{arakOVDA7E<X^5ZR>BTE{^_|LNcy#j-QH$r{3I)
zrF$aw<XkQ1qCWFd7vISKk;F3xzE2FX>TB|DPXvEAizSY5ztnd9sT}MTV#ygI#Ljw0
z?`M|iA`;%$H1T<NruSz<?;cv=^ZrfmBzQ-``--La79qCYW$<nT(6M!a|A?9IHJ0)^
z@9@MF)Mk#A5*-`hCyw_Z<N-Q1Lkuv+XBclm-QYc-Kp%<itdsR_;XObf2|D|8MAN>F
z1l>0F^a%ETi_rDp`XQm(u)|7@B-fkk{u9K#ao5?3<vek&R>5Z!X*)5{MD3y0aLk(|
z*N_KYu+9*TePNH-N9`&5&voOPhTweoJaKN~1)sB~Gj{Y|4S2`adB-OFUT)}}+zmcr
zh@Ijj)EaqisSk{sAcoj3LQtdDZM^#v`+q7<^b2e^TQ*aD*j#&Mugp(B+(%n`#QEl2
zbB+&ZS$oM@{G2`Q_tbUW`ix(Cu1q~wLeC-?7l&t*=<VOwwq%DP;(?uY@e^k}MnVW;
zzd?-St6Z|1YLBdYOV2SiUrP?pTv5mDOBW&7r;*RYqkZdnPt>!^`5k$N+2fU;pWOSL
zWz&m}kIxCtJMrXE;|OYV4=uqx$ehegAM`|j^t*-Ey|m`@1H@E@#!zil#}|Tm03F-9
zzy^`jc-#IH(sLlK|0n9Y-=E~v9<=1>8UWX#7eYGt+;Giq@Bwk;t{0ws*i1+V>Nmj|
znJ;jLz7g_QIC~Y&BQ(MJoT3ZPtIz({8E)d_ndV$qu;Yg*b|F+}<@u*Jb1>h!I2u=2
z(-d2<2bJ5#7-peM2iIi25X?^>?!`9jH^j7rHFUvxp1`-nNu1{~z8m|9Wv(s8wJ-Gj
z#*q)~AJRim2WeKu97*urJW0nOml#P%nrdUNCc4(gbsu@{8M9v2h<_Fs<1>!gvYQ&u
zyv(_hQ*`VGf7Or1_ZqQP`+PVv&cTOH{L0!PS)t!1ScCD{>+88z?8K8lvgVRJf_a#4
zC-uCKJpafW;+#_@_UfZH^Dy7Iz}8>puk+QK#MgS%VC*{f57}7r6s#ZE7xu*GrImAY
zWdG!-K69^&YD2GMVyn$QWD{F8>5E<?`$EDHOPm5@W4qT!Euiib%vo6)8-Kq4iF7VC
zn_%uK=qm*K8th%(f9x@PKIH2eTl=LBtmN*c>-jSaN4mk@6ZFa{aek)$6X|+&4(m@o
z+mKK5R{t!$-tis}eJ}V%oukI>AM$D}dK2^$g6qPyGOb)Et`~Nn$0?oop6jKSzdLn(
zpQ<d4;fU7W!GGiUsXSvF(l+G&fg1ay-}&)Z{6GJ;ZD<a9Tw3qe+SxnyFtT_2wNBHx
zvu?$(SHzP`4Pq<Kdz!b}9OvAoI@E(Hx(G3{N9N`FMP5U$o$uel{i}QRbIs{bdDQQJ
zDW`Cx{}XC0>vuidyXJyOw)!!n=-3?N9ONn->2L6x@{<qyPd>-I$(c1Q9mg2<58QG5
zCSDmD-z<JNPtGN)9beaP@^4iCRNNEf5(g_8k~bmSjn{6w$E?{p690H%$qq-*%N9-V
z9bgoebb}oo`4hzbme9MKO3yK}>NTe7j;nGi7pl$rH=kpo%#Hp}c-x1kJ$#GBUgMwQ
z++#26o<*;A^boF7Yd6hRv2V#v4!Kht(aL+c&3m|u`VQ}#?stB-B<IQId6=I*=%*4I
z(=WX@!TIK_bB}a=rtS7`LSw*wgzuwJe8u+^w($c?e&F7Mc|kuFdi)8;yH?NIC+G5<
z<LWIm2Kr}hH%&Iyy+k0J)|WKN%`;8#Y=d4ndPed*2A-Eu*m@q`@cf1*j-IDHSE1*#
zb?DjJ67<h=RT4jO<Za=3&^>1UBj|DeO<1qjzN7<V>ap&n`pic!A?|*$wd{{ra_9-2
zzmdAWFYx^y$(Zl^Lqvfw_H#kb7AyZYINBFzn$!AZuM%|Z_zmMHh&5gMH$r|><FL^i
z*k7f6$Z^p$2KI(^PyIa<`hAMuWuq{!-)y&jv+cwQayEI&2lSS8_-z-K;;?__&|J((
zFDt42_S}alX|SOq$swQXGBh77L2YbEkC8*TAJ);uVQtwzKGs2x*qZuv9I@!cdo4TH
zRO3Sa#k(5udCwrZ^}dXEX1u@Q9YhG;NANDECA_2Pyr<CnitzyNd1k)fS-jgwc<0jv
zz9WdE2DO%;E^{y!^D_V4!<O#}a+;t9wG1}msppzYI&`g*^|E&Mq8Aw7;Gg28L<jb`
z=XII7E}WSPHWRw8(8Utx7qmPd#G=DY>9HmDorKQYxZoVxhX2O7NPNVu!jTS~={FoR
z6h}X-wP_F7r(n;t=UfY}RS3=ipm%{C(6KkcnF%p;mYVQ8JKo#f;Hzxjv0YGuT4qTH
z#!V34#nF2@-qrEmE`;Cf-IDiwt#JN_az(WfvtOV-^D!@d^t?w{|I$9NU!il#{rkD^
zwWnO8mDghHdJKJbFVXc(X*_%KnX-7UB(42h$Nm#tF@J|pUWH!FNF6`5S8^nQan%_^
ze<5UtTEA(IqkWh>Uj_TZb8Y6i<&3g-AzGeM?%5&O-wJ1UUZ1l&?|b6N<BYHC{-pLu
znCpmo&oH))zUYr$>6!l7C)UNf*9-U{5|7tQ{B1vqd&99^F(z`JZ_?M{x6-vd$1U+!
z8{<Er_Q9UEJR3**4D9zCUA{;-LogDq7dkd@962!m2F?xTQnLx}ZNu0M>A<+^_n2JH
zR~MYOC5DKE&k;VSxes{8aE>|Cocpfx&F41HxnA)3U-|4Kw%!NSFw_L*U@qom{w0o}
zFM5R9`@JT|+;S?f3u;kwh!D(Gd9u+{rD;sB^xl67vE+dB(R&h-73@n8y9IsG^Lhba
zg*e7lqI--l9;kNaz2`p4d17U4<jA_@PQg03?tBjN8R^eM>?haQ6n8`JPi)1Q$a%XY
ztdzDRu^rKL7B~~Ilh8eKgU@l6O*Wv;P4zKX7ehU=&JaucV0u|UF~C|P^T?$JHRlUk
z_6l*WaFk!M&vE#eBSg<wV(@?CDFz$0sACvocYKXutxd2uQ?MUT;5&lY$R4L^a;>=k
z*TvBoZu_@!%^AuK!5s8^a?U5o`fi9L52&#P^(xE(*sR}j$p_~L9ETht1amSsG(nF+
zU)n?VlYK_kJtc=+YQRdWj_o9V4t;xuZ9St5&(!}UuIu@`<}$YJGXGCHy%A$+y^dW2
z+bAsQH}(6+?fYpwRIiDte%SL!M(#a!_eZSbvEkzyaXmSUTzk#|xjplUcYj^qm1c4z
zEBq~R!|zwvEUO<I?81``Kfev$JmryJ?dZ;{c5J=C*#4#**6Drn`dK&Y#gD}9z4M+m
zt^+>BRJO(y=6k|1BlDXib3qp&R$fD{AJ=H<T5-L&h7i)}i(bf~26g*i|6)m=0>8mN
zasO7k6<5LE%I~+Xk7SM~924>z+mN<dVq0H0^8Fp?`-b)G0^>Iv=ij$)Im++gw~w*?
zOZsm)iUt4n{wLDE+gG`-_W*TFTo<16t;dmTseapTS!15`lWSvc_riOL@xYSppTc{Z
zH~NbY`y14<&$^}Ux17rP4bF?~i?yR8M-te|7~d14#1Q`*Y7V+{xK3QJmY`#^-+Ak$
z7wnFClg>Sgt$Ve#{u|!O!AQ2`6TI8=`#tMOV(Yl-OTJ3=q1)G(Gp}ox1bSy3Q5b1M
zvVVN0@Od|y#$xNU+boSkKKw96%g?INedGIydx%=T4!#yhXa!;`_RWkX{t5gBzx5^^
zTyte#UGgSmGpu_gtm)+XSZ9c(wGYvR_hV{rOqULa=W&7OBn%M=&&+R3`JoA(p*&Cd
zUc~p|o0WfKO!<c57SG(wb)Bs-&;z~Dr~BU0f5Nd<lEYpY#`urwGY@mqOHV%QkS)?r
zA2)~Jg83~yK{wb!zsvZynVo-|cm6(4J3jQ_H=gph0(*0krac1oYCnM8+<x2NWK-@>
z&<Fj5;M#5VdDQO^pWhnPe=o463cjJe=<Jo=IdpzQ=e>_$%)1}<kr;@~r#64bGvCm>
z%xzlsfe(EM`s>*%{Z{>G%pU9{bd3!*_JA02Oi1^9NROHG)0g^dc}>}iBf5NGKWiWc
zPVUjx8k=Cv<{nS^x`+$g2K$!#IP#s_*87Q>?`sb4D+)t8gxGqg!F!y>yA8eLFpL2o
z?1Y>pcn?H<*n)R@%)Ks7j*(pBDd=|zBxA=om+@^QcV{l^K7#YX{u##Y+DqcF*^b<d
zbqzw-h-<^OLJqNIp9RL)iQ!sKu@lbP%}5*4ta4tkIls!5c}QZG;Eeg4F}|rj$9CmR
zaRldh6gb;ZZPuIY<d9Eaq4jd#4(-*{9)kDW_ay!<*iZb8Ys$6DbH(}LJoUnoj(rpu
zI~IS9w~pP|7P1Y!n`_C@`?|?HI}s0H|K?wM4>$^pfm+UWzQ;#CdZ3rBb%fR*+6(q(
zah|l7TsN)>d%OkD6rLwMV|cFdOyOB_lCI~_8^jQ6hIE7N6c~S_##a3|IdA>F*=Igq
z?e~1l6@q<ef_+(nJz}p$IhRfQ$bHB?$^J%y-ekjWrgUt8K9o0gEk@o~oO7;;VH^TK
z^B|YNPRtQpKSN(z&?i0nT8`Xv*2h|rW~DDAS#M=%e1pGde#`x1ANLFRh<n04;6t~x
zePwT!wj&)|CHilvwXCn4uS<sTUbH*|>?wN-kxa=W*eAy$8Ml&0OvQQFs!k5Mzkyie
z+SGzBLM)vJ&IPmteI-@54T-%aTjvZobG>kM7J)Mvg0sxMz-LSsAvWhc&phWI9Xl~c
z`216Y`jxFQeb5hUVNLS^eD0T=TBB?19*5=t=E6pt*NAi;J|J$05PW9R>l-cC&YBFi
z8}fHTUFyS1&_fVI?p@3I#1Om05v<ewBN^WiM|{P(#F7Wrkw8p^{2?MiH%s~vt}(M_
zmH2?z5Uk1TM6&L;byE8`P#YZUIgz#@YYgK%4*y8*SmFUYj0F88PxV4Rueocz^&UCp
zxq*+p*capvvC16t%Rb+0KAHC<-7od_3-z9PilGL*g<zfFHDEJC`Vz#?GMDr5ljj;$
zx}IyCtg}^z{??bzjFX=sNOOOVI%bxbYU{Ey#}LfNyfBk4Nl)}=)=Q6}S{3(RZBKev
z9?axO-q_bOHYD%9>6PBRr^wJ4+ew;YwqU*FA3;sm-_mc`({Zsh2A;3KfoJg)$lnm9
zuIECIq)CFumP@uutz#WO@vO5aQ?khh_?95PCsVR=G_Kf(&H8U-S3Glh&zV1D!%jXr
z{x`_uT5^54&Rk!v>&Kq8s8Q>9+;a}TYi$wj-*oAf>a&i2CFl@|$4lcQkfuw2!u}(F
z`|H1h&3+_f!?=qOL+hBi-l6pa>&14G&p7vu{hGOF#IhIEaXt107%y>t39;mapeO1w
zKYcJi*OU2t-I3UcBZqwUU>3G?2>k|Yo^1ZD7P$(i=#e#?kDOm<^4$=R&GN~Q?+IeD
zBMswkZ27^xS2@bs){A~*hue>h-@h&I-@+Ns#6HIRm-u)0q2J#Bgr)d5cu#?^zOSgU
zqs-N$|CXBfr~1l%x_X28!jav)#n|q+H`(&t&F#nj1aUQ|>h?Y5{ZrfB-z<C6rN;x_
z&nF)?@}T-{yJd|*r#6goHaO2MZFhVf_m?@R?B+-Z_HBrr1n=((x4p~vCoIJq@~po}
zVrrbnAv?X$YZG0)vp1hT$$LMpy;&M#<8veUY-y5$&-<01<Jg8ivpRm!*kfUx`piQu
z!x$o^$ClXLm+K*Cg0JQ-#luMOJwYB&rzP~cexS=Ag3o5w+Qe*HvxtQKU|*nJY&{Qw
zXCw6F=y?b{7hx1add1Jt$@e&(rF;j{bDifq-;JgSz8~>-i2fb}^e)@T=RdjBWS%8X
zLO<>e>HfVQugT-3^?BV@VmHL1Bb%Tu^D(bs%-n$AZ0Uwv;P-RhKL9#(5h)q-dpp0U
z19ABMt_0~=>@Wp!{1(b@KK?uQvxoWj9DidB_E0QwMAv>!_FmV3@20@@s5Fg<A=WV7
znTH=88#SpvH5YTQ{9Bv9vFUB(dg%3J-}LXb@$LY49|XMbsqcW$v28&ddE`@XiLN=A
zi@)!gn?53YqA#<g!x24ur+?M~tZBU9^*R<glP*ckpf=~0-`~{NpilM8dlB9ZtXv0n
zt{pM-51;tdS<k12>U^$i?jboR*UtLUVI@Pd71%H4XaAUch!CH5c6x8u^{$3@dc3>v
zdl<{3cN%6&H`pA5^mt3B-sk;Kz87RJ=3L^4sb1*GMD~3oSzFWkVM}LytcO_gp1|iC
z#8U&da4q)LI`-R#e+ka%WS_O?p=-!FGK{zE#{R>#&NI)M+j;Id2k6*Zf{qQJ8Jriv
z`MJ;1k{v&UAlEPkd}c|9lhQilT7PRU&hmZMmu!`h_W^N0f7E0hUF&8KknLI*e)a`F
z`^A1j6WpWhGuL2o&2{}a8@-$n&Iz^<L+1$E1!oMV2r=>;az?v|WaYa#<P9;z!c2(`
zh#jJdUEUk=-tXw0pz(V^VjMR!o-sA3ztrDnJz6vCXWt^P3;P^;u64ol?TDu5$`D(G
zo+Z#<AclDIsl|2TdK<=Da1A5pAf7yGu8X5_#r|sZGwt(S%ls}G7uePV*v*sQHe%>=
zB<v0ATv`k3VO^|~GtSu@DH&t0zL2frSYo!I-YB^K%=*N0|8c&N)WUWIHHZUrLyaZq
zncjcGYom{S)w^r?`W@{N*I_30+We_bt>5si?pyv+?QeAXAquR~RJ(P2qu^L<O|ain
zu&+qi0-s~7Gk#*p4o|)&J5Up--^Iyu6y-W{HVoI+*Vi`Wldbw|OjG>IGuiSpcj|M+
z9O(xCDCf54xuwPy^a(>OaRlpNJvUpn%I$v|cjW-JD??)w(&=Ri`eJSL36XH$8P>!4
zSZ^00mYy+&F}@>OSwH#IqwXp&#*Uxb<dAC^W8cELNAW<vH})ad1HIUYsrj?ib3XBZ
z!pi#OQ=6K*z!)DjSr_Xwj3a$Z5>7&`Hyl%?W0}ujqh^RYH+wx_uGv;khP<9o=Ll-L
z{+90Zgbw(KBab<mhqE&By9qLKe*B@hm5^s_>#{)z_hm_bOIQ;y#!ftWOPr*sw;TH1
zf^{r$3XHMiCyzSRyxFA>=4Kp<LvMn<W&s=iBRoHI7;MlI;$S^M%og;@y<a~U_VpQZ
zkMGzzw%%2PJ)u5~7eaP=26{s71Rr@zoCmPK`R;i7snBN~TPKg2Lxi9gdTJNgZivA~
z9yN}jE^}43#uc7XJik`r=O?oNf~lA%?%XKPZtI?t`J13GdPOqEZkBZCA^QvXKDq3J
z&K~EwOR_Irb*bn4so4Ktbk(M3dSN}_xjknn1{*Pkv29#Kt}AQcejJjFKX%2DPp$I;
z-^GU5!oOwprhO2rVB0MnV|ysaU|Sd1-XQh}eqXF$?;;9}Zx-v&I+xbXUQQ9x4`bP(
zBV}LOx1IL_d&PcEa?3t=KIS=so`$e|((w^HMHeBc*~F*5=3y@Sf+O$|NA4E<*7^j$
z!@jZPs~nBNzw=sRb6l5x6SCdV(;MGnhw>^-V{_Z<_||vM@45Qb_tN-0fc?!!y!Yg{
za^~;n`xmnQ{_fx9-(-!oe#fr-jsH*OU8jzzb^a#2KOq-cnHs;b<$Hs7GKLuRx7eTT
zHP<zV>Q!uin#;Z#|6AR;Z_>Tb+&Aw(*Wx!gzGpsleuLwYuEBicg^>M**p(bfLrwRv
zr333{&(;gPj|0D-`%^iU3(kwIcgs3|_1R93^v=4tulX$CGb0jo?5wqybrMf3ai_^A
z_?#aJ`jm~&GGeH667pb@uR5c!Wh0iHE{MBh7?X>SSmKZ;<Ec?|R;iC2Kg^^_8tOn#
zLJ~Z#(mo`g(f-^%?O$sTN%p~bZ<=g8i+LVGPk0utd@k~gt_+P$lg=|6X3`~ZLbjo2
zJl}_=zTfd3&ur-nJ29%)b8dQork)Hv-fY=I>!@J6!9U6#tkkg?a+;uro$Ew0#y%7D
z8~gZ8Ja`Y0Fdm`_-j8&#^n3Y8(6QljE|U1C*vJ|)B{A55T8(=8&Hd=Nc3@1sqrZ#U
zd#=S2=LLMw6TX|(>$dn_D|Y_9*(IsH#MW=(jo-z~+L^n;zAQl;@%+7RqUhA4_7u#;
zoP4Kd{>bygdQRc9K8=YZ@2CcKsLNbaFt7Wg7j*hT(&xy2u@Oryb*Sf>)FQqqmi-^O
z=e*<KT}I1y8cSn*hnTEQ4&y1vHH?qIPwW<<IRG6Se&V9ARG&GT*t+h%_Vf~^pQCpd
zyuY}?PQQk+VJ*}+g4)c(d{59*&;ID~BrSVq9g987Yk)jy>yr4rPI8<#q+`cVT#Y5B
z&chgn*kURE2<95emgGz{UC+of#d$&J`eHYXw?Nv4WNbJa)B|+v)LP<DQ|ECD?x9g&
zjNK3i{R@uSnOAEr)eGITZ}@&j&M(xsH=Vi0)jvJCzb>7%vj;<j*tus-lD+DJYr(ad
zx<(;ZUca4Z>FBI+=BCcx;tc9MayGjNv3bvTNo=++`8d~{V>p@D6mxi|SD4blHuNKi
zrCwJq`PA8kk@rWaPx}6xH?5KNbA5bWyzfVQ4?H`0-tl|^^od<L<g#x_VDH!`>NC%0
zPuL^v8GFdNBjyvUz319Q&J+0@<yrcMpJo5`4Ab*%U*IFI)>x|9MWke0ZLEp4vMwZJ
zVjbsLufOFUbj7l7>;-3v^W-z-Jz<P*3*uNa60iZbC8*~f=mY(UE<4zFqyv3Dfv<}Y
z%tb#duNT*ZGaf0IBsR|fEQI38A(!5%MP2sk2=+bn9R>V71>M&NKX~leTiX8{dFOr`
z-}Pqp^Cz+?r^32nB~{1PMF^i8Bw%~PG2i4+4b!A^9bk&iH4$8A&KB3J7Z_u|!G8O=
z&Oogv@Hww5pYt&ibZo>dK~Hbc^AxNFyf(`%n|a%}Z}z2p7)g_atvPS#<7Cf+zQxYH
zX{<*at&R1C;6CBr;dAfvnJPK>3>5XAB5n}NzKBEaLp}VCS<;~=*bTNLT%*dF{Z_e)
z&9UUy8Z{pM&T;%wp1JeM0rsuJUc$P-Mm%+>*;CfKP5#O(bGYVF9asX}4R&*+gU2J|
z>4VzL#r#h_+<wP77XKF1yz7T-_<*=d)A$DeE|7nNpFHO8A_V7*^Ty}6VGQ_yxFyJ)
z3AJG4eyoQzU^}AgJ~7zHqh1%(Hd}K6b2c&66ZZx8%hdM*z8f5UpZa`9kpA&0j#^RX
z;=c5J=ms183_-ltfMmSH5yW%P^BJ&`Z=V_X97m3^4T-J2ur=QeJ;0Oww%v7aKV!#K
z-L^ORRA**iUGfR`54@Ki6HD$EL;J9P!28{`w^N+N&(xvkD|mcM`)^s}?6ZwInCqs?
zM!)pkQig2UiFLl~ZS`ervuyH_Lp}CnXs_U-W6OHZ|NkXxKh`~0D?PGipx+8Mdgk8Y
zKK8xaH0GKUOC7#vb+HOZdTak;N>;FYyrqN3P5N)CbNnX9b6Ao?4f^g0IyQVY&auR?
zX09RYKf>o@%Z8nOi-Z{bqwEtkLLevgG}jPY#9#lNt})n7OcUghzf_lgn45XfvEd(z
zBai$gj%fO=70?aidEvO*w-p!qz4x~eKND(s&Ree1<L&!t?A)#zCZunzAJDO{2aaq&
zZ|?IaNo<AqExacq_s0^u{m2{QmN-Aq_1k-mVQi-KZxC1gjE(JEHt_hLO4qBh@owjD
zFqCt%WUGYU#eAd7Z-_%jK2hshcN}@Y<y+2Foj30KHO{`s-rb+&D0|hU*ZqIeiMgpY
z{*F#P=9)=QdE2m8rpClD=So<o*ZfV+vY$tK(>py&^vZ1?^1~fN+)TP;2=`@4uLc`2
zhA}?Y#M&x#osM^Xd|d>e3Hp56O;Vrfe6B}+?(;bhUE?NyR~)hP`YhtJ1^Dbh4iUni
zN$A*Cfid<9wx4jkKjY{HT0(#80qm6;)8&H@yQv4!lAU|P9-Q2dAsGqJ#meUyDI3pi
zp3OZ8N#MI{6MVm!h0gc41p7(Qu}4bmL;2KNqUCeB_VA>;-zr&$!S1}tb3Va_Z;A5&
z_8~&leCOda#N5oBXY#jN!ryHx|8C=V4SwGM{#L_|e+&NR8-l;x3^sgI5O*@COF{_O
z<o6T)4&?Xs&u`TF4f*gpvc}9uov!bqLwmls2HN*7Cf6@P#}<MZ$2uN+_3>SI@_m=@
zxY>8@*?l9KAKwzh8^(8zV@JlH%weuATJ}bN=-7!Np1GFx<+I1ykEZoc{f@r!H+9}|
zHNpEX!x%d;#Ik3fzpa%|9pgR5@0zt9?=QND1l=6zo`;;seum@`UGq|N7Z^joAbwp?
zC&bLP(ZkR?j8<R_JMp+_{CV%eyN?U(#8Hnm&^vP-L0|N@1^ax%KCLA3d`_-O*;DT=
z61(@9c;{NWhJ7usgZHQQGUOv}mie~obKe}nIf*=9t4Piec0dQ8De~zP$r+<g#Wl%U
z;*gu?wVqkd?G1k5d;@tsL5H1qY@2gkbE%H+)t>kCEvM{9G(LA9z-RDVuX0|s8JnKI
zkfa~?hHSacuJy1-?9~uk*QD-s=i2Eya@II^OXtt$+Gp2t>x}m6j4tJIR-1A^e$KMq
z^Z6a%;ok@f-Un`hFY^3Tm$|4}SsKGhsLMUl6Lf6M`8k(b1LuWv(sF%~Yi@a6ksq64
ze8#$TZ1}cde?B(q<>vuwo0^BY(Ah8ckUieo_o3?+dL|v7OL|@bI?pNS$x<9d+8sN}
z^UgL)^2y<PGvCa$&?_)L^jy{&isM|kFXl7U!rrnbaYym%1?FU)cEP-WkNJqB#u4<o
zA7D=G_$xJ*m<n;!Wu7`;q|J7GO|TbBM8b6f#@LCcN9OQ#VE?z^J8T6T;BOb${)DY~
z!yMMDtaIObjl1>n(o4H~zQ;%B!puCAUD8B3H`ei4M=tH-8#RtRs5a})A9?M&uKC~`
z<@G$eZou{HB80E2uPt``M{o|v<yr%0g?cyG@i#$!2-l?+etLO2pY&Ss8mjdAo@6ik
zf&LVOt=40{meiimr|9CS=T+9~HO^co`@>or_XMAn`po3>jOX_jj0ewMfqxQ{_YZmO
z3pD`!rl$=*u(!sxl`&oN4Pwp(Hs}x7ZW)Ss0zdt1!QPDAFZRq}d%}K8Vy5a)lexzA
zS#xqOufIz2cJ>fCpX>fcGB?BpHJOLG=?l;+)kbWM?}|0V**_Hr9-phG?LSHKY7ArM
z=^_Mscy#8v;QRsl5u8K(#F29ZwUCSr<C*<#$x7X?YPUYKURR9}%m+K?MK(cC+#`Ta
z4D(X|2<}JUm*`LQa=$L+j07EyAZ82h{rXveehT(gn|1q!;zJ-S)Q9;%lZ`$q*ue3Q
zp=U!p{w<i(FgCWmNyk-r$J*CampPfgCm{)pkC=)9$6`a@g1SSjFC6&{pV?FFU*P9%
zeNHbuo8PE$=q<VDVt(ia##@lL9`N@He8e<Cj@QNdM}ki6yB;;}+OGR1@A$WI&F`AW
z5KkZU6bU+<l;|P2##~#jd!*z#<6}KTwU~$6GdYsr-|+Z7ul}Zo-L@^gg56_u)1?1|
z=XD>JwHMdGhQAjWV>gVu2*EmA!rmEd_?93J$=EOke6!G{n<L$Q4XqP)5`X<m$3}h#
zYB%8?7-OdndE|7lk|W9Qv;M92mj3PbmUrA%4e)Qk{;hajzbo7BIHYr3v*qu_RoeGk
zNiJ*iI=gg;2kcw&9YHSh?4<T++bxMV_?%PMY2AL0El2*wzH-lwB<}&9xP3F<FKo$g
zG`){7PjTOT-{Rl$u-81ty~&a9Osd~D%j&ak-;-RbY3jR{Khd54B%kW^d=G?tV#@v#
z<Pn23jNfn!G7|SY${yHei4R&zk1bc`di*4bvAt!jDt!iKp3^SL8GZwQg}g18V<leW
zz3w`mxnD=}roQj{6P-HL?IIF-qBqluj_;1c&w9XXLw8=yaV`@3$lRv*u03pg-sp3S
zX8_L==sXLWWPYAKedb^r3Hr+GL0#kPgU|HTkq`+rp1^PW$oZNi@Oe80ecoXI2Js=5
z);UBITkB>Y4Eq2l_l4&nMB?WpvI&33>3oMN@ZFW~Hud|?(BCkPzkBre2yzL&3r#^B
zk})tI%BLoCFxSlQ3iRT>R_geOB?m(KddS;ZgZP$E-(bTBJ3()P7-|~E_}tG?FE{Rw
z7{l5J`yfK=G^`ue4>&FqM-8CfO_Pnk{if*r4JelW9t3pk#BAZ3NY{1#$vEswa9!sE
z*zr4`y69b;%&WOu@etZaK%auxm3h<{3H?~V<<7Yx^SUIqhMl$QZ()8%>Uy8>`Td-C
zM;h~Y^5Hin{$`eK=(qL5@9O-Xo}iP{6hAVa9ANzUeTrJjr+!>@$Ug;-n`%;*c=A?(
zF?Rez)O>VuvBSQw{YjD=<m;Wm)H@8brQhJ|f_EWX?=_CzkE{aYCi~=_hX}<Hy99Zk
zcOcoT*LSogU@zH!_U<Q$gZ2Ziy;T3E%Ldqwpw<>#KYl0SeDM2;?~R`K$CiY7fsL~T
z_=2(W4Rwy_nMd3boXeRU$%^e&cEvy>)EGJEP<{GdT0;od6s%Kw&b2({I&jT750e<>
zeQK!Y$a|1`4}33n-H))6Bl!*Dx`>2Y)IOR6>Ka%JW9%*Ch<6S)zz<V&!P?n(_O@O3
zv+n`c4_xD+wRY_b`*RA6L$F`u)q8?-%lYLThw!<^Hn|tLZ}Lq0{%To+I`~4c|E@zV
z>XJ(gz0nWr_^c<-1#2BzxAzdqnDs}(zF<Fs=hM)0#m^X?MLlzfBX?=cvkM>bJcG#j
zQ<%dX={NR`m)apaJ<vBj(dW*!pkv4XM3eo7_#0wuTk?0o9MA;&YZzk>#Q?E4_SO7e
zt_Au`s0SnKlH<BdwM{Sc*mh*|`p~g=5vk*2|JY-HKdbV{{si&k3-~L<)-n2RJF-3D
zes15oYL2WKlIF=~A98E`FfZ5_V9(6TJ?oMc?B@a-^aTARwJvtkrHA19a;=--OmPl4
z50TQkKd-sZc@}Wb4}m-a8$LddojbE0@(AVt<}=u-J+mgY8e`eF;^-4rawMPd9{!1(
z<vKj&-Sf~xPeKytk+n3zS}I-R5bOzi!yd6`eCG4H&F4Cx^EtX@$Il+HALIc0VW?#t
ziN6bS0DTJV1{=O1B4IA@7~c{{5N{Y`A4wD)yE)Q<yqR;;AN{Tej%<Jr$zH)swxqEQ
z*#+@K>|9r9-l?^ik-fC+g?`*qWG?yZ;%E%mhX}zO)M0Il^(E*YhjjLGh$gs}z!+ao
z&>d?XpLJ@~eAmG47~+>Wg1!u6?9fFB^30HKu;IVK-URc`Tmv@h9l=~PLC3ZP{z%FA
z2>Y#X#j~I6>q^kEQIohXm~T8lUj{$1%t2l1aW1ytKIDG%J;@lmnbL3UbM8_O_#VGy
zFP{TdpR#|$v61;m<{4Ly^wVT}1AkpZ*BFlW0noP~pW2nBvGM#KTaL_WlCFbp@Gn9B
zTMhigIo9$0T6?um`A*^fOdk5YhMn+C?Jq3Z&5;gGzXw%pv#dVr&V7<A=jf6K+euvG
zO*-yP*1TDM+p><|`kN%?C*E>xC!Zd>2*Lhy9k^D$o?N>oo5AkuA9+p5qXxC8xkWU^
z{eq>K^8>`dNJ6s0d^6`oLMzx;b8dZK`Lzb?T8Y=_`mXJK*Y((bOWQ56x5V@K8nE~5
zE&io7^ZO{A+y`vH82c1k__x?9hklz~!oTezd-<)GG5$NI##<*3<^xBz{}fO4tF31r
zAxYmOX_D;24R&zcl1{GcOzD-QaRpx;TgMJPrN>pCmt6lYKlB?t>=)jA!Mlh;mtMhF
z$JVibW2ujdW2^1f9n)Xt#6Ew?Q5^hfyz{DTde8D(#vjBoN3BaP>@PT`%J##Y#NIL0
z=C#g0*sr(Pt{T7L&Ua2If9UMAWb52RPmb<6U_8@DEIF_QHK;em5%<~|W3OOiPhfu`
z^zQ<pCmz2^YPoKc4$M1~E?KGekdL*o-oa;0O2(`mpVvz)IyQVYhtIKDXwpyn7uc!0
z67q~~LpJcZ$|HNd7CWyAJzxi7pypX0vOf{B1HA)%wg<3(gPfCV?UEt<>>PS7zQHq-
z=PAsjONLl_rUK8|CN|Gm!Sl9@li!2+o)d-t`racO-=8Pn#Z#hVBYp|$P?I^B3z!?|
zV<zY(q!UL@E8Ju1Ho-j1H#9GJ{+>M?Nm!!VrgB5|mpFp?XR;+L?4$Xwz1H7oO9X%W
ziJnZ!roU4{y)4l*Z{^5VA*PEETY2Oj)u0YFk&Ln9uMCYVO=EDp$ClW;h-7A6=APn+
zp?>!Tw%_2qU~fe)Fvd@vCYXykyNG0D|MbP*%%A;bkHyyC#go5{#nRvJA+~;B;{CwV
zZ}s&Z!P0N|yw~Dg0Ke(OXUy;ZiY13!YQPXHVT_+R-UINSfO^O&c%OieIf)~e-sqK{
zfjveJLC@5litXf(uR8Rzv#(koKWhQzu|70z2|Bd~HC6iv=0M-F(HGDoanz{!NAm;g
zp%><-7xt;X4?%~M;GbgTeo%wj%yF_G=BEz`F*L?E1#xkK4Idog-jR$e#N6O#j-B&1
z?KgWKx&OW%oGIAC_XCn~<;jO_h;_la<@~}-j-;`z%SJ9W=z*R%Ge`RaE9sJ~gSB_|
zg1yb_!=3}z>IkmglArZ|>Zm4jaBp#+J>7%#ezd;IJ!;#N48?teIqSTRt+lX?y!X8)
zO+B;!?2GBr4Yn=VyC{3yREJug6Uq1}hPY3T_JqBO+*kG%y$kGIgT=MT`s^R`&=WAG
z&nc)2jEU!ban_KNvFt7TSz2e)Gi8g=vt)=>IMQ$M4-vw7=rDOk<^Fq(Q}e+|*(D=k
z4Ly5goxnZ8xnoV#aF6r}%)wkkEOC;qXP?1_KT@uY!A{H+J0-RucB#wQgmgm;&;zu>
zJ+40X#IT;8MDEotXM(+Ak8ZFZ!L<W)Z2bZ3#88*{=w%D9X=zQBqw&2j?9mg%RmcVE
zg{b?0&b-)1Lfkiw{FNG8?da9_O&^MlAD~a5=awApU4^}bo>bj7BzD7?>)>m~bpysD
z?dTQ9a2<ORl5cRYeC`+S8PNpyKKDEKmthQB5JS!>Ft%-LKKffpXdO?mKA43g{R#FJ
z``i9H=O@48ej}&m>w<N#9@aH;Py2&p{UMt6=<_+G&!V0zN$l()F)%J{za@KqL!En$
z&>V)(eHbax@vYJaHJ}OXl~dxj{CB^MvD;_=lD#rC##g}xOB}&ovac0<)TSra@cDe_
zGd}5(5GjvjdsuHMzbEMI198MVpBhWg&C1B{C|ln>pj~5ZGkuP!l6Y!Vmd1uTfgWHc
zUW5By>e(FWO?xu0eUIEL?D)69Hj?Vchkc17>N)oQZ(R#xThH@O4!P7}E_$kcg?vL0
zM-KTrX}X6hwi9!6`?_MNxh}B%2J-JY81IC>xW~=9bjD9aem*?;nsTV$1$~bM9Ztcv
zD(xqKW}nofZe?VzOOk#ne183gsW`Y}Z9npXKVOmK3tPU*TWq^(IEQC$FD&WiNPnW~
z`^61$U4)=E60pG%N02uQTlx+DCWt4`)cl&mZ&;?<sq;pSL%-vy-?c5Pk35g<N7_~;
zu}yegU2BU6u-nJ=<l6a6F!uf~#T`LS!yK?5u&>ES9{JEOLStB(>jpdVv%r|R&DqU+
zk^76!E<Uqnes&?d;Io&{XFkV|{_f;&&k#+2hj#rv+Vs0X=y!t6e|yaTrzJt3vQ2#a
zUZBr%?%l@zs0a3aiBn+QMF{W7(E8Z}`X0*d>YMwWo`-s-$3>5Vp0P2{=f2N*_>Gm{
zW9x6V>l)*$G5F1q4*pG;--o}k<>$9-!`RsNB!_a~$%oA~Zdv22?>F|5b6VCMblaEo
ze*(Yp-%!u>n{;}gg1xSL-(`D(SnQTH2HO_YWe(=<g`awH9uiz@Nq3#8dge&?I}%H5
zwvX~I<tKgrLF`klmhWnw<WszDJLk2u{ZC}exu0_EtI~V)O*;N5W|nJ!-jk3V<=Sx`
zOi$g{lsK*{Ipog^Z20~z<ior;8iUt2%KmTZ=G*%@#~??cNjILS&fhg}B=<hmeevEP
z?>O#LK3n;G=6Mo&p7=W%pTF4n+~%`<wSUEia?DolCqE@)d`SE7LlZ|eU=_ObCqj0^
z{4ff(SvnTkOK!EJJKnXLY68!+H>P~hMF^h1Jj*IgWA+QCXoBZ+1slFCLh*oZY<rWA
zLynw(Nj~xBKZ>uA>)4P^?U{H!+pEtpmaXIvzj7Y-3}#A?PsR}ESZt2niubiyx<24*
z$@QIuQ}k*l&V+Put)Y6*E`skKe9tL=oA7<*3GNkW33)&bzK<cHi}e8ZH$pzZZ~gP#
zNZ*n8o&-&EFb^^Gu*J}s<KE@mAuB`Uo9ahDqU&1TV0Y}0&Rj4>OOE=0CFm&xJ<}%~
z^$cC`eUI;^{6<i}pZ5HI%6CrQmGC{4cPD&T-F#P-Jc94ANASIN<ZlrC<^U&uqX@|+
zKQ*aE9#C^+ZFFi8_sLUF^k+gk4B7b(?0#p~{q&-mwKr;0bBS|-ttaTrOP?zllGG-T
zxDdPa>orWx36XR2u8;5Pe3yr%e=|5lONovRUl&sx;<TsKWFF?+*$;gj;XU=f(q{<b
z=(80VW5+)pa2_$lnkF3>Z$a)7%*lRpPB<@IlOs4woU1K3V-;+s+O6L?HMXnP5=U^R
zIoq%=Y;Up?OAhoTBpbb{SNi{~M|;cl8rpC6o@-Fq8sqE4=z6mktozfS=HcGs9=y5l
zQ^xawec7Bxy^(~Z*UB2LV<%=MN7C3fWD7yw$$c2wgQ-2>+I`ldz1Vp@N4ciNuwTR*
z#@N|Ia!#Hn_JwoW1!vYUK8zLj+4HQ=+|0%Nz80Uo&9g>4XO7$@n)Jn7#A|N)`CLz}
zi#4)u>?JfkuSPz<BA;<b68v28bEZCP95XWq*^`i@CiUkv7xQ_}IxjiSx16#aK_9gT
z>(~u(H~5G}Qfq1MNSOPGPG0Iu61!o1+w8Nn-x7Ny-edLvnmBpx7T4h-GzOp9mgjKl
zECOc|+YrPpK}~9J!QAw59$=m9f%nAwvSq7OKQWHO4vwYPZ*Y8-&a1Zngzmasy*+X7
z3wu==8bcJ=*FS-4(FE59dP<LxM-T((*m@F@Tz{@H*ZLcr2gCX3A_Vt4pFM!S1U_Oa
zhuCtK=*4|mKH2cii><M#`}a*}ugy~&^{`vsF`jRhUg&p~y$tEFwN7BYO|TE_3;VP6
z8QBG&vyq>%e9odD(aIin<v|o&hg!r|`23|db)f1?;~}EJ82b_AZsB_9*m{96c0lhJ
z*zi$f<T~8D*D|%1CywmEez9+`6OWt5#E?&Y=3@=)AJ03}G~UANqfcUCC+?9tz!-?>
zf_;grcGnybf@dI%f^Ah23*<eqWIqpJzafsbv0m2q27SX2ORyf+<uzJv*=~sI2|BSu
zED_pwVE?%m^}1l|>Az#~+3%Rhc<e_|uhw*Jq<v4)aa(c5He`FjF<btsFO7}wXJpTN
z8)>HWH;#Ojrq7KEzAi#AUrV<30@xSuxJvuF{1xo`0cww27xMvgPjL$LcaPmOcH)iW
z?0=I(HE*_TP(Ne4K6}lQ4veke^2i5`?-_-e-xaoGCG>sb31Y};1;*HkAIY6-`!`7r
zb#Abew=RyxmD_)h9b4_=rMB%)vgV)cq1tXe6vG~||6G@zMA5O^$Mx?zJ0XybvHa8+
zszv?t1^*_6oP}yfrv|mg3n9C?uL)!O?tJX{n_x{LSQG0o+z&I?$2xsab3bxl@|nnI
z?cwuSL`puNu_66=-V{d;wU6eyd!?TxSo2Q!z4(bC`?|p9So^zvhlcruBVVQQzUg9U
zT-h4m1n(X$?wF_Xo#Sy=ttaevt?|%H_2IAB_f2|^e<JVRm(~N=ts_s;c!%<WV`{u@
z$hW+2_Nlp^s5y0xC%wkr`dxc#J`;Mc10$u!e<I2KDc>=_kxTXd)6{t**II4pE4l68
z#*wuwy|3)Kb)?5g)1;fHYigTgkmJgkI&-E={|0d<&nR`aaNkc7KRC9IZF|bY){~Wc
ziadWv&F#t!K@Ux^PCiR_({<Blb(1{$+~xCSCFm_d4|2--Sp&7OQI9<0sWVlt=W~f?
z#1uW@IfajyU{0|TbZlF`DUkMe^$Ya<1iqtOs5;|SaLiBAIYYVT$%ZeIojpIvDPI$x
zXCu$YLP&qY&(@(m1NP4QS@$%wx4?5B{M_Gq)&pbgtH2mLpf5p<E@pBhnG=}*8;&Cf
zT%*b^dkE%ZUV57kblFb+UBKT4fQ>xr)qbkJ)gwIZ<&&-F-?lCP9_Me$!*?OR-(2(4
z!%7=IVtRgeB9HG#k>8VM{vC{@Hh&wNC7pTizt2N9eB@B)P)l`3{(Z}LG<0mt*HYFP
zdI!f6{{}Iq#D?_B$XsH8wSvbh{gIL}KF4`)hHS*pFMG7LKGw;4`F(=l>Y?Rt72X$Y
zUGV;-iLG}jymR55%F(+O-gWVg1&IwmagIeUK^^9r;)pJogZZdW47qn*YQquK`t+mR
zq5fHeVO(uoJHU^fIhh;Kn{0ruD~@Z)9(nI(?z8t1J1h}`>+QW{9%=@4wVti@Acw%#
zFR(570NpWDy6G81jV7o$1+vz^>re|Dd4@6dsC|Ujy>snL{j(O<#M(x#leL})u-nJ}
zuva_bo;0^@<b8X~CHoCAO;CgS&=d46@EgYX>6hL{!WcV#YOX@)vy9I(m={N5!)K)7
zv(LKy$eDCW@c2ltIJZjtUC<lr@jBc$_Q;r-^~fI&Y}tU%cRuG~{gR_NKF1B?KY_eE
zeyK(mA?TO2nwGudCwGc1ct#+fAg1CNY)u^1T7sHSgzWUu)yLGCn4J6kEI=OJ3!EK%
zBlo>t7tU5BoUPCGqL!ehW3dmx82b^-eFQxZt#MtPYfOv@>2<AMFKez)A6C*OBjH?_
zC!2jOuM>Sou8DP2u;ZWNB;>)!d6<LwS8^ojmEN~tO<o^zT~uGyLvc6M`zO$od8=bT
zvR$w?<MnpgAd;PX<9+hJRmpyuE*(5RxzAPF*E2RGfonCACi#uceIUBve2)a(V6%Rt
z6I;RdhU2Dk=wk_boG*0Q4RPS{%$y_XbH={jEZLqIc@3&0&esT8^BlKxUeAxjW^C`W
zom?a91jZHHhwLHP7xr!?=uI~4pFLyWQYW6g->?*S3XI7ML0#tQNk|&L2f#>LN^HcC
za~@dfBZge^YA$)i`~-0jf;sP6)Z}xzUrdd$8^&Ekvh?{5BWaR1_AU9yrN$AS(-J#=
z;;8ZYZk6A;Lek&Ukc|CZtV+i<#T>rd3iO#dOL<4|-EEieZIN@+!x8My7VOy(oRyt$
ztqs?HiIZ?vIk)=-e9#3s<c>l}H_XSp%x@Ua>;u1{#uC&8=7618x4p}LGKbtqsAnB}
z_5EMs&h6Zq6xObKvz-O~<TMC{PzZ%k2!&8Q$7;=E8CR{n|L$|_hw({BLR^bt*XoPQ
zE9+T0#(hD~2bydZVz!8E=Sb2o_Yqn9NqcUKI<AWj_*R0BjTqXgxSoA2{ge%L$#ult
zC;GLspY9)Vj;-;;RhrI4;0&}xzge<X>RD>N=ey8ys{E(8uH{?(quk(k^w7H+_QidN
z=-2&YJ(P)oDA<Nv$&oaCZ!*}d|A~C7=QeKn+uT!qyLqZh%#$5k_0@i?oQp0Qg8BD4
zAe&$fy?5AGp>h}4k01un0lVqaE1@ztpCx&3nr!U#DZ218QJ;&Y=Y(gBbCt86bC|Qa
z>zs}}ud(q?;JN&qy}X+^|M?E0fBrQ1e~#$i`&;~f+mn!_yk+0~^Tdkf?B{(zzRx?Q
zoaZy2`N-#%elyM^m`CQ8Io{~9(PwgybMVi=mOjw-{vUtieoXpDjAEz0vwXh8s4nA#
zNVy~#|L2{=yGQdvU+4$zAL0EFf2mz@1mB7ICe8P2zE3~FcWvxQ^Az`HbDb)C=0ciT
z^eAmT>C_?qCy1;36#pClQBEMX3&uSzu!VepuZhiE=QsGJxd+w&J2BJ&*CY27C*ijQ
zep4`%@r9uNCs$LMJ*RbVTK~yAU;Axo|FTC0-|^Tplw}Y32YXWcmw5Kf6qMQ1KzS<P
zWFNP`+X>neTW!~VZS|?bZz{m=E8lROW2>xs&wSWy$7YuFpKz>YTseO#FOAU<TlHGD
zePlfHrpacQ%QvQcl^W;zw;Uz+?RzTMoNxMFk2aS0Y0mKXWJ-d|$h%y9w;qZI?AEKK
zKlJOS$;P;*=z?dB=f=+^&tn(CGugDiwcnS{ZT3FzD4qkJkHz~b&sE~6a|%m3U^li^
zd&pne$~6j2dWHTNp2bR6xe_WvwOOB+ojAjID??>y1;&0f2aR(<=Ldi544oywyLjpS
z$a{|YV%~`D%-6+K+1x(rz<QwObA8J@&r{jCYyP2jOr*XfkN7DEF+ltfk+4^QGWI2o
zAm0>QFt48DB^_M0Y_btgy;>i?*R5*}XL2N;upjy6@A4VqZtM&BmfG*Ezt)=f1n-O|
zhU^f6eQ{KW_YQZn#oetC(!u))xpQwF-M_elMS_kEKRL*^^KQ13pLUR4gc$M>gQSeF
zu}>59BOBnev|eMM>fo<2TV*rTho8L8Z5_L@uPcu6oSc)!I5l40<xTAT9)TPxA2H>J
z8rS9L-5=Z$x%+ab)m;*Oa2JrD96(-hKJt){wnu`#WurY}sZXArxtDVH1fBLie#KFT
zeAFk8b5XX9c5LsmFVz9+QZ~f1S6I`?HCsh8e}Ip9gdvCr_6%*2FO<8fe@o+lBc{sO
zY1<6x;PR19{h81wbZq#D8zKbrOHL$Zz_*ekS+O07ot)&}g86|Zm;?3*W7-L0X6#Fx
zA7I~2u@gV1F5ePAjAThxPL}b9Xv#}J=ntTug!0I>U_6Y`<7Ui^7rVz8SABBRKicZN
zkMhh#nk~KQ+%-eGvCWd$3OQ;S-Lc3~@=~s`)a`=#@LVt-KzWHHhyll2-?F)lrQDJ4
z0Nw?LcfyT*mep^YB|dcIH)x;!(RbEvm33hL=`%4$dHmi&?u7RRU?YaMBIT3>Y~&cC
z6)4-roX{5Y$J(<W*!MgK?3JNC6M{X&bHX#uGeLiepMw5UpSh<U`f>LGJ8jv26hq$`
zL+9Nmj_~~q{R!frCn4!MAzyoe_JDqM5y?`&3^sf>*hluCxni74FlLAZeF<V_!kB^j
zcRN#gPeQ-x{}znN<6F|<6l_EGLP&pt80_SyJ;p;{=+g~8VrpOL(-U`FcMLghnruKD
zW=c0*dL>jgwa-m`|5Lmc$eA3i7wcvyLzlmTEd=}B``&w>{g3`sZW+%r4tJU7$Ufvy
zJnbye)Q1XvaCyqN6ZA@GZeWO2IMPj>V|3eVJi6^q@{XlEE<$C%Zk>M9-<B{g#v5X5
z{Ls^e9UUKY*EL6xpiglGzL9l_r4Fo1Vv9e3oaCpSF5-cu^N@G0p-dd{H?~jtj&Q$e
z$6)&j>Q=~CslF$j*e>X66I16pXFD97{ha?HIP(qVkv`(6vlDb|a1;Y8p$>!~*Az`~
zAK|^yMeu&nJ#L7W(mLhO{ZV(wE<!BbfsvG9ij!=`lk<>M?a=NLhxXM!#ybRKhtNC#
z^8r(wgmqwDwqW0|f7S~}cJFB<dweJ8*nl`7PZ#8-4ceq_)1{juotVfv)CcE$la5<i
zuS=p=ut8j4TQA@<k@Xk{P_}Pn{Uhl<PR)VYsoVD!SN+7)IDEFP(sq{~N$ndpd@DJU
z;5Mf6?H}-2=Ch6S?N3=(9m;SL&gJ=E%vOHmcQbN`^##BCxm!GepB&`A$AFDC$WI*g
zXL5>;4POXisbgH1m?L~|e3JML@fF*j>S43rvc}o=Bx~H8UhB>5SC<UI_(mBo<E9ME
zUr(4@e5*ix=cx9oJEq1B<!A|Qkehbck4WSFS*3k5>mji%)#X{@`QjPm9OKMwg0px?
za>h*&NZEKlaQ1Vq^Q~j*o5$hzMZtfMh~Mw{J(1rU&5+(@Cx&+c=Y8;8t9{1E8jPgs
z*eD;xOwk4N#9V}+{!ssy`c6MX{r$X4^lqV#ymNRz!3N%IilGkmxAJY}?|-RYawPq`
z6}rpVrr`TI@SD&L-`CBO{=|_T_$F^`s}f(0n<|^To?~l$>yEXw{hM^`H%a~KpQV53
z`++;g<vW(&F8uq2eU5F)OWTX~h1bJtg6#>%+ZT$1TJNY#e%cK6;SKz6O!>fma*V=~
zUO6h?@LLbe3)`!_V<_AI<a@F?{!eAi^{sA=d(&%u$5h*`-*e{jdYDi9koa$gY$l`w
z>&H4a!M=E7$p_U>9qN<Ed6AR>pRo-&65CvUl1s5q9NC#G&*3e%d`<t4K||R%wm;Oz
z2IP0UBXwkmnRC@OABK6sj{gbfp)nsiQ&*GJdx>|_)cc|5y|3$>=bgpb&wHRLZY0!+
zzuv)5Y)jB9wj-<kO|S9R@7O2%QvOQqv+X1M&?L?09mRV}Fm~wTXfBwK!Fx<|!~C=d
zc*iq;5Q4d_U<3S1oa8CjPqwZ0L;ZOJ|4ogxZz>L2LZ9eg2>L$C7_i}kl@goBxD-nn
zA314nTr8C<Z~mh==H9Rt{|DSPxO?!ot?0UMEbbhlap&RhZ|+dsuM%`@13P~QE0%g@
zNe9Xy$m{&*fE|cg;s|ol-V(jEN4vC%4bU5RC+<*UUSNX|OL2pHpz4s9HfS$I7mRV2
zc2BnLwk)^mlZTuYY%TLsH%c3f^Jspjh-7h>6oY%-3sZO0E{^W0{605Ch^@OQpab@m
z97*bt({0fP_7JW+q?4Ptu0F9Y%sq23)OW@J=ux1&3ieaa+%ZS-%sX?$dK@uyKHfC$
z)$&b2+)_MspcPmH)`NDY+NIws*O9f1#Cxnt`-pR_{mcP6650i}osh>lENxrz9nsV`
z`p3M4`s#V{eAK<fco{dG3)?O2XTF%j{ht7NZklYyZ6dMN*!|LeaDH*#rJp+1k@&he
zqH)F*C|8JC33aSn9@+i`>UBXsn&=vr_gdr_@spE&?FWK0Il=#=W9!M1gp)L#$!1Fb
zEnBe=I>QZR>bDDQ_`tDmawwl!(kr(AB!l;g+G321HH7C5y(icjbEf(A{Idp?lh1xg
z@~lkJ#L~0$d7kuKjeNGcY&=(nIO;6U4XrQhNc&BFqkqhYq0f~%M(mFJjhvakNt&Z}
zE7&PpqOTXa>>-%1AwK(&Jz40|0oxJGE3wp}F1b(QKFu6I<MVizbYq)kTys>*J98n)
z`;8_)e2e+5&$$>IV}xD^>A*ZNAC;yuFkj4DrK=3_OP2OmWvC48Vrzfj%-r+rQ}1*3
zE&34H;fVTdyy@h-*;l*tYYE23IA`HV2W&kFNuWH%5zHO)xqk_<rb!2vcjoYVv4+<1
z5lfr2PrpZkj%^D36>L3;l-O*?Mt$dN(wV0&nC}oH=bib)=NKf6tiMu{v*x|+x1ah=
zke_y0W7@u<9}tPl$dw#PgKdZqQ+tWC5YTsmpSUAv+qf^aKg3dx97|^`XKf_D+qhii
z%JZ0Z4LOeN_@Ijr<l!vm-ej7}1|M<6pM+e_i^RS}2<Pg`7h>t&2I$x-*uXJEagBSP
z?!`#T_^C6+N$A@y{i1F9Kwq|C-k4wJlyzpkVHMqFY$xftPq*aFOdqlf>V=?<CtBH8
z^aZdvc1s6xkn0HY)^@CK*$uWXh^O8VkvN~rw<LBwKpb^v(uzdCsbkslQ{TCdbfAxh
z^2(Tythhe5k#Q#_HvIGI17+;?Q3m2GL**mfkEuSHU3C1!8OksVTe{&~gz*DQe(;(4
zCOLOu{y*TT4ZpvK?gM5^zo~bPu6u}Cd0#n_;BwEHkTlp<;YhFW&8n84bbr_S6It`D
zY`@yjf66!2x5`iPPk!p(cG`BIEW2zWyaudG<G!Z#3gNwmjt$=vM?OQGbxUkrMB+V)
zbQ@J~vU}h2Japk_iZVVVHlD}MxvR5y>#Sa!-+7L6W)GdsEuYn;xX$|mKi@<2U8VjG
z$iHJ~_)ReMTVUt6LVgeAdkS^*p7^{Ml!v_Zf&S8e#>xB)!Q3*>r$9LbG0erM|LPz4
z7T;!QL+u^4OTTD)sBP>`ZM*%$7}b6-?s5h(7nG6Y9_kZqb+yT!;9KqxOB^xvEgSfz
z-Sqt%hFBNDcX9D%xBs`YE7xxzpWAfqT5rk^*eubXz<+bc-TqoWst?uHOIz3}TiQq2
z*cP&Z$2M~AS%*r?^}z4gD#_uTmNVNsl1;y5j07DUaUsab+Oro%lRfw5(tg?6o9vy>
z-qv&0+1H9`#8Xf8$>rQzxhtXHUyOf`L9YC5rrK=B_l>(wEyqK9)n>icdDGX`kGDAN
zvv9|Se7Ef`6JwU<(A+kck&YR;u1~VD9$FvPsSDPO^@b=qcKpQcgt~C&wVgQYHLltm
zbLXt_Lv5@JkF%F~J<|V#S?Z$qBqS@fZTiv#{hi`yUYMJapkwRlM^eT<L<pW+&eYFy
z!ug)h56=+qD!(6izKH3HC7x%{@O)ug33@GK?@36)RxUH7Khb12N6+~alXt|6&vkEE
z^SFM`b0mHtnTx@EB%C|*g0tsnE}6ek2<c$kl70m7u0y%n?7Jl~D`Oo$m1m3EH_F&=
zu$vlR<GNzVeYaI@UH+Sp4Y>0l@waR*G;d}|Uj^IUFPCc^YsI>4QP(zf7ny>)&Pe$C
zxa;1r1osc)a?>4#drSq}P4!zJirXS|Ut8jcruz+&GEm-v``i-T`CyBt`wom`NkZt^
z>j^s8hinNsD&#$Cqe8nOX7*#DD{f?4&W8;jef{)X<6;h()6MU2;^du<GWWV6mLR6*
z+@G9()&Qo;_=%;Cb8$Bf?x(sda(6@r>_^bvyl}g2lf2+^mk!uyi~8guFKrCTA^T!n
zTAP#W<27QQhF~6!U_ODl*@Ahm^Tym6>`f3yd>7;(A4GvUrp>PQ*+1-~RwVk=UNzpc
z*ekYM+BY(nWwmelo?t!<{eqPoN%~voX=yx+lQA;~b<eVQXMr+A;_}RxBU!N>S?$(s
zM}DKrUkR1ztNTm&_E+1K{|F>>5eYiBrt@u-Gmdl4=N@Mtz9(9-69?2Yw!O)r_$E&F
z!~LO*oqFV2$&svZ7XQRl4D1)`*<8=(Q_l1Cq7!2{&!6Co{|&C|d`R1BeQZm<Av~t0
zu`w^qQ!j+{I>&XM*+1-ko@<_o(DT7F#WTaR!n1zz`Pli4AfXF<hVo3%U2bZFHDw*?
zAN{4@^#3GPx6R{5Vj~7da+hsK+V>=Dob||@NbsB@ZL8A$DZgpbfic2LiH(>o$T12_
zI-H9-c8{MJ#}DZczkqh1pijpBJ0EspT7vGF+CFiH7-+(Cam%T>=`RFxr@i7m+c*Q*
zKR-a6A(lM{NBa-h>o5u-ojuDQUIp*zCLa(3#DjAz>EN<uWZW)wu-U()A2HQG*us5(
zlJ*acaS7%KJcm=du`R9`+mY2bRc5W8IGNXVXrKPkANmdG*vUy;1sl+3Vob{%HIMT#
zFU(U2=Fd=G;)t#`!F6`(x843*I*wchoAs4#4apGh!&HBoK*D~(b&$6{GWU9rM>c~$
z1Z~ik_h{EX4Y74zj{;@DM+_`+Qlevv7hJ#Qta{B&t|O37^lXDVP4F(6`A$KvU=OkK
zuGb{ZkdD1)9deBX-Q`ewv`Jr%XgO!h9dpQB9>E&37j}WY_*<w)edvOmLxf<ByiW9G
zmwwV`%Jh$zrFiO+1IV`p{TRuTtk~YNzr-8rLl@+I0$=r`&j%bsABTv7=Mx*gb#YV%
zayb8%4)nW@0UI%{Q*${-^$q0>K_8eyaDVVEal}+kAV0Wl>3*zhekr?u$X2j@l{!Ax
zu=$+p<@~b^S?$(mu@htP<2$0B$wO!KP4&O&wa!+KCwQm#WJ#VcG~LH;X1U*P=@9L2
z>2i&!y8V{ayBV_mmb>m-+3g`6^VG(AX&Zaxsjh9I*l)NmGv~2Mg4e-o!`iW)><#uw
zB<NEd(d7Rv#8a=QM0fdUUq8Wq$Br~ZdI+AkCc2)(rstD$kF$L1I|ko8_=W-KlW!aH
z5yN@;c_-+5#^>9JzHuym{}WTc2|_Du=|{fBH<!$H_)e4W3UUT#ZQ)2C>JxqAETHd<
zb!onsU*us7^jmp?Z#?=9@Y9z5`=d+r3v4H$k3)Uxs?+#J^8nv(7(cl~{iPko{+YAv
z%gkqw_1~g5`TvqG7T>2u*Y|Fi4}9}I#oxBgxAdgxJNpwu_6jksWBHqUHOG_g9QG}>
zV{Eg$?Jgr7QziZEg8B5EPL%;4vI~4eF#oK>DeHk9zw0!$W!%=1E%e()Po|{7MjZ7&
zxs;nVXAkfUf1WAr$Hv`(XGLu8OWHGloxRT9{yclRm)XyekSp5X{ihxGhd!KN(Db_v
zj0fy{k~Q~}|H(F9+IX`+<#@9>NA=e}qT{=5F1wz~$eHtpG+jEx1@jK9cN1G{0q6#w
zS<=bjd{cVGcFVZhbD2Ch_95*<@7czY1dsVij<Qx;`c3s$y(#tyw>h&9me|pI5|Z?J
z2<DGH4Lw<U9)o8xpI6JJXW-;>#o5oZH3aWIo;98so;{v#>hnDE%u^p*OC1}2u%8(G
zm7_Yak}e5xL7U?bq0TqR*Am9e832qCqQHA^2<Bivy#JXW-jn!lu)p~nOJ0MG_%4p-
z-eAM$I7@8CF_c3&VO-emI(O_+Je<Vkp>hb?0N2BAAGRm|QcUHj%pA`I-8Q5d(j!@E
zr_N5ieyrsZ>>Kva6oWei_bKuD9f-RWcc%p1zaMSx8uG&uCu3*E#`T-x%JMDwZKmt}
zGey%oXz(|?=z9M^2+Dwt?TEp<ihEaKNk6>TxQmG`LU*#ky-Xa@c{VTb5lcOCKo_(z
zvrS~<eVFYc@za+OTm5G&A((@%`CtyG=5lFXnOo0qmkqG<yW12!3GR2?^^&c--%mJ}
zdP|Uld{b=E)DECyCx+OTkbiQ=Ob++p3w*?rll{RM887R`*jug-^TfO`f2Y8l8tlw9
zpkwbMgy*&8+;-&y=Gc<GFa+(=KK+0tMiP=hc_l{@s6&6r0jub?HQAo9zseeieHAF%
zk9}VA!@djczaiL%m7_A)Hl&*;n|(<8tE~Pz#^pPvmP2{zuc_sE+3{6e#}eNXP0!+d
z0Uw-<bNNZm%;9+In5TH#TyLv>@D30|tOu~$XL-jR#dMv!Fdx{m-87xeW)$5vB=(gA
z=k^bD`OTCLl&iFky@K7okWSl-g|UWU?pV7nkk&)G>8UsE3!d$z=b2}kXPD<867<ir
z&KaOO<Yq1Edbm7gH?}p|PWEACefmgW=`(Z9{8bnati)x@mVV0U=3Y0K@ms&!BgY%g
z`y{FJWXFcjP<Go>V>Nd_YQ3d8PmGec>P_|vxoM}1qj?7AyE3wj?>CSO$ZIIOu6?`s
ziNkIjyVT}LLh>8lN9?P6FR>rlQ-<<4LVn<k8wH*LINIZreJ(=qOpF3$e8e0<9p~B7
z!DY)P8xUW?=9n!V=o|fC;#^?E2a%vJasCkIk@<w3cn!QRRW7Yj1z!l)MN+O11J#CJ
z?bMs1B_0Q3G9jJ0VXj(%GWMRaN3!OjK0b&G>QTQvfc=KJx_0y01NiScTQ=HtAD$$B
z;;7pabl3vFp$z!wO9=L36I*9CaCb43@l~)@@GU{EUT|*Y8`OjGg8k0r*rxc}hpJEY
zuZyF14)2|j?;!4j5Gv!N4(*<V+~BfhSO2HjqUGE%f2-j6?PaZOLt>vPtDPL=Y6)%7
zR!`iAp?-y+&y267q>LRu^~mM++$Qaw3-58u+fN<SrH61|k(A#c{)SlU-3-|bKIe4(
zsd}eC+1TzeAZ_c43qj61zkT=(HiM0NPj#n!r%>A-YX6_GRnOe#T+g!)Y5k6&Y(H`(
z)n?tkqnM_5D$Igyw<O-+bA8v{vQ<KN2^fVX9Zr$x^-fxK?xwIsYyUUc4RQSf8|;Gf
zJlX6+ju&doo9^6id6sg=Uw;O5%#eQ5WV>-cX3mS}oi%_VLa=VEBWv142=7NEwk1x2
zUg@Rm7$h<HA|clhEhTnhn%Xw>!yNfKe#P@Fa=vlaai;V4J>RML_Hy*iBmCV1T{e81
z^FGhYA${}hO5ZewzHLl>;|MYM-XZv%4$!f6e2OFfDBn^(-W#;f*?c6?fqrpz&`-_=
z&IrmOID0;^^jUd6IhCK^{YDa!`@g?4<*PK6q1w=QLf)>iFpi^fFh5IeGk(Uw+;#P5
zsPFV|so$S{!1MB#Y<!>g_i)K|;cw;0Z@wCL#~#&vqUpQ5nbQBO`E6U9-wO)-j^Hx-
zjeV9wbxo5FQ**$)M6xvRKpFc?jwHC=&VD?#Ipiajx*=H0tu<Xu^|ih{Q%7sgzHNFY
zT0RpzKcBs+J&)eCUnbwta?dxOJ@&F-fA7Tl&>ot~z4iQl&K<Q$`~B(%`-}eIV?2yu
ziSq)!Z@8X+6LQ(o_9r>>w<P4v9q)WU$@S9Tw|Z~!U3n^@GO+fn@f*ykeOr3PIjZcL
zx7wccn&&5-`s7`OBOUH}t!1yl&ffz=|NT(wmc&>`Qhu}9*A!#ikJ`6e@9Jj=#@WOy
zd${R&Vh?w5+TYJrNb+oPhWeewvoLt4@{X0CSn9n&KB#`mC+jZBn;{#-#pn6sEHBW%
zKcUt|r!HfuER`!=<w~f`dB9w7PVgR_I!`!vw$2vbr-Q#^bhh9R;zUy&VE%r>vB;hE
zkrl_>xop2Bb+K7mr#wX$hj+a|2kcwaT;uA0^*JYX$;0^xOHjV^k!uOh@6_Brfj<PX
z)M+VQ_sHjcFtnzyMcqTZ2Y3f?Z`iv3gx&?b4*>mU$;NvmxLb&>wdLKx8UyRi{mU%r
z;4-omC@;Ysh4&A8guinEy%i`M?C4u8-f#KNT6$;od|$PkXXY9xe|*HM4($OsI^~31
zKwjc#hqzAv=&Qy#G<N2Jd1BrMcSp_P6iai;yl&mcU>3S`IJ&Pb!M*J!WP5_RC5|A+
zQ(ou4eblLt2gU`qBgnG_dxNntR>tf#XAL9gk2zw#HuI|aA1~k|W(ww-`R#)FXO7=!
zW&UZC{Q|57H1V|mhym7Z3i8}-I5&PE7D7-L3D{=gNT;rIBJn$J&}WT}F)z`yCpq^j
zJNId5UxLfuWUc>C^l!PVkK9er_nx4i91A|jV8hoR!0uR&bL4p6#_YJA^YfE*KWL|d
z9kw7R?XKiVavlTcuh~Vntrr`9;H<qFdHy0-!ufpDWvke4+ms(pQgv*c>6Yk~p)yok
z)$P9}F|<R!nH%PjXSInTSV!iMIcYggkI{0-j*s~vt_yOl3vBp^x!JM-d4QZN3H9%$
z%XU*^T-VY*m#ehT`CLZUxT=rRKkT*6t@o?1Q{@|CZrhRV3F2%=zrlCgY8n4iOqU%(
z)UiJ4j31g{-B{0Fpo|?qaq9wGrKt?maXs6rv>!Pyy2|&y8`^U>AzOuW;%3VBM3epK
znc%tTNk{_E4e;DF@p%vMzRUMdNS^{f@hdr!-=NJWp6b-Nd5yuor+T(6^`#d=`VIai
zj-U<Za)~2Yg9<jle}kRaDRzQ>(`7UE?GlfVT;Mi_^bkAej=lo@Hk6qY#y}kLhBEec
zK^^EK1nUi~scF*Ra13?Hv63TM+oJ6o`>7LRXPZxLxgBC^9Q&^e_9Bw<NuKgxyZs~E
zr4L=qLM@};5Q{CuQXU}R&c1ZX-!K(Nog3_396fXY@!Uy|d<L=MC$6$pZrK<5<o+R{
zizB=SRbsEcp|vx_;hUn15af3ol&fuIA1s^7^bP25PtdUeG2l8&I&DpHg!{79mmB-4
zB!+S;eJ59iy!b2B*#*k@iKT8YIiBhh3)I_*pT{b@p3^sob6q64pk2^@1wV270$T;Y
z`{F(<wOO$}vY+-Hm5ptdwl|$+Fu!oeY{lMCpEx9h-mNfx$sK=}oo8M7D8muHPavn*
z$<w`b=^pw7-z@qU{7u7kN8W=iZFgLi_+0L4WBvd!cbsj=C^+uO*8ch%^gqG%EM0dh
zkLl7Yp|W9oo`)tKyaudC7pxPoW<x}>bKkIs4EqQuvtQY}Jqby0*>cHdu!Zn5gq?h}
z>GpT#CywXybCz+=@i(^qF6TQ0-y{~_CiIP>^BpTe=R3@iZxYAf?Rh@(J~&x_>)Q?A
zHvG+o`h4^FeD{#PGEXSxlZ$UXVyRueH}DP#^{weFppP@@k{>(gZ|O6AnW|5FP3<gx
zgA|kB@RFn7^(sr{@j{dRjs4&L_POp+ENyH-yPt17j4|hkv9KP8b#H3(FU9No_YsZX
zZxX(b?+e?I)@zLIPttKuK5Y0y-{oP5m7trD4lY}+jJ34=Nk++G9a&@7mG7ur;kShO
z0CwYe=Nj2YNHSK>Lo2#%_=%&=`T~B4gnF!Fh}~3I&p*#SYt8e<v$nMM+#y2G278=6
z&pt(Vl?UHCwSR&A&$EY}=K@I`Y*X?-%K41&d`vyZw9(YYl06hlp24#zA7@)vf1l>B
zY5vSn%oF&jyNT6rK;wZ(+bx&uPmGrw)TbRoyQb0p#ob@~-|7&*k}e5RU_IX$@<A&Q
zOMT~B(hWB2|3)6=0gnyo@oni(Fpp1o-k1F60qkZJz1pywkZx)}+`n5k^_Q_QA6<lC
zPW=qAS9y+Rp-cC36?&#dzRw!Z8Sh*9Ia3WezCnCts@xOu0qu=HAQW5K>e~~JxqVad
zH%+z*XNuu$=}Aa7=7jgT-iy44KhM6-o6q~4b4O>v$DV(;44oImf6fQh<(wjqb5@DH
z`doG$mwTyi8!=``H?|>dLpE`;Ur4}KV;pDumf!8wKA>YKo^dkft@{Ji@z-|9MZF{H
z+&`@iF|aPM5x)iNJ<8rdhb5-&DMvKj6-KfpgFBa4;yloJe~93HpmV<Q?$Eh^cqeGB
zgL~WsHhe=gF%?_cD&r%D*c<Fm5I4opp5s0?wZDeuxAR_Nz7uq8EAMYxagDvm9gh2v
z2<a}9llGeEjEnmn?=;?r8awmC9ED)cn7<~NPhf5<UFDmQjo;)((u$59KTz)o^3#r~
z?cs-+vc?l<TzAVx-x-5h(vM($8RODegK_7&)_G>`n8V2Vyrq4t1=x>$CQWkXoHOs9
zfAk7=uMz9q#L0E1Prc}r@d0t)Acpu5to2CHu^D2HAlFDJcj0=Ge)`S$81oVAIrbjx
zq;aNj9waW?|655;pdDB#UGC|3+|Kr&Br!d6h4L^4*5@9J+Zl=>Zf6X!hC1j+bFoBS
zzk7aY*U-NEu$24e$Y$^j5y@7272Anf;s|on))t=s;Ji&H=d?HvG|t+zqnjc9i7h(>
zXRzo6+bpXOeHD)MO4GS*CTDn-Z&_oklgGKcbfE8ynfYLzB0*=a0-s`tB@gY~)chyg
zaQ;vkJRi5TAK8;7Sve}3yDjX*_7_6-N^O5=T+j-(?ew{POZ@8>)V8hn?CX>?=h7(~
zkNHj3y1nF?54vM5YfM-CKOt1lJk1Gn*9u#E>IwEC^pq~&693K7{)Hhv&$sq2dl-)Q
zvV4&cW7y}WNeAix^`R#&+s2tQ^1N$#=1rY>oO7IeOYaLL<td1XE7wu^3EHSQ#(liy
z%)Yz-)a@dEz+><@kk(rnTh;NCmo{i`U(grZm~+-;3D&Ky=T`YQ)H+XkSDvH%KwGp;
zA5QkMOIGMNzLs&s-gStf4)O*&>@rtJ>kF(i^rB<;{4sYx-N-!TTH*-ziT;==9Xozv
zLy&{Kv~^S4qaEr{mmC#rD<S3y`;q4tIKF?$8}b?Y$5>j9$7AXm*Nw+TJoOA^Xo46+
zx!Pu#D`KcaKj`au!SgjWcgD82IxBOAWM!*8+PuO3=DTB?V(B|$iKJ&4JAUfWZWl`&
z;l6K;16*#`o}f%T^`5|Y*Ksc7&fLV@c_`oYZ<}+F2SU&D6FlcPcbxs$osazPS66?4
za+4jO<Eq47eQwA3pCmEWzErLpm2Wu5p#6fWm|Y0HW1-rt+c)Glw*6a48#8IyA95~n
z1b2!lw(uQh=pG5{BAUif;JeuT0b(FtppEK#ip6#_A8dCFW#Vp*Y;W*w@XcrYe8~A`
z>xzxU^U2(rCf%?Gz<N}=%D{TDZbO9d{;BKBo~`>B{ocnevmdBS9whcIhMuREY{^L5
z)N{z$#d)^%H+AT5@u_bRP2XPl?P2J<#MC#6#rF%b^}Peov2DI#@a;nJd{YYkUgtbi
z8!P+yX^(c~`+RpQxr1*X%7LV<C2054zWPCYQ@^Oo-3~cb?tD9t@9@1ubTKk7x#-)`
zH=SL66Ab-c2TQ--fq&1trTsOgUB3@*{U&(hn34Hu>(Hk9!FM9YNk5Oqz?y8<ze)b3
zvVKom3E#&3o5R$%^8a7Z5Bk(gzv#;rgYWoa6;A5*g~~V7HTF3kxqjftU+MaNp;CS1
z8X^+6JFhvl{f?`4@>G_}U|UEh-npA}=51<ydCqwjcqV{nkLQ$U^go_?*||sX40>;~
zuX(O`7N(wwlg|gw343XZme0=TdEwdBbL@BQQa<>+Yt<I#6YEKz>HA5E{u9K4=X$>U
z4z*>+SHWhQen0w#<1DA@_JsD`&mlbulx_36A&J4hF0ere;-)yc&qI=D63~0v@jubB
zzS|?G^II<2z-6RuRaU=s{O7`Rf@F^NFR61s9)9mz#m2u!Sj)Fg{YuNV{Y_u!a~F(@
z@pZxcF_+Bo%y|#yUhB|UkM=iH@|5@OlHSud6h}Ouw=ZnfnT0ML$W2ZdA_Qmk`~!%u
zxGpyI>a&jBH0kE(Uhs`2f6w~^=L+WwXTa83z&rEvUgw=7DD(c|oCu!}lEia1P0lIh
zARmz1*!CM4*&j>Jx(aPT`v;snKkvHa+dn`IG{IQASQ_^ebuO01<MpWWT=PR5U<b#}
zhqbkB%f}u&{4-4DH>uE_p^GJsXu8wPWOMftq4R%;BPQ<!(e$oZqVw+1J0x^Z>dBOZ
zQ=r^M6ez<?Y2Q{pV;i!U_@?(z*L!TU=d`zm_Ey&%AKr1Soj{)gdtg`0<Xy!*lzO}e
zX`eAL9*vLjG7rp2r1ZSB^sTfzhB(;y`ySGaGS{{}N$0p_SKcL#pnaemf;{AJDJf&e
zKNZKidCk0DjCJICA-Bq>tR=R=JDz7)^TfO|cb-SjB{raJX6o3N>H+nkC0p}<!<zJ5
z7usA&<T|ld23rL?eSM?J2TN-mg0Zo8U<+(V5VMn~{M7Fmi=RF-t|b^RbTN}73EqoU
z+V>kdm7|Lgv_+fH3Y3>1<}H>vzvr1b2Ylq9{!GYo=b}wwXMy@B*K0_^64>w&|I|O)
z!j7Lf>KN+2K`g#1(an^;1%0jU(jMbEg0&c8i_jUp#7T+X3-;k}oV8+JY?V!L&L%^$
zg572GTDE=34yW)|cC4lAP!8&=&y16?GasH8%FF}fXRIC@V;I@)*1MuLl@oM>&rIo+
zt}?hUmQQxusw948AJFY{o?8<8Mwc(d(72jloQCoZaZha7fm}CF_G+UKunI@|P4%PW
zZ`a&X27JWye@UqRPk8LeanV$MgL$5!|3Jw9#M0jU2K#!mk8@vhc5r?V5qW-ueE6s0
zOqc!!v9QDtA$VqBCXKTt@fk(iy+9csaa)jwd~YoI;9Pv`r|X33&<1VMCT&B%z;*<2
zPvE;DZeDDafp$l7B$?lqYsPv`agw@6*h969?l>g%exfS|La+~Lm-gugeG2-cKDGqC
z_Ib%)p$_F!sB@1U{}3UZyUv%}LgI&A+NB=#S8^o5?a+Vg*oUA#d77ZDm2^pC8<IHc
ztjz12lxsd>0NWA7eS>~E7kY*Il#x#?*<mCh>Gr4k(8N*S0sR}q!%k|Myv~iiiJBAJ
z7W89@BkDM+KFb)1Bi>N9ZAgy<eO=ss$|j`KA4C6)ZAffQFqT!IjE|U_tJ;>@IKPBg
zGo*vd=Ou^djQOhAZdrX*->O%6@`avl!?SK|qrU4omwlFwX^Le`T|`R8hJ6-@2kKio
z*Ecyz|Ej)Zzd5pj&oaxI=O1PK)Eh};89Q-1ah+<r&sfe~W1s6IpKR6d80SE)#CHhp
zBQrUYzOM}3Sztd9P4k>|Nmzv=-Bf$e*pM_ezir4~sCMhsZyg^x(oi-_`ZtdJm8V$y
ztFM<fZaw4!kCQoVKfpSG*QHAj!P>EgO|Z68u&-9xV_miiG2htolg~NH#q+~6w(^<d
zESoyJxThWc{XO;lCG^eV^9_RUN@D7}Md#ZE-#U^Z36$||u@pP>{em2ge4LMJhc;=O
zzI#lea^tz?yd+L-FSXlLKlJ^>?K&_0`SeRMpZuktjwg1CE{^&YqUqa9=bMbavn~BD
z*ZFNuZ2evb{B8%WaP&Lhjs1>)l3O_{#JEhGv`;_i4}D|48sEDZzvhEI!5-uL^%Q&u
zAAAc>j^s_x-yvrCJ%VrQKhgB<9USL!mG)WA(w1$GAIb&m!gk9hKe+xa@i}&7uF!7=
z;IgIdZ_;rib2dq!&G|2IpPkRr_NV+^?cK1hqd?iVt@U5p3tM}l>A49#M}9^lpHrTL
zEqHE2&)e2M`aDyLr(Rcm_EKctBUzz8^mXJsuOdCCJ%6*Qa?19`k<akkkafqq{3dH1
zVq6c|3n3loGyOLqeQHdt;Bp;%)mP3>mkcp9XGe246LjXWLd+J_p+4==4()^cv!ol_
zs*H^PjdZ=GIwz@fa_dv`^Tw91;@|NsNB+*YB!S-rZ@O&8K4M+BNw3uQsy?%yU6OGz
zz9B-?wPT){?-0y?T@UN0{k?8T+lU3q*kKmBbckf>9nQPl_?^x(#TgAfIeNbu+o~k?
z27k3te#5z!+A-MBk%qDv(zzFO-YGgac)x6YE9V`{c`-!KGh^^K3wHuyRR=h4DDzG-
zl(FLv<^Ku#0FK+L2h?vb(8d$QQ}2nI>#447&VjUTsl8xa8b9;YAHaSDF@yVxpq}&1
z?AMlLtc-by^8jnS1^WpJQ*=Q*^+tk@jr+n(wq$U35K9~}`Q53|bgvlPEd=)<?nB(A
zDnn)NOpAM#?prX$7X04CJ<L$9U_Tewo*=GkuTA!x_8Y(JboQe59P`Os4$Y-uEv9VD
z_Yxu4pTYfzy{rBmjfe3ve&&HWVSbQ9<zD83xGAs!^98Fw9TU>QWlP(ieCr_|n;FvS
z8??fd9vMd;SufV8-gB8d&o%Q)d3!FI56vfY!yGYZ_k4O@Etlr^1|RjBV9tAjPEJF)
zi%(l>lQRYSh3!Z7pJ?<u^H8sg5ZrSZTNj6YBhY6;c`$y>#mqU0jN|VP@@(a%zx1E6
z%?B8FX#9q`ux@$BV8`~vl%4iyHwsHScKnrgmGNOCw&J)gpP5+~pP|kYT||MoVBMH+
zIGUd-Z66u8CCNc9AQwLBF}F)|%sj&=U=R6kr~@-OlC@3Rqm7>J9ZAN=To19tNxIJ2
zH#mzqha2Z+G9+RBOG0P#6P(?@#r5e6eQJXK((j(q{U?Taa!=tqh~-J!*1N>_7T;r5
zQ@zAK;(p60cb{7)$8Bq}8T$1bp5hrNbP*Sx4<w8i?0=KaOB+v2+0Bs-cVAt$94~X?
z`c=-7ze|52WUsu9rP@cCk0#x)pDHu=TK}cwx%(FD=aOgiX2=$TXW3^Il5*wAh95g;
z!7671IyPe;X9#BsXG=Y2C|B%55<diWLpduw+q7IN!zs|eH;5y?Cm~s(&7Yue?F$|k
zF~sf%Xp=r1!JM)ltW(qa!xUSD_Dsb#q?s9CWs|Lf&*hVCbxGRYYJcRM(I5J?vhVaC
z9U^^GlDIm@)UQ+@u|U0^gk;T28Sq=T-*RN1C_9$;nV>@?uGbX5wXeGPybF0BUif`^
zWM>Z&Pd(>A4uQ>3rmZO$FXP_@=GI`xZ<=&)+0yo-oc)4!up{jY>2ECc59nvbcKe$A
zj29St7tBKi8$M!(piTNP#d!ex8^n9;NXlK%ANK_rnZvQ;nlIO-{wz>7ws+Y=&<2c@
z=-9zANSK8q-O#T4WWDyqah8r5rT^Gmw!g|JpKV)pZ@kZbl3jZep5lI!lbG><>yp=P
ze3Neft=>|en<HDr=NXdo?FoF;sktcMb++Ps&W?O%uk!A;?McRUM!QVT8+^{Oq#xnC
z#w>Rb^qtiE%+j3(e1GIViH^LPvi%9JAF6j_-;;DKzBj$rb4-=hf9q3uE4Sa}$o4%)
z$Wdt0E6lIwyh{hxqw-{D-9{3Utnn00u+O@P0%h#K;V2Hsh3taojk6@g))~yZYVmh9
z-*@;vr0+#X-zfNgwE3=-oc!LzH;fAYP;BR06W^Bjd!4`OmA93%vFG_m`#h&e)1*)N
zIX|hx`+<J#{1(v2r#^N;{;s~#Px|<2pYJO9?PuzH3*TG@-(&P!To*^b(N&hpFp`jb
zV(T};e~a_d))MrGzR_Ri?KAHhD|6Ac{_H9CAm6h22F~~JQ{XoUm(dO1&|xQhSHH2Z
z#@Tkqek+gsc5mreayfUkS$DkUlYJ@oDNr`m{-!&&%8~sIN%yg-uP_qq_;0X-<9?DY
zW0A(|Ri)!biF3SV^-cDI_QY(G+9OAx^Lq#OkiRFyl7sqnJYC~6OS-WQY1@(hMtk_p
z37eVe-;!@Q#<G?ARd*lUubyKF$(>_ltU%cu%>i@5b7YvStvQ>b3+AxGyc+Dp5l?+`
zF|Xtur5*ZV+_xngxLjqFc=y#d%GRswCD+Q_N3v4qtm-q@;z{nZKEdyQ<#)XyeI-Y-
z!ta6K%C0w5FAB8x)Q=`RV_|GvgkUb1=O&nQ=03#IT6jItE7*7Yd)<1<DTxi*Uw?x>
zlP<|xd)<e0h{Ddh)0Auv@AbpEEjxbLMYpZV_5^irmTXY%w%xMEpjUra`Sb4AJC*k*
z@64`u&fq<-ck0$V7k?;@Sn47v?{a5Y`L0Gz?hvJp<6Vb(K-t)a90l8}4ZYf%%77jA
z3;3Ggo<kphqAMmCOSyaSH|f&5IP&g+q}*i37kQsKlFS`-$w97}65VBNN6<IsVhQ$u
z_r%V<Ql))OzLRyh$MCxn_Xe}119u(nJa7{37K7iLMAzL2ju^VD!A`h;0DIzyru{Jm
z`y{x_3Ckn>bMMmKtLY8~n|oM+yV(+<y;hmr+wx90G<V$f>fCwG>RK?@uygJ|>!2L8
zLBE#z%UGIVY)HzC2ke{jg<vj#d1-~MIeUXSeS-L!<4v!5ou}4a>PJ`K=>JyV8B?8q
z=HBzq+<)ej{rP1MJ(p4T<CG3Nak<K#@ke|5X36HYIcj_4+R%>*YgNJ5#S$lJT6@-?
z=O=i663Y09Z#-)n=h41l?{vYw`mBBKFMPxhOC9o)mwYQZlK&YvUzOx_Ii%C~r9J@t
zK^{^2L>=S#M%Hz(ZolKJT*@=P5b{;F`bIyX75&M!<)<zZe-n&@@pQrZGUroszjz)6
zlC|gp`$>qa43)Qt%tcP}(-z}7qRz)IdzQ2P31V#LoLza=cAcFtFE~?g9MiK-mG+&i
z=Q0x8xXy6O!1--l7fHP?=qLTA|1-yc4Igng<lMsdlAd>#BiWjA`~WeAI;%k0VDAOW
zm2;JAEPDJQwGQJmjQ5Eq`weqt+dXg9S7WSKIZFFmI%Bc)xacpeFE|Dnf*fW@H%)rw
z?)%iZx`+#Gm3ftGJbP;7USq$Rr)P_}{|ssy>}}`?&-gd)xTW|ZBBgcCjG1tToIF!F
zqkO)guLRxYBOR#c9LW8E+g)nELO)!#j)Zu?z9rxJ0{$9Hx!UXt+39l=9?!~gxs0DU
z>Nm~*7LjYbB!9!mc<KRV>s4Ym*lBAD+CA9^`q4!Q=6YOUGsIM=SE)Yhu8SN=lLXHR
zau&LDhyvv)sOLOYIv+9A`@Glk{de>(G`tVdc|VSnl(BC?J=!84WAOM^>PYL=cVuT?
z4P{slblF1eG8Wo1BklN&<6TCMq)D2izQZgqo)9bF{Zr#){2{jPY%o)zW5@3~X{yJ(
zP#+0Rc)rMe1bv`SNXpfQ9c-WJcMNq5aa%A?t3Vl|KzSwhQI{MoCA!PlXp{E4hy)#`
zaJ{WqxZ9&0w^e<&?l{X;`dMw(Lw<0(me`0{KXBxK!~1fUGXNVodx0{X2kd+EyA4aX
z^&9CrmaenaN8tSOS%zG{!11A2gKZ^#U-Pd14UYdNk8(fZI&NpHP2V%Pd#r@JiQ%p?
zlOt(-XB<s)^1_z=jarA8T7J@rxw+$-V*Uh=#qzG}{I)yJa+bM4?@37Bcy5{J5X?Pz
zEvmeIjdc>NsrL=CixBM1A)4TsnW7gcV>ga-8GprgB=#<r&LGaE(3yL5E)Sj2{O!$m
z9=-wbJ%aB<UEeB}zqv?mzF{PMd%<_aR2=b>y5vzl^7=eqYNwuu){pG?Mne27?~<lG
zoo@nse^Ty68~*O2essR|@I6f5$foFgD-%oK(qQmSE!p~A&N`CvOuFRJ?|@G%*<t*W
zP#iqPFWHay^h5n-4x7f-H0EGkwEjo?iM`tYk}ih6hi|@%^SeRPi$t$1l`BVOV|#z7
zLyY}M%5OI8P2cZt9N*<PtK`B@o%sWs-v&hJH-pNP&3=5d(4^Czsr|rbs-Ku%pln-6
zXB`Y>gKdabz=nS%NAgc_J>*-x>Z`irJ;qtaYa0@K#Xj4%{B?dQSBPtZ_K=jfpw1BM
z1$+>Kctic0>TB}TR?wd2ck21zIWd$^5|XW{%=1*vXwK^;IN!G*W)-N{lPP%wZFxPr
z+Fl8L0s3WT(QR`aa+SK)E%AfvIT!McEnkH>1?KmOCHoUc_O9RY%#?1nbkqK)`gdWU
z<B>ffFVN;lLbCSRV`~}<<7Ym)2*JF=5Ud5TE|sn_EUn`Zk+8njv9Akk5Q5mren{9i
z74}S}s~p1bcgpzB3;3WXAqlSkO@50Tx=Xx4PJEMl1@C|UCgEKyHh-JQ#+{>GIjCpu
zw#nysq&d911Z`QOLr+4of_)}OvQq8n_$<+B*S4;52<}ac^YAxT-f@n{t9LB-3&!3w
z_91^)ED*mE*CU3yE9-}(!Ny!t$MvcAnN!)3l#iIoPrv9R{iWYqFt1CT#QP3u8<LoS
zyxUlE*O}rZ+=KYt34-681iw8s-IHdyw}tK;uwFQ_bMNDxwG-}k+`YQ)V28UQcb0^*
zZCf_(f85!YIAZ4C|6OxGa^6PH8*^ipY>oNS+;!$pFwfLs-S~b$E^-gGLtjST2N}x{
zQSd$0k~wIFqqza*s3%c$Z1~_5Zd=W1owjy?^6jIq^mz&9o4ID58546I8sB7$8Y}b2
z_?Zvp>Exc;?050m_o>@v$#d}=h<}R1-URCu!t2ByXRYASuUsqE3qr7NfPMtAL;WWQ
zxttFh`H1mabN7#2YvuqQ8-G_U#kG>BD;G?068dc25<m1LBrCRC&Jt@|lsfbq=!;p>
ziKXr-P==lo{Ur3YGD?{kV&kH#T(O__4K`wCf{v~FT^_0jt-zW9>jqu0M$A795rQ?F
zq7^7(2V#JDSmFrsk(V}Cfj&VOC-M9+H&6StYoD8yXYI-J*6%3f{6dYZ`nNhe&vMS_
zk#J^PM}{DdJgq?g=xd0&=9IBhhg@Cn1enQ|Z0&D+hpBSO2h~>fmUYQfasJ=PuDWp4
zzdwaB!ClWb`)@f^rxGedwV|)Xc9*NPFEWQE_VtA$pYa^r(thMhhGbl@zUKDb<)`|@
zxPFyWd7+7;eFW^Mn=V`B_TOb<u^|oRC-6tI^~{3zIM4J<{CvMj$60pOgSg=Q7-H)@
z0nU}45*-_G)(}Vhox^4FPjMc=Zn|`!Y(1n`Y`2_W;)${UNUvb;A_RSB3{7}kRbt0a
z>=7;J-s^z$+92y%RXcH`tXq=~&gpWM_@?L&gltRw0{Zs`eqzm2E^PRTy>Z?qpXX(2
z?fV0~hbqJnOI`9TaT0WFP3+7yRG)Vp_p`102?Tc(;dfvt#_vME52?3AQ=U*hax<nW
zwy1OZCpvY3JkZ6-{Ir3Nt>QRK`-r_E#}FZyr=u}2zM(nbZZ-wu2hRn17c)7MP4U#B
zZWrVsAM;9XKyTRwexN)vhJLIB-SNa!h{s1x;>?nM62`t0=6mE`N4MRQSVMjCg`f?$
zgPfuX`n?Ku9K=x{R&pevmv(56@(p%Vea<nI2O@FV61)3~q>S$f@;UdDBxWV(#BA|x
zzv8dd`K|S8%uhL~H<Bg!g#Ar^W80F==it<NSUD;`;dd*tGOn_H*o|$@OWD3Ex9sp_
zd-C0J^$yW>SAdlq$)@|;Otz$nruj(fy>ZF*#F72xDbBW`c!)1J=9_eVVysumc<yo?
zBlV2q?4LO=P0}!DhIvFsR=UcOc#WPUYt;mMVCFlxUoun%_9uIm=U|F1c;1GHq&~Y#
zHaLmPx5Qs<LuCjt^W5q>w>YOcyO-W=Gyf)U`Zm$^or3QcgKrlJI=0{&M*5LQ@OS)H
z{mAn_l$-p9^3L}HZ9==+4!(zEZrbd8N746{$u}CleF?scHNK1KcfM5^(jgwO&whR%
z^lyYsdgbKrcuVq6>8fMyy0k&xw))QZp{+UQUCA1;N7!fVSH5*`(ek@E-^SMi*iDlT
zF0Y4pzPJBV_+DQjkK1sYO>NeG6Eg+h{moJN4Pp&3)EUW^<adRBf$jdi!F7=B7tog5
z?b2`Tv$Q`HYiygD>qx?H+OPd|y>GJSByK+7`nT^XzN>yDM{7uViX&)?{_O%~?D&aw
z9m@E;CU25l&aqVo$Y<MBxeM~b5<`S&dM<iXS?BiA^YX@&uL~qGp*l-U)n|_a`K;d(
zAB@71eiHgeKlcOJZ@O&8zFq1ve$N5(uo86Bif-G=xTm@9*R%3eo{E8!H2tmz<Ap7I
zg}5eMA4xvwNl3b%?l-at&jEANh3A*KhLMEi)S5vPM{5Zy>5?I~_Jv`OSjT5<vm_2$
z!hQkv4)lvq+2EUBzz^}j(*5AKxIXdYAJA0i^N!&zEVySNyWTrn+&O6nZhMmrsPl~}
ze-}q>RImYlv!w&&E*!tIE;fAo0voZxIP?zv+%vd)=nm5PO+g?H?^~dJ@aw+QdH-?;
z(cPr!PGpYCKzSrvlDpI4eXaQ$Wo-0y=e>;>*Ks^P$J1}-bqV&y6sJJ>X6VjfmUQ^s
zg}4t1?nX^_q#?El-I@BuQu&CcyT=s4J?>(ue7JY%4hB<fF*I*xU3%mk&zx80pSf+C
z+n#gFd>qkPC+08Z^4xMa6rnP5ile&JALJpQ^3pbaqM!7gaWEdnWf-TyhTqhfE?)@d
z%TRuUc(bI#Nt}PHE&ArUqp#?OGHlT_md|)JZ-YInF*4TBm>D~B!8|SPomuwUNgZ3Y
zH|?t%VsG11d9WuF{M74$wwu^x%~(g)&1=<ityZqr)))@YmY9MvF++8zTUjb&XU!Qi
z<EJh#51)O2U+vS6A?Q;j)K8$lH}*N6`p_P*?@1ExIdET=Y;Wz+E`AuI3F^5nHhk`1
zmDqt8*XgPY%pG!OuKggJ>b*fcb-Q5hBj=v^M>mw2`<9@aU3C1c+Y|WA%sN{VXlIBe
zj-WqC>y+sy<6s_^V2)<ei*DPI4ZOeE&s&7f**E%wk2=)7X|fr7<fQ%*N3=Y*k$??f
zPeKy5>KgJi!5Dh>pBU<g?juW_0{5JMO3g!F=eGVPhhlF+whI1QM&B9(RQ=8N6yw;b
z94$ewY?Y1eF26~~J;}E^e`2p=x!Y(tj-xfM*j^=dYxzm9Ijk?`HeLD?A^RKNn@INO
zH(KsrKYK{;<&e&E%k#VQdFGi0$}OL3{Eo9u*|v7o@2dM7>RCek%yxISP2MOB>9EB4
z0)8{3hae~U+XXh*4^YpLXFY%&;+GJ+k|PN{&lc7N_6zn~_N-^=e8^Q8(&Gh>yUv5>
z!?srD%s%HMx52h^9$mM}CLe3Qc%KwPy5Bo*k{Ie7L7tk|y7Ln^c%SLLx47FR+*ew@
z+lYY>v`IV?urEQrEf^PLT;d4k+iS3Mtz1U-0`WlIA;{-`o|iTpOMJXQo;w%$oRc;T
zwsmpGx=dUbkx(WNZNc3iZ1|7jD%69Xc#fOq*9_^fMP&SuB;OR|rak6iB}eiJ{6mDG
zE;(xZ^y4mvY_#n@xF6UZe_r}STQ{_Q+bFMMCx&qW{e+gRY?rp9=-7$bg8JkH^os5F
z5%1hH>*G7Wpzh(SyY4DE@XrEe;@)Dm{1xg_hxj2P<&nh4JB)YSO5Wa!^*uVT_xJh3
zGWDSsqUhN1{}Ybtf$s}L_Xya6y9xAUNy155Q#~;+w#skBU++HZ%tDiH+$PetDrc#O
zUVXpOYyMlW_3c~gM^8eM`SRSo$)*_3_nVx#j$JYY`;7h8MBS(8>__Mcd(?ZD=Z)v=
z=y~Ot?MX<2%TIF259bGn=^}*BuBJ1r>)poR=KMX+w~DQA7ESQ|qKhaJo$nhXzjF{n
zJazq!<V+;*QQn#F(Jg-$OZjQT?NGld*V4C@$#)mN*YLed@Exr4EllkE{m;MkHI>cb
z-vLZ)yQTfNoT>-$z|!x1;{oh%-0{Sb`v}If8KcI`-C}6H*(>b7sXaNGV*mP?tvG1O
zQC*-s(np>p&OfB-n>=;N(Zx_++Mu7tZSK-$WIS~@-}m+1e?5R5LJ&6-+BMklFVXdT
z!W8EM8}#HT_8X2vQtulzmYnosh)7BKh#F@dI}iio;<ktU#<9epW8az!LmBW@Y`>-J
zS<akmB(^)A@(@d$3v7`LNy_I1d`}G7js2AA3;Txs#y&E;$tRi!?Y~{lS<YL|-j6Nc
zf$UHA<{<vBzw<3gI0f4*d&VNM9no^G-sUOP?<W|KS<>MYyiY9W4|}otw_<Oaeut|J
zm49OK+nosg#%H>8m|wsjg1UDbO*Wu^^tmS<JM%D-kYrxXl->%=KkLv%h|&J0Nmf{E
z!`k22hrE51dlHhc@@~NUzrr4anG)Z)sPWca@0%p2A<p`n?23UmzwM4g9z82yz4~V6
z+E-4;Qjcd1M$v7v9bY8Yk(E{IAL)Q?h!FLzgpLg#Q10BDxL@cV!F^=vH<_dRL+3Xm
zv2>p}vX8vSOy0M$anIQDo58(9baG^TS5ESBU*R3Sb${W$)by?nwcD=#xWDx4ruLh@
z*I4u=m|y0ed55PxwRLY8+=oQye$)#yf8T1lSBwH>gMEo$j<{zD=BsHgM$Sht4+(Q}
zlBRh9<_GpgXpWiZ!yQobwlr@i=WS_?CU;HloXnp<$5uIt3)WNhsQ<~6dC3hyezi@%
z=qGDP-x&wv=^_N<G?cMVaW1go`vx&^67-(f&K%Mg=8XO=^^-ls7`A8{4=}FK_&hgF
zbI>&(OB~VodsS=^+Dk*M0%h!m@)9TM?4`suOWXfMQg;aYL*M9Uh@pOay_TMhCKwY;
z(M5=%@d9OHKI^MBrapOUF7j-}P3lRXirb2#P1>G<en6;CK;K}!V1LLD)FqE;(!u2|
z9bCSp{kL>nQ{AKfeuEfr9m`#8_??6C_na%{1DL-iSOX+%5sD-J2y(zo>74kxARdNj
z33_E`*|KFE?e-)jE7+$vg7{H#kOxBTKS96Dl70mJ-h#DU;)tL2@YFK^`+>&!TKE=Y
zAGx}qZG(+GD+%2Jpcg3P9|`f!iKJ{B`LI#vh|N8uDPOWAjcrfTF~}!>$o>u5HADJM
zlkGQ9?=6n;nHpo;o1CimPw1)#k+_VU;{1Z2`bnODOIMC>g#4AI{qrY`+=oxH<z7VA
zJ<7f`UHXlmhoxs@h!8xlm8tR#e%qRK;CZib26Vxh!8y`WqQe%EF~pu1@KuPTJ-7c&
zZpAUCC-9A{-&47}pl`6UkJ#NVb%6TtEw^J^)}c%taJ{bnnJ3$l{~LE*=csK|8+~XA
zW2!Jt=mpy>t1lF1u+QX3R&2NI@&ofbL=#)@96*1A*i{JS0CLR&WfRh=L(b2;P4^S-
zDBM>fb?z@m^wI~~q7Jxkme}wwLH;S2)2BIS?pY(Rfn|+FAL3*#@}al1<Gb0if$dE?
z^}3*6^zW&U#JLWVGHq3yhg>)K;0WhJIuE`OwA~*1fzPb;6L&LY!%u7%^Mxb3Aua?G
z+sLs#^^e@N(FFT~wXa}<oe&4qS)#T>ez*0L+={KRA6%v`{igrqr!8oS%g80%hpE^j
zn(6~OwqBt86Gt)hVGH`z#VSy)*k@bFPu*|zYm8$p@sVq#qzw2+=0$f*%lF%sG*RA@
ztLWp>@l}q>72f5wjJ|%zf&Y#fX~TYgpxz(m!<}Ty2Ha;xVMzzy4Sjc<O>6#zlRnEk
zw#$DLvfbP<Kb4RA3dGF^YJJCAt{iJE57{6D^Yb)!)z%c_wP0N;U1f-beKkZAM|%<G
z1^Y3Qm3y_ZU-S7p`MmPnhVYqEC1*_&yoZoKLHrxkB@gelARm95^Zi0BzVV2WG|8=R
z9tJycNAQj$hjVr520MfpiX*;fesUdsOPTtn^7+Q2Z#rAwxenjI@^?XgOB<pkTfYa+
zq)XoL``c~1%k#?d`OS{s?FvJBB~*s3-}%gx{u7QxQvZ;L@#$L<^T+x8*)!~;+_T>A
z$dh~4`;|S(9!0`YJy<F2-}157mvFwVeC@BlL5F!^yCwdfkc*rl$d9Cagky-`f_6gR
z_`5iK>(Ac;HopZFM%wYujCVcC*olww8^gNvS|-l89_6Z2?#YroiGS0ue6rg{J!4yy
z_I1UD7#c$>+-2sdj=#<U_HTZC<aP}4{e_UdLhKRl8+y-}p*3V3XZzo5>Cgr1zH<GE
zAwIG`Ic9Psjcv$&5h{~oXMS=+h^hU?9`Cu&Kjr_`ycr%@vhvtgrf@yM6imSsOu-aP
znZ3@{p3xAQr>gsVFJgYIkdTBRNhL|0?8ctst}=EV!{d<q3Hkx!wgPQff_`1hUvLxy
zUQg~b?1Wk{*sLRavLv6d-|{J@+K%$P;TlKIWb-{w@XhZH#~^3YBpHXXdm*HQubp*h
z$<DRxtXHnH*BlwiZvWQ9lr&9x<){wcpnd?qCAz@|y%5rYJq||FBn^A+jeVB4e?IiN
zV``iDn=V`B_S3F@>mmC$9A`Pp*tSK<vC4U8U*{a!ywgUWhtQ{Ny+Hd0zt2UH=OWHV
z=tCSqpPg}>kvL0i&JX%tGj)FG;^+*q67<ctBEIM7om-h|!x2L{7T>&dCgI#Oc{l64
z;&Tk=7novmrqaBa57)@L)HPbN8Lt_B>qz`9*TvT~)He8uqu;dDwalbT0%s+p?fdfE
z*R%#h1nVS@7+km5B6R(oHAs#mG|p$NiwLdF&EgCvI%_6|)~##Zn$~HFqqX{+XY-8P
zQ*PZm>`ib!CHB)#{mJ8eoRP>0TXx1`4$O(UcES9)j&^|!A4JB|hifuNZNQGiPHxyK
zvE4Dufw?fRnde`wgX^{A+Cta6M5A_-Eg7oe@xr3M#ksJ(`nu}miAimx&w7<TeIA2$
z^;>rwV-CUGxsH?9<@<>Y!9Df;+&n*m^>IDawW;?%sFSRjE`2M{%5`JRO5|La6Py?D
zjU*(&dANp~C!cNZf9GfqYr(udcgCnW(6P0Pqdwri$X*EPz`A(dPS%>&6gx3Xke_jG
zu%C?SlEgbF{n4?*N_odL#k|3sD#VS<OCIP2x0h^3)Ol~s)r`E4OY#WU<!_{Gd8@{6
z@b&9iApaA@5x>P?4;P^`fua2bv2PIX{$07?h{5@Tb4Ziz3;5q+?7OA&BA*ztLn|<+
zpZL@GpYpx=XRcG1jG|*V_$r}xy*IR>#-LAe3iX<9ow(cP_U)@V(dQq~6$|kT>NURU
zBkM7!y$7gopw^*X_}N%`PM{Y;I{f!@t7mu=TG4ICHgiv4KUmr?4Ex8<eGW-`q@UO>
z=z9ct-oSt3*r9$~c<%LjZhh(6!1lPVm7I(-6Lf5hK`glMl73^~H%TA-NOPoDY`5&$
zCnSOEWlqekt_y9zSFzo)_PKS(JW0n+txHcr^2WX@9pl=d4qOlDZ>&-;&Vj^EANwt_
zK}%eJop+ngD4bKwl8$X=jaErN=RlIv*iL&1u5*eb?sXdv_X68a(3@~y`;e8L@o&<x
zE%Q}rpJnwiuE(x+$0DEXwz)rYCS5WLw5yFZW9?dkj*UJw&h07t5gzkRj$9+8A(p=6
z=t)R29yGzde!BNVK0_?f7o2NKKZ0>Q=FWNC($BA-XQXXN$2(8E=FYfv4z#<N$&q}*
zeq=B4)qZ4WJjV8%m|tb7{X~t4>zb+$ePvGKc8=#U@t+H9!~*&fNAO<b{kD_)UFi4Z
zZ{^av)Ewys+xP{<Io5iWBXeLoiO&Wz&l6j+@?__XG73xjeMam}YjrWz{)zJtbLWXG
zZ}rcs|GC<?|EXR3^c?Hx8Y{m3;MxmbJFi>QdV<%RwZG}IMdDf-d1j){rs#zzy6xCj
z)^d~F`HY?1Glr!17~VI)yXPmmVk$NM{2~v1Lk#^5Z#I9|m%OwOzk?*`*p_106YIPk
z+Z7YZ(C<2%-&6EE3%|8YevjdI8-AzaH!IQjU5nqk_;x1zUGV-kxXZUaf9Jcu|JAl*
zs>IKCI#?G&Z4=Vp*!i7sUf&3@*FNN0;t0m&y7+yLHDRAV)P-t`dZbRNTjb8Vr1m~B
zsu}iW`cNxK+SCzyBeg}1bwND!NzIa*`mXtp^4I5vG4T`U*e#uTEK%cm9=G`XhM&Lj
zPk!T1`2C;n0DKpy-wM#N!Oj?eD{vqB*=L=2`mVxLn>hDv%H#Q1VuO)m5bvBvI`EwX
z`0ineZm@x4-LJ}3@^<MVc8<x|l_xv%ouZ5Q0)FC-Xv%A7WA9@9^S_C-BP+zxCZ7As
z{q2JLJ_NNe#ZfI$kJJ_WAUZbu#4SNT`jdxzb)2U5l#jeU<FLU_JGoXFgK-#-amY_B
zIp;-xXk#PREcJzvkZZSp=QLB&#!k!<wJ$c??PH9Y97*uKsB*mA`<=Bxolq}t)H-q>
zBzfH?=BDOb^4}cUz_o2T%QJw@ZO1!LS6>s-jpxMtnqXa6r!GRUeqPTeeYgL8FS^<l
zYUXdCX5Q%3p@;(YR~gi{XbE*_rt};8ko2kTCw*oPeAaK-<@+t6*#88NbLUuk4tb}v
z2W;PZ@5}=4A~<?CeS>$`;Qb|<-e*VeHslo8@R4UH==dh*7S0wrPlV1BL+{lkrt~J;
z5coRZcQ||K3=)dxY%)00&_B;FNZRCtMw|Dn#%5fudrC6)kqu~LU&8BVS=SFgZKQSk
zX%Eo~Zj+z!L$Dt8+aKQrmq7X(;M5t47{fO~7@V<K7tvTJ&R$7qeU><av)Si-Cb`AX
zdaVQ<+f2|yHtev(5nJnfpAVbXaU|$RYa61m)|?}`AA-KKKpQ*xi0c`Po$;7MOPD{@
zYhkXQXDHr`oGW96a<9zKe3%#W^L#D0<{i2ROEm7i*uNlj4{wHSupT(Fb=ATX_$rQh
zve`FFF5;FLDcz4);`RgX@4obhAwsYQtVI(i*N1iDK6lnpYr4z5<9@Q{$dl`i-)sNr
zcdaqwFrHb`D@Sc(`^fl^g!^83&UN10+n(2ej*mFArB|@G<S5=?!&ljA!?(H6pK-g0
zl<00#gCn1xskNn6SJo_Rjg9pq&i$AApQLI08+^n-zX-L-bu(l$O}eqoa%W%ifb+X;
zKhm~aF7-QtdCy$Ko$Kg(ymWufk^Y2hyw*ATTYWo+<D2&HQCRHfBJ_^0*p3_*j_>L-
z3x{)pXgY`NB%1O*;4@M6RhxBWjj6iFc#}hO_(qc-Jnttt%k}-F)4#@awciN&o~Y~o
zq;oIY1vXe0Px)=@Ik$Pu`KWE`+IX$1bR2SCbhW>6G}lU<`;afhR$U`+@SEx*9;o&9
zfS(2ADs<^4r2ht<T^OQ?nR`QHuh9Ml=tHao-R+)x0sWna{ee8hH^Dx5v@fzZ_RM$p
zqc8LI{NLot>phZB*#AvF_4~=@`|wko{VV5LWiQtk(kouOrgdQbkiUW0C){@^&l`@R
z|4h1M`~deAM&4iUvFijK`%1`V9Z8!pU>0acLfj}c>A)CfO24tMO80d>eDrfY4&K)S
z2`f30#L=I5F;~{hYq_OY@STh!_6cIl$o{T@S{qfz?>0JY^`$?#7!%O3ZBhHUFLoft
zH0c%cFmLC4lK7#ExWI<*TzCxIX%Ddz+Vor3eP->kg?wEQa}soH5Q4Z-pfBwztuNW>
z1N4U}?s<8={}btJv}BBv<1r><n~)B)XL2NsZI-qpJ@--8wa(k)+ty26ebXIJe{#2!
zwCT4p4{dy&6MBs~it`?N%bD-GEopckT1V3MyAnzJPxwvW8uMFyX&y&#M&RtQ6Q3{K
zzNP)6ob8r$@Y#?v;~P`HKf!t8OHRiiXTkPrvyKlPY29t4b$oC*r{;C~dWYH&!s|41
zJ)5Lqomuamge165MmZ}{Z!>E%Br8j`2_tFLs-B^nna^OCWX~Alet!h-4gOvh{QX?P
zhVL81JmEfD{u{>Zf_D`2VQ!u)b6m2MbMp7RKp&Y0$s8BI>*#lvrQc+R2!5N<?=>*_
z?MA;xEq;^YH!9Kfn-#xfwJ+ZV`8N3UeQ@hLo0&zotxEdyP0lpF&#6yO_-@DdJ2Rw5
zvhy1taz0S~?n8fA$&m!cWDbYx=C>`@S#?599YM`ei$D!hd)V<qFNAd08?`nBHe!yT
zFFB5&?ziAs;F(zB2tPmd8A6|e-|Jxse#_@KeVBzKo!|X|ZvZ>t`vBhymN>%S8<4aC
zUl$?hYibUB#H<&N?1q@0grxH{<z}9SaqtmC{1Qj_`v>1Z_J#i+)omxX((?MqX}WX>
z;W^!sIYCQ2*Qt5;0_`V=iG=%QY{NejbnGMVZ!2;)#R=+zI-zEO`l(cVr^d1tsYCWV
z_6_zoBsEDbF2yzFsgQ@UAOy9_GY}bjWMh8Jm-(Lp?MheMgml)x*T{9<Oxe0%3_!=W
z1!E%3-6k(%Fy0jBqTWaA+~1omTZI}i)XWq1)6e-@){Wa$?i|DYYR;uGZt&ZNeiO3Y
zcnqY+ZqmIjtWg&smevkfLug{Rf7gB%*`(k2URf^Pw~Fn^YVX|N2SPS*JtIe<m3pN%
zXQ4}nxWG3568ipzxW;tbeck>Wxp-DDcz$nc48B&_dgiC-zvO7&FiX0@Mh^0kpK+Gp
zx{%lyhq#f@*Zpkwo`j6_(+`MmvNyepIoBMWS*Fe?A&{J9w(P+fNU_Yt(7y}D0d#E4
zYY66OXhTcsw&gClhH|lY9*xPkoXI$2alYcLR2gcUCH-@z()oh(73|cPbYD}`S!@(I
zpK(^}g6nUbO$wapu&<0E4rmjLKQy-^SgWPEa+YLGKkLTYB|Wc+vk!i*jad4$UqJpY
z24iVl#y@2q*qF=8`7kGA8~quJaR+l?PFnMo_mTBSw>;U#c7yLHs0-Hy^#S`LR2MhY
z#%=pen|?R+^Vl9A8*%Fgh%q4@m_K=%sMpW>bP-~xhNsq+H4d%y%=<>YaNhuZ=pJ!T
zh*^rIA9={l7_bwMU!{G-HF4CJ{{4lJeQONHftH|ef!}>s(QSK^p;#aXxr}oz`OX*c
zn<#mxPu8&~k!#AjHr7k9ZupOA*Vv5jIXJIvqr^Vx#9>EPutB@PwguyKfi&0+amF^s
z-Lm?7=3SB};huBvVgCWt&=9LgbiYSuzQ?yDXMwk~K|Lp+6A$ihi4Fe}oI9S*BvW=c
zNj(ES*+$d6UZ{O<-MOCR%sD*CE+0gJ>!}R2pJ=j!*T(BnV;$o-$4;$X7bou(_qmC?
z2C#=>VEmG$I5>hafbrhg@<E*|`bd_fsq2J}-ErS!QydUu{g$4G<t%gV(v7dHO7tZ{
z+|LX)W8ZvO@0K?Ekk;+1l6%E-+Xc^b6YN>+XMhe<95Kp%;XMEunS(rcF80B#_sG%v
zee0d#cYmnOKKU6_{p!4Kedcv+N!DQ$ye`#Nb^G1dZA-_xeM|cN4O9Kv4;)>0WtMde
z>9DlEPYl_iUD&=J`Z?#F*L{#JvCZwBbwE9we7|x3AO!aqNqY(6W<p<ZE^@C2u$v~G
zKIG`hQC@KSmiUGUF*To-bw};3q)P%e{LI@po>=>5`WHF#8koD+5*>zUVk^eb#=a8w
z>3N^0Bph+q%6O?AVomLXZHj(jTgc8_m=mBcfxXhN{<N!~KJ>pCB_Dlea*9NMn{&uV
zZt_4A_c~%<m!Esm3$zV(>s4;q$q&xS_){=P@I1K>zr}r!&Qs-7-Y!D;IvC$`ux{CM
zj?CBdM|V7V$Tz=m(ucgEUoX%m#@E4hTgUze{g&p++`8}_d-fsE7VND(S&|j(A!;1{
zBO34aWac~7?J9`{`Wf459QrKmqT7z`%}$K{$S7xsCB1UgeuHz{EbP>g^?c~_<de<5
zC%Kwx<qIu+mX2Mr|ED-tQ!aDce7#-Q3#=1sH<FO7_n>L5!S|GV+(iiLhB|{Ls8#Bc
z8iaU&nl(IAEo*p|=Z$*iy~6&_dxdvJeNTkm6`X5YIonMA{aoS9gCE9)?YDH?Ry;5c
zEW!B9qia6QjrsD-HKgpsIUjlGk7OQQEd7nY{hJZLHHn?SuQh&S<F_gQR;AyoCck5e
z;I}RP+jnTm*7q|r`Hq)#zN_i`8mwd#9Xl~VAM%m^Fowp2DIGhp^xb^36D>LV{s$|i
z+qPlv1=>#>*~uF@zs=m4ht_3j-KdeN8XKy;kIXuw_NYhffPT`prBlDIVcNu0uyw^O
z(el}!l3PT3#?R1_ACBn%XkMb}_x!<c`l9Ri{&{iu1|XWg8JHm*Hs2BSz3dyr0P&Tk
zwyAdX{R4M=Q#^BI?mdZ=*zvp1&fK1J*Zg5!V2i|k$kB2v^3F0A>-Pj}TX78YvyQ)s
zo%e+M0{y~v%j!S6r%MbGf_kVmfj%!<X*<^aiKWh{S8ADkjJiJj-pB98s`DcTzx~P1
z{<3mk3B|L2vaiyg`UdKloaAPXOK=Tb&rZ;vz+dfM?WO+l0@uShEkU=9XD1SLd_#H2
z&wb#2+$`BD)!*d1v7h_g6Y2%d3wLc1+h4eSv@7RoS06h58^?6{-U#_%<$Cx!xqjax
z?oH)rZOxKyhIA9sfqP`QFE{of@wMdWKAOor&9-&RE;~fBRFgn$Li>Va-sF17vsL&1
z*O;19PY&lEu~K5kzb~*kj@XfeWM%8QpQ0s4djb0g5*vQ{dmQot?NjVqZG#_Z`~INY
zZi%g8J9!zG^Umg+!`VuE7-tw@A7fv`$KEv*PhXGqBs~ssT`<NH^ku9meC@t|w}<Az
zemXVYXYb^U#XhPzF_*4$#0_VQ$r(pytRs4!y{07Ru%>=PM4r*uqi>FE?AM|3U`fXo
z*wuGsf5&m|JH%?9M{rIYya&V)UDq*L)0DJr!~Z#Ns$bLlVJZ*#oD&<@PVNdeVnZ-L
zBz>?QLBB0}&S`2+j1wAf<h+>E(0%OO1HnD1G_?)>%2fM}8b|+{b93L5P(2uG<2N||
zmUrK!e1P40mDr;|8`cB%A>#pGPrXj`CRhvBsSE1+bKkiadH;OBxS!lB?h`ffbYDEq
z+Z;Sz<XDV{4vaqww6PP@lC63`9|Ajm;wtV#46*c~jw)Sk;5t^;8g1h5yi@sa?(sYp
zV>ow}9;c2)>@Lu**vFiV$8q~f((k7{PyKB3xJcWO)o$JXA^**~*3xTuw4T%fjDl-}
zxVpZy@ohnUujELwpU-4V8lMSniT}xleU?1vjvYE*z)Fs!={mFg1ZNxANo$&SG9<xm
z$J~<sPjuODJU8Y$l91$jfNOiA$!@lE`aFTpOzGSQ?n`h#bdQ4PMYR)pu0DHv?)#CF
z{lt3;vJ2i1TkozeChst{@qPB7+;6BkYKr_v493c_m*h!WxsD+nw(zxdUDqlc>6Pm1
z@>N1@z-HZTY{ovuHO%81O@81yx>&kC)^qDx0iA1xB|<S3Z1`H@elz>izV$BK(V7Bl
zJ6K=AT5}H@YtDTv&<1?O5Kli?;t29Gmf5Le$8TuE6kB-imR!%esMl=0=bAmqDc{Xg
z+;44B*4=aSJS}av#9nE6kA9M@32W06ubbt{HMbmUSFpPs(#_U=GuRx1q>Zl$-)rB0
zw@=mpZG0g(yO|-qB{R==M-m$`#MAc_XxqlvGv|PA9Pe1iW3MsT`xin!Am#}A&Kw6D
z^IV*Fa&HRuBkfBqLC1DPQ(WY=Ip<OiIGKAZH|x5RBk6luCHHzKt_|0X+f~}P9_ou+
zj59=}q)mQu&=+~*@#zn}K>w8t$snJu4Ol-w$Bus`){ojXA39^~3vBp^hgI?n=_aHb
z#x=|XT2gh}Eb(nY9_L*--jQS;%x8<bR;(XX8@lb5>#`9;E^_vSaTs%mNSKqshOdGR
z{}fG7Yqj2pB|qcrgt1{1XcI>~`JAgOUx+0bW0ibII&CwGjt}m!nTLJop2yPoz`p7|
zc)sk}#L;hOf7-+z;rFK{Hbcx4_TQ2m<HC8Le8ld=?|w_436{<WaDGA4x$b6`GvJn9
ziKg{SI8TDxRk}~LRsG42t;USZU*(eRTwtq=>=%+1kBOW~lQdqhndhru9rNCBFShP2
zOwq+rO;8sj2}z)4K6RIMxTw)2Bn{61jHF3E!L!CQvh=PPyw~&&=z{mg5L@pK&ak{A
zmf(E>TknnvwjtKVQM<ys2*_!wEi~p4yt{aAr(lloX=`rGi#Vipaxgycw9oHG{Qjih
zq4;fTib$4zvugQW?&!PR;G3P`d)X6w*E5Z8d=Kz#&#a<jBYq3UVZ5o|%{ITCiIwBh
zC&YO8E_n1^uQK`0mvqTD9D}SejKR1~>%^K;gS|-?NNSoI9$CB8D>2k2bxD1q57|C_
za~~ky{iyYx(7$Cq$1nzCt>j3W_K)JlENtlz`c0qT_g8Wx!QTd^z60!pZx?(YTf*PX
zko7xSwO5@!|36?prb!3p%e=d&*F_uqP8?gMb;l6@M3)`BULI#??Lv5c|5Q%hlXij4
zd8+^D9<QWJx>l$SL){o`#Dro^ZKDrCeNl%;dt=j{$bQFO#vZn{C$Jw4)%xVOWPVfD
zp3o)PyFU95`<<SH&HhM#<)O~oRo^YgyT|2O@G}uv>s%k};<fNP9NF<X2iMB{4Q+$1
z3$Bg1z!2ED?t6@_@q8~m-pcVTqm0e<0J*HYy=AM=56E)_`5BA)S>il^{fQy_6L;*%
zoYZZtY1gtPac_OAeJCypte4k`Yg%9E@|loc@j8ub9ep2L+TZ++o4T*i3n3k-0q#9D
za6|psM$Atv#oV}0$Oq)CP~X3yF_(h-?9Au(pUU=-(>d^=?*eV?><NqKS#WNGA$ZPj
zu<t@-Kl-19oaC--wQpEM)^sK45J`=<tx94m#4`ux#2k@J%p9A(>%#r<8S>DlWxk&I
zPM#k*A0EzKVrpM(0trWFtuC7O)UG|1^TXCY%D&2Z3WngE#d)jccR=>qB@S`)5uDSG
z;LOGzj09}>R{EO8TY1LAAF`99<|39HjwRl7t|8BnoOQUqnXumjHqMp7bt(_}hCm*{
zxY&1&F<1kE4c}7?<FjU4V>2#ia@KfeeKoB+46#J$ewZ%3Vmp#p`uqv>sW@L9<0svH
zEZ^d%=J=<)<@$~N=-S@!H4nvv;JIl$JGu{xTA(g;kD!a8Hg;-am3u{BAP=kuu!rFO
za-Vxb9>&C8!A2Yq(?wih!w2XghUR9d+evK+=Fat0HuaZaU!p7a<TaA-2+wb8PL-)P
zK4O;Wg0*3M#;%ZaiV%!b$09z|w?Zznq@Ndvi2`l&WXERzlU(w{N$Gaaev#7lDv7}l
z=uaHkSvP8dny6qiUT0z*zvQRpd4Bdq(;g1vVySI>PH-FP^TRjU^Sm)7;Rv5us^t7q
z*;m^>>`>20Kk4p+92ZS(<~4LZtPg9-nytJS)FHLk6Z9jfJMIy&M}1gRa(I10Ijtk{
zH9_1Ij72}j+c_RNKeesrD)Jq`{vU$(67RYw@cRSrLjK<8Z|=yy_lG3yBlsPF_vTg{
zf16D8AH3s~llKVYZLX0yXfDi&xp{ubDVRIgz;$)On*A2yE0Jxa_3B5*zBHa;Y}2Ga
zfgd~b<ys=wmTQBSa!cYHf;dClgmmH@OS^)-37$!61*nG*tS9%f32KF!=}8nF`w_$u
zzXdstAou(Ne#dO-%x#F35*-_$FL4s?X@&Lr4enE8pKSKq=W&tD14bc=e*1{S|EI7f
zm08xZ<=R=Y-cPI-JF(S=Zo2d+a8KW8@=*iS1kd3REkUnfpV}9or{w*Mowy~)^OVbR
zjwQbK>FQURrR{v=2l|n3io^aP>R#2gudu(c&#>RHN3r)D&hDaVKVo01`xAEdD6^!~
zhdiJBnh$Hpy0X471@~_xTN2*t#C}WSx>yfjhq$mExiSVl1bIi&ByW!93(P%|rE403
zI@r2KBrHJ;u{GZ9DLb6RW7YBT5z{Xs+elz6W80e~Zd_m^zKbK6%T8Dq!#cq#JlXKu
zjtt>^$dR-n8JF=x_*yKnRfvO`(muyGT@Ux7f{nN%JU)^+0QUKiZ>XR1p_79+;-QNW
zOFn~bCg{dC#$)WA(mLzJdL7Zqe!f#jnkl^rVjXW^m7#a3;obU#{g(8%jvN>ERr^v*
z<){rl6HJ{2%$ClX&D8UpZI;!CzW$Q8JU(~!rnw5YpT@a!&?b&P?mwkJVLvjGI!4Xi
zl+&<QtXmhXCu=-JB;2c6YGGv!g(Og8uCpc`PN~h1PTf-5&;-xTOuA&nb|m&w-X~4(
z6TeG7zlG?xkEwSF?~|qX0Plh(w%#i@*zqqBim%WgrZ@%K*a5w1JjP`X%!T(G>;&7%
z_Z=}^5Kmvm?wqUhJbv{4;vLqL;C;q9`~lvFQ}4szoyd2*0^jz&vGq+4W`Q<+$g>1_
z4Q+hHcM)RgdmZ2GOiLYE+2y<7{H0DGaL%EejLmwm-k+MHUjNbf;xzdL^-K-BexGWW
z8m5+)pvLJ#-zmt0>>|XH574n6!FapCZ}+v0zsA(x_R+go;v_A<BW%gY?{G`f9O*ZF
zEBwYC@AfKrM~?Ly8H&AOzA%#}$u)6pm9F-02*ttD`hnN+ZrlDOoBA31X>Z-P%2eB6
zcb^(-f0zGI1A=;K1=_F$ei+G;tY9aOcxsP2Y`pW>FLOWKxwm!px7;^^{UY}o<f8uZ
zDdw|>YHyv&aT0Q}KQqQD<8=8U#OF+)vDl-Q^3Y~JM{{HimKXwkwtwxB^RL&6-UQ<?
zp26lg<jff2(8<ME<c6MO4B7Az(?nPN$oCAA>k8SB#&+7oGsae5axn(E8Dl406L5X2
zK>G&2>+(tVtG0=`ZM0|Fkxvj~LVBGSy64rTn_aGHN;h4);refuY%r3L1lG*VqGO}|
zM3Ws@b682|9_W5>Z`uVm*di1M#9OZt`x`ZmT+Z918=i^zfS-evXA_=3o&hB97VN~(
zzviNC=0jfls&rged<b#_I<_fJfi{F7ZiptBn_;d7A2F~J`a-{$Y9GNh?Q8v?)_H0D
zjs5X(uk3T|$$r=)VZ2fB_{2O>`!)6BTDU&epo`F%kv%X3=PUNfp}i5%r}*!)mu#Iq
zRA;TwS*!6I0lzIIjo%tX@Y{pvI+txR)F<dG8u`UeNqfp}h(SLYi@wyqCC-KYra#0w
z{xc4HG}o)^h9Q>r@1^}4KmCn!(~h(s$&vH6+-gJc4iH0QkaKGs@^{u+4AwmfYKD7J
zm_@I4^tf;yOLBwT$h*&-^Qm3?)Eth*k6z>Kdy`Y~Pu%hG%e*ztIjXI$0s0V4a38oI
zpZl--({z7A?Sn1v5pfmz-ry&meDozJdAQ$5+DG88U|Z=AN#ZM0ZPTQiqq%nKNp;nz
zU)9*B)=C{N>0NewH%B)5(La=j+9dZDL-Sx>b)MF-<0sB@aleq=*zb8VSHoC0N48nU
zU&?ia$3@Ny`-p>avC@vuvA1+i?8MP$T!h+O&lC87KI?%aTZM5Lb0@W~s%@#BsNX40
z(zKVu_yt=r@D^)-=zMY0WrLL*NoYF9+)UYi!{!W>MAMi*;8=1qHgoAoNOE1Q3+u#s
zvi8&ub=5^A=&-~Q+`~>h{c>HAQRvdKAt40uFbYljCs&TmI6POp19(pyy_=TcT{HE*
z<K4%*kl!HY!|&})c6_1t=DgmYqr5-K^~tSqcz(I2&l+ex%+>Rr(xGK7uzsxLPY`E9
zy0Ps|I*!`n{usu;IhvR8JVQ3tmv!ZO3~P+O1wLX{LZ6E5RT58Ma&*D-NWF|CB;o1#
z{;VzQD_Tl)?DRi^yrD6kVC>4udEfHL4z`c%M;p88y5654_FK$U4)_-1@sR6<Av=U%
zeQ#Ko_5!}@XC2o?SNj_^p19hs`jPKx9@u}vdHOXM?mzXwo-##<rDu_Ms^7I;djYtO
zw9R(n=|}$xHo(6#2NJMVhT0Wkj`oHS>=Rvl&fDx8c?SQS!#Rs5krMk6AE`ZvJ!$B-
zN`9aG{6?9-T^`x^?UcQWy@@`I!<dZUbv;At6S;1zGxvadz6CYo`f&|m1N_9A`O?Sz
zm-_q`_lYtV`GN76X9b(FeU(~>qGLC`*sa@#JTEw=%O4L=cX0dO>`!snx>(`}u6+xy
z%};CTIIrQ8Bp-R9T`(qN_ZLF;rfZ~zcqWijU>gb7OB^^4I(A~3K*z`UbuKIW5O0XX
zegv_*K!5BNVncX5ByH@bXAE}0PHxuAYgpxxojrLc^_^+kEPmT++$ir_^h%BUtzP>t
z<-74aAIZ63CP%W;bdDP@=RcqIo}|x-)o0r+d(#}mZKqBDC%bJm|E-UlyCwdvoa+nt
zO-MI2xAQgS1J;Z6>w<M=?L+uJbMKp=P8PKyLQt#Yp++b5CVCQ*OLaO#6FZ+Pp0A^K
z$hzJmey4=&?CCS#D=XhETW4I(xviXaL+^m0_e{Is{a_pKBI0;oeBK$7*zni5p*G;V
zq2CgWJ;WAW^I~pI^JKov+hD^_e5l{le0Xnh&gRTLICnq5JC3tDG{Jk%Ea}iih^=?y
z$oJ&Y_q2-NpU7&rZh!4Rm7^!Y_qoE-H#^|l-A$9tRG)2cvc@juU_9paSr^ut+EG2u
zCi&059O+#Iwyfh_>i8&rT~Ob|5WfU{$uY$d{08s*Rc_gV-|#EgYFyQud<Of@{!2NI
z;JX^%*tXys9N+6!;Yc_2o8XgemhXo4BUdsce@iG9m{*0lLi;6LBiGuKko*Sg!#cI(
zw14l(o1F4P|ACO7dtLAMk<HBP@3^MeyN;-vDe#SgV~ID|Zt&3`x^Qh$(;?Vr*<aaL
z*;Bo*vbQ$D{>eFHX<uQ_WN-b%D_0$h{NyI*%$)4k75d@Zg7KLT{dVGfqg)62O3;a=
z-%@{akc+$?2Yn_d$43%(nA_Dqu*ugI!!>h#U2xsJHvk>`XFW1!9f#cHVLs+aXRge>
zH}x0im$(jVO`@AEz4BDsu6^Vx(2m6Un)1QP`Q2^Xr~Jk?OWV6*pteuBe<2-M8{mFG
z`vt7&5?w@r_Mfm6|HP5qRDaL>A<4al@j{cGdYgips)X9GRA)fFK@-$h7f1Dm+=3YT
zPjLjf!DDaf728{x1LNKF%sGq128`)BF^3!Gia#>m{ifO{VSM8`v36cZ<jOYkPdFKm
z1lNt*_ILS0>}$QS0e)BsdI;vrHBGKv`(5XJm}e{WBU<i<oVRA43s;`SICEh~VmqAU
zI0p*OU!nFA*r(1HTMWgyKlzSuUVKjwPYmM>L7x!Vk@n#S+R#Oa&$!G%b7FqX<r9~C
zJok8s&;6z*b=~wQKOE^E_cIsuC&x%%l(k|VLpcU}shDbGThd+Uk@Z9!!6{HnuA?_e
zjH!LU>5hMrBgd@1JJ-y)BCC%+w5zOntdEE5vaja5^_k<|cKY77r?&eedm*HA-?`_X
z`!0zM95+)(T91rbil;yKl;?;0>wC_9ui)#szc7~jV8b^aaDQs237*B3P@mM?&U&Xl
zyNHyoSNy~gf3svG?-Y#T@t6<S6M21Hqp!2&e2Jxx`wg|}cM^2yA_Q?WX_9ar#wVVB
zz*x*<m$@v>1y15Na)|f>e&UYkd0)}7g<u@xHqzjm54g|BT;!%!D%g(vuu{5RrTcEh
z^Sms<KFxmpjVb@1a1?*zcZ=oF8D%Fv$K0}W-pljO`a^jX{}bfwf_X3>=G+DA!t>91
zv7SRj;`>1x-w{)B#Mku<<uT+m*ob?A9ON3x*{DnERJ9zcW!?`vpFiFaymNT>@y=QL
z9b)snPrpBOvGhB`5L>?~@S6iVe}hla6h~}VANrl7DbL9F7kPs*G#=wqm#hWzW8Pc?
z*E7Wt^<Mg(V*4AK`aQuoz?l6a)UJ4Khvo`fb7x(-SFCL$=&-~|xK3i}15N#nZI&}*
zkzJ63Tp?U1Rbn?oIxKNgqPvZaoIrlFrB^&RuJZ}|k+*-z_Kg~U$Jy7EgZUtheNWOc
zmi1cDr|1c5P+@I`2vOIS`ZP^C96dWX_7S_kfS*|RU&_@BwDA!G#P5W;F~<tFpKyP2
zH9>yH=}AbAe6LOI2Y$a{+XC4V{JlUMA93WVIkAoGN6x!%$hLCtIc4ABoXehJ*gIg0
zuKlBFe`1f~3=6A38$a=jy(ssrqkRf}iy`~Rr~PS)PptBOaxov~oNLZnFL8uxhdR1z
zi5Oyy<B8i3ILDvJraXrHi#drX(8hjJqGJo;I;ax6eIx6GYp-Ch?5k~G%YH|70B&18
z+3Xu7r)^J?xGk7-7e}xrZ|jJUn3eI7vP)tIuc@W&D`P{FF&Vo(fF1u0c4)$DVu=m#
zlfMhbI|(|roiUELta*qD#nR^puLakGt&2#ACC4n!D!GPi_$u_HKY8{Gk$eBj{r*Va
z*f%o9ZQ`sWX@lRvZof&#A?E{IHuLn}zt0d$=K~0x+YD#8nH)*en%3n7$K3K;eD&S^
z{-iz2e4li3)v<=Ip;CPwx8~{U50S85tRw5pJ?Mh_wL}Q&W(sPETA~iAG3u=)u4N>3
z3B3@~VQF6mzf*R3ryT9uhIdNjdu8gJdGh@blArem?}vnU1;6p|UV-=pj$3-iv<u!P
zpZ5vxp8|R5cLZ}-nhSFqnrF{<DA&ey&%9o)kL&1)r5|}YTl4<nJ=O&8HAB0CeQ`cd
z24{A0^xdrU?M!TaM;qekn;Ogu+w5-{Papak+NKrVHYD~N=V#nrpj~<L9mQ10{kbNt
zk#|4$n;OYAWo@asqZ%B!&rr8b^$X~3Q`4?%+i6q#NBBA6+1Vog`5(G;SmKDL-|=Cl
zM8}T5C+Khz_i;b^ZV~#nHpD6%>0RIBVE%%wn5OT6rnb>xexb`(VSH2PHDos-{Ryt=
z8(ep#sm&VAq)S4G)&6BjnkF6GwzPfgURI{sPY~liNcZWoFV#hesrmue3pQ%zX36%%
zksZisy~_2{5Bm^Npk1*K+Y*eyHE=C6uYtMOeVe_TeVgZH7H9*$kuga2`!0@XxfXRj
z(6KYd&VF5aB0-<xB;*HdE8iJN+P9DAn&;c^hm&Xcu2|xc&Vf$<I#=e*yh4l|7fHJd
z=FJ*<?N~El4WZTs`bd^!{PQne@@C2gC%N0V9e+<k5|+jo7wu{jW8Cja5;Kw}>FeWK
zyEs|{!&+2^+ELhAvp1%E&<ZEl**3>iX<wDqzca6GHO@NYED=eU1Z)-CL-ws&pdOBD
z2U^w$(l*N}e^1b{({~GUk#}8S!)J&E`n8nkuuB^q=x2SX-2~$@k4Vs`z(>qZ+!vd{
zhrNp>PQn^`ZIND6^qu^+1{_}{d7uf8$@tJk2+s{2+bYoJ8n|ZO{hR?fH*p?lIy-SD
z3)#BPRh%Q)GYor%nX>N$eaS~Ypx+{g&TpLI8o82_w%}~1m?k*yA?f4zP@Yxj(y<xZ
zOB{i|IR`RU<|7wlMf!=I%!@f|FI>8QXyV959^&a2lIYBPrj5Mdyo^b{!L^IdzAMOG
zAwP^{Nru*ciX)othZ)?PWJ})IXW2^MH{G$8Z*k1!Z+Of1W@jGN_tTg)w(4HHyZ_9!
z?UE1|*ybNXpOg2Gd&zyKX1MpCno=!LU(`@jO<>y(wLw2<*`K;0M<n#2KY6GxYML6P
z7O6wirAL7_z9WX>=@;r>A>R^5Fa~2WZWl{1uPs8?hopVdPwWu%GqhnR&P6_hjhH4F
z*JESD2aZK9agvsEU>?kec@43|5!@5sOY7Jxwok=wLH!_UcTr<&&ZRsdJTAJyX0Q!$
z1o_BowsdeC*#)tNw!y!JYkX*~D+%rO{Q>OYI7{2@BNyPeudCk_C*f>jwsaFZ(-_V-
zm8JI0;S5ylJ^K)M`>=hZXWx+Ye3)Ys%sm9x)e>JH*F=n=kFm|t*I(sS|1QY)xi7ls
z)GW`|;r+n7Ab%HG`MbsD9jf=|)_e5mcZM$bZNWs^u%jE=QykIMcL;KXa((hC@6=eI
zXPjqP&qrjvaox<3xxx{?E?@61*KXV2$d>EL7?qi0_e+M_73K*;w1l<oV(EH@;JOU$
zCGdal!S!s^JX=0+9J<G_w7<(|X7+PTmBd$wH9d2<z14Q#k=Iz|lFeYZUS(aYZ+g#l
zCI<Z}mb{Du?FIXhD`Tq-y(L^9aJ@Y_d4IS^+$-?Dh@7Gc@8{Gl^pxl)A<o!_AG!#!
zdHzHbyho<!33}zIO)UM6Aomu`k@=b<9o$BaFNA#Ld4e%knJe?{YGY##hIR=273O=>
zWUFw!-h<c^g5OKEPjt@h+A{zh8$M##ueQzwOM4gnStn!&Y)x=>V1MCk%ihLssZIM1
zdl7pRkQ-aiyq`G5(w8}rllgaD8*9ND^<3K{*;F@x4omb4Z1{+q7hCO{P<_H}ci*Ny
z6>>917a^D<60j|C3be5kXCiIb(XkKFgzxd2B!<`uHmH4Ut8ur!OCHCQV-~t}gZ&6%
z$whyzVI}Ag1!4^LC5~WCy~ek^*PD1l|1RPMe1;gt9-@glcWn3o-Oz{rD<%FWYF})Q
zN3VUDJN2{@bgmEk$-KnVza{9{R)JXh(AWL(6L<IB*`Ged4vl#(*ynHCw>I&HIP1>i
z_Eg->maXFV{w?bnV(DyPII9_--z=wma1wq$gS&0}pGb22N&Hi+=P}D1ZL9LBZ?zFi
z4(NrD&N_MRSZCJ1i>3P%;;CM!-!4L|d{6kju(j_R+t`PVZAiyW_34G9{hN0I`#A54
zCU|ea5?yS)OGeTpf%n7|yb~hf_oI>UzA#(wBybyP+m!tcVuoVLe+2XR%!~Qzns^R-
zK5tFW56>Cv#kKNoBA)q?qbnEhu@F1oYrNag0lR%CzX|d^a9-a6{jIKkTSK3JNbS?r
zw?Z!be6wRbL;Hp}pwAmyK0|+W=i!^+=Q_0ppZmj_<$eF$YptEvZD@@Q>&d!uU$`gK
z*k}D!$JBPqTBqizeV&CWPJ!oU2!3ntVu_RREerU*wF|VNC5}g8!?y+B)A+u&#Q6j2
zx4Wv({N}eMZ|p<%2Ywo#Il}mXr?^lb;F`^l4lVH-O|4NEAy)f$?Z+jtSMWEn^Zs!k
zkM1dOZ>?iDGh??T(C&iRA=vkt;QfT8y_1k1h^yF!ys2^M>*A<=L(CA7pku2XwSl>F
z4O`T;z!${mI=WyFhoQZQcly%)v~&Mv51)cP3;SfR62xvn|0Pa=HuezC8T3(q@>H;`
z0&T`-%#-hgkc1_$<9AG#UZD@|DagfqnFI4VVhQHWH83tQ!2G%(9*&?N@!aQ8*3|3D
z+IoFiW5Zfge@jraPjuNUPcif#7fo&B@otIVHpkx5{+ZW+><RS&OK{zlP#dsW_cP$<
z0co1_C%6}X!kxqUtGr`so3Xf;m43DHVKX5es26Gh&@0te<B4(mmhNBs+Sb&M+PmwJ
z*oxyV?Q4pII|nw$Z0T^%tG`^kWAQI>UhsO`Ppr9ZJ$*=sgt3}n{(wFN_6qT}FYCqr
zFgQQu*(o>!h@rCqXT&c5&V7Mrp6CCFuD(0RS{et2XpEUYWa#_`OSyotpcQN*u8Wyi
zZ#v_J=D|M29%X1_AMz6e=v%CeWzNiZ=3JQ*I<^o^`G{vs<}`J_0d&s`-EHQ?7@x7#
zzbh9xotNC$0DWKB#yYWHOZYze-b~%6lhpdaUg_n2qT{nfe*!<m1@i#rRI&Yzcf007
z|5KdD<5X!Mvf9zBuj=?l(j>v{CEfhC5B-7r)`jba8l=XkomQaTWyklaEyYo1l}*hh
z<ROlFq7QvTIPX!tQFBqC4Kq2Cbq=(vkG5lm=0|SEFpRmx5zOTY=4tQ~OTS3ampBF5
z*dYYt*0J%!5#-)tXsvEmK4*S*w(djdp1>$9>2DnQDvlen#|w-Dj0;U1&4u|O0s9ut
zK|WX)*dihR1|Km?9MM(tQ|yBGf?E<pY%kER;3KbdZ?%Wc8B6#~a?7ss$`nm!oXSwU
zveka0##txU`cJZ5W7qc4+<-Y&y4scML$5yTA$x_jVf_Ycru$6I^X!~_M|8a(2Y(Oi
zUD?Iw_Y3`<+>)cepMmyBh^g?dHRL$tQO>2@!8m$ud2WWrrsk*_?jQ4_2ACtPLcIp-
z)sJrbZ)MLlbNroe<UE=rb@dJA4qb39tZyV--z?C^4@(?DKOo1AeSa&-4~zx1J=Bhb
zc>!(gD>;(pp2Iy?+B;$0{$JsomW*S%bYPCwtHiz@7_vbKu6v4>@N7_<rb~|kd-@yH
zH8jCH;7v~Xy5Lz@dIlTs5j`8gGtw`x;UkWC`jLbDb&Rbx^F6}X!?iuJW&aKC+sgWo
ze+kB_gxbtu<h+<8^owBbx(=?BvnhKId&SDVX68P_9ul0}Im0TJen*hsW3(KrN@Awy
zA`;eZ2-cBtm-Zv}K6Hcavrpxj866+}$hS1s)HRN>cIbvRvc9ELU#3fkl^jXavWDHh
z<;p%?5+Y%YH;8e3?Zf;|xo=!g%XuU5Ve5kHy&1XQTkFwM#|G=d_9pusA2|kN-7q$O
z=OYg}Y98mqw*>L@yP2}V5x!2Z&C(j(uvTw4*8a%*U}-xN+s^wlBpKT<moAuhoxA6W
z#BXTR*LjZG;C#qxBM!D;9!pST=A^Al;s;`zxbrxNWAK00p65o-CeQ5B@9$IJ9lE|b
zY<`nZ4!_q+-}v+_cRf$^9gL$fr{=UD2;S+*kTkZrkK0ueOB;E!WP|eyd`3XdWJ^Ll
zvpwlUXS`LQZK@qT+A}qdm~XLfIoz-28f7lltN%%NTvK1K0c+9)>p2AXq=}{b+OwWM
z_gVEaMF?u0`#;6W{Wx+@-m0gnPqkZeR5#YEB<5zz2H5FG%>{L*J$;BKj_P&_>NhSH
zzZ;1rwrX}#x8kVI;ZyIIKGY7e_1^jk;)p+j+>FJ1m@8|-I`JIxym=jY=7!d8$j|jK
zcjm{umhzC3aa(fu9#+~spCg~ok<aGVvpJJ4X^y_HtuKr(zMuNJFJm$GPSCNzQU0Is
zIF55)<P=+k_M*^rvo5Uj7D(3JYmcqtQw(cF{FHvQwo7ZhxDTprYTb1o`TX#l9MRkV
zK-<_p<!}FJ{lyZY?^<2VUvL!jL@VFgHs8<wlHhxw`XZmc{Z$(=#(mtb(sLPQj!imX
z+ZWhOlg{;eZMt-bg!N+`Z<=goH;wVal)Ve?(Go+1@V!OSz9G&m=|G!!-X&d7CxCuL
zlW&%~A-00A31YuN%oFs#*|I@sZh%fqE6~P{pKE}XpohRu+|u0G*QfR(_9OQ5eeL7y
z<)3%D_NShE7talQ*P)O4hw^~m5#+;99Qls=hG@zK?1M=1^3IrwF^qwY_|JZ+*pYjF
zmp-!(ar8kR#nK14>928_1M@>dPw<VLm-`O&1Lq(QK625I>td}~GuDrFT*;AqgIYAy
zrrFY;upilzx7;3ol)2dU8%aNi2dEF%2-n;SN9$lFYf|XaArfk%CFm8~H|v|&=D5YW
z3-USlEj`w4r)}RYo%czOGS4O*Jin=Vg4;;^wa+ST_w9;1syS-!#`Ym!Twq(`2y)DX
zae@3E!@erJV(9A}=(UZ1XC9=P(!W8R#~zx)5_OGfzd<~ZgSmv@IYW+Y+eZ6{{)_pL
jZwg}RL*Ecnxp|(UNv91vA%@sPtooA2(C(RUW!!%O7;eE{

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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] =?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/2374] =?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/2374] =?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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374]  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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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
zcmd^_XIPVYm&PMHDmsFS1*GYKAYHmrtze`ny$7X+D$=`U6j6#qdR2NyA@mXy1!+=3
z5duL(A`m*E1qgexv-|GM`|j?w`)$h?@#5ln@-L^{zxyQQmZs{V1E&rk5Qsy_8`rcE
z2nIt0Vwdp#z3>}u#f}&R;_N5nwadERNwXsXw{#62(H8d^Uw&JX^Mdy}1Lkx>v|*bw
z?_nv2YchuHDAxmg=vJeGIIGj|!gPC|9gz>WZ1@mm9W5Zla@U4MRpU2dO@{c-OaiQ-
z^VW9@^&G;U@J-59);k^@w<m9GM{+Bc*M4q0gY8(;>C>Z3B>Bz1>8x6NvpHOUxrvo$
z{ZIv=@cZ}gG~%Hf2M!!qqP3r2WDaHCdB47(3_p$zkIKWE58LgB4IpBUyoG;-c`SAz
z5QZuZ3<$*A&<DRD5Eg8^4k8c@5)3C0hzHhtgyE0c{trJ8@SCix!7DzE>G_e#lYhV4
zt_W^h5!1?BF1YRT@8jdrR-X@R#GSwFw>H<;ovs?4l2Wv=aPL!7lYL*FUjKA?c6GIJ
zOH0cEW@ZCZ)1=nc)>@o{o!!gEv9A6?le)Gd)2g&Ec3Jzm;VMjq+s`lP#qXa^$vP)}
zXl#_W?>$#&`0h#*tHZ3wxpTL!Uw?A+=+R@RPUS6*H|OW&<rz2~JhwN{8a`*c?%?_k
zuMhVE{br9m8*iL)PpFx%CuC%0B|LwAV7Y}qHSXibYb>0cPOxMRBcu4-{Cvr_7!gT~
zI=nWzx?-r#uY!?@Nv2a_IW)JhP?|hYEPLk6nJg@}*Tkkf?K+=?L=P5=Wwi`7DzOS-
zWM-DN?M#twV#W9L+~w0uvXgNkI!;edx91nv+w;aRE!}sR4GRyK$<56rrAH`9NJ~rG
zklN$<E?oH9J20>rm3YDRZpF}vb9<{s=4h>+lZfJwoiXV}?(J>knc*s(lVaw*TN}%p
z9?DzDARJ%0|4N^MJsN%6*|{j3<Kl0~Q_6w0<xYew0iCQ#f(uU1%q;oouWV^YcvNyS
zGCrCV$$Ge~tP)(vM8EmIfVGiqD%BU+qf8rDZk_ccZ_eWkZrytMl!;T&GPDPekB*7S
zsv!ER!RhxUy3|jZbt>;HE0f#fCFR^mp&U%XX=!O#*Kw6(Igi$xemk4E9TP3Zm8g2^
zv=CBTTN|Uav*o6^IaAu&(y|y+<Gq+x5#gTcv@0FQ!sWlnUA=P)K?`;!$d3A3LK+5^
z%x*NUSFR{8Jrq3L9E_imvTO=nH1eG6I>XcAzdC5E)P~37J351CZbBX|tBuUcaj##W
zF16`6<u*GcJ#V?WI;(=&SWexU5!uXE-fr2mZ(pL{eBHp-jIA>Hp8s&AYolq6XNP*C
zOh<cybepjsxBtR>8G`X!i-#d$VJiXya^}_e@=FaI!U#ouJ-rFZ?A?|4>nbW#1(yI-
z>#uL`IK_+(t@-Ix^ldEvv<|&}`*!4BX0Dk4Y(0<r*oR+S2C-PFv;6$|RaHi!v2C`B
z&EcFn`uZ_&L_h9bkn&!z=<Dq@beb=;=0$&ecBI;UO1qeFV*h@_2E+h9q^P)d>AAW8
z;`L+&AMMMRFGD@*p)Y>S(^mrR)gC9V^vY9to1()vo2Iow;t^!$b~(hYWZDxkPF@&m
zbmAIs3R{jDsrJZc;!?;7<_<J`^5jXi>-baNsildw1PSZs2?+_<JB@p#rKBd|0bfeD
zYT=xlnwnaoHNRGhqpY__h0{ZeTS4=P2eb;yW~SLu9Ln0-`oN(>eQjd6f`S5Jc%gu@
zGV0T(PkFhyk%U=&xL=#jl)|9xfuO#4Nn1*=^45FyD_q{+9(oR-Oic2p@YxQutqr0N
z2V@f-GMTc}Cg#wSfi$kX_r_E-HpTlpBOGsDWu@UsQPYKZou1+0g0!^X!Z_vi%gV}(
z>wL=~Bco$u2lC6Yc?AW%Z>|RGYHO##4|{x;MuMbmIK<a76Ha*1(`k1#kFc;hR1-PR
znK%pvBPZ-dYG<ok|Ng=lk}@TT=5v;hZ@Q>v4#Uf-=&K7E+6P%eSs#y3!zge?Xr?L^
z=H#4n*!2DWkr6UdKvYx{;|^gZEh8g%_G~89lVecr<h<sRm^kG!CMWHXJ$?BG(tfLs
zRU^(K=Cy_xDW4^)fc3H9y!?Fp%wVas=ZxWqTc_dyM#k>n8Cm4ac3Pu_q7xGG==p?+
zf?D{BU&|hDOi)-@_ujp?f!kyhc|1Znrfov|&Yd?<4Y3|%{dvYS5)#_WKRX9XJC(>I
zsmbzQdG+-~ev6e1kwV&1EY5C+woR;NV`Hn{p>3`-vAejlzOC+&c`e^xWR~CFu0Am_
zA;8bCdNr7-57I21g<mr#C+7wRYw@0ezB=Qo`<Yj+Uez-;&O2%DeHj(75)GMn?C8-n
zjYOH2v3rx>KfM^jqF=2r{y1{vNP@IOjDCUPo6nzbI1N|c?&#<sy7uGCe>tF{G$j4f
z#pV3rPtDDKSD)}gjlW5C4R7waYia4RIy2~8xCy%-Dz%MB@n1svC~(d5h=^#2h=|zR
z+hZu>K@}$Dj@@t{Qf?&mj(ADc!NI}VB0MWkM00vv9BZ<25YgB~C4y^KXJG7}9jr(0
z-nUD|LwntudvkU4Ak=iSH3j75P2%I@1w}<;n#Ut~>z2RB=M@#{`}kDB{>~yh71xqr
zG14wX1$y4h<96!nx0ckbt*j<9W6iZaJv|eBjO(H?n6yWa7(~pfbs@s=&`k7<jB<N>
zd$}q^UQ<T5e6h{kMHq>vLYbkA?fDr)<L+`A#>NSqC5^$%>_{893#GPf&1C!g_wUzs
z#)_KRtAw5Eo1!KrCI--ADwLQwE_~BbI(zohjin7yPRr1Z&Ydl-Wv`$$FPk5qBl*sq
z`)sn)pP%MCbRrv%*4EJ>%<S}Js%c!i_PbV9|GVyy@?S6yC6wlPl_xgnZ4CK}Z`+Dc
z!?Jkf%mbzEx%fo>^76It-mmX0>y$_3&=v3A-DV1Ilt;^6xM0XG<JgsRJN+0JSJBp%
zf4<XHN5%-D?9hIxr$W!<k9Tn&StUJBD;l<Wtyov5Jq<Nun27KSefjdRS-pQ1UZO(N
zv2Nwai4%M+UOmpx7Q;E^voM&W$e?6wVtjmVc8c#!G#c$Y`6k$%N<rt(qLZ<NJdd6^
zo(P4W{PJC_-VAaUNM-Zel*G|36{stDIXPX?LIzRM(V2s#whmOv6kJveekuy;inVp7
z)=0qSDjIq#{I*{#aPeTFQK<^V$kaWPLIakwXU|Tp;dbhvhQx@Wiaf~uNK9w6_RlZL
zuQEJ~qo!Lu{qRMttv8{2<z-}C)6>)Q{q}I5l<gM|sD6}6C)T*5EG&IJJ!u1|AhWQr
zFuA}j@0tmE!kE=~3W$kmK>^4sE*_W<T$6_nZZaW}kTv4s;({U~(S+I6cx+A3PGH}_
zfWttMS%SEwN~*@t_P58(lxAhx?TZ&Lnk8WUYGBU~s2e=3N)zsKVU1(w>A7MZ9UZNL
zajh9qvQ~}YaxxV)$R?|)t4sO#_;AvcL_`WZwwPnvtX0A}&_yVmbEr58?t$;jnfD6Y
z6g=tM`^QaV_u^&=6@G0MYi!g)!mLJ3l4drWl-)}$vxsKPyLa!ZL%-3gO8jZzk?HhM
zWw%v0(r<aTTF#|qd@&9M<$^R<GcN<RK$=kQM7}5Q;o-rjs5mn0F<{0gEZok^%j>=A
z2N^?GJ1GCfCly;zwcDcvbkw2NSNX2wZNN6wt*kN_85zYF7Z<Z?YlmwWo7kO57Asg0
z&1}4tjZH#FqHH4Qh|%AF|2;04%lGrlP#L*AsQAm!iJZNy>y@we_@>t2_fS5+^&meA
zcb2?YN*pGBvyo*!?CjEoyYO&5wO--jd31#zD>p6p!32td#`7VCxc7B_1)H5Ud37%o
z4G7Ii{)+J9h{@asxaV*A-K30*4WEaH*UuhTD|9pySb<#%o;mYSC=-FGeEf@l!*oar
zM7C^&>^T8}Za7m9%H(a(K3>MSK*b7K1mYW$N`t+smWyN;p1@vdD%ueze%000_5KA8
z`bX_c9?3a{sDAOFFC1D#9n@LlcXyviNJt!GVM&L6WmfHugp=g#cc}ZN!J)V=Yi7m~
zO5BLoXuy5BWDL#M?{QO;N-BYU=Igtw%cKr`eZZ!a*PJQm#rqj1gxR8~sAG^3=&7De
zduQkVIC0Brf4|4!L%>Tk!O!RO@x_%R&c{!lTpOgixw&~P{XjzKtqsaBeCn9zkWk;c
zii%)%=Nxa`Ij^*()_}VHto#Bi1EQ<q&k$mX*+eu(1B+1<iSPeMql?i?Ui_#$FxKH4
z-uwOpR*yr+Sgr(p_pH$~H60$U*@Xm+L`-Glr#)O8Q>KT?;uz{L5Bxow{0~RB*AXCv
zrVVgZy`cFftv^AQ7i?tY!~0jbT@MI<gU>D}*glZWrPP*=j=m314$>vPkdl)5)u+GG
z)dtpU-kdITrlzLobmiz+pkHX*mqnv%_`)^jodsrkF9!AM5B1i-K<MH{qp`8E=PzF9
z0ROCc9XfOfVt)wKq}L!+X(^j_){bO(1C0B|k~LlHfY{XW_O68HmU&!A|1+y)rc+f_
zmEeB>V!C^TEfCYQjJ#4(x;v{bJ2oq)+ZgxItUw=AJ6r<OOG+g4baf{|Ab{xUp-ZO#
zs=J<nLEDr&FiCz%Nsmc!ZLR6X#)j|r5Pk{(+vkb<Xkx7o74lqe#N5fLFiR`7C?kV+
zo3@6FZJX$U6fbigkwb#ke1*L?cBRTx6oiu|M%UD|;NVHo$qw03N|EhoeSk66E)w+G
z$_v!i6^H(U?idl10;~o`P)LZbh@ini@0fbHkE<)`qFZlQSJ!y?FT%TVCBUyV;xCq=
z;!yI`lP<i&d8MO}OG*r3z$}pU6-W&Y>Ep+blU`{liHC%Q@X5&yeQa({gpKML7}&yx
z*zm>!d!|-LMn;k%Rk_5u11OOj6uef)aFv?|h(WZS-Q>N*8n1bo_wV16;%!sJK@i()
zQ&;$Sc|S(Q#Q3%e8)H9TQ&CBXi8%r5P>T^3r@sphkN6Wbo>Zc&iwx8xQl9}z8lw&+
zy{!DYs%m0yukLcUDtCNB!YN6RS}YtKj?-jvK<kKtQgu)HC6>wYMrbi4lFfVx^iQ4^
zs6449>8cSj05qFh@Aq*_?NGFKe&~>xgVrBMTIm;?kBrFx=c?01ki>tncX`on{L%FE
zhe+;n9j`Ax_Mi4u;9_B6u`DSm@&DJw9P{QGXHsog;!e60*h{>;+Fw0TjFM$mSa{HR
zc~w8@5`)_7hzN1ZrgdR?_sN%$R!W;QlBp9A@uZ*1J5}OMaXZ_iJJOi;Y7er1t2ex#
zgJbwk19dEzTOAPBsMIE`%5yeh?Onj8Cr``PMrY7!%r-uiX7%Xt<BqyDqC?<nY3fG7
zPtv06c+(*|VM;m;Nl8MKm{$~*%{^vT`f9UtQrOS}RAoSGS$M=8R-|j;$eHt(Km!ZG
zjc+Q*$mnC>vPe3j@IN4qS*$bMEi?}IZw(JUD?BDzkIxR4s%j~1WB`J!MFMQYb%OXn
zVm^HMfVFNr;Y29ckhJ~M3*i@)oIElo7bd>st?)b~q#F>lu*``v*{$Tk$rPNWk=Rcz
zANz8YjcsbV)`K|q_D<uFu<Xtb&$L>sC=vq<>fd^Sg9)T>ZKD(DY4avl2vGFGxA#O<
zP0euLDX1aD5|D5=H8u6!+)6=Ob^00`8`A|EG`)-PD3^jEEKPr?f4W}+BX#%Veiwot
z;4;g?u6)^L@zuGJ{Ls)}53$Rr11P{-`dxxH37QoH-3p;a?P8H}mXA_3U6@K{lZ9ze
z1NvJp$FS_*x~wJoqmo=y!<(z|O}2^dSIoXOCwu!&L>suTFO11Vz}fq>IgeE9?PKQZ
z1>!IG@ZpLXF3_we;%7Kynt_If#?ae4k58RC1%H1>kvf?U3(U*R%<L!uyegM>t|pXU
zlFY$*ean9P-=bO}gQ9bik~;Lep+Ov(jRx)1!KX;s-D(ah=@0P-Br`xFL%?!Lvu=x-
zY6@fb-I$22V>y=k2i2C#U%pKx^L~0~*_>BiuAgsEtncq%yR@|A+n1#eI#3Q`_U6r-
zQtp$toQAMSH&T1|&(t8|nAhfTkyGU|g>-t8ZnZeYK;bG<+c&sMj65apS+MrgMC&w2
zRw&OzmK#^DJd$zz`ucXdihzOwy+Atk51{y8g06ok^4o7$AaV6IG{R1Z82>P%eL9Jn
zobJo#>_2$$pw9jKC3FR!k&(gFmVD7oMXY{3Ek@WV4VGXI1xxTBWKtbh(3UF_(>&e{
zR8Oc)?`P-NOuD6`^9pE@7YRC8$I>z#93S7l@=H>u8TzZ-e!7EiGf$uy6r1-!S(@;y
zDf3>ui|qN)@@fTg5QM#Esck2$H>eOo6b(i}f`U&8?-YtQfsz~f@*l%;Z*kDJL%`Nz
z^ZhDQIy*zhDt8{4#&0w>HU<<m#lc%V=Z15^*GhfR_e!RW+J>T~ZEvpmk!=9>Xq)o`
z>@Kz4cN(hA2#+4`rghvJ{_!z{Mb2Y7YAwBjUDkOLNE;75bV#I=anJ7Sz~X@$ZKzgg
zIRLV90aUDc(6+~R$LN+u_R4=3vIS$?GT9_;&VjqY6nr&N#t8#v=cgAZ%g}f}GAj4z
zkt1)QFrhy^KmI&4v=@S^Z+Lh{ah`&8dT4hk>A0T+w<V;!@65YqO0SMqZb3o2pOK?#
zwFGmz{IVJ^DXt+Xj8*&!y<&g`l+&rSsSZ3s-<rAaR3;O-z^q2U#&cHN+&l%qTNi~Y
z9^IbvGKNxE(cZ!T5>OkEiS7e}Rk?KWA=r_BL!9JGO6%WtZ!bm!>1t|f#%i9faA4p2
zlpZfYmbdiuqM-z30g0hO;QIcERFx}~^_bS}>+hciL~s4_Mc>9I3-rarqBk#czIHhr
zx~`tNc~Mu_Eo2Y)5ZNIt{Pxh&Pbv9VlD;J8i{ZAk!PJ0N$I=TQ$#Ru=6N$Wi`SQaU
zQL{WWK5J@yaU47$UD!ti;lx|2t@E~4^OSpeRrOD>w^T5LxFB5TQm#&RLQ)dP{4(8|
zl!VKb0&21O{PGN+vht`Y*ia+0QnIp}rh0DV@rH-Hi6sI80xFnJ>(N5+-`b(-wttS~
z(SUYQK`S(PNWp4A!w2KId~ojHxIF(7-8D=@;BHR$=U=PA2M4a?qvHRbf^_xtMm%f&
z9pEbV7ZekdrMLMPV)Y9#IPmP^!LCEzyeR>xBMnZ74R8a!@6#m&xW~(2@?hDx>(C}P
zHa3anv;T}&IKZoC3_ku4_tm(I$(oYro(!cCmD6m8f$S;D!vOMi3m*>BB^un-((>}k
z$^fcD{!DHD@_D%g)Ndgd`PN%%*NA>jF+kU4@e3kIP#<$|=O7sfg|nI|3PzwnW@(~g
zVx2!N?@cua(ztgPxrskP3gTC1354D{pL#WyAwDF%P^JW|4r&tmi868y?1#?{v8&pR
zKG<(qcl_9~3<&QjFcf=99f<@He6$a1a)(&tM-G+-=6ejgEOzh8-`yO+JphF&8f=Bi
z$_vR#0mgK5$TC8)|4uSN;|JOC(RaA}_>BFCOAk(4cvwK6po03<Gc?QrZFf#k@FqT6
zYk*vgBi>1dLS0<9nov?&3W4W78nD(f<?hRWPDVzCs(x$uon<gABO9y+0eFh;aYyo~
zMny)xfkc4r2tcL=VOrW>{*Q#FfP7b1z6-&C^5YImx4fLMU-*4{VV4zH5Y^yvlR8sJ
zM{B;XInyxxtIpoP{%RG<{MzmEQ^tLPpFq)8R#tZQrzR%mXJut+&ijXRk8E`dH-1#6
ztgK%e5Len_9&g0``fQ#KYU=`jjGg`&;CQbi5LB-D|K}5^zl_~VP9w8$UT{#SUoJ5H
zX#%&Gt&#tC+Q&Z*8|Sqf^XSo|T4hPit=;2|K>*71BmT<+f2QTXVb=fB8Q<0|7zXia
zB=nBfjGbIJY2fY_>mHc2^iulkjMD2to!^=u56{)cr-yXFW5m3AwL%!BmE-05`ugZP
z5D*XAyRN=IY1{1T)yFXIp*LDHPtdJlY?3OFFwwkpu6l7&tiRHAobD}x6rp!7i6(FI
z4-(0K?86h^&Do0M+}y=yu0FN<@H^vBjaP9vmtr1;;{GH!SO|nM<j&F{Zg|)f%0o_C
z+7<AY=u-#Caeyxm0#4P|>FOGVB#j*utLfoCOP^;@+7MBYKC$M$NWayY?om+sLI9Vk
zfz;fLxwTRv*Cy|dBCWf5?))D!z$P$Dp~0L2$CWPsVXr>asca1xjcvdHphKv*_AW7K
zXPar@o!^=>9g0$XNNhSLCJz0@D3>c&uBfBYxfShc*I&@RFA&M%O{}F>Ek{|{*w9~6
z6dgjvvobS30SI<G5^D#0`}*PyPyu~6B*1$odR$1>bOWo2j$S&qZ{Jbc_`&ijF3v73
zJzWC?p@5K(Bs2w^!4hi~Om0rjLM}TDBEkCYP~{G=g67r^vo<;r<`x&P2@FsxChZB1
zkv{_V<fYU<4d@ng8Q?dGJwyqd5_1e^2Gf{NJ<g&joYSGTtxW^2tP0?_VlzI>GF6=B
zx<y8Eo0Qq>&71ExJYH!VF5g?Yi;Sa@aiP4WFrpPL22Z{tBQtYD*saQxZb*};E953t
zOHmZe(~ll)$7?A&!F0(E;$W~oz%QGu@dw5ce?nITxWI!}G1E6PLi4g!5N36}K&doM
z+~4Ts{6~Y5S;7pRD6;#k#mW!qnHPbB(Mp3vMyuB=YC(78Eszo*aFyC>2%XgFueR-4
zqn*Az&HD{$Pa^hj4^MWduY9$Pm;%dL8<gLdWcdN~28eaL&J;!8r51ju^R*E$h%3Wl
zb8>T$m}4hSWQmxR+kxSkaM3Lb2CeBcGc%q8=+MaK@!RU^p<hy!=a*~N*S&#{{ZgA@
zaDnOR>G5xc5ymv=R;M9PH?!czH+0DX3Zc%Py*it}_zsHFHb+5*1hUz|$xtTKBdEe;
zO=a>6%hVs-+o4LHw!c|yRKav|mRM&3tLp{hC70e+jvb><RAyt8gJ`v(;(~&LJz(qB
zMSw;@_B=Uwvep`4Iw~ot01zBZi_{ekc~5mCBctcfpVO5h{H>mj4&KHOSl?;Y0Q2+^
zd%sOp6`FR%@6SWUr$yuzhpz_PC8bINNbpM`U7(%y*%*0I;|pPhLCwn4ugPfou+LeH
zm-m`j?ZP9_J0MXqVKxx3y)rPX`HTaU81GcHfjN2&R{|8{8$|r;bkW|?F$&f+(H1Lh
z-Fgg8&jISlDQWvCn9oP2rjFVK6z+>kv4eCeodMB5%jKOhS9Zv306*|njB2eKpiOms
zv<Z{={NI1yL!ChM^aa|Cf8}oxiwL5;lV{mQW;*)!a)AZz^2ZM=PB;@J63JOapF{gD
zemYqOxu^(}z?<soy1-=gnE;><{q}~+of7{-F56<I*_ufg-ehI*!5|ZfDKe|c0&_Mq
zBZHFXw2mH}j!j-cBISH3IrW=!@`Wf|O5jDrNKxwGg;nHI+c<Z?%$I8oOK$&}Mk#X`
z5Cn1rQy-?@-Cb|4u7KS%35Wr=jo}qBe0yna*eyc8$TSzkFI{f~Su};R(apCTH=fBj
z4e>&_K}n_0IP0h`g^K^~;LW(!+qHP;Y5l-S`ZZsK2?p#326kOy`(Dni(o3N6X1p@j
z4wQW^hL}`#xXt?QRg>c<PD}&pLp=3Rrtm9Na<P}8ElBjd!ot3Pw5~I}h(4;&4B)DD
z?d)=Rr>cIY-~k+^V2TEF2rc>)jXn<q@c;DjBYm(4GcRo@t7YYIqUVH!)Bx@Dz)pbu
zrGufAnU%F#3CH|(F4k=76%5c50B!-Hui!XNR}(rNIX1zl*jidw<*r%YQ)pb)I$Y0c
zF#tL4vH1OZN2)Ro=aqR?Ht6EFLe#Nm4etCDwV?OwlNYIj4Tr6q>#)1F>3$)oEAZnw
zCrBiiQzOC3+^!Sitlr?+^)w`ClDz2pFHcp~PuuRE*mBMO=5XrYzSz^m>qU71GPoG$
zwae~tU`Q&%wxh*2&j0J*>iLVN`Y(NzX=Z1a=<Y35L(+@qaC!*jb<Jx<S1ca=6G=>D
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
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
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
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
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
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

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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] [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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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~
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%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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] "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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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
zcmW)oeL#}u`o|xoq!*J~?qmjHxf8OT%}h5DM6^y}l%Uwzc38)1c24TfRK!<I9vzjN
z8R)cQnIa7lUB_7)9?c}}O{z^%FfCKmP!UP+1;Q85-`(&35_z8czOL*0{eCVVFFF@a
zU~e62gI7u`gXopL-J!DvhSEJV_R6T&tsYdlwg@efzgf@<$3jH%^Fc^Vu75Z-qssVQ
zydBAM@kWxDqj<L1KJ&vS+-qVFB9~yM#tqC%b%Vm#Er_jgm{#V3^7p|!LULIY*9*yl
z4(vx!SkZkc+=}QbiKtIe;Qr+Sj%u?SF1;gzH;$**3fr>HVczC&kB}fvfBCFrZYB&`
zkxbw!-1fJL$|NR-`B`bv+m$}o<his!nGCW@S`0^5v&9E8lFJr^>Qd|;VdBZx*4Je^
zL<1Cn<fOiMye<dc!OdhZ1kpBlU~<&AdR)JqfX_48q99(NqJ1>BOw<+wLmtX#b+Hx8
z%Jf)~H0)Lx4_(|FnqlZK70~g+O3akfhfjNe8Vh+VPK#CedM|Gx`Hk4|7xFA2o($D5
z92yrL#7z#K=4OZwtU=q;R{Gc%C%C<@7UMBUdf6L@)0BmYCp9}YFXlwQnCDqBN}Tjh
zTQ#<brz;PoI2jI>hB&l*DK6=|;w_{8<EaTLxyuz4L9yN^-w?Kun%tU@y_C8h$CF7B
z;oUpT={2kVnj5mSj$isJS48n1+vXi%HTvr73Q~Jwc%MalU_pf(3Cy7Q);v{mqbmjM
zu+4UyIeI8J-ZGw6qbE~okUzh_C?yM%a5#d@Rm1RRj<ytYar}(MU<_ZCXRgQ^@P?6w
zh$m-O8an=a^S^Ik+c%#xtZ^pmf3H{H!FgHSaM-%aS6!>tY~J0~U-U9>Ya^pCV%|iI
ztC%0o`rp%tjlHdw8tZ4&{H&Xyhs=NY-zhMjB!5E<V!ns6pYu1KJdjmaeS7*WdGKC#
z|62##*!V^8<j<nXOL3bu`TbH%>+yr)dMc09|7Po4uYk%5et6Czl4lsSSDtOPP7^hZ
za23po=|lU`l5OqTi_8Np1uty1B1@ZT=7=3vaRXW{6WfhlIG#lMp<Z=<W)1pJp5^Di
z{+6iR8=sQhF{$wRD{|&fS2uS&&Ys9S=?~wFt{T;UYFOUt_0Q&KTtwuy54hU%1yBF?
zY+KP64Ti9#&+X__>7Pz4??HVMDudGBpC0`3*;km6`9Gr0evtX6gI8NTd;|Uwh@Dog
zSi4_3O+3m*yH2+HQcVNZW0SRCz4w()fK1F<k(Fwi4inw3c&|L<fB9?ghr0L);rrg$
zpjf!?{s6&!uFq<qJ!}~(;tMRMHR$tNuEV7G`Ph7x`y=la#UVn*(p~1MBuY+0h#U3O
zh)4l6I%ofMk8SD55`$ZGmXayB;ycs*VaXoU>otg5-Ti#jS_|zDHPhg;W86(=-b0P)
z>t&pIM}lOL8}oRdds=M5!)c;AGkS&&>$a%#F!MTDB8tA)g>YysZD%Ys&TQpJ{pA8~
zj)tnG_;F){gJ%xqg@vv`UBc?3X!}15*-ODSrfe3pfq>yMU9&GM<NB+W7;bOA9K8^>
z1^d{>v$-o&!;-~<fxt{MF$&6=eK=9Gb5MEut>pGJFELgpdhYGronwWide=?WiKrys
z(Ynbzw~>s}N}<A5pOZNnZQuCBK6Pu$G$XbQJ?_9$V>)WctI6F}c`m8#`&Rl)oRJ1^
zbBE!msEz57ho;~f5RJNsfKrQ8zw?PWTv+`b{qrKU7nQ~2aTYRap59-|7rTs};lDT9
zs4f>}nW-Mr#2zA?J`?tc^03P<={tVaL%vlyGtjipHEpyap;KFB(6;ADG0PwCei83A
zKDz0o*}euz{k+O5IUPTB?9>_i1;1;gpAZ+046#QV{J$jg$~Y?W)C?_bFjyaW@w|yA
zXA4{LIhhi0Q>$mu8n!aL$Py^K>FTAZ&kdeA7XGRkriJ%a7RKsIj&$d!Axc&X*OQ3X
zDUi4IvP8nmk)}UEOYFspgWoB@O;CjoH2EUPb(;%LD|wbGl}`hH8Qy~M`Ys=tcp%h9
zR<dHrb!4thyiV80M4z(C*aAhp;?;zE2W3J$YMBXNr=Lu!<Q!d87sb{8q&t|iP04~!
zq_$PigO@X;s%Hvc$YKavkyLk=qpj{(Lxjsh`!t^2QM(51fUMG|9pX=Rt8N&nY;~C>
zM5HhfbOOtU@V?n$u3C^2r10|~X9a%d#JH~52f3K43^I}m*FdVK9qc>z(|JT#Fj`dB
zW<DvZ>SQ3KyH_5LuX;iomS7>S!K>0H#Y8+cQXA=&Owa8a8I7Jwpk!2TxIb!@>X4JM
zWt~CDYAN;tp7NpnCe_2JE&j#ZFam0YO==$KuOR1(Kk*B3;M@M$nm$9v<y*!1a!34j
zPqt&MN`7_X-gjkjg_Q48<F~fWEx46cKOzKT+p+`iRWffm*<oK3w|6Lo+v_k@;q!PH
zL;EAHWBNq(LA79i>UflYz|-a47b!$_@qVHsVPD2Ao9t8z*J6m&vzKF95bZIMGnMHG
z;e+DMFW58T-9u*;X!~%)D?{YYA!1JN>CLZ9I^!W<CDxDYd&~3h`YHuM(yS%N`-m=S
z8gRP`d`$51TkdBC3|g=i6Nxwfo+cTPdT-rkw3FkpF&f1uNDSpea=a6rA!F@h_eF)u
zGea_Er+-j3v)rIn&)~`8xD|O`bdgBjGMdU|79~w7y3ib}*kyT(qK=GGmm>sJnj3jN
z<h?R-0TXb=Tyn(lAm+9*ChXA@<pDxSTmy_W2}sdHDa7UImrH?fKDwB_2IZ-%TM6!!
zN$85$RKg6s14rVD<f2L&Xw>>9FL~gGq)_w6_r?7GEIpO6<>@u{oW2(>HuPKROuxXf
z-q+9<<s22jS0>Y9UI|}I&}o6|AMIS?nQ8Rg1kRiIr%%M|bs{9|09BS4d>>wpUKEu<
z7cTB-*!__PXD*C&AZg5-r8Z&U16`IfdNH~)zC)!uIwI@O-@v{rOJpo=mCfBstL@1P
zR??24KS6UfcfHE0)}T$NkZ8`4&fbU7)Hyc>t0ceHM!_XAv(TROtZ|F``U}P*{CSJ{
z=%8Q?%4vdvkb!Zf3lx|ZV`Gq~R<Vm)AP?hHL)g?B6n>;sR9%H0oe#B5fd2UpqznJ@
z`0KK_`lg_k6-E5kxd8=kS8LBkhcAWR=Njw{j)T&tl6|y9v~fkQxV$&&k9lNZbvc+Q
z&|a4FIktM|ouLM!`qxi5zn-*x!#XyTRQ1gsy@@gq=q`XMOl1kK$I|%m0Q*<7L(|2*
zD5?Gsz6x4S>sxmE!kk>^?i16|#$>!~%$mM@GUOY|{I>E*-5-R>d--#xLt}4TB+Rq!
z<@U4Rwshdi$%!{4em4X}H&UNOHWuy2=#*maynoXZO;n@LoV)Y7n*W>m<ABS$NnO*P
ztD3&KNSJ&twzGW2o(V2_j;L?XUnwc<A}ozqx1#X1fQL%Ckd3_%#n*_Q?>U=lH4gqX
zv#2RI{}M3J6m_ll#kc$U%|3-zEb0RGpU)Or(i{CWVL?b&fB6?T;}7DKi`#+{H*!Vy
zZ_Jk1?<|!Q8e`NQFOzM&*^uRdtMPgN{@+w8EUB<!{^EBfS^4JzZtd6ICgq>^cwL<t
zY~27q_ahsfRir&jUpRfl3(1alkUt7`I&&7+NXt@U@zd)AB%6v;sNVg@Y9c5FrRo|-
zc3tOwVwz0QXsm!zx~)s3n1$)%oJb6nT;K7}JBUViXs)R7nF0@A`d_HL*CzClMi5~u
z_VV9d;n`xR5OuohW8vwr73Bp(IJgAXH;Kj9yl48W1;{_}5|iJt*OdWE!s}~31&q!r
zLtdz3UmTgrDo&q9ddVU4*i?Z10-2q!F=+^@*uIHQXsK20G%Tc7vBQw@<2}d|GoA62
zEQ=Tsl7@-LP&OfBj=tLYRt&Gx3*wanQv8e!_6)Z%y27@s?j5yC7F9T@ALp^3*H3xd
z$;5Oi!l=&MpOY>%4P}bgc?=!qMh`L1>XS>G{CNBZZ-hoRtInLEuR*Wz6of5445vFf
z^v{Ig!O+u-%ryuVLmx#pjvX1YiuJgBDj1+$*JFi=G1Z9)urg#5l+uavnXjQ7j0iCI
z7lEsk)3kfzkOiFOBT9v@lER_~VXwgryMHh&1ToZ=?B-dq6+_IB>aY(7)OlMojbWW!
zb*7!9US0_6;gsYL3dhiHWmi3BsKMrAh+E?pNqe|j;D|T(rPn}k!Mi?v^u@Wp>O5JB
zJFLe|B+2uNsw+w-SLY1j=oDWk_!Ie=Q$7B2`-8mDI86frb$#V2jV*joYL7Q%*E+Ke
zH2?hhw~`{)_u{Ri7I9c^8IyDSj=3VUkrrO$&}rJa>w<3C@j1c<jMAAeAeh58c5*jG
z_snv8J4w-{B3T3E=QZrB$Ly$o4C8czf)s)|0@1Etj$x~~v03BklH21}@%q*6Pe94w
zD`$J{ROu&K=qUfIOYNR)yDtzqtgRat!RH~QL3hT%1I~(T@^_)ut@OROpBJMoKARca
zx9ts4?UCuu3ydq7FO2mcyn6l(K1&sTUs41{k_4mrN*>$i^vXThQq}5J#xBuF_h#FD
zonDUf%uTqtqIW+OnRskY0}c!V*MN?zH-@Q#_Xzf9P5a*3vQrh)U)4!`Tcg7jW}ddz
zI&;&ct6mmupR3Ni>2qiey4Tvf201(Mj3gxOSgxrokI`X~uDbCXFa<19rh(oOge3%;
z4hB7w!<FaSL~{1Uaf_Mu05R~BP>P!cMRLh1RbpCuPi=1*jaJ@}RC<yGq$sDJ>bvSv
zWXgCNI7X9_qBJpLK;vGe!j;gtZVauYC>?tt5Rt-*g*P$AI?b<ToR--vch|UP2I~~!
zhCwax?_r|Z8qn{V&@=nU9?MUqQ!tW-cdCOgfmc^)iB(LIThpa8uNopdD3_$@Q}glW
z9-X^5C0M-9x_UeV%W_M}A}5SIT#Rwz=i3UjGWY_rk;b5tG|(H~JvqG1&|iLQxmVex
z<Pqwf4(|`;^z#RHnva0jPq}1<FMGRnDfLJ1PbunFy(D$g4#amb4~%qBpu==oU6$KR
zB?<SGmE=D$9$Polmu8Igw!c)l>v|TnrL8N7o~S&A$!eemqXlK{LRPQ?pI3bWNl0SQ
zGSRud1ZzzPJ;Pcv)0Zw0Wn+AI>I+@aGic9)Hf~%s>qM0UIXqeH(8?cu;zo55C}mRg
zOo*tg0QNwO`k=Gleb&sPcM9~4EM$@*F)WraDSVC1G`%$+8L2nYh*(g&z=`b+1D|df
zEQ>=H6AXneI9XspvyVB7n?}hf)$DH796-gAn1ZVHc!aw)HH(bTQwX)42?Q03a`)+q
zJagtqo~ZJzWG8rEU@nc<k?TCPaAvOdMUBp<R9$6Uh<2E&FMDrC5)cYpqsL@f($k%>
zaxE{3AYM-<x|Lm<I2><ZW?pVfC4gV2KsZ*jy8ZFa)wH(Lcg$fIfWpSMFR4Gt42rE4
zzBYup;rJcKBQIus?ciwqcJ67|8}F5_C&r_%>T1kAX9KyFZ^fre^5G}rn$%F<wY}vc
z0w!{=3s=<Sv%8d#gdDd1H>c4WH`kEOoBi)MZP`qYR&c>b*atr!PFs0C!F~JLKi;lK
z(X5!Gt7N@SksW)FdL{L6sG<IF-7M<;l3!O^es}&xKYTXxt!SUW-pldP6zcuzp_5xK
z_bsP2R$I^IHZ6^xXy(E#rjrN%oO7J-C20TxO_6vAsNa8gUY)CsKC;LZ)be`;jG_9S
zJEyoPDQ-+#rr+e!P14XaibT&3Y#%73Y*UwO8l8(RSQeB_uqPO7lBG4MD25T+x2QBT
zp5^@Qr@!|l{Jg%yTOe^(e03mZB8;K^B%mw%U)QTcN5&Ja@Z}AN^|yvqS2u|N!(IJ;
z-^Y2e-xCL9hP-dTe}lb{{lCHu7hn7vgZ$LcdJ21%j{5iCc48Fe%Pq@}LG2}y&(g2t
zn=UE`jcxz5eaCXk;_9~O-Fs5LNIiFRKtc1rbMJ2xcQ<{X-Wf^erkTHV{~>&(@@z%%
zwo<jk>rSkEu7@4AAErB6)kXihZctYe-8}0zq!@d0r!$DKA`-*(%u=CkwLioyN{X-z
zxYNp=GF0onEzy5T)d|)gDG}c79z3<8lnu*@mc7b)E?^d&YapH3tL*v8Fp>p(De7)*
za?+QoD^bqHnZ~1?4EMZP<>a#3GL7;ngmz-!4^c@}7x?Ptk#-hC?CvIOK$<hhnNE}+
zcu5x5Q)`go=!n=5!MQS;E=KrZNYRUGQPm-DRS3Hfiq#7&?M$v3+e+*SHIIdDK;Z<I
zwm5?1Zf<<=<d4w0Bs71X6F!Y66K0Nf`Z`fU%g|h}GM-O^U&FqwapaudktW<2l~>RJ
zBQV26#~?|RP*Ytl7_QGr4}>zwc*0v_xS=Oq3jNy{mY3%9t?x^r_3T28_Z;vTj1lYZ
zPk(9A4VIlHGib+ViOin7Sltx^^@b{uo)RFCbA+8&m2TB(YHrFf-bptHDy7OD$_#9=
zk@0PF0}Z6m^Om0;Zb#d?eXa28@=D801V=tgM9@0C%33_8<FNw@q%5hdgR+U_hIa{#
zWi<KOT4o9%x>8ieO%q!~GHO;o9d!&svB9tTMcb9`>?vQ5r$%)#Qig26Oi?nMX)fCA
z5D`A_pJ7S9>*iDZkIW~{*y5i}@NC=zZUL)@AhduSuS<8ybB5ha4t$o9-dD-FZ=WJ4
zqr+Sd>wpUGv)1Y+RTzBaKE%Ux3?BKpPJs(XvuQ-D7;$HrnHiEH#V~xNSnUM7spRtN
zCu`6ZQb-WJtRQ2DI={&88UDoqcBzV+K~2FE^b<2L)N7FETqiy+qbArUCFO3xB>_ik
zdvy%lF9^DgYw|m7l_1&1{^IjbhWpgZv%Z9mr5KqMGk|Q`ur64|=r40dQmW9WS5H5T
zuH<UAy2<o`Lko-QInjBhm%`WMUKKtkt|AO6<HqV6532LF4>W4Uaeg+TyH|Cl0v9ss
zCWpA^lno?Ya;!z0>b9f7@0Tz`*cLsU@*0R;asuPf(gknT4MW%k<sLyUrwc#L1%4T>
zls1ZeltuOh&!Z+7%yrz{cqb}dQBO+8`0Bq&?@mC?TEy#vp8`QBz-K{hTx`5f*sw8g
z$o_j5!K?k#KmnNismWu8W5^6(gYYgE=f<!4^yh80qBZb@?Bp2iZgTh%?k^S4Ah&>y
zE_c^&e=7Do7;?s|>|PnX$=)%i6+Y^N+8+>Rju-|SysEg-qBcR9$+=q5$6RPiL9vo$
zNa^0Me16%-WwvbY-ofv$(q3QmD$7VZ^iiIfjwd$$&G6WJYCn?YmP%Z9^L0we1}EnL
zFf7#zW+R^p$ISyt>r{yaPcCaYCVME=Nycu<#^lD|LWbCf>x1>?G^thB&P6dET!OTm
zfhLdF<?V6ruFk&gi>(#0j=C9*BB+uR=BDZjM~1dBT{#vRM@gP?+84Z(<4M;`{T6$m
zAwnQjdA6D5Z%P<CWmh%?*}*wNdog0+GOr=mC~l@$mwa-}9lAPhUFnOv=wUuOv@lq-
z&}WsN+KwC{fHN;D<L|mIgTOi3<S@y<JUwKU>XE=Hm@F*{VtwwEt@2)VuQ{h(gJ{XT
zzB>fj>5ch!xcb1h(R1yOBdB*Im1%(;1m#Y9Lcqf`X|ScXa!%6#;eFtNrl1hVm|BpD
zuJ4d-xr@97+^-C*uYp>>dc2_B{pMv^b6{Q)cQ(Ppe$&RSh<V-`lXV|ElPUgM5VoYG
zm$6m-0{=dXnL5#*w|!pbR)ufV|Ja^UmNp&ll;ed2K7xZ3vp*sUH8Mj-mJCQCQd7|F
z<+oCby0j8_PjC<7iEO)a_~f(eT7F+@pX&iS*GoP$pB314$`MZ{_T|T(Y|-t#o%H?u
z_^9>M+jtTuFSO}W7UMr_P-bId92HxSKICU<{AfUEGPNXe9&<%9;fG%zK0G+z0EeDf
z^s1HI_&GFp?(dH0dVJqN-t>#r=WyAn+mnig$Jh2HBH;MZA9HVZSec<i4|h5YH!n_B
zx!x8Ka|esl?H}$V9_Kgz@#68nHx%;%E4Qve0qK*1hXa9%m8kuDRi@SC*Lx~~(^+au
z7`e3SuDM*W_sWAu=T7s=s@gp>-W@S7c?aX6g0aCXmECO$tD|i1|8H0TXXgh+TNA%0
zHV~YRDmZENTH}{JSKyv*YIG61aK7O$C~^vFEcUk>dAom`xHsv4U@x^Xeq?&)S7a=h
zY(uSv!Q_aG{vD0`dzGed7j=m`%r_cK@5*(!z0%E*SR_#QY`I+|Z2c&e(po9Haw(xQ
zjLtLbzltttnf>sC4Y&O7-l%sWla8NTcwnvH(G2gs?OPldKYE-W`l7BgSie}WYxj}4
zZxQNK=jCIXrl7e%iA;C=2keNcu-GlstT+r@(8N-5=#}`A954Bpklv@=-{w^|Hc+Cy
z_Lt(bqAwZ<UT{HUV$oU9lIC8O_UFIH<^HQOSV=bUNeQ}O<1wV5om-R|T(gQ;$dtj{
zG-Cvm3Or7QD$tc}izhsNTI2i{z3E`{A1fdx!Q54|?{I)aatGLzOi=yfs%L8~qfyTG
zSIUq$b@}Cn{78Kd^KD2Jgd*3c<O2UHp~J4oiE`>DM)R*M6)d-gUmlLfHBuTNM00G}
zHWfFF$Cr|t!^1Xq17QrOI+5Kz7kp;H;8B_;2+aK5s6D0aG|Kn6@erA6k%XY*q?pW<
zk;{I+uMW6Fe2<XA{Xx`@@wub(`sOj}u3c9QhAwaDFmcmCYt0*?r3RaoW{5z>d8doh
z4chVnei+&s*g*ot6r08jn$>|XRTs9qX2!M>bNh|L7p5>qYxhyImzUM3c5Rga87uG3
z{ET}h3h{JhgwqfhN4e}5r%X)dsPlG&tOhDn?yg){HH?i8>$%rXBW2c@U{6Aaz6pBd
ztydt#V_9ap9q;y;Na4FxQ^X$#l>9vJi;3|mJmK0L2#FNj9?mpgTPZrU+t34SvZ@jI
zlg+t3ZV88TxA-+8Ov_Ar`^S*?be21Ibh(G!+{mR<SP(sx9AKnz1xT8&bv(*h*vd1r
z4u`Bk>peU|GC?6x0+;9obIzezRC8w3d5m+LAX1RJ_$&_62tKo#BhhCYhs8*4ioA-`
zg+r$jd+q;d?Qzx#TN9|^aB%_|IK<*O;<o!nx)KxVhgP#i!|_|M>BPWkUGUtntI`y*
z!sO=qIw@<}TK-_M4k1gVTxx(Y*c+g!9ux!zs}f_DdOMMrI;XbLdAwEu)VR4nzt0ir
zjNY)Go7RORsJs;MgdqaiS4nSC#f2fGc=AjviyokaL)g?tkeHE*(A#YFZKKxic)e9J
z8!LxUi#zo6H`%r0rf8AlG3IWRGcX1!60rVDLYfONk)hkEqWuMNF+g2)<-we#);6;g
z-3gB1myn3-R#pE_FLEj&Zm)>(jHrRuO|(oW5FP;i)25dqy}r^>GOpw?Vv#i1UsFPz
z6(GZpD(h<zIfcPbq;^ycbtg8bF%hC{qIb;;6N6R5W*~pj&8$<n&@$$GnYsO)@%6Vn
z6>HFFVAVZi6bgI6@AN=J1T<b<=@<;JQW|Ih@^i8V%t~5~lPWb>g2YY4mKE$$tqdD-
z+~j#Dbs?)|?2Dw&OYgu-3E4v~q!_2HK?(Agc+>uyAPhvi$t6E(hXanS`yeTaq@MdO
zm77^Zxev5^rXg(eD*`!znzW<AyK|(ik0ZL6=ZfXY3uG}s36xNI4qqo1m=$cDp*A8L
zuvHLl&MlI#trQ&LonQz?(oXGu`te}dw)}ZPS*5-n_>ZysvSO?7&^4_8TXC*A)-8ee
zkCs>V(6U|&YwPCDH|&1C@Zf+(iZHwFkRnZ`A`8^=M<lq#hl$mS!@QU$wF?(Vtu=^S
znWFZL>(ynI6)^)+1X|-HMpu>|?Ia2x2=paKN1ADWaXu@uFyS4s!}ZVHG!N#m4bWb0
zI=mvkvjlG<3~{YBdP-Wlc>PYB-Qbo=Ad{j3RAACc$g6xq**DIFw~eMtb(8w$#A9~J
zB=&+g>g$`f`VE9pGQ#X7=aeeB2e;pPU4&7@>w(QxD^eWV{UYFru~LmTnQ1(^Yf|u*
zqNv?2pUo4aujo7sM?1TbbDFT7unoAu0u;-QFxJX+lR1|cVaptYU%NY_k`>fl1>h9V
zX$86l2p!ixaX33<(_tiJVo}aBJ>5mfz-zCCa}tEWjeVpHr|&P;pB`r}$mg`h`cq2`
zo+a<*Cn<-%9u{E@Uoowr)`HCHk5}Vt^<{#f<7<#GVb#V0EfU_Vg|A)Q|IPDHDORSd
zSNQ8T*(0RG%lsoHEvxSKPa%lM9xvg7<QCqQ(Te|#%$!SGdb&K&1|m$KXf&#L{-gWp
z^z_~H7EV{fmM-GXhoR5C(Sn@g-}KpEyq03qIIQn5%8+dfJ#5uIJpBD^FpJ`(X<Gkf
za@;ekr6%~kz7n=c$v~hV2<6<b$uA0C*msbbNnvIF-ZFor78q6j8y7uqyR0+*#{-ui
z#UoEYq8LvTRI1}Yoc&5#G<5&|$^%96U!jIu+Wj7Jh4Ys`aGrJ8bq(D9i;^?AEaWrQ
zy;S_QC)Qy!`(K>uGTz^SihS*VaU!qrv)+r$4xq8>;QNh7H86j2IVRw2+&7if-<>L6
z3B@EN-Fi8}7Pr(|I4CrMG0pnkI$FTR<vzZ+R#1hcaV?a6#xMU<;=NMP$Vyq(P{ZHJ
zM}@CTNNz73^F_s}RcuAIN^Jc6JRz0nCZDUS8MOvJM)-)H<GlZu{p|UBk5~2BhYSq$
z2~61@i9sSvF#`mON%L2KNBgCcquq@DYn?!^&GpQ4Dl$M0e0V*jGR=H!=Lc3pe^vL$
z;`{s1BnMt6;XDrbb&hUkc4YD_z<ULe3iZTtv?|1{D$?8CVm{(9OZ`qC4z*z)kfIQ<
zTVMM_+aYX~pX`r#2;_Xb$vinMlZ8hh*L|J0WAQ5)>wp`oFWQbPRSQjXgLyzH?JZyF
zt7`34VTe6Wg0>(QDcxPx&bS*HtR+Sv+TASd=>#{nT96@<Lkb3sFn%f~Jk$bj6@Oi+
z1HEH75<eY0L-h#UaOi{bC6v3ORn(?-6*#&uD$JCJm%|qu4j)y@5`k}<mL@&DiKE<8
zPPtn%%2y`R3Bd40(W|-T0|H9{7Dt{^J<Ap&nxoYM5aP+fPXbpemQt91sT-;O?yzRQ
zkrrTUsja-a26<UN*!M&^d^&<FXe*4(x<BQsL+<9rY<06&?Dw^RTm0?a?UUqpqFC;_
z218l7=1$>QY~)VkQ}H^Sej1c)5Df=<2^Tz}lPmg052+c5!CyWD4xhV8mk;zIa@eRX
zpEVz&g!h-@kc|u$6jL3pE+q$tcy1(pl@GG7RK?WRdu<iSgHKob(BtR&w!FmnSGf57
z%NRlGeUUqj<jFTMd54y`o(XWsTZ7?fH|hiveXgAbMdd2u$=MPSaJ)UNfvyLi6(-X%
z2{QxWa`(nNjSQ_Q>d-%1SNQx$@cw}HErmRSLoy|+>$OF*!K)wAvkkU7k5p7lf0^*A
zT`9!~ePpy_bA{`W9+-rUhWSFE)cOUfp|KXIN)=nyVpxE&cY#5$s#oW46mn=pH{`@o
zWr(e|a-0*kiQNq1CWdq;Fd%r8E0CWK7;z1_q)5M6QBIVzSHVOe*HT;cGU=;E4&CEr
zPY;5gOJ$KfW0inLIK>&v+a8iT(p{!MtF=$9dhr|3>^x-PiFF<w#t81)6}hfTVx;bZ
zk-uy6w$~EKc#_R<^hKHhxbx<)%>&;CE#6I=IsBDo5lFC7F#OyCnZ9l)UAl_x6r>W<
z#ZacPzjU#+ofhlxo$1fpG3y?e--QePsXQb-sWxxBjC0tHm|nBgoaP~^zCJ+)x|LLj
z2kzl3sk>8+lj}$u8K07g`yCE9^!2`&8?1qBD~c?sy|stv=EA0Ol!?W=Uc8GGP2=c)
z@vCXEWEAU^?^I~?5&mTQ$-A`B`FVB)N=v~5N=1dGOi)85Qr}J@_F0i@5jQH2uKO_|
zg-55dkmo=gVK+bu0zeE-q=5O*++R-Fy%f36gVS;fejmmg`g(YC_jeBW3xM_S!hR(d
zThP6Wy~g=Q7PQa5C%s1J@z}3x0kmMrVmXQ1<9vpF-(C-2%Hu|XfVW6p#OZ=?hbSx%
zKJzG#BlUhtE)-MgRTYofkK)pETh(*G`fzf~ZM908V=eIS;R7ClZ`feg#U=ezyb8N>
zrtoc}bJ{%23+5ToaD7(CWO<PQMT5czz%T4Dk(e1X5dodyfNOACgVO7;vz{?U_dH^<
z{>a9eqY(L{xrZ>y{^B^`+3YlGuWljlFj;Dp7zQhIl-v8VmFXlSOyfJyUL+>!9)ADG
zr@Jq`nB}I`b#G3WiTH*{xI-uC`)=$7a5wdQHD5SegV|LYc3z1nrDITPe$T?-^(8R$
z-+Ag`j-UosxdZL&$Nk!AM8+b$wb$v~-J<V=Y;wVB$J1*}3NDv9*DT?saqYuXw|X+M
zw2jMFNhP*nZ}y5}`pXV$5{Vha7&9L2=59(@ku=hZKROCut}<@2nSyY&-z1$_IxDgk
zWYJ$zhCe;zQ}i5Vs>Wmtlo`jrHh!|<g;HdluBcuvUxPB*svmuD)wF^0Ag-ELdi)$n
zo&M|5xX6<s-XC4Awx2)pbPYQ3&2Zb_2BIi$D!({C4bQD$yQ(X#4c^gVxjm`G<KlC9
zqmJqCGxSX`?atHJa!;&bK8lmyVW92X(N1GL_^wkVK4YyR3}s0v55X`o6f_a;lcmzm
z98r<u$v`ZXLBLM=+of}+6MtH<m%Lho8vo|_@Oks{!;X~)b^pmA9)>x2S*Jc4kcWNt
zDn&WIv+)D9(?anNJH+U;#*;ny^9>sj=Cs<9%4@KZ8@B6P!B@LJSK#O%Ja*nRP#M4E
z=on;A2tHEF#~x99SNNrd<7d*}Dq?Csvo_SNjvCdsXF^|Zt<Gz>x;my;oZbCXwC(-}
zy1?12F)FJlw^zk2PDignTfY9g?{ds<9j_}$=?40)tWisCz7UZQG)bKih<~?)hm9;b
z95I?T>LoY7UX^$2CRRODW|YQbKOR~ZK9j0^WSaLqrjhMZ64EFC_z!Uf+K{(q#?%-5
z{;R}_;xr5~n(c<nSN4mDSdiLS-7{8x%6HR?D75HT{F$)MZbt%4{M<vK3^e(xj%i44
zkvoG&d1-lYh`mcwn7l5{3j{{6ZWUpqW&QJa5Mqwx_K7c7QE4vwxsE|X$Abzex^JGS
z9zVl=1#+(C9v--aQ4st+mgWB-SF2c73p+~}h3n=(bpm~<xcW3;Cf1;j(#=%%Vvmyu
ziBaH5{AINl@MKatL6Wup37~ae-a-!7a!Q^^D8A#s*oCK2!_qfH88z4f7HT-82O?VC
z(^M?f2o{h17`GVZ&xq-ez9Cv`7er;5v1NJDJqw44DG8`(jq#{xSK%q&*A={rRj(QX
zElG#G-9|2BFCdy-%8RV#V+Wi7*jGL;DXPBG%H+AbrVxfZR^(N!nKk-Set%i6sSiq1
z0skq^G|TOwvpbAbtkxXnLPhu9SJBHd3GP+Pz~s>vxyL*XT!Y^Clc~##Jl6%LO%bCa
z2D9ATF9TVZxDK~7gk2HcA4=k?*>^!Pe%PoB+Y&tTC}B}OuJ<tcJ{^8F2Vy$tY$ga%
zLbfktNHjwL1myM#P{W2W<Q$x4HiUKed!tkpv3(q4*dvR+2`S^rWnQ({hwL&bgncm7
zLjsR<E=@{Fo73jI@D74GhXbBuH|qBz-N<Leo_!`_PtJTomhxb~V3-u;PfEk!!!f>O
zprtcHGQ|fn1F!82(Fpc|5Fo<;{P?On1ZR5l(j-Yc_z&Q8N`J8qbI7YwR2c>Frbg2x
zJ^zf?iE`B2l$*nxRwSi;uZzZVn3;C`5c`Sv0K9dwTw?%Ym_bWUpUm5;^J%1|puOyy
zHZ0|6js#=z<57t3v3`g;DPjVx$(~;YNYvgu#E8^y0-Sk)B0gAo@-=WwJC+V1O^t!Q
z@PGmhG6TqTJ{3=DdY7hYYjCozuuTk{A&eZ#qG#(DB)}o3b@&CF`}0CiD|h7pNdZ(@
z&P-s(=iRGLo$>k}5MDB#gvJ3Dh$B+eL6}u}#uPqSKMtIOlVjk&xjAxr4IKumt)&JW
zLo&lXqXq<dr@QvK!8u<8yE>$|Gt?ky9!3;~VV2?d-3v%UOr3ZO9kdDD97^hISd0n~
z4d?VhZ8H?#?!kRoq^@;aUhZn;_P*0&+kVV8(}+Qc26x#mHzXILbn>f)QNxpEu0q9;
z&bJe-F<Y+ztTkF)8X_We;k&cCFy)Oj7vGS5$|Sgt)8fE~JtZf!KjNM4FLqkC)#y@i
z82pHk9o9K%3`6cDCu|6H0BE7kaB$miAu&!0Aw_xA?j!2E^N-6Hj7#c_5Flyk!+^NW
zSAiQCEPXbbZan598dAq0N<m_kGMXj@w#2T^390f~o0q&rCu9LE20ZkUQ3Q-=q#e{W
zk&4pE31m(o6y~<$ijj_`TeLb8$Xnu_C=V*al{~o#U^##ng;xKpyCo$j+*vBXfe3T?
zt$4j<vVzh;&|~V`mVwFcq~et++Ao4^5WuFxwNCcjR;Dh0HL%iTj}O)rh9L<)=zo>o
zF{sPZ4THsJvGC(#E&|1_2EWF=7m>dtC_XFt)Em)b?*s|yN!ErxAM!>Pi7pLZg7)cV
zYlU|gHMg>!1XdNi^P;~l9gxvtQvsghC&NsKokCPMx{u<)+}vNBtLfw=vmnAqpISc|
zVyl^U8VWTh5*~m|i9U)^v6AODv8VQtm~Sy8I6C#m?YKT>hT-UamAm#~#X+a4hk!^p
zZ+}BD(1>2`>WblAe09yHU#+E%!3TFkf}Zfk8lK)8TN3WMmArBO)m$x$(C~%VU)umA
zN1Lz8s{ZXCm&H88&FASc7dV3F<E!4Uca^rRK|d#1|18m~+-Ew)o4q!FaWV1lt9^7&
z1^oNtkVCl(>6cpvE+!I)mnuc*LiM$O*WP(B%RPRx$SrZ(<%fD7Lk!CHP52E*T!^lM
z?%0A+HSM1Ey`718*Gtb>$8+r(zy>x@t>XV+x^QvS;F<o?=DGA*CzavznT3|hWw!CS
zYIr(v=9hE#I{-ub*MR@^&Ru0YM!8?WjZ@XBf4ngvY4f?>yww5I=*L{s_n}`U<?xqc
z4yTgij&y!ITex4sk1dt0LBIP|-*Rr#QxTu(*(={EeCUWj*|!}#pZ-=n!?-)xR9fG$
z`r)&t@lV1HtfxI0uYU^r0XZum78d84ny^X3c%z7zru+1Vze<|v^3{hW{Z|8;;dWLr
zLKIQ^8DaYbzcg%SK<c}qATjfTHq}IoRRQWTYbFw#wFa?Z`-ZgIA28h}`5ILIVepFl
zeo^jVmOeyqZL;A#r7N7q6!0(BE(rMZGGQwir@t@Gu&Ufm3018bvR^U;;3QLHtg=i@
zLff)u>}2ugPEZ{cOMBq_N?stUm6!ZldJ5GoWPohFX)hfRVfsv-JdY%b^oyecAOg^t
zF;1KTK9vKi7>LJ48WY1X!hRuRu13Fdb6`Qby8XUEo9B92amerVliInKG^G?bmnlYW
zv)%h=?LtYHA9f~pnk1A$=<~oi+!DwI^AGz~egw?T)d2S}mlQoR3tCkJt}zhG@DQV}
z&;BHQmS1>8C+dSY>Y9Q?*<?Jh0D<o$J4od`4m920iHSt(f<r`o8)9r!+^lqU>we!|
zEu(2Q<ah{3aFQrkd=^u;y4NtU)B|xFU8)2qjrzJl#p_e3_U7lKgZ>~^GO=*WNT#3-
zlrfn}WH~qFS^)tmPs)wgVGNW{<j|d^t7m{R8^IgHl>l$4esCDYf=*m+SP<Sl%$*w)
zj-4!Fj|7f%0{NUb6dcG|NCDt)hCQC3D_!i_P4SEds9Z3x(_|jl%-VQ}0w@n*BR5(z
zC%H3P=;C)O0~RU{yG`E5B#^TMGedfuZKq2j0;WUdZKoC@F{>@&1G>goc@^dRbn{VF
zGmTN_4w+*~o<K~{j#bc8vw=^UNy#y(y#Tr6_Qqf7QL`@29Ob`gR?<MatnJ#Vt2a{7
zDcq>tr0Ry96I|xI{<U}qQ|BQ;&ka^kePCCvMG8m@U_u6UY4gP)`bHXZIQeRN&HCoF
zK;EAGO+<?<BP6444O*-?F+UP)4BHHB<X(}4Tu-^w<W&jYaYl%j{GqLYA|>7ae|D<V
zBx`WqF(}YgIO*qVDCew(uuViSJWOQJt9<nXAo<disIL#9xa@8uyciAe(jI4a{z5e1
zi5(0U;R$fF_Y&;!tDjg<52}D3S~rzVu2X5GxZo*#ju%xcMzqtC8~2n~0ik)XvJg7h
zH=jV}YFaEcI)NOjG#QTyIFY7cGC(c6eVww`--{D+6O?sQ3f=M!G=eZ2M%DTWbdSH1
zbr9Cn8^T;rzZ=^7g|9=bf$wOfdw1v-hzIAmgVha%uXu~U4JMu_dixFyZor+ew@Z)g
z5rhMr$I;4k{VqjjQVVKJA}E(`NKIVzT*-aexi+pzd@%e$b$PwyrijX7yiUHm$ea@>
z?#6g<In~$ILa>q0`(h#N0&)VzgqlwuQIaViMvs)Li<1_13BaJ_BT^{v{!ak)4%)d6
zld%4g$u|T)o;#QcU><{#8@KgOPnJ5KSZaR%)7K|*wS8@zfd-GI0tEPO_sogOqg>4$
zCGFs<;oXyRV*_e>%9p$-UiZcqs0n}+k4SOJt;BbnG!ic97se(q0CAi>6Snb13a<>k
z@Yt)G=9a>XQ|Gy*@I}-_H$>5&#AnAr1Zxk2iD78H*cfJ5j2=2CtHpEIFWvQoP{SCK
zn#&91@YSVvI)UG<`hyDyE)Q_vG7W<Qux|pjji%zs!7_LQ*mXHO0iZj^YYHoa2d_bU
zigPDH<Zc+|MmcjF(~Q>$LEB19wkis|?nkbr{3SKyq0K&#n^3djC09HJW6U$^!GZou
zdFrew5C;=Cp+46)AxssKd6jcrm;oqF5@HcM=AOQ-@lR#M9Cp!;a4Wc8ThPmeU%O+k
zw|{J)vP<d9o9LfaEBY_N(AoSBW29<ctpE6_L0kFRObv6Fomznke`0+6QTh~7%~3k%
z|M0?ruQ}TyD>^eCvrBUBC-Ei@HcovjnKE&MyziTgf6q|%bw29=EieX0?%Ln`II+OS
zOyL<C|2&6WzJ3c_+1o#3f21=GR?MH=n)|B#s-s`2i|EBt7NxM@)tqY6^D*uZadp*K
z9Sb7jKucCl^@ldo=x<*XBx2{c`DD&vyZ=`k^PwAG^qkPCvlZx~8i(nT#}tbmO4?7w
zYtWc6l9HviVQB{kOsjzi&zD*Ni2*W-&mau<Xiza7T~JU+x;sbCIU>pdr-kcCc=5%K
zdE*xiPFlDfzcQS7F&jhdzal#K<X+sPs#edMgQPADeI-U@edFn|>)R|0^yzqo??2v-
z_)p{v+?o=9{Q|1Y*IwICj)_2jwS4X;#V!W+FVuw2-in18Z&=xm{NFddf%exQx(a^L
z?20qk3XH7!qI7iO?@h>!&m3>&SoI_P{@;pwR)bYAw}h?y)T7(nDQXjT{_0znhO8)t
zH+CH+&2yJyl+l*jb)qW#!^W{lJBpRLO9+H~v6~Jl>a)AL<-{BY{)kluZ__U(mO!XK
zf@hd+1^Mc$lE&DwIf2VADbt&W{7<%-@up2wrp@XcjDAI^MO@sM?LMcG2Id0OPz%dW
z|60jQyZW9h*p&I47}eqv5|gde2F?|wQ!<J-8UU5=F%@rKWUlVHlou!SX#m3ZH?{CJ
z8TJI&9T@-g<W}bP-%~lo1e+9)0O;h^zg(<=sDBV<j7Nr2@!7h)#ST;Dzpgsj6F3^a
z20(yne&1{YRB*%4FC3G=_JpkaON?QF2c%F2Yo6%%Mm1l=U3Hi20x};Yc6gEw0cL`c
z$4gB69dt7dqF-HFc#H$qA0Et`e6!6S@9}Op^?xz}^5*snxR6v|$a`S{rJ!3z^~upk
zjG6{N+q=uWy~wLQM}hwLO5Yp%!>I(y`FUcLGprw{1l#e76^l4-vnrACIwWfM%Uz6N
zNo9sTGSK3KsSh3=%)_p_7s$q_pjPKbg6%e81F8KGKt6=B#FLMrob3O|1qh86lR$U~
z9JgPyuveThuYS^y9Gd=eaw>ILGEf@kWPa?iB&5qZ%h4}-oJvHBDHBkbN@uu|Hx=v-
z4LMAVSb3&<TaHDn`zFfi)ndU|1kv%_NTme1R0fpH1Bf>e0#5W26K$`irRahYv*LA1
zz#sXmv{Q1n64$VMDzpqzDAlF6Cjg}v6*@I;4TL0Uz59Fncs5Yrju2k;^bkK|aKeyD
z0R!q%3_$z!DKIFi;eA$PfBp}`GA~~Ys!Lmb`Nfd0$6N8b`@e(4N3;b;TK1z`ih@V|
zbYT}(KLa?TSB~azXsjC>_||!=a@T{JI)L?=H!-e@*5kTFjw~_a9T}1}nqGrpKlWp*
z=AxYQyL_>}6FfsmOzLM2ow{`Lh06qJ?(5(cb)1amlHE;Yj+^YhAmM)<Z_z7|Vto^?
z>%wU6G?a-3ya!u8H+cObH12j!F2TVBodWXh=nUxpE_a3L`X;21u9FQrz<3ec=XC$i
zYtW^_4C)O-_=+N@$2qQXj{x*Zl<`Pu3&`ej)}W61fCaaB71D5|TlWMOBhQNX(!KO3
zu)4uzp1XH34`I9B*z|6{1YN$<hhR9Wd=}(KgAQZ^qS#9gU&aMOErusH@mpZxXpGcg
z3Xqo%OTtwlf-M*!4Fr}IP{1<|!$WV<P|l~X)RwnLzxx-BEIc`T<`9%PC*YfU0!lgz
z5kxNr3qDz!c<6MN{m9H=<kc)k{JP#DM}lii-z>g;z9%&ymD6LbG4W>n-QHvalDNZg
z#O_l9t{-I|2qHV(zFMp&fD5o{R#y$?ZB3uzYJU4YHvxHYK<W-vtuQ%l6FKU+@Rjz<
zh#dpKr$3N|F8Y@sg&5tbTY%q(&}WznaOr)3IhiZ~-gVCdO<t@As{ui+n)biMI1yeg
zE;HjMW(MxaioP|gON)Rrz0r=7dQWrHjdWc?hdJ^M0n5#E{qbpDJ1gL+vA^uC2catv
zA-ddO?BWCle$@Iq<n?~Lh0eukWTME@;g+FBpXOzBC*-WUYvY}U*C6=PTut)WXzz$w
z@FLVwP*o|)O@Jh(5<WE!u-7X(Tb&*uus~;JUUIkLche6oLDiUeiZBm#7$Ol6XAqbQ
z38|^PGDuQySX2jTPd4oCCIq^^Ss8hRhqiT0UaySftE+~X@Oul|tD9eNj`V=>jd#32
z*j*|jGM!+QHh4>aB{AraP%Cm5yW~i9c{8o#vQJ}wk!4&TC^Nk^Y6boyQpBxm=+uN9
zFOr(ALP{~pSU^1L1vxfJJIER?45sXA<Q@}*#`c-Kbt5t^-QjuV`wnnG7K3*#)o*d(
zGS7^&2lEGHtdoGy^-Wl*?k{$9OPaYcFet>P`{R~+=dzlwqq|PU!Z*wFyOJ5bE#!}!
zEth{yH-yKJH61wj1LOANY|8fmzw!=eh#cQMw=(X8Ms$Ak^xOg7-+!A**wedUF8uyw
zrsjMS`I|?{OML}o<ExMuwLbsRWE*W!IFoQ!7*II4{?}HWP|;t5omT!q@%$cpH4esR
zNImd&GBWAPq1}$ww>5g?heXZc)GT+?NLIS|-^m7*F<Nw4W9Bf(|C}Hm&n+*p0XShP
z@1?fXo&bM8_ezS3>sWan@gER$f5TGkzM)@KvYukNnGN4~!zlm;z7kQ|V~N`GDE6Ai
zq=J92`$aHV$-Dyk>B-LqN{e9Efm`wU84sLRxAP-@@T#xTpFvwYKk9iyd~88fEI2+u
zS;G1DJqni&*V>@en@drDbpJB&(;C!zC_y%CT!RMw`zmgwY4q&-HP!4p@4tsfVMyuq
zTRFD7$K!4on4hE)Vw<i-lr~2*{XTltaM-_;>6!w@?enCTC+?%cC#8XKno(PWefT))
zs>IaXMOTuktnkZiD{6s+|McfS|L7N6wW6*xfq-6Ob_=*K6I5ULJK`<?A|KW*MFt7~
zlA3xVO$LzXXQ6T@?->=(VxK2Eri;#g>OFJ6ejVwutdVsLWa$Zq{6egDJap<^xC=ZB
zjDdFoRX!(PHv`*1BeEL8JK6a(V&<|ZMAs7t1}Y&~nMhi7=iIF`gaMMrGj`+xqW*OS
z7~cV^(L8o!5$x+J&~Z)BZdFKhH`f#Js#M;^JOI9|$FZMC7CTg2CK0%`&dcm$x)06(
z;fn^ZcEb1s7)nX<>c`sh>i+WEx=JqG<4-08j>H%Y{naCNH6254zFRZV(GG2y9Q`fO
zHLl019vY5_AU){84@G?$fgAn>7SBqX>6QXBN>LQ80w!kMLIycr^@JFe!#>)%;i=f=
zY(*?DmhMYXCCRJqP0fUDHqHy=1vf@5HA|NS2}<;=FQgY<O_S=955h+rCKNYzAJ-~g
zM@Bv4GPgZ>=oX1tw2IFH_X!GqvP5-PsC=Zmm)*)Z`M{EP%S2V=TU3GV+EuxzC1f(s
zefx4$wmXk(fERy;j-`!TrEj?DVm%O8v++(@Hp5|VE<Sj0D2Nq5thnP2t+HP=Ail$s
z(j}|T#56Iy-mFmsq7-0?LNOYGnjpW~;*BdWYm&+`LpG7Ta=20coX6PtF5zuZCXI)=
z3om*g>a(m>Z!VLQ|5WDus`af{SP6XDjX;*T?E~ntSJf7rj9dqOnCZocKFT*nu#4W~
zP2juXO)hAjJZ0AnP{U7N_Nwf0hI9D+aFy~OeCh6P6uC}ceKmJ*onPZgR)9vP1s`Wl
zlb{<Jcf*k9*y{X&|6jZ;7lv!|5It!%Pu8I1UAcIAQ0`c`(ngPW+BlkSPoNGP!>8hP
zTUKX)Z%l2M2Br~I?f@QL{gAY+C<>99nQ3Hz9C_xQbjIM{?d8H871*|S=igXXF9?R;
zEr6<va~CYqC(7u7rge?Runpl4(?ep|3u%F)j1$#~<ilgOcu4>JH-RrUhm_zl)5iu5
zsIF49KIpO@Y$uTM)TBeu?r9=;4MgBY+({(w%YF=DRG^-YwW>LMfSKR~`+S}3|I7xf
zBR=q8MW|t^fD1efFxqXPu<+RcMvii+MuTOu@(|G$aL6%_Kic$KaOsKRaJCV6AJ|Vc
ztJd94GZ$7p1C%t9Al^f%-MQT3|Ij2t4hI&rgT<+xAwk2Sy@T)P1eRG|wY$55Jhqr`
z9FanVG~-~g=n&SXnuy5dCBbrM1Tbq^(VE6YB>lVM74X7eE^*&V5b;X|+S;N~z{3SX
zie)d6{M15+q@5?vAo~|W!8)KDRRGG#9kWFu>-9H4J`8P99P&m~L{|pw$*;7U!;ryX
zf(FhNa31`C*#Odf6zgC$D_A*ek!bc5Z#3Qqs4JZRFn5F%yRXfX%%W4;xat<CDg3?&
zVCj0v8iGJzc>+25?fBc;JpaRV(rbZI(AN<=d?@JGaWA<{#yTjv#yaIUYm;2=vKS+X
z|8Lk<J^qBOqWR)}+&?@AfM~Ms8+#PdCb_|*f)xcBixK<PybM5xw9o8zul3%rC!n=J
z_H3l_^wH|;D(wE;L5T1akib?lK6~j725es@$*+65I*6I>*YvXzP<(~}RaLsujf%xT
zBuo=yvXnX+ioC4Z+6MpDUy67o#hV|$`=b#1EQSY6EEo+tsmO-iW@S>}#S2D*y5fkw
zFuIEWftuZX!*~$(xb}1^0Y$g8C4pEx9rK}+yKF^hF`t+*I9}=B?_t<BKISyH6##zZ
zW&D`+*wS`Ez+H7)>7$+VrflfVr$+7#N8iwD(|D}6&+o0l!TS6Ie_2|2Oz?>&Q6UjB
zaqj3s)sb$L))4#rwV+&w*h`xu0V~IW!<=b2_0>m0xX#GLd%XXiqj%NDy}F%0Uo_cp
z8Kpz3y@s%@35Qc(cE-mk?>#%T?aa9s)>^NI$00WTVlKV_GuK~nV0-g$V5Z&I++R9i
zI3AH1UE2S@|8l>YciN)9eY`sGoTTynyI;$4>jvA6Im=N;$=JVQ@9`%_JA-YFCwdX@
z=WS^>2E&aX^yV$h%(i7`>6*B!Kdk<;-@n`UcIC@yZq($f$&gK!kAn|CSt5Uwr_RU5
zc}!o5y#RdJn+3nn<_b3ub5fkC7iYBc9Uh^RbzeE2bm}VqkEFAYOZwj5|Hmk)R<M>k
zse#n&4B5_7lNE@Fu9J5erfzG;HMC=!H``3|9+QvemdzPx+H8hMA(GoMw=+GdNm@>^
zns?~5nfI88q=-P?q5WQdfB*K_O1b&G->>U+UC-+y^EB=KHz;p7^MeBNlXbz>BQP?0
zuTSfA|N8Z+uz{Co^L)-FMp`*h)@`<FPDR&A0FTHs+jda##kb{o>GN9-eKMznOTO6m
zsDInZsM>e(j{N<;IpptGaoN{kKl`bI5CIMj?+^X=VfIak-3pYkc~R8$guauTv#aM#
z@*Q*Q??fnxZm^)V#B5jJ6GA4J_i{qW!H02Z%jqx6HyLKVl~4Lh@S~HV_rxgHdnD_-
zwuy|}<m%O$*HeDcR5_6-pn#FN17LT1sq;6+#g$TU=RM>4kU2DfJ=)T%$`)Zj$HL5O
zbza-VzE7Un)azP_U0_=U=ReNv|NIPsL&Kgm<7LisFQ=oe%7yHaqNr^1MCk);*5Z~U
z0x&`%FWky_^dXc^>u}yz4VT(B&qW?`(!Yz;>YLDk(T)^0y_J>AOI)`<$8BzPw*87U
zA+6oCM?o#SZUJ#Btt+kwxt}9LFgHQT-8NNZrokblWCb8`X+Ta{e=<--HOur%C#|~R
z6h+_MH_fjhsF%Q03wgt-tWv3CEtwAgHOfi8O9}|OL7vhFxC*4QBlphNL0II)LK-oK
zku1%_SJ^Jkw!*)nsdY{oQ>A#=<G71C!x99>kD>)h9Fd}ENH$4k$0jv4h<fp~p)Uku
zbijwfn!i66NdeQa%Hc{^F#KBYJ3HhUVKR&E`Xhe$wi;Uq7?3m@6iJS(S=0y6AGN-n
z+P0IB>B+yCxf{EW>!0b?!6=nhB%8{?a*u?MJKU?pkL<(v@mF3U_t;9X#VRkY_K9{l
zfa}1RrQO&|Aa<T-9*adG8{T@dLBnbZ04poJ(qLC9ED3K`IXvxx|81?|WKeJJR!tQ|
zFEi0S<Y(2qLuo4|Y&D#B0}zID*nL}i7efBRAer<0|C|t3%6x@ET-I{D;NIRG&GBan
z#5rylQe|O5N(HeYMY2UdSm=Q-RuJ!n)(yHRRbW!p1xr2c*w;pc9B?DX6V`1qS>M*%
zaEq3GUmMW*&^+vELr%zaI_UWR=u_@szS#z8+y&uO{o*k){}g;3aM%FkP#Q$_ZGM~-
za9d#*1UJ~)38xtaJr+MflL|a*kZ&|Z-bva!+<wthHP$0Eb>W7Uu`m}&W?O;NB_L?r
zCPhDzxhc&inb6J6GJ$71ej^Z2#E09+BN!^Hkp1AX>_MN#Qy6#IMNMViURZ|zU|;FV
z8l}aSbR_lzPakztuot2o$&GFo&eVhk?&Pe+q$g|r*KL|Ib)np?JYf}U3F}xzg_A!W
zSCq-ZY=qGQj&+W}#o&;8_kNsz=c&0KtugrN`C%tDbq6OSD2$UqfvpDdTLdG~frN{$
zg#NdV<*f5p5=i&FT8vtMok^m3t^u0E#)fcYXx9MbTzB>h-2UVRKVW^k3Ac8Pz<nge
zFw<4&F3D!P5&zh=BzUA);6!`&fVv}m9IU-J3NDS`HxnXYRli}QTXT};<wDH<k1fa%
zR(f?<P*L_HkCzZ8<AvbRwK{4h@^bdLP_Yz3cn-z`&#%M`2%cV1!ksTfY}xLT+*I{0
zA{IH+WXmD;YQa{VXQ*)BE9ZL=lP0f6Sahbax{9h{rJ?rW6_iX|wwz4peyW+WnRB64
zh@x)l{4jSv0;>n?(D@rtCm0oRLxQ4jM3SK<l!`XBjuie<v57FpI>M(g5}A~t1XT%7
z0PmF;A0BXKbp~O^tX0wmK~nr=GZ`U>ePu@g^dY~kJE0~&hd(T5tZ&*_{{Ig|AocT&
ztf@2g;zLpc|30Ww+e2uapfD^yz4tYoX(hN#zl7&Sck<27Uo0y}B>q;@C@hP+cZh35
z5oVC>cfNH=G`2=zT4ULL8!EM&dVSm4NGWCS-XLaWx;VWTcbNa?zTmR8)1p@h>CMg&
z%~y?v|25dHIAFsx=kRY_xL@<vEn3FO^{Mb1OSlBiv56fo>c{!Ir0Uau`Y+t^<Y;Qs
z_FVRy9SMpYxwtVhZbMrkDg5<+T{-Wi3uiaEq!#=<cp)UUQ9Yo|Dlw!FLDs=v>A&;K
zO+S9ZOXqzknde2m`TC6Fo!~sp+y5zN^j2YMv%Vlbr4hH4yXNRc)@?Iq+HfD5scHeg
z3Eq{RrSjb9qv?s%B<4!D=gflBT<kZkn1gl0eF>j!$yu4MM_GxOPu?w~vqq{`@#cJ@
zbS*-1iO0Tts6F}RCPn%`gP*rN@(`FO2c6bTj?pvV=<)u8=s8X8eaja{qkp?)tyhZ{
z@4ReTJAFa(TzlG~2zTZH&QJLYxpQw7_x-~5z(2GR${%QPr6)M-oa{#vmEL6(ez2-q
zevA>szP6(r^+;sB8((BzeeyuxU*awZf<*uOH|+MU<QC?wzi%tA?(WV+S<Yk|bKAJl
z0doKGo{+yA`{=DLqzmU+_9@)n+@Sf{05|bk>^DjQm}gQ~e>(5pn>IoxY)?t5@H0HK
z#ClJ=sjjoWiBkA&9dz%t^07{%&hz!GZ>f=jdbEQEB6||`yALca2PCqY+bE=Qi9sW>
z^<B!?qX-?8owAq5sF2~7-&QLyI8B!KqnQ?(NxFpEpX(^-;vt-;?I1-mu>l<JVBv4v
zm6MysBEYz}t7}9*Sj^hzIa~?+0Ld2Or&|A+6v|ZTvu{03BPsAF&COa>F)9+{13cwR
z(dwAxz4WodR)h+%jSa;t`Kw3;sbwV7CIR+Rj9sE$>-f<lhR`~tBhzix%W8%nx)^O*
zhRu)}oQbcH*R_3c0x5Dxt^S=s!`c9rL(z2)xRl@YIE$mWb<)a-j6``d0nS6xdq<Y8
zI2&-Ot&qt?YqqktNtbSjFBT<|0zL?$W5D;%NQ^6ue&O_B2sR3PsNC8IUEZD1wmIdA
zil>oH^zzNK9DD$T0wmsT9~b_2fuVXy9lb$b8*#Go(p1Ow-3Opq4AzHWl7b5m6hF*w
zOXxc+dq{F{h8f+P62zsqm85SWgueb6um)-xuPOk3qJ1PYsbQR+p}mNqL%LLLCOS!w
zsCadrNj7%Z8@|>MxghTq+8|B8qcTzskMVLWWQV3H3<;Xcdnsf3S{Dmq@FTNcSWu4Q
zn_RW9)qE8G)k&-6H2re-CQYG#)=Z5ehgpe3A+u_=^ioPAQdpM_=tyxMuJjo4F4_!F
zLrYmK=kQBiiFY3S<VY7hV<RH(hB3@iL0T+wbjc)11U)ei#|SxTrS)$^p73oNH46Yj
z8?8dfCl#r07iFv~?uF#x4p)aUAn(G>Hl~z!?Sffv+V0V0h(YVMl_jIh#DKDpBUg7u
zTV=$cZboP94>A*&NwFy-60D((Ns;eu*zWx_N=A99<iNPmQs6J}<y;cLc&8r8$1e4B
zVt0CX20f;vK6@rZTpW01isRGVjfY#q2~yT-AHwYl;3)HYS(i;ZP>AgjteqAX16Si|
zSe3A)7P~jv>JV2LN0R}VV-MP2;`uTrBaP^U&_-PE$=>EKs){{eUC%n&`-=o|;DPYX
zW2fB3$YoAS5Bx*nIIOod7#T5#T~vAlcI*z<C0Kq&%r=d*o8{1#ly7JoMBE^$dD8V#
zr)$~c+=y7Qf}yfBUKnlh<H8puCHA6k<WwB^wO%3HmOD`A3a%=DtrxyX;Y)ksV%+Oj
zhZ!NbQby>n&8x%Fwp>B!z1+Zr!6Hpo$!VgL5&e3P(2`s<?<(%QPVcm~j#h&aX9o*s
zl2!-%2AUxh+n-q%5m^E6E$of8gN0X=TCeQx$zbK%!tfs;XBCEo|IYugXEdun`x!`;
z=w1zz>E@*bkutk?zTEB^d=3FVv6%#~0vtvR;f-42`n=YwRUY~G_$PrT030-d4Bu?l
z`wzi1-DOig53>J|aTFXh0kFMzZ>N|h`3GTg0VGG5SB+X9yhpNR^8w>P31gi(tpwB9
zBG(trCU}<|W#mBAEL%Sa0)zy^N-qg4;}<nf65!QWmlZ*ZD}skRc0`nDBX?Mf!4AW9
z2lLB?Umtb2iH@u#bU2NXuB!}fuKm|{>RaB&R!)X2PV--;ma|gVUVuJNy?P{rVl~EP
zcMZr~)OqhA3{evNK7!I1-(Xet;;O0K70)gzLz~lx(Pk;h@k$4PM>HizcQ=JGOw1V1
zub*_q#%sM!AAR<m6~Gxy1dEsFGGO`YCo=0KJ76vV@m?xAq7o=!ZT$P}kkLO&T;w1v
zgoR0ep%p$<8GB~6G(EI4#W^4nHeG_E{GJccI!o@9J_xjvfNA+OZ-4=JnD8Q#q$Yl)
zdgXuZL|uEM_u{$p*dZ7zD`pD`!UlBvg7fRUz8}Hw5>xCQHTvD)f$46E|0Jo}_I}sP
z@+LR*KW`}tTS>ZeZEXLqPF?xz71AEyeecSj3fKQ4X<_gpjw=4?Zm#s5H!lBqC?C8F
zA*7ZnyOq!&?@lbc=29C9#E>(6C1;c!Pf)W~V@KFO){9GMW7$W0VLe;{!J>Q|)A(k1
z(b`<hD`Z4d>xv69D|oeuf5Wc5{WMAnVdDrNw|4|sBKI=~5lgjy-`VecIkn0A#XsH>
zjy|)1YWb(G;b6+AY7fsZAJv?^@GL$9`@XKhdF95rVv*q1Rdm0&Om?<)Tl;vr`OZSi
z+K05wJ8#u}?c`kSaNav$?nTa%t#+$@m)-psT<xj0!`ThDALKc2x+BQ^_kZ&rVdL-t
zJoCB5pIrOS^ZKM7hM_*!tN4aAs=;FOVA0o+3L7{(tMpJWKX-^&w=C7`1KV3^DP!h0
zqkr&ItQXCtYET8$!S@N<l0mukiGG5}3ssJ*u6s(W81-Yl2l6Ay1@K***)J+P6N0a!
zladP@l_Prgi$;6zQNV)D`(Vj+6`OGKtmDFBszde^fCFBv&iUJ1BFq7{l246#nka?m
zg$G6%8z^o%GAvykcJJ|OshjbP4Q+!V(6$4`(wMw%jQ4Vmjg-b>k_~(tG$jiht>hB7
z-nGHgJ8)ab1kh2`Cms#=G=vIy^k(>aT5GDqI0=2hO6o}JSR_mjXU9k&>wQLPnd94V
zl{QGvz)e|K$0B-JC5kxj3pN~TC$HP;X^%Mkx%3wp7+nAu2T-o;Y_$I(d&9jmmc*Ri
z#|7<l5hBDu6*wQw{97h2A;7a}bb<i<%e$MvWIMcWAEWQ$g-?Lu(DZSe8WP817chh;
z^j1;Yg4$tr$VKoUO{xsF263sjJP)4Kf4IZ9w(0VU3I}o#`+QSauqd${;V;J3B!^#z
z^&VPwLj=ANa$)~<@UQy|@UWt+u{5<p3c`6<vbnh(CV?|x%|DbL?1kmFV&RD<_N=)t
z+K$kl31hvxdtkViwYQIfspW254WBr@zRPQRNSqDh&H6ta`f@fdFoPuty1~pHqH1yl
zB@K2R<=9Kw2O6r#GD>en5t=$$Q@j5FsSZRpM=k&j#L-sVN7HPl_1y!&iBm94<r+*G
zyryaZ_~ZuS!^g|vmAw>HO9A&Gh5#%C2N=UGszf>8QHC55(}~lw-qWd;XblmNHM(99
zSLZ$e`pv;ML5eHr->-G<9aZHejb#j;78X0A3M^ygq*dkz3zYc7Vv2lD&~(ii&e~By
zpSUbtMrq?g@LZyU4c=6CAO5+ohlv0O2j08?`nEPkk|bk%K)i+YJJ3%P*VGGe_96#n
ziD^`H4`1}}B6a*&M$bwJ_wF3na<WCR#zc3ms8+arAqj#@nKmg}Z+$ze^S2x=;T#qx
zbhzwQR!&E2K=!s9;ny^tRUsOJgGq$e_7`7KG=%Vk#daOY{*7D|`ub!>Zvd?E;IP3r
zCxXJ83R)^gX1B7TqNCfx$Kg4X0^bvwWHa$o@=}bPRK>W`0x*ql9>R};Z%Bmzsf^h5
zM39b#APE4Qvr5xswd;?OznBaT+zBE`e^H9M7Gp~a!@_Zy?6DHUC(AH&t%cf{eiFm8
zI<92G=ZdSuR>6?x1@61wK-L=_mC@qinO>^2&e~R3v$n3Nj6V{UHz641W=wBr2&d!I
zfF%Wjq-SIRV*w0#LnLR^aFPqV;pUH*!7VC^7)Qg9IJW6wEzJt(F}c=h@bTlrtbO5D
zp{RO9d;B;U%Y}=)l^(d0s&m28j@ex|84~$4NgiP|QL|};5`>W(+N;MEm4bs;lQPU)
z?MD1H&*vzOMl%R!_&9M*kErZN-pWY?yXtchht93J9e-Bk1i>}0wuG{KE1>s=cNROY
zO6SWDBq#%rK)#`2ZOC}M6Kg|=^f0xOHQ*#@ilr~t+jhmeoaZG<VHDdFh8(qcz}u>*
z1ZgE9VI=c);k7hs&wxHzE;9C)SQ*{2mby1ZoQrGX34G?TVcfRSmckPrempet>wSBF
zfR8x#(n{|VT*#OUG@IsgUo?}#ILTwbZg8NsE(e7L3XiJtcQzANr?Pu*%a+rC#zDx4
z*%1f`jF*-eni(wjnY^BOt3Q9i287@E@<Mhs&wBs@#0gIlZ#5&vQn?Ik8(Gi`xi%1Q
z{5w$x6O!VQ_l0mA1#@0G&kFnifIPfJeLD>xo`2QH9#fL^A!QR2H}e8va6WOaVKe}j
zrVIRPY@QbpV(%1GDpc|`&b+&;iZ5@K&D|ybd_&PjD(vq4T$=MIf3oRF6^xnwu0s*H
zZ%*BbZ8{&U<SnpXM=M2Nhbwg6<w0c^0=e9@g&meZQS}k2{cpzpkE_ob=$@aCKIRp4
zr2eV5e6u?LW!UG3cJ)?PV*P;nd5ffy5qB3Z_vb~YB={xN^7Y|i@#S&Zf<GPKqCXK;
z550Yz7xmgAH{`Gj|Krtb4xXpyW+<20G?|)tf*k4pOwNn`AyD+V?64>IGxm+&4Uxom
zfB1gw{2M4s(4cU3xB!~W$KNp-|0F3gp9`6~0c!BV&B3&=g$%sjTTdG2+`VP>Uy^98
znb&vg057@7x_wW|G2)jEzjh887j>6ahVS9RG4~(u*GOSo-EDc!q?S|QkO+GI(V10n
zEq%?OFpm5d`9a=TqBhi-f9x0_Z}OA%tzR7SM*A#snmlhTsp2ASLe$jS2Ztr1^d2Zd
z<z$%;-nPB+&|wJ0*Zvd7$<ZE%Woz6psM6=ttZxUVf-NvcU8xNu@^E0M&E4kUIlmIx
zJZ5;-f4yFPbE0hMg0yP0kXQ%XO6}l{&OIgZt8zi#4!2%?l0}PRydcGQ1#Qu1%t7>H
zf?v9YFt!#moGvcnf@6NSsGwj`3k&+3+vRGT9QtZo76g}~H8FrF#s)u<Il@rm@KOD&
zAFb=H(si4%*1^m@ziMi!YvYgPDKMUW;K{uT(w`+g<c(BV$*t?d0u$h26~^Q*hMjh9
z3JYA|13lJu7KIDk+6*(TTn`>e6N#67mo`yYH&NOKSGF4Dy1FUA%?S5k-vh?Md;!=w
z5(GI_&SzTTvddOq(|aN0w+ovt1b5jea-KkrZb9~fuJ_j+hv)U)p#>OFMi+ol1%n_C
z20wLmC$FrnPykeoyJ5kP1zV>wcN0)Sv^rYrn+)IkUgJr`#cL(R2#!5EV9#U-d9UCT
z&AC{}Q^18-0c5~;y|(l4*VX3&*lWIF+w5lClL2dR1-4t5Drf#0LlwD&|HVd7qFJ(8
zKTu0h0}5}#!#?ziv_O?<r!z|kd&YV!N5v*}9<B(CExAlj^dlJLd;>m6T?G#<ldktk
z)prL!H4YXEk9t8&60$R4;p3|{*#?lhf#sQE>#_bJ009Iw@{4o{vIv<XV{SO-n5|ta
zVrxqf)NjP=R{!b>qbd1)$aUg(Hi=4V<196YPB^*gr43+|iz1`J(xnaDtR!dk=U+wf
z>VP0e@lePPHF&ESdAr!=sr*dWg+++~_Ff~JEQojtY9ciH6xq6Sm={Q2!MzISc|m%x
zQgNj4twc+-)euiCE;?&8OH5s!eaUe_VF+u?r|{Qtp6Vqj4De_055sN!(`sOxGGowh
z3}CY~9)DIH>n)}+ccONC8EbPe>$0)1^2C-+P;+Q3*G@`{$LGdY#E$k=KFgko4!2@&
zF5g?UIUCs&>a}gSjv3=~SakOSKyH)3xzq=jk6WbTr5LaY%N?$WdV|;%uq4It^;Mg9
zO3o%pqA(`lsv-!t58!hC*@X{uzMhKPRxuD6L{mtq24Bzwv**luxb&cJ0-CmPu`;b)
z*L`wR3Oo&c_-DEd!Cv;+3}3wqwu&KwbH;9lwVmF+`sV?Gesm7NjA;b>IN$4|j{L+O
z=g0{sF~Ys6Y8wO={}i|8<shI|kY!d}b~l#vyL(8~4-afN*0k<s=`U&pijc~NrS&u$
zDZ#Au@d4fW=;9Tp&LDQthV9R`s|&to1f!B?eZ*nsW=o3<Q>g*{+rwy@$TzM3V=_dX
zy_eTx@leBWmoyfl7PjRl0(FCcQ$!<ko@aV%_jm3Uj#KB9pzFfj;L&3v9N}XbF)px0
zzqs|C)M+$T5`9#ZOJA-`heL$G_1em_-=oK+bN%>><KRdrx5~PgJyM8CV$@9)3IKe8
zL>U|uF{y*@aP1o%xGh=heV`At7AmVKx&hdO*=oIpYtB|vGnoJsV7l)<-l<jzULoA}
zR+qis4)HmCjlAH|n=&wtb-OB7w&T&hMQK@YE_>}ZqJ4$*OVk*77=)-GqLBm_cP0YA
zd0Mk{3CwY4;pUO{Bw<7tF2j02fXc%34G6RrMXWhlrq%DYgE{?Mziv{)5P%_ZUd!C$
z8`NG01wJg=Ry4ah49aiwiYo6c*Vpbr@Wb9;VEd{&{xoD29W$BXUZnT>hKcX+1B_w7
zX+bJHhAd2q%_ZD*B@b_wJCw%YX!?%hwk@O8fxVwt<Qh_PnNk~guEFAP&C%zpwY_p#
zLb2k&r0M;hu70*}z?7bMx4V}@IQ(<jJLf8^_Zx7@Lq^Mcocf>CkItR{vfc8})H+*I
zyeh2ZcNENwo2ORgqXz~A9JKvoP7pTtB?-pNJNL&-XE^jkbRx>rzm5H6s!e+iTk+FJ
zt5P|n@zsLTcRpILmGtb>b(<=HxK}F1J{~?sHJ{60o4H}*!%L!B|M;vaAg%NCbH3S!
zZx}o21?-3L38^J|c2xh-{zIv5FK;fqyo3IHysK>6VB_}Z5nY4WKWN&|IM;-ptfs|Z
zPh2)LcW;?pkNcieFSVK+v@}jM7XK5IahGiSrmn$hIkez|Lj~HwsNos_O3i(R{z)FF
z;@U^74d2D=^=eIixi8J%h`$%|$ldAwMC6<Ck+H^)_OtGNU!bajYuI@3egP@{Za_Yo
zbX(bHo(*w6C-YJY6rWakM3q&`_F)l2Zt867)}xsuXIuH$*Rvfi$q+D8Zobe~`35a&
zYNE8O5}t|>e}EA8hsOz?^Sb`>7l70zf&vS7m(X8w4yKKnDy>sBwQdGDCV_Iy>)xMW
z3~j>rD`CvcQTOL7@eMTe|3c#?=`T}7$&<j(Psna1fK^N6YW$oex21}J>;LZ^Tv+G(
zz?MrH)K>U>kOfcbyJ}zBbd1{^$Uo0xk-&vf3b0At*P_*2J0iu025Jh>Jiy}u4@Cf^
ztDk$oBN9orQ0hJ6V|@Q!&y1dftGUJ|>M07_7K{vI>mevYcC4h7EB}ZYIxC>i9xV&Q
z5V{ifa$|gIW2EeD_YL3Xa5R87S;+!^oNpLAVewl8yOf~wu@0>sp-X!UeG}jzN6Wgm
z->A9)k0rvSWmuawlr{^Fk)_~elO#LKn6APDOT)0#?JmZ0Om*r?R0?v^R^LB7!?50F
zDG+uDh6j=@bE)g^1dVTW0koyY^_AXR{}6$6uFm(2ujeH}GFT|1k&VEMZ!7~+0gjN=
zv&Qk~Ew{CTARB@n{1s4+fN&0jhG}~sVN|hiCA8rcvI9-Nj;(&{h6PxYMNz^c732^*
zkD&OXjG5D>y+HvuF!4!<-w@0Y=jIn(*O+8;?jeQQqq2RwMGlN$@3ue3))PhC4#fEk
zJk8<M<OS;%a*>VP!3)UY8=I;lj|)QOz~X_=J-!>nu?Jc&4~G+oGrT1Xd=*&(k27#9
zp>0{Bto07(NEMI}O{fI(3}z=zP5F+(^*^0GAad!l*Wy#OPK=>H0#@sZeS1W3?}Mf7
zn)c8UE4cpmUw>^R+f0lm)>8>{r1$;?lq8@MJZe||xD@;h*rwfx*AQ!{oQ`P<;~Z*y
z@8Buy^UjRvO)mcA?7rSrhafo73w~8{F6Qsbh9(2li}B0UhTJ}qs$Qz}-wW@A*#&_K
za(Bi^kyJr8gjgMlx5ft?a-qv0-EkesMMBb8&S!kb{R^(Cmts=?0s`;ab4@L=i&>cg
zBOwpW!-^wK!2#(R(GpDl?_<3QMi!?=Ei5L<j;sy|;ltZx!S)N3x$H*^CE;lCyN@1#
z&~3xb&oKBtxd(O)h}9xqwAtRg61Nt3hGIm9!D8VtxPJ(*pNBX|*|qzpEsfiqFrkj(
zbmQ?Z-3fZLwmbAvvKSk7^_Y4vD=*{E)tVu~+EnX7wtMbBHcig4-qBF!QpZAlm{<jC
z3D^l}iq3znGwmg{6#Y=NtAj;I(my@931aKo)a4l0F3y@Z1LTsd0wvF_d2($gE|rjb
zIuExKA^lz!#+|0wTwe@-Tm)O&A6FYwWMjW&FiNbw9QPS~L8;kJGu_HNFMs!VC*F1<
z6VC}NoM%$JHMh%KA}qSaD~Qu{%r-h9S$dOD!to=VM8Smx6glQGXYM1Nx0;X?h6JK3
zTGnOr3XEO=k^tl`(aE;yL0?iu1dsGEugpyvZ24y<FTpDt!`<gl6IuQC4;Rx2xRxr+
z-ciMV?Q+PX$9CG_c_-T+C(rY`gUBWL&|Vqo`$X84J{zri3;t5fE2JuDb}_xz<>_hk
zuxBh1+86P%oQMr`HD3MXJOBs4`>|<p)_?T2^vYAsRf^~7vg<D;h~^xpZ`2?^%WZ}9
ziYGX{u3&Ac*?aFL$(VqQv)V%sFJ7t~`g|oxqJFN1fMBDzbmo)RIiNs5tw2oB&@?Q~
zu>l9Ix+3_qM}#k%>{I6NVo?B2Bx{d7Y<6Gk>8&eg^6XFNkwDy{Lsvpn(=avRZc`YZ
z?F#+@*YcB5)%}ISVu9%eAr#N40F@P$`HaqVF=yEHu~3pjxM!`S&)MZa8n;jB0d7dX
zdFSed3qvp8@8GOW(O*Qr2j`*i?K4`@Kz`~smSWG=Z+S1PP~lrarRfum=<np`4Yo{t
z7{o$6Q$?1=SBUHC@23Q(Hw0Ba>+--asnWNOcYnJ2r+VOYEH1&~(-3pz3P%w%Txq3y
zpgl=h&iO-H5Q?wn{f`>3O*s!kEBS}@BA~Dz?c-XgxplpLrq#w?JV&l$lP5hwUxV#7
zK&}^10EjMz1wr<1@n^pu{*~>SrWT$0S9#uLp-14mS98|5W8k*A)8vnhSKglWEBuq{
z^;b@z2*XiG@mF`<UGfcBII(yAvn3^x@#O&ZocZHy!NrRQcyT|L{%<mBPEb4auZ;FK
z?159eW$Mp=nXNf>?(>Vknt?*~dg88(r)@n~YSDB5U3;hIUxST;YiAP)!h8Q}kIdm*
zD!1L2FetSHlbP&v)Sa|9x1P<k{6v#Gf2`{-Vdcm?G633n6Guv2pr~)I^kTgqSbp;E
zov-k-SZ-x4HuR=-jYEXj{6VC0c#@<DvU@ZoUH6pJD`}>m>K*@!1{C;!-U(;{&ue6K
zUZ9{L`UzHwE;qi*LuJ)HRTO2K^}0Sc%upp0>|t3!l@iuskYvytJr=dTdxg|*aCFPG
zEn(GMZdNOt0e`bLZG{aLg^0_~uG<jC<`op*VK|t96{q)ZgT*yN47LMxbpT?W0Njdg
z%tO2ofh9Ml^Ld*)eE$US0gH2b!9SCiAm|glC@fg?*_azunKU@yAqL<K#vkJS(g#xE
zjV%AZB<jgcBAmL4%vapA2cBTDV@g~Nl5=-c9?k{ztf{xtop=CeCmVoyx+jU{#315Y
z^n><gA;*+5lSb&q)D6MDp;>8tL$~I%c`Rua?L*|yOi@!R3=7Q@<|j^55?*+kkt6?I
zi?%fM3PX|wMI(pcStLkLl-^ZqedSb#A2l-MZR;Lmu$ak@MIM(GE1YSdpfSY9Fn@=w
z6t@OSfEq7kM!;ikmrRMB3S-X>0Hk^2Bzg{C`t+<;T1HD(Z1fB|Qjv*<bJBa19zB26
z*$~uv`-4``JT}f2AZY)ar&??~wsni;wn^tdI+#DHfz4>BF!rcfnrG(Wy_?Ie1YrIk
z$H72sM-bF-vwN#~h-<IT|1Vh0#(3MZ_H~fqV!N&EI#872+Zga_bncN+u;Ln|Jnu;0
z#E(l3HH|1pX}!4!jP$y}!m^+VnIm|iFcOf*HlPyp8P=|Vt;4gqM;D7LV3jJAz3s<;
zg?#I53;rnh*TB)06CS`mEDkAb;+V?w1f}rgia2Z19$!u>*K}tLb#H~Iblv2<yGk@`
z+e(NqRTLVlLAlCoYWA$jw5&1E?yV2!WBwvoApC2+;U;7=w@`F_V040$gJ)4tyq5XX
zKu7?^N*@HEZq24b428{1Pbz1!>=Cziz)Q%hY{x8pbrbnp-Hjl?`FSiTV%(E$>cJ4}
zWL3T+>CuKG*d)`#Fr<f(5&(v<C`9oAF6Zg9TGY!*rxK0>`<}N><$`IG#wm@Sqg!sT
z>m6mbFJaN$MZiIF0l))39e(bGHAxUQOTT|8+REo}o=^?K9qqvk#rNp?EScr}$6qVm
zNP^b#VPnL3N*y`QZ?zB1Q_~+J5oae~Qb8W9>Q&fS{RA8aui55`yje_|4lM}}x>37X
zs1_8JwRsjL>*0r`Q}0+o_8jC6o*1w(jX|~h2;7413w??Pm}r2YWCT-<bR*f=XOa<c
zKX*FKH914Z#_9z_H5M^HObH6VHzF8rIEi@bIei!YVv%{?r7dEU<l<9UMq(2NAhet^
ztY_1AC|pno9?OBWw_7F1aMC!6r%DA*RxYmooxc4=yK+PGoUJqM0prdKxs&1$t-(Kl
zITG%N%x&$E@7Eqm!R=)HssTnlB!W{a9LkbQE!3RqFl%TGIm!Aymp+&(N%TlDOOUm3
zZ_JKEe6vGS0297|R&sqJ)TQ9D)o3h-wyL1unXi!C%)Om+IoW{TZA_M@c&q@~HR`$K
z%u*G3&3xQ)G+QO)e4M|NC4@p5?n=l?JbxBOb)eAZnOP|cTRRUpwP?^aP``X^-`+O-
z+X5H9nSzbh*p#(At97yWZhsKQaM<FU&|FT|E><GFz3`*Nq@zNBX{ZYPw?mBrIjP*N
zQP}C4wK_j6;D15F+3$F6-UROmG2I?<?SiirU7dY=si!~$gR&<eos8`|-(;;<8)|P&
z?$84|kb@5kZFk&M*eg38L5++VTU&`#p9>n7i)PjD@7A2r`bBrttyXs=q%60&xF_AY
zilPm}yf?lqxj#X7H{bk0fdBXv@{#l7^a0_LkUWctpEz6{{^u)1J)-`h?Xf|>E92RH
z+S61C9Fj|AZ>4vY)oWCZycfb*3U|%Oxi@kCLdQQ79x+d(ZRuy#gnzrL$<<cW>~-X9
z7da^2Idc{JuIgsEVsRCAb;iNUEBMV3=vp-G;p%oqq@d;-^J>kGGps|Uzvm@ZoQ<32
zEy|7GPWGV>hjPomagJrHtFWXIDthJ6aToN?jQjQ%rZRK>eA-FYcJ<eWmjLhiOnh})
ziL(fQ{li}!DsN`pe;Q%7=mrwG9o4UOCvcA6in>65?P0FD!{+m^>zP^Y<zI9GdT!IY
zUVQ%Dx?c%LjVL~LBJsh(L;mTj@7Dc>IcrC13FUq=BAjcZ{fyBk#no;OKkpedqzzp>
zjWdg`E1@!u_)f4WxdL~^EWZPBv&u~;t(cW+TYdj^S3%J{zAEJPbr*gx+qQjmm?AaE
zalmLR_fxde5<POgXj-=NF%K2C{rHdIXEHxmV?uD=tXwd(eRF_kj=bt18;h+vvV?SL
z*+d^m-jA8~3IkHf0?NiVNDMZWVab+PNEVPgu_fM%4apLNSX7Gu3$aN46KItVP5a>#
znC$|Q0s#|5D%90Y_GH%?y@7^`a6u8_<%t|lI5W^s8UNolvT+DGG-biONVCEDa{7>L
zJ5m5`Q3uI7NjW^bz(qk!vuTWg7?Bc27xS2a2g&c={=5x;m~ZI9q7;*Y-UF!X^JW`8
z2N)@1=lQc3<e)b!=Gc9Jw<!3(o7`};l@(#*UOGy%l_W{aP}pp(K}69|F=;4CiIXZ2
zasoJBZZDt8Q#q^w2#&A_k$Z!*mJBC&Y&gdWneAx^;R5cFOM*haL@JW<3ek1*KqEoF
z-RSs%y8t5tG@s#VX3!HqPlGlPBNA3&2@ziushO<Y!um<0AF?(l2P|~3u;@JMmP-f5
z0g?=k>rzIDx|&&O4MOqjIAGJJ3u4lmmwki6*qR?;Z?|B9xo!k@f5(nAjm&~Ud5a6q
z6;f&TA-K7T!pvbb%!@F^D#{oHY?K7b4Zw>-F#4W*n3pHK#ybhdP^+ws5It+y1~SCN
z+v?R@nR}ssC#O<UsPFFmbs+a>9tgcwth~fAm7x&)y}gS;K@YPEEk60U7yQLQ6=4M^
zs&<dYR2Tk&ev{_YJ500w;0il30(B@5y<mdVl^0K;n{D23>#fCXPNHVA0qgZd8GCw_
z^e`Vv`XF3V&91q=w=6FK9Ak0=AfC|bfCw@lO0q-(-{%48Fn*HdL@iSHnG~kvj5g5i
zADwI91$RP)25|-6V@Em9?ZHIhuaM(eGs8uf)0Zhcw%T{U@ubz$4P^dPGt@DuUQSbx
z9LaLRtnb9IQ&;%CyzX=pL^)tjfCmAbmn6j!g94D#3-Q1|c{Z2(f%Pdd#0g;0_M^60
zMkoaLt~{u%`2WnfQc!?}!GYw$)jvXvYa2kCGyNBR@G403IawM`Zn_xn2CB1VW5E{=
z>1*&DsRS;bi{WATEvZbcl+gvc{GQcj4GlbETS1GWbi%L_`5YEd^1Z(`CZNa2YEdpF
ztFn!UE0W4%ahq`di!#%MBwyCGAyCi5H5C3wO$kDKXaw)e_zCO*pqxRbNa^8Fk=276
z`XUo&YgkeVM&EbAxphPS`w0+s#bB;TSR3?mPJq4|!7v4ja7W-vcLi~1ETQdeNtUi-
zMpao?9%iB6cajVnMls3|ygJwE9*dF>!2dGa9kL@28sFw6)?jUuK#q7Z+Ogo##_Oi`
z!eJ*pc1-1;{SBt(tPW@NVI~d+c+rI+m7(UmyNaaLpG0_MkUx1Z<;m1;Pert?SOKY=
zu8nZe?R{{~L)fXE0JqiTqUa(VG&JZ6IWnO2wPU&mTYTZRGdiL3`Xux&^Vt42{9D;j
zj1m-kv>U8*z?AF*3|<hq64WE+7AFj#=E&7ykVf&_tRd$Hcbm#*c2@&2Ho%LjDPfpr
zk9TQLP@7qbjw6^{PV;(VM5*Nn)>!V!Or7-~@aXAFhWSs<tlYV62?xvR=5>3TM%-66
zvMlVS?l_I3$DT9n_;+@%9xQXDl%Grztg+_2si#y~JtFPRwbB|>U~7|*^@8H!k_z=7
zFK660@>_sNPNtR$;rr`AaZ_^4|FE81dEeD27%C|g1Nm-r&i<&+hs!No^ZOm6D8wD7
z)*W-TajfTZ;?E@to%3p4MaQlOv7<A0_>q0)YNFw97k(D48aS;#1FjT6I*CT8J$P$t
zqjvqahFTES#V5Z)!g>6!;$jV}QmEjx;|KQ*+*uM?R&qK7K@NYa7qRPa?>4kwh<fwS
zzyq)Kq|Js1%C3A+|Fr4-0Q_4hoPxH^;5rZ-BijPthzOCZ{%=mI(pEKK;P+UZDr_17
z!}}F-vL^4NZQonM=N+5?NI?f^NGf-*<UoD2)wM@wZ7(kbX+Ntdgq2&4m9^{8z@D##
zwD?1|r?}<WQ(i7Xk9P)s7gaee`C_yz@YJ2@<xK>K?ZU8yE3a=t-}}Y-%l^a*1z5~?
z4Ano~RHp93&*q_c?6cak;qME&BhpX3S%Loi{d143&#JCFoIag5`{v<Yiao=^tdAjB
zbo6hB1+0q|B=3K@3W@dbn|<HKuYG-WxZy+T?TM?Kyu0VYt{TNkSGZu{m-bUE5o5j+
zyhxP`Dy}mUM#Sy{xCaAhr?;9W<0vY(uJjhc`SiOIg6N<{k}kwkh5@2+)w?HkO3X0p
z0z+p*fR$5&%pHcQaTu8>aR<(^0a^vTH3pf!I|L_{LpNszgdDJi0q%s|fa{A%n}B;=
z5HxQbI9uRv`MSSYOoyRlq!<%NlMbw*z`M|aK)Hy0&8rhnx`v$tfh2%F7;R;Jo)2C}
z@V`N2kZeD}EWvUM%oXCLFg&NJ3S$e75=>u+VaBN(LKd4uV=yEQ#XH$O0w1C;j2w2I
z#|UTFoE|)a4cVB{Sc0VRj+%ifYQrbB1X>%iS|O0BJ)T{N0=ashs}_zVr{)K+sN4s2
ze+gb&xyP3_o)H_H6j;dwHN&Vo8B*4whp*?iaD|3{y(EZ388R#^nxzAiaB4KpGV5&c
zioT4Q_|6TtS+B?;4d@7#1~AANeQ;Q^jBs{G**&kFC+Q$#8ia90o$=>`!h+F(TTnGc
z&hFv`DJx|j;7Kgkt1@>OV9xIF(&ZWJx~-vf4{?5yW0pQ|Z?O*qYcFIvF=VJ(%1Bpf
zgiCMQj!orn<(F0hcA7(9S^rScwJGzBtTMKVpfO0B;%b^%mp4j71bt_}j<az6thUoU
z%ge%$;L;Xh6$OQ@ixu#SP{r{Aa9qHzMtVn;P<N)Tm2B8m61*71F=fW_xm}UR|6+q9
z{UD9LDZ7sgVqG#}J&`aw=5W6z3c%@OA%YLajsyin91&F$m!UHg#IxNOzE_oaLLE+W
zCN9O^#T8r@ok2SXuI?njN^3PqX1BadbVAkOT>ijkypw)wj5H1lxMT^R=|o#jvw_32
zSAiuY>3lrn{HL9CWksfm(q{0&<_Q$Ov78JiH4I0uU$=!WHAdoWK>9q0pS|Xajjht5
zlt_#b2BeJuDgwdU4f@Fje6_SFA_P+MdyLYhPX#7)7tngpe&LN2bA`*SDt~ufypx)1
ziDu0$!dpT!&1~7<_Mlg`Z*ra57$Gd4Q(3XTNf1-eF~_R6-O6Onks{FapyN!J%T;=a
z@0V)f$MDLAXbAL$#aYK6qjVaxbHm5UAOu?zS5+w;7}Alqi$(Ywip^KZW%r=iBS}U^
zooKA|{zB*@^_nBZc`Q;xRtzJ#DX*2JE<YGSx2GhJL5mDc_IQ?Dl4S+o&6LTMi4t3G
zJ9t@kx>#9G<DfeXAiKD1AQ2EwV%l86l-AJ|33iTPRn{T|@3;C5dWIesTc2<c;fh47
zNq{R_9iCRR(wB~57)?2-maTTwdF@oQQhR@?pZTjxMrPz}q$~=d+6@OQ?U#g*6j)9)
zMgng_@6~w<n7TI7+W^GFuv17kmhSatYK_}NtWW9u(l<QiBe)=M?-^(@J#^T_iIMAJ
zp@v|Gm9_g;HMgbUtxXTT7itBt#S@JG!bkQm0t#=N2mrVFyNpVrHp8=KmvKA3=e8~S
zx~2(yzq=s4S-Uw2cAop&-18<14G^}y02_Xg_M0`YnadrS!myO_!5gFS(?KhmZ=Ade
zoaJRO57L=nd_ymHbA@er7fi`|zs+;QPW0x7@SRY+eTe5ge$*;cwAPCbin!lSCTe}?
z`V&lFa&_#%O@;--NQpnxr7d^Z5iUF|FDIWFkde<k&<6Oa<s%hWJumEee($9uf~%y8
z&OlumVo>s8X1E}$)Y(Z_8wEAu##{(lBd}d*J&2Xl%2`RbJGX)*;q?rL$~fCwOUwat
zufs8jxb@#ah1>wH;8vk!!*iw!_Dl8nP~Ly5a1O`1l&?B;$IX~@Cw7&@O#BT@MsL^u
zJgPW?T&TD~{q8~RD`ZBasjns&_6#*FZ>4=T@XL&HF*I@J%QlPuz0U`;p$vIf^s?^v
z-}m0I6wkyne{PR@h2&pT-pn7US`w|VuTI+Srmdj43&(}aTc0QsMj9%=`G%8S0ySvb
zlJ9u96MiiF|7}J23N3urqNFgkLz9ne>&^e9b@~GQ5vqnL(|<85t<-ZR$p<(9D10Z5
z55~Zctda-T(qO*12h!9M--n!f=Z%52uTbZ=0`xUm#!offAA*cp6TY0hyfQXWg-$QM
zLVPDPdIlS%KA1mhml>!26FqkMjAu?$zvMfIf(p!Kn%&^LwZC=#uCBXtgsog*F}?I1
z$v^z~Y!5qn`aoQ3Sz(r{!nP~8|7K8~=w)l5tN2=>t>H?WEbKBSOBq|dly0gdf+<!i
z^N3{eZV?+yl~_JBU8O2@K^iQIt#!d)pXc>u-wn8hO$Ohb5T?GB9ihK1@`Lq(KhUBu
zxvA3%igd0FC=r4au5VaD(~@{YSZPl4z!j~l3;nP-1$0W}M$9zA#H@TP6MsQaQ+5S_
zp#t>}mTANe%%Z2SLiU{SCak?ftbkAafqQ)PXCpsRGThPNzo2gx;kfW4(q{c!3m#3U
zhpZD<d)X-&`iGeq%jxwZTq)k$mjN`KWKPo+<e;@0Dqg*rG$=H%oy<i-dvBLpj@fRs
zt*EPsx2<SuPzx0ffGBI*3T*w^#e2bj)suLIK;~4zLkFPL05^8)f@wv`aauo!-pbsQ
z=Wq-n%(WDfvx(X}0I`~_Zfk>lYj=mDOthvf`64f`*NV0%y&LR9;~WEgq8D;LmEJ+R
zLKq8)EF7qoAr9XZLam$Ddj_1LMbPsDDPgtWXe!jbE`VcaMP&fP$zb7K0GA2UY|7@}
z)Uqv=v@UP(1I?j^<!)}xg`ufze_<>_?{Mmp$8G~AO(5(jt&DNufvR<C)CMkB%(_&X
znF8Y>gz~2ZsWfJcYr*1W2_i^<hey<b-Ifm(yL{X_Y%*EjgP@GbUg=qSe}AWsD_D7(
z#=&Q|Cpf@UyVBiKaE%D7*GG<XCYuy6HK8L#FSV-c+knFEa!BDG8V{*`HkkQC;h)bc
zd>}Ewd))Y9+Pxe9t}+(9s`7xN7hnIH83UDDmix2&?6JRU{YG1|MoKM?Yv7S%K}7|b
z+SCFWE}D&l;soO4arf~t=g0@;q|jxRI0q`H^rKaTuUP;S>bbP8Ek`#Q?#{!FemwUm
z=mDgMG^J-vGoyrk1b>fhcK~0Km-twy@WWgIu#wG+L<TqkEt+>4oq0&~qxTkIXq(sh
zi$8r%Oz-wm21MBI^&cg1`mXQ&u35%Py&#`6o}drGZ3_n>1yhbek^yqn@u$y=EF(pk
z=i)9FL$m~4)cO~$^_)Nw025Daa(7yHIs6L2MZYeJcR}At`C<xyqA(S-BtfnNx?c5Q
z>VY(M`3o1{u#_{Z{7>MoDI6$ZGlQ^-Bexwfd(*r3*hC6NfG)QlzZg`tPYY*IF>nnL
zG6Ad`6MA-g`#3KonMldDhmalcU+hoA^;G6WOpV=gh9Q90{$zp@s}J_u=~}8RVc-}&
zO4hp@v5GLSx0&BEM5Jr=)cYcbqJ+Bhe7((`O;EVqWRKcGULFtz!K0OuEzrA}2TPlK
z$Mdout%72j_{EbWVB<XR)#XrA{yG%0?fvg->Ak-_SO$=uwGq819}jS=zt5f!vZ3)p
za50kzz$hn(Njy`KBMYCw-qC50Cc$30|7p_LN~kXxN{a`F7J+2(KNHc(Dkx~Zmb@>~
zqt;G+6R5bj8U#Qu&lJvfpatS;6hdMp5)o+tH3GdP7-n6{TD%8sosr9c>~JX6`fDT-
z)Pc7hIR}{_5LgqTF1^F@82~f3je^v{hD|XCt|(NIrusRUrYyG#nF#^jU7<^=$ZTD}
z^8-Y<>jI*H5VE_s5FC4@!`Oh(^;vBFV{=8OKfI_eyFE;@4Hq=GZh^OG)2O~(j-e0n
zzz+9PzU!iAu&M;bp*5KlCdFTUQ+Gl`)b6l81ZosmLSN^KYRRAL0{?-%2?pjF{w$Ue
z<lVXti=Cq8?!E$vpf!D4cHemrzB_%Qt?C)RPfpMu&%5__AxW^=o!f$t&ppg~mL0(V
z-XE$?n^WR0mZU`81g?{OB)qfG!x>X@a8tF{HoY$jUVrRu%~JHEX9J3NGZV2JWW)?7
zGWoW&iQNZj?(V*jj9$}(jEN1q6!=1Cnkw*nT(|C7mXbSlPWZ;!iNs>8-tct5Eu&{W
zuI*B^;I)rg4fQMbhAz0>{Zy<^gmW==X@R`lHT=Gs??~T6ba(mbJ71U@S&BYSJ|8_-
zl}31lEbJ-+vGh%y=ii@cW{B8!)PBJqRM!=@@5uWwHNIogtI7e~ue!x4jSU|B&+B?l
zk+>1aIfH37Lxx3O_u>81eJzW=RCQ0iO$&THe<!uVaZw%cISs`->U$6L)R69TKx^h%
zU!~P*nyTVIPBj*9R%h@~>%7Keiw)a<!2TTl811PmoU49c=kDil+SdHw&F3Wt5Bs*a
z^*l0FpHd;McSk0t%5&<cdC^n2goVi5*(%SOq_LzsM^2Fb0dD;}oxOYa{4n#5`_^Yc
zb@$CqB-aUP;Mbg;8@#Um&jS2XJDXiCA00B;wSM3xmR1Ec3M%qXqp1Y(30BiEq!E+o
z)OkF?IiP%h%S{GoovYF*n{3G#RH|>7vfyweQRIkAYQ;;4a!gaMDh1^UxygHoX%%^q
zwXl)w+j<_lxyrhTF{MIGH4g<kv`y4|ecYh(*+CIw4Hjf(rjrIb6+xn($lP5P5YG8q
zaW9$$pF#(?rDuE1{N-4+Zv~!vh~bfLs2jFt5O&HFoY+q~7(;KL$lN1FM<gbg(V@t1
z9{AW`@q7b?E|?2_&=F~pVs{$h?}?IQ=hRiOi6~a=o7rFnID7{!z5-ujCHf8D=B%3J
z3<>nZi?_17FLbDc4>M64h&$%5ndMgP8@Q$h0Tg*OY-c-7^OE&mda%rCFwcq6vrBM@
zK|KScnO|SjD9CVi4GM37AT>S=Eaf0j!ow(l3y7K_=n{;!3Ie|~rzO|Bdm+00rOwMr
zc@v6I*C3NkXQqc__(H%DD1?Bn(~gv)BItecxBPPqBqPw}lfzu|Axr>2H!kQS-Ek$g
zw2K-EMM4PnE*m7II#^JNPhjmJ+=7&S2eMT<ucwPzr~ZK$lR4*c-}J}MmcoI4fSv;t
zltEHF0L=|QLY;dGg|^5l3^iSx(wKB}T#+cMiqeVY#~>oqm`U-0FbaqtPSEF3VwG+J
zw~W{~fCHE|FI{)iO!P0?MkNvrC0hs3X+d9E4%A1{Nbh55gzB)3WNCJn8JG^rKZ2+u
z8-*L>YS}?ge$G79`s^ET2!#qf$g(>0mHiIq5cZC5EPaH33=FoDV?BUQ-gE)|D{klh
z_v-nxjHV?OABw05v#eAwySAbIN7!r7mFOEhn1z)OTXvE?K*GfKnf2^hz`|RnO`2q^
zluE6)=V%KgZ>Ft$Qs6V_P@3M&pVmmqXS)+6)(HS}U~32w1|J`WS!UM`1~2PL=*<%)
z%bJy8C;c{~H7LdP0WGd(>p9j4R_4rd4&czW0|1!FP<ze2|J&WWBT@r1n&s`oKh<p8
zijZ2n7iD&jbb9~7tY!NYTLA8FO(@6&eYOV*oav-SW(+%?4#M-i7)Y;}17JO6;)l)U
zU4NuXA}{eFE|r%hnq^XyG!H>dPad#iQJw)fHL7|1{5my7>-Pb!G-fD*Pc6%dJqqjG
z2<Nz(9~n7+P~4qIm`>`Lu_$2C2>Wx-?av|f1b!hIzP1v&3bDGzv9npN2j4w(Y+cX(
zQP#z5P^BCdj?MZHalJs@0_eYVZ$om$diXU40e}`rXtywytpu<fU61-kE$6%icR<`0
z;%e|3O!)W?;L;!)K3*W%5VhqFp64DHC2eFx0GI%Y54Zs0Xk!_3Cgf)kE<Hq?Bir8=
zI%OkDcqG|kYqHU|{Wu(>mMq^pX=TBPO_9&Z%*xa@ml||K#vl`tK%Nf0mq;yLDS@T4
zS%zBh0SKUzLc0@nUi)c-Y1ASZ;Db5~KHy`kuq!>!?gn@RwTCo*f?;eMfhvS6eWb`|
zH)Roa#yGoH%BErmQ=}kA&f6$QHNlI=x;)Q2nGR1I+JonnxD4!wv?)A*u{PS7b(sh1
zK0p@}y1e~(_TFdk>|u({6;%3OnKzs0OQw}GPatqSQ9Cu*T8gP1VDZq8^8r?SLixu~
zZb~FDpr758L<W5XrYpskcQe%OTK}@549aO_JrTNI`P3ix3V}h@_I)NSCxNylV}dRr
zfF7dVh+1ZAM@Y6Q=UP4#H!i}LrL2Jh2mukKhw*3}3$R_T&*sa`D=Wb0cg;QHfeQ*l
zVy0t{yh2X(ncsh#uZShDD$q*>eviu5!;FLVH}n&_#V=)bod@W|FMqu6_@!|W4nFM1
zj*sh~-y67+nx8j(LB8qGyHCyMJ$}xvAzdHHTN18)rhoGE&wu`=DchZpl+ir%=VULc
zG%L~J)yY%;Nxk9l_2SMa4(3S^+m(}}EQ4s^Gv;^sKbx5EoXps!3qI%?f?|0$Z!SZ@
z_&Ep(6=WBH5PeIud%644ewN3NW__^c2e2%rku{U&Gv0CQTj0H{IBo+4AG9b(vDtRo
zJ#;{iqg;*sSL7_^!RpX}GzN1$o>#y@Q=)1{<eMW-mB$d@Q__b|KJEIb=hV7~K_IQ=
zwdK>Zx4UyW|GI@fDSI+>>SygfeYSkK@~m6839tnYqjUU^{u+!ti@MIdo8SBE^>xnA
zpM5K_6=wBUJUko<T~NTMxhGAkkSt>{GXGAuuCR_<`Gy|;H8{_qLjydtUMO0+&w--$
zRA{Ae)X8~}jJTYtTnsByg6Q$b4%{(Dwy;=s$aXFjTIcos`B5>Gp~ZKX{(M6T&2M5i
zu#)?^^KHh({GzR?GikFywrb&c1+H|9M`Vl+?%iSrFXW|#;`xngk@Y@8(Jcy}`x_G$
zQF~5bqyRpp)+j`q^&u+@eWi#R7L++z{h4+aU)^zS0AJ688{lQhX452m&5VK~#eIWz
z2=0VO^OC5D!%zxTV!)o#IpKk<3p-^4+-Dp8IP^6OK1!YLtFzrO;N&<cwDfkErWmF!
z8*ZHu&?!zcbShWLybZhUBP@4=7x@37L7nXez3G#%@$QDO;6a79and5q<*c2sYhHz8
zwu}3$)_Go7ys;WzZ7YW5%eKzmF32jd-M4dwA?v|ElL-iGK-<x~*si|SPX>j}Kp`+L
z@`AzK;|5gKaY!FPIS;!TzTaX|uIpU1l`A9*DOx>xJgdMYB?2nz`c4y&m7FZvwD#p=
zr0<}Gbu3xh#EW0e(Vifs)d4{n7DqcKx!zEQ(ti<4a+PcbI~xO9$L7*xa3o+dp!-n`
zSUHKn{UscH+aTYb3adqeIuAZ8n}{(%!yIf_v^BoLJ+!`Ab5{l~Q^kkqJg?UZ;*L*^
zBiW*|l1w%|7}%BArZCUX6ww}L&ZR=q<IElLjeuy8h_Y&V!LW^;V+~6%A~UsK+g$#_
zvxa*Os=90<%ZfrsZN>HQDy{<`Au~z{U7qSGa5m9q{m#2JPvv9zMO>(KgJ%rnpv8)q
zOht}k6-pBFtikfKDv1C;tSGXUZ0q4rl%gF~*ew@dtFY4c8GY?M?BjK+JQ747hPZyb
zTsPxFP*~{DMat=eWH~vPvF;JFo<Z3<x#KQyfxv^D>yoU3NW27ZfGoKRXIYe(_0TQd
z*aPIdN;N>nwFm^<gP%en(mdq9yLLiZL^dq2#!Rvm=nsazp@S|NJ<a;#o$xswZU{-K
zaM3^nkT7PE%ACh7R8a!B?Z3g$fdS0m+dvN%+!$c<Cv74dB}uTtdJ5edhFy8wz%A-?
z-b=aX3<5uy<J3NTb_zkzm${7&D)*cFI{npjOH4cpZ~|zkS0Gq@BI(<M*7V`y%O)wb
zs-E6$?=@W7u@npm<6GYgrfxzp2KG`rGlpTNHa$%1dVllxoqwE9qf38TNs%NGRO*|L
zBp44!j{mhRB+Fb93Amyc^Zf8}SQ`i*7K+hOuT?pqJk@{~-^_{!i`I+z#t;GzHGoUC
zXM@?gxZqhNv2-j{2m5D<=9rWrFmQ>~6|C)ewp>Py`p5ZnF8c)yDvCV_DK-kwuWer&
z0RB+2WD5XF>sSYoSwEbW?*DOg_VG;b?;js4>vXhrN+)VF9i3SBqHJcy=^GLgtJ67-
zgHk7)b7barvJa`8BMpa+(u`t8=SZEyiL#Iwg=rI=a@#N?x0~i>oZsd5=Q+oDJfiu0
z-tX&ry`E1e`!dX=Hz67MY!E~<G^%$%Y*Hx|jmbzkqt`y|v=CL0#%%XaY#L6$4ba_!
z+K}&{zT?t6=`xj8su!?qx&-M|0trcA&&y*aPO`)|euuCg7H|z;Qjr_B{o2SK0m`y5
zBvPB_Z?804OJ(T>vHjRA4lwRHkgDzKD&35dT4cyFc`*c%EA>~vyQYB?jXwb-r~pW|
zXQ#Eu*)wp!JNzIDJX;8|3An^Vu5sZju!E$gB7u%qUiHx?89xIMW>oYfAhY2T8L~tY
zJ+gq@8xq6Kf~xae4t1?ZLN`878wCBTF$UO-d9jn;XqTQ42G?J>7t7h=saQ6Lu(slD
zW^NBDp1iz;M#)E8@V(j67ai5ZiS_66p18yP8!r3D<Jh_r!`n0XKjgS-D6QM>fMu^Y
zT0mWB_cRipn5nsL7`0WhJ+Kr2rSE1{kftZZMHHWHY@APa%ebi}MtKRWeOo8Hv&(u9
z%DRz1GKVH}hA-3%Rp~uuRt2e-e3wT<zf1Bv_})I0fBNB2MV#rww4JQPy0R_P+rWR9
z#=~^myjq!*-oE%wcg1+O^R8w%B&JnW5y!4`9{tKQ)tW7JmRVkm|BFlKJt2K?e`G4g
zbP9n|>|7HOztc%`Z_8#~OpzdWL0&a$BbUETF#fkY7F=MSe!=7N2`r!OHJzkhyZ)wl
zL69||1!GLzt13e9SgJ%;oQa&Nzwov|k?y>X<IKa{3bAe+@MDS6G|x?6t8&Q1%6Uwm
z&sFQ!8u!qD`qh>VoTnL?gqpuMLZ4D>6!>8Y!g%VkuVtKVJ?(3+I*sH+_ayY6N0&x+
z=8bL~k{oOb?hD5v38zl~n6^92?tIEA^f}gp_|>k~BOwRhTXjL|1xabWj`J(XWbWPn
zuhi|ANHnkF3uUx!ZTbdWHCUiy+Bn)m<F`l1V4GsDAK=+_BrTi>oSgj-;_s=wasX!T
zZeH4Cqo;gcRsnu62UdyNWSeOK7blg7cuBv-<{y>-`)FZHK%*TmORa-ifR~04+_PYs
zl~e{2P=O0V7=iBb(u>2dor7cFij4Hq;iCiH0f>x3cp`HVT((IwK>tuU8gSxa?F!8a
zcwoc{EKv&dZaWzlxv@7K*E}!#Y{i;@$sf+V2VXKO4q6d5zN_(JYN?Cf8@p6)Yw9nG
zAU+s5L5gXfk9(DN`wjq{A^U>R->Qzv=fIy3DKa1&!fH@_b*)e-%YOJi^*XdAQHJap
z8C$SKff1C&#49Ln2ADMtFL>#`4|ZWnIaCP1$QTAVAjuu5K3+d;PkfgBa7>nt#$wQ=
zXz1Tc4<CCI0m+j|+3hxXqcizYa214*fL`_QqcH&BMn0|0C*D*81qO@&(3^A!<-h{6
zH+$L$)f;Bu0bU+Lu+?~PA}qb)AX|6?7(jY#fkss3c0n6!gA#2AE{0u%Nl$Mk-Zbtw
zhX+VG+)04BK;w~_cH~*9EgrfXw+2~ooB&=A9JXm3%}QP`FJe|mJH_ij43*RQ8jAUZ
zT#sbH)&|Eun+7dU-z0S3Xm;L$dV(6}AbT)I1Iw^s0Wguj55~C(XkE7_qY4CM^Bkyy
z32rt}@zFx_-xrw9Q3`lZ{{&{?RyDS~dcix&e#<J7#KI;C$`DH~ZV;U?NY{hc3S-HG
z`ViJGDF|af#RwIcDGebv_k(%zIQG<?eDuSC63P+@68W9!n#_!63&-`R%VD^Xenkl^
zz32?+ewU(%3TK9=(fKl)DEp5^dT*A3sn}rZ(!jB?nMH4uQc#X7$)6>1vLbYr>p9`U
zP*ic5Hg)j<BLI-z<GC=K0~*RB4&ocnVSf6H^@2Bmo->PrEVeJTRTk>&o_4?nx8}xP
zYo3SkPz;dVuyeJ*C}%%O5R<q+zf4+5lSJLTte|<i(ZzL>&em|H#t%G>D6}#F2yVlC
zp2$dSbp8S(OPWO`h(!IQgaYznQRdu}rO_~ZqHxv4YP35llJ15$!6nNBwFsuDHXH<h
zz?PXyvmEaeT0+esda+#p^cx6YMuYoXAc9Q;MZ(o2cnK)xDG=1qBvWX1G9c7c6>aMd
zcy$!syGN{Y0>KK+f%p}9RpbcO>p#?Psawle3scr<(4>tjL|=h%u9bRr+!1RGk?d#$
zZYD+3;HQ}aqZf*qI-PTYtv+r&Gh^q?4~WP|r-rYl(xZpRJ<!86tAF?|=93XBN7Tw_
zh(BS&ez2}XY<nKAivwu@b!k`7g6YYWLK8LJ&Eq<bIAxjz#6P!SbDjs7BeM+sBpI?q
zKF<J%^2z2?!VeCUJuv?soM6y`|3lSxRk*0b!>l~Fe*nkB5t|*x6wnD+j;mp)vY7Y8
zZO!rsXv5y;umO@tqQ8LMrjH(G3Z^Y+K{=7Z@#ZH`mV%6X57@~Jl~W=Zi?qIg+dj-c
zz(x<W?&|5LLh}?j=u|3&`#>lPeHq{b>_|r%`Tb!WP}|`*x;S(s+h6P{M(Gy3O_Rsm
zxT--zL1TI#8vfMDr{VJ~?^v1;uXLifFf@h?nokC_nre%eKcA12MJ={=CK#rg;@mu6
zWJS-{_ypTS9p)4YsO_l+)4W@gF2<g>!u_(Z*Tigb+_soBL?eNV_R6+Vgwu|C8*6qZ
zU2n2kXQ^1%RJ5Q`xq+<;_VeA!9QrRzPj8YVm7|5j4JhLZ9>Qe+#@uidS)#UEc><nV
zj)+^yrZ^k97QP6i=Yn8sIoN-)qRnX~R>@O>8-D&zI!-J}3HPdViDnTcTMmSJHt(h8
z3{9rJ+=oU)9Mye0kBME`Pw7u?3s@;X{Gwj+U-FQk(FYX{=8f;FAAQw*>aQOyv`kb?
z_m7PiU0oJD?Z-okv(f}QSC`u*8>&CheteO)>@YkSul5tZKfE~Za{ti&;pzu)lWeKk
zH=Q#sdLXL$LW4h%`?%xB_Q(>KF7cr?G;Vq4VrlId!hk1Z2NA4Cog+0nXEzZ|vp!1h
z6tT-^g1!o{)0P-T3>SQ`J5fM?q7-}WXv+iaot46ZulBoLko36wVol7c+rf3I(_y=0
z8kXAWWqjRn3A@wgrwf<QY7{xM9_BmNaQ)q8T8(fT`;5F@Le4)~*w@O+rJW{*nssF2
zUM%9$yXlS3Qp0^0#$pD@H6uSJ4f<zS97BIge~qnx5n{-%^w;pKaf2gR{l7<Bz9dwY
zoSKX*z8Xd@!8jfLHEsEz%A1`5csH;WYdsm|?a<1IA5A|mKnza=-aC<yN-RCFdh(r+
z9Jl2{DY3q5uH^2D6*8LwfE-LqjT;ivzt6Ay`O!8A55VOyqhWs_Zwq{v`XQ(ETx5K1
za_J5i`u-6QR4S-25~>H;y{WqTQi9`quxezXs=YD<MQOFOHi3e>30R0J?ZZRtj0(<F
zb4W~Lbt99|gX8rCN$HUg)ti=Jrt%dQaFnE9ju<-%A@V~AQX7oB09l6C9nO||@lb_1
zoLgTCQbU<~rGzvM(K(#orBp*hj@oG)*yCnxu_AWmOfb09p!v<Pg2CY&<k64mEHWHX
z<`z5B1vNfa&4aUrA7YJA`te8b^GQjv8wmDlHpb!#*m$TMI0M6ZeNhBaHb4TR5l=7m
zL8wJ*MCh(k0w@PRk>Gh*mHo$K%!i1a>^XRiqHO2>&LIQ8tUvIP@+fZ&G@+u6pd$s*
zgbFbJSSXwt0g&DbNe!aaaDpBvQ!^L4dF6_}9LBAM<7n<rSh`)bL+%nOj+bjW+YhJO
z%ed@eqg)6wi5!rgU=;jN6R@mWBh%c+UUSP4BKws`+(<B`N0yymP(riRBRAmtFW%(=
z7Vg#<Y;UQ^CbYf!Xfxq)N|YUFTH5v1<vK}8q0SQY)V%n|?c0s<VL=jf4n=Ypz-Rgg
z;*K9m;JK{RmQcAil~jM8CIMtEuwolj_aZ!s5U#OK9gvA(L7N~Y8h#Etj#^wPLRY>e
z(}G2Cfd<=2aw$ZMiKS%ipm+3`(`2g|4ua<Nq1%Q)mTgotuMC?|jQR|D#lCX|@*&tG
z?MPTZYcJ~u2);80cz!*W>-E(8cJN5-It3)2V04S}>NE33Vvtayf|?h7oXk{h{+V;u
zeUu_~HD8vI3eW$KBf-B=6eaHyVqnmGgaAYR5ER^nN(oP9$B**tm`@^&z6p#|eyV-q
z{c*Ho{eC1CAbI^K)=(j)N*I9@kd#(pc-~~RN7X$(dF)L*0C_Ce%e9ZO<*ZSdHET<{
zjkC>=rP09kvqt#Su{08VKX4JiCa_@l+IT8y(v7oYJu@u4V<M3gS-1*u;8^(h`)h;Q
zAknM|&00e>E%zo?bG^Dsjr2-+6r%t|K190BMV>xfgIBeqJJ-K6lQ6{bpgE3LbQabs
z(%u(f*h{_T&us$V2~GUMa6T;J2V~DSJa%(gDY%+q09@KQ(L-A9y_C7E-$Pn`nQ$so
z#*54O%F}(VRo%iX)-Q0}X3ohQ5ACBj2!bog;}DejG}XJZVG{P)!|6){fPBNi%CBZ0
zeGf_19#I6+3C1{RCz@$EciBe*$$(WyvvL}Ri2%k>S&AOz<RDJ%VW3G%1LM|;nrv#)
znak`d-Rts`rYM0HbGl)#Gvu6iVCyB*(*V)B+fS0<fnLk?T{a3BH-QWECxgn4b}$5#
z`FQ>2`2s_@Vry?oGB^-(G2s8F@)o5QflUp@O9}<S%5f4-J}_KK^L&;&w<VMtDlV~p
zhOBF&e6Tcr?~o;z-+Lw442LXDD8Mq<Il$}4hNtx9Mc~#iMuO)e$1g0FW-ZH!`rzje
zlX#--<T~p|AZb(<j~#6{bs6y1)6u94GIl~Zcb2R+fi=lC1}Crry>Z&;@;`Q;F@Bmq
z&%1jw4l1ReVy21tg_ODl?~Mq+NE!%*Cd>PL^y}WV+wJSjoQ702e4JtAT2SNVF%eGv
zC|oHqT6taokum+?s>ngeU3c?S9EsO0>~$T<kjGCOfQ?A4AKm9P+*d@b%VV;eaqtN?
z78#H3tgiakTPf<ib9*9j+%>4Ns;z6Ry~`>tx2&tAHA0I}-p*T;hHDGc%EP&;yF&%i
z$h6tb1YFCJn3`YHHv3O>{WWGxik40b1b3?gpI`pDnrOT5cdO4HC}3neoYOXODq?>`
zB!fEK>{T)SdF;Dbso5hRH5@$BO1RpEw;!%Pmxdo%Ea1(WjoNh_Yd?{cuR5^?L7wHj
zX<FFg?}xy|8tOd8$l42djfe#X7lv&Ffm8^`Z-;T$ntF-JCKJ`$LjRJn!(ZNB_<<|S
zvs!$udTcjs@ClJzc2JH|k1xdc&Z-tHDUU1&_qKmdJLTN?GxzlKlcO9))RBq1)ip<m
zqfZ%YHo^1!J@(eB6Mw;b0(4b)-lfN5?y<;^^`|UEVQ{RdKK0#?%lGj-wzr|&9}J2+
zy}D}L&MdX%meiApQGW-x+wC(ib+eLqKD%RFJJ?Z>&e0UEg2J}CGm#(R<E3Q+9h?$+
zZSFN{pfA%?BD=+_UOqA1RXpaNSUW?C!-|8&k`|J4jB@1_Xf{5p5%CJlApe;fKQU`I
zDZBcGle}1DsID!p!{a`NICYI!I#N>sb==S=v^H-W@8omu-o!3%oGm2a{IYVBU)Xu4
ztvGP{s#z|faQNpMMdLH1(3x*u@aE+nA=Y>Pmath4+Cuym&&D+A<jUJD!5U0wWGN?_
zyF|Ji2}@@^Hqv0qUwa{d#bDN|Koic`U%l3IV59>?y}%WN8zYbuJE}EBmtvK3*GZ!=
z<;?iauHCBD%sdTJ8(pO+lGGUHw;ISlc>)}uWDLUYJb09W>c_DkONtY$q(^<d)#^w^
zZ_=Em02pbgq%sBY$p|Et8nUGbBdV+=2<5kA=e>LaH?ZK<HXwm2mucU@eULgMBbx!z
z7*$6I(gQY(%T_yEKTGAO0J8%lt|Mw3PVEBAenA$nOhh)=n(O<@Aa}hZVRKa-e3P(Y
zz+RW7<^i{@Y)ASm-N!Esd6roPXhy=-_>}>qB?Uf#$Y!`hz~fd=S-NTll&D&KG|Y#g
zJ_%(UCpdEiBaN9lQo_Y*7%<vHuP^QPKbBIO$2L@BeO)1?Ie$Xx3~S1$amVK$ILDD>
zfu`_c6_|OX^resh;&YC-pyL+&g@+%Aq0vaFUUp}e(gKo&*)<RfF<q^{J^}%sHxzA1
zkSTkXS*nkvTOZ}YFd=slT30=GOk;lkd64x^_T~y4M)I9zVDFSAsB!a!c6p)Ai>+<o
z%~Rx1^X>zW-Kn?GNw-IqY5qlaWj`bX_wcnv`U0S3Ko&Po#h^W%-QfW72>p%At2(0n
zAjkL^TO%YQ^>Xp&#uK)YHk~W}toUG7S7K)(%(st%%_!*urSJop7Uva)dyx%2qog#y
ztO0=?)6uNw_x^}Umq01(t)|~XDiIA3*I>q>G7!P@O*L#O1WwYp<uHYhvWXfcg+(Pc
z=!Gdj<+S~*u8~K7Z0FU@ew(m$sW%RJwe(6599y>_L)I^fEg!V6Y@h2h_^;+5a|xm5
zw-B+Rtf;JxQ0acT4clNEy@eW1(*3M@ml6t|*Q95f@iE6M3JkB~xP#Jvz=-Mi6Z=US
zCwi+VOhIic>`|_i;)k{<yKqbT70c0B8~o1%j_lK4Fy=fBXNpvh6tCQi<Bn5*y`o5z
zWugHKpZl(YP_xDHmI(&P?Cuu}0}mb|1K+%1*QW3<u*gCOem*|#M0LPLNvQ=Svp**^
zC6Fn!ViRdd=0h-k)po-g|MO3O?b8SeoRs4Qf+KkS7$Dl`UfE|Vnmq0Zjg<hU*bJ*I
z-6t~2O-B4yiYM@KTR$kToDZvU-*R5WD2M3V=DgkU!DQm|^8BR<xaHzMYlDAjsH@ND
zOlpr*x!h^kCV^Nqls}<T7|P%XjE{2!Vsd`K(Q%ba;4>v{1a{R4c)o3*V>>?-^p6X(
zVB(CFx=|H849CE%aU!oCcv?jW*X{f??)F2am=43K3msZGIx8(oF<T#hEE4p&p}b@I
zd6h-Kb%)0tKk&&sbPu&@djul1aEJbXs11wz3kh~G%-**62V4)uk5kh1!^ngq`<3XW
zw|>z)7vFYvrj`!x&wz`fJB8Z=g_wMmJ1k^0`FGe&Lr=A(+a$=O-7HXb1Eaas?X2pl
z-j17kZFF8LY^W*!YSVfOKXePSE}P)PNQIigb{BA#y@A6imhvw^XD6UBcB`3g8{$4w
z%|Bm(Hd3ag>m@e8snlHw|0xhM0?9%%3xU%-iGhNtlT5GXIk|WTu)23P_X{{VB~}oV
zLY}x526ls~^FBn4CR){>rT<t|Wp691`f>R;UHwFkNsxNn-_%2T-_vax*>K)Eaj9|A
zul0|-?w<I#u9Ugd=~(rDDD=taAajgK9hx;9@85rL*k$RbT%_}qaPAtVL!EdPK+>_d
z;Dz|BUHruBe?0>!6Rvjq+|ncbLcXLSJN@c&9&E16S3upBB`8W)b^$vUW`rV92(vHm
zy*)DyYw2iVA5p?I<!q=zX^JHS-aG7Po0swODhrPyy^qDx68tHV3iWwKfB%{4m+q^2
zoFo{T_?UB}*?fZP+lPXZyZvj(v_Cq^^A8=7xNI7>+i&uymKd>icAe$A-;t#l$)?>c
zlYgR?`urU4|Ml)dCehFM6zTM(j44*-@{QN;&_l2(H%L*YLU5o{Xsk$*6_`j)ii+nw
zX=8_06&MpZCz8l?pVSC^scWTl!1WXMGx)*DbpICdGys|{L|=_I4X(H8=ELO2!o2hV
zW;$_2Jn-(3&v8!?2MPM!{`{t$id_<Nak5vlC`szqu_is<Q6Upp%`EM-YG-y$2v(!0
zL(-nm@*0H)965i}pYA@BusOfMg4Jqb9}gkAr@;x;YV}&*sc@`yZw?iB9S`Rhj|0>+
z&0I*8^M*6?vIpr`Fpn@o)IO2PFwfT3FYDH*t!Y-}djzT%<Ruu}6sw>Dse^rD2+A{i
z)j73GnbFODLzx0HGT0?mOnn%~J5c2uV-J8uO@ScB4+gj#{{i?%j9at`JW}-8(C51a
z8Yfh|qJfGrA2MRS17QpVI?^E;4QS3)8IOi+qG2wppSr-)Buz%rg5zVBk=;z^XyuPw
z8<e60xCJ2yC6o@H+$?}pQYL^4O$)Yq)?W(KDZmMcyj-YHrwe2}K;bBXNeaI7O9q^M
zz&Zou*xsyy8eqX4?u3lparouDzJp>Po&Rw#e$=b0cr-{4!wn)p3xyo56q|=Rqf}s$
zqG4?K$XSqq8jov(u~1=x@}HioRbFE@z}3HU_zJiYsJxjjYGngnA%X^Bm>u)svl$>`
zEYnn2tM&*HFxCkqE4j*XMg9bN0;=qNx)NrmJE%1mo*Zq&b;1w+>Pp(lNP|WT@n-;@
zF&P0Dbz4(vI|8fIBk=nl-V=PKzG~rB_mrJCy6*p}r2ziq1tShwTqFK@QOGLe!FUob
zl!R38hd)D<%Kc3AxC=KI>Xkn9<VQXRn28)lxSjU`yBic7mg}p}!j9+Rf{ayDL>5ZK
z`WveXuD_H{!F-eMc45F3!@7!J>ea}3tQ_1)l}j1&1-J=$DM25|1P>GHb?8Fh{G^SO
zLTQ6U^A;@pW#L2d%jFk^w@bI_f}Qs}6o9l$F<U?*0rCUJ4Co9GRIZdZB7LypPhTvL
zfSI`QCmp~rRk8pex^-FYJ)PNn2fl`&qI7o)$}9V!5@|P_fQ=dEDTQYCNTjZ$@5Y){
z1f2g952g9w<gva-KJ+JWx`8wmJF~7J-yb%*Fvg=Tct4oHh)#Y4SUgW-n7S0y+}#6W
z#QjpgbrufELSpYgnj2FNV~Dm_v+q+dTuOsc?JH+vx-BO?V@B8WhYcANok!e>L-d2T
z8&`iZ1qUiOTpJQQexjZqKh0PtA7j2aWfk<9RF-9mYq8VZTYL&(;NV(iw1v>qa>8>S
z(g9ODQMLQL=H*EjMd^%D-valW5utHRPo})o_5n57?Eu-hka|rjCgDxjnGpBvP%I5-
zucIqj8T{G8x^9QlX+n&Nk@#`@e(36<LSrV6rF}%M0RNwaY6<VgmRG{QKt9P7+nwMk
z;BZ)OnluvJ*U+1uf?@5iBzV})C9ea5P$X;vI>PLZqiJ^2ZqckJ;vPDhR%~{$x&j5f
zNF|7|XRK0U@lgvojz;LZR<udpEkNEMStW?EsnkwFndTW}*zlT(V1PPyE0GH7T$-D6
zeh{M`k_@In6V+QVyJHC?-_w$Op!VTpmniroX-KfW>FQkx=Xrfs2$Gg~Rn2qB9(i5}
ztF3n_sPdB=QuBXS3>Y_o7HLwX4Rm9vL3zDSN$}Lqi5_}7H=O%MBgOxan#yxwuv~*K
z*biNWrp+!*5x)N%a!P2~D2E}hp<i@f=_(#KOU59#ZX@rh6S7k59=%|XxkA(z(7<#u
z4BXQ*nib%&bhOVH64C43F~jCIJ$;W?nMQlFc-`%*s(_*A4g-ncDis8s^KOE1<!HYw
z^{276(bJT7Kq7Qd!Ic5XZyr)<pKw(wwk8*`MVCR2cTkDP=3d_sqb*93aLbePO9Ba*
znd-bJCxwgGC7jz;s*}Ug-*wtT>n($Mz0k3^0n<`2A$mmGS`21d%-;9b=`v@?He1Z4
z70BGjszI!HS3~tt+2GmpFGH>TTK~)(@`b!%^>@!NZ;VXf4h)z7de;G&Hu-WE!R0OX
z>}vgP*<t9}e<+hOSe(z7J;rXSR?hVeDOvZMemZ}!cwqLRnbfH6-I%BD-p%w$Uxm=N
za-alG=2c^|%T~9>pgcAKhz&t9Pm_Dy3d5c)+30Z5-)!+&!6qAI?9|Zm-tsl0<qvu<
z+AC07G)u;)ZT69E>tY3&%TE!rvxl3?7&50F#PpBF=|6G)xt4dR?+Vef%v<))@|el!
zu9q6G=ieW2@tGy;n%MVb?e9)KZ_q>kJ5Up6AHVC*e}GnCO51hgA#wYr*Wbl=DDn%<
z{}<tzrGb(~kM9XbRvRa(1ar9V|K(FPZ-vIvuZvxr>Pn0hc-#}$|0Qij()@0Gp&dLC
zXdJlQ6%sDM&_>g5nJvhlEKPvNDOViq2nv#0=8a&-q5{OFoq+*cr&Usee&8b4XqrE3
zRO{R@Pi1yYH!W|8+8(ng#wi)AhMs1<x?TVvOo$NIMmyY1#ba+3t{UV8ceABaGSu=W
z$PQu>0hXrgL8!+ap}m~|K3*$mZRGg?d_G98eqt7a20V-pEvDenO6&rDx(hO{e)be(
zU!<+I_=V%vfEQx`F2Vvv*GZ;XtcA5SyNE*FsR|T+;iFIqv4~7r_8b73w>GXO$G>Vd
z8$o(S`0>ShQ`jkTq6+MJ(2j~2M~(pr6Sc-(*E6zgRZHJvqO5U)vpYPM8#6~OG3ZCV
zLIvS56GfJCFF^?+MiRozg|+0XzEU&7JMp$QIySh2->-K3<lUum5jD=+kf#wRL)GYf
zhrH%;n8WN2>~xoi6E*|`BGd)y<BtWHXs6D+IXN3v^Z2k}D@1Kdl_yU_1RCe&&gbEL
zP!4{OhZIz5Rv3-4=~fu|%8yF%YojPIw2NTFD-mQh|IfzqI-+0652gE%l{rv$sKkfU
z*J8qE$6QQIgrFm~7<ikwu1<mtb{uQn_d_lH1{&hudMv)Izdww=Givj0<Zb_2N*w}+
z;k~x0YssqCeeZ(-`S`&hAZS$}yl%0*S$zZW3U_MsgzC$rGX-+GP!<7yh#QSe%-wgP
zF-e=Y4(Mkf1Et&HfQUy?+^F>dDh$@DH~svN-U@I}LD=x{SNQW2DTn(qI&<ez-1Se1
z-1h2wL3tcDfHrzkBs6P3mIXI61>6^^#+t{D!u1amxUvuP*ul{i!Kv>r;MghzxWh-)
zKSMHJ%m%V5dq&-xV9c)8iB+-9tz?CTpaZP30AF{O_<F&l(*&Cv<^$+g$UvHx`7jh2
zF2)4Xei|u3k!tuuCI)R5U8oxC%*{+}K+KHoBER5cUP6|{6Sk7j;;@0#*sH!`;duKj
zlpRe;sJv$|YMHQ$5Y{y<fQgYP+^iQDKLDP_;g3FHsyXj~b1}5w{PhYpWGgze5=>&@
zukI<#I}9fl>udCRQDvBkS4m=qTHeWv0<H5hTEd}j2_wMq>Gl``GYtJCttVQDdHAL;
z!h3dkqxK18uh;Zz?(+6i-lyy}IMclY(`KFL^Vi?0X}zUkDwYL(j1zs36?*oK1Gi`F
zVeQO~zz5%+Vo@bty}}LQRT-YLDx1f2OEpn+FnDha(W*Gi<|N~$D|slyQD^v>_Q}`!
zzW1G7RlR?1AIn2#ugiqBuTC7Q7ud~;lIJ;TZq45=UwB&C%J{1Y!TBVA`gzgy_1%Er
zBh@|iQm>Wb)cYn^(_0jiB;`!W(5{=}CxW}#VNl(@cUr2=hL8Gb^~Gnx=l9PHPv96G
z`D$&$iM}r7xXKM5ItHfT>#mP7ejj=)uN!2)y?50Fk0i~=AH~~s%-m@CR!Vr>zNV)`
zQ>?cTA=0-7SnO%_M%Lq8;0gZnnY1N%v_4Gb8ofC+8dmPwqVvO}oL2%DzpOv0X&=@B
zaj%nCFX#w3Uor+?gW02=hV=BA%)6-@k7i1Y46z_xzig;6s#L)cs3+fGeRO=?Y|+9D
zLK@WN2Y`A^me_q-A_}>HpY{Z@&i?QamvH-wlAOcL^h4S)FQU)x0}gEML)Qa(gMpDy
zl{!5x;XucqyjD!36e=)7Mj!C_Ennea3xcwy$K5Cr6i#<$m9<C&P)m(2^ft+;K8=la
z=%{*;c8mLwWF_tK*^epfl@gGk%KEMp95aDCZgZn<{)y~!vazuu$8jI4sc`$xjg&$u
zgs+Q;@#Uy~=QXwFk@%11rM3=Bsw(<EoBN+{x5$)U@UfnmB}NrswC6LM;FJ7m?PB@;
z&o^6`56`v|pY>T4X`&QD3}w_VC;C&Y6r)X=Jd>GQbAA7BIH%l>DrBBJwb)^ZjrzFQ
zq0qW?-tN1j^7!&E$P!ugJ*Ut@%KIW8hsAaLOCjw1^Etr5JPaj|&3}xT^aYBjt{i-}
z-ydn7|0ZB&S5^n^<=!<TL3=IoU|DIc8Cn;U_e;~vea@2HPx@zGkMGjNRe1j<UwbNM
zgxn2DLr-t+tx>{3zgoHML-!N!YS(?`ytpjhQaw4>2S|eNvs#9#%s|alf^kcY@VjBA
zl9l|5VK)`XL4)J8oORVkL-)B*bac#<hG7)lWJ`Ub4S>V7<(9*OuCL)ZPkb+E#?K*-
zTbx-cOHkic<=zz^cJBWQMf;=0=FY7%&jgia-mfmDA-g9mgoii6)OO(KDtkqeU!D-!
z{z>gDKmP*s&2X19R(^Mi;@^lHj#|W>)Bap_u;aU>2JOL@-^9Op8aUU*ypVfM8uGjO
z5!S<4T8LL_8Ex@(<Oq4(J2iB~F1px+ED^e{sSmF(HYc|6t$AC;+YWfO0~VYdN%TpD
zC%*)l0;sU}`f0xDDIqx$o^QQ}uyM=;)ojtR?Iv}D%$nqi{qb^HR)ilT=*!=dY8R^-
z$mfF;;{RDy>Ix=03LH8nTn9QpcV4HQEkb|bFsJC%a5jAs->YFmXaNgIfnQ-wff8il
zCv>n<b36J>msJZG>nP!DQ8e(N<CuDV35Cn(rb6jMq0|ROBil^$;CxQg<9M3Fe_p}W
z&NmgJmF&zH%les>^BkEnsV;w2leCu>$Gmzd!dG!WSa0jo_mEK&zymnA4Ln%&S5?jq
zU=T`{B|rp{=p@S&kZq8t1S17T<-%?P*)sgr@+a`7;vhW)svAtu(a(-E1{2k$D;Ja*
zxb?6E*JO}e!?@9RQcb}U<xoCRKU9<fEz_*?QC5za{vf5f%Bji1oImZ%4TNW?C3<)a
z+A104GTeKpJ+Lpu=!*50Mke2tn%PGe*eeVY2$C_6W%F5~j@o`yk%A%*20)SjEpod%
z%ufCv>ayC=u&zg25{JzVTK<f&Y`QYjbtss8)%Hrp$6z3pG1G1)Ay`UY&P9t1$L*n%
zZCZWY3<8OKxKZWufOnF2++kdgWe^2&+gwuP5L9AnI2aa6RW}kGqbT#SmJA$yC)U@;
zy7a<S@jM||*B?fzMwI#RMld@h(~cc$<EkU`BXk}p3m9y=#|Jam;QW)=LwoK5H%UlL
z5KdIDWu{i3V0e}Uqbs_PSE{W4eDPvAs;y`BHat`UY8qr&V40RdW*C0bk`OQL<B$1E
z1CE%X6{p^*(!E%m5AJZ?`<tK4@u2CAE5##<0`7?_EiE{K&#DzF1nbO3V<ugckj%2(
z2bL$PU)Ih3X}3?5D~P&Q3z)M+YvE<6<Q@535B7}27g=f9CBTB+I_6euQRY`(GqtfZ
zZIT56ijz=kr_|Yp)u)gpPO!Z+ss%^(Q7BpXuSBLtf*xQ(JLIo9$gBtwS&g2u^iNey
zg>>hFIZh6ZD<08<^wauxX*R$X0SQUXN@{d@(k2S8g@!k>$+RXK%%3J0_$J_)nL;rh
zPSxB=V3nVRV^qlDaTk_+V!=y#hV8i4>OnZ5ryM#&lW2(#9Nl1F9VpL$e)+QMeRhqR
z7Ad%wcM}HHQRCX6g6qW;)e%(e2G3gRJCoVrKexZE9`5Jexcukyy=<9)kTA;WDt><v
z$e8VazRX;d&uzK&1I52L@24)i?OR>i{(Z;XUD~*Ye%;e@o_GC+t;v($Oxc|nqlQ9e
zoR0SG=T9t-Y43T3=@Ab^3}=(vej5FH@Ct%%8E^gOSiz0?+oj=u*i9_9$^{{j{Ph&T
zktVP5DSp*i`exqYT;tAX-8(i9`?pn2Tg@Xem6B3MChK`}spqzkKd7s752f{LOMXAs
zv^4B+wQ5uDUr0Q2&r6otR^i<r^amjzn|ID9CL>l^5w40ja6meq`1RL==O;gE3j2MK
zKO;^{UaH|z2fI~1cdB!P@10N8XNN`Kc9{!Z{<b;k@jw?Cz8ul7dqf!f@(15C`{AN*
zogJoBGNJrjNlxOz#g3`&M=jhNIons+wph)U{4Xh}USl$Rr?%pYxzoHJs3516GO^^B
zrdj=COQYEvs;&jhP>iZf@E`9z0e1}|GMIO1?aj8FzxJ)xNRf8o*}bb<yOKKdDmT6>
z^+;}U^K@gx7HioZfktR)Z$Vb{b~*&aBklJcc9*^Y+qc2MUy{;Y>#TaDEnJn*0`N}K
zmqL?S^HPtL%8BOzOx8@Xg0djfKLBAr=}T?#gLU-=6fj)3E#3PnT$1F0fN=h6LSsK?
z?T?WooQ_Ig>=B!^kgo|%tlIZCUDm0iN*=DDpihs2!~6G?s?Ej_9I9R7bQH3CZzn;d
z_rZjtOAFWQ=$jLT7fa<y9%hj3%`!~I-Og8eQ0k}Pd8`+Bwa}c0KJmb0sTTv7<wJsU
zeE&dBx-uH*VHwC*d!zXosq(7_VpA`c_r?^OrP~2&h4?HJj3};g5h@Q&e>?i>hg74&
zre?*X`@sjIMTC;PhW6R~PxOGJ7hdUAuJ*!1MDAFIqy>2KZyM+^>XQ~D2GosTGpst6
zH+hF%ue+;ol~kGkc-GY5$E*(HpEG$9VdQ3)L4@6kghwm28`OgGm%l1=>gXy8dSYYF
zwEqU;?<0c&C1pQ!elip4p#6%n>Ak?5{-va~edFxCU+>xzpRcZYe@-&>$e>yi-nu+p
z<~Xglb#~*Edxxz2xP<}#p=!QQf7ABeZ)HcIAhl1wfbh8h=XPg1^<n-DhNc3gfTblv
z34&2C<Q+W8@{2Av%r2a0PgItfJIwmV?|kk*R?x4xxBWu|KlULmE6m#OPT~2BG`qFx
zb=$cMeZ1~2(MbJG47oV{*63RY#UNCzXLiXWTE-s@27Xcf(z$WZ@`$o#$nUmLVP#n6
zxYM<J@=tUui`{+7^TKj*cuiE*HN)k}%<m7@APW@(oD)`?v#A(H#eSGVRIJqyVh)<w
za}R#`xq*ZKt*4MHdR*~UO>FEY%VpDG)UrawASU~jzj|HbJb6<<zO&(2MtOuN^<uZ+
z#u|w`H)~ckcXC6s6MR+ujG$uuC<UlMI-rHDIh@SJF}?SaRbFXN<5}Ju_Pd<3ZxBRe
zUTQfm8FDez6o5J{VRPkTO)fR{W6?+RklEp^2s{9>v~cC3&||z!a~D<?S2wYM$BF{%
zo7b|<t>uUv=wu&ehZ^cpV@Kyw0xYF9aAyr#?FlXM>S$Q+Az=Pd&uy_&4iSQJZWzYZ
zgv|h;+|?{>HtC;53iC0B!#u>z>H5Fj5bcOGLPdNi=Lcx=H98Uo=D^}EV5p1+S5G$!
z2?j?{`&hGuN}H$EvT0t2@2V!rg|@6fOrnQ`9syG7!>uTCV2)pJwVWDZ^g$;Et%OC=
zimS*QwL)=Lgh57_`pAvGses7H3K-PDFbLt<c`GvHLOcr`&!a(=_bp5o#U)gH#<4^R
zrVJLaIQ?r^8mE8npA|xPY|`%t9Q!y4PK^UllB<rBfjhm{Fs~H7ai-upcmp$<Kn`Zv
z8=L=CVA5;>T3$h(rE#K))ao#f7YkC80u2ie<jz(dP_+Rc5c2tcgcOI%(trwLu$_aY
z!Wyn|0C;N?fN7^rE$>`qVO*3D`#zhvzh9<>MguDE2Jr@IQ34(7$()3Zsi{hk;@pA9
zz%=|)pAGMZ#AEaq*{08Ux{b#G7KXYIdN;F1(VLrCxkN&3^|V1n`Iq9)s$K9{?z9jE
z5T6mm4nzv7;5B1FU8g3$1cPXNa99-I3horV*N%j=7aV3hc~X}5##>Rk-vmZyE|4l>
zw;GQ%wUJO^Cjld-Gf(lKTMwb6+B^F<@|SJ6G!-;)jy7UwB?<iV`D3897L`I!L#*l!
z{0~*;y2@;TJn6B#P14C{3q*);g;^nGbR?TV;&K2$y&VA;#g>k?vMlhT%6Os-XNrI6
z{`E_*nxG>AnBO=+yt3+4vKtAoo_28yo}3jKp4C;iJDSb(kicUz!W}6jHZ+aB<sZO#
z9jpC;N&!~PI<sLO)cWzDDT}w%!-ZD9=XEE|$&-6VAb;s%o&gTS*;*TDbWZ>VF7=1Z
z+}7Dby_xG(dl=+*y6@xUt^lL)dj>atL1||yTlYPLOlBNaUE*y-pMV`0)e+(^cN6R_
z(7R*d6uOR@(F+`dn`Ph3*VWhxO{mVa_~4kgeLgE4nL9kJE8w5&9tx-(-%yiVI}o)S
z2d3qO=FY>JYC-N!r(FT>1GVCvd0+o@o^12s;-wpxhK90u7dyx64j$;n8YtwQf5r4@
zZx^?DkT-(*d(6dh{<^S|jBX*=bv$ETo|pET983~lN)vYq{yIdL9^7m0ZFlh2p|VMC
z#m?5|r8$*vdse^hgR9DWcgvw63F6~h;B6OqbKKWzjJbRAifJ5oM->Z7SCebri@xI}
zwHg;>RapOVEZexHVCs*f5eMjTZ>zqnoIf>8puWDG8_s2S3hOp+`JHN1g&~TGxr|3^
zSZ%v_-_H5cr%ztykJF#(M)B)T20q+)f3x<QOt@i+e$j5B%k&X0L(O|yaSjPhdzoDv
z(Yh({&kgzx(__7Y?Y{A&!@rFUo3K+q(n4gweGjueVR!Cc(H#4cC?tk8N<Nrs;hWZr
zYb)Bg7u7T0QTh2j^HT`sim;cWtoY&A6NB?fWr3a>*3}Om+`F1oa2SCAZ+7&{j`)Rq
z{P~*RhNIQ18z*M>ep#{^&F(_xg6F^QVV!t1!%vdsR<jyBEjzA#TSt#B-OFL0jK)Lz
zeO=RFL<x)Jns;5iZr|2#hVS$wP=xDREj}yRpv(Z9p0wpa9MgKHq^WQ>?Z{p)HTFY|
zTQELyd8a!JANFzvZnEDB@7~|H)x|>S>{O@f%xm13RV1iki#?KAdC0R^JkzzGIoIak
zFP0i5M{AGlNDe=QkD!Ivv%4xh1hK1FM-v~Fv|4P)`elE345l*^os*3oh7Q9O#TfH+
z_ch`NnQ8K>_}-Aixo~fCXSZvFr@MbiabH(^UTmL~*j%Kw$G^X}x{?1g1ue7|kPnhf
zyk_`v7K}{p)>k4ehH@<Tbdom*kjo!Sf`T)6oBnFN$A}Ge>G?x6Vt0~M_nc3B;`%ps
zY}qH=?v#1)XUWF&814OkKH%v-gORAH=0>ikTX0qyrSs@Jc6;uh<Z(aJ`$Lqf7a9X`
z!8c!j)-z+rKa~=b;lCM8bNa)zT)MXFmmUA1lC;MCr%*LW{Jb*uzS_Urbn0AHPfq{T
zv-8Hp81>5A+td5F^AYO7_4b0`@bH*>4}5PsJWJK6yattGm|u$mDwpHG&YVm8;+CL0
zvVi{La$=gaYK&RG{Mf<M_qDHJ=X3k+XXHgi>49(GsSf`_`LIh~4rk|rR9iPSVHYJK
z;QY^=&<uqCzxd>XyK!H?dic+~Axs9`zm?kW9i}FGt81Jsey;JmB&HstZ~w+3-;8@>
z6=5lHD>F&^V^PwQum6qkkE^4eQ!p2NR0H(KX&Ks(Z#KIenNQ~20Nu*+L485xK}$NM
zwa^v>PniJM;t(jii}_szAc?mWjLPv>1NIyf=AV(piDOMFPXeY@w<B?ber&&7(o2@W
z%we2CST1iqoAju&(0|NJDe^f<j}vGvyF1K{$siC`oDIw$`D0U2nbC94yeu{t>fBN{
zCNZRpb^Et(|7lWgltk_i{Pb8Ngg^UPm5S7~kTVaWCZYWipw~5#<3G@RPUWsa2AAHV
zqNjK|j#tJEs{#KL1SQLSR#ENu`Ds{<Br3p-EiSkPt=23s#lZz8bRU0dso`pc0Hc7~
z2`!k<ff%Sw0y7m$qSOs?Z8+={YNUxMZ2kE?Kw}U$>>&5^%BwGmIbLBKdBH34^_$8v
zjxRs*Za+-AeLfjRGR2mo4otUx(EM>`?7Vn<T!^35TvR?9C=1s*vm#Y)E`-&`*Tk`V
z`D>PkY$BDk;F#`MpbHESwo}7{F`>DnHx$2e6cR1a=q^GI<L*uN2!~lUA5@uyF&Aj6
z$Bo32*0(&?+w_F^-n-ct$QMK?D)yi(=73SR7MW&9+|LVb@mSB^y9&d&wVr_1?@JtW
z2?b3&DA8ooOE5NN^(L;PdHR*#G+hdwvsd?K&LzVx-2%W2#^^2~wFWd-7^B)yvVDqG
z?O=om2ar~XL!mvnmSot#^OsGt0*8rij<%_<08aRs#49NUwH2d(Eg{(+nPQK_-c#si
z{ixIiC@uL0X^(q?pr1emjby;!lBJ#)iVAcv=EByKzkqAJ`Dr63s?a>Ct8|~Sj^sL@
zyhm%Pmw<<Kcx;`jOAWjifV)j?L3vJwyVwK{*~=Dm<xzCE0PEpyGL01T@?yC-8%)6r
zQunGlsT&1(8%v|gpWuYH51MU!4S2e>0JAeK4><qG2MhjkG$O8#6d|?1gOGr&xbHD%
z?bmwroo;&6r$dl7`+qBdIgfgrJH~#O0>?EotVD?aX)#Nj?EmCww_NY?S;$4j;c{{l
zGh26X13Padz`W&jXZD=4hq3a`m=h8C0>&*U){OdXDn75&;sQ`-%iK_**iK+E!gD~k
z<C3d{P^_Vn5}=QR^P#+0o_@lt*@?nW1%HFm>z31heR8pUd2Qb9x!?j36DX*ket?#f
z&l&}M%FY6ghn?7JVFH^BInOo{*inx#HXrn%E9o`o{gGhz>PP~@h{kD)KXAQVVVd81
zEbYeAs|j16NO=Sb&;0nHLd+H1Q!+7HNKb`6hkLjK{MkRvl!>nqZEkjslId5_qQkP>
zMobZ@5TeW9L~ou^c}%!K5gR5@S!>^4tQ_GSXD1IKJE>qd55o)cIM?)yiH{Fgp522w
z#Lk#MfmHUZ-x+m>$ND(#pHL>cger_?C?j@qPbYveHUfFC96wHsn`EYFhTxE<HUwv#
z1$?Ue-~2FNvn3P<S^3YpfJo_k>wE1oVbp7P-o7@wg|$VWynw6U62;~N^{<(hcgyN{
zrxIDea_RioxAud&dJ|!Hcn|AX*8RYrk-b=#mNn8+#v^nDA}0JO`1)tjuz5;YMnavm
z!+VHGk^iYHo6Ho!7hr~3>P4mD&D)x(51G4LP!6ZfLn$S!J?^8O>>EpC5q}&DUyMyB
z7XA3!cgd1o-H~sOC47@+P2Y1k(d|y>9%+*UOS8$YXYYD|!!`Kkv;oT1C&mxC1ULQA
z=#H7s?-4lNhWr|#``=}{S-*;=?TVoJG$r%T@r=bz-MV8%L4R1^-$=r{S&w;t;_NU-
zx8UArF0C_exjxoe^j(2u($kCi;rgb)k_}-s)tkPkRAy*@%snQ2xBMXfZEooLzm_#=
zEN|7Dij!O4L3#Zr=A-*A789Lh<d!SC#Ujrq_nZasKonso;lS&|?zXM<TfVPNQb!%k
z8(#NP8+*`<`<>EAd@JN!YrRc>cwy*4S2|{xKpL3$^MLQ}96wK%O&Ra~<HFXoUKL}V
zWPsUp%4)9*+M<+_#<+nUfDq(JINeU*rN)5?j`*vl2;I7G+7^FC2rl_;{~AjOB>I&q
zo7{JaPL1*=mG^t^^kie-{TQ2ov$~#=7-?v3ag$=GWQe%G8+SXSGhOdtr3h+YD!9wT
zfulPZ&GYOjZu+?g*IQx`^$#L;V@b@WNZ(w1zC9qKNb!5g{>lqtFa|S^WnHYdYE~R%
z1X%5*raX02<P9MA{?=2oyv}s+ID>@W!Z70S=&_lX($c8xwbm9s!}|*8;vt7gA$3zr
zEcdTlDT<-x&&PqkYy3%ya#Am;dA2O(^_iuPT4!-=Ypk>QLMCfwLm2nQ(RD5JqVNA%
z8d^T%yTSQL*oE_IV)xT%!H@4Mp3oXcVqGRT`cnVZ&4j`H?fy--=M?^D<pJ<s^P>HI
zsgN3{{=VKPoV8x1I(fEy-gALG8uvB7u7!2gc2&~W;evCSQEP2wk3UwB=_8VvduhRo
z&A4oxL)JvfFog@#+|JvXl@X=N@~vqTS=@?~rQgxRqD2wAZYAg>yw@S!|Dg)+G&Q=E
zlHWByDWV`HUtDssTPG@Ru=4#-{@a0E+!tbN7yGv}OR?IrgR+dIBa0$cE5|uAJpi=T
zhS4;CSGo-pa^Ns=*R6i$<EEhnhp6xPX^*Y^ZWj@Iz6$4R_5VIYGkAVIJrzOS{~f(p
z(I2tt<(tobnOokX+GY`QvHpHcNkEXkgSS(OOYb7m_y=h#0M~AiEp|1lybpxM;CVMJ
z7qB<<1=i!<=*c!qea{KG8jhfo$CISf%sT(uIiH-Z)eIM6k|blt4dWt9jQHV4^W8J~
z8X8Hl^)c>=SK4E{NI*#lS7oAGU13xvm*o>X3o%8XES68Ks-5X^(1wKR>`nyQU#u4*
z)D_=I<p$+2KE)k4Z8m{0`17Nc{1QulLZ6WB>t@tMrAH0IJAQDMkz4W$vbCl&l0cQ=
zl{JT*p*UY^GKh!;LB`_8Iex)3yJe$-5xcdkEGWjOwN>x4hb6mf5(-lDv?btNN?El}
zgzFMpwqYO)N4zbzw1@f}Qk9Rv_p{!ng25gi0GWLjWM@x~QWn~w<tpIkiCv5#pRE58
z519BIvNXicTAS>Ha(XvpQ$0b4F$oXDI@V?hea|>~js5$~>o3(?=+{IXm_j`Av0l+q
zXJn1Z5?5}Dd(mQekgE&LQ`HO|35qJdC~S=_GR>^g77|K&l8x@`%`>4LXf~z=!>Z+a
zWbLdFohA`er-bPAXl&LRjGJ#HuzxdC{OItCMorGWN`&$B1Vo!HC;Im2v7oo&J)O~+
z*S!=}3-9gfK)A(MYi10VSFCMG5Co8z^X0DnGn|gg#LfiD7^B}M@fTz{#2r67>1_&}
z^~@>wn=o9#x7)9c!mi$70F6vfPvH&>kpvciGL;LN!0`&$2&IT7>0w!3TKW>nYUX2+
zK6l;GcV+N>G}Y-!47fifbzVd96%ZVNz6}lfQ)Y`x9;j^?!J79_GL+@MW*nV#h94;a
zB5^ii<cU0v&w(GX`JGl<Opaf8w_XMS!-Dh*iC!=kf5DO0{GtO|Rv7#rQTEt!{7|g0
z!A2R)giSp3oM&x5gpntmSEIJ6fIW`thag&>*3*q@Dh}>mH4B5w!-8@6sY*kv>INeq
z26h54?6!sqBR#dL2dNRL$jJUJj&DWqs&j!_rvFWEJo|=UxfynUFcpyOvCWzW;<IkR
zdPTu3fSoolc7!^|5o9HtKYeR8kcxd+i&e@pqugwzsiu};)g>nGdnw_pfm4&jVj|}h
zs((21x@c(JEe3s~;ISM<ph!D;G!i0iD$@1YzTl4U2mh-^IGi@%LnY><uWPF7_j(f+
z)c=!d$Hnd?XwfCu%`#=F7h9V|h8(>HLgH|a-c!DyJX)xT27b$0vQ6z*4xowIapL!9
z5zuOX?9I{r0U(mFa0;9lj0!KlRC_s^Ztg1!fvWwAT(_@YdwXJ7oHYDDnhW8{aXUd?
zG$P(%0OK28mLcOnk6nr{;4nxr-PPD~P>4hF*FyAyBU1xqhA|0F9Et_#P979eqyvoQ
zZLq_DDtyRK)aw$I+DXz}JH{Yj?7iBK{tI;yP6RF9az30MWyidVJb9b>Sl4)Y^A;!b
z5@4ZKN2|QK2Dh$u!=o}6d8TmPihJQO3+Xb#s5jXjn_FTfaYLml0rkgT>Sj)b^+gLU
z*FBj7-O61vtjmsc*l}PcI^Hby*m(z>jwMhE4_Kua_P3jeF}}=?{0P7Dz`Vu;lr-sz
z=#K}XdG);Dn{~vv(rsgq%Um_K%Yd20{Ny{#*w_hP6cz({&!)jwr@Q6fUbU)Lz#gp3
zd-vda0~f`&)Z5S+{-K*f^Vqe{wR@vtRkKv+`Uu@ZtRC-u@ISt(r?0%a?EpSP2%)`K
zzh<ZPZsEH-(yIx(ZmJoBRH@kg??WHv3)L=`9c{NlxAHwK-iN&C&a<M&@*FB&?(W-l
z#w+JWDAom;WH=TN?K$zVQ}{}Gz_#P{l`7-^P~YtO?Py2RVtrRt$?vR;<#fxB=XQz$
zvOz&nFZ^cXeYrYCad~j{($v`4*Pjo}IRt+!S(#vzZYc6>;hea1q<@n3W7c;?df}~|
ze+s*LUVfAwybb3U!p_R(ZCUdAOL38Zu73P|ZGc|hBy#dfm4CK!)81PlC4U(YRS{NO
zUic{WdHHR7UbUDO!ZI_vSYM{{R(*aiJK9i?8&6_Oe2PtCS_(vXdHwACz3;zx{gs5u
zom(vLckV5qZ1T1B6Vrn0vWYQ~v&CT~_ber4XP;6`Xv3Ml&%v@<cMN2_8!8^$$B$WT
zy<QWQgyi;dZf@lddT;m?>!~>Y-huTW%JS<MWy+&7ll^)#3+=Avsov*>$A0y#_w3Bi
zBy(Xbur76J_5bR(RgN>890I?HB+}Sj*IM||_lr&%hvIx1E8XYw0HjR8w8ah=Y_{gv
zaZd3=KEAqjZk~R*tE}(H4Q}P&DO~Y8(gyC}4B~mvZTpKm16xW3K8pS7wq0qNjCtI`
ze!8vC$DXg6_TSdJObTANJr%?()yGfVy!SAtB(S;9v+gIyC5j?N^yM|&Je;g&gJDqz
z5%X94v#%}Wjo-w^FOkZ<@5LT|^AB!;a__Hy5B1IN244@SFoz}4afqQiGvDBA7Dzf0
z65?GPd+gssM;j><I}6_05=WF*$NfZmbJeyJMl*3=N94rR<II$TZl-%pQ0(ou_`J-D
zLsVbrfYozO#qSUtP8?F0R~CJFEjCFDZ<ds&0ZMC|#lWXu9FK1!-`Bc7nlF`Rc1PX&
z=TOYK=bxqqrhJH4JhRIGF{Q_QP|_B`LEPQ95Yq!`f4tIkP|q|@2yQe7KgfNUwkHks
z{>i&FZB0DMc&hhLLi3V`n9nZu)spZ3hN~nKc43<x|Gk;!={B;BXx6`c((sQ=UefTU
z19{og#R;nBG4Hg;KwLRo^+l#cCfJ%$S6oZ&(q8Y(Yx6Wn+-Mj$SF<I|LN0dESs-OT
zF>O<>3R$`&Rac#p{#j-G&fU6t!=9ZCazFDkOIoZ=e=OZC^)so(9nmyY%q+jWdz^uB
zOE=|r>`KMDxTOc0j|6>YNw;On__$5R_V6H7q{pme=qRHdx*3Y!4P%R-d06cR&sW)?
zbThFwXf-e`l1o(binY%5h}xE+nOK#OyHtYw5;^8B^}h|dyz5Ds?*FSE#~&9Bg^J_k
zpE%r_w=}6YwXC%20q_nzuGH52)4DNd2F%vCA-_!J#xZA5aL2U=Br9fHB?ANnFSYC(
zzi8}D=u_{J*ldWIw@T_w+^~T>oM}&Nyfvmq&kghKh_@ai$I&&vU>8f+Gk`%)ftag{
zo0BZT)T-j?$7tCg%U#+#$P3aaDp2&)eS{K>Tx_PZq`7n^m{JF^<<TD-Y%;Ruk!z)v
zi!~82-tCVI&_I(}(?-h29-v4=d;<hWP~>Q6K-Ev;O*{DGL`x!Yb7$I7)|n0VdMOv|
zk+2Y_F&-2y6QK>6*sQFuY%*?Yq%spsR8C(Yn|-2a63{|oSKFfnm(mUEnuU^9xs8s<
z?SM6nPk=S11A^qS81t!oxP+qtee6bkgf69G&|}V6#u1dY$pmRXyGwiw2GW;uTx=j`
z3}>ZBJ^%|LQQKF=fd91-s47w?068}oO8h`p^n*iakL9@b2pvtlzQZ8yRhV%sv(*A0
zG3E^%rQ2yCK?Yj;yeF=h7Rn^UJkgn+yWg0r0&T6eci>fpx+o18K@<g{WR001j`>j9
zGkGj238KuXmWyI+FlycfQ%dJ6^fL_-)+-Vp;brR)b_cVnN0yZY1Y46Nz<_+Uh8`0!
zTVf^k0{hk|xWe?UwJ<r|$IS`^c-B6+8z0xl111Z3FX9qZYsjNPD05gWL4iROh0k$c
ziweR=L5=|D<}U%zI^dW~cTm9h3wj?4RJVivkE64XXL^7C_?TL$=tfa(R;kdPn{<p}
zs*@p2=<Y}&%1!6U+#B|xRZh}y5D9Z)jY>Bsj){eoxyju~9l5Jv)^fi!bNBsSet(^F
zI_Eqp&FAxeU)SsPe9qM}rC4vs+UNEgf*RfdSsq3*rT3*(^$K}<SOE(VxseUuQnT@y
zFn<HmW7l=_iIQzw4(|+lBc+y8%QzO!)8F-%;&*pq`!7}i<(H<^Y(OGugqfh?@4?&k
zyo9p3DVR(!*|uRqBlzZ^;5p@()~w5st*xN(<p}L*p&A`C&fIrWP?eR@OAs!E@a@;G
z{2X1P#>jH-g(IK1<}uLGgr!Sq2Wl(nfS<Y(d|*huqjpIT3fY#(2J*EE>l-qOAi;gX
zH&1;fpOT}uZEUVCM_dh|1DyHUS6;)n;J|#+>WU}}5E&ACYhZ<(Q?Y<o@aqn)kdbu_
zY)H)(QoN}@3L!GdeNaox8NsP*s8^Q69`1BvIyU;%j=kKrT2238gCxsAWl=3h-1CPM
zYmtYpGO6@{@rlP4Dp-PcFCR<$5tR$@Dbf}XT`epSuc$%`IeW~iB;5b#hEEb(G8`az
z^b!y6Nn775%YirZwPPZmmGQ*{Suq%r=UEqpfT(k40DjDQvSMuF1ZuSuj=;}MnUPCu
zN@uTJsvs4cOFXHm6&zP1K8!aANL!506Tdgj)+VVQU8|lp6eaLVt>JjX4I)_zEsq-^
zir28w$%97(iDiGp3@CWjNf_#&bGA~VYPeZ}XT$7CG|^PIcpK!?;Ott3{QrNHQ~2V>
zvNEgVJ`%^@@Jvm@yuU@DRSE08JVN%c`o4#KxHjgf^U8}*0_8r=xv5L!TE2Gj>}j{l
zh8p0Ll|(OX>Rc&v<!ZwC;V_v0X$0jBn|28k1GHpCe}(jZs1)*oAKI+8@|-z!N579w
z?>y)4WB=+|%ViwZ1=%OEuv2_8-d!CiFcPwD!6Mi%?)v*-XA3)Es|D9$_G5ba_OrS(
zF<0-Mk6lp{kUiJ=gy=B@JrZ`KYmwK}^M6k*PRO3<hg3!{%+x$PcBPTi>hg5vvX!T}
z!z6p1{}Xc=_XtDeBrWQ?yp7t;{c5IV<wHN{Qd}EdCDt_)A{(tfl%A9Pb!_M2L}D3@
zKFLioq;G62Zm3tuEpK>oJfx~(VPGz^d1?NF+w!tnkumN(rf7XJdhTinp~;|6l2uZ+
z;_P@VwWli}rNBSy!JnIfx0`FHc>Qsmak3S4CM%85u<%V<7;@+IaqGnAjda;wuVG=C
z(@D&Q9wUocL@=i9skljgwco*;!AQPp9MWj&p8mK$Fwp#?pGLGa$53Rpx6pAMa}QkX
z!v_2R*`*-T&gQjlivHkJe91B3%cF(<YxcR$*d!zFE0q?DhcSewWiJPj{GXOjI(C-K
zy{nl$ZTjj$yd2<7jVD@-V@O0eCbaCy&Z14uz5K*OXu+T7^W`VH9@}|+TENEm4yk#4
zz&ncPpv<7k-gW&41l*ZdJGI}f?;nvUPMiHso}X|Vm9iUEeeN}I4g_5~X(!#7v;TTL
z(jyxBvG*hU<+4{ly%Iy-JO9NW`lf6)a?DZRO_XZInyQ-BgA{vKT*wrD5gzKYmHQ$B
zJ#~=pd&)i=87_PhA4{?K*?R5r?Mn;L);VkE<Hyh(yZgs6Z&UJIY$Wc<mF~{VfxHF1
zm;PS+_P_9KRC*uwi<74dLvi}Jt)ZqIxf^otC6>=O$udd2(^Yiy@HG8U*_N+XBjVG4
zv_)6#_unyJ87E-ppWYsa<XEVIgdo+o&%C1=8Hnb6-~7-EH4BC80bvnGPdt@CCy?xq
zazBKKczXD~(0ZB#q0Im(eZ>JACE-o*;b8=<`J*YH1Zm7{7w$6?G<U+^T3r`+3@Yv}
zt>E7&)kLA-fyCa7ithamu~mRcw>C*14p^+?PJZdijb9~knw*+$hP)vYp}DO6M#ic_
zeyt;?c08m&Gz6FS%?1HHF-e^kK=E7oKa_7Mo4TGMj|g~^7F|OZ7smY|Ol9slLh0vq
zXRd;!tx#hEFKS|yJIOH%06yvo%S94mca9l%Zm6?-ypNS8ViV2KgHUoen27nB=<L~I
zNInvAXfx@+3PLkNFa$ZEU(W+|)Gdo=F-8Af8|#c*k|~J(g=C`0EI`e7(V&uc$|IW#
zuVp7za97;=4bWlDpLH=-O-e1*8;2Y&@osayM%7y@@wfbjp93AQJ|%b%&BkXETxJ%8
z4sL@}w5%}7S+G0=F5-)cf_&^x=rhm9ygrHkCm8uO<0n)ilWHN9q1K+=QByzO6^l={
zUo!iOyB@j);LK+`S#JqAUl46D$z28bNWvq7UhFPgp1HR`sXEBYKLQt_kzjRswi9;S
z+?C9;Yzs9SvQZDs%+Vjf$}m}LZwXo7BsT2}Upv^49CizPZ?sMrS6v{aDk?e=E&;3R
zuo|ARDiJ?5)*8}6;MGf!-iU&Ku6K8IHDYuXpghYpZeVEw?mE`j0qJlu6Z65`W$||=
z0J=b(u+Hl_CG9~Z$u$)ND&89~B3YLlq{nacTi`1vVsm|!_rVh!+!V?z2H&J33+4AE
z&X!b6(yrxr9&RBcjkNZ_&2dcN+^FNji|vxq0N;XMo>T3kWkC<=!C(AZq(<#ZMqE*z
zI5QL0O}iw|6MXk55K_F?4FIwtmbpx8Xclr0)ZDcAFd=+))r9b-z*)JXl9B?T)j=<r
zUoFi?FL@X}FjZ{a|4?_>7R<CB*a4wT%LkFAjQw-nVj?aAAC{U8^3xRxm@wpP!E0>r
zkGZO_)VY59aMY6Wt95CEUwJtK9}cq|CZbA-7^1m=1evdsfbt2pSx(bVn;=-4xA*5k
z;DC?jbfsc6rW3;p_!RiLuX)vgQ&vaHHmk|M3q9{Oqn~C9VK0Gn#P`qpj`h$_Rr|=f
zCLWXZ08<R1_ID*yD~9+@psTN_(^sE;Ih8%iLDZedSZUsh393Ba-e?-%#hM2dk=kTO
zitX}g=KXJ}Gm2JMWHO5aU0b&Dmi~w!^Gi${HKBmfodK<N2Q+DqR3o?2d0_HACf3R`
z`=n9_77>J#?87mzN9d@FY=tw-xPg0`^G^%;!%XcB623pQa}VDIb3sNIFMpVk!+GxN
zfLnMCo3r&(v`eXFHo*RZFA2`?^Wb#%1E|PRa~JkllT^)sm7n_JD;Vk9l$neaFe99u
zT#~Co*K6wMIHg*5>COBm=b#<(Ia;Ven~2zvxeAg+$v=gkcz`wW1wRqb7BjK%eVM_K
zfVl+DMv(x_00H)I*O!}Tol)Y&TNY{wQ#%FI>B1S`c^K9h5kAvGfu#rgB%_M4EW+YA
zZQnLv6sVdBO~$Bqdy5Rs#0jcLkviBZN)DsZL-6Y<MIpMAOqXKJLzxM0W(_%5nzxoF
zmDth*i)c0!%e^+&eHC0+zic4@sXJ-Iu~@$rzXEN7#`IF$snk%1Z>hHpRKE-2`0)@+
z{q@^1ouRPHi5LeYRK56w<uSAtZJ|dHKHkA2;f%oJL7x<MXWsG{!y8Gg#ceJXKgEa*
z;ab{Bw4I1E8JZvLJ>RNm2kkv#@3z`><96!TFKEt?^GbD#(!(>%+_WW>Yxw?sReMC+
zL=5MZ%*bS!?6DbPq(6#%AYxwcMevrZMh&|%C!KFIW!iz-)m;a^srLm`I>!@8MlHUu
z%z0CW3*yHK3VxfQ&t}hlve@-IqMo_%J>vdLc_I93!R;2z`0^Falvk6Byy<_-Z$5ag
zd+QtfJR@HCw{Ustu|4r;GSnG!<1J6w9l`|<i{R#<OTqsdUm^S~>Ka%}imY~jQ+i-U
z=_$!ylH7}BUT4k>1y%7dhxkv0*W6>WICcuRrZ3o2L7N`G`p2%rS5Z@BT8G$e?F{ZK
zU&d9M(k|ZL6kTO3D}uTR^LD!Jz|Y66%N={ay%PKwTvMwhd$KpAz$?aayL%h?-_7_6
z|7SlNDi?o*N{iP8Z_*sow)8)|t6b%){{>=ti)U$>?jUyV^w|<c(y9wq+sptJ>UC@#
zZkfRqE3cF&$MmWY|0n+e<?}HzD!%Y{Y#8%zUyK}NSDwK)qe#5D6xrjT-`0ra7i)XY
z(z+xS3+L&lFBH3A<mBhB@oO!99^d$x)c(ax+I;%zb}s(ao5Lf=XglxSdAWFO{_(5d
z=BvK*DR0^D6TjYT!)W2A&wee{B9%+T7Ys{kbQ)Z0MxEI&*E33_;slBgLaDo4iT@7W
z@($dSfW8CdMkBs!uAc3exmO*$i_BkIdoR8_^|^1KZR*W|kJX$v!C9w{mSvy5o9{b&
ziknrmF4mYXI-GD)U4G0~GewY%YW*rc`R$_FS~PAM39rYAHB&gcx<%&?jUP|*_cD5a
z!0KqV#M$eOx~tJ*tN)q3nMe|r0Yx>up|GqNMuP?vsmE7K@j0_w9+UR;Nk!DDSmYnS
zup~G<VQZHMn&GI9qPd3|+P&h>*g*64OV3O(2tBRpExbg+A({6B&?o0MD67$!yb%!$
z^g$2*$dPtd3)pnwc}k3qVuH|DREh>USK-<|VFDE05arZ~ak53Aex63SMA80vAx7U!
znxBoA`*M{;7FljnmCQ7TRVTjEuLtuJ6!f3Kz{O}}(o|P&kN*Iq(9{XbWxMGCcO4o&
z(;sH&`UAul_03vmc+_6q@|dBJbsr?SfQ1@>{rY&Alx?YQdH2_IaUWlI#3}5Wx8WC%
z{s*N5e99Yl*~&Q%^HzpMF4;ePW4tJJu5PX_d+QK-P})qMxAY@J9!7HP?Yle~^tPZ`
zN;`Fx8N{#B_>s6E6x>O82aLgzuN6s^bk{_DnhSrxs-#2N@oSyH-`WOIy^$K1xbQt0
zUoJ_wq<c~B=$cO6`>FT{kBlxx&Qb2jiac!d$0qzQ;{ayGJ4B7+)9#aXvQ(CG_H0`W
z>>26q*RwSl)#4+{7OPnq&v^&b%+*Q{5a#kF_84^5rR`q;roAiz5@4V4rjBnDLkd*1
zL}OV-(|}ZVAOoIQpx#s)lDFaohylEYNcu&Aek&}f*6X|&Q^?N(K3C$L0%GqtMl0cw
z3W4}$<h$PrMa3!ZKsGb`B$-k^ZoO9cS@vikRes_G({XuXpnjYhBsI)WafM~H0P_j+
zwjJ;XXlORuSt%TI_VAdru1~sFn2&{i$z-dm8~jA;00~pWKkA$!lh`q=|Ew2Q**jpF
zdmLiMk*ri4eVihNTN)|4osp7`r?L6mW>aj;@O)8^7ZG;;gqp!q@qddIF4krwy}T83
z32J`twCV1hT#E^0kIKQ01PA<BZpl0riko~ugWpN?oY&J~)#V=MQ=||ih4V;md;;oQ
z4uioL+G834O!pxWI4HD)@aK*dh#ezcVPoX59J&}87)y+O7-24_h$t5ytM<fjOw@}c
z6j3hOl@fD|_$Nh_bx_LQ_B*znnH^qW#G?wBwQM3Y5@6%&6nv-^dW>phi=YoN77TiH
z%%BM>`;U=`{FeiQ+<8-bBl#Ooc~skW?%+IU3QC=RR)4%32t_!^3dOONi2;NW-<>{x
zi^)Mi9XPqY>Ybla{a{BY)|A2<;X|p*6c?EfK3<Lm)(P;iH>wXaq4P&*fbZ^$-xjyH
z8woPc`D*joS_AXF)36YmC!Wk)mmH}m<V>f?9>!^_e<_3@W-d<*ojA3AJ?Zn%{Nb9H
zB~v5_=MGGDayH|P{$=(OXPr?}K-lqfI}yy8e01P|v>?`f0b_rW0xo(mMfDdJ)Trak
z!wOU`&)^`Q8_(9R)aJc6#763TrU4vvhMM3o*Dh(uTZ^wWv-GWzjrrLa%?PjoE#vkM
zK<9QfJ~$&lngFP6Ahcb^Hychyq&Rb@7IU?d9JrWQ$e{W`4!D&ZHY-qy?2d$F3~R~f
zM|O3|2H~=w?%pXm`-i#g(KH`D&Hh2ql~}h$1&}gKcvZ8Vz)CPH(9P}D2hV)KF|e;a
zNNL~$ra1HDwlRopBunT0V$3wMY4S%Vx}Mb%@^f@CzNQli3W|Khawv0E{+gQmMB(f`
z3PMwDp1!(F1Fa4?eUtuop?Ojbh6SK8lr=3v#!r~li{AJ}G`Ud1)riihA2yCob`lxK
z>%Z3>QLG0%BOp?}hF+kR(5VIPG})t|4pWu~R6-<Ww#`UFnSVVAr<a^0Sw3D*^7f=7
zqI+{*ZxMYg)?rPrm}4>De@nl&wYfVPWUDG7W?J?i7QstTt=-I8FavC{>n1ogJeuTN
ziXGkK+1Nkk^-zj3H9xfBn)>hhRTDaPUy8(vju#tNZcTAsX{fHtDLyT-jB5W3?cx`1
zyy5JHv0r9kelXfHVHx~e0_D7!1hJt^H-$W`9lr9m$78@~{(C4(!lI{N-}?N6-`9HG
z=R(K~@NHg66&aI7@A)fl@4dG^N4Oq4*ZJ^wd&;zcllCku^tRbs*1=Ny3=AnE^vBio
z^GwH<{<{vZa$d$Z!TRODuHvTosyF^Q0e`9<e`#6%>_mX3szqN6{7kHibqKqf?Udtx
z;chRKqF$7(Eb->cWA>(;XR-_>Vwa~v{khuCaQ2U;)65sgS9-pk^6Rf4PH2ALoAKM?
z<%LDFahF{m;{IIEYUCuB{)W@M7ynw@|DgJZ2;8#E#hv#z-=CeGJmdVsXFPGP^Y!J&
zg)clMZx>IkuyL&KjZ!^UegvbB$RCGhVbya;XlHTSqZ{Wkl9HuG=@_g!&t7{&QlDzF
zhJx<d!9E)IFqu098FD^l*=Dp47+VHuYUygr6E4L;<eRNKG@_>xWS`)0Jt}aI+bS20
z7>p|{@_EFLh*tY>&kpg)0q11uiwV6i@JV4b)O~jZL;K*~Y=;=cTre;=K^A08=H(JY
zi>P?RVE*3Ysi^=fFqgq9ut8XQ!08bRVB-X(s=wz-depn(#%!oAm!6Tbf#2`mD=t?g
z2{K3q!uQ9I>8sUrTb+KC98?)5W2=lpKeeU3>(TpQ43!VQmxOS5?}`b4A7XoOGY1!Z
z0cq`yloX(uCpO{ge!>+%t@8)qav>@h^00;q5Wz<&)1j7rJ)%+rYK_FcRtq)tg&BN!
zUVr97ejJR8=MGsPEQd#gPA;V4hGuZSKg^xE>#|3&aDN(81HkiFM~(h(?7-C`CS3*x
zRA1ECh<-s(1Pv8t<2bIg6(qQik+YEyZE!eQN$tMATwQP{?tml7mGtKnt%I}y(tj4J
z2hcU5ap>+Q1X?VNNvmlKezbLObNzZ&#`j`bwWXUqi1b67hPyxSbPky7r}%O=p`)MF
zNSuofIhcO1O5YZ}Z1(ha<JnxY<=p8To|%gA-x7p)`qRC+gEEfimV{bFH&^DNt(nzK
z9z6X%z!=%GZ^zVz)a;O=!&_-;rKivR;b16s(bvKzoKb!|bytvq>hzefiR!4?Y>}{1
znd?=<**Fjlv>%`6mg4^gqWSD?I@?5JqJ$%A>h>9=AAq6mxI6emD{sYQ2eY$hHL&KA
zWmxSJfUha<3#7YCGm$}XPktsq;L~Wa8FjRbdB1>f`PeOFwgZaZX)fG#8;S62%dEHD
z<M7M$6aYOZ9u6EKqgk#FRF}0>+ohL#^$ig^!2!D=)j7E$zDeP{HVAG!ZY!wp=ELL?
zPjO+X=({cW6I&Aqqa8CvMv3!zlP(@n;K^8KxE;~CH^+-|q4I?;!f_B<lhFyNJ6QF5
zsaQ2kUlD{ceqj<cR@}iG9D`vlL_^Y;nB@<cP!}gACgEL=b|#+stUxw6=%j)YLJ3c-
z2+7AHn)Y;n%C)yzI4fngL>APkAMPqZ4?{iK>dGuE9YEHX=7r9aIM&ol>=Em2GRf({
z9X|+K@3j;()l{rZL$G|pa)i5@ugf-l3FJ;4Mr};@5d!RxHI;H&_u4TXapIY+vk7j1
zP}8y0H<F1Rccii?ov1!D_%QN!=ZKHTF{agdP^gqcdQ=5K=Z?MkIlx^}@eck{496x8
zY)CY?Tgj9(C1mrwAL%X)4k`g@IkO8;^ZVUrjCuY3{003%q_huGH86QWVX243@~j+2
z?sXt|L$N-%dJv%SkW>w_atCilkS~gFsV)Rf34Po>?T30-1~cee?3O5MUt*w@)A7&L
zzT`2WQ6KJq45j)Yf{6=Pd$l<%cZ`1YBKk2jXP@Ek=4W63H+|%PsGGY90e%s!|LQwF
z!`NHzraQgIP4n#u)kCjO#+YjR8KT=lIf-j&J~(lvun3ItiwADqQ2t4BJ=!rI#+E{K
zg(xGX8!GiP7fYz1W-{<mJb3PZR1Q^Gz&^gWA&lF#d~FKNlZ#AHa8>thMFgpWxSVlW
z0lMxN(?&mnFy({@u-g{d!^x}qC%_aa0a2yI4z(ISr|r4f9gg%9+gmMEJq|=#n#=Po
z3^2u}+0w;*f`6&<j8tpBcL)%W_BP|<(ZwdxrB@&Hk_r{UP>lyJ&1A=nugHJG{N#2%
z=PNk7ipniQk$fG@cVDgW0G>YQxy$jM(76)Y(gznSo%j7tY?svJA)1t&5hWg<QnHRe
z>Fm=>gI@<kF;VH&8qwUj>r7)#6$nH8*RB-5m4gFZ3Ys$V(5S?g%HNTBOEf$}6UZ&e
z%{G<~#@d0m*M_3!hz|m8Z<59919>T8k1`ByFSIn8ANgUH-;oN~8l4e+vsTq!!1<Lm
zb*K4U``Q)j<>=Hf&=Ev;M-s9fo8+H}6&>UN7A<att!N1E>L6V#;bJFf@Xh|E*hEu}
zDkt~J3hJfWX=8>FCLLdZpBP_e;*Eqc%_I)j-c$i=zqgg}vtV&uGY;XcGzr6lMQ*P1
z{$P-~(^41J^#KZB2~n#17x?1Cy^QN1Cy+i?Qjm5#`kxf3DG>@|tV$~38(MkaK9>Fm
z9+z|b!HQoR`0P_!{9agq4%2y2&Reeh^<f5U+F$gp-_)S*pKw!4nws?QBnnON!mVe+
zd?i=%-o6aKU4djgr-^E5uUy{UFociFW;h9$@5+G)<<14DfqF-`);#mO{QFdIv;8Yv
zm4w*dcu0qHp23)Fk(u{kS2raL-4N+5Z<iI_3*1OKZxWRDDD-$xSW>_Co66Jd3Zm64
zGwSS)46LcR*+Ew{o*i`x-oj6RY#I$>@t&*-${tEWL~i~q6`G=pzjsQ^`jj$dPkW6&
zUI{yH;YOc0b!U&poN)ZCcG()PlD_!NCh-eW1YPdc><GQkmJ)N}cmj=Eqlg<W52+wr
z>@TCpE*~hL185!VitE#msJgzKqQjdl<YRj`9>_47Uzq!tLS6TzQC1XkcjGBPZ;vTo
zLbn;Rc);k?J#RBbCoR|+qmpRr4++pCt(O&KS1Q4&UVQS}*PvSV?!~jQ{<wq3jO)hl
z(?X>j?{E*o=xI6AJmEsEPD)2t{(otYH(U;vFIB+R{MYnoFWbB@Fenph<QS(lOofM<
zjD=}Ob?)ik8(o)EH8jV2VyfI3zdle8!$9oPySclsTVLKvcK>)_m%f@-ebbh3kgs&u
z9PE^GLUmKRI573jr3q3yQo2%s6PzEg21+KX^a0^i9&ly0ll1dKAQ$G@6MjVRdwESB
zK<8ow%(SPPTjTBlh+7miu%B4|^^F|X$Q$@eT~n-g^mQhGNMlSiw5W<4mD^}_eh%OI
zm+BPM#F>j}T=9EcRYI~`00wX1@22kR^kpxIRr6*~5^tFYcRzr^XE?#%-H-zKdBZ@$
zD47T(GrRA!HX7Y>MERF`X<?IgMf~pE|Di&;qo;ab{8)voF^PSE=<e@}UHn!^%n{0C
zPhC081su}9wr39^@3Nn_c0;9iXh9e{e$L8obep87^U1->5$>h_I_Brt3TTyvJ!#Mr
z?lV8TCpCzwCr)T%UQ01<5-_b_3icLun|{1OO=*hxF3P_js75Y5|64f;Zl*Wy4kZsv
zcNeJrA{#v?HvDWwi^$-#z^nGbmWm7<+4TY+ts;B+RTtS4+|RcCXEiG~{d!&OHR^E|
z^-EU%@S0lPGXJp2l<6}2GpjaD*M@@pF?jxv3xXLYyeA^%58v)%)XZw@2U!8|?5S3C
z|G`kst*z&Wp=!8lL#P>Aa=6C*R_2Osx|bj^5v~QwFDfDb6*kX#?ixTDv;7|BA`grh
zwLX`KF#a+Ggj_;uV)lezV3mGvU+i}N2SWa4ciDmEG#J(jQ(*bBEMZ3RW>h7b&wR_S
z=?el>50nm-cWm<jg3qY4FttH!$GkYG(V=V+7#UE~1|vnt2lV8oWp2|3ZE|%|SuZZi
zdEK<yo+D=8kv&INF1d^onVL*Ee+*1~JOH^ufmberZMcK)UX^2t%|^R;rM%a|wy6;K
z*S;21f2lsS+su;I9(PZ13}u5M-QE5@0_X1r#U(SWfh%Oi;(!O9m6nv|Eucb;LB(4&
zVEO!{+}~|AOc!(*U8%~(FreD4MpMl|g8@^!>L!XDx6qyq!w4jR+*cGx7<%pO@dp7{
z6t{9|S+I_O*m>X&tSV@-&D*K#k|W>@Aa;iGJ$u_9gSil5B@oHj_WqgIF0CJ5w=-SD
z)^${F2el<q?7TKC1h8spL6LdCk{?gnCGp0c*G34-3xt7yqtikOlUfo3X;Kc@*i^9E
zFjYp9)|AK~xG3e!_wh!mYh>?H2Qk+izva)IjibQL?7*$q&Ak!qMWy$IB)YW!n*;zz
z*}r?W+EWJphkDh`;^Tl5V01U1jWYDnNzkXe)8+Ph>jq+@^FbxpMv6X|R6!9Xs)EnC
zI4Zt*Ra^o|NnVH#W3)khvRX{WBGeNAVY!u27Vsz*Ys6g8YvmT;NCPI}BQ&QMs^)4@
zS5nJGrP$x`d*n-?*0fmn+T!gxLqo5_^F+W56@cDUEIxr!ujo!*n1*=l!lDcd!$d$5
zer{(l(`X_2lLg8@@dgtDYVN~CnZy=Yt7H8)b-nohhjXpcf)UtY=PmoLzNDv7aKdpk
znoAUTNKs>k5bx8zJ+*FJV)q3b)H@;^TDqVcfc2C&BAn|jGLz+bF)iM(?mr6Vcf8E!
z&Terxi~woPFEWiBb(f9=_ohYJ_R*R=IMcwLA~$=BW77m1j#u>!gTMy)7I7^-rYMJx
zLke3Ri%}RetST`Wz^#W#jj`$zk0u#4`PmELP>$n&u#!VfH<tv`@)MS}syttCvEW!k
z?{|~IlSXB9WjXf#G+7afgY!XOub!x*REgR@0T?!1Qr821sR7>9?c{c1uA{4C6WahR
z<jHUoDEh22-VR@xL=Y_^%U9}H781ko9RGdFtG%U?6J`y-mJ}r%1(}C`m=ftvSw0VA
zbv<b!51mUGx1~?OZRo3APv|4fErHNO6_dX$9WWrb%;Xhn0go}j#$3Cka=Hd2t_!|v
zW3$oB&Uk`FF)<MiCsU#_du3r@P=pCGX)<Q)XT-mV04oC!)kOGzysGRee5Mpt`G-q7
zY){H%Y<_E-U=gA++1l~rPO1D=a`>v7@ZwES-jE`8Vm-JXZ1*KUl>GyYqv|R@;M+s3
z)~d4wEGrLsu#;JN`}V$}xP@v=>WiKkoelz)Vbo-TmS&gp@~~8wm2WOL3@oN6BU-U}
zN#7)t-f6Y1oZ`J|!`&Z@jm*Br_@B-UK>B=!2D{WIh-DP%Q0j2>UsmpQchoaSHc?;D
zr_0!sS9kj*>h{C$D#<NY?xn^pVTrj>Tin?CxE(#pl$`;k9&R~J)A+aLo}@;r2~k(U
zZ><eb3M<Eqs+9&%kS_eYk2fn2;#ra9-sIoD1kL}~Fz#}D;;cwF1+L<cb7;L&R$&r}
zOL6xoIzr+W)SB#=lT^pvkfa#tiCVhN^L@)!rDTjc?`x=^Cj5MMC;+Sffx&jj*bjw~
zxxP}X`u4L#r5(vgWF07e-Z6X?$q9q^M#j*=3uD1&{u=oo3JmlQkyCedF5vW%$1IZG
z7W5Gs%Unf*k+1aNGwX-KSO1eZ+eNwm`0?F5A+?sN|K(O>u;8CAU+%)U#ZdFcOs#;0
z?=klu7W$%V=6dxN;tsac`d>7&JrW{<V#rpd+V!O;EB<nMJkeKzuAcpPp@&Jfr&T#t
zbg>2c4lmT)5?x+(Fp!f0z$$d?i5UL7L*F4o7iI}5(!%K)#h>8igH;ILaEgqjpURWM
z)qnC!@ou`Ofc-A|T|6G>D7x|pJncaW_}b*-&fly&7g_cIYAN1~4HetLe%__g%JUth
zxaW1^8YIV4k}CZy18dn(TUBOo6T<<Vy%Q-tf(T_C51+>ieg2X5!&``xpPlA+v*P&Z
z4inbf2#u%2^j-f$odN6X<;MS^h*MTW{*FodGly;l+3pJut9g>JynbhLfM=!j@pD78
z*=Vy%uG9U4df2X08LC?x`}MV+Jr3O7Qa5nlxc?0Yn(cG7@|dfsS6^0s`}O^vJ{zMs
zp&YsTw=*~W*Dz{}X(GPmd4bSF@q}@Fu<tXgtk~`NnDz8wQLf)>n}mnN0!X|Wj-C+&
zh0WJaJljO<)6u>}J^QV~0&hg4!RJ9A_poO*D{~^M^X)*S$Dr()T|hjk(sEB|c`IEZ
z`OW<D1>B{cHBYALp~kKJzHzsQJ*)?E2C_BAKZI+B=WVoz`}^a{H=fh<QoRRByf0nl
zo`J!OFW;0Goe^c<SBEW1oY$ibtJQN}cf6|%YI18U{~zjVRWT(4t#VDen_ayx<dRcD
ziZ_VgU;GNqrBBmE_X1ePi=o(uzCG&o3qt2{MSS1WIKz6yO@~(oFd`{G=5;<ogbZOj
z(wQC8svn@YWGHri%J@|3sQ1(t(d;LMcd=N#i8?-qj(HC*_&ez~n#=Ojj^){qI}$to
zG0kP&J-bFu_hQ+HjgglZtel?vcThHNi;_!DtbS7rjCCE1cF79oH*oDc@wQ_c!Y*b7
zS~c(x4>YXIzLZJU&HZRphe2>+?jR_jRL;Rn-msGTxswCKj-!bQs6QDQbw&w?>j>jw
zXRmv+&R(C}17B{=V>)i!{=HJw;eb-BlLS@>ad44)-FZVTV%%oAx<l56wI2e_EcMlX
zVe<SIU`K0d9{xzhXKbO{5533G|MwWWY&QWU2g>`a!sG0c0Csh}C%WVY4xW2To8WTF
zU;<Y70Xlc<bN?e|Zc2jK9fXFj!AY<!$W7m_0gqSI9eiVAsHCgF?8}TZGI>f#+kE;2
zfAOYEaM>6$r-%oJYhUiVf%*UNu13}3E;fG+tR8eY8e`itMI4$R4tBG0_pNMGyy@Yt
zxRm4|MBfN}aGjZEChPdL11dhxLBcZH{<<?$4kZ_l@ew`lIw1#Fs53Ob#~~WV!o5pB
z630K>mx_-{fFVha*yvN1$3e92cYQ;pYi|o`zI3`+H-(H_uYq=^kvwADk>rv<`V%5^
zfjV^uTV0OXQd_$c4(Nzp%JLV_tGz*_AA582wE%?m=X@Qnb~rvv+?V9e(<j0d#jGbn
z>u(fyV1hoXoA-@bo6;eG5|;x84a`PoM3ZLLP-pH0)FNg1clzjN?W*^7eW~RI%7dc6
z%moba<*fDy>eU-VKnj{m{$Sqb*wmLSWIDR41y(}6mT6|`7b#*OCuGAJ<qJYDOFbpE
z(I&CIV}sPOj*+dsbt_NbnDiPjg3MxoW`g*15e+Ihv<8ZIJS6{Rfe>e#KjYY%g<82a
zV^D(%0S?nQf#yQxv>@^aaHzk>lqsi97l`0x-9r-ur!LBLzv-*RK#pUj+$3IWgyt->
z`T8os58>nOQSL@LJp%1{fp(5f@QH@%K^JRcdA>#1qo1Uxap%>-Vj@bo_zFf|Q|2+_
zAbby^f!<W_g_<zyX!gW093;~4e2&IBbjNcO?R<tHi(+V+n+C5)zjMiBk)y|3O?sx=
zWcgenkBIuZ)C4-xOTg)?1yYV}AD>3R6(^c?hE;G_7T^cElI4KAX~n%ak<IJv^rS6x
zJGM?eiY3Jt8*Ik;m2XYj8GKw^|48}gBe)Zl+53Gb<Y9amg4CBoeo-v;_5p)cOn^wQ
zI}UVjM@o(_sKWLsV}rr)Uf0K9>q}-jfb{R=friKPGkr>sS>6H?byA7nEQ1sY929~_
zV71b~2VU0Xa}%zjpCd?xA#YWm2Fhy)zGC5K%|xA~2U6HKX&$c0TV@F;8w~yYG{jx?
z)rDO*wi82fCk!Uqh*RbQ{A;>rRv1vM0FUv5r1xlgT#!*}$PEJ<#_!r`!Cct6WGR1}
zOhya|(t_4CpYDMyFGmX^@=DZ|ihImn5};2<?OMz1QN$&EIj9(_;$EHLH}<qCqiYm*
z^+*u`q#Top{6s-;6=$MjBY!L~p7o8r9-lEh?iBo;hip-IYW4R$aBh0*{@acY9bIR-
z4Qt1Pv-0oNe|_1k-}^bs<Nn_wQ#rESs#NcOn40&~ymQ{y#wk5Qf|nq9?DyOKn3Qhz
zhP#d7zfc7)-o;;<3QnNaFC6SIVtWjmFMGiJ3=@f%4&K%5>8-S{Gd+7wXRzM%=fK+y
zXWTkhC5tCkoW9B3dRCr;`c{6EH8c*pgv3o2q0Npv_Mh?<|1~g3mooj|x*=Q;(#wm3
zBm_~07Vi5+(%3|=rJwy@`%n9vE4wx|-(M>^vwk$HsyJvzAZlTv&WPdswC8yX?F{`x
z`xzha45MTu!VLGg(Q%We=-E!ne_H$HuRA3{weaS_&@vq02y!`H%?gOT==mi(WD8eT
zNtolaUC+0iJ!op5bOrH!lK(`_xXRMPOuDFD+RXmu5#7|mJAXWVPb4Ylc!BHF`(>4$
zbgCeS`-g>redC5lor?FAe}Ivdn_K#zz_rl#a#+mQt~A5OpgqY*a&%KyF4p66Md(uA
za#hvD4&YzOC8v+xeHYbH`#)4^_p6X5k?!VwP*BpS9GD`dBfoBy`=pH9Rqc$f%}uvp
zh;*?N`qe^MCGUyApvPnYr1y_k?!2vpBVNf#dC47jqD`2$=T?Rn4e8q^oLqhFy+`l!
zeuAvJ_>%?6{nkHYnnP9!$%$Wg>HPWT?84-V-h*!Jrbg2sGEP$YCNV8lMeS-z<&9yt
z?YaSx&mQ~p5tG57;0u($%W)@s?1~K4Ov@<c#ap?K4-RNzL!JeE>;30{C@?*QT8l!r
zn0R&GzOpbm7`pozzX(@v@pCR;%YSeS29?~}QEYf8mV%W@68_t%T4A|<%`t{|V<5G&
ztJ0MjMqhxqbL6&rBkQKh+&+H3c13-9Q@xAbI{_i}GxD%g<8hJ+lVBz}>pbztu)9_1
z;Kao@pKlGdU}zo8*%Olpd-W((X&gqFJ4A)#2rjxg$mq<b31uYuYO_}-rG0K>)+^QJ
zuC4c#qn{F3-u_Q?1YJLT7Ojk$?K2ou?Q67Y@6HUo1U_v3+X_EaPcI$+&X5cCci&h4
zkQ0Ld;bcC${5dgUhI%`$#jIFsoa|yW*O#t#`(Yt-@&EyE^ki@F+r^2HXS)pO*WM7r
zpV)<|we|@&rWM^Q2)i0+n$&+fjjIJBtQ^VR^QAqcn9iS1?1K5THKQlR@kXEb2}6)d
z9P#vx%;|ghoFJo~`C55Gq$G=n6=6iUNMxAZv99xJ?V4$j+`afG5qg=y`Xrs<jefcW
zm((s!^5*t^*-4p;hYXXIt%BbNOGp>{e#)M#g1_j0<D{L~dfhQ|zG?okwa~8tA64qL
zuh!S>kX~A#sdoB-9WS3^eQsIm*W4mEE6#YNQK!-GZFg$T@rw_feED|;#Q6`95iE;$
z>IQ4{C)R~=H(!K{@eBI1ypEzJW!DRHKc2Gv1uw5~k*`)GL)QJp?U{wB_BLkJDbHJ&
z9T_@FnIg;YzZ+BXqy^9}iE{S-0h@)&AJFUf&{}@(Cwtqq5&EdXWYnAhJ4mHeo5*0G
zbp#T6o!kqY6v6$TK)tm!NS&XpSjHKE)w_L|@aFGApqlOgSI;Moe;Bmuc|~eL<}TbH
zhH8$EEvcBm;ezT`8}SLgDB-{+EwUxN)i}y*KAx6})jqa2;hnb+s80=T)LqjqWghMy
zP4J6tF@p4~12(2zz=oDLS5ySSf}}i)4R)XBZ?Tx!z&|al7BZ|?S9dQDKCyUES`=l_
zMAnXnQ4IJ{Lkld`m$R!|drdN>?oziE)e8E!zk_zfq3yE<u7|%^r71xc%`2|D$mkQZ
zGt=r;EF3W!BqzoQ<IV#xA2vl(MKguURzSt}v-Ech9e%*z%JP<nS(5fRgbwFgx7x1|
zBE`hmw`P(rr5f`vkUFM`7P*t`iJ{|mt(*xE?0u??t`E1sSJ?4+1}aW<N<Z_^Wix=H
z+M;G`l$+L9TZ|%FsGS9IpDR(j(wUlCFR@*=nSWHk6ahw=^(l+M@z`L+FUE$p`a^g!
z478P)%~;jL*{n>+UFOo9!w~;{=n5(H-_Zgl0jBa?Aje~VMO*mD9!-{wB^bjZ_00Ed
zL}}bs1wv%f`|vGpOP^81VntalZQv*EfR`@B6_+F|b?UBRs8%#Y;VhI+EN%del2NN}
z@g}97$!Qn6#Z&8pJAsd^@k2>6eUd^xY2{CfFFR_7q)tP5;S9<Wx~Qg!YP3=!i{>{j
ze<NFo!dF1ovrh!u)fZahcHlOfJf*2d8^!q<>m!@;;y{wL0$#ZKOJb%+%h2G4(nKe!
z9_=V|?+oS!^87d>w6^V$J@cv#QMqqm8S^ML5yZRYuq_^=2c-2oR$BQVZ1^97qQz>k
zXb{=Fi{S*MF$h>^+)deVYOWbb_m<(3+|!<6A9{<5v16NeB*EEMgo&ekZ8TUmyC3_9
zMZz@__|oR}Z^i?33&iVLev1dHZW^g=Zh*!S*lINT=<e#SYB7Z`RMleiEaBLMF5Vph
zH2CVUAm2sp&Ndq}M5kC~A@bo{?26XIf(N~U7<=LtOM=EzrJ3h&g7J%T24jb_*8QI*
zVPM%%BfSpN!#SF)APpQPu%-Elz&~Do2gT|g2w}HkB!^pQ;Q*{Ay1ZDa2!+94mRihf
zkQ@C;gzwL+a5&?V7<tVoe7wJrynLJt!xSRb8o9Z+0s28c;Ao%8VB>4$CyaV7Hi2Uh
zlHg28h|-{Tyr^C25(U|nC^@@Y1eB)O0JF_sJ|zTLT^<N2QUgko>AwdlZ?z5&PReiY
zUPhY1xR)T%LpsKck`;{5v`e?c@3`L`hJ6n698RxB=C^E`0a{EB0IA|Z1m{P-_%@q9
zGAM#oVpHe<K+#5L+SJFsj5~d~?zh4WtDS}#5DjUOqPRuqvZm{$m<i@m;j86*`p*K*
z{kPTB&Phip(^~^;bF1#UZ07fw43I%cylhgp_uYLV@3;u-6>d{^b>D{Ed4|2#d{tEO
zCS0@UL2q?Kh<PPDAcR_GW$?L*R+5pJqDHD*+RuF103*Don1uURuy>mkU8uCnEn6o!
zw<G78$$Qki9@^D!o>mu~S^xEo8!<!%>ltFk@JM;lug%Fvy~K9!H6ELU`h_U)yr09*
zc6}8ZYv-&9T4nU#;)_sO(GAhyU{bKN_~FMhVJUs;8S)%t?qf-Xo5A?mV(N}yE?wFw
zA%-W5B)`FxyS!(A<7GPaQy1sAwA8s)Ab$td@Mrrgx{KLgmR;;)rayReb&KfA&I=ql
zW4h?*6wM2Jc4tQXkRrZU_QWo{{zL6_VaVOn-XV=bfMr<vpA_n>UK899Qhu>7Nqpw7
zZx$1ckun7S6P?pr&%?#rpf{h&?;C!l(ny}I&F;K@xMIP7Y5Y>?w)1zov43{CUcUid
zx*!@>l)pdJ;$>-8G^qdKeR-16OTND-pt!-~Nba#vLEa7uawnnX9=1VFcIkRn=WMY!
z+^LE5<YL%fC%h>?&a-$edj*64I-egJKkfYrX`I#)3!WLjOugG`@K^04C;GU3{;m{7
z{C`h6cfQ<As<6-dd9e!9K;a#`XvW$;Z2a55HFK4TAJ3M0*yuQTWl8Vvv;K_~_FrpP
zq1`2;#fP5!-w{{#DYvK7UAImLVeYpDE%z(Ge=2$^=KJWQ7lh5X-%N^d$exzJ-VH8_
zsi#MgwIAC*Y<^~A6`U<ExO%6UMW^td{PDD)X7|QcZeeaa9NLNka?|Z?!><@tRGe){
zpOrmv@?Wor^;V0@$~x|JJ^JM*K_RcgW58hlyv4^0$`5R$=5c-HIb`ip_NIdP&0Nc<
ztgqersJZ_JWBl%CD=~CkZC*ZY7f<@{@m8@th$Okb$!IDi2~Oqo?rr?*+rWW?yDlWi
zVjb!gvgQ+az5cX3LlmX}kUIPjZEug_;v11fP+4S9fBAnXTOC&8^P`0x&u9HCX4`)>
zZ`vk{c&-^>(O1e@)27D~uj<eKlwMn?pE!JMu9CLpzkjPRO&=0~O)cJ1_u6vL-dwy~
z(t;3A&x~1lO{-T(+>vF&SE@5+qOv*@M#k_}Dn4DWU{&{P%YQ!gq)Mme-|XsFwfYb0
zl&i4%3`A$WxN~_g#3#kZoy=k%0^V${)Q}Z79sbPkfChG)ltVe7=_le{5i>=$yNMBW
znem5%A73Te4?~~(7XEfo7rn~T@ztsvWXlHty%*i6z2@Zh?E~_LXIAu%j~-s!l7TW`
zXMh$JZ8{uRFY4@4{a{EBcG=gX&f*=9-TKfmEqdX*_2N@2nHT(6whR`am#Y<g*NnBl
zn9k>m*y>YNx@_;2He}sm`&|Qz6Q>9Xb(z1@WaE_HPbpomZZPl?{ibb-H_^!C@w9yx
zd+QbVGAyk;PgT~G+mQA|P$52UU%P*hI=yB2$~pcsf0P6U;o}+u{YG=0Pj>{_^!NxK
zd=li>i-t||m@pGeRk0|l8I%@O*FywCWl$zLo(lWzWF?fULv$}Fph)3kdcp`rg^N;d
zKAycD%PK5-Q7Mx&8zM}{PbNxQ5EKF8Myn+RD_XE21*0<pWg`Ze$j3mLgtUbKBly)i
z98B?2aL!Sv%f^f)dKGJ~T9;dO6O#PloaCU0Q5&l(gHleQ4j=v8^_O`LL%`x&lmS?Q
zP5d(nhq3gPK}63P$Nk<}oit&o&y~oEknv}4kP=W4cg5=P-IrkpgVJ@IQfnYV-vg-2
z4<TYZ$yCQ2i>+lgLfQlSDju!fk<c*fWR3r2aPn>mZ%$UQxT^r32l0;fv*=;6+5*i5
z5-XZSjlYb8$y=+opxjtCK=Xtsk26*nOLJQ2NTjytDfPb2P0MLjjwQ1(MC5GBCutrg
z+#<Jx)i>A4sA}#@3xQ54d<A?&SnX`k!k<`_gXi%(J+0rpq;gVLAQg7Ss=F^!iD}R6
z47Ui&6EP}g{7_2);Btb548@UxAM_Fw>m6joM%_t!9PJ5;NK4-rtLn^Ek3_(9XR^Su
z{E<>ObD@YR)j+UbP#0O%4;nrvyIhj$VUR5Aw~B4m=X8oUYx(=?_`x!UGvY^7HCvp7
zWkU??6sFrk^KvzxyApQISn4gVtIs<Ud=HBHZ>Rg&0L>t>c-d`6QDFsR5x}cXpcun;
zfHAMH-qvnc7X>GfnIx!M0W8L^cb1u!iL?+3Om2vLzhy9X%%=@3cWh<)&1hZZIq84y
z)_9<!GdM!pVpfCg%p_pLIm;9o%#U{-hw#;d)|&_Q`ttF29ZUX)3jS2QEQaZC`SPE)
zYuBBq0j>PYlKKAqyF2(hGRiPF_5$W5${9;-_0N2UQut+VCPlIRw!Ay8TAy^Z0|Awd
z_){qXVER55ljm)UTg=*hm2}O}#Rnp=`vISco!Wb9%;V!tOLddjsb$+C&OuG7ezZNv
z5Ry0L10fQJ`UT+19kq`4`BJ)BZqnC#0yWitNQwHN_|sILTyZbU5#Vo4{0aDysM&pE
zhT|t6CdKp?t_{Oxw`UIqAT{iIKAk7#;`^Yp-p4v9&7T;zZc(G!MumcMUCocE=4)2Z
zhvKoMFXzU#mQ$0IR?B53GGP}p+!R171=DRI1(vhz3R%8|_OVT<(eA`-7R?d>s4W;A
zsN~7^OMfqJUi$6(p~k+YlJpffF$*Au(<J>u?Q}s<!f>e66t}`OuAA;j=9r-R6@L9}
zthY>jyiN&n#9gr)W->3q1!MWa<6;@;2dvkihrJZelW~nw4jrBM=qG+}Xr2m`w_O37
z(jQkKYgXRONP&?*B-LBa!#U?sTq4-@oV}i#OkwiaXolQR2_Ux>PI0LnY=neHGwkYU
zsvZX|WbSFf_h1u>GE?}%$aF>GLVHJwo%mCnV|BCc)_D76)a)^mA#B1S=cZzs8R<$I
z*ei%zehxitX>rgS9*7pefM0;oP;g)7rZbKYwmPnKzI}eMDI_5Mc$ItSnwt0z<{h}^
z?R&knJ;f3zsTiIMLnOahm&sd&_M6MFrAonmx(ZBR9o1!@Fe;iq`4n#`Z7BM+O5e&~
z3IztgoE15NR#Z99KlH&c(8K=Y`w!o{_~7~)hgX1F*=^L9v1f@_HeOEmOn8y8hCgm3
zJ@jGc;Ict&0zkuCp){4D{PF11<Ec}N(vW$7L2q>aF!JoMkAnQc#<7_4YKrUCvGmG0
zeI;yfc(PS+*VFw1#@$}HR^O^`bvT`#ol{`TQ@3yZob_1b@yh0NlL4i!KzV)O1+zm9
zyJ~~yY6Zo+nxZS^vci!251-v{*YdLbMRcurdu(*2?nT!|=H#vA!ZU&&8{N1PiSvMK
zVP<iF5wchueA@j#Q+zM0vE<C~!MM5CnRZHR8fBy1>~{q%k)vs;H%aNI{`%mtI7TV`
zn1160z~mC&6<{|A{(k49x&N>9YrUrSfA30eosW9%Xg}_->XssM$CHMD3auX^@sSg%
z{M?316<CD>#J>bZc9&>C>DpKvABrQHKmHl-WrUz$n#v8zy|yc<Z{a_Sto&U}G+kmr
zPZ!_4QlUQfO1jbMM_t{*TdBpRBD=r7Mc(*#-{FPs#Y1*KSXb$zuW4rsEfb`M29$+8
ziT6kcFD;wjQ{FIS(eUHT<|$Tx!sD)H7B>>NSHOO;m0a(i_%F$LarAY#M(4YBQ5|M$
zT>o8!Uq-u`pAm2vk>#L<D>7cz8cp$CIlEXN`YUvprBD4=xuh}e1Rh6WDCU2@&*9k(
z$SZz-caOp9ot8eX`}mGCr1jpn;Kl=+h0@6nNF`E!U8%Ux;LWevzIBsrpVW$W)b~eI
z&p6wuMBl2m@OC+K<>lk{5vo5LFKI=WKWRrUa+>CTc*}NIehjefo%*@3=QIyFgwW?r
zi#ORkF8_Wz`i;lJOkH2O%ISBN6jC(d`CcZJ-&Vh<gAZWa32TMddIOR3*WhD+T3QkF
zj$ZPd+466h&LWLjI!yJq{)eF>(kj*qRZ9O5Uwpj4_lfq64Dd(SC_WZ&74hSm)6bCg
z#KE`UE=&5J^CQ&fOWbe3hv&{|r|zYRM#jXGm4+?h24CHx!$E`9<k?a9B&Fx>liL~3
zi?4_`Jqo=ZpfQHq<7B$3{+VBZ@mV>e*x`Uxz;85Z^A&McFm8RzL3t7_{fcP8^I4$V
zf%a*&Qp3zYE@pa3oW)6*BR6_{A|;6P?N>>eX9>Guf`m<Re#%G7Z%}(+x*2Y6Wa^k1
zTJ&o^t3ps-V^*)2cG)Ki1irA?c>we4E(K=QOje5bwTu+mQzg<|=$_WM(=PSPN7BZ|
zomZO2biey;>Z~YW;e^9(QDG5v)z%%yY83Gls-yapc8&yh*&S$rMK|)3kOx)8j(X=h
zdcbt~s@1i5eIODE3}8iEAI+JH{?*jo&)8HOxn88m4i({ZY;l1$XTip|NolLOsvG#^
z4k`ch!;-*JR_jw@d+gdycS8~K@dka5MB?MQWWlZND<E})yv^8~GMyE6)&p%4n}mf|
zBxih~qs>Jj5}yzuu#{bH`f039sfSdTf$@W!_Adr4!LNb!oC0_78J8VtK97baWDdGm
z$&&{`M#CQb+q8wRjP6t(G2w0SUq*eYd3aM=n3Y!?AS_pN{10r}$~-?@z~9gJkI?4#
zCpZMrpuhat1KkB<w+^0$+rH=)b&QxYIul;VKZA(Mlyg4E>>WwU(5wPe$xPhxq&lG5
zV%Ubb&oU4>srvCBw^>cjo<v2tyn3%o!?@>{qHuhixHrB}A|?;`j&?5eI4c>4uN%!G
zRZI)uClhtLC=m~t@`y9G%_ctwPi`CkSgw)nL(r(CCY#Ga>(k<BzZ{peBefjB>%C;4
zb>---h3JQ1cHyAiNEiq+T);*|D98syBaL~`deyuo5Pn<D_`MoolI{mHa-gqb5(Pet
zx9xR(n_t=@#meX$ZsUR<N+QT8^Y<H}h2$N*6;T5Kn%n`GAgcU?ev3K{WvNEB338k(
zdF%LmV)mpu9#T}*M1*8z=tqeJav29dGpZZy(WX2rz<R`hp_;`uNg2_Poxb}n&`kDd
z!l-^;pBT!<gRP})z2-y_>T3k>XGM9lryi>VHvh(Os53hd)DZwt(Bw4o{ExY$bU)n}
zxyO7`?3P;O^)dg}@6R*_*IZ|>o3CYbJuC3i+57oa4PxarmBe#9WVFdLL2Ij2FVgz)
zU=r{6P+a!k^G_UfNg--!70a!@hdw)d$5L-7W8|{dt@BK2$GV!gDSY--jf;xmJ;ph7
zS5~niV<COeTT4OOBNCr9)_xE*d!}hyPsBzv{|8C6OY7Ziw#>NhHBhwIOlf~yiIw8^
zQfy}eHX)DAqd5%ulh^mQO&MunK0m5n*LT0asA%&!(|!w<{oU8OIak{_XGHNAR}0&q
z37v=ob<zTuROnYkpV*<g!L4b(tE`sc{H#S2;A&!6V{j4gFC@N~4GM&}21CKnxmkR?
zCkRHON;6KM5qoGhk+Fe#FIIkrNLwzl1tGw3?OL$(VYLBLm(h`M?HlO5*KAViO|qx-
z+7--4wda<c!%$%qligt^OgYYiEfTsj#+Sf%5<JLNHxW2mw4vv;qnvssyR*zgHN3qh
z^DxW>-<|Z5oY&f&@#9Ff@5bt%18wG66r&Cv{-zSO$9tiV?7#G9_uM}mnQ7b09PJEw
zls#&3l14Y7$N1uEEkZ1Pf6zknb-=4uuJv_=kO!u@$!cvWr%acvtIYupj8(55?!E92
z)ACstW(=7kWpG@q-6#u0CrPXSMWJL~BM1DU%W5IH!n#R(Q7|fp6JLv?>k*1N=-T7>
zJA?EH!gR6qEkp>%A<~`2WfTz%A>&i~fU3`oYOfo+mGO#Nw+u^#m{VYoUjYRDy1)^~
z)}7GCxT+ikSXvRxhUA<9FQB0G^Av4pqgH$OUcH*uivoB-+&#I5@TFs>5XeEq#E|@X
zJ*9GZ`hknf6esR~+w($Ev~(%ZTW*3NuZe=-vQi=j6rrv5mo(NYPtd|RMZm)Az_{Pa
zsXH61r)>SsC%03UdauR&6m~FFV%M7QqkStbW7E;H@fV61e<%HJD=$gct51aSE_N$E
zB4pGq&qPIVnVbbDrTf$P4>aw)TH22L6Seo8;NxBcyn^_OdSK<1t^74T2zXnlNtLuS
z$}ejaMG^zYT&8mx^KO9I9I(sw4JK8>>Lhs80nBR9vj|=GJzWX-&;wasr`6a2R=+}I
zQ}$$KP|aD<wP#n;rWX&-b!mU}4ER5e&OM&#_W$FPYIi5Qi|(k6N;On+Dw~;+JEz!k
zO3AH6In-CqhdF#mrKF7zIgDaP5sKS!4vCQ%n?ncZVb*e<^SFOkzrXJ8$K$>|#P->B
zz2C3b^Qq=MCX&nZYqKR*;XYK)(9(O7sxj;o7OjU>Sl_zJK2dOrzw3#y<6`Ffvykn#
zuctpt{|D>Kf8j>-xeS`XAn{qV-jkFWx!w%UNrJ!LW?XVJS#Rr$O|>Zb3wuj2SlLv8
zH3xY4q{{#C_>N!=mfLRYcUNogf3V<fMxAKbD}ha~kXozL^RUXW^qyl>p<&d8H~Fz4
zL9<Z60LkOcQY&@wM)>|bbS!@y0vm@PBZn6h26*v+yXv0)>qW$)VZS#dw?CkGvR@N$
zz~SnG$|V2Z<#k}jzx^b_kn+53X0NRHP2!8g@$0b)^uXKw{~MQ17v;(KL+n3;M6Z82
zFlcSg4I4eKZ8tR_pKw8u$(>t`o5DJ8o53z0pQzdFm(j`-Y?p8M;v?9QS?-eS>GfP>
z_<n)a)%%1VistuxQx^@$e<&A|`=<0_<V2BMV_?gGPEWwU$*xfCoh}+{=B5HCAOECb
zqc6PT?NZJ>axcZ8-&Jc-<K4$VpxFM3k7yi)Ns&&x#Yga$|F?2ECadyl$CH$EUK<uy
zFTVIZVX7WeeLQYp*;Gh@R6cwwZf!XG`lYs8Dz0Yl`UHqhy+Zv0;RNJTlT*rZ3Ex8s
z9&Y>IhJD0N*?rmhKhy(l{vQXeGirKcwLkx3oU##~)NqXRsN?&;$?z}c)3Vp?QO}&O
zh_1|72kC|Q^HYn<vmR}%(eAJnD_4^bz_WC_fzUHq?tr1(;wU5OAoPa+`t;~skUQ)a
z_|+{8)a_ijP?tn55e^opzV@oaA)2YKz8C(Hf01m6UXG$)y%-OG3?FMo@qgcf!i_&;
z&-&mEcBVU&Z1qP10L|-n)brQkSu+T;;t%6CtC@vfbA!9Va1-hOHa}27vfa^m`3*|?
zf-UNC3aSnx7^Gi?HZ2!uwPmfxJ9*MlwPjA8BzI$?2TJjR75}oT)cB#6(cG&P<C&8$
zE>d2``Tz3puaE<i+Dn3@4*y-+k`F;XZ3p$UZWFRkEm=}=nfcS(OLMs|Dc_Iv#jg#s
zst4vy9hi+tfdhx#vN0@ZGXD@OF~Q(pt=QJ_^7bJUHW_;9;&A3@Wm(Dy6jbJPdul>H
z!vm$B@kg9XXj{6?eRGM0GiD#JK9WA>$N$c_T6=d4u(7-(-Ar~f*LEg?W-NGTTQscJ
z=f7}-<KJMnH0O@cfZa{|OU=Rd1ta(ukQyQy6O&Y7ZreBbmK3*v)?wQ}e|NA=kS@-P
z^v~O%f^m`}NJjotsU3;rq#v5_Bn?bi-#8)r6==3*DDIJuy5^S|ThxMcV8)7Z*eMeO
zkewoeScSgs{5F_&7U+1Gu7+V}%=Ft&NDck38<sUrUdm1X59Y^>n2C?Iy5aeIfZmmE
zNnG{r2JUM;=T;dPuxtYeby6QdL_lk6eO*^py;(m2ZmF{qVBTYH?4e+0QoW`CL1Bu!
zK$l$>>Pw0DfD1JF9_A<Rl4j;;7MwFz7W7j&yADoQNH&A*00vxwq%n{$DO6!W1PVYT
zv_Uw2keNpy(bWz`(gxh{q+In>$1wP~2^2j6*qE@X^i(2t%pY3JX$5qwjJ2gK!zW|A
zDT$fMW`v!XmbFd^L0=)t0(qM{q8o0rn?z(<p#6tI7ZbSSUV{0&{Z{nKQZ9{&n@CQl
zz|9N+vJQwtJpf=X6AW@dGu_dvU#iAxU(lLW=vQ6NzTja1SruCFJm#i=MLkAh{o95c
ztaSkT@$UBrE?N$B+hb$gVU=Kg#{_|yig_K&_^9Rlh{`p8`hEqVKfFLt9`i5YpH#HB
ztUh7z9P`$MLGTm35u_KPgy;9K8kw&5->g|HI~5Y-ao~82#`z5X{M$T`dL-E&B_)L?
z`5*WLvwzI))3y9X%&9$7uVje_#;2^dK_H6Loem2x{b+|i1?emtxBW0FaB`N9j7(?&
zUNxPaw|UX)%rN&fYRZ6)eD3@1pO;KR_Lg!H*Bd$UX-C2>dtX+JRPePvTkbE37m4x?
z$>Pb@Pq0Ax`D2Dw(R9|!k2|T~SVT;^d|^zqUUs**KityxE0ws&)af`iS`-PzzIfab
zPuyIzjA+H6@OLcgNApdx@AzcX%7jjH+In`VWcxK4wxfufIZY{Df=ebW=K}&+&~lOE
zvul~?r;R>OIu4BEeM#);xv1V06YyU$qqkJQo(|S{7ESh}iv;Gs+zHefg=!mDA5vQ(
zS`Hx9xkEHj-A4wkRB9Aj0G%#Stab%w7O~r|XomgudMl|+-*OKeEkkM7L$utaau6S!
z_-NQHy8~#v5*tn(&0W@&sx5VK3PQQ<iXm}gXM+g=Y0czRP1ZZ5KS#qslslN9yx!eU
zHM}UsPs;w9C4*&W^+V0-(1}<YS(IhC(qB`iEHnqQZOD<wxNa68F|fG;lsiee3+(G1
zK#UGk5^^$F$>4STAvAj-JAEh2v2h%os-_mKl|Bqk_$VOiwdAglITWUH-KStifY_~g
zo7^g?H|mGbL^BFx!iHUD-FV%WG&m=A;rG1K0xgFM;Ve(OgNQmX8gFVn*bS6_@eu2?
zu?&~^vEmmcSSH%@S|o=OG!e&#gKz2-?#WjvrOguxX9oTss0TE*;0uj-CI%3d!wB~7
z>)8`C7b0*J<(!S_ZD;geCsYbJ5xd3NQKsDif{WDZWw&W^xD2d6G@A||A_Q^%gYD4W
z_=(5l#_bsT4_0U#{yJkN0LsC%WNj528(82;=t$CZ(3HhA;bTgKA8?_!it{F!b2KHn
zddzj^_Xrt($9_&^Vz>dnHv#Rvp(F>|75YuT^eoLn7JlejLG=&euf{-{3fc8_9;`aG
znA9y#cMkiqE!$5J;i^iQmf<dT`!bnZ{7&gMZ<_idQPV~I2@;nMex!~9Rb{b5atM&p
zF`oQ!_ys<sTb`-Y)eM)>!oB#EK8N=7wkr5^Mr!rP)&9q9(6RIbB*q(+?>}T3q1{Jw
zuSJ%QrwOhY{5ZMZ%P4sEqD`vwN+|2^a>-at|NMvbEvqbI@H;oNZ{v@Ve)$jj?;pQc
zeGyo7=vVu8K?~_&9!><st<Ifx8tAa7<tT=IBGEW`y@3K8c63d~HJVOlN5Szn7ysrV
z`|%fE`f`#-b4{B^b$izbz%?IW^R4=6gdj~&o_09XL0;=S^<lS<so293v%8LoWtrRP
z7{$ERX{s<U8f2k<`qNG+)b%la06L)cXPHii4@4kCI_;dZwv-%MiXMO9)pNyI8K42U
z_Go(G&FB7ELJ;|~XWCg?YppMT7>WhUZ%+J+%H9v|-Zv`N2QFN_mNe`g6aANc>Mf&x
z;epf9jy?YrZby73sQi#VZxfntB`G!dl?B?$3C0?|?wM7Dg9S^W<<rKaCyVEYkHvqO
z&w<pGbyfUwOLsYp<h<XizOFqd_0%S(<hb{eyWTRLyz57ic%E8hA6XcAZ)NdbbvJjy
zrGn;voO*qr&W!!MX;)aY?)*tkYWIx^&B1(T>Uf<W)1&*F6g-vrg!O0Ou&wd?1kdvz
zQn*u;{Ql79u+Y}=lT)o>ALs3N4F`nwonXjt_sQ<txcL5!pEF}6a(DmMA=_$~$jLp_
zS+iAnFrRJ!;sJr^{SL{W#gy%L-ar3zBYeDS&DQkP0mOO&x6D58;ccI4`ffc}wx@>+
z&0lf(y)!%_s4%&t+4o*TAKmuOdCm2N*5S)BuW$B9#mp`FdaeGjyV)(P225AANzXeW
z473<lz0(kxg1sc=QL1c_O@C@B$4-T}3+<e{w;QjS5Ud?;b0eQadWi!ZiTM_ACC|Tb
z(CCA47Asr|3Sx$N^ar-h1E~GF-OJ!*82<}7=}hiUO-+UL+tk}nuSE4YGYwg((9Viv
zLf|q>cE<7Qp7mRr$LgXEa-LcW(;zx>S+~1N`z+<S{PXgYNgI4}X|kk3nBKCtW3YUd
zT1v&n9ix-8`d^}o3SCuBys5%9fmR?dZ|1TUw6s2#I{LcCTwyShlHM~p-JQ6xOm6Mc
zvh@turOp~eg?W5zXAda^miavK0cq(gpvRSu;q&2{_U#-kYh$wyQhEW<?|mD3IeOvU
z|2z+%K_F=h!*m|%>$S?Yf7w;gs1Uk&R-?Ujb=^)UVNYGC-<0)^3WXZS49%+*`+Z+a
zOJO~U9+pagHq8IKKWbvPO{@06#t5tT6<4lv$9CU}?zY1%Kx}#A6l>Q)V1BPBBS`SI
z*HiM`r>OOzCM&q!(<@M$w({l_@%VbS-XaJry?eK_h`q@01c$tWvN#uCtAb}B$B+!u
zGLRcC#3@qh$a!xw7?^y?*faZ2OL#fM8D<9EvjZx7csClbr~A3fQfeVxPWzl6wc?d>
zAFW<{D7at|u^P*#fxV18cphFd`8srD{bOz1>Yb;}h%fF4$WWAXEOdZuDMpb7vbKqY
zy&!vQp_%S27zFBZral5yIdySU>kCZ>JjYvvpkWK}t&Z5S#a!3;_A`tV5r!2kM;2g(
z>ZW><!<2*SM<aIsR+d+H{RcY@mn<4Fjb{P3H_{2(@B?r!fHEP0MS<hS8fTvxW=dZj
z+JTGija!<Cq6JMEhu^<%SZ5Y^uQ^S)AeBfC9mtdQ%^VS!k^QuWJ|>rgiuFtWtL#3o
zdHU_7#IOzY;XvhvH|8V)wd(iCKSD$~V)qal=pf6$d`qo~VI+HN?u=C8ptd$DPhT5J
zf!hNyAIKfL*VbtBi1k1T3@PuB%i0*KHpg!=^S^GxugsXPa6=aL04rB0wt;PG=sA%{
zBWvBdbM^VjxM<zmC2vc59y!i=s9t~TS9k^9rf{bB{phCDfx<f<iJwNucGM>cCTm}6
zpa1Wmcada#YySLp%>I86(}1V|UM7-rMLRuztvl$-+>F-T*i_NzholoYDWArCz#si*
zu6`9hp8DpTFc=sA0w|76_>Tk@r@l_=Se4|fqmia--M4Ci-^u=Qaifopm#_Kh1$6s`
z=$l5j8ye-y{<=mZ4bE6jAIU@uEc$~*xp5pMEB-#Y+dRlKBTR{n7FzzR56W(g8*X>x
zNrUS>($vJo^=?RA0HCZ=0W=Hu9a<fyE*w8wVt=9DahvVUfQ`OF$#i*alkKgxlKM%q
zUE!m5p%mu``$>c6SLAX2465LJioqcG>UmQ`Gj`=hboR5Rk<}}kKA0Kfdn@}7PX=S#
zk;7qkN^rDmmr;FvbUDx(;)YoMU~YYync^=n0s&tEG*2rHS1g1n@Gi27JV>KRt2IBN
zzJzcv0l;aIbDUI@)!I@R(y5j|01mHsQ!q3l#~1=24RVe}29Y457kMeWPe^R=Ze)OS
zZ$F6oc#VKbq8GsQE`!W*9nX9^81L@eGVHH)MOBqJ4Gg&RdW$E*sP=FW1XPC{0s(tg
zA;{Y_6}&Lbw&T{p?zgmordK-BS7+wr4ZPZyd@0HqRUCdK_{c>Po`QVWPaQ56l+PDm
ze^d~1>A*@TFo!3tmNenk#essDQ(M*+R;^;4=W@ZpzEb{m%EL|7MCQVjMa#0#m^aiL
zfg~#wg0@LD=YBBo|J{sp^;lTFw1r3gNF{DV^9Ezj0RSL4h%e><j%{i5E8Ysz9ZZs}
zd*k>b`qcM?lH3CbN8D0QO9K!pDPjJDxfV)z$^GCG?1|bt&109v?m<n5D_o`k;qF0t
zRJ+26vD}P#AS!{aMJvq!=oTMLmYsBEcExCNEF}YS$NVM?9Kxv)fc{M?JK<u#uNfg4
zgy2R7DPBM-lMJGL8Pwj$eu9)Jd`m)|hxN*0mc9WG^yz0YS}t>~;(TC`?DG0^ECJwM
z+=&<vgal8H51hD7l*+p;zLaRX>h|zuaGbS}JXE#Q4s5o&1O~ePpb+YtU<iZ$gGB~r
zQ>Q73jJngk2_<V?HxBiSa}&VeY}%V!roBS#4$Og(i||Tv{D~P8@5;(02FR9YT!1Ox
z{uukOwsm7U0Z?O9@!O8*Dx_S(y^zdkTZVSVyR0UH)kI3O&L&vf2IU;k`ny0b+?V^#
z!$0L0K@I2>KLd6V9%l(vzOTb#Jw;kp@&A7K^8kGA?H2!fIS;<L`LlQ^UO?LSr>x8D
zfQ8}X?v8lZRoI|Tw@_VnV+P*cr}ZAR%gWEHrSY$)z1}pU*OzJLO7pz>2}Bj!j0h^j
zaX^@Qm9-qn&$KT_k9!~KnB$h+2E{VaPOE4bXr8fu4~#||5O34J?bM1Q-!tQlf4b{C
zi;Fq#2MbXi{}lVLc8km0RXgmC^&L(Kef#pz!rNWm&uv<a&!)Y;bMV)%eLv46oZ55s
z>ZppE!CIf}hj&C(xV3e`uPvx~Xz>j`LCZG2cj73~%r94V1i!@>i~t5q5JUJ7FqI1X
z4;HlX9V@%><{V^E1un~P*UJ#!Sh@(hEoEv2JYoJ#HZg6@>GE)oJ6rtyKUgJ7rTSa5
zE#y7K`Pa(rG1Ayt`Ek^;PIr=v58H+QHP}$@&HJko|G`w}oWI)LzWIQ^aeZLQT<yr^
zG5^ts_ZZVtk+<aa#b85c=&s-zzT@Y~&eVSIb^2P5`)SCUnvlL`>5ZZJEFlpCF7d0j
z=#u(-1C`k6lN`rRXT3{eFd<rZoqc2NmTbP@`W`=Wm-p&T(QWTf=yK0H99mnh)6H{B
z$R70j@&8~xnyFp3E;_Dhrf%QRpTiktwjq}rHz!^93-(?0Mo-%f=Hp{VO7?b~yl^F1
zl6~;IXAp$PE#?OM<|~9Q{3HBIT^-J*q`c9%LW2UB2wCAZqt{0o(o;)^BcsP`T6I4|
zeQmw}4z`TcTKBD&T`kyjo>yDjS?l-d-J_=9!;ZH?`DX+0`f%#<m!JaHzyD*59s3_%
zXY`f2nPTXX`nzIQDp@1RRI%uhcyFe5=VGDB3^x#3o0t+h2I!94G@9P`@TY-X(~D;f
zav<;h{p@$V2JY)pW(K+EQw>!)npiVh(|$%)X%+Ma3t3?;8-n#Rspsb?$3&kh{}~D?
zKYPp5P65IS+Jn38W+=y|gm&P{lhP26b?EiU_I2ySHDxBe5UYIbcx9|OclHx~e(bib
z0P63VEIM+kvO;#L;Fd}6+4!$HpB|2ZvFcIl$d<L+l_u}9k7ere?m638jcBMVtuqY@
zG8AnsQA)}2>s{8TSSJ_ybU#EyZ5*LkT)A31qgYgEm}?(jn;`E4{=F)6>dLM&C)bBY
z1gXXE=fk~I+qnmyYj1rU-v-7^w-Q~%e5k0<sUSLYP=Z}(avY!2ZkTJ^KAylQrTYo2
zf}_zI0R=~tc@uaQC+*KF$gTf-BGo-!<u7yj{1-JZW0Jjch?=gfNbsG~AGz!XqR&Bm
zW(cEghxmE`=*xnL2`+WVfjUcr$$rp8UKE()-ea%RC5y8*21$G(+mY!W5dsCs)H2;<
zH=`LIn)PeexQ*|DhghxpDIlp^n|{!+rvgyUTG|kFSPFCf5~(DIeR`h4RN}i010N#X
zi-%eRqmm7!DPsn)v>ppC|4`f6VSp`fM?E|O4`<MkU>%>e2%f~?{*G7v8i4Bea@SlG
z3QhE8$e0#>*+~e-kOStU#fjK;PT;GZBkZ;o5S-|X0<E@dbkyXZf#9=4x|b4m0WOCp
zUsA`g$>*^k5xcD0wUX-O6kRl+HHck(X5t;yDpm$x={LT-K#hX)%iYV3w3?f-m=0EW
z2sojVkpN^aWuZ&uTi{ox^!NPIb0%4To*htzGS-$EF0Mu7<~N<fMnX{K0RyhwXxS^m
zDM-`5;0hZ!#trr}_R8C%8tFk5g)f(`-k$8<vmA_4>L)O54c55t!%jB4t*w}(WHS4*
z^1wq?rayLLy8FSx;A__3S6qwMyBnXq!wU*XGin2XrcO9Bh<87jdzOlqnX^=1?}upH
zFpF4x{sZ51M3tM?!D~P8N<4gsqy@Ge9qKt{vD;DaUfzCbc^#=lUI!MX%)rbT>Z|c2
zQ=JI*0a7Ea0+XS@EScD`$E_G7t+cV_Zi1Ebgw{u?klyZzQ8q!^z+!*D|3nrc$V=si
z1PEu_DZUt~@^&0N`0wMDbk>fyP^U-a6p0r@jX<18l%5<o`Hhat9#fa8yfW>hSIT4`
zO;{mYEwGOMi<JZvlqnMp8}aL8NmSL%SRbrbJ&9C!hS3`bs>}9>E`VfrK!8~P91&ju
z0%o`l6F{*-T<=Ke6B-9(0f8{X$$_Z;gMOr0ZxL0s3_@;~B$*HbrPTTz1Khu<xWyU$
zT`b+@Y_WUvPvu5kSCn$ZbPC98i-F#iO?LPXrUP@_z*$j+7Hmbjs<8|V`jalo-3$ZC
z9gIRiQgc#MhfUWIpz`Q0=r=<L9h!XpRRTY6kfjH`1m}sLZY-v%_q-aAK@k<EmvY2w
z9B41J`b^KsN1gSGSElsikzm=KF^x!#?DYMf(dz9MK=u>p&opW4f}ORoCHtP)%>(J8
zDPv#20>OgWP2?h2#8Rul#lV6Of2SM<nrDwYNiu;Te+JGk<0}Nen{hlD--IUkO0cKs
z58$J4UuOfA5U<l8gu`a^Kk-CakaIdG-J4se1q{+K#+p?in7gn&K-|u{(;I-81A^#)
z85yofhvB$%v|Ki5v0F^{gBm8}{9C8&JD3XI3t2E{cfgL(LM{waz>&+hdM*nVrVKp@
zbK5*Vyxz4jQwY;e4_NQ#EKC9^2e`XrGhqtP(DJ27S0<#SC>c9;38wRVfk@FHTkUqO
zGlS`D`UQ%WNhGidkKP_3!>5qU45=W<?p_1jPJc2Oo}ibZ7M#6ORphA50xNe7JvFlb
zv>O)Y<a-fB>0+e3S8hlA=_lhnJx}(%7`1i@h(aVyct}ez{D%xPPn-{nng-a@M3Eyz
zx^4!(B@vys{%NgK5+{YYZtpl?q--)$fl|)$3BqqXjC#?~p!F(ky>Z5xM9gf`XBYm3
zY7P8zfMo9#&`(4-zRdFp11dMin$*h&Z&A<I)eJwJ0*KuThh(8`5D%Qm5X9W1=r3+L
zEJBz!Wl@K;aPAtx@XG2K!b3X_!gzqjeA>t1dy2bOZG>Rhus)K?k1FOLp5vq+$9s{x
zD-v`4fJkyRS{Cr|8Uq3;wKaCC9|$j(SAJL(3@OVyHE)*bK2**)|G8#Uv?xe@d15tL
zDs1(gldGhHItKsqBYT+$sYLHf?4Ya4DlE3Ai-4%{KiHWW`%0UNF(_2nEl)a&`E7J2
zyv$#6E3?e-8JMrDA@~#==eIma0wNw>uQ%nGSmjpAjqo)(7!|$zR>(=eZD3t6ODo8@
z6Du88|1`2S|6${HhYGBGnS6WVTNGvTj}gwZcqGr2*wc2pOJTmNcDe8xWiAQ=XRBZf
zTN_WUoupkq=yp&Dlz0n%-7NA9T)ceAx4$Q;%DOoCiS^COgp>H!PIW#ywwFuI0jSpl
zOq2rdw{bGleCooWojc!SpPXtQS~Q$-rh|0UEy({z#k;2GN3;3Fq(cUB#JnJ(#lEga
zX6EOiN<8MxJr{NKH0kV6Sut-6KD2+=_xz#tlFp?!e8{Cju_Na_cys6dBpI|@hbVGe
z6@r$EjPG3d4*3m)siePvj;zXr@Ar87ca>{eSwd*N@z6V!wC||?Y(LZmviS?+!;ky2
zIy}-}I4C5nR5mcC9xvTpNd7l&`=_&4vl1odYax4)@~NO3&Ubm`X7uA!$>n>Ch5MZ_
zn$cUvJSQMC%hN5$YNT|-yTV^V|G}((R0wSbKZ*Z?Rm;AywLWmtNM(R18_Fs|_Rwo@
z*z7%{U~cpN>bvQ~Rvu~J>r%#)*ULg%pJ5d}cP%REg(Atl1={=_>rEr%oudyl3Z6Yd
zkj%WE3j#)5n!hK@v@2fC?#izHr)@KiS>5{}@Ucx4q}(z6vPk1%zP_AMi(`+^$%&S>
z3SPF2&h4&Gv`kcY@by87`Wd^w#?25f;rKgWvb!bJM@J$DxM%76mv^l%taj@db$wFo
z?1d6T>&1g*w{FQHi|j{U*D9ciJ=v&H>CNIrVQM?)+%uPsVzcV#84}a%xCLuD8uRX!
zYUj)bG~9IMTFS}>-=m##+C~SVC9a{qb1OKa1Mm#CuNmJoD%p6TVF5*0zZo-4B8t5H
zZqS*ZsA^;wt_AbKir?J8-b*f1vYhll8Jcw7eGpZee$X9RbedBzwMv@LzV|uYaig77
zrgi1^Z;HVQy_x;k%PM41?v&o^hqh`#x1kGcJYX03Y0YCn3x03k_>8^L>)X<=J3(Gf
z4OsV9$XrO$6x_~z|0)2U-}6MB)bmCpyg>68co2b;i!KOH>VU0LG&yI>nzt$7oZvB8
z@$r3h$t_`ZDwaPcWQOd`XZr!X8#YSzUgJUs@6GLgG(yGZOp^hD&;f$vek%L?#>lZ9
z-Nb8F5<{QB)&iwtjmunSx*My6du}`g6{a;1D%KHY&kIe!g{nZku?}6hRW!zN9Vgh6
zMn%Bmjr49^FU|ZEBu8hXk0$p~M_wH@lFtA{QGdo<d^=i>5D;-F^1+%l!hlQHUG%g7
z309PQ#77;-%dP(7hC6E-a9FJ*<~IhLKjf8aXZ>pZ^WDe-XjQrW-RKd9>%ETs>Ct^R
zv~=}t%cn*|q0i^uk~g3lieb1$wp$zX-fUbT9-;?vAHH0YarL{HnZ}eG^A_962hDI2
zQ=78i@4l=E7g+rM8`N2H5(9^AP<sy=x2<qZFwj(Q4!(-}$FPsm>Ae7TR3`T`2=8&%
z3u?}0IVvgLm@zR{q<m#$0_!7@zh*7B7p@43NscNGUO`6_;LffxPh5`qcKYSDjCpy4
zgQPox2pD=hQaZE`d(YEUPDpNKR$q>p<7D4DL?R}Ai+=l=eE{{ynq;WU*UcB2;X<Jv
zobo1+WUw6>^swy*3)%O-sMVAsP1<}1BZ86gWeQ*r0c3N%Os(nAvFzIy0kp?-D!~FA
z3F=futq2kw{Tun;44Oups!YKvHE;;#r+X8p>a_;duqgNbQz(!N=f<AtO^i=yI-(mW
z^9SgR=YSB%vm=6K3z!Tv$Y+dS{4twLW5k=o7Juq+mI$XoB$`9vjc38ZJfJt01`XsW
zSocQ$mJ=BFCezeoU~;<hWhe9;2UL#Z4xUeQR&QCgAXEr@(_!@hYq@RM>kiGISY>nQ
z5C!zfSqgsLKZqnWT~_Z=v42O4liXjJ$pJUTqW$N%ktUE0Sk-o~`;zkCBfZ>lG?o7`
z0tfKQIRF`sSAH|r_D3^fG`kup@4m8%AeMf_2(O*bZ?l%_92!Le4dOUx8xR~t8E<nn
z%||m%L@QLUa3tp`*Y3M*?zI53%u=J>5HjQ-F0)W`4h8UH31HDQ9RP%*i#(>bqOQEA
zF@(Xe?G3ye^M*xPG_d&eF5Lhy=Rxv<zC+-viO6NLm2`bpSg)Wrq9Q;yFgLz+Jl}Zh
zMo6c36u@G^XiS3S#i4xguJD@z|IFG3&upe>OIc{HP){T)W)@0TFkXRH#1sciD_4Ui
z!L|-(DcGFxzzzm)9yEW}I3a|l^c@^h@p`5GvqLjhOJX;PZ^9-Nn-jMe>;xx}(0)l7
z9x5;A7c}^rAW#NV_@tMJ$i>iQMfg4POg9+V+2w4icUu9<k)yf=ubU%buxgADfu(Z7
zs^t%chq-qjQ|-X9nTa?*PaN<(ZYXQc(@2h>I!M`us|5V#+_|r=nf8t=UqRDt?*e$8
zECQHYWb+kgE$>ME#)TYA!$|Fvvfu~(@TRJgL~z4u$R!<l;QHp5p|J#QP#tI{iL#te
zH_7Vy3yk@ICPYn~`%xx4%&iuIlRPcMO`<|h28LnyZhXgqZ5&sW6+#hZ{D@k$j`qxO
zgF!Q$qAXY7X!mUbZEp~PM-Zb6H5JU_HU_f`wYdVb2JaAmJT`mbcaA(^Q*tmV+B>*)
ztaFF#YP4smcRW{y`z-qri+O~ydp%JO*Ztaf*R$b_G701vkkrBmzbD0*SA5vp^JE*j
z`zfaN%QG7spn{uXXL^&B?aqGUyFr+HOu&2de!QBH(es4)p;3FQRrFn&GUn9+YM(<o
zHG>?O-&C&>9zI(6O8Gl*LY-oz*UecKuToyQ@}sR;*nEzc@fzTArH)^=YrAO(5*8T@
z{-(T&y@GmA0e_Qx=DJyi=b>@%0W-dDSX@{06CVPUi?aX0u6B1<yzYj+^%S-$G!KQ8
zymj~crcg_G^3D`J9Qx^Cal+jF#zH^~uyu7zewNg>_|`pO*O`utJI_oL#y@2jd1TyP
zeY{|726Sw;#BZL-wQT0)zuYK6kHxiRpK^Z5ZqD-Wg(vCspF8>mjL?Lp+*@xLx9$6B
zPk?D}?|GlPhd#ofuk~?I$iijLLgaeKW*M^ZpvvQ~=O#^bZ)V+bfj?$BzJ7I)9k*w0
z7-3&puH?PIFf*Jm&t1yS8~^|aYp}}d+~<3bt=s#veFyy5P1^2LtjH;S5mx)XLEVO2
zRgdW@Bh4{N(hu3JW3yzNdt3H?Z1z%bVR+A{?|z}HFmQqUJ3|CDd^*Wt?*0KrhTGKz
zwvJss{8nN{byr7cB?9;SQ~1KNBE#wG{I|&GCGl)syBy|g&(OD0xSg+;Al*#WV9Z&M
zx5v4<1HbwS{kqEnTl=17D1dC2-Re?FP~`8w@T&s*uP2=Da7V7nHB)O})W<+{jJd<R
zp^Ren&c3@#`U=pZ6(y+2Dnzm52|V)a<(M}&$8T>9l-~35jGZ&{aGcL}kH)L9nei1Q
zvv*4m?tMb^X6oEJ(dB=p&r_G%*IQ7y{JE|U6?SJwVaknP3CzE{%>Q&cE+n>i<WTbc
zB_6ZVfwaS$Kc#>chmuEQu$GQJ8Advx%s2XaE}-b3GS&_KeAeeW?jT)I;KyzBFp`<p
zwRx=`8F~5nnIsL|?SfN=yXM#IkaOpLlKqNLi!?v|FMj@CO#x~CJ*fr0|IN`=V@ZZR
zl+*{aJ5>^$y}PjXk#cn8!|*b>rwNHp^SuIU5p3a7P3X?Q&IX<yKU4CcYjLEid-nsA
zA^U-#2J5~;Yv}orDAxEjP7|Yhtmwtr&Q?IX_0Q`FEZ<(#D#yAku)S(>Y;m>ZpKjq$
zK5tZQkKbX|LKc$DZ5f-h%p869)xu<6rOWGvZ{}=vagJ!!0u4BQmz)1O(8n-?lR;&@
zj@bPN!V%1XjmQT{Bcc4lBP@b8IVVC&0}86K@?}Bbf*ox}(AlbL#Cz^;Ds1!1odX;l
zsW4;vQ<4?+Yn<4zuxU|8<Ahdrz%)aqKz-<mP#<tie9i>|p!}mTzDz_Q!;FakD*=d|
zbvh-)H^A)K3<R6*jp|$?Z3V11C5e#oEpc<P%Q<p<hM8tm_q@&}2|%sELkA@e8AHU<
zz)2+uJT_N;1IVL@WrqS;d_z0rKPfK-3jz7IVB3dMzobxQgfNp44?PV2`dEJHx+7q3
zDBfUuWL%ln?ImlUWRZ&tL2jbPzPMy*#jL-j1_2HUf%0WnuRR3aF#AM#yNM}>=TCle
z<JFo0^e`)gYYaMn`hw-RCm>2*i@shWM`~K#Y94NBIzZWW;;A{+y+LSx7&M#8hz8&L
zYt_G}MV7zHvHiTVE|yPBGa{iei}|1DgFH()*?nc|{Si?M-h-*$;G}C6-|VHs`7;>Y
z?Te=kDJ0HIO8U-}$OHf_-V(3T{S+B<zQzxav&jl=Ot?t77R7<ysj^OA$&FF1(cYeq
zX#lvS{cm`bBr{94;c~TI(W8P;n(KqATgb&>4ke0~9dGC&oirmbXSWYBf9_YMK5Xh7
zclpMnnrZe?dSvm+1|1qY0q+vn3PbcWvsAho*gN{DgD3p9Ho&s^iK$<G1Vnih1pAlU
zG2hnp<_KvhcG1J|+1IZm8CP0voaoJYr%oDaJN1)a4%@M`e^WFI>f7;|qcaA)d*Mo(
zieM)K@+*>HJ3#iqbq&>-AqMc^*V$n#Gt!rz>pF3rNs{G7S)*@`94Z->SGk3h5An5d
z>~WI0MHam~Sayn>5{hrII~K|)H2-rfG<!B5a<(qd7uxMpFZ03KC0~<vp7g4Kt3Es;
z9XfPa@YUx25%4)rOL|=rDZA?agYa$2VPCU+&#5Ad*v7r=zjIT5Ah#82WOK_jZvfyx
zwlLaw$u2%^T(oLOSId?Fq7BYTk-+l({E%4%Z@24<V7Z6EgfrniyObq!@0cdcgfbYA
zM}e?0wCu-4>51SgvDGbE<i*_OvzmEg-%I4h{gYOOz8^n1Vg01hnTevT1h5r6(oE)%
z=k=z@GH)E_?pV1w0GH(4X3vpzMv)nDqDso3p7L@A*qZ%veJd8e1FSpTJAT0mIdcOJ
zDA3OEV^(XvVw)?lFdS!1BsBdB%`@G8DPP$}@UD~@1PEY}z_i2o=+obf#uLH9?^MT-
zWq@$y7Vi>(5rt&xy(0YNuVAe!aQTc2+ACGduWDzkjb#P;JO5x=8e?0wqzM}6Jop%3
zD%}(Ru`w+gCK>}W045vI$FIPlhw{M1I7Ir*UYO4>o+f~W1EkDDauJ@muJ}rz)Q}oo
z_zi^yEaGLnQVWmaaOr?dX7a1nEI+v>bdh4Ae9cl8?8RqscB*yy5-;_hHw$pU<@X%k
zO$$<ZDA%E9i{z4QSM%8LLKsG#y!&>dJVJ6d*EIpW)FQj*$(>tYuBOqE&UEeh#VpZJ
zCD|HZs6K}!Ii3Zeo&UkMY^vOl&opxYuv>Ws7{|%LYBR~nKz9yWbk~V)f0hmsYLthP
z(9m$!O_ynuda5-yZ^nSNOyV0~1_)&wU{wPtjn&dmz#d2L)JKmPOd0EC<N+2J@O6u(
zr`Tkob~x~~dBG-9{?JSU$vEo_sF8kTB-+fdl|YU-P)`26g9LNN>=k29g5h}uW>1xs
zRK^8m;c~uCcPt=d+&grLuJFkn^eCMnm@;BeNWyR4Pg}8amX1Zdi0rf)UQ=Ki&x-IW
zMq6jee63g1<i3^s2gr?|jst6#wpMo_+Nk6pAH?PLB!|p_;wI!UG&>aVRBC)YIf>u~
zh|4KJ78g)J3p~Sp#kj9O60HX~zS{e|ixFoboeWisY^Km*VqzOR#ka}iy%+ZGy4Co}
z6u}E#d1{!-txW1-W1;U3^*!B-6S>lR>cT1&2@fqEz3e{4qh>%lFI^AmFI2MVJ|Dy3
zGdSs9`qfRR^=2q%)GEIB7~d0cIu8_Hy%^12V>g~{Eo@*(5AQ5aR@}ATAAS~$mp&9;
z%iS9K1^ZSxkS(njXm_l9XFvvjdO82Ocf!JM3D9SA16HStjV!cY&n?yFX%|%R{^lLc
zlPz(sdS%+Q?T9oqF{1Z3Gzn)@^#C-eY(Bc}TzaPrsUB)|20~zx{Y%yBdpAWJ${39v
z>yj_K5huA!?az<j0^hRl$$)P^$!k4%Gg2l)Ujcc@t;@!!`r0daq;2ZZ=F1`w#(aIP
z^xI~sKg+&2`BGBs3vh$9)3~Kwc71h;hl0H+a+gO;M@*D&?M%|8B>wvNDU91B@#-@(
z<wz}LXgk<4MW{ptw+A>npz-RIZtj*OjCF6Onoqjow+-Hs_p0sHQyqvkoxqvRvqNb&
z3`3&|^_Q}pHd@3Ntnxk$2QOTeQiqB2-VIF2#ICx|%GicjhG-`JJ?6#q_<m$yIix!#
zGqBL!7Ph;uqo?Vr!oBD=2U_Dk^+-@p*(MKV<jKNB*}9o2b{W=tmE|{fZ$134LgWH?
zG?5)*wH4`qoANW86TAlc%ACJ+G?}VCcsV?)V`Cw9u%toBS`TJ}r_A4-KOuR#{!K?V
zE$J2&UuAQK5`?rh`rlq1^%s*lKhKF!9sovrHtTEa#M_GDxqlK%G@j~yAzqU^y}Qp4
zVsCl-K8{2z%c=Ke32grf)}=NxWA#+{pLy?pTt6TGGbo3xI3csV)pdMB<;*BJ_7a`P
zgd+pz<i>ml6PG5^I!LHV_UVs{g<Z`}t*yBWQBA7BbRGp^2F$x?aL$ifPL4r@1Mdys
zldu#t{Wtw~&(&w~CC9Iu!AK+PP>$7o&B25W7IkzqPBd8x<E3kVE|mm>2yY8OrKMhH
zUWo8lC6eqtg9S#$0N`_3!Y5d`?8Z|BX>hc!2#iJi7wJxv=^&I6hE445UmWZ7tprcV
zZM?1C8Q*eR*)q~BYd`=*FTAc-UXPl{l?NZ;wH5d|3oJkNlq7U*<LY=-ckq8OmqkXx
zJW@T6816}e_nl?iqdotkztkxoXqZ;{SdJ$R77Pz*D?B5{8qe*Vo0DO`Z!0-a@>+IE
z0iqKh-0)Gkuid(wTA;Y+NvqJ&?{yeTIaSHX_(TEXF7K?FX3Odu4rubwOr~PrnRamN
zg%>Gc!nH?I2$4`a2isGdV&%XC+%uz^+o7Rn%}E==;&GiZ6^-c%bnWti87uWe){%f`
zi+7J!my;v}mKhna2KEzxnB;5;`?FGUcMQMCR$xB$k(P84k>Z!P(z<3<oE{+s(6k_}
zZlbv`ixtt?Uoa>fw<I>B<twP`+qyWy&8obi1eQm^#v#$W7|jp5;(v}GyJc1&M}?>N
z_^$ZBou|fA6pEZ}uH}zFJC}=l0`wF#K6)M&eoyoVU)Dk)B#&NXuTiCUIR|@XQ$sm~
zYcT9Xwn8vdvo*};Xk@N$%V+|)<7RDqhgnlSOQXxd;v)6>s3WA}X6{~(C+H;xLPC=P
zyV#8j@-;x^9kL{_Ku6A(n>oxaU-*ATU_G%h3WP`oN2#CVcwj@}UExEviJCza8tH*P
ziWMb0hX3{?D#gvAI4XYeZ6|~9%;xFVydQ&QBa$~G;Q2+;`>!P_TuUCoem`ZDUbJ5J
zKO30db+f;BjTgbExi23X?SlM^cGB%mguOVlL-u&?>$%Jto!coS^gDI)Q@+b3O<E-^
z47<0uWHRro?AlHzJO&?>TLOd{+l)x37a&BT`q%i!eA=R%q9kSFHCWcA`<nL$$TQu)
zChv2;k7&0|0jvJxGS!K%<nE9T&L1e15%gcaJ+I{6YE)BGX6pj-p^AHFSM94<Se~xU
zZY<%j!10B`zR*paD);<LxVM0lP(DJsb%aWM^cr7V_N%KfoY8u7Hob5Xmky>V=pv9m
zyXV9KCi53e72nF?%h|Vo=W+t|5(hW7DUHd8r1p=agq*mI?zP{c*e+1rlkB62q!-Q*
z6Qj$&C_~W@!vjW|34NUi9*Jn*1#M+h+E<yKyhrDNipjfPAhbY7^-@~RB`dSb$wYq4
zZ$b5Tbdi~t!Wm-sU}L0_5ts86mcFnYzK8?J!$zi@@Iu7(=Cpnv_b^P(w2}lVJj5~~
zX@qPAJwzX(a^j>2em*)tc#$2OYS>o@Q-w%KsYDl-IScm5hHPL)8mK$yKqb5SUW}jO
zB;Ds#Z_2pN_ztEC06&U`FgtYsC2RqZ{gc%*k~0=;d(t|HN)swq$uUIG`yvL7CUYm+
zVQ2IbnSi|L>0K?**ZUYr;dueY31@hEGQ&N68l`L$?g97qZJ0<V*x%zpz>1X(pohWz
zH3uDiuz=*njWL5Il&n6KuaR!o>;p?8XMEKq^<WUVF&Ij?n3*`M!wI(mR;)aQ;L7Y+
zT86u~SO80(@<fmwHL%Eoj$z7`a@Zy{sdIHFC_~S-f;83z*pZp~+=Xhoax>09%Nex?
z1~zA=EIdf-Wr6$+LI#$xW<}mmhK7wOU&Z<AuPPL@+ovu9nZ+#FeG0$F8vvXn&VR}j
zXoq|$jKULJX#Mhu(HP{}GewFsfXc-yG?_-v(lP^plN(3DY^q>bfNuIsyypx<3rs2k
zu;6DbA%_eAp6~k^Z1z0Y1Xq;`Q)k->Od%G7Oc?&BU2ZK5_-Rqtrme#?Dc|o2>4>y4
zw0E=&Z1&1t;%*;bTE?4GOAYI#l^cK~GXt{W3DJk2A42-IUz~tS^=1mKc<ul<KtpgI
zMf>WT2TP>odRTgWb;Q3#pHgqf`Tp<v%c`~RD}m>Fhoj}3mc2o>o~^iVU&tC{hi67$
zvF*Ah-%#qA_NTNuUV45gy=NZgVUx*MU?R1{7r*St^d5Gu^)SGZo%z2!?pnq7JZaY7
zcg8H~HgE&GtQ{QxYdB7WUwGwOy81{o@*wfJFUlk>Lbpl5KEoA*+$?L`6&V+ZV5hz>
zm$gn-h|C*PHW&1c-=_{zI|`uVTyHjHKmL3qfcmm_@v1apV3xTDz12R?-#vJ}*wlOT
ztOt&rq`{|q3$@#pt8CiT8pZ5--icSg=RUo-9Q;*}Td9)b(1{9q21{IyEZVQrU#C!;
z?{zz-<lFXg6|$u0b)`#nsOmpW`*jQI-2R3w2?U1c)V5uy9{+j42)Z@_9;Mf12iRYo
zEdKtGnLm;Cq751NW@OW_6_kH1_>z&<&Njp=(?}_A1A_XnZ5S`INvn?VY}=Jm#yBA`
z(xT<#;;*1LKUUCQ9X}<J0YY=EY3rDn$@Dl%ycT65yB`o6ET0GNP3X<v*?4_gIwtbT
zYQ>41+rqxW%K^X!5WGEqUuUnbJZK5+x<SjRwtDVmteg5YPz8*7t@B1ZP8p#r_L@lb
zjX*kizLgbkT@varV>YT-`N|^S9Wi>^nr-Es5sLr_AH;jOm@8kzHs{194ofV^_e@)-
zKG!?PJh0=6SF=tG;@(`2g4bfRa*eo*-VuTTT-u2^4g~E2*CDBF%HsJ0w3k|$=S0KK
z?j2!*0V+x$<=gF-by>P{%$meAlJYfXpbKHh|9NJ(ON@d4=f)bPbg(fM=G|c|nTi7{
zHkT<$ya3?{Nc?BQyK7v02Vb&lHI0`mwXPU8tX5G<T^Z<iDyma}W&8Y`6d<Yo5fFqu
zy$n@k@g(DWUjmq`xtO`eL9x7FtdjT^#{eyO$FNthhiBMB7<`(x?eFlp{2jyAhkpN&
z=jTqm>;iXliu#dCrom+zyT#dbE%}heB8?gZy-j%cAEV)(2cE|0yn;pDGx#?gd6}tc
z&6s(Hw9w6_%ILL1qK{^i!}*{S@8cngPSJJyu2|4+NovE;9;h6!o6QIB^-J&6(-%?`
zU3)9P>%2O$1EUM=LF<NQ7oPMNduT2r?vZy*Y*+Le_RCQKOT%gl>vh)ZHKCafZ4Yi&
z%J1DgfMUVvxO8~{u738RrJvk&Gx*Ut%viT8a_)N$;L3x5%6vI7@e1_rriK?ekd6!B
zAHBcb*#0)wiPrt(Zs6?=l>?K(Ggc6M@T|0-ZcIhBtWD2;7i8@Y!BviAwJiP)(O{l}
zvz3Fxqc}_?{-Oe&`a0ut*rD!;%=mH)mSuMDJlQ`NMBqcZ(SD(-=bk=wiHJRO7|DIF
z5nlEup6my7#^F7^P;mC@Xu`a}g8c<F*V&RZ(I4JIt}e&*QG>i_Ff0TVSX!8Z#{p!Y
zA#z&(+)!^?W>UozCpMk7=aLklnygtS#IwfDdFWKfAYLp-!gOrTSl1hPn-mJS#!^#6
zSzFob#)W1NrgUQ>Hhz+k>U^e8A0GKvK~I#V!gOyb^!GL-qPpGbBl*uB`XOm*%3@J^
z)6ejz#HOnU4K}aWb#pwi3fi6*Y~kZSmFvZAqN3BE)`I@h-qV;lx|mynnHqe3%+q>a
zl>6ck*ijXdl=GGdhk?<|avvV9)vTKdFy@-Nv<rHcRGe><5y&dJSFWb;%8r1281d6%
z))<sP?af{s^UFbRym?&GAB5r2|2qEaikM$y@99JI&>#;>wrhL+PGI$P#g2R_XsBKH
z9(-Gjoz&?`XmeJa?!K!tJ0R?A>?>KQ5bs$mK@@Rf;~0?~n*M5dlH5;Bk;lV3nF>!o
zUVR=~EdkVTImgxla{=Ab{`yFfS^9JkwBP+Ig+0)sHS!xHmCf(w+y}iiT2el{cv?fM
z)5nc>$441HJ4?3gfDQtlFa|6YkdeIrUW5-uUD$Gf0*qIp%t66a6L@)+`m%O$Qg(Vr
z_9hUt&2UR#XHfd<0HU!BeW>!@NR}%t19%y?MD{xlz|BaG8A`yS0gXmf)KQ&Hh3!Xv
zf^Q%(tjqLaW4S>uWpDs=1wh%$mt}7#J*SlcA~$g65dfPk;+t&aodlYT5h$Skc3N}C
zqX;6Ln34teW$z5mCa8cni54x>9?k(=MJG-&S~9^zJ<@nCGi}9fKWn#Zmf&K&^+G^y
z_|as7*>+VZ_$L{-@@|9{T5PIjOroQf-HN3!K$}A-M9+%oVDfNTqVW}vDYsf>9TF}R
zsLPS~MmU4YhpOv^gK6<>8F2lD5aarYR<<FqTmkjMq;>+4r%3CTIWt;X6XKui8xN!h
zH47$i2w~lukTKL`EIS##h@90J*d~eUfS{e0KcWD#6Q#VW(2r7rZ60Y580m;VQdvxy
zlpPEIJ60j=v;<Npl)xKk$2Vna$dtrrtS-kl3OKtSVJ8xbhcEepeKTscT~hiPi>}-O
z&sE0JN@?j-Cg4aT(nUEy2t=tZtxcCN%~<!(x;blX$cf`gMqLDFEpy1HjzE5)R?nLT
zLIBA~(;ry^Bk(i6Zl;fP@fiT>$ocR@L=D-RiOG5ee)-D2Efe6fHsdGC!F?E_!;~8&
z6IQLj=oa*?yjh=1VJTywtir9kY4Gi!!eA;kijd9>FXd9|MT|h*z#I%8h)D$Lesn&3
z0<TPv@0NmoKd*U2&;k>1d#UCz+oQ@*(O@R5yG-9a!lj?weGlm`1TJ5^d(dj#$Aog;
zd5ImuhN+9s4Fs`ZjSG5pSeYx%<;dMq-NWKD?4cOy99|jQI>y=38Ry%;IQ5KK8#*Vn
z)!8<7(7O6CFDpycEvNpB<7Sy!y0~(nuNQh>j(QuRZ1}JBj351G!nvjfxeXp4SSK3h
z6aT{Bk^B<IfQfh~(vRQx29}b)Wtirw2X-vD!a2Z1kv4v|{ZxD6YIkUlQbxJ<%r%C5
zVx>`zpHLkDd-qaAb~+zw!)H5`^2bk`{3=I9xcKLNi*~*=Eoj#&FBV>xbY4CNwfa&=
z@YS40W3%e11tf(Krgq@lo$fMEaTN+0qTHFW`JU}FY5BSQ3Ek9F9#7gb6NeX!rlH<I
z!KHn{U|MJ~1O~sRdtNkBlfh4v{%B!g!L}S3RpBb1cmRhm3pf^^GRLLse{undl18&@
zQJ+P5*YX8irq$mi4`Tnl$cMB#z(vZ8RFW$V9%5aI503|)(?*^(8Xz<S^pUYayVf!<
zw(r8h^nwL%8yW6VCpIWKhyup^1gY_LPsj79Mn%vrhm~0NwrXU>YBTSbvXR$@if%^Z
z1YVzks9d%n&jo_}A@ZMx)8VDlcw>9FW^RK}zkW||UdwgsDPu@?&P20f-hCk24CXF&
zmx4eyWfHR}Q-AMXb3&~4(WvFBt`!9HHw24{$^$1NOoMQhOVVSyKXzmR8U5UUFp2D9
zuuT>#$9zoSMp@ADaC=XTZkhV74v@?6o}U|}1m&Ld!OAUQ*d8z|Bi;hFI)>OC$i^O}
z5--O=dyb8Xgcco!3xnw)!11abR|o{z%`Xq=E(!*-QO1sSbQ9m`^#S*Er&{mt6>mQ+
zd0Ce|Ie>Na@KcO=gTRwUE+3F}Bn^m#&2LepcOPx5E_`kIJYRG9fh&->yyr5+yV7k}
z9)A=M2w#{iI%!%WT2aJ``5zNA0-LUfS1&`WQY6pCcBKrpJY}{lcmm@eH3CenVv&ct
z-1U#In?DC0Jr=)=<3@|<4g4rBCqmCL&@T)5U}k7AHk1`_rL=^1|3UV0KX?2nDtlri
zKMjOTY?;yUD6ZB+yZF-X1*vfjjG{ZJir5vk+5H=u9oy+FOE`VtcnkYSE7(Orck9$}
zB(qKzLO;6jd`tbg{lQDQFZbQPL(!om5ihjhb$UNEduhPU3IvT_n*V6II!Eo5a=F=Z
z=nFv!nfid5R&Lf6uV?pp`IkyUUVjk&PJg2<lS=)f_9LDgri?e@^+t7bebmCseq9()
zIBkV2099Ea*;dh=8!A-R^`C-loz=f#fj*3cQql7@zM*je2ipX)Kus=PyHD^v(XYd9
z##$m|C!u;MhRBM#2)Z8nJ7`h}ocG0McoAKTj~%4|0xax^ZXHTN#$|1%QS-!@Yk-9&
znv&Fh)h%#%{Py*S6=<K{=h`jlO9g*p=I0$t6`jjx{EH-|C1>WL&#8)*BzU0-LNbcm
z`^Jd1Q}cVSm6}G+_-8cN`o#m*HXT}-96kuItjQIa-&F7R%PXn6xldzA9lSiyGod`X
zq8~^G%8Nb{5p5Tq8b0-1jy5ojr!nYi8`Gs7jZvwmG>izpC`l5!{&@A6aH38?URr?o
z7TNZS#cnhO4+&(%?c5^r9`t#gOD<h1nMsu>B|J87J}iV=9ry|-YkU9sZtvLTymS;W
zs#Q_ST<^mb3ytcXR!)FZSBS#dlpE!4QN`Jck}*=iEA&M)!K^w<qBM;Z3`SMc_NW>m
zP!BZ;8ViGo&V&#q`OhTwUv$08gcGqKdyMVJh@m|GdKvwTDz4lbn2fA_jXe{ONOTZ(
z0(*fnYf{G=vsytQ=WP>*SV8;d#5UyLd=;1@R**h-QP{3s2c(&k5@CAIz<URn(H%O}
zYSY08sev^PNK*U){J|{ASkaW}P=0pa&+tXr;RT9{(P0*HIUBh#Vy4F^L{XtFano9x
zG69q1OQx-(6d$Gi&FTF7_3n`$LW9YQCfQ+dx;0nD1ddrY8-E4|%BcErGUvG$$a|az
zhY_uuP{#Q7R0M!Nhb7Z-TW-ewx*G}VzNGDOyso^KevIV!L>#EhO~)WSl{N70Apk5>
zT<_<3;k2eA03beu;ULiKNstU~lebT(a~#NH!6!T}Zy~+IWXA?HsX^dE5Ie^vr@`j>
z=0Fde9iI4-&j7gw2qa7Do@AHX69=G2=^EI>mk#Vs2UYALo`ndb#bnuU$N1l)!(ZhF
zf&vfW%)JhJtRsNJsFIK|ZZn_xU%SNU-8vjtYwH?xiL5|J&-qW8k!cseTmYnvNnoS{
zOqVVINpO>&&@yH4Ge~A|btyY`QERs&W9A@;ab)t0$9p4WoWZAJYmO*eZ<HPZ?G<pS
zD{>&dJI@IO(79+pWyF<x+`~>PLsH#))Pd(3<-S8VEI6B6cx0+osNYy74}??D&_fh}
zO~I7G?;Lz#T1^aM5zL69EO@yWaAM^e--ay767W;_pS^pBj#aFSFYup*dG{uY)_)IN
z9?ZM3uD^&lFpE-RD;8=h-rR6&9T4M{wveu;g0RR?q1MJoYc?7kznmuv0HpuN(b>l{
zz5aikRO{9%Dl%5-G}Os$*)XF{#$t0%>WC;el`yx%KBPElhJ%wdqnNpAsS^j)qQpo{
zb60ZPFtZT0-248ne*d2Hc;qp)&*!?{@7L@3MCB4g0Sa?<LS<wK2;t`yBScV@E(<}P
z*T@l{O@hs&rN{M=rU7yXRKpPS^`-J4dr}JfAr%88dC~GFKo)9BpQpn;{HJ<Zx<Lb4
z@=?71CJnyw0lORAD2n*NKzQ~lVpR4x$B<qL8r{>8+S_|FqogM{6G7Q>>k?^aZ&j=s
ze!BGU7dwElx7OSnYS-E9lhMo3(u58QCFei)m}L6VAJb^SqUv^JRD%+d8#HYyl@+Ht
zcs-ZmC^_!aSQF>yC3j!yNmbs$!$gU*ffp}w&@<~*&H9P#&7{(zRx<eID*1w_2{vFW
z&bZZ93ffLiU2!qphgCZBmfB9fl1fM?cbm-xJg`=bfD-xKKS&>et8b3_`atS@6<?JX
zxPw)4dzFj#psh7@a*h%QZB{Dd^KXj({7iX@x|iCZjVefH58xuQgYm~HPM0t^9jWY5
zMAiy}lCpgKWRP##t&h(bssDP@G;jxq4HBDnO8!fK4A1JRg!x-?<fMs%P5%873Em7q
zC^tgL#-97t06bPbfXh=|54S*RJkBhRE?ApwDZ&9xz~{LDMf0F6z(>tO_|$pG5%s}Q
zU3UQxD)_{_M$@}@SO46EfL<(sCTn(`4u)q&HR?QaiI^7vHwTOTuEGjX8qI$@#6gYp
zWi5c@H%%i?YXca(ncA7j%&3(D$Rrd{cH~ZzGkAfiFLJYlzw>`|`IQX!V%_s<DF5sx
zwNo_Cx}SL$GFX<raVWfIuQy!#ZDZ8pU+42(;yGb|5))zORYB(Ey)4HxltS(+jgXWP
z|Aj+`NBzdi1EY|HqCC9d$)lxY6o=eAXz+W<a_3*8vPXD?LTAqt9qAGrBD|dlDz>Zy
zEC=mVKg_cuF9XZB_BNSB@OZ3r@2yp~@)~<g;^Z~u2^%}dYvlzdwc6hE7jjN?^9h+S
zg)wCx_THnn!4J|i*4Sy22BP_}@o#x8{<M<*0G5+Fy3vjfS1+wux{x#xVrSr?W1@{3
zQx9ZhC<em@Ifvo45WQPT5x$`+QI8Si-KsjBSP}R!+eB1M+!^*X#o>)ZFQVtldmn??
zR8P7_)q`(7!K*Dfii*OwV*7l~pV=y=t96YoDrC=}8XP{YX=Lew>aS5D-PBQo%|Sum
zB!5oK9e6e!Z0>;fsb3WvP=o3?N287EBTbWw{Z)X8ZxXWXoIU_@R{tby&&+&Vh#DUb
z7h=WW99z@kKws_92U6=+yCb8spMgYvc(y0kMg(kqs?D+)TU<>37y%%I-FkAUlX4e8
z7qmTaV(>QS(1&`(<e7-_=jg8sX&!A$)nV#^zCjj%`t$m_ExhW3#G~n5-PU=HDqlU}
z_!FqoXPxg+$(c)AC~qoNL;9R{J3G}6fB3uz#Vll5GV!2kLEN9={#jz{+D@VQ2y!Tq
zY!M&>cd}XgjBIZLkZDOhXc`SeI(m9T+G0yLO<r3^*pzi^y+ly-R;rx5SZhX4ia(aY
zcMue6jw8Bnp(ji_w_w`#9is7`tw3Ee4PFJs9<~rrAKL&jkE%vm3b2Zcoz_369785d
z1jbG>w(5CCcR=ak!e4=na>O)JtNbY(ryE!%tk7iER9x8UzI3qxR{mUrD4eU?e2Y|C
ztdwN-6FiNU-ClrJZU)F`9Np++nns8^m^jbm2L2a~^oYQ#Q)Ev^r=h61)Cc-agT?6)
z<2i7Y<Xk?>VPib4dZ*oy>50mI<^!z%ulRGWyhww4_Gp0NTQDk^;vt;m`-3ozh#;_$
zp4BB>YKq^#zNs&Bd|d=88bVFL&Q$=S1HQTz7=z>Pl@!Uu9fIxm25PYW)6}eZdNg3(
z2FjU+8-*|-fN47bu8TQa+vn%^g!)T=y@6gjQbGvz#x)`dUhSph@(&XytElD9XWPh`
zcRT^Zj3zV!4oK|8Gdbjkv=6k^8nMmSQnBr(7XAnx#EyjLn%ok=1K$hKa@4iqPU}X6
zrK+A;$-zQwY1DT(kcNl!-8Vz*w%E=$bAUdtzR5~No;qJDdc0aV{j+oz80uYmA6A$j
zl=V2F-&8RG!+I-KFA>7h+VAZkhIB-*TKWq9G0%#a)S5PDRz6Wk5Y-Xvtv2CTN#{P#
z_oYwkl0l^za0)Z?&n%R}y98c2!_-hK3P7c7GD2p_#C@5wQ#Q1am7yPpmK@Wdm*zf#
zhy0eV*!Pa}nLX(|KgN|(G-#s5FgGbwdjcddBZUZV*%}FNerkO;&r%#|pJ}3FOL6x~
z#f_+tmI9x;ru2M9+)z_`I4D3NxvPIhmwEw-1faTQwiL*4`pWSUR^a={4cLr+>(r==
z=+L)9i}4^I<u4UVETPlu*b?DQCr}jo<>TUPP^txxV#OGT&%s)lrD)|Ho`o|Sm5Ixa
z<ir-12(%<E<W>sl(z+9-Ac_+WLOa|NdCbo#f{Dfjb|7&mRTU8nq#WwY@OSBShGONL
z*NRz@B6Tf!+_1kMU`6vOXFxQ4hDo~QA-}yHzJU&fbj9^KeN6xp2H0G|BO5cP75IaY
zd;$$gT@w!g*Ez$dN?|g<a3UZydZkKJQIt#iwyGWT>&&tSjG!BYtK)S2)jze6VN!`T
zMbQrYXpKt7%_+hbu(8qL#@KK0%j_(DoSvT(o4V*=q3#|8|EP654$pOUMSJ2!L}-97
zytG>@zuM}LT46~cDlI3x<XmjSAt3ptfaG}Dj;!b751GkFV!Ktb=2OO~kWp#L^M8+m
z-EM#GR+Y&wZGRZnI4;i)agFTf7hZzEx@q0bcMrg&aE7F!6I#d8S5(LZ0(iJlqWPNk
z(0lY=>%R?|l(6DwV-)9)XoM4_|F#($kp5{iI>^+CsE1iUkd>G*7jD!fr)$|$)?{$j
zZKD6A75UC^_df`QHVZs<a#)55Y?>hIMU^z@W!FsW=SKc8-mBUUZ(Hhpey7}LjBI9X
z5Y!lNxdS5+Wci`SOLnDi{n{NDc>UJxDbe2PcW(HG9(L=Y)$2icBu5p(>26=@#1DY)
zYBSGLP^rJan&3c#Om3<o1V53+vysKO8v&2gM$*dy6dUCS!YX~3ie$#&?>JEXQ^>{q
zEZ97s$P2_qPvK{&%E><p{sG)<0pjZYXQHY@uns2+g+~Y(>sL{KEyi&H0dLQ_Ey8L6
zL(I8FjjX&h4@fQm2{2g2i1~S^MUbINPnZt@a~&%S-jK)Lx_e1YfsS$x&Et=+53haq
zV`(3|zx6x~=Okbhtuo+swpidiFI3}w9HP8_{RjL}eRubP-H1&RH(@(oJ?_{k&4uVy
ziIv$@Q_R)ZcaI_MtRl}o>YOd#op@(hTGFux)@;%ZO}M4Kyq4?dd;aRd)4In5oQiGe
z8T*p@36rk+`2{Gcw&=!go+;4YSay(!u*3z*C;HZH#|+QWG}(f96A@N>6amlbkO#47
z!PN{O3l)T7<#)w^;ZXA|pG^MVQzvUR&}Q2}LERAzihT%OLC(e7iD|DKGC)!UKRDW{
z0>#bT=kD9>lCTstW9Qw3S=D)q^vqUMWJHu(-Pn6EZm=$_du!H6d;K-L<PU)_O5dtr
zkNFdMCp}`DMJJTTgRo0as$n>w;Yb-VAR+(Sn`WT*d-lvAm-hROwEG|RUOjjMM?@Bj
zfJG~NIsg7**#>IfvB5%f-`J$X_mAz@9D*uT3j9zBc6?N3PdsJz0^|LI6~MU%!rH5p
z@HSnu+2v2(ir-DBMzzHvde;N_ml^=axntAK3f94uR%<Xs)izxJRHWxKFF!-Cd>4En
zlMq5zkR2_=@GKWfE77kEPF)qMQ5PuAKCcn<H&tpH7sk}F0SRwHc$E1NBYqLodhL6_
z`&B8X(KGd57%IbkVn}Z<1tp(M%pP$|Vh?&v4rp5Mo+JYgA1DfhmrYm#Kc=Rp{LAHD
zO*~swiFTDC$EPwv97GAtrCFKutb4ZT4^lA^$Z9E0&+}eKuoV~8#rul>aHFpUJd8^w
zRMT-u8OhHi*5%pT7zh4>5;EtQRWS(gWG-=6kPNX789YOPq?y)azw_-KJ~t@=2$0yh
z`d+l1KV~`As0$P^or^Kf5B}YcJQiBzGXIa5=2AQ{KymS#h(25euC^hUwMrYaE~(XE
zCk>(}D9-JQqzz?tgX)y9ikomZAEDun-=A7<?ax0Jj-9l?BO$#}MHt6r<BUSICKfQ(
zBxuk4J26JAu-H6GgzxZdDw}0$rrYzlrM^X7+j4{w{xmD35)_1I9P+awmIBRwz`z&x
z?XuIZ|H+M*r9}Ryz}A$^_a-a^km&;@@~h;w6Va182<bR&l{Y?<TXfqRcaKepu<8~A
zd4pV-*b1V04uy3bCa%2%&<u!>mI@%2FUiD>v(1vTNv1Txy7If|OPmu{`g1@GbCH${
z2R?&B97i{3h>|{y5CY9HYE~KA|3g~%eAGu-E<Y7zCIy7{IIW<23;y!x53BDTXEUTl
z(-?IvWMoOfrg|`@e%K$I%+bZ^3V^I0%F~jE%?6(}rO9UO3K`%5k*+w^$wg76z!jv0
ziuBlQN{>?hL}O-gmzkA`rNXK$uvl=_sq|ePB7)m+od-BPvVKW@s8)dNxGlg;svL>*
z0BXT(QI%FxOebkbcsL94us{MI0>kT<nfBLGr}EZF6U<11YX<?vQDq)Ha5F+wP#{$|
zpVCzoTcNQ5?mkxJK6><$E6D!|?gO$|(MIV=aw{Hu^w=ro<f@}7wlJskkX+X$;Bz*7
zJM0)fWqo<RGPa4{kbqy^UWLNL{6Xw>24HCzGVH`JVBxee6OE+YXE4tqvr*JrnJTra
zNDt`Oz1+x8lRZ!%11@t5)3j;9&tiHpZ4SgClXNRkEG?r!1JHtv2`lhkq<k8B{*6Ac
zNoyji;BrJz07hjPMEg=fpO)8VvAr*I5pQ%`s2rh!1|&3P(4b%$cjiWV&(XeRBBVwa
zH;K|Xs4)WgzHm#i)XI2IY=AZtL(dwl=n~%0Qv|;k@a0X)WCD8xy9@}PznYRR+WYer
z5_=MgkwU!4=JOiK13ier`l|?gOC=yNd3<e6{9x&2B+zev@=hT$8DN4Eg^Y*?OAW_)
zzH&S;h=S3IKWIDfzzHf-kPZt<oc<(kk@Te_N<>xKd>llOyLbW)V<{)%jFs&*15}h(
z8WJ5NgG?jKtcP>}n8#_esWmTfu~+G*zik%t!dI>;l65wNnUn`28SflS13pHf@^b|A
zq(XHQdeuRGE05BWr|(-nm`{hnIEND_bnMM%4rjO4YQPI*Y&y8-uF6p~UJHawY-vHw
zr(S3}H(jAdom={qIMPUvtCu*R(frCgW2X~|eB~Oi0u=K|?Ec+0O@?p94ttj<U^5j`
zU%wRi3Z9$m+p^a^IQr!IWK?FOr<ZZu<kN<v<!;Tbf0R%%K^PcnD)w%To8j6&GkxWD
zW$PEFl|go==EkH6>bQBfx6R!BzoX0Ax}YBvr;Ings;KdkQgmQ7{_RzFs#|D>SvW2t
zD@-z&v!&1cqNCrz+5X;;Z-0ZyKsr+`!FF`Fv@rjS?U`2~l0sZNs|wQWsF^T{^SK>!
z{Sk%O9{~niXTDY$3Da`p!9+!X04G%3?NDvpUm+Gb!z5e;?FS{iWPX0#=nVtv{3C7Y
zKYE^jo3W<4sXbhf1LrHK{tu9}BN0D==u>G<KcSw*ucpWmBO}DtHau!p(QGd;e+98w
za;RC2m;<SAB$=;%utBmaU}DHaWmg9MDL|*c-gSY4Nxqa7H{@}7ZK$dC81Kxdcg`=)
z*8C+LJ6R4Np#OXL_i_AcIpnbec{86C6<&BXE<%y@seFst{lrFpE#YigdP3Tb2j%w|
zil%P)_A;-QUqDO(*NW@_Y}Q?c)i9P<`)zBJIj(qsr`+DkgFK?9>|0N#ajd~#{6Tf}
z$%7N1$#>p5$Yd=*FOs?!h5jDBs*RB;r|yd1q2Ui817M^F?q7c6O<3*6>F+Q`0*rc~
zE8t0O+OI0FEHGa{v25|%!5rAXFRJ*Qj-L2!*|hl#veE4?r14$_I(!4i@aUBfiF?Av
zpHJ@^TfaE}=XTntSJ;!K&anxT`9F;U&oikyX+}g3mqTf-0Bgc;lX4#BERpH@egFE(
zDT#BJkN<uR`n<?!*m?ECa9+b0+t+uFvQV7=4QOD)k$M%bCq(hx541EH&qgCzqMK(N
z{LsR@uJ23?&bE6?l$oNP?nRlzmOrrU7$mAt3y}Mt98rr;gcAb1^IuXrNl*^B736Fq
zp?3D=K=&#}tf}+C0k0FgWU_)SLyJpO_E)T;f}qF6H`%i;Hs&kjez%iR0~-Hqt2p+%
zW?bKYslOOo9~7gOR$OxWrw}PWB=sv#-f#t{3aR_Yv4P*J+ZK}hpZI^J=Qp@H&_6E;
zZv+!i+^x9;e4S_D2Oq4RJzkAO_%Ato{JH;t^~<^jULX~AF``(v|Kw4sB^V$C>_gmG
zf!HiC*tUe>VycygzG)gg@wg05{8o5RI3XISd2M$@7VkfF(Ca{uB1wHRHcYe_5UgiT
z?b`L_!cFz%d0WlQHV;katwQhg*V~R?{o;_UZs!&<2lCJJ6)WnKui$lWC3c$Hs)7w$
zh1Hb8qmj4`RlmWIsrK2?;#HTg$$1Z;Z&#I1Jk+@rsR)QxNot>cxF-{a7M(!FOj;2G
zHyoL*y#7Vc=O57zwurvnCHO+{(yOlczts{1TrDnKG4SJkoR*|BCD<(V>}mK1hD<7B
zf!NG7j>D;=(xq3QGApmtl&l$$s<c;1`M?oFFJyb5`#~==aq-O+RXL}-YS7!IWtXGY
z>v~|#`Km)!OjR%anwGtag$pgV!7pVw&d*8PthT-*uVU|<h*p+A8uyT;>xGs$1eqt#
zvHk9#)wR5An0X|GU^z}ZFS(UqzO=&q#gdGi4QG8vPuar85cFc;9{@ww{@^A!ihIah
z+W*5OR2$TU-PD^%(9ujWy^^s9BQk<w5-g^5yV71+;Ed1M@LSpxN+dlAblEVd>1@u_
zRFF?L^8MZ@2e=e)qBQSUz>V0`Y?fkJFX=7Tl3y|fkr_09xxK4DZ(yhDO8)}O>xc}9
z`BeEqNjY#&?Juh80s8b7KqzT$sRvM|XoVEaFaEWbd;{CF3kU=YGduej<fKu+k%$32
zxBfNl&{IrPC#wi~9(XT47h8jOug@HiG?yIMKhKga1-u3koC2`NQBZF(jq3{l#L~>n
zwv)Aoixg7XDQAW_NTE#={Al{tp#qlr%MMe}PgFJg`MANd30SdEh>l-?;XWukN!O<Z
z{IpMt%*tO!UkC5xpyc_&7vSx`CMHi28fu0bxVk}=z#W-6F9u`lJT62CZW?r#7K_+e
z@t2?KI_`=9%#LjQ`lv|VB-a2(IHSx2%0Uq`3p7RxbLAAHBmz1R-$RRgfj41d`@N=K
z6-2Jw@R}V88i6E)Q&ZFnGxnxnl8H;X-wPa9fB*xgXlIn3i*5R4EOk7wGGgj%Jdxym
zuF0gs#P|b<yP>F}u}5-sLQvM|p$AhweXW>vl85fiM1arK$yEo;E+!)vgkB#eTEjs%
zQ}{@1!85aW+&@>mjs?%lHai8;^<4RTl19iB1QhJl@rUn&g1f~bysTiMc(!gPg6(@9
zsR#C?qR!IQQsSvu5RjQ?eY+=DSn&Aa*9yo(+kJcds!*gJ7))yAv0S|(fj3v|Xa(e3
zgr(ecoJ-+(?A`y#{Uw!1h%G{vQN*x}4FdiHCmW0?&ZC%+1X-zD#elR}3o`SDkGLu$
z6is^#@nJ^^51NO&S{Kr=YuYLBg&60_&HL%y4<4uI43mkf;EE)6^ztc~*onJIgn68B
zY5o!8!=^+{pxL{uHly2&ei$-kZo3L+6wjiC*Fek8ES1OXVuOEOa=i*SRmCpuJE}Ku
z5L3A9KRy_MJ%H^t`c??Wv1%B@X^UN(*M@?!w<}CJKgi0k<n^*nH;hSKM-due^+;WC
z5d4?;0$u)YqHI7->~PB}Bqi^q@rH6GhD_qww5N0~`kw>h%p@}q%?FFTg0klsiOs^U
zt`8)$l!b!nw3Kp~s*%lSu)BC5;-b)(KvoNE^{jm6TUd|?M(=8mlAK!w7qHSjZ(n3L
z->iXYRvop1bpb@8h5B5y*rrQ9?VB(cz*pcokyDnEUhYw=3v7=wy+39wk6#2>DKu{g
z7m*9!KK;4CPb6Fnc%%q0i1`n|y9D`~5;qCE*tx-0D#m-a=?US0m;+Y;`3f(aOmJa~
zf{=&6T-G42?U0#<8^G|rH_$GcGXZ`tXq)$Blsfn>s-!l6&13>CyqF;qv6VN3a*yex
zO!VF691cT=k5_T{yJnlL$nLE)I+RlN`{xmp;A@TV-!DJeWJga@nnMw4xUiF_`{yuw
zALo329Z{j-_o>sTUMywPM#-nsvLIQhoQOrXo;*!k2CXzM+#`_A=qlLBec83&TTaBa
zHh&zCMn-Z>k&)9~|2ZCjSg3CSBnLs-`|u+F+bT;S0-J(USaeF#?~)bU4>m}wU=qh2
z*Uh#$ZvJH9es6nXGpOcw^~d%*+byJRF8K${furVhV8}z|zk?x7$pwgg%ucnrXeE^D
zx;n{-zi~Zj^_u0%D!1%OqIlt&^@R6H^0qO>3wJ~(lMU8qlP)Bm>>|E~-)C1{zWAtR
ziAeS=-p5JH|ERa{CP|Y{@<`T<UhXd44BD@!zzb*j0I0~(8Xd-b!9>VkR-nY>P97vx
zdql)ZO1>T8<D$s9kbxex@?$FPlxSR5sQIY|a4K<&B+U$K>-t|0n8OJ)kVV+~b4|PG
zS4ivn3}QC-bQIW}>^-W#wVmo9C_A@sN#&&9V&fl+?->f24!?!nAY6R%h+&(r4?IO-
zWFBm;<cLCu>6ZE#hopnX?G3qev%AbIbSs`eN961HML=XXpX;|Vh#tg=;Myx<w?gVl
z8UX|aCnvgJ8Xpdd#;#pEeM<EV7mt-F8mo-<&`1lWtKGLVdQ~588PZzr`ckGfq*cD<
zOW&5sYe!QH4_^nc0)izY*K#P4r~vBo&hDSA4IAY&sGiav7=&{H^sm0O2xV|Qwy<K5
z^|cc`|8=hKY*=#o3ET)(#=kW`arTO>%hoFujm@~-q9G@=v?Ac?4j<25y~fte<s25`
zB01Nx)Gmx64wN+;P(4C2_FO%Fub0-Xy+3KB?!ea!^v$fxCDwUS;tTIw{eJVG*WCTK
zHGH+~1druUNFM)IW{}SNI>=?5bQ&e^Fn<!i0?89M{g?j|v!2E91+VLQ&qnS3B@bz?
z&pe+HjEWpOsTjR}g5i`f9P%eh?dXwV@~UQ)>Im^dvCeUNw9)rppLQdupP>uXG>9~=
zL*iStzWX5Yx&Z0OK|ys57G_M6@YkcWMVKMDm+}sHY=iI=TN)^2*H9v7h$GNt+hIlc
zAnSt^MD(MNRJS&spg06S*V4qkbZD|W%dGQ=((L*aqR9Gg5>~uC+Yh89LoB`h)eb#r
zB#u$8r=+<^j?~t>7=Ry`q&S%}v;6Xb3}g!kD%oV(iBKRZ7cF{JWIx>nGE}(TR#BQp
za?@)EXbfZJ{#o#inTI46dwhLkhdeHMlDKEv_a8T(n6jF7C-(~Cf8#qep0Lu{MTu=-
zlV(dz72yLQ<i^7_^yM+MmX<p=M<8@5#<4@>$AV`qV6z=ye$#2nj(;g9uFu{IkNK9)
zBWJv2tu8wO;MuwMPCmuLlyUMzw0YMc^=3|Z5qfk~Rse&RR|mvaSdf=sRw{stX^F~Q
zlo_*<u^d^n>NexB$T_$_e>w$go|XUOg!D>$P_o2YPBsC=&4`}`(wkfXZNzD9@{EP~
z0@R++AIk+?6iSEwltrV^C>g~4@6)5F?6CVK7O;?(!s-!A9?}+swi-YP?I##O9=OT=
z2vMiBK#IAi2t+lY1Ez|u>7%#bst3e`EAPO_rp~qFKWP8T@`H`Q6ro<%l!ToSCEQu5
zgy0lIsf19kF2(^yXGD>FAIQroOoMG>2>+uAc+t|R%3iaL2Sw^8g4tS%)My9kJt)uu
zGoK02^_gswi&Vuf7UwUJAdic&<()HRd<Ez`NB8w_GlljOJa7l(0w%E`c(!^e307+6
zKxagPBm<OcyfQ%PT<niB8U#VMX$2MN!HXHo2@?m9f)garqxdSI8cXnOZ7xK}^9I3j
z2O0UJ!2dMHj9FXApehezK>gR;0VMNh79HsWlnxkb4eEnCbWW$pU8JR@BN?CYP*aNB
z%lgf$0m|gAaJC-OSd(*bf+DNfR%v8D5Bsa9F&h@R%Ihh1pz}Be<`$-b0^JW7^|R68
zyQM~D{)ZDQe_+bB6!%vQ7TFuGO|NHPaf3Y)OD<;Ouj_26AXaI4Qs7)d;h5M-E)=bP
zY^yq?pWP(PnCq;sM=+~&D!`v*D!2pup^p9!c3%py^?oNaa~{>(*=98qPLY<`Mjq2(
zk0DZEp0}8I<-y>nBbUpDKMPaY6$2$P)e5Y0Ae`%&tpbD5rME`?#C?yvz`kF{XJI+l
z=jU)(@q^<<Yc*xyi7Y!A$Gh}YC##SK-Qb^ma=y($dFZKO)8s8%poZvsQZx4E;%b%4
zGDD%~RSA)oN-O;M*V_%AiP=1l93>v*$-v9btkgu^{>X|)4KCyOhH;f3*Du$|<ld(N
z<ax!IuJf4dKpgZzsG#z+v&r|tBzcg=*mf2FPvOnkZ5P)l-G|-3uP9cA*f#SWAYiQW
z9ISk=JFAG_aLbAkV#jX>`l|e&$%Ku(5T1vjY^6#g8b`Ruh#Tq2JrY6nX%^!Tf`p`{
zZHs8E5TlvBQe}Zdp~isgNMj(NXl*d7f9=zZ#U8}$2N@vxiw7TMRM&Z6*5^S>dRm&t
z|1bat5x194Hfp|2l$4E-aWAOR_T0zus|+<!W7t67dx<ZOI+}aNxMn}s@KT*RuS320
z?rHtdYXo?6=)E*gly_`XKU<2_U8yQX_Ip+(2mVj)$R)k03;M{cIM91?Nqr#8`Yr6@
zMIoD#11?o1_r-(7D)oC?jzl!l6;ziON?`-ae4&`wJTP@$?GV)P2oS~d+VLKioz(==
zH*sG<k#@V{{yL8FL1Cgz`}gT((16{~*?bqi`qC*2p}`H*3!zsX&d(zE-AbSB0DW7H
zynvW(XBO>ucu&N5b=jIoB~HkuLQS#rU%sfn&9jx@R=5bZW`5ISO=fBjN7W|#VoXHY
zQyAAXcC|keDtl_;b)eGsOa8&p)yMxn)l?f5cjSHzHUJ}C)y%tKq;<85ZEE-r*W5RB
zo^7y){pd-r!uV*fW$1(R=$RqT<qyfIF<f@cX9BNz9DPHo%`8kLz)|$B-7O+6J|nXs
zyyEJKiKWt}j}L2y9eus#Or*sd^alL-Sdz!%<EA*sxRav_+Bi&bDEz59)n<C<4rYCJ
zrNIbf%}W9G#HJm7IK5tk3kxqc?guXx0Rs?q*&g02$@H$BK~DE)6ffkKP#E;U@BLFt
zZt{T-eOtN`XD+&Yi-|hGaSvS^CW~D^tuGuc5e?0;A06s>oswbxYNykg%f_aeVvpb&
zNSv_{<GS&B9G)P!Lw93a3Tm&WSt*%pVSM+*vo57gS76IE6w=Kd7XH0<_4wa)S}Rq2
z%}2Hji0fF!jG7^yMSwH!1(&fX-rk2sP6u7ks(W=RuxcDzWpbmLB6aGFPfdM!!dr2h
zwek(b0qUm&-mFu7klrTn-#Zc$+x4Myl@WWj+GFgg9Kx`x??~AT-dnMtBAxs$<!<ux
z;vCuo&EZv!bJ4xAAUL7l%Mh&AU6^|0cReXqj;ZY--$w4vn_PZz)i!8YHuL8n89OxG
zemr^b_&Tn2@Kvzv2_LC;=7Gu%JyNR!lPz|;;*>due0|o%yLYT2^p2BoHYx&odYVkH
z)E<r<cqKRmac%i4N4Z)A(H+NqzV$!)yW&?<vjZ!bpv3+KgBY)>&Cml)*)aAkK-D?J
zM=-O7<M<vY4tu#p7z_lwPkXr0S)pV#;ET$nNrwV|)=PH;Sb(=(C7x9UCgbVO4ZrxL
z0ErG}HUNfgHfOR!;02unJ*@iS-BV%*zls5gm5{gjUV;|Z0Hp6A_@$;t8+}Sw3YEXF
zHs!cy(lJwZxTtW6*oOJ~7li8UhG#P)W)X$AIGu?$%oqW*BWqK#VmV(`#`Yz*{Q=i8
zFwp>xTF~%UnWH+?7tIXK7mJbrSiw%-do`p5;iv%*g0kL4DJ%76SZsegt&QJQgZ?6R
z7@d9Bd3Om0>Mo|Wqf%L^yc+E2qZS}sW5BVXMP3im>2%m22*ci`USUlL6KVDvUxQwZ
zwp$&sN|Brb!X4Ul(+&e$8uKh#g8|N}f9TVtR9FSUPW}XiJeZK?(DRU~HWM?Rb{_?e
ztJ_(_XPQ~U{EYv}>7*U>8~5Q;4Cgfp#|nHO0NRzE=;%Y<N~~aX*XskWD${W#Gea!n
zH<2JSkQE;}Y~mQgR~H-d2aO)67|96%L35=LIMV3;s{uPAtY9#3@$ZabY8y67Y+;Du
zxjITZNGGT+;b9yEh}~LW_JKq`nRuUbV$jVO(xpi!qSQ?~Upe9KE(JzJ8SUH*th-sV
zRc*uGL_sE9dq+eZPiQBKq*k&^h8-gj_6ndM2>$tiqf{73!8K*d57zPlzEK<InFoG7
z$forA$Zz*k+4m(jUmq3HKq|z`kVmYX9thxmrG;2QeMUQgf2D%p;XQ$wA#9aRS!~B+
zrUdslKLj7#LLL?Z#$A|sKn$5~%1pBbL@-4IG{9K#0&PPBLf&<3pv>Bc>j4q{^?@@C
zCaJ<mj@ziBBF3X7gNdE0GZrw!oR$cTIls;pnx%2}YZ0S|f3id!;e~b7%DP6NC%#Oc
zgGLt~C&4tw)%^>0?gu}xRAMW47vAbvH>lExU&W7CoGLOhr{B3|v+rB;*<qJaSm2M>
z3uU|G+8go-0@|&DAoXKS<!Xi!Jz4bMzK`&#jl=><=4rasg(}<f1tQ+#TNdfGlCpd?
z*H(EL9PAGwjh&WU(gCYAo3E9Z&P;?XRFGQY!My5zX{m(@>@Y*wk1alLbVD_L*C`D+
zG4QA-MI$>5WSGkKY$i2RDE621ZA*VHJD-il=}X+Upe6R%Xh6ww^bUQ5&<JTeibneg
z*Z`vJA2<0|S`MA^vuwY<YWwi1r*VOr3+_HAeM^O4$y|ZZE;?~JQ$Z|&T+~B}FiMyI
z*YPD1Awh@%u@<9`W2N-TP^+PDWkIhOBo`d<Z`TGKqaKRdVVnPBn<BEk!+f7DUC8Ju
zMBw`OhNq9cVP-36FV*b*?tSg^(vyarALEhtE1V=m)pw%{C5s!qwgpc~D+*X(>w5L@
zeNCVF-V}$SaU3NVw=EK)CjDnUc6lDCkOBHV6Q!8}YzSi8GcQ2%GZWSKaPrje3KcGo
z-(4OJ3X0QGe+f>HR4|1yV{S6C28j5=G5&_!m^sQa&{Dn2QA7_cyb|mPnXjh6x3-&f
z;_j|{7K0T4V}T`I0^cq_Q&4U2ORQ&mD>k<*JJ}#s8z9b6YM!Z+BIa>}awaqDT?lh0
zGF$&e&AiPm1Y2ar%nmwgepxCxKRn+h+Z%Waz!e9d9+<^mM9A<qfkTr^->SWWV25jC
ztTd6v)b5V2&)$*6o{EP}@-N-a6P)Zw<pQ>59y$A4*`Z-@4g0`^f4s)e#ajPcuNmno
z#+yEbIQk^@(zTaApPYZ~J{(tqg%h(9pOX91GwYk10(aU+&H(h{x^n+qzeZ&t5~o>O
z<bP)s<`D%lg|8e$8Es~9?Ug&y_Z^~0*^2$nUaJkvu92?T0dawPd%t%;QLJceFACwq
zQ6pUh&mo6B$1(tw&j8CK{O2|{L9N=Z1x*KL&{BM3Kl6eBonWj67x7eY>E*VkOS}O9
z>MGo4f5nu-%yv90EN#Db`fT$Ar8|1RL{PftqfJK!>I25f-FS;7lr{UObNRd?oX}L8
zw&thsX#CZ)?&JJp;N64hN*u?UxKPPMT+au=b75t6UA>=1%8sU`G}(t_*DLX%j}*sI
zpVE>!5RcW`6bvXeFZf4VgkVjHPqCnU%6yfw5iOESDpulcbPVCa4wcMUN9=go+k&+_
zG+~|<!kAKz(}okd6E%WE>C~ya+Z$Yrr+Db{?*{OJ70}Y>%Pl<7DbM?Se(qnTcwWY0
zXI3a?FH+SEG0sdDk?t>+LmxP5NS8!TsMIGz%GqN1VYPOt++2yTDfalGJ+#lYMn|)c
zZRpxf9K|3B1Mwlus>~n^kwo}%duQQH_|s@L?fv!$wgSt;;T>qk>nBtfwD(mOjv@}c
zvno4%V}&aoiB=vq4@zRl@qEs|aIRN0*_N)rYwb%{$mnEKGAtp!lc1=mX?VUT*Rmnl
zTz0NKfQ|TcIrGrLX|qn1(Ef!|VlcW`gG<!6*xRi3FrnwMw^ZT^_HI)SdP0_?uaQ%5
zP0%rOU$sjqUC_7T$g)tt)qQI4obR}`9MM0Ucl)~fQsWitEg8wrH?H)aGq}?7_Q}1!
z))!g_xwcrc=sEP+PHLd`NK|!($u$Wp-?Kp_wyFG?crN9qzpMF$y~)oQGsE;eaedm%
zJpJq+M14t$yowp^+biKQrt_oA&1NUgzZ_?55l%Br55z0gfYbLdN#*iRhrGM<&4AoI
z)$<rOjx!Dn#vPuc*dN>D$4qAFqRkYGx_lPj-2BE4c@8y^=Q?+dfLHsuCLqGo3quD<
zYY<>3d{8~3GOjPU=~HLjm@R-Fv3{Wemt}>x-wkUd=lZ~!?gN<FEAfc{j+J5>Cp=r9
zsfoH%i1WA_^=peA(i+YV-d{He=5+xNM(59ERMIK-3iD!mmakW^NmuNRpM?qZO>$_6
z>2_?@dEW@#1n%Kifn5=VyuwU@&0^YpuJ#H$qq&$)PUy?TK{Fv1dp4^%d%yI_4d#O@
zH%$XZ%=*p<lNR{jUxX>J6fi~~f0%m&iy%!lfbWQKcXSs!<K(5R?_3jmg{0spEYQsP
zuPa%D<?{DbUdFi${^1AhF=0@n?vD&UnD2v<qAqyz(=vI0kTWzbc*Yx@1*fFZ*tVYB
zt<9sIX|{e`g_`eU<V=uER8Y>>;{Oil9GpY<m@r}`Iip#FDWx8!^D+tbruoj`goIa)
z2YU4&@S>xeID%C>3R}v?O!cOCb|uykHs2A-3iIlsQqT||;3Hpxr2Eg629DNLn~~4q
z`*nd9h*2-c*<4Khx6H*?aec=X{wKGwFqJDm{_qPm%U4)!nQ|Q9tig2!5y6@!zha^G
z{<a-Fj2B<o!-;SY)BHfW2w*b<^`LnhCedFWJl+b;6k|GL=p+&WzTTQ*eR)}0s0rhs
zu0qR>Aqmamv&kX6iq&l(E3g*8wG;t$GG(E_=fyO|fnO1LlcUvSbtbOQLZLt`xc?lK
zZtG>(O|WX%qoNJ;0h5kj703ss_p<@tGfiS4Cs}mh8`Y(OjB0PjVElf@+L##6LU@Im
zPif@qf$@o-dTGqh!deM9f6Q1w4K)%$A`nyIsh|lr7yW35DLqfCu$QG=|B0NrPz$TF
zG7f?T`rIH0$5+Z10+sTHqA6}z>j8~Coqv3ri6s74RzQ6}c-3B0LHMu-%k|$JA*yYR
zs5rLUdinZ3O`k#<jh3+x7{1c|P$^%VII?i|qN}M>K4ng{U1Q4R4m7$l6ko2Xve!m!
zj6`<bn}pN&)kez5xDrz1oTG+UFMFAh#vLq%jUi8Ao<^j8<L%OmnzB7e=7AJTjFcq<
zPTCjF%_>)TA7F^C->BqfiQDN}K;8=C4}#32;@F;i!`R{nV>{cjZq|Cln9qDTYsCK8
z5A9|L*IFD-=zu!^+oAhmz|`g6LKJxQ(km~XHMo~nYoDb?Qh(W#^hs=Yte3T4>8j8B
zoD~ir76Kq?L<HwQ%dc3S{j`zV)w0g#;PT~8@0_dfcyt7B5L?yRrqW9Nj@Z`zkGa|c
zR#KdL!7y<*{sCgX{3cG9LL1fKmb+U2HIVRiuFO$$Gn6U5bmsPZsrecGw?WOAMuifv
zAs|Zqisi+gAAOnZk3_{2A0x>&`7G6?0Mi|m?gw<KWXLFF*>T5kD3~ox1RT;g1;~{t
zYaGk;RVYs9S9il@3mTyAENL1sjvy9QybezCs^ZQngddv%{>LQ`+mNpn%Jn$;o?Hr)
z>$ur842+Ftws{@mVJXgjm?j-tnXpQ4ZG2Q(usPB!*GB^`U{IF;f3;h6iXUiUZ2mvF
zM#sWXuq{V=k_h(Ed+)dpsJlm>e|V}bao51=pN4;`zlePv7k4Z@;kgNU@a1+t*ay=U
zMcK$@?^0RLfoeQSE!ey&#61Xcpar_SZkgCuQHn<N-ZzR#&me0ms7gpu;G5hPdaqgR
zn7HzSA1DejdCU`y73aS;54`Ew1;L!oSKipCy{>^DC}x(=M;5^{0MRC&W%F!g6&J%X
zgSdk^=3McjsmVgohS^t`lLy;Lgv$w;Z%ebn#Y>$QUk(d*3k5|W*pdOsA6rNxJXG)>
zj_Zpw^gRwf)QfPe$*e0~Zz!T5orXworH!WCpre<&BbrE_+1|^{nC=L(>eeByhoS$|
z0TPO1A*|T^gvmyiAXPO(R;v7yQXCaYd$WTR!;*9RybPVM*t;wT+XcWrd<=XyF?PZS
zLzQcJ5(x_t?(OU^hHRE#9&hu^sUY3v_TtWy*f-uu{q0ziCpf1OmNvcdTr7EunLO5a
z`)OKEsiLb*6ReYKN@HW&@Ly+~>h4l~76PC8c|&)jRRDHH1sTIKtUDvfTN|uQN=I^x
zq=*Af%&40m(l<~tEWV@Eh-!;vj6zY6-9?NzG0|moR1e|>-VMBF_vOLV0v+PE>G-Ix
zFDU;FJ!#igo->qqhWqEANi4l~AQ*Z=ycX0S`{~EE%^Qq)w@8SdsamA&V8yA&*kz}e
zr-moE*E|mE!9n@4C0Wfaap4+KVHGqEC-0r~IWjdIH`pBl+fdRlwA7Ol*ElRX$=CFM
zUJv(_)<B|165^`%X9R<u{qU5n*UH+Y!w}0zKC@mzs^|Sr&hxg*dz`Hke85bjQkYj1
z0;W}J&;dK;oKIq&LeE3+cgptKK=tkc4osHMxr|+URL^cDxX+@qXgVVo*vn(=k2(kI
zFS-~jTw7(cJcBVUWgjs?0BCyUh@S}!{T7m(f5BU+HMfsTy<XE2q%U#tbx2yeW^Gsa
z59j2O(CV$t@0eECuy0#K{`~Dd{u))XSiaBqU@ea#dnTLl8Gl}L;o`@eFG2BbIFs3J
z6hA+=Q1(B$cTqE*-3RXDKf1B55;&O*g|}_iTR<Cu>>|Gu->!27Y>N7y7PX`H#L^($
z9>!MQ0M5bTN|Y)R48i~=`VS+!3_gF5v329T{SF@%T8Y`8vh_LIj2>VK3|ixbV5h(C
zT&o^x(s68$?=n4$F+C-CnD0Yut}i%KcNbW-+9`^aw`EJIs;WU;tbdIn2;HaBMT-<i
z5gXUA>_jw9Bn+Rhf_b2MgOF!lDMpw{`&opZR~rR%p`7jQz}RqtG+#V=!?TV;V*tTJ
zygHL%A0q|Y(TF0Mq$g*)xD7GihEiGSQs^3^%8U*T{{U0>+<=u<P&J<>cR9&NH;=B3
zoLjvVX(lbEb9jVcFzTP@akM6|0f{sEgVC&wU=Jr#-nj=N*X&4pHJG=0WVI4Bfx}-4
zW_b!Tkp-~j`F?>$9iZS;cv$v;w-{AfqkkI~J!7G%nfA*)S_O9L;NpJ<_;WS6a;EbV
zf+06rrI-eYpxpHZfazM}e+*%2*L8hb)dU18y42l2A_|d$`3dqhLatmMH^9h#=Ai;q
ztWOkSmpctxR0~mbwVI+1MgGb;f@#;KxljMvnT7olb2f^82UA+2l*#y6BwZG$Ot-a2
z@Hd;%Wusv9$bBU%@J&`3DSbUNp^c?x4O4zl>^IE+)2tp~h23dr_RAI%>CkyN9ge97
z`n&?M9R?)lO$5(6k&-sl7-aJm1g?9zhvM5wn=`8e<;N(%o|3HLwFJse!7B~Sff5{8
zD)4aGD2(K5iX80!ofPWg7!5n)#S-~?TDWqp%9P;2*O?9GmDJ4%kJeu=u;Df26hEJy
ztcCIH6lEnoN=*C?<_3vqqz>Km(^42fLZ-c=V}_k#bTy$zMe7=cr9}#J=&_d(g=v(l
zM4*3<oLbP9(*XLKWrttOe%!qRP><7U|8!1bH`V3%6On5R+Yw>|=uo|&8Rw|tlf49@
z^RNmJt!HgE5#z)v=giOfT-PFg+XrD^86yZ6!`i97o019;QaZ>%?c+F|+cL9UK+j>!
zLtk^hRcvQADOTm4^3L2&6Q&607KGJ?tfw~+V^P#ifv1;Jsn=)wUZ*@W&%JY@Fhnig
zSYwkdVmMYf6Zxbo^UmncHh0(2Fwv45Vwj>lc|d3Nms%(Y_K|xG>mHI+dS-{B9hrc#
zz3S<TSs5t1!Ut!A;$$5?yhkn4vRMMTx2Tn7med0W%=SB~#o8(oqB==)#`St7PdGLu
z$Z-ZffDidhyl3S!P`%k$S5%8&H$?=ujCaz~zed9gZz<{c*Pgwu+s2D^+JatTbIyC2
zHSj1w=5>UCyN^p9CU6J5ovLbQTz`Uzf0M#Wm7C$!>wg7PJp*r-_8yc?L&pMo6BoNN
zyLMTYS>3qU0NMemwB3#N|L7+TOQ$Zh=VO2jKJ=hyZ0gS%N<S#Uy9fD7F{PRZ^SM3c
z>6Rd&@7gsR8nu4nn#tJ)Cij>)I44VhZ@Q{-?9_L+0wusk6e=U=ydOolGoEFUW?PRY
z|4%OF9|>NL?mp@i1NzTaq-vpU0-!^N@W5YZHh}APg|WR97N}FkGzd<B$hP&;8CwM=
zF>2YNUD2@XQ@>O!!J`o!3UL8j5j4kioQG|k_Cd7{CTyUXu}sg?{tU=`>G>gpNeZUx
zd$&&Z)2p<B#OR}<2{kO92C7o>-x!o|b?q7z#LtpksG}#di+MQG4=cIaO?MKR;r8BU
zPtOik-gr3fi5I+n@(1a0z4PbEVJfVaW1U8%EW2)cfy~S&^xjRHt`a)ml~#^DDrU3!
zt1fzG@Z7RP%Pw~&F?(B&gj@abWy$(&VQ-56GPwHd1|@T@e)_ZzY|u<PlR`0AEjgu*
zFcuH`sB_?yE#xC*C(J2ky_I1DU7Ac5O8p}>3Nz9v3#IX@$cV?Vj9;Tql81#m2pmii
zY-CgRemYjxAf2#nURq##CJkS5X*!=nY64ZeR3P?qesG+hSqI~|UY}>Uv`}R02MQ1U
z3IK3+??|}YPxWrIB6-F*J|87J7(zRktF9$&w9CdCIxl_>%S!Jq%SygJ5<6f0`0Dmr
zXK;vnr2gs}j36Gc+}Zr(;a^Q($oa28w$Ob(BrJ&T=wdoFCeAIxqsBM^9m!^ZE@OXX
zDQ)kJci8~)5be>2=J;js$-Ywr!cl~h;~nu^ao?+;=>HDL3ljwQ5o?3pkd}h_PF#?@
zin{iul*Q3F?VA6|U3u9x8nO^j6h6Gx2fMrh(-hNXu%l!Nzxj#YC?leTeyUDkB4DR#
zs3I86!Dj1DhPs$OOca#-9oy6%<Mz8hvv^-|ql8RTH0c>DkND7wQ8m3^eC_g=b@#=!
zYpvx<6F+2%k2f#5rHyc`t)cprfot0a==;Yx{ujnAnca;?D7!PNRVAG>+v-%mndN_b
z^4HyFRgSV*1&R~eqQ3jeFbR>HzB{qa4L0T(Xc3L`XnS~+)LR!w45o6m<(J@x?{~5Z
zyDf)+oH`^C{OJKCfT6D1e?SS5_Rqsgudc)baN+qnhK<wS_h2^?(xu$xsly4+$n<O_
z1zyjslqcw$EVnBw{Vq)i>5ToerO(id(@JOeAt~km%FybQ^E#{j2NLdAG!N*|SV{)Y
zzg?m+X5FhDPIM+DGVQ{ig11QbLo=TMv?O;ho9G&R8DtPLvh_?N%Z_8rdZs=?5~^iK
zk5P&hb;0B34;d5`TWq}Z+Jq}EDlVXY46mJG=RL1M^6)~p<6e1IqR662%VHvY<x-<#
zso83M_my_H++V@qs@gmER1qEED1P&m!-n8!gyNgZ^?~Ki-yU1wK{YTkr1$IKV}3Q5
zV&k+WXB#hH`~gDkUxcb2w>3z_N_KVI;Jv>xHE%jVJ*oY1Lc!y9k|}ug(kr*UfB43G
zo}7D;MvtL%d2+Ro4GjBzzagWo)>j3Ipwv-zd=B(+fqi6eGQwvjvJi(Uk}ch5sf&vb
zMe{d;?=>+v0C#&$i$9?qpI58E(wd|$0N4&V>rtdDpNkdfhRD`);x^;w!yQ`(7CWID
z#q|jx%XD_emj9d$ZCy$xT-MkkWJWqJ1np-lx1&eH*z}>JQOa_&d0hMe8|?i{c*HJY
z+L#3o{t^tBFVdKm9WlQDuTF@=uw){jEdRmPjse1x*Rvl4)G)vNclSFJ0KkLcgB8aB
zUY@B2+ylc4s+1%1uqBWv<&q~5KHLrkRlC=Yiiu$72nQsXOF11bJW6Ols9q?H*fj(^
z8$e!m2FXJlFx9{lZdMr80%B*}WV*5+NQ64Q70#B-H?zR?snV1#1a+K3kiryfFfa)(
zIwJb-REPd*(1ibtHGI1uONKkCpj0zXCj+WZI|&5=vsK!CrnZ5>XQ02VQ3KI>HUUgS
zq=h(xPKvw*E;6wv$q2WYNtY(8)#=EOh63s@Xx?o49<5wh0+gr#m6yiar^5Z3VZ$!~
zgW+|fTG5Yj5Y($v7Zdfg!H{mo%G`TiF;6UqTqwm`z7^Xw1R*2tW2u3gll{gZP*h~d
zrmPL|9n36c)AdbwYGuEa4;mj7;Cv4@0i5Is?XBW^o>5-1<|CGudJ{09YOQeWg!IY{
zkxUZ7LR-9W=LBGF6yk86S=2uRc0^LMUi($tBwQuoJR*_W{J`T|f|pM!ci1Q}$Y(dH
z?O7XFnQ|eLJAUYN4T1OXw90@z@>Q3tC@^K}>sU!UHpaQ4>qnsGr{ppBuGCMxrz5=J
znwf4>Ulrt-c@o1%o-y4u?sq1xwN@xh{KyUpvJwVv025DtD)5H2-c3^aJu}l|cYb=@
z<Zv!F%KATcQiEc)QS<<qr`~~mQ2gYkDW}vJYNsBYaT)hW;tBy|XrTOp^ISAI2GhIw
zn#IR+G{_`ahCOWr!*6v|ESEjWJxROEyTo<WURqvgJ6+ohqKlrgod>k{%raB0%tM-+
zwB&rrOPy(FSLz~)-gwu*%$Pg%(!5C`Kx9b9O!`}f+};7UhQ+%u-<URSdQu#rz(?g*
z@5?oO460ezscr%_dp){|;y^(08LMmTOIcEBSsHRsy6pN&t0AWQ{Qf?Usp<z~eP7z1
z{*eFvy?XEIskNDJ;y(=wz<B$#|N41z%eKgoS;gaXAvtGHK5sP{8C|-N;L;wo?ArML
z4`faBOm1uVL8g`ACA-^=+M3^H7x(XzY9aw|dkxZNo6UnsbMP^N2UFAa$W$*^7hD|u
zexLuT{9u^8?6L(io72a$J!~1_Q+<h_qLDF1+uqI6yOIk=W&fWw1+WQ}DZVF@kpf2S
zuk3IRJ%7t#amgG#nL;E50`C=uUq#5-c<&j|su11`OkbNWWV4LuI}d82zjQc5erS+W
zb4t6P*(t~!P|L8%R&Sz>bKZp<4qJIsW$%aL5R(<_v{!dV%Y?PxhecQENnc*B@=B&I
z*fYJwg4%n2W9B|hh8LcrKQNfx-@5P0(9r{G`b^SC3b;5%X7;@Bxt<m~{<MkeJjy&q
z_n*FZLVGDyy9o^SRZw)i2NX3KJ>zazrulYwwU}-U@P#Ngii3QQR*&g2`~!DVCqErL
zZ6B}iCcr_y)umM~&9WyWXG7Esh<ZsJOyNOmVt4<Ckfz8p>oF-O_S=imOogg5<EtVO
z^daxw^Xl=Zm<$t2r^i`SD5@&`Uwte@VE7LEQp2{se>Pp?T?4tsJ~0m}SaIesa_`1t
zmdd_e{bZk6yR=t9sWuHq;TQm5m;K8;USiLGRt5)Aq8W$hLYlO6+kf~E{q*kL8#j-3
zYo0P%_*VL{@LGQ0zo7G5a%7U?^81dfPrd&{nQ2MR2QjKYRMnwd7oL>v3JM~5$n?5z
z_=si~WBMOeXEs9;C!HUF_{-d%y#(U61&>D;#GYNhg~c|yhyE+ajhb=v8V)vHD3_0#
zh>2kJp@(JV&ogYYMuXP^XlSt;0ZfWce~^=`8o5Vk@2($qiGby2ZF^lmWfocX(L88i
z=ONX(#N>B0QEq$iH;42(kluTS`JbGb%T||oRK>|WYiK~-8Fke~Wsfe36KFAX1VTTl
z#{_Zh&fj?x(iD8G4ICHrsuUl8;k9<&=9J{D&-_LmBky|}%AhIb4&0ghG{4-NXB1;J
z@adHjf{kMNTMg+81<${MX=@M7cLd9$jQwr$xb3W&?#C*$xWfhA^4n(E$s6Rg>F#@0
z;=gySKx>m1=Kwz@J$zLg8-4QVUl;!q&NH(L<}g8BZ~w-tKPRaSbaWojFrT^ElyyUx
z;y)3k?vHEe{K2{$|8w+5KyqO?2)DsDKUmB?uAo-!S*4)J)d8A&!DFw8>g~ja+CN_+
z!Gx&4`yWu7?%p1TY22WLUK!A-jQ0Y}#*5dX*nz;xJZRgFBHFQ{BQ0|WMAN%wZob4!
zUwfLfK@Efa-FpDP{sN#k0{`<%OKte`qDVE`tjfwlTK@0TEyI_~4dzV3DkAPUjn0Ps
z9(v;T9A#TDiXJ1_1x~9l0e9mxsQ2I990H<TqWpU2Ka*h`fU<Eptf~dDkYcMyMGvTO
z+Qf16CoJXik&W{_iX(WV(wMNeG(f^Yjq{baHO#k$R{GJa_C@0;v^jInu1$Ae%ty*`
zj^clDNQ8?f4w(S+zv-^!NEDWQF8?R-RF@YcfjRywioXHG7(pi1upYSLfh|d)b8T{?
zO@3aqQSGp-WO1M)oV7U@I@&Pb+e4d+23@1w%Z`b+qAoS%z^7Jm5t(#~tO)fFP(GU3
zA6lhm`K@Khir3Wv+&`ns<>FQ={SKd-90i;)ilwKqADm{7-Dx*p)8CU;L(Kx+N9|fQ
zibhtvs8(#zA}=gqNik+AUQPRRBZ0c{BFtA*g%$y8!|!R(NRz)h-17qWSp2LM`F|Xp
zc|4Ts`^QO{lBG@*nW0jRr9#NQm26?`G)Y9+O2%%)lN2Qep{zqO#x6zH2^C{sW^Bnm
z7-O=J?7qLd-+$-4&MD_GJ<ok#*XQ$oCrJ|#F(478x-Y+YU~S<Rxa%12s)D8fP;rJL
zm$NtD|9kM!D)|A$#FTwx8F<BWABM5y+0V==^JnZ({Q0xNh(0V!G+0Q8GZED7&NK)6
zO+D9eT2r`aN~%9?AHYj;t8-XZ=}o{TozWC?-GYKC557>+5^D3AdZm;%+@V;%tW1(I
zVoN=^2MY+@`s8WgFab>h|J;>%38<D@%)y>swsZ?ma#N<w=5!;Ic1UyVzjjEW>q37Q
zjOkCtKoQ%NV}~~buyZJJ^z+=lK*$glO*zf+`(5+DB@7?hq(koiaZGBavLR3qKL!t!
zWoN-=A%=8_O`=)vJO*eVlmUIkAkzr|lZCoRbLdh{7r`=;jM$!v<3gzin>$ZaLJ@Q8
zU}(xI{eaoGo?Q?2D#D@bqAz8isfnfm7YjflkLE25R-8QgmTyx)bZmM(7Yi`Jf7TiL
z_op4NqR`jxcu(qz1O716TqK+U!j%M}TwHjR9c$VzM;=W60y4XzqVZU1LkaG&#MN=h
z*tF_AzU}Omoju7QpM*7D<*CBVsVzNp!hNxxKBQ{R=}&rX;8!j7DLqP$({MMot5Q7{
z-!hwH&$V|`e&?7gY?cA|X*X^ReDCk0Rz4WXG#rTCLqphypC*)iRiT+o_g^nRXM@RQ
zYe7-Sg(G)QV{j*khIJX=Jo|MoJ=Tt3ppUP^MQiOW^qvYyE<;=Z*1)S`(Ezd}1n*XN
zKkZklPl*I|gO+WI(>ogF{r*90-|1WvjR=CMUy#57x**v--k|daqP01Yp^elGu8<e~
z8>9LO+Q=_+zwW%C4%VJCv4-|opIG<noMW<s={*{byvo4E?Wy6kPGEo^51jgGD}v2?
z#0;m(BH}aZxlmJp$tM*jBW!H*fKIr3CdlsyhxDp{?xB<R_0sP7=e&ZzH`h9iJG`M_
z5vC62b3-Y*v+%M5rQJ80ob0a4Ods!IK?40P>7t3gMZdCP0gHNSr&*t>B2NZxj+}lw
zG<_E{>m8U^&rYc*IeYdum<|@T@`tx=%zjHd`r6!D1BrO<^?1lZU3uwNe1!1(Quh~c
zg@wRhmoH0EOz5~?O;s3(H1a73A|(}ptPQ7%XR%EL0VN+^MH=miLIlcZkb!@Pt!~2G
zbziiuJY_d9yMhf-^EZbEKBZ<GHC(Frn->oNIxj0Sk6sPV{sCFBiEH}KItVhuSZsP;
zrSAnM+CpD2>u`6dMEf|d4{Fz})t8%-diS|{^kqg$DCaqaiIB-VGMdL(J0vN5%qI-l
zy+7=mFJl916JrnSpO}a4A`bGb;h+}-i7wHYfwHqt;^I`S6EA;HPhFcA>(A}9RAXN-
zKcFa$&MR$ORk3W0m{C^uNY(%I`kI~^<?n*oG^X=PpxWP}_G)o5$Ry*jfAelP_qHq<
zjTmSerX6Y(+ETjs;r`|hk%;y>xWGh-#n$RqeSQO5<dNs7@)?7Qt3dAX<8Xi|k$>?~
z@)ZoV!bs4I9nKXiDs7>!DO#)V{4*gvo|25&`!SqqyY`(D^GnTt$ufoKuvWLBqe#Cv
z;9X4Bi!;$Tla2X*fv0jG?<vfL)n9wQi&>5!?6Bzb<=V~38Y>BQpczEts*qq$C9dQN
zo3!y!O);lKK3?h`8d^t`)C)~a71s-RH3LTi{=xW_R^+$hZD1Gx5;jYuy$zAP^put`
zP~6lJK2sXNr_PtyZ1%<JIoRt;_?N;J4Xa)^V}=v+h6DGcs#gEFT%~DVw(%33mon}P
za*@RLOTYw=4o7hMrgYnHP8EQJMJ2k|Pw3u<0;nWgER2em)M+!OeqdN#uxlFJ+_4U4
ze-HMauiww8Ii(6t{pomUr@4ESML^YI{R-cbyGIwSo=4+V6fo9d%t@)!$7Fwr+E-M2
z?t+t>PduChkaxa5PFr+#niiNDh>899ql<2Elsh)rfs6WT#_6E7K&{^v^x}Bx;IoWg
zXiqB2m36N3RcxC|$b1b+xo9r7Y`VWs?C6Ha5i!@#p+1|v<I7nmaD8<Sdw-^~ejV0G
zTp6r1DetDK?OT#!P0IQ8xuzecqAoWunFjGdg^bKSl643aW*x-<R^j{vNB|}8jj3QQ
z^dBX7(HUm4%Al(Yl7rt(U~TS2Qc%qO@px7q%4E;oVgp6Vc3fRwxcRcfT1|FhZwVc?
zEt=@Jp8s3*Uf4iEJpk5A9ZAZB1=#22nLNwaWObEl$OIwWVT}Tqp5~9{dg`EnH1k&>
zwS5q`-rE)KF=-PQY^{_3e8i?OqTuO(Cf~!3Ddjn=g@1bg$2!VmdZpoC$hC{!F(vUU
z?$B0{*+$;3Wb>HndhTP8z`hGRp>sDC7dXA1FLN!dytgvENj2)H9vDc|kkdqw+=Th&
zj3&pcGD=whCtd&YBBwE&qZdm(wiv*dMv~wAu~B1|Nx$_QjIqsnReYP2L|_BiNIWT@
z9oVT~hi&k?M8zU;5|FkKToHZbA`HB;eb$*#uTF#kQ-l~1?G|<o8p}#3_m;f0J03`(
z&uU6L-TeNunnv`Dc<)6A5UWc#WpxQ%MG*{(h_QVy#_?P!8!48Fc6k6O@f%B8MXJbt
zEH(To$)=Q`*9>vpM0ScwuUJ%_poev1?P<GiDYOr8b7<OW`Qy|DI~u6D0UqruMWs$P
z5tWTB*xx0v5ieG(*EZy<2hD}D>`MDSzyuEQVQO)y_^LC&M0h0KZy$t-P-s_}v%~Jk
zG~JMVfZhvWhfWwY>%mf$*K^Z1@(-A(GoXp<*|0DZ*gJ;Fgqp9WI6<&wdn1?I8Jr(L
z{$(Sts)x7)+=ocwfiyf;L5R_}rXO$$r_7%sgpk$d=o68sZ|V!>=Z+KML6+JlW{?MP
zbZ{YaS`FY!NLA&=7`1kZcXQ0hM;HJlH~+I8UwLZG$RkFd`P$y37WqHf9#h$htp#9G
z=yqpU0-!^V2#tH-iW7uz`<4L#)`wmTjGyOdm+=+ga#8;MyI5Lir;j^mfl4@|hI6IG
zCi`YrZ&TQ5B_L}JokAO}DrIjPG+ks1Ef0`~J3H?DD`V^@KD!5ie(AV!e7!VQb@ddG
zPU3!sawhDI@RoD4d7(f7ebx2GiK=bt7a(<GU;Ud+x^^JdBnX-f-}D9XM1p=3-Az4+
z&hIk2^D#k9gl{z0nO=(J)YSCH`Qw7As=Zx+62PX46yq6-av|C$n!;|$oVzht!egz}
zNF$*$m6a8YSm1io!niL&vLWaWt$tg5duKI2u>C-5!xF;`;=AtcZG7OI`l%WIF=YlN
z>DAbt%0@1<7B*PyWOn!8EyOlD{)}qj{a<Mu@m*3p*h~<Nj;VbL_RAp5z`>BQD*ZtD
z=>`6Fw%lnaJO1`DnGQ8CttE6B?dS`2kM_J+@3bqWqdVD))Mb=s|7kkVR3!Q?*-=!^
zHG><)1g~DFAr>bQ)UrKb)Gw>0%rGy7ishhaUe)`Fz6)Cek58tEgO3eCDL!lv<bX^n
z&cIpf61-EiFz||dw6~a>iK{CXb2_U3QLJxo*a4Zoy-md_f^Ssb)_K2X$!Dg}Zv>Dn
z&jY&oyn3vAAW}V;D!BHWAQKi2h_e1UWOY5mG<J5=+f^XCU{O(37zp=enn9nyQ@}Mq
zZd6wfF`xcA$y0TpkUarxF}t$ez{11s?yE#k2h_0<x+BBZM%K|_SUJ?ABwiVe7~ApE
z@9fBZ={ET<e^z~IB0D5fm5-d_)=0XC1Xhrt>KD&PRhFeBZ=S6YNn#B>y8c!}OgP;4
zxBoFkqlAHU;qd1gD-%{vq2)R-oxh?xA;Z@mwOBoC`=tsXvURbmDu45QHUjzoMDqcf
zAuq{T8Z%f*&;`O<wG(l&Of6nSen=p2gW0pPh23qruzc?;6xF<gF(}$VG=@rIlY>)^
zd1L+ZWz>1jE>RbI4qgCbNJrRCZV}vNInNf354N@v=!&`ueL1a!SuZ|(XZA)t^EO#o
zZEeB&98zq_TdMV^&bASMSH#J^!EwQh<&K^i*nxwOU(vQwE6zGrb1qGmUd=&a!JbMi
z_I*U5_z!{i!id7o+j@+(eLwQ~0PXjU@DO#^OV{@1i$qJ+^L^62RjmClC5xt15f69;
zA|x-sqy~!epoyoXIRUb?_M+r<PCiPUKY_0BpKhF!pjVxxvsaLS1}}<|tUbDE{b=k`
zczCKK3^}vt-qj1@qB6KTk;IbQoV=6W7;|xr+>FXuxMdiMiApxIGOGyemfy?9@u;zr
z1uiOS8kRWWU5i?quD3SA`={h~FB?e)ZD|@3<c>gMva|^rLQ2E6%iz~~@#>3+iG8cP
zw8?KK{U1{j^pIc@wDT<~?Htc87ZdsH*iUICrtO-R7oZWe6n{_^GO+t8wdT!7Gbe8h
za_b35WqW!mZCg4x#=?rRn`mM<?qiI2RGbQR#HkYf{MvVx;HX7r^+tUJDbH|jt04Z1
zB=pU{Qoy+WjWWaLp8xp7gpU>6d&`<(9A|+^;p-eO{3OJ%IV_}k&oDZy&KpZP@Y-r*
z{9;gUqLP|_;cw+R6~Ej+V9Wh0M@q<>Ony>piQt|6E^Y4-k}YDkrDxdvR<i43bwB9&
z<Fg_QSKtOhqt8tH@7I$Uzf)6SM_ZXu(3+GE;4s|E#*X5Kz)`>A$PeUBQum$so%*!j
zslQ*W%8W8Q^J4G+r|7uzrgbODkFWi998iMcZ@M;{fcwF0JoO}6)XOV$g@|DeXCGW?
z1$pcY6-(PuE|l~dDE;I!wUNk0D(_Vd$AP4%^IbN1OkLfvYyn<cm2b1#QRrzsRB=*5
z_Kz19N18uC-uXe09f6+i3)oeSVXbnwzu@csW~&G8OBM(}JIb55Y_b?@6k!}6Z{!3_
zix!`*#imurhYia2@+2j%j!G8N@fq&FX$Z+e+92s9GC6mMer7#Sc*%Fk`p$~L?b>Bv
z271@xY-$rHb=7(6-uX}gC=V+_;;~BdzBi+`J<#`{t?QDpMqu(EB2ubZ;u@Il*!d}|
zoqkBgWfTs7Fx@hGa58E#2!5Jtg;Ml*Hly6xCi|36bK)cO2eiCg0gZ4Xw$1|gJh?@=
zK{Mla+RX#Ju-36S9IV~CZ3PJ<=vd5XF817#a_|P5`5ci@bXhqR;VF@<tnQY3j!k8E
z^ro~(-!5O;jJmo+mFk^v%Zo_(ZuJCJ#)rC@zh5Vkk$;5QbU?U8Y7Z3jK(h{0#oBeN
zZyF~YI1eLYG2MVzp0~Lbv;<lg+bnkRxsiR{_i7@>dI>WMLKD7S;wN+(c5@S*`T>nf
znK6v_DSw&`6(7FwMb{*FJvVw0)NB4JZ>UB`u4>$i^94AL6^0oWV*>CsF2%C8?~#L*
z@^#x4G9f=U@(#w-t<<I-?3LNco<&GZtWhg;j<oHP@*8$XL4x`4`)E_SCF6tZ!&qu9
zj?a+IUyo^kS4lOI>)CTX?*LlWKCRP!SpfVE(VmPi=t4<sSAv+j;KO1JxQ2imq)g+e
zCm>=&C8}qmcfe`HCE7WZpKofLD)DP?h@Q^HmhcHoA;MK-1?9V^?1QnCgtlc@_UV;P
zAn1um!;81Jd-ZYqqY$o(ArhHQzm*7fySwX%ISJlf6k0VE)r=!YvE7@JuctvqboCk_
z05<1XYXEizz*+VQA1szGMb&ES%e79Mfm#U`=y-6-psIi|*mVM_bhX$-%1RSEX0%4M
zMndy-kUGyrZ~@A$7Rs?A`)i`@a2gMC(<i}C;pt?)j3}Ou6X(B?L!<tWZBP%)6ON7-
zpZ(YM1a4XF=0j}I6}^pMbAR9y!2SClZo>jMtBDYBEG2-7Yr>~(Q;t_)G3Brv!0nW3
zv>IAotv<&Nl$47~3;LM&4YxqnlD5_;tV4wY9S8sU-Qb0J74V6UW#@OR0YdcZKZFez
ztIM@@>UmuK&w8{3Z{WvgDk%*kU<+Pst~`PQ{o}oEo{Ri`MXMo^V<moKCHgm_xeqbI
z&C;iROaOQkXDkEq^F(h>#Zfh`C)glRnsZ$0JU8`+ZMCjH**3EIkYzsqWZzV^l!djr
z-Gu;OU;i#ey?3JCl^?`_WI!sh5>um@Ec&iSIKV=XJyzTPvO6}@;yUrF?)S`hxd)*~
z1$pC=m|>zI=!;<t5M}W)nrL<*0N5!t0pbItqSM#jh>r75Zd%^n+WrexVdx0g*Y7n6
zhAO-~I`zyGGYb~%iz)*TK8!d1E|vkgFJkFI_Ea}`X4<E$kJlDDb@TvPNCFlxrXcJ)
zAwr6=JwgTv2R^Z4y)Hh^bUu5i!ur6Y-K@u1F0inHWWFwC{@wV@G}5i3Z^%S<UHkGB
zp`GvV!43cBv#|H!4GgPv?h3m{p6c!=!8PJ~wf5jSlS5`nDi2hx3u%aLD{HtSLJoa%
z=(SY#f!Ryh&kJMS>5GnMmhlz8^us-#W~a8}k6G0R43mtmTxh~yR6Upr;Usk&>=xA&
zwB+!lLhtzl-1Rj|qqY?BLpA#ftg5HiQ#GVcz3@#wFvKAyoWJ#mwSURV!DNP!-uG-3
zOnXY1cOwtIVat>ckp$a^@(R-v42uJGrcx(0YuLK^_X8*V^0X(s+$P?t(0R1}`^Uc6
z?h8_a`x9ep0bOE98wcHq*Mi}}zEDI0YEE!abYm%;V6R%SSR-FdZdhq-(ur}bz6Yue
zAMrW#tf@Hq4w1m2=2xmwhYC2PdX@FaD_aU3|KGLU<}w;`hOtpQkghk4svf9IeYLG}
ziK?q=lbWn3)oEd^Y7<7uz0n3@uw?lF>VxU?@lCf)vP*m*s}q%m)q+BXjcF(2yp#*M
zRF);>IUFVn+Va1zf1JK12M0?euR!J?g?L!*|2bdO3YUv^w}k|e#fmU5Ftg9`0f`o^
z;+oG7SDXU{MZPD1LT2E4{@-*yqW}U|op0Ww{;S98rALWuf#Bb6)Ey4A>NXo7CJUV=
z7@p#SlowDyJ;*fA6W->^>6m`?6{jTBbk?keCX|1Nz3cE!pTB^9>(8Qg@~G%bod(A$
zbomc3%&j;AUQ}o~j6}@=R9mM1m)tO~aq-<khcIAJJ}Qkkl{#>x+5B~@-SvRX_hm)o
zXwJ}V&f24|BF5L9J`@>DHU}btO8%(dk?Vq*%w~1b%k|J^f$0y<RAz)z{6>L{37y#)
z!Ye}PU9BomE3#JZMwYnOdPBfu96_&;;Y-Fz<<dEH4*rLwJf>x-1r!Q`@U<K0Z<R<1
zd|l>L*`_SOck8B#7L-NBv+~9_0Gib1sDMAO5<)VumsYmZUkuJlnAGQ%B6q<1w`nY5
z(azUJ{Tu+{=PwwWDu(dfO_34Yt^PZk4}TtNHc%y{^Y>E{&ryH&ZQhCs&p>!8{hX$}
zOMK_!-!gmSW2IL?2GYDnaRMnZxEN3@_<Kfd`14s$3;F`uOf;Eytb#1}HBGuiJ)aH+
zR^ov>?E~qkof`s4U5QeniI62XXj24D^WIc+LvH3(>pVyU6o>Sgf`KOTsFQxnwY}jh
zs)=yLygV<^+{o(vI;K4rY{?xtkS~9bBLbe9agVo-H%WxA6C{VXsa2_$BH+GDz#X^=
zAaWUchF);dV!3Ot?BH<Tb+nfMiLd3?mciK*X;OzzTzuFcoeRO-1RFc89l^vPZ|>@d
zNRky5ug5ToFm>!kP374=C2emMMyFT8MEZ|Pn<VMC-Q=`*x8*Lwd+N;Id`(+`h~&9?
zMH&EuXYid8((}Jj?!baud=JhfndiaxBmmJEKQj15*G8{%koZu`l2$5|7Zua_vakxi
z>_!M;4A)$NyyZ=$+MT(gvw*z8eamc*I*@D=Pj)gs;iQ}hGO@I=<ks#H8l^ny0WcTb
zHtDXZe|d1I^TEtF3nQsUW%s(4-?~~%)6cuv;YP*+hj;2kYt23}tdlW)eMTVIoSVWU
z&~*baTujJen|;yB_B?X<K!xkVK(_@On-5_GL%2g=cH9Hhk69vhp}y%WjRbmTau3JW
zFu*8H&lotFMTd<SUq0|@`OfdWC6iV%%?P2gk-dM=^(Ze4#7p|J)^<Yxda0J;Kd&r*
z=yjuTY=_%E$^DF8`yjZgFo$1UG*kgVZuM<TtzF<n%HbJY+_!8kJA=e*Tg0-5Lg+|M
zMYg?pf7^u?4t~2Et;`l6{Xu)$An_PolRE?%#K?q5qW^-y?<MmSAP0%W!_e1tjj!P}
zJXQU2*?%u_*{wH&lMn;oicp6BC%9KN@QKw*<W@@B-k6)}I{1?<yR}v0PjrcIU>FI~
z2%;}#&I6!<KM<O~5p&yuA`R_!fKzB1`xs<6>VK;AC_UJUG-2`Z(l~LnCEwhA4kFep
zTB2=lm<z7LvQMo48Jai-JVStUXz=Wh7kJIfr!a1f=jX^HpELt46ZFD7Aj`1}8)``c
zETbOY#FYQBJq*LKz!5;brnhfhK44BgpNDtXmHq^PF<?;mt!7or=m6E&4%c;1lU(x6
z7DL8^#OaWi>mMcg9#kbzi-RKSTDBO^8gJrQ2+R;>pAC>t05J(#G2o5QBeZYHR)=Zp
z9WQm)3P}xTEoi}Z5Bsj?Ah7tvjG9#ChQDAQr_N`gkNvka8BvzUKJ7d7@=vJahVex`
zNS;)4T044QzFGR)O@6-G{=6Ky;#wGQfDhh7W@FpBc#+K$b?K0^$ZjQiTF>b;rYj(1
z3DmFK*B~DCFY#1@PJlCJIR8J1C06cR*`9shYC%u8NMY>XTn^~ut{ZSlb?U0@^JlGr
z*NyRA;og5kY4%949T~5PTU_W;hDz+OnSTFz+0HZe;NIf;%#=i?!SiCD!q;EGv9YFp
z9{i|UDlujHPbQ1cKS>Hgc(mo87zwX-7Ey)~uIOrVy-~xJS2L(fHuCYkC-wO%3|008
z4sZMCYj5cxn95?dpW9*+y(I5V3jF8dzGl8J@J9EQ2`%b6Cm@(*_JJe|<hbomyx#(#
z^vx14eCZ@3tfCl6#|Mn>V$3<u!g(`a%F{F7;n~RU=1M>mIGmy=wl6{~b?1XEiQvmc
zB4+>!_$rw3{4pjk3eJrNn|rD~{rK_HwP^MYx0g7TSOPq|TGp|<b2$5w;#ZV=SUTW~
zV*6B^X@i6#?5cPygs)&Hcaq(Wnc<m+Z@flAod%1|b-qflt#bnDH$W~M-kIGQ&1;L_
zRd5^XEKL6LGgm^xy2~TI`o)3i>%r55?(^3wIhKoRlP!xzB({J84|O!^i`paqBgSxe
z-uFlJf$Uah)j)qAH{#okp0y~lS7Wz*5-U+EKbwZJwK0ZpJcApN1ViG?4j3flDQN~3
zSRpwGz9W-mZu(n62xFrhPfwC$@)_sI{G^EKiFFpytIXke{95H$zS2k?E{RPoe~JJL
zqa@rfyAm{4KH0Zo#%t@B53}#T1e<seYN5@s8)XJoopf07t<zG+*A&I#%{J5m@`rfZ
zSqkj`gV=0`$o9I>_iB&Jd=^KfuId0;%C2p(cp7`q{%JC|wkP{+$xr&fdcvyY&+SKQ
zrB1g|?S1Q0Ma`j0>V@ipE{lH)%|4C6D!ls8A{p1*$<G0uPm&chlD<(iXD|d)8z|zs
zn$qNb>&C|oX`O7Bd)TVvp->A`9U_+uw!a**B9AUuc<VHtk0Iq>hvPEb&7yHUU<S4N
zH~$gl+_2Kt&4av3qR;aAP(MvE<vzE|pPam|4K@L(nAF4x9I3|QFpcOQ5p&|0@4~=)
zu;E3uy{E=ga%y7_Vp^Ccuvu{aj#Pt3Q!=M!YPekA8Im*WNN&}tsP-|SFL(x?f1W0&
z1I5Rh9)4$STk5P&P}2^E^lrFcWNj4xclHCZlxDoYkHXrMi;)_U#kUh*4L!IsjgY!B
zC4)9$Yoil9;0x;R<sS?o0lNoILd|nCi(-H0Jd~@XTbOqbbvR`vY<m3XeC`I>!oK-r
z+1lnGjctJ)FiwonB$=fzs!<{!k&1=u;QiDWlOn_6y5%<E(_`sSa*Dox+Dnc5v@<Um
ziDP9w9o0i?g|tki;gbPHRWlH$(&x=LTB)8Vy~goOo1gL{zM{sQ<LYGSZH=3Y+C^@1
zv$7*9)}yUTpc4>zE#T`BhTVGnoa2Rul4WD{_JEl+&K~NychiAW#045t2c(TJtDJgc
zf~8lBP}x7)Z{&qF_wFxv{QTkk6kpM)Me`2vcz8;c-?LQXqq^jyA#Pxy2P40wv3#)y
zsB=a6TfkA^lOgerQ%2HM#apFM(txbsDEkuB#M-NNd6lwCQEzkXN!ykme9W6IBz|y(
z(Y9(p2?_PY9)@;<bh}6R6N}`X%3UzP-o%Uf<X0T=`U@Zt2EmYhTotlkE}aF#b_u3v
zSGs@kSw2`Mk$>{^;xu2aRfo&D$oJz<s25Xv@!B`gp|--`NKJ=0HRf>=YeHX+(`Ks3
z8cF8*-Ptx;bIF=Wr6sFW8OvprehHy+pJL$$+m;vDVKb0&@!!|}nepyletLx(62vY>
zBela<qn_n;-?+nfym7KDDtCnz&>A(I{-?{Zr$(GMWIh4p^9`OLYOPprX5Y#6Uaxa1
z|8^M+dw3fp(|dRCdi1`jQA=s=aO8l^EHI2Eudx)QK|zGuS0F%c=FBkrv`Eqk@y5x}
z1+;@AFNipU*bN<SdNJye3J|%MG(6skB-|C7zL@23t)3Be;=;$*_IKhbSz=3=;S!nY
z-R2LDgJG1sh^QQIiD;EI>%*#ghOr##du}6X$0mFlb2y&+<14Q4fx1dEIFA*{iAqec
zSUF_Pmj+$J3Hn;JREL(GN`Ah4A}#!x3dIQuUo$<c)H>mty}X-8K9|T6m0)TeAr~Ve
zVFaXOEAtjhtQ5;;8fqU|tmK5mv&Q!FgTC*%vQNYmd8zEnFGDO*^cy6{B8zDv_<L}(
zUh+tpxEi?6XwysGUy1MmH#%|_;g)dUOE=h$Koi3?XCHhFkHR2b8CyM4yh2;hH%~d;
zP_xFJz8^iS;I=0!vCDWBw9wcr;X?*onhuZ+Wa`0L%;8k_EkPiZnQ#EA;I-j|diM`U
zyEkGGk>H9*Uj)#hAH^3V!Zj6C#bP(gjF!NJ+TM+A$s`k-2$trgPDRaafh#6_Cgslp
zHmW(I%&1>6W65%$Tmfx|xC#P_g|ta|`ADUxf8vS%vEh2;!8F8BlK}cle~G*?tN29O
zH^6jQwTcBON-=_TXvVyj{WXv~fqSZPp_+jV2ndE$0sNs`^D+z$T#-Y*IkH;JhAeO=
zlTT@YpEmt}WEuxA6D*~e1Gqid4L$gp0d8`91<IKt<N92{S|yS(9M|+Gh_Li~B?kc;
zcy1te9sn8mM4K9b36SjWO6E^roC}@dfQN3F^kp`aus%&lK~d1%*yqsV@&U3CM5GiY
z70dS>w`a_ziVIEj*Hjb&zmuU+Mki=~oS`957J3ud-prJ$oP!fS<58Td>HG3fMz^8n
ziGjGi;GR>b0Q9TZ_>V@pDeOV;em>4Sz*<gbECh4s)Jv0n5`=Dk6qKIXT+O@1;|WU6
zsaW4X;^%iqq8yQ~Oop|VNCqV7I1g50-cXGMY4E)1nHGAyF)|(`IF~l^Q$XU~34H=N
zQ2sb`Bg^HR%7CdF-$p?P^hhUuRb#Wnum=n;Jmme}b$^crO6cN8KgVlh6DZXlE?d;p
zIR^)w5G=P%Ec&EICZG8nMMzwR&pi+hszJ$-;Z(w{5nra=RlP^HE9qR=^`(Ji71jdk
zUY$l#Vtn0gHx;ggs=Nf@JG1%F%Rq#b@ad)~xr%Rz6mQu1r{xfQBE(IpWh<{NK+q?G
zNl94?%Gjp1DmVN?7y9MK*?GbD`4_L@R4v%2dr+<Eq9m*Pw}n}1kbu@twsA?kYTw(0
zS|MN~mALm_#DQsitZ{sniF5zbqOuiZHJv~g6C>DMc;y(zv~sljL;)j${^N<0)%%if
zoFmmVQRqPE&CFb%ZHc2%hLUE?#lOSjvcy;2qT)LvmU!DA&`XZ$JJPs_bfHg@4{r`D
zAtYXUp(xMbyq43J=Hg_dHFIo;I1PrZ;Ih7-s2u;=@9^0bhFyQhc>`n%Hg#dzYz;G9
zwm4}m>KnEGDY;NSP-*wTTYsfyb2zt!x30?Gc26}F9r2!RZ}F;R*umrLr603z8;FX&
z{-N?HPK57Vj`hOJf*+fqP6Ig>07u~A6IXS(4X=`J`6{rW0Afj|+;Yk40?(b3iMXJA
zZDEa-oqo#`u{9(fwG-t}$wc|IqbCPT?Z*=L$(d6H^FJ2^pBN_lEtof+Ez+=>2DobN
z|61RJ`By7VQ)W7#p!>PrB3UwcKtQ1Pm-erup<SR*ba(wtw>zDG_G~w7H7DkqPqdT3
zjP+|))$LI+?`vE9&a0Bs#%(J-14hOh%4)cZ5A1uJyK;6X^olusPi9T8s`wYToRZ9x
zc5ki_mGr`LjfQ_*>*1PA8Au7$5YUCuETX+2In(?t(BR(1E2&GJxv>hkoNhnzruY2>
z8@mP0;lMwMLUi@E<S3IZOd5baglrm;FK_Ow78wdfBrMDSotFu=I6PUsVBY)jzDsyC
zg?oAh$ai_gL3~pl4T7QIR70ygkSdECbvNb2{{3*I#cjS{sCkm?o>?|wsizDvjJc+b
z!RYMogk|Is7Z{uoTvIN^!tfHXF*SeUv4Hgj6EdtAEf+7U1SR_YyAi8e(m_dAp$zvt
zRrcY{?=i%gBB{j5ZiG}`ijSy${~Pb{|9qHteUWWlMmIH_eayK}O<Ue>XmyYrq4Cl$
zel8Jwl^m%q7i~kjUJ}^`P0gWoX1&fgVg?8XmgGLa63I2Q%IB!mNznS#GpNH&oqv!J
zv&%IskVtTf@=dquO0I6CSLKX&@A?<iR(oc+DPlHa$4cG^+I^|=M5R?6!Ue4_SXFvy
zSTT%8yg8`@NzbQDyo=w_JUvd*R6h%BTbC0z9<Q}h2aBEUjvaueZal|gt*y@aInLy3
zed7Hen^Kp1XI(w%4SjpyY0R6HwY^0NvAC_*(KeaZ$eu}J*`PKO#*GaqeiI~9*u6Y>
z;qlqFRgEPDlIL!T9Hp);Z=LZa=k+(beNxcjVG`E*ZoTamqR{&6YAFZ7TOoh&q^;2c
zplIYZj%ZkzH4`C(YE;!Thks^i+a9b0E$VY2kmE{QZCldn4I|{Q^lxF!Uz&za5QM%j
zOBe_uu$IxDz4fZbGNs5cN;*nimEydp>HoY)ri4e114%^3?a_AgU-$t;$FXLS$S`9T
z|KApbyBM|J@S&4%Ho#GWg>=%{?ozA^W+2a)y8)u(=oLDq@D*#V2_IcfpzO43)9-$J
z7NmP`Q+2eT)W9e;2dZ^xB&&FK>qDr~;&WX=KWEQ_XXKZGe5Id}QRDa%W#3HXn6}ij
zJmUvf>~W_{Z?rV^&Rd;#-fd2(%Kdr+Aj|&y$wwNG`kU9WHP0G;@XSPco#-+v=wubJ
z0(CsksCy8o`O-H%XF9q<h6YQ02ppmQIp>|Sc3m%gDE^+Agze*r7D*Bl5hiGnM=UPH
zef1vUdVxc!7u*ktHFVq#kng<|7TFf+Xi5uT{adKx1@tmWf@&MNH>1YCYa|{g)6A2m
zz1+B#gZR0Af>Si%Y!{!vHBJ?(Y_~2GGMT)u1{dKGoDXD})210)6o=sTk5gs5nn^H0
zVE5Pr?i1{FPEcPlvKHD^KP1m$pvY~3Ipj7CGp!f*CYhA?^;qR$5Cc-CKNDw1u~+SD
zlym%e3MfpaNZ<ei8i+jht$#<<|CdEA`ywPXBlDSBsTU4~s9J=3K^jSi)k7aL4Eapt
zR;lOH#4dL;3=eN%*YmVBiYXbHrRe)*NHrj;&{yZtt0fL3iiXM#huMaLFQ`pl#3zZa
zc>kynn%;AZ`kA7+VEz~6Bsm(l?B8oH?)x@)0aUKIX7EfdHpERAvuVmv-EHU(n$`o^
z=O?_erbk-0Y9aGaeDppRfi8w;HH3QRrXL3HYQ8_^KHc`^9jm|+4sO6_5O^3OUpH{;
z6^$fUZ$YJGY>FgajaxOap24m}v2UT&s6f$2_%p7koG-XY9`xfV0GpjZfub2~yM1g+
zs5YE;-Csa`^v~YZ6DvL!S3R*iTHC{ClIfo+2UX`ouUJ`5k!DS2yHre7dYPTT!no=d
zv{fbQAKM%j9h+H3aLh%-+9zUa_c?A2d8<53s2@d0aNqmsmrZ3FY(hNJo2G2C-STyq
zmTXXcQl*?e20E`e78rB*0P&s{a??B%Mp9h^MO=Wvx-Jr)^zl6h57`~qhWL3PF1gB5
zcg>eo2-k&ywB|bmwkB8<h>os*%;Wt$6Zu|ReP`f~Hwu|xJ>z|26=W>do3SVCBK?~2
zyZ*V(&U+Gfgyz7o<7u_pe)(Z@UB1f$siUU|B6U;)wUyyy9_1fTL7aC<1)n&()CQJy
z={_x4H`dmC_a)<n@mf3m_aL#@G?F^j4+O;B={JRbrCnQn%4lhQ>R0l%f8VtlZi6`L
zKpuR_yfg4t^om##)877E3M)`@l=th!$smLzC4SyR61F$u7Xp@aUnq60-^mq6P6D5!
zszun=d!peh(f3RK@+-E67gypRKyUE<SMhA!bSul~JYe?zzDn|dPMvW53?+tl>V$4s
z3|5G%Wxh*B+3OkJ9FYm!8FdBD+kpf%X?bpNU?a&?je%Laq1z+&b;5miPf}o>;Pmk|
z5s9HIH{>!#QRpsjG6V`@Qlh!;7wsgr!FJXq5%ih7U&87~^Y1M=@ppIy73#=NAhP4l
z*&8QVIohkd5J}P^-Pb;e_eQj?gY(n+m(oINTrvT?5)D2*>v@lQb(|!I1M_Y}L+X-q
zLS*$haiwX$Jo;swjx*EV;QRgz@GU)bntdAX73(@OS1avVThE&=c?T)j+wSXbS*|tT
zblZBo_Oxy)+qKFrdsQ-9RZh9l0G`pu_F6+%Ssg=xsu@#Wl&6tPHd*bk%d6`}M{6Bl
zL;e6j6Rf0mw>W=o6C7Ev@GwF3Lua}c*FysZWw$ux1_f@0aej+RdLaKaLX4MDHnE$%
zH=hwKg0<2LWR4MF@oWCYxLYUt_Gk$df<?==mDUddaU{ZqAoZ#$XC`>3Zz8>vlArB(
zY6gP$zXWDliK}lfwzREkN)}6x!9EExtx?+*XSg31eD>wIyb<$24*SIX#W=Zr9o`=}
zs#CR*KdbCQCYZL2|4^jahq&VZ^6K`Pa1nPZN<B8hlvpL6uq{hAjSYpK;rLhIo*1qb
zi2cs#%I%B2tntL~*Xsz2gDipWJN50SE>=KOP&_zb)om4<%%#o;-Ak)5;xoyRe6HA5
z*Z)E-y5hn8_9$=Y^r!4%i|dLZ^Ph7jd=^X_;%ftDvpskJGR&Q3_@g-+n>cikf^d<<
zE_zf#B@o=irc^CicvFRXfW)oT9V5cZg8OP>2{;<~NJ2{U_5Lq8&eO^W2uwIM5SPXu
zGG05JeJ+=*UKVBK9a?@aC<^3T7wZi(o;5I8O)~inN&>D=n|xSH2I1t(=Eqw>1s@YW
zP_FY;{_hS+;st`ZWbv9-tO$r=SDmHX;={(iTsh{rrI0t&IBg~IJ^6P$`sS~cR=e3N
zah{LZsRPw9H)g(8ZQ=X}UA&<>R>>_Jy=$k0E$MAarMgKTV$IC}a$ykK(>*otdf)Oy
zLAuDd3I_VY*GyRC!oh2u9Zs{z1bgkXRT?VQ8ux=RBX3dup8sP@!d^=Y5oVPAk1gly
zPX}+TjWzFQlsz%r{_-E+pXqoTxW$qGvH2I0WqdVNR)ftGT1)R=t)^E%_q|Y>N`OfY
zqd%H0oZenby*nZTMHNh4@cw<6>{*d;jibJ^&#%e#ovO-!U-Q8y-{}`W1`C__CQ}m9
zlj!R67w%t#i7i>suh_0nunMyF*GjQ#OtG==a@b$r?qAhd@O}4UH`C5W!abDU4nDvG
zL(g;|X@>m+=V0Fy%5W*vDk@MWD6B{Ma{1fD1glsaV3kTP;)bpcp9otolmO?3ycg3U
zlEYx`{O(E5XW~nGg&`lcSWBgpLO@jKIqCdPL#Uen2Y6KaD!iHg@6-J^ihk)oG?`=(
zx!2xeDToiTVnl5IrMarTsgQlvcXR#f)wOp^2Gue@It+il+lB;u(voXHKvqFjOIXp1
zTVh|*O%CrjRg<=AAhN0$<^JhBn@3lP!j9hxKj!t+eG@j=K<%h>NAO{1*YV`W-6lB|
zzr?YZZ&g;tDXEr=q5y0*s}>bqsu^?Y+8GY~^9)?NNZ(#vY$Ekj(1c&s>*L4&xSxXi
zA|%^^Vl3~T8U&o<=!aKzpB5M@Qp&D4(H1vK!hlds+Pyo4T~E2&zQ01*`^&o`<@nYP
znT5us+lwQmDAJwxnE$aADea3Sy%fJY?SPZ|{llt8BjA*7M`S4cDNTuZgm0tC8k*Xp
z@wx+Vw5B~spu&6uD^3_u#@_-mdEYn3AASr=fyPmYy0}e=P~Q2Wv2HC_?ON8j6|2D-
zZLeB0T?B$(Q{5i7A)^509rAJ(i(@RTw|f6HYDyG+@N74{_cuW`n#*3ZPQ?sk8%<N!
zL|<3&a-%a1v}|9|pG+FyV2GW*NTQ*UNDw&B9EWc(^}&Frp}-;*U_;(*L1^cpS2z^J
zpFHt2XZJgyfu3q4YSOQ7eeTQ(^+Rqv;F1w&NHNk`k-fa*N4iiK)0oW~?up@bz*>7<
z88jK#kBEYL*?V{iA2uPT-q!-NG@M+di>1Me6_Lm=a{$|McbmfksX`H3bZLipH)740
z28LE=89l5los{XP<i*~E2nGZoc3`iOq6t9D?Dy?<vuEL{ioOi9|GYviHry0JqD;Q^
z636N~z(Y0&nIy42Ivzie1DjFft*{Yzt!J@j4t_a){bZo1EI2}G1_B<J^@VoKdN%T?
zS@@bF+8-n{z?Tc(n;du^BudGq^;v|`vI^Kow#`91F+Xb;8fszOil0}ZIH+puF|_T|
zsj7Un|ITzb&I|sXpng^cX)Zh%G_8yiZV7$^S2=rtK0V7ACkP2@UR}?Tg(6AP8-b4~
zq4GY}0PR%=;9_RKs??2<n2o%p!3vJ+v3bl}-SA4ZXW$Zu*aHuT?1%$!9vN&b+!{;3
zyF!8m-aOL8oj$C$#-cbKoU8rg&g|Blw)Zau?0aANI)@c=^Am%q>ewDxpjk#lf@J`^
zx6%X{^-)daD2aaa<q@JU0oW=#T_iE{r^G9Ovo5{>tM5?h-HhTyDtj7VG?{DxE<@&T
zl4A5a*aYS0;<FPBu_766K+Vbz^~nB%x0x9uRC;eV$52dAom-ZAOL*C4w-Ki$MH30)
z<~Nh|j^2R?Jg7A8sZu~$2JN_QD$Az<p1f<r@6&ntCe7%tl@NgXkx3dP>0(8KEm{TP
z{<$KNgoEX0$Z&JI5a>H?H4+w;7YyE?y5ILmM#}tGOJKzR*l0zNPRo5C8%HSdL9B_?
z+alDRqt=}WLg6&BOU1hAk>MUKYNq&ts>5_T`<<S8`{2PObCpa3-2nXo>n*)b)WKz+
z;ern>aEQl*gdIE|-+$89KAd5}3pT&c{OnO^Xqi=nR(x~5yL~J=*35`C9WrbdQ)t>-
za6faS)|~!g+XDFCz^Sv;<XgqHOE)rpBv4}N9un9lT==Kdk9_#g+5uGc4A?I;YetkC
zKF~u)=`Y8uhRXkp_J<+E2eQc>N`<Au@1DHPKK{w^ZMm}TH?urm7^<u2kg76&L6*}@
z;o%~mL4uRS>E;U|q(J${6PR5qzx&97dX1zr&nCd7?;$jeeyt<Xk}n_(!>wnPar2G#
zeV4^Ovs4!NkbX`Xz+9DXv~Fn?pLr${UaaZ9AS(WG>fyb&vKyeL*4P4`*XE~00UFr>
z>tA3pEq`AP5o(b!mXxOcIetSk7B5xsV5^3E$LjXEyQO_=_?vEAxJzvS!x^+NO5CO#
zvysDaK$qTTfZ$0#veF`R^tmjU-mGUyToaq;4J>_fB&H%ZlkC9%j-1g_B=pUGZ;mJI
z`S-6^ihtQ_mobHUB9z9d1K%QIz$xgR7&qgy*2unq%#-SN7d0yxU@(%HjF_4BWfga+
zp5_{Ie5+#h(s7oL@KDOTj-%<ewbBl)6njG+N+M}1a7Ugqf<lvH(sx-oI4I~h>4yAk
zUGr;ro(E-nlRNdH<ul#y0KRj*C?8y2u(U!1pVN`6ecWoB`;O5QYj*|G9K~8a^?dA#
zcwSqaUoYO#69yd9%%q@-bHRN%esP-Zr^Jfgua9JP3o|pr_N}H}6bg^-{vaAorlTO;
z|E~2`i7L{q<8gW&QWq6zOSp>1!a%mrm~CNp=LK!EU`lb6Uh$xLgcmhd_zIZatS>$4
z=>}n9i)h{q$wMHz4csL}!-&IAh$iLK{u;l0KF>r7KtG=yiA~Q;1d~Af(a`lP!oZ}(
zQ7<N+CWOpoW84al2k*;7A{=snPsJrq4uW+3gv!&8$s`%<R0cks%e6B`GdK(U8DcQZ
z;SQ@<3*N(;3g!oDc~J@{oX;|>?})rHm6=#pZ!Iu#OG23xo4s{gy&5wv!?d!uWdDX~
zm@U8VP8$M`Q+4;cWbzn7@>I1JtSiGq;|}4+{(3M=!R^GKp-SOU=xL?<j2})u?eBlY
zlXPVTg8E44?Y-rl9K1(Tzx3tKn3f%#^M4$)6^b4>aho8jz6RoQ{wOf>woqfTXHh<#
z*AwRTUzOc8VY3gKcfa*Pj#+8cAv89f`3Sowr9L}M<#_rcLXB6-w>vgJ+vPEVnOv?v
zZDq6O|CUUp)Jl0&K!I5zkAf~U?T>reyL^^>AZ(+FyxU(*m=B1vJCl0*nk3uRpiY1D
zrYb3QBTLIv^`z;oDlZd>=Z>@RPct6xD!#qDV;v_hi3v9su2!S1ax}|Yt_h3Yc+rv+
zI4bWa;_0*Vb9cV3$P2_+%HGbjyR_f?kRLigcqOUVK1P_;^M)oP&VP8L3A9;Ua&3K`
z7<au6veJU_)uDwa<J|GK?Lr-X7A=GW3%P3jTd45^HO!OjVyzrR_o*p-Ke#0nsm+!<
z_MPF<3_7#*(owQNmnof&x>=d{v~C3*uU~CO^60wXU#w-<<?UgDKo2@J4fCoFT<Ue4
zj@62x1~Mom(1*JtSexTd@_&Dd-Mgw;r#jGasw}y2$4)fkVb7KjHQHfS101bz!KYhs
zGydG4{im(w2-mae=8}Ss?C1zps<WRyPQQB~>#grCm-ECU_zL<rv6Txk#W6i{5^>R&
zJT{X1hGzxJWOGV>QRY)KicV7H#u~D&1UX2xtk<8Ch291(C_i%Qa9WKe1pUp=n-8c-
zYVRz(cWCX%ao%TGYtMdD4LdO5jDmGceYxG|k9#$D&t~OduRb*}imr+~=)@Mx^>NT9
z<%%E4GIW_E<p}dO^Xw(a_W(VsQ2Tta*Eh7cp2A1H1BDWvzkY3+bc}9B37yw-qQ|Dh
zx^G)|$wS5>{cM7(&q{eVAva&YL&Lm1*eTMSWYKZ)`xsF)y<oAM*zUGUt(}*BMvscd
zp$2jR!U_|=o~O>Kt9Orp6aq(qE1<xgs;4e7()sx$3>bft{kDSp!>P-8-P%+F`b;hp
zILZ9;T8JLe{$#^G$D}8#?uDgo9{OLd;UMo>g<r@PsDGoxopIP)_J3@b)uk#j__rcm
z1Qj~R$ZML5v226>rwJ*uQ**f`-k&F6|9-D8+#A!U>wOwL`L;VwH{)*}++XoY-EcLQ
zn^}?hg5(2@*Flm=$*sIrfn?FMN&=2|X76p(*xXkV`Y8Moq|maaLnbYIza&%_K;Mto
z)}tM6+dbY{0E3mGNr?j8vG66!@hd;iWY+djoNmCV6$eEZ`?8#IBz5sKZ^tLiRgZ=G
zz7PRnF7t0cmVg-!b`R@36pIL4(Dw-g>Kwp)VGzGUr0WMXu3{~MMT_+@;hlQSfxNII
zY&bnbxrRyXHU;hkNL;%$R?rzZa0my0CBw){kNHY1>A(rNFaL-I*#dZ~D`d)!i;QQS
zMS!n$pHmMBum#xDhX4@=A&~>ABuBZydd!a=i*IBYDK}2<4X1?t?sHKPf}g(c`X(J@
zRL8N2{}1j@0C;k)29(&Wy7*G-zheQ?b1%d#=NxF#EJ7;O#_8zTT2p#hBUlo}ucbN<
zl~p-?1a27E$a(=y2rLpOg5Z^g2W??Q4xoIS1wZe@niA71CI=@&K}$;7vD@8l6);;D
zHYv|#TZvwuCPM3D#5Ib_#{#!akF<cMOVfR`-^5XZdNo2K`~zd)eFm89tGgX~&FN#p
zg8td8My4{z#RqO|HEf%O$FH5%UZV2nr1L@%ghc5TK7axd4%?()fW>wHN=BI$Z_Ck6
z<b(<(00DgAL^PXy;8yL!L?@mmc^8gSto^lhc^=+{;b^K{yB~Age0pM4^E8)eb1;QI
zttJ65DPd0*aplWF@QwU~N-o^q&<_eg_kkl>s`3by0){vyhY(=8HU^}I|6@B$2aIwV
zwO!hQXF=JUcj&omjP8MF=et2-?y9;f)rT5J!O0Cg<G_i7sL;4c`G5W_P5)<n%?X30
zXt!osD?`_W_77es@vYuadoXL8vIahD@FKhW)8Y%DW_RoK*BNMH{bTjaD}#)<MuWnk
zzWpmi!ol6}Fg><dv~Jf}IN_S1VCc$3pNkNjH=P;_j5)^?=?a&e3?{hyT;?RmdyZS(
zW4YH90sEN^FxZXdS^Pdr2K(}C8EHhi0RRp4Ve}k9@Jfp~tB$pLAtv^&fVdfyZ#fZ*
zZF8qv2@OHND-t%c0XIkLV<nUniWyXBx&HIkDRpLO|Gu*zTok<~)v&FGxO>TWrE;-{
zPP%(N6qW2-lqWc;1V7yuD+mCbYq_y#?oTSAAY=r{iK21KzjC@%aU>=uE;+Uv;D`Ma
z0^0kiM}W#D6Z@=eBky6^gNzYTrir<twEZE-3Wg-v+VA=o{mOsj&4*6W#iX+eR+hn_
z5^aKd^e}ho)4CCuH%jWhzV3^RDm%TbIhz0Vd3IFfnX=gP_au}AU<nEPrIiHF<j>g~
zzU!|XcEeZmz2$W!f5*NTBiZUd+drUOeEm&WW0%Cskiv`YMtR3PLH_my9Ahy73UE;I
zc;-~zqmSp5HN_bQO=>K6mtuViSVQ=~hl_v?yUR+p82*qdu0gL&!z!0HqlQb&3D3NT
zHCo%WFaq=Yt^8=t(}XR|Mt(6a5S`QFN<0^`2s3P}erc%LB75f%FAOpNB~LOGJ)FK}
zL^L*l8_yIZVJa)UPrd6n|Mce&)J?#~{M0I(k_mO6EiL~1HuMim;m@S3f6sE+(4q4z
zwXvHI5?7jZ_&Vqs5tU2DEtj6wH267+EsuK4%?()Sk?()%O1QusAdOUTyc1g|m-_L=
z%Km14A4^FTTdB-*(DCKAWwfr|#e69*(!P6|*O11O$$ZzUvI||p%FS}O|AY267#mEJ
z8>@Ks+0Vr0S$e&;-TFDKU{HKEIP3kcc#N*^r~|Nk&$EO0_3TIgW4pR@dX0EuEc-I=
z_t8yz1Hoe39I)!2T^L!2-Rr6@w#}S@|1FVdU@`Q^VzxyzHr#8Xy_E&0%I-VOd}!^w
z_d2$HZBYKBUsIZC<;Ye|KeUbn%D(2;)l61lZ~f7=Op+Z%H{zpA!`92&=KfLLH@>eI
z>W5ly)eacFd!y!5Z)m^y+w8fQuEZ7?+8l!etPxE!m~^(gGkz>BA+wISl5<r%*0a1C
zsB+62*NKbKymzs_Iow98-X=aMgi3!v63mfGGJnSaA~strmI`TQ{mQw0Exm@7XH@oV
z)Z>81TvDc@8Q=TrBB=}?lbB4EetZzQ(>mrP;!Al@kLONihD*19*d00EjF_ON!B;fp
z)yIp|TP-buqA4XP^A*mDa!@?eu%AxY7qC_&h6BgEZFS!nwprk@#Z`2Ud89f&w449i
z5NlJ4sO?iwhMf0iOY`tST$=)MGpQ4ADRCjjmUm-y@wZ0+XZOTVY076e;TfeSpHm_i
z>iyrhM{?i|6gnOq(qE-DOMW3<4v%_Dw)CD8b6darfMP!A?U2yJD&U--Of}uOI*rR&
zGl~?^KhK*iq+qycYc2GB$ncJ1yGRnoMMI27;N)A$4k+th_oW0?PgPTYr9Ya*4-GhX
znEAFJp9k6lC<D6O;CvY=v3rfPVRU^?j#8o<_foZ~*Hg<9;o&E?I^ri{_}Tv9f6GfT
z%$<%fi^S-hjtx!O#_3)1IK#Sh|EI!H{jAEm5wVW0c^`ZO?=vggpASdXn2F{OCL&;>
zXsU0}5_Em!RHc7!7N>u7`sa780u=P!-?t84sg(5Q)VpCv_{n>yEb8{dy>WX?RDnru
z<w{Na=|gWW)uI%5PpPYMx~NHw&9OdQvNuXIm^3jqeLMLEeoQymM%^Rm?B|#Ey4QbX
z$4Qy111=EP@o#o`k5r879-m}q-jsDoM>U;Oi`y9rPL263{O#di`OSA6vg6`3HS>{>
zj8ys9Qlaw$Ps!ijI$xhP`x0(ZM7^fma>iG_uku3NrTBNv7^clZS;?54MzX3~{ujxD
z!|v}I_Lwf}l8@IWqO02aldU`MNGP4hU3J$x#x6v@r){0<WnB2j%AmxmVdqh%e|hox
z(e)$@1Y!CDmTrH3rLj8tn=UvUD8J*^wKT3{qQX@nm24SpUaOM49%H7wb6tjY@$2I{
z{Ye|Y+Q&zp`!of`OxL2V<c^0^6*}$bRXz`o=yCsTiI%aA&ir1OB&wb~D?cZ7`8E^1
z6um&B67;Y9$`#i#!}FC++8bXUT^J}-+c-s)j|TkH|FLP?{dwZ$V*PGCJ%v|$;qH;t
z_Wk1%-@6><vrY_6y_Z-Sigsp_?8CX|O6dLz#a$j(=w|Umt*<`pvp$ud^0=c1Q7_p}
z(K(_Al3o@)WTfOqvv~)U!WhPL-nomOZoN1E3T7^Rr95C)4Srbh_DJ;C1$c=b9(J_J
z<(40mbJO+Ji|6-*$pQnL=r)g*i-GH#cVMz#I4b3JSf3IR2Iu4dh#V__`}_OAXQi0i
zJ(#iD&ELM-|3}ez2SWY-aa<IVkwVA{k&*1IBg%}kx5(y%IC~u_+u1XFAI`|$+u3yX
z-gM61`}_O+{^buhK6gH^_v`t5JStkaP}S<|Ma}Atbmsz}zd5)ONVz)Qw$YyT(a7eR
z<|!x8bd+++4PDO}?`qVPs!q7jld$1S9zZ;}V){1F>xo?)r32r72EwY3Znc)XYV`2p
z0D`tTsnm+#uGQ?9s*FdU<m(_QRY1}4!?HWlfc&L3W2A0eu1m?oG*^1gCTrUrV3$&@
zmh{pD4%L70hL|5XL?3ogXk&5a;xVU1@#x#xDD?{H%4b6C?WtRASs!SV8lsz>FO1P`
zt5RX;w{D`W9t+uESTemdON&=|#F+}`XcsLa@rlkNq|1&t>Ac4WmaQnXyr&|8Fx~8=
zQUl_sYc1SwHw6zWPiFS@3K}z2Z1?xR?n3X&C8lEIj(vuwYc&6a6#V-3*eL#9`;ACU
zg{r~zL!XVrf}i&NBm2HPL*Mut@XGV8N=W)o7+Z8%zSS2f!34+dmOiZ4=xa3lWF6`E
zdC=Sz&+$I|s$uizI3S=Mvy@pE&^e(ri&v<W%;4=i7tLZRddvBYRCRE93dsPd={U{F
z3YBn*<?(>}&WF=&N{guYGmQFENt49n6r=U6jS1^Q>8Zl6o>vfII#P}tg$k#sWG{ED
zMn)l4Jp<VT)9!zX9cEmW6FZTYyyIBFlYo;g6%w!9qLA-#fHS%om#jy(Bs5rHEBa3g
z0Kw498}Q&V{D<=fqr&7x6j!;G3b<VJzcVv^J>=w<bVx7Oyg)>bmwTC-HIO83Ul#NK
z|Npw?d*$txPs=?h$m2?K4Ei_ro}v)3+NcTe@L^{KKgU{7cqh5XHxo<lPMFW5SS>|1
zV7<G(4{QeI#C<vLrUO3cMKinzGv3ZzD~LEkd3m5j@e}$hvhD?U4@JLiqoZ9VGMkk6
z;*Nn7miVvWb9Q&rsd(~HaP<hlqc$-HLL`J9|8nsVTk+4~zPA21=%Zg)v_E48fXamh
zPDhR8P-8N}Rq0#fAMnWi1@yT+0ujW|(f*#s-dX`nQhP)uVB0kN9nte#DLw!ltauBO
zgDUtPVgQSg7mS1kgM#4r$<tl*uz9N2yY8v<{eSySkOjDt7mQJu&zbQq7-hf|#^YBV
zBre$*Z_b5sG_VHv^-|$AuVP{DJ6`Aw^UKC@X&T^wlsu^u00EdQd+xtE0|YJN@<X=#
zz?e<)3cfz3ek<`D9d{&{*)avg<B#T|f#{$0QTY<x|L>Hq$8gVq(`DYw_-m+=>W$3r
z3{OEE3*ti+I`eXfsxlrJkCh~+KttUiRkL7g_m@$unD1O2#kcP;r3lv?>OWmrgP2~K
zH|_0sS>^1{!z<53{WQIWgL(*O$P$~+dnmI4-0qf@xcU?MmZ4aV%}RBpUVY4k6s;T!
z&et2OROqku%OcSk565OZ%<NST_3VtuI?G8x`s~QkQguDRLP}KyT~F|r@}2~u3?lAU
z+YzL~aMi_qj$l}w-~*Z+4k?Dy!UKSFJ?_!5^+OgQ7OMb=<S2}MA#*Z`U@ihc&4I+u
zv2uQ<?O4T}wL$f`8c8Q~-COGY@NLmKu_;{g_{|dV?7iQzHzms8y*%<~i50wcu|9Zf
z#Li6M816kSYO{a}7DXW)yZyAT-OAZYzxlqVSu|>b#nmB!(8U(WR!%s~4yLqWZAOg>
z0PN&+n^#iaVbN!px!m<3$7F!zBk??@uOue3sROGe=U#4Hll|foMqhb~yE?pYeW|Rs
zVYWw_y5#6VrQ#@MxMd<a%p<{x(%Da4d*Y%UqY>l)U}J<)X3iok^oSOJfDjA@=FXpI
zFs5_Lbd;&8?1~nTC}0XnPI%?#@FT~JS5$P=E75?N1;7)?$%E4&IwJ&&nADJMs0&6R
zkFPRlEt~bE0}=JHN5;#Kg7#GdK+`=?fFWNIJUIs3(P<3TyJ|mgTm^qe4GAa%>Wf4v
z?>T>)B#>u*UoWVb?oLcI0j`;v_Yw9H?zwSR1mFmf%8LZx8b<nI4FMYj(?b`K9nTtH
zWvk{?tsbDIDISs3d8uL#*0B;|adC35y?SPf?>7Cy_W|jp^mN$S%aGs$$&bKl@vYp9
znR(S^q<6B!XZcYpY9ZEB5nQGI5wD2=I9Ns1^Eo#XMRQtAq_9qK;9j1S4^vk$y4;ya
z7u9PlZ32c4F!DGe<1B-)ed7#x(Iicl4h*OlDu$2K;s6?hPht7+tu`0mOmjvXQYZR0
z{Uy>;2wD(PIsoq)#_Z{Q^-*Xu$OG&I(^D}o0ixW&^dp5G?|QFPde`P;y-Q?>33qc;
zlTm(Y%JIE<A9BzWUllgO*I2*(d@`RUH#CS~s+!p}W?CqiIQem4hMfjmKRp*bM|_nl
zwGU7ofgq>$Ck!MOy`E8V9h9Cgw|2ayxnmlIV(K;9Y7FJpYlWx2*`tit%3fV*?Sr`R
zgN#3R9(!r69528VRDdVs3{e}PxLwC+^qBc<WTbNvxI7cqgK66qs70Ne1B>@PIl|TW
zngtf}lQ`K(+i_>B8zUyGmnfxNp|i%|;Z9PqIAdLeM;dDt_Zzwmf9Z9sk?RtobOD!j
zvQV4fg1MGpT~W5GHRDmssNsaq$9x%TdS!u=PACv}DSM%I1iGmT;ZFB+p#6AH*(d5>
z?U5=csXL?yJJ?GN4cirw?%3gyeF)$2P$&!fSvR+F@hrth*0VaZzEoD`GhzN)$@RKi
zx=A7P{u4F2sDVO#qz(YvaxIPMA?y=rzaFow%AF<l+!8erqWHE=siez_5NNV+Wy`jO
zvZDHESOR7=@sHJZsposxTxG(dq?Lj=jswmLl1-RkKS-hIAZy%@Tk`Fo#&N0*|AyZV
zx(@@#G#bXTuE_{9^j90OY7+KaWz6568}QbI)4?F0Bux{UF3yo%wzjXE4S9l;Mdi36
z?kS9V^T8^ABkdr_msCqQ;QBSh!knA~PpZh!{g+%bAxtLHv03wDVISQ5swr@0`iU=3
z>7PXyiZP^&MOErvzgFN3<RlX(QY<?x9J+qve*W>X;2r~Soli*ad?sSYmy2!3aH^SP
zOH7`w>m^9)`V9H9Z;lo*k)cuHKRjxpoKaBJk2A9(+ZXJ#;6*moXv*rRnktMPoj^Ep
zJF?}B$h5`drr^87&Th1vy2ITHbkv9&n9g8Q(i$Je?lO~meb6{uSDF@&sP@Lb-~sDF
z8k$=#-B0?P{ZylKD&sG`t&ZFAUi;%s#CjBeGcfGeypa=@^jsR4?LQsO*C3;*QJ7cf
z$)*W&WWt4|D>}S2|9Uj5+T=*BK?XW8Aa};j7lmoNKYZ9uPzOjA^2Rq?>SjKnM;Tyx
zluWp-fuJ3Q^UsujS{B>gV2z$a+*k?xN%Pry;T5N7kRoN=w49?-HA1{+W=wxAy00T=
zK~AZ}CFe1dy`tu`{n4>$5FL_!ec;p2lrE{HfTqK;)RBYFiG<YBHgQ#Suf7`Hthki2
z%NI*dbFRs=Q){_lpl*EjbT*&hdv!1bJ?D&_NflMPxi*Ss$4(5FHI?;5>wN>(Fx<BF
zFJAXXNYIOl9;mRdrBbD>_&)SPK>x1hA^DKpy`qpGO~81b{S@*TC#zzu$awzq^L~~O
zG8U^*N~7>q1}Db3r~YkS5f64$O~Eg`={%Y(In`9EWLMJ$jOOpQ{*|;BR}I4+euON7
zE$6-?ZY6iUwfMgnvpREoHCXaSd+(Kb+fQ6)%zN@Y4Tv0C<}>rUHfxOM_Hi)J0GBtY
z9z4O8)KW(ev}YuDtS_TWWFJiwQ@4_vjR>F{y}vLTd491Hj*DSXZfSdt)jB}3{<4UG
z{AFVF;aZo90^Wj5p~a{S1Q_PH6f@di^KgU-T76Da8Y-k>=Y?|2w=E7*RzjodD|R33
zN+$e$z*<_w@+BJ<+_tVCG&%Ao#?#tihap%%+4bkRB5kPOfSeffBh=~_R(^vg0^voy
zV`7tnwE^lBdcPisvftXhS8EEQm-G##ne%L?hrAscE<!_N6`Gttzl~rOR8D&x{h*z@
z!jLoZw;;2+hU&*#Q3>)V<=oy_M9s5sp>~>U;+tvxd_C1yb+#<9rqmrJUV}{Az>eal
zUq&Hgx7G-uQkk_SD~6JL%6~e>T<DFTc-~@9MVI)DpV;Hdg=g?#bfe#;xebqqGfWPl
zW0nxYz8vOdwp9-wm(0QHKxw+tlpBv;-Z4vN)ExIT9}o{{?61Cb*A{AEXeiFJ)HQCB
zV)rpCoF!S^oVk{D$Pv9ezGi@^i;-WTwoN4TFN2L0`RBrv8g7ssjLN#Ij%!6B5sHp)
zfV8&Qx8boQ^JxQxk%KfX+34+OL@VY;j{@b$=7A~SwySuySplZ2R%^ODk@n5<^<V?Q
zC}?k*w9OA-j^oejJW1WEA%Q8>{yoTx)31K;iq(Hs%AekDJM;Oi%w$>36YLjWZYAwX
zmR{w;e_}*Vx*~kkb1sRc*Ld1f)!}wel74>~UsG%IoFO^_zGZ4NeE!-3*TwL;Zihgz
ze9Vrj!C^__<Tk9$y6uQ8)N+xBT7~Ds;zGpwY3Z4mX-!)YJs8c%BfP1(<plS0)V$PH
zX7Wg=5>-|BXLRINxkfK@JXt2RNAW0ajZ1gnWL|2dT9OJ=Iaq9WF;d*U;}9A!PVaQB
zOUU9Ko)qa`^x~tPd5f>WA@-wi8_DUGrIdu6Q4AK{LIiuJCK~@**B6{<@x-2xD2osW
zqdy!aP~wVgs=nIB`Y$B_D|ydW&CBUZ8Fz^V6-gcD%!U*5)ISlz5mZ<$=lOa(q;dp5
zKUXp8aRJ=zbf0sLxAW*~N{O!z6ET@*-U~PvU$a5DidbSjge*<A7?lQeUM6jdF6)s0
z=DLvFgQ<i!6!1#}oI_2xXK~neX4+Pvjs_uX#+wKK;dG6N0Y2YDh*4y^w`)O~J&>?^
zfJZ7qiD$jlS0elU<(7eeK+skSxBnTPrgsLJL3C8IPf#>a?|PjBIDpX60T?h4;FAM(
zk+>`<yf~opyWS#B@1?P_;nRi0!STs01j8osh)Ls{Zx`V4Fv4p!eu0TYj^H}xJgJ^h
zNN80+I|WnaOY)4G=L~7*2jFijr$vS!K5eH5|2z)V>U25|z@x;_rR3Ru%!SQ|_a_)-
zkm~>Sp5hwNdMD-IBq*+FBo8S8#p>-BFZ9v%7#Geh$A388&G7iZe`0`v`%S$b%mV=3
zxl6rcOBunZc17UxHlyoH-(1%zxr>Z!<*lc2V1aJ!EeY4JU-t(fpj-=89Hk?zZeA~*
zG)nxry^Itg&$#0dho8RF1g}*bbdPt?Ior1U>%Y3nqhjzoS_?>T`^C%9oDqMpcGHDP
zeJC!u{(ti<hZG=G?-mgS{OdnJw#%7H5$5wqnsdPi?1yJSo%jF1)@$^|zc&vSQBpnf
zeiLaxpzH5)n-US7>Oiwwmhbp<{`>mv7P^hw&H(ts+Xd42)v;qQvs}98fQB(JP^ldN
zpb4g&7XY|70n|su$Y*{8`R^lvqD`mgIl$5@L{ibPU!twyi?*;70PjI}4X?&2EV_o@
z717J1e*=FAkf5X&v%jW9)Nu0T{-JxZ#mMDa5+mQ<cc4g=K8P}Cqb2d*Y(4X+Z`MDj
zvC>QU{c%mY0x%I9Ne9s})I5u7>ci?#06OZGsnU(n$}ZD*jj{L#@RYT%1l@o{LEU$J
z|K21&Jj_j%fq4MFdX5Ixj23V8QJ{x<Gv&wq6XZc4M1Hd<?q2u|V2`;K^#i4Xsy9Fd
zVJcPLSoRgSs*LEKg5rQH_5+E8IW`RJenxNOm<>=;PZ;9cO~5U-;^nwWbr9)^dx{=Y
zakt#*RCm80$$m#!pTfXm88u#1H_b8Vs_6qbi2*DkGwE)pH%IKB(h%lb+Wyat2Vofd
z1$)hy3t1=O(fjhPuXxj%w#>U=z@xFH8*o}LRwuWX3B9lpL9MElI8C?!udt79%4_qf
zKw7W&Qz-$%9PI3wYq^<IRW`FkxsN>WImi5;^=BFs1cXup30H_r7N?GeP&m&g{J-s(
zIT-RC;D4WV=_SA~7zMYvHEh^FYX{Z26$U*B9@g$yamnvLEloj&o5IOJMGyUIa6n$E
z9xP8#erLqoN~(PeZUr#h+wLQP3Nz*u)hIR*Vf&9%98H(LaGnL!hz6HZ$)wzCa9&}@
zPm20zR@@L|FywoGf+tfyV(_fprKfUXdsBrD>GB340U7CtoH99R^=-?E`g++TRX719
z4S}}{;9%L8g{z_i`++zSFeV0z?4f@cK7FR`u_rwW64%7{*<SV1jFS7ml(V;D{culB
z<f_R95qcF&UraS}(vQ^%i2-XrVx?wut8iE)c@8A$(e-_MQwS9XGbqXgri97YOh`+x
zMX(GDaY48GeB#E=%aklE<2Rj77$$e>5?4^~``TR2%2?FvUZwr&+osd~yHW}8FNZ1&
ztD%9{L>~W|GpZ@OOL+lfpQ{K6I}6?(Qq+f|2;!!)qv_rgFc<DkjMFHROvikRaal}B
zV%pdwEY6EYZP7z+i<bfadW&`IM?WEy276_2k<DEHk2XHKBf~=}90#Gk?wR_it@~Go
zwa0;*^zG242KMJuxdMnF=^9VRHh4`rUSxCS$m%fksnn39)0oZ>*}!f4kr5@cmsXw&
zAMgA{Q&?;8uMT=Hsu$E?RbZ5Ik{a&6r`?DZ%VjZRb}L`n>w$gIJmy%Qt735_EOb8k
z{JNd|?og!6Dw3)Iks_0!n{T~f+!<48yUx%cG_d2<lSieQ*rMTOPY`!XxkX!0gIN6h
z#t>m1?(~pjBaFgOyy8+`*xd^iYHxm{^iiyD1<<WZiJgExYfO|`ME85MJ^5Y?<`S0q
z&TClCIzf`2WeIBl6_>^wm>xR$-;F=52f}3v$al$EjSL`8%Eg5B8h)KFh6O*ZlqtlH
zvGv`;t8@Tk>v8`6pfyD(-iY#pMI1owZ;O2I&NY2-k!MpxD;qj`Aa+`mR)OQ#w`1$x
z&ivD}z0x=tb2<K+V?#-%;%@e!M^U|S1LwyIbz5+a5$w27I3@<q+#O)QqMhS7j@|89
zXpo^bB?X5II)^rHylLsj!jH|oPuKhrO71$cqU#AieEfaV9^6x^f7@r!Y2RBy`sSPv
z8)&_)OPs%_bU>eL$K6Y<$!Pr;@{bxwh}4zP2^Pe18Y|$|zZ&5(pjWyQoUfU`>5cpl
z=eWo)0V`wnbuhEiYy`$8$X4&BOZ2_Ww_a(wBaOfL@{d{bB9_I@y^G9!-Oa8%UPo!z
z#`ZhJefczX4*x`8UbK$QgoLorubZw*Oo}J;<o})L5q=8mOc*L&U0b)zF0rDvxhUM7
zGbl=aLx5m!YtiOPDMv-m@KS7Nk3t5<HFPH`VRuL-Ro<s%9)0_E&eqNE#89SBibdw!
zZu73E#@wY|t`Wbl=$7ISo>jK9ZhTKbU{<c-ZBEHORrlxLSk$HbK`dycivMWT88V@<
zkoUL$b!$fK_U2uCAN8*4rM9NfZe#qGik+cv(Tv)*_4@oNaw6pfT{-%jw{DlE@t501
z5{%##OtPS$`n{uYZc3TeD^F`<-8zDNNz1Cp7rqmj0;bY?2lujUca2)%j!>K(ql3LK
zL@K$0;fenqZTMNJR99S2Ex1+H%s!p3O8lU$EMM4gT4peSAuYsh5_!-T<*%?qp#Ehq
zD9?VS-(ybh-|Q9cIdzY@1}5pHtH@yefj#W3F4lysbA?Y*(~{!mnJ5Zf7_|p&KSr$@
z>aorYhrDnjK(NLcrnYRBo<9?i|F%C)(xb=<zhu1g>aCoVXrh;!1F>yVq`ioT^DWyP
zVB%D?#(3iX{%YB`2og^Haz*paT(SmTQ0Gkdq0xm{gB!Q(Go4q|eTy^I`GDikVRzW8
z&5)P=?Pn$GJIaX{L@YlmAL7pm1OV>5VwHvSimORIX&Hk&)gp+&(6lCU^xWcc^{%$4
z83-g=>gi~uBDp1`H^xBt<cDuR_N@5WNMPr6DtXMSK6cj0s;3z^TDUT}pC6<yk;u|f
zmwv;7PIoO)PT%XC2pXEcMZ3u@O4h(8ZR>1V&zZkGSNZJ1<nS=BDfoy~lzl8h`-$Nj
zs;SN4cx#umr0@J7#CSie=1`D5^)H+QWjb6DHCVbXe+-H!t!&${*dw;H6T~?p?kk&W
z6Tl7UE!k-&Ej%o<y58Zc7(&Z1li!BZ{!qP{1!xxA%nEta47xV`0?xC8zJ9QTad}9_
zmlATj>KOl$j@-r2(jy+okP46Jkgmv|-vcE5ESY8A+6`2%8@|6aU#u&ln?xARW7=M~
zAgq4ErTo3tmrCZl+<DTD58A#yVLX2^LFUyln38N1u9Y$DLI^+C(erZ}XKwYIJc~3i
zp&F*lKm5V>ijnDIOs3aq8@USX+1$>Pb5GvN+H=jQa-q$0s;Lvm@j&Qz0X}gHY{azX
zlh<y(R<b|0np4GnNx2Zrb+I<c&>2Zn>i&D}MZ+&SPc!rhSe^NXEo{H{-$g!!6FNV|
zt4nQUj)&ML2XM}^*KO;moCxgvGrg)4lI;c>jH+y7QbhHZA8A9@Q#`P+3>94t^Va8t
zty@yRhfpSv$(lL_Ib*svq8KIaz3;yS`KWgzVlp^Z0-1l+`CK45-mZS(S&}8oWOX{w
z4sVokm&WyJu5yY(6hebMuKAV}$<)QV9|z+(3cYbXp5H&hXz|p5IDyjDn$5V#&;6%m
zy7ODCWMk9p?&S#dLE;i@;0+_*GeutWOPt)3V(@l&=;*&Lg`JW6ontf!EtPjW{z%@6
zlM&^1Sc>cC`nTm)gY$oa^uJS_W3WcI<2$-&rqAL16!X906J9|V0HK?<qTr&Wc*yK}
zomoYhg0sRYUe+B)(K2+4F9oSIszT1%7}-7dSw%A2n>ce$8h;wb+P7Fg!b@O)phJfT
zMH{{l_ZP)uVz??$d}#75v=cAXe;bfps%{E=nayELiC<N-h%wNA8}+uoWuUIt)<W(-
zoS#2FvHvIz6gkbWL$5+T%$t$}h?;PM*{6l7?jrg0G7K9iaGyBrJhB~#>B(MWaS4t5
zecMUXak>v9a>_J^LA3JO?MM!Tl6bO@o_q)utfe{<#=u9~kIAO<ef4U`KCWW*VyXS9
zR=zsTHP@{!79?4&2E`3?anG2Qb;s<DZrM#J@B9tiBDDj%Loshw7T-W>tU=z4*P}_(
zYz?zXTYloxChpaFneK=(t5pwZ)n$FTE{UdjXYb$16lFpfz4ut&0bUVX!u`b}C2d^O
z0U6Tk$Xz~A$jb2Jpf6|V`@tWy2z+X(_gGC1nj2KP(YQsDcJFFGcCM5w?VUsbpk`ko
zg;<*Y+PHTKhARHQ1~s1gr_|3_))F5FvAk5ug%`ENkQu20{L<tuce+O02~|k>Ns7_O
z&y~q94F=DsCgER_R*xkSsy*`O#Od1Ht`Yw(busziJ4;4j{wME~x%~a*_g;=Pju*B8
z45adcUsn!m-Y~vj1<wQEUEE5&I|74`e_@@4rsMgq=so_up$riRU}`+o^&$@9<KXXa
zp3(u2NnJ{A#icNA8mnHX-Z>_y3%cA>qq9boz_{@NRm%h^KG|?Usu>e|9Lj;?XNK45
zX<^-w&tfqP5KQ7FKJ+t3$Gb4{VpKpPEcxtoKz<z8q+8<xtG=-dvRyeA$$E^l;WU>a
z2B%6U8)!Z+bT^3ysv&yMobLXjlj>JANYjCFCJ(R8-=`pIATG@<pC*g@-Qnq-%{t5-
zA{E*izZ#|aq4a&5kw%1zIHH@Rp)U_*OaQTs9&62Xi>n7be{`A28tVbaMA<}q@WA~s
zX&_e>m&QOw(RMuS;n*9XXY5O60OF9^jKQQ&9IVn2J&4Tz568cT-7ozgaK9?g5I(A1
z09?tDKye|}#JI(Vx<QogBLDUpHclWt3NZ%!duqG?#~WT1OS-!k5(7lG4`h9)C6LXn
zZ7?<6#aTY%_pj$!j|Gl12$l-2HTj_tPN`BM00_d@>+cA`=v;K>MH{E`ZSLmYQjAO-
zI-(Y6vUY-(yU;PvjKX}jT_fg=U1fYHtj?;8!WF=x%MOKd>p!^&f~i1y^ElT3!znjr
zd-u%OO*hFVJ(T>rxuo7rZjFH&--U{hJl-Y<GQiP?!J0@J*NoP7uEuLTq!&5RQ3s!`
zti|Z=XL?ltaCxi|SQqsA<um45G4~vx+IE4J<(lDkx{HGKrYZu@#Mf5bg`$`JuJ{gL
zeyvEu7o}u6Dsd01PFc@?CAl|jrR^UR)A7%iOd8wN@`^n(#_J+)ZyI=?==`eF|HA=V
zs~}N|%yb+PSBdld1C{>1d|-_rLvbcS8oxkyjs@>a#s@Rp**r}Hd`?=d?_r%eyEYFU
z>9neCRc2GwS{cg?{&8<gv6;k94zl3z!Ou$U*=Wh@4`Fs;)jZyMVzoBAYtH7za*&aO
zWT@Vug4;X1Eaana5l86e#`w|fLh;04_5Q-B*5->M%C<QnQyg(;SXhHasY|bHpYHa-
z;8YlCvs<ycx$|jBF;KLqNGa79>0LTK^pG+DI*3S|GzJw@R+sh)!ZX3$G*a&goHW4Z
z3UuaSHF0u%f5=$icRSL9QTaLq34>bghaPtjT3kotc%XW;icTd&sZXUU?!gy}xd~0W
z0V&ERfncX^|5kKHAiP@7mXtlP<EFaPxiD_Lg=XVOSwhN-TW!B9V<P#2p5p<vggKXD
z9Kh+3d3v`WlnNaM$KOW0UsqnoOT0ydZNRJ%8!klvbqu4yfCNrAL`O)dXwBS#m=&q}
zh6}~t=`76Wc|-x5;KllJ(dg2SmsYUkqDaxzG7#c<9m#UH6B<kapZvN`@2zE>jU<nV
ziGe;n&g&~vRjYesd51psCaqaiXoxt{bB|6(9$N=?lr0G9Qh8pcaw;4T*6TaKEbnGf
z#t?r-?>eFB<@VXQ3%wmDqwcUzs0|h%nA0)6r6c){xAR!(UkDzs-4zL_@F^^Ws81Yv
zg+-GkA+TRi@z#C8TZ1~^5K#izNX*kc_Cad4s!ed_JCV}D=YM{ErcP(0mprpE?4QPJ
z=c^}OsqpjbNS_24K?C;G5Z*9)P*a&$hH>rQ!Y0ha%dA0<@h3pvoUe=9kUqX!vI{Cz
zHHa8VWT!D%DmVD6D6_r|)@kV5RA*dbOeb^3k!q#Bo+i%nq8PVUx`41mCmBC-Zmeyf
za}twf@+1NZ=tfh8B}zV*t0}EVk2)}?WnZftob_VCitIvxpAmbjyfEF##C^7=#Ldmr
z9l1d|;-k~zUlXs^L7X(~=5!weA`UqpvodH|)E!RLdRG_C>NQD3ztqE(W?LWR!<^z~
zYcl9nw>zOrLe(Rrnw+reeCDi$EH9&!f?VaO#;W&o7DHksjn-2~W34RlzWLDIOgJoy
z(s|treffP69B`rXSqz3iv+~SJWRAo){rD-eLR6}>XH2FP(Z&K?ZQz6_Nj{xw-#7Np
z3X{z7qJ&WWSpA)CmO|q*z_H>;5wsFc{)*>8G=rFSB3z}Umi=ai&b9ckS;iw&2Q%LS
z;V%A*uct5n8>_-X8<``h*i+gthra+-V#WhflY?{B_A5<|u$CXxUsGmcweT?0<<zAU
zo|2Ou`O~<Y34VcLazwe`KKxXoekOXL`zcAvl)UC_3SB?nw0T?1hPQc@DK3)#(oKdR
zS{o<$cb_Q~H{#KVSXizn?(fH{sS2Y?6DF;GI#`9V${)^VeGA??_N3r{CkHh%a~`qp
zgkPSAMCPxlDZp+)Tv_n7$7M+4w+bP1s?iB^s$*VLZgti))rmTxM`Pv{^!^Azs(@2P
z$^xw$u|Gcs6Rk!Ea2Q7#Us?D$^>}<nr8q<yjwY_nzR*x4i^qF9Uz@2sWw`0^+MHsy
zUPMbG69H<0B`A9Q?XmP^QM!jp?XTmV34!~&|9tt41j9ynpC-u4K>u;s?D%=C9Uy|;
zxvT7A_fx4S&G5Jj@n%2tOKDC_sJ+}UOjvdp+=?}{X7ZZEd@~n|j=oI7kzC1oB!$#y
z5-uh->s=GrtX%j5_)bok)OM87AHGHWlHt7dj~lETzdA4MDE<->h94R{8y2}j=gXD$
z_`4&_0}Z>fBcE%kx>BQ;oP-46+#M2Rv`#3pMQper++p;UxNiq$%{;DP<yh@ywJ-H-
zGDSbr2RqC$0L-_Dc1t1Qul-x_Wo6<$`QHD3!fl_rtyl92u3xtpP|FKe1o@W=FN8z5
zy&~5K{^plN4@PWUATQOPD1>}=`(_c)KH5+YldU-nO0ZlVcQ3IMJ}>N7<sAA%tII9W
z*N3XZhE<v8U9uhM*1^fhu`*V2uV}e{J-PU!WsW&mYADn;`B*HX4;p177oB8}xgX6?
z&<06~P1Q~a_N}A}|CtQm@1h82Vd!mnqIdXb6p?HDT!Gbv>C<jAv+sI+26TR6`em67
zY;L$9^Fd};9n}EyK-#wFK2)1_Ku$CF4OQY=?`IKm6G%1FK1jZnE2Hg(soC;<g*_o(
z5`mlVFAW||WgPGm>oQVUR!+xPdv*D1X{#ij{j4;dN}Y-AZ%w8TKMnQT9yM)#5GjjY
z{#xsc9{BEoW1;Oq5y%@x?Nc4at?G2|3*)RAUZ|XpBMY9BwRNL<_Lbud=u4(sZOl{k
ztho=0{mzl|WG^2V6l$rxc~3mD$6Q2&|J1F$SncYDIc8Ez09ex-Ea{(%q3rRyCI_Nn
z*QaG7RYSKP@7C>}h_rS!4AL+Njd-rd=^3c}`X>ezs){gYr!${wiBlWD<#Qq_fsJ~)
z#1*el_L5DQ<$2R{z9TW@miJrj4xhMjyVq{!#F%5h(`-rzy?zO?w9SKcN<k^WJF~qq
zU&;3{x)1poUq222!=8id7Gj1z4U^+#hl}2-SeXo$>~m9zzF^1U#hg+1umwwU#I~`j
z9I&A|N}K1aKa2<mPF!n1Xp3snVBN72WfdG+pVa)ls+<*XA33+#u?@J;dRp`2y!3Nh
zuV-&tS2pzhU?kw1uwfl7d@f4l?Leu>V8sIJ*3oGRui8mn?25Wf{~{ms+B{-ae#~if
z>W{(NE>=Ci7vc1*nOLGz&fOKS4Zqs>$yQ5pO;0kc>dj(}8`(e=kEUGEUsztox^6?-
zilx3=iQC9}G{M+-<z{1S;%>Q*!wibT-JSF|G?p(`UX-1tG=H3DPT_ZdvUvpM3Q&-D
zlrF}QcUW0@GH$XAz(E_n((Q$8h1@5`R|ecgKh$1qn)~|&;s7(zWR9mMjg<<rba0yz
zaA9P6A;5!dd6XKy1&-aYX%kzEBr&0`fx%}#zn~wzJejA+Pz^41ef-)pR{i`#N7++T
zdGl$SvwY`Cwt=Z@iSpdJ0j-dqUn`yQrGYONqDk+!k}oZf*J?u1xIX7hk1klJX-Y5A
zqkEUNW4rsbTyKkrho17D5;++yOlJsB;pWQccRY|1o5O!HTEf@g12f2fyA-nDxnilK
z6V@=fY<F#>^T)8O<a5!oK*BuH{hnd1o-3mg8ofHPQCCqvQR6}HKP3FOmy+eSF}3&a
zX{03j4e4p3Bll+V_s7_<W&Xb3#~=Dnhc*Aq-1yY7M^fYq9ngPr*WluL?F9d=dZ{aG
zTdEvA7vyevQ7#3?-oY4c>w@>sP(sYgUA8CpM&t7Nx<rLzXW70KwO58Ahw>sqVEq?l
zH@yca$jV+>ip5JdR(HxO%Bf9zbiF7BkYa}lY@SH`(Xod>8Z-<^K_uF*n>+e&7!5)O
zgrk-Upl~uTTW2Uh>-4V9OO<?1Dch-Bi;R}r#0)DV?+?JR-l~qTx-sJ|%8UUg3@unF
zd~@X%{xV+yIiHcBqGw$$QWzvI-)B=PJL#D0f(Z0Q6aM22F^%a%;E@8TB0b%ArI}pb
zL@`E=J9gskzTLhg;xGxbgkY$u$6iJY#y#ThM8DNqHTg6jX!JsK@YEEiw?M@zx9>*m
zURhm5jl$+zlwOPf-ZrAZ4fsv8>>jA`qbV5VYxkO!nkN4AtmFwh-|fM8i#UaiDIkro
z{Vlg2jFkI>TgX#C-#@GvbG8;8l13brRP$-DeZ570Ex9Wwi|D5hDhM-|?eN}bacBO)
zi7Q5pKkk+VNvK>p->{t;(8!ojrIP{%2#ndL?XWA`kmB~$`U1KQqBJ;JpV&Arzirkl
zmc*5D#q})20AK+4q+4k4^)-*D#JDOR0;3=RIJx-0%6VU`<!SIk>*h*+NPc5DJ@m5l
zMBw%TNbVL9hO|`w_kAMt5H$}lnNp(QXUr%-l{^F40{U;`1U6lgXepwP&)MPP<1HRA
zDYt;}EbQlA-K~30GaKXYBKhrIE_wayfR?ufv+$dcK+456f7de?NS;H1$bS;K$mqu_
z^%>V4TaOFuXH1WHc)a6^mwF6Ja2<{>u1QGew3KR5{qSh)@2nT#we`DjY*L}e#EM_u
zoaUWw*RaWX1IEYl>@0I>08o-t2U}HK&UMM#7tMOi4<b{t0w3JB&<pfq<)s#lt8wl<
z`)E+q`SgVSSmpiZ^L&CWiSsP;rZWnL7M1rPQIL3;IIuFV&w84B2{hBC$DoQCUbG*V
zV>D(JKz_jLN@2BeLW#dCaH+hr5OUk1;(6J)!`XN7r}@cm4Vx<5$fAcZ^FmQ11&ZD)
z4EZdr*R32p=_#+8+G<Cxv;9wm?j7f+5J}S>{SW+JE=6j@X;s=Wky)@RW0%EI$kR%u
ze`2SIq&xr;NqC?^)(8a5*zC*(03mS?#UucNdy|#uB=0ZjurOh9B<DfNSU%u~8TR|d
z>i3#_mim@MU=#pVjKB<kNJ5kWunT_RA9vD6>__j}k#yT_2DW>nUN|Bs@M&w>IE)tT
zcK?4B<SF)ZCKRB=;~i+60}{{iPf_$F1a(Uo#kfF#(Fd&aIQ^AxXaz=%PZ<`y$Gu%a
z5Itr!zXNcMGkb@z_mqbOgZD&H7uTSU5VPCrww0?+Y#gkL|4gz4>%fKuSW@(kuljH<
zD8~$yl+CyA>_$rPFyALdV`{0*19e}qJ4hidN&x8ozvY0lGMesFreTl1^+KiU()VP^
zXQkaxcy7MF+zn6xHL407r?PRlQUxLKplOreQGk!;%K}+Gbb$Snz75}kq{GAtN-9!E
z6U7n%)AGMv{$=s^kEQ>jD1zd2<Fwd6;yXlE!gpslXD}cLMr6l3`ceC&Z@cADt8oLO
z0?jr`Z`;%Wf-o(d<&6>qD0Q(dc8+!1OK6E=hTpIgAjJv4gE;geJG0D|m)7Fxih$!3
zJl3}-PN}w1?wMXu?viT}H(}fg$Z<rEz@-<AAwCa5{Qf;|vIu+J1!CqQ%fmDx$0Npk
zr3H9v0v==Xp-oKy-w?Q?BTvdb*LP0MPkMY`6EJ1X1@INtv7F@6jDj%hFa7q!@mR{0
z0D!x$<(2AGkr5N8$Nh7InTK$3ZAFTwcVgE%F>buEA~!RC;(UVr?ZR4q{Y2A|7PP?l
zw^%|+Cq+SAaT82K&M~xi>uGM~=8sGgGI*p&MxRIE?Bk7T`4a<aO(BWDl<~Jf3m%t1
zb*((VP&38ovT-7fb?mpi>hJwYTXPYqck2d3_z$?0{t<ujFF-WKy|98l@0GsEJ<x%2
z;Y&5$^PG*3GWMY$hn_uVBbl(on^{;X`}6UxiK<sY%5;oMQ$N%rV#Qp_yhW0b`fv^4
zb7<@fkUB24HvW!Xt$ezQ59?}bjZR^alej3ZGE(;G))8TK#p;hJRj>k|NKaRG#JLDD
zNvtzZKg|~|&(s+!2mIB{fvT!kwxaDQsFG#)U{YE%G}fcXs(J+7UsIVP4$~E%xcG;*
zNtwCJz63W<DAVT;zmM$N5*0H2NFl-wpP;wZ`}ya}A(sZ5T4ojftkt&H30;t&Bo-Ul
zPe3eMdZjwD4F}umEs-lj#jaw_KB7yiZh><ybcw=$IN}?r{%y)tT7qtJZ)%N>`u}k>
z{f22{wB6yn>%S1@gQR@puojhYd**h>#kh#C<MD{m<$l31<R-7k$kHQ~XK!}8Hlx_X
zxS=D>Of@zx7D3;xzmwR=jbA-J@fRnZRQJgh*tW(K9EW}@cgQ(Q8M=I2z0ID5hZwCW
z0J`3k8K$<j9JyvRJc^dj69&j{{z#+zAVao~EvPl5Z@JjPvHSK~uwPYS6avMe?-&PV
zRAEMbl(|9$b=KUmMyPMAg-*}fOWnya%M7P?agyegy%b-USsiR2JdN<%6FW9+$olp|
zjXy;4h?UV)pV3Y_*Y8-EI$-AE$UayUFu2i_Vw?7KxO`a#4#zC)TK<NI)QMNpLw5;8
zF!Ghwfx3})QbEGvFjlxN55*PlFK&6<OxNc*vrMsceR()~(6ILLN2eEauQI!Z)qCk^
za%))s0A2&S(^Kpht6axi5InEPv8z4pc}%oehUfYr!ezIUPCY!$F+2I%#o4g8oSa8`
zwRO*mEym8yu1xV9ne#bTZWkwu6zq#t>Rno~)j<na(gICgt%2?|SM2bM>v)zusyN$g
z78&zTH=nr#PNu0rMH`h{W>t;#`L<O<4npC4CCkNwrf+mROk?G1o%BmeZI>J->uVz;
z3ZY_7SO4Lhm6+&NSACJ&L?TZ`_o$5apRUP`GG?EZX&j>`OBwxsR0i@~u|}RmxM6zj
z3dkdY4fi{kfS>;E>(AjSKB_sr*&;ZWAMpMuve%fJEQq7N_IoqV&i{II$pf7nky1q$
zeWq}_^pq)mmfPONopohC<~|}m#ej6G>#EJhV+vP!U~WEf#_c-_sUcC`dFMK_Xq(_*
z@gI(I`rsQPa>*~Kh4tGL^+C4YxQhxP%`nsSM_z;u#+dIk<yBxGEB`quXsLe_CgJnD
z{R*dJ-`lN(_R-?)T(zX(7s1#CO6|z^!iJ(a&{O1V{Dcv~G6z{F#3Hs<oh=30P%zu^
zPdvgGWCzTJL5-kDWNnJ8pw5E?DK}OlULR*?AVetdwR&1k`qJ@<fl&XAU>#Kn>#XTE
z1pymOQ2m5tk$SBha-C65Q~Ozk;p`zVtJU*_uiZXb@CB$*f{AblHdj$z$K6ldgnVJq
zW}0g0(UH(`K^CqoIk6$VB1&A<XRX=CqxeAe$UQQ0sw6l6*ml6G@&_}qLi6rGWK;6G
z6rWH7L5R>)%UG%Ld{5;^!8a#HdWn{tVBtX6paV#ixlz2xk5RF3N9{kH&X@`FI?tht
z_f@rn;h`T!m)-a)cKMw$SIbl_BDe9+En&Dj*R>_9j<h=*`7*DgL$d31tX$)&%mbp7
z_RC7G9dQ<FOI#)D>?q1AhuU+Tj&W2qGdmkf=;c=nqOxST%iVB34nA}aa^fOo5qDOE
z(R(u2XVP4btZfjMRxf^{{;t;?;JlPfkU-zRJ*HV09G?-A@%b%Sa!tm^7cuucTwe+D
zi9f6TVP>Nqsj5RkL8=t<nn%xqQy&`NV_n43<UAMyuL-f7v_CCrDmn|ad)=8f@-*~G
z8~Y%u1><=zOO2HLk5^Dvs8i_xTKLNn%=5E=H4yc?Ir$PB%&|F9XysCA3~`=&TkRIp
zLB%^vN|^?$9!~S4EVm?98mnxR<6xN7+aSjGOQE^e`J`d6o93JSQKV1LzjxVLQ8fD?
zl`!?qH(L3{xE6o)OsCN+tbTo6Wx~j>+$YWjdRA9SObzWUbI6=wer}!d+29!uSoC_7
z`S=NHs^Q-|R~oi)J;Toe+;-cJ5^~Ll`Jt$F1C2#Y#mw?TS$<)JbRzePT(kL0_yg7>
z^}ewSp|3$};=%el18U_b421vTw6<_|Z~a}8Vs7VnXiXOL|KPL0jf|~JsMQT9H^{tF
zy@D5nyFy#CWh}_Ek{pUdU)mlA!*n279;90i4<lM5Ez$@5@tiss8b(bzOB5fX`yJ^F
z_;Yp#aWVzSG!!v=%4k8ves<)1Ppr(!`UN_A$d_N*aqy@thn{l>Eyr&=E>LZPrClkS
z^R1dV+nz%9GsnA#_95BoZ02{TcobP3y55|l9J{C7$`RDH-L+2<uM}W>zcjjme%yqw
zo!4fzimZK4!f<0VH>;bd&MAvjw^*QlxnrR$_nP<L*R|3oG_7B~&2ch2V^iz(I!?+m
z)q`GfE29l>o8-QGZ$x3k;M-tLQf#E^$6AdQ!Kw<pOqkbPYwABSd23*cHU5?3`vw;!
zHXzERdzuod;>em9?h0GudMMhl$cD$TVpa3Qd8U5cF?(zt)A&%uS#p`Ut^Q&31Dy+k
z<++g7?jLt=$8DC=3ok3j5m+Pq>@_53FJ)!wy<rvI2RZv>(O-O>m2~D68!<-dOGw0$
zK@{`WvBVG&_cv)&**=LQ?KA5y+^mIT=k)U3_l$qW^P~3Ml5}BY)-}j=_BTuUQD5!)
zYe?j~Qw#E$oO~*NN3cE(tYf&`n0)y~<O=h8Dw~CFe~vm<wV~|K?3!w#2(#+qI&<x>
zM`Xg@GZH!HP&ZlM_woV6@1UN952`kQ?SQatH5r{CK9(SnN!*iavxekB3gefeCG>nF
z9AF;#2~z~Rt3(dQuKUF5Z@NRy=vNiqzG0>X`Gp?n-xQJV@v{{?-8J`x;w3A9r=C<*
zIZunJ`r`E<F0vV_fj6+3n)1|~`YImiRLx}WDUme)_JyeDrVpx1`16p-A>UZ~u-N;=
zT~0xIyQ~LhK#*P2z;^?8oDs#ZS?y#wqZLPM4CGlelY!U2GR{qPh!ZW+xzEjqZXp(a
z-LvD9VIMD-;~XXwXnlDz5rzUPS!czBE40<6^(N8BTnmNjij0|SyvO-$DfWh&^kNeo
z@Q&#N?Wf>_mgRgU>QxUZkEuk_!K@YHI*5m9zzHBPrZz9ptU@hO4>P?@ydHl-7xnwH
zxWPdz6S)6a9Jmw70xIEA$#**{+tAy)I|#x&s#)}+z;VTz(R(W0zu9QL_^j|TKzYq<
zi|fbC#lIg0@Ie*B+A*yr$?Ho<Ze&0bWdxn2A0&lw{}|Bkm@6;9Rhv$>=aAgtQLVt{
zBM@)vpqF#PIemEGZrLCv*Itj#2YVqaK@Ni#R6PUhl;!?F0wV-5fbz~rpi!?rlsr==
zd<|eN(jKtq<8tt4{04|dh*@;?EO_bBhyM2MHVAI7IXg=RR6U_rgdp{=<;{OM@4N!y
z%>(DsJA0T(Rq1#5#hi4BZjtC5OF$*3pu<T%>Q_BPms%lD0$4kw=f}qDndzKie(|et
zTh;3-)TZ(_TzrgQ`r`T=5wJ=I;;bK8#e^kEyaN^M^>@(R?nqzAJ^Db1GVqEE+Bn^Z
z$n|%uXJY}+HG#n|RYsp}w#<bUfRpg;<4NBYN7rSmDH<@JbfY6yZac&MZ%@Ws-rS0(
z+U)gXF!E5X6k&$Pokw%=3@}-N2)K#_Ic6^PX}v^dzMNMEurzFG(j?Oy&*u|zDlGqq
zPWCG-_wtkg)bXU>J%O;lg`k`~y$WNdlIGZV4w1eM&8I1%fP5zJJ8UVBh6Xz^?zteE
z_3;L-xCIxO7>9NoDDeehC)D^<Aq2*Ywgl5Hcr<`h24~Ha&OIMC%92=cbetiEwpck7
z^HL*p1IrJ2x#ewxNSJ!pfvpe|n-+~p%dqowNng}Qyx{YyFQI0dO@&?)p?-RoMa<GM
z$7yEO<O-<4UhnB)vy#m0%^4wzY6kyRKj|st8|<i8s5}?SR41NC7q7+R1OdeqjsIa)
z-a`ZtAbDNs;IR1JLyvv2skiA$tm!wJH(?<RoT^G6Z4$_?TbmitVUV*GTFz3d?>h^m
z^0+C9#Q26Uhvld#)kh69d>d)+h~(GQKUSd@ag$hB;Ad3eO)QuMV4x1w24^;VN+k#a
z&OPPrhCBd$@#g7@hlA?kT6A1}WJ?PNfUE`7aOB&t791&dyfP>7Jvj=h9(d7k0FY>H
zbM%fTd~%W^7|TTptmDR!G%KeVtyi-fz?n!9Mlr*C9D3rO^|7iipCnK{R`{M`=ynle
z5y>$!G!}ZOyN#DRUz>7oY?q|7;g{g`nAF2*UZ_VWW&dl*Y<il8W&C!Hjoj@!p%H^2
zVN#g4J5phT&S!FKguM-{nCr$)Ed?@?Utw_4`zwVPpsQUUm59|-BKV|V{Bi?3m-M}3
z!%yfFU;9;*Qas-}dyVr5mDnrhow~)VUtsEM_tL|Kvja{1^>WCz%@WV%@QhT~l>frr
z!9cMCjcW2)A--|L-W(7Nec|qtn}|_)i-KuRmEf=V+#$L%JonTG#N+UWr9dJ=y6#{V
zg+ibQw-oft`MbwWL7Mm-<n`V-QYqgJpf^^O2{p(9Vd!4mGr@BJ1}D?Ka<r8G%SrEK
z!k3eI*?UW5UddUrMgHzSoimmmg)d5tUjSgzwQ06vG+%8WsEz&Rj<BbLs`ZJ&=*2Yu
zc&r5ukjfkAux)<30~ChVg=`5yG!4ep9Vj)iu^3%;BYQex`?JDxDW#v}86_Ilo5r?z
z)@<SgAXre&SLX$Hgme9l-<ceW9cY0Jr<}YaJI=7f-Fdgzf77Zc6;hT6{`}pJ(?x?2
zRYzGPdR#>my(RzH`vI})Hyt?`nw90QjH|LSf|1v!g#-$f`&77r8nXLWp$Ct+QXVC|
z`1HWfxQ59j?xhzx>mfXy^D7Qx&s2-nXl7+5C(a*pdQt&BcfQQui(Ex9axXSZ?c&?%
z-Yu4Hjg*4sEBlN}aKHp4+7i7)3L<?-@yX4qs1`kU?h-ox=dmf}&tI6p3|USi!rwJ&
z#=h3YS9=&93uK*gLS6d97qg_yUu#WEL@~K?iY{tM#8xRbY+MCHjh)VRf{MH4#WRB>
zw4Ss<O}!`PO`PUg0^v*XV}Bll4QmJ>kT)?OeNxzw`pfTPJ6P0{Xud(C4s(Qp`#y}!
zN~R-Lv(?%Gq#qJWlw1r`TT&=G>ie3;SY2h#nmU?b@tB;q4%CN?bESU98@oXE&W_H)
zY5B0Y?gg!V@9#W9A6eqEXEHl49!NUy^(wMtc%B!Uk082}4R}WEHohv0`2?3iD74J{
zFjv1E2d41fvWalJ3>J7;s?A!CjMw}I`AaTL5gB41pKsc%$b5bTi{*hveUN6sMob)M
zSaC%bbqGCjGij*sm|92%Ofos~#1X5FP741L&-;!IN3_}j0WqqEyr7`J<SxrZ;jazi
zB#pB-z4e?X`FW3|?YG;TdaKq+3m3F0`F=E~znmdUtdkZZlP_%DNJZ9Wmi)0=?@3ny
zq%<6&a1!^GfSwwbW`10B<Y&*yZ)9^Qz+BNC$)<JEhXY{pxexDtP^4}v@rBPj=h)9{
zYw<Z`lzza(&1gW5_1=b$QWZk>bEE_;yjj9n0s_+b%$(r(oD&jJxUKGC$QC){T0P}y
z4W7dD97{l+6iNLNPH`1jJ~mliLzwqR!KLI;^Z}1K9uZ7|>Dh`!EeK0GwU;`wJe=tG
zb}!@2ZTTvlW#x`Mjl@J!(3r<Bs+SE3xAjAI&3ibf1huLTcHoaA37(&IhD8$f-+j|i
zXlHZ0vYMsYb<%xJTTSbF!;@RAAXWY8qd*#td^UTzbi|aR-Os~Ye7hU!_<wLS<A<^R
z8QsnwBpCByR2n-{HfZ&|(oJ<2y1XRj_hzE=O%<R~6DP&qUY=}AG$Cm{8`{xlTucrx
zE`2+3ag=(+toTdcUbdmaoG<oKs+L9)n*`pB{q~hF#CFMXPp@^l6mr~KxA7^Ovx%!#
zl{Evb${H826iCvzqmv^=X3M`@qw|)#Y+0C)mERtA<?OMYrsLBMg#d698xKg=YSPd2
zTToe#uVhNy5MOmDYhd}{^w=r#fvcr!E{658MEy%6wLoVPPRv5!iNy<s0j`*qlbplS
zVF`nX*pJ1QdbMi?>KVZz>TuEZ)ZJ$KV!bHhrMo7XG1Rq0Cw^U&fT^6K1Ubq<AWrjj
z{xvKkgQ2nL%1wCl#Saj7o|_HwF=vE7T~twNx~wTrxMV^hW6J>3#sy|U*V@6Q{}z-h
zF$b>Pl#E6D=A7L&jKK)!KA4%5D?c#esk60n_0UzFIQUuH_%K$Haj4kYnb7&WD$H*(
z&C(fb`nK3w^t<4HILt1eKX(so<4W>f>%NEiI)vvg#dz(|i;&G+`@@j7DAFpjB<_m`
z`8-?HA*-XxwP3!?k>VXHuja%Tqk>fLwv~DNesaS8yxiY#r&(*X&yM79Zc!DLga~3;
zb~I%BjQZhsIREguBzMpPmh1<4s)8{=gQf%x=VjIH_GiA5OY71TGz#LDCwOqtzIGTM
zW4gg45YWmyOw6RMiR_LOH+>&6%dGih@qvic8z#C80Tr#ve`1{KjS`9XQ?n8rYY%JF
zl~v7(M?9^+I?Du%`PCp+_2p8sjTU(_J<m}g9kxH5XiQI(6n3;2la}f%$KR6tc-#Df
z=^`{=W8sE0GZCUtnmXO(w58uK7PJMkzB&4VvjUK0bBj_dqb5ra%(KV;N6}dYG{N^#
zcnE?Zf|L>?WJrV34WiQBDN1*Y?$JmM#^@L*9iuxGBt{QO=>|tPlJB?gYS+8k{^xhj
z^EBRDj9tzih^N*1`FU~swx-4j+I1Xo_iix!ss7M>q7bz+S@81a2IZgrAAlwK>)0C9
zS2i4V)k?Jqmm~kH&*Kbcy=q9!*sRrF1n$61?e#oL=9f+1C#&EM)puln{F<}DM$Z|P
z3=1z`ha9vX)$S&tJY0F2T8kEXM_H1Tyr^Aa{vtr$052KkjU%s4mz`eYj{05NfPVaG
z;y$Akl6D=I0H11posti(-1q@=ALI4q?SnPr#uTKaa~(<cG;87S+J%4GHFLNZrC!;{
znLYO!xR5+Ep3HB5zK4i;-Cvhv(h04m|LSOK3xO&PwUQ3n5XgwMZnq8(Umu*GagKuB
zum`!jEjN~3cLi<nt179I4!B&*PD=}i(B)1b47McuSEF>yQTSo?DaYqq1@#4LVjbVx
z!?)6=rwZ>O;s=p}@zzH5zw@WP=;b#QC^Te}VK2#OYH;Wk>FZ7Qb+LExQjUZS02K-k
z0x>>Wc-r{#E7jqjpje&<lQ4X~B!%LjXZ}EgnZ1HvwPGv_YkDdCX@~yd*EX$=6ZV;d
zV)Vqco$=!F-s{^UNj1I6qPQ}jU6J<OaJm>Pr7Ejm+e)<NArj~79rKQMo4#2edd8^l
zI=PA`yVz^4+rG{{XF@T!VR2rPUuGprAQpatfA-TZ2R$zg8&xJw(IL^)((&rzK^n?s
z-gTyb{=^-T&nds^ihcbbKv(hadp8m(MIji=F)Py5l_kqjdg;~zr=!lF;ETqHg3I(I
z24j9nbI7Y387l)@#A%I|d*`1uT0}u(=Ze|0eHnfrc^x75>aoRXoZ|Igd>lX!7-CF;
ztj92)s=2<`ClT&xIov1?0N&sj&YaGhau9lO4#<xu4&1=+La4mw4#<bRUif=XR$7I+
zwb!2OjNkiJ0yE&^CZCMu!WGiQkok%hc&>6bHYm0v-<#NIt*J(d%!p)~2oBcO$qFXa
zRR)B2derQ*NsnWZnqa!CfI^KNWb<J&7!Zh(YOQ+N`@m`P)K7Y8y_6-{S#*EW*`_x#
zfQJ7`e83k*S!3<*yHX@sK55YgWe#K<wh)@a+VWJnt(HrIlGDn2ncg;P#JZROyUIR`
zCc88GkFdH7=k*PQVlONGax^d1(h;wjjM}2<L%T$K>o6Z`67yO1AE*ZeQJLhm?U+Tr
z=CP+AW=kQ~^xOmCri=Z3g6i~|>fuybUffL(dOR|QaO`wA`WWk&fb&9F?nT<=ZowBe
zoNU;G(Ai2{!@W_US_RA1q_B{_HJi8aZII)hiGARnPl8~a+k-D3yJ_;1qlNzfNYfWT
zi+Uhyi4=T@fkB#Ql<f**5QSwqDO9oel==4ep`K~8-yTlrENAA)@ec_?MjbVDzGzUV
zr~aS&KZaEA`rmR6*<D%cx82WCI~{;>g18*!yB~!|uX<!1q%pJK=CG2SsB^t%*VmWB
z<Q#Kp&(9we;traTy0jow92FxYw7C|ZlTh21>=<a0u``8^T5>DfLW+Qt(X!TTbCaQy
zInz^<xhZ#dH~v#iW0Jp$vf+Du4j)ZFDa1uHickxsHw)inbMWSIF33JqyMbW`#xb_e
zb<AUg^P*I5ea_z5>)tK(87)eWGMTt$+nWA9;MJ(9C0bbUB3=!j6$)mLnr5)LpkA*p
z@Pq8c;UeTr6AnfCAkB8&V{#fo{g?)`Q(blj!!dh2Lo_xcR{^eIaIpv}zxArkFE&Dq
z*!dY2)J^V88Tg%WXp%;K(V1ntVL+P@zoISaFLmkT79?3j(P9N18Sli)vkJSrCJots
z&JI{kE#O2gCJ%O~pnU$eaq&~;nb?m{w6*TBQ&ZZ)mt*4pzke0La;Ejzo&W~=RG%;%
zPapg;9r&l*ut*=%EWFm$KksJV0{%AzNGix%Jy3p9UJK(rRKP{Pa=DF^S42C!_dA+M
z4e^t7U+K|;cVosUY{NsLoRW7vS=_k8K+=q$`A;h%Ix__u%h0_Zuc9y9E>6{0{|JBW
z(AjcXm>Z-s_|kq?U4tMhzi{|(mnE_E-!X?F(V@E@qz(S+#hy;ZvjP&2rlR;6gRZf&
z$s#l8hrAAPeOj?=5-f&XLE^{N@i}Fz{JDEz{vo}bsXT!U-=;p1(rG9fPw(FfR@104
z6q?o9h7=6N@)ff}u}6Mrqo^3cRd~^>@2r{{OOR3;F(>AWil5jA)GIA`xZJOP%Mx7N
z&Ud?iWZpPTdF_ZEVD#oR=s6bk`RDvx=#cMqH;;oa?8S+(D-{E))inaMDWX1dX_peX
zs`;7B@H~=IIt*)$?%Eq;r}+$gGn3**LeQxcx;wQ<EHZ?}Yy)z9N;a>pTqx1X>Olch
zkQ77hVAIqqAttt`r+LPe$jNOgUjM+JB4#5|$!g|YSi7WGDbAMfkv6e2`t}nC&YR%|
zk2}H6TkPY@twT4Y_?N(#l>I&q8l%#WeYk6b;WJ6+yW*GSA8W67u&rK24Jk~kgaJn0
z0ASgv83|g{A@N~o>64Je&ShPzm+~QM&!h+hEyK^WuMXn18L$MP>}OKqS_}CY1ti<r
zd>OwnZajiOSt~wR@OQ%gQ(6IRF`49OCNwd7i{5`bOGDjm8!M&#GH{3$o23MC2u!({
zrOe3qEElT}lqzKY@xO5GH2C(;&6|YUDpdD7-arB3M=J8kHQ?9re}J(LZfl4$x?$+8
zw^BMR_+uCDGLn5Q*y&6UUVeemr@ZT_R=#e#;0>A~PmLqO56~U%1`>skrBauK1xcq4
zdQ2+T=H*}!+>*LX)j;jT>mR!p`Rx?8CAdgM>I0xiwQ@Baj`mLl*SJp&T9un@Z+d>u
z68Aci)5;coY>t}9QQW|rhFG&XSk{zzoL-nUUR5cq&oIK0Wim^^p=Y{c!1G=90rc{b
zHowzZLJyXB4xIA4PKT+q*dF;$s-{KTVzV#>^Wh+lh||T(!u?>IVrJF&L?q2tix9OW
zFkBt2E+sLp#40avB(E?U#hCB`7JB8c1xJrKB*iFQCu$(y!qAY342==d4Z(<0anE8E
z28~X^4VlQd@cPm{RhAp<<hV<j@Zkib4Pu0EI|a~IAQVRDbLi4&DsBH?Z58;|n1cVI
z<@^F!YIO~N)-UjHmJu(W?ubNO|C~SYtIxL^+OzT=9gJIQD{QKFgX@e$?Xv=%JZ<Yg
z7Mjm_{~VP?9z%kUtBgLLTY`)Xt?qiT;o-?(<(8{_Svc{V5pe^_RaY8XoG6L&GOCvT
zT{P*?McH)gU#?^~adYNncRKjQ|Iw13rS-o~IU=JmrU&#|)~S#T+leC5Q<8w2>E~Gd
zCW3D3c2v19?aJe77O7kkf2NBAJe$%>k>Par*S3p-n0<gv>4qHpmOCs$)l^AuZNB$A
zrwMdnIoIDH`B?WncCh?P(l!>L3c!B#0`oHwRp%nMZ7jP=?;2Yv&!^T<*D!W-@qf@G
zTfI0?BlbZwzB7Jy3VGq7@vJBCS9w`a(4l|^u?S;!OCj!J?n;6z96q?G{elKaG5TI{
zaS@_JYZa2`+Npz2gX?}??kCaqAApMYC<CkEFx1eV0}<>TDdnY{asqb}rnrD2pWD^@
zo#e+%FuGW|+lc{V{!XL*mtfZvPa(U}jQafR2h}svgQ<_#tsod8b!Oxz-_S-Ds^z_5
zLP1&8qLji5H;d9TP--`c{E<TvSyu%G3K9d1EYGnzS^g0f>0%Y=@`e~Q;Bj#J<KA+a
z{|Otb9Ima7F?rkSEMvveqe*$*mw+$pt+g#xa@MT}n_?!tx@!9tOJgRQIrtl1x(Mbq
z5*7*Uj;i42^>&#GXVuxD#63qk`QYQCqLFl7SjLsLpD4rk4vD4R;5Y*^4MHlaNr)Bq
z-qwm=0KWcfwmi*edI&ozD#Rfb4KBCuPLT%>^26)?l3Yi%vkwQ(;Y3PDW8mu<?yIbv
z*|cGDhu4ySrqW>QijrUS`d`|@V$pkY0S)tK5_!#Y3J^Q|Z^Z+>k6zMX_OzFF#TDQ-
zgXV&^pizm_aH*-F!w!F<ZEnk-$&gPLN<0>!$Z38<e4E4{fO|*vUVDB_RtlHZYin4R
ze1a^x6zzIa4pzLr)AxxjZ}dJF9GQLN{3=}I@!f@~24_A)2^<k%@g2eS&Eo-9Y0_0m
z)I6NjB54WCGtJs|)%W`>uYYVC!?V>0HJrPwuZ$gS6;sCn+)S6$WgufqAaTwv(R0CW
zuO&kF8k-@J1Y@&(dU<`Uqrwd#^M4A1-%ORrZubw;R`aEe`6E;q+<h-9GhD3dW`y?d
z1e!Zc9FMru+_U4r-8zGNVFJ)bp2ozO{{VHo<`0v<56HaUt{WtoYhEn!?ZxZXVMKln
zm@1tpk2cxY)qw_Tqpf9rLB!akS_&)O%LGSB50GM>1K{Iz6JNwW-U{EDyGLrzqxX4d
z@lz}F`rv;yyK<9Ti|K<5Q(D_wZNxhan-}G6HtCSd(I;wjX2U+tl;7w)zIGGDLq$jk
zZw$1&itOYUl=<f7`;X1~U0B+a<Re35ICpa3lVx`tVjo|#j^V2$K%A?MIcN``RCz9q
z7^MunUAzQ>VFQ)_G@V<W>l7>2@#4ndoZihKFxzBxqj!2!mieUcXJ52h>fPlN<~0!T
zg|7AONKXi17cRnqZnnl(kjq(OZS<xOKM&YUZo25I^!m1Z0Xq-5!o>|8*DwG6H{NLU
zI_72a%$7~dtwot8q%g$jD=;sGIIt`JWGc48hXvk=N&Gm$5_<UD)YJ+}a2)ws*8>fJ
z$L~-r8`_;*2eT$>PFwP!9a!wvwW7$HaYs;`q@PM)I)2iW55E!*#7FBTb^|OF4`?!+
z0gwCj9>GGBu?HNIwvQDEzXApRPe;xwdQj3vr-Y`%`PMN=5W0+N%1>S)>`<WC*<MQv
zG&cRN$j3)al=@02$f;M{skR9QZu=xQ#pjxoCet$;B8q&*KR-iO@=HiapKRcr<~xgk
zFFVkO99@m)AVhP+l-hrQuWaET>azeC@*XgmjqYmAr<J$YZ5y@7l-MbO1*HOK`2Oh5
zTl1FoRVOqg|9s5Ree`>xVwRChiMtRXbw~tL7xfObV=8Ml!?WFSnCpNqejZP4+pu)R
z-I5skSrqh*iOf*B9!A35gP7>P^B|V7>S*+7)zA5P*I>>#9NMKd3B-vlyL_f~)QJD-
zeb>tvRlDTCcKk>2&`sP#hY5ub0qdl^2R<t7rlz$JKL&LiFNk`V=SHlC@ZtQ!R&Y;Y
zn*vE+(xW;8u6W`bkA<=#Z$iq#Mvovc5T?<7E5DROV6zMm6J<#b!2M%onS}|IaJF}b
zJVGD0%lWZp8jQ8Tn#*hVDMQ1=!%aQk`i@DQfEG-ch2W|NBcxH*1N|iHx*lWL>KadB
zdk3VZlYH+cLhWfpQe~tcTfT({eB7d;UfgbQGH~F6$H3$_Pc`qvt=^<5Iv}iqPK7b8
zkUXLcM?(&{O7bH$SGsx)bD(FS;2E;qtD1zWdn@v+v;-H_>_6Bz@!}J$ol8Rk^HYyP
z{D91jUT~>Xe>DgQ(BN5|k%JZ#nD|C~-GLl$Vo2ITw+HzYyKJ2d@hDKH!GbB|QlwR4
zE^_N>XMwI|9Zj<}vaa9hlek|Inhz|#lX4_~_CX`Ni|<wA?5m!KOEF&jbrGx7fvzQ!
zwo9b7bSva_C2f2_Rp9VfW2w>3M2oKTgCo<a8?VKgS@^<zC%Lo2@Y6tCB@o~#V>;w}
zeEcSabNQL!c21-B3r9N30>j<(`HRID?xsqYCPMIgW>2kO)utfJZCCZ&3iJhE>Ea%3
z>eQ(M9zr|L7dcCY!cP7SXg9u>UhKMSu(oYZy3Cuj7EfJuXr*vl`)K0x<5GkG`T<n$
z{{sXyA&XfM&!$;Jk?ywd46V)|2S9NCP0V4+cGq?}<a|UUPm7`~vUv7iYSr3$zI)t5
zLLl={UhDWDfRM6j*=e5p%g47bO!u9xx(+35#m<r0|B$cio0FG(BwpwxoYB?(2QXLM
zBsJc)jy8#!x#TmiBLoH&c9ggggoml)p!_EY`FBlWlUffmq))Ms(^ob1Z_*%rP)hNf
zWATl|q1H}yj;sf**V6^m+>1)w9$fAPYz(nMQC!|T2GJT#6Ma>Qm#x*dzDP?|0de;0
z41dn^rM;DKQwP&gwy&3FJtc~!e)3Wa6nHztnxx;Pz{_p+{RW*4l3C>w)=$36f8sDc
za?N&{2pLWOOM*)(hsLe#(`$poqZ}*q>yz!xRyYTO^_cG012!5p+ouFuC1uM7FS+Kb
z7)}bvO@v=PuO_NxJ1*aV{<(A5SblpvdRv?>f@UuKEZWaEC^WY}Uz_mNS#GGuW<sq~
zt;d3cj)|PFRaSHfT_nd|t48#$c3>9&KY+dIW{9}0q*c~n>^jEP7Uuv$gW%3NHNcE2
zH7tHowfdPPO7oegi#tfbxZK%=i&h`!YLL@Hcp+-+t&|6}aSCF;+`X2;6#cP2d({02
zwJ8kE?Z@y>Xv~oM#m%8uA%g7kh3_J-5A2R5XB9F18x#Hku9##>Xyg1{mZIh}n!dAw
zHf>keM76otA=$ye=U4_3&6{ku{;IF#b+B0rXmX~Fp506?a3rRR`x$GOHKSn0USg5v
zWSXJZo<Z~RPL$x^1%NXw1_b3t0T@aWCpw=hM{Bj8G)4)YG4X$=dGSuS3LN?H{6`CL
zmfl`LKQ?8oLT)0EUy{zN%&c$?l<}DO{Y#fM0)6xG%PZtx<bEL}dEV|k?qe@qnnXdX
z7UWetG`K_G(Y`j1s%p=qZ()S2qcGokY&HM<0+*`ZSrWWkgW?AHUZ+~I0e!HItJ!SU
z1u?5(OQm@9W7M1{-;ciZx2x>Zor$<VjlcPsGnd9rm_!f{8JmX8F+^w0P6<)Zs@Ehm
zj4GmE>4)3(nkzy2*Gr~uR&}lS(-mvmIy!#Vog#$E{)AkS*E2jZg*DtXGfcU|yga(^
z`~$Tdd9z6}i+pPqJ4(E6e{GhbnW?x!{I-sRIvsx<c|x8SO`R><-_%Q{a~nINx@``X
zJm5F8bIn;}^_PCeJw0vZCO`fb1{v@9$?xBK#3S<AK{Jq=>IM_%&%OR^^U_ZTCI(9e
z1wNs~l9CHVMRDAgj`<}F3L>lb&udrSSL#gL`9gmEeAao?$J*ZV*a>UB_M7J~iUDy}
zB+1j^QT#EON_V%5-=p+c;g)wJCu7Wva(&kh_1IOH;sU9Lt*AEeRizdq`$ou6g8ITm
z`K}z`ZXQUgA<7inRjGbo%`+B1zUNP;dM5cb|B$<7fGGAQPCH-@9n8r!<wZZ#JEP-m
z!hEsSIYJ9fGYg2}DVkhXP-Hv3iu~NBNEan>x$ii}oONenx){_nsv3;#wLB&!{IJ3X
zmErX_2q;r4pY#2xBEtQ=C@jYOeZCxJ3)4?Fdp1a^WQe?+Zu$dR@js8!L9g}PN2A25
z<!P%*ZmedR0PA*7;ANkx0Vi{^+GQ=;@we<wW$o9%>m*lg12=auOvqykWaQDMxAFjG
ziKcH=*`z!K&;x$a=p~qJ7(<ms!LaWp-*W~K+Z%J_pI={V_-bzB(X^VRV7{nNMWKL^
zl!6%P=BHiqzxb_3>5@*@TA@Vjpo1@eeKONbtgP*NZvWP5V|$R%RL@J!0N0g9ic3nP
zES`cZV@XfGm!YL-^CKWlV`LhBb&X%pwLB*WoK&s0Q6i4VC8ikIb(Cctz*7!~%GorH
zCdRxB5hvEsf}X%oWyOUm-!mIn7GH*5wL^$9S>)cNgSILQ-GsNb#W1ltTz(@@Hf*WB
z!y-zv<gEmV$)%0Qn_Is2vBR}Kckm&w%M<rvt<JiLkY{2>G*G=RE;Yqpo)ijZ&2M9B
ziWJc<)1scRjX|>x13JoV>kPur)Eh!2u5KTn4fgvARoZ~3f7yBFGYxcIiWLi5ia`K2
zrLy3p@UgKVhd)Vv(c2$Bk!4Ai|FeH(;D$C!<xd8U`6Ky=nlnV0B>X8f-pQ}}TXZ_H
zg1(*5{4ic$OlCRncEJ*_>_bjg@{CPS9jDZHh6jz}P(O_|%&=Ik4u%Gj;!IEgt&5n9
zaxm!?BsNSG_~0303!bgsQ2Fy80Al=k?e7#xr(Fw?xHo2&k|ZyIy1U<wW&?VUA$DWi
z+Vm=kKcIF<Y*}@)_c(yE(^#8s`O5gTRy^5oPr9!VVUy{bDAK=<mfSA-R_s(5ZYw_~
zK0UB05wq0)JF8bgRPwUo>m6gpgJ+ybvTVej{_h9NWPg2Pcj7aInwbJMBZRMvRv4C2
zT`j~0T&oZk5&fK<qt{>=i7qL61%EDp)qTdKBdGj!^N*M8yF4)yVU^m}zpzN(QlfZ<
zpQ<x)BpMU>R;#yJJ`^!&nC^|UQW_G0(0?=8Y@e49sYWS>GF-vBhib8SfxilvZm>^F
z6EA9@E(<XOfwI9<s*J!MNVwV#)>R$hF*T{-io~Uef201R0Xu4Lq{$DK;vh^@kVU(2
zbmi&Hd}9ot5gk>OaQBB!WyC~losY72ABx{heUQlJ^`~`{w3ND?cx2`#M$h3ceEvZD
zMbfJPL{B<X1~}@P47iYDKlIb+RM^n{ioHh*=3~V@n2F5A-*6aY^eqdcr-vGfF@doc
zn{_E1L+x-n+r0{<9s>iH{3kpT`?IY0#J!K?eSr*}e|HcH#^$^J)8rg%v;R6dusF*~
zwyh&2%xn>>JOTY*oZf_z(1|R<IjHo7P#XidkCQCvY4d00onGbN5~nw&7f+8vzqWZI
zS-Pw-lN0r8UAox(ThGgcQ<T19t5%N}J>h;s#3wf`!+$qCQOU6-Cgl)o%eJkfpDw18
zw??%wx|F9NFD#eu_c>!S^n$JEJ*iZHZV0fNwN4zys>Jk&WA94dPH$(qh{#=BGwF~S
zY5>3T*WH_JUA2Hc&q++tYmi&H=Y)}4QYqnX(%V(U7C`K;6^uE5hf5}q;wFie$zBIs
zlq;e@k1DI&Ixe?=tT84EDj_t~bIWk9+wbRXd?lOB*a;Ro`JGhY&=qCVi}St@h@3NM
zLw+*pQ>@f@0Ij3ag4I>&8tohxNbk&JZ7xZ06e|`KeOYYv<(`8-*hK?tG-ma~s336G
zzY`!J9qVCOFTx~iZ+4A>SmDyZ?Of>@mVHbv;wAK+0XtmsE=A9F;^n1d)X;39x@ytn
z?qXQ4@X1xQapLij>fq8c+<=p0qyc&6B_%;S(UhJ-w@{5VKNJJ{lx-v(n!dQ59@Ni8
zTM`<N>?4b461TPTKA1co5L*qp*+6ctNkfj7k$<fQqeGKA&P>T;j&#aAJ?(mMvDT2n
zl>r*6Y>Gr41sR`2q~S9ZHO5GpK-I>~;5vO<>}EP5*aTzrYV1Ei2Ud@XEu=&nZ<IZy
z7u>cdxYm&Ac_&F!Txf-5M-YpU1kAF0_m-DSl9x`|$10V}yUs4kD33+y9fcEgAl%i*
zr{dF*fBl4vz@Y<Wn(<Hv8lE)WyNwd#jJNZ?^qi%x8Q^6E;YKkhElUlxM>j@|TXb*c
z8{4+v#3BM)MHy6a7o(hz_mB4}ZGKjQnEJKCw^3H|g~cTzOngd=?#FSN0tip!gI3Dc
z4-ZvdRwc8NA}J*nuR=}0u0X6kMD%F6?3HOch;92ol`YmDgbP!(?7p`DqZHSUNWlsO
zsc3dPIb?wsd$Mw=AlKlOhx?nUC+b+S+j@~?XrEyG97q51iuX5A_2^1glFQ(ASp@yg
z_R*eh{G7hr(BJ^3&qg(mW5n;;(L9<h^va>I{OzI-lA<=-KrAlf!C)1V^()2MXLEzK
zop6H=xWC@&ctMox&etsTSF`sNsli1NdRc9m`!nNpWY6kx#(KxirRgA-Wo5+7Wvw@H
zH7x@7qDpvOH8a?Cy~<(oGP(8Ai1)EMhDXSTwSpz4&;eRs!)0ao<!azjD?R`G!=+pr
zgu*ewnf{VRdy~-6{oNph4ayJUb*yWJ&Y1WZeOWI2QsqAlSz>u{(&tDd4>Q+N06;D<
zJW?9+V!F1U=QVWONX?zfsRWTiFRABYA)NTlwchV%Vx`~Vn1)HGvg+7?7iRK#7vS46
zdk{{AT5c&ZF45|i@mlBvU9Kuhx=M1CeD?*;DYas@y1RrI6%XV`u8m;me*lVSYLM|P
zNmS%8tXs5Ox+JR_$IYk?fYRn%LBw`7?1er@jiT5Zg*--jw=(S6{Ou~U%qn9jx;O6C
zyyw1Cc~k$wmH~F)SzRslC(Z?OOec~C;Md{2<L!o|2K@rFH27`V6)``$h~)S_^}xHj
zs${gMUhB8w`$69E@)w>oHHRGrUUD)0Lhmn(qm!@tH2?YZ8W5;t9xOjB&v?^Fo2@Ex
z7O<S}jfy)PF=&u3jY&Ek_n#`TF7Y%m5j{#;5~0|OEp6*WUxs(Na8J-2EYnbzifTV0
z7C;U85j46bo35ylD|l7zxpN!feci|=!kRRf?z!~j1Rz6YJ(M>RjIzESeZpY-beF4H
zw>Ou%6^z-<%<|MUl9r3-=cTlJA6nzIvo`v?)nyuO+#VguEw@lhLH#L?K1(kyIfVT>
zq%%2CW=UHlWO1+DB=N2W5}yX-84onK%`!nx(6JXaKV4()T58+mHQfZl8$1SgFj>(N
zGZ;i*3&g@;!a%y9<6%%GS9r>|UBOD4da^hsGwJQwORyGV32N7wye!3HXtMj}d0Ib5
z5yGS)wYEJ{PMu8lwrg_(I6G9o{BJDiy-{ADzzZk9qtbZ-A{>;<w2MkL&3#@EA!%&K
zyGZ9j_*M8wvb-1?_b@c16@`3L-Z%|BT^lUGK>DVfRvV*7r{3rln2M2a4u{VYP%|v2
zW=hvu)EdhRJ@tNPm8t(^K+lOW7k%{(9ZYI`UA3os;`9SJgH&&<eB08l(3)jCGDaCj
zNtRHCP^1q6_vuCo3CHQaDPP(COd4l?JJa=E*0l$hntJa;_e!ZWZE28z>$+hWsOQ_9
zBBaLdib9ny$(^q=1{8`?Pt_*{n#fUB3&(s5D%meoxHOt_;f8D#Z-c1Mt8=QDI^ueM
zd_q1HY9Ia*Y;$)bK`lNf-oabVIR;PE(N6pa2#mMRX<AE0g$4aJWdGTqaMLarq~Wz*
zltxdT>!a}XI)Bg+`1g6DH`~u($LhKhQb^PrK_%^@hv&9o!#xv?eSN?1RqR5>K5dxy
z`@T~*%psobuVF=epHew~=$AJUezyHtvGiby93To>pnBZ56DzYuH|=>bd2Z<RdP>`%
zvFTH7eduXD@F>uGSrP3t&Hdxe0dSh%UVBMkm(G>k?o?_8UR+rde6cEgMN|d2ErgWl
zQSS>tQ@tUS7;TLH?>rJ?j<AzYfd^|#IbWJ9zW5{j*MD#s9!1V^Tt-Uy4m>IvD{S&n
ze%56JBhB1yVR~aeCU$g=l&PCldSE<OH%Q0SOYhcCA4D})GIy7nBXwC$O`6WS9$Nxd
z>)r6zChC9uE}D0ox58AL8Ef!Xa6s@M6npK7%~ifIsMM}nfoG9{It<^||0qkE37!P{
zW*Sl-<`6@3NjSYvNaOO1&JF`j%9jS={{a}2Us6kjpoav|)Ft<+T=py;;$+aQJg2z7
zUNX<4v$g8pV(UbMOn$ssa-8B#G+#H*ujRaEj7_i$4+3kBX&!`;ZF_)M7-W$Wy5yz`
zeYc721u6dJT3e#%mzGd72Zd`Kd-khjypIt)?jy=u>!yproE_d6EYn)2$GS)p|8v;W
zK5?n3YI_{t{F^g5jw{*Q${E0kFmS<jBcQ1g|EKiZUbvAw!m?^xuBa~4^BU6N$(qSK
zJwhAd!t8Qw^I>uU%c*@Bg{%v<ojgWgcE*Dn+Z%_9eo(#|`$T<Cz3O$or={d)`K;F`
zp}<sy<{5pPtoOi4Bp!`viReBqR_ZX+IU~f>c0<qDm*~Ru1QF1jJ;pyoqO_VMD&^5<
z0R#SZ-cNoLHLuk8jC@ncnmehVIr-f?ywy_nLMT7KTTn~Yi<Qs6Ss-;C;o8Tq?_^GR
zU3o8ugmrx+@!)KU<p?RRl8%7c$%eSb<))DrkL8`jsJC<(3_xWltmnkqOs-JF-Pjd>
z?>~SIZH9GIk|4MgMGY4nlwQ2mkNaS35TqeQZqkh$vP^srrtdd;_|1cY(=dAT_xx*L
zB|3OmSd%y+9newu0imFKZS>*&FEK@G3B3VPhC-q##H^eln`c9PgLcx})6ZPYiEAu4
z<EI)I#YL5`s+Zn4D}KS>X6dJn-?&efci7RsC)wp4)(@QBpqJ@Q4peM!N$){`Vge(G
z3?iYAsdW>nH36G9$r}FMHR54aNbZT{=D9#ItgzaHW_V~54>Bem@1J$^eM7C;@eQxJ
zRq5aO?|VBj;r=1AEVs0yc|FpkX;05pcw||V4?fLIST<g|i;6Lk_!68{%^R+G$syw%
z#x-=&nQYNPn5V_E&(N2T-oWiCSit!N9!V+`*Qb7EYth<}=wy>ZV`F$3r*$_m#qH`P
z8#QR6(?|b!5%TJS?w|Q=7C5lHe1y7w16P!$i@qYSd7^Q!u|M+MDBs)K;);{(30e|s
zk(g+cuFDe3WzFm^4hz>m-9C9-&Zo7t_A7=o-vWGBq1VvP6|l$B&O8~~h!BXr;>jVc
z;`;=xUTZ}ht}&qWq2QYN4_v%+%uYBgi3q~aneV7dA@dCRPJ$}*+GEa2=5_jwfx_l7
zKew`n=pK_&6R_wGQ;jsU!A*cg57|!hJh3P`!d?)e;5Qt$!&I~>G^0%L{xyj6jpXZ6
zl=QU4(W^f?WlT6@!HqMy<c|X1IPiGpU&5LFZsJ2Tae?LK--a!}$IpUEVw=)$oKFAc
zX|<d&LnM+-EQI+H_|ynehwa<|o<25eq|u1IxLLZSyG!_R-}oO;#3r=MMfCoeKPSw2
z?bfl>^JzPsqlso6nu|qs>>!c}cw{35py?V_aV&OBr$v;AHaEE?_p;>eud=g6z5_?#
zT@tX(RP5=Cyre~iam&r*=h@6M$R|HnOq1=0{0S!(xWL`&x-rPrE`X13mT5mk-9rl;
z!ES>xUwI<CyWTs;@tM7S_%e?l09JwQpw^8n4F$!*BwZ$y@5+EDg99?g6~V7QKc8n|
zV4QKODuhz+q#eI(i_hPZUn=js;hjdYOwop;NaCu)@3U4;#EH&62KMSc>{8yMnheSy
zqbwe+i?v>_7as(U=h|ArhxEvqNvIZ>4wgMm;YVGi)f;Sj*<b3L%x^K9XK5c#TL6#g
zq3^m-U!?43u8cpJV35xCmHz<>n*NT?=Z0$9dW0tw=6&d*N)4hfY%`1F_NOrFVLCIj
ztCH+ms6TrlI!_2>-);<>N*PswS$n*IWP|UkjH#>MN~4`#Lirk102)&hbhp_?fpWnJ
zR^8@AZL)5MzGSduOeCH6hJCk9H<Pyz0}R*nuW?DbOZuA^HS2F!-uekMiN=Qsw~?je
zeJS0TsgtyES#7RqYM&02<LQ+s&Qh8)Q+;kM8cHvIxY!FvXgJK1byRwG3zelpC>-j#
z*YhL{lYNUD;sT^9P&9nCEWL#97YIQ~vS_C5X3zGDh8d(Q^GWBWB{u1Hb9x*2r|T&#
zJC2^mQs~Vr!FK<{%L%r$Wj3P*y%<oMK5W(=<j46ExCt$3-Q}_o3%e7Y*huX6?z%@1
z9_a*c>+=5oUPHiCd#CPiU{wZT`(_~iV*29ig_O&VR)>O-D#EMs@?Ejgwbd7D^3lD}
z1*ENs*}@{mKj-q)?iou~!|#K)&u$gj9tnhp##?z-S$^uw`N#Ir2L3Th#F5L_XmaOl
z!=~#(B3g3VQD~CerIO~(mHX>_i+$EoW`Pq!NIbc$SidgC3YB|NabI6OWc-Uj6U>f*
zX5-`U!c;vShf+z875Gu2!$5Ot#8;mIlEb&YqZV&sJkQo=Yu@fX-EpXbYCTGdZ5<{{
zQn=*|MjC4>CV&oPn<YI)!Lud9j(PcRdEH!B;=c1*02wFMItX57NjSq~BMZ+|vZF9g
zQUS5lo*V%11>U{gl2v;Jsre&M;>R!aK5&BiQRduoWvz?vU0F!g#SpK=df^;1+qD&-
zjS=SdZuLYd9(LO$cE>*dEu+-M6wyGQA(^u=kzpvm)c(jc=dz4Y?<=m1=wE@p_a@ta
z#V2rIW{DJTBBCXU3RS-LV1KX$TomRl=oBx|5Qhv1sx1kHQ>(QFS-#d{wvh_Ekcs4F
zCi^xVwdhW`It}7@S8y2zUzcbZjkwjuvO(g7v5k-Fr!7t94X0{aOEkH`ro@xWMk<_N
zpA&C@I<?=X3On?%qizm;JV)*1M28YZS7Wzp*7XLzDBEV$B#QzzCXuFA9=hK%Ckdmo
zqOtb4jU4J(CdM>KtKoK1>7c30p7HaSecLS5hJBvz3*y=&NA&TjKsL}ApmV>xfIj6`
z+Z*NXSW{-JllH91SUJ|WEG`AqSJk#p<F$Y1<!)cIl!>tKf7<t@B<VCj0uuf${&df~
zU+#3A)NVaJ4Uem*RlK?@<C`f2VKLV~@{FHQ;M(6z`VHMdIx#yxago^7$Hu#7H1~E#
z|0WP6StL?oeE>Gg^Fq<?_4GWgiL72LQU`p>{M<dXSTV)mjkc9}+xU|jy6rt^kVCIa
zS7L@&Iqt5*M+=#+JIio6keSHlGt_a#Zy69GLZ4G+Y0u!hIV|d6^n)C$bN?N$$4pf}
z%KjRSr!NR`o<uCC`in3adk<WcaZfAYk*I@pa3{Hz>wo{SzE+^JH`&6>!#Q5mo_gIo
zNRnjG-)fg#%gNBI8x--S<^XfpF?yfWKSM9R%c7R(9U9^WS0^asO?L38?h^FCr+HZo
zR$7e@Iy2?s@x(hNl!F{15ae4dLQFX`if}b(J_NFH+xhpAz*U(+>t!Jb-d%Wp-9C=j
zm6%<P^+$Ja>f&N2%8#WW(TH>M!Jn(nGr9ft;fx8A?gXmixIZH%g4s%t^rahis~7o?
z&oLA6cRd&-7`(d}xPjzXxH_1ffs2V=?@HzwyGfqY+b?oUQlO;DR(k$jmez@`jvKCe
zLNIDi+%V^YnS1ChwH>?lYy^SSUlurMA`3i<C43ayZrwQ~W$d4i5tyY+$dk@w`JYSK
z7sj8{2ieE|s$C6S>6^%-VfeD@@5b4lm)o`zn<g+>>^Rata-*6RH8L5W$W1y_`Azh;
zxPHU3;S{W&lqAl#Gx5Wcj7MX<23#ix`8T)$y>Qk5!N+F;tqy_ER6psPz!Ie2{>Azy
z*%X4`<rCFIc^nwcezDu0qEB+tx%Z9&y4?yyZvN8|>iRk5EsX3HoCJ*Q80FPD+G?)I
z3Qp<IZ33~BfvC+R9h_5yLZjY*lO8T)X-`hnds9m_{1-DDR71-^^RD`$vIPynT8TOD
ztoEt7KKodnY!9CD&BNIUpy!kKc5H_al;kp!*g})2Q&!^tKe7L)y^2|5_}#Ed&%v%6
z9hrpS;3*(@a6QxzE(y&AW6Nd=#)-}Ts;B<rTohK8CH^jl3Pa+$RykgGr32_9y*>-o
z_zTJj--G|F)1VDjXOoa>q&DlXo&Pf`6{OdbVBtMP_8>RRmHnbVmV-1RuEXz+CD@a=
zt1D<I+oPI|eV*d0Z*-M#ylT5DMF&3?q=294Dt)4x$jvMvj^MxR@;ow`sSk`v``kI-
z%Hq1r&{*dBijLoxptMRn1?~FO^x#{Po50O<Uobv)EiM#_2MOsRTP}e%<|pGe^ZQiU
zgQnsWm=+Nl#+h_mj3WM{#6bonmO2HVn+80JxzE#z%WD^AiuA=c8B%5GN^ToPCExJO
zPPCLz{2+hBA;UJp=>@_?Ov}-20fAVLg%|-9nmwE2rR=qWS<0&4?X<3lDB9H+OSJ+o
z*U=9TEfV=cT)`9NT+a%&>7^X>KyIRxf=a@{mWoRXg3<Zg*?E^`h7=UJOZKbJ_6Ccs
zT(DTi_BLQFH;G(m$exBM>iE38uZ5n&C$}PtTMqS>8Z%$<1JdE}-W?g{uj_a1fA;=E
z%Xp95K>is*LdS1qwo?KR+n$`H@1-YYE276%;0PdEp;=EhihYZ<zYq>|A1#;YoI**L
z$~V{idFaOOJg)pF-#ct2t&$DwsdBsjDSgU&)X~Wif5+etoct)LZj#rzTwp;c$<T<u
zU%gC)^#XPd>^kh*j1PxMW{T2tMV;VgoO5k!jV(Ws;;Ly$da|-(>MXSNgR?^-je7C4
z)p8yJceSi1{D5%Sc?@AXBRo?Y+>t{2ccn&M<KOw~wYTCQi!fvg!8lkBhdukbe7Qio
z_8*l9|A;Yqp6Lz;Rwp~?n{VcbpU{+l{7Hj0OF_SX`d;2i9stZ@W@;h$KX7_a*9puh
zd)3L&zM;#;#&S;iVlMx*zgAh~g;*EhSQJuOQ6Sh<TiOZ(ivu|~lSnmCGYC5HGgz2F
zY{H+I%&;(lK6{F&#y`zI9>u9oYyb)z0J46CGc41={&i;N_rxPlT!fTk#S0OUXB48E
z5h8S*_#V&;bt!S%pL#Fs+LLOy-S`$~VwHg9xpO@uncl7}w)R@F1(!Z&-7i)TMIqAD
zf7w*y7fm_nGDw6yi(U{R#qUEE%?c#P_vld1JkV+tf`eayyz+_<x^?!-7LgH2wLC)=
z?p))eDMk_3?!>jL)d0Pg{WZfs<qF9m?ws^CjzHRdzXoxQ!=D?A;XlKnoae?i3lhhk
z7e01jTyOE%kGg5l=HY!ldrsN4wGjVHs<&ZMm{Xn)<-<2QpFfOED&T95+P-A+1nLeK
ze540If+h3Co@;R6n7(hl(dj6BSVh;AUM9AF)=jiTZ~m@~f(wJDdPkY5h~l=w?~Hb2
z)JYsU8X}j6#sS0yV6Gg4vTH??3;~qsl>5Sm&AeQ(6z}bH$#&R<XjOD#6C~+}+h{2+
zbY-Z%WJ0mkbxC7PjI}fMz@m#m^Qx=-jWyXI3q||43cby?4D@4y@l(PETVZfb^H<JZ
zTq>O~cR#k7y5fn#Kf&NDfkYj%X{pqDlL2DjNyFi*cSk4>BaIUFOlp%T99hmK(q?KI
zq&-j<hSK3K;o(jsZ=KxHha^2I#2v<D^*cT-$>8?pRzGxHICOfF^?nAtTFVA~cUe`x
zHWnjs_i6G?;jwLaQA1rrmePNKhVS@uh80hSqt>A7PZ;JlsHTZM6t6oLI11!*%B5gq
zf!xRIf9AT^>6Um$hxRI-#ru%K8MBvdHY9ZNFW5juLAc*{XD6|*X9%UUi|4J8!14Tp
ziczj<AN`19>nEzVnr;xNq|;LE^7^9sCFn;U_;rtX&m}n@K%eN*n<x0-etF896OGn3
z#DeO?7Oj4|t&d3b%qUAh-L@bLA)TuPKQ1iE1HlC?veh=Q-A>)}P;2~7_c(HJ_UKjY
zk#6hfec@bdJEGoGa>xg+Dnn-$pItE~oKI98-wACEYR9W-=YKiY8F};NhG;VfGA@Ov
z^Hb_Or&f|~7#=d6R6%!N>$M6uKV#A6Itww~7o)Ff0Tr1&$LQS2pI9Y)|BKLyVZN2x
z&R3?Aq_O@2;B-^k=LcL=dO3AVDc7g|JYkD+VLq-DzLc@atb<I-PiBU)ZSzDj)y{W@
z9GO~gG_<Y6=Ucb&;F2-dECFpxB~lI~J+KR90|VQVPjr#O^XRZ#<J~RuFp>WNT2Hq!
zr&_L=&D{LY`YavD{+KNO3wt>un2gdj%sP}vJ{-~%STo?%Q{wdYW@wyzQtU{ZK;7n!
zLAttFiTtuVNP%E652?`zS(+UdaOj?T+U^XN8+-GqO}4zk&&O?GEZ!e~ek5TMkF0Cg
zk#_0AqiA_PsJ-XCaI-n?HOZ_;q(mqnbntvp?4nP2=JbgtDS1!nKVH8rEJIWO*3@EE
z`rUN_XbWJK(>#iz43JpFqy~S4#-8%sr_JX;>|0>H5dPX^(Y1&dC{D_X$23RrP<;C~
zZz$^tN%7uBfP7P&lC4OyQjKJY^@bLmi<uIjOwv|}*k3Jmsq_9H12Cui&EXdXdwP)S
zW0GB>T9lPmc%PgX)w-|4lh@NnNL$+QSB-{$oI}D$+&jCOw!(pDv*FGpoT-b5Eb6TI
z@zJ8cko8%;-<Hr7oy-)&1uE^;3-93<xOlh&75qwI#z?02_UR6mK|0h6V^43>i++KY
zMAxxKx#lpYbPc}dcotk`HwzUFSYa1Yl)U*VRGkbwro{HBJfneY_;WoYz!BN32UEy>
z{$)t^y6JEcISvSLSHgTKtz_5F@wPEaRMT05IL6U2;*CCD^i}$;LbjD7%GrB2C)$n1
zZS-kMw7q;97jUcg!2uvwR45U6(eL(I(zaBzpR+g_@jPn2N1c}E=6!Rh=WTkZh{+;Z
zCafRpWE{YCW+C}iw!CO>*)LuxceK%J@{JOFty<AS@<D`v35=FCZRA|AC^1$$G(d$y
zl83K;Ft#NIw^$nKCjCAf1}xO!00I6dh>MA3rMJiFQOx4>qrW)pVTa+|-x!I$VhMM+
zSegnO%=FoGM;wGdec~lK=YipaWqYy;@C<sd;AG%qF6d_O*5~16FUa@zB*kDr)8sHe
z{Yc;ox$bkmsmsd6Lvx9`r}Rp%r+A_vm&jCPhX7t`e!V$MGtEF^z*!_ciSJ;y;PBw<
zY}EJ?q_B6?;j)Z_*!EMeb?&h6T4+D`ACc`PH1j@lo%QsNs!7Ujl#*Xra@Msil0eM$
z(ywcf^?UP7rS)$~1*(}i$+Ht?RPg|gr;8%*DnQfCcg#*TrEn}0FAlk9!T1$oyc&@E
zl3Z1t_-j7zuis@G@s_~b?fS!=$>0ThTkf{9HanJplJ=$^4nT+!0HC4yR&=|pufqQ2
z3uKAOzk0(-q`|K%Zi}!px7Jpc7b5(C96UOJX^1?(yM3F}ye4t8v|zIcGj8KX?q_L3
zycZxhi6Fw88JH}mx6uCn{%j8<m=Q|XN;fj;uDi<@`qVO<zh;mi2b|-%XGq(aR>AwT
z*d%)|GjAVn;o0lw?+fF<By}{`0755`E+g|#eO-G+XINgs=9sB1SGZ4yHaYnWo>J3D
z<h*hrcvOenOn&yptbIl(JNqNh84AfBOu+HeYl<T3rJ4t99vhy|5FNdTd{Z6BQ=0Hx
z=oG))=*t=*CH)HGVmUk!TI#7%cE<aGokpfb!{e`n2L642SnFV0Z{6x>GHHDS`l?t{
z7c<w)w~X?5tcgD^)_tJ+#_QGuX|th;HA8E;;)E;KlDGMJk0udn!P{j74#gycf$Hr@
z4e7Fi>-oMIL*xtQT7@l0tMzrb=<p+@em~%sF9v1r6LOb#4C=kd4+Eu$9kFym-VQYn
zvHHoo9;b=7&2r}HF2S0H&<Oa!a=nn6%137tln;2ft|Pf`6EAkLB%ARg_eMyL=Po$J
zZxk#Z{Z;3IOd$-_OO}??+O8WS*OKfGv^o^s)eQ}YI%bfs{HTC93f`n}(*JI%jDD<h
z7>4gg;KEfdc+oCW6q&1F1<iMu{p^~h!@n)2HLggQU`2CXGdH-m&}sRj0J&u98-0%j
zQD>dQegfF3Z!6;8tj(17U1l;cF}0q~xRa@nzmz<duxUD|ta_LttmVc5GKk+!s~1`X
zu|8$;s7Lg5lJG;a?hAs-^)pvoPW^HJ_~R~jhK=#_9EAEk_4~krXzco%_F7V<NJA);
zon`D7MEQKdJIy{P?x|vkyoBZ#X9B7%3r-G!12<pAab*r8=KHoE25Ec7MDM&<gcny~
zV_edp(-yjal5qXhSt4O}hULZ{&~gbq;ZqxXY4c`D@PiP9&I#v7;F<P1$QeY}u(b1>
z(pGfi{LbOIs2JdGn&3V4DQ9`8t=k+hNr5uo<UY(+Jh#TRA(9N34x(8U?I%#(sdgZh
zP2$M!mmXJZujPmUtdeR6L6j}PwK&{Lpkj`QP4>atsY}~GD}OiPZ%P3~PNy!nOltI+
zEWGq_r@asa2?w0bC9E{pYLPWnv7d(INq+JN3K0BfC)ptXC;QELf$!>!mZT}S3=xUO
znJJCPhCD0w_%Q>(MtHo{1!|^@5EhX%SAX!Sy+++%m*k&5U6jC-&ZlCdPl4SHN;xE{
zG@$L(nXjXA7Yr;ZXc`gHkbDoUS=XjL1}|ZxhXtZ%CR~OcL#sV7t0t4e<H2fV;y&WG
zQ0mo?peAzV^F;yGSnEftgl|2j7#c^T;Z6>=nIUi{_&~+i)jAm8RfPg>!Ryu^$wNjl
zx!@d&Mr5(7+$jSelq(|!l@rp^FD6s~tc}7Au$*a(sC2V%+jSVFj}@nUk0VKvYOM$=
zfOuA!(QK(zvMh?YlNLGmytUFv>qhxs9A{L;-<^pME=i1Wz5j=j5eVW_Kr$!kUSQPk
zBn--P(Mc&z`-1lzKN>c$)1;n@1J!rI#qddtY`@0jOorkW=3O+o?==>qvLvbP0hgE8
z02Sdr&$E>6e~CDcE?ZrPw_ufhA708p`0qKoa+k0k^~Boi_Q`0iuDi1MCal4Hrb=G@
zu%yVALrNHt>LT##Zb#@DP8o$ewv3hV1Dx9kr&;5ls~B*r=)P@yU7$yY<=*HOx#T)Z
z^9#RW!|3bg#FMHw690ZV-9qmHO*JQ+CtwUM=M2_c`*C5Y({<hVDy{bPei{SOE4=;b
zUHG^Op|l>gH||+Dr_Zh^Dv3x{mOb667Aj!E7A%ljN#H#HLKT4(8c98GjQ%DNL25Q_
zid8}P2XQPW<Hq|GcA<kCIp}?l)E3T2(?XvJU^K85@+q95Q~P%kZSgiCH7CDYcCkwJ
z3yi86^@+xQN3}9xjn(P}2BIM0i&FlORE_eNy%HaPw6g=mPMH>ekFEL@qDQ2Ul<}zd
zQ2wfSJ+UNW+i=Nh^_209jXW*2L%XAR+7Ag!8vfs&E|l%s6J8rc4$|x?-GRcD_RtOh
zQvKph%d(;!EaIpb>t%<;mXY_NmCf1gG5<6nM3%74`;FN~Vz2?k%IfZ5@OG(O7i)%T
zG?5X}EhDQ@8rU;q5XL%2Qzq-=V<{pxy$<v(2RZrur=MK=9xur`bd^{f<BSI0+XNx#
zEEc(v!|%V%H!|zA+(meVYRWOZkjD2g2D3go7B`?wl;_S8y4H!>o3H9Gz&Z~wwcq}T
znl;+LOzbogw#$HQ>A<=%+R#pRO@48mW48{Hh7kYI#CC04M2<yP!4@te<zxz*wLH<3
z`djuWAqPGaTS4KmBbu=#hGbWi>b?%pSG5WgJu=qJ%Lp1*tnS1LJNTD1D6MX2ZG$`i
zvQ-NSvxB9u<2e5>(hpOutJu^k`X^FEO7wx@d~zIo2hq*EMhkYqB^l&IKx}Z;fx)#h
zzv~v4s8ABLM)r9D2vj5j!X;Y5{OI)8e05Ei4*T~T)>>CwaB&^2{D0Ew;j8P_WBb;f
zZ-3d*%Nva%w~JRL?oOh4{`S)A*>|S!8F)N2<?s>wNOcF1!f>7!?Er9-5|wfoQFreV
z(vXClA8F`cqo^nn#>%Oj#$sn|=m@gJ^{3oDhjIJdpDV@az)aFkNu+Hsrh3c)Q=Dg@
zpwE%l?bBcXSYtaU2S!>g8{1M26MO@kvx2ZCLfXHJLEC%!;q(Pr!wEl*M(2_Lk4}K=
zJ~}Wz!@!?Hh6Hd-?03>bl+>=A1>YdX6fzm}`=$F|m)zingPuQUx`X{Ih=ir!)VP?U
zQL5ko?A|O&`jU&!1lqal6`Uue7UML&lFG=#dZ;maQQqAmd0Bk4H(B=m7q@`BSn-kQ
z!Bu%{u((g@Rq%1pE-g)<2&3<L(IPhLDVK#FHZqwfb~rex@Pzp=W@wWKPH%1qK}?%u
zzG?!g_TI&PAx`{jzvv%ZRp~Bvq-{lxbv)W914Q?(%1l^Dz^ViY5B0%~66L2Kc~)NU
zKI#E+i|b|LoUSmWDn^N36ZjX}MZdiE7x`=)QlGZ#KeeDvqMxOUb498=!JcVYsj|71
zeK=)3kT7Ud#=_z)#Tl_sb4S{aff%#c*sLrbG_<h9M@SkZ>|XKSEZx4;7FqQeH~8io
zWyug8sJct|CEsVeBWkT@qz8QUov&T0l9H-QtHtxoFk*1Y=&b&W6^X;hLcEWJ0k!gg
zjeAJi;G&$P<@|S{jKlu{8$sm0erbg8IVb99Bfe@jW3*tc4IR-EXC7Q&F#Fu|QK)8r
zD1K~WoTylmKm&DH`LiF&I#At*YmEyUi1N$^Is;FI8cT!<fc(_PjI@L1e!S<UYTGJD
z6nKyZ-ZI2=H8&zr(7Ox=?am6u97l{6$LC5^t@s0GV@<goFnA)bLk!!4BFfFP<}K8m
zbJm7Ymk%0-DtON|H!+M%cZoyF%aGWAJSpfY%Muu7VjQ-24gE-~g#yneS#g2DG>S)@
zxrI;2zzRoPQI^q?Ps%?I!k&nvE>!*A!n7ui1%k(A!WJQms-YWjc;xVN*N&B4hwjfK
z@T6}Pip4-<@{Y8uI3FT%DNaF74@!vOyI{*j%H<u#^#(=jK`IYWaZ#3EkaB5%GxDF5
z8bQiPKJIWaier#ti)yw+l+DfMNV{7Eo}H<SxNjLfJ!z8S3{K|ftv6`i`M~|z?ZK%q
zyOi%Ag&}tY;Z8Q-`cg2IMhIbPA2T2TeiaOnr$VF+*y+isi*C7Wh*vTWg8)?9Rz%aI
zTLP@CcSv75hindm9e*05nyi$66LNM)rER89cdbPdTU)MV8F?gCMINPz09MSiSwxqX
zx_$48UK?FWvbNBWvXF4nobdjb91LV;wrzi~Z8Q%V+t1>k53TLbgXb{q^O&yXApj@<
z3||Bt++wTAYjghq2ow@Nm!&{kNK1R5W>vV7;T$m#sbJu?K_>uh$)ZhvBz{B0`PbH}
zdpd92kK#MexQ|2dz47out*b@lyQSD{;B*jhI%j@K=dU#^7WX%jne6N}`-Yq13>QtO
z{fo^&0v)JW<0Fhd+y!35lUl|tE*}MWjqWu|QFONU@fDUbVvI_~pJy0t$_`5M81?Ig
zlT);9MoU;e(WSVOB}+(u?pdZ~3KSLq008a_fKGazOhum}TC>w<m*J0+!@*YVd#Enr
zAa62Bkd`g?)llv`RWZ&$I0H3_f2O2f2)&Ntdt}?GH=2tZc}&QpZDOZx0nT|m_N}W+
z{Sw2%_iB6{sZTTbq6Qax0!po%Ghmkuv=9^zn~eHrH^rKcj{3HLpKE7-smX8si3wYE
zh1xZc{q`v?)5{<33=_x|ycNeZk~z3-<&wk0w`r$%jxRS=5P5oRt+~=P%VA3{#T;ao
z!8`?SaUK1^Z7#w)PY-D88MKlVp6$RYqXn{vrCF5YJoP;)8+FwhPY+l$+Qqv|Z!D9&
zyrXoHsl;Ivav1V|Sd-7*=sB9jbyzPYOMeeVdp6sM7TP=SE=c}h3EW9=Sb@I^30$4R
zx;8URqk9##kA`lpEhX^Oxq>8UXWuM^jsu+hr3O#&9Qt5lvb0MJo8K4N8E^EnG|{%`
z?uN^90=HK<18C`to|xveX0p5g0ED4sO&3lD^>#NWSJcvfJ87H@e(l|(W?b{slY#G9
z`rZDbHSZ4TiK=`t{{ThN;d$Fk#LKw<0DeK0X-LLZNdt<lSlq5}Xque%{wwiKou7le
zAsZ^VcwTpnEm;oM05IG#!z2RSp1z5x#iYgd+nH|k<ETw!;^rqJScg0|Rk>5&Bpl!l
zGg;QLq{0_}9vZxhP`}k=ck)3yqeUgz$or~JGB*9=>CIeOJUt!%0Eqs}9j(Onz6_e`
zRJ(5~-C7a6o&gRQA9Evd=Q*q;Ym?+$(_hL}o=tngw$|TjhC7)W*fYbPR7QnP(SwtW
z06O%njYj&}d`2U>(jaK!xn{DkjyG9uOAndMp@`dm#(7`>>DLvTd#GF7cy3vK#~M!2
zsl2qda%7RmJGmG^gV~#C896uu$u&O}=@zhoW2EU<mrZ?h8%}0sOK_k7VoU(p&)#A|
z$3i(Sof%YmBd(4TQq|~>MQv8j;>$^p>RL6WwWgR-N539aV-0~4NJu0cl6IcGGHaIB
zykDn(L2xdjit|u*nG!Q1V{;%In8?Q^8@I|&1Df&2Zxw16(a9~|p)o8nXFIZU*m1z@
z0038Er1)!Cy}#4N<dQHFk1pJ0V=R3@<dfgMbp1+|J!(q+N3n;?XEkU+zcWH#i2AYA
zE?RGdUJ-a@wnvS8$q|Xpa?Q@+k=QS#T!-R+FNm%qk|q6~z8_5{0EnoV>>jO>K^~uW
zx+`xD=yuooW;HJjODbB)g^th65p(wknUD!Q4!?zJOJo;Jw`i}xpY6(}e3i&wM)^X0
z0L^1OP8K>UcRd<>JBgOOx_TMD9`T=!Y`h`jjc-=?Tkx~&tz`DveX{9(RmI)W!5bKV
zWxTlYnH%r}HNa|qJ@Iwj-mY#w9{e>kOLliXwY;hV9*Kp1aq3QM*fq^1uKYdl$lhv`
zn`;dQ2o+IFl1mdW0EG<1XOV+RXW?H3+{b?%hLPfCmG2O5npk6sG(AHz5%Xi75sw%Y
zmMadgdT813<$GVD<8k=Lb+oowej8kWArPu=v$|-;2Va$ufzN(xcf)=x(*~#Fu+aFT
z&UrL>Ue<V-94U-$*z19i*uckryjN+j_+P_K;<Kh%T4{c4HZEtoHyMptMoNNsE=OVX
ztcbiVVFkqN5wx5eat+9gWaNJWkTIT_BR<t$*9_OgXX<HBhN{lZtvw2M-Zk=nH2nz1
z9#)LWD~nj;if!^?M_l26>wrn;r&_`BZ;2<=z9c=<*~Jx<bHtF@G{mxwHyH|+%bt1U
zC_E2dp!iPK9Y=rm4TOXl01{_ua=06_gMrtlQCZP=T0}1IX%^;SLkRGr*YNb_oGQ?Z
zx;ml4wI53!f2dr{^J+;AyeR~Kmr=-`Kw=fTZBoDz2*ye3d93%h)g`*#wl_)%&N(NK
zucdngo*y{*p5{`jxOU(lLIDGefA#9bI#Y{D)t*2MOSyT;!Qf}mdRFTl6|v~i;Y7Db
zkXdPWe`pQm72N*-Gvhsa;=0K68-b?VOtM9>?n<st%*1u$u0IO&YkeGleTzOp3M9rz
zJ4fTvw9`(NZ6b36Yz#uN91<{aDrJpw*!A%F6*^iZan{;htZ+q(V1%e7H$2xv4wU2U
zq}@WH;u$#2Z9!>fM9l3lA;AGh2R(9g$F~Nxf~z~Z4WBVWji3wx#{>K;mQ|ZQIAIh_
z%N;#ddBaAah_kw801?}NXz!ZQF#x2ge1#)}+OH~Fe`L)tzJaC}Y6L|aaR;ks7yx~9
z?M{*<8ZDH++InLd5y_1l?~ex<VUGPpWZli<O>9wwIcby-F%Ee2s|>89hK-brWEzig
zTS5|08Ne=faschS)7F@c`^*q{_o-;!Ft?#<Hdc>_9P`hm1bqB|mK@XLXuPMx0h*20
zKqMzTidGszK0MKxFbF(=O)@bgmykytt2>^G0VMm=er>0pr!}Rd>pG5;Ypz{bTUj=z
zJW^Vzxw8zAK*RlPZ@7H<$RlAG?r33B>1eLZ`4&`tuL%vik&Z_-6BaiQwiM`20O%?Y
zI_ZS(EyT|4E?wAv@>umhjR?~hoW|1vBRMPS-|(uitnH}MU(P?hlwpYA(!7(KNF)1f
z+ZC9E-N4*(c=x89@^E=QO(IJSa>T<zx0$}dD!-oOF5}UcZVo`~Y1o#AcR2)oXgw-9
zWgcSw;xUv2gd~COlTq$C>U#I8L1IE1enSogJb++R?^XAIHvnRs3hivT>r_KR=kIju
zO09wSO-Gd>u^{V7y9NGkrl}ZCCDfKYE)o9sdcPcpdU8JL>sX3$B5;27UuRMLP0(Vk
z9CadX!6_jI^NiNLq=a0MWxy$%9+k;KDb5am)>g8}cE)hucD00>*z&P>c+`tcZg#N9
zg#q)Il^LslVX`<i$5~uS_T7a^8*&bLu967>jecR)z04*fnOW|BU!3L6gxgyeGsh>K
z(@FV{Bc(KuNcr3DQfGn4`_<lj_;);art!zjI@0IdQ+sialp&z(I`yQ-vHR4%yoyZn
zIiP4x=aWZc#V3BW4DIUP)W#jU9<<@m^G!Ly<kQ!Grv`u?x!=?tDs(3&k=CIfe0;0-
zYDFB17#HI|cjxXq)`Vo?jyw0Pw8qu>Pg=hj;dnhoLn#`OoP+ZYgP^NQPjGsA)_ONQ
zA*(3gGYsaTqT<WSPs{WbIucJ>q^E(_tSLCpKZQYM^(Svp_*0nWdUpJ31t)0z;OkO@
z@{W6dRI-r^k%9E8GGpe(I-0up+T5C_Am#q=N@z@@AUXVdRc6l|ewB5{2N>#l)l-j~
z=I=~R5T4wgw4R)gyH0FwJkxSB)4fqG3Ob$*IDO+t2+nxM>UTN&-RS_h;dnhL?t0RU
z^Th`^pg?+d=}qnYT`5j+N!zD-VrWD6M?L9(r#J@`r=jUd-1VSB5^y*jDLL9cVbYN2
zJ$uo|sOwD$j^~<BTsJ=Se+cH2zf)95av0~+){b%CttkYm^rXSv)q2nZ9-R+bVeiF1
z^6N}&dvvBIGoNaXOmoLkQgi+4f?VV7w_a&WV(ENHfRWEV>F6@wb+PYJ_Z*tLZy6<j
zNzbi#7`M6i8EVlN?NIHHBexl?$Pj;bs?|GW;SST+(zfm6>GF@g#dtNIr`F;2EkK+m
zLFrm?rvv5fQNn;K@%%M)RODa|)x{=v#BwP4K1!Sp2NZ~>1Le;ZI)k^Tdd;&$AOmsw
zQ?M|+H%gEJ$68P_dGw(%hzA`9YLEkel*l|9a08!|@lL?URjWicI01&|wG`zayE$f}
ztq^?43HNWk#cIR%mx0!@V#f3%A9uBCL64N~JT-mvkH;cgJ$h4k$)_HjsfVHCwLxN%
zGPoV-xjXvOp8Yz~amNF#00i^Xy$82Wl!rMSp0tGHZyl%r$=TF(rOCkQ*QGaq*MruR
z_=i2H5dQ$<{3yud?{ucpaf6)WJ*WZPW4GO;{6#k>Z{9Ryan^wk=LaT`=YfiE=hlFE
z<eCI87(Di*IL~gBhwo9_q3KTIu$_$|>Drh6`lkLp>4;9ofz`S1N_uyubCL9+l^0@l
zKK%u0K_g{3Zk3P^P6t|@9}d5NH|JPRC#8n1W{#p4%xlQ|)p;N8@;cW)Zy?;?G5f!*
zYDWJ6C^g48p4~az*p2=}>?-U}^7X8En}BfNja`k%{t?&Kxu+AhoQ-v1kG)R}a5+6{
zk}%p1YG6snCb_2rrZX)D`9~wIFFERZ`qUuvoYL;du4avtiy)n&ky9yuAKq%Hr{*1c
zRO)#9tM_UwCnC^4DCBjhiyg=3JkX?MaynFUZZ1g229<`G^4}|b=cP0;$mI2?bJry2
z6rl6hy#*FQJ6DrV4UXcV4e~EaLhF<B8dei!lEW*_FiHEvh8;Q@r6acPze<cT-QJ4`
z*jWdZzcK4mqjdR&Wky?n1Fv57aS!`E=9eh0Xo7bxSXAf+2M4WGh%qA}hZUz9s8Ps2
zFGEF(QX(iy^c3je7<{c+UB2IyPNhPhlvA*rnMt9KZ`?!kbBcmUlWD>n{{Sk}AaHo=
zP&)Heh`EaKE+6+|vabBKiLeHCn&@N%d7J@U#-`zIE;G0NTUMxlaMh#8ykT^wQ@4d&
ze7R=&*P6{D`Ho9B-mT4c=gsj}u)&o70HhTJ8s%m=mp)?s+!31EoHRa@4I4!vZe~Mm
z7>#BJBp!b%&j9iB9-P#GpEbA~8f&&g4351zP|r@1u^Su%)32ph8Og~%c;csEN;%v(
zrl3A&Rr}Q^Y7-}a%s5uSsY`>8m!RNM$>j;90hF(n2sr07+$WbFBYfjECb2~6zsVme
zaxy@x5xRyOq;NL^c+X0%jH*+iIp(j%1J7_HwUvNwK3+)mBBh{czHY?PTt)WPg%-j`
zX&p{Z211Nv@^}?kZZ}as+Aj!b^1J$j{{ZW#6%!J$BcRWJ=UNf@K_kqJM<W4hSfd1q
z7Yv{>o^X2lQ&};*C?tj$CZ_)YmX_oo;xYguu4+YDi%*E*;~DHTNWF@rDdCndLUWp|
z>O`%EO}OBZ-n0lnXUjrJWCsJBazC9>oM8yXz#D-%9cdaxl%G4tKU#s^RnTlX&ow)e
z6@Ef9CQU$pLf~XXeshusCYhoTgP2RrYx8myPb2G5%FFhoA!1Nt1S+<0I&<&dp7KZ`
zx`iRONZDg9Oklee<YA8>djrij2!lf|=8ryM+Bb8@wIC25nSm|$`0YT*^7#XDWM}fJ
zB}VeWF@cGgA8Zc4<3SNfzq`ASXqTZFW7F1x8y@z5*XyUe#?4v~qjZtTtfM}p6OT@D
z&lOFiPdhx7#y-CFsc$r~NukR6Zf#+`yNX?w=M#w+ERz)k5O$1p$6WWQFEsm@yj^=|
z1-1JzTWR1x3pd&4Q6ywG2sj4~-;R|@95rjGUzymlwrwT-#%*JYB+@M!Nv4z}QM0Jw
ziw;SD?4WKvsc*i?Z>;DMY5p{~mU*;^ou!(>M2!+L^Lc3GJeld13D0a0Ye!nYvp2o~
z+2B7B$#V{m<Vq6lRwXNh60pZt9dnW~#wwnx4w|0`R^os7OXAdL@kA{Oo3!%2#Tm?!
zY{u=R;c`gH<W;18Tf}@s>qXM0^y<nNkV-6nbTK{ks=d6nrJ;iDKG81knOG-e7y)sd
zXQ?KU?ls%JN5q$s>Ip1ub_yRjEUzqs8vxqjh{59v!0T8p*5gvtE@9R+XGevW8-b9a
zkwGdKCxj#e$j_%W(b%n}zl?l2buNwK31fwl=GHjFnBAFoHsn<wKHyHw4l4<x;2Ugz
z(YF5pgoo|k1CBi^=4&`LaT5Kg6-gP+5+xw9ZQPOq0-aAx*2LF3GW<sPmdS5zYis`i
z2~kOP5pu62_XM9XK)WO*4=M|7JOiAX&zr<r5b*bc?KJD37~VYk#J7)ea?fhJh;?}W
zcHX3a8=Q2<0<y;W?CjaRX`)(K4QkeZVI=m+8zT_IW&tC)EX9s^CmjXCo9Y&^Z(5o=
z4R!<;HnCb=YqseWThXOkVA*Egp^D1H4a_onfNFq<&G9<U8+f%i+D%)_j#ij$SlF|c
z%K*&GNCEv9C!TAbvnel#HL2dq!}Hrs<4I*UlFq(k0(Pj0_Jhy@#5g$nyw`7kYiVO`
z<1H1&mjf`mjpUT-9(vo79acExW(*F|g%8jl&!+sOkGzM&mOm6>wvWV`ic2<(>v1eG
zCiR$%jf4}p;3)Rb9Gb{uqBemg#jlGajzqqaJHp|W?;caM`Eq5*9GrqdW7CSQc@kZC
z@4_O&O=QUaG1?`yVA3jX`OBAoAch={7=eM%8ZC6adAv>HSlSO4T0<4%EYB3_u&S|S
zEET>|>PFlG0qAO@Yi=u;H&ETSq>#RsZT4t&CQEqr9X|pkWxyh5B~^#iw?SI+>9a*~
z;byn+(#Q-VPqeUA1dKA4LH9;;+!h@N2DWssE-wlAq{*q=&uIsX6eM?lL1m8Ha~;fg
z5xC%IJd!}^*0}vw#d>h?Ub8j6yWzs4$M0+8-Ci)37?D9q5imEC+av*;XT3Kj^hLs)
zrt~+X)ugxZ$A};P5?>9njR}miM*@k_#&$#*w(jTqrMRvKRMgVv!ahB^I<2*wt)bi7
zU8KqTsF~arZMn-csLnxu>T%k*tBrEvU3+qPcGge0)=|fkZyE=~GdJF8JDh?$XB}so
zMb<7CRG#O=mXj^tilUZS+SAHXVp0<TWCi4afPL;ytu;p96S4HUZbdq_a#k{YPk$Wi
zq1b4?Ht`kQBTHYj-Mnub`HV<tqv?e1_{eWkDvp<+TPKiZvYJ+ZWl~j6Fg<hptJ7_C
z8yL=>B7z47(H*~bS8JZDk3n6Hj+JW;sbuo$k;;KkvgEGdIopxQ{HT^Il02|J^97L7
zg_~D6n=K;2CDPu^Un`ptzs`kMYaYXv&OLZO)zw<*>jT>6;^0gelIp||-S9_$THm*d
z&9y5rBSi#KTrZh_EKxL#5)yvukD0OU%^{6Lu~TqVOxsL=hAW;jI}$m^QCt-#DfK>|
z4TOXhlt$Xw!Y`4KD7jMTq9ot*D95-Y`j4$mZ4_|b+#j=pAq+lYjtIfY=A<fCOLt7E
z2RUBGoW+cZx@IJh0LLW$6^9|(sU$Uw&7(^JxgJrSNll}F8BvAj?{V9jpv$L5*6^&h
z-ecTgA}BI9IVATAzvtUo!4GNvit&{gZOzGGdf<VIp4D`dd#OFerSyd9`9`!ciCMRF
zCA(v$De{@rq^+if2yJbAvff(oIo*yAw{Oa=3wtntc`M(b{*>s}2{i*8QC-B1cZFG`
z1gP~S05jZw;0koAiFGn9>bO@RHVDY|!RDpF=!9d~SgoM*K{o8gfgo<jKBui!x`H+l
zhn{BJz{%l9p!5}BONfvWCPViARUD3n>M+Q5l+R!1O-9C?i5Vu^5iiQFcplXdi3RgF
z*dqJnW1N37Yo(4Gcb`vK{7In+9w&G6U1M0391Jsm;aQtJ1<4)in#SkF7O<IZV<%Wh
z_vA9DCmV?z5IUY~NRZ^UDcZ|#6!DpCHA$n6;LG+X-)dYDfECXmah^zSfMc4WGArEP
zH<fi7HOsJwwnBnQ$6#<c$Q;*IahqG6Z|z<Y)8@IB5|*>uNgG?L6U%vOSeY1o+>wr;
zXQoeooItio>~#%`D>KHSe8vZoo3Wf6dhuE&b1OF8h=!Y}EuEvamDiTghE@xe!NKj<
zx6-3%-W!`ybEjSm#7f5^GGs6y9Pn}9j<osbyNARc7&?8+EHT}@(@yNdQb`A7dB)y8
zQp^vi1B$tA9<O_U;yZ>!bbzZf+}?syc1Rz8ykJ-X=~kJ7sV!WUk(IcHAQ<`Mjw*X-
z46kyHuW1mf?P2H00A^#1FI=C*4|=TMH0*rXSQ!ZgM-)EskR*@-Fm{||d(|U;TdfIi
zA&MKzRcq}Y;E%o_mv#s}GC0V`VntNkpK6he4T7hP)T|+8i=f0n90AQp_dB$G7TxWC
zbjahg(PT(Xt*8=QNYWSGaK*VG5&;9EsK<I?X06nLbNk=i9#iE6^rsmdx!$ROdM^V9
z=|`BS%|1`fy9z)0)d4%1$t*Al0+owMxJ9p#JDb*0BKZ`8cQ!`@(~O*&rrfgSn;GtD
zpEr}iAL~2QOShekfbm6&Q4#VR8&~pwsECM(b8yM~lg`p|dk#H)_^BD$P#i)?VZ&5S
zA!nGFqD+!NPM@tYa+Y3yGsB(}h}&An_H8-heX4UIEL(Xv>(1PI4!qR@SO)+KSmc^H
z)rHaJu*wbzUj2{qH5*EWj_YRxspVVxWBe(jE?!*_x&7$QF`l@l<P!e?D`OOY^o~}t
zk<cq3muWfVAE#Qb>{Xn3MAZm(N0`}QIHoo*eq)SNq<dpIG1*-z?dc-|bNEy_C0n7R
zVOV%<Mo#YZxkHQ|IOJ3jq_3!3#)?Zba0#o^K|Q^^K5dME@z<k%KjBoFg-Ims)No|j
zKq!7e$)w$keAQQanGV=Wj(`Jy(0ys@es<*5Bc4$&Le69(o|&zSNn<ymU8DfS03+79
z&C*~MoPrHn5>39@l;MK>%Z?3bjtcbdj-EZAZ=d}tFhnP5ZZdr<YRchCC^N=LZ_c>5
zUUs!2LN^&QIIB?1(OtqzjBoE<RBCcG&zsEfDz!GA==3CXIU9#HA<lY#e-&j~N*V}T
zG4gxXmsLZ%x21dZrlgVib|#CbHkj}D6(Q&k9VtHp(wEb%YIA|<)3r4H;Yxn@dT-)r
z8V=u$FZfe(ayjiupK;QV$vX~5QBD}+uS$#`tw=ib9VwtB9eaKiGWA{uN`xL3tR^>(
zxZ6V!I(_x|bH!au@xl9l)l~sIP8StzaoB$qODPsX<ow6(^YyDpcvG6FxWVMrmB!z^
z{c}*tMU^~s9erxVY<$7;{c}}Q?vaC57pnZ->RD-)fgj#IYHW-y3mnx^_mq27szy5Z
zsA#l2o@5vwl|bO<txwKRPPBw^)O4x1$`TGAj`dZ>1z&N?eGOE9a5CI+nxJJi#t#Cb
zIp^g)YQrecPvPdHBdt<ok&eAjT6iba({ae=jxv5`=|#jyt$~bx4LdzPW$RGqt_i0P
zy1begi8$T(QXYe^N<sd4qqyg_B*ZtrN=|e4ss5i@Pg-{Yp1(5v+Ds05Q@_TOzj~xg
zKs)k!QI4HDQh+jlzk97Nc;!V=AaVWUO~A?Ly*rF{%_cbO>p+I~KQDTXvz~*cOM)}W
z<nc&(LBjDs5Mbo-P)XPC{{RhHAmsdpppXm-Q`pjy_mK(=y7cQ?R<W-5{z86HR4vdM
z7mSQn{i+WwIIo_@O4mN?EQW}`Y=h+BaCoiAQz3XAdkUw2ZiD3EK)|htl<ZD9uL7&o
z`pOGJR8h2ir>7Nd2Lt8&>8PV(3=hJrs2qI5rE)fQL{$SF>OclYXi?X#JMbTNp`%1E
zbHzM#<O)R`FTF?yUcD$l#L3SCJk!7>dSa6tjw#?A^)*S5#RHCmr+O+t2Hx~l5ZUtN
zdEXfW_<6;DYQy)`XSYhrh<w8Vvx?G-_<nQJzd@1s;w~P*sOv^3;~&LA?Z~LHpq-CB
zsiuzoX+Oe?0G+=IX~sv)deZkFN^jz56BKqEhvP`c(C3On&<v^hX}`zQwE`C>j%j$o
z=9`i8{ocN`+@JPwKn^FKw7KKAN@h>Z!0SeSpL^DSfFJAAr5WUMI#WsKsHD$7jQ~IU
z-%3v1J!v!3=I=*i)2#v*Cz?)o9+}-nc%zM{<`mF_)00j0;Pj=>KXg!f^`;@5h8%XM
zf-=1KrkrA%&peu$BWiN7p%j?M&04TY`@X+g=Rx_Gj`g7ogi3&VS2W^#IBKUy8=ozC
zHFh?CB}dPWD-J0#6mRd|uOyr=&EB~u6V<0PYBwQA%xcm&%Jt+{LOIIy=~ts+vyf|^
zQ95HH{^NnjsTB0(Pc>0U+B#IK!;Bi{oK2%L+LMEv^r_VG*R@g&!2bYtr$fN`g<|3k
zWuSTLXl!if^r*r6ymzJK<YZK|Tx3MVZ#;K@pf@L#q<_5MFMet<*Qn`Pw_~AdN*n#N
zNJ!c^H5Ptj^B=oX4D1{l6BLlbc^zm?+m8dUdXr(=oC=i?ZW;Y6M2y=V7&u-JTF{LS
z<@twNjx-xr<*P_OV?#uySW-gp1zC)fyXHT3t1m<KsZ`;IT83#7(znfydh=4N9QCSy
zM2+1KN|9UuK7Q1ZO&65#c@)R*&vRA$=>Bi<sG3$JVc2o&REcpC;Ey6sI~w!96kM!+
z6xG~Hxm$MR`-<&uo&L<nKf_)z<Lk9w4WvSTUr<8dLDsa6rucYXNb(Drb9FZ)e(;{W
z)_EY88U89+n~;8A^@pWI4+jkx`3dBI*K1Zs(NRL3tLC37Lzu__931vPg+f$_##@>~
z&A9&X^zTWy?UN%pteQLNs|U@=$3x8k;IQ)ham6&dd6FH=^LDA11~K<~RJ3))kzkU?
zKgHUnQs7DzLEMBNr8gJ^Wb$cOf0>ZXFlr5=FG7QKB$&bL`c=z$E+diIFK*+1%8*QK
zK{@xTz$hf0yqc6a5ilU~YFjNL<V7}~81c>pTvtKm1%zXFe_vY9f<+3$%s?~VwCz?l
zo(#tsP^?KD^y!+51eJ?%gTC3r+9@s+D{@Kp;<Sow)8qwVIGiyAW4<wi)~wmuMJ3Id
z`%S=q?D#?QhV881)Mp3Yx)^kS=*7_8J(-Z|PZTRGs`3&6IN8B0Kqoy0DcI$mWR6zr
z%P~5?+F88RkL8adFfsSI3;-PTIrXf2l>x4R)M0QgzzyZ_MtY3@0DIoM?M4Z$Md^J?
z`6ZIoALfPfE!lx>#PC&*ARoYVt}@~~ZMwQ6!Sh8c#LU?RLCEK^Jm7JE+N8QwE?`R=
zF_?MslA(_yjs|~~XS0pFN|o=N=C96VTSa2`ECj8%ow<<Y9-VQIQB+gx@?5jLOrk@K
zkKyOj=}jZGF%}@mn7ju$=bZkvBr!;3P||{;Qh59^nsP;J9nHV*qGAagw|}KdvqT`c
z^3nhT{MlZEHC7^0WaUbK{ig~7;E+1;_~xLG$=(qxCI!)BZLArXlftI}joA9s<|!Lb
zzY|<erB~#R-AR&7#46!Q01iRPAaT~MK^?=*W~pfrK2ZB0jDGNLI1EbXE)P&gdR957
zS}{)VVxn8>65icLnl<msX*n><AvpOCPf_zKoR63AtsP>25<?Gvhd$RIhOKR4_<e5>
zpHGze*CIAM8Kevu6b2kAJqAxCQ{=j`x0N9__fuT8xl5LbSF3!bOOm6E<%W119(b$>
zfV<S^iM&+aYgt>`#U;d?$Rgmzilc7SC%0VtX0(hix%o#E=hDPgbg92}X{S=N>pD;T
zB|a;*kHR{Mzm7P6=CPN_GAzvFpD<@=$;l1Sat<q`(>x*K4M$SduW$TodoH4MQ6P)W
z1S|o*PRg<o$Ris-#yQ1Vj@!Z(dWMR!>$>Duaq5txNVd~6l{`L4O{5XY8@U+3Ijwsg
zLdM!Jh!@bwq+Cq8b3iZNSxgbc4&_F-Y)GtrT;V_?BpP#nZ=ya%5sUbl!)q3+q-#25
zq`n`D7-0xS=aZQ345#J_0Ks)ZgT`_)GuEr>I;Hr#zna@p)Kol{tsK5!S)Sdts|H5H
zFGd3#;MaSo>iUMI@ax9kYKz17x>`vbk<AONW*dbnW0oz?xa~Y`z&OtbHRBOA{2K3$
zqCPSbdEO>}3k}q^?=rDs3MpJ2xqR>d!RbXft838ZuTC&`j>e7rw&L$YAKI^VYcGWm
zO3kn>s+T)+8oAy<0O7yA&q}hoP36w9b8kMO;#mZGl%XY+0XK3pakQZ*Qym6zfDR67
zzMEsG4<A}xYB~nDYU2GGNgfT++#mr?RAU9Plbrp31$qp!PHiTdO)F2fOC3I7h__p|
z%Ys!-(n7Gu$~qcTt7oDxTAb9ne~0ZfyLm4)DQ&;geB^6uuw{?~wa~;16>;AIeMMXI
ztZqIN>%Z8VPl^1+y_DR@U`Kf1QNxGGA(&xDf8o!1&%bRd=3NGKv($yuz7vmN^4?Xr
zb~|2wFj+v4apQW75AS4VlF78|Uk!McOI=q%lHwcK;gZ(MX{C`RZ2XaVc@C+x?_<C{
z%~DrI@?T=jq`n=t@WhhM@NziBdVa*c)n$@VB*zS)5HxWsWMruaKD8FR;+xwzB3XVL
z`~kX(Uk4c$8!KZ3jtC5;<W?jwUc+_|rE&g$An_bA_#($p)aSElCe&ww#>UJkc642$
zM@A$eT;+?5o|xvm!tCB(Y2Of4biG0;Eqp~3t0SH7ExednV=g{bF|!6cFfqk+MvH3i
zW75H8RVy{7hUTf_ho4xI&Gk#@p_b+;B!f)~W%*YMk0>gH1?t6jA4=g3o~LtgOUVL%
z#C0|)3a&WM1=In~JDTdW?Hf-TeX)m1jL0P*N<$THdIC=yLEz(__30KGZkW1uh*w1N
z<x4Onk)<!@Hc!oi)3Cs+bB#T<KIbgRVNT7hObZ<cAMl8v(lyIulG-Q4qypJE+?;*W
zUWI3-+N6dFwHe|O$s=V~dEM!e&QGp?c&TGnDPkJ>_CS{5P|D?ss3hQLpdOWRM=@al
z`9?UdI+YtfwuTW$p&*Xm%!yLfxEyDbpIp_PNN0bUj$gl}M6AATzwZJar@k^N%){-{
z4>&jO`x@tGrB0QB)s^xkAc;Dm>GU)eVj|$43CTTA)X-#y%8+i(5a0pO`jb_Er`&EA
z6XXN(f&LV%biy_-LG~tz{?VviLZaq1CNvJgPIB9F2>^N;t{N4)nU+h&K`ZPfKy350
z<2V`bf^pDhtDa_?YutRYDEZfE<Y$r15<7^#^lOox1r{|?C1x#R8gr-?dy|GEs2xc4
z=Yv(@lV!}}IVM&xGJ+Im2d`Rxfh1FNx6Dl7h1_aYmMC>QwUW<Hcl#z3zDoSV^&*-@
zI4y+_C)%dWvJzZzo(DOrj%@{nvnHu_^Ru5dOjuL{rW<kH`3!s3Xy~ox!lb`N6*31t
zZWT$`Jt%0dTN8#m2;N3m^`r$h-0qn0oDW)_+FMWTKM`BbEd0#DHK}EPWBb)$89q_a
zuO}o9I@B{5!|H+TEW;a=bTGNtirM)<`Lo*@B+}&)mbS3ah+}pa05UG+!t?kZ)X2z5
z7ZS=;gP&h<PK*N6gN%q7j^@Vzb^JJ|IlAAbG`6W4{ge-pK-`_qJxw%(#J6eTzK&~6
zOj^qm<~dM}%6&#b$sMzQ)3rw{T+MrRB>I)qvP&^{mHB5U_>WG%N_qm)5S9{<OBERe
z;+o6CW>C2Yj^h<pGiebrN+BdgGe)=@!jQT2&$Tt};CZcgS!wbZ)np!IVS;iy5PurB
z*E)&N?kxw1FTTpx!e_Std1gQW4o6+s9=JbRhCQ1uGka>7w>b}gC{p7i<p7+q_8yt4
zGuGObr7YJnmRLbDl6HUr&!89s=}aJbV=_NZ)nt8y!Ehu^M95rudqVkm?~+JAkTlFL
z_{PE0pr>)zuMo2`+=;bW;zZJ?btwx-&nl0SFc+rt!DGOx(K1P?YT<3BL_&5K87+=G
zbj@f+mcMSf%+ck4Y}m1o9ia9fC_J9kTaEAY#;WhfAO5pcnS`lcqL(w%r$RrJP6?FY
z9<;*1up!Pjahe^GQb0Gb5_6vQ6tX~W7^SSJp+*$8<DU6AAIhDMgi4?{m^|2&j&R2r
zrYMZuIBSO(JwVMuCixf{RE^y>jQ)LT#OeP4*tZfkvp1c8_VSBvke(0#ce5TaPXG*_
zGebiooVT2CfQ;~JHDxi#e$fcPA1Ug7l)Kd1f*Ab`RFEGrSjd28gok3lWfxGNAr2dm
zd(;n&{Gxzqp}`<->E5A{pKBe%BRHmslu6Z<OP%r#Ddp`>h{f*h+Go^=P&2tu4s+X*
zc<;qUEYTl-v~6{5(5U_5bH~$)teaR}4c24Jw%zl{0X*Xh4^!+ZnOftOpUVnzc{K67
ziFU;)+aBYAoDW*Az>U8>N4{k@B`+=)b+Ja;ag{wm_Bg7s5<}!?^FdpQRk6WRK_8Vj
zb@{coN7V0~QbV;_$pbxcPH8QF(RR-xpR=y*$&4R=LCO61`c!P~mckC5sibqt3A?qb
zB`)G1Hyq&A_PVuu9TgYDme4$Q0Ue@|m`KC;$Zmx91CLBrT5fsb1a%~4r)4U|e8tG;
zinL=ja_DsjsHsto(SrHSXQ>-{WRq4EhzZjG)uRfLx;A5R`?0$jUVgOsNHKx5ees`q
z&WXW)l>HAiWgUz1axv1a9#v>w=;<`8jE$K4yb9`}apa7+&umwki6oE8k~DHefR)ct
zU6q99O*YB1_n-&g@vl<{THfjT{{RqW+`qhA9R_}0-KlfI<F!Vo<d2impOJ?7dsnP{
zZG<P0#T}0g(v!I4Q%hj=9Vw3D=dUK3dwpqtr2K}HBh>Y!VceHLUX>sx8Of^o<L^{~
zxjgYe7L@#_ueDi^=)Db9kM56~=~mDjB_SfzeL9}Ft4rJE9cl#5;l~-P3I;kJw2CKO
zXYP)*VRO$1psMSi?$qhK1Fc9R!e<0=Q?54kJ!&Mz0QadzHl9sOG(@AP-Zdvar>#bR
zy*ds}N;A27W}%je7dYrTQua9?tu$wMUex-6$Rr=k)khq+PL+AbTCT&B_h`86Q6r}n
z5nfN$t}_1Y^{9%BH%cx`MM9??`qE>A$9k|w2bzq7?be;eVjOh*X@5SH{1QhattL8s
zO;yRTo%$Y>bKLi(^x#r@^FUZ$FgYE6DRI>1nlp}+zP$ec7c>Jx9COI~-RZuaX-`~n
z(vzLTlh&ycz?1UQkHV9VI#Y+-Jv!AQ1pK;CIu1Ma6uplolb$*6OprbK{u*h<I(MfY
zhyB`N=|BuP^{AKv$@h9xq;vSxXZ>jTj};XiqRxymywP&mM)<x%`Bwd^j1S#^04o~X
z{bHQ)yZnmiEyv3l$7=a}WVJs)%c<ETS_S>u@@rK9+`O93fP9J1Zq=z68y383jQUzi
z#gzkZ_*BcDq<5wu8wXyMI)ld*&d!v_DB$H!N^l)`{VBj5r;*Z^A2u`Eq@=_Hp2wP-
z2Lt64fO0-skahc`?$9<g4o3oioCi*O(($-`X+Qz~_isvMHaG*cb45FhF9WBg6z)Ou
zL)l(L=Qi@5eKAtRF}L?@550SJ-jitQDf=q*&2iV-CM1!P)$`jG_H^;_lhpj)wo^K4
z>r;&<<>3b_-k5rim%V7*T3yCv-3xHU9x96l3;|L;P<gJnO-X3aHgx5G2dX1KLs65{
zlhUMMa5$zB@{UhhvnDk4ZfU0&>M2MZ^`;!{Jknwg<F8J%hpFa_@znRGlgClhwIB{L
z->n(oaA~}8#Tof}_MihNJx5wo{5<xi^T*bXa=aP<c<+|{=<na9Fk^RB=}DeP)_^4J
zc^S<pE4hAQQ37$C4jPqzdY_nep$U=`^BzqcaZKYscy*&ZkD8d6;!f=4ahfu5)O4ot
zicI@=rXk(B4z!22G~Dyoy)J#bP&C7^=e<gdcP9g-L;2Hz`G;PW5{=HP6)eqYBspH4
zt4b&7$7<)JatQgm)}$^9j;G}ru1Uc6C{?;P<9-3&I@S1}<x#tTwPHs90CS+{rCyE3
zE1FR|qcdes3-cO!lb*e*iZ|T(%}==G{MF4knyD96zF)snp&38C?OBS)Bjz7UvWMo*
z<5)PA%xS6Nc<oYWl|SuOXq(*ht3A5(6_k;z7(P1Z_-X(fdHH+Pr|z0e@!O|vwSzk1
z$gnr{?N$+gcAaQ{QPYFcr%-k;%ifwPiWGVZkPqGulzr+@rz^*5ofj@RBjv3Vv5beR
zouiJ`I)jtP81$e54N5z4+LLBzP(EIr>3RPEYwpv)8D2TX7(DPgR!y75mEF2=&MGoo
zf%9UgWILOI)}dh8Vdb8^g$UB(WkPcx=}H}V#_ZH$H!eSa*7d7#M0oiPQWI#(y)qkV
zv61pu&mRybZ}>^H=(njN$(WC?O8QRy0J6C2{;b!@em9)I#lI8*Fd{iZegn01Vb$by
z;T7a^EX1DOe=2D$fN&}e-+LYDcj7#4$i;Td_vtGaAc|RUkr5Xx*c|lw`&D-vWxP)^
zB2w|tvhoRkQ;t2VYf0^+i&HXNTr(X##A+C*+<3_&oOj@kYKmmL95xK6gIKew7r8nH
zDtcfZ^<)M8&<*?}CYYhTybSfJ0LIa@4k}sG77d?ZF+v}|&uV$kl>Y!A=}k@u;C0Ro
zWX^~V<V7J7f<hj&#V+h~x2I}HBq_s=r+3n#Q^MkZMjtgnyiuVUAgKs4AE_N{qSICv
ziXaPuz^TV#e!iZSfP@vX1g{;wwbI!;q_(RRx`Ls)M}JM@jzIjgNt0J&xv{p?;kxkT
zzt{uGl^QHV8?=Nm!A9D7JO&*z+Pgg}+Tj{kPZP+qTHX1O$K}Sx5hAgYQ5nmSfE~j)
zJY<T0#kX@czlWfGQ6!V>XpyW8BP+NT+F0xiKnFR`-T-sb_3o){9;vIww))D)0g>$O
zBUY88$iYP_ib}I}V#E)+6pWfnQ^Tm`Cu5n_H4A9<QewB(ra=%f-85z+J;pw5!z{a0
z5>;`#o=+Tb(i^`v8D7yqRg@;v_tay8r;;;&+=I^|x-Dx^o?AKONuFp{_E4#D7JRp2
z7~w|&i3105IM33!>*tY}VpYk0B$dW+N3MEy=M;}e4+|qQcP)2tBaOyx4msVy_dS0h
zP>2)Bas8r;iBuep=g^Mhy)cvzf#w!r000)w(VjW!Q3ja9I+eF1-3C*RMmqj|>e1SN
z?_mUc&C`iuMDtw7BV;RMfu5vp_x&o}q;Ka3`xMNHahCHC5Dp2!2ZN5jl^jZ|6QM2x
z<CFJ6&!??jht2cdjpd@lKA`crD)}W>B@fkk#twf9q-9p8EL$Cauj#r5gL!iujg{Tw
zTPu+?Y2~7^$Ra*NHaQu<9YN_+ct6B{TAr__{6*A`k##-YmX@y)z^f6Ek}%`TUJ3z>
z?KmF%*N%9G;(5Lxc#7^TShid!5ZzBGSl$>^F9=6cF~)eWRq${2MTfwh15%H~;@0jv
zrke8QQGz4#6e`3SoOD(g!Ou0)@aizTTC?$-esfl(YK=+jb@DfE+8Ojuw`zWW1JYz`
zi?m@D<coF>&lv!Dq#jRFTa(tbY-8}!TIyF%r}#2WGS|cJa}C@JDl`(P;y9K~o8OQL
zDV%%PIc2Rp-`jJxxuV?9Iw`fc)HGkSOK@Vz5-KAB8Y_IL$7v+<T=N#by0e_=79^X7
zn^Llx@sipgd1a0<f?JG|3z3e0=Ce?Jc0O)$*8AMKbhj5P4c)evt@%%FB+*;7>BP~U
zzFrwiKH=2xaC%@>$gKQNs@`hTT53KTid#)W7PyA#e21AGcC)bgzF-MfbG(m1+X8qs
z>+O3}NIoWfH@0YWC}KmU-k&ZQko<~cWl|s42P{WnTjI)l3j?WYI^L;&dvSed_ItQQ
zkXtd8*lhCLu-m;?du=)6o=s@vlGAew+3HJa;opc*`0K+L*Pa#8Z*A>$Av#5;!z|-s
zt9eCLRa7Y865!zcz;-r9n|8NeFSzjx{u?viU&nprS?q=@MbF*I*(T`tz*KHWzD*5J
zUGYVyf?m#l6L{xLw_g{3KrK+;%QT`EELCF>la0d|%ixiY+@2xv3)^@n!*6$^_&ZXL
z7$eQ*rK(2-)HBG6+mMD5?8z#~K~uMk9%@`=K83g`?3vY1X`r1q#My&a)L^yJBWZ6h
zF5W4l5^)r<w?i1g-ScDA_N=3+YcY63T}Wo|&E%0=J6=qXMz1V?VD5@m2k$1_ESM}v
z;1Slof1k&4!K3^@hSyhV&HbRYme~+}o+uHwC|7)z!vTUht_tg2@kREJe`h7-qFYI{
zks6)g4o~k1EOU-VaoZH>;H2KVBdZUURI2u|?E3eOQV#{*S=@X<noFTN8)VaBk0__F
z%!3FIU|4bdIp(;3MDc%(X82v>n@Ie7;rn?ek!>PNZ7?m(#4q>U-EhEwPaJ*~#A&)~
zPpDb1_KXYWO~c$1uyNF!6VQ5BairNuvS{UOEC<>3E$aSSlja;`<c^2X@m+2ZrjM!1
z@(8A!j(bhgbqlEMl53gdjx{8P1(q$`lgHi9Rz3c;>hNfPu~})_NEiAf%W<R@iYt9U
zOXTj`%LKqISArN0c*o0K9+hErYokce4-b8+T`=4<Bpu~XJAedk>5wzDb;mWQ6bifl
z0Mk*}%-0ttF^I&E$ru0(<I{m$wJSLvU4_6#4@IGmYj3ygVdHXA0E_ItgSBlcM4(_t
z%tN<B=}1(6Za7SS^x$s&b5;Pi8%xP_>}}-S5P((r3(3eMp*;<A$=vp-(XtUi9T`6F
z=~f2g6kj;Pp&Xvxm05U1+^9~|_)-SLwm~`ctd7Xju{mY(vLpe4<Bp=DEaAavM_)=s
z*kT9wyM%{mVcYB8p__372>DmZ1F0Y9r6Xv@#F>+S$zmZpOvG--A4+iE957%AT;{A^
zUif-wG}vL#wP+GJ$&AQPnkCuu7b)_QyC8AXtz#_gx@=&`o4l|{&T*gcq$)CVPU^;-
z(_P67PR2Yg)EiU}<xof^+a}>IR1EIwKl=4XDQ00l9|{OO_cbt-86{S`B(nl@>r`}d
z*mul-B1euj`CJkic-`0<mUn4w?B;K=ZZfvyM8Qmc82qUrbq_FNo>7gr62rG}JK~X^
z6_g}#TF44yNQi$bEK85QeyC>hVue8Y%$Vugts*ltvHi5h%7X=g8PB~U3uO?<&`ew@
zJ2vAdx3|4Ia_@5qP^v_#K<BTm76&55l4(wVb)U9t`iv!Xxk?yg&gm3<szB%FI2?5E
zO}0?!sXJeUXr4Sjlu7{He8hsI9{!@9h%s>>JFtYSV;i~akAF(Ors*`Deir*VhE<M6
zj35jp1Aq^p_sH)>jAbhsmo~Dc^~yBRvj93AgZX4)l=-bS(@ByYmmKn-3<{cPo;mb?
z^!pr%=4t!T_S@<`z3C)bQrYw72Nwi=;m;rB)3EujM-d`aKWmtfPS#E^N1znqs3moF
zm7ivE!;_rV%Ue6Ui=Pc8p0%WXqT)ir5<>ZFyJ+(nurhk_oC-B-eNM~9I;FMcg{Pkm
zogPiQhKz;)s|E+59VwYQiMwA@A=JlzGY5|!I%JO9x>PcV)?0GWM%?xF9^d_HlQ%3Z
z(QWrD$Ua<WBpl|3c#~d%&XK0d7VS$zC_5N`67YD);1SZQ#oU5zxK<1l4ZV*al_u7B
z$xE(>l6dLfo?14&y(?i1N%p68jIm&<PYby6a5%~9P+ZGsON9YW^(+9$1e!p9I5`V)
zzHBFQ07&iu{(sV#3KWqReOOM{L1I|c1#tWoVh(*U06D7b<%@ylO8)@rk0nXRrvi}z
zHRM1%q4SV)j9_P}Bhsk}tAi+8xugBrD=}6%<0I0cXozMiSMHt<aZP6m9mUHx86>YK
zG)U^uS`}#6`D208*9ZF5A&_!^mjIo=dx62I-0zY`B0ijB)}@`IH;wzNMH{oWKAG>&
zTB~sI1!9pn>%$rfPq{gYRPg16!_B9F_wuU7CsQUA;F6%0QR$J-YJx_9q((K6lANz3
z=AfOdztLU=)g2zm33=5Oi{lOeQr{?Sfs>LuRBCP(2qgwp267aRqZI6a3EUNm+ziC{
z&tpW6n_L88^7_)ov9Z)x>M@O$fU36y=hN36>b7$_F4N0(#{=A&b`xWc0ypomk;XZz
z7m{heZF6a+YY86309`Vd$O9ym<CE!8DAUG^sh8K_7YnMQM*xk9Xz)pW*xE37!8!J-
z>KUVAIp^gW>-46K$E!Pki=D}hv4T!UKPrH^%Z=F?%|^lUa-bdOieqsbay`DaRw6~E
zYjYG>w_w|jPIw}mtcFJUlznQHDRyJIe<h4*GOIA?81xk}&i4g?!0%4SGLw6&6PEe7
zknno_X~m%u;NCw6h6+e0^x~`TQlqz86_+S{tdRNSaa56$MwQfmwoN*;7S{--6a`<i
z0fUab6U|2xv5i-fclD|-BNZS(iZ^qL(6f6c(lLb-BjlX*6-dISh`kiDtdlR;tmIdV
zY1~L<KA?}}YIJ7jAFXF^0&Iz6>)6$(Bu4v2TW|V5$`5l);HeVOX)*V|D(iHHW2df2
z;Na%Cu*|FuS0Vp@01D_dsipIk3jO>y6}1|ivqyuQ;r*={Xm@dw<sX!uJ!(wwdF@&7
zzsg6Lc*lCPyOZ<w?_WtyT*))?iqLSAM420(EsiOrhdiE?&gYR$C+6u^VmOn7^DkOV
z`<icI!RtrNF~@p9NVPikUJpuzf8PEYodLl4zl+kEDHh{@&QtE5D%ySJ<n^j){;_?B
zV^<^fA-dFpF2+W|{`FWG$mG>z#_`5JO0=Di7^%5L!x$e<^)mhO!Kl=5dj2(K1`k&I
zw1$x?ec{RJQ?4>N?My`*f&Tzzr5*TQy($@^95J+W&T2q7Z<yzGG-E$>^rx;f+pR-o
zq2PR@>r!`r9CxMz)|`8B-lViOx{sT^LP5vfJ!)f*PSnx|9V<4=NUBFClh&A2W2b7h
zwC+7R(+Zz%w7G}MQy^pRp0yJx$g8Asc<)iN<Q}~$u0x4WZ_WNRgnN&>Q?Tc+dW?=n
zanh+W8X?CguU_=l9F7f2dY%PF*}?kNrY43Cox0M0@s7Re4^9;Hq~{Cs4h1q;rx@sZ
zQUk|sl!T0b6*E6N@OpDpiDZO~cB4Ibret7pXvo8L>sCndp5whQI2}6E0r`jB=}D8n
zw^|4sPYcU^<4At*;Y~gMl!rJ!d+(mK0M<P9J!&vU<H4n4!*!+tHv#ij7>8(`_z2!+
zwWr^Ii~a6vrMFYLdgCBhJz%7S%AdW8>aCZE{{VN#8LyYcJx|bZ3q)x|1{eL>(uq$z
z8mkih&y@Psj6h?yG2Xn1v)-q%G7c83C>iK!s17=gwJ_U(z^s|FU<X{E&VW8+$)}!&
z=KQI>&t8=!COl)*Qsr=YJ!zRZ@6wE(IO#}#cNCwPb58{GlD%pp)bc4uRr!zIrY2Y)
zjTF@lxO~mlimMs6X*66PkRChLDPRO2-6vkPy|isVFM5fi2R|)q8n$OFs3wjo^G=1~
zZ`>%#p4G-*=-Bg0$NUEzeuBM$;{O0+Jk=SkV>`Y@&(gc-<E0yFd6=BG6*?aP4ngt0
zKiyf}f5$72EwP_U&S8w?VCKEP_f3V;VdQhqYT~c-X8Fp(2OY(GSbThCqdsdDlu8$I
zI1)Zn#YRUbrE6T+-Nm?=U+?3kXELxSDn~WwMrvC##;HnBdZHfv`cqF+&uV!eUbMrE
zk%QKmn9t!qH76N8I(MgWx&E}@S}XzBQQPpNf44!>o0GexAQzr_T1@+PG=%l(NKamS
zcc2C1j(bw%VDsrrKVRbYp#9;=>p&7@VErh`$6w*=Oy>vY?La*ArjUs;aoUicded{$
z?$B|&sHRAujlbhZ<KCP2cBRiN%>X+*9!_&flate}Cu7AXdi0=ib|eJkb5`PVHsV9p
zf2b4JtvOikUQZ3pV>q6c8nv0wMJL_)#a~7nlY?CR5)U_*@5O3H{4YPnT$73H)1A?`
z8}OWtwO}~O#(LILKh2DeO<YzOUzvY8=afy9i|XGf;MJI$=UUEF^AGoG)JNz1Ynn*f
zEYyhOamnjf)SoPUD=`S#gEgfQ$}ju1e}s{|SeQHvj<mQtx^}5Z<xbN_aa`>kQIG-h
zuN7qn3Dc!SgXK}Ou0}Z@FF{Ds<CS`xHBAuXIQ}jvgdM}5;;U$<%1%!Lgv_SI1LZsl
zl~*Ns?MfGsnwb=BJRY<*V{yow1Asa7skSD0r=p+kpSx4+Y%lbvEi#)%y_dB_f6;<h
z<pYY)+4bv9+w|*AGSew4az0h-R#ABSzr*QLZTW`+pNu4&kGn&V&U02}T{85RUL!T}
zUx+3$`1{53habGwr9Z8GhvHd8eiQK%<b1kpr?0hqPk793FPzFwZ;AZtvj?ke^zcf|
zgc0SFpIQ%><VEvyyOI2=08ZZhe`#`e90Al<WRdQ`p8%@!`c&u_X~#^|_BOK1B!47<
zJjD+9;WNfh<HZ*cwZDpdMQGDT&2Om`B~Kjz{zkH9(3)=78V}EbQ)V%3AmpCk{d$Bi
z-@s}C#&cQ7>xQC|cQ-BfX*%QO=sBq5W96wR23niD?hVV%JNnj59dRTqf2U{4F`OKl
z2|;lPOL>kn$?kos2F~XmVh|7T_o-06z&5X;z~-f+XqVzI_L#}HVe7?i+0Q4NDO-!g
zQ8@@=0FuWf0uOH4=DGA?wbkAch&q8<Hd9=Sd$5UXf>4di(2AQAJx=RQ)S4EwEo(f6
zC3v>oN=mS7@O-eRaO`=;e>;vTx|P&xD~o+&#2I}-^S%D*=*k=rO8O0>u6XHO`&>+I
z)e>70Ol6s*h%f|>!1w3Ae+q2IKkU&T+hg34?=R*OI2?oDK9sgN{gS=OZf<UT$dp~I
zNV<D%Sk!<(7(FxBxjg&VHzc$Dq9Wwr&Pm!Z2{okq8f$jkHx*?pe^~R6O!WS>og$Gt
zlMpA%IPb+$M??}t07hhDv(MA8{{R{uIEB1rQbON0;14G~KQ3viSS*;wJ&icJgi$0R
zS9soXP6mCsrd+4Wt}1bJW=k-_5&<91wIiERK@@2ACONHFVG-_j4a2Sp$Oi{Imp`3i
zMLv$&uAsJ_Ad2uNe~#`RG-cYwfWrp#9PmwQM)UbXXO`+DiWtd~DOFfGCu0M~4tjMQ
zb4?twsH#TmRL?Z=r-t<}_(`<u?KeTbxU_=UJi26eM6wduEfNv|LO+L$XMtJTHn+Q1
z(W4$9{>izvx12tos1GJPh};|}nAjZs-<%wEuUu>P@+2*5f27C~=0m)%@10oj^AD7f
z*C2Q6RCU4O`<X4SFT5w=>&S+J@3QXES-joEVOZsppahP&$Q9cROL66r`JWM)@TELN
z-08kX_gxIB?YuA~(5^LKi+UX5Z9PPyT|h}RcpoGIqdPpf&&|#<d)3)IN${c#15QC}
z@YY#lMnihgf5_3O3O4PGwiq$s;{+aguP2@@5Zzyd@W+PW8_&p!*pDZu8OA{4p*XBb
z8%<kl;>s0PNiuc}@!y|b)k>E!;XV>@cb!FJ)Nj0b4abJAEv+N){3bi3FFI+esgL42
ziB1P$^EGlh{{W1`Ti9D#ctUHG{=sN&TU#p7G`*#ce<=30{BgLt@%%Nz;x=+4x15i$
zw56rvcN~5uvM$jMq(c3p8Q?$O{A+r2BAL9neuXuEh`V{>4;RZamGMBfj9U3^6@qzD
zGK_^B68HnAU+G-CBDK8x;<$NRP~Ya6Sezc9hRHeWoYs(qcnL5(<nf+QYPAit&wR0Y
zOS_ZMe_#RcT|VqfrIyF+#UhoRjMH7liDvEoisXeEBLgInT~42;$}R20dQF_JVQHrY
z0|ku_Mg;N4&00EspCY_sD|hpOAeL+l<LlDB2S?Hbx=rKU{{UwTOFcSQxRxeS=1a6}
zMI)EV#y~miT$QW#J)AZIFx?oInmluA+K-SVe{~nC!Jvq&Vj?o#c^i6qSEECu+FI$_
zZLIzuM4n4H+)F*$?Almh6aejGf&&)g`@QO&rL6HuWSihFR7iZEo63(LF(7AwkU2Hf
zT_&LxwLFh)B*m?xk9k3j!AAg&Gx+h-sICdkv)6?yXpGsC)jUxG8=2uqbw4J1i)c)Z
ze-abO01>@c*n(-S6&J({Z>`u#1X`S{6tWhK+(xcKI>!G1Ff1^3o<?fa@Ve>~A=F`K
z`&bx;WtKN52OEJPkT^ZT;;P9D8|7d0g^eU2f<K*RdKBr}!5;Z1i~TA!%91y5IqRC7
zD-$R>g}&5`@^W(BfFt?TCt^VXF}BkQf5BstMtk<A#$aTXOn84Z6bduJKAoysI-;yh
zbLIh-JPt>#KLn&?L>YJCi02g$!re)g+yNj1z&WHbT^Yg;HFu1l!NYwIL;2FNqF}^j
zuq5Dp38N}*ReZCZqv=jz7$~LRI3t0a<KBs&m7uz4^#n!`tM1x9P(Ph370imae=3co
z&9-G-nFWCFo|*4iwoyjbT7yX(>c44VhX)uQm7xsAE1gC=i&$1b#rTL7V0(Zv1#evG
z9ytF1g;VhJ#WMJOP2s8jD9NTmV7-b4o>W5f00C(R0+1hO(0JtWRTw#Jwm30ailHdO
zXC{(<eU4Tb_x}KFq!yZsh+-1Tf598E!5QhCbQPr9R-rD7sNGv>y2Q|1HM-9=v_;l7
zn~1}nib?r-AZLmtxYS04uLx|?4?9;f+x?d8qT2v-9AL2d$3Sz-bCZ)=H`l%<xX`rU
zw)o;-DCqE8TtRGF+)o@V9xt?{UR-lBwo1DpKBVAPMmI9Aj;l%YNvOqje`ZurX=2Mn
zkNy&SsppX|99l~YB(eD`xsG`SM^bV)9St_t=Ea*zXPP6vITVnEMn@ca_Qy4QO}*UO
z{8pD24w1Nfh?+R%Ng^ah!~=p@0(cBK?N^w*{{RfMyJ-9yp{1pszbuP#wsEE0q!JEX
zl^_Ae+#g)}Orv8=9zWZ2e>E;>-%f^jHs5Ku5zM(4Oa}0I0QLNTty%J%+`hyGTI*sk
z$PbRKgUAD)tzLrK2h=p8k8GkucJkg~l?NCK03eT3l0E9u`7f*LsST}(iKk*>$u6NY
z!h&<O;POHB;)IULRz)>ibi1`#p_$_oC&>{g%rl$<au@1B6=vbye@#`{EDA(!w*j~k
zSFqeTCmnHCq)T|d*(=3u3w^pYc$Pv4Z<hmUEw~VJdiABcg7x(6!^=p#$)tu9LIS8i
zHUI~gKX7-!=qPB*oidn?$jI!{#I9LVILZ)Ml1U>O8RG{%j|06!aT*2F*={Y-O}i4A
z%NEWvj=`4%cdPNie|EMycui{FY+42$Y5?n&KPkr?WB^BQ^_zB=p+gNe(88L{wY$p<
z%1_!QS6~9?I0~ee#s^N~h{fDFyvnl1&jq0V*NvHNncZUrL@ky9cMzqBTpWy!anu@s
z8Q%6sd;6l>z;BrR>Y#NMebqk21ZHa`5!^^!(Rpn4C%!vXe?#SLAUpxM2aFOuew9N-
zc}$5c1#f0ij9_P{x4l4eBo4@M_eA6Q{$1&p5>FD|VJ4HNRk4BTkALY^jIN?Eben_5
zNd%Py{{SitQ6s)?TzTLSP8U9uw<z$~n5WY<=%#nKkr9HZD}sJ;_p`{`(;Vbge>U0B
z6*76Aeh6d8e-%kfeY;UFcXrHX>h4MXN%~W<b}WT<icg*~wjfDn=N`2KluKxWy0#ZA
zTfI5RV<r(mRv&!wbJC%33S5sV&cy`aanDTC9g7pkbee9DB-T-^S2m3Bx{yO-uTJ^x
zS>e$cm&%x(pn?TL-e20IK4AnesqNC9UQd{+L60Z`e@F+6_NuU~5_7e@!<_y!!?4>j
zw2%z+FYEQFAIuA#&B^Uij#C8Z4cyZPM~G7Hd@Mxo<(IjkrDDpUOcQTL#xvfYL?R)%
z$ON2i6%#anW>NvjK9uYs`=bQrF}oSb^{4|%3x4|}Cxg@cX?lpp&zXoE(lW4npvc)z
zz3ojQe>O%0?=*p7kdYZA4!EhMyS!_gR?WIHX=xB>VpKao$2b@#2a}ANhb$o^GmXIV
zI^w3gf;i;`HH%Ay@?mn&l2nobC{JQKA9`d-m6@2y%dsS9lTF+=VU%MX>U+nrH}d&0
z*v5qsl@d+GcMR<<fs#A%#ZqR>00KB})mAdNe>h(-6=(X2eog=^$BwzE;*nO<Q%0~x
zcWAag@-|?c@zCzzbJOvlvE1E0_fbsElJ@1hRl9ktQ%2PiO9wL>g)zyzfD{f_9=`RO
zTMdtTc_6BF=}j{!E0dWNgNV;skzkRn)>KJG2+0S%Q9pIQZvCrkN0AHOMJ&f;k?aRO
ze+fJv!kNd2mn3dNn}c#bwS6}TB0ITeC#UkLE@O=@omTM}2|n;Sr=*s@WVcPO7)VKc
z{qIf>OjEJRDP3H&!gC8YTLo(D7Z*R;8e0^E6-7*rI3Bg09gJ;)*x%lTc}44F<xAy#
zshpKyr52A%w0yv%$fqE8>srgqZSxG*e<h>N9?B41a*fEYt|ANs?E~hodk0eSN97sb
z8`)NR59fD5(u@p>Fn11nic!vRr>%Cg!xI9W2VT8t*yp`C1CjEMl!hoAbscI|`@^S7
zKn@QFtvz$Q@upHHPJ`=KQ2f~Ds|<63-73O;<@tw7kS|B~x^@+92&xgDPt8`)fBb`<
z{b~zE<;GX$#aIMoaNSK(Rv79!)rC9`M_QYdk#!FpM@pC;cq6YhU3+~hWykl8Ln#x1
z)8*|>U*Y5UX@lxBij__?)1^x-5Bx<ZIL6`kXyedzqa1apY|#Mi@{hW6OTqN})R{Rv
zEjVLw`FrujX3bET<L>sOXu#vOe>?cPj<q1<H_Fu|m5Pt<j<pLf-oZV6D)C;QDeLJ_
zvW&6XC`^`&^0_VYpTJaQe)ko4ug&~56EENCS|(=VQ7SSxAC)ne<s6E%M_-npJsXkD
zT4rq($m_}IDl$La>r)@PezgO3`Hfm+v@<7;JJU~5^q}W0)AOe1uO_U9e}`mew@Oc6
zn0_?ejK9*1j2fg%7d#J`QJ#O+8g6*%DG3Efv8G8TMghs|OwY`DrfxX<v=hfe)`3_U
z@P1zXsi~7P@P73nKO=v=Qd<n&FCX&Lt#aa@x_Vi1_s*KZK1c~u(>*Jywn4C*cC1Sk
z!b6Pk1$3}4?vtKK74o>3f2%)1!7UMPHQ;c1)x;RbBCEzaWxG|C=r}dzOLN+W#f8QX
z%z9J7>Bnkd2Lr7;oC?jFj@*5FQ-|F=rA9h*?NW?nayrtnLh+IHr{nH$dQhXk9V$VM
z!ix&zVM#p(Gg2yi-6};3v~;KOo}QIS5ac3`1{8iYREyWC=|xeKe`fv^gG;yN?M?px
z8hBy1r+Vg0-J&w9gTU!gGG`f8s~x`zZ-2d1orrNLNeDmk%_};4NZ3dWE6C&PTivQQ
z0OKHi>edyUOeaY*guK$@edEX-c;dLtLqt1n8DRi|PI1<~p`lWzgIUvB##O<La%<6{
zkCb|zUMDVvMXEk^f4i}|ib(;1h~4S={{Z!?EtG?Tq#XAZ@3*>KFC4?{%b%rj8kU3d
zOSaXAQ^2oohG7|QeAX)`lrG|VwmCmqOmIH;TGYF-y@qH107j6gZ%WKL+`yw`9C9ns
zjMTPgi#l?HvqKMldQ%VktJa)x`Jgn@)cohIQJCI6Pu`}Vf4$eWFLTf7NzT*Ltri$(
zf;sEnjPf}hX)*V{_exJrv<l<%*PisfhbxL_uP3c9fAJI&E>Aqte-H4|WM`-GQQPpK
z2W0x1LU|ubY3O+ENs)oU=|B$$<vn`RoNnv<H5PdsbGn_Lysl^g$2cdBv;)EBlbjxV
zQ!+8vy%LSlf2BF{veGxsy?WN158Hn=j0ofFR-$qo@_z8HS;Y15)sBib$OGl8Xv1$_
z)squ~2OWi8M&SI%rE*Cgl4g=OEAtP#R~3d(?mu_6Wg#1v<*TSp1`qL9JxHAt*{qB*
zzcK6UTDI&qpxk<KSW&;r%8JmpepBYG98HrpeR%Cke+LJrN@5(x*P*GDWMc=da?KqS
z<VzBho;%irah!e~>N|AE9Cxj_;T}TpMP*}0Gd*HE*X3@tY$g<b?W*cTx$b%GQf&E&
z+A&Qc9IjGWiDmgmTC$O#+raBnl>l^FPI%<fWY|^OGlBV2kMQzozQ0OPcsz=d(h%bf
z$)@q1f0VsTayrr+;PlRFOF`??r3d{?ynh8JbI9vKC&}ylCXq<<e;hbphF&#eC>YUZ
z$<MYc<7wSCIKmvZ@9?j#ekDH7gPuDgKsRZde>NGfkEcJqla(1`UY-wTdbmOmNs*36
zT6iU7Y-8@!YE&!dImo9b33Jch#w)1yB5v4Uf3#W_y%4iUGudqc`Y8t?z3^(fnOf%R
zM{?3U#hsg}C%LNeM>pAKVHhfk2|k%MGLwV#<Ww|~bmEh_INkH}(xNBta85s+HQa?D
z9`zn@$;SlN5<Lof4?LhJINilUe)rut-NCC{l-rPDPrt{tL|f+NG6ASMBFK&duguup
zf5G;tw~swfohQtB$nW*4^GKT&b}?-6NU|^skiAIhQqj>Dp`ff=XUPb|9#5re+inO$
ze4~1tkF8=rgvl9gK>;iZsA0`&E3l7mnHSv{;-HB$Vm63NBVu#&@sry;lTf%(aVt8_
zu(<;V@)c0X5-3K~lauT-NX+jD20?(}f8#V*%vU)BEP4)o4KsRf3PT>$;gwOHyz$LO
zOA)w5F5LCm$LG?j!%PY&<H}riG~Ky4HsE}q9F8f>z^eSokbgQ+wE1Is1Ri*%OJotl
zZieh8ou|fHZ=1^i9D9L7n0)(4<hF)JP<HqEdV!OW7tnh4t4ZaVR0YW=oQjCVf6F`k
z@n><#2dMhfMlxhq;hG7JoCYNODPJz@95-I8!2|es9QGB9t4AwX-$-wSk)1VAeCn;Z
z0hTH-NI1^}kF9S=%&BfxS&3*{Afn^1<ND&ctz1p^eK3EcZ89(eILEIYxvgNeIi}7E
z>NZIvDQ$Ho@q$y6pHfXZHBCa#f8iI#T{6$YUIv*p-v~uxdiuth9P>g%!cQ{E_;_7F
z<<5A>1DuT;h_111iy%mxIb$dZw>)D#YLmiD@3tOy0^IUFKs~FrF2|RMr5ds2md7jh
zXKg)p-AaX7RsK_eNW$_t#~zhl<_Klie|LFvAr^?OCzeOdI6Rzm{cEsDe<3$1n_w_b
zGFxjmY>#TqXx2Sq?8kFzHp`asquQjN*vbBM-Afp{KGWSsC5@hzd_iL!<?gEuxVZ**
zwuqP7J0kj?fb{0O)UnfJ@I}Kz;QbmXuC-N`Ij>|zyJ&&=QXqwf1~BB1PII=f65XER
z35XWXNv@qf&Q6l8qiBd>f6_`u6fsc5?k?Fsc%Hqh3bh+Gqk`nI2AgK5S<{wVJK`Ga
zb08!Vy~ggNJu_a3WnrtQgYRHl?L8o$QCWPKL}fyQDmLeF8*%d<N%c9U()8Dk(lacY
zG;;};&ihQ8NDYFxVYmgs>UbUTgIA<Wc%(6l+ZJp{5!43uC0S1+f71ky!nx%mwlKbg
zw(w0hsb}_hbjY1FG9BX{THzP>g!K7NexH>|B>JP+X@chJNuq`J`C#E=IRH1y>Nxc$
zy)+<6EeLr4TcfxfgOWci6VJU(dSE*Kh_LD!G!l6`WqIVnZu`NRv$S#BXu<WUHHAAf
zHaW??FCBzsS5TFse^DMrbJQGuJdU)C*DrT;e8|`}@oWMEV3C~Xj(b#)GMiJ&2Xx#D
z;4aqca&Sg|l@3r^+%CY%v#EUKWqS;cM?RG&QblPbh$K%eE<C1f=t0Vk!`%9S4Nqk(
zuRNL3(hc@f4WusZx#J{r&H=}2fw#7$JGd-20y00HESXaSfBDIuH;y?Ss5G#x<(tc;
zYl#jfKsNFKIo<D?(X?oi>itaF9$pn>T#kLY{VIx(*ATLOknC-)<ou;raxskLb>o_y
z5zOe)F)A2js$(nd{U{SR?)1nHgS4BAUm5rs+BUn9t}U<iB?rvFAjOr>Ki&23T=b77
zZuX_C17MNxf5*$q3}iM2ewe8gz}J%~jRKhf3jD9@Q_61EIN~T0BdB?~1Dy8b&>jU%
zh=P=KZsjYe*{v+%5e9U%ggo)#l&(JMJYZ*zpN&+r8pXsqHM_$YwzIcoj@mn^Jc%Ag
zAH7)16x`$j<v__%>01j8xjH&eF^BzNB1L26s^y70e*q^aH~?gm+pTE8ZG4R=$7gCC
ztr1~lFP*G%033YF&i+mUo}6ZrX%kUKR=T~mGrYAL0|DhC{jZTIFSz5WUch?SC#&f8
zkE=^P&G(4IiK36o{?V14+!8s7hE%V9fB}wcw%csl)~6m;MKa5R&5~3eNFxIWj8>x0
z6}FuBe;@FV_)2wQETePpnPqR4nU$G}kbCVpAaT~5PAp{zS5}(2&RJ=?WEz|+1)hxz
z52fbbQ7BOEKsaaI2rAt{-NEV7v~<Lp@*6qt^joVtG}2m2N7QuJdrO5-(Uy-GEZ%8d
z&N35r<|8$w9j=3^N2kYg;JZjIB5BoTn)TG9f2!n^P!PL-H#i)yJ-Du(`&_-$<^7tC
z)y}AvnlFcJH2o&SOP!;F2%!Qd^I{>&Nj}w*MhB7xMtV1?&rM2#j48!itL^FB%ZeLB
zo5QhBVRbQ|#S=yiyF_7`h82PZIocNl9out(oSImYC<pH~o1}KOkVS6nklcjE;JcM&
ze^LUHP6!~Jb*+tB((&{?YU0>O74h+;uvnP#%B5sO<|{wlgbe#`&OxcXxTL?-Usl$%
zkF!O1lIjv!h~#wNxMf)226h31r^}Pc7~)OcQwrkITFyjk7qq>a+TIjnGZjype)eWv
zti&)tc8#DCGI3MEWn%saC;Mtdo-3K8e|w07Mj}zjLOJtUm>(>}Nm1JwuHs9ZHD46n
zLt(F8*hOH_CDpvh_)r%y$L1pmRyJ%FQ`P?PAW>;!8d_@lf$(;@c=Bo2enZC;h_;SU
zD;HpMfJ+4pwOBFW@l|UX{bAVi*3<72Fn_bOsnTZNvLu*z&H*UsPF0ZP6O0jtf6glg
zWre&ecOcU>P~U8A^9cElJb<!if_jkH9Wm=(ldW1yG14=A;dGd3e=f^_kuGBZLz#Dy
z>+>vu`NnuS2Dt4>?#{X3@fD_>r$=?+)shBVj3jRxySszH8?Y5uc23Yh<O)kuqMcr2
z&iCpTekj(~OZeuQJWCvD71g|ee@vUUhDBvkRr83>Id0rmkZI?)*4#j-MZ}qjq#L;>
z9FPtG>Tn4>S8b{IgT)%Rz>kPJb@z>R8SWdzb~@<P@0<-o&9x*Yv5=`|iCK)ufsi3q
zBPTWI*5WAqKV#+j6HE4d%3fA2B#M7{qjv-Y$m5>0<dU_W&Wbf9H2IQEe?EnBH?`8q
zbuL^gfQm8{4o|T?DAlfRr`4=o^dyDb$QPFuQn>Tn4W-^Ql?-qR*f}S)M#gieJ1wlM
zwaH+(3^CLk@<7iWYOIoj2vxZ(zFv0`>Nuv3hXpHNp;63HLb5KcDml5^k^v<CJ!&TM
zzSR%jIG1+fdj1{iA1>K1e|HtO++*OD90GYg@y}XTA2e<Dh{!S(z-~dur3XY&ER6n5
z!$)s$;T(C7u=#P8`=GGno^jKs6wwW|o*vXE{@lJ>$ZpXMxVQbw!Hk#lH)nqCHtZY>
z?(J1%IrE3wrV4t1!~>3*9S^o?j9KB74OT?R!B9pH2XWV*UU{cse=(|6mAAZuj)2sW
zljlUD(8vyOgE>E!KJ^L+mI6tWImR*8m}T2EjFQ}eo{LprY@NsrC_9(r$QY`5>xKR*
zl*#5igpc`U$*TVVFar|;0pr%4g>k}ET|VVr!bu60b{*JM9PT*BC)1ISdTqklhC>FU
zd~$@9nJ~*y<-Cc1e|~x#t~%3HyTz#ELDl4Bw?JfxPRPR(!=9fvYH1L}4Eb%upRGmv
zz$L_kp4BWe+7=5emx`GAytu<K`T|Gus7phekgque;1>gS0pq7bR3gUfxa=WGTHnhp
zxp1qvXWtq8&MGf4e$Oyjq#(CKd;0xqwsPpENe?__xF1S#f8l49OejMxK9uZdEePLk
z@Yrnb>M5xtz}$fyt{E^(C?tIkV@WrduBc;Pxyhw@ApXv_3vF(UAD0>VzO_jiIU;Ly
z)7niyPknb2iy+Xlu2r8rs~*`M4i7b5kIH>K&svSvKo=nO&jy;L<Q=WUbTnAb<e`t4
zi{z48Ko<k4e>G-EH5kD2bnCQ1I9EG*Rb-N6zOtD@2T8Z4;oh~S)-`!VNk7>nL2SwZ
zPzcZe0AHFcVNuHZ7H%Talfzc+9FOKSxFNYcKT5zM{MgT$;}eX9Y-CdAQyC_9Bh4fN
zc%&t>&vmLu!<E|4Q(5MOv|CC408}&2Lru!;Zv0kye}x11xfNv&P;zP5!<Uz1QW;|!
zOn|hRR>>ohN7A3Ujt=fKR3as3gpzUQ41?TOox|IIX<Qg!kVaeOQgTHjo^dxcSH`Ho
z&Y$YPTJ#%6B^Q&7*OS>uQ&hGmr=6ZXE7dfj8qx*;;GQed!BpjTJ`ahow|vHdTrl}h
zPW0dge?IT6U6MS<9wQ%jtyag(M>XrIT=-c*p@X6Md(@yD{nJPX%sA~*1Igl<C{fe!
zr~3WcZyuegd#*h_C@6T&N6bGOnNP9%wE*h8_o)Hoe)5w7+LiqAny{_PjB&+L1a4oP
zb?;Lv4XfDHl#K*qxC|e?`Bk{j2kTjg;|GD(f3C*gIr)V_W|DsoHDO7^aGzSDjnn2h
zt4PCQ@_zM6NU}4>%z9L-_eWlp0^@Mxb*a~&=b@=(lMbEvH0&NY9cik5Mc{Pwr;bSL
zP|XnBbmP4*8ST=PgS)LXfC=kaGgJfbbQI-g!+%O=Ja9VF=dVtcC6fd0y=kWz>)NBw
ze_xlqJ0}B?){yKmhX;exy+FWx-+QH5V!t;Br9^x5=}j_RN{j|iHCcyVy?rX{W1q&W
zxaY4MYgn@>M5y_};d)hO9QW&1o1r=HRoEY!t!SB(L<|N`EIFu-bKa$4*R4X`PbRcX
zhJ?@iL#-h^jt>L1H1!zIPg*m<<bCR-f5>P;epATl>rKzhIW*Jv&(fM$0ry8*qDSWd
z{r<Fthza|;k8s5%@BIdW5@hW^?^XK|{*f8M=M|bWv~nwFO+saa@%O8b7X8!J%N6E!
z79;lwo!u*>fpSxi;pte`Xm&@0Obk~?Zii}SK1$chVqT}{SUA}tXwcw%z3S4Ze?2=>
zkq!^b-}0*pqi<ewUTbHm7Dg1|c^xR)GC4hJeZMK-^rRqdA1d{!G)#mqCy~;e0m-R;
zUO4P22<wb>pr9BEew6I==kTWB^Yy6$<c<iSO@Ie~Q&Otux#>?t%YE9isrN?F)~w1>
zEA1m6DWa|I868dsYA7@2HF3v5f6|bS2hx-go@w9k5y`G=9d{xm<EwR~IOhQLsmiHF
z>6}$^2$1u|F<#-$diSLmEJqX%y1!a>IUOmaOoMM;Pf9$sB>bbNT6hPJ58kOj<ZwDu
zy^LgvZvx={?N1`J=CoE<%pm0S#czSh<aMB`{NE_8AyK26a7`Qq_LBsVe=s(2^*z07
z&-G6a^EpTdf5N@#p;D*i&lQ<*X&V#!mB|&~Lmw!0JlsZK3X4>H!Fi_M#U$UlmjQpf
zSnjebknqS32U_}8_e!;W{{ZOA(DtqqRPgc=?6%9CoDwVBp_xWopFfGo<sD*q5$b+n
z(vMyTO5VTHZ{eC!EuS0sf2=o2QJgeV52&w76(cQ~<5i<LZivn~<Gm*sJkz+?d8VF+
zgVMAx6Vs<kDL;px=|`tdlvoAh)b*s#w`xxPX*+Z@SOw3pqww!d{xS5Yb{|>*O!7JJ
zOWU<KzfLnw{HU-7Prph-jmM=XM)UYl>(i|<4hNCVNT=o<dQ?2&f4QYnbJx9RINa%>
zQq0zZPr5hu7_DfVF|W)z*Ebst$LH-@kT}F#isGpQ+o4wI+e5+ms?r~oes1-j8xND_
z8O2*e?t0fWk=q7n#>Xr36Z3Og5R>K#&bL-2cy5)qZ4OGDS2VOb6E&?tF^(AUGg@gI
zd5Q8GZHx`_4X@N!e?twiET14Bg>uwJ&?B^q1b*ye9CKSroF~XQ6!@VD7$gkssR_Vb
z0n}D4np)#Ru0G=QrZ8M|^rsd%=sHwR#*oxV%Wyh$Bc(=Lj;F05Jh`Zt{N1QDQ6}7b
zWA9LY_g-oM!vJ7)rvuleOGR>%bMo;^&-X<{3Ej>*)AtWbe?ei~dvvBqf6-r%4(f5o
z_o^9B?jDtjiQ~T%Wef0+#4226ri=o8b6+LgZ5Jmj4^h^>rTD6I@VfbOIo4tRWY@~l
zWZXV^JI#7{MeeiK!Xd#_mBBnO<4%ugknleBL^25Eb*X+)B!dc0dsji~rd$#qvz5WY
za7`IGUV1e!e*m$lD*KrO1D-KTq-68c+M;IEbtIEJQv~$wOA4vpS&7GLV9qg)^*WUi
z#&B|96_t*}>^NXZcsM<cFqpQL%Wm(Qw<K31O4Fw{%jG@e#v34f>M}>KPWZ)VN^vZt
zg#@kzPbpEDk~Oem(hxs(Kp=HJs<>#&WK9|Qx?>d-f8Jq4-cx8DbBcg{oJ0!Fz~|Pb
zqp}+sO(F?xcEq_3KMK}SDT+KK8B#Or^sa6eZO1MTJXWM~To?&elL1Cgpsd;y?2Q*I
z=Eawn8-O_H6yiV)fhSJ%ws!Z^%PPYP78+!)ncK@lu}cxTxXA<M8Ob~W%~ghVXaFcq
zTe#$7f2g3%Nj;s*8`wJMX*+)!3*0PBpW7O#jNI??Oow1^Tzb?@(TM>HGoEuu(neWG
zjYl7aFx-^oUNilndZ&17BV(WE`qPz^5y|RtP_wU=K2SIu5;IL-Gv)ovpy#0&G$LCs
zZ#g`VyMc<4(aoMgQlt!!c?PJFAyom`AEiIff5ZV(aBcWG=QT*iOc`VnF!@jJ!8kR8
zsY3*sy`g_Rgk1cj=aJvn6}!E~tb`yxDLi*Ij;PXVnyig&a~X9}my;s^aexmWm2V9W
zT8~2|;ZQOpkQ{IrWE}M8rB#v{lGae4VF!R!PI*7hx+aNnD3C;cZZXKuwM`Te{r6iS
zf9q($6vi8VdIR+Jtz3>rsm|NjNG*!Y3bc@dfxy7$hR0l1X0c@e)q`z;F=|4AfC(Kv
zIrYz4?|h>t*n?hQyQGMyk^!|tbs6lS<0G|Z>rn^Ow5LrX*cc>W$ueYQaKk-F^z^Kp
z*}WK~?s3t@BHBlf?tXQ-q`+j=?ZL6Te|^zANEi))K<Ao_$Di!rA3-S56S~%2>^+=+
z3HIi?9T5oBwPE&4pDX(j)!zYt3_!{B&tu#1q}|S$Ee-o8kL=9n!yYEINOV&RHOm5I
zEuHGDyai?Zxg7R24d2*gFdJP`K{fPOLP#gKDJ8TKIt23Hgm!h#;5r^jIjblwe-=@V
zP0EP)MqDXn`?=2t9OFK;D4aFZi)j4G3a;X~ZJ_4>c3)xEu_B#2btPA~*%C`(HVR?W
zao-wr+<k``#Zr(!b!*}vhDcPEVym@e<EiLL@0yoTYt*;6K^4K9U|5BksV^(xRauGq
zgr0e+{9~f{^FZ-lxuWaycsoqIfByi48p}|QHFvo;5l_HHc!5~mNFjuqc9GQalFrxY
zTdz(NjAbiITQ2DtLhKu?4K~yTgbm70NEyXgNfo1*{hB=dqXhfcB)2zlh1e~NJ*X^O
zoE-J~;<T3f2`!aTt{P7+J>{at7<KMOGt-`W)SY~{*w^{ec|b9YoRDd<f2?h2`>qP$
zHqsY4J%RQ$PtA5ncTP#%0XXFTRdtmOo}8-{x^0cgBRO_soS(x0P!B<bA$$e|?f`L&
zf&D7TBr22U;{;@!gNi`b!p8pqHo(Yl6e&Ga4^Dgc&UmC<-|4{P3fy`&Jt#A5ju_-^
zJ6Mp}1GeLMVQ>|Q9Y9W}e<SIN&}j7YZE=lD2yK%LSi9tN$<9wdObViH<B~;laG{nw
z1GfZcx41p&(1tpIg|x{w1{ug3To8WY9{#;EPR2`{nceBo(~et+VkQRM=EcLvF|lF;
z=g#bI4h{m3L+witwib80FK%8qXCo}6br>!evF+EP<eDKas_@NbfAN7JbXm9yv~Ma(
zlC7RF4s+WXHGOxLg*?kfGia#mx(qPnx6WHXIpY9uMmvfcCQ>7`^Zw0dQhh$#%hjWn
zDIFB=k#n_3Jw{JXoya(=3nRy_>mi1Z7G8H$R9RPahjCDL?IS;zK~QatwIi3lSz@}k
zNg$Rb3+Be7c2g`df5*+v4><sFSBlDPM3KZ=Mp>~WNSi|Bu-c$uLw(Q(7(8^K$+4P*
zvqSLy-bk#hZmr|-Fp>cGn<6hPii994Lpl?+i6a1jc&^6U)y9!~HIIfh2GwJ~2I3f5
zKXbN4kI8uyjIz&=#Q_^L&MTfU>2m1WU8vKn?ro%s2fJICf0!an@AIO7*aLRb8wWfd
zIj({m?+;l+qrRJK;_Wih3++Y}@*r25)68wl3=$AF8NkGh3l&FfVB(#QYLaPaRnaXq
z0@h1)H;Ph0;}a?}$c=4raU&4WgTajFE76yBIT+1$6X_8x$BixL(dCoOvVSJdTLBxf
zjn~SIO0Dy@e>au{GGG!iO;fu5%9q7{IyNbEglQAaHNClM<F<{PK2$Cj7#SENl{>y}
z^}3pdt9#%d7*A!U+>7f}wT|BM?&EFJy0~3{mkJcAJA03>CSHd$<tMJhnzgh|;G4F!
z{?BtPI()#gw2NtSQ)@<mByQeT)0Nw|r_4&4(6zPHe`ff5;92gxcWr+q?v--);^l4O
zHyaqNVl)9a;1yD>l21nBu2|`wAU+cK%dA`Yhexu4&%^M4r0dr*tIIR_q%=YD`H(Xz
zg;K8B&Ic61rFiZy0(>Jk{{RUFqo?Zkv4oQ25h});-AXd<`#6k%`Q4l=9Atw}m7G6W
zh3(9)f1l&MzT<|5&hGEVJ{e1WA6TAv{7b0ZPX)cY$S!T|mExWw667fXkS^WCmj`gg
zay}%|?(~H4R)^xx3F<Z;PKjfC<mzBEBq63>Iu}C0x!A3+wpf3&UX=s~Ncgqlo2?Va
z{xuf>X*N5hXGw0(rmWX6L_;naLV3S72~`BTf1bVz@hUj(em85^8Y64-=y%=;(C4wZ
zyjFRw?IQs$3dYRM5H|}Z^<FX$QO#P=?8DTZO35p7TK;$a3ikTejW>(zBA>%o#u@cF
z?8VrTgR~EogK}VFV>3AKf&m;F$({#~PP}<7;N2a|p)5|>0Sp<`DCv>;j8vBzW|3)g
zf8nc(ZxQ&WNmIn_a}<|l8WR^jLBbFi5H}n!;-7sq&10fY*E)og{O@qq<)UCf`>5F=
zMlu6uj;5ua<uz@LNaDV_gT-*^ei7HNe#7BMzM5NGNhD;qQJH0MySAbptT+Rytoh~&
zZO|DSCx$r;tp_9I`GTk{Pkeg&QrO+ye_Lt(BoS)*lwwFGib&G-Sj^VaDgE1+*?h>i
zVVN7{VmfnKR~DMIUJ~#NT=;t08%y}f(<L{^eAJFZ6uZ<m_|+ff`SG}NGC8d*th@C!
za-3ytEc9LOZ0a_8rI(Fnv($Ves9Rhviwv^GF3`awMRYt9gSC|N&p5?nv2fQ(fA*jT
zK*z7rmg%lP;z<n22bphb@idDj?=^Q8MlF+`4hJWIDxJpTY~>Bl7Ayyrxoz3TK<mbH
z@7kTUH-l<E_T%12^CFn}-P5I6w~t4YP1h%v#@aorK{c3)&QR?=#`3~VjH6<Rzy-IE
zPIv~Lt;wRv;+;*bJV|YF3e5~~f4XUHW+g<8RJetnMqH3d1+q!cd{qxBA*Y#5?wCor
zE3sS|1_0%UP&*G?RVyc|xjfwQy3m#GG}dyErN#v026K={)}q?m^MW!epj0z97mdX5
zDMQQT%&R9;Ng}OfVZle6araIKA6jW60FtAMjxu);WNu%u$)%J;ZthYke{R_W{H-GG
zVm(Ob8T!#-T!L0|$`!c-f-6!fwR=l#U1NPrTi$7@pE@FoE(hKK_8A}^c;}4Pdzkhr
zwTxh_Sp+slDGax5ZDz)6hKe~#rsgac*k?6Ha(5`PZ{8Cs3?76YXx_zeK&!V+W#wr=
zXqT}OrKy$VxZmc;bMvUcf7qmd4?kL<L*XzKsWo>M%M2q};v(e<$4>PFxhh)^xIY=E
zy07+ptX(p=$Q`O8=j`#1vW%+r^`?=NmB~zntc0vxxhfBAilTCJ^Eck&ug!a^+-UwE
zwx3s(t?euXP(rbyDkgG3+6GBHlEjjG)G|#IO>5=pu|^_A0lTv=e{)S4JBacUkbxZI
z7T_J-$nQ+ug1;c?ibr5!Q|B(@A<rEBX{yL=7!vvOc&bQ?*jHvOm@*I}10I5$xI0GR
zIi?{^$2kKAgWn5^b~0?6E*X^d4ng#%ukdr)t0_6^)cl?285~k*hFcih$UIg1W{qLF
zV`z_?W&knhf4%h;f0r9(Cj@^LPNjzdha(g-o@lyTDhAc-Qv${{!wm6Nm0UOsk^|{i
zZIa()uO-B)H;^#7=qe0lq9sNmNXQ2`uUPQIiF`Y3NCb%rpTfM0c-}DJ^Tm3%!|4)6
z*5Js>%@d4|&a{mAH9mhipsG{Y^aB_ADEs*d>situ2RQ0Ye|7Bv`#AmDWT#rixrKv1
zBVGxwQidYu=UA*OiG$ALk=~RMj^B9G<x&{@t<tMx069E8dMZ~(l_<1Nk&)A_J9i&=
z^s2kL?MC62`_#mXVDLKAgA9GrK5D7E<@?`}r3`%m_Z_JWxCqBn*NS?v$Qi0?+>@64
zDrNhF80$%*e~YN#E--r4*w_^qEuFQNq;dZDHEK5L#y+(h7LAD8?q%xQH{JP%Ty?CJ
zVYqYHRpej@BNUlNinq$AKgH6mDf!UjjkQ4-?p^__Xii5=5mRE5FAQuQI#i<^eK^Hd
zL)Vj2gYy3Xz<8*VE-Za8^*oNWe-GY0C^eLkv{@hbe|hgopPQlSN_w7KrAAL9ip`p#
z`5!kU7^Kfm4^K*ukC*1{MtXD7q-5FW?$b_iepAw!o)0IjJ3JrvXt)tJIP21&amRk1
zm1VlG2CKJ5s!}Dys>9}QtygSs=z3MQJofvwS@1E<T9K21S-$bA=Re&&d8-YKAC{sc
zf%UDFe~g?;=dV%M@~F?@_|%P@o;y?rIXrf)6Eo!yp7=c}q>t{e-K9Unl6q8R^V7Xj
zWVAc+6raX^l-|edPW7j9Y&dfyL;ay$Mwp-K`0fW4%)$Y@Oq2J!S97Gt#Aj*y-=%r@
z`PwJBlheGebv99f1-2CO)zLzyYIfqYtq^UGe}j#cyAu4X$7=aJMDEYO!$!z@FUmev
z>E5g;U8m)yfH><;=LhA-6~fuvksD`uz^0IM(DbRm`9~b)g1>ix){<qF@y|ojjB&y5
zQ<XgYrj#kb!ip{zApq~_dUdM`y#{;JfWRCt-tAJT`A;0xA{>V(A1(-~*8?9h{Hh_)
zfAQagN*j~GsxxG#sOiC?oBTg}JW)Y5E(6a#l_Iy^<W*pPUY-4E;PNm>TE@p=XK}_d
zI#UaE1a_upk-_OrJxA7y2@f1?<WhsrL)xJv@x?qIKN?`m3Vu=4)PUrVmAX}3#AB!D
zOS!n@(y^O~Z*bq&wE>QP>FZVV@@H|*e<|wRFW0?08A>Ib`_Y9s%CAa`c+VTY@1;K{
z9Y!%hlS3qh4tQRj>pFX7DBrmqeJflr&r$f&kh?nn01aGb(UXE_4|%3Q>n3fG@#$Pf
zr{UP1IZE1N1oR!N*`$pNbp8=kWw(u&n3t_~(Z)(0PD<D)R9d6vjYC7bibp97e}rK6
zu4Y(nW0iwjKL?&G>I=O(2S*-4eig`S8V$3h$NC`7IKtPnLo#1z@NqdWSe_6ugUIVg
zrxn|3J|3MUa~xBB<Iq<tac6xK$QssOKMM6};vqem;nu;_ru9W5^`@SU&uVu#KOrAl
zL4)gCoT7Sie(fhY9DfgLem=cve><Ki0XW(@G>0CCtuIm1kmDUkN<cLC<j`}sp`(nB
ze}<du)1?Fplb)T08RXJ`58+5V^y@<@I}<A&#PVwFOhH@$oYe$Z+`lhZtxI?$GDq@~
zb6oWjJsdRM(W!1pDeHk-_RzW6mHeu{pK9dA`;peWdkYy0C;Bt?uQsgGe?8hsvYn-=
zC32nXsj{<j(Bc8t(za}L)3PFB?mJgaZ*3ArpSu|z)#g;JdKBriHqyyeP?YBawL&VN
zx}SHhD#6>g@a<6?bJn?~QM0BnNQv?2-D<O*d-SUe4o^;%3v_Rk{o_)ZY9)5vk%k>A
z7SGL+YIa}&`@Jf=5s}F2e@^C#1ZSc8RA(7HQ_eZ&nBRDH=~Z#^h<^F!y&%s$I@0$X
zwJ+i*0dv>pJ!#qLOg%bMe-P)j0<k7~a%u^W?q8Gstkl@Z>)W+MD8vu)j#SV%?s$jA
zJfDUa2R#1(ZbE+!Yvq|YdGc~T@ip~d#Pt6Fi)nqq`E^)N=1qLFe>$H%{{Y`L=wV)r
z^)RGM)35PjrW;B~c*yTnz;E7k>r(u{LCNO2nco&nT(esrEQ~{g&r%IZ8<TZBV$wz0
zgDgi<eJVKr0M?W8<27J)8Bx#jtYxX$Nm!K-@=G4IGN}1D9V##n*;x7Ua6Nj_xj_V%
z`?QiYl!w0WERid4f8(j+6`ayfy7Lo&tqvF-jm}5vD%6qz6x&?kl#WJgDrWuq=0yV?
z>RyJ_mCEP7XPAQ_KQYN3!kXSrTWYrhsqaMK`LO{ce5QCj)n(iqlF!qchIhwe{6y>r
z7{m9ii+w~|S>4Kzt4@IoAf|Bn>yAeqvseN~4(huIDh_==fBNF1GP#o7M)C>}-2POW
zxfQ7@k>!0&hrIC>-O!f%#J7L)6_RM+wQnvc*^YCyahCV|D%2#6+e)5$^{g^uOLE5N
z01?YKN|HO6zqEAN(&eOSB?IK=2h)m{g$gQ~vQ|d%e2^M2Jx*w07%8#Xk9w(aXNviw
zpG>=ngkYaAe_-RW#YVGr07cJn)A~|KO{cMKn0(n`oN<9uq_Y{F<kdAvWGbqyBjkkx
z3co?nRTTup<jWtg2a1+A9%2o{9dlJ<DH;zXi*BusL_Mkq%nzsTcAqY%fN_jeA^!k>
z^KQm^0oJGUg0hik9@6{<6w)(cEB^qY?aN~r`qf2YfARyr1@ZFJre-e3$^dmZJW&^x
z!3aQm*3q?&N}HFF14h3iAD93KQ(7w(sMPG6a8eiMBh%<<mdg{v0NDG19Ak=*l`=RB
zmIQ)8^!2E0%|w{_X6km09aPApr#St2^{Uq}B$`af*K;rsF#zZ4I{H(P%3OoOinzd=
zd4o=%fB8onfjJ|$6)l>@SmT=20&#4Le7yX;X1WbBHG@W&h@>8BZIc{sT;v1mih!#I
zm}L}~>%sjvtJ~x-zzoGd(ZD+Z$>a3*p|fT&Qy0TF@_@33B(MOf=m*lK!8T30`ebZ|
z+*^P#lj}%^(Wky2D+IMrSAI@@zgns!nPj>Qe_|@DfwLc%;aSO-6hAtElG&k-!Q_r;
zCmwWxasviZ3C|&bJc2z%V`}%h+RLk4>Js1IU+P-hUR=*D$umcA+1h0|A-L$g3=S|c
zT983J(%t_6#LE5$j?tu!WB`S6jk(WJo()`^>^Bw(Z+8`>^Q^GkNjx9B22qiWFJQb7
ze|W*AzJ_&S9(3BhjvC_P;_Bx{Pq4-2E}7-2P8r#baD9P1dJ1-t1;C5MzF-LHc4B2c
zLn-H<ZicmPEOe;!i5>;<K$<;eStMD@Hz$ne00r++z_W`M+~B#Kv#=j|iR7AT9kG(-
z(6t}>;g#TiS*wIGNY2s*c&hObBFO-pfAp!<WAmN=0MbGGI*b<taYcxe9zWMx5>9jX
zPkNc$nTS*v^AF+0R4*3u^2>qHkx0!VylfgRr8;_1Vr*EGBI$^lLK-rso`BS`F$}N$
zp*odE7*U+#r?>Uyp#&Yosp=0O(wV(d+T^5hljkV;hI-Q`#>JP}#<5`}{&T0;f0>oZ
z7=*C@09k|1K+e(Xd8tR2E%L^?#nT_OvzD3go>GD3l1p;IdBFAn^I7ou$H`B&T?pjA
zU5Gh!B|?=^=uaSLtw%IBka*Wv^COl^dx$*88v{)Qu|@=CMnK0v{{Y>_d7#b4=UE)K
zZ>`^4PbH<`PZdWbke$irs|;bve-X2I88{;cr(9HavqSxb2#V)W+Z@11s^swOMs{?<
z=NRL!Ju4Vo%-ZIvWPpgK(H3M_uo~jwTR3k(dX6|efm={brz~)rYgl0~aN(jv-o)%A
zjm^sQ*VhEqBMC;u*x9`OA9jVRTbA(pBwH8;Z@#Wrmg;_1Zg5U9j8=qGe+zqfXA|6A
z+uC?W<jS`)w)cup^^Xw19%3$dBaz&i<I?KNUlC~&O83hwdR6RaVEx%(8KXUT`Nj_i
z0OV(-Z0VPF>8IPM@h-H}$>3Ib+IUtm9IAIPP6*|9BIh|hPAM7AIvq!absr7?0K&BK
zpwsoML3X#vZmk?4m7w94e@VkORb(e_0l;iz9+hqx^vioo(|K><nB$Mf4-8g?;}E=!
z9t$uVUwV(7Hm(NWdh=~M9VQ<g_=Z~@d&Am$U0OpFfn#-9Z~<h(a1frOX$JsfrEJM;
zw;Ju#x03jh@uRXneWilzcv~e<yEp;8uzGRrLsvQ7Ej{LX-M@%De{-y9{{Rr9hxU^3
z_MX%D9N1Y|_<q5~wX;LF%W1sA!Inh?F+vyv^JcI#PZsN`q_gVx9v+_m0KuOTuG3Rv
zt*a)bWpOYp;?2q=5kRgANo^Y$K4fUlc=KI7EYapv(KTT9_i#k-G`nNiTmTA_!#+UZ
zgU?)4{vx;VW~cEZe?q*wn^|Zrv`L+9VJNamcjh+rxMUe9<Y5d?m0S$xB;E8d`i(g>
zn$c=@x0=?Wsy~Mk&%}}HO{-~lw{XRz*(*(9<hW#rA1$2Dt^9u~lyIbDisS5b4H8Ly
zCEZEmKNLb@w;FtHEODf=Eb|zkM9vI~$|QFv3Bs`rSXNP6e^~1GKWF%v@p95c(##RP
zo~Gk%w2i)4l#H-f0Xi^XSCVOCmRLMN;yL2+Pl*ek4qDqmEySYYSk+l}g=SH+E4UJv
zI6ZkeM`S3t=@(+ETir*bPi=Q;p_wfU>EZ2{X^oL~g;hI&Wl^=8<r_#KWSYm-7IUM>
zmiKn?teP{lf1ZEL+khF{AnJ@ec0FoK>&f1G*->wYn|tQ4X$u6D^CNnl-9}Dv*0V0&
zMtgQ^r!6c<zF1H;06Lt1`spNk6w}eOpD|nw7HyVnqh>;)<YOFVk0%E`umxgA89K1t
zX&ad?iFqVkF>H4uImb_>c9ZV%A=zOV2?-A{CoC8Nf3)_%{<W68Dc$5Bob3uaQ(B#o
zmC>JW`fMj!jQDomS8Is&W_Al184aDIEO`WS0LOZb<B$7WPX_Eo9G4i#=%DvMPu86z
zK$+w+!VlVrAz1DMu1LpE#;ML(t?lyeMlq9DYmB#jZ6&XWF73lZDku*W;Ycz@;1xWQ
z2he^rf5;<>NH2FZ!IuCaLEpZSRb-Ou>@X*q?Y2BAW0D7_(w5d~1a}w_1H5i#9et_V
z#M#)AQ?;Q*1RhCZc{%O)R3mz*ZM^Q_QcojED-u8<hcy=WS3MYP<2?mZLS&%L_R!%9
zVGkpZ{=GR&t^K4U(zU5%OA{j)W8A2q@?W?f^;M*h%6}Q8ll^8+JJi<qSF!3c7&U`x
zWwmHzb$zPJ-9vWAxu;@e-Lx!8X>fcoWp(z=EyK=3MI4{JRR<Ym^vJ5L)0mnCXxTjM
zr~|*K_orNG`n*@SW_Vf!0SaXO@WX~&br|P04YuahY!x*E3Ax7g>M_)e(2<gQZdPYP
zsDu(jaeqh|);SmDDo=iuAYtU{K%_-h^-e;K-TV4fQMb+2e(!p+FLPzD<hjs%H(@1)
zi*F1vNX61Ix!jCyb~rr%9e4x1W6se1slvRiw}8O#RCJ+INiGVgoRX)A({mhhcpihA
zY|+{cJ4W(#8_6Xx7M)%lqBqYfyq&-dbH`d{c7I8b5W9G0``xO0h$f2LOmYS#wGK1<
zkH57<{#bk~%6>tTM}G9jmUCkSO?Np&b||Fq3F}P?OpU+Zpa${@+4AqkYCa0|=xO2D
z3}cLRsxoYlkKMvZATneVLa-SeeQEKAceagTa?Lubfz*<Cr`=o46zUx#1TPqDhW8X$
z%70R^7{T3wI#OqVaNTMlou`(kDa6o{PZHCy4n)IvWH@jOb5|E4XmIL&Va+mjgv+^P
zLI@ehtpSk55cz=$dCyvt7Vc>VcGNCg%~O}nOO_VodBFVHBerU!O%Zs(kOCn;LsNy5
z88FNgo(UWpgBC~tCOnor8t?ud&awPf5r3CIz0%0*+#J`PlEJ?7S4ZJlT|O=N9IG$Q
ztfIDi=Yl^GN=rs?W8-);>-%_B^!WJy0G2@VD-!zAgUS1$(BRioqm9-!xlj3Gzm;g+
z+AGHRiGJ;8O0$bTI~74r=Z@V#KyDAv)+EueE%J2quSmbMA*DZO9XZJ2xjVad4}UMo
zk5Fsd!{Tm_o5bO4&R~=Ca=j@sa@>PfCWwbPOmcHn+aR8`=tgOtWTNA_C}ETH3Q)&)
z-h5}Vs{6P+8giabAHz=KMZ|7bgZWj3Bc?}MqKEgVj@39LcWRrKk#rxs!Rb?>;ki9(
znh}x7{3^nqm#=z~k$N`ym#tn`9Di0)lh`j$O1B#vCnu9Y>}$ru3x@qF>}|mN+=|GJ
zj&Y2PRruJ5#xwcQGfp-cKQa7jbw45by=y%ihWXC~XCC!BvFGPMjV6Yfb0cRIgpN7y
zRrh?0^rJkVm~^b%OH7rIy+lvm<kL%W)|kvV>T4N9-Vz^?h2ymu<LOanj(^>03v<+d
z6@-nEHhKJM;PAX2m0vx0rv~{)-s@A$U5UvAF9+__4g6iXr{|8{d(#~7eqwl~%syL{
zn>al8s_plQ+J5J)OvmPKohq}Q8-voEW<;PyPs-d5l?lhq$mvoO#XwIj$gYUU=afj?
z{Ew14)pq;6dsNMh-FtVaTYv8!ohxL_njt5qNa;-^V?Ok))M0&Tgyp)9YgEjd4E5_q
zPaJoqal8HnOWUaFOjb0kP&MlH`}OGBWO%o>I85&3Vz^x<GS?80ndh8}^vyap5kbfm
z;pP=}KD#Ev`>C7O=y1FaB=1_$4nFbeRUlkOyaUZ?BK)J}JuBvGN`LJ88d0(ypkUL0
z8-`SU+5(?m^!$BmnVl#b9AGb6XB_mW9O8gF=cNDu5AKS7209*{>7=Mp&w2|2qk+<?
z62$}eho1E>%Z~jj5W^pOmmm|(XptnD#@-Dm{{UDyew7i=T$*~G4?U^aOrMRtPg*KG
z@V_zZMLQBqr-7W*qks5%)NP&JJJZ1VMjN$e(a_z8^OMu992^0R&@<fkr(k0s3RWkW
zVH_NTNJ+u^)P&_uK&FKmqQmA8eZkEkBsbpUJt=ZBdeU|5C<~4R?%?;SbJMS0wE*Mt
zptb<}y=bv57J(TbIH@;$r>6p_ZW!yuN*^irsIi-gY!Q#U-hZ5103F<JHAJxtIpY-I
z<dyl2I}+ks+&2B;)|g1{Y65V74@yn{04d4sO(9s2g&=&rs<g2oL-LB7aO37UB9xzy
zb*fFGTvIVFETUj@0-ih9HG87kNUja6e4*`Lfq{nQdQ=S>9o&u^HPcTKDD^q&VPiG1
z;o66W#%3vQ-+y@E0n_oWF7HRwVwy}_&Oj%(74*cg!gppqtytF<7LUArmM(kZy-FFA
zTeHT*<gu2iA2Pgitc)7oQI0xPUC#|(=cs5Fu9FdFx$S{mUDt=^SD3A|nBH;#?OvTc
zd?mTzR?2EY>8a=W``q`Yo}YO2uC`4c=MDab{{WRzeSa$9Mt;pdUwY_Rh(4zjuyq$h
zo#QRij(Z{et9WVB<YL-Ry~SFOPMeSPRzE>c+sC;J3pdc_#B!29cHL^^HnK5~_eYbT
zt#$U=ROF}nGxYSXj?YDyn6qO2yH_<#WKq>iFO;6g4{Ko|G3MO;?lLQ^)AXrHPxN8P
z9OAp%4Sxs+h`a-*dh6{p>nN0d<}SXK=2pjcXSIgQ8r<Xby&3TqU>|sP>s`f_gb|=6
z26olt5h@@Mr%y_L{{WP7de@s$vy(lVcx41k0<2gHfKy59%|KtT-ZahM?4Fg0x`8<>
zh55VF8HP?6^)&$`u=$N2!g}<iQi$S5A2a5mW`F+xcAVJjo`Rq!hUh7zQbaA(@M<H|
zl6q9c4s%hQVYn4Wh=}7I4@yDE>eTbl{H@lQdXdjsX$7t!1D>>?aC*{r&$R@d!-MyI
zX^WIXK4aIVFpfuBlyx+X)O71iIYb2HbNNz9&Aa4wqrXaV1j7FSN(r&!-xA|f@UK`V
zH-9+Ppge!QUo2fA61T{E;=Z}~hZ%2#UM>Mo7Ruj~3i(#<H!4odbI7i&G_2X_;l2|H
z50L)=z22AjThuTDrDQwD$^k9LeQGni%x{onNzHdQc0rfzRu#O3CRI>SG2PJTr{`6W
zxsk!$jprHksiZsFBGC*i2)|xArHx6Oh=0f%c&JG0gR;0U-o_h)-kjqQNXBADYROoH
zOY;8!7h0<{cS6NvHdlh!-+5wEzb5==ZhdjusjC8aW@|GMDG$JEt#fST#^2iZ>-(Z`
z`Q%fja4(9hkiKtEYNIrAw6c?_OSfpk;<0G&rtDXeK+-7tP{?c&2OLz}?F32&rhiEa
zataWCK9x>Ifni)s!}pjZuTOfeOgkGA%+2Nwae<Ga=BCGFWJv9a+hno;M|0AeU7ptA
z7F+QlolZmipbifma(=Y0G$T%g{{UmDVIu}&I3u-9VAjlMV*m#S9)gvLsaZi>fvs=e
z+6=sy-`%>^*dV-y?g!ZDP=-<uCx7y*xX6Tmr2hb~7}{~(rj;a$=~eCSm5dvP<Rd>?
z&9lp`nq6|~si$dkWgPduWt{UY=merx+(15=^zBt=i~T+?v0to_`Ptax3_sb=bNE$w
z*DG{h>ev;BD!X~9Y^Rzl!auUCinOV@<-*{9yn1KWk~pbiTpQO;!1oNwaDV7nMsf;Z
zjBrLf8hSd20aC$<$sUHO-k9Up^#YJd<xM$~CoQ--w>&p-OBM>`OUV_jk76@YS2g#7
z*5t-HP!0_|FgIH;gfAl%k{VGUQpumMYMC8YJDxcpbfUzv;c{n{OExk_NaLSMw{5Wy
zks1<DAoa(!WN%=pkU4zuSAQd5vRk*AHxhO@JwMNCu7(nhrtC_8u<x9P!rZ0-;GCLp
zkrqi5yrayYc5%S=tf4Gz0tJph#D+XzZtqhlV`&>3pPTJU06dOQdWJO<N6adA3E}yi
zFb&k=r-a<>Oo;;di~)WL^~blT6<Z^E?zWHbU=lihRP!pe<i({Y{eKxoanN?9aj1zp
zH<vm4L;!5yvFLkrsO{hV79k|%q!$mJqvZpDIsX9bRhROOtRPL3<r9PL&{lY97Sd2*
zfs0DycHQatcBWD+$s;Sw7E3-M9AljS0F6=(?KuKyhEL7SL3WN?a?DhSP8S`|YO8D|
zStj!!lzL{7qBeJdrhiC0;8<TU-bc4%{OYu95?OZ4M<*?elTo_P(Zb0q3`v5dWDt7s
zO~_KC<tH4`U_v`cE-n?My%>`rTdog7=}%R}B>9-Bl*Qx|^D)j3AoS}{N=D<(2JQ_e
zQjqii03OIfjPE>(dXQscW*OVu)qJ|_K6eMTM1E%Eah%d9m4Ddz>;^rv-k4rbvrCg1
zAx;6MFuOpd5Vll+0q2gi$s==WpSq8EoB}}W_4-pIom^;~s_<JR4hQn95nQj8a<6H;
zXDY*k)~WeYnH%>@fH^s*5z66m0Oo?OjRkp^Q?X-zGX>Z}gMfhY2qU=v04A=7mp6c2
ziAlS5Sy_(%0Dr{$`_@u1+k$`|z?zmRfQ|;<q>{%N>4V4TNS2K#%!#Z#hDhXpv7eoW
zNMd;--mIff_IY-qg*K|Cl>j_vzg+gtYZdMr%u|U$^FiT9<5uIo#81p>jUtTWp(ImC
z%26&%ZIoLo{i#T^Q}U2-$3NuNoy{$cx|m}*3JD6Kuzxz`xF_k&W~(Qf$|r^QN=rCS
zeXwcZ#x%`I+F2MWDuD<MyRLKSJJDhd0-Alcov%qXoT`t5=TDL%8@L<}NgQ#GPb3Q0
zO+d>&k1JpJax`r&c+%nvcQQW4`2?ioZvc|5gSd6(xcx$T=kS`wH7#Z|k57t7eCa`E
zV}f!(#(zm1@OT{5wvo=VK{d_Rr>IW)L~=_z4T}qHKf8=36JY3|1;Fi1XiJ6Gr&E12
zlRt@>wB?K#8eOFsQsESFCJs+;l;8p}SvFE>ts6i5By+?!$K~w{wObsP2evrif+?wc
z47weJ$62}DZ(iCc;E0J<6pUp_Y#~O#Tz2hL3V-R5C5&inWQnyPM6x4Ev@rS83PTWw
zj=AHCVvKBy*3MQvDbAaw7=F?)Ziz*bG(R@e%VVJ9Cz{NXd0OUK67k09O7Q;x!^zkW
zQU^|Hx7Syq+fPRtaglDN4(OxHWGCb*IUO;Kbnne$vhI#tPjcA|c5u5Cfq)4)CpkXU
z(tkCC4I9aAMAtzqrHgHv?n9R#k<&QaxcA3F#b-?RYofXv#S$_`akPA(XFoSkPo+Ya
z7Y5PS?}>G3-d*zHOR>pe=sRQEBduk*pLNj!A&cF>o_`F{W1<lp(@q7zX|4ov&A9yh
z6&(gWkF{2oQe>Tz$Op>+Yy<<w2|anJ*ng_rB7jd!0(keRi63d3<QVdZ81<@1)e!C>
zTo1LeF`eG#ss?T90dNPeT-4@C)?0nCsr~pRPjTr{O^>y)Q7&>a2<ELK(AIXtW>KDo
zm<SNI84u0K??Gf~7?r^Q3~j|Vw(lf5gZ$~(cNiUWB9cZ<d8Y3<Z~^wAm5hYpdVh7O
z@&gZ;XFchX%OOiZ4pbZ-wOH>DaKA1LWm|CRNE%$J61U&rcA<0T%FJ%c<K`#<$LCa$
zl!rF+XKJGUaH>uhB!S03IpU#B$#EMiuse<qrfI1m`OXL4r+)d2fi15bi)L~WNg+p5
z^d0E2lW8K{Z>5VZR8B9_Sr5x3Kz|g+t1qw6ij7psYZsLb<c^BK?Mwq2{{R*`=hxb^
z!4CmAe1^w0JZ4mZipwDD_elpHnH{LHox2v+Da<#!E~bWSdv`J`%dn764#F@=!TEsg
zp4FTf?3C~4ap_Z+Ig&#>>{uPgIb-;r)~msny^%lz_n(leCA$D~f(Xye)_;)g%XH~h
zZf&HBMJiR0u6U|s<y#wb>S>}mt|vttcc*_AaNR1^l32El;un_eZyIqCCV!8y{{R}K
z8H7X_O*CZZaY;MA`+f(dJee9e!MT`$9sq8_n+b!;z261)@{8paBWUNH!1eazVv)CP
zVi<L*v5VZ5N6YulDS6;$^M9mgPqSNXwjhgfyPV|Ghf-AeKzy|9Ly+~x*Bj4TnQ%6o
zoacd6fccIA=qk(}Sh!+b;6Qr%)U!6tYbUc^I{dY?{$nT#-9R1kDsMhhqO46a6-kLe
zdVqhWQdWn_;TR3)uX<o*Ek8IsVxglMEpA!_9^*anT6#l>{vh}=LVu+Bej~SG$G$(U
zW5yhS6<DxVWAqiFZp^xuhu>}(YOs^|Fr{r7$%=mKN8OqU&Yfa;{{T`kT{{3s`B(1O
zDdENqqiG~(=CnikfnAQ?2Lq*WIUhATZss-RtWJ-J)9&=eae9S=hnEnayXjt($}m1&
z)kb(Cc;y~i^{uH_aep~0VN}l$ytQB@{o7|f#dGt*LpRF(>)5p&I1wojde;woWXmME
ziN66}z8@8H!^L1)=x~e}byuVr&r@4h7W_&3qtde8H&z{bcdt$rRF4{TTo?j)IQ|h+
zA>?)GRfa>6&q|OU2Trv@MbKLvM_Qc;z&SlTRS<bWxODGUP=ES?)0#yWP@X<|m>x&W
zI#o0yjt5GePd?b74J31j`u*y-kHGoQ-r}**j=}SehOMjosq+rh0kn_E`c%sOaBC$T
z@$=yI>sA%c3Bl_?8ez#Dv+qXlYNQ{~wKzY_KK3_KWg^*Ov>n-~_i}jddQ@ANC$C<V
z-2VWzS;-njl7ALEyY;7MAblzf_2hM@Zut)fr)uSzI$-Wh53^Cfk@E_#p1pe0OL92v
zT+((rVy;}?NIy49Mq#o3X8W~NHyzIuo3d**%`7>I!&D4@ZibbQ2j?{zBaVC3MUx~(
z#AWzBdsGa0CnFUp#^K5P)f0989<|d3a?KF2$bL^sh<~3$--?m5mifEX2cvP#bVTNm
z*2dG*r)q~Mj<q9a&~&Kt$m?4pCMIxC)}DhiKnFiK?@^rm-*>HO>9DikFYd|tg({Qf
zi)OSbdr72qx;4Kx=gBzQ3HsNgSx53m^0sz$Jxz1kRleJMa$^1g(z{D&$VKM9R~uWI
zv-AwUhkqndZWQ7^4_eSw0TfhGF9>jRR>F)gPrF_$-P!HOL@)u)b4CUS)|_#Z>}iDb
z>(->S#5^rTSmfgrF*rP)wGlsBX$8e&&tBBI80va=sI&KZ?@sPHt5FkU^T7RSK_#=C
z@l5o>_ot4dfm)<PWPqQTd(-*;@as(&$o~L(mwzMX9XK6n*qe`Ey2mTpiioh{iUw)z
zKPMEu^YYZAq2SYT^K*=1ur#=Xu*EwA)X|Q(^`kf(;}p>?fho7{^HKi*7fvzSq+p~B
zdecXK4@zRVpDr_w)VLc@PQ9r*0Ds!)PXrJ+9Vys+#9U$dZk?(o-GR$vJ?hC^j-+!;
zJ%0x$triYq42`28^`$4}#!pdCAQ0SksPWg4PQ$qI_f%khbeZLO8T!)!9XX`vPa>U#
za%`Oa?)1F=6%agq<4+jCqQsI6U~;`FOC5)=YG525wD0AL08E{{u+AzrU;`cfy=l&P
zA35n&96!z1sqaBa1IP>KibdL3@%&W=(|^2Vp0#Q)xg3wXLMlmER*edDU&^V;X&V;G
zCr{3_8I&(<)J4H3mg`z6v|#C{(8p^SGT-QtepOlY+jcqoELi$h`OiGi56#e4ioB7O
zu+V)DZ0Pof{#>E_sp+IzhfG_b=hC`SoK%a}uj>--W%W3AGVQe6Wsv3weweMeZGY{N
z6A&j#5RNgorAxb~%sN(bsNU?QLMvoTg&S~+DG59KR9pERj=r>o^5>ITny8Q5xg3gN
zKQnUOX@ss%C#?e+9E=vEI}&8zV7E$e&e7AQFm~piI{og{(JW3q2TExt{hp?tN6Vaw
zg}(c8KMG)w)?<VHDk6CwH9X@z>VGm0<H74r<FJSB_NI@z*(aqt9XX^p+Ibx)3k^R(
zQJi6q&C-;EfrcGvp1cYMkkWop&uVEuN^$GcwJ?H9eJC_T!TEZcJCBy5=RHqs)QV1X
zkwBUr21nhe;CW}C;HIeOuWEiqdh<aC3F8<<p9}nOo?j<In~!iZKT%&M&VP*7@SJ1i
z^y^<`Ymuw?Yg$sgHJpq2f-B@nV|6!*z!JAIC**Nk(Uzxn7h{vSL*+MKB^6izBpeP!
zZrnzpGvz4(O=J`s<2XDecg9ye3TR_wpuy>k)X}qSz*2am0OXJMYFwyDlt%e0*0zGV
zqhxH-Gf9SSoc<l^w9h!xwtpQ;_{a9MCzKrREsSm>rg2t@3a|U4${f~9$i?R)%ma5p
zRXAuma#t%#s2n!_F@c(>?;n`ikQF%N*EKYfpY(vys8)|0j%y^X?3d6iT2`ey7vUg6
z%)ojm&o$1`=&2;G-Gq>48IRhd``iL~s?G{Z;P68c?kOc@8m-8aL4WZjxH^Lc`&4YC
zdwj~dKT2^}*5!eMcjRD!!ObIR&06=+f!LJ;&OdvlU$(;7kKGSb?@f&@*{#()J*@fS
z`vIJdnDp8KC5h?C<F;ze$XK6i$0D$7V2m7&qaNQ%i8GTCTbtb^g>UXIt>S?W;#jc_
z_ak0ej(aa&=g=C{zkk)Hmq=I_!eq+?sT(}AVbjY$K1+~tdH@A;pJ<f$m%{?a_fUDG
zzez^_058ZKji7Gla<Dsts9u=Jti4)U*T$NUm*cx@_qdE*Tu!8AC6^`RlV}OO8-ufq
zVDZQeLg$Mt1m`r)r4sr6$8<FPNsvcyn|zlsumk5g0FRd-o_~0!td}m@eYM2brfZvU
zEaM}YV>tk!<0>#leMUOh6pyQ$OXwo;Z;KW=llQRO+&UzIa(-Z^1PZre&24o&!VNBI
zZC)v2mE4yFdMYtID9_9XQZrTT(XCv*QHyEZ>opt5q_gnk1({}!_C=C4wF<GK00vvv
zu^p<q$h+YxF@N={7aEKgn%YQLRr6%GR-GLYVq1<w6bsdHj27oPsiH<Q!UFY_bQE&i
zL(;;<!U;0tz9XEHdFh(71HfRIo0SDqBxn3<ID*$QNA}JV<+pskhqXFMEzz^&Nsag$
z*Plw89Zb^_GfIcbLZNyU?OK~vbj>brx9C`s;O#*!WPe-^teD_?*Eo}ceqTF|-33aD
z@_Fnnpi#4v)9XPFH#Zc9k$`xHU%vvUjFoj$BM>DS$8-Mx)~xNstN?jntUzZyMLDD<
zY^;y+z5(W-EOct>&`Nye!h@Wg0ab~E&$N7*7-NmZ<NRwlyMJeeXC+yAsS;S%Xc8{r
z9zDe?4Syp|C2ui~0^v?U9MmlF{Oz+WTLh8RdR1kSgUrWkWjW0=bZvI7WtCJnMd)Zl
zu_$MGBtBg0`_KSm=}ONZ*qFAjrZfKlYotpK^X8C2JAlSEj^{N2ahA-01{`9fw-J_~
z5J!+c_6BkFrYjah$|6uwL4^Y}*yOfL=pIcY&woL?bY5vd*#{YA$sF^=M<mQ6C}BhL
z^{B%{Voj1tPnF1EI?}ii*~1)Zs1z5Y%+y|I4<<(T01^S|oPIT>n{jO`6ANM>0<i9T
z{uQ1anGhCn!vZnKUOA;~`K$`JS{|THFWJaeS-2yW1Md4&3`qb2I{MUrAc3%wo<?#i
zxqr!$auXS2MTS^Qo0zT4QCddJmh(49^8$N@{{ZWAQ5%NC4T?Tq=e<QFlPoQVUR+fd
zXU1~aG+2mIOXgh?5b|bM3Qstxg8-i+Hq$3LtfS`bU=;GX=B~l!`C(gWK3{4qXzYtj
zuF_><&p0^iP0E0yjDyZ;nUXdnPtUbRa(`o1<Ci(6kQP<59l$I<)r@?(=RLhCRaa*t
zjl+t7xG|^zj(bv<#7mY_jAV|()YGvomtv8YC);kvXmi(+dW=+|^QQujW*FO&%O@ju
zp{ixMKndmZkZBXk6BQ0YB$J<7MsCKfy~GTWt;MR7<*NSd0IEBll^A2?N~rR=H-AKc
z=LosuI6PogJndXyWIy3iNhG3kwn&NE4+kK2BAAh8Q{~@;^Q~ms9B+t%gFSFZ9FB8T
zA-TL0>*hO;E!J-<a-LKL`AGE0IHGASPMrcIPOO)&f*aSaeQJSee8$5@2N}Q|<JPLi
zu`UO54TzEMocRnR2a&i8@$cTMynnNOn(&ywB0@2Y8mB*)9@UklJ7YZ$O!pMf*|CiI
zZ}&T%f5wE1EJt$?5iFJ#%BOG67v{kC_o{Ns0h;_q?}7_#4}rJ(`_)px<%|$l{V8&D
z+dVz$?e=r4+&R+Y1UL%F$AOF=&a0HD=q0qCVyZM-6U_|ea9Ch;%`Ar9Z+|3poU;9(
zkGq46b;VB)*+WGdTFR<h=3+i?sr9Net1h8<zF5zhjwnOs)TeUK=P$~583YQJIOlyP
z#!)Qb{{U`*Goob07{||!{eMbF`2(cTPNkvW9#rzDrw6h1s3I;UoQu1tvjZXW$pnHr
zA8%T;IZEq7d!&Fp`CV=~S%0p#BfLxtu0J5&)s?yTHgnRn3In7&uBO}Jx>RVqvVKB7
z{_Nu!;~1)K{<-*4JDgP{5qb<JLV)h*YCoNxPu;O1Je+z`vkZZbGfNz-jd6%!`Qh46
ze08P{MPTR5KQQEx$f?=qh1GWd0IaoA!2bX$g}kwQ8?IaD$qYIgWq-tvB$;PEoO)1^
zlVgj+w;oUgH(y$MO{l|k^IGcnF|*i76Ya++-9gW<dZbmu+8?t?wWHh_fde03O0w@C
zo3SmR<~$M)2i~g2ZQpSWvdM9#0RocChT6F3c_a><YFpHJWK_sy-PWIJBQBeDXf*pr
zGT(_7Uo&e)!>&(pfq&4DDxK7_?u&in$%f8bsicw5cBO8FYDP{Ug1spNGF_vqHam(#
z{;CG@RBi;|QjOo-9eDz(!+Mq`zKN{kLFbR&63t9sEv@AsU}um;RxlDvd1MX!D#>{Q
z#u>rFfIWa11MsS{GFoUywFHPpd(yW2{uGii+z#M<sQ{6XoPUm<w9+C>QtWN<$ibuy
zzy}>EtBf{r=}J^?;EJOr$qqKJBd<z7h;iPd$=tasPtFR^X4zo~*iTL>#A-GISn_xk
zO&bONT>RB-NhmPA2R_vjC9-y7gdaB?4AYbXl6B+Spy!U2GVqh-#&@kj46|y^Cz}Dk
z<K44Y2|i`9EPny}N@LjMRU3V)HR&?rF<?~SlW}OFvzyrQ`O(ne#I4V}JSf2UXT#Vd
zoiY>u0FH|9dv)zzci~L`0KzNbzPbL(i;uuppac7%^B=ojLuZd91dYd&QMNF=QWhJR
znhD4qdr@*+NF<F}a6<n8O2EC-k^IBu4u_zwmmK%&NPj>$%8XW#sN=DW=&5dbHle3F
zyr1af9Gc}WZ5c~^roGzg)+a{9Yn_<nR~@KnjhRo9$Bx3i8W_uNc{rTCJ(1)x!b7px
zcr{hB5Ak*MuGa3!mE`#wuccv2Zo%J<E7+xpO&$eoD~mFe^vE0vvW#|&0sjE&sM<CK
zzjWVvlz##-_qtb7cR1dKm1DGUI@HSiE^*SSf_dhi3vC?t^`HyE*8p#;3jIb6W`@Q%
zJt}o`jBf5|uo`J6&N<FSSXbnH=kA)y4bN8gsnN&DmVOq28jAk_caiwi!M<bjAG_Gr
zaysE^!m-NoI{MHwT@AtKwJvyHyVk1$f4&IKDStmUcJ`=dkwoRWIRmXG<Fx$8tw2fR
z=M>%FF&uQRT8C9MPFP_4#)03S)n7c0M@o2Z56#}V=5|36<+<cylRrB3?@5u7_i3l8
z`qn0*k}`3cVLXnVds6oQ0D#nIJoM>WK+ZsMj`b1y<LOWAc|Cn9GxvuFpstu4vm$Te
z`hOaL_3FGIO0e15cs*(ZoVU$gQAaF@PeZ__V}bRl8>ecIKRD!mRjM-+8F;|k_wmhl
z8Xd353Ag?*K^4wvcFiWC8QJ_@E7f$%V7B)E0J;MS>0WL=x=P6RvWz2dnWJLH5F&%+
zd~w09h7|!$MN+pxu>n!Q>}yUnJ9~Anmw&B0pKU@GMU=+G>(Zpp%G}gh!94b+?&Q}a
zM_MG$BZJnMPhL+-Y3RHUz1En=f--YLL%4^&O*63RN^(fxbfo}ioYkaF#$%z#{3!el
zIP~e>mmF4!3CI@#M<$oB<%cxh$AeA;@$&bou{^_vLC<<ZdhoxE2ZifVF*~|;tA9}@
z;*xS`rj`R7lSMleu5>{B-3~EM{t@!`rVM29-joy19jlERi`%Ux0b}!j1t{7`;Pjy9
zX~O>i6;dII)BDui`}U_P7;LY8w3~T;4_c%b8~`YOQPQJe!MMgTPaOp*BL{)g(wPmB
zZXuJNt3l{`ed-xTG8uD<g^mK^i+=)QmhDU={P-g|po6<0pQSW)e!Xd;t^@VmO?>X}
z&{CeGgVL9<;+XC#{mPj>rlTDXD^46R9MCJ1j-Psijfal(&`#6Vl(^0@+JTWcUo3rU
z5?2S4QXc&(CfW+}I#MYRH~P*$yGW<5Pw`Yzx`5v>&T6X2=1>V8XhoOU<$nR)NTdci
zBkxiuVxxvNGDdUKnGA5rQ`fC3r#Z;$-lhry_NNY`idQ6V2vPK?*z!0%YIBXfPfCTc
zxACRS3M65i5^{Re#D@pvZj{0}JW>Vux*n8s70OG$=Uz`rcH@Khy3|<Y@H$hu$69wK
zq5FnUC#5(r<DT^q952?9dw=|=r7McXpvTsp8-?SwRmsOgN*j^E>DrEBc}rP4SEU5y
zBnKJC6$W|gY2fkr(3q?oe|DO2=}td)pzBO0k9^a(A*b%QUX>m>Y~!U!$AsYh>R}@%
zr`@M<k>KubPALkWepacM6r_#a7on$dT!4<9dQ%VZjCb^@PBWaXFn|95S}rmy4b;4R
zw7YuqNJl4y=|#YDp1)ow&(F{6O~KE8w7BQD-lE`S>O=hk>}>}zoY%^_#AYuZ__98@
z)}_GP$0s7bv%E~&Ki$DhSIs^wgJ;HX5`hch?V^*fb|1@%)|=Gnp}FVRNIavK#~9|Z
z8<)mZfY{=?OVrGhWPdjR=DGI+&3r2T?!$`jqV9TdWMF*fjw;*{p}jy<^cehUk)dO^
zDm_hWLl!O6`CU2_UabmOFs)X`75chdM3{_&D{>F=`qnJ_aKJ>shv$wfq11=(t#jsl
zw^<pke(Vt)(G$jU2`3rA`qQfm7ec0nCEoEQ#I$4q*w>@{FMqVt?l1gNA@L549l^Lr
zzkhPEl(r)-${3Brk&dFgzUhc;334{$BfWF?2#nGxa#WsFlm0cz(?@N3KUk;9&11Rv
zkEvK)d`){BZED8gSZjAt$t|-MiE+1L2IMmicNHab->~H%mg+S_9<6g5?D<^}HIWoi
zqbOM83LAh10Dr4x&y|6moDu0*@>v~NdMcGQ3*N@_-`*=~EV_-;u(gcL#sIrW<hJ3F
z!Q-BJ&1T$OJ861-zRRO4>x(N)&ZH1Q8+iqQU~`bek)CQLc{be`;<Y>A3g}c7Z>T-$
zw3t~2>vq~CU$}5GIT*)JVN=S1QjN;92~$#@5oM~P=YI{pGB*L=rz14@;*G8#RlBi`
zw)ByY%s&7?1MsaU-+4Z(b#d`D%PMGaBx!WVdnm$)qE%cSqaSwwbz{k@(jZG{Q~N7Z
zFZM<*WQeFEJQdG4_QzVZ%jaJ*7={^}<!(<#!s4YO;HWW)0|vk;)NUB#@TqM-vyIKF
z+<$E(AAe|HI!FL67q~?|T9~q_zrOPAF9ZVd!X(TLn|mDb$nT074tm&p5wvdrF$Kbt
z^fj+(EaqU_&=t-IJ$;Q(K&C~)5INx0pOgp!v})b+QpTBRZW2h#xR!EH)Y3?9Bx^)0
zm=BV1&{S<J{K0<DxB;A=Gm1!_T)UPTAor=USAQ(TVixi!XWhS?jw;UJ@WP33R0#oY
zI@VIie$x5dg6E}M4-g1Yk-^U4)X>#|GWxtrty+<8lB!%I6nyP$5O8pFgV5mA##enq
zP{dG1tvfQu5Ft}1?x;C99S0_;tFPH+ZOX6Po=>envN)Kqo;>4`{xvqZ*5=onnIHv*
zQGbCW6y}mME4P&@{M`BvN~06P&nvJz5w%^qpYWi%<xB1$p55v!S%1w^NZv+AbJnD0
zlWHhYjB}4_g4pSDHnACPU(S6T{gK&K5oheOZphks$p`7ysX-<5ekF`c6StP-JifuP
zj(xlJqQX+StX!C_$JyiMfEYioG^fm2xPO*G$>%jiWw|#Srm%uCBEpnR1_L~g{<jq-
z_hv@(hBojqOiZ|pcedvzG>*zAPN1HERS6|!3IxX_a52_^(w1Gt@)NnD!Zd*<U%bC^
zrQF01ka1L!MA}Oi&MC_)G{7C8U;#)AftUvQbDp@SoP{iURBIxYx&lam3PycuGk+s_
zEH|&-#%LXd1qht7rxBA>NgiPNi5clrHtv}mif5H85P_i?8?sI~piWjpixTl2qweuj
z+f4`dgGSA^O`I|Ny!0PaNfoWZxUr1f0hz`a^ceN_smew6frhnhvg9&=LH89_Jj&Rs
zyCzH`fLcgC(|Gc3IeAYc{umhiDu1XFDJocf^Nd!2Qr7InAEz}I!;<D9wO}mF$EV>%
zi=&CYjHpWQ10ZrK@d%CEE0xJ|p>xX|XY}h(KpIVc7{$4B_Jh}<^{Jt{^So=VM3y$*
zL>ftDoqDvca7WMpMLQchsk<W6`DzKs>+4l_J4rrCBuD@_?Ndk*VJu|e0DlcpmC#It
zI}k=jD6w&7iIsn|qZ`;Ux>J$VW8c!FcFe^$#x}7BZZLiLtp5PC7US%wFr1w8P;bfF
z%F4z=j2@z;7NRVN6F=R+kmH(&%$pnqey1lC$KAGEukjwHsJm^E&gLH{Pg=BUk#Xm5
zF@V|!mOB2mS?&-<>GpBB@PD{H>Y0Dt@`ohxROWN#Mpc_V^V+EzMmH=WlkEG8jFNcA
zLrq(^7gC{Dz>@@utkOy4$C;Nqhq<WS$kRJ1#!n!0CaEHtHI_$dts{=+AkQ+5@)8wC
zsm4wRTInpM(!b$l*!{0u(m%3o7$I_>BeuboZVP<vTxenzA`d$SY=2waX$huY!2TS%
zadi<_kdeAR`BC*8=8jXAwc4?(;%T&ttw>#1%cPhs?xKV&XXYY6PVt-)GBM~YmOJ;M
zC<8JA0Uf&<9wtk_l43x>483qWQ6bC6x!91n80}3Ur5;G7dyJF?P>jkMV&RDDKMz`_
zNF|0(`oGN7?Sk?W?|;)6Z(q-)MBoNZpd9SS9Zos@Y1q|Btl8S#Y9hz|lZC0JBhGw*
zkeuxt15{o}KFZr&_j&mGRU|~2KJp`Dx;$eXib(`1W2DM2Z6xzm$wX|F!N3jfdi^Ry
zw7z{B=1_FxQEnYX(<+$(IQaoNY<I^>tZmtCE)0to37#Ai`hRAb4U#9@E^cgL7wi>n
z@SbboRYz=^WU&30Uy3`AGDU4TGPDu}8Fk8>k<+0db@i%_pvSblpb^;M){Jw(Eta1g
zw=XLs07>QoTWH`8dG@NYgy$=(Y*WLOapp3%c&hA;v4LhgUz47-a!HHLyh9rQ00;vd
zV~VetH%vD#%zuO)J!zyTB30%af0qCbl;Yno04VwjXxy-;J*iY7W4k9K)}4uLLh|JP
z_>c`Ww-1(XwJeRe7A~8B#sdCT02$x7xcPX%>S@@?vF8RcgW8-JYyci{QiOqY`5(;$
zumM0LkF8W2cODO3^+_4I4t#DL(k}824K=a9y-2w7!GF&<re@h7RQot%cLq$vYyj>U
z?s&&PQ$hQ~p4AueV+XA~1G#bQ-jgA+WCSvu!#JxdTgxLSmgcJ<K5KAl&<Bo4sAQ8U
zI8nHC%~(ZEvYxzDDeK2-nQ^s-d)7=Cp$6c0o|SgiH*IG|L5!VFAP=X^Dg*$xPvY-e
znk*&$Ab)s4Jg4VhhoSeWZpoZ@pM{@mcxnQg4vsnbZB$os6Zc^3Cz`>~RR*7@kCXja
z&!u%mQ;aD4y(`OSg((@#qbC@q>^yVDUS%0QDk8j|ILV|>F<%GPft;QPTAZrw$i*;@
zdKwDm8MIUq!i=9X1J6@dzl))xA1_|i#PvCA{eLz#R>TR(^sX-ZPGypB^kN4!>tr3t
zmCaGQwT0mS09S*axUPy=hZb>H!p3Ou+ly>3`jhF>vZc3R7v(uM>l%ifN1KaW@zf6W
z$X(g6c|Uj2x?;VW7`yd63{D2u(Bg`)W*8%yPII0=I@+Gxfi7Y_c{r@cjfU@(*QZXR
zk$>b=q~gedY;_ePu>SySrA7Q*8keRx9cxROBG@A*=sVQPPEIq|6-gU~;QixPP@UaH
z45VCB&r`)%R{2owJt~s_01wSmDHt60scfW+!G=1&L7INyv~oE$Q9aKasr!!^$6C%(
zHHs!J^8?39ZgS**DsR*;T0MGot~tA%aDPL=Is47lo-vX#demI*9CoL#-x<f<?Of72
zVoW`Ev8NoI^rj8DA1VCl{=D|A>{!#&@T4P-r=>4ac%c2$T0t4ij~zMwDrxFz=kA(k
zr&{WQIVQ;1e5Z{3)dLS>(yTH0k3Fgrj(F`|F*)Q{KSS1*BrkOs3f)F&_$7b{d4Dy~
z={7E8LeZ}$IHgvqgl=ty!@9FcY;9<^fl?pcE_2qs0@5r+7}{}JmKNbvJwl9(S49#4
zi^ppDd{usCebxsJ$rP+whyk#l?$yOVA>yj0LVe!VCU`jA+Pt|tp2TBfa!0A_P2(L$
zT8v{W!&A8O{_yKiSnQmA`f2;8uYX#Mk+}TSxjPS9r4m~nJ92&Le~W>hl)=z*+MF?v
zaz6E1h^{-+Aa$hUo+u;`KD2S3-D^~cY+n6;N;`C<=O>=@p1<!^SVEKXjzvUC9RR1F
zx_)Yjx_$25sg#KM+}~O$dFF~m-08sta1L=#Tpr^&s=>z}F%<pWk{kG|mVeeQqI37x
z08k0sG6f>AE1a%zPRQf#^zBT|fdKTyFpv%oDMJ8yQyh$(=dCm$#~1@6twu=x>r{Ee
z0iM)^jOPv1)gf4MZ=0`wT4DRd?gpdhap%1+83T^=$6?%a!%>cTT42t4)T-Qaw9tlQ
z_nzBm0O#(Wl{gAlJW>n?AAc`;X$s>&8$12#b_X1<N>(Fx-90KMAR-drWx7*fho7T#
zrk#O09<>pZCxtya)Ms%ZZfb)-cjV!ZN`&qt{qB`E!MC4UcF-d{Qn6Pv-7-%H-xV}4
z4ZQmLRQrE<(B`f}hXdq2X<oqOM2J347lo<9s67o#6b_!08iyewEPo92G@E%pDEz8i
zA9_zurA^8rEAn)xh&cQz!6)CPMsbnywJVfBdiJBS;B~1=^x)G9oE}XpfShsnx>4)E
zplAD(?xb)#QE^yk2Pc|v12pizDd)F(c0G?uIf!Ire52(wfPB3wL-$7lfPR$ugdhV4
z>p&Rn-+G<=Lxt;37=Jr>A9|@WSl)I6wA4o!JdU+s?brv_p=CK8_@{9ZbM4ZYbMoUg
zD-V~C=TVKhe6Z<Mh9>WqpGskWmw<ZHjtf7`DS<|M9+d7Oxjb?@{&e--f%12y+BwK>
zl<*j1oQzYrn*uuU2Oa6S;QYO+OcKW#{Ar|ca(h!E;&IQ*+JBmH=z3D;rvi|Xx9<*~
zv=mdi{{WA6<M=DVJZ`q5;)ad;!{)b!T<k0Nkzem;z6r&9^ozPFK3ekM9BGigpKX2+
z`L@uy=hinM5%lgo>Z0{Gqb*V3nvn)uf>lQZ4m(#gzyha^U$u1ls;HJ+I~=+CisqyP
zdkx(&UXCAg)_+ez<)BYAu~Wigw&GHB?py%4#}$KWz)c9;eY0EYNz<Q^_mmH<eKryo
ziRI#_W@2jzAY{mhkq$^5E0?{$wzBZfwQv_qXJZ@@iGU!x@_6rnIj+xCE9FWYs9_M`
zj-c0_>bB6_SeV_g66CsUQPks;?@^1O+Oji?l}On;Gk==7xQ<B!MQX^V5J)`(9-w=A
zR$PR6XMjn1(w!oW3JBPZryjMNDF>e_CB#5sdyqewuRc)aN6}&1QCI9UDdm7z52>V5
zK~uLQJm;aUT?bFKyS>$Ax_gAShTAN81)Pu-2f6F)DK)DWw7at~6qe3?#xuJu6EE;L
zf1&SO(tnb@jTSDOpC$D(QK1&jTIF|rpr0*r2_I2b43NH#@&5p5U4}C&qLMZf)8@~y
zI5kzG%rUm`K1`g`*(2X(#_0esHV6kfUNC(#O2+)@noA9!@K&{p*&}#v?bs`@K5LdE
z<pYwTPEV$Om3bgZt@KG@@jUBxF4i@QXqltg-G7S=_uwuLdsbDnx?p?A?k%P&)()|}
za&6fs7-BF(4#XUAcp{Q<GEaVxYqrj@Uj|9-!+_WTg1fen$>)xum5zDcmhX|{@gIsH
zUlDjJ;Kh9!iS&{FjUd<w3zc3*cD58@fvQNO$x?jQK4uAQXY}-|8guAVYS#Y%+B&YW
zW`D1%=4*?111R3ZbL|}Q$shtr=qgp3ICY;AEw;6&%WV3U)Nou&ZW337<pC;2S9<jr
z2Ac>=r(vk8i1-6==xNV^8Dk7xI60`Kk|Q|%=@<YE^c}OBjicI^1N%<SL+5<U6BD$b
zexH#(^pZ8XAsdwNzjvsp!F`Mbr?0I<?0?A<9CMD8W?^#5@wycwD#HY4r@cD|GA;i2
zLvF@217<P@U;e#ZfXrfOMvreJNw>=<JHZDhXzy9^N&D$HB+P@2yRn1nD&%)^#SW+C
z+{`!Hg;y#($j5N4)Mt=!)KYqlF<IEjvuNF(b4qd*M(|ELj+FGazaA66y>+k<s(&Pd
zbm%2yCvNpj?kW!i;}sYitYwtm*+URgR$H8`ZhyL`9JV<Fy-tJYUC9%d8E^mtsjDjK
zu!eKAxX#>X0Q=P?Hjk*rtEpl$BC5$Cz+>y|D&%m=`d7qMT`^wf(${i`=1~xgV3`Xy
zQH}r^IW(Fp+9b6e0v|LacT6{uHh&I49W&SQrjv9v60=!cq>Z(JkR8N!Z=vm3%O&sF
zpyD)1Er%Pv@IJoWRgKp#du~puml8ZY1(BJMDCvX90CdL~sj*izExyP7y`>wiPgjoI
zPNGM)0i+4sqPGN(PBTbaPqkf^X}P#0?*JTjBn|;11d60MSeVRmIRth!IDh$|LS|x1
z62zWK_n<|Rz=b>l4;ZNfk0wv`SuD6GwmRaeMdmi46l*oEOyFdm2iB&$hG=zLrSoH8
zss{%nJ?OD5tJsrvWRsDO*r`jXwTKAc?{)PRLwFEpY<V)3+D}h<cJfg{X&2<^N9jqU
zL=dq$g~WbU&&zMT9B@HBGk@z>M=qbdar1YoOk2;iXv9I+yACl{m4KEme}anz%jq8r
z$vo9fUO4{%;TwoO^^hNJK&o@Oo70a@zLj<-h})7MI322vqaC!qA8^ldSV|pP21??Z
zIp*$c>9RBU1H<8@4I;qtNXMPqNx{#!$K_LbC{e~h8+h6}S0Q7lB7YQz>^G2zrV2CH
z>cIN-uBr=$eKr#9WxSvHW^$xeSn#nCah3WPm2N+?bo3I$N*|bo``*;cg^g?{^DnI9
zLkP){z!~)V)rbpua^`XOxCB-{vu~wIec`#TwRof1ERjU6a<0rXfW6q`ifs;ruF;((
z+!hyhCMz3@o4NLzGk<~Q^WQ$7O0%ZJJbFB)R<vvBuFKq*&R3~81E9yCtoD68No-=%
zAPp6xM;r5%QgTK*44=xW%x;6n<m;DkF+Ve}TxXHbtt5|5F}9|?!;?MQ`J8X)J!+GO
z1eS(e7zPh-&Y^i2Dj&4O4;#x4Fn_IQ6L2mh16$P0Mq<Ju$A4%i&~~E6(Yk8L(Nd&4
z1JRG;P|qQ0Ey$DtsN9Zu?NEkc2;^Y%P?wB(+$KsMri6}^#V;o53A!id+<SDUPRZrl
zz8@H-yTC2tz-`-bPim(#7B&cpD>GcGDyYdUP5=~GtCOb3%L(Jg-i&cjNQI|dD(nn0
zdwbTH({%{^Ie)L2d^6$(F=^4>G`6ucf*Wu`vq%sSsu+MvU<1c-SvPRW6~rIuWTPk`
zso>QlV^0}P%aKb}(5WC%doT=fk&bF;@X<g?INo}9sy9wW&8Yh`jm!7FYRYk^0%Qxf
zInNlY*y(i*cp_i65#%x2{D)!waZ-g*1nL5eP8oC89e>Bu(xiPe#TIsc18qmby2YC6
zUJ@FHnzvDvmg3O;$yGrlBMwx!P0Ps0r|gVd+#exJy^;_D<0Gggx%`Dm$m%DmcPgP^
zIJp3MB}$wg4FEr%3oHoVJ}}^5pQn1eZwOh^Lup|uH;3hPH!J(8SOQr=2P?31pI=&R
zp_jv&P=60#yQM3HlP|jgm5A$tIyNwA+)iaXm5fa`Eg{1Jj-i1grVpX%Rc=r%f!(Rw
zd4QrUAx`iJ&T<Cd*F5y835dlu=_fsV=Olmi>Zl;c56dGR-0cVa=B~n0V{T{AQ^R@`
z3E{0>Zbvs4ZE=)*=Ybgn`g5Pcn9pesg;`rjw10Mc#o@3YA6~!XQBNFFTU<GrRI7lX
z_vg3us{ENU>RkCC07nBID$*sD=8o7rUR<{XgvsE6&u&RQDkz%VMSRoEbg`s6m_{<h
zXRz*S%&K=OWBgo!RS*1pLhCCdq^inP;DV<h{s*O6i4&9McF~eeE}12co^7Po_btSW
zGJjmaP^ld-PhWA=8jS7Rl|#E|&S}c`cRHrCEVon1C!M+3+bqm`lir*2?i>!h@lB=B
z#*>nYQ+Hwet*yz)Y}5W;Fs7oy8JKQ76G&TZn|!i(?L~{ZCg;ln$<mZy%NP%glaosb
zSG%+S09B8)s3DIXd;3+Jq=Fq+<-D_UC4VG{&Q*Sgxb&xEHzF5R0z5W&88p+6Ae^t~
zQL{4%N$yTDOhDdlcOSdnnnXDcZ2YH@pIT0L9zZnqISMd`=FV|ZoNXuO>p?Axj(Uob
zS=K9n9xOVjAgCvgL)3l;nu~Jm93GSm<L@3vdJN>rz+9i3wLA_7UbPDS;hohu{(rud
znI(wG0Q{$=N)O7se-%Q#0QRZVZzF4GJ!>|_a&!)3IEG#b$;SexKzzjncIS$k*5XCb
zH4A?t4Xvsqtsxm=%A^Gz)YUnec;oe~nKvxLzrT->jn&)uLfpymPr;wN>8k>B=sB)F
z01e6>Ps}UTz8%{K_?f1;jZc>wH-Gf5deX9IJ|WsH`m;y`SlZ!8{lfLGhb_6jZ{e(s
zIdN$h%A*mA)#D`OR|)g;dXCQn<`jo<&jOTV1duvX@sansP)N*hew5NUJQ|!1y(vPU
zQANr{eY|v~+Hv?*pof#iJ8!b|qUdE^zaaSraZ!|S?(v$w5OKhz*beRu7k@!(nNmX=
zMS_6yT>bW%j3gr6e(C3LHQAIHBLbP_sn5twX&RiSbE2iXJa+p|k$lYCH?KXbnYgo%
zNk8rmeMNix_E0*J<)<UCtf_QsQiT1Ldiqy=9B(P+*ULG!JPGXXGJka-=Aru?&hNP|
z(!JfZOKj)t%TfOTVcPCL=zn9c71*;Qh2+fe^s~9#K3NYwm1%6J+P}M$b6(QAEwF4G
zKVH=@_C2>h=x41T+C?mxo-Qor$@wLz1*G^NB)x0dPLFS&`0^BoN4Mks6TeJS{?SE$
zV>8D^wA;8zI(Mb=CiU%JwAwTTpY(Ic?kWe-lji>bM?HNiUOh2?WPh}IUzIL@)wvYD
zT!SCFYV?QFId9y0j(b%%(wJuvH@+$!DKgewByf9QDtxBtPZ$b6c7Fj~bed#<pWHW2
zxT>;PN~nKu-+R)d+r@{}=DHl{JdU2!xjb{;wBFJ8f2xxoN~+K>C*^9TQ8Ot~lIU0U
z;*kB*^r=cXCxMJqdw*ptK#11RXy=??VkY~fWOb;?9V*9@F=P9(DZ<*|u^wN4O6ZM9
zuBSYx&Gac8bJL|W49)_h9FEnu4xMmhOvNrS`PTKOn5ttY1NZ*`S|^Nz7UtA)+La!v
z$imZf_jzMyiMsZ$L9w${ia*^CxI0w#wy~<FAyM*rR=j8cAAc)!uNxDLb3UH~mqwBw
z3Mh<xxW;Po_s%+1amF|uDcjBm%0+oolWg~46%x+uXRqf*?g!0P3;Pa~2m9Ris8KYz
za4;Rg;)4GGG39>>reEb=O(7@Oy;6XjiyOvzo|L=BdY+xCp>7Q>PERAPYNClP?;fl7
zx=<wNnMm)_s(<Z0nYz*uCp<q&s|dawc=^ZP9qGZw<I4VZmxl8P4f)fFU{B0?)mSV5
zNkO*0X_*%zl6j;o3F^EW&GQ^%r(U$vAq4*L{uHbhH8%`>?(~F={p!pTw?92dB^#6H
zAB`&oi{KpeqM%7WZ)^%Eu`JhDZQS~Gse>O;jC3_iaoeAMl)Hb90S(`gT-Q4qG(+LK
z{{Rh1=4D4Gt!IYMe$?e=4fl-%IG4AKwna3s!1=p+)m`J?tvOCddUheAM#&?daX=&n
z1*rk#@@PE;Qbe!>bAmaheBNVqrNH&=PRAVj8cZxW1IN;&AbDf1b5V}`j<n;A>GK+C
zio%WKjE=qOOD=yHZXa@(@+gUiB;(SkxsjV0z^fN2B$Et)FnOr{c3?|4=S%<&H<}EJ
z0sy_~*ktRBjt}0e1BB>0^{QyYxv7=;`@*4=PsTHWO(c`SG=SusHA@<j-33cvJ|tb)
z=dD}-58$RK0CeqAXD6p_^_Z?EI2;bN9QqEFy^l1fZaRO|*e*tTib4iE^r<nx<We?v
z{nOTq0%RpdKKFWQ11FBu{(V16c0N<nrA>=Whp8O)r7CxHT95(q{Hsbcmg|gA;x1w>
zg9EK5!MmLGsk8EqpLe}9o=*mqg5x%Tr>z~2J*nM?(xV+u2dx4c*}&lSsPXTPYE~qX
z$sE%^gz|qnQ%D1!EOXwFZpVI<y#e{DrMMrhF)?=y-+0oN7#}z1RoIW4y+B`<$o#3M
zH4@2Tla?K7Has^g(xCGPKQZajlX)kos!|^*CgaBgtvhh^H5&Hded-P~)w)x-nk)ug
zgP+cv8-Ov!DwxjWgWjA8&r`wToy^=zg@(=m>r8(nZ5cHhpQk2*N6Sv+*lFR9E!LxB
z$mG+{Ok$%s-N`*D0MFhT;F{+(*j8T+>k*TX)-EyptD^2sYcBaowwDEYjMXhlgR?$Q
z))CWCx<*m*r$1ca*DWptiZHy_ed3Ebq493Ch26JLB!fTQb|ijXD}b9K<~-wr&3ZUj
zsy%<IZt*3DA8Cke8U9t!!Vn^yH(Y^S+-^SE2?)dYqPhlkOetVj3x-f|Mmqi#_81R@
z@-dgWpQvNVxC9I|UHvPIyV$m!PIexDm37zUO{xvRpE#bJn&U6X!t};Ss>GtOoeoOv
zzj+|!5T_o5)tw5%OS{+DUHGEP-BQ`yZ+w3j+6lnm^T+GZ)oZe*PvSdd{3{+#E;0jg
zC_H+K@v0u%jHOMeyFTX5qpE5D0NU2jS=ry(+rtwDR5&s*{w61qefw5D(ba#nVl!S`
zm>j&Rm&kYSPkfJlwVx?zB$?cfzrwXYpL6|*EKi06j2HeKdRHg2v$^Ns^662ZJf(lk
z%aPm<?2iyfCApELv5jJK-|C2Lk_Ub`#TN!v(=-QZY}kF8L_2Y~VDXyILHoEqXUj}L
zspK)@?M1{*w@_8wIuN6u)}4=KD-9b<jt}EkQO}o+q@A6rs8stnJBd4U$MdLx`IK(&
z>qA8|Mm5^E1jGuwcs^ne(=_FBWzK)Ww00FOosP3}Z#lHmFDLTg<pY3EvgfJx9GZrB
zH7j|bTaOKRn%p$R19NQ3nH_#&G5Y=$o%J*Jk-e_2Irf;O-4vXr2pveIW{qvIsDqw>
zV;_}QGM2bpNQ4B&2TqjISQhzXJRZF&(kaO3v>RI)?sa?H-9~1L)>I-95o3Qd`V*W0
zI-a@otzQ${#@2ox)gootJ>Y?llzG75liM9R`c`IvcVeCc_^odx)A`R0wAS$f!6;7d
zeZj{Wt(JxLKZo#X@OZ0Uvnj86u*D-QEa2k`;A4*bcjpGOsic=<!Imyi#aX=$QrWQ_
z?d8NllQ=%3ihGr1a3Ub}st|uH$*f*OBW0kvc;y48<v2BEoA>NhNf_d-A3+&i8dk7*
z8cdpn-kl7PvOT;BE1XJ3epK#4^&oLq?Dgxv_(r@@46tbt+e@UF1R~NWWmY34ODQ3{
zZd^B^9M&c5T7-965V*C}6dg5Q5i?{6*ykuSfDhrCh5WX)x=*l1O8|cZ?8#1eH4Zm9
zD^QJ9tNV>TNpvOAQ_1k%p6ibav}(U;a<JShjGex$pLcP_bH^2x6}GB08|C{OwXMbM
zXx9WW2+PjUz~B}f5WwYW*7IFOG{RVK=805DVqMF*lOQp|vBKvk)OE*Nd^jc;#oS>H
z;AY%g%PpV0$~yj8$4Y-zH^afgJgwi<yw@5j)VwX^>DN)u98sj{EThZ$4-LCK0x`#G
znkb<@Et*-pSrwu@Qaeev?uO0+oD##gPL-4sPyW`Gr*N+=`wYgTXyc9#KEv9#ET2Y?
z!#3|4X&0A&+9gsOg)XTXKi&23!J+6~N{R@F&9-^rX(TbH*_VHXUQW@0z~ggw;}n6^
zM<&rJUU5-MZd+fHMzoA>mz0cP51{m^;hd+9^x-~}7>z93%V`j*F$ab?z$AOr4Oi3j
zAdO{Pl6EgM5)_}C@~bT+%PR&mf2#lk*B;eIcagkhtW1-m#@ft=HV8l~>x1jor;<hz
z0ItVy<dM>?7tMctY%1+C!}5cII(mw@<QsT-UK=$;a1RalI#a-tV8p5Sf#lL?r6R(y
z4~z_Xl`F{zLJKGYKnW(I8+@GPj(sVGq22*&Vpx6M!*)G!*B^x|1Ce05t-%X($Z#72
zjCbd~PA7pTj5A#P&N(9^ny3OXPn6>ws>Ck>>UJhuOId$aBxB`EosW=44%{9yk;vpx
zV>ZU$L><W%)~hLaf|X!IiOzZU?NC9cYqQJn(k%<c8ZN7<YELr0i)9SaUfW8I^2Wk_
zvC7hnl=7X9MleYf^)aQaYLZ+tB4M6U*FK-j(pcT<wthPBcA;ag-&*P#e~Yc}EUzLU
z$!~EJhDm=HAdG?sP(@r)zPlVanr=~UJK5W{{L7kVp{&iT{6U8L(^j`O(-!iijh0JN
zt+k;cfNknQ1UDhFF+tX5eRg=yg9NsJX#h!btG!$Mz;lj0D;rgPTK@pzKZ`Y6{{R(h
z*B5%9i!Sv$>6w*G*Hg&NBanb7%My41dH^Yc;?9398r5W)<8$9Kp~peT%ulaxrB^NX
zITWEmCsEq=Uo%#78Naz`po}g!2&WYX?@SUOERYbBj=)tGnM{&}nf8N>lh&0bacw3p
zBvZWo)~U6RRV@{XK64^%$oX?jkgn*xG1vLkUF=xmN6s<DLnAPB1&7`BqQ<DSBx4W;
zXtRH~k@U?)Czc^Ob;&$tq7tZr^)qaDs$`V~hB+8Lz46wmvwXucXPzp#OGVO9KnCoR
zI^wHN&WQ`8%&r)1ar`anew7h-^3MYqrn95lgew04d}NAtDeQNaTK>0dp!lBJOPLq#
z9vYiYyAaM*Zmivr+BtTgnOT)jQTIh+No#+o-h4gO^%U^jG1*)A;yVVD?Fp5*WG;*4
z?%$2Q@wc{fT+2%4X@}cO1wt}LKT1n`m;{QW&fHXPIO;}lO*Iqco)WDp&T;N)MQZ;5
zZ-MR%n^%ykN8at!9y8XIL>%fx@9g3NDVsAKD=-9wUJopIUw-1ACyk@GFD$)ILXm&z
z#Z{W(U+mkMRy#eCTqC<M1;Je41L$*;{{ZTxW_SH=a@@L?H*cw0%|D5JNpNG*ZSB%q
zsic&wFs|6*Qsj_`I8_`0z!lR&BSYa^)qCq^X)oa~x-10BpP6{~$Gvj4vwx;(s3W*#
zTO;!9=uc0tt!*UHrIpv4VHAbDy{Lcb%f%t;-Or*NjlP^ylupR44Jm{Vr1*r}YnPH3
zwCHEv_S;dF+=f+ClDIkg;<DN$W2TtSoL}t07)d8P7oJaS3;-(A2xZi779B%QP%Y!k
zYc9a57dRy2C)eNWSkjhgr^yUAN3@~93Oa-J??hrY>|2^48{GnDP_Ce1hSh&0bH_dT
ztfefAbXMWW`&rt0Wct;a%!|DJzfFAHld<H>;~jD6YL4THet7UP@|EN8t5F<TP%akf
zgC_NVn2yJ|s-U|hm|1$&*D4f|7*NH&q;%$)6z>(bvlzF4iLFAC$_W@Cj1oBK(zS{l
zq-U`r6>mKJt&X(|7|N~?dy#)rN)XtlC2itxLhZ_*eE$ITs@|u2CCtw(nh%DdX4B(B
zEUkoUN{ntQJD%pQ#tv@gWKtOQNE$e8-G+Wv&eO+n-kkpc>TVd64CJs-dS{x2Vm?$3
zsd`Q@arZ%{D!WX?+{k(XnmI+zg@vR3DTZ_D%}J0XW96Qm>UN7wT`7O0{?t!2UMh(A
z+~D{0#WH0@lFX}y4{RG9#R&_YF{(z_#z8)mfT(69W{~vz&C-zl!H_DfX4xj?F*XrS
zTk)jMEyyT2Y|sh=5iy4O#z8pGwIdIlk`n~v0osu*iZ<;W^`@V_Nt5#Q=|~UX;LuIS
z9iX>floCou`?F2Q)}?<>x_Im<GFd7CwmgCTYQO_4fO=FZk_XDadaTEcH_AC3t0@z4
z$&Z`n9cpp+6yyV(R6`tLRQ%O2`-|(EhQOJ60k^k$vl5)HN$XX>AK&O|<VT0#bgbBo
zD?$6l<YN`?-wW;6`%6-kpd>=7KNJ4|)~^w>T(a;wSJGb$t(AX#6Xy9044RYYBd*>C
zD~`L_9GIzlr?^@iT1Ut5RjvG<I`dVb$h41+cA8R7dH(Hl*zsDqZ+iT_Y5RtHRRG)$
zy(#Md0PPwqE>vg+83W#?UY$o;&PK@}GgXCupQx#5e5K{+a%x-+zj#$uVdbaFbDEGp
zy-7(Ha5nVqM;m{74wV-5!1>Q=Qrr#&B9avS1p^p73T{UqT3^ep7cC*&deY@~x9->R
zsLtZu4Iw-Z4G5(YUO4-`XghE|RQzfzoVPuN85>8|uHfQKHts(vbfoTh6%I~MCZt^9
zvfO8;X^WJ29ez>yQV=)&(Lp~i-tSD@GI=?vD#O4TKO%qhp^*z8kv|bp1{;sg#OKzY
z7<1B#jYN&3jDzwgUrMg<Mp%CBdU{o?jK9o2^#>bIBBPm_C@#ih+eBOLFGJd@J)B2B
zyN~j%q6SaXtuU{!>qk2)*+uj@xped@_>FoVYbJd#6c|h$=QZ5zT%HHxOlZ)LxV1{O
zk(BU|mqUNg{{XT-dC-0pX*7s%qsaad+nVh}X^zz*#U59V^=lO)52!=2$0n0+f%}#m
zRLiBrq!9r7!yH#&Bac6EDf=VA`BIOpNtCc~T@F<&RAb}=p2Dt2Yybc%epR+rf4aSW
zDA+UiSFfdJ>NaZ{F-CI2KyD36BRDw0tJ??nSFL|Y5q6%RcB58mos8{`gTVW}>Aq9(
zT7^c{`BspHB=CAsVCOQ7ZIj0trWAic(zS{%NZNW+e6i2UXh?kKL08?;`qQx3=-AJC
z)e-P|QRS{1<XW_YoXHFG4k}dxA9uZId2#ddEiacI!G#@ZhdEV1<Av!`Y+icwsX~A{
zd(?k`4C5WDu1k?$%3Qa|qu!cg8(ZZ4D(`XipaHx1dQulVGmJxN`3K(g>rk`@Y5m)N
zHLgJCfl&}J-Fnb9HeyK=XZX5RR!IRESFQF?QNHOlS)&;sgZH?qG*dHCoDNHMqO^RK
zIsM*v??o3MGB0#-!Rbqq8>ps&2;}uNnE-!~Pio>i$+Pl|7Ny*C$sK9}*aL&ol}=T#
z-KxaP3Vvkc_^QVtP8;&7s(wX2)gV78Aor?9QY;MMaynDN%AQVY6*(i1;inw>_Vu95
zaqHi$H+RecZ1L8bNypwlbkjirfZNXMOwmM}JhxtyjK>G*NHgd<Qjjt-MF?#S>KK3R
zJv-EFR4-pzk&ZV2R~f3({{Y9kp8M*P6^Px&*ZaLX)CrR*`@L!>EM#6=?_#EhXm#WG
zYOW1g6ATO!=~DoHU#%z#SCvEQkyFNnojoZsE=vk<Nh9xOub>{3)KC>FZU=K&v0mYW
zwDLOBbI9w`gNz<&j6lKTr7H~&&j)`Xb)^Jk^V*`%Ba!!MrH8M2Rtpmo$5#9(3<iE<
z_j+Qh@9Xl@3myIFu+&RMlRtEG??_0`3@W)Np1mnSJaTGmI}>y3+Ja8f0jToX9MTik
zm4pS38-qsWz|W;b<oRrQ``(>u47Lx<deLH%C)_uazr7~mwa(%_DzR=z#U_95M_vzl
zMRJxybI+|gvxTbRl(6Iqm@(RZVL>elNZNQkDi%3Y^L8~U=y@F~7RNs?@X#bc#NobS
zp4C~ilk*;xZ1g`M>rpTyvF(awqN&eZVw5o%&N|b`I5@%iY8D6kuhM~&2m8M_YIu<3
zWS*5*fWw~Dxm=H%y#ldwBOHGL(wqp~cmU$62EjOLlron4r=>fYv{)JElhT(XJv-D}
zg)T-9%~YA2M5i92m~ny#?M)agw5$)7#|NcSA&fZM{8bx(Ob6v|n5&ujPtusc7~7xW
zszSN*pTs*oN<WC&ec+i*tiBVH2Vd??uenJ70C`Ez(!7rA0T|;Yf#!d{o$=+No8ga$
z!bGLxRhd1?9Fh2p*UWc=fr8u*(z>wo)b?<4=7B~wB6zUFhOO9HzRc|NAt4UZN9kPh
zkR-{^;a0xT;c`=UIsso<m)1#YVTz>K+xL}A68QN@UA&)v&baHx%RVFosKy6D?OiS8
zl0BJXARHV3IpVoXwqbuXnN<6=*IH?r;p1Z#S93nW9AA5u?!@-|D?fOTP??RZFik;5
z+;NpT#ap-_OAcK*VsYt9s9Gv`XG)&m#5!F0v`dSq*oBrh<ZWM2I+4`yYssq8JxJ71
zvVBZhUwpc&eV)}snuAC}3<b$21FsZFPWv=LD-&p(0nSfhRak$LgO0Lvqz^Jp42bNk
zvIbH*f)5AttgLhzaKU=btb=8=+Ss(Shjm?wF`VR%a(WJZs+zcKZMz~1_RZjd$<Mt*
z=1$XU4EGYVO6*;aQc1}t@vAsgg2Z_(nF9sfFb+E4^x~nRruvVOqcGX5PcXy-e)2hN
zo}SppUi9!6YVLp8)0)o({OgP+Fx=v&K`Z^4V~%E(uEGT!2tU@9fy~i+-Ar3qL2Iwx
z+N4vLR)v^9n173K?~W?OTJMabu$~)_9cuTGeUe33FGyttfg6Fwax<Q_har+Ze*QD%
zmWt@3s+{46P(5l_RhLH8WCc~Cgg!CB836O^OObXtr$&DgcWY8;a<(%uXm>N@D)b)I
z26i%K`Njq+uw?rkwkMRf;usOY<BT8vwNAcRvS!@dgB}NZb~jy%46~!h<>~{>c)%<V
zZ%WwHudglUm^4;9{>_gvNWs{1_oFB7w_tkKb*;7K%#$=m5Rk?mSy{kX)O95K3SlrA
zTrK6S$}WFM+%vVn?lX=*3YjF%TKHOZUEb)qH1`why41|1G}oDC+Mu>L&mO&M5?o%|
zAl>s$KQ8rd@&u0WO?1AsG0cIT7C=m700`~HRSg)tgepamcz_n^!Otht)}b9K`<fcw
zC5}k^S>bdRdV;6?BBS?`uqILu1PtT>&;yFiwzYrM?llAUXdiGz40r9q=C1gK^%*`P
z#U<Z~^m*B|#birJg2Nh~08Ut*nIxX|p3=@OuF^ZJ<Yo)=M<HAe{W+&?4CyB-QNHG@
zdG?bmwtg>~NsYTfc1p6Ci?=a`$sn*DRD;xJv(63V?U_dFfq}a{PjY`VRgggxvw?3T
zZyA4J(i|4Y41LFHoM-I+0C5gSbK0ksqpq5=EkBWOduH=#)|X6P2UQHFB8u5`kw#k$
zfI6uoJ!_!X{6hNHv*I06Z-(CpEUp{EdRCcknk;W?9g<rA0Lw^X-g5FTQI8{%cs0#M
z6XxPXv%6Ts7Gh5Qquq#H{z90{M2uA+Qh0ydsxyk01lgSFMol-mC5~M{>9DBPCm~-U
z9|xh&QZw7uwI{i^mqE8#^sDt}M|g=JE(Zr4#u)U+O3f}7YYmSM;|p&2bA#CaG}kU?
zW;YTs<C8;z6sacDEkfkzwqV9L25j+$?brHJ9*ll&qo=JzjVGEjB7dsqij)tRJ$Zl4
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#m9fHYC!{>wsGh?Q?Zj{T0kV11mL%NV!C<kN}PFK
zz3MhuL`NwB24jE@PZY*wP|DV)Awm4=ks>=Pi^3&tTb!EXbsNN!R`9*F8kNN1wHJ}X
zsmyA*$mblBo-3<q0hRYcnIH_-1+-dwYucRaVX=kDR~+(3@d58z(`h@i$jpE64-+bC
z_DP#*#kw7>or8jUP)YI~um%T8f<_AIf(~K_6&Cg-u&v0f+PUr1k1SH`NU}MY9qKrx
zZN-V+GB7&TFkDT6CNt^Qkz`?d%2~Rey=mCgkOsl!v%Kb^B>kbjevM9%$Zq)Bc^;Jk
z+Cr6P=hW4qme}UrG92Ta)Ny~3zG%W>h&2hx^8RDO)Idr0oHU#eaYcc$XOA<V-hrC6
z3{fqfq5hKy52vy|a9H#s9+cUPG1<UcMGfVT#;G)}Zi!bMF!u(H&T0GQsbxgrEuFt~
zah~8}n-|(8lI_ec5<79fYUO(W02W3+QB=bb1i74(k&j{i6>AJ_qT7Ew`yS6@V4bI&
zoQ(FWGgKnF8p>{4P(${6XK7tbe`Rfn@{Uv}7~ppGt%oxUR8RC2!l4YE_{i^$_0KGq
zM)G%kQdTko2^dfg2Ot0d>DUUm^KQ1XTuJi5w{)@-$K%`EwJTh<Ut?x(QKPY)f6!v{
zOp=qjY<$i*;YsK@;B|kiS5xWltZPn|s9mpy!Q_yNp+H@^Cz5l)&OaK%X-AT9!~neF
zobF6WR@u(RQ}UCN4}5l}qDw<=NPR*{4ah7><yQmp<EKh=3K-0fYaUwMm15n8wM0Jf
zRkkE=QS*K59>0;NzEI>aJa?_4jHXr!&#I~kARp-=0cOI2PkMiW_wR3&M{JIjG6S{S
z%Fpk!)C|!0@`9B9EP>oss+gS0Y^TXM+nnU)p(!(2-8N#vD99`U`~_TfVF}D{*NoJX
zTiE{qWk)oAFtsv$s|{@|Wn}{y2Rx}AxTfMmnUNH%zIwD{1zQ;HntQ&Owz^WsadKy7
zZ#i6HS108F{W^d8R1X}oT+QYFLyQ`Ml0=1f!67?OEGjLj3eE0H&@j}mlr@uWy>Yo5
z6>o6Euhyk2`{GOg01i2(+YPpP@|0z&LRXxq>rTUR8pb@}Zt3_`dC6a`PQFRFh_$+~
z^4sOyM^V=!(wfT<m4b&EJOXI37aBxo%j?0X{F}b>AD4f<B8~?KtuIDAo|PeSxICYi
zttbN-+18G^>rMa_9cc(}866EdPtFDpT2Kb_^A43FM$Pty5&hf_NbgeFEstCcn8!+;
z0qeKx#aB#%*<v}XDt_qCQ(4GE)BSKYHy<wpuWDuhAY@dE0pR*pYzfpKmxbhWR^tQ$
zIpwOfWQl)cAx1+2GwoMk<Ybfnv!8l~P0igs36>$W{q+OuUtRb{-^uV#hT<pzTLcFl
zq;p>}cuv?{d_mCS+6s$>W(U!EHT9mB5p3YXV+bqHs{P~6#!I2q?ok9oaQmI9g@$^O
z^{PH#-Tt)a6d8GJp8aZ1HpQaDaXXC)+^-`QOum0W;0|ebj1V)7(PEM`)sJjqtj5FU
z`IoI^ESOXC8jwo9giy+{vKyz&DqX;Y;E#I9Ne)-{hODdngZGCun?<B(hF@0ePYf}`
ze+^JqI3IVPT9gx!(x9ss!5K~u-KS-8eqqw9D{=QmcG0+T^YiaW5ji;B&N=m_Zpx1Q
z@l}7>h?IQBo)~<*ifNXSH#~Aj6yOftyk?^fmILPLPb>o{9<&TUi1noe<n^Q{fyt)l
zkG$O}+$=wE$MIBc)2%7bmMSyIJRIhg#*n;Ve1eSg+ox)12MjUZpR{27+~SLrgC`#N
zq{+bMmj@qulN|Iki$dqojVR6!G@N6g>rQ_i_%xa*4mtIsxcO+uC#5LrDnKwXNAa&p
zb`KpX+eQx@&;iar3Q?Sn1ui;tr2~=01Tnbdzgm$;&EKUw1=w;x`Kdu%91-t|WQ@lh
zDKquyPbY)O>r6Pq@l6PBTWfsuqdamtQfIGDw1l09rB#JuLC~D`qdcCK4&(EDyi<RH
zKJ+9O9!TbzbCZ@mXveXo=hB#1Y3g|GNt2$2pMy^W<{djxaoB`zEWaytr}MlF9+fWD
z$8NNs9sdBs(u;_XkM7cU{{Vp0pmKQpDR42<wJ{JLjlrnfspq(>Cm25|>rl2c&`<?(
z56#z+P43*Wz^PAu4m0UY>7KnRib8*Z!RCroBc2allvIp^B<&#g=}+B~y!NWf!++sY
zamQb~>s;15u1I$f+z-1z$YF*(C<o<kJ8?iGk@Fvyy)*=&j`bmjPHJ@{<vCxw(y9aV
z40_Yl{O6ixY`PBz7^kV>`qgD8Z{E)}C?}3j-J!Bl9sEtfpabR)tt#{%?^AzR;!YTK
zq-u$V2k{DPH_SPxiTMskH5p;M?+j*(j>DMz&GZ#oMkfQGy-$&b&ba2QGZ7g9K|Zu5
zK2SS(`DtSR09~FsR6jRxezi0TO~~uPt4xWbLNGG91oK)EC<OKEP$G|$fzquf0E~`J
zHq1$eHvTm6ot?T=VD#sjRwsXNL(-w3LKE{ZJ?V^cy-!*RIq1K7kw$lLIj3TV1Hs_+
zr(>r|L&L2EjGkx!$2@w{75RY4>p^UH9chKvj!#;W(j)@|mhVfClRc^(*<sq3b~E!F
zRJ0Z($jc1VNf<nHOvvX2X@u}|*L4;P3dcF=-lFyEkF5la!-l4kIplxzrDBp8_{qk4
z)CB(U<0FcZix4_gZPazmClb;eI*z>sO}T(P8mte_y(&!PedE@ZiD;C_Hji^iT})#&
z3F>-u^{80<><bY^g<{U`yb5kq;|>QESU1dhG`o%u%sSEw6L253F|m{K4!uP*H(!})
z81Q~^)|zCHzX1IzzD|FB_iCN+bMsYp>UkWF)YB;j^ZoD6m1H}IC#6I|+IbZT+zI)O
zG=j#6kbnp$1XIj|D}rk?djsF4I7+`RPvuU;IGU><%3$~Aq%wZ!{OgL#4loW+CZsN;
zug^^wNf(Q*$vExnRUSeWzH`^5M$Xvl+Nw(6K6eh4X&Kna)`x$YqH1VB`R!Rx;xS(<
z>o83Zh;_&rd5-ai=U-A^N`~I!_k*o`{{Z7#bzc=N!md2k3jXJ@{Hsb%%=EA`v$5wa
ztX>rYLRvrqsL3Sy3WP{Jv5exKa9vrMWgv+MAoR!6^sKV(GyAqYp7rkGt8$)&SaTBG
zOZ$tA2I_kD`d5E9a_m^;pBV32k~^3rIX&wV<b&pZ^P<<H>fIdir)Ff#z|AL5xm3<%
zfW{?q1LP>`eQH_35<Xbq^Tkyo3P_NHjxk)*cRJKj452*06**QRvr!UuHZjP@(xd>H
zm;f?zPEV()sLtF2&IzbBOjT=jk`U5$VUy?&f5Nr(TfKiiZDU7<*vxEfG^r8>ejSNk
zayu4oe@eh`3%TPQ(@x?e1E6kkO2%`I+I@?DUE0l~DYLwd=C=hzh*Ub0jIMhA6}oLT
zeJ@$lZe7%YI<#_mXA0}vo;W;rtNKH0de@A!B$2elw9}zCGiAcJl?si(6Y2&y>P=Ab
z1?${s`iy^vS8}HH<Ve|wDmQSr<aDWNt9hPnTz4&4(|vb2+=tcmi3xnmeA1kpkWE^N
z@uli$5ebstX~^xK-j$yVCewz_4_s8ynN8CD%x>nc$D)|^07uB@C$(FE$FaU~ki1kR
zp)3Ng2BKC0q~WqCwZ^4msk6S*2gA*F$uw*4wOoJP%G1bS0g+b`s(!f#tz#@?T0_GP
zxX&FAztX9z=6FZ}NIgfbU)n{q0q%j#@Hx+6S-99#;-cH`ZP{u%a`<CYvAFQfl(9aL
zKxTcclLAUe9|gW#@;Wf!)+;1}ED5&*CsFVIG@=;VJxWhCL}(Oz-B`B(55~9J-@~h-
zXh?s2Op9>ZRB}5O45^WlrAKkos5K8lm7x7hi>UO})wH1kt{200{$a_<n2fhyP6anV
zF~c=L?HRe4tnj$ra8MD)(9&-_aC5k0nyVVeL|Z(Fhyx&0ia|R~%t~|Bj{>2Lz9Jr3
z<$F`vWAcIA-+u?1Ry0hzBixM^))v;L*xP?)@|PQW5D7hUG1K0vsXlyXV;l;N$NDhk
z`ti*Pkf-PV8dd~bGGZrTZb<`^OCIkmw&C+;pl1I7MaI%{y{fQa9e#719`up}M6&E3
zF()*U%A)rkeArdV<2=<xVp(uc)}JECfSu8>J$A4>{&ZLoX<b9c15U%t=*N*(CYpZ_
zw5BXwaRvqte|pZ2Oc%)N2kBMJ>6YBGd4-(<j+i|U;Y*ZGR@~c`c81$PGTSmG&Yot8
z!z*r3#Ty|>DnSRR2fit@7>Yx+?c5l~;;o;;vSNnaY`2))mIVCAsi(7CLwRu=uuBYx
zM)Z(vWbep54k}V7nLed}SWOlLzzct+ZaqhDrCW*SGtNBDHXPM7kzG~R?kscj4{8=~
zE#z+_JRZFd<4(fRu`3U^Ir9zzfq~fLo+`V)-X*%p`cw}nW&~r9I8jhYeniZC`kHAC
zBSlOeWB&aZY$v5>xsP<@00A6v*XvOdL`jKoaoVfO@)+a`17RWD#Yf#<nLdAln8{0I
zo_~g`i9+2lFZ>;;4*viuJV<a*bKarMVqB63&s32}mD@W`?n$Ivo4zG>Z2tfobNbXQ
z%l3hT#yfYV1ON|~bLpC^4&|+`$WH#fDVR`4-oO=HNW$h5^J8}+ule@tX)74u&M<iC
zMTF;K1Gu3flLz#s>|lsYi^qRTWLFWh&+^2$ZawKIkv5UJcsSypD<#V0PVVzKk-^8^
z`cpsy{#!N*oc>i7eswq;8j)NEeZnL19vY|#BS;=(SJfI3_G!p}B)(ZtvaZla-y?2w
zft=Kqvm)9`l3PGS1tE@iA@=Qq)0(Kn7~>ct_o{e3$4a*}6Mtjd$@YI(HjPnLagD?>
zoaep<FetH?Gr4^lFC-AzQuqd?R$v<}dhzILgaH>%D#dqUjzRBQR)Wo=xmg*v{{UyZ
zt`9qhKt8n66qu}b#~g}5DnY=Z+U`reGB_ZPTZ@auf(W;TB1d2lGd2_{CmAFG-l@;#
z{{Uvpe4)8O+r}zO2`qo4yqRwy*H+#ICgrUa47ebL3%}*bIP2S`XrSK4Q<al1YS5*Z
z#7%0=JY!*cmg^idTtc`*I2e^vuH{KGfrktR;BZAZaUpjo19;E1RCLiF;k})})cj7G
zhnXhCeWD{2Y(pGio!G_(M}EDhw@a_=jWy(w&9^a7(Y8iMJo<lUwQmY`Ibl)CI_Sw<
z952eDNd0J&%~skh<!17iJaVJCtB{*Cj@9RbQFTpL1~I_fOD62P?jY?XbT~MtUKV|G
zT%H|1=^&QtbV)SgNl^}dMsbbXdS?TQ(MIftP|uaz>GmpaZAu1WFr#oM)b;ub&y&hX
zZkWay_6@$?zny<xkw}$+i{&lBBd4xvv#OH7q2zH%#C+Ew^7U9nn%!v^@dmbzR4#)I
zjxwY&@NzxsjEwJoR0Y}=v~MN3kKy-$R!v>zf#tYim1Qx=xKkJmPImf?4`Eog;!}A$
zh~H&rDA|!t_idL{k0C}tDmqYh>?dny9q3?zl!iRgU~_+m?l_>kjU5TvXgi8$9Q`R<
zA1Mra(&s0IJdQI`13rDPpITK7xRQq$;+=!I<aeilILw3Zdek--Bf}CtP64Nlyy7{2
z=Tdr_To9xN;}qYYZ*RL&!Lf7u&L2Eeg8=7}G6s305qa;nNs5EPVT1U9PxCcq(pV$b
zE#0Gm{{Vl}LYUcd3ZDM}U&5uCRj8pB`wRpYQL~(PsgMD;=IDCUt`IHz{G<J0;*kN!
zIsOrx)^aK`x=fS!hstVo#s?oxYB8QZUX>u~4>-j`0%hIi3=Y+&Zof1mC#`42x6K&O
zBxbfPKsQi<w<bUb6_nkHy^mh_ab#On)NWcMfggXCryarOzJ|0wwkz|VK(99NO^}1Z
z`Z)VI1+A7wKIfYB=*oytY&=(*-P=5jM6V)#a=&}-(}3Xd-kJ#7DcKv3PtKXnMswx?
zyS+OkDEd-13mlqgE6>a`nl4%<1d={(^)To;H42gFy=ryF!NnIDDjaPXH7GpwBbtMZ
zeeQqs;gf;1_3Khmbzgz=4_cjE<Z`u1cJ1g-y-c{rQ%DP<Pndj$oLKOC=Bgp<$*U?j
zT$4(}OkPTkwDkvS{NJ4cP8TF}sT2=U(v^zl95@Y(^rackU(SQn^WKmVk;O1Xnd)~^
z6Uh3~V?V@tQPBqnlTyn=i)0#%ljaVT;&^{tdQxMP$ote>s}2Nl$o%Qu`W}?fI2=>Q
z+#GhKG$(QOq$PbtA>D)bx>GR4x*At4A>n~N4_cIC4bN(aZU!^jlpH7FNMxg_<Gn8%
zhX$et1GOkWFv&E6<lR^gdUgoMJ*ptX)O7TvFUs>y#5PQNFHV$z{D;>y32vAJtv7#h
z$>*z8BuPH*2Q;C+P&lgPjz_<>E;IaeSP9E~-Fwm#?mE*4UcKpY$>5)ws=z4k)1@5e
zw_0`x1By;_jCP;^4tffH20GJ0=kA`g?EN~?a7Y08hgy>ZY3tIMy<duxKPz!UV;DLf
zl;s?+Kf~Id0KwpW+75nR57vPT#s_}~tu$wMT26Nln02Hi0yz|benw9RtsazsryQKq
zxc=}wQzT&rp1++VFR!IaF_FzX18+cROhq<B^8BKrWjn#atHf|P6w;utN~?`CKLi%$
zin3P>bLmAQj3jVIb5kpv9z|xO_4&<CtaglIu(8*3LwCw)x#axDsw<G^p4ERYRD{7J
z9dkevDLFijm0@wm-Kt>noQ}0Nco;qC0@}AvnDpkXFG0zwN_utaQwQmc^{E7lxfnev
zCSkn%wHEJ?e9iZ1o4F?@i<&5oa(5G+HqsuQXxs{(4@zeR$EUqb%SdBxFMto;r)*HE
zmVEkB<#!Hy(~md<G|)04xpjX7JdkTf-X&ZdWcA6YqEHHP&1gnGLBQ!&j3q0M0PY-A
zpbew1N(UI@v8Fp>L54gpYNIk<g>rjS3v$?TQ5XH+e42=o3BwGUb{Z@e8%Iu+7npI|
ztyV0+<0B;Vnm|ter!-g#d$PR_eQBie-`^C$!VbCHNOO+8>GF*s31fdE=Qzg|CmToI
zsQJm_lmb*7noSy{F^&QGjV|nk=8&oDwweYA>(ZpOi8J#iLk?*ilH-rzrsU(Rbf6!Y
zWOksN4av@Vq$CwRDsD6Pc&6bAZckpAphONnRpj-kn4C8UrC4Ft<!ol6W#PK??MEon
zAr13%6oJ=p`p`!Qj@5r%&KUITQ)2flw1XUDtwzkJXu-}Zsd0{<#YRSc_iCO{<s>Y3
z9D~!fChkw&sPot5G~D$$;+H6#O9A=nXe>7N`_)jl&YZVHNE@ihrD7T_mKh@gqF_AE
zy{aw8o_kUk7(aTIggdiyOgK2m9Vpx}_q$U`;BwVyE=J(vsUm-&AniOFvVQ_8gbcO_
z`coy429O`U-kc<C=Wy>xz-O;&tm6P2)gl_XYtH#c$}zjOR-R9hh$?cmRo%R{<PJ?|
zPcsOZZv1mpnVX49_EY7_^A5aMn)s$Am&5m&0F_<JdyH3Ubs;8So4s<nh!1aa2?b15
zaW<s+T0BZ{O0s{FcpYmVQTx}!_UbF4)?<<%5s-+6A{!?>gWK?~a$N0m&n$XZqe-6B
zB&3QmZt|x6@#SkCeiCn+Jm$5f00Z-}<E3R!_vSk@oC@xQ#N(-rAtZ$-_^OnEs~&%f
zugVCNoQxW*`%J1yA4;~%MOIVg=N(p}Vxlz#7aOX1SnYoU0|EQhR}4cCdVaKu7{zy-
zHy-p2zc&q>Qh+?8@;6TO(YMQ!JM)eyqFX1imT0_73w^HXP^K70a7aCVx%aILn>b|B
z3dCku<-C)~W(N#MI49Pz(LB#LEC$%g892}KrAaQ+NR<-)><!KGhdAfjhOe>bVz7#&
z<29s^^KXBtL!`5|i+B-O25<o$ovBwoQsOS8V-%3yY6C}x6L9SqZ@9;ddQ|rR0BDn2
zNbGEHWsoUo*8^}MWS>qb*QwJPG_@i@F~1`$3Z6kGtjXo3qXAgK=typd)K!yb;(@8f
zb8+E~L<2r#kgAm&bs%*7t2fL>zLOH=ci=WSKT3ZSOsLIEW?4WU>rj2Mpj@^T5(hm6
zTam5)%i-jWZyHks?=P5e1`o@Q-7}tQ8)vbPQPsof`kSfIWL>KK?qTwupgfV@mRPPA
z!#V_$#DmYWcZBZ*x`xAWIT$<~(92RSMHSQN*0K|BBbQrPfoTBCfu5d&Jo;2p+ns^R
z+mL_PvZ9r2?kU0b?@cDqP2um|-8@lRCiHWF&HPx$KzR45B4OmX`!K>eW!er9XE+rP
zLb-~ds8&#nST}0746KiE(a#^vW>awh?FX-3mD6~B$437Egfin*mhszmy!Lw>@RDF0
zw_c;ARq+jmlNXtJY2qlBIWH8=YbfPeyQ6>fA-yUb^|8+!bR9=esgTa0V^J$`fN*Ks
z(<z1rJ!sS7v_2N`RsG$|m~Ewv76^tKM||J|+Z|0)jjg<x%DnuOjo@b=g*zRvsHEEL
zPV+aM>w&ZykT5%NM{2B4`GXCdy(r@&3_fZsXqhX!=4A+{<s6aHk(di;K2$sqeQJLV
z$L%8pvAhm_>0MadOfuNx1kqr*B1lPMu*wGRYCuCVU89xjQQNzXMI&o@N);rPLVA5D
zW>B+X*8)R=zSIikxZWlZMl9W3VIkR@@1LbTZN!(cWuj19YZJlb;1TqyX!3c8>apYx
z;_3L+>uaTbQdMZtacj6^`R1XfbJu@v&c)*jTj*C1v)@V(xcS>8FQ@+iuCpY))F<&q
zuXY3s%YO?oWKhMTP^fW%k^uaAoYt#IO^o|Y1Q_s1=DBv<y2bEcx=wgBqK<4jz0Ij^
zBcD-cks*Pa>=!oBs>BEJ5g5P+>48yOUg|d2*K$Fq5KK&id`dwbj@HQctl)pompmM%
z4nDL7Cul4H%~D5Vim_lZU{2Hw((YnAvF}l_jfu_EWD*LKP`fIH`P}vCRoS^;l>O>z
zCW(_feB%=Fn$WSomfF`@MM=udZMD<^h6ku5_BE6qAF;v=Q|{*{JZ7UTOrLukQ*j2A
zm4-<3o7orz0L*Z!&<aUg5y*cCT;i<>1Q%AaMI;V<f=G49<Y0mgW{C;8l(Mc2rl}#^
zSV#egatS=<og;qqe)t@xYH3ltZD0X4JofMnCdOFjmww{1#70Wsec*iwsuPulAt44;
zxjivbZFX4)l-+7OIBzDF=p+-6k+Eh9NEodIieEVIEEj3Z52vLDH7b9l>Su^H&aToN
z2H;a<XpObN79hXcNe)T-xao?~Xr*Z6QW&1Z5sX%BsVZKw5O5DT6vY~fL?pQbYOy;y
zFJHo%g^P|`@uYB8;g09~{{Szz{3=Q0w-8wDOR#>!`_1_K-rk>$QKvC5D6=6Ucs%6Q
z^<_4*EQujQ211q~XR&_-dR9DZA-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+-84NQh6=FHPIAfH(|D@
zfS?Mbtfa2&9&$S#D@St}!+oYr$5BOLv;{dmcmku26f;Sa83J_!Y2-J(T8&j@j5nId
zTxZZ%R3LHGs60gz>Nb&r*f$JGW5>(%sJ_vqH;MIIc<t^H(n&!qxJN73ALoj<ZWHZJ
z>;g1u8X`eE$@_obr+TL(60MJim-|*{ir-tfxQRB6%JLp}H&y_2&1&OhVa;+IjFxeS
zz!_3%fg{O3D9FhCYW&Cj6|&NQtnN9gB^1KV<{WXxD;b(anD;RUxq~IRCkxv>@mFHo
z9lXEj7Eik005<HexWNPS%_NFM!>>M+(8mLV_iGl7NSl8KF_`(?+qE+o5^#D{#~(if
zwM2jAr_!N~4H((gsSa|#G3(Zy&d?4ixRcBS91+Ds87Iw-Nb5_^4+4e{u|8AxsRni)
zoohA%^XPu<9nbQoafKU~np_P2H7$zZxY}}8tu7<`L~Jq$Ac{kcv<&TDJJd2-xo0e9
z1inc*IXr*V%eQ9(wO3Ko=kHU1ayjo%!(u>i-3}^Yw4_{js6ZL~YRWInzLgA?%W*FQ
z<O80<y5A33yxu9%QEl_O^$TQlT=IVk=IxM~q8{Icdl$p|7J2V3$T;8SMgsK%sr>k^
zTGG(UtodSlK9rj+EWkhl+kgksx&>p;%~WjTL27@8%Wu0{0Y*8;O5sTIWh=4D=LeD2
zmo2yw-KbR_gQYtQ?@SQVatF+MQm@`#T9A*J@H$ecJBQ3Z@SvnzPzFAgFzCNZs;!Ro
zGPv3~?LZS`Wbm}`z-{@D-m2TV9E?(P?befJBwSYO&w89UA9;F;&IPgeyVU4@Uai)U
z>}Y>00Dp(AN+n(E%YGF>N%?^d)}#RBWxG*uv7{s!Jgqx_1LhrjR&MW`mK7>7`LIV$
z;(?@JR?ay+Do{Ed<E>Lh=c@Fn!5NR{??|f_fgJKF4l&N&l^7$xtsx`Vzj{rL4;bgK
zS_$O!sP_&!QfDoJNVH5CZNX7Wzk7jD`g4EZno{2;0UZS)lODf(Q%eE-bq40g8KuD5
zK5l-LtQQ}<mO1Z789ix(7{?uH{kzk!a|m1c(eoJ>9Wzb}cdk_Rr-b=|+<Mco4ns2B
zjB$#7I2@DosWy%|6!59V0_Gtg?HI_w^`zQzIPX?A@_28(OONx42XZx2$I3d?xb}Zq
zTyxa@-t-Qq=}zMm07$_dY1kXO&<7-Z)b2Ca^`hW3^NeS$E(fIt9;2loCnJW%A=ofW
zbo}XreEs-pmp+7k6oia*GyvaEoARlL`n2g$WigKV=9f7BBifk9=N&WG)_{2#J-unU
z>%r?l+s0{JRuq-oesR*7#^aGrBO!mjN{^hLl<pzJANci1JN&(>Fgo&j)3S0o<83iC
zN(jK?-<m*wczEMA7ET+6=}H)F`={$nEKkQDGWMYKH3%Rc{{VWV3^@6h6bMF9gwANE
z5;){hNOwHyDOcqL9PF#e=L^XE>z|4E`~LvLSL1$T`J3+ZQ)8y)z+sX`I#Yjxupo^6
z+M<#SAHCA0R_8m2sjytUr#R=gN}LnBtx#4cX&$w1Gr;DhqLVGIa6V(!r(e6xLYVn^
z2b#73+Bsg845Y>o+q#~#jrT`2U}JAi)Xk*Ho-wwj=88lha5*%*eBEkYxappi3kJym
z54}jz<5%yu6>SD1&#0y(U?G1b4wWzjgcvy7Da6ifmJ!Pxzs1t8pcou?s^~GZfmT!M
zD`a5Du^8#vs}&{5$;D6CJocpLX&4=8h^j#cJ?WiT^Z3<<8P6iCwpEA#bLuLEax4QV
z<Z)6c%)Bq~^`i&NW3+Xv2mpt#@X$2IU}L=|4m$U#Ml<(&)QY^ZE6;zu7c7JUgY>73
zp-xm|H1fQYgGg5)atBV8B@w<dHn70!Rh#d1In7(Z`H3f~#}yj^hC4=a%_5U3^M>P`
z&_T#J9co~su18*J4ma=yDURbt>~-%=KYV>D=Q#U|O)7Dmo|K3qE;gU7H1pE{`_Z)S
zJQ{dYmE(+48CAo3)mMK~Pg9)Mn*dWAg;sQ295CcjVWwsfHyn<JnbSP4O1R0KjE=Pl
zjesA!9VuAXn669iIWN|L+3((^k$zO+zbdMCZ#e1A77->!Pg+CwPtEvMecw9_H7G5(
zbJ~@OXq30VYHsn6HjjK$4oDm?-Kb7M>U-vuh_PcMJQl?+;m?0PyVXtP7t8jhd4wx`
z!?zVJ6Jqdwy*gBcAwomo`c_$xd5iS*piT1}H-0GCPAs;-<nn3<ATA7f6nXhv5;Ka4
z<N<PUMmefXn-p#c9D*^|6@zyu#GQWWt(%|>bFx3nwDDYp<hT+Ho~E?0tWvm_Gdai@
zUs}bTfsRjdY1e-;0?*HS&UsEwanRL7b~yh45J8)EeWL&#ao)WB!wCq-8%=uU>Z55_
zDngZL&j*_F>!nq@x?CK`a#gteMRrkr4*WFkj9C?x*qmUK$*g&oGfVRyYTCGB*B0PS
zceP_VM!^|9#bw-u^SB2aYpyb}*qzL2f!qN=In7dVIp=>THK{V?LCNV<SO6Ft{#CM(
zMF#tlf)}CbP;70F^W){?HDQ&$ZX56QsHDy?Ks?o4S1V-alb$Kc@cC>obDose;g2V+
zOeB%*t<|k8%Ez6o7Y;|Jdy29f8dLoW;e?R|TXVdU2YRb8BkaI5xH1q(86Nd_exR0a
z$Sz`zNnL*fp}{ADMtam!J<s+#nKj#1%*Z^j06$(oBSLQGPEP(sVg^pv`9R>e8LN7A
z#m&B<EYO@tA!Xg{+!0llJ9pD&bE=hPZ<aiD{AsW&vP=<Vz#E)^aHG`wRSBflr%`RK
z-YlhVE~ZpzF(5;^T@M8aZp3hLTE1t)z@Z=EtSWz#+q9l^Qb?v2JsL2i0KVU)aD^1a
z<K{SS)g+fU@2A_L)F%rZTMz+)7Z}IVvvj*?a8<&)r%qhG%_N=?t$35lyLW-^3~3{$
z%n)!G`k!8vS&hTRrtj63NaB&iY6dofa!0mLHCiV`whCbw+%r-}L3#RsUm#WTo|H67
z<=B5-BdEd+qZAE|s(-CpxStX@i{(;;9CfVJ3LSuva?*l-3bi64#gb(E!=R{W(CDon
zPLJVT^{hJG<2>FhOS^$IiX%)RRSTYSe@f-9r)lId3#lG8m=o6-9l7cSRFor0K1%f*
zP@n`|qaR9YI^CRb!9q1Xr&C7Jtp>56MRR|v%$B25^XF7tf)Hc^JClrlG^-udmY26}
zWgIXzq}v7v02bj_rvPzO0*#53Y?kgTMji8M?-c$lTX-$>+2)NHWIK+E21h27M`~7g
zCRq`9GA?#gJj5+0%-9Q5)JWP~lk`w_ox`c@0q;!(ys|Ky;+2h5%L>cqebazxj`Dwf
zzA`2Ge7qH@)ra;Z#e`#QfO0zXRNt9oARVBdgNhKj%h63b$&{OGZD3e;2e;Cl5dGtP
zz-77Piq46f&EjGAyPBPy!@2XA<@v=84&~dU3hB{^=AVD@4ZMDJQCdN6K2f=pf_vlA
zm{{;cr#T&JLcqU3aI~yREK@Q<6(E0{v3^5++K4pGshrv2i+~r@o|N6(j)3N&c4K*w
zA;<%ed7{LmkzvG(EZjPgAp{=8bq1j>+qpUS0*7Y^GC|x)s6jbiJ5xxzlQX!B2cBvm
z$>v9ra9b4MKxuwx&V8wXLT(&2!5Crz6;=Y;THQ2$DUvY*MQi1f#GjjYVaI<_-m_Gb
zbqMm=i!cBVd8^y+AkZ(;En48gHl?wFJe{MZQ-Qp_OHG*X{nhfg+v=wxge2ahB;2z~
ztrY0XCf7$o7$0y&L^I|PLyqHc>slALa!K(E#21ky?q$6aui6)o*c@X$0UUc&lC*c4
zjf31vZ)$!}@{)G+^z1W0drN<AjJ@9><E1yulWTtQ{{YqCjML|gN2p(->Nb+1&H~99
z%CI02imXq~_j-!7t~=b(x0suKGBwmLVn)?7Fh(PGIRKH{I5?!5;`jST>}8M7+xgaV
zk`;j+{b@_gT?v!;arLKT4`P&@yP7auFt~&@$p?4d&qGT0Hs5QTGnRk(hHE6K+DU)n
zrXC8AhZ&;CZV1_xVm33A6v2VYW7GctulQC$^BDcs>5AF&Bl|9x?QYm;!0YYCYMe=%
z`-a@1Nyro=LaA$(ZIQ;5p{JLbbF?0!t?q?X{@?-SVC2#bf++}-g|;~us!ejTM9M6b
zbAWpqIc{LDH*yzwTH$}lNeXYrO3<`@Aj7OR#m=M{=`#p~5#@}ae1jx_7kA#sJaieV
zql7`YVx`)jXF;>0G5qUjMAA=77Hr!V5G!OqAc4?&VzuK6126<Ko;W<#ZMahm+qVO=
zIRJL%ud6wb0>_0sf!4Q*v6SU<;_cmOw-lZGKhy6U$H!!nLpjuB&T=Mmo;k}g=W|F-
z5k+Q>tBmFl<~V0_3e7o0&gFbQ#YjSgE$0kL(dWDGAF#(`zr64Jy07bXJ)Z$0dMo{&
z)N<scYKI;zyXm-mBVg1!YFGZ=5827*gPXoY59ns2O`C-cg+;PTl;c#U<lAG$cTw+c
zB`L=z<du90nr0j0@p0Our9hMo;_be{!NU0hpZIG#rXMxzn;6&$srkpl7skl&B*^ys
z-p4&g8jnc8dXfKGl~ug`l$Cwpk{{emdnn);#@-u^e8r((?57T^X^~<CcG8|pG9jFC
z(<^Lk?Eb=tGvW)wvuDH_ZD^FB=S#Fq(^Q78fJEE3$rqB>AF**#rmuK8^Mll<YVG;Z
z@Hk5=JXg)!L5PsC+}?yLiD9*?-F#2QbMvOCcAo$jc{(AsufS#5nA|o}qCKn$?dH+r
z>qAdlQ`S%ydfp-q-WxxbeYDP~3Pm+q%K)sA$^dZxHf`e*Iw5!fh_?w(-ajqp-w1w_
z{<obmm8JOk0;$}@9};w05og(5$q^uHD(G)$rb4bY!Jl~`6dAUg-Bby52#fwNswpeC
z#}UcC8;?^}kB_THSt3p?SDFNY{F&X|=&gGrsb2_w+zf(n*$0u5TdWLU8PxdJj<460
z`_b#eMm9btgz1dm|GjyCo!8`=IN(J3_-$F!!rYVZ0yp3YXGJRH;d@n(vd4Fo_KO}n
zV9;3{r>z6zh3`YiagC!2PKp+Jt{IXoDk|E=|Kp=$4r_MHGO4U-5HMf>Du;tD(K`vL
zK|nthu_2Tl&#?CYi&-8jEb(jj-_mkTU>lX?LjuTYCKL^#6!~|Gd{b!+xAdZ*#gOD1
zwPumt>8i6Kk*Y_9$7@k7o8|6x4t$~TkE)l?P>k+mH*%NQ*GYtyfXdXNO=3Y@=HLt8
zj*lfSP0Rg-ZxXL3uBCEb{Ln-v84GhcdmPqmN_S-Ktq>k`;cwF1WE{6e78Xe8O|Ccu
zS5fymWh?ubKR!RMl-M};JTe_VIj}qctI(E8$(7QlI^$bbw&tTSTQeoYi{E6o^pA)B
z4D6WolBB%3R)fD69QltZ0^AK(J^Ty_pA~8#1Cgo^efoZfaq=EyJSU?4$(U*D`nr4I
z?|6Bf1+8&11G(AoGSwYdOXF^Nn!kTiK0Hh+C8KEzMl=Uz>%^G_b;6u^k59OG{@8eM
zPjO1%I-gG@fZReTZ9El=FxbILp}8PVvNb?;T0s<Psz#0_@O5^Eo|M5x548=w)dEr0
zW`REI6{}Wj0TKR0G>5)?Lp`gbH9mC5oN9FMqLMinu)wxfK2%Y%YRKN*Sw68H{Rk95
zZ<0YI8*-xV6DX@;IiC$I#4`dcqp;XRQ*~4bfeA4{2jMG>Qc&g-BPA={9-FwW0(|s_
z=WCouLBIIm?36DHH5n&QI%_>J6`pO~6%ZwzCGm@fTBAQxh4O{ZW+H*WPV!35t_j!C
zbg+VraQ%ZPpR|?K(#099k7W0Hsy~e#$vpJ839V82wogIL{m4%{vZZ8|Jsn)%<eqRc
zxRhZh9Eilu^*`r4i_v|x|F}|(3F}{-)*>0pnNg=iFv;t<OocG;JQhhX`SR*#fqdS3
zLexo><qPy2Ag`%y^ypj>r)wp8Fxw^bqLSteG_jax*xf@73?bBR-m!8Bl$B7!Ur=fO
z*NU7i5=ixEnlpp)doda=cBM&yzlTtr#g`tG`+;+f-Cg}5){QFNJdcD(>QJL|-Q*LK
zt7`>ATX$30_kR`pk;|czHf!w`(f#hUg>8bxe&{yfN=8wJH>`?`$bcNSSJ>SGQgL`z
z<PFHpNN;c5nK$OE8$nxI0$VuD&`RZyc_+#mu#<oTUY;q>zzF#!%bTjKN98$JFwtKw
z_UrTK%M|>??Kc8I4k@xj{K>z4^?_sPjFa`e7%F+(@sUsJz5wf}I1L!PN_ph^x1j;u
zV2O{_3U$qsx(D4$>hdYW7wwqB`cjv-lzBFSz8A#b5XGmNu4wpY3~DMn`cPdWGl>jb
z*}~sTymUJv#hsI3RQT=lC1un@VYM_|_g0>l5%P$o39tYPP_s4*KQk3bhqyIz9IjLj
zSH^9m6cK!%eH=AcbZ!+b4L&J}iA5`T7V{@F-_fQ!FGE_BqmFFMoPej81nOasc(oH}
zd7Vpr0yf+;<s4Gwk0{EGQ*f~3%qKt1a8*=H8ErkTNR~5F-&S(_fk=?L&bhD$6RCd3
zLuOfqTQ6*~a4Xuzv#3yKyVGppNf*B$#82b0+RL*gHDrHtp>mzc9%R-Kx>-2-Q>li=
zguHO%d1o!+PwXHY{_59o`u8_O8PVZ84lRSqI=ZR9)qgA63kapQhOo-$zW6SwSjMk8
zMf?{`2()=u`QW>dVv?%L?U#mMoU{UUU34s?V4OpbuZk6vF$Rpi>_)5pxHri<-j^`Z
zL9<KJ;dmJbt9um#qZpH~2%-VAJVX2Q&K*YRa=)d@dv%}HFW1D|LA{)m;r$giz+Y3o
zPi-Y^C8|3#oye76Iod=FSfq+4UN{BU!m_11g!bpeZyZp*q28NxWM<jl=XQ)6iH`5r
zPGr$CV1fQleo?Jt3o~Q=F7Y>ZW$4O$agbk|aKa}!#(eg$QDsN}Z-r<Rh${kP2Ubpx
zh*%=!j8Ka36uf)gMrurIH+jrU&>3Lv=rw%)<9u1<VbVfM-v`!;YKF#FMr`~bOnXV{
z^@W?yiZVxlYF>F>R>abP_wm)=u7u+I&bhyeaxVDXG|NZ)e6xKwaZgqJ)*-u;l^#wm
z#ym$U>}v<zi|{%VvHR#R*rUQ1RYc`H>`mtLYr|h%_Q34t!U1Tgt>jnTn+>=GOHU`y
zIL8l3Z(cRogPA&GPfH?v@)_i23ZW*pNOAAnF9nTvZMGDy4QnUMV=>zXX5x8o<pe<m
zf_orl<Al(=Jwvq$s!d0-`hZCU&R#GnDds%($jo87!gW8C4TT1j;?66VntE5HmWHx^
zJhQ8oZtrSHtE2N;)8*X0p@z46SdA`gwK7+~kT@B;y+E%+R;loc4JI$d5>S5YZP#8@
zygKhz=H!`F_q_@j5-K;o3f^?rrwytaNXbHA({yAuu;fQPa7LdV3ox59GVfK^(bZMg
zoBAPY96WIAdbIP$;D93o*R-#@%`H*aXdqcb!hcAmObA}?f=r{kev+M0Br>IvLT{vY
z=E`JMpM?n>{k$2<-gcOR`V#vBrmzFfTU@=qOiIUlt9LzSfI5wZGPbdi2vV`ok*!${
z6`b_lnXjCU>0uip@*#b66nW}3wb02lD_wUJcF$7}{V1W3yJaTYDLeL`;qFrtMCARK
z5HV4pXmPnKHgBoGVC=S;jeCxY_gVI>XGBRMN<f(Ugn*o12<01ZfOFK+C-;5xEJ_b=
z<`q|efwlqpz$2n(a2bN)$&1i?`Mr+v?rPtrGX-IF{bJ@~i6}As%2~apO^82skeOD?
zV$+%n4OU==eqn^1P&3<4!r%D^4M#&zq`Zx$JAw@YVWgISLq7CTuiNtG*GTcac8}^S
zQ_Xs&ghNX@uBlcjeY7rmD!==yZ0vTHr__x?Zi3lhp`)gZnp)hcH|(Uc9Gl%LkyhoW
z0xb8+9!<&qU6tNu94fK`(w%xxZq_*T%PA%ueIwu##o^~AOYl)3a&#`|q2a-e;Mc?X
z5uWPI%$J5quj=y4MqA#C!17G18Xtc4=~;q5<2`ZkzxA^&z$`#wV7FSStft+shJP^1
z!^DraJ^Fp4InCF>qdT5T<YywPdAHp~@9BKr4s^JfDIgZKCrc<xwb(PrSkB2T>)zJI
z5Yg7j2V%U4BIBkcSRL1hKVk?)qXK*h)ye1)X30n^YkW|jJiqs{_uhGvbhCjKV)|L3
zI8NLFT@d<<GjUIPGqGUJ@CO1*te3y?(`Z-{@0GPJHdixl?cCVhzEM9kflXEa(9HBi
zx5E$l_g$2ZzW)S|!1cx-H(s^Z;%}w0=Aa?RQ#@VOS8iw6wP<PaFl%|`oZVSc>Bm40
z?I3NB?at`!kE#<IumZzoT(ZT3M%@$lv~#BrO}3DNjaA~I{MmjeYlox2`$tT>8MNA8
zCtpY`@Q;C}dW7(Eic)?yyO83Meb#a(!>9B~1ZU3rYevrm`Q?~5-mbt=QTwR8d9(;~
zc9ftut$9Y;%NOGNM-0XNDHs)XRWkNprj3%jTg+C^gmKLvKhxu0_x5X3LS`_CE_l40
zMmTAS&qW-&Vc@kYQQt;Kt0~iLcEgSN^MM=auU2Gn>QW@~cmjsu8K1%KpVZ2@o(QIR
zevqB5IladvBXR|tj=0J)1SGiw(0tamd5fA&zR+<h{&=Oa1t($;Tsrw)b>BezP$^dx
z`1c*xFc+6~s^OoxRK9WIH{|v7wT(bf<;I2F<Jj`Au*ItFYWSTpwdr4@{>pT%euRbD
zO=`VkZB=yJ{l&CSp2r@va&&_+3-!p2(GL-~HG3|hyl6}V#Oi}&oX&{oA9a5F!^EH_
z$*b^(?pz<2SCioz35m0eG(ve34X>d@z%!c!`cE&z)JV9elduDGz$Nu?$h_4<mRs*r
zastE&1j~7xC^G1W&-N|edr%qW4X<}sl0;+9QXI|Ae0KYrqFZhq&ES$XT!_*9f5$%8
z8bc>ltpN0L=4QwHN^d36^EmgbG#v+w?~D3k)Fm!CH)1Q+E4S>~pQh(H#$OY0zy@IQ
znm%|KzN#|%x?pSBAwhGnb>BbAeX820ZijachxCWwzMenk>JXB^HLAmVRKwqYI)x&I
z-;!WLpNo0B(T*o$-n1*w?lZlBb{9Lb`gIz;;Hzz;*uu==6Eze%J<wa{?JQ{8wsi^j
zEny`7gXidffJ^u7V9ws0Oc}o7YhjQ=iD5OC$BN+fgSYgxrO*3hS}PvCp8oTz(m;Fm
zt)dfZ_4$rfDHD5M>a7D}P}!BEV1@24&-a89&@ccCkt06a-^Qz)H{Y%*IXa8u=PHnR
zsBM(R0wo5$Vf!eC=GwBzQc>aQAnGOmD?2B0<UU4%gu*vw*p@asY{Gv$n~kdk?SFE6
zqp;EVAE3kB5<@&bFrw`9s9G5EP#*D&&_fG`V3oR5ZE3mH?IT`I#>euUn({2-3h+Ey
zE!Gu2<5Z)<8q~a1J;Z;CXX{Q%SN-n+!+qZa?ufHDS+3@2!HVkVZBp{><t)%X+D8kH
zS$%AAbXIjVpoA!pdCm!m0H#i4tqeVfCq@V_LtExc0efqvCdGR^@{SJG>@p#kj)W|=
zr%%?w-;3{eC$l={c>Ao{Bo8z+u`sBe6gS-Zpgr4cZ}r!F|35$i!TD%HlBF*j0oWjx
zrk%za>jBaJa;isW|6k~+fhR^$eoEL5P7-Q$aZ&Sl7R`jzkq8&9Nu<F~){dDx#-g<$
zo~>s=#q=BdeCEax`k(ND;>A(zILU2Q3k8)FU+BwDD!@=#$lF?f|LZdg1vL-E->x6R
zo`;s~JzFNyy-5?)iIWjkXMbD<BB}8<(WI(gpcg|7)EHgi%x$m(E7#Sdl~T}#8gItW
z2+JeXv;c$pyVDLvmkp1PwcM>P=8ma=K%`ck0&B+@@@@+W1__xkN(PxVeb-LXhZW~%
zzEX*}WFPz__`q(M%K7U)O98$`F`86jS!~;9d(TUwtW!0frUt*+(^Qh5$@6#;hnHPI
zN1Skqu$=QbiZ97f*Bl@pk!kkpIMRb!WSZf}+vDN23}vnc()W`^RnunlzqMMY6)aSz
zeXQh+f)oiNQ}R<KbzrPI)WFq4VIMB;)DI5|b88>*rOgs*kqE=${%3ama?I69gu|ML
z>~{<3%p%MT96uy8UTpWp|Fev%ek`I%opri77;z-sUkBk#q!+H)^ygY1F`^1lZ;eMv
z9kOQW^`>g?Sv_AEgwF}PLVq9HOaFV^d=^$6?a$^_Ced@n)h7CUy-wa}SW9I~dvLCH
z&(pn`r`7fOYn)_Tin=%f458}t3P6srzL<6jY{&5THN3a5b^h-Fcu0lwPZl_OnvThg
z)tOZ4b$_^xi{}yY@8H>x*&G{o+-$A;O=MFSXuiz(>7apeBwt1m3dPG}jw;q0U&XEy
zIP!BavA|^ChUYC(h-C5ALo7KVE76e+J*E$QqdH4bD;@Gp;qQ;gymGzw{M*2e#i%20
zgOg8o%cN&1Tr=j5@;+Fo)&yO4u&>c<Xs(@H8#Oy$T@Tl{*$AqhG~%aorkSrYbV4Sp
zRI#NwNr8j5W?srq?k~AxaMKAWvKyU+?H~<hWaMvC&IUyypcY4MC{H9!IeSGpS9Q}a
z-Hh+-e6iv?Te+|xbXcK7%T4Ba)L@hr*@3cQ+c4@YEVix3(!k*f=(l2;n#0KC<Hef~
z#ThQ2Mol@^0HhYOvBWwSC&_bLwv-iY5N+9X=tQbgazT|cAa28((@P+~txYpY$;N_@
zbYK#DBA+9h7WY^29)@cO^wzg?G&FQ)P@KvC{R|{Rfra!OgP|PeRW1L^^ff*6Xwft-
z7l51-;1%vd!iQ66RMHerk`UDe2>_8T-tlx@(u?$9+T%K~#jh<vR`c*hM|nxVGU1Vb
zsc$op@wSm`V=ti&%2wA3&8?kgDh18LrfQL&SDy%h$@tm&G>lrVzmEUZmd(BY0M908
zU>xuEZ^%7NaV!xkAPeX-KjvWL4yn!(v*#KC)_UH3Da?fy+N=d3Vs~b{tTT1R1WG|O
z@8c7_p_Tf8P^&KhTIhV+nXJuur(a#~59UUa{OIbTbJC((D0veOerSGNyBe}q{b1Sa
z?)q~)Zx^$D>VJUJs_3`_GC$I86FBj=8yn22Z`wnJGbcB<!xQT0hp2z6`ObjOwI*dA
z--vK>7h31S9Q?h>#FTTigq4E#pf7QY0nlpg`v%H?<jrJ%vDUL;>zs9maJsO-s?JKO
z+C>Oq*k5{X*#&4%vYJH_k+d61d@2C)V&2k3nlqPhuBVTil%+l=01V`z2hG2<-)#hL
znSki%txsc2R*a$ypZ3=11sbHWf)xd2@Hg$yg_0vzd;-ILXaLp!0WQ1u(V?QgwpI-L
ztrs5evQ=X}8Qq1nd3zmUssVtKjELR%9M5D{-&Az9TO`YYv1d8rs+8)dK&l(X!MSdU
z_hrpWlg`B_5gFP#hhzfe@T4Z|uVX*h0P$|z`NM1zis|@V-h65IFSc4Q!HO83u8u=L
z>_8FkrYFVtHxaxGbE8kloKWEILCpG7-`90om#vG$cv<NV^O6jYVava*icaFkf=IYc
zxuX0QUqHkSmQcPn6FQE-hZZ#3kAyupSUcux7H&19udRqJU1p42rhkNDhf%5<b0s`2
zTVJd+dqhE=IQ^D1yO0)`DWM$i$u^+ljc#d^=NntDKXf;OBf7gw;Av)66?LiCZ-Msz
z&gGO7vyF+hv(CiQmezE61;c<wKN#1^fVCHwOGFMK_TtOM`fNk#J6>K*xy^w80OIRZ
z_w=px9y+g|uhugfUsnJ{Uz({F)!Kah`yKgBVIFr%IITUUHlU5A-!pj#2cXb1sq{Hy
zVcad-l@Is85q6o7q%$FIpFoW3K9k+*3C~64%#iArY6YnqkN68u9QMcY>$UfpCQ8em
z%v@`t!QlZumnZwLj$c|*iQHhicx-jA&Mf=M8+(S1SHFbaiw*az#FzcdzPFzJL0qUy
zh_>T)aRa}?484Yc<&s=RM@{<ZbQ7g0jeU4RO?<#-Wv-XbmxNb?I67ZyJh>46;Mu{g
z%(fnCa#C$b!~t$gp+YJOJ~*ElEX>8PcBJS|*Lf<vhNu5?Jm4O7*?b`pudaW7WXcR3
z66J$JY|n&Sd2hTsTcQuVygX8Kn4UCdF>sz?ExF1||ERtU_ik5=3mQp4|0IyKIWSkg
z!77NU`plZb?*f|*tCMA2(4N9%Dzh$s{c85pQD>&isX7*4C+=GPML+A^(+;LTPP!tX
z72Of)_<yu`Sv0l!SG+N%pd(rHwzV0C&!11lxsJyFW$c|S%s5gc|7tKl$V*gxLPz-$
zlYELCp=ewf7*eCmVt_)sC%SPIPsx~|#egLzZ(b!f3TFlUYPj?MtGiKdB)?|^1eZeK
z^j-EyAGP(?8kQ?7)Ogc4yh?1~x^9;8GQ3J_KBj!h^20t|v=_dHE}>ZI3g-9BU_+Dt
z8(SA6CMRHWr}cSjU&ak+%gAXgTD8pUONjhG>{$USNVL|l?s*m(fGlM7t>C@-ejEIr
z__se)QO$EVQL;y+)_vSFadh2x6|oRnSqw`{K1wY;s``}9MDSgGi^`?$rGb*eYG03+
zB}TI@2Y!_E!jE5{8@u=h)s~+2JgJg$n7X!r{(PICLhrj#{=8}Reb~-o6RBMeA;^Y^
zpox~vs9XpvV~Ixdt`hI0L0WM&VG89@&J5iZtxMlvr!}_(*V$yWwo$XP-DJRQ`~{gV
zSfSSm?Muo?vby%Jb3@q?WKEgDW<jjn8v7DP8e^QFn&7STABo}*joNR&Ghu!mx76xt
zt_9;uadaI4#nvq3^D3<??7n9K@fqI{*3_O(##^;8b)tz-Mg-;jW1kjX{n@jSGVsW%
zbw(srQ$g|AG6X}OcT(uZhd*|@MeP`t9jHhA@_p3jHo4Mi^+fmgS1gV7>-RIEt}IOn
zZRzruJYq|n+)yUWZA!gbSqKJaX-Eu@|H4Sf>=wdpxkSCL7W_(vO`4Y@f9k(BjEoP%
zLe?wm(8-??UUeZpb4D*usdl-<mHN~%ia^L}7m_tCz+vlVlzq`wW4+rk=aQo#bB(K_
zD?;hXpn2|Tig9Djd7vhZt;cdy51;fs%V_ZNfvz@Nz+O=&YAyzuT;p48H|23$%~&RW
zX5bi`#4c099XD~V7^rl=nnJK1sp*F#n;UnbxoEV8{E?Qf59df`UE4a}#Lgt@esXEK
z`kH=`r0!C<wux<<$|o&M9a>JVI5T1c$+!eIo)IH30A&?Pzaoy|0!vX-AKEE0RedI5
ze3EPi^`-pc<Sqjo4)?WLS;d2rV9JTu9Q-sWA$JDx=W~1tA5mB)P&X*j>%@eRuIQUO
zPMYEE)>Jh@F(Fm<<9z1J4Xx+j!boLTW{V~<|Mm<^UTs9_#fl;+zskAa6?AR=-V7j6
zwZt6;Km~`gp3B|0UTxU+56&K4HN8`%Eb;<AN9Df%+hiqvsvi-w6Vo_wIq|VLq!hl)
zi`;kic<bBPp|kofbU-pg-u;Nk7=fl=0)RNyKDF+dacew}!v89Mq-WW5LcmfR0eX^!
z2B=iO#nztT9j$(y)sb{GW40ufBru*tAQ(e?G?k6DBsr&ScTA^Tn8o;H&rCJ3EFfcD
zPTh!I{7+wP?CH69DZ)x#dy4RX$yf4<%9~W!#*1wobFEAI{hJ>=&ZcG2(l22@#5>-7
zrBsZue?5G&|K#U&oZf5e{e|^%HO@s1eNy#P81Ujlv)p>%d2i|$St_AHh^NX-mW8@%
z!0Oc(S`HiDxL6Dk4p#vsALqA0Y^3qQ5rs{k3c8+6Pmd*jK9Dvmjhd~sV1k{+nAL^6
z9Y^HdF>EsDY5%9tOZ6S28TWS1Y`nRt5iSeiIRCT%0E|AOg+3}&ES+QOF_<<gQjIEJ
z>;jx$_&_Ne$w)I{SBk2oD@TU#(PDx(^2kz)Ps)Iwu}GC7ac=#*n4M43xj(QzqgsGY
z6V;iHO_r0B{G4H~A+P$Xj4FWmyAo<w6G*G^dvbFi5Ne{f@BxiT9#WgHu`1ZgH6qW~
zXP9Or=ZX527M@fy<vgN>r9LY&Q74{#ur0@ikCI14j=h$OR;mud>MA{oq2s)+BYc7N
zg18G8b-f2{&->C&A7AcYlvA`Fq$1;Oqn~E5L>$yU6k<w7C(hLAe+%0eEtCYY2Tj~@
zH)g_<=UbknhNC@G)vNK5I0Y)u<Nm|?uMhcns(me}iNSU@=*1R~5B!AZk;=+4Y8L(K
zh0nMJZG_wKjumkBt(mX<=ZZfwm1pL_yz#l@K!A#RTLnu9wCCK1T(FefwXLk;QjHBM
z6CUl4IEiI#7JSL7Qe2dQqmBjSX~u%8^w=TfeXRF9I=6H4%;h+eq}k~!qg&XzywYU&
zsEH8uxlUqc9hg?oY^8DEfXDaul}#+c&8lZu_w@3juN?jPdRyfJkOBP1Mhmc)E^+f_
z>L$Q%SZxOH-7NdjazJZ}^5PIb9pg22>6OqXxB_2krE^LuSs?>ezGn-0TYjFe6=1N9
zaQ3c6-yLM9GIA!hzh`T#mtU9Ih(6|~;@SgW%O4>VOvk8WsK;PqJU)pSB?w8mEnG3B
zZISF5!OH1n{Yd)HhrLeJ41c1htH&i2sbG}9KR=3Yos%x+7j?J(l23i&W4G<3o>vNC
z0fx@XUChz<^1f|vu6om#Sd?7uu71$rv#}F}wp6hWXNv{zKZfTm35jtO{;h(&PrE)J
z7>YE4>oZ>RIDJ(%?!L@&R2V3M<BYbosJa_?$sS)M_3xxjR1qpXG}~p9qnv@{|9ern
zgj2P9I5f_BQnTg2vp@%#$3|vrcBougeEld&HwQ3W9@vI`Bg`+#d3~*w0=GGGT6zaT
z`wu<~ts1=24F;R3`-n&u!$U3(XNuF>T@Mpd%S!Z-ksxF1YYV7jLZFi#XmF}ib)JXv
zHdA1+%djr~^?KzWyIaSwgy(S96<a}>fYbatZzt7{9A;D_em(`|Eq+YukM;)@o=i?A
zwH<aG*fnr_vbC76Fg>$X%HB^Rm8J5ala+a!b+o$KF`p9_MWj>G?}U}RXfFmlW}$FC
z^Wk_0?BJgxi541gUU_fXSa#$%;E<_&BM4DvSQzBmli4xH<=}bVeR!X@l;!uAEa9W;
z8iZtZ=D_5Mc2|RO2xiY|$a<mlzG?U?C#mqEnNoLI8rv-suRgKv^;(h5f4|l2(DB^P
zx`jiZYYoo%Gez_6_Z4LvnVo&GY(_+x=+Y~VbpLId9_2hWxTdl$%Bjh>%wuYwc9&j2
zHT2D$1WKek2v|6GvjSQnhMLQ8E{psR5SkE=c}ak{*UB+`4P2KTM9tcVd|`ZR+|U~C
zdX-h7EHXX`L)u_;Z*%Yna3{c@p^1T2O`<U)5r93r9GQW^l^5+cQPO7FaPTWP5gNKr
zh$Dx1$6uyGX7A%H8&byR`r60!hn!tE3MCbUbNw+azMr!&Dj-bZqdV}Nv>|^Vk%x@N
z@`2`v1dThlQbfCqi{&$!S{G5ohuITJp|1Y?r1JYEBa0tHDt?eIvnjUFpx<C3_BmnT
zKgklMeoz*6*g9uuAlN}cWfC@E`_NoAH4d|qchiFh`S`}jl(9oW>HAzePFM!7j}f1U
z&EcLI?}LmovB{(PoV<48TcHWz=`3XA#U(1CN6LWt^cf?|OpUC3p4=T*KL{g@<P+JJ
z{b5O7y4)Y~c+^Qn)KlqSRQ}NRgY}1tA25o-3~`phX$`UbDJb{A_ixZStCQtUX_Kn|
zKCW4|Y2M!dddS&!tNc|s-xQT7H_A$18e|_v>)3nEiGXq*G{4%;^(ppIKATL)X^9cV
z6I2l)5$^F)QP@Cb5`h`80%4|V?MMlscZT~W{NwU6ijKR+B!j6G22S&Wy?9pRTn2iR
z;po*MjV1@~HmP*Yyq>$M4t&3Fps@1()-4JhpM~83i_fgrt#f5xp-#4p9x3eVPo%7F
zH%&(vjC+?W**@$V{FD@lwcyTPB~@)!IwQGwIhYkD8W^<9mwD#`eH5<$%!+Jy^cmrz
z-{Td~UsH;2n2N{&qRXv;n`#M(kNuyp9M_1zBg5!p|Mn4#0o-T)%Uc@9IUIuvm^dC)
z;?6J4#`{knFO%*puyZ56iPpUkXVUV~w+`n!kB)W&x#S8H)t>H{GOqVns&yC%g>vnf
zdbvA10spazl>4SGxGwiXyhKUC8@MTy@ZdW&xcX(3&&??I3>{%c9H?l6KcEV?dp+G4
zr2?<}^j7c~sbA7Qa;t~iG^D$B4<hsEhO$!`h}Ev_(>AYmWrW}~{6Xs5ij&jIRQs!<
zyW*>YH{Q-VMhI+5Uzfr#ie>p<#yCIY<-c83A>Oh~H<$}m_H4d%Tejt_Y0(9XywxR@
zonDrXJ~T?UL)-RnaT?!|Bl7yp#y@^FMn4Eb<(fp<kbhTId5;SLYt29I2Sl7IzRt}S
zfA|1HVG-Q9+qsv0E1Z*&X;>>=7O`~lMxJ(TYl5Y?&FIQ=4CxKjugk#Eqc9S>Va3LH
zM}D@}Lwu>4MP*U-9|!)1GY+5d^k<=|I^z|44I`=9RP?<Ry&<=ggL_KK#fU;~$gIQR
zX^LZrKDTJI?8QHZiq=?)gH2>gHpUQiz$#QRDgOIx$Wcp$HRqgAtFrF?Q`ItRXr<)c
zW>o9y%_yd`7OGt2Fj+Gc%kqeaX5^R<`PG0nF+SQu?#0rP{hZb-Y!uE?zx8Q*v$t=~
zpq2`M0(zv;NlGW4;udIL>)Q>W%YqGpn!WXPqE+~UY<^z9wpNx}Bwwj0p{&xtnQ^V-
z%KOc&-*%lWx<kW|)4B)|Zd~4cRI5vuuV>2bJn{oKcsx!HQJA^xLrG7Ibb`k|9^d`S
zCcc7Z+z+bMBqr6)b|IVK1xuGk%<;#y3VafW=)xC|1&QYk&-<dB8f0|7EB}C73FY+>
zdEO8J`<CYwj6DW?19mnDybZMSnk#dGs&(@2TWPC;*J?kJJ0|K=n#PPKs8m*%LM=Zq
zmbyfc$R&(Fu5gYC3|z{)qF21vv^hm>n;Lf5r#b8ig?Bk`922TXKK}j?o5<<msw`B9
zo)cLw`tVp)>8Vs;+rge4NAkaB=}U>OxT2h6Y8C1VNvQ3}q$_Mz&FtNLMVmSlGXhD@
zSg)rAh;AO3$S56NtiUQLm)#wxl{)h%ik&)(NXef`#TH%yusySCFiL;>=hNqM)3~pr
zQ4?|+fNnD9ZBZ`&;~8-_ktM#a`Em=i%9#=AwKMSiKFT&`kag-?vyowd=%&g+LNmA*
zAN89kRJ=3)#u<^mbdymp)1AXMLkM?V^(-z+Gl*4DLf+Mb&p161w)w$&z90&_zh|n&
zs66$x{I=$81!h)o&ra`mJZNR(<fIHtgE}UagTJ0?lhcd@8loX-vFGAFPF`qL#<1I6
z)O$l;TU|V|8jEe<Q#4lE16x`sAwT()<iAH!ExY%)gx8+UK)#pS`6U*%5!eDvY23=z
zK9GHrUX49(A_+%Ds@e$Sm0g+!V{w$C<--Xr<U;e^SpK7^!a4R0Nq70A&S~FREbX_h
zkxJZ47<dR(p6-lXsgb;T1I>R@?w%VSKFIx(z*}&m*2W&jC(C&|=c9}R`Khmzm$Bi<
zdb7Sck9c{bxuh9WzO|Uqg&1c)*HW9%K?JAFS~BBt1y}4*qzbHzDIg3;pUAjb{7r22
z#me#ZC&8MiYJcI-0mHUl>RWFnkw#3^XJn7+PvV%PTQB-f*gK<HN0(n`Po0t{P+#K=
z;zS!M%>^DGnw=g9HIn484ocIr|29oC!QmkDe5BIhC8hn2Hb_&f?paX0e02$kw{-&b
zqMz=vc}8dDp7X>7_UUB}I~G*!vqpjk>BskGVsC<ZCd_%hOpcNpae@&Jl^yR%d%wS)
z&<w$gKuB$5;7knqZowUE<hO-{#g-x{w%wa&Cn>@Dy=JcY#ExVAT|DhVozI;uZ1SWy
z%p4!Q``B3NEPlAoZbkdUZG6a%6ZCEm*FS1l_#yDo@N#@3Dmk+p^rv*fRf~#b{}-}h
z*Du}6Jh9lYp+r{Y=A;j6J-9EcVmN5NREIY2PPt_k##xVk@U6Zs*+~!Fb{~fuA$Q3(
zEQRs-3ik2uzwwSb3UqASNPczw@+6DFl?kribo%f&g#y5~il~dPNz2vn>n7Y1bC9GA
z2$WPRdgU~qpwK&N&Z1K8w%`Hzpz^)cgOUt#w3kpu9t_9=HyecK)3lc3Xg|t8jw=CY
ztibX+IV)(DYB3sVoZVbJNd!x?2`Oq<we3cEbKbd1LwE|OLe3ImFW*R%0rXT+AW-hD
zl4RBiOC@FA$MQC@P!BxLf)Wa0w}OEOQ3-)qomG!=D?OOQ4GqV`2{;$<t>cYSs;~<#
z<g+zjGr9`0a-y1%SjTjgNA+)TRdD6vFG(ArvpK}m?9p7L()$A=i%VT9k*O0|X1O4~
za+B!9U{QZ_<NQ2MuapbXEZBOKSqgA-r3*eAXgV==18y%AwNjd~*Y3*09T`Xv%F9m}
zXa<b%FLnFv+&kr$9_CIlyVyPpyVTrpL~kZ<E6mneb?1={1UhA$YbaE5&o+-e2Ed4Z
zloZZi(0}!X1c^1fNfb<=(<&v83|w}GVAnw_UT&5QQOid`TaIQJAe;CJCrht3Y^(5f
z<()z=I}40t)4I1~wS+j6ETX-MF(3kAa<#)y&XBt*opU@XM}^T`eOns@M5sTu=vHnS
zmM;{88l_Qg8$W*?C|4-<3t})GT7{+zc7TQ>_MRx1T>bZh^co7&ANQ_>Gm_N~4W{<1
zs`;7v^-=TZ4Xb?1yl>u>nd9-inMw^#ITXS42(!6tBqO+JgD+@)7jxk=;5nAQu(U8G
zSS7r$)-37jXri~Yp0K{pA21cmV@}_te+bGzvYk$G4t?v*dAf8$s)a6mN8d_n;mZao
z=F9PFSoV+=KRFAqe7ns%m!_mPw7M?R5-$y=@M{e5RF#Tf`aqI2J?v<4EWgdByzV4)
znS)nB(7Nej++Mo!%O)XRk;)SV)&?g>m_g?&O*l@3_W#(u5}yxRo>G|_T{_*#!xoy4
zFF$^4^-fZ9j7^3qE-?9<HrnBitTXv{^`nl$0o85aA9&8Q#%I>VH<N?|#Bo))-^XVa
z1fjHZ;ghNc0`yV+66VTrIh~i5{O2xv>!X+U7;~n`x<D0?M39^?|C6Wrh2nAkgQF)L
z`Rjs~=`iXIQNnQ6{_9Pe^lSC%4qo46UyIU740O-{^p-yF!#z7lF#13@{U#Gl_nwX6
zFI%U0hS*zlKWWw#(&f&4-+)K`>7rIrGhxF#^vsHpi)X=GE2(+>X|Mm@*|>B^*rRAN
zZ}l4QSgLki#=?)WpYwzI;T!EZC!@=vjDn2X+WSr*#VPY&iqE{_h3J;{9+EX(eBL1X
zc(`nSp_ZCX!+x?ayiY>2L@Ws#MRG??hO3P5C0S@aFE)O=OlVnQ#-D#I7xfaD63JcW
zbZetK1|L@}@azq75s(-23j63*l(k;wq_HxPP^)M(vPztM8_jLLOv>q_*Wf0&<&|LF
zm2e%$Z#FW)RMDDGKRchxaRn#~DH&SK@II+Kb=hYqG{<S&4LzG0UQYe8<4b@4+uE6s
zMP;uRiZ-_{HDrImwEjUc#(a}n(+T|0TD7K?mb`*A(ePemSS~X8RoQ@fU8gMxH{;Ct
zxzfxnQPpw~=h*hk-6_27fio4M<XDUR6~J%Fl;7yk;Lo~dmupm;@P$v=*!IT@<N&}Q
zc(ujctV!&}IvUL9_>jNnh$<hb(Njn`d_Vlbd7av{1>71m63I+!Da!E(7HE<)aHm;^
zX~yUqouPs%@0d6P&NhOJdjoSqb|&>`yJEO{kGIVJ17u-X5Xr<fNTFe0-|>W!EK@i8
zkiu9i3|l{bx0mSKC+B`^3rnmi)?AvJ&&xNN@#27>LpW%-L?x6VUU}X75Z-3VD01Dk
zxHWxlAF#r7?)3;)rE3G~`Wyv)9IKr{=i7!K?%i5L6I11A1|yn!H-rwba>UY#?|C|Y
z0Qwy}Mq_EeZ)0#1Y#Wsp;QBq?z3tlINIjv1W9!!Yf8#Tp3hxc<E_TQQarFb5bc@3}
z1n?HxbkT9#4ZiUSp>8B>a8*E7Ny(oH<ouUt%tsOp0sQctHHACeD~Xk^P+9-;iE>rG
zLuE^E#Pmdxd0c-9ILO+%<v2TWZO%6DS;tGi&vIswP<Q$;u7lY;0{CL*`*Jpb&1X$J
z)w`UoIq=20=;f9a;{dM}7IXrp=$#zHs!#y>?A1nu0+CN1`!Ay{X7t`LoW<OPg!vS<
zEukTQ+A)Ja!({EOB)d6;*k7ic?wAVu1CyH$)+aS%b0gs_&C*zx<F#{Lp>qEJ01j<j
z9RC3_3<DBpvBdXxnQN0@XM=gz-y-fFMH~o6CAi3j!zS)t_1@I%z#<o{HUq*H#(B|H
z7-1Qh^2a8!%8XTgE5hA}9=cM1o1%|`u0D_3G|miw^(ISP`rC)I!Xna+D?ODQbt&TO
z<wk9wTc0tu%5Nd5(D^*Vi{7<-nr&$$W3vtCm*O~N<q|aS;|<$Cb7F%GXG6wq++uF0
zDH@qoNolKdHDt*=%l##QF%c7>hE5ocpBkZ>#0*>ZO~&qxFiQP+GI|z2i$&(`1`Y8(
zQM>K9R+~d_ye;L~r~ML<x0&W$<)9YfECeWMp6QLaGcsu4<}8vArOYxx3!CSihE2Ss
zR1^zIe%$;iQtkquyJYrZwmTLAfr&)K${S0p=joo+7t0$`Hdt%pNPSN-nhK*lXEbmz
zpOnwjPZRWV4)Tw!R{DiJO;NA<V%<cZ!Lu_4L?VbYZB=5gB5|U)yc}TD^SHN;jTI&F
zQkN&hH)Dkqlq?x68d!WSi^Ri$n^S^Vwr9LPzt2FTKg$-PrzU3Jj0FHdi#eE6JehaS
z?OIEr4O6h<4R#L(_$&#%cX#Px|B{K$9^7N94Kk~gv^P`G11<e+#ClrQduiy3Wz1>_
zr`Vttm5mY8$4tVD7n8%!lGK1dP&Sd`Puo=wwS9H&I6bBZ9q^hvzQ=zgTHC3uheGDc
zZB_^YJ2U0k<6;)}m5|x)t)r+RM;suEa+q+xI;9<DB@P{>hoQer6Avq<bcr@TEkYYT
zr`1M1TuD9-p`4uWW`UeapQxHeEwzd(DZZgUPa)KwK!=uj3|z#wSvJ>Df2|E9^jRIP
zG+emar=esjI+VXKBN~6Pdua61U}XRRmqI}&eYR_^{j-^>q~<XKzR=_E9gf|k{Vwae
zZ8BEm8|FHK9xEDry^d$~4S29zl-tnKOxwB}fI8kWv_+k_O~}gABn{P?G3gnMBH!oH
zvauWu?^qa@#gZ&D2QS_4ed7F9WlvwjjUvXI0j*pZy;iS=IkRj&jlwv33JmS**}Lju
zc`*rkRoN0zvA}e*u*z#@6r-nu<vqiH+k~1Sm(&W;O_%zCo83c>K9ehN3UYobbrj|Q
zZl86a`d9FOrUkl`pAVJGr?2lA7oYXXs0Iy4g1$w<=h)r)DtdS%?znY6w1-t>dM+Zb
zZJGDcYET=g^@e=?;r>u7OwJ$jVZ{x9RccJ>(Brd$$Xy-f<*k(7*W0L@*`h^xc?`T=
zkDjoh1znZJsoW`X^A&UkUtWT)+6T`E`LlE$oS9OL4n?=CgX-cxg>NJqZrSE3$^>dc
z>}TJ77u-c;+odU3#U^Q9b55ElAj%n9dOqZuRF|CdYH`-2JGzHkEJ-loS1bHdL%34V
zB-vVsWFmx3uBDJ2Q-@W?c)KbWlM4h#)Y7Wa*cQoq&<?2%7s1+&k~-L|y05LZ>cXvI
z^Of5x5OQU0#Y66)$%s9~Pm>OdJw9!xtXc6W*>3||4k|pBx${mf2ZD5k9CjCN-{t?!
zA?7K3%Mm|c?AlxVc9++ma%9RISnNqN{1w*tA*sc;dGD(7er>G5GG_@l+w!wHGgU@5
zG_fF`Y>6?B&NWb%U@?hHM%tBvQ$8ARAXGEr8ip&5qA<xB$d1DbPq)HlQ@2|lkG3V*
z?99vUR*FZFrv@mWjBqof16wK^jV49fBI$`4_8!Hk+xJ}&4#?ws%R-P5WJc|MR~bE_
zRjK`s^&ArGp(E9Z3-Q1dS;A5_5ALG7^feGRbK{?cidKTv#fvE#{tFd6NBl5I-W5Rf
zI%M9D=koQ$=UvaNjWjGa))k$V44BPDPtjpC35hoyEQJ5+{9(5<qh<20)wxW$)~IT&
z`;xHfpJ_-9yHwvESKpF*flesV?HRK0>85;hl#yh+8c6J<Q?dMpw+@y0bQFRvlUlfS
z_n4FoeJwfO-|0bh3>xnLGYQ+pBTb$(C8c4l8F7LDYD%+W=@XM&ny>w+(B{thHtj(w
zr@6M>Qp845DfoP=L0`@Rn7Zn*_%7Xpq^os76=SDLgt_OBXv#-A3ETF^1@*jV^0aNX
zY-_ZSvIRR21~Wc`GOV>*8=~)*mI&LD7%kQU<mX>Q-^`BVS(>Z#ef6kLRZPJk&g1I&
zuWGoy!OGtyn;(f|e8!Ks#iZy|M8`Fi0mq!;<{f{Vs|k-lm2ls8^;hPop4^G|qq_;Z
zJf-DSz<#iQR~1@ao4+c!;=yA{&WwxQb+s9B5&K*95y*M0W;Wis8%^z!)~ZDf+Ep@@
z2*M4`$EnLD6=T=Ihb!-er8n^`%aW=VU%78J>QNUr2J`6MS6z`4-XrvLIZt>b%N)92
zo%iGBE5<Q$JT+#l9Dyl0>oV?WLG<!3^~Y&lvF0MWsru_K@zl^lYNpF?a9!ZO7#46Q
zRg3%jQoPJcZE)i%diFeS|0bC*lr?l*N4AO#&jz})$amMtZL2vOokr|EzHVEGy~l8L
zgXBEtqXlgME!G$pn=E)7S0x)R_w+#K4`F1s=r}s&Qj9H6>$d8ly@-|YuOW!tld5jk
zoReD1=+|~dKGY*Jb7cGa!jYp!OuXd5-hG9b7ERtv9qRZ0Wl&wxA%XM0auDLI8&G($
zMMFNYi`f-Lwo8!J62_$dGDu^U1)CiU%c<r0Mn1)!v}G-tHCa;nkzZ^5^uG4anJtSl
zAO6U$<hfp;?n>qLp_~O^(O^|y#!#hB`d(lk->WzK+Ls}uDj^!u^Qo8eg=dwvA1tTf
zrk6xaSgp{IgusTSz%Lbzg$B#(JmR0Nv=#?21D<Jbf1xC+j+fvm$dyD)W}clCkP-yB
zY5C5B^n|C=)Aq$!$3gHZflV$46s4EME@E^*kB=vpSc>!W&Y62OZ|slp>2_C3^hr`u
zM$_UMmi`5c-@}iAE?F-+S?2IMdx+MGe`!#0QAdl@2Wt5L2PhDd^jG0Ay*D4d)T+ih
z7->dQ;R!2$wb%a6>s`W~8;tk3O93c|bs1ENP}zw>4RAZBr;!B=%7Nhi^v)y8-CO2z
zOv(gKG3F)SrWuyqrwY#Q3iekBx<dEvGf;~L=eMKd^oF2?YZfuc-pp;)y!t8Gch|zt
zw9&8tRu2nI^17OJtF!k6`Kk?z_=1QHclW<$<x4b+m-N?};zAW>uOvN$8%(W~1bi6=
z5g^2g&Z_fLjowVeW<CFlMfzczf14k}z6EXAOl-VJm`jS5Vgr<_ZwsZIk)U`hw?x<L
zL*;aVX*Z_s219<m!9NiiGuf-mHB9;!EQ%ItzJtU>bA2^=tst7#twMTPw8g;S-=$r?
z`1h*>CdD`#?8(nQz~o*xaOLmRcT(B&aJSAC%wfeVtL=bGx9JeGGpVmWBO;dN4ZAl2
z<O`d~i|j(wS=2`;V<4-dHiEGsDO@u!4K%upw63m5YQzqyx#xuBW7j^D$byM6gJ}HT
z25*56=DkJX3yJ=GE!|cMv0Fdl$By1WfQ5-}2H0&tK(h6_!Vh1qPcg!Ub6{w$Jv`R*
z2EAdLcuf9;cBHKO3!kKa4YK3rg(^dUP(qtkLX}h0x30^lMhi3?bpkZ0T(TRqtt#bK
zw5b3tutKN5bMo@maQP;`*mpUjDKwaXU;yn8a(BVgBzQ^*#?F{}aZuswGUqcBM#2MQ
z8M>H)(j;V3mH0L$nRU71Kfq>H!O}XR**tcY9zv)U>DKE$its<K0!<=QeDxSEkNiR2
z&6G~9HC~m`h{)(93(eyST1U=JfhvEyU5QI3mZ^Qh(}tp4d*%X&xs);Vl1-R~>)Equ
zfxex^vRw_=2*;;j>dKoLFot|sYzKj+eDHaOn*an+t60R~4ctt5Osq%dnW+kEQ5RnU
zAga)ZZRqg-YAbE-lyy^SqH9pamt=!+W_rIYnr=v*{}D-9C^^%iZ840jzAYM|4}tI!
zYuxN!8}GI{WDSN5p%nx9+M!&WI?_v<5B5*1KjE5y2{RHynE3v`1`iuvFf0ZR9n7`9
znp$#c&MWhOQ0tPEQ+yVy(IlUH(-POZW?(!Urx6q$!Dx5Ko0LM0xV)BZ3+%u8%uY@*
zzKiDK`}wzC#C>KAs~oSxXDAI--U6<BIb5X53r`^BHX6M4K}R2?oMOOrlV5PB&JEx?
zb`#BZV0hikbW0l7*Ts7F_>bHVv(px9_FYuC2E2v}MokKHX=^2!m-Nk>bzNUOW7#Dh
z{=x<ml%}Bd+=msBsi_W8L$ulaavoIB<)auO;SKB9Z(_&7?DIKBy%dx+O7^U6LNX&>
z9c7^#074p}&+m?GS&Ln)o?V7NYSYzvLNjEHs^(b$?idK1xm-x-3GqCeX^pXYnt`{8
zhB5^LhEQ7CZezh)=9)o2k&CI(-0uq!CZlH)6oT2YJkJ&d23xg`HdD%Cgi%#;W&GT^
z!`D(O3CC*dSsalC%R?ONrv||C`;lRq62~M07J?T4YHIsHz{nrbUHKWVdh|Z^6aVDz
zMswZn%9j<B5AZ)FXzHK9dxUR>eQh&x4_mc)XOs9!|B^8@c9lI@BJv6BEU$*%<LZ#8
z-=&Hy8ki{0w$1I%jeo(8YO%sNe6qweI>#M)W+gFzFG!^D)xz<788&V?nUf%n!_l8;
zRTDIw`x$u3g-9<7eCiuI)k>xN(8NNh9Rp6p0(iu0s!K8cQb08}l;eBEK7Al@ej_U3
zYTc!{?9*5uoi@Pgy4o~=?qQ_Lo|UBL^OGvhK|g^H2Z)uT$=OJaNSio14DR%WPwlCJ
z(9aTDkAVCh;h;TZfK-5ex$I$47k2hD1nn`8yOK_WnR!X0ZYn0(bYx(EE>6QPJ}HZ`
z^6OS(tu-@b3==6;SzMa&FsWH*<7G8=dyv`wPtlb!Hl%B&h6P|Y)jkEzilx2m66?iK
z?;&F`cLvcyW_`;R==Z3!w=!XSXT%aiDu+|tRu1H^F7eR*@`adIf45jCUx%p#IsksO
zQr`V<Ys(OUo46s;5B8%@-~62rT<eN3y0l2~5HTRps&$uo1%&%P_E5WKm9Fa1rBKId
zD6~Z#97Q6&mUH|IkWcB*gGcpbxR`ed@k8J4XV)5~rOlSB@ui+)4(y3VG=cdBM=7Zn
z-;8SxlZH+oClR`QS6we8L@dz_A6x=_<PAF@n{%xc&odix7oxqepcO7<2)+$|Ym`Zo
z)XIaF7;TGj;9C}0pJ~ARhkUB~v@v>Q5G-MYkA;w$_sYA$A&@`wZ%PRU{F%{mv}FLT
zx`3LWOS@qkgZq~`$HW$nx8~d7SMJ%L!f>-)!C6)^ZbAs|ShL4d(&$_88!`;TDs^?e
z9__bR43d_ZX0cD6P9bM%H$)if4FGl-e!T_cgOEC}QR~gVBPKtd9Y5!AXSlbzxJ^_!
z>}FcpH<+AlPeJYH@`v3UV|;>d{ow<FraVyhch`uv;@qc6S?hS48QEd(qcqzhUh9n`
zEUA?gVl6&A(HXfLf%a|iZv|w6D+KKx<9cc@@ri?fWJ2}dWoE`KUFzk_r~5-(znyFb
z*s|~th;VsXW)jtN;F!Z`2HgcY#*C(-i0PhD-K)0Vlh%cW8NKjG>FgcqN^sy8?Y4#l
zEpy19Y3lVXZPe)5kS>VZKmK0M{I`&L$k(1rTGh#F6lO}Hn?_pPp|L7or-_fgwMB5(
z$_quXgqP7hbxZr4pwr-EycXe>hbzh;!yt1Hf#LjbHRb}PR@oC$-LMAf{m7ZTGA2wD
z;4-0&F4ft+vQ5LEGwQ6tVqtnMeWsx6;gq68RV3jtrA<-zF{KW%XH^BC#Q)^RIf~`B
zWePv)k7PjSzqNwfR=BSjS`vfH4Kv@QW>WiDalnNjML%6hCQsy+^;ku@x|9sd?i1?1
z-pdM*5F|w5`dQlmBoic5e(ySK2KI@{oAYAj;c$iTEG+T|CS$at78oix8T`DgC|#p#
zE9oODl0EHi@{MHTU^g&(a{Fo?_zcV)=i*zo@er*KIb4{_rCFudOtK9IYd%xdN?>8l
ziO`)dvrraiwvv7F;?qnH$L1OT^!<_l{zuVSxHbKEVR&>%NIE*DRho^?0i!!a1x5?V
z7!5MI9NjnuNSAbp2uL?l(jX%QBqT+^-@Er;;JWzkbIy65`v&+nADgdX=8EW}{sU<3
zDQ4ow4pV6I*Fq&y&vCA2C|5i;fQlD|LYOX@<$qBLU-$?{6^CB$?iRf$f@tkjh0~*{
zMUTkxN`<y{;wJsgTZfTfmZNMUWLVKA>jI6@PR2NqR4o_Sa_1>G--6MOfNgQbN58Yx
zn?N2OwoZ#8y*C~FiVgspg7+wMimMqG$f!miD`FwnD0e6Osv}LAi+@MztDAHa?~wF%
zQenc?^F^SImg0Evw$!kj9}1R!t(O*CQPM06;~92NZ1VD>a7MCUzUS6%1KW6fT(}zP
zfBKaPlo1(jGgm*>)q}$5zkTg8?495;oNv0+?~V5$VJ!E#(m~VNRc+<0=lsZi-jug`
zftQa|v(<zE&?I@CBLnN<Gz^kw{`r)~(vwuyTUf~S=KZdM+(Lu1<fi>-mD*ibqV4LS
zSW2W^b!jfCJPcX1Z)K9y{R}kV!Dw5uc>(^FIF<R+fc~q&#Mxe6+9r+s;?&<sx3W9N
zn@;nJU*++}-;T96DmkP;5}sg^NV7J_?Bkiee|c0HzkGzEd$u$C*x`A>?q_|0IZ|3;
zEFGW;EnuKp<!)x8nfjQTC*DZq!?O*)ieq<-RwY9m@EZAH0OBu+$HbcOVxm1l!px{~
zY!X}vyxWY-gY2(nq!_G)X5@l&J&y(ia6jzj<?_?pfsuf%@Kr;g`j?}*nUF7Uen20j
zGFSPs?jUQWbVEamN;!!<m8TRc@zWkD1&7b1D?P(5CzW8|NLD0GaMFG)QN@MRrdj)K
z%h5fe!^lAmsSGB?e*$2NRn*ZDlsxA=5`9(nh>o1cuA^zk_xiGgGiPr5e%)1>SPLO7
z!S?_LDzbe0Vc*|@1f=*O54fKC5jb<jYK*4!QX<gn9mW>8!GJ0kCpz^}lm9+s@2&>H
zPqaWObTeVhu$24h@<SsJ-;@|_hK5<Ts+H6Rq;fikjFGOF4*pCBh(HNyf#39Ov|9-z
ziN2Aqth^f8NpA`IJEIL;giByi&ilB~;I>PRb0jB%g<XMI;%@(pr$(U1&gu{0xn8oj
z`UY;UVs~?P4){PpO)#5BvAyi*OBjzgpb^0qs}$T~>2*+Wuo&{0IT6vKZKvy+Rh)x7
zqPfRR#eK?P!ex-89TQt+z@#J$<YA9V+@p>w-xvM#cBLDu1d@8}-R}=;2uWXF-c_+C
zme*P5Mgo-ldl|?`(lHmK?F`5#)EV%+)Q6<!EfU}J9;UDWQjIIT4Til8+z8ha`rGon
z<Sr`dX^Vv;ljhwuZxeepS5LGP>jjZw_)7zi9-C^Ib96F2$^T4_dCaaBLu*?`MXA%E
z8#ht#NmOv7|33haedcJ_@Tp3yi(WN5VCYaMO^XRX!&BS`G$Hq3w;=CbggNC$03SDT
z&|Lc~;gjS}y%E90JCh+{K5l-pw6}sb_8vx_)FgS{dj%<TsU=QBCU05>rNyg|mGZ4`
zm1?C3F)wwB<bugn^|zE(lefVmQwpvmw_OJ|4oPw*`T%+Vl0`8bS3^q5{|ye4%{i6j
zT`cEH@-pUK9Dt>xQYp$d!TFUniP`o=DV&-k00Gq^3|ViXk!McK`F-wRqMIwmpOi0%
z>S13K;vO1PvW{w447ItNn-N21#Ot(@aOYUX=>M3h?!=Pd!aYWh+|jAm!6sU})h|@s
z^k2M_8JC@F*mTG8OX=yn!5s<UqGCff2x|chBM<$768GN%gt_Tii?;UA%Qd&TK(4?O
zmC@(PKX0ZOLb<LH;ihzc0c$hO#Ws*`(FtcBt!#VB=C^VSQRLoBcBV)yVU3d5WUzS@
z)So)L1;+P=-c1=mb0%w{Z4dk`PyGeV5RG4X){vArw+QhcKskp`AoSi3xcJFh;+Y;1
zV!NTgJR)<76`k2$qi2ibG)ZY3j+hj>g$_AitqJ-QO#6Ry>K}vS8<_u;HT!eL{S?68
zWuh9)M=WR7FU0+7EgXq!iZ0HGgbby@&t~CSKajF^c1<Vj%{y;0L$7~8cP!xm3J0Gf
zJ<iNKO6|cQ-(Nz?#CRgavgB&&(87<3w%Uj0hIU#+pM3fA;uux~j-bHM=2&|OKv4#f
zq$jh>pKNVda;8FXDJ68)1884a4i8)AmY0UlO;_>|3xP<8kjc;hR2DcD-d$KpCI=WM
zSPmzBZz_$SHDz)ysKN)i`IL0gyXwrZAlOIn&zg4er%>t>YA%1g&+LJhmD8GS8OCZ`
zA0D9S#0iqEgUB9i5}+;z%m(a{=|PlT2l@f{it8EUUI2d3c3y_)B1yNk#sI)ZMu3c`
zyc8UJ{I?G0|0sLFks;v~=6<IKazC4#=?cObTGYAu1!~3tzvQ;ipv=(I@`pN*(9jHQ
zlW^Q3+Fw%AEtfmJIZeU@^886ARxy(TcJE|57pdqBH=Z7YLJ&jxmz=zNyDz({@?xG`
z-_GIE9d9<|O{3p&fK<j`B?^K~dyOv3@X61{L5E14FvGjAVfC~@?jZh;t`PCy-|H!F
z*Ts@&FzviQ=(=a3_&5aFI21Eh&jQ>6DS!^oBxf-JRS)0i`0$s5D`kqz_u5KT2mEmF
zViX1>tnqaqh7%KeTKG^YipuTb9-#-}x&9EYVK-*HZ5;nJ2r)O?Nci^eobp}w;iFo4
zXMdd2x-_Z3s&8xu2eGy5mFx5`nHrl8mFzH%ysl1A8HIq;2{?imN&zqy1E@g;$ESRk
z7lW#Zq~K}8PHhtYauw~!=DYj@gKUC5$=U+p$mK8|qwm`a8cKhrMq7Yu4dIBH9Dj#o
zu}Yh2S}~4az7<K@BnmghBsj=uYE#1v8}hBIO-OMJaj3gdJ36f6qAF^vqdml_)aDnU
z$xzYQ>yh*6ZgM){<kjQ{;j_qH_U5pVi7d%)@+Ak4*hp-?8SO>LP=69A6J`$uBF_EG
zN%l^jK});$|9tCC^Jj0loZ!gkb0J}06TBhB<OeSVq_`gl8F8-6nd`2LWDbq4K0|Jt
zn3fRi+>r3JSUJ78H?WSr+T6UVbgEn&!-(Lfebdm;h>n#NsQ~Bu1$_y$h0U!WM+$S1
z5Jh@JH5js|C)+B2;!tmszqGOolj?K?o%3+Ty3bdSIRxyo8=vY+SPC`v`ScWT%2-bf
z4!xCaQ;^Zi$f2Ws_O~AScmCTDAJQXs;!<iaNMm?|itpm?u%#^(%7K21<Hl;f0JBlP
z-}PlWnrX2K>mr8R9HsvUD8tKJ@Lqg#{W_^xe^me1YiVahZ=dPYaR*MPTwx-?KBs*A
ztZevN;{0BVpMP0ehv!3c$(x|<yn-|cz46hFz0$9_a20(L$r-VX7z$6LBU}&#;4M4n
zk&orPELtRfSMWpf7w<6%vD!#gn%C61f2EGhcrdKMt)`!edLlKUB#|+~nMAG<F&;pY
zYMANn8<dLIhnU>hQByO1e3P_J0yXY`roY}owIzK~CPCZpA@yD+p6_bxt>EuX+|6fB
zh-&>_$XA4(I=fUyptVz76PbGLW{O;UXkO_#is|+%wYhmUFw<o3(%4Tc!8!EOjegm)
z9x(Xt%iJJ^G21}>6w0iEMj6po;Ksw!$S=%28Xo3{tIbu$s0+1oqSKA4@<)je47EA4
zey*DD3LAetC9&B;6EMnONHG^=S6xi#amby@&1KpFDf_}_yEH!IBaz-4{uR|EaxuyT
zphH6tnBy6Jo*-3X&$|99-t?>k|G0N=8x5vQ!0{_Y`KQE$sOZz39Fqr>-s)CUZZ7Ng
zs#>L?hNr7_qa+LYE%D0_=z6yDxKik*L^9r+jPeftYq2+rQZ5X$Oq#cPA8q`KV5Vvt
z#lyQ}5pL8NK{6UNhpf%-NqS#NHfpeP?aX0KYyl#N1Q3*}J{P<6<dEDWu?2JP78<J;
z1S?6YxRUBy+T!fTko1QsroI=I2_G%oFrVlB{ypgp{Rd`H<3%MGaQbdC*LOW4r>BM%
zceHh^Y}8jzi?^V=JCua>YOTfc9=SENn{aY;9$8t?Xzu7lAwwbuUQ5rciYKQt9hr@8
zfmQl&<<&B$+~GB~=p2wdDiWh%H^S2F8M90bl;3nd{kU+vdgB<!>-o<tqn`4bqIwZc
zGod$uRiFmXHUEjwj{B63ws_=Q7L|z}>=RN34g^1$?`)!8MQ87E*ZV%uVnNlhvJ0|6
zoMYCO%6NYuo4$11zB872%1elt2s-+gD`+)p-DYwQD}{ewK*a1oG_7YOV1CZ|BP_z*
z!}oC0d_41UgUgQ}acbgnmawfR-uRw3x$wwI;WBaYJg|20jb+?Q_=JOvdgz-JpO1r<
z|4dMb0obZ$#8QG%=bhAN2k%J|O2i{^C$Z~latAx4FlG7Si>^5%oPczL>7(D)v)qP<
zw|5J_Q^!Efh=E~mV4Jle)@9qbd{ymsKlBQL$;>+9?%2l4C#(slG(2U=8|~u=2xSoe
zl%vVXHlLI(Xe>WK=vPg84?58<t^($aIk`pnRW4JrH*W?qsDfGijgq1D96La>>)o=!
z0!t)Zgzj9BY7JaTAhvRTRkZ}1G=K)B7xcC8v?ls;Z`G5E2M*P0J<q_-RN<3?K{(cN
z@|f;;kZFF%cge&t7CAG^Sr87@k!hytzD?n9DMhs@fg8mrg&Ns9;Lxwy+=D=F(U$kF
z{3L9y<)e?`yxj+bIQhoG!+tIO8&Q2RWV(rf8cRxQ#G_6_V{UuA!THi<RWRkCret9V
zy6(3h{fxFM9%w>*Fa_Q_6)G68-i-){wi7!1ZpHKv@donJ%F4)3%cZ6e2VImQBE0AB
z`#5pdRAnQcNUqzQLR)<Il<aiHSED3#U8=Zz1r;V!l=6#c#di8kv3z>^Fo+wOhes^?
zODPDwaj-(@)$uPQmxY>sU0l&l*Mc?tu6%ow9j*sDr+2{m%Hze{WB(C<@Qe*t{wVjl
zLGB^i`)xEp?8!M5W2!@{+0`&4VE9Bm_-<(IA!(tm1!5bO1p-zbKtfM~I=P~YQ6ie*
z5&GhK7R&1BI=82!`hF<ELn!hF2v!i>WG%>U5$rKZp_T-M#l*5qDpy=lJk>c9+yv+Y
zy@d>wd{lgU6(}F!^MWAwq7d0UZ#e;em%)I)GpsRo(TC9ILb>_~=ytOu?OptB(aD75
z@vSnSQbrvEev-lZgmy<mQn3d&*j=d-^yK?ODd7>kMQlK|d|N(z2<etW5gy~IWc|RJ
z%1kcjm`%=94_)8)_8=%tDSk+@{buTA*H7X>s{CO8O4WK)Drnn>K8L7hQFbn8zvoan
zuKv%PjI*^Wujj)mXGyMIT|awAz-%r|e4)k?%V7}Yrs*`9UGy*4QStS=-^P*ySUVg}
zP_yE20dq?rO3k&ug6vWs0(i+9*T3f_!rR8El-RC_L-8<sc^{|Fe1{f_M0BXiF=hFv
za{lT3r7(RrK3<~9zzUuEm0?zloA}=D<EC&u9zorljzviDoB<bZGH)?Wvk~JOvaUF5
z@Vl9Uw$LSf5maHc8i9?JN2Yyd&(x!`!h<b*<hK>Gu2?)pzP4x6+_q9(G{_A0sdfXV
zX8&W)B(z*sG&{7QdBu6e<|;uCja~XQKRk4Td<U#Bg5a%8yi5!=+x9uKYIUVIpi=ZK
z@N3~FaR6&n8C9$oJS%k_RHzn|a8Yl2*uz?<FASwQe@Yy1Q6+}=*|D4aTNo?GKq@Nt
zvr(-}xmWKlvQy#dBXN~;fDDy&$7=@MR)f`#;is&PMDv5_ubT*)#voh{#1G0~K_Krt
z;6p<!%BO~E3mR`tWPHpA;r;7VtHF<h(c}I@?0bc?r^6ya`_m@xzyw)}^G3iE{Vt)I
zg6uL-g=58{cUI3NF2%nq8J}1fgvppU7u|aUJkUe(PYjK_Qhbt+PW0={I>t>}LWV3<
z{tw0G<^%4cd!O)#y(F<y>tq7ppy1@Z(bJ03ZBpEsq}nTKK|yBHJu8#?fdkMmTgKF(
z*1*D###=k_<3-8}2IVc5#9XvTYx`*XY60VKp63994|%~j^GFZz#%P4~V{?}G1vaxf
z9HPiG!3r|-n}Dex$W&e!yPmO{R=VGu_w)2==R6H3iuMCd$wYS2@%{#;O`lSfSjuV8
zrR0!<rD@8itl?oSeET1REnT|+<-Qp{)RWj+zYAfJ?bet|HaTgP7bzW&HTtA5Lo=na
zP{#dCG8`Z4sVQZp<H;emJ@?sxc3fFOfDp+P(sm4yfuE>2J%*5ey(n27G!A`<t5w$^
zL($lzxtiCs$}?d~ZwHj%ctPmANKQ2I$wIlt2tX4fJ1de;HuR=*alQmlxLSwytAH66
zbA<y>OsXmOPJH)`2j4-tVZev(U(Z~R*u{F~jes5pR<XJ$)0OUk9=gP}eexZ9q^#Ha
zCFe41KS>B87};}Z6q56E1Da)wPwz9Oe{qUvb_dw!CXs-OfsXel`zq$_8%Tb(%68+I
z#ZS(|n|&+iyK$B*H^1u-IAWBk`%l?f^44k5_R0sSR_}mcLP}!(VG`e40O_ps0!;4c
z*$BD_N1GsW4bBdtZrMf(r8RdX7ClpcDV(WWN0Jc8<AQBb2!A#xz*C0MDuE!9BAH6u
z0U!oGU<JOkl1!;QKV=8W+C`-!pXtc?qdj-~QVK2Wl)~O|<bX0c%W<8grN5fE*Q$(l
z06*C|RhK|7E=#OI=(YNUlUPac=GG)&(^KKCz(2gRx|bP+cLi`)JQgGz^SoAq5L;2%
zLzvq1r;<E>BCNzd;-e^C7jf_CUz018%&4G68ZHJS1%8zoKu^2${0&K@uATWJWfzgU
zA>-|(7B~*MlkPJqP)RN=j)S2Xd39_<)Kb$(=x6Q&72Mu+tPc6RIp=^5QQsFkIr4b4
zz$@2NYvu6}<<%g+8f2YV!2RN+L68w2wf<#Po2*?!BkzrcNIS{zN}0-+L);CYCuMOZ
zlUl9Dkld-D_spxakNuvFE0ITqHy!_LdEr15!xZE@q0_m;AroZI?5J&coE;XL`Cgv<
zl%hw}0$iJQTk<3HN{Ec%bHxo)Z>8JrX(cQ#{&A#<uJF;ugdeiigt09;DzenRG31P`
z`Z_r8ZD-uBl2|YNkLilqbg}iX;~EDJH=DNKi08R{j(dd+LyKAzzY9Pxc?%Pk(4YBV
zJKU<-YXzw?s`UeYx?Q%LwG9|4Gao1-lUitk?)pGSHu7EiZ3-f~c;f+~m!J{gQgV8&
z6v+sq;Z>!$oIjGyP4~T!q9P*2tHm(Qf*0fVYefYKPbgbe9ojuqsUdEFu_TElxkl3u
zvEx$(lc!J?ZqHK5P@~@pu6BkGCj*uI(Q_(su->150WAaIUM&mcQOr~=Wg^4xb4)R2
zt@2k+D)<oicdl1Coe&Nk(1no=%bR;kp<-;|F}TwfvV23H+=T-KlxN0ad_omoOTUI6
z#QO8MxitXo+B1PBM&;`qVu$8&9M15DPsR=JQ<=QJbCUkWaSf|^;tUBUmn*1G;+F&6
z-YW^PF4RMegR;!xqQ7`*4QfcHwh_#>NWSgGeV_vO&+zn$3Jq^Ggpb{3@ODrVFvYGa
zzTq^aNk`)-$+T(1X^ptzvA!FV!;meC?PwNd=Kqw-y)_VsEd?({S#eSG7gZVSKNpUN
zP;-)#(Cc;N;hl#J)Dye%5^B4@4}UD1t{WHD$ktamgoWM$Oxn{UCtb9R@kgJ|z2Oyx
zg&UU?k^zg4g~KCfswuW4n*EjXK_1UIrtXj-^CeCr#2ZhY{JjUhv-fqWao43mF(H#{
z`~B#Sb=f@EmF)&`X+$*rug68q#GAHW!B-{7XCnS7-l7U_wu<Jx3Svg10L#+^@l7g0
zdh-m$0X#C`$biw*I7Ds%mD;H37INJ;lz#8l6m4d#Cb~Al^Ebi#i8!x2MPThHA{hw<
zI!>A;%QHI+im39mdihhFr?`!BNvnLG-}K|TEK3#l6ZSB|M;Ba1v6`6mAkNweH|HaO
zmG|FI&%+JH&pO)D!2?Dz9mQlSwu`2Z3kdcN%#we-%Sj5EL0DBiKFcBWSQ!M>R^aDs
z!6M9gHh_wsjSx)L^rcBO9`IZi7G#jQE?lkkXWAb}&{eH)7RXVgKYRP{oNjwt7=yc0
z<`5kQBYl1>Mwgx>D$K3pGHF%JCTC%I@E^e4_Tw$oo8-@&#Mf%~DD^uKn}pUpbcha4
z|I()T7w+~%zICZXWV<&4&j9hX1V#6Q+q2!gG~LZ9=Lj6a$|t6XE9rB$kTQNmgwfC8
zt3ltD;16ynZ{vPP7Pwup9LfZ2ufTx4`(eWG=6*5pWp8hyHqBEr-+jY4!|90K>r4iP
znav)T0HH^oMO>xq&r>_Q-Fh&OpK#s^-~ZZM{=~xrR^KUWGp^B9JN~;sInYkYMZ;d!
zsm%p`TY+sQt67O7gZ#k#{U=*dD1L$|&%&Gdv)GrfF&&Y+>DS&I8L2Pheeol1H23!{
zWf+GLcXf&7Ek0kJDXlH!&wNt7LdscZx!ZkxDccjje$sjGyu5@u^%BP4T8&NL@zyN-
zSTQ0oR;ll^wq>2L%a{sQM9-%RtoucP4{bib<L;)$rBrw=OoS`!ky;Zb<#3a6<{9T#
z^pU%i{GdaV2><&XCFmYkM|{J-RCdHhi;Jex1jh*xOh7UyC&biW_xoA~o9t|6*xKyx
zDs9{|wM)+A8b83XqTz71zsyG50k4@ks2=-&Z%TkS8ScS1`uo^sa7~VxD#uKB+9dl`
zimh>)42S}8G*gL;B|uW5;Kq=#?n>4f={=E%e^%`7`GLF9!-%OjQ2U&z+}qg!p>ysZ
zxJ<X2w_0SXc-yGg4Q>$*P98DH)L}`(Eg6Gg>|N(Z4fqgzW6hajC#7cuC%CQjz_{g}
z8{6T{IrIS&*~*>OgmU|`qT}s6CuI^4d#I*SNrz7miR^0MOF$hx;}Yq3ib!yMGBqxy
z2OhmB^rzob3Qo#sXSWIDFHq5f9w{?@qPTZ8J?k)9h!IY5+&n7ad7~<p5by7B8gy<#
zE8}BrJNPfQRycy*c4YMJH)ClEwep!_&=jFhxq}BAB0<H=5c52wPp)&?>iYijw!LCR
zAz)ui3^~M+DTgaf;>C^&IN7AAVq9ZS$c^bnl|Y40S%ZyPJq8b4cu008_%!9Inu&1u
zApbnC$r<=Yf-`)A6~^jYLKs<$Sk6w&H-I{WH*rzHA+`#<!|#>2Fb7FE>Z$@)y<*)e
zS-b5X4C9*`FKGZvmfZCL=Di@eD#TmYoem@qK`9sYs=tqvh-Yw^TRT5L;oId<WfVsc
zpcxt~kIBe=={0ZDu?(TBvsPXtp<WMjZzjd-HQgVPVn6RX4OsSmTSby`W6MOJzeXgQ
zHF_H4Lr>>D%Ua0wJ$ieN0`i=4ataz=a$C&LK;yJmUpO(r4e<>9U6I?vMgomShafj3
z{Hu<!yW8`;cCwX>Ozrm1|G1&k?F`0Sj9pKGWTts#Hcj4?uYv3keo>=O2F7E<D}S#K
zp=6-Fy349fuY5$aSrm!eMeP&VP`;JkS{9bTc7)CCmpUNy<)yYPEUyztloM=Pudz5Z
z@rb{$mXL&8W*+#dg43t^_kHk!JMtU%GVXG5S=~@^K(=pIOuz}heyu{n7EB)FL2n(e
zIfgd70C4v1Rt%Q&?@1NW7G&?#I81E5gHwFkF@Vmsae(otp{3*<jx6wnwwj|7iNZy=
z&6(5h_>R)TTU{n~d5Wa@pI3@@T3*U5vQ(KPt_zLFVZW5geWjMHDrh**k$5<g!W1{A
zY)+_%8Z1|J%JGcTXRAWJA4$5u-dv>p!d^)zaU-xPVI+|(jU#%Gt;*DupiKMD&7(e=
zCDdtZ!|pB`qV~q~d8yL`ok&eo)%M=+Qm1}MRYWx^a;606Kr}|Q*2AVpphcjiO~Af4
zQ??P+^Ps>we92G15HJWw<|WJj2YAGn`az?iee|=EXQr<OSr(IGZk5;<=`)hCg^v)^
zPwd)j>k-x>{SWBQ3jzL>$}fh{v&1StyM$cQ%vq8c2yD|g_H`!`ik6kD%7J?XrMk4d
zPr@vZw)4>LmT_9eh6cRsdZH-tkm6doG*y~LG9ht^g_=#ehl2(!NTI@~`n#-=d7<Qm
z<XSj-!>T<YLCw4Gg{AiLHE3M^B?+RE^E_+QzdXZEfTBJ<xf6p!P;)m%*w7N=UsMwB
zVz0xT+e+oB^KXpbelm*JCyl_Bb68CP!n8*#el_q(5`y!Jpoz3In!EslDIUAczov_L
zaRdsohQ=(+1pKQ=o`g=I(wfml#k437xvYP+mN>~+a$dwNuZEl!ZeJfjgg6@vjfq-G
zlVROWCwbO$IG2!RqfHaDWqpaa^mVQ`d}>l6DKld<<onkKUYztVk47M!zkWY2%j4I#
z(m|@{ZMw7Kps#qdU82&Y+s6ao_`$$^t@o6ObAm5wzw|_r4MTv7vIazQ3XL&-ghWmf
zZte7rLM6#y0*dIJAVhJbw{Q}MXR#obBOw2N=TMM`&JzKQ3asG(yvX$oThxgp)wU+r
z;?9?A`W>7!%Rp_t1T==2HX#m~tX)WFa@FxjzWz)eXqWuiO%&2U3fKB2szq>G!W(<C
z(i~69zm6=S6@#4%?pClm?D@~+vxs_j4`_W+Q}a$!@SE{qF&Gyj@<M#w^S4gtd5}J+
z;L7b`7vzVP9E2wiqIKv&gAztZ95R<BgV8Kxyd8sr+BRW4M++ao6ks+%3pt13e@|U`
z<>)BC6rUFpuxY-sMscj$itTF;``uoUqOo?n=|}_-Q|P};Ape7@Ah^Sx@Zn52xz=um
zFDq3GBV_f2BPaz-+X`k0{P4qmYE=4E_M0vsMS_o{h5kia0AUgVU3ZJAs|6>lVNY_Y
zfavc(hP)XBKR?6O6U)0F5?VUnY2m2_UrWyQEv_TmtOu+@{aD&340aPE3ua2+Yvff6
zjv#M_){foa{H$~{^=WFD+UriU=xogMF1>d$48Jc{sikB`&M-lk%eY2b#lQ2>DR;&2
zJ3&dwiNu~kS-9SlsZgP`VNormT6rAbDH-~nF_-7z^E%H<0xU;JsA+VEd_r9Ps%$93
z6E?{ztGrJk?Va)Z)RV&P5$d<xcK-olJ|k!N9otm_lgERdPoz~B;<HAsJ_a>>Qm9eT
zDXwZ^^3qm7SbzHuP^(OGy8YW~fk&)+6#m?c`$s$lne}$298c{WTLb|6$CX7+bM1%Q
zAU)?M{Lsv%m6zrBa>p`hXU6KT8v6dk+U^itw<V;lcvQc1XOpVuiN>Cm!iuya%#pXb
z!iQ!Xgqo=P0}H}YgQ<xB0Hq)bP9~DPvSvY1U98+&!EKCUb3PBO`Lu;mdymz=(W#<<
z^J_PcLn?}0NTOZq#xq|~d_!Pk5F%LG!~<V1&C{R*e1Xf|8ZxQXQ{b$j5BnX$mod^=
z$?4ZOCDLOwZ6tN;12)bEP37Zc$N@7}qWi@|18l$zks0b3tT`pEjYT_$8w<$A>Ia$7
zvz<|`gjd^z8V1}|%}h_!o1B|g!TE6%jj!8?l@_g>=dWW&k5|sllU&8qnR&-+yaGZH
zM;2VLUG0=8hCxb4y4%4qY3(V#I*4U|fjEl!J){25(p>;Rdiyrm#9jkwmX9JIavn<^
znw$F_W;Cd|PM_v}YqRo{R3ps0$Dz%Oqznlak>ZgjIp-bSW)HkB@wxwFRM3%bV*8HY
z+gpcLR4gG%b{DoWtaLq(@2=LaCSX_~bm5t+;HJ<+2z1XSQ%VFQqFJ_iE1ke6T6BtV
zEa=cQj@>WLi`Dbl^b8UT_jd%Ur9`!A5-13uoRs_Tm%Rn?{dpd54_{s3?1!742OIt^
z;wHe3Hj_>-&NlWB1)V!lq?3N<f6Sa%_CCS9#67jgjO%9~MBw1nCDHZ}Idi?fNc=G1
zLok!VYc1AJ3eaAGn%Q<#$i()biu~Vumj<Xdy|?akO8EnPYGmb*l(?3^*lQpw8JKBE
ziU*=N+1?(8zX;sp$h1&@Q2C=R!@jUp(6YMh6)nVLl8WrA_pgak$hZ8GbPS$ksYky-
zgTsvh)Bc2Zt~oD}`_0Jc<(+Ga^2?B?_lss`!)#T{Ue~U>1((~Wfh&VT8SS?s-Jg5U
zI|xmG4urW&Z{heCUEEI1yd647*$G2H@0mX0kEuyC`>PY}uXkTdmp5EE#93*n6%H6x
zeSzt`VGu7@X($T?4@`P?j4t_=TY{qyuMn2do4VFhG|}S-rsMFUVJ8P)`!7zfQZ3{~
z;SrT`cXQ{OR_bRv^5}T+*yeb*u{?<}rGOJn)n2<~k3?6u(g81P7S=!Z0nYU#OufHL
z50s|6pefEVnPVGElxc4ghrzu^FYZS>#PL|Df-h=>qu+4bTAZ_*@fo|H=|TFB(;cg~
z(?}SGUs{bedFOyG27=ATUF%cb5Embv4I5~A{{4JAS@l{&m|+4jv>QcM!jgS_ep%D;
zL04w@2Kn*$Z|?#Ye|~B-P%$%Js-zE015=2r#fnM7C3=_~?#CS1DIG@07XP#jUw>Q=
z;3nP9oizCqWG>P`{p7bNa)H&k_BE5`9-4}McRJ;+;&9IQW9aU;D<!g7HsR^LHn~?^
z9d8C3jy<r;p_=>4pSX;N9z*@*8;{qT1U6y(rAXKafvqp=_fi|nH|L=ytLBdf3tGX7
zUS3@TzF#Z1zkhvY5@p9d()*^?fMKqxiqu#fd}8g-xWV)9*Zsjr787ClL$R$kJ*~4n
zvKfC!zl9MH`yT*m2p>Kc`a3G~jPrbs8Jo1Z7eT2<e^x{gI2fF#pLr!K=w$rvI%&yD
zn-J+CA8IDU@szzI?oFUU0W10Um>*0X0*aYaLLThv91_NoDssWI;c}KIFDWf3VnHbv
zClGyHubJ8&^H}>4j~A~h1R`{uPv!;f7yax3@ToCW@hq>a)h;ks5O7&C-IW~cZDtEQ
zpEeb5wPsaL=nUxPznRx9`*tqH^8U>_=mM8Ns$6UrHKk~UFPG`9EPC3D3dN-k0{oZ=
zN_D;%q|=5^@Msve255&mf>`HRGLpX_$=zrhi#-Wrv0lTK4*oC}(MA$y78AmISCVGt
z8h?&8v8`<WPTZk5@m(11tb$E7U%q3BQ<3f#5Jb0K{GH_hQw6?k-qfciu8uVnL(Y^u
z)pZdCtZ2lPSsIs|9S{qm9-k}Ccd#W~SCxZppo*EeWPUQBPG99i?>NgKs|R?b$lt+^
zgY`TC)p!hRzQ+!i$H<B8v46&Qc_fNm+1sPf<#95Y`M?{WjoO}Ratt!&5EIH2@eUZ^
zc_=Yco#kbEe4^9IyG@l}!JO)VR2nUKs%ZVnBzoTvA0Ny68%oVzF#3+Z1PXMx7gXbr
zsl07@xGZrt8zYetY#Kd;{+l2%yqoiU=RkH=8(Z<A*V`Rk#~m>wPYbGO>e=h!3;Zd#
z$ihdl$N|Fj_Zh1_Sx;qW{qwOgcP<T78Yw-{l4=;6;7bjj9dn>U74b6CNXz$nq);|S
zWv5KsrGYk=4-&MwSId<W5y*5YMUe!$l6rx5KwlT}fXy0g+osYMcMG#raE6e)nzJ9k
zTnm=h;;&Hz5e5uZ;X7Mmsga$ISNVA9PrKw6Ouws-_G%yYP8g-G<*8ck7Bk_#yw4$d
znvrqi<t7>*o<!)-;jC#wUwv@+lA7oK;oU8-l!FBi)uwl1KPw>qk~g>C$X=9j%P<k(
z*HoeT$JWdC)Qv=7Pvy*h&K+|=V?-5o@fPaTYkESr|Cv#&i#=8@`ox}DO!`=*_phl~
zzbK9tMT+L<r0}cRp5UQ%$=)S|9k|`S&fMvKhc<ICiULTvK)R9s38T8}G*48EkE4#P
zQy|jMUg{Z!g$zBIB!RBBCaE6Cx3ZG&p_Af1tTii7ajfsZz~s8Ea66L|uO@+O))d#&
z2K}m?S+_pjx~#Z4fNnH*Y-XHFSA1>@83<ZmyNOosM2i@N3ZX^QOdFPqG+&nQTN?(#
z{1{E9OsrZNpY<SlfX?vm(bc<}PWoXUtW=p9U|-OiuJv+r&eSP=a7{0BE|2G{Hu|_3
zg`et)O9>bfy92im+hzL43VK%BY%trJckO@`Q`~4QJ|m*dD#&pck`?0jQz5j)GR?|h
zDj|hvWjqQUbPmB&Ilsm-@TETVW{LdXWvy<)4)v?R4?_|MMOqa1s>^BL1mm((aSeC-
zUoY>3zOq#&=7N8LD|wgzBFZ6Mug$5s<%CnOESW7h-o~!6&(SVX80uU-&eGHvj}qee
z{C28EFU_25cN;HEK}cde)~Ec$q`nUXDG{cFH)Fiz<_>8Dn6_=jhFJ3)lqncd>22W_
zDQu&bV#rOll5gJ34b0*709+k9A%zgIWBU7#DcTn1`nVzb$lxqTW}?9NM1MPl(2s<+
zu}*I=e@B%;InCbR@5CIU#i`Dq!f7mkw*$1-`XyNQNSFw3g$DNE^4^s!7bD;FkP7^h
zq~!%oy`M;7Ff*)}7G2Q;Bq+6J7>%~{F}q!JMfTJKNK?>WaPw9Uk-OM(YkCUXXTKft
zV8+0(zv!(p)sU&pLj!VU{xMsH0|x?Dbx2Tt%ad$INt(|QCTEoZk3X9fzLn~)&u9}9
zUOR~4>1kKNpkXT8tQTciigq5*MR{t@)F^I4tzOjB3p@9AwOOJAlv<`0?j@*}9F4dm
zgXR(v7_{>dNdVj?n6ezSkJEoHf6?N0-}KoxLT}&opPRIiix!tNkWGP%t`h;ABf^>T
z*X8i`(|IO80;Ye=sn)b{{?b8)!c-<>4&*6;Fr_CD@*{Xd{82)x834?L?I@ujB}xWv
zW$*m^xxbL@MZnF2ni0E^=qV&<l}6%X(>X>3>(5?h^rGM5V6N|{@)WP3x+PKWfjzYC
z6WY!0n@>PTi-m&{Cwg*?ifRcOd=J9g4k&f;gv9lv{El}lN}<X(T0zQ-)t5t9y%4;A
z^v;VHg`(T}?IqekR&*qa{I$USI!kx0-r4W)JUiAjnlIP2q^^ks;n$UYen?`kz{`?7
zmtjybd=bE)N|OZiLXt-{@E^A-Br3EWZ?{3;fRs2(?TW}iMuUQyYcC(w?Ld{!rbZD7
zcKjUvZED8ilUEPJMBy_D6*V$%_l6b{h(<#W;anmcVjN;M9lU#Why=`!_H;Hq*zg|`
zUjLK-0Ecx=K?S+oqoagF$m{Cwd^Kc>jy0UvaV2R*_xXNA_&Iq@qV0s?e*g(@A;(bk
z)kRIp9}*U%Y(201`JoBS)HN2T{FNoIPkXzHt#ybeLEM>%hNOPSwSgo(c<xWomz4{;
z6*q@W4j=;fZHpr>h?RP>gp#{Y;ghLjQ>r1!jR`Jh6WxB$T=N>qXsvc$$A4m>SE{96
zRTO?hESv#hV)f-I^|WkVVu+M6)Li(Wbs>7`K4m;R%m@odpFbZqNJA5xo!ekic8a6k
zTzo9D^3#qS{C7EF<`M+85W$zGODN|f#GW9lE0@C5daBMSQs5Zj2u(9_io0?6_Zt%+
zE4zV^ko#Lf_$@MXl+Pb-oS2|uNvEYLpO6znHN?7CD{geIIb^mQGpdgBBBdwEnmnps
zGgbs`UQ{5Wk!8YslR3WxZCSlmnNuH1Bo!xJlEeI0*@S)t3{T=+NY=;*Q~D^I>|i})
z1$t93k@TJZo`&<>!uVp5he?^*G=eVj9;>T)e#B#;fk=tuu`W)M?_J>Ga|Um5+V}M8
z{{b*L1ZUOI9<Je^5!H2cW0?1qfwY^|n+=?QXH`=@q|q0w##(r1rYWY*$#u1mSP3dk
zN_|(Q8OM=VpTsUorc+sf%Lghu&qf3I>t;&gdsbyAg6D~yh`k+Et<6s+h*pMCc7X~m
zT5~hvX-Hz;pL3hqBG$0P&rTKneXsxh@@fIe*{9}k<dOpSp?&I0>z2fF%KL|AsFd2V
zB&GS(<e&iCR<ZhQDteBgJE3qoJp{q~oG<450IDw+yhH;cv?iUr$usEAOxXsJzzUwn
z#ZKcYrs(bS0Wb<<Q$vq+xfA;3uw)CC5TH4wMP})J)#`bZeQ2cG=QHt{0@ekNzlndd
z^<g_1j8h76co!Qo&HWz#d@tBT_lBP*&oVW-bZT_z{8WjV%)1^{(3P?yTF%5kUo99d
z%KIO{Vz^cWQtjp)t>#T)GW2KOWv*pl&?+KIL_Y}cpO@fbCeKqxK~{NI2MJrBzd`eX
z1V~`Y&8i1ODWc;T9he5->7hV0n|j^Y(r|MbYbl&5{k;@ff2PXtI-`~2r@w9TkCi^^
zmv@GVJT?WX1d_a{1XS|}XPPhEbRlsDDi|X9f<M>rr%bTk7cGxO65j4g4Kq>TNfo=(
zn0p634zrb*PsXntX({@`l0=Sr>-O5ozXjQ9!%oM4CrI-o9=}1|eFQzbsrt-xGwWHn
zPBt~4pTJrC{&LN-C;RKf4jux<3r|OW2VI>Qmv1FcI`=}CaJ1H{fi!LD=x4hyf9v`!
z+Y({+a)bj#fm?*-Re!;6*>C4<aI<s--bvCW1TN-eE<=60=&ilg$WQt><d`1~D@A(9
z#(eJi)IvB45NCacJ+k`VfcN(4nx?+f6gSsdu<cC4H##aO_kt8>HX<iICSm?zYSzg0
zHfFGlt~yj7Jm5IC_a>VLBxe9BVnn2K_2&Xvy1+FZ*jJ(qajdnTlX#hpjdV#}Rh6g{
z0EAlVgRQp=W5N+1jHeE|^X%eO25HZvj~HgPD4TF6P5peu=2d7eIn8HD$_s181eqtO
zX{HzuzT+)a?Xf+#L?~<YF_Pn2D+m6qDt-TsHRR$!|DSs3Q{y5ae-{!|-S$}E<T=`w
z2J1E2wM#i$b69`t<B4|A8Xm!{lzFf!cglS}fB=OyZ>X>nu-W8o`-;2&4}E7y_Vvh6
z>Ofr{y=a-}IH%&t30c$RZsH49=1S6H_>>#9&kpx@^4{otS7*1}u~H2&5}1UenJ)ut
zdr@1<BF^aR8kYB3V_LfKv`0z8AEd1Mo>LX5jh4285e@M*-xHK4&M+<ej~FAxJzBZz
zJ!`^LR|@KM?LQTpp1nqHcCsSDhsGsM)f6~_Oa9Be)mSec@P;WHtJcORPlalSS@|VZ
z)3tA<42Pb08PwSoQni#blJI}`)SyEf3{~)Kq%4MM2y47w<~u#^W)gJZ7yKQirFf(T
z%<q=+Zde;{<TE2(*`IJ32qbf0nM7<PjLf=Rxi~eX&o8b`jUpwCQ8+2Ygp&wXNW8@K
zpM%3tJn5#7)cg4TzDG>H&ngT9-9mSkgUkbwIiaTo2z_&o^-$b*n|bGctUhG_JAG%&
zYz!~XLr<8E%**c~xQ>;qdBZ%6euTZwIQ<rSz6)OT(%wHYBcQmX@8DQx6KDvXu2&7D
zyuDt#LjTaj-QRWE>23Bvhk14Fzd*P~XM_b0>s6sbkq1%txb@{AwFc7!#P6mtW#j2V
z-2IRKe7R||3oJc-6<y`mdn^ur?Ege0@a&9^$q0p;xDV)1Ng8~CxU&H@x`{vgi$WQe
z9l95)cpU<3E9GvCV@b_l&t&`$u!fh#FZne9$8141*T{(LrfKnX@ymyF-OdQ^$`>*5
zGtqB7rUk&b!-G{ef4o=B=y-umH<HPrekw@dsC5%`U21<{q^McT^2IK4Pzb*dr>)iB
zgTXiuU5wN&+U@64L3m6`qKAiuo>!$LyZh^5S8?w-Ww%=efp<e6B@DB$Cz$4<Y{2&Y
zhBZ<|x9S6ql94Y6>fQFK(9I8EbB)pH1#?6znml^(v}9-4{O0>fkWa;UnDgF=>AKm{
zQ)>0yrn1gHKz%{S+<XPA)H$iiTHX}rO?N<HP`cI33kahvFg=OV@pF@W`BN`_xNh%y
zsLAzf4c*_bcfB#G(~YyxegaO`xqvqX-B_fuF?^w>idt=^PCf8w^o_a2($MOGU?+)^
zSS=t-^ze^~E)2eDyvxxjJlOsDC6TK-3(u^txyJo3HQVjK=AXq9tItrIwx-(eXTtuZ
zZ`+*g)^ht||5P~`H9$!4Yen4s?!Q@euo=a(!pkl}Zqtbd0Ci3FjE2F`SJ^EulcbTO
zk(d@LNJAW?b_f8sfa$CB!6ZdIT0)IxyKEAvEJT79Jn{y4QXv-Q*4@lvD`#bj8H?#L
za+)?iwF363t>H|Emimz2I26pkI&z5u=z;r_{3ycXK@zueJ9msjpt3$hLAay7Wf-WE
zSe)iXgwS_dVf^(3i6GU1z`|cBAiF;6kc#VD)hn9a7XPlOO_QXl+76S&rdu}<Qk1Mz
z?&11L<lDSn-JNeb2f&Z!zweufI=w#;v%e!^x)=KTyx!aKZM%|>Z>4+5!;jBh6h1A~
zaIb?#9(W!j<G+Vru+QskQxw^0+{n`19hi<hh_+XrG;oU<HR9v(NyCvk^pFzv5maZP
zZg9I608d3F7L`&mOds0((TcWWUDlZ+rBa83*Ir-{v_DcQ#wg0ru3&lQ7LX<%lO`j)
zlV8y_p(7~Xs3AAF?QSUBbfIKm-NK9>tRnl0m9l*@o;DZ(DCF!JCMUs~R1H>)@<KT8
z2Hu9Yi1_oxM?4ojvv=nIh<ksODln_Akxqq}x`5w&qB_VHao&aSZaPbn_m57C{AO@Y
zz5boC$?+<vwF*CNauDK<zM87lWabS9I---P?To{vk7GsFNKBL?DLdkGgApgjy}R=5
zlf;2eKb4qO7=cW@o<lD3b7jWXgsvO_JLM8N8??O9=nu2Ccz}!w^2T(6*Ooh0M0<=Q
zsNyTflYfvWtAF1L9;DHnsXXjC)ac)g56>6|#E<lX@XO<(MXUkO+gc!vjn4^R<Zg^5
zmE(5PCQm8ABI3bLl@efebB96gkiBqyd<o`%mzqrAieB4sQ~bq?NkKza*3FQO0W*XQ
zjs7eZqcY@|b4RHba#Ej4U+$_1nr&uj5AYSDGU%9iZfg67<&(2wvrT@?2ex4=?B*%i
zp-IS=I*|!`PB~?#$|3?o<$72jGfKIH&3mA3{Af9c)!5;Pql0NE2pzK=YC|*2U3~<W
zL&fIlE)yWb8>@$pw1J5_PHO3g`n?<ZV<?}J)X*QRvZfM92VsU)F&^gEwDhOi6Y4Td
znJTt&XoNW+9`+yLWyh4H%?EBWgB;Y+{&M<j51`%bOih$38Exg(`)22zOoJcFHWkCA
z@!);E#nPC^%Zi!qgG+>%=GBLx2ZoAv45~5xQ$7ElUJ6iHR36UcbzVEWVV7$@Ze;Ud
z=4kj-8T?R4+^z$#$DS#1v^KrX>?FZKNN$_^iV|}#sO)|^F%^`H|Hfn8St(N<K=NR@
zYyd&2zMsC1(FFAl%8}!y{Vdr_?wY7q0=DJ)b9wwZHS`Qhg8RBW59a2MdK3_b7(|vN
zrB*VS(3Tv=h{Xu5=#!0bNJ+-5f<OaAHcl@rw~+38E&55FRBF!jJr#&BytUO?s?+<*
zMUOPaU*Q-s`Y=FHi%=6l0_W};P*GMx?WW4mMU=$ghHR9tg6o}!JZ|xxv$>6Frf|V_
z9BKuEpInTT@MA7Q1~sr<T0H`5=}bc{41B@AHSjymjz-uW!XS!;-@$SPQsMlScdy-$
z`~R#I&8Jjs)_Pg~*7qt1A4xjzx_fs#)&F->9oOf=)wv)mwyJM{6JTcOI@j_g#D4(7
zaA!GWMo3?&F@?Ayrn$3GiG1QcpG$RO^?9hT03!Lb;&rVPv10LQC2pV3wAUp}wc9xC
z|4etQRwUA8`?4k)aae%BiAbJ3``(7ERa4XbZXp+IVjRPIe=rVl$NDoJnVWqI8LH(@
zmo)lfcm2t)HrToM-F4<vv6o`#W$7C(B7KXql5bstOPKr*<As`i&TkB?f5AA5HZLcI
z$D0F(J6di&g}+REkl%oMwg#N=p4V(r4H@p5AHq3MUkj5N2%}6JI97+Xm{#(T2057W
zF0WC3cLxhk`jFimoscfUaWbdLRZl6VO^n=vv$}>nu96#^m!P2-z=`s>tS0Y>zhRTh
zi$3qt<OrT=a$n#jQXzDz{_JtKjdo^0y5InYvyQJW?1q(;%H7iD5}=|7h{J>o(RJc;
z^qd0*FtqkTiqGdi08;Xs?q_6<CF{0B{oZnks&reW<OnglJbUp1CJJ$uP%P6Sz3@wu
z(6Bc^&RfUZwP)*5kAkbg-%=K2LTO_vi@*p|`pI5Wb5cJKE3W>Nu{Y(ZPs&khhQ2$u
zbqv@v(N$(^^XXYx&QkldS|EY8HG8|*mfAD~wRKwI08e!p&M=&};vpmd%;wl%AZFIw
zo-BRwEWY+(1lw!#Nb*`a0v~8AjDV|&)rIjNdEzN08kw8mP#HY!1Crf;9VVJ7pvv^1
z2*>Zj&0#EZ!6y2v0z?_9BgAR^_si+z{{gBMTn)j-{wT&NtTxdIJ)SEg`DQ~8o0|`z
zwNB2|->fMH=HD!oLr6JMQNhiQ9!}II-I1D;d$?JgEkp0Q*leD6+lixIxiA;uy^y7Y
zu)=tvXOh|}@LEAO$jl39qx-8mYh=^EP$R{VPn>$fKvi!}4SrkBpi7sV^rvUY#2`Uc
zr`~*!lw|o`+SaSg^zo?JO;wc%aKe3p6s@Aw*#QY5Rpgyp4ibJ996_f5V849Ex5W)j
zHo7Qk6wwf><UQUVNuIhBqD<T&5*zn!-}I~g;V*vClg?K%UX>h6u-${7`XMz{(yi@4
zwcb1uNKjNYeEPmR%mI)@P5jY@NgCfFxy~&Cls+c(WQ*!NLdTy3hlzISBHa#<k0!Tx
zd~pBSB~Sh&3(1c{T9+NMD15emV5XHiESCIv?@RDsv!&-AUouIvr2hjbYx=!1X9E8<
z?x5p>3C1frj@J;2eN*`lz&u0vAlT<ck-5^k*s%dFbf9xUssb{*3C(o8v7FZCd?knW
z$Gr(n;?dJ*NI&3B!9W}Dzf3(;jx7)W6Z6q@?ucJi97raZ){J#w@>oOad)LW-+80Bm
zE>LlHu>4Ff+1MFlQz?;WDS;EgcHTmJa7?t>2~1^on@^ePTH%l@e7)}>U1tO}eT{p9
ziRWtnBbyF+=0g9QBr&m@VDpS#Jg$QLl80rLqx~8nQpnHWDo*b44=q5iiliVmIib&;
zaUl=$NTlGZcgJpFx<7zuaI_>A_82SoO2T<(!X!)F^r%hc>^#|e$w8S|U*Ao}R6wjl
zUlyC-PY1U0m<#OB;wMQM>X=>D>A*_{P-!!)KmM#a{&>D=H6bE6P@1*TyQ@O~t9;p^
zzDC!J6p4p$t88-w5ld0Z`84^ZX$xeo^*)zm92v-6y|&1IqM7jkv0SS)F?@Ra-s*w&
zC-E?LY+g@CYk%@>inp9a!}@+ej0G$OMu;z**wvg)*-8wcmG!BGiMPqmXypWkrGWRX
z8v6-axn5#2m)5M0B+@<~-yO1R*&L4wFnx@hlgN}qo1UgQD_SEgXRWfVWHfseDE-q_
zk);u}ZJ{5U9NRpm(tG3=zU2-W$L}>Q4Sljv!3fiC4ZKq_^k-MDgJPCNy&J$chvKgx
za%X>Pf0+KLj5R3QrClEVxFK|TWJ(SSHR%qz(5~e^FJ;&5qIMhTXauCSE@4^8e<qrY
zS4aNx*3eQQ;sf8#w>+tSdRKVZQ<X^Y5ZT?%bNF0vbt{uN;Wh6j%0_#r>v__C&x_%p
zONIv!wff~tCbge)R-&jq%G@TlRen!L0!&OTS!Skm{r+-C8r6DiEnt{@OIt%HLiR_F
zY0{o~oxrQhD3hqD_OTX(Fv3SVQiA5hJneMTGYprWVUzgCly_J(eGFtZ>4O&pA^V;W
zYuhv>x%ITibw3iEEs~<5I4aK>xRlaCJq6y*5bxhk&MWI=-i`*ASKncGjsDEFzprt7
zt49>V$Ta!ZwRcLM6}HgS9|`ZPgQkFn<zfv=8D)|L{hvGn%cGny)J&`Jgc4SVyS`ej
zk6xNB!i){V9k0`h3(L#1M0Et^knI$pDvaG~F~8g=ay9<RP}ppjF!jn!HrrC^Q~_h?
zXL463itaA8DVS;B$KU7IrQ%Q5EiW%V^j=1<wsk+%<_(!!P?C9&JXjUG?JcI98T{!I
z_r$r(#N7_eZFS)s*D-MY!2eNn)?rQlZ4@6JB8Y?_9TEeThLNKOA~8mz#K=jbl)wn3
zYcxpbMkpO3N^dk$(h>s%1Z04SfWLR|-+Q)e*R$(-_Py_O&gb~^feeih6Ydu7m#J&$
zq+j^(OCx5HyipF8S>((LC5X$to|pVpT~%i)Ii<%D`u>i_ck$pKQtnrB4$2d^Fb&gm
zNtsu3w~W~6l!=6<#wD9{hGR9_xL9$2f%96}1Te3n2sfR6B=LQJ<#Y-2#9vGr9&){!
ztlfMOf6D1tWtl@Iy0Dc{$((XOx29Dw?I`W&249fxGXHQ`1&LTsx`JWujBN8%bDDN1
z1#`BGR(MzuAsuyfq4vV+<2IK6oCn~?0kt%2yG1uZ+hn*_1zIk$rP#x)LOmr~c&RS#
zU(m^(DVE8bhnMA%&etk48r;oywnI%FIb^MhQOGporg3Pakz@?7XD?<))>w*#{)|KS
zq4lrFVuX|uBs7kG`;x(^@BOlly7y}2xK@Qb8!Laj?*&rv6N+0c00A)$|9N6fout10
zs;(e;i?l{3klx5JD?s6reRaCp^4GmPDX-@;jXLChv%EvK*h?~z1gQY0fhU>5NoN=q
zz^z_ovx=lcPKNHaW}@wx%BDp4sKDhThr%t7OO9VP$bg0sD^)`&B@6eeCH-Maez4@V
zEo~oE&ZJQ#xr{*|V54W9F8}94&&e!CXQyZ7w8S#GhnaG|*uf9ESH9iY5w%s8nuvAh
z<qwti3++NlI((^~C@NR~4CtHCw!JJ$>6H3Q7y{yT`;qMz@{E+VEMAn0oY{(i2K}1t
z&DNjaNDOntC-lUzbzRA2=$LARuX&k0wW>ZReZ8rGR{U44Oh;KBdGS?>C%JuD^uAri
zrvCxv(ai#ix9h(}07nKoPzDBe0);Ci$5u@!nWywC)a9Ii{SbXr_7I&R$(cxF9aR0~
z_wSLjNeq1-N*qa6BUCW9?03uRa0ZA!YJshW$P|N;V4#YGB5~x1eiZm#Wl)7N^y^!N
z70NJ`A070(S-ipc3;ryUXW#kuwV%GZE4TPSK*cx0odY?1icbfajEmi-r1!h!R6yI!
z>`W)VA<vzd&zqz%F=Ls*w`9WLZ7@6D%+P5Ud=TC9`&yKuH{i15df+l|x1?674fpn$
z6jGOnKM}uP2VnPR=USlx8b5jyd>E`r`#MRVeiwb9Mgol+8DOi>9`P-j?O{|d)3NbU
z{*7Vox_32z=gg;!sm`4yX?eA`cWh2}x3Me@V9S(J6|Y4bch_$Ky|UW;LpAG;eT{_R
z>R;ou3t=(ZpWHz%tHWGWt$;7%ao>vYFOgN+9QWuiMDD#O8RhZT&%`(OkoZ5n`&HbD
zhMFRg`5-@sY#bFnWl7AEt(*D4mq;tNiaHMrNjIQR%e0>oOJiX!o0dssW8r#|DX(4k
zj!hduTjOLYG`lB6LDb3Qqb%0n2)ta7SVst|LeW21SYZWV&t&B&x3`KGYDA23k<lZL
zdidY9;PqX9SCyx9?o4+#;$2kKfRP3N0epD$O?U3BMfkaY!M@c9yRGTcp!wv{R`1^Q
zTZ;#&-u_S^gJhz5#)KYKLfTv2jm&V_+wb@#(|q`#zWX8zUGX9Vo|D#jj(8rK=wf}%
z9U2a{z3GS!LSx;n))?xa2xSpu7czAym#eLyALqYRahrQ~<x7@QLcd`kQ^z`kJ`tG+
z@1%Irn&R`x7;uC=`a4HmqiUtTVl-Xxa7aT(C2}Y8&1DDnTerFWKX<;K$$GNZ;fv^W
zr__uC@T(=A^O}J+h}gA?dkr<i)Tz2{W%(SzrWo;TjQNfp8=A!9@x)r8J8~oCHL+<<
z+{zr95Zb<5Elcz|kkDMzBn%XmDvTS@o-Ks8#Jd%5D-faHlR5q_Lf4{HR3M($#3y_x
zmcmUiHR=y7xEfH>&?B&xSwurYtV@_IcE8+Pfj={x2f&M3-to9iOcY{9cHMEp#fI*I
z5rweSdg@2GfDOGBBUx^w;YkXx7w<|&S>jVt0B0*Lt&$I*S$CR^aQ3qbG4qY+xh$B;
zY}-)|1L_z>Vnsj|OA_I}=}&<&+OZ>x*h=N~fL%`Gr$2RS)Rp3t0}r*;gsGynN&N9j
z@nq~$yGQtWa{TeGO4tji4qL{KS8FopX3H<g+xkkYF5C;3mVp$me5Rvhv2*i6g_?*@
zI51B;nKhm&8;$I^!qzLx^8}eGCx3a}t-!5oG|}uUXYi5ZrgXZ}e5*R7j9NV0Yfh>W
zcezwqy7H01XQ)n$w0sZ7^4Sc3v!AE8g__SwF!*Y&@EkEB&-Fsm=6kD^&bmMJt6qLW
zzt7GGjV)@ji({k}bwA>||7fmb<z&9H9MarAy&^vUh6u2>6q~Mh8YjZ@ng9K;NM0P%
z9E`uBr}>~h{r*|K<9NSsWWrEc=l+IEo6;}jl;h>clFH$Q??<%d<VjP5gb%A+z@t9p
z21}>57b!j})DYM4<N4%hAN(0+*)37ol^3R~q&wZQQ-^%jXCZ*>C~;MgWn(V}sQ|8l
znscYA-6ovT7hm*;3mG{Loop%gOgj06_AW4b3LZ@7RdPGd92RIyXPK7G6Mfa=wOU3r
z#XpmD1WbGMu8~*Pqpv$d<aUFwc#p_$(psuscO&Sp{lC>4>}wMNMuFAcyvr%8z>jx}
zD$2cy{cC?ScEU5K7A<bpuQp4ZU$p>mQclCY|L*hi2CzKHX!L%Ul1SW{3=2~Uy$?SI
z6use`dt^mR3Q{QL6&d{^K<@ciT~OlLDr+5tYI#$`IHF$xZL7Px>S-}FnT@&K05!_j
z<9r~oJIW(^fR({-_Jvc4<;P`H8d47g@tB&U<dF}|X*>>Fc2UMrSG}O^=0DR7E>9df
z{C1)kmIa>eWrh1r$B5-HH#)KZ$a0h>*kka%H;4-7@L8-1gRD<e0eM_<_ayY`6Kx@g
zWX5oH_NDqtkWi^Gt&}8|`I|E--_B!|{Q!;!nx|FB1Ro?&DByHXUAgG2c6{WzoJ5y!
zfHd^tE&S9mN)B*IOYj_%q7MmgS^e3tgbo<iy!>6&xEy$IGHrltFT<qG24<*3{)RqG
z^uAxt>~=?H^mfu_9VMGb8E4xIai-bE;k3CkP-O6~GbJ=Wfb&vZs~WUf5eRN(<-B}?
zeGe2Vl5JnoaKe6*eI6jBvmJb3@Fvdb8S?i*9E5+Jy8u3&9gwfbf#|El)sUXF>W0Dw
zqn1W`X>Pvua4oljM-IHX|4ixOulu=btm+`ne9$@Nfu%Ys^<peDWFP9fV(4Uv-5#zn
z7@O%+3m`gFr>mg%x0&U@1;3PFw(WPX*(`S)c*fv;HzDC!4!Sv>^iOhl*Ix-B{{wt5
z0FSCt`o)3HWd8K?$mtw>L1Zfv!B6${?kbu)3l$&nkHNr#G4l=DNj6nGL`zTH14oic
z$Ja0g4YSdnj-JVE1|Izin%wE57r}zzHvaZbbB5u#-En~bFiW-HWxo9+A|Sfmkz#V&
zs>a570^Do3TPff)Vv}h*m^p&HEJ#DpRG9LOX#$F3ssc%mR^c(?G@zBvaf>XtdB#gG
ziSGj-;XQSCMzu6`ex=q+5J$%(UZF;+uE=_0CVIM#mD_ii4NF>{;Y+rCtUYQXvVQ1s
zG8y73WK6womSgciBDPY}QA|=u*o&SS>JeH(CHjWf-XAi2g{6qZs3IM63ArKmP)}8>
zn_Z;7g>Yt!!nZ?)<UGP~g&57-FJGmChpF<r5pi`##&`Wdl}bA64fNe_WyUIR8+vU{
zQ)+&+z%xZpcY5md7T{Rdc)J*6e@JO{pyC{Tr_p*|$Ly;S)Pqo`dIr`n4GW`9E7{^9
z33xA0L1|DrKmyPC4cTR9qlvc#E=LW<&?{QpMq9$i#J|1*P5zlr&`C5M*?AMGSlOY>
zJ(nsYFecb>fa8*W{?^xf6lfEnYnrfI-6AGahhtEw4I0bS*yRy_5lhOKvRJpsx1-S;
z@|$IDlId=*gRN^r-J<>TC#(lHL#_|?bw!oMQqP|Z5517GfgzXtK>G^shaj^9Jv!1|
z^{!7TS@dp=d$Sk3BI=~SE7J8J0c3NO>EXQm5ghe_>0q0GR@JL#hgLH-kFeZUSKYpA
ztw|G#nTA~JeHbT|keR1Vxx+A)>2ZY4*VYh!vo~I`K&HK<`I^#E;H}27*2dA$!u{r+
zfP%>RE>e`L6cQDs>tL+sp(%VcOjQM(9eWU~%j>x;j55wGe*CTS)d%mljsnkLbGMpp
zT&m6e%d*{(>gVh<$F8cl^@n~5X}4Z|0#G0pU0eaZ1zgpv-@kPJ$(~;2&~+E0cu`H`
zrF;EJZ@Pt!Ei~BkVo*Rc?)yck$xB(9N0kmL^8z~+_oR_AY9Eb=mKv_w-h(~$#2vfU
zqD(hv<~MWsLuqfjmFl&h2ot~S(B%1Y!n>$DffbAeM3z|EO{F2eY~#~da)0qq;qUD4
zh4mL7^CO1BLtRS+O#|f1iJ2QUPt#7&N2IJT_0X|3+;*}ft-M~h<%A%znLnZ#HWMY%
z#8hwE`50O30~y`gK76vHuXnSz_f(tP?z1B7onIp1g1Iib$QxZOnVMIuvRBGMR{ta=
zciajr$qmPy%e<F)2dt6Xn5j2FOHt~ssQ?$ulp3Ncwb+NgPEGsCBuiCi21XAm>yBJU
z*V_^PsC8A>xxVm`%rAnQK}xsJ#x(08jRj;azmUEb^L$<8^f5(^*Ao)oU;eJZyJ0ft
z`JMI`u=-j2+s(yY7EmEJ1<X8Obb(WTj(|34ToPS!9pYu;wugY(cCt^g$ew8&mPh#4
zUzq=W5oV||`K4vSTx)8TfO3B4b`|aqmkQ7<Ddz`~_wq<5fx>}$3pHH<feaJx_tJ+r
z<mY3q{l1c(OX5xs*Gd`@w{HJ<x}c%KtNSUU&XvbE1h!^@3pYEk>bx()LL`e$C?KY_
z**Ftw5;Wgi!e6;*M;Wz;#7n#NWWm-$yKDM{$G(W}5u?w=yz6JRs3D!17IP@-lf4cq
zJ^aTHG3eTAF7^Vv3bpAOg54|^<nJRr>QZr`ku%dxnaLmzxuJ1+%{KAta>11Ig@xs`
zlFms3I;i!sXNq!M&+^`lnAaVJWgf(M)ANd{A@Uaok>*j7z*^2EBXG%#v5?>NKhpQ*
z2KK(pdiP0k{8ozXk$ue`wiV%8i8NBzv42d}B(H0D>F3QL5tCbgX5ZU(TrMC_X7fqg
zj+ir2^eU{)snb<@?g?gm4I+I%)PQ##yH)(LTKGiP3T#fb>!JcsChBdu(~H}zJDMW{
zt9L?*f1%;5g3I^AkKL3bbQLf$ApEQAy}F5MNvYbqs|ZMxw_uc^!ft{&$$mtYB{60L
zpl@|it<PSkr;z^hk?7Zw;6qM?_(J=>Jwj{TD;}xKq8!#O0+>(C+J?JemhU)Uu7SHc
z?bWiLyJ}3ZaKS`*<V}zD=m(ti-d-vaSr#F8_!7rn2PscSJDy`Z(GHAdN_rfUs|3;G
z^GcV;zS%DU?bW1_3%<cc!3<f_xbM3%Klyt|)+X#Sim2M>E9ervfk<tpsL`0TBFGst
zZ?YpY%}W4KG#jJGIvXX|f2=}tcvj8Ci?WQ+<76^cQe6)c4%BZbGZJqpjb(%V2jD?a
zrk#uT`&tbBq7kUKes<JQQ#v$r;d{MbB2M7X$>836FB<1yt{I_NbQUv}a0e%q_q*iq
z%E(Mug*iNn7upZpLVl3x5?t%OmofV{!I8NlIMG{N$M9=U^*SXKEWlRnd5e0}V5<m(
z`P3Pj3HORtp;T9^hw?Snl+<#Tki?RkWDC0JF40R-`s?F*gpVKeJ~vd$GKj?|Za*!R
zpai1CqlZ^ay>nF&g~qjv+Y(#TRV1IG<mLFElIEypwv`eGqyn>?rjvg32u|=MKL^gn
z#0OaZ)>-9G;E^Edz{AlPSgaPCad`@m<33;iJzBQIaoZFYLZJ9p-=wHu%(N^_sm^&Q
zWcTl^XR~0P6GM3QfiV;gQH4d^A^z@fv~drXmx`XSGu?(3-Ej?^f<BZYo54)h^9hp`
zt?u>G!26LT9}7kRrs+Dbr$wbGt=OV;**J@4%VcQPf^j>QleZ^5^5LAdezQVm1D6pV
zYE<Z|-He{9?e-$-O;o$rH8AbAXO+%Y{tFSY5y?xV5Vp{DJkhu>E8zHmAMytzYtJ9`
z*#$m<kgE3K<@DOABL79({=KSA-NP|*B|d|ua0E$|u1F@r%?Cm4X@*D9l@RvO#&l8U
z+*v_x_O}Y{lf8!q{xe6f4#1PnhuUup>Szl-t3G#sN2GnLu`uxzr-A=YJNrqtE0py*
zhHhkD#-3uxLdzd1&e<EMe)?oeJS2v@Jtzqv-y-{9^0bE{_}ED74gQ05V&PA}@_ccz
zl-o#N|1@f>e$bLd4!iJtDV?96j(k9A+&;~a;#9;7VU?~KL)~Ay0^Oizmg}gC#)9cP
znvIu6Tr?F!Z}4<mMT#)g7jdrd3)3Xoh75+<pn-5Ozcz>`u0kojc^%c6%wp?hETve_
zO#SC1Zg+=EOla%)3sv^!`{uCYcj&r<j8h~Q_o1!vG6Qu#Z0lRSjp<DBMos($(Z_4g
z)Z)98NH2~ga>smxQ*<|sx0@8aT7K!Qb?=KK@+4G{tB0myT;*9;b1-=>_nzzBdZAc9
zLK^kxW9vMd44C?MIDER=e3xgUv@GKhX8i`y*DeNQzDg)GqE<ir{}kl5@_5`F`8Dnz
z-*gikj<R6+<_7wAKReN2xjiiy6^f(Zz`ftn?%;7Z0~DYq$FV#c&%HVP{8mq&u@*`{
z9B*5c#1VJ;<;@IA(u?BG{R2vA)GD=}wk_+&&jkj3^PMWNE(Se?(cP~CR=P5<;V;-t
zr_RgymswZJx%LJmT8G8HB{&Em4~dy`v1X|uIXYm#2gM5dC672%3qAmC13DlIjXhrQ
z&c=LiwyXYne?2bWG=M&8aus8u3RUhME|Z{b7Xa;<n}M-Z_1ejxH)dYJ1^^(;;<Q8E
zkZoaw))-<TaMkjjzoj&J0J~yJmF=Xy^BKIC&=}n~44Q1!Zj5TAMuu?DxyM0`KRID8
z!3T#X4gm%l)oUu4;H4n%k%HX|UtVn<AtPqyxOm?dCx7Ed=KDYKVOt4ERgYpd^(5oo
z28bz<62Ufj3vXbh`>k|bv*pr>F^0X?2D!CLq9PS^3|S9rHB^frGxhT_;f1p)S1ZUq
zyZ8@KaeI8MtVQl0^56B(%g`qEvl<eciL@i~Ftq&@?X<W7a_oT}>hlw%VcvRpi^xMy
zu}jYmIBEro5_<HDgyOVdW(!4;dGMAT!}(s@lz)qa|LerpbnT~%o;7|qN@k`z!E8MW
zX@v52ME4yYcxoed&qM%{j?dbqN@-<!e0(Pv@8lQe9=!Ag`5FaQ=rGnLPa-=sc1uL;
zwIpLzEh{}djjiI935YcR-<=B2=@F2{{6ou(7319eM~Z{nqz*}*ZwgSCj?E(y7A_<Z
z&E;?PZlcMR#!kxqmu5B?MhE|hCwxoN2SZ3&L4`K(yW2R97*an((4udLw7tRvqQ;9g
zJ)NE-!hH;B^HU!*alH=JOn-c2%GZYmgtr`L+KdhA4flffjQgnDHFSSnpm$J#5`cms
zs^@+0oGJ`>?nKV)Odv9wn%RF1>}W`@%%*!u3~4<6`&my`pD!=rNI>f3W0}Fcq;`d5
z9h2k|I1YUQHw7m&4+O0?3v*YuZ>*K2^0)<48v&6bhE%m%DXOgqMgpZf<&*GM(PtSZ
z3#|ouZ}Hi~GUpug8i5p$VTB(?hzM^f&f#G)Kmd!gpJ(4AfH-Ipv4T%aNFY>cZRlR;
z3Wl5A9-1MosVmhQNcx-KHiVQJXy$AIhgJZn=1V#mh4SvwlnYb5bK6}mI=fp`rEqEx
zD1sEv3C!2DcUpfvr!Lknfs(LM0Eh^Nsc*Kz={<~&=STz#IDM@MAC8XVl6@H1O4h_j
zNKHM^zvnl?r|ii6(?fP@6(0MIExnd;!1Z{2Np}ByONoVN|JUa^Bad1k)oGH&!m`A7
z{OGv6h?JQku<7uisr_ZKU&%m)Yn%3SRafK^SEAaAazd2G@oyH_w3?y*jH0Jv`TXyW
zxFM_acY@HD`^-ePrjE1SL+WHO7Xz_)W8$78p!%4|91*=k&!j>Knck92VocvkFijqh
z0?s8pXnpsL5Lz$7{GLI>tX*iHZx=lvSTN`JDa+E*_ac?0z3r=)>+PN4H}-`Z3CYN4
z>KRtK*8wM8g2megyPa<iMsKHJxqJsr^LRKvJYPL<frf69Q0@G<M_LO>Cr@ik<S}$#
zaRtfPwk_Oy5R9u+s+IM__fHWdpS>CIVr%!)4`9*znk%O~s1y<j%e6dB>{it5sE@qW
zg#m<TjX!rk5%FGY+^SN`3i;GlaaoFVEle@A=yo)6<)9ja5=XfdF$j(*&UUx@Y<Xy_
zPny_X{}LJY#6~|K#q52ubruj;5_y03sLy!Xg|){&VM&^)SwRPE((?wcf++7}$m<f$
zcqTa2AsFl#DMZbW(YwQrgNg;=`g}m`iFCbS0Tz7-{l-<&KbC13cyJ%tAEcRU(pfL(
zU-KFwam=sT=Dm(1_lmj4{Ai5o6S~(H&f;R*@<78Est`Z6U|qJIdcA__D&KUC(BqCC
z$3pI3U?*tj`vf;i6W>8t`U>53HQTW@hIolfi)6<G{j<FkL}uFiYY!h?LotI|@%|VV
z5tB}NEy$#ad4<cSeRmrG$uHs8YEo`n__blT{*^bKGl$pK_caU=_-j^w1?PQPJ@F)R
z@)91s9ZhtCfmR7OVy-wJJNHz!vnp}V&d4OwPURQ@&5M{R$)efs!uWOi)-T(-pLRqU
zM%VHkZ#GDoIscmO+-sJgQxgb{RT$LV=4?NjP&o)IRVpB2_Yu-aRzJ#+KxY5DdjizD
zDV+y<Pu*sj-m1Kw-%ZQ4`xLa55Z6ccAE2gs?6H&6<>L&3$mMHO!8ef?F_Pn6E$nZp
z$rP$&1cBSSt7qi}&j$ulB(W-8bCLI`h#f$_j!*wAU%&Fu>Vm;}tT|)v>p%xOd4#=g
zL-@T^pNpA}nDC7-5cy*|Qq?0eoue>R-gd#`+tU?V9`8wnWvlr4(sE-|5N=y0ip6}A
z$9lN0;40K`Yq%M9zRHZ_Z(waDNmj~=|DMsE#tFJGY11+5NGkz5$;S3dLw?Wd$oVQu
z;@<Vj?2QF6jYAw>vb2P^M+#sEv`1{%*||zizv_BRE$ApRDkKEf$yx?w<ax&z0*g}B
z9a&Wo(>C2vAUm2Zvi!Gy_J7StL{Qi7y4BN>BPV*knt1TFH_Oy)uReix>QlT*_P;QC
zKIaVQ&?8`1Yejj;s1;LuP2*An$j!Zo^A;@Wx?A<|>2?z8yR5IkrNu2%a<;47f3M!5
z%Hs2<NRfFY%|)|6=Cb{-K1<usuq|~ae>D9!f$TinZ1$H+qOR|K6zv-Fy|vv%EcfFu
zw%(*A%Bc16(d63kv!QohMFxWCVP$h@Rx(VhsadI9&Gkm<o6QTaD8XSe?x@Q4NOJQn
zdqMiL7I+eoz(m@#!(_qM_@0UO^=u7?z^xS@pfi$8Amb9&!wFy_TY!2nYZ0Z|r^muq
zHNlvRFfdj>>4O2iui<3_ASpep#!J;?uv;!gaWiRqPP0)kQfG)x{s}#VJaPgEHrDA=
z@=$_58qfF>VtR{JK+N-H^0u~M1(JP3<>bIrysI*;CFzNrp;1T`pcgMW8IsMbiG%b-
zBENlGst|V<6Z$$4gq^NV+Q?ilLVOAm;sp2l4k4Bb$kGZ$m>%*QT(t?hGUC&F?86L!
zj%Y@CfIliN2v;TO{oB&2Ped?_oUrz%1hdlNaT2NDrzx*i9DP6Qt`o8Jiu!@GxsU?q
z*7jPb*|p;R3X>4_6r)PLDgKC63556y<csV){OjxhRIu<b?#znDd}Th6G6l;sLkJtF
zHa-(_!teDLpGrL1IleNpjM+*1ywURmXs*kxE~TB3B%(G^N<Vn-4llOVGS+3@kwl<G
zMeROy!zL};M30^Q!BiN9=0|_uQ3E}%s`}EE1sl%+x@J@lMq}W<M7oA0B#^j&Dc?IQ
zaZgG%$|kK<uEZ_x87^#^>^ue#NU#LVb>9QRdV7*HI9T#j@|>t&5vZdV`QJrt9d})*
z>6>#6YFOJ+|GthOr{WBmL$z9vYUrsXtG}@_uI*yFi2s*`cmSQ2<_`3!zW!a3{e+to
zV$Eg<?;&eEuSSdSN)5Mj)o3A;3yFaw_VK6NAF{y@TlAv(JI|^d7wtU8xxY*ClW}!&
z7FR0klu77sbZp5!VivvXFOoFC4}YEH+`&jNPYMy}UPMqzh$z1m2P^F5!<kR-NnjMV
z5<*0!lWJYPd|pF6#P#mF!c~8Db&%FeX>UJbZ;YPKB-_@KhvU%`hlj{hQt7F4G+e7z
z7T3D?`(1LxFPfdS(1pv{(A9nZAVJKK0`s5ELYxEH;Zpb>#-o;ua8fh)|C$laYlF@q
zU0DgGJEAQa96<^@xeLN^??AZmr#-&js7RCi_kNJeztD`xnA_<g7uRl=noJo_nbZ2d
zNUTS;m3x1toS8vm@{mn$D0m~+as${bF5n6!P9BtVH$P;V7~79|x(q#zeC~uDb)sX)
zF&#W1Wid6s21bljl9l}a12ln3cE>zRQ)Rx3`sqFV#{zNW<k`S-jSEl^X2^G9d3Cw(
zsWc!YcPNEj!_Ood>XW!%ze4M*j>pp@bg<CsO7Nc{3l%E;yU6?Zgaz-2P<#^}!%eCi
zK-Wx03Zfx;c+BC7nWa-@yO5^qHagr}!Y^3nZKT_;2{uO5LPA>Z1=-GHeR~iL&x6S9
zSd3VZz1yfn8a<uXu%^>rFx`0f0j_sc-a2W00^pDYbuHkW>Sx;yKjhbwQ2W^N8*Lbh
z#lJ<rsUGh|A!E0oIT|HSuVgIUZ#A}M+ul(`EhSx#=zkWCX!_KFYS0x>W;6)afdNsI
zATCi$r|rge_G@?a_il<z#`7PD2Wgnq&-~JRsK2u#!@R;|9E}km=7C|F-IB60cJs7*
zlgcg$wiPRXdPlu}C~jhg(|37)A@6resL5ZQTSa@RAtkO_f6uE)8aTpl5fU<H@h>ZA
z0|S1D+VHD=QvB+;DHQUuk{l53U9bBeAoQ$Uph#Cg!_niq<)k1r*EKLC_Q&hMYEr4-
zL+BJ!(z$qemWTs^pvwZ|?nZ!(l!^VIx25*mSMji(Egrex8sPW9_Yw&EEyRhb!^-C*
zKgy*hWRk-0p%rfB!^E638`(G6hs=4^9HITYDq@Zk2DW_Prz{jWor8B}!>M>bj87Z^
zt>vqgq~~7-_uGKgLq8Zl4P^cH5Z`9H^eI}qAnYTBlmvO?e76oR`aW0x+hKHmfJ%bw
zBUC$+QVhsPdip(bREFa<jCC+H`|n)akid}iHj+DQ5K86Y0w&Gr^(wB{=`|>j4m&!3
z;YR&QC}7r}A$MExm(n*1NMXy4ssz9&^A+ZGQB{6q+b-1);41@2LBLKY-jkJgVsM@4
zsK^v05D9ElN4rHGY#4RYCFOsz4^}?J(o0EaEL9lSze-Y!ymJV}dr*-jIFMubZJkbG
z$hb}>fOCe31lwj=Cbp$LQ_<I4VWp&AH+kmEQ3J7wShC7R!doGO2{7j*7MxvxXO=~n
zjbbyEpvo_g5cib$HCr3I2$g;x{F=S4U~fq2HvzR`Y;q@$e#kqW6Fp+Fd=)s8p3*0m
z6A%F9q4t2(2A%WFn8q_Oo3hApejPtjQ#KtHA%*1{LL8LkMtW6OTF{$2ncmy_ep;j9
z;?H7vOfWP^lF;>-rPp0-IoT;3a@3OzIAK`!vrYRNWe6;bn9=1R>0QO`Syw%ct!;1}
zh-EumE2y}%BELDFE(H%vUX{>(&@|^DW&3PQ!y=B(P?AS^NDq7L6fB&U;wFjxhd!e`
z6J1#$#F`z@e}L3b*F0nv(JA(+ZKZ;Lqnx;YCJd~6Fs5qNU=N?U<+aC4PPSCsX}uRi
z&5_ESK^o{R+00_Ll#APJ${EXnKC9A@_q0ukfXyiImIy~DbiLpnSCBN#CZ`AY9Jzaq
zTJzJKZV%qy+E&p$Fa#^-;E*1<J$q01<<ly}JES<Ji)`{=3f!=oi$%eE{$A8VvO#&4
zhYUV7OycSXhi0>Ug^Q77uIhV6J&c51@i+gNe^mtAlJy8xrU-(64fHK*CY>&oq;9v&
zIsqm49f~zpf#bus+@jqmCL~lSTyRb=V<bjMI)^t)n=R{aW&e4hV2sq+*6K<Ld!a88
zLpk!&BNcAEJjA+kd*L#;_6L&)sXa--g=`(apIPBrR2fAids_PROV!L80m}6>A4-X^
z{l49wlYA+hOsym;H@ef9CgNaSJ@H+-06*7UbRo|BZZzPD6OkG2<)=cS$s0TN@jGpE
zu#F#s5z&}xCFmOG1x8{#YDz-@z`Gpdyf{^lmt2yNyKId)jued~778XXZ*od0*5IsY
z`w!Uwp11?+<<*Br0(xaD(|~~#FxI=?MIZA!rC2^|f`K&J(hH8OY2Y;Kh}liaDwZ@=
zaNr}uu?r{6qaF@iM68Sr<_IHB62`UT-<P?*C}qpM86+<VLm~`2%DN=3o}w&Wcx^aq
z=__U*bAE=iByxOt<I*BTNZuf9VkZpuEbk)wf1#!2mn!}P=-HD1GPkO~*o`FS_;z%_
zZV8@HTs;Qv%ag$35)V07b!v-<!ByVa!@J%d0M*}m@XJ{dmTe_ino`l6l(V1&P$nU?
zQ^H0-faMiC^7E=wCD=~Jo;F7Nl^dZxy>p0oA<x-6=u!RENdkmej*yo#HhR2ubXaq+
z)Ai^{WLtF(rMp$R;U|CsX)be9$-_t#@mLsXtv$32V;3X<n@g~h(!1X)i5OIFtrycZ
zAO9WuI&=BwSBT{jvM&3|n2M-t=$gDnl|;_4*7Hb|?F#0}OFMJ^W>=kikJva5%LenN
zDV7E_ZbIg0G=se)D2;ZlA5{$VUY@{q;(w>R*!o5m>$eCcSlsEGpa1aNoK4~37m&ch
zH%W|@#>OHqxog@d?iWOCG)WeY@YkjJ=nj>42Cw|DzjIYibE$%}EqjcspD>ZiNd@0T
zWfWYIBh}O0UC=fu%K~DZqir<t{L1vYTI-<~jk&lZ?u?}-fN`e|(-I*#6yjLh;vC5V
z+4;zk7}li9>pxj-J?^%><|lW(Lc1hoFkvjYCQI8BJzpc`^sAh^_0vgmwJ(dl8UAhD
z`PqSm|2;CsO*Rjm>ioK?D4T7bfVMnUIH3rsi*QTCgOXDF>LGo`pc#*@R9tvRjTHF6
zXPqwTo8?J+&Vc4VBC|nGN+Y3CfCdUWOwJy7YiUer)~};lVV<EG@4Q~*UZ$Kq^1HS(
zBQkyJ-$_HiO#j_%UOeY{y<Bp%982o>eC{1q_PCeTV@9I+Q;dwgI4mM=NUDGlWrO4g
zk&#vuBa9x>uTSx+G#cfC==AvEEx#)y$l57lM{S;~FGnz}o>g7GXe2ObE~VJxC9l&N
zbztiO%;I9L7resUSv8Fx#z$Yu1nX0+O{!-4Go)b&F&rrj2%X3Pd9GTs@_seqFlgdO
zj8%i87jt#Q6*qM4^cxyQ0a+?Q<dsfDbmK=Dx)?~T3Nsnwd@IT9tmELN2uq|*)6JGn
zXftbvbHci)f&RUfW6(%#N6!?wm;VnC(I2n2TYoh(Qk8B%<)g|R1XxUBR763{C9c7`
z?l;S?h=P~vsz+cwA7@@t6cyLLDTgPIkl$;l-$QUoqiB+Seir;vmke25X-f+r8^Ovt
zz(=A;Ba0BAL}Tdzcz_(YZl!)>;ldK|cW;-fB}TdR-+Fm&C26h>*)g3<C9R*T=|#v~
zR_aa6fjJA47$Lz>TO`YbLo8F)Pv*H=;94b&{VKNJ3U;$_sr>|16M46qYzNbqnzQ{p
z3s^lO)m>v|`(;Jt1@a#MEV<UU<o&s~sXIKKUfug{Q-?faVf$a04F~@178Q!g3%K=Q
zIJH`W3^E2^EH8GE<xYfW1x!rEI||V#M&}<KK2&@8rgUF1VI0?GxxLloE9g3^%$-|*
z02yh4kNgPUY#(ge`lr%~g+n|e^7PAZCeAZl5~1Vms&-s&-H~tE?XptGmzqmB%)kd9
z+Z+X)kiyoPgCcQ_NyS;WjT$_8c=w<pyGPjh3M|#Oil}Wm##kO%v$qr>8BybBWP55(
z8wJ`+Z~;(J6`Yq!E+|*ned=lCjGPeNR7-Pwbawun1nX5*$-bg^R%;NW(TMFRjFlBq
zJ<_<DF(=)yK;nrVW%r~Qn@e{h$vvps*&H?PNxtRJB`B0%NjKYc#YZxtvbL@k56)_Q
z-!C{X)uwkm{LcN|Iz*D@BK7u!TSxxmE<HhlH13wPpRaz$AoxR?T7b4P=SQyNp5Y3?
zM4m3o_*>b+oGC=JJLPJc#%`75d_hIm#4^Nqfd#m&j4XSgVb$1!hc!b`8=1vjU%bH~
zrn7j$Q$4)H=`LpY*t7!iAkil+d1W1zzj}+b(OwfmdF^zPKSh{jxqQbyd{F^=G(Tn;
z5&xDfiMAlh)g(Gal)ViyJ?7z<q)w|trDf}Nq1v(*Fz`uoYn$tH3-Xq$0Qc+}W1SS_
zD9A1oNxzd}k8;+)zMz)S;mTb9Abdb9ap*~3ryM?)iH{<arpv-%jBBM+LCh4x!kuT#
z6tN<spQor)fU|B|X!(qy&vVaM-fpJhU>7XzK2Lxd7mbj-dpSxbBnr!?jHaaF6U-8{
zbr9}zD}@BeP*B=kqk7xKpZlq~PA*~##7PVJm1HfDSTB9>ln3cXR&CvezQ0b1nhW!t
zt}<&ob)xGe<ySWuy-(p+XTq!d;7$ri1u=aLOpIB&_x23^yOVZ^#@NZh$T~QbmwOeH
z=qqRlX5!AWO|BmXU0~vQL~akO0AZ<8VoGS$n99t!DAu4+%wMy&Qgoh$In+KRSZ-w2
zBRfY2`11064E2~q?M3i1bm~awxt$0m6V;V87kHP-v3>$13%`|fvmso9UO?M@Dk?gE
zP=>bG8@;1VF|jRV4CaKzND$;!9)Ifw<1{5s-^twP8vqT_oD;KQq{&~P?wCjONfJa7
zl=dawQMx^F8=Oai&6O~+Hf7)Vh&(kfggvG%RJ*Tb55VU1{OAYOvWy(I@bWSsts`?I
z!krJGYJZ2NVvm2<d=V{-beGf+rDmAWBU3?pE_#0qDvjDb_B}%r=pwil#!WO04L359
zOp)<1y4Gw8X&bXqD(+H}V;;aX>XE=#C26KdA4oGBL{kdR(UWvO3RO>WNV{0&q>Oo#
z+2~y>(Fg3lqc11idpG4qN}|B{8Q|s-w+kyTy<*DQrqS@ItIQms0YIhN`j~`jGy{??
zuRxy05bo}0>B|b*BT^mEmY;V7k@whS-cHPX`&EK^V7JCg_2;b)+512mpwCI%J&C(v
zSXu5{xbKnxdI~awH>0Bz$Q+cx8ia>Wn9JV~#h`5*gx@SRLj@7O9c@+1u=u^AO3ft%
zZ)RR5O1%~Sb%u`2Vrfig*FnJG_{Npump5*t4!jEFNq@hZ<)*B^JkU0aZzLG>=N!z}
zQb7HWt%?76?NrBRECRyYTrUn&M<2<1(X5}}AlUu*eN%ibr2ImV@PumL3!3AM!6!PX
zkgUi{9b1zkqv^c8>6{al7t$qZl6^Cge32Ju>^GUu#gdiwLR8gU`(UGCT+KRh3RZ*_
zTz{G-4eOsh$Ea^8)byNwYp+ybdb`^VVV#Q!_MfjS--uQDI0p##fR|Lq?44oU-18CZ
z>!-bk77iJ^wvEV*S}xmP@*!sEl}ofdPnRhig8SLBIP$DdohQ`(Tisp`M+*)@(ZP;I
z{5k+}1jwT=o4-wWKLHmjYUO4;FjX#UWm-6EXq9c;yQ8l<kr&?!cxgSYOQ|xpphQXG
zA8<;Vz2&p7P+#FQIw9TE3FIzd_snG`(Y&i`ovzTK<BDWgNfrbIBYkG;uw!vfJ})NG
zDLDNBG$1Qzi$#Djp^iQ96_@*Z>bs2TPM4QG?~)s@%Ojy1;m;ZL;~{<i(A`}s;YufW
zUxu}zAkrvbHWdsAHxVo|ZO8_X5RFJ4!B7daU5kL_K8)#(LpoQaUPD#=6o^mp0O2$(
zCpMD^<R{uXiwiFUU9bL2Xby+P?yjuFgZdu1^$kT=7J1;1rTNmrtubun<Lg%Sl=Bye
zxFemF@MB(>-{Yh5&{v!Fl62uNf>eAAm0F`a23Utn<GF|m9fe-8sjHb0mgXh8*SVy=
zONGOtW##qrKc+U9ZxtU0)SN_#x8HfY_=|%(2HB!zuggofk`h(6B-a!i8kvDLJUgNc
z#VMng1K8S(h`ZmKy9Pg{afUBU=GG3lE#L_yqx{cS8>1u($PBl&Y8iz#O<U+>Eh(sl
zks2W|%hX3^F-9Btj`u7pp%$PsOlOnUKKzs|PmyokG^>$fEHXp~O!qp!rt*z^p>%sY
zvZSi(KfpjYvth1)aDuj=9?e6=U%p@7i@B(Yw^YQ6r1%y|A6sP`r^AjyIg7pPUzB0q
zal{NHogA1ki%K>twyoF`0rhO=LSMmN)x3Y1pc@9;Db$w3f+^Ll`V+O(s~%lT&Vogy
zx(>u#1U}1-a+BY2olLW-LVQqf#Ye&&`7Cb%SnC%I@CQd~iQ9I7ddQKAF;Hn+$hRgv
zKD%=&z$>hGUuCQ9NQ&bSm9^8m{Cx=2Y{$FcL&>4F3BT9SKT<k|5Z?D#^UAFFzQV@S
z1tw?&fYZtAtTcons|i`DzpvanTCf{wv#`-I?-)K(rkoTGTa*$?Wy4J}Z&M-1!!Uh~
z<Xadto-f?7#%4sxf*sra<i1uZ81`_-X%Lm<R5ZsVC4PcQSH3Jr58|GC_|Zr_kj_gW
zL1gM)0P&U#)j+0Pe$^S?(Fd$f5KS!c&g~p8;#sFWR_?vNEA>Lk!aS(lMCiMOm)B1O
z{(|nL_kPQ3(g+qENi!!$Ix!@^f!EidLuV+!(cRm!M`zhi)W^3Yx?qluA~H6Q=Wc=P
z=dfCX_Ycp7DB=h?+2=>P?TC6#U)j18%@n=o(gn!mrzvkn7@}!+q)1DLC#^98T#HLo
zBZ}sUeEn^M+d-3vag=%oSWsAaNA_WUuPypOY!ru;by4WkjF?b?93U+o)(>~2ZR?A3
zh3yf_vOUDmD<Odx(a}<{J*ZDL7+;WKs)f3#<QPfhH#;`uW0jDL^8Y4-W*&Q2x!=#r
zJ&SWm@m$(5o<DUhU{>2QpuMV8P$2gyuM{7{s6uynOYrD%bN6SRr|+ZfZ;wVup0Vi2
z35m<Ei-o<0(K8(aka>ESiUGAyGUoZ-Y)VSrzz?BUFlj-47rsXl&jKP={8Ze_JY2_%
zWoO~lY%Ilo@@z)AG|N$ddMk}Y*Tv#6Z2owLsz*6l?vRQ<3@Xx;D%wD`VU{l}vIRdo
zworXGeWxHAhh8n<FHFYCYPe|jkxdT7Mn~qC{gL=^)Wd6!jGS((pts|r{%a-_ue@9^
zP8ywYobRSXeAGbN`tk@dhR90$l_lqb7JE|ZBnxXOAKcB%Mu?8HXsg@R;M4mbvA26=
zEgqCl9D9_jdOb9vQl=L}eQNqhYR-xeKaD<kjwKq!S$mSJ)5K^AGd>R6odEplxV58e
z+VCw3rOaYvadk+&perYsitFIZtT;dGwAx}7jth&}scbK-NM${>mnWw`M>zT#Y!B#;
z3%<Ep-P=_DxUJ}$zw-Je+v=@d*=OY>UuGM26TU)5jHLwQeO8J(IE+}VA+eccy36zJ
z1_=580A0PZ&mrY}DW@|XgR)9&BUGyPsk=R1Z{~!NiGU5I-|sVqN##hjcE5zwojk(!
z(`C%Jn06+W*n8M_5@K$>L^~xu&LaE3--dttDdRK+_$4Q<Q>?((Y)qFgqcNHxE3$Gq
zy;J><c{DH+91=Zis$5Mwa3{Dt*Y>S62L+UK+CxKU+o2#}vwq`-6IMf&O{N1PHmj>@
zL`FCv)0j_|N+ng#Z)S4`Uy!qVaNd_|=dB9={}_b}($O`5J*DAgB&jdwQE!ap+9Q9u
zjmqdzLGSYLO$;+f*9r5~OWry5F8q99r2joAv#;NQN(d7t3A$vkMrizYBB9ZY=vJEP
z6Kw}O4BsI3hh9HafqP5eXp*Iz6(rz+fHEYDo#4xZge+KE_YH6%_4ZdJBec$*kw8SY
z*ocB_;^-dH7VJ(JH8u><$iCE({`cVkS{M4Ou*S<evcORo{qNBnu!@9ewcC{J;Dr8M
zPolLQ6k%bZpWHSTcMV)kJ(}&M&Zs6@1NXlK-YkU@UrP!i1FF&bsH1v#-r6q7AyYHY
zF|0xlFN~~-@67tjz&5#Bi@Be!YPWHQag0j}Bidd5YU$yuC!i0tCJ4*I7p~QnPw5Qp
zjz}g$<{-g`*4f!{ldOk}Yl@<Em16e?nIG0K7E)y!vIV@a88vzU7viPnB(pX*_Z5kC
z;u(;#IkwQd-9akd;dFm^WYc35+151R7mj~*B<3hWokUtcJNL(eUe9Fmx#C=M4a2G|
zXAkU7L~Y!1QTJYG2@4JyZlpg0t^_PE<&3g#_~vJi>VgEdoyZ0J&b?MsV60xBuFT({
z$WST%Yc(wnP8+F|rOnQmQr7VW@etVZy(=P{vXm*b=PrW4x<sPvbwK1lfWUB3fKLe2
zhxS)>LJOFX3orOPODVZS*8MS{+QBkp_f|nTiwJqjsymYsh>Q3Eh0MEeYjpfrW&L2U
zPf<(tEVcl~ptFi+T|{3a3Bd<@Ql)oq3_w*BCThjxrd0FveX!`DegbI}0l=WXGDXHu
zYe^@+`V+VS>2a1yLw1rUg^q=(U`iuQxBJS~2EQ|(TPzJm5(!x$k65_~!9g|<7~{E2
zgkqEe`!12%Zy!8N0By-i3pvw`bYfR05Q0zvun)~zm<n*ja|pS_>6m3^AVyI8PIO_C
z12Rxh6G!FC_&kY@U6#;bZ4yW(e7Sh2X-YDKos+hUOdgqga0>T&s+9KCMI=6d``svY
z+t^_4FF?(gAL9b7?mqXDND`XHxbn0|gI^>iofKPRcy9@8zy-Mcp(9Zbpha#sE0G$$
zMd#AZY?<P$`{h@)^JvmbgKU8rS!Gp!LthbNweFe!0N?btJF@3;-<U<7Ciz;-jHHNs
z4tQi*Kp%^o##8|We2I{yzH)J29xfW?e8zX$KYD=^BVCdguXop~!F~Y)kv<?a%LJao
zl-o{Ls{P3BWl{~>7F7n!@vB&e<(8d{Ux;hQ)78WZaT21lV3L{0)K1vc`MB#k!s)6y
zM@DQfT8Q-B1E-6(OzVOA2Izmza2$&;q}#k#nnQY|O1xdouqXrbLdS^yYr`!>Pn@Qz
z9mCM~kODmZ6PjM>OlD}9v9JeTsoRkUb57-Y$|tDL#^V1wg2iZ+%V@f|TdqJeMKKVq
zA@`gAo`N#GlCCLA&l&%_(yva+#h!@@BMSg@K2TS<2I{CtvMHZt7^r&9J5W;Uszcow
zk=XGOPb&pwduVebuZ-l`*&usZ|L(PDlHs{BDxXqgq{?2e0QnK99o8(tID9UUkjXg|
zzWe-~;~w7LKE;h)!UZ_SY%eU!aU^({N;ot=awY?yin4@`v#3Mwx+e^%Zx2%n9$=Y=
z*;vS4TCJ`X^Wn$@_HUazlfUX+k&cETV{~@uKq|n82d7LV3Kyk)6>nIS8xN-DXe!Kd
z4}&EvQ28y%cRQULNhb5R@LTzj)|$oNUGwXAL;<m0pIe4dFowKkfmW!duPm7ZC0tWq
z52y+|fI&@K{Vs8vRrJakkwqacdC^)El5V?>r&iaLRLU6#P-!L5%>nUivm*PJn{?L>
zo@Q~;z}92dq(4@!RP2tc6~g*O)uc8nO$iwt(M6Psv++%##hHblT%+{}Q8oboDX8ek
z&B=vm08R(u0Z*XmK$k>4$v8d9*R^Lx$GNJ2EAFzmm~c9=9x2Vfk(*P}6^fLTk|In0
z3KI04)Hf$%?|)fUxSB9ci43b2|HM5@i+7SpB2e?!HVi~xB>&+CZtN)g<7zyT*gxBz
zSIP2~F8kB*u^($oM0Z4SaId0E0#$7~hlW)>{8O^Bv3FCbtULV<c8b%sR6e?%)pc@S
z?oFOpESD2@o>B3A_FAoZGw|<JwR<1Dko-BkthRIGv)$%d#iB9)Fmk0ssBrlM!j-5d
z9EB;FyJ~Ps{}5fozuL_EUa2H3Ty3q*Kt=S(Hc{QWoS`!LcJ%ch3$Fn^gUN;a$Rd{!
zB6??ard64#h}b+qqTqnKXif-H35WkN^D%T^KbbnKph&}#9i5%mN_OCGb`@BPDz-Zh
z=c_e>@K84<`T7NRB>&!Q;0Ntrhkc1}q4?v7B-aGOasbFKzw0)?U;FQB0ixQs|A3>s
zok2<FwOQ4q)c1>;V3scS)F6t^EtcWMCyb5lq4Xvp7Eei_s78}M`WNZ0%~bxuR_25B
z8y6w47dz5Kr$96@J+K&Zc)O>b?hd5qs&x=5ueiZiQ$A{k%sItSO6ch7YlQ!x?+z}H
z6q2XU>W2zHlhb1xTO97;0{W>Q0ToVru!vlirNy(lIvco=cTS~D<7jepNrlUUOxJG7
zktDwmm(pfPf;_8oLbxe{ShLZIj`niY**M)&z*w0I7a<L1SEdKN_)i^r{)rd=!UWmw
z7<Ka=F6AOoo&H@BAfZaJw2F2%%G@LEM{)urLz^mlvEmJ+pXehJ8s9i2O5$|>0T5B@
zkMq~H`Y+xl)1;l#%eQH3e1<<aI(4GpgxTYqa~@7s>i^WqqF*S#z028fkQx%m5_>EF
zN^-i7HYCUTUKUl2GI`NZN#ak8N0{~hC{v&Qnd3z^awd^y6Il|^b?3`-91^stRgc*?
zcZvxu%gX|upQ$>l&`RG$)FpROOX!LOPw!~Y_<}|vY7|&8@*lu0;Pl?x!?o6Ujs-e=
z^l**8h~C!nqfI}X?X5lNxZ?<pdAS5g@+kN>nw{s+S42wyX^imL95LNa5#SA%$wsXC
zwIS(m--0eT$(1~7v%>N4l7xlTxGevc<H%5I@?9%;wUdyW-;j_#Fi7FZNjG=pWmi*d
z8=De^3)I940~$%|b-e{>oPq^`3<iYoEE(T{I&^Jhm-y@a;NG+(`4wfdA=NB7rX0ry
zgp4s78uOmZuDK_j8q1HzwiEAuA{ZIWVUUHai;+WsVS#$*I{zmjLe4&AU`C_LCqHGY
z$`8w7j7)6eD;Wt>$zWX&mtL7fj|55hZl%%vouFRx9@9TWyhLr8WD`hOsR^PHx8;&b
zToX&QsJT6;qRJqGVBIV7O0{lLj+d(6B9{7Kc=?Yc8a8~Sbd5qdn9YW{<|57bkq?Gf
zjGku!2-gw%zMq_2F~mKNiS*+f{wNx3r99rvvq#}s=hl4Xz9-v4__x=us|Zzu4DytS
z#vh;qGiPT{b=@ph<pyR~1=UZ1nB4Y7c2=bV%25z#2$=;g7JD?15il)9r99=%EFnh0
z^T}*CI_0URn0%(GWVV3Pmycg=kReT%mo%+Fa(iHO2DY1jh}s8C_w{<Me}=gI>0J6+
z!>mLu9DGJRcic}|g}M6_CV<871)ZI<Ae_{z-kySQ`{T$2H=B0-YMT@;eKg*lAE)|5
zR})eyZ^dLCyJ)!xjO}vm4Kb%Itq-#r<xCa5Ije`YLu3{WQZ~(Fd8O8g{x|3`?M-gP
zj3`+kAmu;6zmL&ol8v?Rm;nF)e%5n42^~!HaQ0>Wy(ig>+7!uWk#LSh0UXu75=@9=
zTSKP+{O{6X&@6sODqr?=$~)OlI{VNdT_I}wnci>VzjKRaX?h(iL%Yg{Aar%qwsQ}R
zH-(<aedAB0-{2qn`x1%-vi8}d_W{3a%6*d#$v%L%_90uJPs_BJK5wd9PO7M7iJV3?
zak#U@3+!+@&9MBGrQdD)9<;a`F%iV#vf;!OdDq~_{FdN*5Lt$q_0pxOkc`78ruJ4V
zhM-5DW-@4$wZx#NQvp3vk&$kaFLZ}ITh$6*6uSp=!sYtu5g|CVU$cee8F-V1>M9N=
z{1A;XziJ!W0Ay)TjRjOrca9!}9}Cs~kD{}1Yw~^j@aXQ4Ni%YUG)%e&(u_u>qy!`s
zBu5K##3%tr=P2ovuY_zgNViA|NJxr+zjyCHuw%!w<GFWV@i|W=y#o41!B4{+xS*eB
z{u87mW|1uFZ6LA~kyQm=xXh4u8-X!^^Pr~sK66Lc-|kiGMb)VUbE*8VN1SiB=O7H)
z9$Hddj>LJv^z-;HtK>9581Q|_%KLQWTR!}tgU;S?|4Nv}%3NdH{j&P3l#PPl<&9EC
zAX`1Jq4rnezTUk<*gE&R5-Tx7@8Iin&6-NjF;WGhar3u*G-;9lXh}p9cLiE)-L*xr
z<ba^+2X?RZi4l%>@o#n&SrvFW<lo9JG1xNXf%5b9D{>!cjrqz>UZ&{Z?olBZ)WqQ#
z_ifw1l)17F&sMOb67;Y4h+19Nmj<pv2zyDbQy?{+3d$)^8^bNnlZA3Klzt|i*rhVl
zv-rSDlGe^wB1vK<27NCnNa|*CIKpv2j{C?gFO8Ah;h}e)%U=eE@amtf!Ky7XmM$OH
zbG8<5#S=?`<o2$Q!5fz><zuVVd>wGBAE_(^np4~#zSu3L6Z(`xPNrrlxcI_9S*+JV
zhkJ)@J_N=dK$t_`THolc*QE+wdj}PBViLI5>zy}db{~jjacFrLKHAVBm1_JSARu(U
zAz3SRtw4uYlb^eL0$<ehjkt!`#4$`NBLmfSRh@=6Th^ro*iw<^B&JZQZ~pMJ+&+S(
ztmDw>8=)2)3)~%ltadB@wJ?y>>MQv%;s%XlLgDQRPZh~HZ>^@ZU1I8{@mqVzEh2Zq
z=AxOSNrBNR5k|IBvB>Ss{GFz*82l6ahFRhs=?Qho<9Ih>#t=g`yj<9v+9j$rs`TzS
z)j+vz)g*i1v^1yQ98rA!0KNk%H)Lu%8L7t)@^=bac@n+ZsL-?LtR<#r-$AkF<fkEa
z9ee@fXYF<<C-15iT#tlPRhB$8clRIjT9fX?!cS~<ymVu#FEH7xBhhFki!t*g1GWI%
zP9IrkO%2g2Q*vBGjsFTg0nMZ522(NetFib`hoojsrp%qG1xI(oYpl?$hGS|oo2F9O
znS#*Qbsxj5M7Vs0x9VQmE!B^alLqeFcCK<Ih{@x*jc)H*y>T4rtM2>rZ9d}s)Kb2s
zOD_YID6E8S^VR~nG>=DJe#)fcSjvgREZh2P7Jm=lc|GzooJd$!Pd-aipx&$V)MKnB
zXq{B4Ud9r~;)f^j#~5<bU$bq}{79!rlOL7d;e{WNbFF4LakK@(S?$s&{Vmze^urgf
z+`<6r-O96xx$TH$4|Dz@b(3(*ZBr+FA6ADs{BsOty(bsjlK$BcFJOPZMgHz$qr)YO
zQ)zk?k`fB-|Kg~bu2`u#=3=^Z*jJb9WVPpU+p%w3TOtqluH<s(faPJWwTF?k1iO{w
z#;frhS5>^OQmEZWc3tEvNMsZ^gAbZ0i0_<Zrnny!9jXIQCPWTsO`J|(S{hLVHzo#|
z)Os_m!c<5?JUtSrZ@ux`czZETlCp^4&$o`_ZQdI%u7J-4SzulX_}iX+hZ_94sklI}
zJK%omF}(0!E5xRopkRQ7p7@h7i7{s8I-K%j{Ci-sIF#KsMY{KbEAw*I*`j4uDG=>)
zJQt@g?{|+Od549r`l%k-n0FADYe%JpKrjocHrwv9Nt{tn{VG*sYUS4&iyUdcb-yy1
zC~+)y9?(Z~eogteSeBe5AuWX<P2<jb&hY7(7reU@lrwt|cHgy#?NfHn=MeA(enbjy
zq=ftg+m=B$t<M>9I=G$#{#q{TzJOR0ad6v(=z3DPS`zX`7xY({7iUNj0)Envo4?3O
zmysrwsyZ8<P!Sm{VQ8wWRYqmZ?j0K53_0`U&^d6x8dRF(u(t%f9*M+gA5}a9B;b_?
zTxwU6054|0i4##Z`nJU_^Bb1aAOt)do;1(^`}BEIOsWe%5FZ^GTO@8%3Z*nz2lkhV
zeSfrLX{9HoS(<_72&%KOn^z(kJin<O|BSlUD=HiI8u(%VrrA_boR?eGnhi9w{NXw-
zipnL}(Bk0}zP-`5jv=7fSA<j67)lJ!|8L}sAc58zYbCEFRlI(I^)u38-?U~l;{7}K
zb1V0#EYlv7s489NT6kLYu;J@@PGb6|92=S9PdK)0ndoubrp7i`mWW4kgPAKLnC@eb
z<zCp`P4E7pLBFQ7<B*^Kk?BsO@b^ABXUJ5imWQN0F>1Qh<A<okBifMOaaM6=c$oxq
zoWpkLH;RC-N)>+o%Y{uEQtaK+Sw>$8DR3G($r8%(z?){&VV)Cz&}L4g*+gKT4s~#$
zRM+dvlCLNw{f-~T3NY>btpcUF?d4jneoFNDs-?ae93J!eOv-prP;iHhP*X27EpCxc
z1I8U7&4J;HNtMjmHk}5TgnH7zizPUzjl279!sa<XB5TPx{q4+SyNuxsw$qZUq@=-C
zjk>5HUZ0v7HO)ZdRB^Ct)lJuQrj=S48K;i6l_}al_3~+S(=EX&^(pufnzb*S+rTy8
zm>h2fcx1M3Q6q85`vG7s<)|R$!Z<uMDJR{HCPcZ<!o&`O@7~X&<HX?FzZa0^uJSgP
z4pO4yqSPCi&nT+0ayAm!CPN$9qxQR)l2@nP{auoQ`s>Vl=aqN8(lH&la$b*Rm)2AH
zi|cYlEM$K<#vu_Qf`@f=&*v4#rr1P<K1BPFsXA|4=nI@j&$L1vIPBRdY=Qbf9`v02
zN*a-ZUHJP1mvfkxE<S&M>5BdbTL$tx+KEp0*L}O^2G*7$5HwAX_!}XT+yEKDx1Nfn
z$*jQmch>`>t3XRCqazK;{k?s2Ho<&4m#vSdV0IkZeXv~<RKTylhmJtbqwoy0E04RS
zRC5(2)4i<CEX`w%hvX3Dl*}bl-pjvN<&eF7V^C~5ne2D?kLQNhwYjtLWYIHqkDQFQ
zL>KBFMb6est=_&V=RV;oXqm!C15@s<%7_wzQt~~wj<+}uB;Rt(ynBTw&-@QCxbVd*
zDAHy4&}^?#Wq++ps)#K162qKUQvA!a7n%C82jJ1a2M(NUea&jVY16ci*eP`>{2Xdk
z-i;nShtu!F%|Ld(V^^H4KUENzTr9pX^mOfGXA1p`a7VY#FLm;CdfKV@0swt`h$~K&
zjM4X5n^Jk(XcOPK<CLaVYy;6QZ9%IKKgsstY@qE_i0}JhqIxJMIQ@sEO`+LzCz!KA
z;(<EdSn#VYL;?S3%t~`xQIaIAX?wHsoUklz!}T}Z!Q$ye2a^mRZYB*(#0&OguTy`z
zy5Xk~;N{=wlLH8B>)1VhqbpC4RvXMT2(9|n>FggnNYN61qZCwQhD@m_7R~ZcL@3cR
zqb@7sm9{p{Ix&Q2xHeA>HX)&Of8+jL_MHEwir*g{_?t>OAIqb1O*Vv`Sp%Lhjax}W
z3Jl@A+){&2+z<+n1c|?)sR>0~#RdbIY49HGWc7NIsv+mWCLK|EXJttxVa-OSvM|7+
z>OQ0j0GHS%NOL){$p6J0-g#1J0K;>E*>~_ADOPa!A<4Jp&ZQJj1))Vj;tJa@4zRKc
z8)oy)A;Idj3R{!Rjy^1SieEcAZi;3+9<EUs8W<CfWfblsI>pciOAzcRnI0xK0KZTc
zuU0F(&!x*o;{i~gWE?`gbBK_Zxl38UqCP0b3N5<TbQ4AJfTfvt@s)388QqnrEO*GM
z)Jfia>pO3H5lZ{fNzUq8vk$X%!^wUhJ8^ZsJdT(+h#S^K9bD9f2>2;444==2iwwLT
zwBfY5<o6SSnz2{;u0`w{lT`T}rLVx?GO)4U>cpIo<ZOtd^32m9yZ;ENjf~A@5rnR3
zL+U~Wtj)euE#2BhJDr11f`}7mLq5=TZk^3FnP4z%g)LDGdZSTfUYTMqw~O3*<M7vq
z&~z3z)aipjgAk#jlDyeGBq|7=xI(EfwGrW^&K^HJ@jVCO<=3p=0eBy!cirW0@?2I|
z62&UAdR6}({Ugnn9t^0?0UqJ26uad2vfubkm0Uom*=zpk5&zZ)ia7B@GgcnM2Ru1=
ze}}veISN{$gz4={YB0#|#fEK`=sraf07c@jE=zQT$XOa5Kq|g=+`_;5Pr=yvX0nWa
zzt5$WPuDXn@IOJ&YclBPty#j-q1&@!7GuMc>-#A!`_$OgXlKhOuIUiaoyaP=NuDp~
zn9ECCD_LaN^xXh4%c_YXa_@JUi--=PE8tND9{49S)GijCmGin6<2zWj8ZlNB`HTLn
z<;HE2>Hs{4Hr4w04xY{=IMCo8uX?c}8uqq!{rHd$1fd^Tyv3I=DGcCehSyd<i?1D1
zKbsU`>{5)x$(z}q-qaDF<!`iY%~!{`&P%Y_McJvdF#7>8JGt77aXMH@DKqUI$IN)8
z#os9<b$t3<FTW;e8yT1_WxeH2t+P^f&#n`!3n1-llT+rdgB$UCw|)9DM(Z*}S~SoC
z#xjE&Inv*5R#^)V7s`#~&ibl&)&IV|``}G2LjAVJ_X(E^n9d+(SAL1H<N~lw3$~Me
z&!#-sV*MaR0pdW~R~4+7Eh%ttLxNwxR`n(wJ{uIAm+9+0LG44m8^zM8lC+*55Vvrq
z;E%3DOV_Ygc!p>M&w)$|wt$dKO+w#k_y~HKYfY;T4n(;A)BqXvkS!<O{QFX_NVUsI
z6fDW@CMFrWS@561iQohA9fon;rZJEsFV^(a9xQHTS{CCAkI3&mEtS&>|8jof8yUG(
z`NMjLvhnPN7{{rSTNNa2sHi{E4L6-I0u4{0E%YdW+rewa{FL&l%$bCRCT@Gc7b|+%
zF)Sl1fUg|ef9L$!)73&_cQ4BQ8hRT^9hAcn$?d=>@(waJIfHM|CP%$Od?F}YcG>vo
zYsUQh3}+FRWyQV#7Cps_>M@I#ag@fP^Xa(?_j6cyB20WIRUzEeT}Vmqd4Ha3i)#*+
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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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
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
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
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

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
zcmbW%WmFVSy8!TASawP2(iNly1SCaLL0CdWKsuC;C8S#<q&pP^L|S60Woe{KSg9qJ
zPD#n7;qrgqd+t5we!BNQb7sEGbLPzNndi*S<jn$rLPb$o5dZ`N0KnS;xWNMC0fb;M
z1WZ5(fk23e2#HB)$Vf>@NExZ9$!YH2WoEj67YcpA&d>FL^${Bs`tS+&qsM|GA|lLO
zPo>3$r1*tJg#I}MNJK<LN<zv&M#dn-0%Z~UKgZ2a03{*dBj6)GkQIPO3B;!a-gE+(
zZ|_L}{8s?}Gk|#bAObLikcgP%HUUWizyspr<ALxA2tc6QZ2#MR0Em)+ibe1_m|DXW
z!s<*T6qt}h$R=0WMyolz$1ZH<5=2ByN6)}`mxGh*AvceRsMr(nrxNln6ck}f$|_oK
zv~_g#^bO1{EUm0<Z0%g#+&w(KynTX0K81#bM?@wjC8wmOeg2aEJvT4Eps=X;M^$wV
zvKCcW-_YLC+11_C+t)ubIyR1(n4FqkTv}dPU0eUNvAKV6cyx?AIXyf7#{~r7|C@EY
z{u}l`T$HyiJP-&U1o_7W#PhtJ_>>?57C|u8a}9{8Gc~JFAR&!hLQZ8H5u32)9<7<n
zFfkpw$Rfx7KeT_z{&%pT|Cj8)VE^r!29V+dZyyhz5+Dm`rfFduvw(%pjaw$|cAx5?
zFA6UuwcIu=Q_p>C#H;LK4A*;TuEVlfCxzOE1ip8nQ(T{E4;g`zb*o_qmv+djWCOLt
zxE%qhPBCQtG*~*!X{bq`Z6i6!q`*i*EQRmtc>LFHwGlzoz-(ZTpXUu=OQ#^s38%(-
z&kP&wN{e2A3rSWM)}-;1<Z=z5%6;FQd|;`nKCmBK!zml5N;g?3)UBLrj&~v0h~tr8
zm?N9iO~2_4;8Mw*S+93z)djBc=bAXz77_fbnF()tRUI^b7H;~)43!nB`+HoheTi^-
zzAgQu3E#u#9r3w@NWHz6R?%E0(GHjI)6}KMEoRX2)gdytmzH6a+;}WP%1Np(GyKl%
zFQ3E@UrMc3$xpS+8A6yf;kKii9xTeaV@L-fe>@vdLu_Ud_NAQvcZ^1|6E3X4_o#%v
zK^pgYQNV#SFm874GvtpiCapX4u<WS#!4&S@0pS=hUJOzA>QYz#o1e-a4w2uHzlHg0
zu_V6age?D)SsV0t7RUyHfU9!8C<_F<Q8Qxo={$`2j4pcum{40L!{ejYl()fdm(%<4
zeO)e4^u^s4azb>__su3xf@Z|}D}Mf8jx(A}<jqpn$GHGkT^EH2oS3g?3G1`Tr4qBR
zxtt&Cr{F%BT{SyC72Eo3lw4UCV(xvAY>hKrdhZ`wsL}gE6H0=)%&BkGn@^8=ntk$j
zBIo7VT~<m+9Yp&A+DR<ZIF%jBh}TmrA+o1Cel%2XDRBoG7hLpQ;aP)NHTMfuM}`D-
zMaE?r<fB1)94@1|uOYsV4SY>|5Kh~;bkA5;2}MMPta;hPW=4RJ9Cpfhy}u${Z7une
z?YH7Mg7tlJnw85?X>y{!e$ux#QA|A?M7KX9SqJ9+uyyC`Xjy7J({36w`o?Q}`~|^t
z<FY#IR?#&2e!UV3CALT<AWwTskjQj;!t$YSt+Z-e3$SvcNszzN;Zf)Y-&zRvWh+aD
z6>YGOYj&ASIwVNcU%w1Jxk{(Wi<*Az_`HTn5hmX)_*b_kAlx7|&EYERBA{w8IknX)
zLM-l!I(ipdkH$1Oead<~;wM;$-8f0p5^4C<gGTR`g+3-a;VPFjAE`=11}Aa5G(zXn
z_I0&K+^S9C4uvm5%>6w25pf;Cr@=bNfC!yKRv3lvg|~Lomg;~T9-aM47wbZBkgxL)
zPckzRvfjnQW*HwVYWVupyv*R)NV{1b$vAyzmv`E?sfq0p4qrx3CSi=DgF|W8Xpg0R
zPjB#3%IKrMmAK*^<6rCpR5Fhl@J%$>sj$C>)$aAMCNk>1i#*O0K54N0nmJ7)`wig)
z<QraD!VJa=UL5BRw3R4I$OVryOMbNgI!C%7)-~<d^Eo@R%LJic-_rWYGwVjQN%!Q_
zGt;_njD4)#^c9;~s;*H78*iPkl1OGsJ^jO3r`NX*#qYc1xz681b*B5Zyq%)+5I{<$
z4eduK3J*zIEbk){oxf*(IWn0>xu%S{8(tZ#p#5FhN1z8iA7xT<7Zz^-v<ijg%*@6y
zk%Pu!$GaT0s>*XVp56(i7RmVKFngWW5VnI$je_$UtomvsCQm@cWBZpaYKL{+Rjj*z
z33trruw=`TCP{M#dB5ml-ryJ=3U{~@RYaz#>Ow^l!59B-2F75dq+18Mgh%g%Cgj5B
zc&_`fethLs6)N8t*&OTHa+r|w#B(P(NrAsq3WHz}@e`UKg7#T;q8qI=O%&-M3Hw@<
zN46yjsRvT$oXYd7w8qYJl%zNjy~TQQ`nw#=*~rbnNO?A5`ujUkqq~^O5=P(7gBl-P
z>yq+O4@IZ)=dU1z0m^M&4k-<(+SOf=o#!*f=BsiH@7%?=v^KNur*3k;Gc2Zk8S)Yq
zAm?8JCsE%EX|S9d@Ha&>GHJzooqHluHRA-D{O=W<Lr<deM%}Si>AwT=Iu(_A9$ZOG
zz%1?GRUl(RiRFTGwjwj7L<ySr;O2)S4uNcrul>V(vKX0`81fS+@5j>-ix2V6^p_~~
zwJ|YS%c&6OvS2ZB0%ZmVT?CJLXX}?}{aWp`RVu3^)v~jjC1ZOE?b7|DY!5n2K@^af
zju(M=DQ$fKi#tkvfUnH?epd@|kWHpX7{pQB4y4A=lB(CaZuOoG;08cGCl$HHe;H6T
zgEeHozBjtNYZhfI+?k`@)@#u=B!Snwk10KU(qV8s7xlv{eN>xFCfAaOqwEJEVX~#R
zYc~MbBaX=M@|N2*Fv4lSz<jzWY7$*g;@ZPxaA8H86`#srpGu~S5Dp$Pb)LJg%cLx~
zFo^GqB?fG4$Y$EuiqW6Hja-Y;4AOHnMb;&xY6M>w*WZ4b<4#2SMzdbQuTlw3losn^
z@-2+E88`i#w_pUXM9qCKTGuok>SSdPgu2FXcT+mB{pK$0;R#n50;S6s)f{+3Xs~E!
zx_vv*YIM)~!?SVU9qAS%XLG)htwCX$TO<1yznu`5A5(0ypDa5Cd3_cpatVtSgwqX#
zojO0T*6l;5?N2zSmq-*)36tx;cnsGr!x6Bm(@Z=+!RAr70$<-9i8=O&T_xAYk7#?D
zrmo;UJ?CA!Pm97R12^q>G^48SCdtHM{N!!TJ)xMB)Ft^(iCj)i!XE=juWPDjl=eju
z+2O*mQmHetQpD?X<aY>}FuaXAF!e{59j@dEOp-jZr8Z*3+i%iL(meSFK!ro3BpmZ_
zvtkYN+u6f1!VBgIW!>C<tdQ;rPB84~ERFFwI;=eIx|mdbvD+8x-)vVTJJdXro>^bu
zckQHeS<?YcC%krRNe-cc&qzJbvx=$F41W2@8=SwSI%ud>(>m5}G>9K$c<*K8J;_(H
znbs!Cq^KmRdrhhFRbc2RG_AqQ_dGLnF0cB#RJvhvU0ypy##v1)5{OiZN_&myg6Ai4
z3E4g;PDGo<MW-KT4=?_N_Q}pMU)k-q^09v8i3W}|WD{(1PM;fk$Tp-?IcF_cpIJ5a
zBfaxh{PBJky<XX>pNF&ksvw+q8|*zkgMVro)>Uc^ep8ht7x9pf=Ia8JxU9;Sd*3xW
zfX4Aui_rB3;1_UQk{+j9y$^{Hx$WU;GcT*J$bs1CsKey9MJ6rBD~q#svCs^6nyVCX
z)az~ik!!-m^v8=tvyIGYXGeKaswu;XBi&uUf!Fn5S(SBUM#d>-?n3P$Tc-9j=LsW2
zX(KwEzQM1JEJN|q(P8#ON)vbg^@ho~f}LlA{w5C|+QE^{1Q7C(ha_s$$!@<BpOzH+
zCLsHOH@;?nsQ8ECzP!_FCuH8L7&C{PZ=Wu^9Bnj;vQBXR8SZmsm%@eqODR#3Qf;lK
z%u;P3ZRxP>j49nNm+xQ_L$%_KYPz8suIZ)Nvlrl1_#c0+OY?43RD^Kn<F7bVCvTd_
z6OSrAEp}GYWmegE%qkKb?W}H^{!;6iS5}+@Ev~h2`j;>biZE9CxgD;R`qb=R^IhFQ
z^FVvkS&EAvG<Oud=8~YPO#Bs*i+=SiEipz+o#KN=`_@qcP4Xqiv<)e4S6ya-Mj?~r
zpxE_hzhj%jf!>pc+HP+pX7Zhj+AFs;jp9@+?jGS>AJrDoDS*JHS(CE)miua)IU12q
zia$?e%ynJC^v96iptO_3p=SWF6nQ(Ug<*yR(dj@30|g7S^js(nT)`91F|nVD?=zc>
z9&;G4VHP>D*-gM9UZpM$3+Ja|yJ)leiZpe_5q_*2PHnY1ZuwQwe0aItg_>%{U|jEv
z@Daip<3{2{{b$e4<6)~kMKJX`lfAzjv!mA$dP2rBU~#K4qO*2b^&qL)16mA-zI(`{
z<+kQ40#_{M8|$vB2%47u22ym+n$gu?CQOn)g%zm^ZP&L@c7BX~ujhQ*VL@=+HWLs$
zE$9aDW^E2U3x!=9$oOQx^YvsqT)qL=kiAzep7i<vIpdqyp)T5}+soZ!yaBY7<dQ4Q
zXTkUdDCsZivUtCm)gEP2+NFzYz+L8EOSRtsggzLz5_e(IBLx~Yx_<1VzYh)6T}NtK
z!#%WO(v!)YxK5Vujb6gGjHL@I3pOPc^0%ofuL1L7GMVsB;pg_yb0*$$@nXJTmSIto
zC)GcT&<2MB<fkLJ{v{H_KB)`E_oWBWCi5+m&)to-Z?tKL2PGWIwIWXo^ST@Yz?FA&
zlw<o^=kAlQ@D3h!`LuQwKO1#m+dTnY1DN*_T!`%N*odu(s(2<_!u!PvEDK*T1;BJ|
zndIc=E)mFY8KzT&>Ee6{MzdF;yMzL+=YVqOjTZKKNDz?X&7X5y78<*x0gj<YKTxS&
zo)*pXZ5ogA4-6(tFJeWk6NbjL8QCXBneVjFZ_qI@1gW_yBOAszua+~yJGRl!gh%nh
zzU_LQbRfb}EhOW${UhkSq4^EEvp&eh*7d|67zF7m^8mxO4{r7?F}eYiH6-^%Uky)w
zz{hK5UUp9ls~Oml>48<CY8#2sPo{o9Abt-JKLIy=#giB|1#{~GWV_=_tc!Cp-t}nO
z#e-q%YK}gd&`_wRuzLX>^-qND-r6@&WAMoOQ~wP18-UmQfbOQ(=|@hXo-Z*IxM;5!
zi~_R>`2p>4NM@nq8tt;zjAvKziIHu5fSb~aFBEtg<BjwPpmrp^=AD{mpcVX^7*OUM
zj5^iLR#nQas&1OvmLc1Ngo(bz6Dut462N*$^0Ke$7I*(0DTrEp73@h7P&4~NX@Py?
zGIAoJqj(<sNl&2MT>B!2;~jxb$I@R4?DD{PIcyviATcUO4O3e}hn9V}-SI7$QFevu
z3w58)(0DQ+WZT5cgPfpVp=%gJTf}AWs$4Xw>hJvxqd!aO)M8SyKV)LcrZ$Pt2@lN#
z$2_lu-@b;+2-CIPk5z?5t8vt)4O*RP0Q#IhND!Yrq@G4Px?gOS3Gs4UdFU-u#0IQ>
zeoAuL%EPeinCtGKv#dY1-qMhem#WkE$mh<ua{U(O^T&0rd^Hk94zRY>%OgnHlZw>R
zkzqHID?2$1ZUkBSvS7&)`XXcjbv6jU0kkuK8DoC-a_!<6(FdaMPDd~phMl8E#_gT{
z?JUtc@z2f^$CsO9Hvo!nUXB_fD7DS+bQiGmmW)Q%?Ck6FqF@(YyB-&}hgjSB33+_I
zz0e$Umm7c;D%H?(x<K>U87^qxlsdAvWf*y1VwyLqQ74i+Zg(;vv^-5?zuI_^B^IN!
z<S}FZ1a!DHQt6)QeypkrH%nw~-|i4{ga%^wuI#)E(Qq4DZqw$l8m*HHhHuoy*&Vi*
uWgom=$@)7wAA<spw_?k~+NcTrj7^g|=;e=joX;n;A-1`{ic9rxrv3wVI|r%&

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
zcmbW(cQD-DzX$N|TD`LfqC{`mNOXb?9;*c*L|H8aLG&7;Cwh65L`V>AwXD8cl;{y<
zWus-4gjJ%fPV~K=-|x=7Gxx81@B7R-|D4a9`Ml=LnK{I1;xB+v7p?;bKp+4BT@8RZ
z184x0<m43OWRw&X6jW4{)U+&gv@|rd9Lx{~7H&>n9&S!9t{Z~4L~iik6yV|#l^45t
z`;Lr^46lfyih`8#Eom94e+~grQBl#-(6ZCfu}krB@k#xkL;MUdQ34S_1Q^5*kT8M3
zOdw(}z<bpv8R%aD{xcvFFew>11tk?V%~b)K5g-A9!6c+$GBQ%qtLo6JeSnmSjG6C_
z8ac%1F$KRji&SJ<0i}R?Z5ONYw;e%gd!HyOYPM_a9GpVJBBEmAGO}{=3W`b^e`&(C
zv~_eJnwUN^Gq<pGc;e{f{M5zO*Uvv7Fz9)3^vhQ<v2pPU=^2@?-(<bb&M7P^E<u)-
zl~>f&H=rAvnp;}CdwTo&2fhq`#eN^3n4Fsafm>L_FD<XE{$5+(-P=DnJo<Bda{7-8
z1c3j|x?2AY`yVc*D;EhVDVUVv9~X!u@M?mYNXhu_kTa_pQ9SmB@JmHfvZ$vO)OJw`
zNE`34+WUN?W)qZI5Ze8R_AlB04i@$QlKmI#zg;+h77V(&JTMag1HMc&3?5K@U|v@W
zD006;b(ClUH|oUkWN%|X+Wh{5b9mX_kV6g&47TGf*tWFgygu55Esl2n5&cEr0r@>#
zNABHSYp2Lvi5^@>7JXJVqCF!HAKx+gsW1RX+2co=#KpzAR*<bD8E&F!#UI?epZpes
zk_V>r@pL3mh_S}gna!$eFQD)7NO;H*5!jfL9SJd67f&;eUp2UOYuIDfn1`WV+4-;t
z@HO+%j6aeK39RJ5H@#SC|Gr2#qGh=>Ztzf6j0l*|4X|!r>!h_ajFGc^Q&H_1T8j9(
zS5iaoM3#6%WCn(MJ`k&X*LzVBEeefB_p&8>bBbc#np6*+Ky37tY6G3i7Ke2Vglw&-
z$H)8;$r2{}P{flA$&5B0Qv`tDDLW+4JQ#CoN;Q6|rd%7Z{062}?cURbEtIRDc73$w
z&6NBl<pIMVb8?D3S>N<bOBT~&*PzCum5pA`q=&<MT6DdM%%7a?Flq$CBY(HE3&}pO
zAtdIe{B7J!KZ>b~2$-~mA6CM8@jSv4u@@?^{c3x3R*wy76a(|R(M3IC+#z-I0jQ<u
zUP7nnreU>>_lAv64zgT#>QDHWHJ2vY)k{YPj-V`?Pv87HY3J6|O2?lS2DY|(gP4<~
z<rF^i9Iwh+e*eswJc1tTTGUtFS`lpmkyfx;ak0Kg!k5$i<d(?T?M#woU~_xK*?AO#
zgVwz*;+XYGZcc~AZqw6+f=kxfprw7X=R5a!WF#aqsm;JZ#@~t}K)P2LI;U5c%?P{H
zER5E|1l#smo9SRjUZEOunVFJzXT&>T^bCu1mJ^pkh~aoHwQa)kqkWVlbd1uXK7%DO
zik^xvpiuGPh4AF^U|LZU!?Ou@jfE7n3s{dT;g_U|&2?5xFkLRs*E+M>EN{Gu)5;`n
z*jhQ@(eR5n=`?oC{XFf{youTF`?UgiP=xF<vl_H*gymbCj~L(U7|Lpk@30W0#o%0l
z#wqpD4)Yw30rc54p10Fdxs9{Ip;%N!;(JT~y=&~H;+Ouyqrt|{6i>f1^;ai)651f-
zvCiHyd>(>1PFnrTjt{P_{i&=tM&SL%_{Ixc8ye1_?Ue?O+D9V-%j(Fj6R6FT0XED=
zqz;7Vo-&v7tXY=0QC4ekg+4bd@i6qd&92!|<Hmx!e@ve6jlt`FpH(OisxXTV2#vzE
zRlStimr?U~vlQf+`mf!I*#Z#(>b<)~f5Om0hlD=D#+;QdR_~U4t%{r2w?FOVr3EF6
zC(4~Ht~MySg%hW`>&ERNaaA^3fjQhAR>^!qz*_VSYY84g1XwkHRzYCai8-U+8!9g>
zm((2G1+iRSMG>m#E`z`lnj`oG<S1RQWx}PCrA?=FXeAWoY=4$NdVib!GX)pEgB-?L
zfI1%Cwr!D~N4P9t9@4e;8!9fP7~(DEu6jhTjWbWKhg5AY#)q*6#i+(ZqC$9e2Xzwy
z;q(3IMimF!UBOd_ID5fi0}}q_xFgo|JkdOa&mYc!4_hX+dj+(&mEQZ89~#mR`LonO
z#}kn1!UCNIs?)NsN{`j8rM4YAYF3j{#l9$q-kr)T;js-m%#|NoZL=1BS2ZIu8GRwl
zF9lbmSetCUE8#%)>f^K9#w^?nRwio;Wzg+t1aEfHGpg%8(VKV2cfR~#?7JBkw;54m
z)bDMxVrqHIfO2PFiTQyk2mO4*^HA5RH=<&ZHUtb~<?@+vg=zA8<7ej=YqJ5;VPeNH
zot^%C?=lPAFn0YKuLy5zBl{qDHZPlyue;)(8r%9N%l+cRyYRY^%s^Y0*GH+@T7z3N
z%>&r7jZ687L#JlmXPFk-Wt~pGE#zZ>f(io%rrkeGYWFaueIc$P<ZZFMjwfyR3fl?o
zjMP`N@9#t1`V%WDSb{OH=kgGWLMGUuz1OtG%%Byt4B{O^-$<~{k&%_J>DEHttf_nO
z^D6XE`D$~@!rUNp-yidUfl~HG^lPorMMH7)h`Vbant?~3q{_GE?@&@VoA`w@6imBG
zQg)=_{s2YDtB<0OBnbpPdx$?@imb%B#4?Gi=(*C7M{Bw~4&gogOzHN3!eMp(ssU5t
zW~x0)aWQUv^!p{GQm}=o&-baBvQ&*C5g4dM)pa0#JEY%y{W!O~tqP+%<%#6Xovd<z
z!(<GIK*-Kosw+W8UuqHOU+2<zGcDWpi~c($J0?u|d8JrG2c+V5_|vA3$1&LcEk)Ee
zv^SPU(BNl~GjPdq;o{t!w&)_LJ?YH#9NHWf#ENO-;bK(zXcq7>CC}m{W`)-lB^>J(
z>JBO1JE`dn7!bP@A{YrcvZT4AunWu@BfSqjNqJk9Onu0M*f){_D!pCVn&kG_?JqWk
z3Im@EsLrEJcvo$<^bKaetA@*0hFLyN(I*X8vei|mlHKCDft7~i#MF>%%2FC}+J`dB
z%M{0xn1loE2B^6UqxSyr+xaE;*?|w>wS>V>k((<a&#6!1yk-yzvMb$%87*tg4Qh&W
zDQ`(Wy5#teqRP}9p1xbjj<8kR3N3##Nq8Q}LcNYuzvjzB7Si<U#hu3=%=?ZU8NB%~
z_ZDI$FTuE4lqr0<`(5yXV8hPg>-^lH9{D=m1gr<1A6f*)en=m4A#m3*{~p};*vLC9
zt*{Es(9T)9h3D$3J*FOdXMrv0tVK6QPP#>4Pu_Vc5b}t?h3m<P)x$j%oNxWp@tXET
zojQk$cdKt>mYc8N8)zY%nC3z(8(Y)1N^^dQyd~e8=$dX`Fx)?PqcKXb@chu=ohUq<
z&bv*!15@&=4RSV0!@4D!zA<d)e~f@_Gwc!!BzNS!^@FqQ>&H#V@^G{8HV_qHa_t&&
zegYpyF3!<dMg(9>W_&LA+=nK~i!nck;utzc9-`U_ov+Y{lhS||HVi*LlJW3#LfkNa
zUMko0>yLV5@!vn{c<LID6gD0OnDH&7UPt_lbSYOt%!SkBF&pm4{s4Wp^UZsGIBl-Z
zf{ol$i2v#@$@j{om}|VbSR%E=?=2IjTE9YR&4{qr2jvjsU7;0JInH+d@hzvwE@(1R
zlP<TEceK7*Fa|N0M>nshZ2_iNUrj&>E3kUdD2h1RmpBM)+qVUb-@@21=9&$0n>UK~
zKfG~Ppp9t{X?l5RGX4VQadL5>@g#qn;SwG6^G(`4RyeR`Z5VY3aSw%l;+@l{Qowjg
zpV!+sTDD<*R3q(7M1A~cx6x@U=A@pjPD{b(=<fNamBqGQ6&8kke`T^I7<e&o@s{|v
zE)fCe&II`vVlS^=S_kZOVnnO*$8mITPIxTgj<U3Y<?;Yr^W>}KxTJ0Hp4S#yi(bDq
zA?)jWL|MSiwQy3e5q7VaTXU&H=cmS+C0~CJx;WVX28e)FG;fJ7Ze--#%`+64$uwF)
zfP^F^J+fZyrI}N;iy0{jlb74-)SYKp4)?2eEkujd)kNV`K9It_^JdK~@RS)E$6952
zQkyLuOuZ2)Ugq9J;6;?1S(go|TUON7Z)Rnle2z=&(o!`z-!3FjU>{Eep3-^gl}`tS
zQJg@h2#~V1=AEJ)jw@4TCxhnCJgw}+Ud_ubk%U!tRJ%y8B{GG@a<(ax;dbY6ewJr<
zZNUCPd8Rw-Pb!%M<;jfM1C-<<cP8Gc1dJHGIPO0n0!*h<hAtmnT2sEcgphs=kB}cp
zEw$XG9Yav4#wKi}i0k=sJYGCf+1wGAo@^WHxs++IYmS=SGgSTdUP3umlKpfFd8Z0z
z%Btz-Yw#|5d{>1BCqW1|M89<s^I+l%j+!8ZiR|>s2g_8G43JFswDSEi5#>tQZ5LL&
zscik2wfn?JBb2jQCC)piWf8+>8x;GfRl;9<?JS{>q=l-6hl(2$yi=)_XQNfCURiiD
zxh#<kXHB(FUkZMBW2&@1+Yx=QPV|N}?NQf-gk*w?EOnAm`~Cj5`6J17rO}egFM^$I
zZ+rmY&aW`m_MQF(Xqdp$It4+FY<d_DZo6TXHQC??)&6~YlwU5sE!RXPH+%7m-rEu`
zCLs_%*c1@LI`XnLSS~GKrnJrz`aYb~AAYXsYld^Rntv7sU&t>BNvZ#U2+G%repst{
zX7`dkUt!;2o$<_f02$V@FF^zttY-~`8WU_Yb2n<1wMp%!vW?%BO8+Rblzr?`%CWPt
z2;Gi4bgyfuUz2V+)$H(5yF4WV=u@UHf)yrCHvU|#+Gc$Uw&77C<pA>w;EniPt#v%-
zxImCPGpzl#2_;l@*N+_eQIfm|=vBI^MSv9a`t&ZC<s-n0*EX#m9~-H0D3{d+3+yAC
zRK(~t=*2i%zk{fLnKc~yKH#j1cJY1RF_IqMrU1j+i0TK+_uNIgxt+n4;T!y^)f6Yx
zzq<{-H~CWUwt2u7^D<b`=bXKY7Q%Ohi9nDa?C)xM4C^`(U@HOZH>7@=g&YIn{cU+|
z>(J)hiOph)9CZp;Bkdp&+42ad*M=oRlHU5D1BTcRiRqxg1=-9xChv+~&dKZUbGmri
z`2>*dvW;F@5E1C(EZ!URt@;U)U=w5MV+<kVuFQ|Q)|@7g%(3K)W`*m>9t`wUzdF^7
zjk%Fwg?0BpQ*{QdEZ#no9-}?@T=4sDzS24l)n8wZ3H2Ayxrs_QKj5y&@SQ^40gW2!
z=CCE{(pC&-|7NiCw6m<&(;SmLET=)t=uXy3y^GKEW`;!lT$QaR0+e>_PV(Rz`Jbkp
zVP7Vq@p=ezhbHW%bA6LUUC`vO#m57-Q~Q+<&($LrTK>Y$$ydZ72)yg39)!`b@U!(o
zx<Tto?!mDl_tJ1{S~`br&R5Ap7di75?pdzcI^b0tjpQ!_3H~$qxZlRps#^q0Q6%h>
zJ)E=ETC0B~P$uTCg+Tm_chW2bQ?1)K=|43Ag`yI)6KU#c2b+B;JbMnySMpU*A52PO
zj(ENq{@k>W&<_ZwE8Rn%EGS$YwhW9j5rL^HrB+_j`+U3pF^06(4CCbk8`dV=$W$q0
zt+URqYv>f`6W%#yMV<j5T)@WNI=^=&8kTSr5JPr9WGR2c%8qc!I;f{zgsgA-v8hV8
zLlG-$OCncV-X}Q|a92Wb*{r;O8;eX_Fo+Ih3~!kGOZ%7L+IhlMT2J}UnOEkLRSu?S
z1wwXYPkR=(8E5cA6IEIhP2o!4)gfB?i<lTxp$j1dIjiH#Wg*pnJj)WuUJdI~sEYFB
z3W`~oM7UI+e_2*fqSYJQU9<YVm;;ehhE=F0qkgPYVbVnH?~DgtNZUSeQ<Y}x;7-xg
zO41i<$r^DwF#-lX!<48`L?Jk|hyU3IN=ib^DZm`hm=eDHR*~ksQ=A>|QA+&rA4Xu}
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
zcmbW&cQoAT8VB&-6lNwy8J%dOmk`D%Gf2_NhG<s{ZqyqVLDXDp2||cOw1|unz4tPr
zL~lXV!5|642v;3e!p5xZ-gEby{p;TQea`#-^E~H0@8`UKy!1KxM}W;(-$)+-fdBw>
zUI3j8=m2m=Mi?Ul90r3S5bz5~PG%$%6OxaegOyW|Usy<xUqC=aTtP}i^pco>fV7&-
zB}FAH7Aq`;(^AK1Dkx(y-wy#H5C|j_l9!p87lRf+WB%vR-vTH&a1FQy0f_=&6bOO>
z(R%^m^LsLYeh={PfWQza10xKMxWIHi(8vaWK@bQS3SnS?LeHne&-(xr#lVhMy3WX9
zb_XWv$BBtd&V!3-*LHE4Pwa^+JNri=E^zbk^6^VZN=eJeVpUYt)NyznT|IpRLnC7g
zORK+G+t}K<xVpJ}{Nt`?!2Q6W;E>R;htV;ykK*DVKTk<bOV4<b`SNvsL19sGNoiSK
zeM4hYa|^MxyQjCWe_(KEcyelbW|lNJzwl{gm9n-@-T1t@e?U7t`sMh`*OTuq5CHju
zb-w=r`-=;8?gB%h5Gd@s3j_{6Ul0_O0j<Qye%%aq$B#o46A9<kPR^_CLWn7w?{PW%
zPh8*@$9|I7|4#c|_TRyx{x8{oV1K$603-x-{&)}+a222tOuJh9lOu}fM;Sj?f3*FW
z7`~!PiPB*6SK79%Dcm8Hm1F(MqtKx@vN~uj<qbbOymdmLgOq*kv@<a{eG-K<9+2e(
z16|wibL^g9=Em4>m1<S^29y~lPU)+r;>43lrCM5}Va%iYvqV`E_Ap%1!Pk7|-OHDE
z_sF*k>X(P9$I^Un2mI&X0@i_fJw+j;K74IQJCPVQ;gU4F5~R2;Uo7-$XK2KuGNhxx
z$Bk5tZl>8TtTh#ciW3F|SdKd7t9ucLyY)92OXc%$2Orj<bO2A2Fx!}F`tTf&yIoZo
z@c#A0VZchIwO-5gY|oI*!kAIK(x9#Xbr*6G#!K0(ChKNL`q-yy>5@Gz&%(P7RYn`=
z0P4;Z(%;@ut2NhZIqR|XzhHiwa25M*wdRcD;Dk^=Y*pL~cJ`pie#S7DBDwc(or~6n
zr0)AW?`_Iu$_Wa|+AO7d3(8u+8bNR^xj7=051)9(Lb|N7HTP`((yhGOXb^8G<}1Y`
zc56^5ldHSERsQEz+C#(1XeHo^St5m&{lITaZ;j9wv)0Rlcof-2RP^U+SGGH2-zzwi
zntrj1veUkvNu!~@%?NdTEAR8x=P}ipHEQ+}lzhs0V)bn--^(Y1eZ)^pgX63;*rnJ!
zqW?_}i&t3ROxLMZLykvst<W`#aT6+EL2H6ZJrg*Tdk35biy~(U$4gb-WXTU?=pNu8
zm)R4_xq9F|P56h2uUwI@j;jf&i%)+_QzvW376z|e-o8B`(COxzadA54s?Kb!H<tK%
zdZ*f#9ozbfK~&<a$rNd8uqt=6x$Z-qVXbBW*kGQrT&uX1Q?hGSh+=!fQ69^8sr~e)
zKyn5y++9Y1m?~1UJ(y1ko1i2fmRl|>kA~ZM4A1S$_*Ct#Ju}|cO!_oWPM6{xQkf57
zy@i*otEqR_NSmVrj=5(MW2GU%Hd9zrq~}nHZB{~7e6I`}+CD}zWe)PRpBOY<6&<CU
zGIA%8b5o8g7ht-S6nFB2yfNqNr5i*oR>yrYThlPH7iCNF=5jyg<h&c~*Q(R^>?6ft
zM`RW~qby}2*DFGo;j1v%QMJfqAkU-Tbp9vP<LJkmI0uSE5(I3z=15xUM2vfGibgNl
zbqK+JAngA#-oiUhb-Z6wm1^Nby(!?-kYZ$0l8tU4MiXRwToZM7XzCD<{ylYSA^(*;
zkJ8T*H{2ATE4GMT#XLYQ6up@uchdppBL|-yu9%&_pUS5i>~cSI38t7_iEYCVudIyu
zskBY%h#tB+Gl${AOPW=i)s^`kxaVdMw51iL;i}bYzQmN0MGF^iElHn=9pHX75H1Wl
zQEk6lwa_q2PRkcDx|n2{v#zzZSZv1;Wbg!Uo>W1rj=R<4yQ(o0qh0Qu{PX9QB-7Pd
zVu1a!D)H1hu~7{csnA6~|C1t&m+JPNqV>`U?Yq$v3vgY3<E&ugrMbiPHp72PA4yeY
zcCEBq=w<Xfak<q`YzIPIT#D>uv5&_}3<0;M1DlhezI)kX#P>V9lin<|4{Z1%LXiZn
z&Up$+@1t*=wGiv%k-d6P^8MU?%T=!=)+?*RX-?YsG)=pOjs*0c_j*P1Y}k+ex(7qD
zRl^t@H8ER*-78~*MPJt7<&Dw>TZ+7Rg)L#+JS@e*ijWf{+B6>+K{d%&IKAj4)Z&N_
zqINd&)YslC9xo4aBE4H3akVzvJNdP1Ma<K5D3H(T3;V&<N{gA?y*(atn?(~RzIder
s>XlXXKC8WVAKdp<2?~DkGe#%--@J^KkEdv&?NVIsQ>`025%l@r0B_us5&!@I

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/2374] 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/2374] 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/2374] 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/2374] 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
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
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
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

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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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
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%0D9FJ!+sTgMo<k~43Xrd>NP7_O2
z{5fP|fJi>d{OIiEweJ6N0_h6))oj@L2;&lI$(ELv`3^gxurqPpG5qu@Hr80Pq%=O-
zL%;hpbc*Z^=PrK<mLY`@cJ?&e`B(K}<l>iq9BNL<e{~zIn?fQU6cD}$QDb}VZZGVe
z4N7;>ug|^6tRtqxT*z`rM*ip4zI$Po_E?iwQyGpcS298sfFVAvDl6PdQO+n*-DT1q
z;#ghuRAZjl#vq<aT=PuWQ8w{M1o6=yAKE!#xKB8AA(3Ywf>3r%G5!QP0r2&zQL7C_
zl&5_KXJc>`n{Bj*UAIu<iv`NpsU^ZQ&T5yNW%`rw0!b{HFqFN_GU@k4pd0dN{P_>j
zqk&8;=)gam%QoB9l}^dxq|6(2(rw3rHsK*49;X@8;FBtv5*4XVsi7?7R_HDsD$-SA
z3`A6Lo@Qo2gqc)$ScsI3*}>cNiN&IucMJGUXeZnj%{ird44Me%Mf&(|F0XJ2myOZd
zzjmEg(XXV>H(q-jp07lfuE&ZEyB-s>0(Q&s#=z4+zkRNt%@Kv#p$yscUN6l;x;(ik
zCE;GnLUuiIatovq-&ED)kMM?YgPHSPC%U2f1&XXbE^(hFNlZ%-^7lGebwi=|<mrEu
z6w(WpTao(Q|L1M!lotKy2%TeppWiz}=h$8(+R;PP;Vl&=N_}Kxpk)u<#drkX)6~Z<
z;~K%cPD3Ld=$+xXsODOF7S(s?EN_8}pjaE2E}FafL~$Ax5!5}UQJA-3Xdna-P<|K0
zN55k}f*|o}tOX{0gna}bu`FnP$$DvFw%X6fciJf6soHSUW(6t$k9Ll-0=AZOgqEkV
zwlwyFB_S7|nb&~B^}Y!WlBLw-vLxuK?%Gv93UTr-k?K*KQ4v=aCQz;4?~94*ZNM$E
z$hUIuU}K^XTY~!*sV*>$S<PYeRR%i*?PpXlX5{5FvZgI7Kku5#&VP$7_i{6Bu$$$_
z#o-$=ksv;4RJD(Fl|j}Ulx(w}8YQ&IYHt!49uaLWJ8dyX?0A2c5c6hfD5Ro!RDMt;
zQHVU>L@C~W@wfCiawpdmrl@BYYWwn=AM;%^57cjL>=y&nR8Q^`jswtr=J{7}eve<R
z?CLS^ke+!42z_mjNq@-scPjh;JJ*awYtdk+Nh(eY*N8NFtJEfz-{<&`eY+cLIlCUB
z2QN2NH`lP~=X*~bA6m<d5X84?a=(pd16UkKqy)N+v5;Der`0FP(gB8GYH-ucldQ7i
zfkNksrwOYa9+oq;FD=bXQ=AehtF@~ghPJn<j0{y!l#iM(_69Z%G2KFnFGy_fUDBBn
z%o?p%+7En6^K+VyR!f6PXxg7Xv)hHc4#DXLH>jA!UXx|3oYCZZedVg5jhhwwPGFqL
zwrdySJQ28L$6t%>K&(rPe_jbTSN|IQOP8znI3=pgp!Yh01wUVe929LIn4}*>$XrJP
zEcqfI;A6eEt+b%IC83GDI?0dkDkQL0v$}rP;c?PH(){h=YgKg)Y`pfRzLDFV6#p*V
zl{%ujA?%Uypv1Cu`%gYmh93bo1xRhh{6w&HybgI7+vxTkFOOJK@!5%STDG^=m+Zcu
zxU?3B<uLwpmux`SEHPsY|MJj&_JU5rPH>-ff~ZsRmIiYOMK(ccOL+A|HJ$g0s|I?K
zIP%E^&t&mJY}Jc1r_}vc<eYU?7f7sdmAf*PeI#=`;l!2>$rKM}{EK|KR>tq62B-@e
z#$*!|9Y}#+E*kA4SdYomtX>{+3aim{RKMs9PZY8&ERs7_29&oml;VzYDpYO*`0B^y
zG8yYlh8{JF1o-WiYX$na(KNuPZ%?<lo!>;EdxwJt%$<%jji>2M=D%>mrM`)ms)qXh
zBBwkRtOa^qzI^xu`9&{nBgSMc=8RvnmsWp<{VsviNYHb#evi1>X^}~29c<uIWo(Bo
z6q1uEDQ1C1ThX2?n2S^2AyGr-QiUv-7~|ov{F=qq@o@Fz@!Cfx5O5W)sWqkVo@X=Y
zG8iS%g&fE*AbSE-i$K1@6tq>#X?A8}_pLm2)hO2+u8o`aaTS5<J(sp7fh@`l72_=?
zH(Bu!c|Fhm&z<%^z0(cb-cPS7hj5B$=vJ%f!1}T={_WMR#vwT?9yArLI5Y#_-ORmF
zMrEg%)La_!5+DaxAzdaBLb==UZYw*FHC}yZ{U`Ng!oj-Ww@JQQhHdC?=1WOn>fnvl
zXFdt$Vj}sGQ;QiJkrP>u@}j6AUZQ!rbh<UGWY-tT&2`7)(<V_%;Z&+Eaxj1Vf|*sH
z3%I~kbg?h8P!{|ZH1D`cA1u&Jo$Sg?L}n_$5R1=SJi<O5xDC`bOB(o6G)meqbo+_N
zOumx~aDurU)Hq87;FY8xo1@1o^v=ttEXb6sSliJXL#=48^@hK4n@>-Sa-bmF4vW-o
zfK^Rl*{|e(i@Hbvv82_XE%^LsahyLXO-4zUV_xk($Ja<g5i8dHN^V{@y*d~{aMnln
zDU-k^+1%8a|KmRI2g8c@Lq*YKNI1WI)4-zIx}WS9CE#sq-_SS%CPZ&?^cQ;?W9pb+
z(bJpqmux6R)}m(H|C5ot{R^T0`gX4ht>mLfNSQ+_Kag@I%mBG2kT1#a<p$evDbw*Y
zQRrvM;iSeWb}D1pwC(-w;Y7!F`93hF3~SW7a-@R$GWkSyXefO#);5NRP6?0G!J|$}
z9Xy4!4bKD!J?4mQ4jDYmnVD(v2YZC(A`da%X5g<7F4{g(a^vV=IJ-&oJ@C(WlxhdK
zk7$=H!n}gbGE*X^f7YSK+p~a2idUJ{b%FY88+4TeotckBV2Fq4&^t+W!LdoFPRb{R
z9KJ$qrXd|MfzF;L8<1bBlY$lx+Yx+l>d%WxSBB9~P&I<AHMU7#^3=yBaG3?!qo81=
z{;$Kp)I8;VovWhOIkA$VQ)%)pmV)YXZ<qR9b!}YQEkX4uPI}j>^#<#7yX&QMgMh`2
zO4g+WWf8L&k>8DMRapl-iM)|^onU4`=8<XL7Zz&uti%(SE7i!-#{-_)WjU*x*q?g8
zJnF3?#l4P_=*loPWFko9)+YW-b@RW{zCHV^V5k){11om8=6fDWG^ChFwDPnvqcpTA
z{nID;dnAd;WM(`-zhG`!%bp#C)zWIwaSZ{K0sc}(iYUrMFF}jbsxUJQG}co#9Ym;9
zWI~_@Bn%RZkYO^v6`;{S4kXlBpcXny{6^0!1Bbo@?Y4{N=1A!;zdOtFWo8DNP&BoB
zyzD0%`fkg0+(r?cc8J`Etv`ORSg=y8)PV_<>Z#rMitN6O`NFaC6&E`Uh_k_62UUI)
zF|%{=IHfatZ3#F--q)GImM(7=eAog9?b6Cy5Tpv(k*?D3<q`0(Z;!<_33y_h8V5`l
z<G#u=l7L=N-e@k-jP+bY2B8Y!EtfF^?eMzKfcFfN*S%n&AY4FkeH4v3dW>gg%(dHE
zUCYO(sII4d+uPlS&3Z?{KlyCcl{+m8gIze7<VRF6TiRc}3Z0$tcC#aC<9!a-G9~_;
zzfoOSI*Q_Bhp}2@QzUor{lnP3{|_qn<}WJu20HWfLs2;>67m&~5?e)alu~(STnYG{
zo9G7!XPO(R=wrAX4r%1s^Gl!9ZEv;GEJXUbU;OeoMRvjksS+a7L1lCZ);8P)!RESs
zHS(Ouc}m(#bmSbu=jCzY8W?0`99bzQi~RkFCT|&wC)*Nh+8wxrjEIQ=NF9lR@NW=B
zkTA%Um4?<APMT~wz!ck)azX)1zl+cS+dt=Bo_ue<!|{25w!Z&B0eA5Q?j*tE*S<wS
z$P<>R7779AURHq`hT<p@_@Y7`4N<O~r8OTDKtUK@!Xj6bj`}L4IutTtF(MBW=WELd
zh1Lb9&GG>v&#2gzW@Oa1NP?k<{B$*x$phnt8C&yFaVL9ueSH3xqPdlqa1?tO8~&5k
z0nbzki1N)U`VD)(6$Lzh#<Q`r?VK1`Ojr}JBz0$Rf#L^V*@GOWWGLoBDjvy84vNG$
z3?3J$S9vXe{S+>RM|J-H$POr-EVxM~!ULs~@gZg0)#u7b9884Cb2&d~!1?8CGbmD9
zF_E@NI?U>%@qF3l*NLXtrrph!0g{_fUv{xIg3QoKu0iHnd+b1kKCK{*$sYNuk{8a)
zbb9&n%2N9Lqv=<<9&hoX#?%ypAY_Q0C+36)RUtqNK)|8oUL@sou;DFF?VAdyGYsU0
z46XnO4O+dHd2&9@1wFc#@1j*@=BASm$}`F#-W1%x1897?fpxn`(2LIaTV7)<qSGW!
z{!pXnHH(G94rlgIt3jgx_)A@!@A=0ryN5l+j6%*J1lE@3X1k{;!$%8ndaf7O2VgBp
z6^)5=>7#i@v#TN%2FbRXoPHxM1Z*D7V9-)6BvDBVimP$P?(=l+LG@W8TFw35xN#MC
zX1`gBvH6N4NFL8rv$8V8=eyfS)7<>c#M{_=YmNDaGS3y$^>>YLzYO~%nhN=t!)%Yz
zrzpHT#&OcKYmt8?*zf+9@!wPbYsd$YVvm00Y)RQcjDqMkLdyNN>_CTY6I>yziK=I}
zGk53qt5Gq+bst}LM3#mHJZEt$7-hKQl&X>S2274w;OS0;J`cfdJR|bN=OKvyR`#AC
zYS<J1pe8fO9{855=1b>~j11YKKp3uk^xb8iS${F;`KLG+-UCoieXy&PN1oN@Yj1$X
z#dE$%Rey$-7)2&{TaSWhF!Iho*fNW%C<|!(VMVul9L%e`{L^|3AqWR-%b;;Sz6aDc
zcIG9%%%z;(!<v8Qx?M^tIqg&5Y}D{ZF5L?QP;Rz$*drn$8bp!v0NevL3Kk0xv~yWp
z{z!??GGOIyo3kEj3Yd}{H5Z%&8Lzh`JtQMa_4rY$wY#J&V<crQkaMrmWU_1I>*ubn
zben~G3OB7%Xxf{Y%-S3#On>xSfYfjEF5sYAf*>a3Qu%St4v^L%e9PG1wYeFGQ0{++
z;NRs<QGiWtXsmC~?;+49vkQr_e>?!UigK0d3{r@qlFYncmMWF<ThQp6;u@v@-EmGF
z##+5c$FyXp;ev?Ab?}W&AleO#+wrtB3ns!JX)TA!6H?^ciu-H0L+ryrT}?<u0zbgB
zPwqYS5LN9D`TIlcnoOA^D@6mGMHCMAYOHgDbtP0XPJS@g%Cn{IV)Zgf_Za5_)$(^%
zU1tNvk-q4|_X!5%<bwb00)S0k1;@vsBJ~XiUc{cd_guk@>~f%1zU}M9ObZHkBK$V)
z7yd~_`YBH4>?q~W5DE){9qGt^)F%P{9dgYJA43BnT#*%q*pyaVK5rcr3RUAqb&6K}
z4Vvd&emM&Hr^%Uu!FTGQG`P~+^X`PyIz=S{l<F-_g9_&pDwz|So<F62R#jcA;G~w*
zsar@@Wz}+0Ma;_FF|!|)GZkv}b8|!<Z)!n7M`2wp<j<OX!K~B2b3aE7)|S9r|5fJ(
zsR%o?gb+fIF-xeim>o$0R?l!6v#7TD<V1@AWcX3Jr<aPF)i?gHEKfHL0)Y)bdPEtA
zOK%PE7ZK_bJL8$W5J^8su@v(|T5wv!nOEh=x13T23Ky)050HuM*i_3*#hiEhaz(Bf
zNE!QWBK!C1ey1fNlhF32QaxEM#_$GFlUXw#&3-J`X^v19vdtkoQ(tIvh&U{C)tN1O
zL26BIl!!+^AnxUT>T!k{L2I=b6=W2FktBEs8-BaEniJA|J@U@?r>{tJ)3_{8_&sq9
z?RbxhgY-K=T1FbT#j#&we&Q*lkZ<g<%8^Il0$4S}3KYjfanjrk0dae8=SY=hDYf2t
z`WL5l$yrU-C2=0!ctbd(2AZCIMpJ<upOu0A+}Wm%7GWxBUyrLX%~jsJuY0lMm)xSB
zf+~kUrOd#FCD>LSSM9%;J1X)1g|a6c|27{NT~{=}uy|duM3F&m)bE{c++pOvk#Pro
z9~4Glqc?q@V4oh|ye>OztN;OVM5StoE9<oW!+t%i%0>%fc%hPv@CL}SgE}`XiTH`_
z>VQvq!KNIUcYwB#X#1b{xq~md6!%GH_4P|IW?~ufX+fTgG`UPQJ66|(7k>0G<fr;s
zb{;0b<6R?Cx!TS~9Rr5dyf`=S*Bz_I3%hKnVisLsyd@D+5Hp#iiAe7Dg2WC0RXtt^
zr|9n-$kEmI>VE?d5pa-gb(;N7o<y35yC3QmQBjje_JOwaot(}}^^w4r4wT?I4%bg=
zX6{GZhgiLSyA5V4h9LXQJ>m<!7=NUI-(nbuxtx=<T{E23rdhUwLkXqj8I1g3NZXgf
z6>K+#u&suhK0P&c?lJI_h|k@-)y*#Rlxm@9vNb+^9is+u?=-{^J6d?E{qws(|IeGm
z2~$|Vp_Xlmf9G`qpr0*2Z*=#~zQbpK(Z3%pnPINOW#fhLaYu<KH66e6Bkv*Oarum3
z`@cqfT)CZMU(vs*Qc>54isA|6%wbFgiUKvB4-BZ_{PeU15VL&<j-ahl#?~Z+(~rru
z!gU(ki_vx#0wZC+Lnj+arP4!BsDb+XXZ<&Rf9__Q=j1=np^J7$p%uK=8l%N(l?C<S
z6r)ceHvU2#ufv-Od+1eqO!_r^P1I&7`>pTn#n+i{<6215wzUXG_8LCCXK*UC0zw6w
zUxc2zD3;%DK0xTgQF+Fb0ale~rKRsr(X-^GD&{}e5Zxi;2(&JWu3NcB8K50RxDP&_
zmY<fvW6-qABK9_VUa7R=s*|HPmY*zi+}f=FE=5H5^8n6bC~ljf)-8C`ipXv8U~@oJ
z<}pIMprJj>jrnH&@L`hN_t@L_QTOyPd8+NHkhO{0zwgKSCkH|Y#e<uF^%T!iqMPdI
z(FG!q$xXn^*T2~Ilop(em90ANAIuK^VYoolY!?oJ<Da^M<*OZz-P51B!#zcf{J2M~
zb5(?U(<kV;PQ=QBG<&ngjj)4|tY{js`;gm7-GQGTE63c@6H9i;&f7qo0&ZV@%|dvB
z9J}O)sIn>pd1%pCC_y9FA8hkR!J&xmPs1Od6a4Oyy6Y_bEKqI7(WPBU2u`2JYjjW*
zFVF5aJwg=f`7+<vMx8j35zFhom=4ohhWh^j1hf?ziuyaPo$0}TeeI3;vyuI<fx)KQ
zb3xQ~u5jz|A^VpK#~{<rq~}ImM^BsGn%ld0xmFK@pz+ibF4Oxx!#``5dKJ`p)zeI@
zxZK-}vQgP|jZ;eY`)qoNs{0V>)dyv*PyAWQM7n0$R59-ME;}<XneIdtyA+9o`!#Ut
zokapseowo>Ema13wSz1CFMO7^(fr=eTbXm<O_4V_|JC6VEGH+y60=|Ze|>bkW>`8*
z2WML8*i$o0xM33DIs^k??#pe@>;3Sb&{OA4;$eGv)n?vMQZeix=Wb;&wEFm34OAa>
zJhQs$@xyxd_r}(dd-POf*OJ7jy%bA45W9lRh8gX%kv^CeXRY~=nI_Fpe%i5CdUM~r
zowS*f)BQ+J=7vf)dkT{qebMJE{rAAt@r8>URz~$wIK+sRCWceaN9(4TGjs>^6rPl-
zATag37-tloK_EGw+`D!`9``cI1q*ZfbLZ%OrOnszKewAJgN|L1euj`ZnC|MY$cvsX
ze6V1m0IxH&@W8dCPpP4>LnC8w0Q1l1IUDPr1*+vRkR71+w8E6!CSh#a)ELjIX=vkO
zUB9w(Rl}9aGT}O8=&Ld+8K)xRw?wouqgE{`+~+-|6~@ZvhWnDLS8J3W50mx!Ni4q<
z1b2A++Gp@MI!+j2S@7D*6)^%)9lzl>yXpON1C1?o5$6ul<?oY!8;w7X)R%p4m37Nf
zX%gg#EVtAXj^WhQ-H@aDX?!oT?qang*%C(ea*!>BdOjF+5^)dL<B+s4J>;FT5mvg{
z1hG2A-_h#s!#UCGXc21&9?&lU1C?YZ<Qm<X^LK^d*@Fvvj$$X8IzKa2WFB%RSNke@
zD;LKG6wW-*ODiCdu3+*ZxfmN~6pTJEbin%lZt1RL;)(zeQaDEgWBKX(J3n7sMEn`t
zq+uvsAy2lQv`By|2b$x=re3<w)>mWb7X9AbHa+nRd7{gqF~!F-j^@*<6RgDV5kl;G
zoKJb*$YD})!0hf(PJ2(~nBFsqo@N5X{-5@~JF3ZM>sJvK6$M1;QeQ=+35X<8Uuh}|
zDoP6^N|)XtRI$(rAX1d3@**ltdI=;dC6GWO(n~-HA#_LrgpdSoe9zHyzWc59oqN~1
zf88bjWq6*Mz4z>A&n~~2c_>K|Bei`bBs!urZV6tKmIKGmr1}%D;{wbkgCmi5v*d!V
zSO?9D1-nGJ4Y#<j+TDc@7H1kwwm1*ixL}|2-$D=@=&Rw~%zBZs>Ec56Y0@m^oiR#(
zR-{VDEuB+JzEm5|d5_+ni9hH?-z6W-QgONv@OGCOdfO-|lJBW)($^P?tJSXe%Ui3R
zCg;o7$(j>!ENAi!Y2&%hc!q$3z~`kw)x^O?>vc%^;(WHQdeK`mC9+kk|AFbP_~6GH
zhya5{-%^rU<le6G=`cPY_T_|HIAz}AH>b7Uo{1-{w)MnJ2}eVLI#H)hmxHbcvt~sr
zjLu^>8O>nm3iPdT4fTUH7q6tx`u-X*36}c|_aQOSXm)wZpBS}Utt;<chJ@_1^juE9
z2S26Jh;I&+F#?8YbX=TBh^zy826PO$9)f+Z%bwDBv})5FB>Tw1b8E>YZ?F8m`#Svv
zomMZ>sBf#Da(M{Ts@ef?qZu;~5yi?8zuYlny~I!1e`?AEzpdqdG;*;?w9tOWKoH2V
zt$Q~c3GEJ7_QocrWn;|1p(>A@uaELM948U9VqFp+Hj9v=rn-vJ%B;bt+X$NX&d})o
zX$KzNJFS!jznb&LsQLCDuIIhdkr8wYC~4Li7%??fb;3?@lRY(&xwbLANlj$Dr0ykC
z@+&40vU9gFQf-OSGJHm#8p(-=o+!m$7M!|ZlB(&5OMChx!P4)&of5|x(VWGKVMzy%
zopQxbBOG=bOOM>dWlt?yCfj!5r)5D!R23e63A-%r_Sy;~G3LEs`IySY!HuwBLW?zb
zk6`+nwyc83bN0S2EDI=&qDeG?G)93p_Tby+j?HT9<=})hJoE`~Q%>!Z@yX>Bk6_vY
zk<Ae7isxYFAU9O_RUH8fCpo-H0SRAlP?)@q1kQTJe7SDVw{LNi(R;Z`B)WbR2&><G
z!{gZ<e=AGtj<&51hF6H^AUQGyzOvy_)?Gi_J1XqX*Xec!Bie5-Y?J4&4RTQ98MGjc
zEA4aSB#g$0lugi`O=HLeOR#+X8+Ati(<7%7?q+V<!$<LwO{Te_rMbJzc?z9h&|wu|
z)r=66@tRTbo}4(VF#!iFO@@~+$Gll~0qG4EJ1JS-S(9|{9Yg5shzka7gME@!AmJ1z
z)+ksuKU8ifAH^DqvK#cqCw&rgIX(|`>Bx7QB)E=X{mV7`uh<3S^k)*ueme#){23vq
z^9N6Rs=hU<N`a7_nOP>85#hHBTyCyREJ;ictRxzHjhy<(cvLA4IVNB~lg4a5k%MxT
zIim8Y{r0-y#MrQ6j>e>1n96jAg7crbF1zIB&#Dszifuu@b_-n68?PeyB=x?#9_B(B
zQ=0(t9H`s(RGf>$DAP|VgE<w(Ll2j^>VSQAHN3`KVXS4LK0x0B;D9e|I!CUY(KYr(
z^~*r{CvtYB27||?WNpf6OLjZFII)W*khVl|9XWb$TNctY<iEH*EaB&xQSLne=`GI{
zZS&m>A`#IWqQq}w-dTwfyCE}}CI6gdtnlYTWv}kT_57^xr~oJS)m*IPs>({fviGzF
z!uIk8S7$w@M|232sLVQVgIUcGRI*dnkkQ()L{c@0i^%m2zuBc1Tcrp?EyP*oNWrdQ
zW5E3F5m@F%xcWY?d`}pp`D+B`-B>W`rR)eR;B=z@2f2o@;Ox1=0~0o#rXP%mhg?|9
zvx~e*)asax3!P@2r`bBa@tA7_SVXfA5RUIcx?k5FPVtf_d+!;kr%NKV#^H>}MiDh;
z#8Uhba>c$QD(;h}xo+W8ol$&oKDMz%i^mrK*6hF7n*E1zV!E`C*8a^x39_0lZG<v7
zmW3(tMwr*VX$OF8{5j*e6NMZ6-t+6XIUMK}>1bNAn8bL-e9}BnyOKwy3BeeIWbf-1
zev?wnKxLj=6;T%EKKc3vy<NV?suGQxGeO>{zXX+An0|DoAkqq}>nDYk&x{<??8R;2
zcBer^o}KSJX!nX{8wgTRDn#uv1-x#Kby(?e6d!TRd9Bt;m0<Nsv}fabKg%3jmq$`0
z+TsLybv13kLqn_2b(yWYNy1wzgDeVl@h|Zf105tXU=i=$D6V_T9q-uWX;;B;_QR?=
zi3Zn`1K``%zS-?_;Af;f87s$O>;@Y!6qhcUqADgoM0KEeR57!ZTKKAWBY?+*cHKVm
zL+)nwHB7GVbBaHuz{$l6xXeMPW&5zpS#jo4KI8k3NpnYTs+pl~xM?^vRF_dUGZt$>
zdPdb{*_qHdbKwteH!*iIDvZ<~9JOi$4^e7&dYak~76gB;3?r-s(cKUik48Z|@584y
zq&R7@yPxzU{a{7Sg8MG)&SY4kmp8_UU9QnRwppz?M5;Hdy&kj5npn+1GT_KWsj)ir
ze7XvUA?M<fj8+Y7rG49;8(t}T9}0D<bqv|5o=a~zuCY{RIFwKk!E&!$^`h_4AZI5T
z6SM_ifo&=FWn^xNo?6F9xfOwYHJ}n?NgwZ9xMyrt5a{R|2`%h;cHhQIb~*v&CSD<~
zwhJj-HBGxQHsTEg&qYqRhyfkk!>Vl?{eVWBafsR856wb$@_r@E%c*Zi?Ak6r+!I}R
zE;UO35XyLC0ieu*x+xjU3*V|VMq4789_!UDx6AR(cTre;N~$%3>70swIKXOxd=Y7C
z%2sa%9Q6?Hjv>Vk#V%8QhiBKeFTe&;1x2}2V(ZIrRLk5&uP1m7dqDk$YcD=U=_GkC
zakFfUh$}qOwz{*jI(RP^1%y%@IX`i~rdFLWzl!?ot~;H3o9*}`g1zA$9RO6LM|)3v
z6h$`bxZ=VQ;yC>X(Uv=YvtoAx`Cf5xga&xLt7S7v;H~7mUVf)KeCKnKy#8dR^rmL>
z45xT&LAWyL$-%-0^w^DXEoM67D8pbfZuI?M;PT;%m|VU_27j^0REVzEFbEl;XwzDe
z@pPct$yc!>3Y$5nV0K{PI$D5(lS}OW-l;7vh*+`F_l85I26~!t_eYd;wy)6J(#@V*
zLXdYR;F0o8#|@+tqN*yS<f-5j3Q=yI3rB#QAH!K|stCd8QV<g9q9gGI|8epoYfVeH
zOuSxqYnQ<q_X8B(uh>cgY`S|l-vUQ0*HYq(b*)VcwCzBVQMBNw3MOlEH{w*0J+R{(
zc5r%mSxi;Q<qPbPYLlIekg{<J+3WiI<`epPfp!9$GCs)N9R^#r`|17f`-nsAr2!+c
zOP0vWoBNVR>=alY{cwuZm!UW(?Z{)|p{isDR24%NFuz(+gz%A-_nR+xOg^1pOoeE5
zzRvK1EB(QP5>BzJ?|D42TN;2tOyN0CkK{SR$6NdhnRBs|ayT6t#`iF^+Tqw$L6(X=
z7yPN1)ZfY^qwwAPy-c`ou1GZD%=t;Y0&QhnDQ7W<m~N(JkxyUh>kVbnHjL`>=0Kq0
z=*1)IH5Y^Upj-H-@Nq{jN4r_Zy**f+?mj0j-&S`Ct~j#&GC}K5MkD^KI$;MPycM%{
zs)QWi@1l9;#E9H(>*{U_(Ys*RlzuhoPbPj<2LgH;%c@c)+hCsw5`<UVHh~O?r#4LA
zV{$C{W^SQoKv@(0^nItm+Mu2WG5!eV&gyO?8>mHzDxV5=ajDPMiTH3}nI-mCTHoaW
z{_1&{pmCO|0uC5yPvxF_Z0)7-WPA!B{ETYUGVTnZeSR>kTws<pzZj@Jfqg-pE}a${
z;T#Wq@eTnUcNM_;76o6d$n<8-BhQ&dPLnB}6myk9|D<KHybK=u=ZQr{*{3^xe10+t
zl4255iG+SGF^%Y47|__jDlzJsE|g-huF>=9L|KeV_Ugo}#r3T;e|#Wj&8mQyzVnp3
zr}f*@hVY=>+6NCszks}YJ;(N=@8?X_h9i%p<Adniyk}w`TGh`zc8D2ac4ba#2CqD?
zcW6ssb|KmWU(OE$;CeHNMttP;hP1Ml7m8}-$57bR+-lC*u*Uo`XC$Er;8iC=3Ifh|
znRa*9pGbe?;f*>Perphr+yv3CAC{%zoNOlMso~lw+6ww~stWu<K;ey<H25BEF_&Sl
z;d=Sjh{dUp#t7}KvvxYO0_p-Tdf3ZDr%m!%3A8UVn2<Nk%xM~$9xD;QgL3y3PgJS%
zU+-GM+}7Ak+_RU%_@*8}=aFE$93P;Z;{`5rdPu?f0mhflLV8Wn@ccx#K)=ww5RF!w
z6Xl7ac5-T_E?XbWrBNm$=dAZx#eCEWIeK4-CiH0hW6yfaN}R;_Tg1hg`pC!Q!IcuX
zl^`NI#Zhpb3XPQZpz7>+2U(-3;bbqK)@M?xkNtQ0BfsEpqWL)BN&>zQLtE|Y&aQSm
z|0<khS=b)JS~2oe$Ko(7KVdWk!yoZPO$e1(n~R6G3#5M^YhR7TMG~}(@VYQfh52U|
zKoQ>$Lp!LA<*6eEg0ucPm-YvGWJ&PT)$4Gcm$J6`px1m&f#+<4(&M%yjFXf^DsO4y
z#gKp<M_K~&(FtFjn82|lsTJ@!<kkj6PQ~TgQd&iaDi9U!CZ+fA(=C2pSjy;0UmZ?Z
zrQYVA&a)Q!cI7Cu16?gk2l%9bSxSh3D|h$Z#mhjtXYNY)BiUNv5?HjmajU|t{zW-y
z)9%v}_|#^Bmw%Kt$XaH}Fltof6Cu2*FMeeYP|CPw53aCCBPHuIRIUSn-D$I)SUNz)
zAeqUO#sY>dbZhDe@w%y0gng}esFYD~=W?C2EhN!59l25FJ-~OKasa7SAhs_QfU{ZH
z`s(HPY^VEK5zlk_a7BlX@NKp0B!_cBCSGdc(VeL6z&{vVsHj#%<D^fwEv`r=<y+g_
z@rZ=73LeIch453V2<dhT`waOa1dm^&-Volt*rt54$!28&am&I?N36B6Z19#=<hJ@8
zZ25<Wv;*A#gb-yKQE=n?t~W>TQZ_5v|4McDP2r3FfNCYH_SGx*=*4F$Uv{WgwntUk
z9d#Ej-?kY3>&1ch^PvchC-CrGMAl*}m9a`3nZX@Qv4+e=wcl?#Z6;UHW|lX4iNiT&
z%C>5Mu-q3{L2klMRqiAZ&1}SJn@28cM3pe7m3J;fmnsw0#Yi_o4&K`2MvYtxcX6m5
zZ-A;b-CW9~IkY8~sK|ha%B0`wcAXisqL{mxct=JCH*M5zgPSu+8Kh@Xs?USVmK%p6
z9=~2{by&$Uv3%skT3h}6e$?=54}r&|Hcl4r;0;1{29Rz&4u~PJXRUVb%xzu8CR-0r
z1K?yBJXdGe;5slu2`$XvnGfCClk&qAvgi0h=7UR`#(we@=(L#T4j2AQ73{P)_x18i
zsPgWJ_P1UkW>u*K7lgdJ(&xkEv7SM&uS#ERCHqa1p^;wUI{{-;EJi`v=arpmcG%E?
z2#XlTl?#m+O1DN$gx3pcWD(nhk()gbMVvOx7CQUF1x=^&aWIrbffM9#WljEWbXQmo
z(IB9DtJ_7#oLz6~bu~nYqgFXqe6Sng4vWn3?t;LsRIO5)GLgEn6r<6EdL15^g*Xpg
z8eMHTz*Ks|6WfIfM|!0@Y0YTl4s8h)yzFhfs7QL=zoACS(DLG(+_HaeccE${L<(_X
zX~`p#ri8T158ak0&NR*?=gV5qaK=Y|gopWhJL;#!Bw7}yleok{(W4)PrQ`|bG1GXV
z*Y>&`{g<!ThNtdTFTATY!%)Yzhw;64gD$Rm)#~g%K*s24c%<WE?*W=GY7GuiTNg+?
z6|;TiC)bOYHP=nBzApv+cLCVu)nk>}Wi8}Jvq)waB||x?QH#7qP#JBT53ROqsZ>1G
z6nUmrV)Z=T@W8;z5rgGu5GdK70dqP0wJf+eVs~T3feNMd(F2{j1m<ieyoz0&V3|zU
zuCg+^?@FM}{IEYa+;^vOCaCs^k(Pu<tmnc3iLH~w1c%w4h(KCHZ#n#(aH`rFQln!4
zE=_(Dvr)2|(K2`Yo4Sw-eh$rw)(`!A&H019=Dbdvy2B+F7X5N)+VV;D@|;d;p=N*T
zU48qSH=D0Lx$fD0!c5vVV48=Lv&ODo-?w_9^yr^T`uLACjK1aAp{P;9dbUKZ-O=*i
zg(e{lLFd?naoNXYn>?adSvWOkQo&4z?pSj`_qYbW{k#)7^5|<;L&t-(TPlwoU{2xl
z?E9bTEwpVy8`rVkg2tefxnVcqXO&8o-Ya={bH8~G*4J&()&4C19It@n`#IsIp8?^U
zh3XouzFsF;dXzHX7n!==!<ZYC+WAF7N8|0u#GB2jQw{EXIP*?iLHkWl=tM78T=zcj
z-q6!JE1PAazG@ELFd@icic4q&HT7@DPMz)8y|d#Z>3;_tam<RJbG|8X4Bb)|<|NZ}
z+!1uYPMoxLV8lgwOn_QIRJ#(GR^eQwv(?V)F8pRE+KCGlt3N(P(p^5UzP@>1yMFPJ
zb3Mu@w`J~lWlhaZhJcH_U!AywfjlL0{9e7EUs*VNC#xc4cXSBtAgG)<z%SdR>Qw)1
z*z5JCG0YFu6Dq0_KGw4JW{n`R+rZpvmlzsZ6DU;IhG#D=8`6>hK}Qi#HCqL|$D_*Q
zX4Re%soQ!0EaEc(M23$1l?yWZv*Vr^>Dy7Fz`>W#YrTY!Zy{&g9^!C0m$^mRm%ULt
zZ)(+ux$w*bt}zV&*at<_b!y^GaT!pdpu^$$o@767H5Z|zug%X%X`+8;urBPUc%Plx
zas`XJ7=E`p+;4kVe^?>Ldo1B*%_(B%iz(^zPCn)L&*@v2x?D*(<(BAt)JlTex$k@C
zV&B)yKYh6B`-X}a4*|4|bZ|~hH_D@iFXG+pzT3uqEFh@!XyAx(CreZm@Wr~Uc?yK-
zvI|{yVTJ^}x58SC0C3jpSIb|hgRT~~2dTt_jUnL>mv+pHHE<Lw8IZW%S$6Hzw2}l>
z&4rJBvC;z2qI+dSYHK!#@GMpcW^V3B!+wm?o<ullr{tkJ3to56)9#yiX^Ihc7%V6;
z>!sLO0~kJzl-H+a4{7Xr7lkQShr%9+Ib=MCFD^Q1IP=<S`POApcYMo!WHjauu`?R0
zF99+fC<{rDoQ!olJs5wk&LOB#3F)+kF+GHTrdUFEdCk*F?-1%#)j%;Cxl{T!l*R*B
z*`LZJZYUNtAGy(<vXwCwF<jTWSk2W8R6!{;-6?hMOt$!*E^C&l%wpoQcGv5p;NcsM
z6`9-}z(u@*^B2u`tyS%fhS}Ki{nV}FAE6|0V>sQ91)X{-VWjaG6v!mKHVcAfXmPR-
z!@hNatD%EXCH+Yf*7fXlkw9I#lf&7lpwFFzqd5P?8eJ{Ti77uGTrq=)z`JZlYb)Og
zelT4Lu2FERIUc-9vL=ls`sy4cS8xh{6}0b!_w<DI*4o$Cb#TK;Y_t%2{cz);2S4`-
z?=MfFO8MmOudBCjd*o`DG&s1-l_1I&x9M!+q?^BL#Lmpmy-Bq@&=grbG9~@RQi4<M
zyi2wMby=iyfm4*P+~24vgP6-+axOzO)Tui=UV_b4?w6NQB6;fD7QJFu?RCG5b_oef
z$EIPX`WKF)Dk7pC;M|`2-@9qY4u0{9&0fA_bCr<!#q}f%(N+mL@hW_l3OT#$%SliU
zpC9oflTm1WK_!DvE7w$$Zl~d<FQCEK_f(N*!<=>($|%OWm|Y96=D<cr+@owz#S$^u
zulIH{Qiy|3a`9*w*(SN2iXUAV$Lk3?;gn9?he|(MH{DupClRj*jU18j=DiMIBEy?o
zEU_Kq(qnLyr_`?Oa3?urso3*AMzx>4@}uo*HH4K8go*65*qgf=rq13fHtmGnqi!FQ
z9Y~TV5>-muE(<v$ry5>C7wtSw5phate4*7x40q<6qT0d|eG#?E0K^G}wyd~@*%8(s
z`V2p-rSar6V9+2T#Oz7!d|~W1F^wIq%ce#}9bv0w)8A_O>PS$nqKb3ISYo`gy$w;}
zM$AN<SzxVB<VPp9+jk<AB`l@)c%gJZyU2T#lb%)gIc?c#R$6#datzPHTrFG(n0wh}
zMfw=mnB^t;Tn*$=6Bsa8zuf68RwdTIuE};4>pFZ+KP-2_M~UpH>)ZkA5}5K3POizZ
z`@^&}PeImUft0SIYM5_s%CHUYeoRD=A*RADm6dnPk-@dL+fzIkcW;C>VwWZHe5|)c
zQkEYWr#G4b)K$X*Hbs{@b~>O9TD7Ah626xZLft%mXB(3~lkbx!?Vt2>FAIAGJM`g0
zl-o(v^W2Z|aovfDeDBoyl~7>c4`IEKP{oz!V+jIej}~y!_ZFL0uO~CZ!5TUh69_?4
zhIX3+ZtkEs3Wn>%U7frZkU9lGexH%Q^)^JM{4(oN`p_R)9)Dsz>n^Su=q_jLG-s+U
zK6?5i@~~t_9!*0XFZcjK9Kw2P?>eGtH801EbDO=OG-cwu)5uzo!~&h;9if76DYa1U
z-MSM}3nsWo_7?4s(gT%wTz)`|tr9TW2v(Xp73}X&SjxU9hUWhs&p$0B{K5Zu%;>Wm
ziIY<2v9BV*2fmb-=&kfBZg@~E74+r(B1ED?mfNn?v^m=*iBj!D=Qh|`r98~)b2c=>
zpYH-;ws}b@Rbz6%VqjPohJ*%JH&Zt?iA55~JK*@7H3St;!hnX#GsB>2kW5V*$f8gu
z-&dF3YdJ@8bfFtvWT2b?jC=tn1$rPTlcA(s(eI~hGz9BkF!~s0u|0ei1g$QnYO$Rs
zqdnMi?js;LamMS({FOG~U*kdHl-uJc8jh2iBr2i#H->$&CcWR9>$H_I<N)P~v7{Wi
zV1iMT$S{o%UUf*TV%|Q=ACe2ocZeu^M7%nS{@4~)ITI(|x`9v1p=?ek8V&AEf5>er
zeux+Ff$f;yYEi`|e)2u>t}M29S|s}1V{*{-=X@%1kxhdg3>jJOr<hk(g%-5SGarh$
zJi_=o@>yR57u!Tqv^PU)`t#4x?Au~DxH@#VKJ&PhtVY)CaXE{fnhsL?%V=$UG+~94
z?`5!bz$^oJxovjVxiM%tv@tBWFs8csg%T(^w#cYaWH{DRl@>_4t9CCp>?oculqS;v
zfrpkgZ=*|y?huw6bZ%*+sv26Skbg;-7&q95KTB&__S?V*V-j_@ed*vD0VEwuq%h@`
zvp{1s>3c@<0pZsV5H8&aEO)^@4JqB*cwlSkRjNtDOk&zIL7D{`J?h5UJ?DI!l-5!o
zT&URr<{UBaJ-jn_yT;kuKnS)X0q67Kc~i0enewM~{KpodKbz~eJ9ON8Up8;gG*UEH
z5qCB-ThG>k;)eX5q-qs&k3-c3C`Mm~y~TA$ie&b&BG>CXy(CA%b6u<|M(@`*Wa3|-
zMqKv!)-|9iHSB8=@N)~dWVzmhwhVtH|K!=8Al{wO%_XK8J?bV_DF?cvCgvi)tgv0+
z9E0BcI%+Rk^x^(Tp4)wwXV2a%!IY>=mm7SAZ>^!w%Hc#o`<Pm@ft5X3%68{8%E2jv
z<NSfoW2r8<tlBwHE-Rg?=C{?r-K$X;sL@JE7S(XGjFH$`GbTRWYOIbdE;SHL#B-zU
zV2k1ljWhHOmvkHfDfV6(e&0Y!ddV;(i83C!8w8~$YhZGE?@nKSLP*gLD9;5z-*gvt
zgG6cQ0eMRdM!Cfn3?;Yw5z!fx?F<^aR&%iyvc{W01&qi6i!<{LA9kC+*JY7rzw>X%
zc2}jWUIq#i<B{buXO+7hE<dxv=NY<(u5UzaIgl_Fk<4mhw}~a%T(dXukIVB$0k4NO
z^B7Jau@$ntEQcurVC9+*bW4}nNJ)>{uxYHTzbox#EG5Hj44J_XD<k_IPk@J05CoGF
zUnZL|`AvnKY{qbYafW3LXxb6Qv0h;$X<9w5(@Jh}1x}2PCMgSQZa|TR2Y+N5ud*G|
zD_{Xx!|x%79cM8s2WfTE+ymvuM(o9W<!`&}be-0RbiCz$qpnMI*bNQJ8jjn;n3GA#
z^e@Ks$6u_<`Qnunlv?)1auRM4G<~MNmdLMewbFhg6hxL)18vIaL{I{NqKrJ`+D*^p
z2nxY$#yAtDtRp_<18mX=FD{*IG=IEeKR%OXl0V5xf3MunkM>84qBq~vhDg1Q2PYW3
zybomTOvJq}fWX!mPjTUAj0zg;K;Bg6&x=Fe2InK?n#`N6R@&a3kd<kJgp%^+qVntv
zr5lW1Q_cOa%_~?2>05K9j%LUpg`c$jStCF?nlzFoGx~<0=8)15?d4AbAML1axauVZ
z%g}yIlWxn`g<Iq^8qKnvvbR60z3?d{hHJxWGKh&5GfPUo3-{iaX7u%bV_GHkFg>7K
z>+x0LvIsqcVQ?bO&TcsQV~Zd$$xGlCj3pEXL~<`Fm1ZuxMqnSpbIZD@T=h=s_uuf+
zQ%PbbTKya0FNZGGrPLRyYqgRUOyz9WG*&tU-@0n!a+rUY625TYcQwVP_ygS7vm_C{
zl>c%!AAyLhulpVpEq57w6g6^uY=7CyQfVD0y_L}$YF9QEg@-MM(5*b$w~gZ)0tqZv
zyX7yI6W=%DWeYx}yE-P4pT;Wnf4#)zl<08)MdYdiLHAkxRhOGYNH>dk6Ta+@v;t*D
ztrH{+eNtA$>1I3Xsk1=ixQYi#*w;Lv(3O#IIWmy`TQbwEP<`u~x6Vh_P52%K?-WkP
z4bHoEf#V0sXPHGBlV`IgBQ;kdKnfDbEh{Kt8AF^M5cOSRqIpf~1W;jgDXPbQ7=iRH
z`IML``2rYQI$4IIubx`U45Nzj?FgdTu*FHt{a*W=TK+`h%+j64RK+hQ?nI0A<VfYF
zz+78RyCBtj#*Ks|_o%tJKBq;=ru1A*^A&6m=0%@8@pWDZqS8ufR)=P<F#T94>k`Tp
z3_7dnPCorTAW5}K0)JuC-uV-tvNp62T!SSYBHcBq4()xTFi`5fm#1%3T6|1l7HA+`
zt$8D;tkWmg0SNk0TzA~huJ+4>MVcn<i6)#*U4AP3+-m}Hcf|lQc_qqj4-Dy1by`*5
z^=P*6F`4s$CQDzHk5sbe)q1zXR&19q`YMT=87wX?kJT><xL|YRb=p9^FGb7BRSvh#
zd)UEf{#}u6^y(9Pl?UBQs9phOouYKpf=m3U#1)YUAyy8Oo+AX69y_oS6_gK(5I{D4
z&%*fyH77ml#aw*kDXuHa*`*SuYz&#Ugg}dInH@uKD#+k~;)dH3u=lTJZe-!KSOJaI
zmDW3JlRE`YDiatz+Z6ufw<8dMKBGBiXhJg2J{!K|kjskVnI6+K>h!p!(<wS-Q5YC5
zvwhbai|%rj+WlgQv_+7UAxg3|hlaZP@{D?=NhMK<uo~t}zcX|@y+BD*Lj&!0Oyv|S
zwK_vPwk%Bdj3banL}7C3*-^PJHJ)-Lg?Zb$IpR$&l%D5Dp^WuLNWW$1NR(j;5H|-U
z;vW>aV2H_<!DxA9Tjj;x+xf-t0u9D~lS|IPDo;)1y}vA5)_k!KY+e*T4Uw}MCw#0N
z_;Z~ORvzoEmG-Wy;blioorl{dZ`r_7mIi$7Ibnr*PnzRy1j`6{8PZ~Haa&na?49xM
z{5~~pL7s&YU<7w{v1!3M%W|+>Mazy2eO#?TSx`yK7Ou)1*kuh7Tex1!4w@QlHG?KX
zWo;ffaK;zS`P&xXgXx!-8c8PJ%Zzxc*1ck=hxN^>cA}XVFdb`LqgtA`7fRTwYEq6D
zrd-gG{z%+`PK*R!(s_GehC8~1?^E!b4LY4vpgg%X>aQ+@6y=ZbFf3UyeKNJkcShMR
z6wX|GDu}+eK7#KN<)`lP&0R=qt!($Dy(zhTEbL+;>Ccnkyc-{gTqmHB)sKZbJQ26V
z$24!{gS8>zyZyyzf5@&gy>^nh?C0n5zIiK(<=MDy1kj=eKv}bJV&5b)!;flQ@!UVH
zICv5XLN`*KHoD*YEwgf*Hii(k;H{k9_oaE4ZbfcjAaa^n4q^+KdUUJG@s4W&7KoD?
zV`W-Fl^!~bn~frNDi*7@iuKNXZiRtRZ}rEaR)%zW%Un>oV}DOIHp5FBr-{xWiQm^n
za-M2y=obz4HU><*t02z)oddc1BL@N&CK-MgI;>!@C)aRyfPJ9zbIo9x?Dl6<sv@E8
zyxo}{A_Zzz16NMs>|0>y)ZTMoow&@-jV;+N6TXW)_LC-AlglyAiIH&O+#!3%IFC~k
z@f%@$H~k$Gi@5HMWJp5_NUkU8I2zx$s^k!#>hy4Jn1PtGO9Mt~Vu3Vx$I`5N=Yz{#
zTv?bRgELr48LRchE#}LTbd{(+9G{$nK`>fYGc`wIfgD>!^%Dv2Uqh5#aQX6MzF0OK
z44EJ)Zl^hYptXoQUgf!UrZUK8k@h&`*?qN8`L?4$y&^3VkTcSsigA7(ABA+u7D*y}
z{4Wg>skn;VbGUqHsaEK=Jyc1&z%~rf<lc>WO1Eh|u3wiiC($gXp_{KA_I5ljvXkf-
zK71`HH2fmkM_NaB+kIS9g1@j-Dbrlkw|k4?cLt2PdPO_|L>;vMl3_m9d+ik7YS2qL
zi&!m)E+Nz9g=1Q!j6V-2lV7+1n?bqe;rRCj1ycx9o_xpJlfcV<OX+0<{PhU(ei>8m
z#R+FmU^!P~+26s)O-ba;kWX$D{fFgS+r29()93YMxW@ws6Q%f3;<%$?cVph~a!W{L
zMr}BLUy5{^L#H-?CSdo%Wn;jM&nc02%;dcLL9p*(=VAghPo;Z1a<SJ2>{3t~u6ozk
zl=qq4c?<j7F#g`-a5mTN^Zf#&&6P?8OGZ``3D!*2C&w@ccXlxTFBI^7T3uR0<FYCI
zb`oxJ$!YR$;HY{eYnffJ%s*Svyy?bvf={wuNt8p5fx}omD~W#wWyAKobh;9E>A_WP
zpC<(FOy4%v!_gE(`^c$aAQ*J4HG}Ir#&?3p@G(_QRuHY0k}qeL2Tt^ruS0K6MikpN
z)(I<qJ3<`IA)l5u`k3w6UNdN>b!(G7?zfhWxvXZ0slj=j;V9%dl;#CIsn&;25|}Lt
z>;1skafZ^oqi$lyZ53RUA&N(OiBpm>EuaZ&#b8Ky?KmR1aVdP3gbvG6%5u-CN8^RO
zm0Z4wo}qQF<qRn%rVVNB&NyTiF$P-Foq^@PK}B6kCpCK?ffMt`{?3eX?x(C)iojxb
z3okt)%{^x)M~pZ|F2VWij$E_{)N;Q$$oD2@?Zw{On5na72JKSU2EGk^>MwrVEaj=)
zbltH&ejKqPkpjHkc6*&4oG>`gjRu;J$2a&YqZGlg0&a|Ood1XU^xhunee3oyGjq;q
z5fJ~(<|VWbYc|={7p8Ntab31Q&q45&S_^S99zU6=z7jZQR1)lE3F#{5sI23UNZFk+
z+pW=}Whfg9rf{v3i@uw3lY&^=J=?-Ze8qd~@I{>nlgl?^Rdjsos+{Hh1OfgZh^~sq
zDm+wl`0mp^lGsdd7|_=nizqn-`B}2at&ysl&~k+dZo+EIok2*5;#*3bz_focMjsN=
zBxak07%d2S!^VF_!gC|$u0!Y2sKocO;_{YYXl*ld0YjWJ*1c<LK-ie?6P)(mVS5P!
z^2DWq+oo-QoKuku>`oG7Lj)4$S@If%PFmYGkdUhJkX<7v(qr&JadpL-UqEf#NO7Uo
zh9&9FDe5$_ww#AGaJ0n7CIK-u(o~?oG$6n-Jx{CpvFKbmJZIti6Cv})#FIOt?$(O)
z<QNyKcLG#+v#wFer~y6L=c-($t1dnC*Ngffr{G7;Qi|Z7<!Ljek%eIv`_|!85w3-d
z%i{Gg@iaOA$dWpap_>-<DWdJFZH8w>y|AEo(P339m!XH;y(5a!#wDGE0ke1rJ$vdx
z);1gMFOupo7OE7Ov%(s`1b3Th6QaF2y)IkPVxdp<dqUAl5yLLKF}n*FjZE8{Pdb%o
zNX@D&lBv~xr}JG(+!P&}Q=vf6U;D@gxr<K+%!&3%1m*~82yL04ymB1EaD?h|P``or
z>LKCP-O>$8-KJT@BPC9ou1VF*etOmV)(gsP#|EXnSX@a~0{YH2>GjgZa`s7SV=Cf)
z;VL0Z*RLZZR>PBwe097|j4QYY-l?6F5hq1{6r0y>a$0HwDs&KTUstG-C~JqytBhQE
zE_0@*q!oKKS<d<iGl3r&bDMarzF$L4!T38)c@Meal*3JLmy!s9{{L3Re(XxNMfz(P
zJ#VmN%yqQ5stXP5$%uZh^x|#ItC5!5)pvGpA9ydNH49faby-L%I#BHzjrAEd><Q7;
zSb6N3HPFN-v01ffz!Wo(9P9CYO5m-&blG52l)XVpf8qY>?gt6}f^51cz&Sz#oJdpU
z4r-s%k-=?9J|Zn<O)R}_g53<$d|NYt-Xozn5C(O)cj1b$&eH6mq~+=YpQGQ&4L64f
z*-$0=2)X$HnrjePd370d>h<P^7+JdG20~16K(?G+GszQ5mLB~pnDA~$!#fkcim=Xn
zv)dle>S;*xDp8mSsj$UcrBr4PVYW3_GilT<(4rGzKoH$hQt|w8aQSmJ6_qahT&9X{
zoYMJT5&(A}h|Vpp%#l5nUN)YvhO|Uogds4#UcgO1K^S{~8tJObgB9i0(B_wR)^C`#
z_x8T*GbWWj?Nd^u(W;Gpgy}NuFg?$G>iUm@jR!wgw7-t<wjn7kF!wu`o$zb7q=XG_
z%Uaxm)u_%*qCRtGxS`QI8O-Ok=z4GjqA^*{2wsH3ZSblolPz~16M2XH-qne<OM6da
z1m-=|v3!b@@s7$w_~TjBZ13VKcQN$Sc=5y)%anpur}?T3P0&q$Dgbk(1^CP`sIMVX
zrb(uaeeoTeMJ<lyAXoq&tAKi-y~#ZD96F8RJg+L`Vhjsci}g;#e%@dfR$hFw@TYZ3
z&S7fI7Z8X_vA_P%Zw;O7r`F_AicjWcth7}5DSH8IhtCC1j>YLr451^}aT8#>a}{>U
zIw*3ZJK0*$p_|aIWt4P6C5k|-qU5cj*1R;(-?n?I1V}IPz61*pFs&Y%XLjdSrV>@~
z3(1cdmKB-x4$l*~(IXj7WCNzWUhbHJtjIhlD(u6hi~bv(dbxWwG1)p~*@z|zX_0I+
z`nPd^!mc0x#IB^4J%!5H#WXEVYL0Vd$$dOfxRk`Z_kB$9%V(;?K@a4>%LzGBDub%F
zPFati&RyfhZL_2s4DYR6_KR6ff(Q>v*AjjGaa-Q+V+LJoll<Q)=JVYt)V>fCn8=qZ
z6F18x0!^~rHd`Lr9-6iq@zF{_a8jEK&rkMz7c}v@g;Nw)Q<$xs?X?eIT*<q{KVi>F
zxiaOX>-7%f-(%M4;B*$8a4K^;1o+}=@Wdg0r^FmyDmQI9WQ2!qDzvohk=f3b8KzQ4
z-gd6}0~uPaVBljHzthK1@uEz)d59eZ$BWV}ybL9gm0)&$AcTDC75iF)6V0~CnFN;5
zVJ}(J`S15Mn{JOQ%J)8kixfoBmfrjMBkTqVyZdL4$P*nMx72`!fl2mhBsf%)jfVE}
zNus9wNp>qCgL4<-wP;$T&^(GwkY%}hJkF2!ElV@0I?MzC0KfNo+>`<NQBg?vk@#yq
zhmHTFa?&bE0JE`0+7@$Ggr9c=xd+|v)Ika#*L8ajRF7&miy2XA=-7^gncMF6C*6JQ
zBreNPCXr(;y1Q+K7brr3Mh!wQJ=6!Q-CHl$NDn>8b|}oqhCyXPb!vd2%z35n#9kT7
z01Li$s(_EZ5qYEogp=Ez4qA0OpJGYaV(+CihD-@rOP>+$@*j=Y%hA|XG=h+{vdqa)
z=q~$a$PQb7zKd$M9oEK{Dfm3s2e8{q#(onJm{~$3l0kN!_*5rckSld*Gf7WE<5WkT
zZ`Az}tAuj-BVkVJ99ts*w!gmEsn&c-;-heD4KbiUrQ2aTMaTxK`S#mbLYGz$JKXcA
z&Ckkl0&c5%d$+3$(d=VdxY|`P6X5av)~Eaa(9s38WewF8o@AOncT&bmPT&)zrtBFl
z08=n#AvMqNP13;)t$iAg{j~lvnJ8_@jA)k0B{^@X!16S1+x&=^pR;wkFg!3<G}__J
zTKnXdGA3%*1bJ%*E+pWgywin9x%EO5e)@~KQfuEzdzZXAWMj<W)3&i9-V3k9@>Tuh
zgmLbeU`UK2E$ZoWW^+0b0M{jR$U9?^V6^#?O)Oz!r+Oi$GC#_%U<E)HibZd%aFPFF
zD2s;{Z_j=V%%^_z7L(0C%1T#jp3Qp1Z1zaT4*AE^H5b16(1Ep1m&B=wMhMMyOuo}F
zPI63rX^^!59jslk)V9%19<HzZhLYca1{>jD1S0)Ynj$>DYMb)(<KwJ$og{VC@-xzl
zv6-<Fk*-x~cYh?%6r-6rrT`tAp|%lTz#xaLeZW)HG>W}E{iysG>P7ahUg|xCst(4o
zRZvpz?`H9j4}F*q|2zfz@yw6b?^|pbGm16}^#8|iw(&j4Mri5YyBRC<k5}00i(soS
zxg`jj`|GW}N4QWtLj6;}I)+uS;kw}!d1|sh-wOG}erw->K)|n#3393F580zpM}h9Y
z8lw)fA4BfD6Z^-{7XkS{hHLi1zWlf0vURriKE5ROPpTh&A`5)=3vaF{sQ%Y@dK_Mz
zVS1^@^#A7chcYnt2b2JIhHf7EMW*<xhh8Unc>7-eYJt_W3IDGhJ^Vp<Tfo_0G!hiq
z%hBp0Y3a}}Ilf}cagWNWgkK~I9qA?+0(3ftaPRs5DQqq+z37qafXIir$Jn{&e~|9e
z{bRQT^~l`%zxqo01kj(*+P1X%MHE+!!g*|}M&i!NA7Sf12Q51?XVDva^k(GGrs!LG
z0CBm}pEPmRC`pRdgZDiz_({~g6TC3v!}9;u0~e}nXb<t1%!JrqOWK#iKc%XN;UEA|
ziZW+4f41z2J|TnxcKrF1e7%Qya!q&N?f=y!XXxH3tGhoL=9T=)R*VlE|9Ty)2e3H#
zlLJn!b&fBUAAU}>q~0q*UfA9JKl$0q(eluz^xQ9gc)8e>lXnOHHP#sp8<?z+#V^T?
z3h=_l5Ifh*ev<d~NVbm6zfp6Z@2j8I=a1KZ{lEO7C}p%|^P1_;7N0A6^$Gft`Nw~<
zP^0(?WH>eing2D)8MZobwx0XRlinD|7vKN82M$Ejo4HW?VvK)s8eO;FS#7FeS>)CF
zFYe6uDx%DfF8=!6b2v$Drl&CK>5tg>AFV&;hZ|Zw2f5Ei#r?DOYZF_e|HnyPWYfE-
zu1EjHkkQ_$kiS0u!%ncLhTVhD`2VO^3g=<|<EoFUeknHZm1y5w2eDtYa&kR?1A1!n
zi>UuJv2**MINXi?7hlSfVkL+F)!Tp2Dc<vk;@ti<);;N0#E?h#Gk$jW%5yJUw2Kx0
z5^c-F`NDr!Gk&(H`MFDe4Y+)`L8=1pUNQ5lC6<$IIXI`~eo20eqv>u<1S=!|=P382
zCB@9nm;RgHus^>4y9ao)afv=!_d<SIK3CAai~O*$^1c7k=<_Gp8a(jvm%e^2{r}ro
zv@6=?@7Z%U`KrO6cYYg=--hFVTM>R64)*GJ@3-Oj?PdITH{`dm_-!n>YS^L5e|1BC
z8;jq@;<vH*kFn-&&*Had@go@iZ7hBpi{HlLhb{Pz369^M#cyNr+gSWI7Qc<f-vy4}
zm66|-5w72rk^ck7;kRe;yNvqZ9f$u|XZ@Yv{GH(Zo#14br2j*G{5R%;Eu-JY;<vH*
zZ7hBpiywHM-=4+)V}RCW_LUGH_Od1W4`g37_{Z=6g8IY!JIs%b(8B%C5W3L45&s1U
z_@5D45^U7hmj2CVgI_?nw`>^OY@nsvFRFO>cwxGn?IyoaU7l>Lt0y?P=*&;>*cLB)
zL*W0^iJlrqwe_)Yo7IZC=71fP*qRH&3dBAu=bwWDLOIy&I-$kON&k?<50Pkvusi*n
zb4mKAd_Gm4$j%U9Ut316)QXV3@snV^@1GBK!+mli5(EVV5)kb?u)(xny};`9oF`l9
z!S^qM&cZd}>S7YheZfJ$IN=m8)w{^+A|QU*?+M{{U2xD7!okHQ*I)lPHn_)ykO;bz
zn3(9~5-j`0ck^O-i<|(aqr=%64Bq*;?4Gdm;2`sBUh|cIk;8Q;{7!xkcQ|dOWB6us
zO-;icua>ClT+Jw@%M_!dtrCHcC)hiQQ*QF*{X&fHi7rrDyY)IGB*N2Ev1*NRTFv)@
z7>VH57`ki&o$iuFmx1ch6B84$kzf3A+Lke2!?(!#!E3)nvnM(V$Du!`&D^?Q%sxr#
zj%k68T_h#l@|yFsZDv)0VI9}%>S~rh37a9R;gwW|f_~-x(ubOljvXqlu>J*Om0ZI~
zo#&ipF7bdQz@p-64Cez_h46*`7ajntPxBp%OiMHkx%-$h?hjEM8yo9gonEoZABS>v
z(x(Ho3wRDn*rZd{f1H>0Pj!xhaOjI`Goe3@b!xP$6Dk1uzt!4h2D=M@ZR5O7Rw_7M
z27|2?MSJ<^--_zd4k>n}-i~_W9Nyv{O<)bc`r_KbW8OTBqd4tf@Ic<JVy^Hz6U<nc
zI$n85O{hRStj>8-EPJ|b!DiVz7xkVG2ujH++}Qe-leJK(OO7u_FD$ru+E3u|WfeDg
zY#>|0Q7m&BLzu@~?I)dkIds$YVAs>^<k&}~i#}DhYr2z}Wr4mNpeCL<(kiGkctiY@
z+LhHMudEg!(sKX2Is5qV?c1EQMSdh~UR7hGwdx-(1xX%<bN~RMP1?UHLgyjwYF!d5
zP&mOXU&~tG_n1x^KE8U$;Nmfo**bqYE4iB95JOP7;Ye7zX}ig@iNRunSY5NTi4t%t
z@usz#7jz5GL5(NT*Tg>kLYeA)k2^Bc9SjeHZ$viHCXsi`!7VmnMx_Q>(;38pXDza-
z`zKfDZ?=-#<J#0kcn&q{Xbw-7D7J?&dhNvyg(2BH_%rP^sk#Z$!SQ-KX(kc6lRci4
zJ35YI%<-u<-Gz`oPl`_~<<?l#cUJf`m0l9HLnEygOjUG{eYb-bjad<w@Xq5Z7CLT>
z`#IZ@I%HY}GK$4oT%C-Xo<z1z%1Ufzk5n?O-z7JjBx2NgT{IHNgzeNzHK%rU#m~x}
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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] [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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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/2374] 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 f9f7ba4ce962558581ec5786397efad96e2ccc53 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 23 Aug 2024 18:24:04 +1000
Subject: [PATCH 0953/2374] Do not raise error if bitmap buffer is empty

---
 Tests/test_font_crash.py |  11 +-
 src/_imagingft.c         | 264 ++++++++++++++++++++-------------------
 2 files changed, 137 insertions(+), 138 deletions(-)

diff --git a/Tests/test_font_crash.py b/Tests/test_font_crash.py
index b82340ef70b..c394551f590 100644
--- a/Tests/test_font_crash.py
+++ b/Tests/test_font_crash.py
@@ -1,10 +1,8 @@
 from __future__ import annotations
 
-import pytest
-
 from PIL import Image, ImageDraw, ImageFont
 
-from .helper import skip_unless_feature
+from .helper import skip_unless_feature_version
 
 
 class TestFontCrash:
@@ -17,8 +15,7 @@ def _fuzz_font(self, font: ImageFont.FreeTypeFont) -> None:
             draw.multiline_textbbox((10, 10), "ABC\nAaaa", font, stroke_width=2)
             draw.text((10, 10), "Test Text", font=font, fill="#000")
 
-    @skip_unless_feature("freetype2")
+    @skip_unless_feature_version("freetype2", "2.12.0")
     def test_segfault(self) -> None:
-        with pytest.raises(OSError):
-            font = ImageFont.truetype("Tests/fonts/fuzz_font-5203009437302784")
-            self._fuzz_font(font)
+        font = ImageFont.truetype("Tests/fonts/fuzz_font-5203009437302784")
+        self._fuzz_font(font)
diff --git a/src/_imagingft.c b/src/_imagingft.c
index f8143e0cc32..54b78d5bca2 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1025,130 +1025,99 @@ font_render(FontObject *self, PyObject *args) {
             yy = -(py + glyph_slot->bitmap_top);
         }
 
-        // Null buffer, is dereferenced in FT_Bitmap_Convert
-        if (!bitmap.buffer && bitmap.rows) {
-            PyErr_SetString(PyExc_OSError, "Bitmap missing for glyph");
-            goto glyph_error;
-        }
-
-        /* convert non-8bpp bitmaps */
-        switch (bitmap.pixel_mode) {
-            case FT_PIXEL_MODE_MONO:
-                convert_scale = 255;
-                break;
-            case FT_PIXEL_MODE_GRAY2:
-                convert_scale = 255 / 3;
-                break;
-            case FT_PIXEL_MODE_GRAY4:
-                convert_scale = 255 / 15;
-                break;
-            default:
-                convert_scale = 1;
-        }
-        switch (bitmap.pixel_mode) {
-            case FT_PIXEL_MODE_MONO:
-            case FT_PIXEL_MODE_GRAY2:
-            case FT_PIXEL_MODE_GRAY4:
-                if (!bitmap_converted_ready) {
-                    FT_Bitmap_Init(&bitmap_converted);
-                    bitmap_converted_ready = 1;
-                }
-                error = FT_Bitmap_Convert(library, &bitmap, &bitmap_converted, 1);
-                if (error) {
-                    geterror(error);
-                    goto glyph_error;
-                }
-                bitmap = bitmap_converted;
-                /* bitmap is now FT_PIXEL_MODE_GRAY, fall through */
-            case FT_PIXEL_MODE_GRAY:
-                break;
-            case FT_PIXEL_MODE_BGRA:
-                if (color) {
+        if (bitmap.buffer) {
+            /* convert non-8bpp bitmaps */
+            switch (bitmap.pixel_mode) {
+                case FT_PIXEL_MODE_MONO:
+                    convert_scale = 255;
                     break;
-                }
-                /* we didn't ask for color, fall through to default */
-            default:
-                PyErr_SetString(PyExc_OSError, "unsupported bitmap pixel mode");
-                goto glyph_error;
-        }
+                case FT_PIXEL_MODE_GRAY2:
+                    convert_scale = 255 / 3;
+                    break;
+                case FT_PIXEL_MODE_GRAY4:
+                    convert_scale = 255 / 15;
+                    break;
+                default:
+                    convert_scale = 1;
+            }
+            switch (bitmap.pixel_mode) {
+                case FT_PIXEL_MODE_MONO:
+                case FT_PIXEL_MODE_GRAY2:
+                case FT_PIXEL_MODE_GRAY4:
+                    if (!bitmap_converted_ready) {
+                        FT_Bitmap_Init(&bitmap_converted);
+                        bitmap_converted_ready = 1;
+                    }
+                    error = FT_Bitmap_Convert(library, &bitmap, &bitmap_converted, 1);
+                    if (error) {
+                        geterror(error);
+                        goto glyph_error;
+                    }
+                    bitmap = bitmap_converted;
+                    /* bitmap is now FT_PIXEL_MODE_GRAY, fall through */
+                case FT_PIXEL_MODE_GRAY:
+                    break;
+                case FT_PIXEL_MODE_BGRA:
+                    if (color) {
+                        break;
+                    }
+                    /* we didn't ask for color, fall through to default */
+                default:
+                    PyErr_SetString(PyExc_OSError, "unsupported bitmap pixel mode");
+                    goto glyph_error;
+            }
 
-        /* clip glyph bitmap width to target image bounds */
-        x0 = 0;
-        x1 = bitmap.width;
-        if (xx < 0) {
-            x0 = -xx;
-        }
-        if (xx + x1 > im->xsize) {
-            x1 = im->xsize - xx;
-        }
+            /* clip glyph bitmap width to target image bounds */
+            x0 = 0;
+            x1 = bitmap.width;
+            if (xx < 0) {
+                x0 = -xx;
+            }
+            if (xx + x1 > im->xsize) {
+                x1 = im->xsize - xx;
+            }
 
-        source = (unsigned char *)bitmap.buffer;
-        for (bitmap_y = 0; bitmap_y < bitmap.rows; bitmap_y++, yy++) {
-            /* clip glyph bitmap height to target image bounds */
-            if (yy >= 0 && yy < im->ysize) {
-                /* blend this glyph into the buffer */
-                int k;
-                unsigned char *target;
-                unsigned int tmp;
-                if (color) {
-                    /* target[RGB] returns the color, target[A] returns the mask */
-                    /* target bands get split again in ImageDraw.text */
-                    target = (unsigned char *)im->image[yy] + xx * 4;
-                } else {
-                    target = im->image8[yy] + xx;
-                }
-                if (color && bitmap.pixel_mode == FT_PIXEL_MODE_BGRA) {
-                    /* paste color glyph */
-                    for (k = x0; k < x1; k++) {
-                        unsigned int src_alpha = source[k * 4 + 3];
-
-                        /* 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);
-
-                            /* 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)
-                                );
-                            } else {
-                                /* paste unpremultiplied RGBA values */
-                                target[k * 4 + 0] = src_red;
-                                target[k * 4 + 1] = src_green;
-                                target[k * 4 + 2] = src_blue;
-                                target[k * 4 + 3] = src_alpha;
-                            }
-                        }
-                    }
-                } else if (bitmap.pixel_mode == FT_PIXEL_MODE_GRAY) {
+            source = (unsigned char *)bitmap.buffer;
+            for (bitmap_y = 0; bitmap_y < bitmap.rows; bitmap_y++, yy++) {
+                /* clip glyph bitmap height to target image bounds */
+                if (yy >= 0 && yy < im->ysize) {
+                    /* blend this glyph into the buffer */
+                    int k;
+                    unsigned char *target;
+                    unsigned int tmp;
                     if (color) {
-                        unsigned char *ink = (unsigned char *)&foreground_ink;
+                        /* target[RGB] returns the color, target[A] returns the mask */
+                        /* target bands get split again in ImageDraw.text */
+                        target = (unsigned char *)im->image[yy] + xx * 4;
+                    } else {
+                        target = im->image8[yy] + xx;
+                    }
+                    if (color && bitmap.pixel_mode == FT_PIXEL_MODE_BGRA) {
+                        /* paste color glyph */
                         for (k = x0; k < x1; k++) {
-                            unsigned int src_alpha = source[k] * convert_scale;
+                            unsigned int src_alpha = source[k * 4 + 3];
+
+                            /* 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);
+
+                                /* 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], ink[0], tmp
+                                        src_alpha, target[k * 4 + 0], src_red, tmp
                                     );
                                     target[k * 4 + 1] = BLEND(
-                                        src_alpha, target[k * 4 + 1], ink[1], tmp
+                                        src_alpha, target[k * 4 + 1], src_green, tmp
                                     );
                                     target[k * 4 + 2] = BLEND(
-                                        src_alpha, target[k * 4 + 2], ink[2], tmp
+                                        src_alpha, target[k * 4 + 2], src_blue, tmp
                                     );
                                     target[k * 4 + 3] = CLIP8(
                                         src_alpha +
@@ -1157,35 +1126,68 @@ font_render(FontObject *self, PyObject *args) {
                                         )
                                     );
                                 } else {
-                                    target[k * 4 + 0] = ink[0];
-                                    target[k * 4 + 1] = ink[1];
-                                    target[k * 4 + 2] = ink[2];
+                                    /* paste unpremultiplied RGBA values */
+                                    target[k * 4 + 0] = src_red;
+                                    target[k * 4 + 1] = src_green;
+                                    target[k * 4 + 2] = src_blue;
                                     target[k * 4 + 3] = src_alpha;
                                 }
                             }
                         }
-                    } else {
-                        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
+                    } else if (bitmap.pixel_mode == FT_PIXEL_MODE_GRAY) {
+                        if (color) {
+                            unsigned char *ink = (unsigned char *)&foreground_ink;
+                            for (k = x0; k < x1; k++) {
+                                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
+                                                        )
+                                        );
+                                    } else {
+                                        target[k * 4 + 0] = ink[0];
+                                        target[k * 4 + 1] = ink[1];
+                                        target[k * 4 + 2] = ink[2];
+                                        target[k * 4 + 3] = src_alpha;
+                                    }
+                                }
+                            }
+                        } else {
+                            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;
+                                            : src_alpha;
+                                }
                             }
                         }
+                    } else {
+                        PyErr_SetString(PyExc_OSError, "unsupported bitmap pixel mode");
+                        goto glyph_error;
                     }
-                } else {
-                    PyErr_SetString(PyExc_OSError, "unsupported bitmap pixel mode");
-                    goto glyph_error;
                 }
+                source += bitmap.pitch;
             }
-            source += bitmap.pitch;
         }
         x += glyph_info[i].x_advance;
         y += glyph_info[i].y_advance;

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 0954/2374] 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 0955/2374] 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 0956/2374] 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 0957/2374] 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 0958/2374] 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 0959/2374] [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 0960/2374] 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 0961/2374] 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 0962/2374] 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 0963/2374] 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 0964/2374] 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 0965/2374] 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 0966/2374] 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 0967/2374] 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 0968/2374] 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 0969/2374] 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 0970/2374] 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 0971/2374] 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 0972/2374] 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 0973/2374] 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 0974/2374] 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 0975/2374] 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 0976/2374] 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 0977/2374] 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 0978/2374] 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 0979/2374] 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 0980/2374] 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 0981/2374] 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 0982/2374] 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 0983/2374] [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 0984/2374] 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 0985/2374] 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 0986/2374] 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 0987/2374] 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 0988/2374] 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 0989/2374] 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 0990/2374] 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 0991/2374] 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 0992/2374] 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 0993/2374] 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 0994/2374] 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 0995/2374] 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 0996/2374] 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 0997/2374] 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 0998/2374] 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 0999/2374] 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 1000/2374] 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 1001/2374] 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 1002/2374] 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 1003/2374] 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 1004/2374] 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 1005/2374] 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 1006/2374] 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 1007/2374] 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 1008/2374] 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 1009/2374] 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 1010/2374] 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 1011/2374] 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 1012/2374] 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 1013/2374] 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 1014/2374] 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 1015/2374] 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 1016/2374] 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 1017/2374] 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 1018/2374] 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 1019/2374] 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 1020/2374] 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 1021/2374] 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 1022/2374] 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 1023/2374] 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 1024/2374] 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 1025/2374] 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 1026/2374] 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 1027/2374] 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 1028/2374] 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 1029/2374] 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 1030/2374] 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 1031/2374] 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 1032/2374] 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 1033/2374] 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 1034/2374] 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 1035/2374] 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 1036/2374] 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 1037/2374] 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 1038/2374] 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 1039/2374] 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 1040/2374] 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 1041/2374] 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 1042/2374] 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 1043/2374] [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 1044/2374] 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 1045/2374] 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 1046/2374] 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 1047/2374] 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 1048/2374] =?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 1049/2374] 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 1050/2374] 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 1051/2374] 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 1052/2374] 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 1053/2374] 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 1054/2374] 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 1055/2374] 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 1056/2374] 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 1057/2374] 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 1058/2374] 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 1059/2374] 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 1060/2374] 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 1061/2374] 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 1062/2374] 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 1063/2374] 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 1064/2374] 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 1065/2374] 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 1066/2374] 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 1067/2374] 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 1068/2374] 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 1069/2374] 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 1070/2374] 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 1071/2374] 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 1072/2374] 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 1073/2374] 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 1074/2374] 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 1075/2374] 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 1076/2374] 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 1077/2374] 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 1078/2374] 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 1079/2374] 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 1080/2374] 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 1081/2374] 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 1082/2374] 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 1083/2374] 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 1084/2374] 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 1085/2374] 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 1086/2374] [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 1087/2374] 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 1088/2374] 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 1089/2374] 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 1090/2374] 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 1091/2374] 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 1092/2374] 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 1093/2374] 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 1094/2374] 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 1095/2374] 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 1096/2374] 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 1097/2374] 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 1098/2374] 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 1099/2374] 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 1100/2374] 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 1101/2374] 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 1102/2374] 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 1103/2374] 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 1104/2374] 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 1105/2374] 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 1106/2374] 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 1107/2374] 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 1108/2374] 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 1109/2374] 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 1110/2374] 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 1111/2374] 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 1112/2374] 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 1113/2374] 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 1114/2374] 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 1115/2374] 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 1116/2374] 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 1117/2374] 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 1118/2374] 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 1119/2374] 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 1120/2374] 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 1121/2374] 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 1122/2374] 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 1123/2374] 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 1124/2374] 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 1125/2374] 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 1126/2374] 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 1127/2374] 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 1128/2374] 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 1129/2374] 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 1130/2374] 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 1131/2374] 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 1132/2374] 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 1133/2374] 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 1134/2374] 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 1135/2374] 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 1136/2374] 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 1137/2374] 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 1138/2374] 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 1139/2374] 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 1140/2374] 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 1141/2374] 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 1142/2374] 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 1143/2374] 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 1144/2374] 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 1145/2374] 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 1146/2374] 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 1147/2374] 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 1148/2374] 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 1149/2374] 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 1150/2374] 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 1151/2374] 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 1152/2374] 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 1153/2374] 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 1154/2374] 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 1155/2374] 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 1156/2374] 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 1157/2374] 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 1158/2374] 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 1159/2374] 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 1160/2374] 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 1161/2374] 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 1162/2374] 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 1163/2374] [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 1164/2374] [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 1165/2374] 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 1166/2374] 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 1167/2374] 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 1168/2374] 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 1169/2374] 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 1170/2374] 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 1171/2374] 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 1172/2374] 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 1173/2374] 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 1174/2374] 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 1175/2374] 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 1176/2374] 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 1177/2374] 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 1178/2374] 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 3911afbc97f5b3195609800f471794f6b3e349dc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 14 Oct 2024 16:56:48 +1100
Subject: [PATCH 1179/2374] Removed Fedora 39

---
 .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 21e1275e7c9..880fe3eea24 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -46,7 +46,6 @@ jobs:
           centos-stream-9-amd64,
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
-          fedora-39-amd64,
           fedora-40-amd64,
           gentoo,
           ubuntu-22.04-jammy-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 00dec41d165..21ebd1ad520 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -29,8 +29,6 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
 +----------------------------------+----------------------------+---------------------+
-| Fedora 39                        | 3.12                       | x86-64              |
-+----------------------------------+----------------------------+---------------------+
 | Fedora 40                        | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |

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 1180/2374] 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"

From a433f24f0bf5a9df98bbfe3c076a060131e92854 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 15 Oct 2024 22:14:26 +1100
Subject: [PATCH 1181/2374] tile is already an empty list

---
 src/PIL/GifImagePlugin.py  | 1 -
 src/PIL/WebPImagePlugin.py | 1 -
 2 files changed, 2 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 57c29179273..a7c4f8b2c57 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -103,7 +103,6 @@ def _open(self) -> None:
 
         self.info["version"] = s[:6]
         self._size = i16(s, 6), i16(s, 8)
-        self.tile = []
         flags = s[10]
         bits = (flags & 7) + 1
 
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 64188f28cb3..c7f855527f0 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -60,7 +60,6 @@ def _open(self) -> None:
         self.is_animated = self.n_frames > 1
         self._mode = "RGB" if mode == "RGBX" else mode
         self.rawmode = mode
-        self.tile = []
 
         # Attempt to read ICC / EXIF / XMP chunks from file
         icc_profile = self._decoder.get_chunk("ICCP")

From 455e6da119ac01ffc3aeb68486cef47e1f3f8dcb Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 15 Oct 2024 17:30:25 +0300
Subject: [PATCH 1182/2374] 11.1.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 963d8c906dc..0807f949c31 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"
+__version__ = "11.1.0.dev0"

From 8393972c3540cf7bba737b0687d79c5d8ebca3ef Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 16 Oct 2024 09:56:33 +1100
Subject: [PATCH 1183/2374] Skip PyPy3.9 wheels

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

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 837e5ea91fe..34452fa563c 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -152,6 +152,7 @@ jobs:
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_PRERELEASE_PYTHONS: True
+          CIBW_SKIP: pp39-*
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
       - uses: actions/upload-artifact@v4
@@ -224,6 +225,7 @@ jobs:
           CIBW_CACHE_PATH: "C:\\cibw"
           CIBW_FREE_THREADED_SUPPORT: True
           CIBW_PRERELEASE_PYTHONS: True
+          CIBW_SKIP: pp39-*
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm
             -v {project}:C:\pillow

From 7c194b54ef3e7a04c5b669353622687075b5ebb4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 16 Oct 2024 21:37:14 +1100
Subject: [PATCH 1184/2374] Fixed disabling a feature

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 60707083f6e..def3417845d 100644
--- a/setup.py
+++ b/setup.py
@@ -389,7 +389,7 @@ def finalize_options(self) -> None:
                     pass
         for x in self.feature:
             if getattr(self, f"disable_{x}"):
-                setattr(self.feature, x, False)
+                self.feature.set(x, False)
                 self.feature.required.discard(x)
                 _dbg("Disabling %s", x)
                 if getattr(self, f"enable_{x}"):

From 11c654c187ffbede40c54e6344ddec49f495d4a7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 16 Oct 2024 23:07:35 +1100
Subject: [PATCH 1185/2374] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 8a20fe16a92..ff126c61140 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,6 +2,12 @@
 Changelog (Pillow)
 ==================
 
+11.1.0 (unreleased)
+-------------------
+
+- Fixed disabling a feature during install #8469
+  [radarhere]
+
 11.0.0 (2024-10-15)
 -------------------
 

From c252b708ee7f90dbc3b6a86056f390b7b4712f52 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 16 Oct 2024 21:41:38 +0000
Subject: [PATCH 1186/2374] Update dependency mypy to v1.12.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 dcb3996e24e..852444d37a4 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.11.2
+mypy==1.12.0
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 5ff20273d90c1be49a9662cf6d4c53c9bd53aadb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Oct 2024 10:46:26 +1100
Subject: [PATCH 1187/2374] Updated type hints

---
 src/PIL/TiffImagePlugin.py | 40 +++++++++++++++++++++++++-------------
 1 file changed, 27 insertions(+), 13 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index ff5a6f9e91b..198bd422ef1 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -685,22 +685,33 @@ def _setitem(self, tag: int, value: Any, legacy_api: bool) -> None:
             else:
                 self.tagtype[tag] = TiffTags.UNDEFINED
                 if all(isinstance(v, IFDRational) for v in values):
-                    self.tagtype[tag] = (
-                        TiffTags.RATIONAL
-                        if all(v >= 0 for v in values)
-                        else TiffTags.SIGNED_RATIONAL
-                    )
+                    for v in values:
+                        assert isinstance(v, IFDRational)
+                        if v < 0:
+                            self.tagtype[tag] = TiffTags.SIGNED_RATIONAL
+                            break
+                    else:
+                        self.tagtype[tag] = TiffTags.RATIONAL
                 elif all(isinstance(v, int) for v in values):
-                    if all(0 <= v < 2**16 for v in values):
+                    short = True
+                    signed_short = True
+                    long = True
+                    for v in values:
+                        assert isinstance(v, int)
+                        if short and not (0 <= v < 2**16):
+                            short = False
+                        if signed_short and not (-(2**15) < v < 2**15):
+                            signed_short = False
+                        if long and v < 0:
+                            long = False
+                    if short:
                         self.tagtype[tag] = TiffTags.SHORT
-                    elif all(-(2**15) < v < 2**15 for v in values):
+                    elif signed_short:
                         self.tagtype[tag] = TiffTags.SIGNED_SHORT
+                    elif long:
+                        self.tagtype[tag] = TiffTags.LONG
                     else:
-                        self.tagtype[tag] = (
-                            TiffTags.LONG
-                            if all(v >= 0 for v in values)
-                            else TiffTags.SIGNED_LONG
-                        )
+                        self.tagtype[tag] = TiffTags.SIGNED_LONG
                 elif all(isinstance(v, float) for v in values):
                     self.tagtype[tag] = TiffTags.DOUBLE
                 elif all(isinstance(v, str) for v in values):
@@ -718,7 +729,10 @@ def _setitem(self, tag: int, value: Any, legacy_api: bool) -> None:
 
         is_ifd = self.tagtype[tag] == TiffTags.LONG and isinstance(values, dict)
         if not is_ifd:
-            values = tuple(info.cvt_enum(value) for value in values)
+            values = tuple(
+                info.cvt_enum(value) if isinstance(value, str) else value
+                for value in values
+            )
 
         dest = self._tags_v1 if legacy_api else self._tags_v2
 

From 4611a246618b1b3e09efc829e36205184376dc75 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Oct 2024 10:58:48 +1100
Subject: [PATCH 1188/2374] Fix IFDRational with a zero denominator

---
 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 198bd422ef1..6bf39b75a5f 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -294,7 +294,7 @@ def _accept(prefix: bytes) -> bool:
 def _limit_rational(
     val: float | Fraction | IFDRational, max_val: int
 ) -> tuple[IntegralLike, IntegralLike]:
-    inv = abs(float(val)) > 1
+    inv = abs(val) > 1
     n_d = IFDRational(1 / val if inv else val).limit_rational(max_val)
     return n_d[::-1] if inv else n_d
 

From 0beb2228f9adb387a87c6b944cda2e427f5f264a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Oct 2024 12:44:25 +1100
Subject: [PATCH 1189/2374] Include JpegImageFile layers in state

---
 Tests/test_pickle.py       | 11 +++++++++++
 src/PIL/Image.py           |  2 +-
 src/PIL/JpegImagePlugin.py |  7 +++++++
 3 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index d250ba36965..c4f8de013ec 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -74,6 +74,17 @@ def test_pickle_image(
     helper_pickle_file(tmp_path, protocol, test_file, test_mode)
 
 
+def test_pickle_jpeg() -> None:
+    # Arrange
+    with Image.open("Tests/images/hopper.jpg") as image:
+        # Act: roundtrip
+        unpickled_image = pickle.loads(pickle.dumps(image))
+
+    # Assert
+    assert len(unpickled_image.layer) == 3
+    assert unpickled_image.layers == 3
+
+
 def test_pickle_la_mode_with_palette(tmp_path: Path) -> None:
     # Arrange
     filename = str(tmp_path / "temp.pkl")
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 44270392c4d..ec5ce6cb1ee 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -763,7 +763,7 @@ def __getstate__(self) -> list[Any]:
 
     def __setstate__(self, state: list[Any]) -> None:
         Image.__init__(self)
-        info, mode, size, palette, data = state
+        info, mode, size, palette, data = state[:5]
         self.info = info
         self._mode = mode
         self._size = size
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 6510e072e5e..7dec7521809 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -395,6 +395,13 @@ def __getattr__(self, name: str) -> Any:
             return getattr(self, "_" + name)
         raise AttributeError(name)
 
+    def __getstate__(self) -> list[Any]:
+        return super().__getstate__() + [self.layers, self.layer]
+
+    def __setstate__(self, state: list[Any]) -> None:
+        super().__setstate__(state)
+        self.layers, self.layer = state[5:]
+
     def load_read(self, read_bytes: int) -> bytes:
         """
         internal: read more image data

From d59b169ed257ca14d86c90dbf3384b8b3999fc5c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Oct 2024 23:10:48 +1100
Subject: [PATCH 1190/2374] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index ff126c61140..ae384156963 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.1.0 (unreleased)
 -------------------
 
+- Fix IFDRational with a zero denominator #8474
+  [radarhere]
+
 - Fixed disabling a feature during install #8469
   [radarhere]
 

From a337138f92d88d56488e5150d7ce8a3e0f0a91f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 18 Oct 2024 08:32:14 +1100
Subject: [PATCH 1191/2374] Updated type hint

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

diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 8548fb5da3b..57fcf9a3463 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -10,7 +10,7 @@
 
 import pytest
 
-from PIL import Image
+from PIL import Image, ImageFile
 
 from .helper import (
     assert_image_equal,
@@ -179,7 +179,7 @@ def test_cross_platform(self, tmp_path: Path) -> None:
 
 
 @pytest.fixture
-def gradients_image() -> Generator[Image.Image, None, None]:
+def gradients_image() -> Generator[ImageFile.ImageFile, None, None]:
     with Image.open("Tests/images/radial_gradients.png") as im:
         im.load()
     try:
@@ -189,7 +189,7 @@ def gradients_image() -> Generator[Image.Image, None, None]:
 
 
 class TestReducingGapResize:
-    def test_reducing_gap_values(self, gradients_image: Image.Image) -> None:
+    def test_reducing_gap_values(self, gradients_image: ImageFile.ImageFile) -> None:
         ref = gradients_image.resize(
             (52, 34), Image.Resampling.BICUBIC, reducing_gap=None
         )
@@ -210,7 +210,7 @@ def test_reducing_gap_values(self, gradients_image: Image.Image) -> None:
     )
     def test_reducing_gap_1(
         self,
-        gradients_image: Image.Image,
+        gradients_image: ImageFile.ImageFile,
         box: tuple[float, float, float, float],
         epsilon: float,
     ) -> None:
@@ -230,7 +230,7 @@ def test_reducing_gap_1(
     )
     def test_reducing_gap_2(
         self,
-        gradients_image: Image.Image,
+        gradients_image: ImageFile.ImageFile,
         box: tuple[float, float, float, float],
         epsilon: float,
     ) -> None:
@@ -250,7 +250,7 @@ def test_reducing_gap_2(
     )
     def test_reducing_gap_3(
         self,
-        gradients_image: Image.Image,
+        gradients_image: ImageFile.ImageFile,
         box: tuple[float, float, float, float],
         epsilon: float,
     ) -> None:
@@ -266,7 +266,9 @@ def test_reducing_gap_3(
 
     @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: Image.Image, box: tuple[float, float, float, float]
+        self,
+        gradients_image: ImageFile.ImageFile,
+        box: tuple[float, float, float, float],
     ) -> None:
         ref = gradients_image.resize((52, 34), Image.Resampling.BICUBIC, box=box)
         im = gradients_image.resize(
@@ -281,7 +283,7 @@ def test_reducing_gap_8(
     )
     def test_box_filter(
         self,
-        gradients_image: Image.Image,
+        gradients_image: ImageFile.ImageFile,
         box: tuple[float, float, float, float],
         epsilon: float,
     ) -> None:

From 98f975dbbe6ae0ef521522cdea6e00fdc81449c0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 18 Oct 2024 18:56:23 +1100
Subject: [PATCH 1192/2374] Do not save XMP from info

---
 Tests/test_file_jpeg.py    | 9 +++++++--
 src/PIL/JpegImagePlugin.py | 2 +-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index cde951395a7..1b889eb40f4 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -998,8 +998,13 @@ def test_save_xmp(self, tmp_path: Path) -> None:
         with Image.open(f) as reloaded:
             assert reloaded.info["xmp"] == b"XMP test"
 
-        im.info["xmp"] = b"1" * 65504
-        im.save(f)
+            # Check that XMP is not saved from image info
+            reloaded.save(f)
+
+        with Image.open(f) as reloaded:
+            assert "xmp" not in reloaded.info
+
+        im.save(f, xmp=b"1" * 65504)
         with Image.open(f) as reloaded:
             assert reloaded.info["xmp"] == b"1" * 65504
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 6510e072e5e..6937f2650d6 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -751,7 +751,7 @@ def validate_qtables(
     extra = info.get("extra", b"")
 
     MAX_BYTES_IN_MARKER = 65533
-    xmp = info.get("xmp", im.info.get("xmp"))
+    xmp = 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 203ca12626b22d185b59199b60ceb55081f6c3b2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 18 Oct 2024 19:09:22 +1100
Subject: [PATCH 1193/2374] Allow encoderinfo to be set for appended images

---
 Tests/test_file_mpo.py | 12 ++++++++++++
 src/PIL/Image.py       |  7 ++++++-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index e0f42a26649..39aaa1613ce 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -293,3 +293,15 @@ def test_save_all() -> None:
     # Test that a single frame image will not be saved as an MPO
     jpg = roundtrip(im, save_all=True)
     assert "mp" not in jpg.info
+
+
+def test_save_xmp() -> None:
+    im = Image.new("RGB", (1, 1))
+    im2 = Image.new("RGB", (1, 1), "#f00")
+    im2.encoderinfo = {"xmp": b"Second frame"}
+    im_reloaded = roundtrip(im, xmp=b"First frame", save_all=True, append_images=[im2])
+
+    assert im_reloaded.info["xmp"] == b"First frame"
+
+    im_reloaded.seek(1)
+    assert im_reloaded.info["xmp"] == b"Second frame"
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 44270392c4d..586da7d3dba 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2565,7 +2565,7 @@ def save(
         self._ensure_mutable()
 
         save_all = params.pop("save_all", False)
-        self.encoderinfo = params
+        self.encoderinfo = {**getattr(self, "encoderinfo", {}), **params}
         self.encoderconfig: tuple[Any, ...] = ()
 
         preinit()
@@ -2612,6 +2612,11 @@ def save(
                 except PermissionError:
                     pass
             raise
+        finally:
+            try:
+                del self.encoderinfo
+            except AttributeError:
+                pass
         if open_fp:
             fp.close()
 

From 5b065970753d464c0d283f9e0c2f4a0971800ed1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 18 Oct 2024 19:29:22 +1100
Subject: [PATCH 1194/2374] Use fixture to re-open image for each test

---
 Tests/test_file_jpeg2k.py | 57 +++++++++++++++++++++++++--------------
 1 file changed, 37 insertions(+), 20 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 26b085601b6..79f53e21195 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -2,6 +2,7 @@
 
 import os
 import re
+from collections.abc import Generator
 from io import BytesIO
 from pathlib import Path
 from typing import Any
@@ -29,8 +30,16 @@
 
 pytestmark = skip_unless_feature("jpg_2000")
 
-test_card = Image.open("Tests/images/test-card.png")
-test_card.load()
+
+@pytest.fixture
+def test_card() -> Generator[ImageFile.ImageFile, None, None]:
+    with Image.open("Tests/images/test-card.png") as im:
+        im.load()
+    try:
+        yield im
+    finally:
+        im.close()
+
 
 # OpenJPEG 2.0.0 outputs this debugging message sometimes; we should
 # ignore it---it doesn't represent a test failure.
@@ -74,7 +83,7 @@ def test_invalid_file() -> None:
         Jpeg2KImagePlugin.Jpeg2KImageFile(invalid_file)
 
 
-def test_bytesio() -> None:
+def test_bytesio(test_card: ImageFile.ImageFile) -> None:
     with open("Tests/images/test-card-lossless.jp2", "rb") as f:
         data = BytesIO(f.read())
     with Image.open(data) as im:
@@ -86,7 +95,7 @@ def test_bytesio() -> None:
 # PIL (they were made using Adobe Photoshop)
 
 
-def test_lossless(tmp_path: Path) -> None:
+def test_lossless(test_card: ImageFile.ImageFile, 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")
@@ -94,54 +103,56 @@ def test_lossless(tmp_path: Path) -> None:
     assert_image_similar(im, test_card, 1.0e-3)
 
 
-def test_lossy_tiled() -> None:
+def test_lossy_tiled(test_card: ImageFile.ImageFile) -> None:
     assert_image_similar_tofile(
         test_card, "Tests/images/test-card-lossy-tiled.jp2", 2.0
     )
 
 
-def test_lossless_rt() -> None:
+def test_lossless_rt(test_card: ImageFile.ImageFile) -> None:
     im = roundtrip(test_card)
     assert_image_equal(im, test_card)
 
 
-def test_lossy_rt() -> None:
+def test_lossy_rt(test_card: ImageFile.ImageFile) -> None:
     im = roundtrip(test_card, quality_layers=[20])
     assert_image_similar(im, test_card, 2.0)
 
 
-def test_tiled_rt() -> None:
+def test_tiled_rt(test_card: ImageFile.ImageFile) -> None:
     im = roundtrip(test_card, tile_size=(128, 128))
     assert_image_equal(im, test_card)
 
 
-def test_tiled_offset_rt() -> None:
+def test_tiled_offset_rt(test_card: ImageFile.ImageFile) -> 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() -> None:
+def test_tiled_offset_too_small(test_card: ImageFile.ImageFile) -> None:
     with pytest.raises(ValueError):
         roundtrip(test_card, tile_size=(128, 128), tile_offset=(0, 0), offset=(128, 32))
 
 
-def test_irreversible_rt() -> None:
+def test_irreversible_rt(test_card: ImageFile.ImageFile) -> None:
     im = roundtrip(test_card, irreversible=True, quality_layers=[20])
     assert_image_similar(im, test_card, 2.0)
 
 
-def test_prog_qual_rt() -> None:
+def test_prog_qual_rt(test_card: ImageFile.ImageFile) -> 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() -> None:
+def test_prog_res_rt(test_card: ImageFile.ImageFile) -> 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: int) -> None:
+def test_default_num_resolutions(
+    test_card: ImageFile.ImageFile, num_resolutions: int
+) -> None:
     d = 1 << (num_resolutions - 1)
     im = test_card.resize((d - 1, d - 1))
     with pytest.raises(OSError):
@@ -205,7 +216,7 @@ def test_header_errors() -> None:
             pass
 
 
-def test_layers_type(tmp_path: Path) -> None:
+def test_layers_type(test_card: ImageFile.ImageFile, 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)
@@ -215,7 +226,7 @@ def test_layers_type(tmp_path: Path) -> None:
             test_card.save(outfile, quality_layers=quality_layers_str)
 
 
-def test_layers() -> None:
+def test_layers(test_card: ImageFile.ImageFile) -> None:
     out = BytesIO()
     test_card.save(out, "JPEG2000", quality_layers=[100, 50, 10], progression="LRCP")
     out.seek(0)
@@ -245,7 +256,13 @@ def test_layers() -> None:
         (None, {"no_jp2": False}, 4, b"jP"),
     ),
 )
-def test_no_jp2(name: str, args: dict[str, bool], offset: int, data: bytes) -> None:
+def test_no_jp2(
+    test_card: ImageFile.ImageFile,
+    name: str,
+    args: dict[str, bool],
+    offset: int,
+    data: bytes,
+) -> None:
     out = BytesIO()
     if name:
         out.name = name
@@ -254,7 +271,7 @@ def test_no_jp2(name: str, args: dict[str, bool], offset: int, data: bytes) -> N
     assert out.read(2) == data
 
 
-def test_mct() -> None:
+def test_mct(test_card: ImageFile.ImageFile) -> None:
     # Three component
     for val in (0, 1):
         out = BytesIO()
@@ -419,7 +436,7 @@ def test_comment() -> None:
             pass
 
 
-def test_save_comment() -> None:
+def test_save_comment(test_card: ImageFile.ImageFile) -> None:
     for comment in ("Created by Pillow", b"Created by Pillow"):
         out = BytesIO()
         test_card.save(out, "JPEG2000", comment=comment)
@@ -457,7 +474,7 @@ def test_crashes(test_file: str) -> None:
 
 
 @skip_unless_feature_version("jpg_2000", "2.4.0")
-def test_plt_marker() -> None:
+def test_plt_marker(test_card: ImageFile.ImageFile) -> None:
     # Search the start of the codesteam for PLT
     out = BytesIO()
     test_card.save(out, "JPEG2000", no_jp2=True, plt=True)

From 55579084cd57461517dfe77d7804dfa24219a9f6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 19 Oct 2024 20:40:13 +1100
Subject: [PATCH 1195/2374] Corrected EMF DPI

---
 Tests/test_file_wmf.py    | 7 +++++++
 src/PIL/WmfImagePlugin.py | 2 +-
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 79e707263d6..424640d7b18 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from io import BytesIO
 from pathlib import Path
 from typing import IO
 
@@ -61,6 +62,12 @@ def test_load_float_dpi() -> None:
     with Image.open("Tests/images/drawing.emf") as im:
         assert im.info["dpi"] == 1423.7668161434979
 
+    with open("Tests/images/drawing.emf", "rb") as fp:
+        data = fp.read()
+    b = BytesIO(data[:8] + b"\x06\xFA" + data[10:])
+    with Image.open(b) as im:
+        assert im.info["dpi"][0] == 2540
+
 
 def test_load_set_dpi() -> None:
     with Image.open("Tests/images/drawing.wmf") as im:
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 68f8a74f599..cad6c98d53f 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -128,7 +128,7 @@ def _open(self) -> None:
             size = x1 - x0, y1 - y0
 
             # calculate dots per inch from bbox and frame
-            xdpi = 2540.0 * (x1 - y0) / (frame[2] - frame[0])
+            xdpi = 2540.0 * (x1 - x0) / (frame[2] - frame[0])
             ydpi = 2540.0 * (y1 - y0) / (frame[3] - frame[1])
 
             self.info["wmf_bbox"] = x0, y0, x1, y1

From beb32bbb1f9bb713a840421e3e9f5191d5f51944 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 21 Oct 2024 00:18:00 +0000
Subject: [PATCH 1196/2374] Update dependency mypy to v1.12.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 852444d37a4..047307bb585 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.12.0
+mypy==1.12.1
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 22c05e232c67343b193b9fdeca9e7b683d470bc6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 22 Oct 2024 17:56:02 +1100
Subject: [PATCH 1197/2374] Update license to MIT-CMU

---
 LICENSE        | 2 +-
 docs/about.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/LICENSE b/LICENSE
index 7990a6e57dc..8837c290c30 100644
--- a/LICENSE
+++ b/LICENSE
@@ -7,7 +7,7 @@ Pillow is the friendly PIL fork. It is
 
     Copyright © 2010-2024 by Jeffrey A. Clark and contributors
 
-Like PIL, Pillow is licensed under the open source HPND License:
+Like PIL, Pillow is licensed under the open source MIT-CMU License:
 
 By obtaining, using, and/or copying this software and/or its associated
 documentation, you agree that you have read, understood, and will comply
diff --git a/docs/about.rst b/docs/about.rst
index 98cdd8e5ab0..c51ddebd081 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -18,7 +18,7 @@ The fork author's goal is to foster and support active development of PIL throug
 License
 -------
 
-Like PIL, Pillow is `licensed under the open source HPND License <https://raw.githubusercontent.com/python-pillow/Pillow/main/LICENSE>`_
+Like PIL, Pillow is `licensed under the open source MIT-CMU License <https://raw.githubusercontent.com/python-pillow/Pillow/main/LICENSE>`_
 
 Why a fork?
 -----------

From 6a55f2df0346e3d97515ee46e4dbb966886fdc94 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 23 Oct 2024 02:36:15 +0000
Subject: [PATCH 1198/2374] Update dependency mypy to v1.13.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 047307bb585..c84a3533b85 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.12.1
+mypy==1.13.0
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 8af2d7640ead3ddeba9fdc598dc8e72d580dfdfb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 24 Oct 2024 23:26:13 +1100
Subject: [PATCH 1199/2374] Pass palette mode to putpalette

---
 Tests/test_file_gif.py    | 6 ++++--
 src/PIL/GifImagePlugin.py | 5 +++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 16c8466f331..4eb8c0d02a7 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -4,6 +4,7 @@
 from collections.abc import Generator
 from io import BytesIO
 from pathlib import Path
+from typing import Any
 
 import pytest
 
@@ -1431,7 +1432,8 @@ def test_saving_rgba(tmp_path: Path) -> None:
         assert reloaded_rgba.load()[0, 0][3] == 0
 
 
-def test_optimizing_p_rgba(tmp_path: Path) -> None:
+@pytest.mark.parametrize("params", ({}, {"disposal": 2, "optimize": False}))
+def test_p_rgba(tmp_path: Path, params: dict[str, Any]) -> None:
     out = str(tmp_path / "temp.gif")
 
     im1 = Image.new("P", (100, 100))
@@ -1443,7 +1445,7 @@ def test_optimizing_p_rgba(tmp_path: Path) -> None:
     im2 = Image.new("P", (100, 100))
     im2.putpalette(data, "RGBA")
 
-    im1.save(out, save_all=True, append_images=[im2])
+    im1.save(out, save_all=True, append_images=[im2], **params)
 
     with Image.open(out) as reloaded:
         assert reloaded.n_frames == 2
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index a7c4f8b2c57..47022d58436 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -695,8 +695,9 @@ 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)
+                        first_palette = im_frames[0].im.palette
+                        assert first_palette is not None
+                        background_im.putpalette(first_palette, first_palette.mode)
                     bbox = _getbbox(background_im, im_frame)[1]
                 elif encoderinfo.get("optimize") and im_frame.mode != "1":
                     if "transparency" not in encoderinfo:

From c8e301c47456114f245261fccd316b4fd8964f3e Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Thu, 24 Oct 2024 15:52:59 +0200
Subject: [PATCH 1200/2374] Fix SEGFAULT from calling FT_New_Face/FT_Done_Face
 in multiple threads

---
 src/_imagingft.c                   |  12 +-
 src/thirdparty/pythoncapi_compat.h | 341 ++++++++++++++++++++++++++++-
 2 files changed, 351 insertions(+), 2 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 7f246412455..6fed821bc0c 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -81,7 +81,10 @@ struct {
     /* -------------------------------------------------------------------- */
     /* font objects */
 
-    static FT_Library library;
+static FT_Library library;
+#ifdef Py_GIL_DISABLED
+PyMutex ft_library_mutex;
+#endif
 
 typedef struct {
     PyObject_HEAD FT_Face face;
@@ -187,7 +190,9 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
 
     if (filename && font_bytes_size <= 0) {
         self->font_bytes = NULL;
+        MUTEX_LOCK(&ft_library_mutex);
         error = FT_New_Face(library, filename, index, &self->face);
+        MUTEX_UNLOCK(&ft_library_mutex);
     } else {
         /* need to have allocated storage for font_bytes for the life of the object.*/
         /* Don't free this before FT_Done_Face */
@@ -197,6 +202,7 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
         }
         if (!error) {
             memcpy(self->font_bytes, font_bytes, (size_t)font_bytes_size);
+            MUTEX_LOCK(&ft_library_mutex);
             error = FT_New_Memory_Face(
                 library,
                 (FT_Byte *)self->font_bytes,
@@ -204,6 +210,7 @@ getfont(PyObject *self_, PyObject *args, PyObject *kw) {
                 index,
                 &self->face
             );
+            MUTEX_UNLOCK(&ft_library_mutex);
         }
     }
 
@@ -1433,7 +1440,9 @@ font_setvaraxes(FontObject *self, PyObject *args) {
 static void
 font_dealloc(FontObject *self) {
     if (self->face) {
+        MUTEX_LOCK(&ft_library_mutex);
         FT_Done_Face(self->face);
+        MUTEX_UNLOCK(&ft_library_mutex);
     }
     if (self->font_bytes) {
         PyMem_Free(self->font_bytes);
@@ -1639,6 +1648,7 @@ PyInit__imagingft(void) {
     }
 
 #ifdef Py_GIL_DISABLED
+    ft_library_mutex = (PyMutex) {0};
     PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
 #endif
 
diff --git a/src/thirdparty/pythoncapi_compat.h b/src/thirdparty/pythoncapi_compat.h
index 51e8c0de752..ca23d5ffa9a 100644
--- a/src/thirdparty/pythoncapi_compat.h
+++ b/src/thirdparty/pythoncapi_compat.h
@@ -7,7 +7,10 @@
 // https://github.com/python/pythoncapi_compat
 //
 // Latest version:
-// https://raw.githubusercontent.com/python/pythoncapi_compat/master/pythoncapi_compat.h
+// https://raw.githubusercontent.com/python/pythoncapi-compat/main/pythoncapi_compat.h
+//
+// This file was vendored from the following commit:
+// https://github.com/python/pythoncapi-compat/commit/0041177c4f348c8952b4c8980b2c90856e61c7c7
 //
 // SPDX-License-Identifier: 0BSD
 
@@ -45,6 +48,13 @@ extern "C" {
 #  define _PyObject_CAST(op) _Py_CAST(PyObject*, op)
 #endif
 
+#ifndef Py_BUILD_ASSERT
+#  define Py_BUILD_ASSERT(cond) \
+        do { \
+            (void)sizeof(char [1 - 2 * !(cond)]); \
+        } while(0)
+#endif
+
 
 // bpo-42262 added Py_NewRef() to Python 3.10.0a3
 #if PY_VERSION_HEX < 0x030A00A3 && !defined(Py_NewRef)
@@ -1338,6 +1348,166 @@ PyDict_SetDefaultRef(PyObject *d, PyObject *key, PyObject *default_value,
 }
 #endif
 
+#if PY_VERSION_HEX < 0x030D00B3
+#  define Py_BEGIN_CRITICAL_SECTION(op) {
+#  define Py_END_CRITICAL_SECTION() }
+#  define Py_BEGIN_CRITICAL_SECTION2(a, b) {
+#  define Py_END_CRITICAL_SECTION2() }
+#endif
+
+#if PY_VERSION_HEX < 0x030E0000 && PY_VERSION_HEX >= 0x03060000 && !defined(PYPY_VERSION)
+typedef struct PyUnicodeWriter PyUnicodeWriter;
+
+static inline void PyUnicodeWriter_Discard(PyUnicodeWriter *writer)
+{
+    _PyUnicodeWriter_Dealloc((_PyUnicodeWriter*)writer);
+    PyMem_Free(writer);
+}
+
+static inline PyUnicodeWriter* PyUnicodeWriter_Create(Py_ssize_t length)
+{
+    if (length < 0) {
+        PyErr_SetString(PyExc_ValueError,
+                        "length must be positive");
+        return NULL;
+    }
+
+    const size_t size = sizeof(_PyUnicodeWriter);
+    PyUnicodeWriter *pub_writer = (PyUnicodeWriter *)PyMem_Malloc(size);
+    if (pub_writer == _Py_NULL) {
+        PyErr_NoMemory();
+        return _Py_NULL;
+    }
+    _PyUnicodeWriter *writer = (_PyUnicodeWriter *)pub_writer;
+
+    _PyUnicodeWriter_Init(writer);
+    if (_PyUnicodeWriter_Prepare(writer, length, 127) < 0) {
+        PyUnicodeWriter_Discard(pub_writer);
+        return NULL;
+    }
+    writer->overallocate = 1;
+    return pub_writer;
+}
+
+static inline PyObject* PyUnicodeWriter_Finish(PyUnicodeWriter *writer)
+{
+    PyObject *str = _PyUnicodeWriter_Finish((_PyUnicodeWriter*)writer);
+    assert(((_PyUnicodeWriter*)writer)->buffer == NULL);
+    PyMem_Free(writer);
+    return str;
+}
+
+static inline int
+PyUnicodeWriter_WriteChar(PyUnicodeWriter *writer, Py_UCS4 ch)
+{
+    if (ch > 0x10ffff) {
+        PyErr_SetString(PyExc_ValueError,
+                        "character must be in range(0x110000)");
+        return -1;
+    }
+
+    return _PyUnicodeWriter_WriteChar((_PyUnicodeWriter*)writer, ch);
+}
+
+static inline int
+PyUnicodeWriter_WriteStr(PyUnicodeWriter *writer, PyObject *obj)
+{
+    PyObject *str = PyObject_Str(obj);
+    if (str == NULL) {
+        return -1;
+    }
+
+    int res = _PyUnicodeWriter_WriteStr((_PyUnicodeWriter*)writer, str);
+    Py_DECREF(str);
+    return res;
+}
+
+static inline int
+PyUnicodeWriter_WriteRepr(PyUnicodeWriter *writer, PyObject *obj)
+{
+    PyObject *str = PyObject_Repr(obj);
+    if (str == NULL) {
+        return -1;
+    }
+
+    int res = _PyUnicodeWriter_WriteStr((_PyUnicodeWriter*)writer, str);
+    Py_DECREF(str);
+    return res;
+}
+
+static inline int
+PyUnicodeWriter_WriteUTF8(PyUnicodeWriter *writer,
+                          const char *str, Py_ssize_t size)
+{
+    if (size < 0) {
+        size = (Py_ssize_t)strlen(str);
+    }
+
+    PyObject *str_obj = PyUnicode_FromStringAndSize(str, size);
+    if (str_obj == _Py_NULL) {
+        return -1;
+    }
+
+    int res = _PyUnicodeWriter_WriteStr((_PyUnicodeWriter*)writer, str_obj);
+    Py_DECREF(str_obj);
+    return res;
+}
+
+static inline int
+PyUnicodeWriter_WriteWideChar(PyUnicodeWriter *writer,
+                              const wchar_t *str, Py_ssize_t size)
+{
+    if (size < 0) {
+        size = (Py_ssize_t)wcslen(str);
+    }
+
+    PyObject *str_obj = PyUnicode_FromWideChar(str, size);
+    if (str_obj == _Py_NULL) {
+        return -1;
+    }
+
+    int res = _PyUnicodeWriter_WriteStr((_PyUnicodeWriter*)writer, str_obj);
+    Py_DECREF(str_obj);
+    return res;
+}
+
+static inline int
+PyUnicodeWriter_WriteSubstring(PyUnicodeWriter *writer, PyObject *str,
+                               Py_ssize_t start, Py_ssize_t end)
+{
+    if (!PyUnicode_Check(str)) {
+        PyErr_Format(PyExc_TypeError, "expect str, not %T", str);
+        return -1;
+    }
+    if (start < 0 || start > end) {
+        PyErr_Format(PyExc_ValueError, "invalid start argument");
+        return -1;
+    }
+    if (end > PyUnicode_GET_LENGTH(str)) {
+        PyErr_Format(PyExc_ValueError, "invalid end argument");
+        return -1;
+    }
+
+    return _PyUnicodeWriter_WriteSubstring((_PyUnicodeWriter*)writer, str,
+                                           start, end);
+}
+
+static inline int
+PyUnicodeWriter_Format(PyUnicodeWriter *writer, const char *format, ...)
+{
+    va_list vargs;
+    va_start(vargs, format);
+    PyObject *str = PyUnicode_FromFormatV(format, vargs);
+    va_end(vargs);
+    if (str == _Py_NULL) {
+        return -1;
+    }
+
+    int res = _PyUnicodeWriter_WriteStr((_PyUnicodeWriter*)writer, str);
+    Py_DECREF(str);
+    return res;
+}
+#endif  // PY_VERSION_HEX < 0x030E0000
 
 // gh-116560 added PyLong_GetSign() to Python 3.14.0a0
 #if PY_VERSION_HEX < 0x030E00A0
@@ -1354,6 +1524,175 @@ static inline int PyLong_GetSign(PyObject *obj, int *sign)
 #endif
 
 
+// gh-124502 added PyUnicode_Equal() to Python 3.14.0a0
+#if PY_VERSION_HEX < 0x030E00A0
+static inline int PyUnicode_Equal(PyObject *str1, PyObject *str2)
+{
+    if (!PyUnicode_Check(str1)) {
+        PyErr_Format(PyExc_TypeError, "first argument must be str, not %s",
+                     Py_TYPE(str1)->tp_name);
+        return -1;
+    }
+    if (!PyUnicode_Check(str2)) {
+        PyErr_Format(PyExc_TypeError, "second argument must be str, not %s",
+                     Py_TYPE(str2)->tp_name);
+        return -1;
+    }
+
+#if PY_VERSION_HEX >= 0x030d0000 && !defined(PYPY_VERSION)
+    PyAPI_FUNC(int) _PyUnicode_Equal(PyObject *str1, PyObject *str2);
+
+    return _PyUnicode_Equal(str1, str2);
+#elif PY_VERSION_HEX >= 0x03060000 && !defined(PYPY_VERSION)
+    return _PyUnicode_EQ(str1, str2);
+#elif PY_VERSION_HEX >= 0x03090000 && defined(PYPY_VERSION)
+    return _PyUnicode_EQ(str1, str2);
+#else
+    return (PyUnicode_Compare(str1, str2) == 0);
+#endif
+}
+#endif
+
+
+// gh-121645 added PyBytes_Join() to Python 3.14.0a0
+#if PY_VERSION_HEX < 0x030E00A0
+static inline PyObject* PyBytes_Join(PyObject *sep, PyObject *iterable)
+{
+    return _PyBytes_Join(sep, iterable);
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030E00A0
+static inline Py_hash_t Py_HashBuffer(const void *ptr, Py_ssize_t len)
+{
+#if PY_VERSION_HEX >= 0x03000000 && !defined(PYPY_VERSION)
+    PyAPI_FUNC(Py_hash_t) _Py_HashBytes(const void *src, Py_ssize_t len);
+
+    return _Py_HashBytes(ptr, len);
+#else
+    Py_hash_t hash;
+    PyObject *bytes = PyBytes_FromStringAndSize((const char*)ptr, len);
+    if (bytes == NULL) {
+        return -1;
+    }
+    hash = PyObject_Hash(bytes);
+    Py_DECREF(bytes);
+    return hash;
+#endif
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030E00A0
+static inline int PyIter_NextItem(PyObject *iter, PyObject **item)
+{
+    iternextfunc tp_iternext;
+
+    assert(iter != NULL);
+    assert(item != NULL);
+
+    tp_iternext = Py_TYPE(iter)->tp_iternext;
+    if (tp_iternext == NULL) {
+        *item = NULL;
+        PyErr_Format(PyExc_TypeError, "expected an iterator, got '%s'",
+                     Py_TYPE(iter)->tp_name);
+        return -1;
+    }
+
+    if ((*item = tp_iternext(iter))) {
+        return 1;
+    }
+    if (!PyErr_Occurred()) {
+        return 0;
+    }
+    if (PyErr_ExceptionMatches(PyExc_StopIteration)) {
+        PyErr_Clear();
+        return 0;
+    }
+    return -1;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030E00A0
+static inline PyObject* PyLong_FromInt32(int32_t value)
+{
+    Py_BUILD_ASSERT(sizeof(long) >= 4);
+    return PyLong_FromLong(value);
+}
+
+static inline PyObject* PyLong_FromInt64(int64_t value)
+{
+    Py_BUILD_ASSERT(sizeof(long long) >= 8);
+    return PyLong_FromLongLong(value);
+}
+
+static inline PyObject* PyLong_FromUInt32(uint32_t value)
+{
+    Py_BUILD_ASSERT(sizeof(unsigned long) >= 4);
+    return PyLong_FromUnsignedLong(value);
+}
+
+static inline PyObject* PyLong_FromUInt64(uint64_t value)
+{
+    Py_BUILD_ASSERT(sizeof(unsigned long long) >= 8);
+    return PyLong_FromUnsignedLongLong(value);
+}
+
+static inline int PyLong_AsInt32(PyObject *obj, int32_t *pvalue)
+{
+    Py_BUILD_ASSERT(sizeof(int) == 4);
+    int value = PyLong_AsInt(obj);
+    if (value == -1 && PyErr_Occurred()) {
+        return -1;
+    }
+    *pvalue = (int32_t)value;
+    return 0;
+}
+
+static inline int PyLong_AsInt64(PyObject *obj, int64_t *pvalue)
+{
+    Py_BUILD_ASSERT(sizeof(long long) == 8);
+    long long value = PyLong_AsLongLong(obj);
+    if (value == -1 && PyErr_Occurred()) {
+        return -1;
+    }
+    *pvalue = (int64_t)value;
+    return 0;
+}
+
+static inline int PyLong_AsUInt32(PyObject *obj, uint32_t *pvalue)
+{
+    Py_BUILD_ASSERT(sizeof(long) >= 4);
+    unsigned long value = PyLong_AsUnsignedLong(obj);
+    if (value == (unsigned long)-1 && PyErr_Occurred()) {
+        return -1;
+    }
+#if SIZEOF_LONG > 4
+    if ((unsigned long)UINT32_MAX < value) {
+        PyErr_SetString(PyExc_OverflowError,
+                        "Python int too large to convert to C uint32_t");
+        return -1;
+    }
+#endif
+    *pvalue = (uint32_t)value;
+    return 0;
+}
+
+static inline int PyLong_AsUInt64(PyObject *obj, uint64_t *pvalue)
+{
+    Py_BUILD_ASSERT(sizeof(long long) == 8);
+    unsigned long long value = PyLong_AsUnsignedLongLong(obj);
+    if (value == (unsigned long long)-1 && PyErr_Occurred()) {
+        return -1;
+    }
+    *pvalue = (uint64_t)value;
+    return 0;
+}
+#endif
+
+
 #ifdef __cplusplus
 }
 #endif

From 7999da38a7ff5aa359aa6ae3a7f88b835c7f7f06 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 24 Oct 2024 14:07:43 +0000
Subject: [PATCH 1201/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/_imagingft.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 6fed821bc0c..884b8f96c2e 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -81,7 +81,7 @@ struct {
     /* -------------------------------------------------------------------- */
     /* font objects */
 
-static FT_Library library;
+    static FT_Library library;
 #ifdef Py_GIL_DISABLED
 PyMutex ft_library_mutex;
 #endif
@@ -1648,7 +1648,7 @@ PyInit__imagingft(void) {
     }
 
 #ifdef Py_GIL_DISABLED
-    ft_library_mutex = (PyMutex) {0};
+    ft_library_mutex = (PyMutex){0};
     PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
 #endif
 

From 0fe55d611505fefaaa0d4b7b3a87b803714762de Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 09:23:13 +0800
Subject: [PATCH 1202/2374] Isolate macOS build from Homebrew.

---
 .github/workflows/wheels-dependencies.sh | 98 +++++++++++++++++-------
 .github/workflows/wheels-test.sh         | 15 ++--
 .gitignore                               |  1 +
 pyproject.toml                           |  7 ++
 setup.py                                 | 90 +++++++++++++---------
 wheels/multibuild                        |  2 +-
 6 files changed, 139 insertions(+), 74 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 97c1adf098a..35b04c6d652 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -23,6 +23,8 @@ OPENJPEG_VERSION=2.5.2
 XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
+RAQM_VERSION=0.7.1
+FRIBIDI_VERSION=1.0.16
 if [[ -n "$IS_MACOS" ]]; then
     GIFLIB_VERSION=5.2.2
 else
@@ -38,7 +40,23 @@ BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
 
+function build_pkg_config {
+    if [ -e pkg-config-stamp ]; then return; fi
+    # This essentially duplicates the Homebrew recipe:
+    # https://github.com/Homebrew/homebrew-core/blob/master/Formula/p/pkg-config.rb
+    ORIGINAL_CFLAGS=$CFLAGS
+    CFLAGS="$CFLAGS -Wno-int-conversion"
+    build_simple pkg-config 0.29.2 https://pkg-config.freedesktop.org/releases tar.gz \
+        --disable-debug --disable-host-tool --with-internal-glib \
+        --with-pc-path=$BUILD_PREFIX/share/pkgconfig:$BUILD_PREFIX/lib/pkgconfig \
+        --with-system-include-path=$(xcrun --show-sdk-path --sdk macosx)/usr/include
+    CFLAGS=$ORIGINAL_CFLAGS
+    export PKG_CONFIG=$BUILD_PREFIX/bin/pkg-config
+    touch pkg-config-stamp
+}
+
 function build_brotli {
+    if [ -e brotli-stamp ]; then return; fi
     local cmake=$(get_modern_cmake)
     local out_dir=$(fetch_unpack https://github.com/google/brotli/archive/v$BROTLI_VERSION.tar.gz brotli-$BROTLI_VERSION.tar.gz)
     (cd $out_dir \
@@ -48,25 +66,25 @@ function build_brotli {
         cp /usr/local/lib64/libbrotli* /usr/local/lib
         cp /usr/local/lib64/pkgconfig/libbrotli* /usr/local/lib/pkgconfig
     fi
+    touch brotli-stamp
 }
 
 function build_harfbuzz {
-    python3 -m pip install meson ninja
+    if [ -e harfbuzz-stamp ]; then return; fi
+    python -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)
+        && meson setup build --prefix=$BUILD_PREFIX --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
+    touch harfbuzz-stamp
 }
 
 function build {
-    if [[ -n "$IS_MACOS" ]] && [[ "$CIBW_ARCHS" == "arm64" ]]; then
-        sudo chown -R runner /usr/local
-    fi
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$IS_MACOS" ]; then
         yum remove -y zlib-devel
@@ -77,17 +95,23 @@ function build {
     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
+        build_simple libXdmcp 1.1.5 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
-        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
     fi
     build_simple libxcb $LIBXCB_VERSION https://www.x.org/releases/individual/lib
 
     build_libjpeg_turbo
-    build_tiff
+    if [ -n "$IS_MACOS" ]; then
+        # Custom tiff build to include jpeg; by default, configure won't include
+        # headers/libs in the custom macOS prefix
+        build_simple tiff $TIFF_VERSION https://download.osgeo.org/libtiff tar.gz \
+            --with-jpeg-include-dir=$BUILD_PREFIX/include --with-jpeg-lib-dir=$BUILD_PREFIX/lib
+    else
+        build_tiff
+    fi
+
     build_libpng
     build_lcms2
     build_openjpeg
@@ -113,33 +137,55 @@ function build {
     fi
 
     build_harfbuzz
+
+    if [ -n "$IS_MACOS" ]; then
+        build_simple fribidi $FRIBIDI_VERSION https://github.com/fribidi/fribidi/releases/download/v$FRIBIDI_VERSION tar.xz --enable-shared
+        build_simple raqm $RAQM_VERSION https://github.com/Host_Oman/libraqm/releases/download/v$RAQM_VERSION tar.gz --enable-shared
+    fi
 }
 
+# Perform all dependency builds in the build subfolder.
+mkdir -p build
+pushd build > /dev/null
+
 # Any stuff that you need to do before you start building the wheels
 # Runs in the root directory of this repository.
-curl -fsSL -o pillow-depends-main.zip https://github.com/python-pillow/pillow-depends/archive/main.zip
-untar pillow-depends-main.zip
-
-if [[ -n "$IS_MACOS" ]]; then
-  # libtiff and libxcb cause a conflict with building libtiff and libxcb
-  # 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 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
+if [[ ! -d pillow-depends-main ]]; then
+  if [[ ! -f pillow-depends-main.zip ]]; then
+    echo "Download pillow dependency sources..."
+    curl -fSL -o pillow-depends-main.zip https://github.com/python-pillow/pillow-depends/archive/main.zip
   fi
+  untar pillow-depends-main.zip
+fi
 
-  brew install pkg-config
+if [[ -n "$IS_MACOS" ]]; then
+    # Build and install into the `deps` folder.
+    BUILD_PREFIX=$(pwd)/deps
+
+    # Homebrew (or similar packaging environments) install can contain some of
+    # the libraries that we're going to build. However, they may be compiled
+    # with a MACOSX_DEPLOYMENT_TARGET that doesn't match what we want to use,
+    # and they may bring in other dependencies that we don't want. The same will
+    # be true of any other locations on the path. To avoid conflicts, strip the
+    # path down to the bare mimimum (which, on macOS, won't include any
+    # development dependencies).
+    export PATH="$BUILD_PREFIX/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin:$(dirname $(which python))"
+    export CMAKE_PREFIX_PATH=$BUILD_PREFIX
+
+    # Link the brew command into our isolated build directory.
+    mkdir -p "$BUILD_PREFIX/bin"
+    mkdir -p "$BUILD_PREFIX/lib"
+
+    # Ensure pkg-confg and cmake are available
+    build_pkg_config
+    python -m pip install cmake
 fi
 
 wrap_wheel_builder build
 
+# Return to the project root to finish the build
+popd > /dev/null
+
 # Append licenses
 for filename in wheels/dependency_licenses/*; do
   echo -e "\n\n----\n\n$(basename $filename | cut -f 1 -d '.')\n" | cat >> LICENSE
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index b30b1725f94..05f5162c78a 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -1,16 +1,13 @@
 #!/bin/bash
 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
+# For Unix, Ensure fibidi is installed by the system.
+if [[ "$OSTYPE" != "darwin"* ]]; then
+    if [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
+        apk add curl fribidi
+    else
+        yum install -y fribidi
     fi
-elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
-    apk add curl fribidi
-else
-    yum install -y fribidi
 fi
 
 python3 -m pip install numpy
diff --git a/.gitignore b/.gitignore
index 1dd6c917524..9b577325730 100644
--- a/.gitignore
+++ b/.gitignore
@@ -19,6 +19,7 @@ lib64/
 parts/
 sdist/
 var/
+wheelhouse/
 *.egg-info/
 .installed.cfg
 *.egg
diff --git a/pyproject.toml b/pyproject.toml
index c55be769341..53546f0ab57 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -93,10 +93,17 @@ 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"
+# Add an explicit dependencies prefix for macOS, and don't request vendored libraries.
+macos.config-settings = "raqm=enable imagequant=disable dependencies-prefix=./build/deps"
+
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
+[tool.cibuildwheel.macos.environment]
+PATH = "$(pwd)/build/deps/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin:$(dirname $(which python))"
+
 [tool.black]
 exclude = "wheels/multibuild"
 
diff --git a/setup.py b/setup.py
index 60707083f6e..cb1da7c73f3 100644
--- a/setup.py
+++ b/setup.py
@@ -344,6 +344,11 @@ def __iter__(self) -> Iterator[str]:
             for x in ("raqm", "fribidi")
         ]
         + [
+            (
+                "dependencies-prefix",
+                None,
+                "The prefix where build dependencies are located.",
+            ),
             ("disable-platform-guessing", None, "Disable platform guessing on Linux"),
             ("debug", None, "Debug logging"),
         ]
@@ -355,6 +360,7 @@ def check_configuration(option: str, value: str) -> bool | None:
         return True if value in configuration.get(option, []) else None
 
     def initialize_options(self) -> None:
+        self.dependencies_prefix = configuration.get("dependencies-prefix", [])
         self.disable_platform_guessing = self.check_configuration(
             "platform-guessing", "disable"
         )
@@ -564,48 +570,56 @@ def build_extensions(self) -> None:
             )
 
         elif sys.platform == "darwin":
-            # attempt to make sure we pick freetype2 over other versions
-            _add_directory(include_dirs, "/sw/include/freetype2")
-            _add_directory(include_dirs, "/sw/lib/freetype2/include")
-            # fink installation directories
-            _add_directory(library_dirs, "/sw/lib")
-            _add_directory(include_dirs, "/sw/include")
-            # darwin ports installation directories
-            _add_directory(library_dirs, "/opt/local/lib")
-            _add_directory(include_dirs, "/opt/local/include")
-
-            # if Homebrew is installed, use its lib and include directories
-            try:
-                prefix = (
-                    subprocess.check_output(["brew", "--prefix"])
-                    .strip()
-                    .decode("latin1")
-                )
-            except Exception:
-                # Homebrew not installed
-                prefix = None
+            if self.dependencies_prefix:
+                # Use the explicitly provided prefixes for dependencies.
+                for prefix in self.dependencies_prefix:
+                    _add_directory(library_dirs, os.path.join(prefix, "lib"))
+                    _add_directory(include_dirs, os.path.join(prefix, "include"))
+            else:
+                # Guess the dependency locations based on homebrew/fink/macports
+                # attempt to make sure we pick freetype2 over other versions
+                _add_directory(include_dirs, "/sw/include/freetype2")
+                _add_directory(include_dirs, "/sw/lib/freetype2/include")
+                # fink installation directories
+                _add_directory(library_dirs, "/sw/lib")
+                _add_directory(include_dirs, "/sw/include")
+                # darwin ports installation directories
+                _add_directory(library_dirs, "/opt/local/lib")
+                _add_directory(include_dirs, "/opt/local/include")
+
+                # if Homebrew is installed, use its lib and include directories
+                try:
+                    prefix = (
+                        subprocess.check_output(["brew", "--prefix"])
+                        .strip()
+                        .decode("latin1")
+                    )
+                except Exception:
+                    # Homebrew not installed
+                    prefix = None
 
-            ft_prefix = None
+                ft_prefix = None
 
-            if prefix:
-                # add Homebrew's include and lib directories
-                _add_directory(library_dirs, os.path.join(prefix, "lib"))
-                _add_directory(include_dirs, os.path.join(prefix, "include"))
-                _add_directory(
-                    include_dirs, os.path.join(prefix, "opt", "zlib", "include")
-                )
-                ft_prefix = os.path.join(prefix, "opt", "freetype")
+                if prefix:
+                    # add Homebrew's include and lib directories
+                    _add_directory(library_dirs, os.path.join(prefix, "lib"))
+                    _add_directory(include_dirs, os.path.join(prefix, "include"))
+                    _add_directory(
+                        include_dirs, os.path.join(prefix, "opt", "zlib", "include")
+                    )
+                    ft_prefix = os.path.join(prefix, "opt", "freetype")
 
-            if ft_prefix and os.path.isdir(ft_prefix):
-                # freetype might not be linked into Homebrew's prefix
-                _add_directory(library_dirs, os.path.join(ft_prefix, "lib"))
-                _add_directory(include_dirs, os.path.join(ft_prefix, "include"))
-            else:
-                # fall back to freetype from XQuartz if
-                # Homebrew's freetype is missing
-                _add_directory(library_dirs, "/usr/X11/lib")
-                _add_directory(include_dirs, "/usr/X11/include")
+                if ft_prefix and os.path.isdir(ft_prefix):
+                    # freetype might not be linked into Homebrew's prefix
+                    _add_directory(library_dirs, os.path.join(ft_prefix, "lib"))
+                    _add_directory(include_dirs, os.path.join(ft_prefix, "include"))
+                else:
+                    # fall back to freetype from XQuartz if
+                    # Homebrew's freetype is missing
+                    _add_directory(library_dirs, "/usr/X11/lib")
+                    _add_directory(include_dirs, "/usr/X11/include")
 
+            # Add the macOS SDK path.
             sdk_path = self.get_macos_sdk_path()
             if sdk_path:
                 _add_directory(library_dirs, os.path.join(sdk_path, "usr", "lib"))
diff --git a/wheels/multibuild b/wheels/multibuild
index 452dd2d1705..8a9333e307f 160000
--- a/wheels/multibuild
+++ b/wheels/multibuild
@@ -1 +1 @@
-Subproject commit 452dd2d1705f6b2375369a6570c415beb3163f70
+Subproject commit 8a9333e307fa3f24db2089a66f25e38a8272c261

From fc35fcc5ea844cd0184af6e999d0f35835a4254a Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 10:55:30 +0800
Subject: [PATCH 1203/2374] Cleanups and typos identified by code review.

---
 .github/workflows/wheels-dependencies.sh | 8 ++++----
 .github/workflows/wheels-test.sh         | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 35b04c6d652..2c0835e7e56 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -23,7 +23,7 @@ OPENJPEG_VERSION=2.5.2
 XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
-RAQM_VERSION=0.7.1
+RAQM_VERSION=0.10.2
 FRIBIDI_VERSION=1.0.16
 if [[ -n "$IS_MACOS" ]]; then
     GIFLIB_VERSION=5.2.2
@@ -71,7 +71,7 @@ function build_brotli {
 
 function build_harfbuzz {
     if [ -e harfbuzz-stamp ]; then return; fi
-    python -m pip install meson ninja
+    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 \
@@ -176,9 +176,9 @@ if [[ -n "$IS_MACOS" ]]; then
     mkdir -p "$BUILD_PREFIX/bin"
     mkdir -p "$BUILD_PREFIX/lib"
 
-    # Ensure pkg-confg and cmake are available
+    # Ensure pkg-config and cmake are available
     build_pkg_config
-    python -m pip install cmake
+    python3 -m pip install cmake
 fi
 
 wrap_wheel_builder build
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 05f5162c78a..3a8fc87ba1e 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 set -e
 
-# For Unix, Ensure fibidi is installed by the system.
+# For Unix, ensure fribidi is installed by the system.
 if [[ "$OSTYPE" != "darwin"* ]]; then
     if [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
         apk add curl fribidi

From 00809a25516e1396e3e3ee38a760733efffbd1a9 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 13:42:46 +0800
Subject: [PATCH 1204/2374] Tweaks to ensure isolation from Homebrew on x86_64.

---
 .github/workflows/wheels-dependencies.sh | 34 +++++++++++++++++-------
 pyproject.toml                           |  2 +-
 2 files changed, 26 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 2c0835e7e56..dbabd4aef28 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -4,6 +4,9 @@
 if [ -z "$IS_MACOS" ]; then
     export MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
     export MB_ML_VER=${AUDITWHEEL_POLICY:9}
+
+    # Build and install into the `build/deps` folder.
+    BUILD_PREFIX=$(pwd)/build/deps
 fi
 export PLAT=$CIBW_ARCHS
 source wheels/multibuild/common_utils.sh
@@ -84,6 +87,18 @@ function build_harfbuzz {
     touch harfbuzz-stamp
 }
 
+function build_raqm {
+    if [ -e raqm-stamp ]; then return; fi
+    python3 -m pip install meson ninja
+
+    local out_dir=$(fetch_unpack https://github.com/HOST-Oman/libraqm/releases/download/v$RAQM_VERSION/raqm-$RAQM_VERSION.tar.xz raqm-$RAQM_VERSION.tar.xz)
+    (cd $out_dir \
+        && meson setup build --prefix=$BUILD_PREFIX)
+    (cd $out_dir/build \
+        && meson install)
+    touch raqm-stamp
+}
+
 function build {
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$IS_MACOS" ]; then
@@ -105,9 +120,12 @@ function build {
     build_libjpeg_turbo
     if [ -n "$IS_MACOS" ]; then
         # Custom tiff build to include jpeg; by default, configure won't include
-        # headers/libs in the custom macOS prefix
+        # headers/libs in the custom macOS prefix. Explicitly disable webp and
+        # zstd, because on x86_64 macs, it will pick up the Homebrew versions of
+        # webp and zstd from /usr/local.
         build_simple tiff $TIFF_VERSION https://download.osgeo.org/libtiff tar.gz \
-            --with-jpeg-include-dir=$BUILD_PREFIX/include --with-jpeg-lib-dir=$BUILD_PREFIX/lib
+            --with-jpeg-include-dir=$BUILD_PREFIX/include --with-jpeg-lib-dir=$BUILD_PREFIX/lib \
+            --disable-webp --disable-zstd
     else
         build_tiff
     fi
@@ -140,7 +158,7 @@ function build {
 
     if [ -n "$IS_MACOS" ]; then
         build_simple fribidi $FRIBIDI_VERSION https://github.com/fribidi/fribidi/releases/download/v$FRIBIDI_VERSION tar.xz --enable-shared
-        build_simple raqm $RAQM_VERSION https://github.com/Host_Oman/libraqm/releases/download/v$RAQM_VERSION tar.gz --enable-shared
+        build_raqm
     fi
 }
 
@@ -159,9 +177,6 @@ if [[ ! -d pillow-depends-main ]]; then
 fi
 
 if [[ -n "$IS_MACOS" ]]; then
-    # Build and install into the `deps` folder.
-    BUILD_PREFIX=$(pwd)/deps
-
     # Homebrew (or similar packaging environments) install can contain some of
     # the libraries that we're going to build. However, they may be compiled
     # with a MACOSX_DEPLOYMENT_TARGET that doesn't match what we want to use,
@@ -169,16 +184,17 @@ if [[ -n "$IS_MACOS" ]]; then
     # be true of any other locations on the path. To avoid conflicts, strip the
     # path down to the bare mimimum (which, on macOS, won't include any
     # development dependencies).
-    export PATH="$BUILD_PREFIX/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin:$(dirname $(which python))"
+    export PATH="$BUILD_PREFIX/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
     export CMAKE_PREFIX_PATH=$BUILD_PREFIX
 
     # Link the brew command into our isolated build directory.
     mkdir -p "$BUILD_PREFIX/bin"
     mkdir -p "$BUILD_PREFIX/lib"
 
-    # Ensure pkg-config and cmake are available
+    # Ensure pkg-config is available
     build_pkg_config
-    python3 -m pip install cmake
+    # Ensure cmake is available
+    python3 -m pip cmake
 fi
 
 wrap_wheel_builder build
diff --git a/pyproject.toml b/pyproject.toml
index 53546f0ab57..3839cf8402a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -102,7 +102,7 @@ test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
 [tool.cibuildwheel.macos.environment]
-PATH = "$(pwd)/build/deps/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin:$(dirname $(which python))"
+PATH = "$(pwd)/build/deps/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
 
 [tool.black]
 exclude = "wheels/multibuild"

From 06dbfedb0fbfcf38f6d6298ac4979e82fb653956 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 13:51:37 +0800
Subject: [PATCH 1205/2374] Bump the multibuild version to fix jpeg-turbo
 issue.

---
 wheels/multibuild | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/wheels/multibuild b/wheels/multibuild
index 8a9333e307f..22e8ad0c69a 160000
--- a/wheels/multibuild
+++ b/wheels/multibuild
@@ -1 +1 @@
-Subproject commit 8a9333e307fa3f24db2089a66f25e38a8272c261
+Subproject commit 22e8ad0c69acdb0c94abab74da6e09f2810d50d5

From 5a8373e527bbea93cb9c3be87c206683f488ad8e Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 14:47:51 +0800
Subject: [PATCH 1206/2374] Correct a dumb pip invocation error.

---
 .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 dbabd4aef28..0990943d32a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -194,7 +194,7 @@ if [[ -n "$IS_MACOS" ]]; then
     # Ensure pkg-config is available
     build_pkg_config
     # Ensure cmake is available
-    python3 -m pip cmake
+    python3 -m pip install cmake
 fi
 
 wrap_wheel_builder build

From 140a06e0fda60b7474dbdfde53b2ad2f1d344603 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 16:04:56 +0800
Subject: [PATCH 1207/2374] Explicitly disable libdeflate on libtiff.

---
 .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 0990943d32a..c6f57200f40 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -125,7 +125,7 @@ function build {
         # webp and zstd from /usr/local.
         build_simple tiff $TIFF_VERSION https://download.osgeo.org/libtiff tar.gz \
             --with-jpeg-include-dir=$BUILD_PREFIX/include --with-jpeg-lib-dir=$BUILD_PREFIX/lib \
-            --disable-webp --disable-zstd
+            --disable-webp --disable-zstd --disable-libdeflate
     else
         build_tiff
     fi

From 0961d3d22bc966f19f68ce01db6d07373dfbe6bc Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 16:10:29 +0800
Subject: [PATCH 1208/2374] Possible fix for linux build failures.

---
 .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 c6f57200f40..4d58bee901f 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -113,7 +113,7 @@ function build {
         build_simple libXdmcp 1.1.5 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
     else
-        sed s/\${pc_sysrootdir\}// /usr/local/share/pkgconfig/xcb-proto.pc > /usr/local/lib/pkgconfig/xcb-proto.pc
+        sed s/\${pc_sysrootdir\}// $BUILD_PREFIX/share/pkgconfig/xcb-proto.pc > /usr/local/lib/pkgconfig/xcb-proto.pc
     fi
     build_simple libxcb $LIBXCB_VERSION https://www.x.org/releases/individual/lib
 

From c46946f3a4c89a52637cc8e0c0f67d8e85d18a16 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 25 Oct 2024 19:13:39 +1100
Subject: [PATCH 1209/2374] Added filename placeholder in URL

---
 winbuild/build_prepare.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index a21fbef9148..b106eb7de76 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -131,7 +131,7 @@ def cmd_msbuild(
 DEPS: dict[str, dict[str, Any]] = {
     "libjpeg": {
         "url": f"{SF_PROJECTS}/libjpeg-turbo/files/{V['JPEGTURBO']}/"
-        f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz/download",
+        "FILENAME/download",
         "filename": f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz",
         "dir": f"libjpeg-turbo-{V['JPEGTURBO']}",
         "license": ["README.ijg", "LICENSE.md"],
@@ -161,7 +161,7 @@ def cmd_msbuild(
         "bins": ["cjpeg.exe", "djpeg.exe"],
     },
     "zlib": {
-        "url": f"https://zlib.net/zlib{V['ZLIB_DOTLESS']}.zip",
+        "url": "https://zlib.net/FILENAME",
         "filename": f"zlib{V['ZLIB_DOTLESS']}.zip",
         "dir": f"zlib-{V['ZLIB']}",
         "license": "README",
@@ -175,7 +175,7 @@ def cmd_msbuild(
         "libs": [r"*.lib"],
     },
     "xz": {
-        "url": f"https://github.com/tukaani-project/xz/releases/download/v{V['XZ']}/xz-{V['XZ']}.tar.gz",
+        "url": f"https://github.com/tukaani-project/xz/releases/download/v{V['XZ']}/FILENAME",
         "filename": f"xz-{V['XZ']}.tar.gz",
         "dir": f"xz-{V['XZ']}",
         "license": "COPYING",
@@ -188,7 +188,7 @@ def cmd_msbuild(
         "libs": [r"lzma.lib"],
     },
     "libwebp": {
-        "url": f"http://downloads.webmproject.org/releases/webp/libwebp-{V['LIBWEBP']}.tar.gz",
+        "url": "http://downloads.webmproject.org/releases/webp/FILENAME",
         "filename": f"libwebp-{V['LIBWEBP']}.tar.gz",
         "dir": f"libwebp-{V['LIBWEBP']}",
         "license": "COPYING",
@@ -210,7 +210,7 @@ def cmd_msbuild(
         "libs": [r"libsharpyuv.lib", r"libwebp*.lib"],
     },
     "libtiff": {
-        "url": f"https://download.osgeo.org/libtiff/tiff-{V['TIFF']}.tar.gz",
+        "url": "https://download.osgeo.org/libtiff/FILENAME",
         "filename": f"tiff-{V['TIFF']}.tar.gz",
         "dir": f"tiff-{V['TIFF']}",
         "license": "LICENSE.md",
@@ -268,7 +268,7 @@ def cmd_msbuild(
         "libs": ["*.lib"],
     },
     "freetype": {
-        "url": f"https://download.savannah.gnu.org/releases/freetype/freetype-{V['FREETYPE']}.tar.gz",
+        "url": "https://download.savannah.gnu.org/releases/freetype/FILENAME",
         "filename": f"freetype-{V['FREETYPE']}.tar.gz",
         "dir": f"freetype-{V['FREETYPE']}",
         "license": ["LICENSE.TXT", r"docs\FTL.TXT", r"docs\GPLv2.TXT"],
@@ -303,7 +303,7 @@ def cmd_msbuild(
         "libs": [r"objs\{msbuild_arch}\Release Static\freetype.lib"],
     },
     "lcms2": {
-        "url": f"{SF_PROJECTS}/lcms/files/lcms/{V['LCMS2']}/lcms2-{V['LCMS2']}.tar.gz/download",  # noqa: E501
+        "url": f"{SF_PROJECTS}/lcms/files/lcms/{V['LCMS2']}/FILENAME/download",
         "filename": f"lcms2-{V['LCMS2']}.tar.gz",
         "dir": f"lcms2-{V['LCMS2']}",
         "license": "LICENSE",
@@ -497,7 +497,7 @@ def extract_dep(url: str, filename: str, prefs: dict[str, str]) -> None:
         except RuntimeError as exc:
             # Otherwise try upstream
             print(exc)
-            download_dep(url, file)
+            download_dep(url.replace("FILENAME", filename), file)
 
     print("Extracting " + filename)
     sources_dir_abs = os.path.abspath(sources_dir)

From fa7678987e034599344304dbfac5d533c30f7820 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 25 Oct 2024 19:56:36 +1100
Subject: [PATCH 1210/2374] Simplified code

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

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b106eb7de76..c8332d11c7e 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -130,8 +130,7 @@ def cmd_msbuild(
 # dependencies, listed in order of compilation
 DEPS: dict[str, dict[str, Any]] = {
     "libjpeg": {
-        "url": f"{SF_PROJECTS}/libjpeg-turbo/files/{V['JPEGTURBO']}/"
-        "FILENAME/download",
+        "url": f"{SF_PROJECTS}/libjpeg-turbo/files/{V['JPEGTURBO']}/FILENAME/download",
         "filename": f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz",
         "dir": f"libjpeg-turbo-{V['JPEGTURBO']}",
         "license": ["README.ijg", "LICENSE.md"],

From 43c34fc0a5c22b1c00152a246fd39fe02925043d Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 25 Oct 2024 17:20:34 +0800
Subject: [PATCH 1211/2374] Copy manylinux lib64 files from the correct built
 prefix.

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 4d58bee901f..9dae287170a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -66,8 +66,8 @@ function build_brotli {
         && $cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
         && make install)
     if [[ "$MB_ML_LIBC" == "manylinux" ]]; then
-        cp /usr/local/lib64/libbrotli* /usr/local/lib
-        cp /usr/local/lib64/pkgconfig/libbrotli* /usr/local/lib/pkgconfig
+        cp $BUILD_PREFIX/lib64/libbrotli* $BUILD_PREFIX/lib
+        cp $BUILD_PREFIX/lib64/pkgconfig/libbrotli* $BUILD_PREFIX/lib/pkgconfig
     fi
     touch brotli-stamp
 }
@@ -82,7 +82,7 @@ function build_harfbuzz {
     (cd $out_dir/build \
         && meson install)
     if [[ "$MB_ML_LIBC" == "manylinux" ]]; then
-        cp /usr/local/lib64/libharfbuzz* /usr/local/lib
+        cp $BUILD_PREFIX/lib64/libharfbuzz* $BUILD_PREFIX/lib
     fi
     touch harfbuzz-stamp
 }
@@ -113,7 +113,7 @@ function build {
         build_simple libXdmcp 1.1.5 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
     else
-        sed s/\${pc_sysrootdir\}// $BUILD_PREFIX/share/pkgconfig/xcb-proto.pc > /usr/local/lib/pkgconfig/xcb-proto.pc
+        sed s/\${pc_sysrootdir\}// $BUILD_PREFIX/share/pkgconfig/xcb-proto.pc > $BUILD_PREFIX/lib/pkgconfig/xcb-proto.pc
     fi
     build_simple libxcb $LIBXCB_VERSION https://www.x.org/releases/individual/lib
 
@@ -133,8 +133,8 @@ function build {
     build_libpng
     build_lcms2
     build_openjpeg
-    if [ -f /usr/local/lib64/libopenjp2.so ]; then
-        cp /usr/local/lib64/libopenjp2.so /usr/local/lib
+    if [ -f $BUILD_PREFIX/lib64/libopenjp2.so ]; then
+        cp $BUILD_PREFIX/lib64/libopenjp2.so $BUILD_PREFIX/lib
     fi
 
     ORIGINAL_CFLAGS=$CFLAGS

From 4b9399f8bfb08d4ed1a1113ed6fd4b6137f7c2aa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 25 Oct 2024 22:00:45 +1100
Subject: [PATCH 1212/2374] Use register_handler

---
 Tests/test_file_bufrstub.py | 2 +-
 Tests/test_file_gribstub.py | 2 +-
 Tests/test_file_hdf5stub.py | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_bufrstub.py b/Tests/test_file_bufrstub.py
index 77ee5b0ea12..fc8920317c5 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -83,4 +83,4 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
         im.save(temp_file)
         assert handler.saved
 
-    BufrStubImagePlugin._handler = None
+    BufrStubImagePlugin.register_handler(None)
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index aba473d24d0..02e464ff190 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -83,4 +83,4 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
         im.save(temp_file)
         assert handler.saved
 
-    GribStubImagePlugin._handler = None
+    GribStubImagePlugin.register_handler(None)
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index 8275bd0d890..024be9e80cf 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -85,4 +85,4 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
         im.save(temp_file)
         assert handler.saved
 
-    Hdf5StubImagePlugin._handler = None
+    Hdf5StubImagePlugin.register_handler(None)

From bb3515d649cda179037161ee3bea264a4d289b32 Mon Sep 17 00:00:00 2001
From: Lysandros Nikolaou <lisandrosnik@gmail.com>
Date: Fri, 25 Oct 2024 17:32:29 +0200
Subject: [PATCH 1213/2374] Make PyMutex static and get rid of initialization

---
 src/_imagingft.c | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 884b8f96c2e..d38279f3e4b 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -83,7 +83,7 @@ struct {
 
     static FT_Library library;
 #ifdef Py_GIL_DISABLED
-PyMutex ft_library_mutex;
+static PyMutex ft_library_mutex;
 #endif
 
 typedef struct {
@@ -1648,7 +1648,6 @@ PyInit__imagingft(void) {
     }
 
 #ifdef Py_GIL_DISABLED
-    ft_library_mutex = (PyMutex){0};
     PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
 #endif
 

From 3e0849bfb56f6fa8c73ff1bde044551ed72ac2d3 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Fri, 25 Oct 2024 20:35:17 +0200
Subject: [PATCH 1214/2374] winbuild: Replace zlib with zlib-ng built with
 CMake

---
 winbuild/build_prepare.py | 25 ++++++++++++++-----------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index a21fbef9148..2065e41a96e 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -120,11 +120,10 @@ def cmd_msbuild(
     "OPENJPEG": "2.5.2",
     "TIFF": "4.6.0",
     "XZ": "5.6.3",
-    "ZLIB": "1.3.1",
+    "ZLIBNG": "2.2.2",
 }
 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
@@ -161,18 +160,22 @@ def cmd_msbuild(
         "bins": ["cjpeg.exe", "djpeg.exe"],
     },
     "zlib": {
-        "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(.+)$",
+        "url": f"https://github.com/zlib-ng/zlib-ng/archive/refs/tags/{V['ZLIBNG']}.zip",
+        "filename": f"zlib-ng-{V['ZLIBNG']}.zip",
+        "dir": f"zlib-ng-{V['ZLIBNG']}",
+        "license": "LICENSE.md",
+        "patch": {
+            r"CMakeLists.txt": {
+                "set_target_properties(zlib PROPERTIES OUTPUT_NAME zlibstatic${{SUFFIX}})": "set_target_properties(zlib PROPERTIES OUTPUT_NAME zlib)",  # noqa: E501
+            },
+        },
         "build": [
-            cmd_nmake(r"win32\Makefile.msc", "clean"),
-            cmd_nmake(r"win32\Makefile.msc", "zlib.lib"),
-            cmd_copy("zlib.lib", "z.lib"),
+            *cmds_cmake(
+                "zlib", "-DBUILD_SHARED_LIBS:BOOL=OFF", "-DZLIB_COMPAT:BOOL=ON"
+            ),
         ],
         "headers": [r"z*.h"],
-        "libs": [r"*.lib"],
+        "libs": [r"zlib.lib"],
     },
     "xz": {
         "url": f"https://github.com/tukaani-project/xz/releases/download/v{V['XZ']}/xz-{V['XZ']}.tar.gz",

From 7885066e5fc6ae56db0bef18eb2c188a6aa9a181 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Fri, 25 Oct 2024 20:37:21 +0200
Subject: [PATCH 1215/2374] PIL.features: Add a compile-time zlib-ng feature
 flag and version number

---
 Tests/check_wheel.py        |  3 +++
 docs/reference/features.rst |  1 +
 src/PIL/features.py         |  7 ++++++-
 src/_imaging.c              | 14 ++++++++++++++
 4 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 4b91984f58a..374e48e8ad3 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -34,10 +34,13 @@ def test_wheel_features() -> None:
         "fribidi",
         "harfbuzz",
         "libjpeg_turbo",
+        "zlib_ng",
         "xcb",
     }
 
     if sys.platform == "win32":
         expected_features.remove("xcb")
+    else:
+        expected_features.remove("zlib_ng")
 
     assert set(features.get_supported_features()) == expected_features
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index fcff9673567..427c0f606d2 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -54,6 +54,7 @@ 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.
+* ``zlib_ng``: (compile time) Whether Pillow was compiled against the zlib-ng version of zlib. Compile-time version number is available.
 * ``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/src/PIL/features.py b/src/PIL/features.py
index 75d59e01c40..3645e3defc4 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -127,6 +127,7 @@ def get_supported_codecs() -> list[str]:
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
     "harfbuzz": ("PIL._imagingft", "HAVE_HARFBUZZ", "harfbuzz_version"),
     "libjpeg_turbo": ("PIL._imaging", "HAVE_LIBJPEGTURBO", "libjpeg_turbo_version"),
+    "zlib_ng": ("PIL._imaging", "HAVE_ZLIBNG", "zlib_ng_version"),
     "libimagequant": ("PIL._imaging", "HAVE_LIBIMAGEQUANT", "imagequant_version"),
     "xcb": ("PIL._imaging", "HAVE_XCB", None),
 }
@@ -308,7 +309,11 @@ def pilinfo(out: IO[str] | None = None, supported_formats: bool = True) -> None:
                     # this check is also in src/_imagingcms.c:setup_module()
                     version_static = tuple(int(x) for x in v.split(".")) < (2, 7)
                 t = "compiled for" if version_static else "loaded"
-                if name == "raqm":
+                if name == "zlib":
+                    zlib_ng_version = version_feature("zlib_ng")
+                    if zlib_ng_version is not None:
+                        v += ", compiled for zlib-ng " + zlib_ng_version
+                elif name == "raqm":
                     for f in ("fribidi", "harfbuzz"):
                         v2 = version_feature(f)
                         if v2 is not None:
diff --git a/src/_imaging.c b/src/_imaging.c
index 2db4486b23e..5d6d97bedab 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4397,6 +4397,20 @@ setup_module(PyObject *m) {
     }
 #endif
 
+    PyObject *have_zlibng;
+#ifdef ZLIBNG_VERSION
+    have_zlibng = Py_True;
+    {
+        PyObject *v = PyUnicode_FromString(ZLIBNG_VERSION);
+        PyDict_SetItemString(d, "zlib_ng_version", v ? v : Py_None);
+        Py_XDECREF(v);
+    }
+#else
+    have_zlibng = Py_False;
+#endif
+    Py_INCREF(have_zlibng);
+    PyModule_AddObject(m, "HAVE_ZLIBNG", have_zlibng);
+
 #ifdef HAVE_LIBTIFF
     {
         extern const char *ImagingTiffVersion(void);

From a43e5bb7354006766a67a353aa21d9a0198cdcab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Oct 2024 14:26:47 +1100
Subject: [PATCH 1216/2374] brew remove libdeflate

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 97c1adf098a..7970d4d1525 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -121,6 +121,7 @@ curl -fsSL -o pillow-depends-main.zip https://github.com/python-pillow/pillow-de
 untar pillow-depends-main.zip
 
 if [[ -n "$IS_MACOS" ]]; then
+  # libdeflate may cause a minimum target error when repairing the wheel
   # libtiff and libxcb cause a conflict with building libtiff and libxcb
   # libxau and libxdmcp cause an issue on macOS < 11
   # remove cairo to fix building harfbuzz on arm64
@@ -132,7 +133,7 @@ if [[ -n "$IS_MACOS" ]]; then
   if [[ "$CIBW_ARCHS" == "arm64" ]]; then
     brew remove --ignore-dependencies jpeg-turbo
   else
-    brew remove --ignore-dependencies webp
+    brew remove --ignore-dependencies libdeflate webp
   fi
 
   brew install pkg-config

From e1f4b5a68fa783126f5a81ccba5fac4526f6ab00 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Oct 2024 15:10:41 +1100
Subject: [PATCH 1217/2374] Move MPO into "Fully supported formats"

---
 docs/handbook/image-file-formats.rst | 48 ++++++++++++++--------------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 8183473e4f5..bf3087f6f68 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -692,6 +692,30 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
    you fail to do this, you will get errors about not being able to load the
    ``_imaging`` DLL).
 
+MPO
+^^^
+
+Pillow reads and writes Multi Picture Object (MPO) files. When first opened, it loads
+the primary image. The :py:meth:`~PIL.Image.Image.seek` and
+:py:meth:`~PIL.Image.Image.tell` methods may be used to read other pictures from the
+file. The pictures are zero-indexed and random access is supported.
+
+.. _mpo-saving:
+
+Saving
+~~~~~~
+
+When calling :py:meth:`~PIL.Image.Image.save` to write an MPO 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
+option will also be available.
+
+**append_images**
+    A list of images to append as additional pictures. Each of the
+    images in the list can be single or multiframe images.
+
+    .. versionadded:: 9.3.0
+
 MSP
 ^^^
 
@@ -1435,30 +1459,6 @@ Note that there may be an embedded gamma of 2.2 in MIC files.
 
 To enable MIC support, you must install :pypi:`olefile`.
 
-MPO
-^^^
-
-Pillow identifies and reads Multi Picture Object (MPO) files, loading the primary
-image when first opened. The :py:meth:`~PIL.Image.Image.seek` and :py:meth:`~PIL.Image.Image.tell`
-methods may be used to read other pictures from the file. The pictures are
-zero-indexed and random access is supported.
-
-.. _mpo-saving:
-
-Saving
-~~~~~~
-
-When calling :py:meth:`~PIL.Image.Image.save` to write an MPO 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
-option will also be available.
-
-**append_images**
-    A list of images to append as additional pictures. Each of the
-    images in the list can be single or multiframe images.
-
-    .. versionadded:: 9.3.0
-
 PCD
 ^^^
 

From 413bbb31c959a3e2a6929d4a12861a79d82f8e80 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Oct 2024 16:15:46 +1100
Subject: [PATCH 1218/2374] Fixed catching warnings

---
 Tests/test_bmp_reference.py | 2 ++
 Tests/test_file_dcx.py      | 4 ++++
 Tests/test_file_fli.py      | 4 ++++
 Tests/test_file_gif.py      | 4 ++++
 Tests/test_file_icns.py     | 2 ++
 Tests/test_file_im.py       | 4 ++++
 Tests/test_file_jpeg.py     | 2 ++
 Tests/test_file_mpo.py      | 4 ++++
 Tests/test_file_png.py      | 2 ++
 Tests/test_file_psd.py      | 4 ++++
 Tests/test_file_spider.py   | 4 ++++
 Tests/test_file_tar.py      | 4 ++++
 Tests/test_file_tiff.py     | 4 ++++
 Tests/test_file_webp.py     | 2 ++
 Tests/test_image.py         | 2 ++
 Tests/test_imageqt.py       | 2 ++
 Tests/test_numpy.py         | 2 ++
 17 files changed, 52 insertions(+)

diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 7f848792131..82cab39c613 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -22,6 +22,8 @@ def test_bad() -> None:
     for f in get_files("b"):
         # Assert that there is no unclosed file warning
         with warnings.catch_warnings():
+            warnings.simplefilter("error")
+
             try:
                 with Image.open(f) as im:
                     im.load()
diff --git a/Tests/test_file_dcx.py b/Tests/test_file_dcx.py
index 65337cad9b1..5deacd878ea 100644
--- a/Tests/test_file_dcx.py
+++ b/Tests/test_file_dcx.py
@@ -36,6 +36,8 @@ def open() -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         im = Image.open(TEST_FILE)
         im.load()
         im.close()
@@ -43,6 +45,8 @@ def test_closed_file() -> None:
 
 def test_context_manager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with Image.open(TEST_FILE) as im:
             im.load()
 
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index f86fb8d0925..0a7740cc87d 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -65,6 +65,8 @@ def open() -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         im = Image.open(static_test_file)
         im.load()
         im.close()
@@ -81,6 +83,8 @@ def test_seek_after_close() -> None:
 
 def test_context_manager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with Image.open(static_test_file) as im:
             im.load()
 
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 16c8466f331..248347d5bb9 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -46,6 +46,8 @@ def open() -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         im = Image.open(TEST_GIF)
         im.load()
         im.close()
@@ -67,6 +69,8 @@ def test_seek_after_close() -> None:
 
 def test_context_manager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with Image.open(TEST_GIF) as im:
             im.load()
 
diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index 16f6b36516d..141b88dfa01 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -21,6 +21,8 @@ def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         # Assert that there is no unclosed file warning
         with warnings.catch_warnings():
+            warnings.simplefilter("error")
+
             im.load()
 
         assert im.mode == "RGBA"
diff --git a/Tests/test_file_im.py b/Tests/test_file_im.py
index 036965bf5d8..1d3fa485f3b 100644
--- a/Tests/test_file_im.py
+++ b/Tests/test_file_im.py
@@ -41,6 +41,8 @@ def open() -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         im = Image.open(TEST_IM)
         im.load()
         im.close()
@@ -48,6 +50,8 @@ def test_closed_file() -> None:
 
 def test_context_manager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with Image.open(TEST_IM) as im:
             im.load()
 
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index cde951395a7..2c66652e5d2 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -850,6 +850,8 @@ def test_exif_x_resolution(self, tmp_path: Path) -> None:
 
             out = str(tmp_path / "out.jpg")
             with warnings.catch_warnings():
+                warnings.simplefilter("error")
+
                 im.save(out, exif=exif)
 
         with Image.open(out) as reloaded:
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index e0f42a26649..94958318557 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -48,6 +48,8 @@ def open() -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         im = Image.open(test_files[0])
         im.load()
         im.close()
@@ -63,6 +65,8 @@ def test_seek_after_close() -> None:
 
 def test_context_manager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with Image.open(test_files[0]) as im:
             im.load()
 
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 0abf9866ff2..ffafc3c582a 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -338,6 +338,8 @@ def test_load_verify(self) -> None:
         with Image.open(TEST_PNG_FILE) as im:
             # Assert that there is no unclosed file warning
             with warnings.catch_warnings():
+                warnings.simplefilter("error")
+
                 im.verify()
 
         with Image.open(TEST_PNG_FILE) as im:
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index e6c79e40b6e..5f22001f324 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -35,6 +35,8 @@ def open() -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         im = Image.open(test_file)
         im.load()
         im.close()
@@ -42,6 +44,8 @@ def test_closed_file() -> None:
 
 def test_context_manager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with Image.open(test_file) as im:
             im.load()
 
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 66c88e9d8eb..4cafda86536 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -34,6 +34,8 @@ def open() -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         im = Image.open(TEST_FILE)
         im.load()
         im.close()
@@ -41,6 +43,8 @@ def test_closed_file() -> None:
 
 def test_context_manager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with Image.open(TEST_FILE) as im:
             im.load()
 
diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index 6217ebedd8a..49220a8b690 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -37,11 +37,15 @@ def test_unclosed_file() -> None:
 
 def test_close() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         tar = TarIO.TarIO(TEST_TAR_FILE, "hopper.jpg")
         tar.close()
 
 
 def test_contextmanager() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         with TarIO.TarIO(TEST_TAR_FILE, "hopper.jpg"):
             pass
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index af766022b5c..6f51d46513e 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -72,6 +72,8 @@ def open() -> None:
 
     def test_closed_file(self) -> None:
         with warnings.catch_warnings():
+            warnings.simplefilter("error")
+
             im = Image.open("Tests/images/multipage.tiff")
             im.load()
             im.close()
@@ -88,6 +90,8 @@ def test_seek_after_close(self) -> None:
 
     def test_context_manager(self) -> None:
         with warnings.catch_warnings():
+            warnings.simplefilter("error")
+
             with Image.open("Tests/images/multipage.tiff") as im:
                 im.load()
 
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 79f6bb4e0e4..ad5aa9ed62c 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -191,6 +191,8 @@ def test_no_resource_warning(self, tmp_path: Path) -> None:
         file_path = "Tests/images/hopper.webp"
         with Image.open(file_path) as image:
             with warnings.catch_warnings():
+                warnings.simplefilter("error")
+
                 image.save(tmp_path / "temp.webp")
 
     def test_file_pointer_could_be_reused(self) -> None:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 9b65041f4b4..c8df474f493 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -737,6 +737,8 @@ def test_no_resource_warning_on_save(self, tmp_path: Path) -> None:
         # Act/Assert
         with Image.open(test_file) as im:
             with warnings.catch_warnings():
+                warnings.simplefilter("error")
+
                 im.save(temp_file)
 
     def test_no_new_file_on_error(self, tmp_path: Path) -> None:
diff --git a/Tests/test_imageqt.py b/Tests/test_imageqt.py
index 22cd674ce28..2d7ca0ae0fd 100644
--- a/Tests/test_imageqt.py
+++ b/Tests/test_imageqt.py
@@ -52,4 +52,6 @@ def test_image(mode: str) -> None:
 
 def test_closed_file() -> None:
     with warnings.catch_warnings():
+        warnings.simplefilter("error")
+
         ImageQt.ImageQt("Tests/images/hopper.gif")
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 040472d69e3..79cd14b6690 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -264,4 +264,6 @@ def test_no_resource_warning_for_numpy_array() -> None:
     with Image.open(test_file) as im:
         # Act/Assert
         with warnings.catch_warnings():
+            warnings.simplefilter("error")
+
             array(im)

From ce4059171cc5696e7c7d8c5dc74990d5e874bf58 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Oct 2024 18:41:05 +1100
Subject: [PATCH 1219/2374] Skip failing records when rendering

---
 Tests/test_file_wmf.py | 12 +++++++++++-
 src/display.c          | 13 +++++++++----
 2 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 79e707263d6..d730a049a98 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from io import BytesIO
 from pathlib import Path
 from typing import IO
 
@@ -7,7 +8,7 @@
 
 from PIL import Image, ImageFile, WmfImagePlugin
 
-from .helper import assert_image_similar_tofile, hopper
+from .helper import assert_image_equal_tofile, assert_image_similar_tofile, hopper
 
 
 def test_load_raw() -> None:
@@ -34,6 +35,15 @@ def test_load() -> None:
             assert im.load()[0, 0] == (255, 255, 255)
 
 
+def test_render() -> None:
+    with open("Tests/images/drawing.emf", "rb") as fp:
+        data = fp.read()
+    b = BytesIO(data[:808] + b"\x00" + data[809:])
+    with Image.open(b) as im:
+        if hasattr(Image.core, "drawwmf"):
+            assert_image_equal_tofile(im, "Tests/images/drawing.emf")
+
+
 def test_register_handler(tmp_path: Path) -> None:
     class TestHandler(ImageFile.StubHandler):
         methodCalled = False
diff --git a/src/display.c b/src/display.c
index b4e2e38991a..03b9316c36a 100644
--- a/src/display.c
+++ b/src/display.c
@@ -716,6 +716,14 @@ PyImaging_EventLoopWin32(PyObject *self, PyObject *args) {
 
 #define GET32(p, o) ((DWORD *)(p + o))[0]
 
+BOOL
+enhMetaFileProc(
+    HDC hdc, HANDLETABLE FAR *lpht, CONST ENHMETARECORD *lpmr, int nHandles, LPARAM data
+) {
+    PlayEnhMetaFileRecord(hdc, lpht, lpmr, nHandles);
+    return TRUE;
+}
+
 PyObject *
 PyImaging_DrawWmf(PyObject *self, PyObject *args) {
     HBITMAP bitmap;
@@ -796,10 +804,7 @@ PyImaging_DrawWmf(PyObject *self, PyObject *args) {
     /* FIXME: make background transparent? configurable? */
     FillRect(dc, &rect, GetStockObject(WHITE_BRUSH));
 
-    if (!PlayEnhMetaFile(dc, meta, &rect)) {
-        PyErr_SetString(PyExc_OSError, "cannot render metafile");
-        goto error;
-    }
+    EnumEnhMetaFile(dc, meta, enhMetaFileProc, NULL, &rect);
 
     /* step 4: extract bits from bitmap */
 

From f92599aa9394d9b1f59a503a796bc0fb6ddb8cda Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Oct 2024 19:05:16 +1100
Subject: [PATCH 1220/2374] Renamed fixture

---
 Tests/test_file_jpeg2k.py | 102 +++++++++++++++++++-------------------
 1 file changed, 50 insertions(+), 52 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 79f53e21195..fbf72ae0518 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -32,7 +32,7 @@
 
 
 @pytest.fixture
-def test_card() -> Generator[ImageFile.ImageFile, None, None]:
+def card() -> Generator[ImageFile.ImageFile, None, None]:
     with Image.open("Tests/images/test-card.png") as im:
         im.load()
     try:
@@ -83,78 +83,76 @@ def test_invalid_file() -> None:
         Jpeg2KImagePlugin.Jpeg2KImageFile(invalid_file)
 
 
-def test_bytesio(test_card: ImageFile.ImageFile) -> None:
+def test_bytesio(card: ImageFile.ImageFile) -> None:
     with open("Tests/images/test-card-lossless.jp2", "rb") as f:
         data = BytesIO(f.read())
     with Image.open(data) as im:
         im.load()
-        assert_image_similar(im, test_card, 1.0e-3)
+        assert_image_similar(im, card, 1.0e-3)
 
 
 # These two test pre-written JPEG 2000 files that were not written with
 # PIL (they were made using Adobe Photoshop)
 
 
-def test_lossless(test_card: ImageFile.ImageFile, tmp_path: Path) -> None:
+def test_lossless(card: ImageFile.ImageFile, 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")
         im.save(outfile)
-    assert_image_similar(im, test_card, 1.0e-3)
+    assert_image_similar(im, card, 1.0e-3)
 
 
-def test_lossy_tiled(test_card: ImageFile.ImageFile) -> None:
-    assert_image_similar_tofile(
-        test_card, "Tests/images/test-card-lossy-tiled.jp2", 2.0
-    )
+def test_lossy_tiled(card: ImageFile.ImageFile) -> None:
+    assert_image_similar_tofile(card, "Tests/images/test-card-lossy-tiled.jp2", 2.0)
 
 
-def test_lossless_rt(test_card: ImageFile.ImageFile) -> None:
-    im = roundtrip(test_card)
-    assert_image_equal(im, test_card)
+def test_lossless_rt(card: ImageFile.ImageFile) -> None:
+    im = roundtrip(card)
+    assert_image_equal(im, card)
 
 
-def test_lossy_rt(test_card: ImageFile.ImageFile) -> None:
-    im = roundtrip(test_card, quality_layers=[20])
-    assert_image_similar(im, test_card, 2.0)
+def test_lossy_rt(card: ImageFile.ImageFile) -> None:
+    im = roundtrip(card, quality_layers=[20])
+    assert_image_similar(im, card, 2.0)
 
 
-def test_tiled_rt(test_card: ImageFile.ImageFile) -> None:
-    im = roundtrip(test_card, tile_size=(128, 128))
-    assert_image_equal(im, test_card)
+def test_tiled_rt(card: ImageFile.ImageFile) -> None:
+    im = roundtrip(card, tile_size=(128, 128))
+    assert_image_equal(im, card)
 
 
-def test_tiled_offset_rt(test_card: ImageFile.ImageFile) -> 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_rt(card: ImageFile.ImageFile) -> None:
+    im = roundtrip(card, tile_size=(128, 128), tile_offset=(0, 0), offset=(32, 32))
+    assert_image_equal(im, card)
 
 
-def test_tiled_offset_too_small(test_card: ImageFile.ImageFile) -> None:
+def test_tiled_offset_too_small(card: ImageFile.ImageFile) -> None:
     with pytest.raises(ValueError):
-        roundtrip(test_card, tile_size=(128, 128), tile_offset=(0, 0), offset=(128, 32))
+        roundtrip(card, tile_size=(128, 128), tile_offset=(0, 0), offset=(128, 32))
 
 
-def test_irreversible_rt(test_card: ImageFile.ImageFile) -> None:
-    im = roundtrip(test_card, irreversible=True, quality_layers=[20])
-    assert_image_similar(im, test_card, 2.0)
+def test_irreversible_rt(card: ImageFile.ImageFile) -> None:
+    im = roundtrip(card, irreversible=True, quality_layers=[20])
+    assert_image_similar(im, card, 2.0)
 
 
-def test_prog_qual_rt(test_card: ImageFile.ImageFile) -> None:
-    im = roundtrip(test_card, quality_layers=[60, 40, 20], progression="LRCP")
-    assert_image_similar(im, test_card, 2.0)
+def test_prog_qual_rt(card: ImageFile.ImageFile) -> None:
+    im = roundtrip(card, quality_layers=[60, 40, 20], progression="LRCP")
+    assert_image_similar(im, card, 2.0)
 
 
-def test_prog_res_rt(test_card: ImageFile.ImageFile) -> None:
-    im = roundtrip(test_card, num_resolutions=8, progression="RLCP")
-    assert_image_equal(im, test_card)
+def test_prog_res_rt(card: ImageFile.ImageFile) -> None:
+    im = roundtrip(card, num_resolutions=8, progression="RLCP")
+    assert_image_equal(im, card)
 
 
 @pytest.mark.parametrize("num_resolutions", range(2, 6))
 def test_default_num_resolutions(
-    test_card: ImageFile.ImageFile, num_resolutions: int
+    card: ImageFile.ImageFile, num_resolutions: int
 ) -> None:
     d = 1 << (num_resolutions - 1)
-    im = test_card.resize((d - 1, d - 1))
+    im = card.resize((d - 1, d - 1))
     with pytest.raises(OSError):
         roundtrip(im, num_resolutions=num_resolutions)
     reloaded = roundtrip(im)
@@ -216,31 +214,31 @@ def test_header_errors() -> None:
             pass
 
 
-def test_layers_type(test_card: ImageFile.ImageFile, tmp_path: Path) -> None:
+def test_layers_type(card: ImageFile.ImageFile, 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)
+        card.save(outfile, quality_layers=quality_layers)
 
     for quality_layers_str in ["quality_layers", ("100", "50", "10")]:
         with pytest.raises(ValueError):
-            test_card.save(outfile, quality_layers=quality_layers_str)
+            card.save(outfile, quality_layers=quality_layers_str)
 
 
-def test_layers(test_card: ImageFile.ImageFile) -> None:
+def test_layers(card: ImageFile.ImageFile) -> None:
     out = BytesIO()
-    test_card.save(out, "JPEG2000", quality_layers=[100, 50, 10], progression="LRCP")
+    card.save(out, "JPEG2000", quality_layers=[100, 50, 10], progression="LRCP")
     out.seek(0)
 
     with Image.open(out) as im:
         im.layers = 1
         im.load()
-        assert_image_similar(im, test_card, 13)
+        assert_image_similar(im, card, 13)
 
     out.seek(0)
     with Image.open(out) as im:
         im.layers = 3
         im.load()
-        assert_image_similar(im, test_card, 0.4)
+        assert_image_similar(im, card, 0.4)
 
 
 @pytest.mark.parametrize(
@@ -257,7 +255,7 @@ def test_layers(test_card: ImageFile.ImageFile) -> None:
     ),
 )
 def test_no_jp2(
-    test_card: ImageFile.ImageFile,
+    card: ImageFile.ImageFile,
     name: str,
     args: dict[str, bool],
     offset: int,
@@ -266,20 +264,20 @@ def test_no_jp2(
     out = BytesIO()
     if name:
         out.name = name
-    test_card.save(out, "JPEG2000", **args)
+    card.save(out, "JPEG2000", **args)
     out.seek(offset)
     assert out.read(2) == data
 
 
-def test_mct(test_card: ImageFile.ImageFile) -> None:
+def test_mct(card: ImageFile.ImageFile) -> None:
     # Three component
     for val in (0, 1):
         out = BytesIO()
-        test_card.save(out, "JPEG2000", mct=val, no_jp2=True)
+        card.save(out, "JPEG2000", mct=val, no_jp2=True)
 
         assert out.getvalue()[59] == val
         with Image.open(out) as im:
-            assert_image_similar(im, test_card, 1.0e-3)
+            assert_image_similar(im, card, 1.0e-3)
 
     # Single component should have MCT disabled
     for val in (0, 1):
@@ -436,22 +434,22 @@ def test_comment() -> None:
             pass
 
 
-def test_save_comment(test_card: ImageFile.ImageFile) -> None:
+def test_save_comment(card: ImageFile.ImageFile) -> None:
     for comment in ("Created by Pillow", b"Created by Pillow"):
         out = BytesIO()
-        test_card.save(out, "JPEG2000", comment=comment)
+        card.save(out, "JPEG2000", comment=comment)
 
         with Image.open(out) as im:
             assert im.info["comment"] == b"Created by Pillow"
 
     out = BytesIO()
     long_comment = b" " * 65531
-    test_card.save(out, "JPEG2000", comment=long_comment)
+    card.save(out, "JPEG2000", comment=long_comment)
     with Image.open(out) as im:
         assert im.info["comment"] == long_comment
 
     with pytest.raises(ValueError):
-        test_card.save(out, "JPEG2000", comment=long_comment + b" ")
+        card.save(out, "JPEG2000", comment=long_comment + b" ")
 
 
 @pytest.mark.parametrize(
@@ -474,10 +472,10 @@ def test_crashes(test_file: str) -> None:
 
 
 @skip_unless_feature_version("jpg_2000", "2.4.0")
-def test_plt_marker(test_card: ImageFile.ImageFile) -> None:
+def test_plt_marker(card: ImageFile.ImageFile) -> None:
     # Search the start of the codesteam for PLT
     out = BytesIO()
-    test_card.save(out, "JPEG2000", no_jp2=True, plt=True)
+    card.save(out, "JPEG2000", no_jp2=True, plt=True)
     out.seek(0)
     while True:
         marker = out.read(2)

From ed910a68d637661ccb4c4a7c1245769176fec93d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Oct 2024 11:42:35 +1100
Subject: [PATCH 1221/2374] Only replace version suffix if zlib-ng is present

---
 Tests/test_features.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index ed792997376..f8f7f6eec59 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -36,10 +36,11 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
         else:
             assert function(name) == version
             if name != "PIL":
-                if name == "zlib" and version is not None:
-                    version = re.sub(".zlib-ng$", "", version)
-                elif name == "libtiff" and version is not None:
-                    version = re.sub("t$", "", version)
+                if version is not None:
+                    if name == "zlib" and features.check_feature("zlib_ng"):
+                        version = re.sub(".zlib-ng$", "", version)
+                    elif name == "libtiff":
+                        version = re.sub("t$", "", version)
                 assert version is None or re.search(r"\d+(\.\d+)*$", version)
 
     for module in features.modules:

From 29cdbce39e1d3860486319b46ea829e0c3566279 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Oct 2024 21:13:01 +1100
Subject: [PATCH 1222/2374] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index ae384156963..87945bc8456 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.1.0 (unreleased)
 -------------------
 
+- Corrected EMF DPI #8485
+  [radarhere]
+
 - Fix IFDRational with a zero denominator #8474
   [radarhere]
 

From b4ba4665410c70ad8976b092ee9b1ad89625c0ed Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 27 Oct 2024 07:03:35 +1100
Subject: [PATCH 1223/2374] Do not skip failing records on 32-bit

---
 Tests/test_file_wmf.py |  2 ++
 src/display.c          | 13 ++++++++++---
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 2adf38d48c3..e60a5b64e55 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import sys
 from io import BytesIO
 from pathlib import Path
 from typing import IO
@@ -35,6 +36,7 @@ def test_load() -> None:
             assert im.load()[0, 0] == (255, 255, 255)
 
 
+@pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
 def test_render() -> None:
     with open("Tests/images/drawing.emf", "rb") as fp:
         data = fp.read()
diff --git a/src/display.c b/src/display.c
index 03b9316c36a..fe5801fc0e6 100644
--- a/src/display.c
+++ b/src/display.c
@@ -716,12 +716,12 @@ PyImaging_EventLoopWin32(PyObject *self, PyObject *args) {
 
 #define GET32(p, o) ((DWORD *)(p + o))[0]
 
-BOOL
+int
 enhMetaFileProc(
-    HDC hdc, HANDLETABLE FAR *lpht, CONST ENHMETARECORD *lpmr, int nHandles, LPARAM data
+    HDC hdc, HANDLETABLE *lpht, const ENHMETARECORD *lpmr, int nHandles, LPARAM data
 ) {
     PlayEnhMetaFileRecord(hdc, lpht, lpmr, nHandles);
-    return TRUE;
+    return 1;
 }
 
 PyObject *
@@ -804,7 +804,14 @@ PyImaging_DrawWmf(PyObject *self, PyObject *args) {
     /* FIXME: make background transparent? configurable? */
     FillRect(dc, &rect, GetStockObject(WHITE_BRUSH));
 
+#ifdef _WIN64
     EnumEnhMetaFile(dc, meta, enhMetaFileProc, NULL, &rect);
+#else
+    if (!PlayEnhMetaFile(dc, meta, &rect)) {
+        PyErr_SetString(PyExc_OSError, "cannot render metafile");
+        goto error;
+    }
+#endif
 
     /* step 4: extract bits from bitmap */
 

From 73600eea94bfb695c52f7746c3523b5ce332d567 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 29 Oct 2024 00:34:24 +1100
Subject: [PATCH 1224/2374] Detach PyQt6 QPixmap instance before returning

---
 .github/workflows/test-windows.yml | 6 ++++++
 src/PIL/ImageQt.py                 | 5 ++++-
 2 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index c8842e37b2c..f6d0aeb1d4a 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -80,6 +80,12 @@ jobs:
         pytest-cov
         pytest-timeout
 
+    - name: Install CPython dependencies
+      if: "!contains(matrix.python-version, 'pypy')"
+      run: >
+        python3 -m pip install
+        PyQt6
+
     - name: Install dependencies
       id: install
       run: |
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index a3d647138df..2cc40f85535 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -213,4 +213,7 @@ def toqimage(im: Image.Image | str | QByteArray) -> ImageQt:
 
 def toqpixmap(im: Image.Image | str | QByteArray) -> QPixmap:
     qimage = toqimage(im)
-    return getattr(QPixmap, "fromImage")(qimage)
+    pixmap = getattr(QPixmap, "fromImage")(qimage)
+    if qt_version == "6":
+        pixmap.detach()
+    return pixmap

From e5706a590b16fcfc2b826de19addc2e33d3c3508 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 29 Oct 2024 09:04:06 +1100
Subject: [PATCH 1225/2374] Upgraded multibuild to remove openjpeg lib64 copy

---
 .github/workflows/wheels-dependencies.sh | 3 ---
 wheels/multibuild                        | 2 +-
 2 files changed, 1 insertion(+), 4 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 7970d4d1525..3a80a7e741d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -91,9 +91,6 @@ function build {
     build_libpng
     build_lcms2
     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/wheels/multibuild b/wheels/multibuild
index 452dd2d1705..9a9d1275f02 160000
--- a/wheels/multibuild
+++ b/wheels/multibuild
@@ -1 +1 @@
-Subproject commit 452dd2d1705f6b2375369a6570c415beb3163f70
+Subproject commit 9a9d1275f025f737cdaa3c451ba07129dd95f361

From 08554684b3f382f3d729db5e6cd1fe94126dab66 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Tue, 29 Oct 2024 07:46:59 +0800
Subject: [PATCH 1226/2374] Revert fribidi/raqm changes for macOS builds.

---
 .github/workflows/wheels-dependencies.sh |  5 -----
 .github/workflows/wheels-test.sh         | 21 ++++++++++++++++-----
 pyproject.toml                           |  4 ++--
 setup.py                                 |  2 +-
 4 files changed, 19 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 9dae287170a..22084237118 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -155,11 +155,6 @@ function build {
     fi
 
     build_harfbuzz
-
-    if [ -n "$IS_MACOS" ]; then
-        build_simple fribidi $FRIBIDI_VERSION https://github.com/fribidi/fribidi/releases/download/v$FRIBIDI_VERSION tar.xz --enable-shared
-        build_raqm
-    fi
 }
 
 # Perform all dependency builds in the build subfolder.
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 3a8fc87ba1e..e671c8d45a8 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -1,13 +1,24 @@
 #!/bin/bash
 set -e
 
-# For Unix, ensure fribidi is installed by the system.
-if [[ "$OSTYPE" != "darwin"* ]]; then
-    if [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
-        apk add curl fribidi
+# Ensure fribidi is installed by the system.
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # If Homebrew is on the path during the build, it may leak into the wheels.
+    # However, we need a *do* need Homebrew to provide a copy of fribidi for
+    # testing purposes so that we can verify the fribidi shim works as expected.
+    if [[ "$(uname -m)" == "x86_64" ]]; then
+        HOMEBREW_HOME=/usr/local/homebrew
     else
-        yum install -y fribidi
+        HOMEBREW_HOME=/opt/homebrew
     fi
+    $HOMEBREW_HOME/bin/brew install fribidi
+
+    # Add the Homebrew lib folder so that vendored libraries can be found.
+    export DYLD_LIBRARY_PATH=$HOMEBREW_HOME/lib
+elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
+    apk add curl fribidi
+else
+    yum install -y fribidi
 fi
 
 python3 -m pip install numpy
diff --git a/pyproject.toml b/pyproject.toml
index 3839cf8402a..da8548dcbd3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -95,8 +95,8 @@ before-all = ".github/workflows/wheels-dependencies.sh"
 build-verbosity = 1
 
 config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
-# Add an explicit dependencies prefix for macOS, and don't request vendored libraries.
-macos.config-settings = "raqm=enable imagequant=disable dependencies-prefix=./build/deps"
+# Add an explicit dependencies prefix for macOS.
+macos.config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable dependencies-prefix=./build/deps"
 
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
diff --git a/setup.py b/setup.py
index 16c25cbda80..38d793b1412 100644
--- a/setup.py
+++ b/setup.py
@@ -454,7 +454,7 @@ def _remove_extension(self, name: str) -> None:
     def get_macos_sdk_path(self) -> str | None:
         try:
             sdk_path = (
-                subprocess.check_output(["xcrun", "--show-sdk-path"])
+                subprocess.check_output(["xcrun", "--show-sdk-path", "--sdk", "macosx"])
                 .strip()
                 .decode("latin1")
             )

From 8308bf361e7d4bac39b1710e4c3c0725c7ad07ac Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Tue, 29 Oct 2024 07:47:30 +0800
Subject: [PATCH 1227/2374] Bump multibuild to include more cmake changes.

---
 wheels/multibuild | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/wheels/multibuild b/wheels/multibuild
index 22e8ad0c69a..9a9d1275f02 160000
--- a/wheels/multibuild
+++ b/wheels/multibuild
@@ -1 +1 @@
-Subproject commit 22e8ad0c69acdb0c94abab74da6e09f2810d50d5
+Subproject commit 9a9d1275f025f737cdaa3c451ba07129dd95f361

From c74a5bdd85c3314fbdbbe2a72d17adad85fae5f0 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Tue, 29 Oct 2024 09:02:05 +0800
Subject: [PATCH 1228/2374] Correct paths used for Linux build.

---
 .github/workflows/wheels-dependencies.sh | 31 ++++--------------------
 pyproject.toml                           |  4 +++
 setup.py                                 |  3 +--
 3 files changed, 10 insertions(+), 28 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 22084237118..0eb15d55315 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -26,8 +26,6 @@ OPENJPEG_VERSION=2.5.2
 XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
-RAQM_VERSION=0.10.2
-FRIBIDI_VERSION=1.0.16
 if [[ -n "$IS_MACOS" ]]; then
     GIFLIB_VERSION=5.2.2
 else
@@ -63,12 +61,8 @@ 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-$BROTLI_VERSION.tar.gz)
     (cd $out_dir \
-        && $cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
+        && $cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
         && make install)
-    if [[ "$MB_ML_LIBC" == "manylinux" ]]; then
-        cp $BUILD_PREFIX/lib64/libbrotli* $BUILD_PREFIX/lib
-        cp $BUILD_PREFIX/lib64/pkgconfig/libbrotli* $BUILD_PREFIX/lib/pkgconfig
-    fi
     touch brotli-stamp
 }
 
@@ -78,27 +72,12 @@ function build_harfbuzz {
 
     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 --prefix=$BUILD_PREFIX --buildtype=release -Dfreetype=enabled -Dglib=disabled)
+        && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=release -Dfreetype=enabled -Dglib=disabled)
     (cd $out_dir/build \
         && meson install)
-    if [[ "$MB_ML_LIBC" == "manylinux" ]]; then
-        cp $BUILD_PREFIX/lib64/libharfbuzz* $BUILD_PREFIX/lib
-    fi
     touch harfbuzz-stamp
 }
 
-function build_raqm {
-    if [ -e raqm-stamp ]; then return; fi
-    python3 -m pip install meson ninja
-
-    local out_dir=$(fetch_unpack https://github.com/HOST-Oman/libraqm/releases/download/v$RAQM_VERSION/raqm-$RAQM_VERSION.tar.xz raqm-$RAQM_VERSION.tar.xz)
-    (cd $out_dir \
-        && meson setup build --prefix=$BUILD_PREFIX)
-    (cd $out_dir/build \
-        && meson install)
-    touch raqm-stamp
-}
-
 function build {
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$IS_MACOS" ]; then
@@ -133,9 +112,6 @@ function build {
     build_libpng
     build_lcms2
     build_openjpeg
-    if [ -f $BUILD_PREFIX/lib64/libopenjp2.so ]; then
-        cp $BUILD_PREFIX/lib64/libopenjp2.so $BUILD_PREFIX/lib
-    fi
 
     ORIGINAL_CFLAGS=$CFLAGS
     CFLAGS="$CFLAGS -O3 -DNDEBUG"
@@ -190,6 +166,9 @@ if [[ -n "$IS_MACOS" ]]; then
     build_pkg_config
     # Ensure cmake is available
     python3 -m pip install cmake
+else
+    # Ensure that any built libraries are on the linker path.
+    export LD_LIBRARY_PATH=$BUILD_PREFIX/lib
 fi
 
 wrap_wheel_builder build
diff --git a/pyproject.toml b/pyproject.toml
index da8548dcbd3..af3d0475750 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -104,6 +104,10 @@ test-extras = "tests"
 [tool.cibuildwheel.macos.environment]
 PATH = "$(pwd)/build/deps/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
 
+[tool.cibuildwheel.linux.environment]
+LD_LIBRARY_PATH = "$(pwd)/build/deps/lib"
+PKG_CONFIG_PATH = "$(pwd)/build/deps/lib/pkgconfig:$(pwd)/build/deps/share/pkgconfig"
+
 [tool.black]
 exclude = "wheels/multibuild"
 
diff --git a/setup.py b/setup.py
index 38d793b1412..d7e305fc0e1 100644
--- a/setup.py
+++ b/setup.py
@@ -131,7 +131,7 @@ def get_version() -> str:
     "codec_fd",
 )
 
-DEBUG = False
+DEBUG = True
 
 
 class DependencyException(Exception):
@@ -479,7 +479,6 @@ def build_extensions(self) -> None:
         pkg_config = None
         if _cmd_exists(os.environ.get("PKG_CONFIG", "pkg-config")):
             pkg_config = _pkg_config
-
         #
         # add configured kits
         for root_name, lib_name in {

From 72d81e24a81e6e765f21e5794218f080e7718ec7 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Tue, 29 Oct 2024 09:25:47 +0800
Subject: [PATCH 1229/2374] Simplify Linux config by correcting a logic error
 in macOS config.

---
 .github/workflows/wheels-dependencies.sh | 7 ++-----
 pyproject.toml                           | 4 ----
 2 files changed, 2 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 0eb15d55315..2e915364abb 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -4,8 +4,8 @@
 if [ -z "$IS_MACOS" ]; then
     export MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
     export MB_ML_VER=${AUDITWHEEL_POLICY:9}
-
-    # Build and install into the `build/deps` folder.
+else
+    # Build and install macOS builds into the `build/deps` folder.
     BUILD_PREFIX=$(pwd)/build/deps
 fi
 export PLAT=$CIBW_ARCHS
@@ -166,9 +166,6 @@ if [[ -n "$IS_MACOS" ]]; then
     build_pkg_config
     # Ensure cmake is available
     python3 -m pip install cmake
-else
-    # Ensure that any built libraries are on the linker path.
-    export LD_LIBRARY_PATH=$BUILD_PREFIX/lib
 fi
 
 wrap_wheel_builder build
diff --git a/pyproject.toml b/pyproject.toml
index af3d0475750..da8548dcbd3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -104,10 +104,6 @@ test-extras = "tests"
 [tool.cibuildwheel.macos.environment]
 PATH = "$(pwd)/build/deps/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
 
-[tool.cibuildwheel.linux.environment]
-LD_LIBRARY_PATH = "$(pwd)/build/deps/lib"
-PKG_CONFIG_PATH = "$(pwd)/build/deps/lib/pkgconfig:$(pwd)/build/deps/share/pkgconfig"
-
 [tool.black]
 exclude = "wheels/multibuild"
 

From ec214e4d7caa471c087e0d690b20d75b6dd929fc Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Tue, 29 Oct 2024 09:39:58 +0800
Subject: [PATCH 1230/2374] Can't check IS_MACOS until common_utils is invoked.

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 2e915364abb..9ce851f0f93 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -1,19 +1,21 @@
 #!/bin/bash
 # Define custom utilities
+export PLAT=$CIBW_ARCHS
+source wheels/multibuild/common_utils.sh
+source wheels/multibuild/library_builders.sh
+if [ -z "$IS_MACOS" ]; then
+    source wheels/multibuild/manylinux_utils.sh
+fi
+
 # Test for macOS with [ -n "$IS_MACOS" ]
+echo "IS MACOS: $IS_MACOS"
 if [ -z "$IS_MACOS" ]; then
     export MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
     export MB_ML_VER=${AUDITWHEEL_POLICY:9}
-else
+elseac
     # Build and install macOS builds into the `build/deps` folder.
     BUILD_PREFIX=$(pwd)/build/deps
 fi
-export PLAT=$CIBW_ARCHS
-source wheels/multibuild/common_utils.sh
-source wheels/multibuild/library_builders.sh
-if [ -z "$IS_MACOS" ]; then
-    source wheels/multibuild/manylinux_utils.sh
-fi
 
 ARCHIVE_SDIR=pillow-depends-main
 

From d1a4f8029b2d89f19e4652c96e3b1909b90aa5df Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Tue, 29 Oct 2024 09:54:15 +0800
Subject: [PATCH 1231/2374] Don't use multibuild variables before invoking
 multibuild.

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 9ce851f0f93..fd13930db46 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -1,4 +1,14 @@
 #!/bin/bash
+
+# Setup that needs to be done before multibuild utils are invoked
+if [[ "$(uname -s)" == "Darwin" ]]; then
+    # Build and install macOS builds into the `build/deps` folder.
+    BUILD_PREFIX=$(pwd)/build/deps
+else
+    export MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
+    export MB_ML_VER=${AUDITWHEEL_POLICY:9}
+fi
+
 # Define custom utilities
 export PLAT=$CIBW_ARCHS
 source wheels/multibuild/common_utils.sh
@@ -7,16 +17,6 @@ if [ -z "$IS_MACOS" ]; then
     source wheels/multibuild/manylinux_utils.sh
 fi
 
-# Test for macOS with [ -n "$IS_MACOS" ]
-echo "IS MACOS: $IS_MACOS"
-if [ -z "$IS_MACOS" ]; then
-    export MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
-    export MB_ML_VER=${AUDITWHEEL_POLICY:9}
-elseac
-    # Build and install macOS builds into the `build/deps` folder.
-    BUILD_PREFIX=$(pwd)/build/deps
-fi
-
 ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds

From 6d137043f712d6790eba835a8ec727e0a4fbb603 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Tue, 29 Oct 2024 10:01:46 +0800
Subject: [PATCH 1232/2374] Remove stray debug.

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

diff --git a/setup.py b/setup.py
index d7e305fc0e1..38d793b1412 100644
--- a/setup.py
+++ b/setup.py
@@ -131,7 +131,7 @@ def get_version() -> str:
     "codec_fd",
 )
 
-DEBUG = True
+DEBUG = False
 
 
 class DependencyException(Exception):
@@ -479,6 +479,7 @@ def build_extensions(self) -> None:
         pkg_config = None
         if _cmd_exists(os.environ.get("PKG_CONFIG", "pkg-config")):
             pkg_config = _pkg_config
+
         #
         # add configured kits
         for root_name, lib_name in {

From 2d1d801ec032bfb760bede88da6dcaab5ff3c75e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 29 Oct 2024 22:15:56 +1100
Subject: [PATCH 1233/2374] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 87945bc8456..9d45e2214ca 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.1.0 (unreleased)
 -------------------
 
+- Detach PyQt6 QPixmap instance before returning #8509
+  [radarhere]
+
 - Corrected EMF DPI #8485
   [radarhere]
 

From 624848ff97e438e5ae7bd239254edceaa2751af1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 29 Oct 2024 22:21:53 +1100
Subject: [PATCH 1234/2374] Do not repeatedly save to the same path

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

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 2c66652e5d2..c41a61f4bbb 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -543,10 +543,10 @@ def test_truncated_jpeg_throws_oserror(self) -> None:
     )
     def test_qtables(self, tmp_path: Path) -> None:
         def _n_qtables_helper(n: int, test_file: str) -> None:
+            b = BytesIO()
             with Image.open(test_file) as im:
-                f = str(tmp_path / "temp.jpg")
-                im.save(f, qtables=[[n] * 64] * n)
-            with Image.open(f) as im:
+                im.save(b, "JPEG", qtables=[[n] * 64] * n)
+            with Image.open(b) as im:
                 assert len(im.quantization) == n
                 reloaded = self.roundtrip(im, qtables="keep")
                 assert im.quantization == reloaded.quantization

From 80cf74030d533a5ebc8e921ae8094316123b6837 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 29 Oct 2024 23:13:01 +1100
Subject: [PATCH 1235/2374] Removed fixture

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

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index c41a61f4bbb..347a162a58e 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -541,7 +541,7 @@ def test_truncated_jpeg_throws_oserror(self) -> None:
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
     )
-    def test_qtables(self, tmp_path: Path) -> None:
+    def test_qtables(self) -> None:
         def _n_qtables_helper(n: int, test_file: str) -> None:
             b = BytesIO()
             with Image.open(test_file) as im:

From c6912f81ff20211c2638be64bc198024aa9a5b40 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Wed, 30 Oct 2024 05:43:23 +0800
Subject: [PATCH 1236/2374] Corrected typo in code comment.

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

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index e671c8d45a8..9bcf42458cc 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -4,7 +4,7 @@ set -e
 # Ensure fribidi is installed by the system.
 if [[ "$OSTYPE" == "darwin"* ]]; then
     # If Homebrew is on the path during the build, it may leak into the wheels.
-    # However, we need a *do* need Homebrew to provide a copy of fribidi for
+    # However, we *do* need Homebrew to provide a copy of fribidi for
     # testing purposes so that we can verify the fribidi shim works as expected.
     if [[ "$(uname -m)" == "x86_64" ]]; then
         HOMEBREW_HOME=/usr/local/homebrew

From 67c2e04f706f9f7f8efa6bd6437632ab8e546cae Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 30 Oct 2024 08:37:19 +0200
Subject: [PATCH 1237/2374] Add trove-classifiers>=2024.10.12 to 'tests' extra
 and use for Windows CI

---
 .github/workflows/test-windows.yml | 13 +------------
 pyproject.toml                     |  1 +
 2 files changed, 2 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index f6d0aeb1d4a..4ac6f8769a5 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -69,17 +69,6 @@ jobs:
     - name: Print build system information
       run: python3 .github/workflows/system-info.py
 
-    - name: Install Python dependencies
-      run: >
-        python3 -m pip install
-        coverage>=7.4.2
-        defusedxml
-        olefile
-        pyroma
-        pytest
-        pytest-cov
-        pytest-timeout
-
     - name: Install CPython dependencies
       if: "!contains(matrix.python-version, 'pypy')"
       run: >
@@ -184,7 +173,7 @@ jobs:
     - name: Build Pillow
       run: |
         $FLAGS="-C raqm=vendor -C fribidi=vendor"
-        cmd /c "winbuild\build\build_env.cmd && $env:pythonLocation\python.exe -m pip install -v $FLAGS ."
+        cmd /c "winbuild\build\build_env.cmd && $env:pythonLocation\python.exe -m pip install -v $FLAGS .[tests]"
         & $env:pythonLocation\python.exe selftest.py --installed
       shell: pwsh
 
diff --git a/pyproject.toml b/pyproject.toml
index c55be769341..45d5c269261 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -65,6 +65,7 @@ optional-dependencies.tests = [
   "pytest",
   "pytest-cov",
   "pytest-timeout",
+  "trove-classifiers>=2024.10.12",
 ]
 optional-dependencies.typing = [
   "typing-extensions; python_version<'3.10'",

From 0bf15f0f2a856907bf925fc797a107a33069b734 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 30 Oct 2024 22:24:37 +0200
Subject: [PATCH 1238/2374] Upgrade pip

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 4ac6f8769a5..728182b1ec1 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -71,9 +71,9 @@ jobs:
 
     - name: Install CPython dependencies
       if: "!contains(matrix.python-version, 'pypy')"
-      run: >
-        python3 -m pip install
-        PyQt6
+      run: |
+        python3 -m pip install --upgrade pip
+        python3 -m pip install PyQt6
 
     - name: Install dependencies
       id: install

From 01270b5859800355b12fa4403c7684d9bf72c6f5 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Thu, 31 Oct 2024 06:27:54 +0800
Subject: [PATCH 1239/2374] Use the intended entry point for the x86_64 brew
 binary.

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

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 9bcf42458cc..e2ef337119e 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -7,7 +7,7 @@ if [[ "$OSTYPE" == "darwin"* ]]; then
     # However, we *do* need Homebrew to provide a copy of fribidi for
     # testing purposes so that we can verify the fribidi shim works as expected.
     if [[ "$(uname -m)" == "x86_64" ]]; then
-        HOMEBREW_HOME=/usr/local/homebrew
+        HOMEBREW_HOME=/usr/local
     else
         HOMEBREW_HOME=/opt/homebrew
     fi

From 51e36230660667df38c68379314b652b34da47e5 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Thu, 31 Oct 2024 09:50:38 +0800
Subject: [PATCH 1240/2374] Revert x86_64 homebrew location change (with
 explanation).

---
 .github/workflows/wheels-test.sh | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index e2ef337119e..b697b740ec0 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -7,7 +7,10 @@ if [[ "$OSTYPE" == "darwin"* ]]; then
     # However, we *do* need Homebrew to provide a copy of fribidi for
     # testing purposes so that we can verify the fribidi shim works as expected.
     if [[ "$(uname -m)" == "x86_64" ]]; then
-        HOMEBREW_HOME=/usr/local
+        # Use the "installed" location, rather than /usr/local, for two reasons:
+        # firstly, Homebrew allows libraries to be *installed*, but not linked;
+        # and secondly, we don't want any *other* leakage from /usr/local.
+        HOMEBREW_HOME=/usr/local/Homebrew
     else
         HOMEBREW_HOME=/opt/homebrew
     fi

From aae90c3c016ee36b838d1ca5d522301d98731261 Mon Sep 17 00:00:00 2001
From: "Pietro F. Fontana" <cubanpit@users.noreply.github.com>
Date: Fri, 1 Nov 2024 15:42:08 +0100
Subject: [PATCH 1241/2374] Allow linking to shared zlib

If compiled as shared library zlib produces `zlib1.dll` and `zdll.lib`.
---
 setup.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/setup.py b/setup.py
index def3417845d..48863c3974e 100644
--- a/setup.py
+++ b/setup.py
@@ -690,6 +690,8 @@ def build_extensions(self) -> None:
                     feature.set("zlib", "z")
                 elif sys.platform == "win32" and _find_library_file(self, "zlib"):
                     feature.set("zlib", "zlib")  # alternative name
+                elif sys.platform == "win32" and _find_library_file(self, "zdll"):
+                    feature.set("zlib", "zdll")  # different name if shared
 
         if feature.want("jpeg"):
             _dbg("Looking for jpeg")

From 71016f23b4b441536a5c713d3cad53e2870655fb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Nov 2024 17:51:01 +1100
Subject: [PATCH 1242/2374] Added Fedora 41

---
 .github/workflows/test-docker.yml      | 1 +
 docs/installation/platform-support.rst | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 880fe3eea24..5bfbe1bdbc2 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -47,6 +47,7 @@ jobs:
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
           fedora-40-amd64,
+          fedora-41-amd64,
           gentoo,
           ubuntu-22.04-jammy-amd64,
           ubuntu-24.04-noble-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 21ebd1ad520..da6763736f1 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -31,6 +31,8 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Fedora 40                        | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
+| Fedora 41                        | 3.13                       | x86-64              |
++----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 13 Ventura                 | 3.9                        | x86-64              |

From 141e8d25462cfaa56e6d707b704c832b950b86bf Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 2 Nov 2024 12:08:23 +0200
Subject: [PATCH 1243/2374] Remove unused 'gcov: true' for codecov-action@v4

---
 .github/workflows/test-docker.yml | 1 -
 .github/workflows/test.yml        | 1 -
 2 files changed, 2 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 5bfbe1bdbc2..101807745e5 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -102,7 +102,6 @@ jobs:
       with:
         flags: GHA_Docker
         name: ${{ matrix.docker }}
-        gcov: true
         token: ${{ secrets.CODECOV_ORG_TOKEN }}
 
   success:
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 6576292b5e4..29949f4e0ab 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -158,7 +158,6 @@ jobs:
       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:

From 6fe7160cb97f13a93735a365ff33b5f388d8067d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Sat, 2 Nov 2024 14:03:53 +0100
Subject: [PATCH 1244/2374] Update Windows 11 Arm64 tested 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 21ebd1ad520..d8671ee140a 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -146,7 +146,7 @@ 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.2.0           |arm64         |
+| Windows 11 23H2                  | 3.9, 3.10, 3.11, 3.12, 3.13| 11.0.0           |arm64         |
 +----------------------------------+----------------------------+------------------+--------------+
 | Windows 11 Pro                   | 3.11, 3.12                 | 10.2.0           |x86-64        |
 +----------------------------------+----------------------------+------------------+--------------+

From 327e13ffd0d4999fb9cd63d12407f08f20710677 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 6 Oct 2024 00:57:58 +0300
Subject: [PATCH 1245/2374] Stop testing on AppVeyor

---
 .appveyor.yml           | 99 -----------------------------------------
 .github/CONTRIBUTING.md |  4 +-
 .github/mergify.yml     |  1 -
 MANIFEST.in             |  1 -
 README.md               |  3 --
 RELEASING.md            |  4 +-
 Tests/helper.py         |  9 ----
 docs/about.rst          |  3 +-
 docs/index.rst          |  4 --
 winbuild/README.md      |  4 +-
 winbuild/build.rst      |  4 +-
 11 files changed, 9 insertions(+), 127 deletions(-)
 delete mode 100644 .appveyor.yml

diff --git a/.appveyor.yml b/.appveyor.yml
deleted file mode 100644
index 781ad4a4b1d..00000000000
--- a/.appveyor.yml
+++ /dev/null
@@ -1,99 +0,0 @@
-skip_commits:
-  files:
-    - ".github/**/*"
-    - ".gitmodules"
-    - "docs/**/*"
-    - "wheels/**/*"
-
-version: '{build}'
-clone_folder: c:\pillow
-init:
-- ECHO %PYTHON%
-#- ps: iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/appveyor/ci/master/scripts/enable-rdp.ps1'))
-# Uncomment previous line to get RDP access during the build.
-
-environment:
-  COVERAGE_CORE: sysmon
-  EXECUTABLE: python.exe
-  TEST_OPTIONS:
-  DEPLOY: YES
-  matrix:
-  - PYTHON: C:/Python313
-    ARCHITECTURE: x86
-    APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2022
-  - PYTHON: C:/Python39-x64
-    ARCHITECTURE: AMD64
-    APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
-
-
-install:
-- '%PYTHON%\%EXECUTABLE% --version'
-- '%PYTHON%\%EXECUTABLE% -m pip install --upgrade pip'
-- 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.03-win64.zip
-- 7z x nasm-win64.zip -oc:\
-- 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\
-        c:\pillow\winbuild\build\build_dep_all.cmd
-        $host.SetShouldExit(0)
-- path C:\pillow\winbuild\build\bin;%PATH%
-
-build_script:
-- cd c:\pillow
-- winbuild\build\build_env.cmd
-- '%PYTHON%\%EXECUTABLE% -m pip install -v -C raqm=vendor -C fribidi=vendor .'
-- '%PYTHON%\%EXECUTABLE% selftest.py --installed'
-
-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%
-- path %PYTHON%;%PATH%
-- .ci\test.cmd
-
-after_test:
-- curl -Os https://uploader.codecov.io/latest/windows/codecov.exe
-- .\codecov.exe --file coverage.xml --name %PYTHON% --flags AppVeyor
-
-matrix:
-  fast_finish: true
-
-cache:
-- '%LOCALAPPDATA%\pip\Cache'
-
-artifacts:
-- path: pillow\*.egg
-  name: egg
-- path: pillow\*.whl
-  name: wheel
-
-before_deploy:
-  - cd c:\pillow
-  - '%PYTHON%\%EXECUTABLE% -m pip wheel -v -C raqm=vendor -C fribidi=vendor .'
-  - ps: Get-ChildItem .\*.whl | % { Push-AppveyorArtifact $_.FullName -FileName $_.Name }
-
-deploy:
-  provider: S3
-  region: us-west-2
-  access_key_id: AKIAIRAXC62ZNTVQJMOQ
-  secret_access_key:
-    secure: Hwb6klTqtBeMgxAjRoDltiiqpuH8xbwD4UooDzBSiCWXjuFj1lyl4kHgHwTCCGqi
-  bucket: pillow-nightly
-  folder: win/$(APPVEYOR_BUILD_NUMBER)/
-  artifact: /.*egg|wheel/
-  on:
-    APPVEYOR_REPO_NAME: python-pillow/Pillow
-    branch: main
-    deploy: YES
-
-
-# Uncomment the following lines to get RDP access after the build/test and block for
-# up to the timeout limit (~1hr)
-#
-#on_finish:
-#- ps: $blockRdp = $true; iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/appveyor/ci/master/scripts/enable-rdp.ps1'))
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index d03fcf0d9da..c372da7d223 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -9,7 +9,7 @@ Please send a pull request to the `main` branch. Please include [documentation](
 - Fork the Pillow repository.
 - Create a branch from `main`.
 - Develop bug fixes, features, tests, etc.
-- Run the test suite. You can enable GitHub Actions (https://github.com/MY-USERNAME/Pillow/actions) and [AppVeyor](https://ci.appveyor.com/projects/new) on your repo to catch test failures prior to the pull request, and [Codecov](https://codecov.io/gh) to see if the changed code is covered by tests.
+- Run the test suite. You can enable GitHub Actions (https://github.com/MY-USERNAME/Pillow/actions) on your repo to catch test failures prior to the pull request, and [Codecov](https://codecov.io/gh) to see if the changed code is covered by tests.
 - Create a pull request to pull the changes from your branch to the Pillow `main`.
 
 ### Guidelines
@@ -17,7 +17,7 @@ Please send a pull request to the `main` branch. Please include [documentation](
 - Separate code commits from reformatting commits.
 - Provide tests for any newly added code.
 - Follow PEP 8.
-- When committing only documentation changes please include `[ci skip]` in the commit message to avoid running tests on AppVeyor.
+- When committing only documentation changes please include `[ci skip]` in the commit message to avoid running extra tests.
 - Include [release notes](https://github.com/python-pillow/Pillow/tree/main/docs/releasenotes) as needed or appropriate with your bug fixes, feature additions and tests.
 - Do not add to the [changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst) for proposed changes, as that is updated after changes are merged.
 
diff --git a/.github/mergify.yml b/.github/mergify.yml
index 3c20661376f..9bb089615be 100644
--- a/.github/mergify.yml
+++ b/.github/mergify.yml
@@ -9,7 +9,6 @@ pull_request_rules:
       - status-success=Windows Test Successful
       - status-success=MinGW
       - status-success=Cygwin Test Successful
-      - status-success=continuous-integration/appveyor/pr
     actions:
       merge:
         method: merge
diff --git a/MANIFEST.in b/MANIFEST.in
index af25dfd2db5..48085b82ed0 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -20,7 +20,6 @@ graft docs
 graft _custom_build
 
 # build/src control detritus
-exclude .appveyor.yml
 exclude .clang-format
 exclude .coveragerc
 exclude .editorconfig
diff --git a/README.md b/README.md
index 5bbebaccb4a..c6e61453f4a 100644
--- a/README.md
+++ b/README.md
@@ -42,9 +42,6 @@ As of 2019, Pillow development is
             <a href="https://github.com/python-pillow/Pillow/actions/workflows/test-docker.yml"><img
                 alt="GitHub Actions build status (Test Docker)"
                 src="https://github.com/python-pillow/Pillow/workflows/Test%20Docker/badge.svg"></a>
-            <a href="https://ci.appveyor.com/project/python-pillow/Pillow"><img
-                alt="AppVeyor CI build status (Windows)"
-                src="https://img.shields.io/appveyor/build/python-pillow/Pillow/main.svg?label=Windows%20build"></a>
             <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>
diff --git a/RELEASING.md b/RELEASING.md
index 9e6ec5dd4c1..490f6d6bd16 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -9,7 +9,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 [GitHub Actions](https://github.com/python-pillow/Pillow/actions) to confirm passing tests in `main` branch.
 * [ ] 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`.
@@ -40,7 +40,7 @@ Released as needed for security, installation or critical bug fixes.
   git checkout -t remotes/origin/5.2.x
   ```
 * [ ] Cherry pick individual commits from `main` branch to release branch e.g. `5.2.x`, then `git push`.
-* [ ] 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 release branch e.g. `5.2.x`.
+* [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) to confirm passing tests in release branch e.g. `5.2.x`.
 * [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/), update version identifier in `src/PIL/_version.py`
 * [ ] Run pre-release check via `make release-test`.
 * [ ] Create tag for release e.g.:
diff --git a/Tests/helper.py b/Tests/helper.py
index d6a93a8030b..cf1ef199768 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -327,16 +327,7 @@ def magick_command() -> list[str] | None:
     return None
 
 
-def on_appveyor() -> bool:
-    return "APPVEYOR" in os.environ
-
-
-def on_github_actions() -> bool:
-    return "GITHUB_ACTIONS" in os.environ
-
-
 def on_ci() -> bool:
-    # GitHub Actions and AppVeyor have "CI"
     return "CI" in os.environ
 
 
diff --git a/docs/about.rst b/docs/about.rst
index c51ddebd081..7df895b8ffc 100644
--- a/docs/about.rst
+++ b/docs/about.rst
@@ -6,12 +6,11 @@ Goals
 
 The fork author's goal is to foster and support active development of PIL through:
 
-- Continuous integration testing via `GitHub Actions`_ and `AppVeyor`_
+- Continuous integration testing via `GitHub Actions`_
 - 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
 .. _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 18f5c3d13e7..689088d48ce 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -33,10 +33,6 @@ Pillow for enterprise is available via the Tidelift Subscription. `Learn more <h
    :target: https://github.com/python-pillow/Pillow/actions/workflows/test-cygwin.yml
    :alt: GitHub Actions build status (Test Cygwin)
 
-.. image:: https://img.shields.io/appveyor/build/python-pillow/Pillow/main.svg?label=Windows%20build
-   :target: https://ci.appveyor.com/project/python-pillow/Pillow
-   :alt: AppVeyor CI build status (Windows)
-
 .. image:: https://github.com/python-pillow/Pillow/workflows/Wheels/badge.svg
    :target: https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml
    :alt: GitHub Actions build status (Wheels)
diff --git a/winbuild/README.md b/winbuild/README.md
index f6111c79b0e..0d3ec8d8aa4 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -11,10 +11,10 @@ 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 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:
+Here's an example script to build on Windows:
+
 ```
 set PYTHON=C:\Python39\bin
 cd /D C:\Pillow\winbuild
diff --git a/winbuild/build.rst b/winbuild/build.rst
index 96b8803b477..aae78ce1237 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -6,7 +6,7 @@ Building Pillow on Windows
           be sufficient.
 
 This page describes the steps necessary to build Pillow using the same
-scripts used on GitHub Actions and AppVeyor CIs.
+scripts used on GitHub Actions CI.
 
 Prerequisites
 -------------
@@ -112,7 +112,7 @@ directory.
 Example
 -------
 
-The following is a simplified version of the script used on AppVeyor::
+Here's an example script to build on Windows::
 
     set PYTHON=C:\Python39\bin
     cd /D C:\Pillow\winbuild

From 1c4f29f2ce7e0537ca4f7a1a9691e5a1dcb909da Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 6 Oct 2024 20:16:55 +0300
Subject: [PATCH 1246/2374] Test the oldest Python on 32-bit Windows 2019

---
 .github/workflows/test-windows.yml     | 14 ++++++++++----
 docs/installation/platform-support.rst |  4 +---
 2 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index f6d0aeb1d4a..2e76c05aeec 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -31,15 +31,20 @@ env:
 
 jobs:
   build:
-    runs-on: windows-latest
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["pypy3.10", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["pypy3.10", "3.10", "3.11", "3.12", "3.13"]
+        architecture: ["x64"]
+        os: ["windows-latest"]
+        include:
+            # Test the oldest Python on 32-bit
+            - { python-version: "3.9", architecture: "x86", os: "windows-2019" }
 
     timeout-minutes: 30
 
-    name: Python ${{ matrix.python-version }}
+    name: Python ${{ matrix.python-version }} (${{ matrix.architecture }})
 
     steps:
     - name: Checkout Pillow
@@ -63,6 +68,7 @@ jobs:
       with:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true
+        architecture: ${{ matrix.architecture }}
         cache: pip
         cache-dependency-path: ".github/workflows/test-windows.yml"
 
@@ -81,7 +87,7 @@ jobs:
         pytest-timeout
 
     - name: Install CPython dependencies
-      if: "!contains(matrix.python-version, 'pypy')"
+      if: "!contains(matrix.python-version, 'pypy') && matrix.architecture != 'x86'"
       run: >
         python3 -m pip install
         PyQt6
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index a0bada7b428..cd196e4f802 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -48,13 +48,11 @@ These platforms are built and tested for every change.
 | Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, ppc64le,    |
 |                                  |                            | s390x               |
 +----------------------------------+----------------------------+---------------------+
-| Windows Server 2019              | 3.9                        | x86-64              |
+| Windows Server 2019              | 3.9                        | x86                 |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2022              | 3.9, 3.10, 3.11,           | x86-64              |
 |                                  | 3.12, 3.13, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
-|                                  | 3.13                       | x86                 |
-|                                  +----------------------------+---------------------+
 |                                  | 3.9 (MinGW)                | x86-64              |
 |                                  +----------------------------+---------------------+
 |                                  | 3.9 (Cygwin)               | x86-64              |

From 9faf598c890ced5828ba13ac7f5445b4310fff0c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 2 Nov 2024 23:29:56 +0200
Subject: [PATCH 1247/2374] Fix warning[artipacked]: credential persistence
 through GitHub Actions artifacts

---
 .github/workflows/docs.yml          | 2 ++
 .github/workflows/lint.yml          | 2 ++
 .github/workflows/test-cygwin.yml   | 2 ++
 .github/workflows/test-docker.yml   | 2 ++
 .github/workflows/test-mingw.yml    | 2 ++
 .github/workflows/test-valgrind.yml | 2 ++
 .github/workflows/test-windows.yml  | 4 ++++
 .github/workflows/test.yml          | 2 ++
 .github/workflows/wheels.yml        | 7 +++++++
 9 files changed, 25 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 92e860cb547..626824f3830 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -33,6 +33,8 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
 
     - name: Set up Python
       uses: actions/setup-python@v5
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index cc4760288e5..8e789a73489 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -21,6 +21,8 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
 
     - name: pre-commit cache
       uses: actions/cache@v4
diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 0aa79e4235a..656054e8924 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -48,6 +48,8 @@ jobs:
 
       - name: Checkout Pillow
         uses: actions/checkout@v4
+        with:
+          persist-credentials: false
 
       - name: Install Cygwin
         uses: cygwin/cygwin-install-action@v4
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 101807745e5..03608319a60 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -65,6 +65,8 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
 
     - name: Build system information
       run: python3 .github/workflows/system-info.py
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index c7a73439ca9..bfd393db5a2 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -46,6 +46,8 @@ jobs:
     steps:
       - name: Checkout Pillow
         uses: actions/checkout@v4
+        with:
+          persist-credentials: false
 
       - name: Set up shell
         run: echo "C:\msys64\usr\bin\" >> $env:GITHUB_PATH
diff --git a/.github/workflows/test-valgrind.yml b/.github/workflows/test-valgrind.yml
index 63aec586b79..8818b3b2357 100644
--- a/.github/workflows/test-valgrind.yml
+++ b/.github/workflows/test-valgrind.yml
@@ -40,6 +40,8 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
 
     - name: Build system information
       run: python3 .github/workflows/system-info.py
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index f6d0aeb1d4a..c1ba52719ae 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -44,16 +44,20 @@ jobs:
     steps:
     - name: Checkout Pillow
       uses: actions/checkout@v4
+      with:
+        persist-credentials: false
 
     - name: Checkout cached dependencies
       uses: actions/checkout@v4
       with:
+        persist-credentials: false
         repository: python-pillow/pillow-depends
         path: winbuild\depends
 
     - name: Checkout extra test images
       uses: actions/checkout@v4
       with:
+        persist-credentials: false
         repository: python-pillow/test-images
         path: Tests\test-images
 
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 29949f4e0ab..87acd7ddbc0 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -63,6 +63,8 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
 
     - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 34452fa563c..45f18634100 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -61,6 +61,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
+          persist-credentials: false
           submodules: true
 
       - uses: actions/setup-python@v5
@@ -132,6 +133,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
+          persist-credentials: false
           submodules: true
 
       - uses: actions/setup-python@v5
@@ -173,10 +175,13 @@ jobs:
           - cibw_arch: ARM64
     steps:
       - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
 
       - name: Checkout extra test images
         uses: actions/checkout@v4
         with:
+          persist-credentials: false
           repository: python-pillow/test-images
           path: Tests\test-images
 
@@ -253,6 +258,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
 
     - name: Set up Python
       uses: actions/setup-python@v5

From d3db931f21bcaa723071c7b4d669eead0fbdabab Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 2 Nov 2024 23:31:21 +0200
Subject: [PATCH 1248/2374] Fix error[excessive-permissions]: overly broad
 workflow or job-level permissions

---
 .github/workflows/stale.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index 545c2e3644a..61ccf58e2ea 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -6,7 +6,7 @@ on:
   workflow_dispatch:
 
 permissions:
-  issues: write
+  contents: read
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -15,6 +15,8 @@ concurrency:
 jobs:
   stale:
     if: github.repository_owner == 'python-pillow'
+    permissions:
+      issues: write
 
     runs-on: ubuntu-latest
 

From 924df0ac5c44815b397f375c7bed7a69ba02b956 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 3 Nov 2024 23:22:57 +0000
Subject: [PATCH 1249/2374] Migrate config .github/renovate.json

---
 .github/renovate.json | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/.github/renovate.json b/.github/renovate.json
index d1d82433553..f48b670ecdc 100644
--- a/.github/renovate.json
+++ b/.github/renovate.json
@@ -1,7 +1,7 @@
 {
     "$schema": "https://docs.renovatebot.com/renovate-schema.json",
     "extends": [
-        "config:base"
+        "config:recommended"
     ],
     "labels": [
         "Dependency"
@@ -9,9 +9,13 @@
     "packageRules": [
         {
             "groupName": "github-actions",
-            "matchManagers": ["github-actions"],
-            "separateMajorMinor": "false"
+            "matchManagers": [
+                "github-actions"
+            ],
+            "separateMajorMinor": false
         }
     ],
-    "schedule": ["on the 3rd day of the month"]
+    "schedule": [
+        "on the 3rd day of the month"
+    ]
 }

From 37679c8673e44f31be060ff7bc6772c7f178bee7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 4 Nov 2024 20:55:00 +1100
Subject: [PATCH 1250/2374] Pass IFDs to libtiff as TIFF_LONG8

---
 src/PIL/TiffImagePlugin.py | 4 +++-
 src/encode.c               | 8 ++++++--
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 6bf39b75a5f..c95b65b8ea2 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1915,7 +1915,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                 if not getattr(Image.core, "libtiff_support_custom_tags", False):
                     continue
 
-                if tag in ifd.tagtype:
+                if tag in TiffTags.TAGS_V2_GROUPS:
+                    types[tag] = TiffTags.LONG8
+                elif tag in ifd.tagtype:
                     types[tag] = ifd.tagtype[tag]
                 elif not (isinstance(value, (int, float, str, bytes))):
                     continue
diff --git a/src/encode.c b/src/encode.c
index 1a4cd489da2..09a86a7151c 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -736,7 +736,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
             }
             if (tag_type) {
                 int type_int = PyLong_AsLong(tag_type);
-                if (type_int >= TIFF_BYTE && type_int <= TIFF_DOUBLE) {
+                if (type_int >= TIFF_BYTE && type_int <= TIFF_LONG8) {
                     type = (TIFFDataType)type_int;
                 }
             }
@@ -929,7 +929,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 );
             } else if (type == TIFF_LONG) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, PyLong_AsLongLong(value)
+                    &encoder->state, (ttag_t)key_int, (UINT32)PyLong_AsLong(value)
                 );
             } else if (type == TIFF_SSHORT) {
                 status = ImagingLibTiffSetField(
@@ -959,6 +959,10 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, (FLOAT64)PyFloat_AsDouble(value)
                 );
+            } else if (type == TIFF_LONG8) {
+                status = ImagingLibTiffSetField(
+                    &encoder->state, (ttag_t)key_int, PyLong_AsLongLong(value)
+                );
             } else {
                 TRACE(
                     ("Unhandled type for key %d : %s \n",

From 4b7f6a6eb083b3c112f4713cd1fb74bd93ee3e7c Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 4 Nov 2024 17:35:35 +0000
Subject: [PATCH 1251/2374] [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.9 → v0.7.2](https://github.com/astral-sh/ruff-pre-commit/compare/v0.6.9...v0.7.2)
- [github.com/psf/black-pre-commit-mirror: 24.8.0 → 24.10.0](https://github.com/psf/black-pre-commit-mirror/compare/24.8.0...24.10.0)
- [github.com/pre-commit/mirrors-clang-format: v19.1.1 → v19.1.3](https://github.com/pre-commit/mirrors-clang-format/compare/v19.1.1...v19.1.3)
- [github.com/python-jsonschema/check-jsonschema: 0.29.3 → 0.29.4](https://github.com/python-jsonschema/check-jsonschema/compare/0.29.3...0.29.4)
- [github.com/tox-dev/pyproject-fmt: 2.2.4 → v2.5.0](https://github.com/tox-dev/pyproject-fmt/compare/2.2.4...v2.5.0)
- [github.com/abravalheri/validate-pyproject: v0.20.2 → v0.22](https://github.com/abravalheri/validate-pyproject/compare/v0.20.2...v0.22)
---
 .pre-commit-config.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 6254b89416f..ddc98fdc356 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.6.9
+    rev: v0.7.2
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.8.0
+    rev: 24.10.0
     hooks:
       - id: black
 
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v19.1.1
+    rev: v19.1.3
     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.29.3
+    rev: 0.29.4
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
@@ -62,12 +62,12 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 2.2.4
+    rev: v2.5.0
     hooks:
       - id: pyproject-fmt
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.20.2
+    rev: v0.22
     hooks:
       - id: validate-pyproject
         additional_dependencies: [trove-classifiers>=2024.10.12]

From 5628213ab03b59e2a70087c65cf4f05aa8de8cdf Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 4 Nov 2024 21:17:47 +0200
Subject: [PATCH 1252/2374] Upgrade pip for all

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 728182b1ec1..9fcb8cb94c1 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -69,10 +69,13 @@ jobs:
     - name: Print build system information
       run: python3 .github/workflows/system-info.py
 
+    - name: Upgrade pip
+      run: |
+        python3 -m pip install --upgrade pip
+
     - name: Install CPython dependencies
       if: "!contains(matrix.python-version, 'pypy')"
       run: |
-        python3 -m pip install --upgrade pip
         python3 -m pip install PyQt6
 
     - name: Install dependencies

From 607acbf95e8ee0a5900d3406324bffc77e02b49a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 07:05:39 +1100
Subject: [PATCH 1253/2374] Allow window to be supplied for ImageGrab.grab() on
 Windows

---
 Tests/test_imagegrab.py      |  5 +++++
 docs/reference/ImageGrab.rst |  5 +++++
 src/PIL/ImageGrab.py         | 11 ++++++++-
 src/display.c                | 43 ++++++++++++++++++++++++++++++------
 4 files changed, 56 insertions(+), 8 deletions(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 5cd510751e2..032dac8ccec 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -57,6 +57,11 @@ def test_grab_invalid_xdisplay(self) -> None:
             ImageGrab.grab(xdisplay="error.test:0.0")
         assert str(e.value).startswith("X connection failed")
 
+    @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
+    def test_grab_invalid_handle(self) -> None:
+        with pytest.raises(OSError):
+            ImageGrab.grab(window=-1)
+
     def test_grabclipboard(self) -> None:
         if sys.platform == "darwin":
             subprocess.call(["screencapture", "-cx"])
diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index db2987eb081..6435e1a0cee 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -39,6 +39,11 @@ or the clipboard to a PIL image memory.
         You can check X11 support using :py:func:`PIL.features.check_feature` with ``feature="xcb"``.
 
         .. versionadded:: 7.1.0
+
+    :param handle:
+        HWND, to capture a single window. Windows only.
+
+        .. versionadded:: 11.1.0
     :return: An image
 
 .. py:function:: grabclipboard()
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index e27ca7e5033..4dcaaa6c309 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -22,15 +22,20 @@
 import subprocess
 import sys
 import tempfile
+from typing import TYPE_CHECKING
 
 from . import Image
 
+if TYPE_CHECKING:
+    from . import ImageWin
+
 
 def grab(
     bbox: tuple[int, int, int, int] | None = None,
     include_layered_windows: bool = False,
     all_screens: bool = False,
     xdisplay: str | None = None,
+    window: int | ImageWin.HWND | None = None,
 ) -> Image.Image:
     im: Image.Image
     if xdisplay is None:
@@ -51,8 +56,12 @@ def grab(
                 return im_resized
             return im
         elif sys.platform == "win32":
+            if window is not None:
+                all_screens = -1
             offset, size, data = Image.core.grabscreen_win32(
-                include_layered_windows, all_screens
+                include_layered_windows,
+                all_screens,
+                int(window) if window is not None else 0,
             )
             im = Image.frombytes(
                 "RGB",
diff --git a/src/display.c b/src/display.c
index b4e2e38991a..30b7ada11bc 100644
--- a/src/display.c
+++ b/src/display.c
@@ -320,25 +320,36 @@ typedef HANDLE(__stdcall *Func_SetThreadDpiAwarenessContext)(HANDLE);
 
 PyObject *
 PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
-    int x = 0, y = 0, width, height;
-    int includeLayeredWindows = 0, all_screens = 0;
+    int x = 0, y = 0, width = -1, height;
+    int includeLayeredWindows = 0, screens = 0;
     HBITMAP bitmap;
     BITMAPCOREHEADER core;
     HDC screen, screen_copy;
+    HWND wnd;
     DWORD rop;
     PyObject *buffer;
     HANDLE dpiAwareness;
     HMODULE user32;
     Func_SetThreadDpiAwarenessContext SetThreadDpiAwarenessContext_function;
 
-    if (!PyArg_ParseTuple(args, "|ii", &includeLayeredWindows, &all_screens)) {
+    if (!PyArg_ParseTuple(
+            args, "|ii" F_HANDLE, &includeLayeredWindows, &screens, &wnd
+        )) {
         return NULL;
     }
 
     /* step 1: create a memory DC large enough to hold the
        entire screen */
 
-    screen = CreateDC("DISPLAY", NULL, NULL, NULL);
+    if (screens == -1) {
+        screen = GetDC(wnd);
+        if (screen == NULL) {
+            PyErr_SetString(PyExc_OSError, "unable to get device context for handle");
+            return NULL;
+        }
+    } else {
+        screen = CreateDC("DISPLAY", NULL, NULL, NULL);
+    }
     screen_copy = CreateCompatibleDC(screen);
 
     // added in Windows 10 (1607)
@@ -351,11 +362,17 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
         dpiAwareness = SetThreadDpiAwarenessContext_function((HANDLE)-3);
     }
 
-    if (all_screens) {
+    if (screens == 1) {
         x = GetSystemMetrics(SM_XVIRTUALSCREEN);
         y = GetSystemMetrics(SM_YVIRTUALSCREEN);
         width = GetSystemMetrics(SM_CXVIRTUALSCREEN);
         height = GetSystemMetrics(SM_CYVIRTUALSCREEN);
+    } else if (screens == -1) {
+        RECT rect;
+        if (GetClientRect(wnd, &rect)) {
+            width = rect.right;
+            height = rect.bottom;
+        }
     } else {
         width = GetDeviceCaps(screen, HORZRES);
         height = GetDeviceCaps(screen, VERTRES);
@@ -367,6 +384,10 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
 
     FreeLibrary(user32);
 
+    if (width == -1) {
+        goto error;
+    }
+
     bitmap = CreateCompatibleBitmap(screen, width, height);
     if (!bitmap) {
         goto error;
@@ -412,7 +433,11 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
 
     DeleteObject(bitmap);
     DeleteDC(screen_copy);
-    DeleteDC(screen);
+    if (screens == -1) {
+        ReleaseDC(wnd, screen);
+    } else {
+        DeleteDC(screen);
+    }
 
     return Py_BuildValue("(ii)(ii)N", x, y, width, height, buffer);
 
@@ -420,7 +445,11 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
     PyErr_SetString(PyExc_OSError, "screen grab failed");
 
     DeleteDC(screen_copy);
-    DeleteDC(screen);
+    if (screens == -1) {
+        ReleaseDC(wnd, screen);
+    } else {
+        DeleteDC(screen);
+    }
 
     return NULL;
 }

From b6413cd58818c6518ede6638a391bac15d812db0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 07:16:49 +1100
Subject: [PATCH 1254/2374] Cast to uint64_t

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

diff --git a/src/encode.c b/src/encode.c
index 09a86a7151c..d369a1b4598 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -961,7 +961,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 );
             } else if (type == TIFF_LONG8) {
                 status = ImagingLibTiffSetField(
-                    &encoder->state, (ttag_t)key_int, PyLong_AsLongLong(value)
+                    &encoder->state, (ttag_t)key_int, (uint64_t)PyLong_AsLongLong(value)
                 );
             } else {
                 TRACE(

From 28e5b929f8dcae3312f45e8aeb8d3b03b290036d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 08:40:09 +1100
Subject: [PATCH 1255/2374] Test 0

---
 Tests/test_imagegrab.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 032dac8ccec..35aaa7ff0b6 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -59,8 +59,10 @@ def test_grab_invalid_xdisplay(self) -> None:
 
     @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
     def test_grab_invalid_handle(self) -> None:
-        with pytest.raises(OSError):
+        with pytest.raises(OSError, match="unable to get device context for handle"):
             ImageGrab.grab(window=-1)
+        with pytest.raises(OSError, match="screen grab failed"):
+            ImageGrab.grab(window=0)
 
     def test_grabclipboard(self) -> None:
         if sys.platform == "darwin":

From 2d23a84049eb22f62107eb5f4cbe7c421b074d12 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 17:18:46 +1100
Subject: [PATCH 1256/2374] Fixed type hint

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index def3417845d..1a8c03eb337 100644
--- a/setup.py
+++ b/setup.py
@@ -1001,7 +1001,7 @@ def debug_build() -> bool:
     return hasattr(sys, "gettotalrefcount") or FUZZING_BUILD
 
 
-files = ["src/_imaging.c"]
+files: list[str | os.PathLike[str]] = ["src/_imaging.c"]
 for src_file in _IMAGING:
     files.append("src/" + src_file + ".c")
 for src_file in _LIB_IMAGING:

From 9622266c2a9b81b7b9a9e2e670571f9889bbe4d5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 18:33:25 +1100
Subject: [PATCH 1257/2374] Use DPI awareness from window

---
 src/display.c | 17 +++++++++++++++--
 1 file changed, 15 insertions(+), 2 deletions(-)

diff --git a/src/display.c b/src/display.c
index 30b7ada11bc..b78d0dca17c 100644
--- a/src/display.c
+++ b/src/display.c
@@ -316,6 +316,7 @@ PyImaging_DisplayModeWin32(PyObject *self, PyObject *args) {
 /* -------------------------------------------------------------------- */
 /* Windows screen grabber */
 
+typedef HANDLE(__stdcall *Func_GetWindowDpiAwarenessContext)(HANDLE);
 typedef HANDLE(__stdcall *Func_SetThreadDpiAwarenessContext)(HANDLE);
 
 PyObject *
@@ -330,6 +331,7 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
     PyObject *buffer;
     HANDLE dpiAwareness;
     HMODULE user32;
+    Func_GetWindowDpiAwarenessContext GetWindowDpiAwarenessContext_function;
     Func_SetThreadDpiAwarenessContext SetThreadDpiAwarenessContext_function;
 
     if (!PyArg_ParseTuple(
@@ -358,8 +360,19 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
     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);
+        if (screens == -1) {
+            GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext
+            )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
+            DPI_AWARENESS_CONTEXT dpiAwarenessContext =
+                GetWindowDpiAwarenessContext_function(wnd);
+            if (dpiAwarenessContext != NULL) {
+                dpiAwareness =
+                    SetThreadDpiAwarenessContext_function(dpiAwarenessContext);
+            }
+        } else {
+            // DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = ((DPI_CONTEXT_HANDLE)-3)
+            dpiAwareness = SetThreadDpiAwarenessContext_function((HANDLE)-3);
+        }
     }
 
     if (screens == 1) {

From 48db4a1d4d1baec7fdd77474db00029f24c2cef1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 19:40:03 +1100
Subject: [PATCH 1258/2374] Use test image filename

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

diff --git a/docs/reference/ImageFile.rst b/docs/reference/ImageFile.rst
index fdfeb60f99f..64abd71d156 100644
--- a/docs/reference/ImageFile.rst
+++ b/docs/reference/ImageFile.rst
@@ -19,7 +19,7 @@ Example: Parse an image
 
     from PIL import ImageFile
 
-    fp = open("hopper.pgm", "rb")
+    fp = open("hopper.ppm", "rb")
 
     p = ImageFile.Parser()
 

From 3cdaee45f50a1a4c020c382b516299a2bb531ec7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 20:15:23 +1100
Subject: [PATCH 1259/2374] Raise UnidentifiedImageError when opening TIFF
 without dimensions

---
 Tests/test_imagefile.py    | 13 +++++++++++++
 src/PIL/TiffImagePlugin.py |  8 ++++++--
 2 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 1ee68492630..8bef90ce43c 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -93,6 +93,19 @@ def test_ico(self) -> None:
             assert p.image is not None
             assert (48, 48) == p.image.size
 
+    @pytest.mark.filterwarnings("ignore:Corrupt EXIF data")
+    def test_incremental_tiff(self) -> None:
+        with ImageFile.Parser() as p:
+            with open("Tests/images/hopper.tif", "rb") as f:
+                p.feed(f.read(1024))
+
+                # Check that insufficient data was given in the first feed
+                assert not p.image
+
+                p.feed(f.read())
+            assert p.image is not None
+            assert (128, 128) == p.image.size
+
     @skip_unless_feature("webp")
     def test_incremental_webp(self) -> None:
         with ImageFile.Parser() as p:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 6bf39b75a5f..d4dcab2863a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1433,8 +1433,12 @@ def _setup(self) -> None:
         logger.debug("- YCbCr subsampling: %s", self.tag_v2.get(YCBCRSUBSAMPLING))
 
         # size
-        xsize = self.tag_v2.get(IMAGEWIDTH)
-        ysize = self.tag_v2.get(IMAGELENGTH)
+        try:
+            xsize = self.tag_v2[IMAGEWIDTH]
+            ysize = self.tag_v2[IMAGELENGTH]
+        except KeyError as e:
+            msg = "Missing dimensions"
+            raise TypeError(msg) from e
         if not isinstance(xsize, int) or not isinstance(ysize, int):
             msg = "Invalid dimensions"
             raise ValueError(msg)

From a1d862f1d67e621213e0239d3e45838abeab363e Mon Sep 17 00:00:00 2001
From: "Pietro F. Fontana" <cubanpit@users.noreply.github.com>
Date: Tue, 5 Nov 2024 15:39:03 +0100
Subject: [PATCH 1260/2374] Be more specific in 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>
---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 48863c3974e..68252f3a98b 100644
--- a/setup.py
+++ b/setup.py
@@ -691,7 +691,7 @@ def build_extensions(self) -> None:
                 elif sys.platform == "win32" and _find_library_file(self, "zlib"):
                     feature.set("zlib", "zlib")  # alternative name
                 elif sys.platform == "win32" and _find_library_file(self, "zdll"):
-                    feature.set("zlib", "zdll")  # different name if shared
+                    feature.set("zlib", "zdll")  # dll import library
 
         if feature.want("jpeg"):
             _dbg("Looking for jpeg")

From e82b5398e750c5dd37dfcc2edaf6b947371b53ef Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Wed, 6 Nov 2024 14:12:07 +0800
Subject: [PATCH 1261/2374] Correct handling of vendored fribidi.

---
 .github/workflows/wheels-dependencies.sh | 46 ++++++++++++++++--------
 .github/workflows/wheels-test.sh         |  8 +++--
 .gitignore                               |  4 +++
 pyproject.toml                           |  4 +--
 4 files changed, 43 insertions(+), 19 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index fd13930db46..ff06e99d276 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -1,16 +1,34 @@
 #!/bin/bash
 
 # Setup that needs to be done before multibuild utils are invoked
+PROJECTDIR=$(pwd)
 if [[ "$(uname -s)" == "Darwin" ]]; then
-    # Build and install macOS builds into the `build/deps` folder.
-    BUILD_PREFIX=$(pwd)/build/deps
+    # Safety check - macOS builds require that CIBW_ARCHS is set, and that it
+    # only contains a single value (even though cwbuildwheel) allows multiple
+    # values in CIBW_ARCHS.
+    if [[ -z "$CIBW_ARCHS" ]]; then
+        echo "ERROR: Pillow macOS builds require CIBW_ARCHS be defined."
+        exit 1
+    fi
+    if [[ "$CIBW_ARCHS" == *" "* ]]; then
+        echo "ERROR: Pillow macOS builds only support a single architecture in CIBW_ARCHS."
+        exit 1
+    fi
+
+    # Build macOS dependencies in `build/darwin`
+    # Install them into `build/deps/darwin`
+    WORKDIR=$(pwd)/build/darwin
+    BUILD_PREFIX=$(pwd)/build/deps/darwin
+    PLAT=$CIBW_ARCHS
 else
-    export MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
-    export MB_ML_VER=${AUDITWHEEL_POLICY:9}
+    # Build prefix will default to /usr/local
+    WORKDIR=$(pwd)/build
+    PLAT=$CIBW_ARCHS
+    MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
+    MB_ML_VER=${AUDITWHEEL_POLICY:9}
 fi
 
 # Define custom utilities
-export PLAT=$CIBW_ARCHS
 source wheels/multibuild/common_utils.sh
 source wheels/multibuild/library_builders.sh
 if [ -z "$IS_MACOS" ]; then
@@ -117,9 +135,6 @@ function build {
 
     ORIGINAL_CFLAGS=$CFLAGS
     CFLAGS="$CFLAGS -O3 -DNDEBUG"
-    if [[ -n "$IS_MACOS" ]]; then
-        CFLAGS="$CFLAGS -Wl,-headerpad_max_install_names"
-    fi
     build_libwebp
     CFLAGS=$ORIGINAL_CFLAGS
 
@@ -127,7 +142,7 @@ function build {
 
     if [ -n "$IS_MACOS" ]; then
         # Custom freetype build
-        build_simple freetype $FREETYPE_VERSION https://download.savannah.gnu.org/releases/freetype tar.gz --with-harfbuzz=no
+        build_simple freetype $FREETYPE_VERSION https://download.savannah.gnu.org/releases/freetype tar.gz --without-harfbuzz
     else
         build_freetype
     fi
@@ -136,17 +151,18 @@ function build {
 }
 
 # Perform all dependency builds in the build subfolder.
-mkdir -p build
-pushd build > /dev/null
+mkdir -p $WORKDIR
+pushd $WORKDIR > /dev/null
 
 # Any stuff that you need to do before you start building the wheels
 # Runs in the root directory of this repository.
-if [[ ! -d pillow-depends-main ]]; then
-  if [[ ! -f pillow-depends-main.zip ]]; then
+if [[ ! -d $WORKDIR/pillow-depends-main ]]; then
+  if [[ ! -f $PROJECTDIR/pillow-depends-main.zip ]]; then
     echo "Download pillow dependency sources..."
-    curl -fSL -o pillow-depends-main.zip https://github.com/python-pillow/pillow-depends/archive/main.zip
+    curl -fSL -o $PROJECTDIR/pillow-depends-main.zip https://github.com/python-pillow/pillow-depends/archive/main.zip
   fi
-  untar pillow-depends-main.zip
+  echo "Unpacking pillow dependency sources..."
+  untar $PROJECTDIR/pillow-depends-main.zip
 fi
 
 if [[ -n "$IS_MACOS" ]]; then
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index b697b740ec0..d1db8e8a5ec 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -16,8 +16,12 @@ if [[ "$OSTYPE" == "darwin"* ]]; then
     fi
     $HOMEBREW_HOME/bin/brew install fribidi
 
-    # Add the Homebrew lib folder so that vendored libraries can be found.
-    export DYLD_LIBRARY_PATH=$HOMEBREW_HOME/lib
+    # Add the lib folder for fribidi so that the vendored library can be found.
+    # Don't use /opt/homebrew/lib directly - use the lib folder where the
+    # installed copy of fribidi is cellared. This ensures we don't pick up the
+    # Homebrew version of any other library that we're dependent on (most notably,
+    # freetype).
+    export DYLD_LIBRARY_PATH=$(dirname $(realpath $HOMEBREW_HOME/lib/libfribidi.dylib))
 elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
     apk add curl fribidi
 else
diff --git a/.gitignore b/.gitignore
index 9b577325730..3033c2ea7ae 100644
--- a/.gitignore
+++ b/.gitignore
@@ -91,5 +91,9 @@ Tests/images/msp
 Tests/images/picins
 Tests/images/sunraster
 
+# Test and dependency downloads
+pillow-depends-main.zip
+pillow-test-images.zip
+
 # pyinstaller
 *.spec
diff --git a/pyproject.toml b/pyproject.toml
index da8548dcbd3..26fa4581706 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -96,13 +96,13 @@ build-verbosity = 1
 
 config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
 # Add an explicit dependencies prefix for macOS.
-macos.config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable dependencies-prefix=./build/deps"
+macos.config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable dependencies-prefix=./build/deps/darwin"
 
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 
 [tool.cibuildwheel.macos.environment]
-PATH = "$(pwd)/build/deps/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
+PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
 
 [tool.black]
 exclude = "wheels/multibuild"

From b0345c1c7b7605063064118563e8068fde5f9343 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 6 Nov 2024 22:08:22 +1100
Subject: [PATCH 1262/2374] Updated macOS tested Pillow versions

---
 docs/installation/platform-support.rst | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index a0bada7b428..b9d633142e7 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -75,7 +75,9 @@ 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 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13| 11.0.0           |arm           |
+|                                  +----------------------------+------------------+              |
+|                                  | 3.8                        | 10.4.0           |              |
 +----------------------------------+----------------------------+------------------+--------------+
 | macOS 14 Sonoma                  | 3.8, 3.9, 3.10, 3.11, 3.12 | 10.4.0           |arm           |
 +----------------------------------+----------------------------+------------------+--------------+

From 042f3ff083d98d211c2035dd45e511a63800d06e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 7 Nov 2024 07:52:18 +1100
Subject: [PATCH 1263/2374] Require coverage>=7.4.2

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

diff --git a/pyproject.toml b/pyproject.toml
index 45d5c269261..bff295bc60f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -56,7 +56,7 @@ optional-dependencies.mic = [
 ]
 optional-dependencies.tests = [
   "check-manifest",
-  "coverage",
+  "coverage>=7.4.2",
   "defusedxml",
   "markdown2",
   "olefile",

From a262b1991b439574578b60fac932b7065e02f0b6 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 7 Nov 2024 12:54:28 +0200
Subject: [PATCH 1264/2374] Update winbuild/README.md

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

diff --git a/winbuild/README.md b/winbuild/README.md
index 0d3ec8d8aa4..c474f12ceee 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -11,7 +11,8 @@ 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 2022 with Visual Studio 2022 Enterprise (GitHub Actions).
+* Tested on Windows Server 2022 with Visual Studio 2022 Enterprise and Windows Server
+  2019 with Visual Studio 2019 Enterprise (GitHub Actions).
 
 Here's an example script to build on Windows:
 

From 09bf28e9d7dbe20c13dc05ebe62a9e706abd273c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 7 Nov 2024 15:46:08 +0200
Subject: [PATCH 1265/2374] Update platform support

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

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 4e8620fc41c..373708a61a3 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -50,8 +50,8 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2019              | 3.9                        | x86                 |
 +----------------------------------+----------------------------+---------------------+
-| Windows Server 2022              | 3.9, 3.10, 3.11,           | x86-64              |
-|                                  | 3.12, 3.13, PyPy3          |                     |
+| Windows Server 2022              | 3.10, 3.11, 3.12, 3.13,    | x86-64              |
+|                                  | PyPy3                      |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.9 (MinGW)                | x86-64              |
 |                                  +----------------------------+---------------------+

From 7763350f072ca4ebe714352871df3ef8429b40bb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 8 Nov 2024 07:30:09 +1100
Subject: [PATCH 1266/2374] Fallback to PER_MONITOR_AWARE

---
 src/display.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/display.c b/src/display.c
index b78d0dca17c..da248443c27 100644
--- a/src/display.c
+++ b/src/display.c
@@ -368,6 +368,8 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
             if (dpiAwarenessContext != NULL) {
                 dpiAwareness =
                     SetThreadDpiAwarenessContext_function(dpiAwarenessContext);
+            } else {
+                dpiAwareness = SetThreadDpiAwarenessContext_function((HANDLE)-3);
             }
         } else {
             // DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = ((DPI_CONTEXT_HANDLE)-3)

From a44b3067b0e31d6c3a89ba270db20b1a1a71d226 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 8 Nov 2024 07:45:29 +1100
Subject: [PATCH 1267/2374] Fallback to PER_MONITOR_AWARE if
 GetWindowDpiAwarenessContext is not available
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/display.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/display.c b/src/display.c
index da248443c27..f28926427e2 100644
--- a/src/display.c
+++ b/src/display.c
@@ -365,7 +365,7 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
             )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
             DPI_AWARENESS_CONTEXT dpiAwarenessContext =
                 GetWindowDpiAwarenessContext_function(wnd);
-            if (dpiAwarenessContext != NULL) {
+            if (GetWindowDpiAwarenessContext_function != NULL && dpiAwarenessContext != NULL) {
                 dpiAwareness =
                     SetThreadDpiAwarenessContext_function(dpiAwarenessContext);
             } else {

From 288d77efd6f198d1c01c3eb62c333c6021b521bc Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 7 Nov 2024 20:45:58 +0000
Subject: [PATCH 1268/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/display.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/display.c b/src/display.c
index f28926427e2..89fec2c280a 100644
--- a/src/display.c
+++ b/src/display.c
@@ -365,7 +365,8 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
             )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
             DPI_AWARENESS_CONTEXT dpiAwarenessContext =
                 GetWindowDpiAwarenessContext_function(wnd);
-            if (GetWindowDpiAwarenessContext_function != NULL && dpiAwarenessContext != NULL) {
+            if (GetWindowDpiAwarenessContext_function != NULL &&
+                dpiAwarenessContext != NULL) {
                 dpiAwareness =
                     SetThreadDpiAwarenessContext_function(dpiAwarenessContext);
             } else {

From 4b8867069b3b49cfabe2a7ef6275a7c0d85406af Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 7 Nov 2024 22:06:28 +0100
Subject: [PATCH 1269/2374] Fix GetWindowDpiAwarenessContext NULL check

---
 src/display.c | 22 +++++++---------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/src/display.c b/src/display.c
index 89fec2c280a..5babd4f2ad0 100644
--- a/src/display.c
+++ b/src/display.c
@@ -329,7 +329,7 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
     HWND wnd;
     DWORD rop;
     PyObject *buffer;
-    HANDLE dpiAwareness;
+    HANDLE dpiAwareness = NULL;
     HMODULE user32;
     Func_GetWindowDpiAwarenessContext GetWindowDpiAwarenessContext_function;
     Func_SetThreadDpiAwarenessContext SetThreadDpiAwarenessContext_function;
@@ -359,23 +359,15 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
     user32 = LoadLibraryA("User32.dll");
     SetThreadDpiAwarenessContext_function = (Func_SetThreadDpiAwarenessContext
     )GetProcAddress(user32, "SetThreadDpiAwarenessContext");
+    GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext
+    )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
     if (SetThreadDpiAwarenessContext_function != NULL) {
-        if (screens == -1) {
-            GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext
-            )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
-            DPI_AWARENESS_CONTEXT dpiAwarenessContext =
+        if (screens == -1 && GetWindowDpiAwarenessContext_function != NULL) {
+            dpiAwareness =
                 GetWindowDpiAwarenessContext_function(wnd);
-            if (GetWindowDpiAwarenessContext_function != NULL &&
-                dpiAwarenessContext != NULL) {
-                dpiAwareness =
-                    SetThreadDpiAwarenessContext_function(dpiAwarenessContext);
-            } else {
-                dpiAwareness = SetThreadDpiAwarenessContext_function((HANDLE)-3);
-            }
-        } else {
-            // DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = ((DPI_CONTEXT_HANDLE)-3)
-            dpiAwareness = SetThreadDpiAwarenessContext_function((HANDLE)-3);
         }
+        // DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = ((DPI_CONTEXT_HANDLE)-3)
+        dpiAwareness = SetThreadDpiAwarenessContext_function(dpiAwareness == NULL ? (HANDLE)-3 : dpiAwareness);
     }
 
     if (screens == 1) {

From a6c941ac2c5e0b88d827c6d5c753cce3021e9e92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ondrej=20Baranovi=C4=8D?= <nulano@nulano.eu>
Date: Thu, 7 Nov 2024 22:22:02 +0100
Subject: [PATCH 1270/2374] Do not load GetWindowDpiAwarenessContext until its
 needed

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

diff --git a/src/display.c b/src/display.c
index 5babd4f2ad0..353d52396c7 100644
--- a/src/display.c
+++ b/src/display.c
@@ -359,9 +359,9 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
     user32 = LoadLibraryA("User32.dll");
     SetThreadDpiAwarenessContext_function = (Func_SetThreadDpiAwarenessContext
     )GetProcAddress(user32, "SetThreadDpiAwarenessContext");
-    GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext
-    )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
     if (SetThreadDpiAwarenessContext_function != NULL) {
+        GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext
+        )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
         if (screens == -1 && GetWindowDpiAwarenessContext_function != NULL) {
             dpiAwareness =
                 GetWindowDpiAwarenessContext_function(wnd);

From acba5c47f8be16869da92efb877f07451612fa04 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 8 Nov 2024 08:24:13 +1100
Subject: [PATCH 1271/2374] Lint fix

---
 src/display.c | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/src/display.c b/src/display.c
index 353d52396c7..b0693bf710c 100644
--- a/src/display.c
+++ b/src/display.c
@@ -363,11 +363,12 @@ PyImaging_GrabScreenWin32(PyObject *self, PyObject *args) {
         GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext
         )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
         if (screens == -1 && GetWindowDpiAwarenessContext_function != NULL) {
-            dpiAwareness =
-                GetWindowDpiAwarenessContext_function(wnd);
+            dpiAwareness = GetWindowDpiAwarenessContext_function(wnd);
         }
         // DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE = ((DPI_CONTEXT_HANDLE)-3)
-        dpiAwareness = SetThreadDpiAwarenessContext_function(dpiAwareness == NULL ? (HANDLE)-3 : dpiAwareness);
+        dpiAwareness = SetThreadDpiAwarenessContext_function(
+            dpiAwareness == NULL ? (HANDLE)-3 : dpiAwareness
+        );
     }
 
     if (screens == 1) {

From 4e35852ccc97f3e455f5130f1cd22f2f10292955 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 8 Nov 2024 05:34:35 +0800
Subject: [PATCH 1272/2374] Correct typo in comment.

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .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 ff06e99d276..2dea8c62a95 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -4,7 +4,7 @@
 PROJECTDIR=$(pwd)
 if [[ "$(uname -s)" == "Darwin" ]]; then
     # Safety check - macOS builds require that CIBW_ARCHS is set, and that it
-    # only contains a single value (even though cwbuildwheel) allows multiple
+    # only contains a single value (even though cibuildwheel) allows multiple
     # values in CIBW_ARCHS.
     if [[ -z "$CIBW_ARCHS" ]]; then
         echo "ERROR: Pillow macOS builds require CIBW_ARCHS be defined."

From 0a5b0f29e58cf9763b886e3ce300a79b5f4bac63 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Nov 2024 00:18:59 +1100
Subject: [PATCH 1273/2374] Run gcc problem matcher on Python 3.13

---
 .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 87acd7ddbc0..c33309bbf03 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -116,7 +116,7 @@ jobs:
         GHA_PYTHON_VERSION: ${{ matrix.python-version }}
 
     - name: Register gcc problem matcher
-      if: "matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'"
+      if: "matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'"
       run: echo "::add-matcher::.github/problem-matchers/gcc.json"
 
     - name: Build

From 681a03b1c38b26a36cddda812ead882b4af24eb4 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Sat, 9 Nov 2024 10:29:29 +0800
Subject: [PATCH 1274/2374] Apply suggestions from code review

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .github/workflows/wheels-dependencies.sh | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 2dea8c62a95..f4106429d46 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -4,8 +4,8 @@
 PROJECTDIR=$(pwd)
 if [[ "$(uname -s)" == "Darwin" ]]; then
     # Safety check - macOS builds require that CIBW_ARCHS is set, and that it
-    # only contains a single value (even though cibuildwheel) allows multiple
-    # values in CIBW_ARCHS.
+    # only contains a single value (even though cibuildwheel allows multiple
+    # values in CIBW_ARCHS).
     if [[ -z "$CIBW_ARCHS" ]]; then
         echo "ERROR: Pillow macOS builds require CIBW_ARCHS be defined."
         exit 1
@@ -171,7 +171,7 @@ if [[ -n "$IS_MACOS" ]]; then
     # with a MACOSX_DEPLOYMENT_TARGET that doesn't match what we want to use,
     # and they may bring in other dependencies that we don't want. The same will
     # be true of any other locations on the path. To avoid conflicts, strip the
-    # path down to the bare mimimum (which, on macOS, won't include any
+    # path down to the bare minimum (which, on macOS, won't include any
     # development dependencies).
     export PATH="$BUILD_PREFIX/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
     export CMAKE_PREFIX_PATH=$BUILD_PREFIX

From 9f09d48f3710409725beef1ca1be66da33855922 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Nov 2024 18:20:52 +1100
Subject: [PATCH 1275/2374] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 9d45e2214ca..7e8e94ed9cf 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.1.0 (unreleased)
 -------------------
 
+- Allow linking to zlib import library on Windows #8519
+  [cubanpit, nulano]
+
 - Detach PyQt6 QPixmap instance before returning #8509
   [radarhere]
 

From 7674b1a07a1dfdf1c0944aea1fefb95c4f62f5b4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Nov 2024 18:43:12 +1100
Subject: [PATCH 1276/2374] Removed quotes after dropping support for Python
 3.8

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

diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 0a7d87cc24b..335804b792f 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -47,7 +47,7 @@ class SupportsRead(Protocol[_T_co]):
     def read(self, __length: int = ...) -> _T_co: ...
 
 
-StrOrBytesPath = Union[str, bytes, "os.PathLike[str]", "os.PathLike[bytes]"]
+StrOrBytesPath = Union[str, bytes, os.PathLike[str], os.PathLike[bytes]]
 
 
 __all__ = ["Buffer", "IntegralLike", "StrOrBytesPath", "SupportsRead", "TypeGuard"]

From 2303018ebf751b7d6bc9d0e3d830cdd5f529a5b4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Nov 2024 20:06:33 +1100
Subject: [PATCH 1277/2374] Removed use of os.path.realpath

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 44270392c4d..9b76ce8bd86 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2550,7 +2550,7 @@ def save(
         filename: str | bytes = ""
         open_fp = False
         if is_path(fp):
-            filename = os.path.realpath(os.fspath(fp))
+            filename = os.fspath(fp)
             open_fp = True
         elif fp == sys.stdout:
             try:
@@ -2559,7 +2559,7 @@ def save(
                 pass
         if not filename and hasattr(fp, "name") and is_path(fp.name):
             # only set the name for metadata purposes
-            filename = os.path.realpath(os.fspath(fp.name))
+            filename = os.fspath(fp.name)
 
         # may mutate self!
         self._ensure_mutable()
@@ -3463,7 +3463,7 @@ def open(
     exclusive_fp = False
     filename: str | bytes = ""
     if is_path(fp):
-        filename = os.path.realpath(os.fspath(fp))
+        filename = os.fspath(fp)
 
     if filename:
         fp = builtins.open(filename, "rb")
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index d69d8456850..7f27d54dcc3 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -130,7 +130,7 @@ def __init__(
         if is_path(fp):
             # filename
             self.fp = open(fp, "rb")
-            self.filename = os.path.realpath(os.fspath(fp))
+            self.filename = os.fspath(fp)
             self._exclusive_fp = True
         else:
             # stream
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index b694b817e65..d8c2655609e 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -270,7 +270,7 @@ def load_from_bytes(f: IO[bytes]) -> None:
             )
 
         if is_path(font):
-            font = os.path.realpath(os.fspath(font))
+            font = os.fspath(font)
             if sys.platform == "win32":
                 font_bytes_path = font if isinstance(font, bytes) else font.encode()
                 try:

From 5bff2f3b2894ec6923c590d0c37b18177d0634bd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 10 Nov 2024 21:32:54 +1100
Subject: [PATCH 1278/2374] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 7e8e94ed9cf..f6ed5eb82fb 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,9 @@ Changelog (Pillow)
 11.1.0 (unreleased)
 -------------------
 
+- Removed use of os.path.realpath #8545
+  [radarhere]
+
 - Allow linking to zlib import library on Windows #8519
   [cubanpit, nulano]
 

From 378df7a5b22e47a0652619bd2f3218674c579d91 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 12 Nov 2024 22:41:57 +1100
Subject: [PATCH 1279/2374] Disable platform guessing instead of adding
 dependencies-prefix

---
 pyproject.toml |  4 +--
 setup.py       | 89 +++++++++++++++++++++-----------------------------
 2 files changed, 40 insertions(+), 53 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 26fa4581706..abb7be6458c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -95,8 +95,8 @@ before-all = ".github/workflows/wheels-dependencies.sh"
 build-verbosity = 1
 
 config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
-# Add an explicit dependencies prefix for macOS.
-macos.config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable dependencies-prefix=./build/deps/darwin"
+# Disable platform guessing on macOS
+macos.config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable platform-guessing=disable"
 
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
diff --git a/setup.py b/setup.py
index e4ce04883dd..4770c5eb78f 100644
--- a/setup.py
+++ b/setup.py
@@ -344,11 +344,6 @@ def __iter__(self) -> Iterator[str]:
             for x in ("raqm", "fribidi")
         ]
         + [
-            (
-                "dependencies-prefix",
-                None,
-                "The prefix where build dependencies are located.",
-            ),
             ("disable-platform-guessing", None, "Disable platform guessing on Linux"),
             ("debug", None, "Debug logging"),
         ]
@@ -360,7 +355,6 @@ def check_configuration(option: str, value: str) -> bool | None:
         return True if value in configuration.get(option, []) else None
 
     def initialize_options(self) -> None:
-        self.dependencies_prefix = configuration.get("dependencies-prefix", [])
         self.disable_platform_guessing = self.check_configuration(
             "platform-guessing", "disable"
         )
@@ -570,54 +564,47 @@ def build_extensions(self) -> None:
             )
 
         elif sys.platform == "darwin":
-            if self.dependencies_prefix:
-                # Use the explicitly provided prefixes for dependencies.
-                for prefix in self.dependencies_prefix:
-                    _add_directory(library_dirs, os.path.join(prefix, "lib"))
-                    _add_directory(include_dirs, os.path.join(prefix, "include"))
-            else:
-                # Guess the dependency locations based on homebrew/fink/macports
-                # attempt to make sure we pick freetype2 over other versions
-                _add_directory(include_dirs, "/sw/include/freetype2")
-                _add_directory(include_dirs, "/sw/lib/freetype2/include")
-                # fink installation directories
-                _add_directory(library_dirs, "/sw/lib")
-                _add_directory(include_dirs, "/sw/include")
-                # darwin ports installation directories
-                _add_directory(library_dirs, "/opt/local/lib")
-                _add_directory(include_dirs, "/opt/local/include")
-
-                # if Homebrew is installed, use its lib and include directories
-                try:
-                    prefix = (
-                        subprocess.check_output(["brew", "--prefix"])
-                        .strip()
-                        .decode("latin1")
-                    )
-                except Exception:
-                    # Homebrew not installed
-                    prefix = None
+            # attempt to make sure we pick freetype2 over other versions
+            _add_directory(include_dirs, "/sw/include/freetype2")
+            _add_directory(include_dirs, "/sw/lib/freetype2/include")
+            # fink installation directories
+            _add_directory(library_dirs, "/sw/lib")
+            _add_directory(include_dirs, "/sw/include")
+            # darwin ports installation directories
+            _add_directory(library_dirs, "/opt/local/lib")
+            _add_directory(include_dirs, "/opt/local/include")
 
-                ft_prefix = None
+            # if Homebrew is installed, use its lib and include directories
+            try:
+                prefix = (
+                    subprocess.check_output(["brew", "--prefix"])
+                    .strip()
+                    .decode("latin1")
+                )
+            except Exception:
+                # Homebrew not installed
+                prefix = None
 
-                if prefix:
-                    # add Homebrew's include and lib directories
-                    _add_directory(library_dirs, os.path.join(prefix, "lib"))
-                    _add_directory(include_dirs, os.path.join(prefix, "include"))
-                    _add_directory(
-                        include_dirs, os.path.join(prefix, "opt", "zlib", "include")
-                    )
-                    ft_prefix = os.path.join(prefix, "opt", "freetype")
+            ft_prefix = None
 
-                if ft_prefix and os.path.isdir(ft_prefix):
-                    # freetype might not be linked into Homebrew's prefix
-                    _add_directory(library_dirs, os.path.join(ft_prefix, "lib"))
-                    _add_directory(include_dirs, os.path.join(ft_prefix, "include"))
-                else:
-                    # fall back to freetype from XQuartz if
-                    # Homebrew's freetype is missing
-                    _add_directory(library_dirs, "/usr/X11/lib")
-                    _add_directory(include_dirs, "/usr/X11/include")
+            if prefix:
+                # add Homebrew's include and lib directories
+                _add_directory(library_dirs, os.path.join(prefix, "lib"))
+                _add_directory(include_dirs, os.path.join(prefix, "include"))
+                _add_directory(
+                    include_dirs, os.path.join(prefix, "opt", "zlib", "include")
+                )
+                ft_prefix = os.path.join(prefix, "opt", "freetype")
+
+            if ft_prefix and os.path.isdir(ft_prefix):
+                # freetype might not be linked into Homebrew's prefix
+                _add_directory(library_dirs, os.path.join(ft_prefix, "lib"))
+                _add_directory(include_dirs, os.path.join(ft_prefix, "include"))
+            else:
+                # fall back to freetype from XQuartz if
+                # Homebrew's freetype is missing
+                _add_directory(library_dirs, "/usr/X11/lib")
+                _add_directory(include_dirs, "/usr/X11/include")
 
             # Add the macOS SDK path.
             sdk_path = self.get_macos_sdk_path()

From 6fa775e324a27dac54ff8a9249553e06e1928051 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 12 Nov 2024 22:46:24 +1100
Subject: [PATCH 1280/2374] Platform guessing affects more than just Linux

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index e78f87fe9e0..fea21ee3f44 100644
--- a/setup.py
+++ b/setup.py
@@ -344,7 +344,7 @@ def __iter__(self) -> Iterator[str]:
             for x in ("raqm", "fribidi")
         ]
         + [
-            ("disable-platform-guessing", None, "Disable platform guessing on Linux"),
+            ("disable-platform-guessing", None, "Disable platform guessing"),
             ("debug", None, "Debug logging"),
         ]
         + [("add-imaging-libs=", None, "Add libs to _imaging build")]

From 9dc690427f009f898ef74b8799569346eb0b3fd5 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Wed, 13 Nov 2024 11:03:26 +0800
Subject: [PATCH 1281/2374] Correct the lookup of libfribidi on x86 macOS
 installs.

---
 .github/workflows/wheels-test.sh | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index d1db8e8a5ec..ce83a4278cd 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -7,21 +7,18 @@ if [[ "$OSTYPE" == "darwin"* ]]; then
     # However, we *do* need Homebrew to provide a copy of fribidi for
     # testing purposes so that we can verify the fribidi shim works as expected.
     if [[ "$(uname -m)" == "x86_64" ]]; then
-        # Use the "installed" location, rather than /usr/local, for two reasons:
-        # firstly, Homebrew allows libraries to be *installed*, but not linked;
-        # and secondly, we don't want any *other* leakage from /usr/local.
-        HOMEBREW_HOME=/usr/local/Homebrew
+        HOMEBREW_PREFIX=/usr/local
     else
-        HOMEBREW_HOME=/opt/homebrew
+        HOMEBREW_PREFIX=/opt/homebrew
     fi
-    $HOMEBREW_HOME/bin/brew install fribidi
+    $HOMEBREW_PREFIX/bin/brew install fribidi
 
     # Add the lib folder for fribidi so that the vendored library can be found.
-    # Don't use /opt/homebrew/lib directly - use the lib folder where the
+    # Don't use $HOMEWBREW_PREFIX/lib directly - use the lib folder where the
     # installed copy of fribidi is cellared. This ensures we don't pick up the
     # Homebrew version of any other library that we're dependent on (most notably,
     # freetype).
-    export DYLD_LIBRARY_PATH=$(dirname $(realpath $HOMEBREW_HOME/lib/libfribidi.dylib))
+    export DYLD_LIBRARY_PATH=$(dirname $(realpath $HOMEBREW_PREFIX/lib/libfribidi.dylib))
 elif [ "${AUDITWHEEL_POLICY::9}" == "musllinux" ]; then
     apk add curl fribidi
 else

From 48c7eb22c0aeba649892dcb4766600f6dcfb6bdc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 13 Nov 2024 22:45:52 +1100
Subject: [PATCH 1282/2374] Added default value for _Tile args

---
 src/PIL/EpsImagePlugin.py | 2 +-
 src/PIL/FliImagePlugin.py | 2 +-
 src/PIL/ImageFile.py      | 2 +-
 src/PIL/MspImagePlugin.py | 2 +-
 src/PIL/PcdImagePlugin.py | 2 +-
 src/PIL/QoiImagePlugin.py | 2 +-
 src/PIL/XbmImagePlugin.py | 4 ++--
 7 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index fb1e301c084..35cc623e7d3 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -454,7 +454,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, [ImageFile._Tile("eps", (0, 0) + im.size, 0, None)])
+    ImageFile._save(im, fp, [ImageFile._Tile("eps", (0, 0) + im.size, 0)])
 
     fp.write(b"\n%%%%EndBinary\n")
     fp.write(b"grestore end\n")
diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index 666390be9ee..b534b30ab83 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 = [ImageFile._Tile("fli", (0, 0) + self.size, self.__offset, None)]
+        self.tile = [ImageFile._Tile("fli", (0, 0) + self.size, self.__offset)]
 
         self.__offset += framesize
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 7f27d54dcc3..6c07c85e75a 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -99,7 +99,7 @@ class _Tile(NamedTuple):
     codec_name: str
     extents: tuple[int, int, int, int] | None
     offset: int
-    args: tuple[Any, ...] | str | None
+    args: tuple[Any, ...] | str | None = None
 
 
 #
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index f3460a78730..50fb6a2d9d7 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -72,7 +72,7 @@ def _open(self) -> None:
         if s[:4] == b"DanM":
             self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 32, ("1", 0, 1))]
         else:
-            self.tile = [ImageFile._Tile("MSP", (0, 0) + self.size, 32, None)]
+            self.tile = [ImageFile._Tile("MSP", (0, 0) + self.size, 32)]
 
 
 class MspDecoder(ImageFile.PyDecoder):
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index e8ea800a42c..ac40383f972 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 = [ImageFile._Tile("pcd", (0, 0) + self.size, 96 * 2048, None)]
+        self.tile = [ImageFile._Tile("pcd", (0, 0) + self.size, 96 * 2048)]
 
     def load_end(self) -> None:
         if self.tile_post_rotate:
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index 010d3f941e1..01cc868b216 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 = [ImageFile._Tile("qoi", (0, 0) + self._size, self.fp.tell(), None)]
+        self.tile = [ImageFile._Tile("qoi", (0, 0) + self._size, self.fp.tell())]
 
 
 class QoiDecoder(ImageFile.PyDecoder):
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index f3d490a840f..cf1a8b9f564 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 = [ImageFile._Tile("xbm", (0, 0) + self.size, m.end(), None)]
+        self.tile = [ImageFile._Tile("xbm", (0, 0) + self.size, m.end())]
 
 
 def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
@@ -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, [ImageFile._Tile("xbm", (0, 0) + im.size, 0, None)])
+    ImageFile._save(im, fp, [ImageFile._Tile("xbm", (0, 0) + im.size, 0)])
 
     fp.write(b"};\n")
 

From 871963b8ddab57fec9050135a5b58bceedce23db Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 13 Nov 2024 22:53:18 +1100
Subject: [PATCH 1283/2374] Replaced tuple args with mode string where
 equivalent

---
 src/PIL/BlpImagePlugin.py     | 2 +-
 src/PIL/DdsImagePlugin.py     | 4 +---
 src/PIL/FpxImagePlugin.py     | 2 +-
 src/PIL/FtexImagePlugin.py    | 2 +-
 src/PIL/GdImageFile.py        | 2 +-
 src/PIL/ImtImagePlugin.py     | 2 +-
 src/PIL/MspImagePlugin.py     | 4 ++--
 src/PIL/PixarImagePlugin.py   | 4 +---
 src/PIL/SpiderImagePlugin.py  | 8 ++------
 src/PIL/XVThumbImagePlugin.py | 4 +---
 src/PIL/XpmImagePlugin.py     | 4 +---
 11 files changed, 13 insertions(+), 25 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index e5605635e55..2d03af9d7dd 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 = [ImageFile._Tile(decoder, (0, 0) + self.size, 0, (self.mode, 0, 1))]
+        self.tile = [ImageFile._Tile(decoder, (0, 0) + self.size, 0, self.mode)]
 
 
 class _BLPBaseDecoder(ImageFile.PyDecoder):
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 1b64082370c..9349e284178 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -560,9 +560,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         + struct.pack("<4I", *rgba_mask)  # dwRGBABitMask
         + struct.pack("<5I", DDSCAPS.TEXTURE, 0, 0, 0, 0)
     )
-    ImageFile._save(
-        im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, 0, 1))]
-    )
+    ImageFile._save(im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, rawmode)])
 
 
 def _accept(prefix: bytes) -> bool:
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 8fef51076b4..4cfcb067d03 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -170,7 +170,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
                         "raw",
                         (x, y, x1, y1),
                         i32(s, i) + 28,
-                        (self.rawmode,),
+                        self.rawmode,
                     )
                 )
 
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index ddb469bc332..0516b760c61 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -95,7 +95,7 @@ def _open(self) -> None:
             self._mode = "RGBA"
             self.tile = [ImageFile._Tile("bcn", (0, 0) + self.size, 0, (1,))]
         elif format == Format.UNCOMPRESSED:
-            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 0, ("RGB", 0, 1))]
+            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 0, "RGB")]
         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 f1b4969f2c4..fc4801e9d1c 100644
--- a/src/PIL/GdImageFile.py
+++ b/src/PIL/GdImageFile.py
@@ -76,7 +76,7 @@ def _open(self) -> None:
                 "raw",
                 (0, 0) + self.size,
                 7 + true_color_offset + 4 + 256 * 4,
-                ("L", 0, 1),
+                "L",
             )
         ]
 
diff --git a/src/PIL/ImtImagePlugin.py b/src/PIL/ImtImagePlugin.py
index 594c56513cd..068cd5c33db 100644
--- a/src/PIL/ImtImagePlugin.py
+++ b/src/PIL/ImtImagePlugin.py
@@ -62,7 +62,7 @@ def _open(self) -> None:
                         "raw",
                         (0, 0) + self.size,
                         self.fp.tell() - len(buffer),
-                        (self.mode, 0, 1),
+                        self.mode,
                     )
                 ]
 
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 50fb6a2d9d7..ef6ae87f8c0 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -70,7 +70,7 @@ def _open(self) -> None:
         self._size = i16(s, 4), i16(s, 6)
 
         if s[:4] == b"DanM":
-            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 32, ("1", 0, 1))]
+            self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 32, "1")]
         else:
             self.tile = [ImageFile._Tile("MSP", (0, 0) + self.size, 32)]
 
@@ -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, [ImageFile._Tile("raw", (0, 0) + im.size, 32, ("1", 0, 1))])
+    ImageFile._save(im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 32, "1")])
 
 
 #
diff --git a/src/PIL/PixarImagePlugin.py b/src/PIL/PixarImagePlugin.py
index 36f565f1c20..5c465bbdc5c 100644
--- a/src/PIL/PixarImagePlugin.py
+++ b/src/PIL/PixarImagePlugin.py
@@ -61,9 +61,7 @@ def _open(self) -> None:
         # FIXME: to be continued...
 
         # create tile descriptor (assuming "dumped")
-        self.tile = [
-            ImageFile._Tile("raw", (0, 0) + self.size, 1024, (self.mode, 0, 1))
-        ]
+        self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 1024, self.mode)]
 
 
 #
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 075073f9fe3..d7f457ae781 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -154,9 +154,7 @@ def _open(self) -> None:
             self.rawmode = "F;32F"
         self._mode = "F"
 
-        self.tile = [
-            ImageFile._Tile("raw", (0, 0) + self.size, offset, (self.rawmode, 0, 1))
-        ]
+        self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, offset, self.rawmode)]
         self._fp = self.fp  # FIXME: hack
 
     @property
@@ -280,9 +278,7 @@ 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, [ImageFile._Tile("raw", (0, 0) + im.size, 0, (rawmode, 0, 1))]
-    )
+    ImageFile._save(im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, rawmode)])
 
 
 def _save_spider(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
diff --git a/src/PIL/XVThumbImagePlugin.py b/src/PIL/XVThumbImagePlugin.py
index 5d1f201a454..75333354db2 100644
--- a/src/PIL/XVThumbImagePlugin.py
+++ b/src/PIL/XVThumbImagePlugin.py
@@ -74,9 +74,7 @@ def _open(self) -> None:
         self.palette = ImagePalette.raw("RGB", PALETTE)
 
         self.tile = [
-            ImageFile._Tile(
-                "raw", (0, 0) + self.size, self.fp.tell(), (self.mode, 0, 1)
-            )
+            ImageFile._Tile("raw", (0, 0) + self.size, self.fp.tell(), self.mode)
         ]
 
 
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index 1fc6c0c39d5..b985aa5dcd6 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -101,9 +101,7 @@ def _open(self) -> None:
         self._mode = "P"
         self.palette = ImagePalette.raw("RGB", b"".join(palette))
 
-        self.tile = [
-            ImageFile._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")]
 
     def load_read(self, read_bytes: int) -> bytes:
         #

From 84f5c7e5ba51afbeda6c4aaf42a31cea9ee8b082 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 13 Nov 2024 22:52:36 +1100
Subject: [PATCH 1284/2374] Added default value for _Tile offset

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

diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 35cc623e7d3..36ba15ec50f 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -454,7 +454,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, [ImageFile._Tile("eps", (0, 0) + im.size, 0)])
+    ImageFile._save(im, fp, [ImageFile._Tile("eps", (0, 0) + im.size)])
 
     fp.write(b"\n%%%%EndBinary\n")
     fp.write(b"grestore end\n")
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 6c07c85e75a..bd0e92eb60d 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -98,7 +98,7 @@ def _tilesort(t: _Tile) -> int:
 class _Tile(NamedTuple):
     codec_name: str
     extents: tuple[int, int, int, int] | None
-    offset: int
+    offset: int = 0
     args: tuple[Any, ...] | str | None = None
 
 
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index cf1a8b9f564..943a0447016 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, [ImageFile._Tile("xbm", (0, 0) + im.size, 0)])
+    ImageFile._save(im, fp, [ImageFile._Tile("xbm", (0, 0) + im.size)])
 
     fp.write(b"};\n")
 

From 185a03f1a25ba56ae11d655c04645e0a50710dae Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 16 Nov 2024 12:05:06 +1100
Subject: [PATCH 1285/2374] Do not create new image when exif_transpose() is
 used in place

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

diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index 44aad0c3ca1..bb29cc0d3e8 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -698,10 +698,11 @@ def exif_transpose(image: Image.Image, *, in_place: bool = False) -> Image.Image
         8: Image.Transpose.ROTATE_90,
     }.get(orientation)
     if method is not None:
-        transposed_image = image.transpose(method)
         if in_place:
-            image.im = transposed_image.im
-            image._size = transposed_image._size
+            image.im = image.im.transpose(method)
+            image._size = image.im.size
+        else:
+            transposed_image = image.transpose(method)
         exif_image = image if in_place else transposed_image
 
         exif = exif_image.getexif()

From 54f23345d2fd1894c7cf89475e385fcbb3d3f16d Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Sat, 16 Nov 2024 09:58:29 +0800
Subject: [PATCH 1286/2374] More tweaks from code review.

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index f4106429d46..ce2e40103d0 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -19,14 +19,13 @@ if [[ "$(uname -s)" == "Darwin" ]]; then
     # Install them into `build/deps/darwin`
     WORKDIR=$(pwd)/build/darwin
     BUILD_PREFIX=$(pwd)/build/deps/darwin
-    PLAT=$CIBW_ARCHS
 else
     # Build prefix will default to /usr/local
     WORKDIR=$(pwd)/build
-    PLAT=$CIBW_ARCHS
     MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
     MB_ML_VER=${AUDITWHEEL_POLICY:9}
 fi
+PLAT=$CIBW_ARCHS
 
 # Define custom utilities
 source wheels/multibuild/common_utils.sh
@@ -119,9 +118,9 @@ function build {
     build_libjpeg_turbo
     if [ -n "$IS_MACOS" ]; then
         # Custom tiff build to include jpeg; by default, configure won't include
-        # headers/libs in the custom macOS prefix. Explicitly disable webp and
-        # zstd, because on x86_64 macs, it will pick up the Homebrew versions of
-        # webp and zstd from /usr/local.
+        # headers/libs in the custom macOS prefix. Explicitly disable webp,
+        # libdeflate and zstd, because on x86_64 macs, it will pick up the
+        # Homebrew versions of those libraries from /usr/local.
         build_simple tiff $TIFF_VERSION https://download.osgeo.org/libtiff tar.gz \
             --with-jpeg-include-dir=$BUILD_PREFIX/include --with-jpeg-lib-dir=$BUILD_PREFIX/lib \
             --disable-webp --disable-zstd --disable-libdeflate

From 6136a92d061e77e622c974c35aa0605f96eb05e0 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 16 Nov 2024 09:48:28 +0000
Subject: [PATCH 1287/2374] Update codecov/codecov-action action to v5

---
 .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 656054e8924..b906ada92e0 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -135,7 +135,7 @@ jobs:
           bash.exe .ci/after_success.sh
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
         with:
           file: ./coverage.xml
           flags: GHA_Cygwin
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 03608319a60..cc5f9d4a5a9 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -100,7 +100,7 @@ jobs:
         MATRIX_DOCKER: ${{ matrix.docker }}
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v4
+      uses: codecov/codecov-action@v5
       with:
         flags: GHA_Docker
         name: ${{ matrix.docker }}
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index bfd393db5a2..a14e7e1ed7f 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -85,7 +85,7 @@ jobs:
           .ci/test.sh
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
         with:
           file: ./coverage.xml
           flags: GHA_Windows
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 9b5da137d8f..d1924eb2018 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -215,7 +215,7 @@ jobs:
       shell: pwsh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v4
+      uses: codecov/codecov-action@v5
       with:
         file: ./coverage.xml
         flags: GHA_Windows
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index c33309bbf03..1405c64f9aa 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -156,7 +156,7 @@ jobs:
         .ci/after_success.sh
 
     - name: Upload coverage
-      uses: codecov/codecov-action@v4
+      uses: codecov/codecov-action@v5
       with:
         flags: ${{ matrix.os == 'ubuntu-latest' && 'GHA_Ubuntu' || 'GHA_macOS' }}
         name: ${{ matrix.os }} Python ${{ matrix.python-version }}

From c70dacff62c07341c4bb9d9c28e26e4e703ab5ae Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 16 Nov 2024 21:44:00 +1100
Subject: [PATCH 1288/2374] Updated from deprecated "file" to "files"

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

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index b906ada92e0..2076cad7a9a 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -137,7 +137,7 @@ jobs:
       - name: Upload coverage
         uses: codecov/codecov-action@v5
         with:
-          file: ./coverage.xml
+          files: ./coverage.xml
           flags: GHA_Cygwin
           name: Cygwin Python 3.${{ matrix.python-minor-version }}
           token: ${{ secrets.CODECOV_ORG_TOKEN }}
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index a14e7e1ed7f..cca25edba42 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -87,7 +87,7 @@ jobs:
       - name: Upload coverage
         uses: codecov/codecov-action@v5
         with:
-          file: ./coverage.xml
+          files: ./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 d1924eb2018..d905a392585 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -217,7 +217,7 @@ jobs:
     - name: Upload coverage
       uses: codecov/codecov-action@v5
       with:
-        file: ./coverage.xml
+        files: ./coverage.xml
         flags: GHA_Windows
         name: ${{ runner.os }} Python ${{ matrix.python-version }}
         token: ${{ secrets.CODECOV_ORG_TOKEN }}

From 96b898c826982c5b99f2a9387e0d2011a73fe20a Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Mon, 18 Nov 2024 09:56:45 +0800
Subject: [PATCH 1289/2374] A couple more cleanups from code review.

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index ce2e40103d0..f86099af16e 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -62,8 +62,7 @@ BROTLI_VERSION=1.1.0
 
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
-    # This essentially duplicates the Homebrew recipe:
-    # https://github.com/Homebrew/homebrew-core/blob/master/Formula/p/pkg-config.rb
+    # This essentially duplicates the Homebrew recipe
     ORIGINAL_CFLAGS=$CFLAGS
     CFLAGS="$CFLAGS -Wno-int-conversion"
     build_simple pkg-config 0.29.2 https://pkg-config.freedesktop.org/releases tar.gz \
@@ -108,7 +107,6 @@ function build {
     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
-        build_simple libXdmcp 1.1.5 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
     else
         sed s/\${pc_sysrootdir\}// $BUILD_PREFIX/share/pkgconfig/xcb-proto.pc > $BUILD_PREFIX/lib/pkgconfig/xcb-proto.pc
@@ -123,7 +121,7 @@ function build {
         # Homebrew versions of those libraries from /usr/local.
         build_simple tiff $TIFF_VERSION https://download.osgeo.org/libtiff tar.gz \
             --with-jpeg-include-dir=$BUILD_PREFIX/include --with-jpeg-lib-dir=$BUILD_PREFIX/lib \
-            --disable-webp --disable-zstd --disable-libdeflate
+            --disable-webp --disable-libdeflate --disable-zstd
     else
         build_tiff
     fi
@@ -134,6 +132,9 @@ function build {
 
     ORIGINAL_CFLAGS=$CFLAGS
     CFLAGS="$CFLAGS -O3 -DNDEBUG"
+    if [[ -n "$IS_MACOS" ]]; then
+        CFLAGS="$CFLAGS -Wl,-headerpad_max_install_names"
+    fi
     build_libwebp
     CFLAGS=$ORIGINAL_CFLAGS
 
@@ -141,7 +142,7 @@ function build {
 
     if [ -n "$IS_MACOS" ]; then
         # Custom freetype build
-        build_simple freetype $FREETYPE_VERSION https://download.savannah.gnu.org/releases/freetype tar.gz --without-harfbuzz
+        build_simple freetype $FREETYPE_VERSION https://download.savannah.gnu.org/releases/freetype tar.gz --with-harfbuzz=no
     else
         build_freetype
     fi
@@ -175,7 +176,7 @@ if [[ -n "$IS_MACOS" ]]; then
     export PATH="$BUILD_PREFIX/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
     export CMAKE_PREFIX_PATH=$BUILD_PREFIX
 
-    # Link the brew command into our isolated build directory.
+    # Ensure the basic structure of the build prefix directory exists.
     mkdir -p "$BUILD_PREFIX/bin"
     mkdir -p "$BUILD_PREFIX/lib"
 

From e02e4aaf1de9503e6e88a60f292998d174d23034 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Nov 2024 19:31:54 +1100
Subject: [PATCH 1290/2374] Updated harfbuzz to 10.1.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 f86099af16e..89226810a09 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,7 +38,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.2
-HARFBUZZ_VERSION=10.0.1
+HARFBUZZ_VERSION=10.1.0
 LIBPNG_VERSION=1.6.44
 JPEGTURBO_VERSION=3.0.4
 OPENJPEG_VERSION=2.5.2
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index c8332d11c7e..5606ac7f7ed 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.16",
-    "HARFBUZZ": "10.0.1",
+    "HARFBUZZ": "10.1.0",
     "JPEGTURBO": "3.0.4",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.44",

From c7a9582eab34bc46b74c245aa137424b9cfaee74 Mon Sep 17 00:00:00 2001
From: Tom Flanagan <tom@zkpq.ca>
Date: Tue, 19 Nov 2024 20:40:14 -0800
Subject: [PATCH 1291/2374] Fix file position desync when calling into libtiff

---
 Tests/test_libtiff_file_position.py | 23 +++++++++++++++++++++++
 src/PIL/TiffImagePlugin.py          | 17 +++++++++--------
 2 files changed, 32 insertions(+), 8 deletions(-)
 create mode 100644 Tests/test_libtiff_file_position.py

diff --git a/Tests/test_libtiff_file_position.py b/Tests/test_libtiff_file_position.py
new file mode 100644
index 00000000000..d614ea8eca1
--- /dev/null
+++ b/Tests/test_libtiff_file_position.py
@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+
+import pytest
+
+from PIL import Image
+
+
+@pytest.mark.parametrize('test_file', [
+    'Tests/images/old-style-jpeg-compression-no-samplesperpixel.tif',
+    'Tests/images/old-style-jpeg-compression.tif',
+])
+def test_libtiff_exif_loading(test_file) -> None:
+    # loading image before exif
+    im1 = Image.open(open(test_file, 'rb', buffering=1048576))
+    im1.load()
+    exif1 = dict(im1.getexif())
+
+    # loading exif before image
+    im2 = Image.open(open(test_file, 'rb', buffering=1048576))
+    exif2 = dict(im2.getexif())
+
+    assert exif1 == exif2
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 6bf39b75a5f..72628677278 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1216,10 +1216,6 @@ def seek(self, frame: int) -> None:
     def _seek(self, frame: int) -> None:
         self.fp = self._fp
 
-        # reset buffered io handle in case fp
-        # was passed to libtiff, invalidating the buffer
-        self.fp.tell()
-
         while len(self._frame_pos) <= frame:
             if not self.__next:
                 msg = "no more images in TIFF file"
@@ -1303,10 +1299,6 @@ def load_end(self) -> None:
         if not self.is_animated:
             self._close_exclusive_fp_after_loading = True
 
-            # reset buffered io handle in case fp
-            # was passed to libtiff, invalidating the buffer
-            self.fp.tell()
-
             # load IFD data from fp before it is closed
             exif = self.getexif()
             for key in TiffTags.TAGS_V2_GROUPS:
@@ -1381,8 +1373,17 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
             logger.debug("have fileno, calling fileno version of the decoder.")
             if not close_self_fp:
                 self.fp.seek(0)
+            # Save and restore the file position, because libtiff will move it
+            # outside of the python runtime, and that will confuse
+            # io.BufferedReader and possible others.
+            # NOTE: This must use os.lseek(), and not fp.tell()/fp.seek(),
+            # because the buffer read head already may not equal the actual
+            # file position, and fp.seek() may just adjust it's internal
+            # pointer and not actually seek the OS file handle.
+            pos = os.lseek(fp, 0, os.SEEK_CUR)
             # 4 bytes, otherwise the trace might error out
             n, err = decoder.decode(b"fpfp")
+            os.lseek(fp, pos, os.SEEK_SET)
         else:
             # we have something else.
             logger.debug("don't have fileno or getvalue. just reading")

From 44cc0bebb8998897f03d77479df750f208d9d00e Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Wed, 20 Nov 2024 05:52:50 +0000
Subject: [PATCH 1292/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_libtiff_file_position.py | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/Tests/test_libtiff_file_position.py b/Tests/test_libtiff_file_position.py
index d614ea8eca1..43ed82c30e1 100644
--- a/Tests/test_libtiff_file_position.py
+++ b/Tests/test_libtiff_file_position.py
@@ -1,23 +1,25 @@
 from __future__ import annotations
 
-
 import pytest
 
 from PIL import Image
 
 
-@pytest.mark.parametrize('test_file', [
-    'Tests/images/old-style-jpeg-compression-no-samplesperpixel.tif',
-    'Tests/images/old-style-jpeg-compression.tif',
-])
+@pytest.mark.parametrize(
+    "test_file",
+    [
+        "Tests/images/old-style-jpeg-compression-no-samplesperpixel.tif",
+        "Tests/images/old-style-jpeg-compression.tif",
+    ],
+)
 def test_libtiff_exif_loading(test_file) -> None:
     # loading image before exif
-    im1 = Image.open(open(test_file, 'rb', buffering=1048576))
+    im1 = Image.open(open(test_file, "rb", buffering=1048576))
     im1.load()
     exif1 = dict(im1.getexif())
 
     # loading exif before image
-    im2 = Image.open(open(test_file, 'rb', buffering=1048576))
+    im2 = Image.open(open(test_file, "rb", buffering=1048576))
     exif2 = dict(im2.getexif())
 
     assert exif1 == exif2

From cb1653f6272ebc543530ae03cd7cf8577ed13231 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 20 Nov 2024 22:33:23 +1100
Subject: [PATCH 1293/2374] Updated comment

---
 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 72628677278..08bb7891512 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1374,7 +1374,7 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
             if not close_self_fp:
                 self.fp.seek(0)
             # Save and restore the file position, because libtiff will move it
-            # outside of the python runtime, and that will confuse
+            # outside of the Python runtime, and that will confuse
             # io.BufferedReader and possible others.
             # NOTE: This must use os.lseek(), and not fp.tell()/fp.seek(),
             # because the buffer read head already may not equal the actual

From 925db4552658ac0d8c037b0ac0b39bd7eb96f8f9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 20 Nov 2024 22:40:29 +1100
Subject: [PATCH 1294/2374] Moved test

---
 Tests/test_file_libtiff.py          | 19 +++++++++++++++++++
 Tests/test_libtiff_file_position.py | 25 -------------------------
 2 files changed, 19 insertions(+), 25 deletions(-)
 delete mode 100644 Tests/test_libtiff_file_position.py

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 62f8719af53..9c49b1534ed 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1098,6 +1098,25 @@ def test_exif_transpose(self) -> None:
 
                     assert_image_similar(base_im, im, 0.7)
 
+    @pytest.mark.parametrize(
+        "test_file",
+        [
+            "Tests/images/old-style-jpeg-compression-no-samplesperpixel.tif",
+            "Tests/images/old-style-jpeg-compression.tif",
+        ],
+    )
+    def test_buffering(self, test_file: str) -> None:
+        # load exif first
+        with Image.open(open(test_file, "rb", buffering=1048576)) as im:
+            exif = dict(im.getexif())
+
+        # load image before exif
+        with Image.open(open(test_file, "rb", buffering=1048576)) as im2:
+            im2.load()
+            exif_after_load = dict(im2.getexif())
+
+        assert exif == exif_after_load
+
     @pytest.mark.valgrind_known_error(reason="Backtrace in Python Core")
     def test_sampleformat_not_corrupted(self) -> None:
         # Assert that a TIFF image with SampleFormat=UINT tag is not corrupted
diff --git a/Tests/test_libtiff_file_position.py b/Tests/test_libtiff_file_position.py
deleted file mode 100644
index 43ed82c30e1..00000000000
--- a/Tests/test_libtiff_file_position.py
+++ /dev/null
@@ -1,25 +0,0 @@
-from __future__ import annotations
-
-import pytest
-
-from PIL import Image
-
-
-@pytest.mark.parametrize(
-    "test_file",
-    [
-        "Tests/images/old-style-jpeg-compression-no-samplesperpixel.tif",
-        "Tests/images/old-style-jpeg-compression.tif",
-    ],
-)
-def test_libtiff_exif_loading(test_file) -> None:
-    # loading image before exif
-    im1 = Image.open(open(test_file, "rb", buffering=1048576))
-    im1.load()
-    exif1 = dict(im1.getexif())
-
-    # loading exif before image
-    im2 = Image.open(open(test_file, "rb", buffering=1048576))
-    exif2 = dict(im2.getexif())
-
-    assert exif1 == exif2

From 82dfbc35b190a818a1cbdbee6524eaf31605b7bd Mon Sep 17 00:00:00 2001
From: Tom Flanagan <tom@zkpq.ca>
Date: Wed, 20 Nov 2024 05:21:14 -0800
Subject: [PATCH 1295/2374] Update src/PIL/TiffImagePlugin.py

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 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 72628677278..08bb7891512 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1374,7 +1374,7 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
             if not close_self_fp:
                 self.fp.seek(0)
             # Save and restore the file position, because libtiff will move it
-            # outside of the python runtime, and that will confuse
+            # outside of the Python runtime, and that will confuse
             # io.BufferedReader and possible others.
             # NOTE: This must use os.lseek(), and not fp.tell()/fp.seek(),
             # because the buffer read head already may not equal the actual

From bfe40b5129e9250243b1d425172c18f7c4e15e10 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Nov 2024 19:22:39 +1100
Subject: [PATCH 1296/2374] Prevent Cygwin bash from being used by
 codecov-action

---
 .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 2076cad7a9a..5b0a0394688 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -133,6 +133,7 @@ jobs:
       - name: After success
         run: |
           bash.exe .ci/after_success.sh
+          rm C:\cygwin\bin\bash.EXE
 
       - name: Upload coverage
         uses: codecov/codecov-action@v5

From 69c9a7ffcfd42b0486f02f17119c6d05f1d04969 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 20 Nov 2024 20:03:15 +1100
Subject: [PATCH 1297/2374] Use zlib-ng on Linux

---
 .github/workflows/wheels-dependencies.sh | 20 +++++++++++++++++---
 Tests/check_wheel.py                     |  2 +-
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index f86099af16e..5d23fc036ee 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -50,10 +50,10 @@ if [[ -n "$IS_MACOS" ]]; then
 else
     GIFLIB_VERSION=5.2.1
 fi
-if [[ -n "$IS_MACOS" ]] || [[ "$MB_ML_VER" != 2014 ]]; then
+if [[ -n "$IS_MACOS" ]]; then
     ZLIB_VERSION=1.3.1
 else
-    ZLIB_VERSION=1.2.8
+    ZLIB_NG_VERSION=2.2.2
 fi
 LIBWEBP_VERSION=1.4.0
 BZIP2_VERSION=1.0.8
@@ -74,6 +74,16 @@ function build_pkg_config {
     touch pkg-config-stamp
 }
 
+function build_zlib_ng {
+    if [ -e zlib-stamp ]; then return; fi
+    fetch_unpack https://github.com/zlib-ng/zlib-ng/archive/$ZLIB_NG_VERSION.tar.gz zlib-ng-$ZLIB_NG_VERSION.tar.gz
+    (cd zlib-ng-$ZLIB_NG_VERSION \
+        && ./configure --prefix=$BUILD_PREFIX --zlib-compat \
+        && make -j4 \
+        && make install)
+    touch zlib-stamp
+}
+
 function build_brotli {
     if [ -e brotli-stamp ]; then return; fi
     local cmake=$(get_modern_cmake)
@@ -101,7 +111,11 @@ function build {
     if [ -z "$IS_ALPINE" ] && [ -z "$IS_MACOS" ]; then
         yum remove -y zlib-devel
     fi
-    build_new_zlib
+    if [ -n "$IS_MACOS" ]; then
+        build_new_zlib
+    else
+        build_zlib_ng
+    fi
 
     build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
     if [ -n "$IS_MACOS" ]; then
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 374e48e8ad3..787d4f7431a 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -40,7 +40,7 @@ def test_wheel_features() -> None:
 
     if sys.platform == "win32":
         expected_features.remove("xcb")
-    else:
+    elif sys.platform == "darwin":
         expected_features.remove("zlib_ng")
 
     assert set(features.get_supported_features()) == expected_features

From 9c3d8fb581cab18abb60117f08358b51b18a44b0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Nov 2024 11:02:50 +1100
Subject: [PATCH 1298/2374] Do not install Pyroma, to use only system packages

---
 .github/workflows/test-mingw.yml | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index bfd393db5a2..fd8faba71bf 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -68,12 +68,13 @@ jobs:
               mingw-w64-x86_64-openjpeg2 \
               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-pytest \
+              mingw-w64-x86_64-python-pytest-cov \
+              mingw-w64-x86_64-python-pytest-timeout \
               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
 
       - name: Build Pillow

From 30f03b2bff689af1f395c183cf991bc34f8b0bab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Nov 2024 11:05:33 +1100
Subject: [PATCH 1299/2374] Removed SETUPTOOLS_USE_DISTUTILS="stdlib"

---
 .github/workflows/test-mingw.yml           | 3 +--
 docs/installation/building-from-source.rst | 5 -----
 2 files changed, 1 insertion(+), 7 deletions(-)

diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index fd8faba71bf..93fe8a06465 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -69,7 +69,6 @@ jobs:
               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-pytest \
               mingw-w64-x86_64-python-pytest-cov \
               mingw-w64-x86_64-python-pytest-timeout \
@@ -78,7 +77,7 @@ jobs:
           pushd depends && ./install_extra_test_images.sh && popd
 
       - name: Build Pillow
-        run: SETUPTOOLS_USE_DISTUTILS="stdlib" CFLAGS="-coverage" python3 -m pip install .
+        run: CFLAGS="-coverage" python3 -m pip install .
 
       - name: Test Pillow
         run: |
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 4b517582786..19294f72c1c 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -195,11 +195,6 @@ Many of Pillow's features require external libraries:
             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

From 16e409a8d28fecbf83cd67409224e65ebb371a93 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 24 Nov 2024 13:46:28 +0200
Subject: [PATCH 1300/2374] Test 3.13t (free-threaded) from
 Quansight-Labs/setup-python on Linux/macOS

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

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 1405c64f9aa..83a696f5f8b 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -42,6 +42,7 @@ jobs:
         ]
         python-version: [
           "pypy3.10",
+          "3.13t",
           "3.13",
           "3.12",
           "3.11",
@@ -52,14 +53,14 @@ jobs:
         - { 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 }
+        - { python-version: "3.13t", disable-gil: true }
         # M1 only available for 3.10+
         - { os: "macos-13", python-version: "3.9" }
         exclude:
         - { os: "macos-latest", python-version: "3.9" }
 
     runs-on: ${{ matrix.os }}
-    name: ${{ matrix.os }} Python ${{ matrix.python-version }} ${{ matrix.disable-gil && 'free-threaded' || '' }}
+    name: ${{ matrix.os }} Python ${{ matrix.python-version }}
 
     steps:
     - uses: actions/checkout@v4
@@ -67,8 +68,7 @@ jobs:
         persist-credentials: false
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      if: "${{ !matrix.disable-gil }}"
+      uses: Quansight-Labs/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true
@@ -77,13 +77,6 @@ jobs:
           ".ci/*.sh"
           "pyproject.toml"
 
-    - name: Set up Python ${{ matrix.python-version }} (free-threaded)
-      uses: deadsnakes/action@v3.2.0
-      if: "${{ matrix.disable-gil }}"
-      with:
-        python-version: ${{ matrix.python-version }}
-        nogil: ${{ matrix.disable-gil }}
-
     - name: Set PYTHON_GIL
       if: "${{ matrix.disable-gil }}"
       run: |

From 540a0b73a7ebb3ec5571e3ea027c73cbe95b2fc6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 23 Nov 2024 00:20:40 +1100
Subject: [PATCH 1301/2374] Use installed cmake

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index f86099af16e..ddda43423cd 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -76,10 +76,9 @@ function build_pkg_config {
 
 function build_brotli {
     if [ -e brotli-stamp ]; then return; fi
-    local cmake=$(get_modern_cmake)
     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_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
+        && cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
         && make install)
     touch brotli-stamp
 }

From 7dcf4d8ab319348239d4f8695c6d3366bc257cbf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 25 Nov 2024 16:43:21 +1100
Subject: [PATCH 1302/2374] Added logging to fixIFD()

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

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 6bf39b75a5f..a246994efee 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2202,6 +2202,12 @@ def fixIFD(self) -> None:
             if tag in self.Tags:
                 cur_pos = self.f.tell()
 
+                tagname = TiffTags.lookup(tag).name
+                typname = TYPES.get(field_type, "unknown")
+                msg = f"fixIFD: {tagname} ({tag}) - type: {typname} ({field_type})"
+                msg += f"- type size: {field_size} - count: {count}"
+                logger.debug(msg)
+
                 if is_local:
                     self._fixOffsets(count, field_size)
                     self.f.seek(cur_pos + 4)

From 5174c596ca6c78725efdb2cda8ace39f11d8e215 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 26 Nov 2024 22:06:47 +0200
Subject: [PATCH 1303/2374] Release drafter: move removals, deprecations,
 documentation up, and uncategorised changes last

---
 .github/release-drafter.yml | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/.github/release-drafter.yml b/.github/release-drafter.yml
index 3711d91f0d5..de0ab480519 100644
--- a/.github/release-drafter.yml
+++ b/.github/release-drafter.yml
@@ -3,18 +3,19 @@ tag-template: "$NEXT_MINOR_VERSION"
 change-template: '- $TITLE #$NUMBER [@$AUTHOR]'
 
 categories:
-  - title: "Dependencies"
-    label: "Dependency"
+  - title: "Removals"
+    label: "Removal"
   - title: "Deprecations"
     label: "Deprecation"
   - title: "Documentation"
     label: "Documentation"
-  - title: "Removals"
-    label: "Removal"
+  - title: "Dependencies"
+    label: "Dependency"
   - title: "Testing"
     label: "Testing"
   - title: "Type hints"
     label: "Type hints"
+  - title: "Other changes"
 
 exclude-labels:
   - "changelog: skip"
@@ -23,6 +24,4 @@ template: |
 
   https://pillow.readthedocs.io/en/stable/releasenotes/$NEXT_MINOR_VERSION.html
 
-  ## Changes
-
   $CHANGES

From 02250e81b729ddb32952f96e57bf9d952ed70cf8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 28 Nov 2024 07:58:10 +1100
Subject: [PATCH 1304/2374] Added link to GitHub releases

---
 CHANGES.rst | 22 ++++------------------
 1 file changed, 4 insertions(+), 18 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index f6ed5eb82fb..dfbbd24b331 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -2,26 +2,12 @@
 Changelog (Pillow)
 ==================
 
-11.1.0 (unreleased)
--------------------
-
-- Removed use of os.path.realpath #8545
-  [radarhere]
-
-- Allow linking to zlib import library on Windows #8519
-  [cubanpit, nulano]
-
-- Detach PyQt6 QPixmap instance before returning #8509
-  [radarhere]
+11.1.0 and newer
+----------------
 
-- Corrected EMF DPI #8485
-  [radarhere]
+See GitHub Releases:
 
-- Fix IFDRational with a zero denominator #8474
-  [radarhere]
-
-- Fixed disabling a feature during install #8469
-  [radarhere]
+- https://github.com/python-pillow/Pillow/releases
 
 11.0.0 (2024-10-15)
 -------------------

From c36a5b669b225fdcb6b4b3a41fc5b5e647a651c1 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 28 Nov 2024 10:29:05 +0200
Subject: [PATCH 1305/2374] Update/remove references to CHANGES.rst

---
 .github/CONTRIBUTING.md | 1 -
 README.md               | 2 +-
 RELEASING.md            | 2 --
 codecov.yml             | 2 +-
 pyproject.toml          | 2 +-
 5 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
index d03fcf0d9da..ba2b7d8ed26 100644
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -19,7 +19,6 @@ Please send a pull request to the `main` branch. Please include [documentation](
 - Follow PEP 8.
 - When committing only documentation changes please include `[ci skip]` in the commit message to avoid running tests on AppVeyor.
 - Include [release notes](https://github.com/python-pillow/Pillow/tree/main/docs/releasenotes) as needed or appropriate with your bug fixes, feature additions and tests.
-- Do not add to the [changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst) for proposed changes, as that is updated after changes are merged.
 
 ## Reporting Issues
 
diff --git a/README.md b/README.md
index 5bbebaccb4a..057d0acf0ce 100644
--- a/README.md
+++ b/README.md
@@ -107,7 +107,7 @@ The core image library is designed for fast access to data stored in a few basic
   - [Issues](https://github.com/python-pillow/Pillow/issues)
   - [Pull requests](https://github.com/python-pillow/Pillow/pulls)
 - [Release notes](https://pillow.readthedocs.io/en/stable/releasenotes/index.html)
-- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
+- [Changelog](https://github.com/python-pillow/Pillow/releases)
   - [Pre-fork](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst#pre-fork)
 
 ## Report a Vulnerability
diff --git a/RELEASING.md b/RELEASING.md
index 9e6ec5dd4c1..ebdbb6406e8 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -12,7 +12,6 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 * [ ] 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 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.
 * [ ] Create branch and tag for release e.g.:
   ```bash
@@ -34,7 +33,6 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 Released as needed for security, installation or critical bug fixes.
 
 * [ ] Make necessary changes in `main` branch.
-* [ ] Update `CHANGES.rst`.
 * [ ] Check out release branch e.g.:
   ```bash
   git checkout -t remotes/origin/5.2.x
diff --git a/codecov.yml b/codecov.yml
index 8646576bb44..84920238ffc 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -1,7 +1,7 @@
 # Documentation: https://docs.codecov.com/docs/codecov-yaml
 
 codecov:
-  # Avoid "Missing base report" due to committing CHANGES.rst with "[CI skip]"
+  # Avoid "Missing base report" due to committing with "[CI skip]"
   # https://github.com/codecov/support/issues/363
   # https://docs.codecov.com/docs/comparing-commits
   allow_coverage_offsets: true
diff --git a/pyproject.toml b/pyproject.toml
index c6d95f2abe3..1c7b2c4b28e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -73,7 +73,7 @@ optional-dependencies.typing = [
 optional-dependencies.xmp = [
   "defusedxml",
 ]
-urls.Changelog = "https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst"
+urls.Changelog = "https://github.com/python-pillow/Pillow/releases"
 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"

From 4986609938c6fd38af6efd8501fe157b0443e5bc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Nov 2024 23:44:32 +1100
Subject: [PATCH 1306/2374] Use zlib-ng on macOS

---
 .github/workflows/wheels-dependencies.sh | 12 ++----------
 Tests/check_wheel.py                     |  2 --
 pyproject.toml                           |  1 +
 3 files changed, 3 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 5d23fc036ee..a2aec07c32d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -50,11 +50,7 @@ if [[ -n "$IS_MACOS" ]]; then
 else
     GIFLIB_VERSION=5.2.1
 fi
-if [[ -n "$IS_MACOS" ]]; then
-    ZLIB_VERSION=1.3.1
-else
-    ZLIB_NG_VERSION=2.2.2
-fi
+ZLIB_NG_VERSION=2.2.2
 LIBWEBP_VERSION=1.4.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
@@ -111,11 +107,7 @@ function build {
     if [ -z "$IS_ALPINE" ] && [ -z "$IS_MACOS" ]; then
         yum remove -y zlib-devel
     fi
-    if [ -n "$IS_MACOS" ]; then
-        build_new_zlib
-    else
-        build_zlib_ng
-    fi
+    build_zlib_ng
 
     build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
     if [ -n "$IS_MACOS" ]; then
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 787d4f7431a..563be0b7489 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -40,7 +40,5 @@ def test_wheel_features() -> None:
 
     if sys.platform == "win32":
         expected_features.remove("xcb")
-    elif sys.platform == "darwin":
-        expected_features.remove("zlib_ng")
 
     assert set(features.get_supported_features()) == expected_features
diff --git a/pyproject.toml b/pyproject.toml
index c6d95f2abe3..af09ccbc1f2 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -104,6 +104,7 @@ test-extras = "tests"
 
 [tool.cibuildwheel.macos.environment]
 PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
+DYLD_LIBRARY_PATH = "$(pwd)/build/deps/darwin/lib"
 
 [tool.black]
 exclude = "wheels/multibuild"

From 10527918e3570f1e6772ac90db42d2288cce7ae4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 29 Nov 2024 17:13:07 +1100
Subject: [PATCH 1307/2374] Use brew formula to install libraqm

---
 docs/installation/building-from-source.rst | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 19294f72c1c..ff60120aedc 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -148,13 +148,7 @@ Many of Pillow's features require external libraries:
     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.
+        brew install libjpeg libraqm libtiff little-cms2 openjpeg webp
 
 .. tab:: Windows
 

From 1fab591f42fa5a9502fade7873481b567c033849 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 30 Nov 2024 21:17:31 +1100
Subject: [PATCH 1308/2374] Python 3.12 is tested on MinGW

---
 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 b9d633142e7..35f863374d1 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -55,7 +55,7 @@ These platforms are built and tested for every change.
 |                                  +----------------------------+---------------------+
 |                                  | 3.13                       | x86                 |
 |                                  +----------------------------+---------------------+
-|                                  | 3.9 (MinGW)                | x86-64              |
+|                                  | 3.12 (MinGW)               | x86-64              |
 |                                  +----------------------------+---------------------+
 |                                  | 3.9 (Cygwin)               | x86-64              |
 +----------------------------------+----------------------------+---------------------+

From 1d15ce8c494075f521600c21b9efb0d5eaa9aa03 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 30 Nov 2024 23:17:42 +1100
Subject: [PATCH 1309/2374] Updated build option error messages

---
 setup.py | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/setup.py b/setup.py
index fbd23a5685a..eea21fa3407 100644
--- a/setup.py
+++ b/setup.py
@@ -393,13 +393,14 @@ def finalize_options(self) -> None:
                 self.feature.required.discard(x)
                 _dbg("Disabling %s", x)
                 if getattr(self, f"enable_{x}"):
-                    msg = f"Conflicting options: --enable-{x} and --disable-{x}"
+                    msg = f"Conflicting options: '-C {x}=enable' and '-C {x}=disable'"
                     raise ValueError(msg)
                 if x == "freetype":
-                    _dbg("--disable-freetype implies --disable-raqm")
+                    _dbg("'-C freetype=disable' implies '-C raqm=disable'")
                     if getattr(self, "enable_raqm"):
                         msg = (
-                            "Conflicting options: --enable-raqm and --disable-freetype"
+                            "Conflicting options: "
+                            "'-C raqm=enable' and '-C freetype=disable'"
                         )
                         raise ValueError(msg)
                     setattr(self, "disable_raqm", True)
@@ -407,15 +408,17 @@ def finalize_options(self) -> None:
                 _dbg("Requiring %s", x)
                 self.feature.required.add(x)
                 if x == "raqm":
-                    _dbg("--enable-raqm implies --enable-freetype")
+                    _dbg("'-C raqm=enable' implies '-C freetype=enable'")
                     self.feature.required.add("freetype")
         for x in ("raqm", "fribidi"):
             if getattr(self, f"vendor_{x}"):
                 if getattr(self, "disable_raqm"):
-                    msg = f"Conflicting options: --vendor-{x} and --disable-raqm"
+                    msg = f"Conflicting options: '-C {x}=vendor' and '-C raqm=disable'"
                     raise ValueError(msg)
                 if x == "fribidi" and not getattr(self, "vendor_raqm"):
-                    msg = f"Conflicting options: --vendor-{x} and not --vendor-raqm"
+                    msg = (
+                        f"Conflicting options: '-C {x}=vendor' and not '-C raqm=vendor'"
+                    )
                     raise ValueError(msg)
                 _dbg("Using vendored version of %s", x)
                 self.feature.vendor.add(x)
@@ -1047,7 +1050,7 @@ def debug_build() -> bool:
     msg = f"""
 
 The headers or library files could not be found for {str(err)},
-which was requested by the option flag --enable-{str(err)}
+which was requested by the option flag '-C {str(err)}=enable'
 
 """
     sys.stderr.write(msg)

From 513fe2ca2d23c7f1685b089fc6087ab02b2828df Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 1 Dec 2024 23:15:54 +0200
Subject: [PATCH 1310/2374] Only use start year in copyright, remove end years

---
 LICENSE      | 2 +-
 docs/COPYING | 2 +-
 docs/conf.py | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/LICENSE b/LICENSE
index 8837c290c30..10dd42d9eda 100644
--- a/LICENSE
+++ b/LICENSE
@@ -5,7 +5,7 @@ The Python Imaging Library (PIL) is
 
 Pillow is the friendly PIL fork. It is
 
-    Copyright © 2010-2024 by Jeffrey A. Clark and contributors
+    Copyright © 2010 by Jeffrey A. Clark and contributors
 
 Like PIL, Pillow is licensed under the open source MIT-CMU License:
 
diff --git a/docs/COPYING b/docs/COPYING
index d5ee19f81a6..17fba5b87ff 100644
--- a/docs/COPYING
+++ b/docs/COPYING
@@ -5,7 +5,7 @@ The Python Imaging Library (PIL) is
 
 Pillow is the friendly PIL fork. It is
 
-    Copyright © 2010-2024 by Jeffrey A. Clark and contributors
+    Copyright © 2010 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 b81d86c6ca2..e1e3f1b8f8a 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -55,7 +55,7 @@
 project = "Pillow (PIL Fork)"
 copyright = (
     "1995-2011 Fredrik Lundh and contributors, "
-    "2010-2024 Jeffrey A. Clark and contributors."
+    "2010 Jeffrey A. Clark and contributors."
 )
 author = "Fredrik Lundh (PIL), Jeffrey A. Clark (Pillow)"
 

From 0000729f2a79da62ba64332484103ffacf1700a1 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 2 Dec 2024 17:34:54 +0000
Subject: [PATCH 1311/2374] [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.7.2 → v0.8.1](https://github.com/astral-sh/ruff-pre-commit/compare/v0.7.2...v0.8.1)
- [github.com/PyCQA/bandit: 1.7.10 → 1.8.0](https://github.com/PyCQA/bandit/compare/1.7.10...1.8.0)
- [github.com/pre-commit/mirrors-clang-format: v19.1.3 → v19.1.4](https://github.com/pre-commit/mirrors-clang-format/compare/v19.1.3...v19.1.4)
- [github.com/python-jsonschema/check-jsonschema: 0.29.4 → 0.30.0](https://github.com/python-jsonschema/check-jsonschema/compare/0.29.4...0.30.0)
- [github.com/abravalheri/validate-pyproject: v0.22 → v0.23](https://github.com/abravalheri/validate-pyproject/compare/v0.22...v0.23)
---
 .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 ddc98fdc356..f91260c724f 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.7.2
+    rev: v0.8.1
     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.10
+    rev: 1.8.0
     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: v19.1.3
+    rev: v19.1.4
     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.29.4
+    rev: 0.30.0
     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.22
+    rev: v0.23
     hooks:
       - id: validate-pyproject
         additional_dependencies: [trove-classifiers>=2024.10.12]

From 0ab21dff1ed0b16944a5458ab73dfa3a5c060b88 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 2 Dec 2024 20:29:38 +0200
Subject: [PATCH 1312/2374] Fix new Ruff errors

---
 src/PIL/ImImagePlugin.py   |  2 +-
 src/PIL/Image.py           | 21 ++++++---------------
 src/PIL/JpegImagePlugin.py |  2 +-
 src/PIL/PcxImagePlugin.py  |  2 +-
 src/PIL/PngImagePlugin.py  |  2 +-
 src/PIL/TiffImagePlugin.py | 13 +++++++------
 src/PIL/_typing.py         |  2 +-
 7 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index f9f47348c66..b4215a0b1e5 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -357,7 +357,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         name = "".join([name[: 92 - len(ext)], ext])
 
         fp.write(f"Name: {name}\r\n".encode("ascii"))
-    fp.write(("Image size (x*y): %d*%d\r\n" % im.size).encode("ascii"))
+    fp.write(f"Image size (x*y): {im.size[0]}*{im.size[1]}\r\n".encode("ascii"))
     fp.write(f"File size (no of images): {frames}\r\n".encode("ascii"))
     if im.mode in ["P", "PA"]:
         fp.write(b"Lut: 1\r\n")
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9b76ce8bd86..1e289b6c38b 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -692,13 +692,10 @@ def __eq__(self, other: object) -> bool:
         )
 
     def __repr__(self) -> str:
-        return "<%s.%s image mode=%s size=%dx%d at 0x%X>" % (
-            self.__class__.__module__,
-            self.__class__.__name__,
-            self.mode,
-            self.size[0],
-            self.size[1],
-            id(self),
+        return (
+            f"<{self.__class__.__module__}.{self.__class__.__name__} "
+            f"image mode={self.mode} size={self.size[0]}x{self.size[1]} "
+            f"at 0x{id(self):X}>"
         )
 
     def _repr_pretty_(self, p: PrettyPrinter, cycle: bool) -> None:
@@ -707,14 +704,8 @@ def _repr_pretty_(self, p: PrettyPrinter, cycle: bool) -> None:
         # Same as __repr__ but without unpredictable id(self),
         # to keep Jupyter notebook `text/plain` output stable.
         p.text(
-            "<%s.%s image mode=%s size=%dx%d>"
-            % (
-                self.__class__.__module__,
-                self.__class__.__name__,
-                self.mode,
-                self.size[0],
-                self.size[1],
-            )
+            f"<{self.__class__.__module__}.{self.__class__.__name__} "
+            f"image mode={self.mode} size={self.size[0]}x{self.size[1]}>"
         )
 
     def _repr_image(self, image_format: str, **kwargs: Any) -> bytes | None:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 6510e072e5e..ab6a2f497fb 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -72,7 +72,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
     n = i16(self.fp.read(2)) - 2
     s = ImageFile._safe_read(self.fp, n)
 
-    app = "APP%d" % (marker & 15)
+    app = f"APP{marker & 15}"
 
     self.app[app] = s  # compatibility
     self.applist.append((app, s))
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 8445d5cc740..32436cea3af 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -86,7 +86,7 @@ def _open(self) -> None:
 
         elif bits == 1 and planes in (2, 4):
             mode = "P"
-            rawmode = "P;%dL" % planes
+            rawmode = f"P;{planes}L"
             self.palette = ImagePalette.raw("RGB", s[16:64])
 
         elif version == 5 and bits == 8 and planes == 1:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 4e12272041d..4b97992a31f 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -523,7 +523,7 @@ def chunk_cHRM(self, pos: int, length: int) -> bytes:
 
         assert self.fp is not None
         s = ImageFile._safe_read(self.fp, length)
-        raw_vals = struct.unpack(">%dI" % (len(s) // 4), s)
+        raw_vals = struct.unpack(f">{len(s) // 4}I", s)
         self.im_info["chromaticity"] = tuple(elt / 100000.0 for elt in raw_vals)
         return s
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 08bb7891512..9ee55347aaf 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -935,9 +935,9 @@ def load(self, fp: IO[bytes]) -> None:
                 self._tagdata[tag] = data
                 self.tagtype[tag] = typ
 
-                msg += " - value: " + (
-                    "<table: %d bytes>" % size if size > 32 else repr(data)
-                )
+                bytes_value = size if size > 32 else repr(data)
+                msg += f" - value: <table: {bytes_value} bytes>"
+
                 logger.debug(msg)
 
             (self.next,) = (
@@ -981,9 +981,10 @@ def tobytes(self, offset: int = 0) -> bytes:
 
             tagname = TiffTags.lookup(tag, self.group).name
             typname = "ifd" if is_ifd else TYPES.get(typ, "unknown")
-            msg = f"save: {tagname} ({tag}) - type: {typname} ({typ})"
-            msg += " - value: " + (
-                "<table: %d bytes>" % len(data) if len(data) >= 16 else str(values)
+            bytes_value = len(data) if len(data) >= 16 else str(values)
+            msg = (
+                f"save: {tagname} ({tag}) - type: {typname} ({typ})"
+                f" - value: <table: {bytes_value} bytes>"
             )
             logger.debug(msg)
 
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 335804b792f..34a9a81e11f 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -44,7 +44,7 @@ def __class_getitem__(cls, item: Any) -> type[bool]:
 
 
 class SupportsRead(Protocol[_T_co]):
-    def read(self, __length: int = ...) -> _T_co: ...
+    def read(self, length: int = ..., /) -> _T_co: ...
 
 
 StrOrBytesPath = Union[str, bytes, os.PathLike[str], os.PathLike[bytes]]

From c16ae6fefa6cb939d274c95d1969889dced9dd15 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Dec 2024 09:19:26 +1100
Subject: [PATCH 1313/2374] Do not describe raw data as a table

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

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 9ee55347aaf..be4a57b7445 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -935,8 +935,8 @@ def load(self, fp: IO[bytes]) -> None:
                 self._tagdata[tag] = data
                 self.tagtype[tag] = typ
 
-                bytes_value = size if size > 32 else repr(data)
-                msg += f" - value: <table: {bytes_value} bytes>"
+                msg += " - value: "
+                msg += f"<table: {size} bytes>" if size > 32 else repr(data)
 
                 logger.debug(msg)
 
@@ -981,11 +981,8 @@ def tobytes(self, offset: int = 0) -> bytes:
 
             tagname = TiffTags.lookup(tag, self.group).name
             typname = "ifd" if is_ifd else TYPES.get(typ, "unknown")
-            bytes_value = len(data) if len(data) >= 16 else str(values)
-            msg = (
-                f"save: {tagname} ({tag}) - type: {typname} ({typ})"
-                f" - value: <table: {bytes_value} bytes>"
-            )
+            msg = f"save: {tagname} ({tag}) - type: {typname} ({typ}) - value: "
+            msg += f"<table: {len(data)} bytes>" if len(data) >= 16 else str(values)
             logger.debug(msg)
 
             # count is sum of lengths for string and arbitrary data

From 80c562573a4b5723b1094fb9b07a582912e3d62b Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 3 Dec 2024 02:28:52 +0000
Subject: [PATCH 1314/2374] Update dependency cibuildwheel to v2.22.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 c4511439ccb..833aca23d4a 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.21.3
+cibuildwheel==2.22.0

From f4a9304bb358f45a088d3c237ada88703e0e0d8e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Dec 2024 13:35:00 +1100
Subject: [PATCH 1315/2374] Use CIBW_ENABLE

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

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 45f18634100..c5e55aa621d 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -85,7 +85,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
+          CIBW_ENABLE: cpython-prerelease
           # Extra options for manylinux.
           CIBW_MANYLINUX_AARCH64_IMAGE: ${{ matrix.spec }}
           CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.spec }}
@@ -150,10 +150,9 @@ jobs:
         env:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BUILD: ${{ matrix.build }}
-          CIBW_FREE_THREADED_SUPPORT: True
+          CIBW_ENABLE: cpython-prerelease cpython-freethreading
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
-          CIBW_PRERELEASE_PYTHONS: True
           CIBW_SKIP: pp39-*
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
@@ -228,8 +227,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_ENABLE: cpython-prerelease cpython-freethreading
           CIBW_SKIP: pp39-*
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm

From 3ce33a253a1bd76fdde6eb557cf271b3b2f01553 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Dec 2024 20:14:03 +1100
Subject: [PATCH 1316/2374] self.tile is not None

---
 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 7f27d54dcc3..9836cd68884 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -120,7 +120,7 @@ def __init__(
         self.custom_mimetype: str | None = None
 
         self.tile: list[_Tile] = []
-        """ A list of tile descriptors, or ``None`` """
+        """ A list of tile descriptors """
 
         self.readonly = 1  # until we know better
 

From c5474ed43363e24602c92e5ca7b37899ce37b9a5 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 6 Dec 2024 20:26:07 +0200
Subject: [PATCH 1317/2374] Replace python-pillow.org with
 python-pillow.github.io

---
 docs/handbook/tutorial.rst | 2 +-
 pyproject.toml             | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 3df8e0d20be..f771ae7aea5 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -678,7 +678,7 @@ Reading from URL
 
     from PIL import Image
     from urllib.request import urlopen
-    url = "https://python-pillow.org/assets/images/pillow-logo.png"
+    url = "https://python-pillow.github.io/assets/images/pillow-logo.png"
     img = Image.open(urlopen(url))
 
 
diff --git a/pyproject.toml b/pyproject.toml
index 1c7b2c4b28e..aaaba0032e7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -76,7 +76,7 @@ optional-dependencies.xmp = [
 urls.Changelog = "https://github.com/python-pillow/Pillow/releases"
 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.Homepage = "https://python-pillow.github.io"
 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"

From 2215eaf21d8e9096fdd13c34225c67c0893d82db Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Dec 2024 06:25:48 +1100
Subject: [PATCH 1318/2374] Updated openjpeg to 2.5.3

---
 .github/workflows/wheels-dependencies.sh   | 2 +-
 depends/install_openjpeg.sh                | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 winbuild/build_prepare.py                  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index ddda43423cd..e88a010ef5c 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -41,7 +41,7 @@ FREETYPE_VERSION=2.13.2
 HARFBUZZ_VERSION=10.0.1
 LIBPNG_VERSION=1.6.44
 JPEGTURBO_VERSION=3.0.4
-OPENJPEG_VERSION=2.5.2
+OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
diff --git a/depends/install_openjpeg.sh b/depends/install_openjpeg.sh
index 8c2967bc21b..1f8d781931b 100755
--- a/depends/install_openjpeg.sh
+++ b/depends/install_openjpeg.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 # install openjpeg
 
-archive=openjpeg-2.5.2
+archive=openjpeg-2.5.3
 
 ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index ff60120aedc..03359de31cd 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -58,7 +58,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**, **2.5.0** and **2.5.2**.
+    **2.4.0**, **2.5.0**, **2.5.2** and **2.5.3**.
   * 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 c8332d11c7e..dc802a3e52f 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ def cmd_msbuild(
     "LCMS2": "2.16",
     "LIBPNG": "1.6.44",
     "LIBWEBP": "1.4.0",
-    "OPENJPEG": "2.5.2",
+    "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",
     "XZ": "5.6.3",
     "ZLIB": "1.3.1",

From 522505b714085ca94a2cab2a71e77a4fc5df7a3b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Dec 2024 17:52:34 +1100
Subject: [PATCH 1319/2374] Support saving CMYK JPEG2000 images

---
 Tests/test_file_jpeg2k.py     | 12 ++++++++++++
 src/libImaging/Jpeg2KEncode.c |  7 +++++++
 2 files changed, 19 insertions(+)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index fbf72ae0518..8bb290bf31d 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -325,6 +325,18 @@ def test_cmyk() -> None:
         assert im.getpixel((0, 0)) == (185, 134, 0, 0)
 
 
+@pytest.mark.skipif(
+    not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
+)
+@skip_unless_feature_version("jpg_2000", "2.5.3")
+def test_cmyk_save() -> None:
+    with Image.open(f"{EXTRA_DIR}/issue205.jp2") as jp2:
+        assert jp2.mode == "CMYK"
+
+        im = roundtrip(jp2)
+        assert_image_equal(im, jp2)
+
+
 @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/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index d30ccde603e..34d1a22949c 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -330,6 +330,13 @@ j2k_encode_entry(Imaging im, ImagingCodecState state) {
         components = 4;
         color_space = OPJ_CLRSPC_SRGB;
         pack = j2k_pack_rgba;
+#if ((OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR == 5 && OPJ_VERSION_BUILD >= 3) || \
+     (OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR > 5) || OPJ_VERSION_MAJOR > 2)
+    } else if (strcmp(im->mode, "CMYK") == 0) {
+        components = 4;
+        color_space = OPJ_CLRSPC_CMYK;
+        pack = j2k_pack_rgba;
+#endif
     } else {
         state->errcode = IMAGING_CODEC_BROKEN;
         state->state = J2K_STATE_FAILED;

From 9ed96704d3788fa58d9682d293c4190e5da07c2d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Dec 2024 07:28:48 +1100
Subject: [PATCH 1320/2374] Do not attempt to install cmake if it is already
 present

---
 wheels/multibuild | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/wheels/multibuild b/wheels/multibuild
index 9a9d1275f02..74a9795bc64 160000
--- a/wheels/multibuild
+++ b/wheels/multibuild
@@ -1 +1 @@
-Subproject commit 9a9d1275f025f737cdaa3c451ba07129dd95f361
+Subproject commit 74a9795bc64ff786b7e7d33bdec2843cf17e512e

From e361930936cd1208beeb292654a3af7548d863b3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Dec 2024 18:56:59 +1100
Subject: [PATCH 1321/2374] Updated libjpeg-turbo to 3.1.0

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 5f8a4cf78e4..86f51a586dc 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -40,7 +40,7 @@ ARCHIVE_SDIR=pillow-depends-main
 FREETYPE_VERSION=2.13.2
 HARFBUZZ_VERSION=10.1.0
 LIBPNG_VERSION=1.6.44
-JPEGTURBO_VERSION=3.0.4
+JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 1efe0dcac8b..fd104eb23f0 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.16",
     "HARFBUZZ": "10.1.0",
-    "JPEGTURBO": "3.0.4",
+    "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.44",
     "LIBWEBP": "1.4.0",
@@ -155,7 +155,7 @@ def cmd_msbuild(
             cmd_copy("cjpeg-static.exe", "cjpeg.exe"),
             cmd_copy("djpeg-static.exe", "djpeg.exe"),
         ],
-        "headers": ["j*.h"],
+        "headers": ["jconfig.h", r"src\j*.h"],
         "libs": ["libjpeg.lib"],
         "bins": ["cjpeg.exe", "djpeg.exe"],
     },

From 642b44c3159077d0863c29181c8c6fbe60039e5b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Dec 2024 01:25:28 +1100
Subject: [PATCH 1322/2374] Test libjpeg-turbo on macOS

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

diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index ddb4212301d..2301a3a7ef3 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -8,8 +8,8 @@ fi
 brew install \
     freetype \
     ghostscript \
+    jpeg-turbo \
     libimagequant \
-    libjpeg \
     libtiff \
     little-cms2 \
     openjpeg \

From 0e5f5fcb297b1e08ec83773562663b8ad9e53aee Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Dec 2024 16:33:20 +1100
Subject: [PATCH 1323/2374] Updated libXau to 1.0.12

---
 .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 86f51a586dc..36036ff2685 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -105,7 +105,7 @@ function build {
     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
+        build_simple libXau 1.0.12 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
     else
         sed s/\${pc_sysrootdir\}// $BUILD_PREFIX/share/pkgconfig/xcb-proto.pc > $BUILD_PREFIX/lib/pkgconfig/xcb-proto.pc

From 62d8ccc015d68a9bb3da555f9800786652de4962 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 15 Dec 2024 12:11:41 +1100
Subject: [PATCH 1324/2374] Derive dir from filename if root is the same

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

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 5bdb5fafedb..2d804d55778 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -131,7 +131,6 @@ def cmd_msbuild(
     "libjpeg": {
         "url": f"{SF_PROJECTS}/libjpeg-turbo/files/{V['JPEGTURBO']}/FILENAME/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=========="
@@ -161,7 +160,6 @@ def cmd_msbuild(
     "zlib": {
         "url": f"https://github.com/zlib-ng/zlib-ng/archive/refs/tags/{V['ZLIBNG']}.zip",
         "filename": f"zlib-ng-{V['ZLIBNG']}.zip",
-        "dir": f"zlib-ng-{V['ZLIBNG']}",
         "license": "LICENSE.md",
         "patch": {
             r"CMakeLists.txt": {
@@ -179,7 +177,6 @@ def cmd_msbuild(
     "xz": {
         "url": f"https://github.com/tukaani-project/xz/releases/download/v{V['XZ']}/FILENAME",
         "filename": f"xz-{V['XZ']}.tar.gz",
-        "dir": f"xz-{V['XZ']}",
         "license": "COPYING",
         "build": [
             *cmds_cmake("liblzma", "-DBUILD_SHARED_LIBS:BOOL=OFF"),
@@ -192,7 +189,6 @@ def cmd_msbuild(
     "libwebp": {
         "url": "http://downloads.webmproject.org/releases/webp/FILENAME",
         "filename": f"libwebp-{V['LIBWEBP']}.tar.gz",
-        "dir": f"libwebp-{V['LIBWEBP']}",
         "license": "COPYING",
         "patch": {
             r"src\enc\picture_csp_enc.c": {
@@ -214,7 +210,6 @@ def cmd_msbuild(
     "libtiff": {
         "url": "https://download.osgeo.org/libtiff/FILENAME",
         "filename": f"tiff-{V['TIFF']}.tar.gz",
-        "dir": f"tiff-{V['TIFF']}",
         "license": "LICENSE.md",
         "patch": {
             r"libtiff\tif_lzma.c": {
@@ -247,7 +242,6 @@ def cmd_msbuild(
         "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']}",
         "license": "LICENSE",
         "build": [
             *cmds_cmake("png_static", "-DPNG_SHARED:BOOL=OFF", "-DPNG_TESTS:BOOL=OFF"),
@@ -261,7 +255,6 @@ def cmd_msbuild(
     "brotli": {
         "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"),
@@ -272,7 +265,6 @@ def cmd_msbuild(
     "freetype": {
         "url": "https://download.savannah.gnu.org/releases/freetype/FILENAME",
         "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": {
@@ -307,7 +299,6 @@ def cmd_msbuild(
     "lcms2": {
         "url": f"{SF_PROJECTS}/lcms/files/lcms/{V['LCMS2']}/FILENAME/download",
         "filename": f"lcms2-{V['LCMS2']}.tar.gz",
-        "dir": f"lcms2-{V['LCMS2']}",
         "license": "LICENSE",
         "patch": {
             r"Projects\VC2022\lcms2_static\lcms2_static.vcxproj": {
@@ -333,7 +324,6 @@ def cmd_msbuild(
     "openjpeg": {
         "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(
@@ -348,7 +338,6 @@ def cmd_msbuild(
         # commit: Merge branch 'master' into msvc (matches 2.17.0 tag)
         "url": "https://github.com/ImageOptim/libimagequant/archive/e4c1334be0eff290af5e2b4155057c2953a313ab.zip",
         "filename": "libimagequant-e4c1334be0eff290af5e2b4155057c2953a313ab.zip",
-        "dir": "libimagequant-e4c1334be0eff290af5e2b4155057c2953a313ab",
         "license": "COPYRIGHT",
         "patch": {
             "CMakeLists.txt": {
@@ -368,7 +357,6 @@ def cmd_msbuild(
     "harfbuzz": {
         "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(
@@ -383,7 +371,6 @@ def cmd_msbuild(
     "fribidi": {
         "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-{V['FRIBIDI']}-COPYING"),
@@ -763,6 +750,8 @@ def main() -> None:
     }
 
     for k, v in DEPS.items():
+        if "dir" not in v:
+            v["dir"] = re.sub(r"\.(tar\.gz|zip)", "", v["filename"])
         prefs[f"dir_{k}"] = os.path.join(sources_dir, v["dir"])
 
     print()

From 6373e8bcc470ffa8849a17fa8e90e1146e0c3c6c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 15 Dec 2024 22:58:35 +1100
Subject: [PATCH 1325/2374] Use .tar.gz zlib to match macOS and Linux

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

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 5bdb5fafedb..a68a0b132b2 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -159,8 +159,8 @@ def cmd_msbuild(
         "bins": ["cjpeg.exe", "djpeg.exe"],
     },
     "zlib": {
-        "url": f"https://github.com/zlib-ng/zlib-ng/archive/refs/tags/{V['ZLIBNG']}.zip",
-        "filename": f"zlib-ng-{V['ZLIBNG']}.zip",
+        "url": f"https://github.com/zlib-ng/zlib-ng/archive/refs/tags/{V['ZLIBNG']}.tar.gz",
+        "filename": f"zlib-ng-{V['ZLIBNG']}.tar.gz",
         "dir": f"zlib-ng-{V['ZLIBNG']}",
         "license": "LICENSE.md",
         "patch": {

From 7f6ebfb8c597d8d1a074993f463992b6dac34c41 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 15 Dec 2024 23:40:38 +1100
Subject: [PATCH 1326/2374] Added release notes for #8500

---
 docs/releasenotes/11.1.0.rst | 59 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 2 files changed, 60 insertions(+)
 create mode 100644 docs/releasenotes/11.1.0.rst

diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
new file mode 100644
index 00000000000..c5d0afd58d8
--- /dev/null
+++ b/docs/releasenotes/11.1.0.rst
@@ -0,0 +1,59 @@
+11.1.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards Incompatible Changes
+==============================
+
+TODO
+^^^^
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+API Changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API Additions
+=============
+
+Check for zlib-ng
+^^^^^^^^^^^^^^^^^
+
+You can check if Pillow has been built against the zlib-ng version of the
+zlib library, and what version of zlib-ng is being used::
+
+    from PIL import features
+    features.check_feature("zlib_ng")  # True or False
+    features.version_feature("zlib_ng")  # "2.2.2" for example, or None
+
+Other Changes
+=============
+
+zlib-ng in wheels
+^^^^^^^^^^^^^^^^^
+
+Wheels are now built against zlib-ng for improved speed. In tests, saving a PNG
+was found to be more than twice as fast at higher compression levels.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 641cda4efb5..bd8e5536f71 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.1.0
   11.0.0
   10.4.0
   10.3.0

From 5e35ca359c4182af07c0c02e61ebd8d270bb34b3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Dec 2024 20:17:36 +1100
Subject: [PATCH 1327/2374] Updated libjpeg-turbo URL

---
 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 a68a0b132b2..e702c7014d7 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -129,7 +129,7 @@ def cmd_msbuild(
 # dependencies, listed in order of compilation
 DEPS: dict[str, dict[str, Any]] = {
     "libjpeg": {
-        "url": f"{SF_PROJECTS}/libjpeg-turbo/files/{V['JPEGTURBO']}/FILENAME/download",
+        "url": f"https://github.com/libjpeg-turbo/libjpeg-turbo/releases/download/{V['JPEGTURBO']}/libjpeg-turbo-{V['JPEGTURBO']}.tar.gz",
         "filename": f"libjpeg-turbo-{V['JPEGTURBO']}.tar.gz",
         "dir": f"libjpeg-turbo-{V['JPEGTURBO']}",
         "license": ["README.ijg", "LICENSE.md"],

From 095811452172bc4efd4be172f850c2f564e35cba Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Dec 2024 21:03:33 +1100
Subject: [PATCH 1328/2374] Corrected harfbuzz URL

---
 .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 de2471c3f30..3e2a14462dc 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -93,7 +93,7 @@ function build_harfbuzz {
     if [ -e harfbuzz-stamp ]; then return; 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)
+    local out_dir=$(fetch_unpack https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION/harfbuzz-$HARFBUZZ_VERSION.tar.xz harfbuzz-$HARFBUZZ_VERSION.tar.xz)
     (cd $out_dir \
         && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=release -Dfreetype=enabled -Dglib=disabled)
     (cd $out_dir/build \

From 962bfc6fd5e949cfdf8c0d18877acc2b8f82a78c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Dec 2024 10:39:52 +1100
Subject: [PATCH 1329/2374] Updated libjpeg-turbo URL

---
 wheels/multibuild | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/wheels/multibuild b/wheels/multibuild
index 74a9795bc64..42d761728d1 160000
--- a/wheels/multibuild
+++ b/wheels/multibuild
@@ -1 +1 @@
-Subproject commit 74a9795bc64ff786b7e7d33bdec2843cf17e512e
+Subproject commit 42d761728d141d8462cd9943f4329f12fe62b155

From de8335ba8fe121cf1f1b7b1565f535fb066094bf Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 18 Dec 2024 17:07:34 +1100
Subject: [PATCH 1330/2374] Extract tar files with "data" filter in Windows
 build scripts (#8606)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 winbuild/build_prepare.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 607f672ba9a..188872dfc69 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -7,6 +7,7 @@
 import shutil
 import struct
 import subprocess
+import sys
 from typing import Any
 
 
@@ -507,7 +508,10 @@ def extract_dep(url: str, filename: str, prefs: dict[str, str]) -> None:
                 if sources_dir_abs != member_prefix:
                     msg = "Attempted Path Traversal in Tar File"
                     raise RuntimeError(msg)
-            tgz.extractall(sources_dir)
+            if sys.version_info >= (3, 12):
+                tgz.extractall(sources_dir, filter="data")
+            else:
+                tgz.extractall(sources_dir)
     else:
         msg = "Unknown archive type: " + filename
         raise RuntimeError(msg)

From cbc55c4621b79176702bf14f188e5a439c7804a4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 18 Dec 2024 17:08:51 +1100
Subject: [PATCH 1331/2374] Raise ValueError when WMF inch is zero (#8600)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_wmf.py    | 7 +++++++
 src/PIL/WmfImagePlugin.py | 3 +++
 2 files changed, 10 insertions(+)

diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 424640d7b18..2f1f8cdbc85 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -35,6 +35,13 @@ def test_load() -> None:
             assert im.load()[0, 0] == (255, 255, 255)
 
 
+def test_load_zero_inch() -> None:
+    b = BytesIO(b"\xd7\xcd\xc6\x9a\x00\x00" + b"\x00" * 10)
+    with pytest.raises(ValueError):
+        with Image.open(b):
+            pass
+
+
 def test_register_handler(tmp_path: Path) -> None:
     class TestHandler(ImageFile.StubHandler):
         methodCalled = False
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index cad6c98d53f..48e9823e8ad 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -92,6 +92,9 @@ def _open(self) -> None:
 
             # get units per inch
             self._inch = word(s, 14)
+            if self._inch == 0:
+                msg = "Invalid inch"
+                raise ValueError(msg)
 
             # get bounding box
             x0 = short(s, 6)

From c6f42cb6a59aaaf29acf8831ef5865a688139480 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 20 Dec 2024 14:46:01 +1100
Subject: [PATCH 1332/2374] Updated libwebp to 1.5.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 3e2a14462dc..4e0fad79f4e 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -51,7 +51,7 @@ else
     GIFLIB_VERSION=5.2.1
 fi
 ZLIB_NG_VERSION=2.2.2
-LIBWEBP_VERSION=1.4.0
+LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
diff --git a/depends/install_webp.sh b/depends/install_webp.sh
index c47fb35f125..9d29777159e 100755
--- a/depends/install_webp.sh
+++ b/depends/install_webp.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 # install webp
 
-archive=libwebp-1.4.0
+archive=libwebp-1.5.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 188872dfc69..0674a9a1528 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ def cmd_msbuild(
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.44",
-    "LIBWEBP": "1.4.0",
+    "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",
     "XZ": "5.6.3",

From 5bd2f489fa7ed1ca4097cf15634d37723919434d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 20 Dec 2024 18:44:50 +1100
Subject: [PATCH 1333/2374] Install libjpeg-turbo8-dev (#8610)

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

diff --git a/.ci/install.sh b/.ci/install.sh
index e85e6bdc575..5c20e7f3727 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 libjpeg-turbo-progs libopenjp2-7-dev\
+                             ghostscript libjpeg-turbo8-dev libopenjp2-7-dev\
                              cmake meson imagemagick libharfbuzz-dev libfribidi-dev\
                              sway wl-clipboard libopenblas-dev
 fi

From cf4110ff06b4d4e0ec43b4a9ca13a28b7d3b11d2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 21 Dec 2024 00:55:44 +1100
Subject: [PATCH 1334/2374] Replace constants with enums (#8611)

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 1e289b6c38b..440728b08f2 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1565,7 +1565,7 @@ def get_child_images(self) -> list[ImageFile.ImageFile]:
                 for subifd_offset in subifd_offsets:
                     ifds.append((exif._get_ifd_dict(subifd_offset), subifd_offset))
         ifd1 = exif.get_ifd(ExifTags.IFD.IFD1)
-        if ifd1 and ifd1.get(513):
+        if ifd1 and ifd1.get(ExifTags.Base.JpegIFOffset):
             assert exif._info is not None
             ifds.append((ifd1, exif._info.next))
 
@@ -1577,11 +1577,11 @@ def get_child_images(self) -> list[ImageFile.ImageFile]:
 
             fp = self.fp
             if ifd is not None:
-                thumbnail_offset = ifd.get(513)
+                thumbnail_offset = ifd.get(ExifTags.Base.JpegIFOffset)
                 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))
+                    data = self.fp.read(ifd.get(ExifTags.Base.JpegIFByteCount))
                     fp = io.BytesIO(data)
 
             with open(fp) as im:

From 3d0f4389499314ca793f6244d13e00cd3ad44de0 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 21 Dec 2024 01:38:05 +0000
Subject: [PATCH 1335/2374] Update dependency mypy to v1.14.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 c84a3533b85..cd1b1a1a1dc 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.13.0
+mypy==1.14.0
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 08e1f9ebc11285c94a2706dd02146f685b10aec0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Dec 2024 13:04:17 +1100
Subject: [PATCH 1336/2374] Lint fixes

---
 Tests/test_color_lut.py | 2 ++
 src/PIL/ImageFilter.py  | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index 36ab187f261..baa899df5df 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -388,10 +388,12 @@ def test_numpy_sources(self) -> None:
 
         table = numpy.ones((7 * 6 * 5, 3), dtype=numpy.float16)
         lut = ImageFilter.Color3DLUT((5, 6, 7), table)
+        assert isinstance(lut.table, numpy.ndarray)
         assert lut.table.shape == (table.size,)
 
         table = numpy.ones((7 * 6 * 5 * 3), dtype=numpy.float16)
         lut = ImageFilter.Color3DLUT((5, 6, 7), table)
+        assert isinstance(lut.table, numpy.ndarray)
         assert lut.table.shape == (table.size,)
 
         # Check application
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 8b0974b2c37..b350e56f4f8 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -553,7 +553,7 @@ def transform(
         ch_out = channels or ch_in
         size_1d, size_2d, size_3d = self.size
 
-        table = [0] * (size_1d * size_2d * size_3d * ch_out)
+        table: list[float] = [0] * (size_1d * size_2d * size_3d * ch_out)
         idx_in = 0
         idx_out = 0
         for b in range(size_3d):

From b99a00f44f8e34c18b89395eaf67e796ecdf1bf0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 22 Dec 2024 07:24:08 +1100
Subject: [PATCH 1337/2374] Updated MakerNote IFD capitalization

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

diff --git a/src/PIL/ExifTags.py b/src/PIL/ExifTags.py
index 39b4aa55262..231e80f4080 100644
--- a/src/PIL/ExifTags.py
+++ b/src/PIL/ExifTags.py
@@ -352,7 +352,7 @@ class Interop(IntEnum):
 class IFD(IntEnum):
     Exif = 34665
     GPSInfo = 34853
-    Makernote = 37500
+    MakerNote = 37500
     Interop = 40965
     IFD1 = -1
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 1e289b6c38b..fb3f01fc8b8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3884,7 +3884,7 @@ class Exif(_ExifBase):
       gps_ifd = exif.get_ifd(ExifTags.IFD.GPSInfo)
       print(gps_ifd)
 
-    Other IFDs include ``ExifTags.IFD.Exif``, ``ExifTags.IFD.Makernote``,
+    Other IFDs include ``ExifTags.IFD.Exif``, ``ExifTags.IFD.MakerNote``,
     ``ExifTags.IFD.Interop`` and ``ExifTags.IFD.IFD1``.
 
     :py:mod:`~PIL.ExifTags` also has enum classes to provide names for data::
@@ -4047,11 +4047,11 @@ def get_ifd(self, tag: int) -> dict[int, Any]:
                     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]:
+            elif tag in [ExifTags.IFD.Interop, ExifTags.IFD.MakerNote]:
                 if ExifTags.IFD.Exif not in self._ifds:
                     self.get_ifd(ExifTags.IFD.Exif)
                 tag_data = self._ifds[ExifTags.IFD.Exif][tag]
-                if tag == ExifTags.IFD.Makernote:
+                if tag == ExifTags.IFD.MakerNote:
                     from .TiffImagePlugin import ImageFileDirectory_v2
 
                     if tag_data[:8] == b"FUJIFILM":
@@ -4138,7 +4138,7 @@ def get_ifd(self, tag: int) -> dict[int, Any]:
             ifd = {
                 k: v
                 for (k, v) in ifd.items()
-                if k not in (ExifTags.IFD.Interop, ExifTags.IFD.Makernote)
+                if k not in (ExifTags.IFD.Interop, ExifTags.IFD.MakerNote)
             }
         return ifd
 

From 5fe80e1c48eff0b74a14377107895c3e2d2f91b6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 22 Dec 2024 07:30:59 +1100
Subject: [PATCH 1338/2374] Use hex values more consistently

---
 src/PIL/ExifTags.py | 124 ++++++++++++++++++++++----------------------
 1 file changed, 62 insertions(+), 62 deletions(-)

diff --git a/src/PIL/ExifTags.py b/src/PIL/ExifTags.py
index 231e80f4080..207d4de4e24 100644
--- a/src/PIL/ExifTags.py
+++ b/src/PIL/ExifTags.py
@@ -303,38 +303,38 @@ class Base(IntEnum):
 
 
 class GPS(IntEnum):
-    GPSVersionID = 0
-    GPSLatitudeRef = 1
-    GPSLatitude = 2
-    GPSLongitudeRef = 3
-    GPSLongitude = 4
-    GPSAltitudeRef = 5
-    GPSAltitude = 6
-    GPSTimeStamp = 7
-    GPSSatellites = 8
-    GPSStatus = 9
-    GPSMeasureMode = 10
-    GPSDOP = 11
-    GPSSpeedRef = 12
-    GPSSpeed = 13
-    GPSTrackRef = 14
-    GPSTrack = 15
-    GPSImgDirectionRef = 16
-    GPSImgDirection = 17
-    GPSMapDatum = 18
-    GPSDestLatitudeRef = 19
-    GPSDestLatitude = 20
-    GPSDestLongitudeRef = 21
-    GPSDestLongitude = 22
-    GPSDestBearingRef = 23
-    GPSDestBearing = 24
-    GPSDestDistanceRef = 25
-    GPSDestDistance = 26
-    GPSProcessingMethod = 27
-    GPSAreaInformation = 28
-    GPSDateStamp = 29
-    GPSDifferential = 30
-    GPSHPositioningError = 31
+    GPSVersionID = 0x00
+    GPSLatitudeRef = 0x01
+    GPSLatitude = 0x02
+    GPSLongitudeRef = 0x03
+    GPSLongitude = 0x04
+    GPSAltitudeRef = 0x05
+    GPSAltitude = 0x06
+    GPSTimeStamp = 0x07
+    GPSSatellites = 0x08
+    GPSStatus = 0x09
+    GPSMeasureMode = 0x0A
+    GPSDOP = 0x0B
+    GPSSpeedRef = 0x0C
+    GPSSpeed = 0x0D
+    GPSTrackRef = 0x0E
+    GPSTrack = 0x0F
+    GPSImgDirectionRef = 0x10
+    GPSImgDirection = 0x11
+    GPSMapDatum = 0x12
+    GPSDestLatitudeRef = 0x13
+    GPSDestLatitude = 0x14
+    GPSDestLongitudeRef = 0x15
+    GPSDestLongitude = 0x16
+    GPSDestBearingRef = 0x17
+    GPSDestBearing = 0x18
+    GPSDestDistanceRef = 0x19
+    GPSDestDistance = 0x1A
+    GPSProcessingMethod = 0x1B
+    GPSAreaInformation = 0x1C
+    GPSDateStamp = 0x1D
+    GPSDifferential = 0x1E
+    GPSHPositioningError = 0x1F
 
 
 """Maps EXIF GPS tags to tag names."""
@@ -342,40 +342,40 @@ class GPS(IntEnum):
 
 
 class Interop(IntEnum):
-    InteropIndex = 1
-    InteropVersion = 2
-    RelatedImageFileFormat = 4096
-    RelatedImageWidth = 4097
-    RelatedImageHeight = 4098
+    InteropIndex = 0x0001
+    InteropVersion = 0x0002
+    RelatedImageFileFormat = 0x1000
+    RelatedImageWidth = 0x1001
+    RelatedImageHeight = 0x1002
 
 
 class IFD(IntEnum):
-    Exif = 34665
-    GPSInfo = 34853
-    MakerNote = 37500
-    Interop = 40965
+    Exif = 0x8769
+    GPSInfo = 0x8825
+    MakerNote = 0x927C
+    Interop = 0xA005
     IFD1 = -1
 
 
 class LightSource(IntEnum):
-    Unknown = 0
-    Daylight = 1
-    Fluorescent = 2
-    Tungsten = 3
-    Flash = 4
-    Fine = 9
-    Cloudy = 10
-    Shade = 11
-    DaylightFluorescent = 12
-    DayWhiteFluorescent = 13
-    CoolWhiteFluorescent = 14
-    WhiteFluorescent = 15
-    StandardLightA = 17
-    StandardLightB = 18
-    StandardLightC = 19
-    D55 = 20
-    D65 = 21
-    D75 = 22
-    D50 = 23
-    ISO = 24
-    Other = 255
+    Unknown = 0x00
+    Daylight = 0x01
+    Fluorescent = 0x02
+    Tungsten = 0x03
+    Flash = 0x04
+    Fine = 0x09
+    Cloudy = 0x0A
+    Shade = 0x0B
+    DaylightFluorescent = 0x0C
+    DayWhiteFluorescent = 0x0D
+    CoolWhiteFluorescent = 0x0E
+    WhiteFluorescent = 0x0F
+    StandardLightA = 0x11
+    StandardLightB = 0x12
+    StandardLightC = 0x13
+    D55 = 0x14
+    D65 = 0x15
+    D75 = 0x16
+    D50 = 0x17
+    ISO = 0x18
+    Other = 0xFF

From 0074c3bf349f0055aaff73fd7864c6a5e785b220 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 23 Dec 2024 11:45:36 +1100
Subject: [PATCH 1339/2374] Assert that a tuple is returned by getpixel()

---
 Tests/test_file_dds.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 9a826ebe8ca..7cc4d79d4e0 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -331,11 +331,13 @@ def test_dxt5_colorblock_alpha_issue_4142() -> None:
 
     with Image.open("Tests/images/dxt5-colorblock-alpha-issue-4142.dds") as im:
         px = im.getpixel((0, 0))
+        assert isinstance(px, tuple)
         assert px[0] != 0
         assert px[1] != 0
         assert px[2] != 0
 
         px = im.getpixel((1, 0))
+        assert isinstance(px, tuple)
         assert px[0] != 0
         assert px[1] != 0
         assert px[2] != 0

From 5d5543b35caacef1a7f5912caa14b9d257680291 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 23 Dec 2024 11:57:27 +1100
Subject: [PATCH 1340/2374] Assert that load() does not return None

---
 Tests/test_file_eps.py    |  8 ++++++--
 Tests/test_file_gbr.py    |  6 +++++-
 Tests/test_file_gif.py    | 22 +++++++++++++++++-----
 Tests/test_file_icns.py   |  8 ++++++--
 Tests/test_file_ico.py    |  4 +++-
 Tests/test_file_jpeg2k.py |  1 +
 Tests/test_file_ppm.py    |  1 +
 Tests/test_file_tga.py    |  8 ++++++--
 Tests/test_file_wal.py    |  8 ++++++--
 Tests/test_file_wmf.py    |  4 +++-
 10 files changed, 54 insertions(+), 16 deletions(-)

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index 672c04a4d4f..a0c2f921629 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -95,10 +95,14 @@ def test_sanity(filename: str, size: tuple[int, int], scale: int) -> None:
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 def test_load() -> None:
     with Image.open(FILE1) as im:
-        assert im.load()[0, 0] == (255, 255, 255)
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == (255, 255, 255)
 
         # Test again now that it has already been loaded once
-        assert im.load()[0, 0] == (255, 255, 255)
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == (255, 255, 255)
 
 
 def test_binary() -> None:
diff --git a/Tests/test_file_gbr.py b/Tests/test_file_gbr.py
index be98b08f2ad..5b59cc07ac9 100644
--- a/Tests/test_file_gbr.py
+++ b/Tests/test_file_gbr.py
@@ -14,10 +14,14 @@ def test_gbr_file() -> None:
 
 def test_load() -> None:
     with Image.open("Tests/images/gbr.gbr") as im:
+        px = im.load()
+        assert px is not None
         assert im.load()[0, 0] == (0, 0, 0, 0)
 
         # Test again now that it has already been loaded once
-        assert im.load()[0, 0] == (0, 0, 0, 0)
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == (0, 0, 0, 0)
 
 
 def test_multiple_load_operations() -> None:
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 5d46b157d55..f25d819ea15 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -86,12 +86,16 @@ def test_invalid_file() -> None:
 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
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == 128
         assert im.info["transparency"] == 255
 
         im.seek(1)
         assert im.mode == "L"
-        assert im.load()[0, 0] == 128
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == 128
 
 
 def test_l_mode_after_rgb() -> None:
@@ -310,7 +314,9 @@ 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()
-        original_color = im.convert("RGB").load()[0, 0]
+        px = im.convert("RGB").load()
+        assert px is not None
+        original_color = px[0, 0]
 
         im.seek(1)
         assert im.mode == mode
@@ -318,10 +324,14 @@ def test_loading_multiple_palettes(path: str, mode: str) -> None:
             im = im.convert("RGB")
 
         # Check a color only from the old palette
-        assert im.load()[0, 0] == original_color
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == original_color
 
         # Check a color from the new palette
-        assert im.load()[24, 24] not in first_frame_colors
+        px = im.load()
+        assert px is not None
+        assert px[24, 24] not in first_frame_colors
 
 
 def test_headers_saving_for_animated_gifs(tmp_path: Path) -> None:
@@ -488,6 +498,7 @@ def test_eoferror() -> None:
 def test_first_frame_transparency() -> None:
     with Image.open("Tests/images/first_frame_transparency.gif") as im:
         px = im.load()
+        assert px is not None
         assert px[0, 0] == im.info["transparency"]
 
 
@@ -528,6 +539,7 @@ def test_dispose_background_transparency() -> None:
     with Image.open("Tests/images/dispose_bgnd_transparency.gif") as img:
         img.seek(2)
         px = img.load()
+        assert px is not None
         assert px[35, 30][3] == 0
 
 
diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index 141b88dfa01..94f16aeecb6 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -32,10 +32,14 @@ def test_sanity() -> None:
 
 def test_load() -> None:
     with Image.open(TEST_FILE) as im:
-        assert im.load()[0, 0] == (0, 0, 0, 0)
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == (0, 0, 0, 0)
 
         # Test again now that it has already been loaded once
-        assert im.load()[0, 0] == (0, 0, 0, 0)
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == (0, 0, 0, 0)
 
 
 def test_save(tmp_path: Path) -> None:
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 37770498a0a..10f3aac9aa8 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -24,7 +24,9 @@ def test_sanity() -> None:
 
 def test_load() -> None:
     with Image.open(TEST_ICO_FILE) as im:
-        assert im.load()[0, 0] == (1, 1, 9, 255)
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == (1, 1, 9, 255)
 
 
 def test_mask() -> None:
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index fbf72ae0518..b761fcd3724 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -63,6 +63,7 @@ def test_sanity() -> None:
 
     with Image.open("Tests/images/test-card-lossless.jp2") as im:
         px = im.load()
+        assert px is not None
         assert px[0, 0] == (0, 0, 0)
         assert im.mode == "RGB"
         assert im.size == (640, 480)
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index fb08d613a56..f4acedb3078 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -79,6 +79,7 @@ def test_arbitrary_maxval(
         assert im.mode == mode
 
         px = im.load()
+        assert px is not None
         assert tuple(px[x, 0] for x in range(3)) == pixels
 
 
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index a03a6a6e10a..63d1e7615bd 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -213,10 +213,14 @@ def test_save_orientation(tmp_path: Path) -> None:
 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)
+        px = im.load()
+        assert px is not None
+        assert px[90, 90][:3] == (0, 0, 0)
 
     with Image.open("Tests/images/rgb32rle_bottom_right.tga") as im:
-        assert im.load()[90, 90][:3] == (0, 255, 0)
+        px = im.load()
+        assert px is not None
+        assert px[90, 90][:3] == (0, 255, 0)
 
 
 def test_save_rle(tmp_path: Path) -> None:
diff --git a/Tests/test_file_wal.py b/Tests/test_file_wal.py
index b34975e8380..b15d79d61e0 100644
--- a/Tests/test_file_wal.py
+++ b/Tests/test_file_wal.py
@@ -21,7 +21,11 @@ def test_open() -> None:
 
 def test_load() -> None:
     with WalImageFile.open(TEST_FILE) as im:
-        assert im.load()[0, 0] == 122
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == 122
 
         # Test again now that it has already been loaded once
-        assert im.load()[0, 0] == 122
+        px = im.load()
+        assert px is not None
+        assert px[0, 0] == 122
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 2f1f8cdbc85..f849453f6ce 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -32,7 +32,9 @@ def test_load_raw() -> None:
 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)
+            px = im.load()
+            assert px is not None
+            assert px[0, 0] == (255, 255, 255)
 
 
 def test_load_zero_inch() -> None:

From 601a56def1dfdacd76759302595d9d904f2467c8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 23 Dec 2024 12:03:13 +1100
Subject: [PATCH 1341/2374] Assert palette is not None

---
 Tests/test_file_gif.py        | 2 ++
 Tests/test_file_jpeg2k.py     | 2 ++
 Tests/test_file_tga.py        | 1 +
 Tests/test_image.py           | 1 +
 Tests/test_image_convert.py   | 1 +
 Tests/test_image_transform.py | 1 +
 Tests/test_imagepalette.py    | 1 +
 7 files changed, 9 insertions(+)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index f25d819ea15..9fe5f4fbbf7 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -313,6 +313,7 @@ def test_roundtrip_save_all_1(tmp_path: Path) -> None:
 def test_loading_multiple_palettes(path: str, mode: str) -> None:
     with Image.open(path) as im:
         assert im.mode == "P"
+        assert im.palette is not None
         first_frame_colors = im.palette.colors.keys()
         px = im.convert("RGB").load()
         assert px is not None
@@ -1325,6 +1326,7 @@ def test_palette_save_all_P(tmp_path: Path) -> None:
     with Image.open(out) as im:
         # Assert that the frames are correct, and each frame has the same palette
         assert_image_equal(im.convert("RGB"), frames[0].convert("RGB"))
+        assert im.palette is not None
         assert im.palette.palette == im.global_palette.palette
 
         im.seek(1)
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index b761fcd3724..af6b9b2db2f 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -413,6 +413,7 @@ def test_subsampling_decode(name: str) -> None:
 def test_pclr() -> None:
     with Image.open(f"{EXTRA_DIR}/issue104_jpxstream.jp2") as im:
         assert im.mode == "P"
+        assert im.palette is not None
         assert len(im.palette.colors) == 256
         assert im.palette.colors[(255, 255, 255)] == 0
 
@@ -420,6 +421,7 @@ def test_pclr() -> None:
         f"{EXTRA_DIR}/147af3f1083de4393666b7d99b01b58b_signal_sigsegv_130c531_6155_5136.jp2"
     ) as im:
         assert im.mode == "P"
+        assert im.palette is not None
         assert len(im.palette.colors) == 139
         assert im.palette.colors[(0, 0, 0, 0)] == 0
 
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index 63d1e7615bd..b6396bd64b3 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -72,6 +72,7 @@ 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 im.palette is not None
         assert im.palette.mode == "RGBA"
         assert_image_equal_tofile(im.convert("RGBA"), "Tests/images/p_16.png")
 
diff --git a/Tests/test_image.py b/Tests/test_image.py
index c8df474f493..1d7bd19ca0e 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -662,6 +662,7 @@ def test_remap_palette(self) -> None:
         im.putpalette(list(range(256)) * 4, "RGBA")
         im_remapped = im.remap_palette(list(range(256)))
         assert_image_equal(im, im_remapped)
+        assert im.palette is not None
         assert im.palette.palette == im_remapped.palette.palette
 
         # Test illegal image mode
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 6a925975eaa..03061ceb1ee 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -236,6 +236,7 @@ def test_gif_with_rgba_palette_to_p() -> None:
     with Image.open("Tests/images/hopper.gif") as im:
         im.info["transparency"] = 255
         im.load()
+        assert im.palette is not None
         assert im.palette.mode == "RGB"
         im_p = im.convert("P")
 
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 7e83396def7..77916929bb5 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -47,6 +47,7 @@ def test_palette(self) -> None:
             transformed = im.transform(
                 im.size, Image.Transform.AFFINE, [1, 0, 0, 0, 1, 0]
             )
+            assert im.palette is not None
             assert im.palette.palette == transformed.palette.palette
 
     def test_extent(self) -> None:
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 6cf0079dda7..e2f8308ea81 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -17,6 +17,7 @@ def test_sanity() -> None:
 def test_reload() -> None:
     with Image.open("Tests/images/hopper.gif") as im:
         original = im.copy()
+        assert im.palette is not None
         im.palette.dirty = 1
         assert_image_equal(im.convert("RGB"), original.convert("RGB"))
 

From fb3d80e390b8ed3111a4658755b035f5e20eb5e0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 24 Dec 2024 00:41:27 +1100
Subject: [PATCH 1342/2374] Fixed connecting discontiguous corners

---
 .../imagedraw/discontiguous_corners_polygon.png | Bin 486 -> 533 bytes
 Tests/test_imagedraw.py                         |   3 +++
 src/libImaging/Draw.c                           |   9 ++++-----
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/Tests/images/imagedraw/discontiguous_corners_polygon.png b/Tests/images/imagedraw/discontiguous_corners_polygon.png
index 509c42b26e0cbc5e01853915b083d367c1587579..1b58889c8f3ae45243a7509c907f1928534bcbde 100644
GIT binary patch
delta 507
zcmV<X0R;Z$1C<1jB!ApVL_t(|ob8%RlEWYjM7jT=xSD4(l}h0;=+{zXMhkXH^!f=0
zJ88Z5>$=WdTX_c%swU!U485w>wyG`7FR7NL{=~F7gqE=@exLJl^>&(VxOp^oSf8ia
zhL}fVLnf5pHi+D7J^>rS>@}Z&jbnD1M`NRzjpotVIm~MFXn*Xdtc%T~u_cKYm`7u4
zb5Aml#`f$rpm{%7q?w2WMdmZ9Jmv$tYM1zlSN<x2_e=rxGdwxGZ3;-8o6V~dX&rx-
zfSNa__J?^%x+LbE+0FL6Bs_FRQSblsKC)jnqRVDJc8+G|6H<^HLrjy@eC)m$YMwRj
zYN9reO94T+?teTyQBNiF1Lul=3R0dEvQ9zjq_Isw+1Z|93hGbwh5TH1b;-M+-n=1&
zcbZr2i`SZ$r|@#~l6~=h^UD-YF+bTC2bq6L;W+c^jLJJGTz`MDIk5WYx&49lZys=R
zqFSHe*X9|zw_nf9=69chC6sQ@m-9I1{BBfzwJ&G$*mNFT8n5={oHpCvWidazepB)m
z^*z7KoDbzSU&tTQbL0t+-}caL{MmjB@&-NI6VCa)L+o80o9&^ujJrA>+e25z{{|T<
xlUzDe$vZP-&cnLR`F<MM=Go<Sl1xsu{s26(P_`H)n_mC`002ovPDHLkV1nhN2NwVU

delta 460
zcmV;-0W<!U1m**fB!8_*L_t(|ob8!QvcfP71a<#I<!WI|ImEU;qo2{j8;W9DEt&8h
zUDtKr_n9Y!Con&Wh-iz8!n4ZQCRNh>l4@D(PjuQYa0yf8_c<?Bw$p6G&7-l+a-L=z
zVjhhRnb7>ULF8KV4%i50t$7D*9J9(i8XL_lG>^viVP>00V}E-xGt8s0{h7DSqp_oy
z7v|B}vCOaL^<WvO*ycM?G0b;mW0*hi%yRdHnNN5R$C#g7c;Q(g=6`oZS{bN>=6`p{
zx-yW@%sX@;oL`>6ss&}t<GN7HJYp~EnK$o3Rr7{>QP{jy7s{L0??ngmnl7|5FWZZ5
z<^^5oX`ZzgZGX-0ccHoYoxSL9e%Xan%un{>AoFjtaGZJeq=YAkoRJ&<-`JdWJ^yZh
zPW{aTo}5yhZ}4mL8Pdz|GqL&VQ?P{M?R+?oa?YPd*|&W-o5uFwQh3{kbINRgm&E+=
z{-We$^*vu@&WF;P59Bw=Z25$j-}aE!{@K0+IYFQ86GhJXGa>d@T{hc8HjiI*d2A1<
zc9ZEp%#(a~rkpp^WX{df`g}hP-I2X&ex`d$_dGxT#Oc95ub{>N0000<MNUMnLSTZ$
C9QgkL

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index ed50dfbedf3..5fc1c27661a 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1674,6 +1674,9 @@ def test_continuous_horizontal_edges_polygon() -> None:
 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(
+        ((82, 29), (82, 26), (82, 24), (67, 22), (52, 29), (52, 15), (67, 22)), BLACK
+    )
     draw.polygon(((71, 44), (38, 27), (1, 24)), BLACK)
     draw.polygon(
         ((38, 66), (5, 49), (77, 49), (47, 66), (82, 63), (82, 47), (1, 47), (1, 63)),
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index f1c8ffcff8d..ea6f8805efb 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -501,7 +501,8 @@ polygon_generic(
                     // 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 && j % 2 == 1 &&
+                           roundf(xx[j - 1]) == xx[j - 1]) {
                     // Connect discontiguous corners
                     for (k = 0; k < i; k++) {
                         Edge *other_edge = edge_table[k];
@@ -510,10 +511,8 @@ polygon_generic(
                             continue;
                         }
                         // 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) {
+                        if (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;

From dd410e4b32c6b7e412304f30c27b8a226c24ebd3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 26 Dec 2024 10:51:45 +1100
Subject: [PATCH 1343/2374] Added reading of J2K comments

---
 Tests/test_file_jpeg2k.py    | 5 +++--
 src/PIL/Jpeg2KImagePlugin.py | 8 ++++----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index fbf72ae0518..34176d3cecb 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -424,8 +424,9 @@ def test_pclr() -> None:
 
 
 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"
+    for path in ("Tests/images/9bit.j2k", "Tests/images/comment.jp2"):
+        with Image.open(path) as im:
+            assert im.info["comment"] == b"Created by OpenJPEG version 2.5.0"
 
     # Test an image that is truncated partway through a codestream
     with open("Tests/images/comment.jp2", "rb") as fp:
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index b6ebd562be6..67828358d37 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -252,6 +252,7 @@ def _open(self) -> None:
         if sig == b"\xff\x4f\xff\x51":
             self.codec = "j2k"
             self._size, self._mode = _parse_codestream(self.fp)
+            self._parse_comment()
         else:
             sig = sig + self.fp.read(8)
 
@@ -262,6 +263,9 @@ def _open(self) -> None:
                 if dpi is not None:
                     self.info["dpi"] = dpi
                 if self.fp.read(12).endswith(b"jp2c\xff\x4f\xff\x51"):
+                    hdr = self.fp.read(2)
+                    length = _binary.i16be(hdr)
+                    self.fp.seek(length - 2, os.SEEK_CUR)
                     self._parse_comment()
             else:
                 msg = "not a JPEG 2000 file"
@@ -296,10 +300,6 @@ def _open(self) -> None:
         ]
 
     def _parse_comment(self) -> None:
-        hdr = self.fp.read(2)
-        length = _binary.i16be(hdr)
-        self.fp.seek(length - 2, os.SEEK_CUR)
-
         while True:
             marker = self.fp.read(2)
             if not marker:

From 62b7cb62f4ee339677170b0d0fa5943e490ddab7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 26 Dec 2024 19:06:23 +1100
Subject: [PATCH 1344/2374] Fixed indentation

---
 src/_imagingcms.c | 56 +++++++++++++++++++++++------------------------
 src/display.c     | 14 +++++++-----
 2 files changed, 36 insertions(+), 34 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 1823bcf0371..1805ebde17f 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -346,10 +346,10 @@ pyCMSdoTransform(Imaging im, Imaging imOut, cmsHTRANSFORM hTransform) {
         return -1;
     }
 
-    Py_BEGIN_ALLOW_THREADS
+    Py_BEGIN_ALLOW_THREADS;
 
-        // transform color channels only
-        for (i = 0; i < im->ysize; i++) {
+    // transform color channels only
+    for (i = 0; i < im->ysize; i++) {
         cmsDoTransform(hTransform, im->image[i], imOut->image[i], im->xsize);
     }
 
@@ -362,9 +362,9 @@ pyCMSdoTransform(Imaging im, Imaging imOut, cmsHTRANSFORM hTransform) {
     // enough available on all platforms, so we polyfill it here for now.
     pyCMScopyAux(hTransform, imOut, im);
 
-    Py_END_ALLOW_THREADS
+    Py_END_ALLOW_THREADS;
 
-        return 0;
+    return 0;
 }
 
 static cmsHTRANSFORM
@@ -378,17 +378,17 @@ _buildTransform(
 ) {
     cmsHTRANSFORM hTransform;
 
-    Py_BEGIN_ALLOW_THREADS
+    Py_BEGIN_ALLOW_THREADS;
 
-        /* create the transform */
-        hTransform = cmsCreateTransform(
-            hInputProfile,
-            findLCMStype(sInMode),
-            hOutputProfile,
-            findLCMStype(sOutMode),
-            iRenderingIntent,
-            cmsFLAGS
-        );
+    /* create the transform */
+    hTransform = cmsCreateTransform(
+        hInputProfile,
+        findLCMStype(sInMode),
+        hOutputProfile,
+        findLCMStype(sOutMode),
+        iRenderingIntent,
+        cmsFLAGS
+    );
 
     Py_END_ALLOW_THREADS;
 
@@ -412,19 +412,19 @@ _buildProofTransform(
 ) {
     cmsHTRANSFORM hTransform;
 
-    Py_BEGIN_ALLOW_THREADS
-
-        /* create the transform */
-        hTransform = cmsCreateProofingTransform(
-            hInputProfile,
-            findLCMStype(sInMode),
-            hOutputProfile,
-            findLCMStype(sOutMode),
-            hProofProfile,
-            iRenderingIntent,
-            iProofIntent,
-            cmsFLAGS
-        );
+    Py_BEGIN_ALLOW_THREADS;
+
+    /* create the transform */
+    hTransform = cmsCreateProofingTransform(
+        hInputProfile,
+        findLCMStype(sInMode),
+        hOutputProfile,
+        findLCMStype(sOutMode),
+        hProofProfile,
+        iRenderingIntent,
+        iProofIntent,
+        cmsFLAGS
+    );
 
     Py_END_ALLOW_THREADS;
 
diff --git a/src/display.c b/src/display.c
index b4e2e38991a..eed75975d71 100644
--- a/src/display.c
+++ b/src/display.c
@@ -690,24 +690,26 @@ PyImaging_CreateWindowWin32(PyObject *self, PyObject *args) {
     SetWindowLongPtr(wnd, 0, (LONG_PTR)callback);
     SetWindowLongPtr(wnd, sizeof(callback), (LONG_PTR)PyThreadState_Get());
 
-    Py_BEGIN_ALLOW_THREADS ShowWindow(wnd, SW_SHOWNORMAL);
+    Py_BEGIN_ALLOW_THREADS;
+    ShowWindow(wnd, SW_SHOWNORMAL);
     SetForegroundWindow(wnd); /* to make sure it's visible */
-    Py_END_ALLOW_THREADS
+    Py_END_ALLOW_THREADS;
 
-        return Py_BuildValue(F_HANDLE, wnd);
+    return Py_BuildValue(F_HANDLE, wnd);
 }
 
 PyObject *
 PyImaging_EventLoopWin32(PyObject *self, PyObject *args) {
     MSG msg;
 
-    Py_BEGIN_ALLOW_THREADS while (mainloop && GetMessage(&msg, NULL, 0, 0)) {
+    Py_BEGIN_ALLOW_THREADS;
+    while (mainloop && GetMessage(&msg, NULL, 0, 0)) {
         TranslateMessage(&msg);
         DispatchMessage(&msg);
     }
-    Py_END_ALLOW_THREADS
+    Py_END_ALLOW_THREADS;
 
-        Py_INCREF(Py_None);
+    Py_INCREF(Py_None);
     return Py_None;
 }
 

From 622722f295ab137ea6bf54ede8efb8f376d1194b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 26 Dec 2024 20:04:27 +1100
Subject: [PATCH 1345/2374] Corrected loadImageSeries type hint

---
 src/PIL/SpiderImagePlugin.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 075073f9fe3..c83d02885ff 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -211,26 +211,27 @@ def tkPhotoImage(self) -> ImageTk.PhotoImage:
 
 
 # given a list of filenames, return a list of images
-def loadImageSeries(filelist: list[str] | None = None) -> list[SpiderImageFile] | None:
+def loadImageSeries(filelist: list[str] | None = None) -> list[Image.Image] | 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 None
 
-    imglist = []
+    byte_imgs = []
     for img in filelist:
         if not os.path.exists(img):
             print(f"unable to find {img}")
             continue
         try:
             with Image.open(img) as im:
-                im = im.convert2byte()
+                assert isinstance(im, SpiderImageFile)
+                byte_im = im.convert2byte()
         except Exception:
             if not isSpiderImage(img):
                 print(f"{img} is not a Spider image file")
             continue
-        im.info["filename"] = img
-        imglist.append(im)
-    return imglist
+        byte_im.info["filename"] = img
+        byte_imgs.append(byte_im)
+    return byte_imgs
 
 
 # --------------------------------------------------------------------

From 2ea3ea94a117772532e6f04ae7284c5842392af4 Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Thu, 26 Dec 2024 21:41:51 +0100
Subject: [PATCH 1346/2374] Skip failing WMF records on 32-bit Windows

---
 Tests/test_file_wmf.py | 2 --
 src/display.c          | 9 +--------
 2 files changed, 1 insertion(+), 10 deletions(-)

diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 9322bd0c53b..d3cad7ca481 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -1,6 +1,5 @@
 from __future__ import annotations
 
-import sys
 from io import BytesIO
 from pathlib import Path
 from typing import IO
@@ -43,7 +42,6 @@ def test_load_zero_inch() -> None:
             pass
 
 
-@pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
 def test_render() -> None:
     with open("Tests/images/drawing.emf", "rb") as fp:
         data = fp.read()
diff --git a/src/display.c b/src/display.c
index fe5801fc0e6..b5e9c2a3db7 100644
--- a/src/display.c
+++ b/src/display.c
@@ -716,7 +716,7 @@ PyImaging_EventLoopWin32(PyObject *self, PyObject *args) {
 
 #define GET32(p, o) ((DWORD *)(p + o))[0]
 
-int
+static int CALLBACK
 enhMetaFileProc(
     HDC hdc, HANDLETABLE *lpht, const ENHMETARECORD *lpmr, int nHandles, LPARAM data
 ) {
@@ -804,14 +804,7 @@ PyImaging_DrawWmf(PyObject *self, PyObject *args) {
     /* FIXME: make background transparent? configurable? */
     FillRect(dc, &rect, GetStockObject(WHITE_BRUSH));
 
-#ifdef _WIN64
     EnumEnhMetaFile(dc, meta, enhMetaFileProc, NULL, &rect);
-#else
-    if (!PlayEnhMetaFile(dc, meta, &rect)) {
-        PyErr_SetString(PyExc_OSError, "cannot render metafile");
-        goto error;
-    }
-#endif
 
     /* step 4: extract bits from bitmap */
 

From aef3aa2ab35fdf847aa13017c5b4b315562a1f77 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Dec 2024 11:26:07 +1100
Subject: [PATCH 1347/2374] Pass file handle to ContainerIO

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

diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 237045acc7b..597ab508342 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -4,8 +4,6 @@
 
 from PIL import ContainerIO, Image
 
-from .helper import hopper
-
 TEST_FILE = "Tests/images/dummy.container"
 
 
@@ -15,15 +13,15 @@ def test_sanity() -> None:
 
 
 def test_isatty() -> None:
-    with hopper() as im:
-        container = ContainerIO.ContainerIO(im, 0, 0)
+    with open(TEST_FILE, "rb") as fh:
+        container = ContainerIO.ContainerIO(fh, 0, 0)
 
     assert container.isatty() is False
 
 
 def test_seekable() -> None:
-    with hopper() as im:
-        container = ContainerIO.ContainerIO(im, 0, 0)
+    with open(TEST_FILE, "rb") as fh:
+        container = ContainerIO.ContainerIO(fh, 0, 0)
 
     assert container.seekable() is True
 

From 0148684c2412cc69b9606e7e2b6d5d581030e41c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Dec 2024 11:29:47 +1100
Subject: [PATCH 1348/2374] Use monkeypatch

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

diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 01bd4b1d76b..aa625f22960 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -104,20 +104,20 @@ def test_transposed() -> None:
         assert im.size == (590, 88)
 
 
-def test_load_first_unless_jpeg() -> None:
+def test_load_first_unless_jpeg(monkeypatch: pytest.MonkeyPatch) -> None:
     # Test that thumbnail() still uses draft() for JPEG
     with Image.open("Tests/images/hopper.jpg") as im:
-        draft = im.draft
+        original_draft = im.draft
 
         def im_draft(
             mode: str, size: tuple[int, int]
         ) -> tuple[str, tuple[int, int, float, float]] | None:
-            result = draft(mode, size)
+            result = original_draft(mode, size)
             assert result is not None
 
             return result
 
-        im.draft = im_draft
+        monkeypatch.setattr(im, "draft", im_draft)
 
         im.thumbnail((64, 64))
 

From 89f1498796be0053bc40ef757680c9f7bc49e7ce Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Dec 2024 11:38:47 +1100
Subject: [PATCH 1349/2374] Updated argument types to match Image draft

---
 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 aa625f22960..1181f6fcaca 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -110,7 +110,7 @@ def test_load_first_unless_jpeg(monkeypatch: pytest.MonkeyPatch) -> None:
         original_draft = im.draft
 
         def im_draft(
-            mode: str, size: tuple[int, int]
+            mode: str | None, size: tuple[int, int] | None
         ) -> tuple[str, tuple[int, int, float, float]] | None:
             result = original_draft(mode, size)
             assert result is not None

From 0220b025c5f56ebe4c2f1678e24195672d4d4373 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 12:33:59 +1100
Subject: [PATCH 1350/2374] Updated documentation for #7947 and #8592

---
 docs/handbook/image-file-formats.rst | 8 +++++---
 docs/releasenotes/11.1.0.rst         | 5 +++++
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index bf3087f6f68..364e1802ae5 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -573,9 +573,11 @@ Pillow reads and writes JPEG 2000 files containing ``L``, ``LA``, ``RGB``,
 ``RGBA``, or ``YCbCr`` data.  When reading, ``YCbCr`` data is converted to
 ``RGB`` or ``RGBA`` depending on whether or not there is an alpha channel.
 Beginning with version 8.3.0, Pillow can read (but not write) ``RGB``,
-``RGBA``, and ``YCbCr`` images with subsampled components.  Pillow supports
-JPEG 2000 raw codestreams (``.j2k`` files), as well as boxed JPEG 2000 files
-(``.jp2`` or ``.jpx`` files).
+``RGBA``, and ``YCbCr`` images with subsampled components. Pillow 10.4.0 and
+later can read ``CMYK`` images with OpenJPEG 2.5.1 and later, and Pillow 11.1.0
+and later can write ``CMYK`` images with OpenJPEG 2.5.3 and later. Pillow
+supports JPEG 2000 raw codestreams (``.j2k`` files), as well as boxed JPEG 2000
+files (``.jp2`` or ``.jpx`` files).
 
 When loading, if you set the ``mode`` on the image prior to the
 :py:meth:`~PIL.Image.Image.load` method being invoked, you can ask Pillow to
diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
index c5d0afd58d8..7fd622beb30 100644
--- a/docs/releasenotes/11.1.0.rst
+++ b/docs/releasenotes/11.1.0.rst
@@ -52,6 +52,11 @@ zlib library, and what version of zlib-ng is being used::
 Other Changes
 =============
 
+Saving JPEG 2000 CMYK images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+With OpenJPEG 2.5.3 or later, Pillow can now save CMYK images as JPEG 2000 files.
+
 zlib-ng in wheels
 ^^^^^^^^^^^^^^^^^
 

From ad747f3fd8024145ddc8dbc5f3f95d7e396b3351 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 12:38:50 +1100
Subject: [PATCH 1351/2374] Added release notes

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

diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
index c5d0afd58d8..cccf2323df5 100644
--- a/docs/releasenotes/11.1.0.rst
+++ b/docs/releasenotes/11.1.0.rst
@@ -52,6 +52,12 @@ zlib library, and what version of zlib-ng is being used::
 Other Changes
 =============
 
+Reading JPEG 2000 comments
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When opening a JPEG 2000 image, the comment may now be read into
+:py:attr:`~PIL.Image.Image.info` for J2K images, not just JP2 images.
+
 zlib-ng in wheels
 ^^^^^^^^^^^^^^^^^
 

From cfe8379d905bb92a1407d1809987fb74163b5024 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 13:02:23 +1100
Subject: [PATCH 1352/2374] Added release notes for #8483

---
 docs/releasenotes/11.1.0.rst | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
index c5d0afd58d8..90a0492bd71 100644
--- a/docs/releasenotes/11.1.0.rst
+++ b/docs/releasenotes/11.1.0.rst
@@ -31,10 +31,26 @@ TODO
 API Changes
 ===========
 
-TODO
-^^^^
+Writing XMP bytes to JPEG and MPO
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+Pillow 11.0.0 added writing XMP data to JPEG and MPO images::
+
+    im.info["xmp"] = b"test"
+    im.save("out.jpg")
+
+However, this meant that XMP data was automatically kept from an opened image,
+which is inconsistent with the rest of Pillow's behaviour. This functionality
+has been removed. To write XMP data, the ``xmp`` argument can still be used for
+JPEG files::
+
+    im.save("out.jpg", xmp=b"test")
+
+To save XMP data to the second frame of an MPO image, ``encoderinfo`` can now
+be used::
+
+    second_im.encoderinfo = {"xmp": b"test"}
+    im.save("out.mpo", save_all=True, append_images=[second_im])
 
 API Additions
 =============

From 23083f28abbf0a79bc44c2e7b755663c04368e14 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 14:02:19 +1100
Subject: [PATCH 1353/2374] Use monkeypatch

---
 Tests/test_file_png.py | 8 ++------
 Tests/test_file_ppm.py | 8 ++------
 2 files changed, 4 insertions(+), 12 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index ffafc3c582a..974e1e75faa 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -772,22 +772,18 @@ def test_seek(self) -> None:
                 im.seek(1)
 
     @pytest.mark.parametrize("buffer", (True, False))
-    def test_save_stdout(self, buffer: bool) -> None:
-        old_stdout = sys.stdout
+    def test_save_stdout(self, buffer: bool, monkeypatch: pytest.MonkeyPatch) -> None:
 
         class MyStdOut:
             buffer = BytesIO()
 
         mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-        sys.stdout = mystdout
+        monkeypatch.setattr(sys, "stdout", mystdout)
 
         with Image.open(TEST_PNG_FILE) as im:
             im.save(sys.stdout, "PNG")
 
-        # Reset stdout
-        sys.stdout = old_stdout
-
         if isinstance(mystdout, MyStdOut):
             mystdout = mystdout.buffer
         with Image.open(mystdout) as reloaded:
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index fb08d613a56..ee51a5e5a6b 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -367,22 +367,18 @@ def test_mimetypes(tmp_path: Path) -> None:
 
 
 @pytest.mark.parametrize("buffer", (True, False))
-def test_save_stdout(buffer: bool) -> None:
-    old_stdout = sys.stdout
+def test_save_stdout(buffer: bool, monkeypatch: pytest.MonkeyPatch) -> None:
 
     class MyStdOut:
         buffer = BytesIO()
 
     mystdout: MyStdOut | BytesIO = MyStdOut() if buffer else BytesIO()
 
-    sys.stdout = mystdout
+    monkeypatch.setattr(sys, "stdout", mystdout)
 
     with Image.open(TEST_FILE) as im:
         im.save(sys.stdout, "PPM")
 
-    # Reset stdout
-    sys.stdout = old_stdout
-
     if isinstance(mystdout, MyStdOut):
         mystdout = mystdout.buffer
     with Image.open(mystdout) as reloaded:

From f10e9f42d3e434c34a16df514a5435381b21aefb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 14:29:29 +1100
Subject: [PATCH 1354/2374] Do not use temporary file in grabclipboard() on
 macOS

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

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index e27ca7e5033..fe27bfaeb6f 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -104,28 +104,17 @@ def grab(
 
 def grabclipboard() -> Image.Image | list[str] | None:
     if sys.platform == "darwin":
-        fh, filepath = tempfile.mkstemp(".png")
-        os.close(fh)
-        commands = [
-            'set theFile to (open for access POSIX file "'
-            + filepath
-            + '" with write permission)',
-            "try",
-            "    write (the clipboard as «class PNGf») to theFile",
-            "end try",
-            "close access theFile",
-        ]
-        script = ["osascript"]
-        for command in commands:
-            script += ["-e", command]
-        subprocess.call(script)
+        p = subprocess.run(
+            ["osascript", "-e", "get the clipboard as «class PNGf»"],
+            capture_output=True,
+        )
+        if p.returncode != 0:
+            return None
 
-        im = None
-        if os.stat(filepath).st_size != 0:
-            im = Image.open(filepath)
-            im.load()
-        os.unlink(filepath)
-        return im
+        import binascii
+
+        data = io.BytesIO(binascii.unhexlify(p.stdout[11:-3]))
+        return Image.open(data)
     elif sys.platform == "win32":
         fmt, data = Image.core.grabclipboard_win32()
         if fmt == "file":  # CF_HDROP

From 05c981ffd74f6b4de932a1a14f44dc6a3058bb75 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 15:41:19 +1100
Subject: [PATCH 1355/2374] Removed buffer_size variable

---
 src/libImaging/Jpeg2KDecode.c | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index fc927d2f0c0..4f185b529ac 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -640,7 +640,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
     opj_dparameters_t params;
     OPJ_COLOR_SPACE color_space;
     j2k_unpacker_t unpack = NULL;
-    size_t buffer_size = 0, tile_bytes = 0;
+    size_t tile_bytes = 0;
     unsigned n, tile_height, tile_width;
     int subsampling;
     int total_component_width = 0;
@@ -870,7 +870,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
             tile_info.data_size = tile_bytes;
         }
 
-        if (buffer_size < tile_info.data_size) {
+        if (tile_info.data_size > 0) {
             /* malloc check ok, overflow and tile size sanity check above */
             UINT8 *new = realloc(state->buffer, tile_info.data_size);
             if (!new) {
@@ -883,7 +883,6 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
                to valgrind errors. */
             memset(new, 0, tile_info.data_size);
             state->buffer = new;
-            buffer_size = tile_info.data_size;
         }
 
         if (!opj_decode_tile_data(

From 8945875c6ce48fee62d17cea1414938e24808a9f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 21:28:44 +1100
Subject: [PATCH 1356/2374] Populate DPI from JFIF cm density

---
 Tests/images/jfif_unit_cm.jpg | Bin 0 -> 391 bytes
 Tests/test_file_jpeg.py       |   4 ++++
 src/PIL/JpegImagePlugin.py    |   3 +++
 3 files changed, 7 insertions(+)
 create mode 100644 Tests/images/jfif_unit_cm.jpg

diff --git a/Tests/images/jfif_unit_cm.jpg b/Tests/images/jfif_unit_cm.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..78b50e60a236bf320a29c433eae2c9afeb759fe9
GIT binary patch
literal 391
zcmex=<NpH&0WUXCHwH#VCI&_ZCI*K84;j>5D>Bm<7<_#hv=|r|IDm3|AQ=W8AeI7R
zhP2G0;u4@jeu%>2)a3lU6o&t|8Jrn7*x1<FSUK3)**Q5mxOhZ(dAPZGB!z_eMP#Mq
z<z%H~WE52N)D@I;lx1Wz%r$ik3{6Z-<kc;0EsSjRj7^OGA7J1H+6c6hQIO&P5e9h%
z21ZsO2M9nmg8(BFGYcylI|nBhH&DS=0R|>UW@aW9W>!`f7NBe`P@aKBkX1<0(2-3z
zFp*uUP{gQl;zAB(r;P_igD!qhF-|IK;^Yz&myncFRa4i{)G{$OGq<p`a&~cbbNBG{
z3JwVk3y+A5N=`{lOV7y6DlRE4E3c@mYHn$5YwzgnnlyRJ)M?Xa%$&7o@sg#>maka3
zYSZQ|TeofBv2)j<!$*!DJAUHisY{oyT)lSv#?4y~A3c8Z^x5+lFJFE9^!dxzZ{L6X
U{Pq790|&@I_6$G&?f-uh04Sn(Qvd(}

literal 0
HcmV?d00001

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 5dd50fd0809..bf0dec4b80e 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -181,6 +181,10 @@ def test(xdpi: int, ydpi: int | None = None) -> tuple[int, int] | None:
         assert test(100, 200) == (100, 200)
         assert test(0) is None  # square pixels
 
+    def test_dpi_jfif_cm(self):
+        with Image.open("Tests/images/jfif_unit_cm.jpg") as im:
+            assert im.info["dpi"] == (2.54, 5.08)
+
     @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 5025f88ea97..457690aac51 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -90,6 +90,9 @@ def APP(self: JpegImageFile, marker: int) -> None:
         else:
             if jfif_unit == 1:
                 self.info["dpi"] = jfif_density
+            elif jfif_unit == 2:  # cm
+                # 1 dpcm = 2.54 dpi
+                self.info["dpi"] = tuple(d * 2.54 for d in jfif_density)
             self.info["jfif_unit"] = jfif_unit
             self.info["jfif_density"] = jfif_density
     elif marker == 0xFFE1 and s[:6] == b"Exif\0\0":

From 9bebecf36d66b19ac7ba0241ef9eb7febdcaf866 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Dec 2024 22:18:02 +1100
Subject: [PATCH 1357/2374] Use versionadded

---
 docs/handbook/image-file-formats.rst | 19 +++++++++++++------
 1 file changed, 13 insertions(+), 6 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 364e1802ae5..2ea49282ecf 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -572,12 +572,19 @@ JPEG 2000
 Pillow reads and writes JPEG 2000 files containing ``L``, ``LA``, ``RGB``,
 ``RGBA``, or ``YCbCr`` data.  When reading, ``YCbCr`` data is converted to
 ``RGB`` or ``RGBA`` depending on whether or not there is an alpha channel.
-Beginning with version 8.3.0, Pillow can read (but not write) ``RGB``,
-``RGBA``, and ``YCbCr`` images with subsampled components. Pillow 10.4.0 and
-later can read ``CMYK`` images with OpenJPEG 2.5.1 and later, and Pillow 11.1.0
-and later can write ``CMYK`` images with OpenJPEG 2.5.3 and later. Pillow
-supports JPEG 2000 raw codestreams (``.j2k`` files), as well as boxed JPEG 2000
-files (``.jp2`` or ``.jpx`` files).
+
+.. versionadded:: 8.3.0
+   Pillow can read (but not write) ``RGB``, ``RGBA``, and ``YCbCr`` images with
+   subsampled components.
+
+.. versionadded:: 10.4.0
+   Pillow can read ``CMYK`` images with OpenJPEG 2.5.1 and later.
+
+.. versionadded:: 11.1.0
+   Pillow can write ``CMYK`` images with OpenJPEG 2.5.3 and later.
+
+Pillow supports JPEG 2000 raw codestreams (``.j2k`` files), as well as boxed
+JPEG 2000 files (``.jp2`` or ``.jpx`` files).
 
 When loading, if you set the ``mode`` on the image prior to the
 :py:meth:`~PIL.Image.Image.load` method being invoked, you can ask Pillow to

From 9368a86397a41817f671c3c0bce7b8745bc5e218 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 29 Dec 2024 07:43:47 +1100
Subject: [PATCH 1358/2374] Keep new IFDs when converting EXIF to bytes

---
 Tests/test_image.py | 4 ++++
 src/PIL/Image.py    | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index c8df474f493..092bc07f6f1 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -793,6 +793,10 @@ def test_empty_get_ifd(self) -> None:
         ifd[36864] = b"0220"
         assert exif.get_ifd(0x8769) == {36864: b"0220"}
 
+        reloaded_exif = Image.Exif()
+        reloaded_exif.load(exif.tobytes())
+        assert reloaded_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 90374d80469..dff3d063b13 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -4023,6 +4023,9 @@ def tobytes(self, offset: int = 8) -> bytes:
 
         head = self._get_head()
         ifd = TiffImagePlugin.ImageFileDirectory_v2(ifh=head)
+        for tag, ifd_dict in self._ifds.items():
+            if tag not in self:
+                ifd[tag] = ifd_dict
         for tag, value in self.items():
             if tag in [
                 ExifTags.IFD.Exif,

From ea962bf1d8dab61d526f885eccb34863ea85228f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 29 Dec 2024 16:59:32 +1100
Subject: [PATCH 1359/2374] Added RGBX;16N to RGB unpacker

---
 src/libImaging/Unpack.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index c23d5d889f6..e9203fe4d74 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1695,6 +1695,7 @@ static struct {
 
 #ifdef WORDS_BIGENDIAN
     {"RGB", "RGB;16N", 48, unpackRGB16B},
+    {"RGB", "RGBX;16N", 64, unpackRGBA16B},
     {"RGBA", "RGBa;16N", 64, unpackRGBa16B},
     {"RGBA", "RGBA;16N", 64, unpackRGBA16B},
     {"RGBX", "RGBX;16N", 64, unpackRGBA16B},
@@ -1708,6 +1709,7 @@ static struct {
     {"RGBA", "A;16N", 16, band316B},
 #else
     {"RGB", "RGB;16N", 48, unpackRGB16L},
+    {"RGB", "RGBX;16N", 64, unpackRGBA16L},
     {"RGBA", "RGBa;16N", 64, unpackRGBa16L},
     {"RGBA", "RGBA;16N", 64, unpackRGBA16L},
     {"RGBX", "RGBX;16N", 64, unpackRGBA16L},

From 8d28514e409bf3ecbeb3721d8ccb508c09f2b975 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 29 Dec 2024 21:16:42 +0200
Subject: [PATCH 1360/2374] Add zizmor to pre-commit and fix potential
 cache-poisoning in wheels workflow

---
 .github/workflows/wheels.yml | 2 --
 .pre-commit-config.yaml      | 9 +++++++--
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index c5e55aa621d..3b22ee98a2c 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -263,8 +263,6 @@ jobs:
       uses: actions/setup-python@v5
       with:
         python-version: "3.x"
-        cache: pip
-        cache-dependency-path: "Makefile"
 
     - run: make sdist
 
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index f91260c724f..b76f92ec00e 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.8.1
+    rev: v0.8.4
     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: v19.1.4
+    rev: v19.1.5
     hooks:
       - id: clang-format
         types: [c]
@@ -56,6 +56,11 @@ repos:
       - id: check-readthedocs
       - id: check-renovate
 
+  - repo: https://github.com/woodruffw/zizmor-pre-commit
+    rev: v0.10.0
+    hooks:
+      - id: zizmor
+
   - repo: https://github.com/sphinx-contrib/sphinx-lint
     rev: v1.0.0
     hooks:

From 167ed55d8b43de26c5ce01c239ce848062e5e995 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Dec 2024 19:37:38 +1100
Subject: [PATCH 1361/2374] Use elif

---
 src/PIL/TiffImagePlugin.py | 21 ++++++++++-----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 16c521bea25..2ab0b7ebe68 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1559,17 +1559,6 @@ def _setup(self) -> None:
                 # fillorder==2 modes have a corresponding
                 # fillorder=1 mode
                 self._mode, rawmode = OPEN_INFO[key]
-            # libtiff always returns the bytes in native order.
-            # we're expecting image byte order. So, if the rawmode
-            # contains I;16, we need to convert from native to image
-            # byte order.
-            if rawmode == "I;16":
-                rawmode = "I;16N"
-            if ";16B" in rawmode:
-                rawmode = rawmode.replace(";16B", ";16N")
-            if ";16L" in rawmode:
-                rawmode = rawmode.replace(";16L", ";16N")
-
             # YCbCr images with new jpeg compression with pixels in one plane
             # unpacked straight into RGB values
             if (
@@ -1578,6 +1567,16 @@ def _setup(self) -> None:
                 and self._planar_configuration == 1
             ):
                 rawmode = "RGB"
+            # libtiff always returns the bytes in native order.
+            # we're expecting image byte order. So, if the rawmode
+            # contains I;16, we need to convert from native to image
+            # byte order.
+            elif rawmode == "I;16":
+                rawmode = "I;16N"
+            elif ";16B" in rawmode:
+                rawmode = rawmode.replace(";16B", ";16N")
+            elif ";16L" in rawmode:
+                rawmode = rawmode.replace(";16L", ";16N")
 
             # Offset in the tile tuple is 0, we go from 0,0 to
             # w,h, and we only do this once -- eds

From 7cee64ad1b1cbd558cdb01edaa9444f60467947b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Dec 2024 19:45:46 +1100
Subject: [PATCH 1362/2374] Use endswith

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

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 2ab0b7ebe68..ab760c8fbd6 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1573,10 +1573,8 @@ def _setup(self) -> None:
             # byte order.
             elif rawmode == "I;16":
                 rawmode = "I;16N"
-            elif ";16B" in rawmode:
-                rawmode = rawmode.replace(";16B", ";16N")
-            elif ";16L" in rawmode:
-                rawmode = rawmode.replace(";16L", ";16N")
+            elif rawmode.endswith(";16B") or rawmode.endswith(";16L"):
+                rawmode = rawmode[:-1] + "N"
 
             # Offset in the tile tuple is 0, we go from 0,0 to
             # w,h, and we only do this once -- eds

From 050caa9cae5a5844e934e7ec29c0c5bc42537e32 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Dec 2024 21:14:23 +1100
Subject: [PATCH 1363/2374] Restored Makernote as a deprecated enum

---
 docs/deprecations.rst        | 8 ++++++++
 docs/releasenotes/11.1.0.rst | 7 ++++---
 src/PIL/ExifTags.py          | 1 +
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 25607e27c3b..80966ca362a 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -175,6 +175,14 @@ deprecated and will be removed in Pillow 12 (2025-10-15). They were used for obt
 raw pointers to ``ImagingCore`` internals. To interact with C code, you can use
 ``Image.Image.getim()``, which returns a ``Capsule`` object.
 
+ExifTags.IFD.Makernote
+^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.1.0
+
+``ExifTags.IFD.Makernote`` has been deprecated. Instead, use
+``ExifTags.IFD.MakerNote``.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
index c5d0afd58d8..57a8eef4069 100644
--- a/docs/releasenotes/11.1.0.rst
+++ b/docs/releasenotes/11.1.0.rst
@@ -23,10 +23,11 @@ TODO
 Deprecations
 ============
 
-TODO
-^^^^
+ExifTags.IFD.Makernote
+^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+``ExifTags.IFD.Makernote`` has been deprecated. Instead, use
+``ExifTags.IFD.MakerNote``.
 
 API Changes
 ===========
diff --git a/src/PIL/ExifTags.py b/src/PIL/ExifTags.py
index 207d4de4e24..2280d5ce84b 100644
--- a/src/PIL/ExifTags.py
+++ b/src/PIL/ExifTags.py
@@ -353,6 +353,7 @@ class IFD(IntEnum):
     Exif = 0x8769
     GPSInfo = 0x8825
     MakerNote = 0x927C
+    Makernote = 0x927C  # Deprecated
     Interop = 0xA005
     IFD1 = -1
 

From 2ac383028a1983bb2bee27cd8998c25c81e93e49 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 01:26:13 +1100
Subject: [PATCH 1364/2374] Allow saving as BigTIFF

---
 Tests/test_file_tiff.py              |  7 +++++
 docs/handbook/image-file-formats.rst |  3 ++
 src/PIL/TiffImagePlugin.py           | 44 +++++++++++++++++-----------
 3 files changed, 37 insertions(+), 17 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 6f51d46513e..df2c4ebeaae 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -115,6 +115,13 @@ 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_bigtiff_save(self, tmp_path: Path) -> None:
+        outfile = str(tmp_path / "temp.tif")
+        hopper().save(outfile, bigtiff=True)
+
+        with Image.open(outfile) as im:
+            assert im.tag_v2._bigtiff is True
+
     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/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 2ea49282ecf..d956d12d1e1 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1208,6 +1208,9 @@ The :py:meth:`~PIL.Image.Image.save` method can take the following keyword argum
 
     .. versionadded:: 8.4.0
 
+**bigtiff**
+    If true, the image will be saved as a BigTIFF.
+
 **compression**
     A string containing the desired compression method for the
     file. (valid only with libtiff installed) Valid compression
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index ab760c8fbd6..013f34a4f1d 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -582,7 +582,7 @@ class ImageFileDirectory_v2(_IFDv2Base):
 
     def __init__(
         self,
-        ifh: bytes = b"II\052\0\0\0\0\0",
+        ifh: bytes = b"II\x2A\x00\x00\x00\x00\x00",
         prefix: bytes | None = None,
         group: int | None = None,
     ) -> None:
@@ -949,16 +949,26 @@ def load(self, fp: IO[bytes]) -> None:
             warnings.warn(str(msg))
             return
 
+    def _get_ifh(self):
+        ifh = self._prefix + self._pack("H", 43 if self._bigtiff else 42)
+        if self._bigtiff:
+            ifh += self._pack("HH", 8, 0)
+        ifh += self._pack("Q", 16) if self._bigtiff else self._pack("L", 8)
+
+        return ifh
+
     def tobytes(self, offset: int = 0) -> bytes:
         # FIXME What about tagdata?
-        result = self._pack("H", len(self._tags_v2))
+        result = self._pack("Q" if self._bigtiff else "H", len(self._tags_v2))
 
         entries: list[tuple[int, int, int, bytes, bytes]] = []
-        offset = offset + len(result) + len(self._tags_v2) * 12 + 4
+        offset += len(result) + len(self._tags_v2) * (20 if self._bigtiff else 12) + 4
         stripoffsets = None
 
         # pass 1: convert tags to binary format
         # always write tags in ascending order
+        fmt = "Q" if self._bigtiff else "L"
+        fmt_size = 8 if self._bigtiff else 4
         for tag, value in sorted(self._tags_v2.items()):
             if tag == STRIPOFFSETS:
                 stripoffsets = len(entries)
@@ -966,11 +976,7 @@ def tobytes(self, offset: int = 0) -> bytes:
             logger.debug("Tag %s, Type: %s, Value: %s", tag, typ, repr(value))
             is_ifd = typ == TiffTags.LONG and isinstance(value, dict)
             if is_ifd:
-                if self._endian == "<":
-                    ifh = b"II\x2A\x00\x08\x00\x00\x00"
-                else:
-                    ifh = b"MM\x00\x2A\x00\x00\x00\x08"
-                ifd = ImageFileDirectory_v2(ifh, group=tag)
+                ifd = ImageFileDirectory_v2(self._get_ifh(), group=tag)
                 values = self._tags_v2[tag]
                 for ifd_tag, ifd_value in values.items():
                     ifd[ifd_tag] = ifd_value
@@ -993,10 +999,10 @@ def tobytes(self, offset: int = 0) -> bytes:
             else:
                 count = len(values)
             # figure out if data fits into the entry
-            if len(data) <= 4:
-                entries.append((tag, typ, count, data.ljust(4, b"\0"), b""))
+            if len(data) <= fmt_size:
+                entries.append((tag, typ, count, data.ljust(fmt_size, b"\0"), b""))
             else:
-                entries.append((tag, typ, count, self._pack("L", offset), data))
+                entries.append((tag, typ, count, self._pack(fmt, offset), data))
                 offset += (len(data) + 1) // 2 * 2  # pad to word
 
         # update strip offset data to point beyond auxiliary data
@@ -1007,13 +1013,15 @@ def tobytes(self, offset: int = 0) -> bytes:
                 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)
+                value = self._pack(fmt, self._unpack(fmt, value)[0] + offset)
             entries[stripoffsets] = tag, typ, count, value, data
 
         # pass 2: write entries to file
         for tag, typ, count, value, data in entries:
             logger.debug("%s %s %s %s %s", tag, typ, count, repr(value), repr(data))
-            result += self._pack("HHL4s", tag, typ, count, value)
+            result += self._pack(
+                "HHQ8s" if self._bigtiff else "HHL4s", tag, typ, count, value
+            )
 
         # -- overwrite here for multi-page --
         result += b"\0\0\0\0"  # end of entries
@@ -1028,8 +1036,7 @@ def tobytes(self, offset: int = 0) -> bytes:
 
     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))
+            fp.write(self._get_ifh())
 
         offset = fp.tell()
         result = self.tobytes(offset)
@@ -1680,10 +1687,13 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         msg = f"cannot write mode {im.mode} as TIFF"
         raise OSError(msg) from e
 
-    ifd = ImageFileDirectory_v2(prefix=prefix)
-
     encoderinfo = im.encoderinfo
     encoderconfig = im.encoderconfig
+
+    ifd = ImageFileDirectory_v2(prefix=prefix)
+    if encoderinfo.get("bigtiff"):
+        ifd._bigtiff = True
+
     try:
         compression = encoderinfo["compression"]
     except KeyError:

From 8bdcadcbe999c9a2becd6aa2997eb4d74f8ddf2b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 10:16:00 +1100
Subject: [PATCH 1365/2374] Renamed argument to big_tiff

---
 Tests/test_file_tiff.py              | 2 +-
 docs/handbook/image-file-formats.rst | 2 +-
 src/PIL/TiffImagePlugin.py           | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index df2c4ebeaae..dedd48c20b3 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -117,7 +117,7 @@ def test_bigtiff(self, tmp_path: Path) -> None:
 
     def test_bigtiff_save(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
-        hopper().save(outfile, bigtiff=True)
+        hopper().save(outfile, big_tiff=True)
 
         with Image.open(outfile) as im:
             assert im.tag_v2._bigtiff is True
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index d956d12d1e1..4a220aae64d 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1208,7 +1208,7 @@ The :py:meth:`~PIL.Image.Image.save` method can take the following keyword argum
 
     .. versionadded:: 8.4.0
 
-**bigtiff**
+**big_tiff**
     If true, the image will be saved as a BigTIFF.
 
 **compression**
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 013f34a4f1d..61eb1524311 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1691,7 +1691,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     encoderconfig = im.encoderconfig
 
     ifd = ImageFileDirectory_v2(prefix=prefix)
-    if encoderinfo.get("bigtiff"):
+    if encoderinfo.get("big_tiff"):
         ifd._bigtiff = True
 
     try:

From e27115ee8da08ace01308b6cf6f66ccb75bda360 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 30 Dec 2024 23:31:05 +0000
Subject: [PATCH 1366/2374] Update dependency mypy to v1.14.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 cd1b1a1a1dc..10e59b885ef 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.14.0
+mypy==1.14.1
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 1de617fbe725dcf0862b0d036e3d9cffe05b089f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 11:13:14 +1100
Subject: [PATCH 1367/2374] Added release notes

---
 docs/handbook/image-file-formats.rst |  2 ++
 docs/releasenotes/11.1.0.rst         | 26 +++++++-------------------
 2 files changed, 9 insertions(+), 19 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 4a220aae64d..a915ee4e22e 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1211,6 +1211,8 @@ The :py:meth:`~PIL.Image.Image.save` method can take the following keyword argum
 **big_tiff**
     If true, the image will be saved as a BigTIFF.
 
+    .. versionadded:: 11.1.0
+
 **compression**
     A string containing the desired compression method for the
     file. (valid only with libtiff installed) Valid compression
diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
index 27264d99a9e..1505310fa4e 100644
--- a/docs/releasenotes/11.1.0.rst
+++ b/docs/releasenotes/11.1.0.rst
@@ -1,25 +1,6 @@
 11.1.0
 ------
 
-Security
-========
-
-TODO
-^^^^
-
-TODO
-
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
-
-Backwards Incompatible Changes
-==============================
-
-TODO
-^^^^
-
 Deprecations
 ============
 
@@ -66,6 +47,13 @@ zlib library, and what version of zlib-ng is being used::
     features.check_feature("zlib_ng")  # True or False
     features.version_feature("zlib_ng")  # "2.2.2" for example, or None
 
+Saving TIFF as BigTIFF
+^^^^^^^^^^^^^^^^^^^^^^
+
+TIFF images can now be saved as BigTIFF using a ``big_tiff`` argument::
+
+    im.save("out.tiff", big_tiff=True)
+
 Other Changes
 =============
 

From f91b111fac15e7e10be7323b291a15e238ba25b5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 20:42:49 +1100
Subject: [PATCH 1368/2374] Removed pre-C99 definitions

---
 src/libImaging/ImPlatform.h | 30 ------------------------------
 1 file changed, 30 deletions(-)

diff --git a/src/libImaging/ImPlatform.h b/src/libImaging/ImPlatform.h
index c9b7e43b425..2ce282241d5 100644
--- a/src/libImaging/ImPlatform.h
+++ b/src/libImaging/ImPlatform.h
@@ -44,8 +44,6 @@
    defines their own types with the same names, so we need to be able to undef
    ours before including the JPEG code. */
 
-#if __STDC_VERSION__ >= 199901L /* C99+ */
-
 #include <stdint.h>
 
 #define INT8 int8_t
@@ -55,34 +53,6 @@
 #define INT32 int32_t
 #define UINT32 uint32_t
 
-#else /* < C99 */
-
-#define INT8 signed char
-
-#if SIZEOF_SHORT == 2
-#define INT16 short
-#elif SIZEOF_INT == 2
-#define INT16 int
-#else
-#error Cannot find required 16-bit integer type
-#endif
-
-#if SIZEOF_SHORT == 4
-#define INT32 short
-#elif SIZEOF_INT == 4
-#define INT32 int
-#elif SIZEOF_LONG == 4
-#define INT32 long
-#else
-#error Cannot find required 32-bit integer type
-#endif
-
-#define UINT8 unsigned char
-#define UINT16 unsigned INT16
-#define UINT32 unsigned INT32
-
-#endif /* < C99 */
-
 #endif /* not WIN */
 
 /* assume IEEE; tweak if necessary (patches are welcome) */

From d42f22baafca30050f4fc8b6bafcc39ef624d685 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 21:38:05 +1100
Subject: [PATCH 1369/2374] Added release notes

---
 docs/releasenotes/11.1.0.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
index 27264d99a9e..aec7633a24b 100644
--- a/docs/releasenotes/11.1.0.rst
+++ b/docs/releasenotes/11.1.0.rst
@@ -80,6 +80,11 @@ Saving JPEG 2000 CMYK images
 
 With OpenJPEG 2.5.3 or later, Pillow can now save CMYK images as JPEG 2000 files.
 
+Minimum C version
+^^^^^^^^^^^^^^^^^
+
+C99 is now the minimum version of C required to compile Pillow from source.
+
 zlib-ng in wheels
 ^^^^^^^^^^^^^^^^^
 

From 06e02cc1d98dbcfb09839da080ee8eb318baa4ba Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 20:48:55 +1100
Subject: [PATCH 1370/2374] Added compile-time mozjpeg feature flag

---
 src/PIL/features.py |  4 +++-
 src/_imaging.c      | 16 ++++++++++++++++
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/PIL/features.py b/src/PIL/features.py
index 3645e3defc4..ae7ea4255ef 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -127,6 +127,7 @@ def get_supported_codecs() -> list[str]:
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
     "harfbuzz": ("PIL._imagingft", "HAVE_HARFBUZZ", "harfbuzz_version"),
     "libjpeg_turbo": ("PIL._imaging", "HAVE_LIBJPEGTURBO", "libjpeg_turbo_version"),
+    "mozjpeg": ("PIL._imaging", "HAVE_MOZJPEG", "libjpeg_turbo_version"),
     "zlib_ng": ("PIL._imaging", "HAVE_ZLIBNG", "zlib_ng_version"),
     "libimagequant": ("PIL._imaging", "HAVE_LIBIMAGEQUANT", "imagequant_version"),
     "xcb": ("PIL._imaging", "HAVE_XCB", None),
@@ -300,7 +301,8 @@ def pilinfo(out: IO[str] | None = None, supported_formats: bool = True) -> None:
             if name == "jpg":
                 libjpeg_turbo_version = version_feature("libjpeg_turbo")
                 if libjpeg_turbo_version is not None:
-                    v = "libjpeg-turbo " + libjpeg_turbo_version
+                    v = "mozjpeg" if check_feature("mozjpeg") else "libjpeg-turbo"
+                    v += " " + libjpeg_turbo_version
             if v is None:
                 v = version(name)
             if v is not None:
diff --git a/src/_imaging.c b/src/_imaging.c
index 5d6d97bedab..00772d01275 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -76,6 +76,13 @@
 
 #ifdef HAVE_LIBJPEG
 #include "jconfig.h"
+#ifdef LIBJPEG_TURBO_VERSION
+#define JCONFIG_INCLUDED
+#ifdef __CYGWIN__
+#define _BASETSD_H
+#endif
+#include "jpeglib.h"
+#endif
 #endif
 
 #ifdef HAVE_LIBZ
@@ -4367,6 +4374,15 @@ setup_module(PyObject *m) {
     Py_INCREF(have_libjpegturbo);
     PyModule_AddObject(m, "HAVE_LIBJPEGTURBO", have_libjpegturbo);
 
+    PyObject *have_mozjpeg;
+#ifdef JPEG_C_PARAM_SUPPORTED
+    have_mozjpeg = Py_True;
+#else
+    have_mozjpeg = Py_False;
+#endif
+    Py_INCREF(have_mozjpeg);
+    PyModule_AddObject(m, "HAVE_MOZJPEG", have_mozjpeg);
+
     PyObject *have_libimagequant;
 #ifdef HAVE_LIBIMAGEQUANT
     have_libimagequant = Py_True;

From ae59b039564eefdebec4ea67a712a115d0e1ab67 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 21:40:12 +1100
Subject: [PATCH 1371/2374] Do not use MozJPEG progressive default

---
 Tests/test_file_jpeg.py     | 13 ++++++++++---
 src/libImaging/JpegEncode.c | 11 ++++++++++-
 2 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index bf0dec4b80e..d4c0636c668 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -281,7 +281,10 @@ def test_progressive(self) -> None:
         assert not im2.info.get("progressive")
         assert im3.info.get("progressive")
 
-        assert_image_equal(im1, im3)
+        if features.check_feature("mozjpeg"):
+            assert_image_similar(im1, im3, 9.39)
+        else:
+            assert_image_equal(im1, im3)
         assert im1_bytes >= im3_bytes
 
     def test_progressive_large_buffer(self, tmp_path: Path) -> None:
@@ -424,8 +427,12 @@ def test_progressive_compat(self) -> None:
 
         im2 = self.roundtrip(hopper(), progressive=1)
         im3 = self.roundtrip(hopper(), progression=1)  # compatibility
-        assert_image_equal(im1, im2)
-        assert_image_equal(im1, im3)
+        if features.check_feature("mozjpeg"):
+            assert_image_similar(im1, im2, 9.39)
+            assert_image_similar(im1, im3, 9.39)
+        else:
+            assert_image_equal(im1, im2)
+            assert_image_equal(im1, im3)
         assert im2.info.get("progressive")
         assert im2.info.get("progression")
         assert im3.info.get("progressive")
diff --git a/src/libImaging/JpegEncode.c b/src/libImaging/JpegEncode.c
index 4372d51d5c3..3c11eac2206 100644
--- a/src/libImaging/JpegEncode.c
+++ b/src/libImaging/JpegEncode.c
@@ -134,7 +134,16 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     return -1;
             }
 
-            /* Compressor configuration */
+                /* Compressor configuration */
+#ifdef JPEG_C_PARAM_SUPPORTED
+            /* MozJPEG */
+            if (!context->progressive) {
+                /* Do not use MozJPEG progressive default */
+                jpeg_c_set_int_param(
+                    &context->cinfo, JINT_COMPRESS_PROFILE, JCP_FASTEST
+                );
+            }
+#endif
             jpeg_set_defaults(&context->cinfo);
 
             /* Prevent RGB -> YCbCr conversion */

From e34427167ddbaeece43490c4054c1e17fa21d77b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Dec 2024 23:26:09 +1100
Subject: [PATCH 1372/2374] Added CentOS Stream 10

---
 .github/workflows/test-docker.yml      | 1 +
 docs/installation/platform-support.rst | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index cc5f9d4a5a9..4b01a10e4c2 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -44,6 +44,7 @@ jobs:
           amazon-2023-amd64,
           arch,
           centos-stream-9-amd64,
+          centos-stream-10-amd64,
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
           fedora-40-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 35f863374d1..3741c595602 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -27,6 +27,8 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | CentOS Stream 9                  | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
+| CentOS Stream 10                 | 3.12                       | x86-64              |
++----------------------------------+----------------------------+---------------------+
 | Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
 +----------------------------------+----------------------------+---------------------+
 | Fedora 40                        | 3.12                       | x86-64              |

From d626e6ab9f37c6bc27036982e282d42012ed0cab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Jan 2025 09:07:41 +1100
Subject: [PATCH 1373/2374] text is a property

---
 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 974e1e75faa..d87883279a3 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -618,7 +618,7 @@ def test_textual_chunks_after_idat(self) -> None:
         with Image.open("Tests/images/truncated_image.png") as im:
             # The file is truncated
             with pytest.raises(OSError):
-                im.text()
+                im.text
             ImageFile.LOAD_TRUNCATED_IMAGES = True
             assert isinstance(im.text, dict)
             ImageFile.LOAD_TRUNCATED_IMAGES = False

From 8d78cfcc5a798c59a193b80e200d9845992326ab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Jan 2025 09:10:16 +1100
Subject: [PATCH 1374/2374] Added return types

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

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index bf0dec4b80e..52fc9239c78 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -181,7 +181,7 @@ def test(xdpi: int, ydpi: int | None = None) -> tuple[int, int] | None:
         assert test(100, 200) == (100, 200)
         assert test(0) is None  # square pixels
 
-    def test_dpi_jfif_cm(self):
+    def test_dpi_jfif_cm(self) -> None:
         with Image.open("Tests/images/jfif_unit_cm.jpg") as im:
             assert im.info["dpi"] == (2.54, 5.08)
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 61eb1524311..93ad8903244 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -949,7 +949,7 @@ def load(self, fp: IO[bytes]) -> None:
             warnings.warn(str(msg))
             return
 
-    def _get_ifh(self):
+    def _get_ifh(self) -> bytes:
         ifh = self._prefix + self._pack("H", 43 if self._bigtiff else 42)
         if self._bigtiff:
             ifh += self._pack("HH", 8, 0)

From beda2b6e8d20050a16fbc261753fd30e410fba93 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Jan 2025 10:49:24 +1100
Subject: [PATCH 1375/2374] Removed unused image open

---
 Tests/test_file_ico.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 37770498a0a..e81aae66995 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -253,8 +253,7 @@ def test_truncated_mask() -> None:
 
     try:
         with Image.open(io.BytesIO(data)) as im:
-            with Image.open("Tests/images/hopper_mask.png") as expected:
-                assert im.mode == "1"
+            assert im.mode == "1"
 
         # 32 bpp
         output = io.BytesIO()

From b89cc09944b4add584967bf1fa21208e92442def Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Jan 2025 12:22:55 +1100
Subject: [PATCH 1376/2374] Corrected BLP1 alpha depth handling

---
 Tests/test_file_blp.py    |  1 +
 src/PIL/BlpImagePlugin.py | 43 ++++++++++++++++++++++++---------------
 2 files changed, 28 insertions(+), 16 deletions(-)

diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index 1e2f20c407b..1f32be9c134 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -19,6 +19,7 @@ def test_load_blp1() -> None:
         assert_image_equal_tofile(im, "Tests/images/blp/blp1_jpeg.png")
 
     with Image.open("Tests/images/blp/blp1_jpeg2.blp") as im:
+        assert im.mode == "RGBA"
         im.load()
 
 
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 2d03af9d7dd..0d882fe9686 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -260,18 +260,21 @@ class BlpImageFile(ImageFile.ImageFile):
     def _open(self) -> None:
         self.magic = self.fp.read(4)
 
-        self.fp.seek(5, os.SEEK_CUR)
-        (self._blp_alpha_depth,) = struct.unpack("<b", self.fp.read(1))
-
-        self.fp.seek(2, os.SEEK_CUR)
-        self._size = struct.unpack("<II", self.fp.read(8))
-
-        if self.magic in (b"BLP1", b"BLP2"):
-            decoder = self.magic.decode()
+        if self.magic == b"BLP1":
+            self.fp.seek(4, os.SEEK_CUR)
+            (self._blp_alpha_depth,) = struct.unpack("<I", self.fp.read(4))
+        elif self.magic == b"BLP2":
+            self.fp.seek(5, os.SEEK_CUR)
+            (self._blp_alpha_depth,) = struct.unpack("<b", self.fp.read(1))
+            self.fp.seek(2, os.SEEK_CUR)
         else:
             msg = f"Bad BLP magic {repr(self.magic)}"
             raise BLPFormatError(msg)
 
+        self._size = struct.unpack("<II", self.fp.read(8))
+
+        decoder = self.magic.decode()
+
         self._mode = "RGBA" if self._blp_alpha_depth else "RGB"
         self.tile = [ImageFile._Tile(decoder, (0, 0) + self.size, 0, self.mode)]
 
@@ -297,10 +300,13 @@ def _read_blp_header(self) -> None:
         self.fd.seek(4)
         (self._blp_compression,) = struct.unpack("<i", self._safe_read(4))
 
-        (self._blp_encoding,) = struct.unpack("<b", self._safe_read(1))
-        (self._blp_alpha_depth,) = struct.unpack("<b", self._safe_read(1))
-        (self._blp_alpha_encoding,) = struct.unpack("<b", self._safe_read(1))
-        self.fd.seek(1, os.SEEK_CUR)  # mips
+        if isinstance(self, BLP1Decoder):
+            (self._blp_alpha_depth,) = struct.unpack("<I", self._safe_read(4))
+        else:
+            (self._blp_encoding,) = struct.unpack("<b", self._safe_read(1))
+            (self._blp_alpha_depth,) = struct.unpack("<b", self._safe_read(1))
+            (self._blp_alpha_encoding,) = struct.unpack("<b", self._safe_read(1))
+            self.fd.seek(1, os.SEEK_CUR)  # mips
 
         self.size = struct.unpack("<II", self._safe_read(8))
 
@@ -472,10 +478,15 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     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))
-    fp.write(struct.pack("<b", 0))  # alpha encoding
-    fp.write(struct.pack("<b", 0))  # mips
+
+    alpha_depth = 1 if im.palette.mode == "RGBA" else 0
+    if magic == b"BLP1":
+        fp.write(struct.pack("<L", alpha_depth))
+    else:
+        fp.write(struct.pack("<b", Encoding.UNCOMPRESSED))
+        fp.write(struct.pack("<b", alpha_depth))
+        fp.write(struct.pack("<b", 0))  # alpha encoding
+        fp.write(struct.pack("<b", 0))  # mips
     fp.write(struct.pack("<II", *im.size))
     if magic == b"BLP1":
         fp.write(struct.pack("<i", 5))

From 6b75e0687513fcdca8683699b5ce880a935ad8ce Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Jan 2025 22:58:04 +1100
Subject: [PATCH 1377/2374] Do not reread start of header in decoder

---
 src/PIL/BlpImagePlugin.py | 125 +++++++++++++++++++-------------------
 1 file changed, 61 insertions(+), 64 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 0d882fe9686..c932b3b9c8a 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -259,24 +259,36 @@ class BlpImageFile(ImageFile.ImageFile):
 
     def _open(self) -> None:
         self.magic = self.fp.read(4)
+        if not _accept(self.magic):
+            msg = f"Bad BLP magic {repr(self.magic)}"
+            raise BLPFormatError(msg)
 
+        compression = struct.unpack("<i", self.fp.read(4))[0]
         if self.magic == b"BLP1":
-            self.fp.seek(4, os.SEEK_CUR)
-            (self._blp_alpha_depth,) = struct.unpack("<I", self.fp.read(4))
-        elif self.magic == b"BLP2":
-            self.fp.seek(5, os.SEEK_CUR)
-            (self._blp_alpha_depth,) = struct.unpack("<b", self.fp.read(1))
-            self.fp.seek(2, os.SEEK_CUR)
+            alpha = struct.unpack("<I", self.fp.read(4))[0] != 0
         else:
-            msg = f"Bad BLP magic {repr(self.magic)}"
-            raise BLPFormatError(msg)
+            encoding = struct.unpack("<b", self.fp.read(1))[0]
+            alpha = struct.unpack("<b", self.fp.read(1))[0] != 0
+            alpha_encoding = struct.unpack("<b", self.fp.read(1))[0]
+            self.fp.seek(1, os.SEEK_CUR)  # mips
 
         self._size = struct.unpack("<II", self.fp.read(8))
 
+        args: tuple[int, int, bool] | tuple[int, int, bool, int]
+        if self.magic == b"BLP1":
+            encoding = struct.unpack("<i", self.fp.read(4))[0]
+            self.fp.seek(4, os.SEEK_CUR)  # subtype
+
+            args = (compression, encoding, alpha)
+            offset = 28
+        else:
+            args = (compression, encoding, alpha, alpha_encoding)
+            offset = 20
+
         decoder = self.magic.decode()
 
-        self._mode = "RGBA" if self._blp_alpha_depth else "RGB"
-        self.tile = [ImageFile._Tile(decoder, (0, 0) + self.size, 0, self.mode)]
+        self._mode = "RGBA" if alpha else "RGB"
+        self.tile = [ImageFile._Tile(decoder, (0, 0) + self.size, offset, args)]
 
 
 class _BLPBaseDecoder(ImageFile.PyDecoder):
@@ -284,7 +296,7 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
 
     def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         try:
-            self._read_blp_header()
+            self._read_header()
             self._load()
         except struct.error as e:
             msg = "Truncated BLP file"
@@ -295,28 +307,9 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
     def _load(self) -> None:
         pass
 
-    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))
-
-        if isinstance(self, BLP1Decoder):
-            (self._blp_alpha_depth,) = struct.unpack("<I", self._safe_read(4))
-        else:
-            (self._blp_encoding,) = struct.unpack("<b", self._safe_read(1))
-            (self._blp_alpha_depth,) = struct.unpack("<b", self._safe_read(1))
-            (self._blp_alpha_encoding,) = struct.unpack("<b", self._safe_read(1))
-            self.fd.seek(1, os.SEEK_CUR)  # mips
-
-        self.size = struct.unpack("<II", self._safe_read(8))
-
-        if isinstance(self, BLP1Decoder):
-            # Only present for BLP1
-            (self._blp_encoding,) = struct.unpack("<i", self._safe_read(4))
-            self.fd.seek(4, os.SEEK_CUR)  # subtype
-
-        self._blp_offsets = struct.unpack("<16I", self._safe_read(16 * 4))
-        self._blp_lengths = struct.unpack("<16I", self._safe_read(16 * 4))
+    def _read_header(self) -> None:
+        self._offsets = struct.unpack("<16I", self._safe_read(16 * 4))
+        self._lengths = struct.unpack("<16I", self._safe_read(16 * 4))
 
     def _safe_read(self, length: int) -> bytes:
         assert self.fd is not None
@@ -332,9 +325,11 @@ def _read_palette(self) -> list[tuple[int, int, int, int]]:
             ret.append((b, g, r, a))
         return ret
 
-    def _read_bgra(self, palette: list[tuple[int, int, int, int]]) -> bytearray:
+    def _read_bgra(
+        self, palette: list[tuple[int, int, int, int]], alpha: bool
+    ) -> bytearray:
         data = bytearray()
-        _data = BytesIO(self._safe_read(self._blp_lengths[0]))
+        _data = BytesIO(self._safe_read(self._lengths[0]))
         while True:
             try:
                 (offset,) = struct.unpack("<B", _data.read(1))
@@ -342,7 +337,7 @@ def _read_bgra(self, palette: list[tuple[int, int, int, int]]) -> bytearray:
                 break
             b, g, r, a = palette[offset]
             d: tuple[int, ...] = (r, g, b)
-            if self._blp_alpha_depth:
+            if alpha:
                 d += (a,)
             data.extend(d)
         return data
@@ -350,19 +345,21 @@ def _read_bgra(self, palette: list[tuple[int, int, int, int]]) -> bytearray:
 
 class BLP1Decoder(_BLPBaseDecoder):
     def _load(self) -> None:
-        if self._blp_compression == Format.JPEG:
+        self._compression, self._encoding, alpha = self.args
+
+        if self._compression == Format.JPEG:
             self._decode_jpeg_stream()
 
-        elif self._blp_compression == 1:
-            if self._blp_encoding in (4, 5):
+        elif self._compression == 1:
+            if self._encoding in (4, 5):
                 palette = self._read_palette()
-                data = self._read_bgra(palette)
+                data = self._read_bgra(palette, alpha)
                 self.set_as_raw(data)
             else:
-                msg = f"Unsupported BLP encoding {repr(self._blp_encoding)}"
+                msg = f"Unsupported BLP encoding {repr(self._encoding)}"
                 raise BLPFormatError(msg)
         else:
-            msg = f"Unsupported BLP compression {repr(self._blp_encoding)}"
+            msg = f"Unsupported BLP compression {repr(self._encoding)}"
             raise BLPFormatError(msg)
 
     def _decode_jpeg_stream(self) -> None:
@@ -371,8 +368,8 @@ def _decode_jpeg_stream(self) -> None:
         (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])
+        self._safe_read(self._offsets[0] - self.fd.tell())  # What IS this?
+        data = self._safe_read(self._lengths[0])
         data = jpeg_header + data
         image = JpegImageFile(BytesIO(data))
         Image._decompression_bomb_check(image.size)
@@ -389,47 +386,47 @@ def _decode_jpeg_stream(self) -> None:
 
 class BLP2Decoder(_BLPBaseDecoder):
     def _load(self) -> None:
+        self._compression, self._encoding, alpha, self._alpha_encoding = self.args
+
         palette = self._read_palette()
 
         assert self.fd is not None
-        self.fd.seek(self._blp_offsets[0])
+        self.fd.seek(self._offsets[0])
 
-        if self._blp_compression == 1:
+        if self._compression == 1:
             # Uncompressed or DirectX compression
 
-            if self._blp_encoding == Encoding.UNCOMPRESSED:
-                data = self._read_bgra(palette)
+            if self._encoding == Encoding.UNCOMPRESSED:
+                data = self._read_bgra(palette, alpha)
 
-            elif self._blp_encoding == Encoding.DXT:
+            elif self._encoding == Encoding.DXT:
                 data = bytearray()
-                if self._blp_alpha_encoding == AlphaEncoding.DXT1:
-                    linesize = (self.size[0] + 3) // 4 * 8
-                    for yb in range((self.size[1] + 3) // 4):
-                        for d in decode_dxt1(
-                            self._safe_read(linesize), alpha=bool(self._blp_alpha_depth)
-                        ):
+                if self._alpha_encoding == AlphaEncoding.DXT1:
+                    linesize = (self.state.xsize + 3) // 4 * 8
+                    for yb in range((self.state.ysize + 3) // 4):
+                        for d in decode_dxt1(self._safe_read(linesize), alpha):
                             data += d
 
-                elif self._blp_alpha_encoding == AlphaEncoding.DXT3:
-                    linesize = (self.size[0] + 3) // 4 * 16
-                    for yb in range((self.size[1] + 3) // 4):
+                elif self._alpha_encoding == AlphaEncoding.DXT3:
+                    linesize = (self.state.xsize + 3) // 4 * 16
+                    for yb in range((self.state.ysize + 3) // 4):
                         for d in decode_dxt3(self._safe_read(linesize)):
                             data += d
 
-                elif self._blp_alpha_encoding == AlphaEncoding.DXT5:
-                    linesize = (self.size[0] + 3) // 4 * 16
-                    for yb in range((self.size[1] + 3) // 4):
+                elif self._alpha_encoding == AlphaEncoding.DXT5:
+                    linesize = (self.state.xsize + 3) // 4 * 16
+                    for yb in range((self.state.ysize + 3) // 4):
                         for d in decode_dxt5(self._safe_read(linesize)):
                             data += d
                 else:
-                    msg = f"Unsupported alpha encoding {repr(self._blp_alpha_encoding)}"
+                    msg = f"Unsupported alpha encoding {repr(self._alpha_encoding)}"
                     raise BLPFormatError(msg)
             else:
-                msg = f"Unknown BLP encoding {repr(self._blp_encoding)}"
+                msg = f"Unknown BLP encoding {repr(self._encoding)}"
                 raise BLPFormatError(msg)
 
         else:
-            msg = f"Unknown BLP compression {repr(self._blp_compression)}"
+            msg = f"Unknown BLP compression {repr(self._compression)}"
             raise BLPFormatError(msg)
 
         self.set_as_raw(data)

From 5d998d3fedb06666ae680e3ebe3f3547a9059727 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Jan 2025 23:38:24 +1100
Subject: [PATCH 1378/2374] Improved coverage

---
 Tests/test_file_blp.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index 1f32be9c134..9f2de8f982e 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -4,7 +4,7 @@
 
 import pytest
 
-from PIL import Image
+from PIL import BlpImagePlugin, Image
 
 from .helper import (
     assert_image_equal,
@@ -38,6 +38,13 @@ def test_load_blp2_dxt1a() -> None:
         assert_image_equal_tofile(im, "Tests/images/blp/blp2_dxt1a.png")
 
 
+def test_invalid_file() -> None:
+    invalid_file = "Tests/images/flower.jpg"
+
+    with pytest.raises(BlpImagePlugin.BLPFormatError):
+        BlpImagePlugin.BlpImageFile(invalid_file)
+
+
 def test_save(tmp_path: Path) -> None:
     f = str(tmp_path / "temp.blp")
 

From f636cb8c156f53cb3acd3ebf7164113850df3f27 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 2 Jan 2025 10:28:51 +1100
Subject: [PATCH 1379/2374] Updated freetype to 2.13.3

---
 .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 4e0fad79f4e..9059c04a4f5 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -37,7 +37,7 @@ fi
 ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
-FREETYPE_VERSION=2.13.2
+FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=10.1.0
 LIBPNG_VERSION=1.6.44
 JPEGTURBO_VERSION=3.1.0

From 4c1aed801e43c6b307e7135279ca1dbc02bbf052 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 2 Jan 2025 16:00:59 +1100
Subject: [PATCH 1380/2374] 11.1.0 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 0807f949c31..9938a0afcf6 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.1.0.dev0"
+__version__ = "11.1.0"

From 57786a252b2e3abd63242800ab06511bb315b2d8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 2 Jan 2025 19:04:18 +1100
Subject: [PATCH 1381/2374] 11.2.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 9938a0afcf6..e93c7887b80 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.1.0"
+__version__ = "11.2.0.dev0"

From 6b4619c4f5998d8d40de32de7b17b664d9b8a0db Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 2 Jan 2025 20:46:58 +1100
Subject: [PATCH 1382/2374] 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 3741c595602..7561946792f 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -77,7 +77,7 @@ 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.9, 3.10, 3.11, 3.12, 3.13| 11.0.0           |arm           |
+| macOS 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13| 11.1.0           |arm           |
 |                                  +----------------------------+------------------+              |
 |                                  | 3.8                        | 10.4.0           |              |
 +----------------------------------+----------------------------+------------------+--------------+

From ade15fcdd3c9f41606ce560c4b5fdeb01f0025e2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 2 Jan 2025 12:46:24 +0200
Subject: [PATCH 1383/2374] Upgrade zlib-ng to 2.2.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 4e0fad79f4e..e89db5020f8 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -50,7 +50,7 @@ if [[ -n "$IS_MACOS" ]]; then
 else
     GIFLIB_VERSION=5.2.1
 fi
-ZLIB_NG_VERSION=2.2.2
+ZLIB_NG_VERSION=2.2.3
 LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0674a9a1528..75d6aa1bd2d 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",
     "XZ": "5.6.3",
-    "ZLIBNG": "2.2.2",
+    "ZLIBNG": "2.2.3",
 }
 V["LIBPNG_DOTLESS"] = V["LIBPNG"].replace(".", "")
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])

From 2d7597ac6a431d283a65d1d17622a6d8f9918010 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 2 Jan 2025 22:50:25 +1100
Subject: [PATCH 1384/2374] Updated to giflib 5.2.2 on Linux

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 4e0fad79f4e..71609a6f49a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -45,11 +45,7 @@ OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
-if [[ -n "$IS_MACOS" ]]; then
-    GIFLIB_VERSION=5.2.2
-else
-    GIFLIB_VERSION=5.2.1
-fi
+GIFLIB_VERSION=5.2.2
 ZLIB_NG_VERSION=2.2.2
 LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
@@ -139,6 +135,14 @@ function build {
     CFLAGS="$CFLAGS -O3 -DNDEBUG"
     if [[ -n "$IS_MACOS" ]]; then
         CFLAGS="$CFLAGS -Wl,-headerpad_max_install_names"
+    # For giflib 5.2.2
+    elif [ -n "$IS_ALPINE" ]; then
+        apk add imagemagick
+    else
+        if [[ "$MB_ML_VER" == "_2_28" ]]; then
+            yum install -y epel-release
+        fi
+        yum install -y ImageMagick
     fi
     build_libwebp
     CFLAGS=$ORIGINAL_CFLAGS

From 1678f7f2155beafa594c3561179f4069f9318d35 Mon Sep 17 00:00:00 2001
From: Marc Mueller <30130371+cdce8p@users.noreply.github.com>
Date: Thu, 2 Jan 2025 17:38:21 +0100
Subject: [PATCH 1385/2374] Add overloads for exif_transpose

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

diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index bb29cc0d3e8..fef1d7328c2 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -22,7 +22,7 @@
 import operator
 import re
 from collections.abc import Sequence
-from typing import Protocol, cast
+from typing import Literal, Protocol, cast, overload
 
 from . import ExifTags, Image, ImagePalette
 
@@ -673,6 +673,16 @@ def solarize(image: Image.Image, threshold: int = 128) -> Image.Image:
     return _lut(image, lut)
 
 
+@overload
+def exif_transpose(image: Image.Image, *, in_place: Literal[True]) -> None: ...
+
+
+@overload
+def exif_transpose(
+    image: Image.Image, *, in_place: Literal[False] = False
+) -> Image.Image: ...
+
+
 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

From 1d771ff4a40e8eb9a38c150d18767cddf01c8a47 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 3 Jan 2025 10:26:47 +1100
Subject: [PATCH 1386/2374] Do not call yum on cifuzz

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 1ebc49a88e0..ceb7911be5a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -99,7 +99,7 @@ function build_harfbuzz {
 
 function build {
     build_xz
-    if [ -z "$IS_ALPINE" ] && [ -z "$IS_MACOS" ]; then
+    if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
         yum remove -y zlib-devel
     fi
     build_zlib_ng
@@ -138,6 +138,8 @@ function build {
     # For giflib 5.2.2
     elif [ -n "$IS_ALPINE" ]; then
         apk add imagemagick
+    elif [ -n "$SANITIZER" ]; then
+        apt-get install -y imagemagick
     else
         if [[ "$MB_ML_VER" == "_2_28" ]]; then
             yum install -y epel-release

From d12e78badf1fc4a102b4bec044eb12a6bfd5d0aa Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 3 Jan 2025 11:00:19 +1100
Subject: [PATCH 1387/2374] Removed exif_transpose return type checks

---
 Tests/test_file_jpeg.py | 1 -
 Tests/test_imageops.py  | 6 ------
 2 files changed, 7 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index bf0dec4b80e..dd62460bb5d 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -353,7 +353,6 @@ 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) == {}
 
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 2fb2a60b632..7262f29e64a 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -405,7 +405,6 @@ 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
@@ -417,7 +416,6 @@ 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)
@@ -433,7 +431,6 @@ 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()
@@ -446,14 +443,12 @@ 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()
 
 
@@ -464,7 +459,6 @@ 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()
 
 

From 036db2da87dba7283207b8b61cf9ca131d1223a3 Mon Sep 17 00:00:00 2001
From: "Harm.van.den.brand@alliander.com" <harm.van.den.brand@alliander.com>
Date: Thu, 2 Jan 2025 16:47:24 +0100
Subject: [PATCH 1388/2374] OSError caused by decode error should use string
 argument to be in line with rest of module

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

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 9c49b1534ed..49d71aca77f 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1146,7 +1146,7 @@ def test_realloc_overflow(self, monkeypatch: pytest.MonkeyPatch) -> None:
                 im.load()
 
             # Assert that the error code is IMAGING_CODEC_MEMORY
-            assert str(e.value) == "-9"
+            assert str(e.value) == "decoder error -9"
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", "jpeg"))
     def test_save_multistrip(self, compression: str, tmp_path: Path) -> None:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 61eb1524311..bbbd656c68a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1406,7 +1406,8 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
             self.fp = None  # might be shared
 
         if err < 0:
-            raise OSError(err)
+            msg = f"decoder error {err}"
+            raise OSError(msg)
 
         return Image.Image.load(self)
 

From cce0f5b653abcdf99a7bbba6757f000b3fc4cd7e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 4 Jan 2025 10:34:59 +1100
Subject: [PATCH 1389/2374] Removed giflib as webp dependency

---
 .github/workflows/wheels-dependencies.sh | 13 +++----------
 1 file changed, 3 insertions(+), 10 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 1ebc49a88e0..05167d96962 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -45,7 +45,6 @@ OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.3
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
-GIFLIB_VERSION=5.2.2
 ZLIB_NG_VERSION=2.2.3
 LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
@@ -135,16 +134,10 @@ function build {
     CFLAGS="$CFLAGS -O3 -DNDEBUG"
     if [[ -n "$IS_MACOS" ]]; then
         CFLAGS="$CFLAGS -Wl,-headerpad_max_install_names"
-    # For giflib 5.2.2
-    elif [ -n "$IS_ALPINE" ]; then
-        apk add imagemagick
-    else
-        if [[ "$MB_ML_VER" == "_2_28" ]]; then
-            yum install -y epel-release
-        fi
-        yum install -y ImageMagick
     fi
-    build_libwebp
+    build_simple libwebp $LIBWEBP_VERSION \
+        https://storage.googleapis.com/downloads.webmproject.org/releases/webp tar.gz \
+        --enable-libwebpmux --enable-libwebpdemux
     CFLAGS=$ORIGINAL_CFLAGS
 
     build_brotli

From bd56a956594445c9b2e0bd5004f1b5c1a3f96b38 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Jan 2025 12:43:50 +1100
Subject: [PATCH 1390/2374] Use namedtuple _replace

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

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index c932b3b9c8a..b8a95db879d 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -374,11 +374,9 @@ def _decode_jpeg_stream(self) -> None:
         image = JpegImageFile(BytesIO(data))
         Image._decompression_bomb_check(image.size)
         if image.mode == "CMYK":
-            decoder_name, extents, offset, args = image.tile[0]
+            args = image.tile[0].args
             assert isinstance(args, tuple)
-            image.tile = [
-                ImageFile._Tile(decoder_name, extents, offset, (args[0], "CMYK"))
-            ]
+            image.tile = [image.tile[0]._replace(args=(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())

From 73a383fa7211adf5ed8ffa43288e6bc47daa125e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 5 Jan 2025 06:11:54 +1100
Subject: [PATCH 1391/2374] Use rawmode instead of splitting and merging

---
 src/PIL/BlpImagePlugin.py | 4 +---
 src/libImaging/Unpack.c   | 1 +
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index b8a95db879d..8585a8e60fd 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -377,9 +377,7 @@ def _decode_jpeg_stream(self) -> None:
             args = image.tile[0].args
             assert isinstance(args, tuple)
             image.tile = [image.tile[0]._replace(args=(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())
+        self.set_as_raw(image.convert("RGB").tobytes(), "BGR")
 
 
 class BLP2Decoder(_BLPBaseDecoder):
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index e9203fe4d74..9c3ee26655f 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1664,6 +1664,7 @@ static struct {
     {"RGBA", "RGBaXX", 48, unpackRGBaskip2},
     {"RGBA", "RGBa;16L", 64, unpackRGBa16L},
     {"RGBA", "RGBa;16B", 64, unpackRGBa16B},
+    {"RGBA", "BGR", 24, ImagingUnpackBGR},
     {"RGBA", "BGRa", 32, unpackBGRa},
     {"RGBA", "RGBA;I", 32, unpackRGBAI},
     {"RGBA", "RGBA;L", 32, unpackRGBAL},

From 4ecf8cbd75051c7213a433f80b6a9f24e4367311 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 5 Jan 2025 14:49:34 +1100
Subject: [PATCH 1392/2374] Simplified code

---
 src/_imagingft.c | 14 ++++----------
 1 file changed, 4 insertions(+), 10 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index d38279f3e4b..3a65007a514 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -339,29 +339,23 @@ text_layout_raqm(
         len = PySequence_Fast_GET_SIZE(seq);
         for (j = 0; j < len; j++) {
             PyObject *item = PySequence_Fast_GET_ITEM(seq, j);
-            char *feature = NULL;
-            Py_ssize_t size = 0;
-            PyObject *bytes;
-
             if (!PyUnicode_Check(item)) {
                 Py_DECREF(seq);
                 PyErr_SetString(PyExc_TypeError, "expected a string");
                 goto failed;
             }
-            bytes = PyUnicode_AsUTF8String(item);
-            if (bytes == NULL) {
+
+            Py_ssize_t size;
+            const char *feature = PyUnicode_AsUTF8AndSize(item, &size);
+            if (feature == NULL) {
                 Py_DECREF(seq);
                 goto failed;
             }
-            feature = PyBytes_AS_STRING(bytes);
-            size = PyBytes_GET_SIZE(bytes);
             if (!raqm_add_font_feature(rq, feature, size)) {
                 Py_DECREF(seq);
-                Py_DECREF(bytes);
                 PyErr_SetString(PyExc_ValueError, "raqm_add_font_feature() failed");
                 goto failed;
             }
-            Py_DECREF(bytes);
         }
         Py_DECREF(seq);
     }

From 7708e4b524aca2e7d56fcc75eee59834622f75e8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 6 Jan 2025 20:30:47 +1100
Subject: [PATCH 1393/2374] Improved Docker coverage reporting

---
 .ci/after_success.sh              | 6 +-----
 .github/workflows/test-docker.yml | 6 +++---
 2 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/.ci/after_success.sh b/.ci/after_success.sh
index c71546f007b..6da27b975cc 100755
--- a/.ci/after_success.sh
+++ b/.ci/after_success.sh
@@ -2,8 +2,4 @@
 
 # gather the coverage data
 python3 -m pip install coverage
-if [[ $MATRIX_DOCKER ]]; then
-  python3 -m coverage xml --ignore-errors
-else
-  python3 -m coverage xml
-fi
+python3 -m coverage xml
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 4b01a10e4c2..bebb9cda277 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -90,15 +90,15 @@ jobs:
 
     - name: After success
       run: |
-        PATH="$PATH:~/.local/bin"
         docker start pillow_container
+        sudo docker cp pillow_container:/Pillow /Pillow
+        sudo chown -R runner /Pillow
         pil_path=`docker exec pillow_container /vpy3/bin/python -c 'import os, PIL;print(os.path.realpath(os.path.dirname(PIL.__file__)))'`
         docker stop pillow_container
         sudo mkdir -p $pil_path
         sudo cp src/PIL/*.py $pil_path
+        cd /Pillow
         .ci/after_success.sh
-      env:
-        MATRIX_DOCKER: ${{ matrix.docker }}
 
     - name: Upload coverage
       uses: codecov/codecov-action@v5

From b1749dff08ab96a05234e1492759011ef54cbd59 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 6 Jan 2025 17:35:41 +0000
Subject: [PATCH 1394/2374] [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.8.4 → v0.8.6](https://github.com/astral-sh/ruff-pre-commit/compare/v0.8.4...v0.8.6)
- [github.com/pre-commit/mirrors-clang-format: v19.1.5 → v19.1.6](https://github.com/pre-commit/mirrors-clang-format/compare/v19.1.5...v19.1.6)
- [github.com/woodruffw/zizmor-pre-commit: v0.10.0 → v1.0.0](https://github.com/woodruffw/zizmor-pre-commit/compare/v0.10.0...v1.0.0)
---
 .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 b76f92ec00e..20fa7d04f00 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.8.4
+    rev: v0.8.6
     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: v19.1.5
+    rev: v19.1.6
     hooks:
       - id: clang-format
         types: [c]
@@ -57,7 +57,7 @@ repos:
       - id: check-renovate
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: v0.10.0
+    rev: v1.0.0
     hooks:
       - id: zizmor
 

From 618339e2d2e9313ab8f2da0d78efec25477c4b43 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 6 Jan 2025 07:28:38 +1100
Subject: [PATCH 1395/2374] Allow saving multiple frames as BigTIFF

---
 Tests/test_file_tiff.py    | 19 +++++++++--
 src/PIL/TiffImagePlugin.py | 69 +++++++++++++++++++++++---------------
 2 files changed, 58 insertions(+), 30 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index dedd48c20b3..c4a33488136 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -117,10 +117,16 @@ def test_bigtiff(self, tmp_path: Path) -> None:
 
     def test_bigtiff_save(self, tmp_path: Path) -> None:
         outfile = str(tmp_path / "temp.tif")
-        hopper().save(outfile, big_tiff=True)
+        im = hopper()
+        im.save(outfile, big_tiff=True)
 
-        with Image.open(outfile) as im:
-            assert im.tag_v2._bigtiff is True
+        with Image.open(outfile) as reloaded:
+            assert reloaded.tag_v2._bigtiff is True
+
+        im.save(outfile, save_all=True, append_images=[im], big_tiff=True)
+
+        with Image.open(outfile) as reloaded:
+            assert reloaded.tag_v2._bigtiff is True
 
     def test_seek_too_large(self) -> None:
         with pytest.raises(ValueError, match="Unable to seek to frame"):
@@ -753,6 +759,13 @@ def test_fixoffsets(self) -> None:
             with pytest.raises(RuntimeError):
                 a.fixOffsets(1)
 
+    def test_appending_tiff_writer_writelong(self) -> None:
+        data = b"II\x2A\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
+        b = BytesIO(data)
+        with TiffImagePlugin.AppendingTiffWriter(b) as a:
+            a.writeLong(2**32 - 1)
+            assert b.getvalue() == data + b"\xff\xff\xff\xff"
+
     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
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 61eb1524311..5dd56d92b5a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -962,13 +962,16 @@ def tobytes(self, offset: int = 0) -> bytes:
         result = self._pack("Q" if self._bigtiff else "H", len(self._tags_v2))
 
         entries: list[tuple[int, int, int, bytes, bytes]] = []
-        offset += len(result) + len(self._tags_v2) * (20 if self._bigtiff else 12) + 4
+
+        fmt = "Q" if self._bigtiff else "L"
+        fmt_size = 8 if self._bigtiff else 4
+        offset += (
+            len(result) + len(self._tags_v2) * (20 if self._bigtiff else 12) + fmt_size
+        )
         stripoffsets = None
 
         # pass 1: convert tags to binary format
         # always write tags in ascending order
-        fmt = "Q" if self._bigtiff else "L"
-        fmt_size = 8 if self._bigtiff else 4
         for tag, value in sorted(self._tags_v2.items()):
             if tag == STRIPOFFSETS:
                 stripoffsets = len(entries)
@@ -1024,7 +1027,7 @@ def tobytes(self, offset: int = 0) -> bytes:
             )
 
         # -- overwrite here for multi-page --
-        result += b"\0\0\0\0"  # end of entries
+        result += self._pack(fmt, 0)  # end of entries
 
         # pass 3: write auxiliary data to file
         for tag, typ, count, value, data in entries:
@@ -2043,20 +2046,21 @@ def setup(self) -> None:
         self.offsetOfNewPage = 0
 
         self.IIMM = iimm = self.f.read(4)
+        self._bigtiff = b"\x2B" in iimm
         if not iimm:
             # empty file - first page
             self.isFirst = True
             return
 
         self.isFirst = False
-        if iimm == b"II\x2a\x00":
-            self.setEndian("<")
-        elif iimm == b"MM\x00\x2a":
-            self.setEndian(">")
-        else:
+        if iimm not in PREFIXES:
             msg = "Invalid TIFF file header"
             raise RuntimeError(msg)
 
+        self.setEndian("<" if iimm.startswith(II) else ">")
+
+        if self._bigtiff:
+            self.f.seek(4, os.SEEK_CUR)
         self.skipIFDs()
         self.goToEnd()
 
@@ -2076,11 +2080,13 @@ def finalize(self) -> None:
             msg = "IIMM of new page doesn't match IIMM of first page"
             raise RuntimeError(msg)
 
-        ifd_offset = self.readLong()
+        if self._bigtiff:
+            self.f.seek(4, os.SEEK_CUR)
+        ifd_offset = self._read(8 if self._bigtiff else 4)
         ifd_offset += self.offsetOfNewPage
         assert self.whereToWriteNewIFDOffset is not None
         self.f.seek(self.whereToWriteNewIFDOffset)
-        self.writeLong(ifd_offset)
+        self._write(ifd_offset, 8 if self._bigtiff else 4)
         self.f.seek(ifd_offset)
         self.fixIFD()
 
@@ -2126,18 +2132,20 @@ def setEndian(self, endian: str) -> None:
         self.endian = endian
         self.longFmt = f"{self.endian}L"
         self.shortFmt = f"{self.endian}H"
-        self.tagFormat = f"{self.endian}HHL"
+        self.tagFormat = f"{self.endian}HH" + ("Q" if self._bigtiff else "L")
 
     def skipIFDs(self) -> None:
         while True:
-            ifd_offset = self.readLong()
+            ifd_offset = self._read(8 if self._bigtiff else 4)
             if ifd_offset == 0:
-                self.whereToWriteNewIFDOffset = self.f.tell() - 4
+                self.whereToWriteNewIFDOffset = self.f.tell() - (
+                    8 if self._bigtiff else 4
+                )
                 break
 
             self.f.seek(ifd_offset)
-            num_tags = self.readShort()
-            self.f.seek(num_tags * 12, os.SEEK_CUR)
+            num_tags = self._read(8 if self._bigtiff else 2)
+            self.f.seek(num_tags * (20 if self._bigtiff else 12), os.SEEK_CUR)
 
     def write(self, data: Buffer, /) -> int:
         return self.f.write(data)
@@ -2185,13 +2193,17 @@ def rewriteLastShort(self, value: int) -> None:
     def rewriteLastLong(self, value: int) -> None:
         return self._rewriteLast(value, 4)
 
+    def _write(self, value: int, field_size: int) -> None:
+        bytes_written = self.f.write(
+            struct.pack(self.endian + self._fmt(field_size), value)
+        )
+        self._verify_bytes_written(bytes_written, field_size)
+
     def writeShort(self, value: int) -> None:
-        bytes_written = self.f.write(struct.pack(self.shortFmt, value))
-        self._verify_bytes_written(bytes_written, 2)
+        self._write(value, 2)
 
     def writeLong(self, value: int) -> None:
-        bytes_written = self.f.write(struct.pack(self.longFmt, value))
-        self._verify_bytes_written(bytes_written, 4)
+        self._write(value, 4)
 
     def close(self) -> None:
         self.finalize()
@@ -2199,24 +2211,27 @@ def close(self) -> None:
             self.f.close()
 
     def fixIFD(self) -> None:
-        num_tags = self.readShort()
+        num_tags = self._read(8 if self._bigtiff else 2)
 
         for i in range(num_tags):
-            tag, field_type, count = struct.unpack(self.tagFormat, self.f.read(8))
+            tag, field_type, count = struct.unpack(
+                self.tagFormat, self.f.read(12 if self._bigtiff else 8)
+            )
 
             field_size = self.fieldSizes[field_type]
             total_size = field_size * count
-            is_local = total_size <= 4
+            fmt_size = 8 if self._bigtiff else 4
+            is_local = total_size <= fmt_size
             if not is_local:
-                offset = self.readLong() + self.offsetOfNewPage
-                self.rewriteLastLong(offset)
+                offset = self._read(fmt_size) + self.offsetOfNewPage
+                self._rewriteLast(offset, fmt_size)
 
             if tag in self.Tags:
                 cur_pos = self.f.tell()
 
                 if is_local:
                     self._fixOffsets(count, field_size)
-                    self.f.seek(cur_pos + 4)
+                    self.f.seek(cur_pos + fmt_size)
                 else:
                     self.f.seek(offset)
                     self._fixOffsets(count, field_size)
@@ -2224,7 +2239,7 @@ def fixIFD(self) -> None:
 
             elif is_local:
                 # skip the locally stored value that is not an offset
-                self.f.seek(4, os.SEEK_CUR)
+                self.f.seek(fmt_size, os.SEEK_CUR)
 
     def _fixOffsets(self, count: int, field_size: int) -> None:
         for i in range(count):

From a8381c619de0c244785377322ed8bf115a899146 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 6 Jan 2025 07:28:51 +1100
Subject: [PATCH 1396/2374] Allow upgrading LONG to LONG8

---
 Tests/test_file_tiff.py    | 26 ++++++++++++++++++++++++-
 src/PIL/TiffImagePlugin.py | 39 ++++++++++++++++++++++++--------------
 2 files changed, 50 insertions(+), 15 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index c4a33488136..757d3f96a5f 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -746,7 +746,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
             assert reread.n_frames == 3
 
     def test_fixoffsets(self) -> None:
-        b = BytesIO(b"II\x2a\x00\x00\x00\x00\x00")
+        b = BytesIO(b"II\x2A\x00\x00\x00\x00\x00")
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
             b.seek(0)
             a.fixOffsets(1, isShort=True)
@@ -759,6 +759,23 @@ def test_fixoffsets(self) -> None:
             with pytest.raises(RuntimeError):
                 a.fixOffsets(1)
 
+        b = BytesIO(b"II\x2A\x00\x00\x00\x00\x00")
+        with TiffImagePlugin.AppendingTiffWriter(b) as a:
+            a.offsetOfNewPage = 2**16
+
+            b.seek(0)
+            a.fixOffsets(1, isShort=True)
+
+        b = BytesIO(b"II\x2B\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00")
+        with TiffImagePlugin.AppendingTiffWriter(b) as a:
+            a.offsetOfNewPage = 2**32
+
+            b.seek(0)
+            a.fixOffsets(1, isShort=True)
+
+            b.seek(0)
+            a.fixOffsets(1, isLong=True)
+
     def test_appending_tiff_writer_writelong(self) -> None:
         data = b"II\x2A\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
         b = BytesIO(data)
@@ -766,6 +783,13 @@ def test_appending_tiff_writer_writelong(self) -> None:
             a.writeLong(2**32 - 1)
             assert b.getvalue() == data + b"\xff\xff\xff\xff"
 
+    def test_appending_tiff_writer_rewritelastshorttolong(self) -> None:
+        data = b"II\x2A\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
+        b = BytesIO(data)
+        with TiffImagePlugin.AppendingTiffWriter(b) as a:
+            a.rewriteLastShortToLong(2**32 - 1)
+            assert b.getvalue() == data[:-2] + b"\xff\xff\xff\xff"
+
     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
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 5dd56d92b5a..8179b7f5bd9 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2175,17 +2175,19 @@ def _verify_bytes_written(bytes_written: int | None, expected: int) -> None:
             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))
-        self._verify_bytes_written(bytes_written, 4)
-
-    def _rewriteLast(self, value: int, field_size: int) -> None:
+    def _rewriteLast(
+        self, value: int, field_size: int, new_field_size: int = 0
+    ) -> None:
         self.f.seek(-field_size, os.SEEK_CUR)
+        if not new_field_size:
+            new_field_size = field_size
         bytes_written = self.f.write(
-            struct.pack(self.endian + self._fmt(field_size), value)
+            struct.pack(self.endian + self._fmt(new_field_size), value)
         )
-        self._verify_bytes_written(bytes_written, field_size)
+        self._verify_bytes_written(bytes_written, new_field_size)
+
+    def rewriteLastShortToLong(self, value: int) -> None:
+        self._rewriteLast(value, 2, 4)
 
     def rewriteLastShort(self, value: int) -> None:
         return self._rewriteLast(value, 2)
@@ -2245,18 +2247,27 @@ def _fixOffsets(self, count: int, field_size: int) -> None:
         for i in range(count):
             offset = self._read(field_size)
             offset += self.offsetOfNewPage
-            if field_size == 2 and offset >= 65536:
-                # offset is now too large - we must convert shorts to longs
+
+            new_field_size = 0
+            if self._bigtiff and field_size in (2, 4) and offset >= 2**32:
+                # offset is now too large - we must convert long to long8
+                new_field_size = 8
+            elif field_size == 2 and offset >= 2**16:
+                # offset is now too large - we must convert short to long
+                new_field_size = 4
+            if new_field_size:
                 if count != 1:
                     msg = "not implemented"
                     raise RuntimeError(msg)  # XXX TODO
 
                 # simple case - the offset is just one and therefore it is
                 # local (not referenced with another offset)
-                self.rewriteLastShortToLong(offset)
-                self.f.seek(-10, os.SEEK_CUR)
-                self.writeShort(TiffTags.LONG)  # rewrite the type to LONG
-                self.f.seek(8, os.SEEK_CUR)
+                self._rewriteLast(offset, field_size, new_field_size)
+                # Move back past the new offset, past 'count', and before 'field_type'
+                rewind = -new_field_size - 4 - 2
+                self.f.seek(rewind, os.SEEK_CUR)
+                self.writeShort(new_field_size)  # rewrite the type
+                self.f.seek(2 - rewind, os.SEEK_CUR)
             else:
                 self._rewriteLast(offset, field_size)
 

From aef6df2d04bfe86b4a69ab7d93786ea55a3e7340 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 7 Jan 2025 21:33:57 +1100
Subject: [PATCH 1397/2374] Use ImageFile._Tile

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

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index dd62460bb5d..526c6a5b614 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1030,7 +1030,7 @@ def decode(
 
         with Image.open(TEST_FILE) as im:
             im.tile = [
-                ("INFINITE", (0, 0, 128, 128), 0, ("RGB", 0, 1)),
+                ImageFile._Tile("INFINITE", (0, 0, 128, 128), 0, ("RGB", 0, 1)),
             ]
             ImageFile.LOAD_TRUNCATED_IMAGES = True
             im.load()

From f36c66746705245dec44b225868bce727dca0385 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 7 Jan 2025 22:24:08 +1100
Subject: [PATCH 1398/2374] Improved test coverage

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

diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 4cafda86536..713db848df8 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -7,7 +7,7 @@
 
 import pytest
 
-from PIL import Image, ImageSequence, SpiderImagePlugin
+from PIL import Image, SpiderImagePlugin
 
 from .helper import assert_image_equal, hopper, is_pypy
 
@@ -153,8 +153,8 @@ def test_nonstack_file() -> None:
 
 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"
+        with pytest.raises(EOFError):
+            im.seek(0)
 
 
 # for issue #4093

From 86b8e1e45fa1d425aafa444024003eb3b75d8a9d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 8 Jan 2025 10:19:09 +1100
Subject: [PATCH 1399/2374] Updated libpng to 1.6.45

---
 .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 58621bca1ed..410255b7eda 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -39,7 +39,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=10.1.0
-LIBPNG_VERSION=1.6.44
+LIBPNG_VERSION=1.6.45
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 75d6aa1bd2d..912579ce790 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "HARFBUZZ": "10.1.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
-    "LIBPNG": "1.6.44",
+    "LIBPNG": "1.6.45",
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",

From ee2b8c525632f76bde730805d11d19bbb22f1b2b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 8 Jan 2025 10:26:21 +1100
Subject: [PATCH 1400/2374] Switch to .tar.gz for libpng

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

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 912579ce790..b9695d1d802 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -123,7 +123,6 @@ def cmd_msbuild(
     "XZ": "5.6.3",
     "ZLIBNG": "2.2.3",
 }
-V["LIBPNG_DOTLESS"] = V["LIBPNG"].replace(".", "")
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
 
 
@@ -241,8 +240,8 @@ def cmd_msbuild(
     },
     "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",
+        f"FILENAME/download",
+        "filename": f"libpng-{V['LIBPNG']}.tar.gz",
         "license": "LICENSE",
         "build": [
             *cmds_cmake("png_static", "-DPNG_SHARED:BOOL=OFF", "-DPNG_TESTS:BOOL=OFF"),

From 120ba1c13d482b6f8763ab287ac5811a838f8828 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Wed, 8 Jan 2025 14:01:06 +0800
Subject: [PATCH 1401/2374] Rewrite the install_name of the ZLIB-NG library on
 macOS.

---
 .github/workflows/wheels-dependencies.sh | 8 ++++++++
 pyproject.toml                           | 1 -
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 58621bca1ed..2eac4d3d71e 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -72,6 +72,14 @@ function build_zlib_ng {
         && ./configure --prefix=$BUILD_PREFIX --zlib-compat \
         && make -j4 \
         && make install)
+
+    if [ -n "$IS_MACOS" ]; then
+        # Ensure that on macOS, the library name is an absolute path, not an
+        # @rpath, so that delocate picks up the right library (and doesn't need
+        # DYLD_LIBRARY_PATH to be set). The default Makefile doesn't have an
+        # option to control the install_name.
+        install_name_tool -id $BUILD_PREFIX/lib/libz.1.dylib $BUILD_PREFIX/lib/libz.1.dylib
+    fi
     touch zlib-stamp
 }
 
diff --git a/pyproject.toml b/pyproject.toml
index 2c6c7bcd077..aaaba0032e7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -104,7 +104,6 @@ test-extras = "tests"
 
 [tool.cibuildwheel.macos.environment]
 PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
-DYLD_LIBRARY_PATH = "$(pwd)/build/deps/darwin/lib"
 
 [tool.black]
 exclude = "wheels/multibuild"

From f281eb9b469320f29006d7454d9c38a974ad65c1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 8 Jan 2025 18:27:20 +1100
Subject: [PATCH 1402/2374] Trigger from changes in pyproject.toml

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

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 3b22ee98a2c..fd89f7585ee 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -13,6 +13,7 @@ on:
     paths:
       - ".ci/requirements-cibw.txt"
       - ".github/workflows/wheel*"
+      - "pyproject.toml"
       - "setup.py"
       - "wheels/*"
       - "winbuild/build_prepare.py"
@@ -23,6 +24,7 @@ on:
     paths:
       - ".ci/requirements-cibw.txt"
       - ".github/workflows/wheel*"
+      - "pyproject.toml"
       - "setup.py"
       - "wheels/*"
       - "winbuild/build_prepare.py"

From 84c8e38b2d88d0c4fb733d9c6e44e6af13e2e05e Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 8 Jan 2025 07:38:51 +0000
Subject: [PATCH 1403/2374] Update cygwin/cygwin-install-action action to v5

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

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index 5b0a0394688..abfeaa77f9c 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -52,7 +52,7 @@ jobs:
           persist-credentials: false
 
       - name: Install Cygwin
-        uses: cygwin/cygwin-install-action@v4
+        uses: cygwin/cygwin-install-action@v5
         with:
           packages: >
             gcc-g++

From 2eb112329e4df9ca4ea15235c2743da8f6b0eab8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 Jan 2025 08:32:42 +1100
Subject: [PATCH 1404/2374] Use python-pip instead of python3-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 a1d6ba61c9b..6b1b36cb0ca 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -68,7 +68,7 @@ jobs:
               mingw-w64-x86_64-openjpeg2 \
               mingw-w64-x86_64-python3-numpy \
               mingw-w64-x86_64-python3-olefile \
-              mingw-w64-x86_64-python3-pip \
+              mingw-w64-x86_64-python-pip \
               mingw-w64-x86_64-python-pytest \
               mingw-w64-x86_64-python-pytest-cov \
               mingw-w64-x86_64-python-pytest-timeout \

From 440b09e831873624f9e843adf658633b25983e77 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 Jan 2025 14:32:17 +1100
Subject: [PATCH 1405/2374] Removed unused mode argument from
 assert_image_similar_tofile

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

diff --git a/Tests/helper.py b/Tests/helper.py
index d6a93a8030b..3f45498bb0b 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -140,11 +140,8 @@ def assert_image_similar_tofile(
     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)
 
 

From aa686894a63cb2f15349e9592eedb95aebfc6f1f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 Jan 2025 14:32:46 +1100
Subject: [PATCH 1406/2374] Removed unused assert_all_same

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

diff --git a/Tests/helper.py b/Tests/helper.py
index 3f45498bb0b..126644c159b 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -145,10 +145,6 @@ def assert_image_similar_tofile(
         assert_image_similar(a, img, epsilon, msg)
 
 
-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: Sequence[Any], msg: str | None = None) -> None:
     assert items.count(items[0]) != len(items), msg
 

From f938af5c3cc9dd7c48f8a06a7af4870f1faf2e76 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 Jan 2025 14:38:07 +1100
Subject: [PATCH 1407/2374] Do not catch exception only to assert it is None

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

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index ee6c867c3ca..9d5154fca07 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -307,13 +307,8 @@ def test_apng_syntax_errors() -> None:
             im.load()
 
     # we can handle this case gracefully
-    exception = None
     with Image.open("Tests/images/apng/syntax_num_frames_low.png") as im:
-        try:
-            im.seek(im.n_frames - 1)
-        except Exception as e:
-            exception = e
-        assert exception is None
+        im.seek(im.n_frames - 1)
 
     with pytest.raises(OSError):
         with Image.open("Tests/images/apng/syntax_num_frames_high.png") as im:
@@ -405,13 +400,8 @@ def test_apng_save_split_fdat(tmp_path: Path) -> None:
             append_images=frames,
         )
     with Image.open(test_file) as im:
-        exception = None
-        try:
-            im.seek(im.n_frames - 1)
-            im.load()
-        except Exception as e:
-            exception = e
-        assert exception is None
+        im.seek(im.n_frames - 1)
+        im.load()
 
 
 def test_apng_save_duration_loop(tmp_path: Path) -> None:

From a34a9cd6d1d4b346573fca7336f1cb82918af4b3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 Jan 2025 14:49:48 +1100
Subject: [PATCH 1408/2374] Improved test coverage

---
 Tests/test_file_iptc.py    | 5 +----
 Tests/test_file_jpeg2k.py  | 3 +--
 Tests/test_file_libtiff.py | 6 +-----
 Tests/test_image.py        | 2 --
 4 files changed, 3 insertions(+), 13 deletions(-)

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 8a7c59fb150..c6c0c1aab9d 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -58,10 +58,7 @@ def test_getiptcinfo_fotostation() -> None:
 
     # Assert
     assert iptc is not None
-    for tag in iptc.keys():
-        if tag[0] == 240:
-            return
-    pytest.fail("FotoStation tag not found")
+    assert 240 in (tag[0] for tag in iptc.keys()), "FotoStation tag not found"
 
 
 def test_getiptcinfo_zero_padding() -> None:
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index dbc2e49ec5a..711e988df66 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -492,8 +492,7 @@ def test_plt_marker(card: ImageFile.ImageFile) -> None:
     out.seek(0)
     while True:
         marker = out.read(2)
-        if not marker:
-            pytest.fail("End of stream without PLT")
+        assert marker, "End of stream without PLT"
 
         jp2_boxid = _binary.i16be(marker)
         if jp2_boxid == 0xFF4F:
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 49d71aca77f..18dd11182c3 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -36,11 +36,7 @@ def _assert_noerr(self, tmp_path: Path, im: TiffImagePlugin.TiffImageFile) -> No
         im.load()
         im.getdata()
 
-        try:
-            assert im._compression == "group4"
-        except AttributeError:
-            print("No _compression")
-            print(dir(im))
+        assert im._compression == "group4"
 
         # can we write it back out, in a different form.
         out = str(tmp_path / "temp.png")
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 092bc07f6f1..fe43cea407f 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -189,8 +189,6 @@ def test_pathlib(self, tmp_path: Path) -> None:
                 if ext == ".jp2" and not features.check_codec("jpg_2000"):
                     pytest.skip("jpg_2000 not available")
                 temp_file = str(tmp_path / ("temp." + ext))
-                if os.path.exists(temp_file):
-                    os.remove(temp_file)
                 im.save(Path(temp_file))
 
     def test_fp_name(self, tmp_path: Path) -> None:

From 4d14991604d34f73aa5d426340adf773c81cdc6a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 Jan 2025 14:58:58 +1100
Subject: [PATCH 1409/2374] Corrected argument types

---
 Tests/test_image.py        | 4 ++--
 Tests/test_image_resize.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 092bc07f6f1..a72694ec1f6 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -667,7 +667,7 @@ def test_remap_palette(self) -> None:
         # Test illegal image mode
         with hopper() as im:
             with pytest.raises(ValueError):
-                im.remap_palette(None)
+                im.remap_palette([])
 
     def test_remap_palette_transparency(self) -> None:
         im = Image.new("P", (1, 2), (0, 0, 0))
@@ -770,7 +770,7 @@ def test_empty_exif(self) -> None:
         assert dict(exif)
 
         # Test that exif data is cleared after another load
-        exif.load(None)
+        exif.load(b"")
         assert not dict(exif)
 
         # Test loading just the EXIF header
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 57fcf9a3463..1166371b8f9 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -309,7 +309,7 @@ def resize(mode: str, size: tuple[int, int] | list[int]) -> None:
         # Test unknown resampling filter
         with hopper() as im:
             with pytest.raises(ValueError):
-                im.resize((10, 10), "unknown")
+                im.resize((10, 10), -1)
 
     @skip_unless_feature("libtiff")
     def test_transposed(self) -> None:

From 8603d6512a2e6f534d6e0fb4a9307bc3edd4f0fa Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 9 Jan 2025 14:22:29 +0200
Subject: [PATCH 1410/2374] Use python-numpy and python-olefile instead of
 python3-numpy and python3-olefile

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

diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index 6b1b36cb0ca..bb6d7dc373e 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -66,8 +66,8 @@ jobs:
               mingw-w64-x86_64-libtiff \
               mingw-w64-x86_64-libwebp \
               mingw-w64-x86_64-openjpeg2 \
-              mingw-w64-x86_64-python3-numpy \
-              mingw-w64-x86_64-python3-olefile \
+              mingw-w64-x86_64-python-numpy \
+              mingw-w64-x86_64-python-olefile \
               mingw-w64-x86_64-python-pip \
               mingw-w64-x86_64-python-pytest \
               mingw-w64-x86_64-python-pytest-cov \

From 0d93c030a576e30d3991bf5547f2e0c3e47889a9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 10 Jan 2025 19:10:42 +1100
Subject: [PATCH 1411/2374] Test passes in Python 3.13

---
 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 bb30b462d2f..6d8b4d35579 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -271,7 +271,7 @@ def test_putpixel_overflow_error(self, mode: str) -> None:
 
 
 class TestEmbeddable:
-    @pytest.mark.xfail(reason="failing test")
+    @pytest.mark.xfail(not (sys.version_info >= (3, 13)), reason="failing test")
     @pytest.mark.skipif(not is_win32(), reason="requires Windows")
     def test_embeddable(self) -> None:
         import ctypes

From 64bfdff6c8111225a1c7e4480376738123f2cb15 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 10 Jan 2025 21:51:33 +1100
Subject: [PATCH 1412/2374] Only F mode starts with F

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

diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 3a87d009adc..b26e1a996b9 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -267,7 +267,7 @@ def makeSpiderHeader(im: Image.Image) -> list[bytes]:
 
 
 def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
-    if im.mode[0] != "F":
+    if im.mode != "F":
         im = im.convert("F")
 
     hdr = makeSpiderHeader(im)

From 7166a09538bbadbeb9d02f1d9af0c8d70022a80b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 11 Jan 2025 18:57:41 +1100
Subject: [PATCH 1413/2374] Skip test_embeddable if compiler cannot be
 initialized

---
 Tests/test_image_access.py | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 6d8b4d35579..14a5e2e7bfe 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -278,6 +278,18 @@ def test_embeddable(self) -> None:
 
         from setuptools.command import build_ext
 
+        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(
+            "INCLUDEPY"
+        ).replace("include", "libs")
+        compiler.add_library_dir(libdir)
+        try:
+            compiler.initialize()
+        except Exception:
+            pytest.skip("Compiler could not be initialized")
+
         with open("embed_pil.c", "w", encoding="utf-8") as fh:
             home = sys.prefix.replace("\\", "\\\\")
             fh.write(
@@ -305,13 +317,6 @@ def test_embeddable(self) -> None:
         """
             )
 
-        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(
-            "INCLUDEPY"
-        ).replace("include", "libs")
-        compiler.add_library_dir(libdir)
         objects = compiler.compile(["embed_pil.c"])
         compiler.link_executable(objects, "embed_pil")
 

From 5ad98e7abb19710cfb0c6c70ad52b543b1c5769b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 13 Jan 2025 07:54:43 +1100
Subject: [PATCH 1414/2374] Moved get_child_images()

---
 src/PIL/Image.py     | 46 ------------------------------------------
 src/PIL/ImageFile.py | 48 +++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 47 insertions(+), 47 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index dff3d063b13..0648161be59 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1553,52 +1553,6 @@ def _reload_exif(self) -> None:
         self._exif._loaded = False
         self.getexif()
 
-    def get_child_images(self) -> list[ImageFile.ImageFile]:
-        child_images = []
-        exif = self.getexif()
-        ifds = []
-        if ExifTags.Base.SubIFDs in exif:
-            subifd_offsets = exif[ExifTags.Base.SubIFDs]
-            if subifd_offsets:
-                if not isinstance(subifd_offsets, tuple):
-                    subifd_offsets = (subifd_offsets,)
-                for subifd_offset in subifd_offsets:
-                    ifds.append((exif._get_ifd_dict(subifd_offset), subifd_offset))
-        ifd1 = exif.get_ifd(ExifTags.IFD.IFD1)
-        if ifd1 and ifd1.get(ExifTags.Base.JpegIFOffset):
-            assert exif._info is not None
-            ifds.append((ifd1, exif._info.next))
-
-        offset = None
-        for ifd, ifd_offset in ifds:
-            current_offset = self.fp.tell()
-            if offset is None:
-                offset = current_offset
-
-            fp = self.fp
-            if ifd is not None:
-                thumbnail_offset = ifd.get(ExifTags.Base.JpegIFOffset)
-                if thumbnail_offset is not None:
-                    thumbnail_offset += getattr(self, "_exif_offset", 0)
-                    self.fp.seek(thumbnail_offset)
-                    data = self.fp.read(ifd.get(ExifTags.Base.JpegIFByteCount))
-                    fp = io.BytesIO(data)
-
-            with open(fp) as im:
-                from . import TiffImagePlugin
-
-                if thumbnail_offset is None and isinstance(
-                    im, TiffImagePlugin.TiffImageFile
-                ):
-                    im._frame_pos = [ifd_offset]
-                    im._seek(0)
-                im.load()
-                child_images.append(im)
-
-        if offset is not None:
-            self.fp.seek(offset)
-        return child_images
-
     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 5d0f87a9f6b..b2a44cb4d85 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -36,7 +36,7 @@
 import sys
 from typing import IO, TYPE_CHECKING, Any, NamedTuple, cast
 
-from . import Image
+from . import ExifTags, Image
 from ._deprecate import deprecate
 from ._util import is_path
 
@@ -163,6 +163,52 @@ def __init__(
     def _open(self) -> None:
         pass
 
+    def get_child_images(self) -> list[ImageFile]:
+        child_images = []
+        exif = self.getexif()
+        ifds = []
+        if ExifTags.Base.SubIFDs in exif:
+            subifd_offsets = exif[ExifTags.Base.SubIFDs]
+            if subifd_offsets:
+                if not isinstance(subifd_offsets, tuple):
+                    subifd_offsets = (subifd_offsets,)
+                for subifd_offset in subifd_offsets:
+                    ifds.append((exif._get_ifd_dict(subifd_offset), subifd_offset))
+        ifd1 = exif.get_ifd(ExifTags.IFD.IFD1)
+        if ifd1 and ifd1.get(ExifTags.Base.JpegIFOffset):
+            assert exif._info is not None
+            ifds.append((ifd1, exif._info.next))
+
+        offset = None
+        for ifd, ifd_offset in ifds:
+            current_offset = self.fp.tell()
+            if offset is None:
+                offset = current_offset
+
+            fp = self.fp
+            if ifd is not None:
+                thumbnail_offset = ifd.get(ExifTags.Base.JpegIFOffset)
+                if thumbnail_offset is not None:
+                    thumbnail_offset += getattr(self, "_exif_offset", 0)
+                    self.fp.seek(thumbnail_offset)
+                    data = self.fp.read(ifd.get(ExifTags.Base.JpegIFByteCount))
+                    fp = io.BytesIO(data)
+
+            with Image.open(fp) as im:
+                from . import TiffImagePlugin
+
+                if thumbnail_offset is None and isinstance(
+                    im, TiffImagePlugin.TiffImageFile
+                ):
+                    im._frame_pos = [ifd_offset]
+                    im._seek(0)
+                im.load()
+                child_images.append(im)
+
+        if offset is not None:
+            self.fp.seek(offset)
+        return child_images
+
     def get_format_mimetype(self) -> str | None:
         if self.custom_mimetype:
             return self.custom_mimetype

From 34762ded7500a20f938f98250df6e650608cd57e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 13 Jan 2025 07:57:28 +1100
Subject: [PATCH 1415/2374] Assert JpegIFByteCount is int

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

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index b2a44cb4d85..f905b34b666 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -191,7 +191,10 @@ def get_child_images(self) -> list[ImageFile]:
                 if thumbnail_offset is not None:
                     thumbnail_offset += getattr(self, "_exif_offset", 0)
                     self.fp.seek(thumbnail_offset)
-                    data = self.fp.read(ifd.get(ExifTags.Base.JpegIFByteCount))
+
+                    length = ifd.get(ExifTags.Base.JpegIFByteCount)
+                    assert isinstance(length, int)
+                    data = self.fp.read(length)
                     fp = io.BytesIO(data)
 
             with Image.open(fp) as im:

From a922126ed7495466b2193c6cf582ade11f0f8fe5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 13 Jan 2025 07:57:50 +1100
Subject: [PATCH 1416/2374] Assert fp is not None

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

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index f905b34b666..3476e48ffae 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -180,6 +180,7 @@ def get_child_images(self) -> list[ImageFile]:
             ifds.append((ifd1, exif._info.next))
 
         offset = None
+        assert self.fp is not None
         for ifd, ifd_offset in ifds:
             current_offset = self.fp.tell()
             if offset is None:

From a4018d192cf8a305c3da622a53df7d144d11432c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 13 Jan 2025 21:07:32 +1100
Subject: [PATCH 1417/2374] Added Sphinx configuration key

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

diff --git a/.readthedocs.yml b/.readthedocs.yml
index def6282dd56..3e03c76ea9b 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -1,5 +1,8 @@
 version: 2
 
+sphinx:
+  configuration: docs/conf.py
+
 formats: [pdf]
 
 build:

From 2ce2ff297c9d3577e3bcc8f723107f661590afd2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 13 Jan 2025 20:37:26 +1100
Subject: [PATCH 1418/2374] Test Python 3.14 pre-release

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index d905a392585..b76b00eaa88 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", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["pypy3.10", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 
     timeout-minutes: 30
 
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 83a696f5f8b..e3efe0b593a 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -42,6 +42,7 @@ jobs:
         ]
         python-version: [
           "pypy3.10",
+          "3.14",
           "3.13t",
           "3.13",
           "3.12",

From 0f2c554c698266ec0ba464f21a616cd0eda9a7fb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Jan 2025 21:03:20 +1100
Subject: [PATCH 1419/2374] Improved comment

---
 Tests/oss-fuzz/test_fuzzers.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/Tests/oss-fuzz/test_fuzzers.py b/Tests/oss-fuzz/test_fuzzers.py
index 90eb8713a8b..50d1467fc69 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -32,21 +32,18 @@ def test_fuzz_images(path: str) -> None:
             fuzzers.fuzz_image(f.read())
             assert True
     except (
+        # Known exceptions from Pillow
         OSError,
         SyntaxError,
         MemoryError,
         ValueError,
         NotImplementedError,
         OverflowError,
-    ):
-        # Known exceptions that are through from Pillow
-        assert True
-    except (
+        # Known Image.* exceptions
         Image.DecompressionBombError,
         Image.DecompressionBombWarning,
         UnidentifiedImageError,
     ):
-        # Known Image.* exceptions
         assert True
     finally:
         fuzzers.disable_decompressionbomb_error()

From cf438c53eed627e62baff752cb874aad3bcf63d5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Jan 2025 21:04:08 +1100
Subject: [PATCH 1420/2374] Removed UnidentifiedImageError, as it inherits from
 OSError

---
 Tests/oss-fuzz/test_fuzzers.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Tests/oss-fuzz/test_fuzzers.py b/Tests/oss-fuzz/test_fuzzers.py
index 50d1467fc69..e42ec90aa54 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -7,7 +7,7 @@
 import packaging
 import pytest
 
-from PIL import Image, UnidentifiedImageError, features
+from PIL import Image, features
 from Tests.helper import skip_unless_feature
 
 if sys.platform.startswith("win32"):
@@ -42,7 +42,6 @@ def test_fuzz_images(path: str) -> None:
         # Known Image.* exceptions
         Image.DecompressionBombError,
         Image.DecompressionBombWarning,
-        UnidentifiedImageError,
     ):
         assert True
     finally:

From e70c821436763e09813f0f53c76aaa3bb4fa76f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 16 Jan 2025 20:57:49 +1100
Subject: [PATCH 1421/2374] Removed miniconda CPPFLAGS

---
 .ci/build.sh | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/.ci/build.sh b/.ci/build.sh
index e678f68ec85..ae10cb67155 100755
--- a/.ci/build.sh
+++ b/.ci/build.sh
@@ -3,8 +3,5 @@
 set -e
 
 python3 -m coverage erase
-if [ $(uname) == "Darwin" ]; then
-    export CPPFLAGS="-I/usr/local/miniconda/include";
-fi
 make clean
 make install-coverage

From 536aee5bbde0fb432c1b22d2d0eed7bd35dbfca2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 16 Jan 2025 22:12:53 +1100
Subject: [PATCH 1422/2374] Test Numpy on amd64

---
 .github/workflows/wheels-test.ps1 | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.github/workflows/wheels-test.ps1 b/.github/workflows/wheels-test.ps1
index f593c722854..a1edc14ef25 100644
--- a/.github/workflows/wheels-test.ps1
+++ b/.github/workflows/wheels-test.ps1
@@ -11,6 +11,9 @@ if ("$venv" -like "*\cibw-run-*\pp*-win_amd64\*") {
 $env:path += ";$pillow\winbuild\build\bin\"
 & "$venv\Scripts\activate.ps1"
 & reg add "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\python.exe" /v "GlobalFlag" /t REG_SZ /d "0x02000000" /f
+if ("$venv" -like "*\cibw-run-*-win_amd64\*") {
+  & python -m pip install numpy
+}
 cd $pillow
 & python -VV
 if (!$?) { exit $LASTEXITCODE }

From c67ed4678bf16be8630561ce0eb49eb0a2d3be40 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 16 Jan 2025 23:48:44 +1100
Subject: [PATCH 1423/2374] Moved strings inside debug statement

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

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index a246994efee..c871342fc50 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2202,11 +2202,15 @@ def fixIFD(self) -> None:
             if tag in self.Tags:
                 cur_pos = self.f.tell()
 
-                tagname = TiffTags.lookup(tag).name
-                typname = TYPES.get(field_type, "unknown")
-                msg = f"fixIFD: {tagname} ({tag}) - type: {typname} ({field_type})"
-                msg += f"- type size: {field_size} - count: {count}"
-                logger.debug(msg)
+                logger.debug(
+                    "fixIFD: %s (%d) - type: %s (%d) - type size: %d - count: %d",
+                    TiffTags.lookup(tag).name,
+                    tag,
+                    TYPES.get(field_type, "unknown"),
+                    field_type,
+                    field_size,
+                    count,
+                )
 
                 if is_local:
                     self._fixOffsets(count, field_size)

From a04e76a84ff7122de52ad381e1d44dc556040c36 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 Jan 2025 11:51:21 +1100
Subject: [PATCH 1424/2374] Use arm64 Linux runners

---
 .github/workflows/wheels.yml | 71 +++++++-----------------------------
 1 file changed, 13 insertions(+), 58 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index fd89f7585ee..0402f1b547b 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -42,62 +42,7 @@ env:
   FORCE_COLOR: 1
 
 jobs:
-  build-1-QEMU-emulated-wheels:
-    if: github.event_name != 'schedule'
-    name: aarch64 ${{ matrix.python-version }} ${{ matrix.spec }}
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version:
-          - pp310
-          - cp3{9,10,11}
-          - cp3{12,13}
-        spec:
-          - manylinux2014
-          - manylinux_2_28
-          - musllinux
-        exclude:
-          - { python-version: pp310, spec: musllinux }
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-          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
-
-      - name: Install cibuildwheel
-        run: |
-          python3 -m pip install -r .ci/requirements-cibw.txt
-
-      - name: Build wheels
-        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 == 'musllinux' && 'musllinux' || 'manylinux' }}*"
-          CIBW_ENABLE: cpython-prerelease
-          # Extra options for manylinux.
-          CIBW_MANYLINUX_AARCH64_IMAGE: ${{ matrix.spec }}
-          CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.spec }}
-
-      - uses: actions/upload-artifact@v4
-        with:
-          name: dist-qemu-${{ matrix.python-version }}-${{ matrix.spec }}
-          path: ./wheelhouse/*.whl
-
-  build-2-native-wheels:
+  build-native-wheels:
     if: github.event_name != 'schedule' || github.repository_owner == 'python-pillow'
     name: ${{ matrix.name }}
     runs-on: ${{ matrix.os }}
@@ -132,6 +77,14 @@ jobs:
             cibw_arch: x86_64
             build: "*manylinux*"
             manylinux: "manylinux_2_28"
+          - name: "manylinux2014 and musllinux aarch64"
+            os: ubuntu-24.04-arm
+            cibw_arch: aarch64
+          - name: "manylinux_2_28 aarch64"
+            os: ubuntu-24.04-arm
+            cibw_arch: aarch64
+            build: "*manylinux*"
+            manylinux: "manylinux_2_28"
     steps:
       - uses: actions/checkout@v4
         with:
@@ -153,6 +106,8 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BUILD: ${{ matrix.build }}
           CIBW_ENABLE: cpython-prerelease cpython-freethreading
+          CIBW_MANYLINUX_AARCH64_IMAGE: ${{ matrix.manylinux }}
+          CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_SKIP: pp39-*
@@ -275,7 +230,7 @@ jobs:
 
   scientific-python-nightly-wheels-publish:
     if: github.repository_owner == 'python-pillow' && (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
-    needs: [build-2-native-wheels, windows]
+    needs: [build-native-wheels, windows]
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
     steps:
@@ -292,7 +247,7 @@ jobs:
 
   pypi-publish:
     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]
+    needs: [build-native-wheels, windows, sdist]
     runs-on: ubuntu-latest
     name: Upload release to PyPI
     environment:

From 176c5b3749fe4642186dceb4c4253e4cd3e60e03 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 Jan 2025 11:51:42 +1100
Subject: [PATCH 1425/2374] Added pypy to CIBW_ENABLE

---
 .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 0402f1b547b..db8e4d58bab 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -105,7 +105,7 @@ jobs:
         env:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BUILD: ${{ matrix.build }}
-          CIBW_ENABLE: cpython-prerelease cpython-freethreading
+          CIBW_ENABLE: cpython-prerelease cpython-freethreading pypy
           CIBW_MANYLINUX_AARCH64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
@@ -184,7 +184,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
           CIBW_CACHE_PATH: "C:\\cibw"
-          CIBW_ENABLE: cpython-prerelease cpython-freethreading
+          CIBW_ENABLE: cpython-prerelease cpython-freethreading pypy
           CIBW_SKIP: pp39-*
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm

From be8e55d28d3525b05769aee5f36b945bd6e01f77 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 Jan 2025 18:34:23 +1100
Subject: [PATCH 1426/2374] Added deprecation warning

---
 Tests/test_image.py          |  5 ++++
 docs/deprecations.rst        | 10 +++++++
 docs/releasenotes/11.2.0.rst | 58 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 src/PIL/Image.py             |  6 ++++
 src/PIL/ImageFile.py         |  3 +-
 src/PIL/_deprecate.py        |  2 ++
 7 files changed, 84 insertions(+), 1 deletion(-)
 create mode 100644 docs/releasenotes/11.2.0.rst

diff --git a/Tests/test_image.py b/Tests/test_image.py
index fe43cea407f..10801346362 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -989,6 +989,11 @@ def test_getxmp_padded(self) -> None:
         else:
             assert im.getxmp() == {"xmpmeta": None}
 
+    def test_get_child_images(self) -> None:
+        im = Image.new("RGB", (1, 1))
+        with pytest.warns(DeprecationWarning):
+            assert im.get_child_images() == []
+
     @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/deprecations.rst b/docs/deprecations.rst
index 80966ca362a..634cee6894c 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -183,6 +183,16 @@ ExifTags.IFD.Makernote
 ``ExifTags.IFD.Makernote`` has been deprecated. Instead, use
 ``ExifTags.IFD.MakerNote``.
 
+Image.Image.get_child_images()
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.2.0
+
+``Image.Image.get_child_images()`` has been deprecated. and will be removed in Pillow
+13 (2026-10-15). It will be moved to ``ImageFile.ImageFile.get_child_images()``. The
+method uses an image's file pointer, and so child images could only be retrieved from
+an :py:class:`PIL.ImageFile.ImageFile` instance.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
new file mode 100644
index 00000000000..025b6466075
--- /dev/null
+++ b/docs/releasenotes/11.2.0.rst
@@ -0,0 +1,58 @@
+11.2.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards Incompatible Changes
+==============================
+
+TODO
+^^^^
+
+Deprecations
+============
+
+Image.Image.get_child_images()
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.2.0
+
+``Image.Image.get_child_images()`` has been deprecated. and will be removed in Pillow
+13 (2026-10-15). It will be moved to ``ImageFile.ImageFile.get_child_images()``. The
+method uses an image's file pointer, and so child images could only be retrieved from
+an :py:class:`PIL.ImageFile.ImageFile` instance.
+
+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 bd8e5536f71..be9f623d05d 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.2.0
   11.1.0
   11.0.0
   10.4.0
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 0648161be59..e512e6fc775 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1553,6 +1553,12 @@ def _reload_exif(self) -> None:
         self._exif._loaded = False
         self.getexif()
 
+    def get_child_images(self) -> list[ImageFile.ImageFile]:
+        from . import ImageFile
+
+        deprecate("Image.Image.get_child_images", 13)
+        return ImageFile.ImageFile.get_child_images(self)  # type: ignore[arg-type]
+
     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 3476e48ffae..93fb4787431 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -180,8 +180,8 @@ def get_child_images(self) -> list[ImageFile]:
             ifds.append((ifd1, exif._info.next))
 
         offset = None
-        assert self.fp is not None
         for ifd, ifd_offset in ifds:
+            assert self.fp is not None
             current_offset = self.fp.tell()
             if offset is None:
                 offset = current_offset
@@ -210,6 +210,7 @@ def get_child_images(self) -> list[ImageFile]:
                 child_images.append(im)
 
         if offset is not None:
+            assert self.fp is not None
             self.fp.seek(offset)
         return child_images
 
diff --git a/src/PIL/_deprecate.py b/src/PIL/_deprecate.py
index 83952b397ff..9f9d8bbc9cc 100644
--- a/src/PIL/_deprecate.py
+++ b/src/PIL/_deprecate.py
@@ -47,6 +47,8 @@ def deprecate(
         raise RuntimeError(msg)
     elif when == 12:
         removed = "Pillow 12 (2025-10-15)"
+    elif when == 13:
+        removed = "Pillow 13 (2026-10-15)"
     else:
         msg = f"Unknown removal version: {when}. Update {__name__}?"
         raise ValueError(msg)

From 6a0ac411e26b2b3436f3790e6830dfe18a914ffc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 Jan 2025 18:57:12 +1100
Subject: [PATCH 1427/2374] Added mozjpeg documentation

---
 docs/reference/features.rst  |  1 +
 docs/releasenotes/11.2.0.rst | 58 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 3 files changed, 60 insertions(+)
 create mode 100644 docs/releasenotes/11.2.0.rst

diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index 427c0f606d2..e5fdca24032 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -54,6 +54,7 @@ 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.
+* ``mozjpeg``: (compile time) Whether Pillow was compiled against the mozjpeg version of libjpeg. Compile-time version number is available.
 * ``zlib_ng``: (compile time) Whether Pillow was compiled against the zlib-ng version of zlib. Compile-time version number is available.
 * ``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/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
new file mode 100644
index 00000000000..f9eff3c0720
--- /dev/null
+++ b/docs/releasenotes/11.2.0.rst
@@ -0,0 +1,58 @@
+11.2.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards Incompatible Changes
+==============================
+
+TODO
+^^^^
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+API Changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API Additions
+=============
+
+Check for mozjpeg
+^^^^^^^^^^^^^^^^^
+
+You can check if Pillow has been built against the mozjpeg version of the
+libjpeg library, and what version of mozjpeg is being used::
+
+    from PIL import features
+    features.check_feature("mozjpeg")  # True or False
+    features.version_feature("mozjpeg")  # "4.1.1" for example, or None
+
+Other Changes
+=============
+
+TODO
+^^^^
+
+TODO
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index bd8e5536f71..be9f623d05d 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.2.0
   11.1.0
   11.0.0
   10.4.0

From 30c4ad484c1e784ea316e53083381e823b26a2f0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 18 Jan 2025 07:48:15 +1100
Subject: [PATCH 1428/2374] Updated capitalization

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/reference/features.rst  | 2 +-
 docs/releasenotes/11.2.0.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index e5fdca24032..0e173fe8785 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -54,7 +54,7 @@ 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.
-* ``mozjpeg``: (compile time) Whether Pillow was compiled against the mozjpeg version of libjpeg. Compile-time version number is available.
+* ``mozjpeg``: (compile time) Whether Pillow was compiled against the MozJPEG version of libjpeg. Compile-time version number is available.
 * ``zlib_ng``: (compile time) Whether Pillow was compiled against the zlib-ng version of zlib. Compile-time version number is available.
 * ``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/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index f9eff3c0720..f1e15377eac 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -42,7 +42,7 @@ API Additions
 Check for mozjpeg
 ^^^^^^^^^^^^^^^^^
 
-You can check if Pillow has been built against the mozjpeg version of the
+You can check if Pillow has been built against the MozJPEG version of the
 libjpeg library, and what version of mozjpeg is being used::
 
     from PIL import features

From 284297755a8d982f327c08f391192a6a57937d2b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 18 Jan 2025 07:55:49 +1100
Subject: [PATCH 1429/2374] Updated capitalization

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

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index 725de509275..df28d05af1a 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -44,11 +44,11 @@ TODO
 API Additions
 =============
 
-Check for mozjpeg
+Check for MozJPEG
 ^^^^^^^^^^^^^^^^^
 
 You can check if Pillow has been built against the MozJPEG version of the
-libjpeg library, and what version of mozjpeg is being used::
+libjpeg library, and what version of MozJPEG is being used::
 
     from PIL import features
     features.check_feature("mozjpeg")  # True or False

From ba606622b4441b87ec74d420a25f0c60882004eb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 18 Jan 2025 13:53:39 +1100
Subject: [PATCH 1430/2374] Updated Ubuntu arm to 24.04 with arm64 runner

---
 .github/workflows/test-docker.yml      | 9 +++++----
 docs/installation/platform-support.rst | 6 ++----
 2 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index bebb9cda277..0d9033413e3 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -29,13 +29,13 @@ concurrency:
 jobs:
   build:
 
-    runs-on: ubuntu-latest
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
+        os: ["ubuntu-latest"]
         docker: [
           # Run slower jobs first to give them a headstart and reduce waiting time
-          ubuntu-22.04-jammy-arm64v8,
           ubuntu-24.04-noble-ppc64le,
           ubuntu-24.04-noble-s390x,
           # Then run the remainder
@@ -55,12 +55,13 @@ jobs:
         ]
         dockerTag: [main]
         include:
-          - docker: "ubuntu-22.04-jammy-arm64v8"
-            qemu-arch: "aarch64"
           - docker: "ubuntu-24.04-noble-ppc64le"
             qemu-arch: "ppc64le"
           - docker: "ubuntu-24.04-noble-s390x"
             qemu-arch: "s390x"
+          - docker: "ubuntu-24.04-noble-arm64v8"
+            os: "ubuntu-24.04-arm"
+            dockerTag: main
 
     name: ${{ matrix.docker }}
 
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 814d6a9cfb9..9eafad3c4b7 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -44,11 +44,9 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.9, 3.10, 3.11,           | x86-64              |
 |                                  | 3.12, 3.13, PyPy3          |                     |
-|                                  +----------------------------+---------------------+
-|                                  | 3.10                       | arm64v8             |
 +----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, ppc64le,    |
-|                                  |                            | s390x               |
+| Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, arm64v8,    |
+|                                  |                            | ppc64le, s390x      |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2019              | 3.9                        | x86                 |
 +----------------------------------+----------------------------+---------------------+

From 4ff18e03b8a703bbc15a9d19ce253c19f1820b5c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 18 Jan 2025 20:57:04 +1100
Subject: [PATCH 1431/2374] Moved file pointer handling into ImageFile close

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index e512e6fc775..a0c9ff8eba5 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -619,8 +619,6 @@ def __exit__(self, *args):
 
     def close(self) -> None:
         """
-        Closes the file pointer, if possible.
-
         This operation will destroy the image core and release its memory.
         The image data will be unusable afterward.
 
@@ -629,13 +627,6 @@ def close(self) -> None:
         :py:meth:`~PIL.Image.Image.load` method. See :ref:`file-handling` for
         more information.
         """
-        if hasattr(self, "fp"):
-            try:
-                self._close_fp()
-                self.fp = None
-            except Exception as msg:
-                logger.debug("Error closing: %s", msg)
-
         if getattr(self, "map", None):
             self.map: mmap.mmap | None = None
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 93fb4787431..d716e3b5c6d 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -31,6 +31,7 @@
 import abc
 import io
 import itertools
+import logging
 import os
 import struct
 import sys
@@ -43,6 +44,8 @@
 if TYPE_CHECKING:
     from ._typing import StrOrBytesPath
 
+logger = logging.getLogger(__name__)
+
 MAXBLOCK = 65536
 
 SAFEBLOCK = 1024 * 1024
@@ -163,6 +166,26 @@ def __init__(
     def _open(self) -> None:
         pass
 
+    def close(self) -> None:
+        """
+        Closes the file pointer, if possible.
+
+        This operation will destroy the image core and release its memory.
+        The image data will be unusable afterward.
+
+        This function is required to close images that have multiple frames or
+        have not had their file read and closed by the
+        :py:meth:`~PIL.Image.Image.load` method. See :ref:`file-handling` for
+        more information.
+        """
+        try:
+            self._close_fp()
+            self.fp = None
+        except Exception as msg:
+            logger.debug("Error closing: %s", msg)
+
+        super().close()
+
     def get_child_images(self) -> list[ImageFile]:
         child_images = []
         exif = self.getexif()

From c78d23d5471dc24b20f0eb387442e63ab0c63f9b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 18 Jan 2025 21:22:44 +1100
Subject: [PATCH 1432/2374] Moved _close_fp into ImageFile

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a0c9ff8eba5..99b1b9ab303 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -603,16 +603,10 @@ def _new(self, im: core.ImagingCore) -> Image:
     def __enter__(self):
         return self
 
-    def _close_fp(self):
-        if getattr(self, "_fp", False):
-            if self._fp != self.fp:
-                self._fp.close()
-            self._fp = DeferredError(ValueError("Operation on closed image"))
-        if self.fp:
-            self.fp.close()
-
     def __exit__(self, *args):
-        if hasattr(self, "fp"):
+        from . import ImageFile
+
+        if isinstance(self, ImageFile.ImageFile):
             if getattr(self, "_exclusive_fp", False):
                 self._close_fp()
             self.fp = None
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index d716e3b5c6d..c3901d4888c 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -39,7 +39,7 @@
 
 from . import ExifTags, Image
 from ._deprecate import deprecate
-from ._util import is_path
+from ._util import DeferredError, is_path
 
 if TYPE_CHECKING:
     from ._typing import StrOrBytesPath
@@ -166,6 +166,14 @@ def __init__(
     def _open(self) -> None:
         pass
 
+    def _close_fp(self):
+        if getattr(self, "_fp", False):
+            if self._fp != self.fp:
+                self._fp.close()
+            self._fp = DeferredError(ValueError("Operation on closed image"))
+        if self.fp:
+            self.fp.close()
+
     def close(self) -> None:
         """
         Closes the file pointer, if possible.

From 8d9279dd7329cc8dd330f483df2867fd51ca8dcf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 18 Jan 2025 21:58:04 +1100
Subject: [PATCH 1433/2374] Only use outside border of stroke in text()

---
 Tests/test_imagedraw.py | 22 ++++++++++++++++++++++
 Tests/test_imagefont.py | 14 ++++++++++++++
 src/PIL/ImageDraw.py    |  1 +
 src/PIL/ImageFont.py    |  1 +
 src/PIL/_imagingft.pyi  |  1 +
 src/_imagingft.c        |  7 +++++--
 6 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 5fc1c27661a..28d7ed7252d 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1396,6 +1396,28 @@ def test_stroke_descender() -> None:
     assert_image_similar_tofile(im, "Tests/images/imagedraw_stroke_descender.png", 6.76)
 
 
+@skip_unless_feature("freetype2")
+def test_stroke_inside_gap() -> 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), "i", "#f00", font, stroke_width=20)
+
+    # Assert
+    for y in range(im.height):
+        glyph = ""
+        for x in range(im.width):
+            if im.getpixel((x, y)) == (0, 0, 0):
+                if glyph == "started":
+                    glyph = "ended"
+            else:
+                assert glyph != "ended", "Gap inside stroked glyph"
+                glyph = "started"
+
+
 @skip_unless_feature("freetype2")
 def test_split_word() -> None:
     # Arrange
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 6a0a940b987..f110cc1d05c 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -461,6 +461,20 @@ def test_free_type_font_get_mask(font: ImageFont.FreeTypeFont) -> None:
     assert mask.size == (108, 13)
 
 
+def test_stroke_mask() -> None:
+    # Arrange
+    text = "i"
+
+    # Act
+    font = ImageFont.truetype(FONT_PATH, 128)
+    mask = font.getmask(text, stroke_width=2)
+
+    # Assert
+    assert mask.getpixel((34, 5)) == 255
+    assert mask.getpixel((38, 5)) == 0
+    assert mask.getpixel((42, 5)) == 255
+
+
 def test_load_when_image_not_found() -> None:
     with tempfile.NamedTemporaryFile(delete=False) as tmp:
         pass
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d8e4c0c60de..d0f6c5b7db1 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -643,6 +643,7 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                     features=features,
                     language=language,
                     stroke_width=stroke_width,
+                    stroke_filled=True,
                     anchor=anchor,
                     ink=ink,
                     start=start,
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index d8c2655609e..a4986aa8c40 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -644,6 +644,7 @@ def fill(width: int, height: int) -> Image.core.ImagingCore:
             features,
             language,
             stroke_width,
+            kwargs.get("stroke_filled", False),
             anchor,
             ink,
             start[0],
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index 9cc9822f5b4..81329474730 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -28,6 +28,7 @@ class Font:
         features: list[str] | None,
         lang: str | None,
         stroke_width: float,
+        stroke_filled: bool,
         anchor: str | None,
         foreground_ink_long: int,
         x_start: float,
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 3a65007a514..4281e0b5e77 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -834,6 +834,7 @@ font_render(FontObject *self, PyObject *args) {
     int mask = 0;  /* is FT_LOAD_TARGET_MONO enabled? */
     int color = 0; /* is FT_LOAD_COLOR enabled? */
     float stroke_width = 0;
+    int stroke_filled = 0;
     PY_LONG_LONG foreground_ink_long = 0;
     unsigned int foreground_ink;
     const char *mode = NULL;
@@ -853,7 +854,7 @@ font_render(FontObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "OO|zzOzfzLffO:render",
+            "OO|zzOzfpzLffO:render",
             &string,
             &fill,
             &mode,
@@ -861,6 +862,7 @@ font_render(FontObject *self, PyObject *args) {
             &features,
             &lang,
             &stroke_width,
+            &stroke_filled,
             &anchor,
             &foreground_ink_long,
             &x_start,
@@ -1005,7 +1007,8 @@ font_render(FontObject *self, PyObject *args) {
         if (stroker != NULL) {
             error = FT_Get_Glyph(glyph_slot, &glyph);
             if (!error) {
-                error = FT_Glyph_Stroke(&glyph, stroker, 1);
+                error = stroke_filled ? FT_Glyph_StrokeBorder(&glyph, stroker, 0, 1)
+                                      : FT_Glyph_Stroke(&glyph, stroker, 1);
             }
             if (!error) {
                 FT_Vector origin = {0, 0};

From 0318304f9ae63fe81e513bdb32c1497539c66176 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 18 Jan 2025 17:27:25 +1100
Subject: [PATCH 1434/2374] Do not draw normal text onto stroke text if they
 are the same color

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

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d0f6c5b7db1..81f8fbce013 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -693,7 +693,8 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                 draw_text(stroke_ink, stroke_width)
 
                 # Draw normal text
-                draw_text(ink, 0)
+                if ink != stroke_ink:
+                    draw_text(ink)
             else:
                 # Only draw normal text
                 draw_text(ink)

From 427244877bb243c29fd07543f577ee6036daff4f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 19 Jan 2025 15:09:12 +1100
Subject: [PATCH 1435/2374] Support saving cICP chunk

---
 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 4b97992a31f..f56555160b4 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1382,7 +1382,7 @@ def _save(
         b"\0",  # 12: interlace flag
     )
 
-    chunks = [b"cHRM", b"gAMA", b"sBIT", b"sRGB", b"tIME"]
+    chunks = [b"cHRM", b"cICP", b"gAMA", b"sBIT", b"sRGB", b"tIME"]
 
     icc = im.encoderinfo.get("icc_profile", im.info.get("icc_profile"))
     if icc:

From 8a90975c14e8176791f431cabbcf14029c1b36a2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 22 Jan 2025 23:14:34 +1100
Subject: [PATCH 1436/2374] Seek relative to current position

---
 src/PIL/BufrStubImagePlugin.py | 5 ++---
 src/PIL/GribStubImagePlugin.py | 5 ++---
 src/PIL/Hdf5StubImagePlugin.py | 5 ++---
 3 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 0ee2f653b2c..50c41c48292 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -10,6 +10,7 @@
 #
 from __future__ import annotations
 
+import os
 from typing import IO
 
 from . import Image, ImageFile
@@ -40,13 +41,11 @@ class BufrStubImageFile(ImageFile.StubImageFile):
     format_description = "BUFR"
 
     def _open(self) -> None:
-        offset = self.fp.tell()
-
         if not _accept(self.fp.read(4)):
             msg = "Not a BUFR file"
             raise SyntaxError(msg)
 
-        self.fp.seek(offset)
+        self.fp.seek(-4, os.SEEK_CUR)
 
         # make something up
         self._mode = "F"
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index e9aa084b281..eb1b1483b73 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -10,6 +10,7 @@
 #
 from __future__ import annotations
 
+import os
 from typing import IO
 
 from . import Image, ImageFile
@@ -40,13 +41,11 @@ class GribStubImageFile(ImageFile.StubImageFile):
     format_description = "GRIB"
 
     def _open(self) -> None:
-        offset = self.fp.tell()
-
         if not _accept(self.fp.read(8)):
             msg = "Not a GRIB file"
             raise SyntaxError(msg)
 
-        self.fp.seek(offset)
+        self.fp.seek(-8, os.SEEK_CUR)
 
         # make something up
         self._mode = "F"
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index cc9e73deb80..ddc21850863 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -10,6 +10,7 @@
 #
 from __future__ import annotations
 
+import os
 from typing import IO
 
 from . import Image, ImageFile
@@ -40,13 +41,11 @@ class HDF5StubImageFile(ImageFile.StubImageFile):
     format_description = "HDF5"
 
     def _open(self) -> None:
-        offset = self.fp.tell()
-
         if not _accept(self.fp.read(8)):
             msg = "Not an HDF file"
             raise SyntaxError(msg)
 
-        self.fp.seek(offset)
+        self.fp.seek(-8, os.SEEK_CUR)
 
         # make something up
         self._mode = "F"

From e31441fc41ff54217317b61db395dfc9b5a0dc79 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 24 Jan 2025 19:51:07 +1100
Subject: [PATCH 1437/2374] Use Ubuntu 22.04 for 24.04 ppc64le and s390x

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

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 0d9033413e3..da5e191da27 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -35,10 +35,6 @@ jobs:
       matrix:
         os: ["ubuntu-latest"]
         docker: [
-          # Run slower jobs first to give them a headstart and reduce waiting time
-          ubuntu-24.04-noble-ppc64le,
-          ubuntu-24.04-noble-s390x,
-          # Then run the remainder
           alpine,
           amazon-2-amd64,
           amazon-2023-amd64,
@@ -56,9 +52,13 @@ jobs:
         dockerTag: [main]
         include:
           - docker: "ubuntu-24.04-noble-ppc64le"
+            os: "ubuntu-22.04"
             qemu-arch: "ppc64le"
+            dockerTag: main
           - docker: "ubuntu-24.04-noble-s390x"
+            os: "ubuntu-22.04"
             qemu-arch: "s390x"
+            dockerTag: main
           - docker: "ubuntu-24.04-noble-arm64v8"
             os: "ubuntu-24.04-arm"
             dockerTag: main

From 9d4232101fb84da0d7dbf2622b140ba125f65f76 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 24 Jan 2025 07:05:26 +1100
Subject: [PATCH 1438/2374] Updated libimagequant to 4.3.4

---
 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 8d62d5ac733..88756f8f9b9 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -2,7 +2,7 @@
 # install libimagequant
 
 archive_name=libimagequant
-archive_version=4.3.3
+archive_version=4.3.4
 
 archive=$archive_name-$archive_version
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 03359de31cd..46a4c1245d1 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -64,7 +64,7 @@ Many of Pillow's features require external libraries:
 
 * **libimagequant** provides improved color quantization
 
-  * Pillow has been tested with libimagequant **2.6-4.3.3**
+  * Pillow has been tested with libimagequant **2.6-4.3.4**
   * Libimagequant is licensed GPLv3, which is more restrictive than
     the Pillow license, therefore we will not be distributing binaries
     with libimagequant support enabled.

From f52dbe749b00e97b1c81f0dbc3ef398468d65369 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 24 Jan 2025 14:08:29 +1100
Subject: [PATCH 1439/2374] Updated libpng to 1.6.46

---
 .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 410255b7eda..e01ad064aac 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -39,7 +39,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=10.1.0
-LIBPNG_VERSION=1.6.45
+LIBPNG_VERSION=1.6.46
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b9695d1d802..8818c74024a 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "HARFBUZZ": "10.1.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
-    "LIBPNG": "1.6.45",
+    "LIBPNG": "1.6.46",
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",

From 16a8e2bde4b4f9616eef58a447f878e664c2486a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 24 Jan 2025 08:48:12 +1100
Subject: [PATCH 1440/2374] Updated xz to 5.6.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 410255b7eda..4ab0f1b3003 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -42,7 +42,7 @@ HARFBUZZ_VERSION=10.1.0
 LIBPNG_VERSION=1.6.45
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
-XZ_VERSION=5.6.3
+XZ_VERSION=5.6.4
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
 ZLIB_NG_VERSION=2.2.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b9695d1d802..1c20fad44b4 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -120,7 +120,7 @@ def cmd_msbuild(
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",
-    "XZ": "5.6.3",
+    "XZ": "5.6.4",
     "ZLIBNG": "2.2.3",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])

From 569b785371aa717a004adb0166feb565bbb01b7b Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 25 Jan 2025 18:04:52 +1100
Subject: [PATCH 1441/2374] Updated harfbuzz to 10.2.0 (#8688)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .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 b1b5bcf9406..dffb360856a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,7 +38,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=10.1.0
+HARFBUZZ_VERSION=10.2.0
 LIBPNG_VERSION=1.6.46
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index d18facab4cc..54b5d983f6e 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.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "10.1.0",
+    "HARFBUZZ": "10.2.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
     "LIBPNG": "1.6.46",

From e7ae4aaad04483be775b4dda9bb8803ba63e5669 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Wed, 18 Sep 2024 11:42:44 +0200
Subject: [PATCH 1442/2374] Use Py_RETURN_NONE macro when possible

---
 src/_imaging.c     | 93 ++++++++++++++++------------------------------
 src/_imagingcms.c  | 90 +++++++++++++++-----------------------------
 src/_imagingft.c   |  6 +--
 src/_imagingmath.c |  6 +--
 src/_imagingtk.c   |  3 +-
 src/decode.c       |  6 +--
 src/display.c      | 18 +++------
 src/encode.c       |  6 +--
 src/outline.c      | 15 +++-----
 src/path.c         |  6 +--
 10 files changed, 83 insertions(+), 166 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 00772d01275..2fd2deffbe6 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -473,8 +473,7 @@ getpixel(Imaging im, ImagingAccess access, int x, int y) {
     }
 
     /* unknown type */
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static char *
@@ -965,8 +964,7 @@ _convert2(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -1214,8 +1212,7 @@ _getpixel(ImagingObject *self, PyObject *args) {
     }
 
     if (self->access == NULL) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return getpixel(self->image, self->access, x, y);
@@ -1417,8 +1414,7 @@ _paste(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -1691,8 +1687,7 @@ _putdata(ImagingObject *self, PyObject *args) {
 
     Py_XDECREF(seq);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -1752,8 +1747,7 @@ _putpalette(ImagingObject *self, PyObject *args) {
     self->image->palette->size = palettesize * 8 / bits;
     unpack(self->image->palette->palette, palette, self->image->palette->size);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -1777,8 +1771,7 @@ _putpalettealpha(ImagingObject *self, PyObject *args) {
     strcpy(self->image->palette->mode, "RGBA");
     self->image->palette->palette[index * 4 + 3] = (UINT8)alpha;
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -1805,8 +1798,7 @@ _putpalettealphas(ImagingObject *self, PyObject *args) {
         self->image->palette->palette[i * 4 + 3] = (UINT8)values[i];
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -1842,8 +1834,7 @@ _putpixel(ImagingObject *self, PyObject *args) {
         self->access->put_pixel(im, x, y, ink);
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -2010,8 +2001,7 @@ im_setmode(ImagingObject *self, PyObject *args) {
     }
     self->access = ImagingAccessNew(im);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -2074,8 +2064,7 @@ _transform(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -2202,8 +2191,7 @@ _getbbox(ImagingObject *self, PyObject *args) {
     }
 
     if (!ImagingGetBBox(self->image, bbox, alpha_only)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return Py_BuildValue("iiii", bbox[0], bbox[1], bbox[2], bbox[3]);
@@ -2283,8 +2271,7 @@ _getextrema(ImagingObject *self) {
         }
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -2347,8 +2334,7 @@ _fillband(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -2363,8 +2349,7 @@ _putband(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -2950,8 +2935,7 @@ _draw_arc(ImagingDrawObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -2988,8 +2972,7 @@ _draw_bitmap(ImagingDrawObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -3045,8 +3028,7 @@ _draw_chord(ImagingDrawObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -3100,8 +3082,7 @@ _draw_ellipse(ImagingDrawObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -3164,8 +3145,7 @@ _draw_lines(ImagingDrawObject *self, PyObject *args) {
 
     free(xy);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -3196,8 +3176,7 @@ _draw_points(ImagingDrawObject *self, PyObject *args) {
 
     free(xy);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 /* from outline.c */
@@ -3225,8 +3204,7 @@ _draw_outline(ImagingDrawObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -3282,8 +3260,7 @@ _draw_pieslice(ImagingDrawObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -3334,8 +3311,7 @@ _draw_polygon(ImagingDrawObject *self, PyObject *args) {
 
     free(ixy);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -3389,8 +3365,7 @@ _draw_rectangle(ImagingDrawObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static struct PyMethodDef _draw_methods[] = {
@@ -3595,8 +3570,7 @@ _save_ppm(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 /* -------------------------------------------------------------------- */
@@ -3984,8 +3958,7 @@ _reset_stats(PyObject *self, PyObject *args) {
     arena->stats_freed_blocks = 0;
     MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -4045,8 +4018,7 @@ _set_alignment(PyObject *self, PyObject *args) {
     ImagingDefaultArena.alignment = alignment;
     MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -4070,8 +4042,7 @@ _set_block_size(PyObject *self, PyObject *args) {
     ImagingDefaultArena.block_size = block_size;
     MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -4099,8 +4070,7 @@ _set_blocks_max(PyObject *self, PyObject *args) {
         return ImagingError_MemoryError();
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -4115,8 +4085,7 @@ _clear_cache(PyObject *self, PyObject *args) {
     ImagingMemoryClearCache(&ImagingDefaultArena, i);
     MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 /* -------------------------------------------------------------------- */
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 1805ebde17f..14cf2acd22d 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -654,8 +654,7 @@ cms_get_display_profile_win32(PyObject *self, PyObject *args) {
         return PyUnicode_FromStringAndSize(filename, filename_size - 1);
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 #endif
 
@@ -672,20 +671,17 @@ _profile_read_mlu(CmsProfileObject *self, cmsTagSignature info) {
     wchar_t *buf;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     mlu = cmsReadTag(self->profile, info);
     if (!mlu) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     len = cmsMLUgetWide(mlu, lc, cc, NULL, 0);
     if (len == 0) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     buf = malloc(len);
@@ -723,14 +719,12 @@ _profile_read_signature(CmsProfileObject *self, cmsTagSignature info) {
     unsigned int *sig;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     sig = (unsigned int *)cmsReadTag(self->profile, info);
     if (!sig) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return _profile_read_int_as_string(*sig);
@@ -780,14 +774,12 @@ _profile_read_ciexyz(CmsProfileObject *self, cmsTagSignature info, int multi) {
     cmsCIEXYZ *XYZ;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     XYZ = (cmsCIEXYZ *)cmsReadTag(self->profile, info);
     if (!XYZ) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
     if (multi) {
         return _xyz3_py(XYZ);
@@ -801,14 +793,12 @@ _profile_read_ciexyy_triple(CmsProfileObject *self, cmsTagSignature info) {
     cmsCIExyYTRIPLE *triple;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     triple = (cmsCIExyYTRIPLE *)cmsReadTag(self->profile, info);
     if (!triple) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     /* Note: lcms does all the heavy lifting and error checking (nr of
@@ -835,21 +825,18 @@ _profile_read_named_color_list(CmsProfileObject *self, cmsTagSignature info) {
     PyObject *result;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     ncl = (cmsNAMEDCOLORLIST *)cmsReadTag(self->profile, info);
     if (ncl == NULL) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     n = cmsNamedColorCount(ncl);
     result = PyList_New(n);
     if (!result) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     for (i = 0; i < n; i++) {
@@ -858,8 +845,7 @@ _profile_read_named_color_list(CmsProfileObject *self, cmsTagSignature info) {
         str = PyUnicode_FromString(name);
         if (str == NULL) {
             Py_DECREF(result);
-            Py_INCREF(Py_None);
-            return Py_None;
+            Py_RETURN_NONE;
         }
         PyList_SET_ITEM(result, i, str);
     }
@@ -926,8 +912,7 @@ _is_intent_supported(CmsProfileObject *self, int clut) {
 
     result = PyDict_New();
     if (result == NULL) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     n = cmsGetSupportedIntents(INTENTS, intent_ids, intent_descs);
@@ -957,8 +942,7 @@ _is_intent_supported(CmsProfileObject *self, int clut) {
             Py_XDECREF(id);
             Py_XDECREF(entry);
             Py_XDECREF(result);
-            Py_INCREF(Py_None);
-            return Py_None;
+            Py_RETURN_NONE;
         }
         PyDict_SetItem(result, id, entry);
         Py_DECREF(id);
@@ -1042,8 +1026,7 @@ cms_profile_getattr_creation_date(CmsProfileObject *self, void *closure) {
 
     result = cmsGetHeaderCreationDateTime(self->profile, &ct);
     if (!result) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return PyDateTime_FromDateAndTime(
@@ -1141,8 +1124,7 @@ cms_profile_getattr_saturation_rendering_intent_gamut(
 static PyObject *
 cms_profile_getattr_red_colorant(CmsProfileObject *self, void *closure) {
     if (!cmsIsMatrixShaper(self->profile)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
     return _profile_read_ciexyz(self, cmsSigRedColorantTag, 0);
 }
@@ -1150,8 +1132,7 @@ cms_profile_getattr_red_colorant(CmsProfileObject *self, void *closure) {
 static PyObject *
 cms_profile_getattr_green_colorant(CmsProfileObject *self, void *closure) {
     if (!cmsIsMatrixShaper(self->profile)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
     return _profile_read_ciexyz(self, cmsSigGreenColorantTag, 0);
 }
@@ -1159,8 +1140,7 @@ cms_profile_getattr_green_colorant(CmsProfileObject *self, void *closure) {
 static PyObject *
 cms_profile_getattr_blue_colorant(CmsProfileObject *self, void *closure) {
     if (!cmsIsMatrixShaper(self->profile)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
     return _profile_read_ciexyz(self, cmsSigBlueColorantTag, 0);
 }
@@ -1176,21 +1156,18 @@ cms_profile_getattr_media_white_point_temperature(
     cmsBool result;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     XYZ = (cmsCIEXYZ *)cmsReadTag(self->profile, info);
     if (XYZ == NULL || XYZ->X == 0) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     cmsXYZ2xyY(&xyY, XYZ);
     result = cmsTempFromWhitePoint(&tempK, &xyY);
     if (!result) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
     return PyFloat_FromDouble(tempK);
 }
@@ -1229,8 +1206,7 @@ cms_profile_getattr_red_primary(CmsProfileObject *self, void *closure) {
         result = _calculate_rgb_primaries(self, &primaries);
     }
     if (!result) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return _xyz_py(&primaries.Red);
@@ -1245,8 +1221,7 @@ cms_profile_getattr_green_primary(CmsProfileObject *self, void *closure) {
         result = _calculate_rgb_primaries(self, &primaries);
     }
     if (!result) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return _xyz_py(&primaries.Green);
@@ -1261,8 +1236,7 @@ cms_profile_getattr_blue_primary(CmsProfileObject *self, void *closure) {
         result = _calculate_rgb_primaries(self, &primaries);
     }
     if (!result) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return _xyz_py(&primaries.Blue);
@@ -1321,14 +1295,12 @@ cms_profile_getattr_icc_measurement_condition(CmsProfileObject *self, void *clos
     const char *geo;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     mc = (cmsICCMeasurementConditions *)cmsReadTag(self->profile, info);
     if (!mc) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     if (mc->Geometry == 1) {
@@ -1362,14 +1334,12 @@ cms_profile_getattr_icc_viewing_condition(CmsProfileObject *self, void *closure)
     cmsTagSignature info = cmsSigViewingConditionsTag;
 
     if (!cmsIsTag(self->profile, info)) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     vc = (cmsICCViewingConditions *)cmsReadTag(self->profile, info);
     if (!vc) {
-        Py_INCREF(Py_None);
-        return Py_None;
+        Py_RETURN_NONE;
     }
 
     return Py_BuildValue(
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 3a65007a514..5113cca77e9 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1371,8 +1371,7 @@ font_setvarname(FontObject *self, PyObject *args) {
         return geterror(error);
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -1426,8 +1425,7 @@ font_setvaraxes(FontObject *self, PyObject *args) {
         return geterror(error);
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 #endif
 
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index dbe636707f4..75b3716b5c1 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -192,8 +192,7 @@ _unop(PyObject *self, PyObject *args) {
 
     unop(out, im1);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -226,8 +225,7 @@ _binop(PyObject *self, PyObject *args) {
 
     binop(out, im1, im2);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyMethodDef _functions[] = {
diff --git a/src/_imagingtk.c b/src/_imagingtk.c
index c70d044bb86..c4448265114 100644
--- a/src/_imagingtk.c
+++ b/src/_imagingtk.c
@@ -37,8 +37,7 @@ _tkinit(PyObject *self, PyObject *args) {
     /* This will bomb if interp is invalid... */
     TkImaging_Init(interp);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyMethodDef functions[] = {
diff --git a/src/decode.c b/src/decode.c
index 51d0aced2bd..1f2c22491f8 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -213,8 +213,7 @@ _setimage(ImagingDecoderObject *decoder, PyObject *args) {
     Py_XDECREF(decoder->lock);
     decoder->lock = op;
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -231,8 +230,7 @@ _setfd(ImagingDecoderObject *decoder, PyObject *args) {
     Py_XINCREF(fd);
     state->fd = fd;
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
diff --git a/src/display.c b/src/display.c
index eed75975d71..36ab3b237ef 100644
--- a/src/display.c
+++ b/src/display.c
@@ -85,8 +85,7 @@ _expose(ImagingDisplayObject *display, PyObject *args) {
 
     ImagingExposeDIB(display->dib, hdc);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -112,8 +111,7 @@ _draw(ImagingDisplayObject *display, PyObject *args) {
 
     ImagingDrawDIB(display->dib, hdc, dst, src);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 extern Imaging
@@ -143,8 +141,7 @@ _paste(ImagingDisplayObject *display, PyObject *args) {
 
     ImagingPasteDIB(display->dib, im, xy);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -190,8 +187,7 @@ _releasedc(ImagingDisplayObject *display, PyObject *args) {
 
     ReleaseDC(window, dc);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -211,8 +207,7 @@ _frombytes(ImagingDisplayObject *display, PyObject *args) {
     memcpy(display->dib->bits, buffer.buf, buffer.len);
 
     PyBuffer_Release(&buffer);
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -709,8 +704,7 @@ PyImaging_EventLoopWin32(PyObject *self, PyObject *args) {
     }
     Py_END_ALLOW_THREADS;
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 /* -------------------------------------------------------------------- */
diff --git a/src/encode.c b/src/encode.c
index d369a1b4598..0bf5e63c585 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -278,8 +278,7 @@ _setimage(ImagingEncoderObject *encoder, PyObject *args) {
     Py_XDECREF(encoder->lock);
     encoder->lock = op;
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -296,8 +295,7 @@ _setfd(ImagingEncoderObject *encoder, PyObject *args) {
     Py_XINCREF(fd);
     state->fd = fd;
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
diff --git a/src/outline.c b/src/outline.c
index 27cc255cf84..4aa6bd59e51 100644
--- a/src/outline.c
+++ b/src/outline.c
@@ -89,8 +89,7 @@ _outline_move(OutlineObject *self, PyObject *args) {
 
     ImagingOutlineMove(self->outline, x0, y0);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -102,8 +101,7 @@ _outline_line(OutlineObject *self, PyObject *args) {
 
     ImagingOutlineLine(self->outline, x1, y1);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -115,8 +113,7 @@ _outline_curve(OutlineObject *self, PyObject *args) {
 
     ImagingOutlineCurve(self->outline, x1, y1, x2, y2, x3, y3);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -127,8 +124,7 @@ _outline_close(OutlineObject *self, PyObject *args) {
 
     ImagingOutlineClose(self->outline);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static PyObject *
@@ -140,8 +136,7 @@ _outline_transform(OutlineObject *self, PyObject *args) {
 
     ImagingOutlineTransform(self->outline, a);
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static struct PyMethodDef _outline_methods[] = {
diff --git a/src/path.c b/src/path.c
index 067f42f62de..b508df2ac30 100644
--- a/src/path.c
+++ b/src/path.c
@@ -415,8 +415,7 @@ path_map(PyPathObject *self, PyObject *args) {
     }
     self->mapping = 0;
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static int
@@ -528,8 +527,7 @@ path_transform(PyPathObject *self, PyObject *args) {
         }
     }
 
-    Py_INCREF(Py_None);
-    return Py_None;
+    Py_RETURN_NONE;
 }
 
 static struct PyMethodDef methods[] = {

From e19a1496c21ee5cca0fcbfcd0f1d97b9d8aa6bcc Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 27 Jan 2025 21:17:51 +1100
Subject: [PATCH 1443/2374] Use monkeypatch (#8707)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/check_png_dos.py           | 21 ++++---
 Tests/test_decompression_bomb.py | 19 +++----
 Tests/test_file_fli.py           | 29 +++++-----
 Tests/test_file_gif.py           | 96 ++++++++++++++++----------------
 Tests/test_file_ico.py           | 25 ++++-----
 Tests/test_file_jpeg.py          | 12 ++--
 Tests/test_file_jpeg2k.py        | 13 ++---
 Tests/test_file_libtiff.py       | 25 ++++-----
 Tests/test_file_png.py           | 64 +++++++++------------
 Tests/test_file_tiff.py          |  5 +-
 Tests/test_file_webp.py          |  7 +--
 Tests/test_imagefile.py          | 20 +++----
 Tests/test_map.py                | 14 ++---
 13 files changed, 155 insertions(+), 195 deletions(-)

diff --git a/Tests/check_png_dos.py b/Tests/check_png_dos.py
index 63d6657bc45..1bfb94ab7f7 100644
--- a/Tests/check_png_dos.py
+++ b/Tests/check_png_dos.py
@@ -3,26 +3,25 @@
 import zlib
 from io import BytesIO
 
+import pytest
+
 from PIL import Image, ImageFile, PngImagePlugin
 
 TEST_FILE = "Tests/images/png_decompression_dos.png"
 
 
-def test_ignore_dos_text() -> None:
-    ImageFile.LOAD_TRUNCATED_IMAGES = True
+def test_ignore_dos_text(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
 
-    try:
-        im = Image.open(TEST_FILE)
+    with Image.open(TEST_FILE) as im:
         im.load()
-    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"
+        assert isinstance(im, PngImagePlugin.PngImageFile)
+        for s in im.text.values():
+            assert len(s) < 1024 * 1024, "Text chunk larger than 1M"
 
-    for s in im.info.values():
-        assert len(s) < 1024 * 1024, "Text chunk larger than 1M"
+        for s in im.info.values():
+            assert len(s) < 1024 * 1024, "Text chunk larger than 1M"
 
 
 def test_dos_text() -> None:
diff --git a/Tests/test_decompression_bomb.py b/Tests/test_decompression_bomb.py
index c140156f9ea..98d833736fa 100644
--- a/Tests/test_decompression_bomb.py
+++ b/Tests/test_decompression_bomb.py
@@ -12,19 +12,16 @@
 
 
 class TestDecompressionBomb:
-    def teardown_method(self) -> None:
-        Image.MAX_IMAGE_PIXELS = ORIGINAL_LIMIT
-
     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) -> None:
+    def test_no_warning_no_limit(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Arrange
         # Turn limit off
-        Image.MAX_IMAGE_PIXELS = None
+        monkeypatch.setattr(Image, "MAX_IMAGE_PIXELS", None)
         assert Image.MAX_IMAGE_PIXELS is None
 
         # Act / Assert
@@ -33,18 +30,18 @@ def test_no_warning_no_limit(self) -> None:
         with Image.open(TEST_FILE):
             pass
 
-    def test_warning(self) -> None:
+    def test_warning(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Set limit to trigger warning on the test file
-        Image.MAX_IMAGE_PIXELS = 128 * 128 - 1
+        monkeypatch.setattr(Image, "MAX_IMAGE_PIXELS", 128 * 128 - 1)
         assert Image.MAX_IMAGE_PIXELS == 128 * 128 - 1
 
         with pytest.warns(Image.DecompressionBombWarning):
             with Image.open(TEST_FILE):
                 pass
 
-    def test_exception(self) -> None:
+    def test_exception(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Set limit to trigger exception on the test file
-        Image.MAX_IMAGE_PIXELS = 64 * 128 - 1
+        monkeypatch.setattr(Image, "MAX_IMAGE_PIXELS", 64 * 128 - 1)
         assert Image.MAX_IMAGE_PIXELS == 64 * 128 - 1
 
         with pytest.raises(Image.DecompressionBombError):
@@ -66,9 +63,9 @@ def test_exception_gif_extents(self) -> None:
             with pytest.raises(Image.DecompressionBombError):
                 im.seek(1)
 
-    def test_exception_gif_zero_width(self) -> None:
+    def test_exception_gif_zero_width(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Set limit to trigger exception on the test file
-        Image.MAX_IMAGE_PIXELS = 4 * 64 * 128
+        monkeypatch.setattr(Image, "MAX_IMAGE_PIXELS", 4 * 64 * 128)
         assert Image.MAX_IMAGE_PIXELS == 4 * 64 * 128
 
         with pytest.raises(Image.DecompressionBombError):
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 0a7740cc87d..876561a88b8 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -35,22 +35,19 @@ 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
+def test_prefix_chunk(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
+    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]
 
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 5d46b157d55..61a9475c73d 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -109,7 +109,7 @@ def test_palette_not_needed_for_second_frame() -> None:
         assert_image_similar(im, hopper("L").convert("RGB"), 8)
 
 
-def test_strategy() -> None:
+def test_strategy(monkeypatch: pytest.MonkeyPatch) -> None:
     with Image.open("Tests/images/iss634.gif") as im:
         expected_rgb_always = im.convert("RGB")
 
@@ -119,35 +119,36 @@ def test_strategy() -> None:
         im.seek(1)
         expected_different = im.convert("RGB")
 
-    try:
-        GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_ALWAYS
-        with Image.open("Tests/images/iss634.gif") as im:
-            assert im.mode == "RGB"
-            assert_image_equal(im, expected_rgb_always)
+    monkeypatch.setattr(
+        GifImagePlugin, "LOADING_STRATEGY", GifImagePlugin.LoadingStrategy.RGB_ALWAYS
+    )
+    with Image.open("Tests/images/iss634.gif") as im:
+        assert im.mode == "RGB"
+        assert_image_equal(im, expected_rgb_always)
 
-        with Image.open("Tests/images/chi.gif") as im:
-            assert im.mode == "RGBA"
-            assert_image_equal(im, expected_rgb_always_rgba)
+    with Image.open("Tests/images/chi.gif") as im:
+        assert im.mode == "RGBA"
+        assert_image_equal(im, expected_rgb_always_rgba)
 
-        GifImagePlugin.LOADING_STRATEGY = (
-            GifImagePlugin.LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY
-        )
-        # Stay in P mode with only a global palette
-        with Image.open("Tests/images/chi.gif") as im:
-            assert im.mode == "P"
+    monkeypatch.setattr(
+        GifImagePlugin,
+        "LOADING_STRATEGY",
+        GifImagePlugin.LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY,
+    )
+    # Stay in P mode with only a global palette
+    with Image.open("Tests/images/chi.gif") as im:
+        assert im.mode == "P"
 
-            im.seek(1)
-            assert im.mode == "P"
-            assert_image_equal(im.convert("RGB"), expected_different)
+        im.seek(1)
+        assert im.mode == "P"
+        assert_image_equal(im.convert("RGB"), expected_different)
 
-        # Change to RGB mode when a frame has an individual palette
-        with Image.open("Tests/images/iss634.gif") as im:
-            assert im.mode == "P"
+    # Change to RGB mode when a frame has an individual palette
+    with Image.open("Tests/images/iss634.gif") as im:
+        assert im.mode == "P"
 
-            im.seek(1)
-            assert im.mode == "RGB"
-    finally:
-        GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_AFTER_FIRST
+        im.seek(1)
+        assert im.mode == "RGB"
 
 
 def test_optimize() -> None:
@@ -555,17 +556,15 @@ def test_dispose_background_transparency() -> None:
 def test_transparent_dispose(
     loading_strategy: GifImagePlugin.LoadingStrategy,
     expected_colors: tuple[tuple[int | tuple[int, int, int, int], ...]],
+    monkeypatch: pytest.MonkeyPatch,
 ) -> None:
-    GifImagePlugin.LOADING_STRATEGY = loading_strategy
-    try:
-        with Image.open("Tests/images/transparent_dispose.gif") as img:
-            for frame in range(3):
-                img.seek(frame)
-                for x in range(3):
-                    color = img.getpixel((x, 0))
-                    assert color == expected_colors[frame][x]
-    finally:
-        GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_AFTER_FIRST
+    monkeypatch.setattr(GifImagePlugin, "LOADING_STRATEGY", loading_strategy)
+    with Image.open("Tests/images/transparent_dispose.gif") as img:
+        for frame in range(3):
+            img.seek(frame)
+            for x in range(3):
+                color = img.getpixel((x, 0))
+                assert color == expected_colors[frame][x]
 
 
 def test_dispose_previous() -> None:
@@ -1398,24 +1397,23 @@ def test_lzw_bits() -> None:
     ),
 )
 def test_extents(
-    test_file: str, loading_strategy: GifImagePlugin.LoadingStrategy
+    test_file: str,
+    loading_strategy: GifImagePlugin.LoadingStrategy,
+    monkeypatch: pytest.MonkeyPatch,
 ) -> None:
-    GifImagePlugin.LOADING_STRATEGY = loading_strategy
-    try:
-        with Image.open("Tests/images/" + test_file) as im:
-            assert im.size == (100, 100)
+    monkeypatch.setattr(GifImagePlugin, "LOADING_STRATEGY", loading_strategy)
+    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
+        im.load()
+        assert im.im.size == (150, 150)
 
 
 def test_missing_background() -> None:
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index e81aae66995..e240faf1ec8 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -243,26 +243,23 @@ def test_draw_reloaded(tmp_path: Path) -> None:
         assert_image_equal_tofile(im, "Tests/images/hopper_draw.ico")
 
 
-def test_truncated_mask() -> None:
+def test_truncated_mask(monkeypatch: pytest.MonkeyPatch) -> None:
     # 1 bpp
     with open("Tests/images/hopper_mask.ico", "rb") as fp:
         data = fp.read()
 
-    ImageFile.LOAD_TRUNCATED_IMAGES = True
+    monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
     data = data[:-3]
 
-    try:
-        with Image.open(io.BytesIO(data)) as im:
-            assert im.mode == "1"
+    with Image.open(io.BytesIO(data)) as im:
+        assert im.mode == "1"
 
-        # 32 bpp
-        output = io.BytesIO()
-        expected = hopper("RGBA")
-        expected.save(output, "ico", bitmap_format="bmp")
+    # 32 bpp
+    output = io.BytesIO()
+    expected = hopper("RGBA")
+    expected.save(output, "ico", bitmap_format="bmp")
 
-        data = output.getvalue()[:-1]
+    data = output.getvalue()[:-1]
 
-        with Image.open(io.BytesIO(data)) as im:
-            assert im.mode == "RGB"
-    finally:
-        ImageFile.LOAD_TRUNCATED_IMAGES = False
+    with Image.open(io.BytesIO(data)) as im:
+        assert im.mode == "RGB"
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 4be9e16a781..772ecc2bc62 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -530,12 +530,13 @@ def test_ff00_jpeg_header(self) -> None:
     @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) -> None:
+    def test_truncated_jpeg_should_read_all_the_data(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
         filename = "Tests/images/truncated_jpeg.jpg"
-        ImageFile.LOAD_TRUNCATED_IMAGES = True
+        monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
         with Image.open(filename) as im:
             im.load()
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
             assert im.getbbox() is not None
 
     def test_truncated_jpeg_throws_oserror(self) -> None:
@@ -1024,7 +1025,7 @@ def test_save_xmp(self, tmp_path: Path) -> None:
             im.save(f, xmp=b"1" * 65505)
 
     @pytest.mark.timeout(timeout=1)
-    def test_eof(self) -> None:
+    def test_eof(self, monkeypatch: pytest.MonkeyPatch) -> 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):
@@ -1039,9 +1040,8 @@ def decode(
             im.tile = [
                 ImageFile._Tile("INFINITE", (0, 0, 128, 128), 0, ("RGB", 0, 1)),
             ]
-            ImageFile.LOAD_TRUNCATED_IMAGES = True
+            monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
             im.load()
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
 
     def test_separate_tables(self) -> None:
         im = hopper()
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 711e988df66..589240191ef 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -181,14 +181,11 @@ def test_load_dpi() -> None:
         assert "dpi" not in im.info
 
 
-def test_restricted_icc_profile() -> None:
-    ImageFile.LOAD_TRUNCATED_IMAGES = True
-    try:
-        # JPEG2000 image with a restricted ICC profile and a known colorspace
-        with Image.open("Tests/images/balloon_eciRGBv2_aware.jp2") as im:
-            assert im.mode == "RGB"
-    finally:
-        ImageFile.LOAD_TRUNCATED_IMAGES = False
+def test_restricted_icc_profile(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
+    # JPEG2000 image with a restricted ICC profile and a known colorspace
+    with Image.open("Tests/images/balloon_eciRGBv2_aware.jp2") as im:
+        assert im.mode == "RGB"
 
 
 @pytest.mark.skipif(
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 18dd11182c3..a5715db1b5f 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1156,23 +1156,22 @@ def test_save_multistrip(self, compression: str, tmp_path: Path) -> None:
             assert len(im.tag_v2[STRIPOFFSETS]) > 1
 
     @pytest.mark.parametrize("argument", (True, False))
-    def test_save_single_strip(self, argument: bool, tmp_path: Path) -> None:
+    def test_save_single_strip(
+        self, argument: bool, tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
         im = hopper("RGB").resize((256, 256))
         out = str(tmp_path / "temp.tif")
 
         if not argument:
-            TiffImagePlugin.STRIP_SIZE = 2**18
-        try:
-            arguments: dict[str, str | int] = {"compression": "tiff_adobe_deflate"}
-            if argument:
-                arguments["strip_size"] = 2**18
-            im.save(out, "TIFF", **arguments)
-
-            with Image.open(out) as im:
-                assert isinstance(im, TiffImagePlugin.TiffImageFile)
-                assert len(im.tag_v2[STRIPOFFSETS]) == 1
-        finally:
-            TiffImagePlugin.STRIP_SIZE = 65536
+            monkeypatch.setattr(TiffImagePlugin, "STRIP_SIZE", 2**18)
+        arguments: dict[str, str | int] = {"compression": "tiff_adobe_deflate"}
+        if argument:
+            arguments["strip_size"] = 2**18
+        im.save(out, "TIFF", **arguments)
+
+        with Image.open(out) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+            assert len(im.tag_v2[STRIPOFFSETS]) == 1
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", None))
     def test_save_zero(self, compression: str | None, tmp_path: Path) -> None:
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index d87883279a3..efd2e5cd970 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -363,7 +363,7 @@ def test_verify_struct_error(self) -> None:
                 with pytest.raises((OSError, SyntaxError)):
                     im.verify()
 
-    def test_verify_ignores_crc_error(self) -> None:
+    def test_verify_ignores_crc_error(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # check ignores crc errors in ancillary chunks
 
         chunk_data = chunk(b"tEXt", b"spam")
@@ -373,24 +373,20 @@ def test_verify_ignores_crc_error(self) -> None:
         with pytest.raises(SyntaxError):
             PngImagePlugin.PngImageFile(BytesIO(image_data))
 
-        ImageFile.LOAD_TRUNCATED_IMAGES = True
-        try:
-            im = load(image_data)
-            assert im is not None
-        finally:
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
+        monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
+        im = load(image_data)
+        assert im is not None
 
-    def test_verify_not_ignores_crc_error_in_required_chunk(self) -> None:
+    def test_verify_not_ignores_crc_error_in_required_chunk(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
         # check does not ignore crc errors in required chunks
 
         image_data = MAGIC + IHDR[:-1] + b"q" + TAIL
 
-        ImageFile.LOAD_TRUNCATED_IMAGES = True
-        try:
-            with pytest.raises(SyntaxError):
-                PngImagePlugin.PngImageFile(BytesIO(image_data))
-        finally:
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
+        monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
+        with pytest.raises(SyntaxError):
+            PngImagePlugin.PngImageFile(BytesIO(image_data))
 
     def test_roundtrip_dpi(self) -> None:
         # Check dpi roundtripping
@@ -600,7 +596,7 @@ def test_roundtrip_private_chunk(self) -> None:
             (b"prIV", b"VALUE3", True),
         ]
 
-    def test_textual_chunks_after_idat(self) -> None:
+    def test_textual_chunks_after_idat(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/hopper.png") as im:
             assert "comment" in im.text
             for k, v in {
@@ -614,18 +610,17 @@ def test_textual_chunks_after_idat(self) -> None:
             with pytest.raises(OSError):
                 assert isinstance(im.text, dict)
 
+        # Raises an EOFError in load_end
+        with Image.open("Tests/images/hopper_idat_after_image_end.png") as im:
+            assert im.text == {"TXT": "VALUE", "ZIP": "VALUE"}
+
         # Raises a UnicodeDecodeError in load_end
         with Image.open("Tests/images/truncated_image.png") as im:
             # The file is truncated
             with pytest.raises(OSError):
                 im.text
-            ImageFile.LOAD_TRUNCATED_IMAGES = True
+            monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
             assert isinstance(im.text, dict)
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
-
-        # Raises an EOFError in load_end
-        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"):
@@ -651,15 +646,16 @@ 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: bytes) -> None:
+    def test_truncated_chunks(
+        self, cid: bytes, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
         fp = BytesIO()
         with PngImagePlugin.PngStream(fp) as png:
             with pytest.raises(ValueError):
                 png.call(cid, 0, 0)
 
-            ImageFile.LOAD_TRUNCATED_IMAGES = True
+            monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
             png.call(cid, 0, 0)
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
 
     @pytest.mark.parametrize("save_all", (True, False))
     def test_specify_bits(self, save_all: bool, tmp_path: Path) -> None:
@@ -789,17 +785,14 @@ class MyStdOut:
         with Image.open(mystdout) as reloaded:
             assert_image_equal_tofile(reloaded, TEST_PNG_FILE)
 
-    def test_truncated_end_chunk(self) -> None:
+    def test_truncated_end_chunk(self, monkeypatch: pytest.MonkeyPatch) -> None:
         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/truncated_end_chunk.png") as im:
-                assert_image_equal_tofile(im, "Tests/images/hopper.png")
-        finally:
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
+        monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
+        with Image.open("Tests/images/truncated_end_chunk.png") as im:
+            assert_image_equal_tofile(im, "Tests/images/hopper.png")
 
 
 @pytest.mark.skipif(is_win32(), reason="Requires Unix or macOS")
@@ -808,11 +801,11 @@ 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) -> None:
+    def test_leak_load(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with open("Tests/images/hopper.png", "rb") as f:
             DATA = BytesIO(f.read(16 * 1024))
 
-        ImageFile.LOAD_TRUNCATED_IMAGES = True
+        monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
         with Image.open(DATA) as im:
             im.load()
 
@@ -820,7 +813,4 @@ def core() -> None:
             with Image.open(DATA) as im:
                 im.load()
 
-        try:
-            self._test_leak(core)
-        finally:
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
+        self._test_leak(core)
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 757d3f96a5f..67f808b60a1 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -939,11 +939,10 @@ def test_string_dimension(self) -> None:
 
     @pytest.mark.timeout(6)
     @pytest.mark.filterwarnings("ignore:Truncated File Read")
-    def test_timeout(self) -> None:
+    def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/timeout-6646305047838720") as im:
-            ImageFile.LOAD_TRUNCATED_IMAGES = True
+            monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
             im.load()
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
 
     @pytest.mark.parametrize(
         "test_file",
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index ad5aa9ed62c..abe888241b4 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -28,9 +28,9 @@
 
 
 class TestUnsupportedWebp:
-    def test_unsupported(self) -> None:
+    def test_unsupported(self, monkeypatch: pytest.MonkeyPatch) -> None:
         if HAVE_WEBP:
-            WebPImagePlugin.SUPPORTED = False
+            monkeypatch.setattr(WebPImagePlugin, "SUPPORTED", False)
 
         file_path = "Tests/images/hopper.webp"
         with pytest.warns(UserWarning):
@@ -38,9 +38,6 @@ def test_unsupported(self) -> None:
                 with Image.open(file_path):
                     pass
 
-        if HAVE_WEBP:
-            WebPImagePlugin.SUPPORTED = True
-
 
 @skip_unless_feature("webp")
 class TestFileWebp:
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 8bef90ce43c..b05d29dae96 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -191,13 +191,10 @@ def test_truncated_with_errors(self) -> None:
                 im.load()
 
     @skip_unless_feature("zlib")
-    def test_truncated_without_errors(self) -> None:
+    def test_truncated_without_errors(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/truncated_image.png") as im:
-            ImageFile.LOAD_TRUNCATED_IMAGES = True
-            try:
-                im.load()
-            finally:
-                ImageFile.LOAD_TRUNCATED_IMAGES = False
+            monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
+            im.load()
 
     @skip_unless_feature("zlib")
     def test_broken_datastream_with_errors(self) -> None:
@@ -206,13 +203,12 @@ def test_broken_datastream_with_errors(self) -> None:
                 im.load()
 
     @skip_unless_feature("zlib")
-    def test_broken_datastream_without_errors(self) -> None:
+    def test_broken_datastream_without_errors(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
         with Image.open("Tests/images/broken_data_stream.png") as im:
-            ImageFile.LOAD_TRUNCATED_IMAGES = True
-            try:
-                im.load()
-            finally:
-                ImageFile.LOAD_TRUNCATED_IMAGES = False
+            monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
+            im.load()
 
 
 class MockPyDecoder(ImageFile.PyDecoder):
diff --git a/Tests/test_map.py b/Tests/test_map.py
index 93140f6e5a5..1278ba3a6d6 100644
--- a/Tests/test_map.py
+++ b/Tests/test_map.py
@@ -7,36 +7,30 @@
 from PIL import Image
 
 
-def test_overflow() -> None:
+def test_overflow(monkeypatch: pytest.MonkeyPatch) -> 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
     # (offset + size(bytes)) > SIZE_MAX
 
     # Note that this image triggers the decompression bomb warning:
-    max_pixels = Image.MAX_IMAGE_PIXELS
-    Image.MAX_IMAGE_PIXELS = None
+    monkeypatch.setattr(Image, "MAX_IMAGE_PIXELS", None)
 
     # This image hits the offset test.
     with Image.open("Tests/images/l2rgb_read.bmp") as im:
         with pytest.raises((ValueError, MemoryError, OSError)):
             im.load()
 
-    Image.MAX_IMAGE_PIXELS = max_pixels
 
-
-def test_tobytes() -> None:
+def test_tobytes(monkeypatch: pytest.MonkeyPatch) -> None:
     # Note that this image triggers the decompression bomb warning:
-    max_pixels = Image.MAX_IMAGE_PIXELS
-    Image.MAX_IMAGE_PIXELS = None
+    monkeypatch.setattr(Image, "MAX_IMAGE_PIXELS", None)
 
     # Previously raised an access violation on Windows
     with Image.open("Tests/images/l2rgb_read.bmp") as im:
         with pytest.raises((ValueError, MemoryError, OSError)):
             im.tobytes()
 
-    Image.MAX_IMAGE_PIXELS = max_pixels
-
 
 @pytest.mark.skipif(sys.maxsize <= 2**32, reason="Requires 64-bit system")
 def test_ysize() -> None:

From a9d05a1e5122f1bab86d9c4d1b34a9cd40093d51 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 28 Jan 2025 07:59:44 +1100
Subject: [PATCH 1444/2374] Fixed unclosed file warnings (#8705)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_libtiff.py | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index a5715db1b5f..0332947106a 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1103,13 +1103,15 @@ def test_exif_transpose(self) -> None:
     )
     def test_buffering(self, test_file: str) -> None:
         # load exif first
-        with Image.open(open(test_file, "rb", buffering=1048576)) as im:
-            exif = dict(im.getexif())
+        with open(test_file, "rb", buffering=1048576) as f:
+            with Image.open(f) as im:
+                exif = dict(im.getexif())
 
         # load image before exif
-        with Image.open(open(test_file, "rb", buffering=1048576)) as im2:
-            im2.load()
-            exif_after_load = dict(im2.getexif())
+        with open(test_file, "rb", buffering=1048576) as f:
+            with Image.open(f) as im2:
+                im2.load()
+                exif_after_load = dict(im2.getexif())
 
         assert exif == exif_after_load
 

From 849768df7afbe02094fea2cda31f71e9267265d6 Mon Sep 17 00:00:00 2001
From: Aleksandr Karpinskii <homm86@gmail.com>
Date: Tue, 17 Sep 2024 15:49:20 +0200
Subject: [PATCH 1445/2374] Remove unused declaration

---
 src/libImaging/Imaging.h | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 31052c68a97..0c2d3fc2e34 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -609,10 +609,6 @@ ImagingLibTiffDecode(
 extern int
 ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);
 #endif
-#ifdef HAVE_LIBMPEG
-extern int
-ImagingMpegDecode(Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
-#endif
 extern int
 ImagingMspDecode(Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
 extern int

From f598c0323392f12f0bd6d0b26e3c7de106c0b11d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 29 Jan 2025 17:33:55 +1100
Subject: [PATCH 1446/2374] Removed unused file

---
 src/libImaging/Except.c | 72 -----------------------------------------
 1 file changed, 72 deletions(-)
 delete mode 100644 src/libImaging/Except.c

diff --git a/src/libImaging/Except.c b/src/libImaging/Except.c
deleted file mode 100644
index f42ff9aec9e..00000000000
--- a/src/libImaging/Except.c
+++ /dev/null
@@ -1,72 +0,0 @@
-/*
- * The Python Imaging Library
- * $Id$
- *
- * default exception handling
- *
- * This module is usually overridden by application code (e.g.
- * _imaging.c for PIL's standard Python bindings).  If you get
- * linking errors, remove this file from your project/library.
- *
- * history:
- * 1995-06-15 fl   Created
- * 1998-12-29 fl   Minor tweaks
- * 2003-09-13 fl   Added ImagingEnter/LeaveSection()
- *
- * Copyright (c) 1997-2003 by Secret Labs AB.
- * Copyright (c) 1995-2003 by Fredrik Lundh.
- *
- * See the README file for information on usage and redistribution.
- */
-
-#include "Imaging.h"
-
-/* exception state */
-
-void *
-ImagingError_OSError(void) {
-    fprintf(stderr, "*** exception: file access error\n");
-    return NULL;
-}
-
-void *
-ImagingError_MemoryError(void) {
-    fprintf(stderr, "*** exception: out of memory\n");
-    return NULL;
-}
-
-void *
-ImagingError_ModeError(void) {
-    return ImagingError_ValueError("bad image mode");
-}
-
-void *
-ImagingError_Mismatch(void) {
-    return ImagingError_ValueError("images don't match");
-}
-
-void *
-ImagingError_ValueError(const char *message) {
-    if (!message) {
-        message = "exception: bad argument to function";
-    }
-    fprintf(stderr, "*** %s\n", message);
-    return NULL;
-}
-
-void
-ImagingError_Clear(void) {
-    /* nop */;
-}
-
-/* thread state */
-
-void
-ImagingSectionEnter(ImagingSectionCookie *cookie) {
-    /* pass */
-}
-
-void
-ImagingSectionLeave(ImagingSectionCookie *cookie) {
-    /* pass */
-}

From 9a4f39588dc082f6a6fbab3354b2a55fc588c195 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 29 Jan 2025 18:58:53 +1100
Subject: [PATCH 1447/2374] Use embedded color for text length in
 multiline_text

---
 src/PIL/ImageDraw.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d8e4c0c60de..dd691eeec0c 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -742,7 +742,12 @@ def multiline_text(
         line_spacing = self._multiline_spacing(font, spacing, stroke_width)
         for line in lines:
             line_width = self.textlength(
-                line, font, direction=direction, features=features, language=language
+                line,
+                font,
+                direction=direction,
+                features=features,
+                language=language,
+                embedded_color=embedded_color,
             )
             widths.append(line_width)
             max_width = max(max_width, line_width)

From 7093de46a7629956b77fba1ce1bfaf4ebb9c194d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 29 Jan 2025 19:42:25 +1100
Subject: [PATCH 1448/2374] Moved common multiline code into
 _prepare_multiline_text

---
 src/PIL/ImageDraw.py | 181 ++++++++++++++++++++-----------------------
 1 file changed, 86 insertions(+), 95 deletions(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index dd691eeec0c..d8b5180ded2 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -557,21 +557,6 @@ def _multiline_check(self, text: AnyStr) -> bool:
 
         return split_character in text
 
-    def _multiline_split(self, text: AnyStr) -> list[AnyStr]:
-        return text.split("\n" if isinstance(text, str) else b"\n")
-
-    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
-            + spacing
-        )
-
     def text(
         self,
         xy: tuple[float, float],
@@ -697,29 +682,30 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                 # Only draw normal text
                 draw_text(ink)
 
-    def multiline_text(
+    def _prepare_multiline_text(
         self,
         xy: tuple[float, float],
         text: AnyStr,
-        fill: _Ink | None = None,
         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,
-        stroke_fill: _Ink | None = None,
-        embedded_color: bool = False,
-        *,
-        font_size: float | None = None,
-    ) -> None:
+        ),
+        anchor: str | None,
+        spacing: float,
+        align: str,
+        direction: str | None,
+        features: list[str] | None,
+        language: str | None,
+        stroke_width: float,
+        embedded_color: bool,
+        font_size: float | None,
+    ) -> tuple[
+        ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont,
+        str,
+        list[tuple[tuple[float, float], AnyStr]],
+    ]:
         if direction == "ttb":
             msg = "ttb direction is unsupported for multiline text"
             raise ValueError(msg)
@@ -738,8 +724,13 @@ def multiline_text(
 
         widths = []
         max_width: float = 0
-        lines = self._multiline_split(text)
-        line_spacing = self._multiline_spacing(font, spacing, stroke_width)
+        lines = text.split("\n" if isinstance(text, str) else b"\n")
+        line_spacing = (
+            self.textbbox((0, 0), "A", font, stroke_width=stroke_width)[3]
+            + stroke_width
+            + spacing
+        )
+
         for line in lines:
             line_width = self.textlength(
                 line,
@@ -758,6 +749,7 @@ def multiline_text(
         elif anchor[1] == "d":
             top -= (len(lines) - 1) * line_spacing
 
+        parts = []
         for idx, line in enumerate(lines):
             left = xy[0]
             width_difference = max_width - widths[idx]
@@ -779,8 +771,53 @@ def multiline_text(
                 msg = 'align must be "left", "center" or "right"'
                 raise ValueError(msg)
 
+            parts.append(((left, top), line))
+
+            top += line_spacing
+
+        return font, anchor, parts
+
+    def multiline_text(
+        self,
+        xy: tuple[float, float],
+        text: AnyStr,
+        fill: _Ink | None = None,
+        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,
+        stroke_fill: _Ink | None = None,
+        embedded_color: bool = False,
+        *,
+        font_size: float | None = None,
+    ) -> None:
+        font, anchor, lines = self._prepare_multiline_text(
+            xy,
+            text,
+            font,
+            anchor,
+            spacing,
+            align,
+            direction,
+            features,
+            language,
+            stroke_width,
+            embedded_color,
+            font_size,
+        )
+
+        for xy, line in lines:
             self.text(
-                (left, top),
+                xy,
                 line,
                 fill,
                 font,
@@ -792,7 +829,6 @@ def multiline_text(
                 stroke_fill=stroke_fill,
                 embedded_color=embedded_color,
             )
-            top += line_spacing
 
     def textlength(
         self,
@@ -894,69 +930,26 @@ def multiline_textbbox(
         *,
         font_size: float | None = None,
     ) -> tuple[float, float, float, float]:
-        if direction == "ttb":
-            msg = "ttb direction is unsupported for multiline text"
-            raise ValueError(msg)
-
-        if anchor is None:
-            anchor = "la"
-        elif len(anchor) != 2:
-            msg = "anchor must be a 2 character string"
-            raise ValueError(msg)
-        elif anchor[1] in "tb":
-            msg = "anchor not supported for multiline text"
-            raise ValueError(msg)
-
-        if font is None:
-            font = self._getfont(font_size)
-
-        widths = []
-        max_width: float = 0
-        lines = self._multiline_split(text)
-        line_spacing = self._multiline_spacing(font, spacing, stroke_width)
-        for line in lines:
-            line_width = self.textlength(
-                line,
-                font,
-                direction=direction,
-                features=features,
-                language=language,
-                embedded_color=embedded_color,
-            )
-            widths.append(line_width)
-            max_width = max(max_width, line_width)
-
-        top = xy[1]
-        if anchor[1] == "m":
-            top -= (len(lines) - 1) * line_spacing / 2.0
-        elif anchor[1] == "d":
-            top -= (len(lines) - 1) * line_spacing
+        font, anchor, lines = self._prepare_multiline_text(
+            xy,
+            text,
+            font,
+            anchor,
+            spacing,
+            align,
+            direction,
+            features,
+            language,
+            stroke_width,
+            embedded_color,
+            font_size,
+        )
 
         bbox: tuple[float, float, float, float] | None = None
 
-        for idx, line in enumerate(lines):
-            left = xy[0]
-            width_difference = max_width - widths[idx]
-
-            # first align left by anchor
-            if anchor[0] == "m":
-                left -= width_difference / 2.0
-            elif anchor[0] == "r":
-                left -= width_difference
-
-            # then align by align parameter
-            if align == "left":
-                pass
-            elif align == "center":
-                left += width_difference / 2.0
-            elif align == "right":
-                left += width_difference
-            else:
-                msg = 'align must be "left", "center" or "right"'
-                raise ValueError(msg)
-
+        for xy, line in lines:
             bbox_line = self.textbbox(
-                (left, top),
+                xy,
                 line,
                 font,
                 anchor,
@@ -976,8 +969,6 @@ def multiline_textbbox(
                     max(bbox[3], bbox_line[3]),
                 )
 
-            top += line_spacing
-
         if bbox is None:
             return xy[0], xy[1], xy[0], xy[1]
         return bbox

From 10eaff8ac7548ff50cefc003b27e2ba1a46ed71b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 29 Jan 2025 20:12:45 +1100
Subject: [PATCH 1449/2374] Added "justify" align for multiline text

---
 Tests/images/multiline_text_justify.png | Bin 0 -> 3244 bytes
 Tests/test_imagefont.py                 |   3 ++-
 docs/reference/ImageDraw.rst            |  20 ++++++++++++--------
 src/PIL/ImageDraw.py                    |  24 +++++++++++++++++++++---
 4 files changed, 35 insertions(+), 12 deletions(-)
 create mode 100644 Tests/images/multiline_text_justify.png

diff --git a/Tests/images/multiline_text_justify.png b/Tests/images/multiline_text_justify.png
new file mode 100644
index 0000000000000000000000000000000000000000..32eed34cd219df9a59b7056c0ed17fa3879adea9
GIT binary patch
literal 3244
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
BV(I_@

literal 0
HcmV?d00001

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 6a0a940b987..3ccbf9b7d94 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -254,7 +254,8 @@ def test_render_multiline_text(font: ImageFont.FreeTypeFont) -> None:
 
 
 @pytest.mark.parametrize(
-    "align, ext", (("left", ""), ("center", "_center"), ("right", "_right"))
+    "align, ext",
+    (("left", ""), ("center", "_center"), ("right", "_right"), ("justify", "_justify")),
 )
 def test_render_multiline_text_align(
     font: ImageFont.FreeTypeFont, align: str, ext: str
diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 3e9aa73f8c3..602a8f3e36b 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -387,8 +387,9 @@ Methods
                     the number of pixels between lines.
     :param align: If the text is passed on to
                   :py:meth:`~PIL.ImageDraw.ImageDraw.multiline_text`,
-                  ``"left"``, ``"center"`` or ``"right"``. Determines the relative alignment of lines.
-                  Use the ``anchor`` parameter to specify the alignment to ``xy``.
+                  ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
+                  the relative alignment of lines. Use the ``anchor`` parameter to
+                  specify the alignment to ``xy``.
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -455,8 +456,9 @@ Methods
                               of Pillow, but implemented only in version 8.0.0.
 
     :param spacing: The number of pixels between lines.
-    :param align: ``"left"``, ``"center"`` or ``"right"``. Determines the relative alignment of lines.
-                  Use the ``anchor`` parameter to specify the alignment to ``xy``.
+    :param align: ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
+                  the relative alignment of lines. Use the ``anchor`` parameter to
+                  specify the alignment to ``xy``.
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -599,8 +601,9 @@ Methods
                     the number of pixels between lines.
     :param align: If the text is passed on to
                   :py:meth:`~PIL.ImageDraw.ImageDraw.multiline_textbbox`,
-                  ``"left"``, ``"center"`` or ``"right"``. Determines the relative alignment of lines.
-                  Use the ``anchor`` parameter to specify the alignment to ``xy``.
+                  ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
+                  the relative alignment of lines. Use the ``anchor`` parameter to
+                  specify the alignment to ``xy``.
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -650,8 +653,9 @@ Methods
                    vertical text. See :ref:`text-anchors` for details.
                    This parameter is ignored for non-TrueType fonts.
     :param spacing: The number of pixels between lines.
-    :param align: ``"left"``, ``"center"`` or ``"right"``. Determines the relative alignment of lines.
-                  Use the ``anchor`` parameter to specify the alignment to ``xy``.
+    :param align: ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
+                  the relative alignment of lines. Use the ``anchor`` parameter to
+                  specify the alignment to ``xy``.
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index d8b5180ded2..da709878920 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -761,17 +761,35 @@ def _prepare_multiline_text(
                 left -= width_difference
 
             # then align by align parameter
-            if align == "left":
+            if align in ("left", "justify"):
                 pass
             elif align == "center":
                 left += width_difference / 2.0
             elif align == "right":
                 left += width_difference
             else:
-                msg = 'align must be "left", "center" or "right"'
+                msg = 'align must be "left", "center", "right" or "justify"'
                 raise ValueError(msg)
 
-            parts.append(((left, top), line))
+            if align == "justify" and width_difference != 0:
+                words = line.split(" " if isinstance(text, str) else b" ")
+                word_widths = [
+                    self.textlength(
+                        word,
+                        font,
+                        direction=direction,
+                        features=features,
+                        language=language,
+                        embedded_color=embedded_color,
+                    )
+                    for word in words
+                ]
+                width_difference = max_width - sum(word_widths)
+                for i, word in enumerate(words):
+                    parts.append(((left, top), word))
+                    left += word_widths[i] + width_difference / (len(words) - 1)
+            else:
+                parts.append(((left, top), line))
 
             top += line_spacing
 

From 1e115987afbc92aef02b489ed8fea1875821d174 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 31 Jan 2025 19:09:03 +1100
Subject: [PATCH 1450/2374] Do not install libimagequant

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

diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index bb6d7dc373e..0459264829f 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -60,7 +60,6 @@ jobs:
               mingw-w64-x86_64-gcc \
               mingw-w64-x86_64-ghostscript \
               mingw-w64-x86_64-lcms2 \
-              mingw-w64-x86_64-libimagequant \
               mingw-w64-x86_64-libjpeg-turbo \
               mingw-w64-x86_64-libraqm \
               mingw-w64-x86_64-libtiff \

From 9a58456c9b6a06518f3ce653ce02ec6e25512121 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 1 Feb 2025 00:44:26 +1100
Subject: [PATCH 1451/2374] Added versionadded for justify

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 602a8f3e36b..a2e64a22a8b 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -390,6 +390,8 @@ Methods
                   ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
+                  
+                  .. versionadded:: 11.2.0 ``justify``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.

From ec72d20d23e1dc2b06792535a6db7df778a8ad94 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Feb 2025 00:47:21 +1100
Subject: [PATCH 1452/2374] Added release notes

---
 docs/reference/ImageDraw.rst | 10 ++++++++--
 docs/releasenotes/11.2.0.rst | 12 ++++++++++++
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index a2e64a22a8b..b2f1bdc9314 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -390,8 +390,8 @@ Methods
                   ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
-                  
-                  .. versionadded:: 11.2.0 ``justify``
+
+                  .. versionadded:: 11.2.0 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -461,6 +461,8 @@ Methods
     :param align: ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
+
+                  .. versionadded:: 11.2.0 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -606,6 +608,8 @@ Methods
                   ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
+
+                  .. versionadded:: 11.2.0 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -658,6 +662,8 @@ Methods
     :param align: ``"left"``, ``"center"``, ``"right"`` or ``"justify"``. Determines
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
+
+                  .. versionadded:: 11.2.0 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index df28d05af1a..7e0008e6675 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -44,6 +44,18 @@ TODO
 API Additions
 =============
 
+"justify" multiline text alignment
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In addition to "left", "center" and "right", multiline text can also be aligned using
+"justify"::
+
+    from PIL import Image, ImageDraw
+    im = Image.new("RGB", (50, 25))
+    draw = ImageDraw.Draw(im)
+    draw.multiline_text((0, 0), "Multiline\ntext 1", align="justify")
+    draw.multiline_textbbox((0, 0), "Multiline\ntext 2", align="justify")
+
 Check for MozJPEG
 ^^^^^^^^^^^^^^^^^
 

From 5bbbc462403067c42dec782c11920aeecf9206a0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Feb 2025 01:13:04 +1100
Subject: [PATCH 1453/2374] Fixed exceptions when closing AppendingTiffWriter

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

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 67f808b60a1..af4bae5dc24 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -780,15 +780,17 @@ def test_appending_tiff_writer_writelong(self) -> None:
         data = b"II\x2A\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
         b = BytesIO(data)
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
+            a.seek(-4, os.SEEK_CUR)
             a.writeLong(2**32 - 1)
-            assert b.getvalue() == data + b"\xff\xff\xff\xff"
+            assert b.getvalue() == data[:-4] + b"\xff\xff\xff\xff"
 
     def test_appending_tiff_writer_rewritelastshorttolong(self) -> None:
         data = b"II\x2A\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
         b = BytesIO(data)
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
+            a.seek(-2, os.SEEK_CUR)
             a.rewriteLastShortToLong(2**32 - 1)
-            assert b.getvalue() == data[:-2] + b"\xff\xff\xff\xff"
+            assert b.getvalue() == data[:-4] + b"\xff\xff\xff\xff"
 
     def test_saving_icc_profile(self, tmp_path: Path) -> None:
         # Tests saving TIFF with icc_profile set.

From fca48db866870dea024e4f627059b17571940349 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 1 Feb 2025 10:02:42 +1100
Subject: [PATCH 1454/2374] Added quote marks

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

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index 7e0008e6675..5929de3b168 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -44,11 +44,11 @@ TODO
 API Additions
 =============
 
-"justify" multiline text alignment
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+``"justify"`` multiline text alignment
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In addition to "left", "center" and "right", multiline text can also be aligned using
-"justify"::
+In addition to ``"left"``, ``"center"`` and ``"right"``, multiline text can also be aligned using
+``"justify"``::
 
     from PIL import Image, ImageDraw
     im = Image.new("RGB", (50, 25))

From 69c95725179c2d7cbba1104ed5c99d2e9092f43d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Feb 2025 10:54:18 +1100
Subject: [PATCH 1455/2374] Added ImageDraw link

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

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index 5929de3b168..f7e644cf32d 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -47,8 +47,8 @@ API Additions
 ``"justify"`` multiline text alignment
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-In addition to ``"left"``, ``"center"`` and ``"right"``, multiline text can also be aligned using
-``"justify"``::
+In addition to ``"left"``, ``"center"`` and ``"right"``, multiline text can also be
+aligned using ``"justify"`` in :py:mod:`~PIL.ImageDraw`::
 
     from PIL import Image, ImageDraw
     im = Image.new("RGB", (50, 25))

From 347a3865bf809918edaa4391978394dec47c80e3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Feb 2025 12:21:15 +1100
Subject: [PATCH 1456/2374] Revert "Ignore brew dependencies for libraqm on
 macOS 13"

This reverts commit dfd53564ff6a3fc7d35a5884bc0ef03939bcec0a.
---
 .github/workflows/macos-install.sh | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index 2301a3a7ef3..6aa59a4ac18 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -10,15 +10,11 @@ brew install \
     ghostscript \
     jpeg-turbo \
     libimagequant \
+    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"
 
 python3 -m pip install coverage

From ce1996d8040bd2bab17a16ceb678eed3325194eb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Feb 2025 19:32:59 +1100
Subject: [PATCH 1457/2374] Use getpixel() instead of load()

---
 Tests/test_file_gif.py       | 13 ++++++-------
 Tests/test_image.py          |  4 +---
 Tests/test_image_convert.py  |  4 +---
 Tests/test_image_quantize.py |  4 +---
 Tests/test_imageops.py       |  8 ++------
 Tests/test_numpy.py          |  4 +---
 6 files changed, 12 insertions(+), 25 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 61a9475c73d..46215db1fd4 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -86,12 +86,12 @@ def test_invalid_file() -> None:
 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
+        assert im.getpixel((0, 0)) == 128
         assert im.info["transparency"] == 255
 
         im.seek(1)
         assert im.mode == "L"
-        assert im.load()[0, 0] == 128
+        assert im.getpixel((0, 0)) == 128
 
 
 def test_l_mode_after_rgb() -> None:
@@ -311,7 +311,7 @@ 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()
-        original_color = im.convert("RGB").load()[0, 0]
+        original_color = im.convert("RGB").getpixel((0, 0))
 
         im.seek(1)
         assert im.mode == mode
@@ -319,10 +319,10 @@ def test_loading_multiple_palettes(path: str, mode: str) -> None:
             im = im.convert("RGB")
 
         # Check a color only from the old palette
-        assert im.load()[0, 0] == original_color
+        assert im.getpixel((0, 0)) == original_color
 
         # Check a color from the new palette
-        assert im.load()[24, 24] not in first_frame_colors
+        assert im.getpixel((24, 24)) not in first_frame_colors
 
 
 def test_headers_saving_for_animated_gifs(tmp_path: Path) -> None:
@@ -488,8 +488,7 @@ def test_eoferror() -> None:
 
 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"]
+        assert im.getpixel((0, 0)) == im.info["transparency"]
 
 
 def test_dispose_none() -> None:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 9a2e3c46533..e060eb06afe 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -578,9 +578,7 @@ def test_storage_neg(self) -> None:
     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
+            assert im.getpixel((0, 0)) == 5
 
     def test_linear_gradient_wrong_mode(self) -> None:
         # Arrange
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 6a925975eaa..1e66e84dfae 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -222,9 +222,7 @@ def test_l_macro_rounding(convert_mode: str) -> None:
         im.palette.getcolor((0, 1, 2))
 
         converted_im = im.convert(convert_mode)
-        px = converted_im.load()
-        assert px is not None
-        converted_color = px[0, 0]
+        converted_color = converted_im.getpixel((0, 0))
         if convert_mode == "LA":
             assert isinstance(converted_color, tuple)
             converted_color = converted_color[0]
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 7c564d96758..0ca7ad86e33 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -148,10 +148,8 @@ 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)
-    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]
+    assert converted.getpixel((0, 0)) == converted.palette.colors[color]
 
 
 def test_small_palette() -> None:
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 7262f29e64a..3621aa50fbb 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -165,14 +165,10 @@ def test_pad() -> None:
 def test_pad_round() -> None:
     im = Image.new("1", (1, 1), 1)
     new_im = ImageOps.pad(im, (4, 1))
-    px = new_im.load()
-    assert px is not None
-    assert px[2, 0] == 1
+    assert new_im.getpixel((2, 0)) == 1
 
     new_im = ImageOps.pad(im, (1, 4))
-    px = new_im.load()
-    assert px is not None
-    assert px[0, 2] == 1
+    assert new_im.getpixel((0, 2)) == 1
 
 
 @pytest.mark.parametrize("mode", ("P", "PA"))
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index 79cd14b6690..c4ad19d23eb 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -141,9 +141,7 @@ def test_save_tiff_uint16() -> None:
     a.shape = TEST_IMAGE_SIZE
     img = Image.fromarray(a)
 
-    img_px = img.load()
-    assert img_px is not None
-    assert img_px[0, 0] == pixel_value
+    assert img.getpixel((0, 0)) == pixel_value
 
 
 @pytest.mark.parametrize(

From 90d25060743dfc118816378e3f614040b13f9596 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 3 Feb 2025 17:35:25 +0000
Subject: [PATCH 1458/2374] [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.8.6 → v0.9.4](https://github.com/astral-sh/ruff-pre-commit/compare/v0.8.6...v0.9.4)
- [github.com/psf/black-pre-commit-mirror: 24.10.0 → 25.1.0](https://github.com/psf/black-pre-commit-mirror/compare/24.10.0...25.1.0)
- [github.com/PyCQA/bandit: 1.8.0 → 1.8.2](https://github.com/PyCQA/bandit/compare/1.8.0...1.8.2)
- [github.com/pre-commit/mirrors-clang-format: v19.1.6 → v19.1.7](https://github.com/pre-commit/mirrors-clang-format/compare/v19.1.6...v19.1.7)
- [github.com/python-jsonschema/check-jsonschema: 0.30.0 → 0.31.1](https://github.com/python-jsonschema/check-jsonschema/compare/0.30.0...0.31.1)
- [github.com/woodruffw/zizmor-pre-commit: v1.0.0 → v1.3.0](https://github.com/woodruffw/zizmor-pre-commit/compare/v1.0.0...v1.3.0)
- [github.com/tox-dev/tox-ini-fmt: 1.4.1 → 1.5.0](https://github.com/tox-dev/tox-ini-fmt/compare/1.4.1...1.5.0)
---
 .pre-commit-config.yaml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 20fa7d04f00..a8c8cee152c 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.8.6
+    rev: v0.9.4
     hooks:
       - id: ruff
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 24.10.0
+    rev: 25.1.0
     hooks:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.8.0
+    rev: 1.8.2
     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: v19.1.6
+    rev: v19.1.7
     hooks:
       - id: clang-format
         types: [c]
@@ -50,14 +50,14 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.30.0
+    rev: 0.31.1
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: v1.0.0
+    rev: v1.3.0
     hooks:
       - id: zizmor
 
@@ -78,7 +78,7 @@ repos:
         additional_dependencies: [trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.4.1
+    rev: 1.5.0
     hooks:
       - id: tox-ini-fmt
 

From 955d678ca201fd530027d90626f91aad07c64f0e Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 3 Feb 2025 17:35:58 +0000
Subject: [PATCH 1459/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_file_jpeg.py    |  2 +-
 Tests/test_file_libtiff.py |  2 +-
 Tests/test_file_pdf.py     |  4 ++--
 Tests/test_file_ppm.py     |  4 ++--
 Tests/test_file_tiff.py    | 10 ++++-----
 Tests/test_file_wmf.py     |  2 +-
 Tests/test_imagedraw.py    |  2 +-
 Tests/test_imagefont.py    |  6 +++---
 Tests/test_imagefontctl.py | 42 +++++++++++++++++++-------------------
 Tests/test_imagepalette.py |  2 +-
 Tests/test_imagepath.py    |  2 +-
 Tests/test_pdfparser.py    | 18 ++++++++--------
 src/PIL/ImImagePlugin.py   |  4 ++--
 src/PIL/Image.py           |  4 ++--
 src/PIL/ImtImagePlugin.py  |  2 +-
 src/PIL/JpegImagePlugin.py | 12 +++++------
 src/PIL/MpoImagePlugin.py  |  4 ++--
 src/PIL/PcxImagePlugin.py  |  2 +-
 src/PIL/PdfParser.py       | 36 ++++++++++++++++----------------
 src/PIL/PngImagePlugin.py  |  2 +-
 src/PIL/PpmImagePlugin.py  |  2 +-
 src/PIL/TiffImagePlugin.py | 16 +++++++--------
 src/PIL/_tkinter_finder.py |  3 +--
 23 files changed, 91 insertions(+), 92 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 772ecc2bc62..91bf3cf744f 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -934,7 +934,7 @@ def test_icc_after_SOF(self) -> None:
 
     def test_jpeg_magic_number(self, monkeypatch: pytest.MonkeyPatch) -> None:
         size = 4097
-        buffer = BytesIO(b"\xFF" * size)  # Many xFF bytes
+        buffer = BytesIO(b"\xff" * size)  # Many xFF bytes
         max_pos = 0
         orig_read = buffer.read
 
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 0332947106a..369c2db1be7 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -309,7 +309,7 @@ class Tc(NamedTuple):
         }
 
         def check_tags(
-            tiffinfo: TiffImagePlugin.ImageFileDirectory_v2 | dict[int, str]
+            tiffinfo: TiffImagePlugin.ImageFileDirectory_v2 | dict[int, str],
         ) -> None:
             im = hopper()
 
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index 1d5001b1a9b..815686a5249 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -264,7 +264,7 @@ def test_pdf_append(tmp_path: Path) -> None:
         # append some info
         pdf.info.Title = "abc"
         pdf.info.Author = "def"
-        pdf.info.Subject = "ghi\uABCD"
+        pdf.info.Subject = "ghi\uabcd"
         pdf.info.Keywords = "qw)e\\r(ty"
         pdf.info.Creator = "hopper()"
         pdf.start_writing()
@@ -292,7 +292,7 @@ def test_pdf_append(tmp_path: Path) -> None:
         assert pdf.info.Title == "abc"
         assert pdf.info.Producer == "PdfParser"
         assert pdf.info.Keywords == "qw)e\\r(ty"
-        assert pdf.info.Subject == "ghi\uABCD"
+        assert pdf.info.Subject == "ghi\uabcd"
         assert b"CreationDate" in pdf.info
         assert b"ModDate" in pdf.info
         check_pdf_pages_consistency(pdf)
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index ee51a5e5a6b..bb59767f020 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -49,7 +49,7 @@ def test_sanity() -> None:
         (b"P5 3 1 257 \x00\x00\x00\x80\x01\x01", "I", (0, 32640, 65535)),
         # P6 with maxval < 255
         (
-            b"P6 3 1 17 \x00\x01\x02\x08\x09\x0A\x0F\x10\x11",
+            b"P6 3 1 17 \x00\x01\x02\x08\x09\x0a\x0f\x10\x11",
             "RGB",
             (
                 (0, 15, 30),
@@ -60,7 +60,7 @@ def test_sanity() -> None:
         # P6 with maxval > 255
         (
             b"P6 3 1 257 \x00\x00\x00\x01\x00\x02"
-            b"\x00\x80\x00\x81\x00\x82\x01\x00\x01\x01\xFF\xFF",
+            b"\x00\x80\x00\x81\x00\x82\x01\x00\x01\x01\xff\xff",
             "RGB",
             (
                 (0, 1, 2),
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index af4bae5dc24..fe8f69848f7 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -746,7 +746,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
             assert reread.n_frames == 3
 
     def test_fixoffsets(self) -> None:
-        b = BytesIO(b"II\x2A\x00\x00\x00\x00\x00")
+        b = BytesIO(b"II\x2a\x00\x00\x00\x00\x00")
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
             b.seek(0)
             a.fixOffsets(1, isShort=True)
@@ -759,14 +759,14 @@ def test_fixoffsets(self) -> None:
             with pytest.raises(RuntimeError):
                 a.fixOffsets(1)
 
-        b = BytesIO(b"II\x2A\x00\x00\x00\x00\x00")
+        b = BytesIO(b"II\x2a\x00\x00\x00\x00\x00")
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
             a.offsetOfNewPage = 2**16
 
             b.seek(0)
             a.fixOffsets(1, isShort=True)
 
-        b = BytesIO(b"II\x2B\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00")
+        b = BytesIO(b"II\x2b\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00")
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
             a.offsetOfNewPage = 2**32
 
@@ -777,7 +777,7 @@ def test_fixoffsets(self) -> None:
             a.fixOffsets(1, isLong=True)
 
     def test_appending_tiff_writer_writelong(self) -> None:
-        data = b"II\x2A\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
+        data = b"II\x2a\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
         b = BytesIO(data)
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
             a.seek(-4, os.SEEK_CUR)
@@ -785,7 +785,7 @@ def test_appending_tiff_writer_writelong(self) -> None:
             assert b.getvalue() == data[:-4] + b"\xff\xff\xff\xff"
 
     def test_appending_tiff_writer_rewritelastshorttolong(self) -> None:
-        data = b"II\x2A\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
+        data = b"II\x2a\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00"
         b = BytesIO(data)
         with TiffImagePlugin.AppendingTiffWriter(b) as a:
             a.seek(-2, os.SEEK_CUR)
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 2f1f8cdbc85..bc14ed9d74c 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -71,7 +71,7 @@ def test_load_float_dpi() -> None:
 
     with open("Tests/images/drawing.emf", "rb") as fp:
         data = fp.read()
-    b = BytesIO(data[:8] + b"\x06\xFA" + data[10:])
+    b = BytesIO(data[:8] + b"\x06\xfa" + data[10:])
     with Image.open(b) as im:
         assert im.info["dpi"][0] == 2540
 
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 28d7ed7252d..d127175ebfb 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -812,7 +812,7 @@ def test_rounded_rectangle(
         tuple[int, int, int, int]
         | tuple[list[int]]
         | tuple[tuple[int, int], tuple[int, int]]
-    )
+    ),
 ) -> None:
     # Arrange
     im = Image.new("RGB", (200, 200))
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index f110cc1d05c..4b41d8336cc 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -557,7 +557,7 @@ def test_render_empty(font: ImageFont.FreeTypeFont) -> None:
 
 def test_unicode_extended(layout_engine: ImageFont.Layout) -> None:
     # issue #3777
-    text = "A\u278A\U0001F12B"
+    text = "A\u278a\U0001f12b"
     target = "Tests/images/unicode_extended.png"
 
     ttf = ImageFont.truetype(
@@ -1026,7 +1026,7 @@ def test_sbix(layout_engine: ImageFont.Layout) -> None:
         im = Image.new("RGB", (400, 400), "white")
         d = ImageDraw.Draw(im)
 
-        d.text((50, 50), "\uE901", font=font, embedded_color=True)
+        d.text((50, 50), "\ue901", font=font, embedded_color=True)
 
         assert_image_similar_tofile(im, "Tests/images/chromacheck-sbix.png", 1)
     except OSError as e:  # pragma: no cover
@@ -1043,7 +1043,7 @@ def test_sbix_mask(layout_engine: ImageFont.Layout) -> None:
         im = Image.new("RGB", (400, 400), "white")
         d = ImageDraw.Draw(im)
 
-        d.text((50, 50), "\uE901", (100, 0, 0), font=font)
+        d.text((50, 50), "\ue901", (100, 0, 0), font=font)
 
         assert_image_similar_tofile(im, "Tests/images/chromacheck-sbix_mask.png", 1)
     except OSError as e:  # pragma: no cover
diff --git a/Tests/test_imagefontctl.py b/Tests/test_imagefontctl.py
index 24c7b871a68..c85eb499cd0 100644
--- a/Tests/test_imagefontctl.py
+++ b/Tests/test_imagefontctl.py
@@ -229,7 +229,7 @@ def test_getlength(
 @pytest.mark.parametrize("direction", ("ltr", "ttb"))
 @pytest.mark.parametrize(
     "text",
-    ("i" + ("\u030C" * 15) + "i", "i" + "\u032C" * 15 + "i", "\u035Cii", "i\u0305i"),
+    ("i" + ("\u030c" * 15) + "i", "i" + "\u032c" * 15 + "i", "\u035cii", "i\u0305i"),
     ids=("caron-above", "caron-below", "double-breve", "overline"),
 )
 def test_getlength_combine(mode: str, direction: str, text: str) -> None:
@@ -272,27 +272,27 @@ def test_anchor_ttb(anchor: str) -> None:
 
 combine_tests = (
     # extends above (e.g. issue #4553)
-    ("caron", "a\u030C\u030C\u030C\u030C\u030Cb", None, None, 0.08),
-    ("caron_la", "a\u030C\u030C\u030C\u030C\u030Cb", "la", None, 0.08),
-    ("caron_lt", "a\u030C\u030C\u030C\u030C\u030Cb", "lt", None, 0.08),
-    ("caron_ls", "a\u030C\u030C\u030C\u030C\u030Cb", "ls", None, 0.08),
-    ("caron_ttb", "ca" + ("\u030C" * 15) + "b", None, "ttb", 0.3),
-    ("caron_ttb_lt", "ca" + ("\u030C" * 15) + "b", "lt", "ttb", 0.3),
+    ("caron", "a\u030c\u030c\u030c\u030c\u030cb", None, None, 0.08),
+    ("caron_la", "a\u030c\u030c\u030c\u030c\u030cb", "la", None, 0.08),
+    ("caron_lt", "a\u030c\u030c\u030c\u030c\u030cb", "lt", None, 0.08),
+    ("caron_ls", "a\u030c\u030c\u030c\u030c\u030cb", "ls", None, 0.08),
+    ("caron_ttb", "ca" + ("\u030c" * 15) + "b", None, "ttb", 0.3),
+    ("caron_ttb_lt", "ca" + ("\u030c" * 15) + "b", "lt", "ttb", 0.3),
     # extends below
-    ("caron_below", "a\u032C\u032C\u032C\u032C\u032Cb", None, None, 0.02),
-    ("caron_below_ld", "a\u032C\u032C\u032C\u032C\u032Cb", "ld", None, 0.02),
-    ("caron_below_lb", "a\u032C\u032C\u032C\u032C\u032Cb", "lb", None, 0.02),
-    ("caron_below_ls", "a\u032C\u032C\u032C\u032C\u032Cb", "ls", None, 0.02),
-    ("caron_below_ttb", "a" + ("\u032C" * 15) + "b", None, "ttb", 0.03),
-    ("caron_below_ttb_lb", "a" + ("\u032C" * 15) + "b", "lb", "ttb", 0.03),
+    ("caron_below", "a\u032c\u032c\u032c\u032c\u032cb", None, None, 0.02),
+    ("caron_below_ld", "a\u032c\u032c\u032c\u032c\u032cb", "ld", None, 0.02),
+    ("caron_below_lb", "a\u032c\u032c\u032c\u032c\u032cb", "lb", None, 0.02),
+    ("caron_below_ls", "a\u032c\u032c\u032c\u032c\u032cb", "ls", None, 0.02),
+    ("caron_below_ttb", "a" + ("\u032c" * 15) + "b", None, "ttb", 0.03),
+    ("caron_below_ttb_lb", "a" + ("\u032c" * 15) + "b", "lb", "ttb", 0.03),
     # extends to the right (e.g. issue #3745)
-    ("double_breve_below", "a\u035Ci", None, None, 0.02),
-    ("double_breve_below_ma", "a\u035Ci", "ma", None, 0.02),
-    ("double_breve_below_ra", "a\u035Ci", "ra", None, 0.02),
-    ("double_breve_below_ttb", "a\u035Cb", None, "ttb", 0.02),
-    ("double_breve_below_ttb_rt", "a\u035Cb", "rt", "ttb", 0.02),
-    ("double_breve_below_ttb_mt", "a\u035Cb", "mt", "ttb", 0.02),
-    ("double_breve_below_ttb_st", "a\u035Cb", "st", "ttb", 0.02),
+    ("double_breve_below", "a\u035ci", None, None, 0.02),
+    ("double_breve_below_ma", "a\u035ci", "ma", None, 0.02),
+    ("double_breve_below_ra", "a\u035ci", "ra", None, 0.02),
+    ("double_breve_below_ttb", "a\u035cb", None, "ttb", 0.02),
+    ("double_breve_below_ttb_rt", "a\u035cb", "rt", "ttb", 0.02),
+    ("double_breve_below_ttb_mt", "a\u035cb", "mt", "ttb", 0.02),
+    ("double_breve_below_ttb_st", "a\u035cb", "st", "ttb", 0.02),
     # extends to the left (fail=0.064)
     ("overline", "i\u0305", None, None, 0.02),
     ("overline_la", "i\u0305", "la", None, 0.02),
@@ -346,7 +346,7 @@ def test_combine_multiline(anchor: str, align: str) -> None:
 
     path = f"Tests/images/test_combine_multiline_{anchor}_{align}.png"
     f = ImageFont.truetype("Tests/fonts/NotoSans-Regular.ttf", 48)
-    text = "i\u0305\u035C\ntext"  # i with overline and double breve, and a word
+    text = "i\u0305\u035c\ntext"  # i with overline and double breve, and a word
 
     im = Image.new("RGB", (400, 400), "white")
     d = ImageDraw.Draw(im)
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 6cf0079dda7..6d0e6f36ff3 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -189,7 +189,7 @@ def test_2bit_palette(tmp_path: Path) -> None:
 
     rgb = b"\x00" * 2 + b"\x01" * 2 + b"\x02" * 2
     img = Image.frombytes("P", (6, 1), rgb)
-    img.putpalette(b"\xFF\x00\x00\x00\xFF\x00\x00\x00\xFF")  # RGB
+    img.putpalette(b"\xff\x00\x00\x00\xff\x00\x00\x00\xff")  # RGB
     img.save(outfile, format="PNG")
 
     assert_image_equal_tofile(img, outfile)
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index 76bdf1e5f6e..1b1ee6bac49 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -79,7 +79,7 @@ def test_path_constructors(
     ),
 )
 def test_invalid_path_constructors(
-    coords: tuple[str, str] | Sequence[Sequence[int]]
+    coords: tuple[str, str] | Sequence[Sequence[int]],
 ) -> None:
     # Act
     with pytest.raises(ValueError) as e:
diff --git a/Tests/test_pdfparser.py b/Tests/test_pdfparser.py
index f6b12cb2047..d85fb1212e3 100644
--- a/Tests/test_pdfparser.py
+++ b/Tests/test_pdfparser.py
@@ -20,10 +20,10 @@
 
 
 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 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"
+    assert decode_text(b"\x1b a \x1c") == "\u02d9 a \u02dd"
 
 
 def test_indirect_refs() -> None:
@@ -45,8 +45,8 @@ def test_parsing() -> None:
     assert PdfParser.get_value(b"false%", 0) == (False, 5)
     assert PdfParser.get_value(b"null<", 0) == (None, 4)
     assert PdfParser.get_value(b"%cmt\n %cmt\n 123\n", 0) == (123, 15)
-    assert PdfParser.get_value(b"<901FA3>", 0) == (b"\x90\x1F\xA3", 8)
-    assert PdfParser.get_value(b"asd < 9 0 1 f A > qwe", 3) == (b"\x90\x1F\xA0", 17)
+    assert PdfParser.get_value(b"<901FA3>", 0) == (b"\x90\x1f\xa3", 8)
+    assert PdfParser.get_value(b"asd < 9 0 1 f A > qwe", 3) == (b"\x90\x1f\xa0", 17)
     assert PdfParser.get_value(b"(asd)", 0) == (b"asd", 5)
     assert PdfParser.get_value(b"(asd(qwe)zxc)zzz(aaa)", 0) == (b"asd(qwe)zxc", 13)
     assert PdfParser.get_value(b"(Two \\\nwords.)", 0) == (b"Two words.", 14)
@@ -56,9 +56,9 @@ def test_parsing() -> None:
     assert PdfParser.get_value(b"(One\\(paren).", 0) == (b"One(paren", 12)
     assert PdfParser.get_value(b"(One\\)paren).", 0) == (b"One)paren", 12)
     assert PdfParser.get_value(b"(\\0053)", 0) == (b"\x053", 7)
-    assert PdfParser.get_value(b"(\\053)", 0) == (b"\x2B", 6)
-    assert PdfParser.get_value(b"(\\53)", 0) == (b"\x2B", 5)
-    assert PdfParser.get_value(b"(\\53a)", 0) == (b"\x2Ba", 6)
+    assert PdfParser.get_value(b"(\\053)", 0) == (b"\x2b", 6)
+    assert PdfParser.get_value(b"(\\53)", 0) == (b"\x2b", 5)
+    assert PdfParser.get_value(b"(\\53a)", 0) == (b"\x2ba", 6)
     assert PdfParser.get_value(b"(\\1111)", 0) == (b"\x491", 7)
     assert PdfParser.get_value(b" 123 (", 0) == (123, 4)
     assert round(abs(PdfParser.get_value(b" 123.4 %", 0)[0] - 123.4), 7) == 0
@@ -118,7 +118,7 @@ def test_pdf_repr() -> None:
     assert pdf_repr(None) == b"null"
     assert pdf_repr(b"a)/b\\(c") == rb"(a\)/b\\\(c)"
     assert pdf_repr([123, True, {"a": PdfName(b"b")}]) == b"[ 123 true <<\n/a /b\n>> ]"
-    assert pdf_repr(PdfBinary(b"\x90\x1F\xA0")) == b"<901FA0>"
+    assert pdf_repr(PdfBinary(b"\x90\x1f\xa0")) == b"<901FA0>"
 
 
 def test_duplicate_xref_entry() -> None:
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index b4215a0b1e5..2a26d0b29b4 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -145,7 +145,7 @@ def _open(self) -> None:
             if s == b"\r":
                 continue
 
-            if not s or s == b"\0" or s == b"\x1A":
+            if not s or s == b"\0" or s == b"\x1a":
                 break
 
             # FIXME: this may read whole file if not a text file
@@ -209,7 +209,7 @@ def _open(self) -> None:
         self._mode = self.info[MODE]
 
         # Skip forward to start of image data
-        while s and s[:1] != b"\x1A":
+        while s and s[:1] != b"\x1a":
             s = self.fp.read(1)
         if not s:
             msg = "File truncated"
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 99b1b9ab303..e723b6a2ed2 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -514,7 +514,7 @@ def __truediv__(self, other: ImagePointTransform | float) -> ImagePointTransform
 
 
 def _getscaleoffset(
-    expr: Callable[[ImagePointTransform], ImagePointTransform | float]
+    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)
@@ -3884,7 +3884,7 @@ def _get_ifd_dict(
             return self._fixup_dict(dict(info))
 
     def _get_head(self) -> bytes:
-        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/ImtImagePlugin.py b/src/PIL/ImtImagePlugin.py
index 068cd5c33db..c4eccee3423 100644
--- a/src/PIL/ImtImagePlugin.py
+++ b/src/PIL/ImtImagePlugin.py
@@ -55,7 +55,7 @@ def _open(self) -> None:
             if not s:
                 break
 
-            if s == b"\x0C":
+            if s == b"\x0c":
                 # image data begins
                 self.tile = [
                     ImageFile._Tile(
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 457690aac51..19639f634d3 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -325,7 +325,7 @@ def DQT(self: JpegImageFile, marker: int) -> None:
 
 def _accept(prefix: bytes) -> bool:
     # Magic number was taken from https://en.wikipedia.org/wiki/JPEG
-    return prefix[:3] == b"\xFF\xD8\xFF"
+    return prefix[:3] == b"\xff\xd8\xff"
 
 
 ##
@@ -342,7 +342,7 @@ def _open(self) -> None:
         if not _accept(s):
             msg = "not a JPEG file"
             raise SyntaxError(msg)
-        s = b"\xFF"
+        s = b"\xff"
 
         # Create attributes
         self.bits = self.layers = 0
@@ -417,7 +417,7 @@ def load_read(self, read_bytes: int) -> bytes:
             # Premature EOF.
             # Pretend file is finished adding EOI marker
             self._ended = True
-            return b"\xFF\xD9"
+            return b"\xff\xd9"
 
         return s
 
@@ -712,7 +712,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     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
@@ -769,7 +769,7 @@ def validate_qtables(
             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
+        extra += b"\xff\xe1" + size + b"http://ns.adobe.com/xap/1.0/\x00" + xmp
 
     icc_profile = info.get("icc_profile")
     if icc_profile:
@@ -783,7 +783,7 @@ def validate_qtables(
         for marker in markers:
             size = o16(2 + overhead_len + len(marker))
             extra += (
-                b"\xFF\xE2"
+                b"\xff\xe2"
                 + size
                 + b"ICC_PROFILE\0"
                 + o8(i)
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index 71f89a09a85..e08f80b6b3e 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -51,7 +51,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             if not offsets:
                 # APP2 marker
                 im_frame.encoderinfo["extra"] = (
-                    b"\xFF\xE2" + struct.pack(">H", 6 + 82) + b"MPF\0" + b" " * 82
+                    b"\xff\xe2" + struct.pack(">H", 6 + 82) + b"MPF\0" + b" " * 82
                 )
                 exif = im_frame.encoderinfo.get("exif")
                 if isinstance(exif, Image.Exif):
@@ -84,7 +84,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     ifd[0xB002] = mpentries
 
     fp.seek(mpf_offset)
-    fp.write(b"II\x2A\x00" + o32le(8) + ifd.tobytes(8))
+    fp.write(b"II\x2a\x00" + o32le(8) + ifd.tobytes(8))
     fp.seek(0, os.SEEK_END)
 
 
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 32436cea3af..299405ae0a5 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -188,7 +188,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         + o16(dpi[0])
         + o16(dpi[1])
         + b"\0" * 24
-        + b"\xFF" * 24
+        + b"\xff" * 24
         + b"\0"
         + o8(planes)
         + o16(stride)
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 7cb2d241bc2..41b38ebbf83 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -19,14 +19,14 @@ def encode_text(s: str) -> bytes:
 
 PDFDocEncoding = {
     0x16: "\u0017",
-    0x18: "\u02D8",
-    0x19: "\u02C7",
-    0x1A: "\u02C6",
-    0x1B: "\u02D9",
-    0x1C: "\u02DD",
-    0x1D: "\u02DB",
-    0x1E: "\u02DA",
-    0x1F: "\u02DC",
+    0x18: "\u02d8",
+    0x19: "\u02c7",
+    0x1A: "\u02c6",
+    0x1B: "\u02d9",
+    0x1C: "\u02dd",
+    0x1D: "\u02db",
+    0x1E: "\u02da",
+    0x1F: "\u02dc",
     0x80: "\u2022",
     0x81: "\u2020",
     0x82: "\u2021",
@@ -36,29 +36,29 @@ def encode_text(s: str) -> bytes:
     0x86: "\u0192",
     0x87: "\u2044",
     0x88: "\u2039",
-    0x89: "\u203A",
+    0x89: "\u203a",
     0x8A: "\u2212",
     0x8B: "\u2030",
-    0x8C: "\u201E",
-    0x8D: "\u201C",
-    0x8E: "\u201D",
+    0x8C: "\u201e",
+    0x8D: "\u201c",
+    0x8E: "\u201d",
     0x8F: "\u2018",
     0x90: "\u2019",
-    0x91: "\u201A",
+    0x91: "\u201a",
     0x92: "\u2122",
-    0x93: "\uFB01",
-    0x94: "\uFB02",
+    0x93: "\ufb01",
+    0x94: "\ufb02",
     0x95: "\u0141",
     0x96: "\u0152",
     0x97: "\u0160",
     0x98: "\u0178",
-    0x99: "\u017D",
+    0x99: "\u017d",
     0x9A: "\u0131",
     0x9B: "\u0142",
     0x9C: "\u0153",
     0x9D: "\u0161",
-    0x9E: "\u017E",
-    0xA0: "\u20AC",
+    0x9E: "\u017e",
+    0xA0: "\u20ac",
 }
 
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index f56555160b4..5ea87686ddc 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1433,7 +1433,7 @@ def _save(
                 chunk(fp, b"tRNS", transparency[:alpha_bytes])
             else:
                 transparency = max(0, min(255, transparency))
-                alpha = b"\xFF" * transparency + b"\0"
+                alpha = b"\xff" * transparency + b"\0"
                 chunk(fp, b"tRNS", alpha[:alpha_bytes])
         elif im.mode in ("1", "L", "I", "I;16"):
             transparency = max(0, min(65535, transparency))
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 4e779df177e..fb228f572d3 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -230,7 +230,7 @@ def _decode_bitonal(self) -> bytearray:
                     msg = b"Invalid token for this mode: %s" % bytes([token])
                     raise ValueError(msg)
             data = (data + tokens)[:total_bytes]
-        invert = bytes.maketrans(b"01", b"\xFF\x00")
+        invert = bytes.maketrans(b"01", b"\xff\x00")
         return data.translate(invert)
 
     def _decode_blocks(self, maxval: int) -> bytearray:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index f49c0982296..f557d104b2b 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -275,12 +275,12 @@
 MAX_SAMPLESPERPIXEL = max(len(key_tp[4]) for key_tp in OPEN_INFO)
 
 PREFIXES = [
-    b"MM\x00\x2A",  # Valid TIFF header with big-endian byte order
-    b"II\x2A\x00",  # Valid TIFF header with little-endian byte order
-    b"MM\x2A\x00",  # Invalid TIFF header, assume big-endian
-    b"II\x00\x2A",  # Invalid TIFF header, assume little-endian
-    b"MM\x00\x2B",  # BigTIFF with big-endian byte order
-    b"II\x2B\x00",  # BigTIFF with little-endian byte order
+    b"MM\x00\x2a",  # Valid TIFF header with big-endian byte order
+    b"II\x2a\x00",  # Valid TIFF header with little-endian byte order
+    b"MM\x2a\x00",  # Invalid TIFF header, assume big-endian
+    b"II\x00\x2a",  # Invalid TIFF header, assume little-endian
+    b"MM\x00\x2b",  # BigTIFF with big-endian byte order
+    b"II\x2b\x00",  # BigTIFF with little-endian byte order
 ]
 
 if not getattr(Image.core, "libtiff_support_custom_tags", True):
@@ -582,7 +582,7 @@ class ImageFileDirectory_v2(_IFDv2Base):
 
     def __init__(
         self,
-        ifh: bytes = b"II\x2A\x00\x00\x00\x00\x00",
+        ifh: bytes = b"II\x2a\x00\x00\x00\x00\x00",
         prefix: bytes | None = None,
         group: int | None = None,
     ) -> None:
@@ -2047,7 +2047,7 @@ def setup(self) -> None:
         self.offsetOfNewPage = 0
 
         self.IIMM = iimm = self.f.read(4)
-        self._bigtiff = b"\x2B" in iimm
+        self._bigtiff = b"\x2b" in iimm
         if not iimm:
             # empty file - first page
             self.isFirst = True
diff --git a/src/PIL/_tkinter_finder.py b/src/PIL/_tkinter_finder.py
index beddfb0628a..9c0143003a7 100644
--- a/src/PIL/_tkinter_finder.py
+++ b/src/PIL/_tkinter_finder.py
@@ -1,5 +1,4 @@
-""" Find compiled module linking to Tcl / Tk libraries
-"""
+"""Find compiled module linking to Tcl / Tk libraries"""
 
 from __future__ import annotations
 

From 00790e925dc007a67eb166c69ec87e48678e28b1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 4 Feb 2025 06:49:46 +1100
Subject: [PATCH 1460/2374] Updated comment

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

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 91bf3cf744f..a2481c336d0 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -934,7 +934,7 @@ def test_icc_after_SOF(self) -> None:
 
     def test_jpeg_magic_number(self, monkeypatch: pytest.MonkeyPatch) -> None:
         size = 4097
-        buffer = BytesIO(b"\xff" * size)  # Many xFF bytes
+        buffer = BytesIO(b"\xff" * size)  # Many xff bytes
         max_pos = 0
         orig_read = buffer.read
 

From a7d7a1080ed2e507613201a9f837b40227247ff7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Feb 2025 18:42:35 +1100
Subject: [PATCH 1461/2374] Removed redundant argument parsing

---
 src/_imaging.c | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 2fd2deffbe6..9ce4b34aa3d 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1013,10 +1013,6 @@ _convert_transparent(ImagingObject *self, PyObject *args) {
 
 static PyObject *
 _copy(ImagingObject *self, PyObject *args) {
-    if (!PyArg_ParseTuple(args, "")) {
-        return NULL;
-    }
-
     return PyImagingNew(ImagingCopy(self->image));
 }
 

From b19506a4993b9003809c711b50fd0e82cba1bbd9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Feb 2025 19:12:50 +1100
Subject: [PATCH 1462/2374] Simplify Python code by passing tuples to C

---
 Tests/test_color_lut.py    | 20 +++++++++-----------
 src/PIL/ImageFilter.py     |  4 +---
 src/PIL/ImageFont.py       |  3 +--
 src/PIL/JpegImagePlugin.py |  3 +--
 src/PIL/WebPImagePlugin.py |  3 +--
 src/PIL/_imagingft.pyi     |  3 +--
 src/_imaging.c             |  2 +-
 src/_imagingft.c           |  2 +-
 src/_webp.c                |  2 +-
 src/encode.c               |  2 +-
 10 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/Tests/test_color_lut.py b/Tests/test_color_lut.py
index baa899df5df..26945ae1a69 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -19,7 +19,7 @@
 class TestColorLut3DCoreAPI:
     def generate_identity_table(
         self, channels: int, size: int | tuple[int, int, int]
-    ) -> tuple[int, int, int, int, list[float]]:
+    ) -> tuple[int, tuple[int, int, int], list[float]]:
         if isinstance(size, tuple):
             size_1d, size_2d, size_3d = size
         else:
@@ -39,9 +39,7 @@ def generate_identity_table(
         ]
         return (
             channels,
-            size_1d,
-            size_2d,
-            size_3d,
+            (size_1d, size_2d, size_3d),
             [item for sublist in table for item in sublist],
         )
 
@@ -89,21 +87,21 @@ def test_wrong_args(self) -> None:
 
         with pytest.raises(ValueError, match=r"size1D \* size2D \* size3D"):
             im.im.color_lut_3d(
-                "RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, [0, 0, 0] * 7
+                "RGB", Image.Resampling.BILINEAR, 3, (2, 2, 2), [0, 0, 0] * 7
             )
 
         with pytest.raises(ValueError, match=r"size1D \* size2D \* size3D"):
             im.im.color_lut_3d(
-                "RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, [0, 0, 0] * 9
+                "RGB", Image.Resampling.BILINEAR, 3, (2, 2, 2), [0, 0, 0] * 9
             )
 
         with pytest.raises(TypeError):
             im.im.color_lut_3d(
-                "RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, [0, 0, "0"] * 8
+                "RGB", Image.Resampling.BILINEAR, 3, (2, 2, 2), [0, 0, "0"] * 8
             )
 
         with pytest.raises(TypeError):
-            im.im.color_lut_3d("RGB", Image.Resampling.BILINEAR, 3, 2, 2, 2, 16)
+            im.im.color_lut_3d("RGB", Image.Resampling.BILINEAR, 3, (2, 2, 2), 16)
 
     @pytest.mark.parametrize(
         "lut_mode, table_channels, table_size",
@@ -264,7 +262,7 @@ def test_channels_order(self) -> None:
         assert_image_equal(
             Image.merge('RGB', im.split()[::-1]),
             im._new(im.im.color_lut_3d('RGB', Image.Resampling.BILINEAR,
-                    3, 2, 2, 2, [
+                    3, (2, 2, 2), [
                         0, 0, 0,  0, 0, 1,
                         0, 1, 0,  0, 1, 1,
 
@@ -286,7 +284,7 @@ def test_overflow(self) -> None:
 
         # fmt: off
         transformed = im._new(im.im.color_lut_3d('RGB', Image.Resampling.BILINEAR,
-                              3, 2, 2, 2,
+                              3, (2, 2, 2),
                               [
                                   -1, -1, -1,   2, -1, -1,
                                   -1,  2, -1,   2,  2, -1,
@@ -307,7 +305,7 @@ def test_overflow(self) -> None:
 
         # fmt: off
         transformed = im._new(im.im.color_lut_3d('RGB', Image.Resampling.BILINEAR,
-                              3, 2, 2, 2,
+                              3, (2, 2, 2),
                               [
                                   -3, -3, -3,   5, -3, -3,
                                   -3,  5, -3,   5,  5, -3,
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index b350e56f4f8..1c8b29b1146 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -598,8 +598,6 @@ def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
             self.mode or image.mode,
             Image.Resampling.BILINEAR,
             self.channels,
-            self.size[0],
-            self.size[1],
-            self.size[2],
+            self.size,
             self.table,
         )
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index a4986aa8c40..c8f05fbb7fe 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -647,8 +647,7 @@ def fill(width: int, height: int) -> Image.core.ImagingCore:
             kwargs.get("stroke_filled", False),
             anchor,
             ink,
-            start[0],
-            start[1],
+            start,
         )
 
     def font_variant(
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 19639f634d3..a1c9c443ad5 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -816,8 +816,7 @@ def validate_qtables(
         optimize,
         info.get("keep_rgb", False),
         info.get("streamtype", 0),
-        dpi[0],
-        dpi[1],
+        dpi,
         subsampling,
         info.get("restart_marker_blocks", 0),
         info.get("restart_marker_rows", 0),
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index c7f855527f0..066fe551f24 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -223,8 +223,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     # Setup the WebP animation encoder
     enc = _webp.WebPAnimEncoder(
-        im.size[0],
-        im.size[1],
+        im.size,
         background,
         loop,
         minimize_size,
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index 81329474730..1cb1429d6cf 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -31,8 +31,7 @@ class Font:
         stroke_filled: bool,
         anchor: str | None,
         foreground_ink_long: int,
-        x_start: float,
-        y_start: float,
+        start: tuple[float, float],
         /,
     ) -> tuple[_imaging.ImagingCore, tuple[int, int]]: ...
     def getsize(
diff --git a/src/_imaging.c b/src/_imaging.c
index 2fd2deffbe6..975c700dc75 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -866,7 +866,7 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "siiiiiO:color_lut_3d",
+            "sii(iii)O:color_lut_3d",
             &mode,
             &filter,
             &table_channels,
diff --git a/src/_imagingft.c b/src/_imagingft.c
index c202a805921..2aa425e32f5 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -854,7 +854,7 @@ font_render(FontObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "OO|zzOzfpzLffO:render",
+            "OO|zzOzfpzL(ff)O:render",
             &string,
             &fill,
             &mode,
diff --git a/src/_webp.c b/src/_webp.c
index dfda7048de4..308f031e00c 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -164,7 +164,7 @@ _anim_encoder_new(PyObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "iiIiiiiii",
+            "(ii)Iiiiiii",
             &width,
             &height,
             &bgcolor,
diff --git a/src/encode.c b/src/encode.c
index 0bf5e63c585..74dd4a3fd74 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -1097,7 +1097,7 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "ss|nnnnpnnnnnnOz#y#y#",
+            "ss|nnnnpn(nn)nnnOz#y#y#",
             &mode,
             &rawmode,
             &quality,

From a37702dd8a02aff7a16d8d0a4d3b94279737be34 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Feb 2025 18:36:14 +1100
Subject: [PATCH 1463/2374] Removed unused format character

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

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 2aa425e32f5..a668ac41178 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -854,7 +854,7 @@ font_render(FontObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "OO|zzOzfpzL(ff)O:render",
+            "OO|zzOzfpzL(ff):render",
             &string,
             &fill,
             &mode,

From 7924b6a11f37902c8a1a080741384bf79fbd8905 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Feb 2025 20:20:57 +1100
Subject: [PATCH 1464/2374] Use member names to initialize modules

---
 src/_imaging.c      | 7 +++----
 src/_imagingcms.c   | 7 +++----
 src/_imagingft.c    | 7 +++----
 src/_imagingmath.c  | 7 +++----
 src/_imagingmorph.c | 8 ++++----
 src/_imagingtk.c    | 7 +++----
 src/_webp.c         | 7 +++----
 7 files changed, 22 insertions(+), 28 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 2fd2deffbe6..cd9bde273c7 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4439,10 +4439,9 @@ PyInit__imaging(void) {
 
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
-        "_imaging", /* m_name */
-        NULL,       /* m_doc */
-        -1,         /* m_size */
-        functions,  /* m_methods */
+        .m_name = "_imaging",
+        .m_size = -1,
+        .m_methods = functions,
     };
 
     m = PyModule_Create(&module_def);
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 14cf2acd22d..6037e8bc480 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1520,10 +1520,9 @@ PyInit__imagingcms(void) {
 
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
-        "_imagingcms",    /* m_name */
-        NULL,             /* m_doc */
-        -1,               /* m_size */
-        pyCMSdll_methods, /* m_methods */
+        .m_name = "_imagingcms",
+        .m_size = -1,
+        .m_methods = pyCMSdll_methods,
     };
 
     m = PyModule_Create(&module_def);
diff --git a/src/_imagingft.c b/src/_imagingft.c
index c202a805921..ab3bc8dba5e 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1630,10 +1630,9 @@ PyInit__imagingft(void) {
 
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
-        "_imagingft", /* m_name */
-        NULL,         /* m_doc */
-        -1,           /* m_size */
-        _functions,   /* m_methods */
+        .m_name = "_imagingft",
+        .m_size = -1,
+        .m_methods = _functions,
     };
 
     m = PyModule_Create(&module_def);
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index 75b3716b5c1..4b9bf08ba00 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -308,10 +308,9 @@ PyInit__imagingmath(void) {
 
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
-        "_imagingmath", /* m_name */
-        NULL,           /* m_doc */
-        -1,             /* m_size */
-        _functions,     /* m_methods */
+        .m_name = "_imagingmath",
+        .m_size = -1,
+        .m_methods = _functions,
     };
 
     m = PyModule_Create(&module_def);
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index b763e3a6f7e..a2088829424 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -252,10 +252,10 @@ PyInit__imagingmorph(void) {
 
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
-        "_imagingmorph",                       /* m_name */
-        "A module for doing image morphology", /* m_doc */
-        -1,                                    /* m_size */
-        functions,                             /* m_methods */
+        .m_name = "_imagingmorph",
+        .m_doc = "A module for doing image morphology",
+        .m_size = -1,
+        .m_methods = functions,
     };
 
     m = PyModule_Create(&module_def);
diff --git a/src/_imagingtk.c b/src/_imagingtk.c
index c4448265114..4e06fe9b848 100644
--- a/src/_imagingtk.c
+++ b/src/_imagingtk.c
@@ -50,10 +50,9 @@ PyMODINIT_FUNC
 PyInit__imagingtk(void) {
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
-        "_imagingtk", /* m_name */
-        NULL,         /* m_doc */
-        -1,           /* m_size */
-        functions,    /* m_methods */
+        .m_name = "_imagingtk",
+        .m_size = -1,
+        .m_methods = functions,
     };
     PyObject *m;
     m = PyModule_Create(&module_def);
diff --git a/src/_webp.c b/src/_webp.c
index dfda7048de4..ded9f8ca2b6 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -835,10 +835,9 @@ PyInit__webp(void) {
 
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
-        "_webp",     /* m_name */
-        NULL,        /* m_doc */
-        -1,          /* m_size */
-        webpMethods, /* m_methods */
+        .m_name = "_webp",
+        .m_size = -1,
+        .m_methods = webpMethods,
     };
 
     m = PyModule_Create(&module_def);

From 41861e8e9ffb968945ff6acba422d31f0d69220b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 6 Feb 2025 19:26:49 +1100
Subject: [PATCH 1465/2374] Updated AffineTransform docstring to mention it
 uses the inverse matrix

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

diff --git a/src/PIL/ImageTransform.py b/src/PIL/ImageTransform.py
index a3d8f441a9f..fb144ff38a1 100644
--- a/src/PIL/ImageTransform.py
+++ b/src/PIL/ImageTransform.py
@@ -48,9 +48,9 @@ class AffineTransform(Transform):
     Define an affine image transform.
 
     This function takes a 6-tuple (a, b, c, d, e, f) which contain the first
-    two rows from an affine transform matrix. For each pixel (x, y) in the
-    output image, the new value is taken from a position (a x + b y + c,
-    d x + e y + f) in the input image, rounded to nearest pixel.
+    two rows from the inverse of an affine transform matrix. For each pixel
+    (x, y) in the output image, the new value is taken from a position (a x +
+    b y + c, d x + e y + f) in the input image, rounded to nearest pixel.
 
     This function can be used to scale, translate, rotate, and shear the
     original image.
@@ -58,7 +58,7 @@ class AffineTransform(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.
+        from the inverse of an affine transform matrix.
     """
 
     method = Image.Transform.AFFINE

From f056c259a7080a337b2ee09fee343dad1d3e48ab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 4 Feb 2025 21:07:05 +1100
Subject: [PATCH 1466/2374] Support ttb multiline text

---
 Tests/images/test_combine_multiline_ttb.png | Bin 0 -> 4042 bytes
 Tests/test_imagefontctl.py                  |  29 +++--
 src/PIL/ImageDraw.py                        | 130 ++++++++++----------
 3 files changed, 88 insertions(+), 71 deletions(-)
 create mode 100644 Tests/images/test_combine_multiline_ttb.png

diff --git a/Tests/images/test_combine_multiline_ttb.png b/Tests/images/test_combine_multiline_ttb.png
new file mode 100644
index 0000000000000000000000000000000000000000..d9c4aa2a1ae7e9c150c6ba0a53a78ccaacf6a865
GIT binary patch
literal 4042
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
L&L>I7y_5e5ZOkoU

literal 0
HcmV?d00001

diff --git a/Tests/test_imagefontctl.py b/Tests/test_imagefontctl.py
index c85eb499cd0..5954de87429 100644
--- a/Tests/test_imagefontctl.py
+++ b/Tests/test_imagefontctl.py
@@ -4,7 +4,11 @@
 
 from PIL import Image, ImageDraw, ImageFont
 
-from .helper import assert_image_similar_tofile, skip_unless_feature
+from .helper import (
+    assert_image_equal_tofile,
+    assert_image_similar_tofile,
+    skip_unless_feature,
+)
 
 FONT_SIZE = 20
 FONT_PATH = "Tests/fonts/DejaVuSans/DejaVuSans.ttf"
@@ -354,11 +358,27 @@ def test_combine_multiline(anchor: str, align: str) -> None:
     d.line(((200, 0), (200, 400)), "gray")
     bbox = d.multiline_textbbox((200, 200), text, anchor=anchor, font=f, align=align)
     d.rectangle(bbox, outline="red")
-    d.multiline_text((200, 200), text, fill="black", anchor=anchor, font=f, align=align)
+    d.multiline_text((200, 200), text, "black", anchor=anchor, font=f, align=align)
 
     assert_image_similar_tofile(im, path, 0.015)
 
 
+def test_combine_multiline_ttb() -> None:
+    path = "Tests/images/test_combine_multiline_ttb.png"
+    f = ImageFont.truetype("Tests/fonts/NotoSans-Regular.ttf", 48)
+    text = "te\nxt"
+
+    im = Image.new("RGB", (400, 400), "white")
+    d = ImageDraw.Draw(im)
+    d.line(((0, 200), (400, 200)), "gray")
+    d.line(((200, 0), (200, 400)), "gray")
+    bbox = d.multiline_textbbox((200, 200), text, f, direction="ttb")
+    d.rectangle(bbox, outline="red")
+    d.multiline_text((200, 200), text, "black", f, direction="ttb")
+
+    assert_image_equal_tofile(im, path)
+
+
 def test_anchor_invalid_ttb() -> None:
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
     im = Image.new("RGB", (100, 100), "white")
@@ -378,8 +398,3 @@ def test_anchor_invalid_ttb() -> None:
             d.multiline_text((0, 0), "foo\nbar", anchor=anchor, direction="ttb")
         with pytest.raises(ValueError):
             d.multiline_textbbox((0, 0), "foo\nbar", anchor=anchor, direction="ttb")
-    # ttb multiline text does not support anchors at all
-    with pytest.raises(ValueError):
-        d.multiline_text((0, 0), "foo\nbar", anchor="mm", direction="ttb")
-    with pytest.raises(ValueError):
-        d.multiline_textbbox((0, 0), "foo\nbar", anchor="mm", direction="ttb")
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 742b5f58703..2cb9860b732 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -708,24 +708,18 @@ def _prepare_multiline_text(
         str,
         list[tuple[tuple[float, float], AnyStr]],
     ]:
-        if direction == "ttb":
-            msg = "ttb direction is unsupported for multiline text"
-            raise ValueError(msg)
-
         if anchor is None:
-            anchor = "la"
+            anchor = "lt" if direction == "ttb" else "la"
         elif len(anchor) != 2:
             msg = "anchor must be a 2 character string"
             raise ValueError(msg)
-        elif anchor[1] in "tb":
+        elif anchor[1] in "tb" and direction != "ttb":
             msg = "anchor not supported for multiline text"
             raise ValueError(msg)
 
         if font is None:
             font = self._getfont(font_size)
 
-        widths = []
-        max_width: float = 0
         lines = text.split("\n" if isinstance(text, str) else b"\n")
         line_spacing = (
             self.textbbox((0, 0), "A", font, stroke_width=stroke_width)[3]
@@ -733,67 +727,75 @@ def _prepare_multiline_text(
             + spacing
         )
 
-        for line in lines:
-            line_width = self.textlength(
-                line,
-                font,
-                direction=direction,
-                features=features,
-                language=language,
-                embedded_color=embedded_color,
-            )
-            widths.append(line_width)
-            max_width = max(max_width, line_width)
-
         top = xy[1]
-        if anchor[1] == "m":
-            top -= (len(lines) - 1) * line_spacing / 2.0
-        elif anchor[1] == "d":
-            top -= (len(lines) - 1) * line_spacing
-
         parts = []
-        for idx, line in enumerate(lines):
+        if direction == "ttb":
             left = xy[0]
-            width_difference = max_width - widths[idx]
-
-            # first align left by anchor
-            if anchor[0] == "m":
-                left -= width_difference / 2.0
-            elif anchor[0] == "r":
-                left -= width_difference
-
-            # then align by align parameter
-            if align in ("left", "justify"):
-                pass
-            elif align == "center":
-                left += width_difference / 2.0
-            elif align == "right":
-                left += width_difference
-            else:
-                msg = 'align must be "left", "center", "right" or "justify"'
-                raise ValueError(msg)
-
-            if align == "justify" and width_difference != 0:
-                words = line.split(" " if isinstance(text, str) else b" ")
-                word_widths = [
-                    self.textlength(
-                        word,
-                        font,
-                        direction=direction,
-                        features=features,
-                        language=language,
-                        embedded_color=embedded_color,
-                    )
-                    for word in words
-                ]
-                width_difference = max_width - sum(word_widths)
-                for i, word in enumerate(words):
-                    parts.append(((left, top), word))
-                    left += word_widths[i] + width_difference / (len(words) - 1)
-            else:
+            for line in lines:
                 parts.append(((left, top), line))
+                left += line_spacing
+        else:
+            widths = []
+            max_width: float = 0
+            for line in lines:
+                line_width = self.textlength(
+                    line,
+                    font,
+                    direction=direction,
+                    features=features,
+                    language=language,
+                    embedded_color=embedded_color,
+                )
+                widths.append(line_width)
+                max_width = max(max_width, line_width)
+
+            if anchor[1] == "m":
+                top -= (len(lines) - 1) * line_spacing / 2.0
+            elif anchor[1] == "d":
+                top -= (len(lines) - 1) * line_spacing
+
+            for idx, line in enumerate(lines):
+                left = xy[0]
+                width_difference = max_width - widths[idx]
+
+                # first align left by anchor
+                if anchor[0] == "m":
+                    left -= width_difference / 2.0
+                elif anchor[0] == "r":
+                    left -= width_difference
+
+                # then align by align parameter
+                if align in ("left", "justify"):
+                    pass
+                elif align == "center":
+                    left += width_difference / 2.0
+                elif align == "right":
+                    left += width_difference
+                else:
+                    msg = 'align must be "left", "center", "right" or "justify"'
+                    raise ValueError(msg)
+
+                if align == "justify" and width_difference != 0:
+                    words = line.split(" " if isinstance(text, str) else b" ")
+                    word_widths = [
+                        self.textlength(
+                            word,
+                            font,
+                            direction=direction,
+                            features=features,
+                            language=language,
+                            embedded_color=embedded_color,
+                        )
+                        for word in words
+                    ]
+                    width_difference = max_width - sum(word_widths)
+                    for i, word in enumerate(words):
+                        parts.append(((left, top), word))
+                        left += word_widths[i] + width_difference / (len(words) - 1)
+                else:
+                    parts.append(((left, top), line))
 
-            top += line_spacing
+                top += line_spacing
 
         return font, anchor, parts
 

From 1b0095fad45db67c723215e1f9235f839b2637d9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Feb 2025 17:23:41 +1100
Subject: [PATCH 1467/2374] Pass CFLAGS to build_simple directly

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index dffb360856a..1dd8d5660b7 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -54,13 +54,10 @@ BROTLI_VERSION=1.1.0
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
     # This essentially duplicates the Homebrew recipe
-    ORIGINAL_CFLAGS=$CFLAGS
-    CFLAGS="$CFLAGS -Wno-int-conversion"
-    build_simple pkg-config 0.29.2 https://pkg-config.freedesktop.org/releases tar.gz \
+    CFLAGS="$CFLAGS -Wno-int-conversion" build_simple pkg-config 0.29.2 https://pkg-config.freedesktop.org/releases tar.gz \
         --disable-debug --disable-host-tool --with-internal-glib \
         --with-pc-path=$BUILD_PREFIX/share/pkgconfig:$BUILD_PREFIX/lib/pkgconfig \
         --with-system-include-path=$(xcrun --show-sdk-path --sdk macosx)/usr/include
-    CFLAGS=$ORIGINAL_CFLAGS
     export PKG_CONFIG=$BUILD_PREFIX/bin/pkg-config
     touch pkg-config-stamp
 }
@@ -130,15 +127,13 @@ function build {
     build_lcms2
     build_openjpeg
 
-    ORIGINAL_CFLAGS=$CFLAGS
-    CFLAGS="$CFLAGS -O3 -DNDEBUG"
+    webp_cflags="-O3 -DNDEBUG"
     if [[ -n "$IS_MACOS" ]]; then
-        CFLAGS="$CFLAGS -Wl,-headerpad_max_install_names"
+        webp_cflags="$webp_cflags -Wl,-headerpad_max_install_names"
     fi
-    build_simple libwebp $LIBWEBP_VERSION \
+    CFLAGS="$CFLAGS $webp_cflags" build_simple libwebp $LIBWEBP_VERSION \
         https://storage.googleapis.com/downloads.webmproject.org/releases/webp tar.gz \
         --enable-libwebpmux --enable-libwebpdemux
-    CFLAGS=$ORIGINAL_CFLAGS
 
     build_brotli
 

From 166d0b94d938c97ba06f2718a8772d1f8d88ac60 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Feb 2025 21:00:54 +1100
Subject: [PATCH 1468/2374] Use boolean format argument for irreversible

---
 src/encode.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/encode.c b/src/encode.c
index 74dd4a3fd74..2a9fd3805a7 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -1253,7 +1253,7 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
     PyObject *quality_layers = NULL;
     Py_ssize_t num_resolutions = 0;
     PyObject *cblk_size = NULL, *precinct_size = NULL;
-    PyObject *irreversible = NULL;
+    int irreversible = 0;
     char *progression = "LRCP";
     OPJ_PROG_ORDER prog_order;
     char *cinema_mode = "no";
@@ -1267,7 +1267,7 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
 
     if (!PyArg_ParseTuple(
             args,
-            "ss|OOOsOnOOOssbbnz#p",
+            "ss|OOOsOnOOpssbbnz#p",
             &mode,
             &format,
             &offset,
@@ -1402,7 +1402,7 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
         precinct_size, &context->precinct_width, &context->precinct_height
     );
 
-    context->irreversible = PyObject_IsTrue(irreversible);
+    context->irreversible = irreversible;
     context->progression = prog_order;
     context->cinema_mode = cine_mode;
     context->mct = mct;

From b59dea60a6a7c83545f83f9e1f723c1a40f3f7cb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Feb 2025 21:07:25 +1100
Subject: [PATCH 1469/2374] Simplify Python code by receiving tuple from C

---
 src/PIL/WebPImagePlugin.py | 3 +--
 src/_webp.c                | 2 +-
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 066fe551f24..cbbc24af008 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -46,8 +46,7 @@ def _open(self) -> None:
         self._decoder = _webp.WebPAnimDecoder(self.fp.read())
 
         # Get info from decoder
-        width, height, loop_count, bgcolor, frame_count, mode = self._decoder.get_info()
-        self._size = width, height
+        self._size, loop_count, bgcolor, frame_count, mode = self._decoder.get_info()
         self.info["loop"] = loop_count
         bg_a, bg_r, bg_g, bg_b = (
             (bgcolor >> 24) & 0xFF,
diff --git a/src/_webp.c b/src/_webp.c
index 26a5ebbc685..48b1c0a7419 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -449,7 +449,7 @@ _anim_decoder_get_info(PyObject *self) {
     WebPAnimInfo *info = &(decp->info);
 
     return Py_BuildValue(
-        "IIIIIs",
+        "(II)IIIs",
         info->canvas_width,
         info->canvas_height,
         info->loop_count,

From bfa2d64e0e41285d7cbc1016eb98b56b51255575 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 9 Feb 2025 16:02:50 +1100
Subject: [PATCH 1470/2374] Use member names to initialize PyTypeObjects

---
 src/_imaging.c    | 125 ++++++++--------------------------------------
 src/_imagingcms.c |  71 ++++----------------------
 src/_imagingft.c  |  36 +++----------
 src/_webp.c       |  70 ++++----------------------
 src/decode.c      |  36 +++----------
 src/display.c     |  36 +++----------
 src/encode.c      |  36 +++----------
 src/outline.c     |  35 ++-----------
 src/path.c        |  38 +++-----------
 9 files changed, 79 insertions(+), 404 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index ee373e96452..6482bcc5e96 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3769,102 +3769,29 @@ static PySequenceMethods image_as_sequence = {
 /* type description */
 
 static PyTypeObject Imaging_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "ImagingCore", /*tp_name*/
-    sizeof(ImagingObject),                        /*tp_basicsize*/
-    0,                                            /*tp_itemsize*/
-    /* methods */
-    (destructor)_dealloc, /*tp_dealloc*/
-    0,                    /*tp_vectorcall_offset*/
-    0,                    /*tp_getattr*/
-    0,                    /*tp_setattr*/
-    0,                    /*tp_as_async*/
-    0,                    /*tp_repr*/
-    0,                    /*tp_as_number*/
-    &image_as_sequence,   /*tp_as_sequence*/
-    0,                    /*tp_as_mapping*/
-    0,                    /*tp_hash*/
-    0,                    /*tp_call*/
-    0,                    /*tp_str*/
-    0,                    /*tp_getattro*/
-    0,                    /*tp_setattro*/
-    0,                    /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,   /*tp_flags*/
-    0,                    /*tp_doc*/
-    0,                    /*tp_traverse*/
-    0,                    /*tp_clear*/
-    0,                    /*tp_richcompare*/
-    0,                    /*tp_weaklistoffset*/
-    0,                    /*tp_iter*/
-    0,                    /*tp_iternext*/
-    methods,              /*tp_methods*/
-    0,                    /*tp_members*/
-    getsetters,           /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingCore",
+    .tp_basicsize = sizeof(ImagingObject),
+    .tp_dealloc = (destructor)_dealloc,
+    .tp_as_sequence = &image_as_sequence,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = methods,
+    .tp_getset = getsetters,
 };
 
 static PyTypeObject ImagingFont_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "ImagingFont", /*tp_name*/
-    sizeof(ImagingFontObject),                    /*tp_basicsize*/
-    0,                                            /*tp_itemsize*/
-    /* methods */
-    (destructor)_font_dealloc, /*tp_dealloc*/
-    0,                         /*tp_vectorcall_offset*/
-    0,                         /*tp_getattr*/
-    0,                         /*tp_setattr*/
-    0,                         /*tp_as_async*/
-    0,                         /*tp_repr*/
-    0,                         /*tp_as_number*/
-    0,                         /*tp_as_sequence*/
-    0,                         /*tp_as_mapping*/
-    0,                         /*tp_hash*/
-    0,                         /*tp_call*/
-    0,                         /*tp_str*/
-    0,                         /*tp_getattro*/
-    0,                         /*tp_setattro*/
-    0,                         /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,        /*tp_flags*/
-    0,                         /*tp_doc*/
-    0,                         /*tp_traverse*/
-    0,                         /*tp_clear*/
-    0,                         /*tp_richcompare*/
-    0,                         /*tp_weaklistoffset*/
-    0,                         /*tp_iter*/
-    0,                         /*tp_iternext*/
-    _font_methods,             /*tp_methods*/
-    0,                         /*tp_members*/
-    0,                         /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingFont",
+    .tp_basicsize = sizeof(ImagingFontObject),
+    .tp_dealloc = (destructor)_font_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = _font_methods,
 };
 
 static PyTypeObject ImagingDraw_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "ImagingDraw", /*tp_name*/
-    sizeof(ImagingDrawObject),                    /*tp_basicsize*/
-    0,                                            /*tp_itemsize*/
-    /* methods */
-    (destructor)_draw_dealloc, /*tp_dealloc*/
-    0,                         /*tp_vectorcall_offset*/
-    0,                         /*tp_getattr*/
-    0,                         /*tp_setattr*/
-    0,                         /*tp_as_async*/
-    0,                         /*tp_repr*/
-    0,                         /*tp_as_number*/
-    0,                         /*tp_as_sequence*/
-    0,                         /*tp_as_mapping*/
-    0,                         /*tp_hash*/
-    0,                         /*tp_call*/
-    0,                         /*tp_str*/
-    0,                         /*tp_getattro*/
-    0,                         /*tp_setattro*/
-    0,                         /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,        /*tp_flags*/
-    0,                         /*tp_doc*/
-    0,                         /*tp_traverse*/
-    0,                         /*tp_clear*/
-    0,                         /*tp_richcompare*/
-    0,                         /*tp_weaklistoffset*/
-    0,                         /*tp_iter*/
-    0,                         /*tp_iternext*/
-    _draw_methods,             /*tp_methods*/
-    0,                         /*tp_members*/
-    0,                         /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingDraw",
+    .tp_basicsize = sizeof(ImagingDrawObject),
+    .tp_dealloc = (destructor)_draw_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = _draw_methods,
 };
 
 static PyMappingMethods pixel_access_as_mapping = {
@@ -3876,20 +3803,10 @@ static PyMappingMethods pixel_access_as_mapping = {
 /* type description */
 
 static PyTypeObject PixelAccess_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "PixelAccess", /*tp_name*/
-    sizeof(PixelAccessObject),                    /*tp_basicsize*/
-    0,                                            /*tp_itemsize*/
-    /* methods */
-    (destructor)pixel_access_dealloc, /*tp_dealloc*/
-    0,                                /*tp_vectorcall_offset*/
-    0,                                /*tp_getattr*/
-    0,                                /*tp_setattr*/
-    0,                                /*tp_as_async*/
-    0,                                /*tp_repr*/
-    0,                                /*tp_as_number*/
-    0,                                /*tp_as_sequence*/
-    &pixel_access_as_mapping,         /*tp_as_mapping*/
-    0                                 /*tp_hash*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "PixelAccess",
+    .tp_basicsize = sizeof(PixelAccessObject),
+    .tp_dealloc = (destructor)pixel_access_dealloc,
+    .tp_as_mapping = &pixel_access_as_mapping,
 };
 
 /* -------------------------------------------------------------------- */
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 6037e8bc480..e177feee9ac 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1410,36 +1410,12 @@ static struct PyGetSetDef cms_profile_getsetters[] = {
 };
 
 static PyTypeObject CmsProfile_Type = {
-    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*/
-    0,                               /*tp_getattr*/
-    0,                               /*tp_setattr*/
-    0,                               /*tp_as_async*/
-    0,                               /*tp_repr*/
-    0,                               /*tp_as_number*/
-    0,                               /*tp_as_sequence*/
-    0,                               /*tp_as_mapping*/
-    0,                               /*tp_hash*/
-    0,                               /*tp_call*/
-    0,                               /*tp_str*/
-    0,                               /*tp_getattro*/
-    0,                               /*tp_setattro*/
-    0,                               /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,              /*tp_flags*/
-    0,                               /*tp_doc*/
-    0,                               /*tp_traverse*/
-    0,                               /*tp_clear*/
-    0,                               /*tp_richcompare*/
-    0,                               /*tp_weaklistoffset*/
-    0,                               /*tp_iter*/
-    0,                               /*tp_iternext*/
-    cms_profile_methods,             /*tp_methods*/
-    0,                               /*tp_members*/
-    cms_profile_getsetters,          /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "PIL.ImageCms.core.CmsProfile",
+    .tp_basicsize = sizeof(CmsProfileObject),
+    .tp_dealloc = (destructor)cms_profile_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = cms_profile_methods,
+    .tp_getset = cms_profile_getsetters,
 };
 
 static struct PyMethodDef cms_transform_methods[] = {
@@ -1447,36 +1423,11 @@ static struct PyMethodDef cms_transform_methods[] = {
 };
 
 static PyTypeObject CmsTransform_Type = {
-    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*/
-    0,                                 /*tp_getattr*/
-    0,                                 /*tp_setattr*/
-    0,                                 /*tp_as_async*/
-    0,                                 /*tp_repr*/
-    0,                                 /*tp_as_number*/
-    0,                                 /*tp_as_sequence*/
-    0,                                 /*tp_as_mapping*/
-    0,                                 /*tp_hash*/
-    0,                                 /*tp_call*/
-    0,                                 /*tp_str*/
-    0,                                 /*tp_getattro*/
-    0,                                 /*tp_setattro*/
-    0,                                 /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,                /*tp_flags*/
-    0,                                 /*tp_doc*/
-    0,                                 /*tp_traverse*/
-    0,                                 /*tp_clear*/
-    0,                                 /*tp_richcompare*/
-    0,                                 /*tp_weaklistoffset*/
-    0,                                 /*tp_iter*/
-    0,                                 /*tp_iternext*/
-    cms_transform_methods,             /*tp_methods*/
-    0,                                 /*tp_members*/
-    0,                                 /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "PIL.ImageCms.core.CmsTransform",
+    .tp_basicsize = sizeof(CmsTransformObject),
+    .tp_dealloc = (destructor)cms_transform_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = cms_transform_methods,
 };
 
 static int
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 7d754e1686a..922c3da3223 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1518,36 +1518,12 @@ static struct PyGetSetDef font_getsetters[] = {
 };
 
 static PyTypeObject Font_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "Font", /*tp_name*/
-    sizeof(FontObject),                    /*tp_basicsize*/
-    0,                                     /*tp_itemsize*/
-    /* methods */
-    (destructor)font_dealloc, /*tp_dealloc*/
-    0,                        /*tp_vectorcall_offset*/
-    0,                        /*tp_getattr*/
-    0,                        /*tp_setattr*/
-    0,                        /*tp_as_async*/
-    0,                        /*tp_repr*/
-    0,                        /*tp_as_number*/
-    0,                        /*tp_as_sequence*/
-    0,                        /*tp_as_mapping*/
-    0,                        /*tp_hash*/
-    0,                        /*tp_call*/
-    0,                        /*tp_str*/
-    0,                        /*tp_getattro*/
-    0,                        /*tp_setattro*/
-    0,                        /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,       /*tp_flags*/
-    0,                        /*tp_doc*/
-    0,                        /*tp_traverse*/
-    0,                        /*tp_clear*/
-    0,                        /*tp_richcompare*/
-    0,                        /*tp_weaklistoffset*/
-    0,                        /*tp_iter*/
-    0,                        /*tp_iternext*/
-    font_methods,             /*tp_methods*/
-    0,                        /*tp_members*/
-    font_getsetters,          /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "Font",
+    .tp_basicsize = sizeof(FontObject),
+    .tp_dealloc = (destructor)font_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = font_methods,
+    .tp_getset = font_getsetters,
 };
 
 static PyMethodDef _functions[] = {
diff --git a/src/_webp.c b/src/_webp.c
index 26a5ebbc685..942f275daf6 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -530,36 +530,11 @@ static struct PyMethodDef _anim_encoder_methods[] = {
 
 // WebPAnimEncoder type definition
 static PyTypeObject WebPAnimEncoder_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "WebPAnimEncoder", /*tp_name */
-    sizeof(WebPAnimEncoderObject),                    /*tp_basicsize */
-    0,                                                /*tp_itemsize */
-    /* methods */
-    (destructor)_anim_encoder_dealloc, /*tp_dealloc*/
-    0,                                 /*tp_vectorcall_offset*/
-    0,                                 /*tp_getattr*/
-    0,                                 /*tp_setattr*/
-    0,                                 /*tp_as_async*/
-    0,                                 /*tp_repr*/
-    0,                                 /*tp_as_number*/
-    0,                                 /*tp_as_sequence*/
-    0,                                 /*tp_as_mapping*/
-    0,                                 /*tp_hash*/
-    0,                                 /*tp_call*/
-    0,                                 /*tp_str*/
-    0,                                 /*tp_getattro*/
-    0,                                 /*tp_setattro*/
-    0,                                 /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,                /*tp_flags*/
-    0,                                 /*tp_doc*/
-    0,                                 /*tp_traverse*/
-    0,                                 /*tp_clear*/
-    0,                                 /*tp_richcompare*/
-    0,                                 /*tp_weaklistoffset*/
-    0,                                 /*tp_iter*/
-    0,                                 /*tp_iternext*/
-    _anim_encoder_methods,             /*tp_methods*/
-    0,                                 /*tp_members*/
-    0,                                 /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "WebPAnimEncoder",
+    .tp_basicsize = sizeof(WebPAnimEncoderObject),
+    .tp_dealloc = (destructor)_anim_encoder_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = _anim_encoder_methods,
 };
 
 // WebPAnimDecoder methods
@@ -573,36 +548,11 @@ static struct PyMethodDef _anim_decoder_methods[] = {
 
 // WebPAnimDecoder type definition
 static PyTypeObject WebPAnimDecoder_Type = {
-    PyVarObject_HEAD_INIT(NULL, 0) "WebPAnimDecoder", /*tp_name */
-    sizeof(WebPAnimDecoderObject),                    /*tp_basicsize */
-    0,                                                /*tp_itemsize */
-    /* methods */
-    (destructor)_anim_decoder_dealloc, /*tp_dealloc*/
-    0,                                 /*tp_vectorcall_offset*/
-    0,                                 /*tp_getattr*/
-    0,                                 /*tp_setattr*/
-    0,                                 /*tp_as_async*/
-    0,                                 /*tp_repr*/
-    0,                                 /*tp_as_number*/
-    0,                                 /*tp_as_sequence*/
-    0,                                 /*tp_as_mapping*/
-    0,                                 /*tp_hash*/
-    0,                                 /*tp_call*/
-    0,                                 /*tp_str*/
-    0,                                 /*tp_getattro*/
-    0,                                 /*tp_setattro*/
-    0,                                 /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,                /*tp_flags*/
-    0,                                 /*tp_doc*/
-    0,                                 /*tp_traverse*/
-    0,                                 /*tp_clear*/
-    0,                                 /*tp_richcompare*/
-    0,                                 /*tp_weaklistoffset*/
-    0,                                 /*tp_iter*/
-    0,                                 /*tp_iternext*/
-    _anim_decoder_methods,             /*tp_methods*/
-    0,                                 /*tp_members*/
-    0,                                 /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "WebPAnimDecoder",
+    .tp_basicsize = sizeof(WebPAnimDecoderObject),
+    .tp_dealloc = (destructor)_anim_decoder_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = _anim_decoder_methods,
 };
 
 /* -------------------------------------------------------------------- */
diff --git a/src/decode.c b/src/decode.c
index 1f2c22491f8..26211a95fec 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -256,36 +256,12 @@ static struct PyGetSetDef getseters[] = {
 };
 
 static PyTypeObject ImagingDecoderType = {
-    PyVarObject_HEAD_INIT(NULL, 0) "ImagingDecoder", /*tp_name*/
-    sizeof(ImagingDecoderObject),                    /*tp_basicsize*/
-    0,                                               /*tp_itemsize*/
-    /* methods */
-    (destructor)_dealloc, /*tp_dealloc*/
-    0,                    /*tp_vectorcall_offset*/
-    0,                    /*tp_getattr*/
-    0,                    /*tp_setattr*/
-    0,                    /*tp_as_async*/
-    0,                    /*tp_repr*/
-    0,                    /*tp_as_number*/
-    0,                    /*tp_as_sequence*/
-    0,                    /*tp_as_mapping*/
-    0,                    /*tp_hash*/
-    0,                    /*tp_call*/
-    0,                    /*tp_str*/
-    0,                    /*tp_getattro*/
-    0,                    /*tp_setattro*/
-    0,                    /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,   /*tp_flags*/
-    0,                    /*tp_doc*/
-    0,                    /*tp_traverse*/
-    0,                    /*tp_clear*/
-    0,                    /*tp_richcompare*/
-    0,                    /*tp_weaklistoffset*/
-    0,                    /*tp_iter*/
-    0,                    /*tp_iternext*/
-    methods,              /*tp_methods*/
-    0,                    /*tp_members*/
-    getseters,            /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingDecoder",
+    .tp_basicsize = sizeof(ImagingDecoderObject),
+    .tp_dealloc = (destructor)_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = methods,
+    .tp_getset = getseters,
 };
 
 /* -------------------------------------------------------------------- */
diff --git a/src/display.c b/src/display.c
index 36ab3b237ef..004c7866bc9 100644
--- a/src/display.c
+++ b/src/display.c
@@ -248,36 +248,12 @@ static struct PyGetSetDef getsetters[] = {
 };
 
 static PyTypeObject ImagingDisplayType = {
-    PyVarObject_HEAD_INIT(NULL, 0) "ImagingDisplay", /*tp_name*/
-    sizeof(ImagingDisplayObject),                    /*tp_basicsize*/
-    0,                                               /*tp_itemsize*/
-    /* methods */
-    (destructor)_delete, /*tp_dealloc*/
-    0,                   /*tp_vectorcall_offset*/
-    0,                   /*tp_getattr*/
-    0,                   /*tp_setattr*/
-    0,                   /*tp_as_async*/
-    0,                   /*tp_repr*/
-    0,                   /*tp_as_number*/
-    0,                   /*tp_as_sequence*/
-    0,                   /*tp_as_mapping*/
-    0,                   /*tp_hash*/
-    0,                   /*tp_call*/
-    0,                   /*tp_str*/
-    0,                   /*tp_getattro*/
-    0,                   /*tp_setattro*/
-    0,                   /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,  /*tp_flags*/
-    0,                   /*tp_doc*/
-    0,                   /*tp_traverse*/
-    0,                   /*tp_clear*/
-    0,                   /*tp_richcompare*/
-    0,                   /*tp_weaklistoffset*/
-    0,                   /*tp_iter*/
-    0,                   /*tp_iternext*/
-    methods,             /*tp_methods*/
-    0,                   /*tp_members*/
-    getsetters,          /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingDisplay",
+    .tp_basicsize = sizeof(ImagingDisplayObject),
+    .tp_dealloc = (destructor)_delete,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = methods,
+    .tp_getset = getsetters,
 };
 
 PyObject *
diff --git a/src/encode.c b/src/encode.c
index 74dd4a3fd74..dd7355811f4 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -323,36 +323,12 @@ static struct PyGetSetDef getseters[] = {
 };
 
 static PyTypeObject ImagingEncoderType = {
-    PyVarObject_HEAD_INIT(NULL, 0) "ImagingEncoder", /*tp_name*/
-    sizeof(ImagingEncoderObject),                    /*tp_basicsize*/
-    0,                                               /*tp_itemsize*/
-    /* methods */
-    (destructor)_dealloc, /*tp_dealloc*/
-    0,                    /*tp_vectorcall_offset*/
-    0,                    /*tp_getattr*/
-    0,                    /*tp_setattr*/
-    0,                    /*tp_as_async*/
-    0,                    /*tp_repr*/
-    0,                    /*tp_as_number*/
-    0,                    /*tp_as_sequence*/
-    0,                    /*tp_as_mapping*/
-    0,                    /*tp_hash*/
-    0,                    /*tp_call*/
-    0,                    /*tp_str*/
-    0,                    /*tp_getattro*/
-    0,                    /*tp_setattro*/
-    0,                    /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,   /*tp_flags*/
-    0,                    /*tp_doc*/
-    0,                    /*tp_traverse*/
-    0,                    /*tp_clear*/
-    0,                    /*tp_richcompare*/
-    0,                    /*tp_weaklistoffset*/
-    0,                    /*tp_iter*/
-    0,                    /*tp_iternext*/
-    methods,              /*tp_methods*/
-    0,                    /*tp_members*/
-    getseters,            /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingEncoder",
+    .tp_basicsize = sizeof(ImagingEncoderObject),
+    .tp_dealloc = (destructor)_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = methods,
+    .tp_getset = getseters,
 };
 
 /* -------------------------------------------------------------------- */
diff --git a/src/outline.c b/src/outline.c
index 4aa6bd59e51..6eea07c5db7 100644
--- a/src/outline.c
+++ b/src/outline.c
@@ -149,34 +149,9 @@ static struct PyMethodDef _outline_methods[] = {
 };
 
 static PyTypeObject OutlineType = {
-    PyVarObject_HEAD_INIT(NULL, 0) "Outline", /*tp_name*/
-    sizeof(OutlineObject),                    /*tp_basicsize*/
-    0,                                        /*tp_itemsize*/
-    /* methods */
-    (destructor)_outline_dealloc, /*tp_dealloc*/
-    0,                            /*tp_vectorcall_offset*/
-    0,                            /*tp_getattr*/
-    0,                            /*tp_setattr*/
-    0,                            /*tp_as_async*/
-    0,                            /*tp_repr*/
-    0,                            /*tp_as_number*/
-    0,                            /*tp_as_sequence*/
-    0,                            /*tp_as_mapping*/
-    0,                            /*tp_hash*/
-    0,                            /*tp_call*/
-    0,                            /*tp_str*/
-    0,                            /*tp_getattro*/
-    0,                            /*tp_setattro*/
-    0,                            /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,           /*tp_flags*/
-    0,                            /*tp_doc*/
-    0,                            /*tp_traverse*/
-    0,                            /*tp_clear*/
-    0,                            /*tp_richcompare*/
-    0,                            /*tp_weaklistoffset*/
-    0,                            /*tp_iter*/
-    0,                            /*tp_iternext*/
-    _outline_methods,             /*tp_methods*/
-    0,                            /*tp_members*/
-    0,                            /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "Outline",
+    .tp_basicsize = sizeof(OutlineObject),
+    .tp_dealloc = (destructor)_outline_dealloc,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = _outline_methods,
 };
diff --git a/src/path.c b/src/path.c
index b508df2ac30..24820173ef7 100644
--- a/src/path.c
+++ b/src/path.c
@@ -598,34 +598,12 @@ static PyMappingMethods path_as_mapping = {
 };
 
 static PyTypeObject PyPathType = {
-    PyVarObject_HEAD_INIT(NULL, 0) "Path", /*tp_name*/
-    sizeof(PyPathObject),                  /*tp_basicsize*/
-    0,                                     /*tp_itemsize*/
-    /* methods */
-    (destructor)path_dealloc, /*tp_dealloc*/
-    0,                        /*tp_vectorcall_offset*/
-    0,                        /*tp_getattr*/
-    0,                        /*tp_setattr*/
-    0,                        /*tp_as_async*/
-    0,                        /*tp_repr*/
-    0,                        /*tp_as_number*/
-    &path_as_sequence,        /*tp_as_sequence*/
-    &path_as_mapping,         /*tp_as_mapping*/
-    0,                        /*tp_hash*/
-    0,                        /*tp_call*/
-    0,                        /*tp_str*/
-    0,                        /*tp_getattro*/
-    0,                        /*tp_setattro*/
-    0,                        /*tp_as_buffer*/
-    Py_TPFLAGS_DEFAULT,       /*tp_flags*/
-    0,                        /*tp_doc*/
-    0,                        /*tp_traverse*/
-    0,                        /*tp_clear*/
-    0,                        /*tp_richcompare*/
-    0,                        /*tp_weaklistoffset*/
-    0,                        /*tp_iter*/
-    0,                        /*tp_iternext*/
-    methods,                  /*tp_methods*/
-    0,                        /*tp_members*/
-    getsetters,               /*tp_getset*/
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "Path",
+    .tp_basicsize = sizeof(PyPathObject),
+    .tp_dealloc = (destructor)path_dealloc,
+    .tp_as_sequence = &path_as_sequence,
+    .tp_as_mapping = &path_as_mapping,
+    .tp_flags = Py_TPFLAGS_DEFAULT,
+    .tp_methods = methods,
+    .tp_getset = getsetters,
 };

From 422c0f607d04470729768c3204273894c9be9e46 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 9 Feb 2025 16:03:38 +1100
Subject: [PATCH 1471/2374] Use default tp_flags

---
 src/_imaging.c    | 3 ---
 src/_imagingcms.c | 2 --
 src/_imagingft.c  | 1 -
 src/_webp.c       | 2 --
 src/decode.c      | 1 -
 src/display.c     | 1 -
 src/encode.c      | 1 -
 src/outline.c     | 1 -
 src/path.c        | 1 -
 9 files changed, 13 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 6482bcc5e96..d5c21fd8671 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3773,7 +3773,6 @@ static PyTypeObject Imaging_Type = {
     .tp_basicsize = sizeof(ImagingObject),
     .tp_dealloc = (destructor)_dealloc,
     .tp_as_sequence = &image_as_sequence,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = methods,
     .tp_getset = getsetters,
 };
@@ -3782,7 +3781,6 @@ static PyTypeObject ImagingFont_Type = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingFont",
     .tp_basicsize = sizeof(ImagingFontObject),
     .tp_dealloc = (destructor)_font_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = _font_methods,
 };
 
@@ -3790,7 +3788,6 @@ static PyTypeObject ImagingDraw_Type = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingDraw",
     .tp_basicsize = sizeof(ImagingDrawObject),
     .tp_dealloc = (destructor)_draw_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = _draw_methods,
 };
 
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index e177feee9ac..ea2f7018634 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1413,7 +1413,6 @@ static PyTypeObject CmsProfile_Type = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "PIL.ImageCms.core.CmsProfile",
     .tp_basicsize = sizeof(CmsProfileObject),
     .tp_dealloc = (destructor)cms_profile_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = cms_profile_methods,
     .tp_getset = cms_profile_getsetters,
 };
@@ -1426,7 +1425,6 @@ static PyTypeObject CmsTransform_Type = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "PIL.ImageCms.core.CmsTransform",
     .tp_basicsize = sizeof(CmsTransformObject),
     .tp_dealloc = (destructor)cms_transform_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = cms_transform_methods,
 };
 
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 922c3da3223..62dab73e5c0 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1521,7 +1521,6 @@ static PyTypeObject Font_Type = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "Font",
     .tp_basicsize = sizeof(FontObject),
     .tp_dealloc = (destructor)font_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = font_methods,
     .tp_getset = font_getsetters,
 };
diff --git a/src/_webp.c b/src/_webp.c
index 942f275daf6..c280d9513dc 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -533,7 +533,6 @@ static PyTypeObject WebPAnimEncoder_Type = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "WebPAnimEncoder",
     .tp_basicsize = sizeof(WebPAnimEncoderObject),
     .tp_dealloc = (destructor)_anim_encoder_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = _anim_encoder_methods,
 };
 
@@ -551,7 +550,6 @@ static PyTypeObject WebPAnimDecoder_Type = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "WebPAnimDecoder",
     .tp_basicsize = sizeof(WebPAnimDecoderObject),
     .tp_dealloc = (destructor)_anim_decoder_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = _anim_decoder_methods,
 };
 
diff --git a/src/decode.c b/src/decode.c
index 26211a95fec..03db1ce3516 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -259,7 +259,6 @@ static PyTypeObject ImagingDecoderType = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingDecoder",
     .tp_basicsize = sizeof(ImagingDecoderObject),
     .tp_dealloc = (destructor)_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = methods,
     .tp_getset = getseters,
 };
diff --git a/src/display.c b/src/display.c
index 004c7866bc9..a0538750455 100644
--- a/src/display.c
+++ b/src/display.c
@@ -251,7 +251,6 @@ static PyTypeObject ImagingDisplayType = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingDisplay",
     .tp_basicsize = sizeof(ImagingDisplayObject),
     .tp_dealloc = (destructor)_delete,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = methods,
     .tp_getset = getsetters,
 };
diff --git a/src/encode.c b/src/encode.c
index dd7355811f4..f610d663877 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -326,7 +326,6 @@ static PyTypeObject ImagingEncoderType = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "ImagingEncoder",
     .tp_basicsize = sizeof(ImagingEncoderObject),
     .tp_dealloc = (destructor)_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = methods,
     .tp_getset = getseters,
 };
diff --git a/src/outline.c b/src/outline.c
index 6eea07c5db7..32ab9109c15 100644
--- a/src/outline.c
+++ b/src/outline.c
@@ -152,6 +152,5 @@ static PyTypeObject OutlineType = {
     PyVarObject_HEAD_INIT(NULL, 0).tp_name = "Outline",
     .tp_basicsize = sizeof(OutlineObject),
     .tp_dealloc = (destructor)_outline_dealloc,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = _outline_methods,
 };
diff --git a/src/path.c b/src/path.c
index 24820173ef7..5affe3a1fc5 100644
--- a/src/path.c
+++ b/src/path.c
@@ -603,7 +603,6 @@ static PyTypeObject PyPathType = {
     .tp_dealloc = (destructor)path_dealloc,
     .tp_as_sequence = &path_as_sequence,
     .tp_as_mapping = &path_as_mapping,
-    .tp_flags = Py_TPFLAGS_DEFAULT,
     .tp_methods = methods,
     .tp_getset = getsetters,
 };

From c566a81c647834d5789ab0cc7680eb51effcddec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 10 Feb 2025 21:47:37 +1100
Subject: [PATCH 1472/2374] Updated libimagequant to 4.3.4

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

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 54b5d983f6e..0ea8f0f9f44 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,6 +116,7 @@ def cmd_msbuild(
     "HARFBUZZ": "10.2.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
+    "LIBIMAGEQUANT": "4.3.4",
     "LIBPNG": "1.6.46",
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
@@ -335,24 +336,15 @@ def cmd_msbuild(
         "libs": [r"bin\*.lib"],
     },
     "libimagequant": {
-        # commit: Merge branch 'master' into msvc (matches 2.17.0 tag)
-        "url": "https://github.com/ImageOptim/libimagequant/archive/e4c1334be0eff290af5e2b4155057c2953a313ab.zip",
-        "filename": "libimagequant-e4c1334be0eff290af5e2b4155057c2953a313ab.zip",
+        "url": "https://github.com/ImageOptim/libimagequant/archive/{V['LIBIMAGEQUANT']}.tar.gz",
+        "filename": f"libimagequant-{V['LIBIMAGEQUANT']}.tar.gz",
         "license": "COPYRIGHT",
-        "patch": {
-            "CMakeLists.txt": {
-                "if(OPENMP_FOUND)": "if(false)",
-                "install": "#install",
-                # libimagequant does not detect MSVC x86_arm64 cross-compiler correctly
-                "if(${{CMAKE_SYSTEM_PROCESSOR}} STREQUAL ARM64)": "if({architecture} STREQUAL ARM64)",  # noqa: E501
-            }
-        },
         "build": [
-            *cmds_cmake("imagequant_a"),
-            cmd_copy("imagequant_a.lib", "imagequant.lib"),
+            cmd_cd("imagequant-sys"),
+            "cargo build --release",
         ],
-        "headers": [r"*.h"],
-        "libs": [r"imagequant.lib"],
+        "headers": ["libimagequant.h"],
+        "libs": [r"..\target\release\imagequant_sys.lib"],
     },
     "harfbuzz": {
         "url": f"https://github.com/harfbuzz/harfbuzz/archive/{V['HARFBUZZ']}.zip",

From 45d8d8056767988e0ea58a8676a5244d334b37b8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 11 Feb 2025 11:36:55 +1100
Subject: [PATCH 1473/2374] Updated zlib-ng to 2.2.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 dffb360856a..edf5ba937a5 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -45,7 +45,7 @@ OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.4
 TIFF_VERSION=4.6.0
 LCMS2_VERSION=2.16
-ZLIB_NG_VERSION=2.2.3
+ZLIB_NG_VERSION=2.2.4
 LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 54b5d983f6e..73e3699d75e 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",
     "XZ": "5.6.4",
-    "ZLIBNG": "2.2.3",
+    "ZLIBNG": "2.2.4",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
 

From 8020d423bc42688af8fb83b70d951dbf9daf34ad Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 12 Feb 2025 18:36:14 +1100
Subject: [PATCH 1474/2374] Use monkeypatch

---
 Tests/test_file_gif.py | 28 +++++++++++++---------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 46215db1fd4..396e09ba9d0 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1345,7 +1345,7 @@ def test_save_I(tmp_path: Path) -> None:
         assert_image_equal(reloaded.convert("L"), im.convert("L"))
 
 
-def test_getdata() -> None:
+def test_getdata(monkeypatch: pytest.MonkeyPatch) -> 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)
@@ -1354,23 +1354,21 @@ def test_getdata() -> None:
 
     passed_palette = bytes(255 - i // 3 for i in range(768))
 
-    GifImagePlugin._FORCE_OPTIMIZE = True
-    try:
-        h = GifImagePlugin.getheader(im, passed_palette)
-        d = GifImagePlugin.getdata(im)
+    monkeypatch.setattr(GifImagePlugin, "_FORCE_OPTIMIZE", True)
 
-        import pickle
+    h = GifImagePlugin.getheader(im, passed_palette)
+    d = GifImagePlugin.getdata(im)
 
-        # Enable to get target values on pre-refactor version
-        # with open('Tests/images/gif_header_data.pkl', 'wb') as f:
-        #    pickle.dump((h, d), f, 1)
-        with open("Tests/images/gif_header_data.pkl", "rb") as f:
-            (h_target, d_target) = pickle.load(f)
+    import pickle
 
-        assert h == h_target
-        assert d == d_target
-    finally:
-        GifImagePlugin._FORCE_OPTIMIZE = False
+    # Enable to get target values on pre-refactor version
+    # with open('Tests/images/gif_header_data.pkl', 'wb') as f:
+    #    pickle.dump((h, d), f, 1)
+    with open("Tests/images/gif_header_data.pkl", "rb") as f:
+        (h_target, d_target) = pickle.load(f)
+
+    assert h == h_target
+    assert d == d_target
 
 
 def test_lzw_bits() -> None:

From 8f4bfe1fe5c782329314333eac6284f32ff84b7b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 12 Feb 2025 19:12:27 +1100
Subject: [PATCH 1475/2374] Only crop when saving with disposal method 2 if
 transparency is present

---
 Tests/test_file_gif.py    | 15 +++++++++++++++
 src/PIL/GifImagePlugin.py | 28 +++++++++++++++++-----------
 2 files changed, 32 insertions(+), 11 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 46215db1fd4..2f0116434a3 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -762,6 +762,21 @@ def test_dispose2_previous_frame(tmp_path: Path) -> None:
         assert im.getpixel((0, 0)) == (0, 0, 0, 255)
 
 
+def test_dispose2_without_transparency(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.gif")
+
+    im = Image.new("P", (100, 100))
+
+    im2 = Image.new("P", (100, 100), (0, 0, 0))
+    im2.putpixel((50, 50), (255, 0, 0))
+
+    im.save(out, save_all=True, append_images=[im2], disposal=2)
+
+    with Image.open(out) as reloaded:
+        reloaded.seek(1)
+        assert reloaded.tile[0].extents == (0, 0, 100, 100)
+
+
 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 47022d58436..ff7262efc09 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -689,16 +689,21 @@ def _write_multiple_frames(
                         im_frames[-1].encoderinfo["duration"] += encoderinfo["duration"]
                     continue
                 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)
-                        first_palette = im_frames[0].im.palette
-                        assert first_palette is not None
-                        background_im.putpalette(first_palette, first_palette.mode)
-                    bbox = _getbbox(background_im, im_frame)[1]
+                    # To appear correctly in viewers using a convention,
+                    # only consider transparency, and not background color
+                    color = im.encoderinfo.get(
+                        "transparency", im.info.get("transparency")
+                    )
+                    if color is not None:
+                        if background_im is None:
+                            background = _get_background(im_frame, color)
+                            background_im = Image.new("P", im_frame.size, background)
+                            first_palette = im_frames[0].im.palette
+                            assert first_palette is not None
+                            background_im.putpalette(first_palette, first_palette.mode)
+                        bbox = _getbbox(background_im, im_frame)[1]
+                    else:
+                        bbox = (0, 0) + im_frame.size
                 elif encoderinfo.get("optimize") and im_frame.mode != "1":
                     if "transparency" not in encoderinfo:
                         assert im_frame.palette is not None
@@ -764,7 +769,8 @@ def _write_multiple_frames(
             if not palette:
                 frame_data.encoderinfo["include_color_table"] = True
 
-            im_frame = im_frame.crop(frame_data.bbox)
+            if frame_data.bbox != (0, 0) + im_frame.size:
+                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

From ad6c4f82f3d85df5e51d99916fd68f0d8b180244 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Feb 2025 09:27:16 +1100
Subject: [PATCH 1476/2374] Updated lcms2 to 2.17

---
 .github/workflows/wheels-dependencies.sh   | 2 +-
 docs/installation/building-from-source.rst | 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 edf5ba937a5..155e5fb13a3 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -44,7 +44,7 @@ JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.4
 TIFF_VERSION=4.6.0
-LCMS2_VERSION=2.16
+LCMS2_VERSION=2.17
 ZLIB_NG_VERSION=2.2.4
 LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 46a4c1245d1..b400a343611 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -51,7 +51,7 @@ Many of Pillow's features require external libraries:
 * **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**.
+    above uses liblcms2. Tested with **1.19** and **2.7-2.17**.
 
 * **libwebp** provides the WebP format.
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index f942716cb0b..e3509aee632 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -115,7 +115,7 @@ def cmd_msbuild(
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "10.2.0",
     "JPEGTURBO": "3.1.0",
-    "LCMS2": "2.16",
+    "LCMS2": "2.17",
     "LIBIMAGEQUANT": "4.3.4",
     "LIBPNG": "1.6.46",
     "LIBWEBP": "1.5.0",

From 9f0398ef3239cacf0f0250305f4ccb1db9f6c738 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Feb 2025 21:07:43 +1100
Subject: [PATCH 1477/2374] Removed unused code

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

diff --git a/Tests/helper.py b/Tests/helper.py
index e7b0db1d6b1..764935f8713 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -9,7 +9,6 @@
 import shutil
 import subprocess
 import sys
-import sysconfig
 import tempfile
 from collections.abc import Sequence
 from functools import lru_cache
@@ -342,10 +341,6 @@ def is_pypy() -> bool:
     return hasattr(sys, "pypy_translation_info")
 
 
-def is_mingw() -> bool:
-    return sysconfig.get_platform() == "mingw"
-
-
 class CachedProperty:
     def __init__(self, func: Callable[[Any], Any]) -> None:
         self.func = func

From 1c18d29c34789c802e2cfc73d841019bc5f06ca1 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 13:26:06 +0200
Subject: [PATCH 1478/2374] Remove unused bdf_slant and bdf_spacing variables

---
 src/PIL/BdfFontFile.py | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/src/PIL/BdfFontFile.py b/src/PIL/BdfFontFile.py
index bc1416c74c6..bfd66aa6a21 100644
--- a/src/PIL/BdfFontFile.py
+++ b/src/PIL/BdfFontFile.py
@@ -26,17 +26,6 @@
 
 from . import FontFile, Image
 
-bdf_slant = {
-    "R": "Roman",
-    "I": "Italic",
-    "O": "Oblique",
-    "RI": "Reverse Italic",
-    "RO": "Reverse Oblique",
-    "OT": "Other",
-}
-
-bdf_spacing = {"P": "Proportional", "M": "Monospaced", "C": "Cell"}
-
 
 def bdf_char(
     f: BinaryIO,

From 8261348fff5b5a653767c348a44a01d98238a190 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 14:27:52 +0200
Subject: [PATCH 1479/2374] Don't call pip in tox

---
 tox.ini | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/tox.ini b/tox.ini
index e79d8850097..4065245ee11 100644
--- a/tox.ini
+++ b/tox.ini
@@ -11,12 +11,8 @@ deps =
 extras =
     tests
 commands =
-    make clean
-    {envpython} -m pip install .
     {envpython} selftest.py
     {envpython} -m pytest -W always {posargs}
-allowlist_externals =
-    make
 
 [testenv:lint]
 skip_install = true

From ff960b884188855c4a8afb2a2724674d80b31e04 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 14:23:59 +0200
Subject: [PATCH 1480/2374] Remove debug Image._wedge

---
 Tests/test_file_gif.py   |  2 +-
 Tests/test_format_hsv.py | 28 +++++++++++++---------------
 src/PIL/Image.py         |  9 ---------
 src/_imaging.c           |  1 -
 4 files changed, 14 insertions(+), 26 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 396e09ba9d0..974aedeb61a 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1348,7 +1348,7 @@ def test_save_I(tmp_path: Path) -> None:
 def test_getdata(monkeypatch: pytest.MonkeyPatch) -> 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)
+    im = Image.linear_gradient(mode="L").resize((16, 16), Image.Resampling.NEAREST)
     im.putpalette(ImagePalette.ImagePalette("RGB"))
     im.info = {"background": 0}
 
diff --git a/Tests/test_format_hsv.py b/Tests/test_format_hsv.py
index c07024a2c5d..9cbf18566ca 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -22,28 +22,26 @@ def test_sanity() -> None:
     Image.new("HSV", (100, 100))
 
 
-def wedge() -> Image.Image:
-    w = Image._wedge()
-    w90 = w.rotate(90)
+def linear_gradient() -> Image.Image:
+    im = Image.linear_gradient(mode="L")
+    im90 = im.rotate(90)
 
-    (px, h) = w.size
+    (px, h) = im.size
 
     r = Image.new("L", (px * 3, h))
     g = r.copy()
     b = r.copy()
 
-    r.paste(w, (0, 0))
-    r.paste(w90, (px, 0))
+    r.paste(im, (0, 0))
+    r.paste(im90, (px, 0))
 
-    g.paste(w90, (0, 0))
-    g.paste(w, (2 * px, 0))
+    g.paste(im90, (0, 0))
+    g.paste(im, (2 * px, 0))
 
-    b.paste(w, (px, 0))
-    b.paste(w90, (2 * px, 0))
+    b.paste(im, (px, 0))
+    b.paste(im90, (2 * px, 0))
 
-    img = Image.merge("RGB", (r, g, b))
-
-    return img
+    return Image.merge("RGB", (r, g, b))
 
 
 def to_xxx_colorsys(
@@ -79,8 +77,8 @@ def to_rgb_colorsys(im: Image.Image) -> Image.Image:
     return to_xxx_colorsys(im, colorsys.hsv_to_rgb, "RGB")
 
 
-def test_wedge() -> None:
-    src = wedge().resize((3 * 32, 32), Image.Resampling.BILINEAR)
+def test_linear_gradient() -> None:
+    src = linear_gradient().resize((3 * 32, 32), Image.Resampling.BILINEAR)
     im = src.convert("HSV")
     comparable = to_hsv_colorsys(src)
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index e723b6a2ed2..a5243549fa7 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2996,15 +2996,6 @@ def transform(
 # --------------------------------------------------------------------
 # Factories
 
-#
-# Debugging
-
-
-def _wedge() -> Image:
-    """Create grayscale wedge (for debugging only)"""
-
-    return Image()._new(core.wedge("L"))
-
 
 def _check_size(size: Any) -> None:
     """
diff --git a/src/_imaging.c b/src/_imaging.c
index ee373e96452..daaa56c7524 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4256,7 +4256,6 @@ static PyMethodDef functions[] = {
     {"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 */
     {"font", (PyCFunction)_font_new, METH_VARARGS},

From 028f0d6ea9263928f29e5b62fa67d95870f57144 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 14:42:28 +0200
Subject: [PATCH 1481/2374] Remove unused data read

---
 Tests/test_file_gif.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 974aedeb61a..6a295e89a15 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -22,9 +22,6 @@
 # sample gif stream
 TEST_GIF = "Tests/images/hopper.gif"
 
-with open(TEST_GIF, "rb") as f:
-    data = f.read()
-
 
 def test_sanity() -> None:
     with Image.open(TEST_GIF) as im:

From 126026e5e544ed35a7ea82349f41a1281facccf9 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 14:44:00 +0200
Subject: [PATCH 1482/2374] Don't shadow builtin open

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

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 6a295e89a15..d5084201937 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -34,12 +34,12 @@ def test_sanity() -> None:
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
-    def open() -> None:
+    def open_test_image() -> None:
         im = Image.open(TEST_GIF)
         im.load()
 
     with pytest.warns(ResourceWarning):
-        open()
+        open_test_image()
 
 
 def test_closed_file() -> None:

From 7f414846a3ef1cc5a740a74aa6cdeb49b58a373d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 16 Feb 2025 05:08:22 +1100
Subject: [PATCH 1483/2374] Don't shadow builtin open

---
 Tests/test_file_dcx.py    | 4 ++--
 Tests/test_file_fli.py    | 4 ++--
 Tests/test_file_im.py     | 4 ++--
 Tests/test_file_mpo.py    | 4 ++--
 Tests/test_file_psd.py    | 4 ++--
 Tests/test_file_spider.py | 4 ++--
 Tests/test_file_tiff.py   | 4 ++--
 7 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/Tests/test_file_dcx.py b/Tests/test_file_dcx.py
index 5deacd878ea..ab6b9f983d9 100644
--- a/Tests/test_file_dcx.py
+++ b/Tests/test_file_dcx.py
@@ -26,12 +26,12 @@ def test_sanity() -> None:
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
-    def open() -> None:
+    def open_test_image() -> None:
         im = Image.open(TEST_FILE)
         im.load()
 
     with pytest.warns(ResourceWarning):
-        open()
+        open_test_image()
 
 
 def test_closed_file() -> None:
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 876561a88b8..8adbd30f5ef 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -52,12 +52,12 @@ def test_prefix_chunk(monkeypatch: pytest.MonkeyPatch) -> None:
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
-    def open() -> None:
+    def open_test_image() -> None:
         im = Image.open(static_test_file)
         im.load()
 
     with pytest.warns(ResourceWarning):
-        open()
+        open_test_image()
 
 
 def test_closed_file() -> None:
diff --git a/Tests/test_file_im.py b/Tests/test_file_im.py
index 1d3fa485f3b..d2999880153 100644
--- a/Tests/test_file_im.py
+++ b/Tests/test_file_im.py
@@ -31,12 +31,12 @@ def test_name_limit(tmp_path: Path) -> None:
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
-    def open() -> None:
+    def open_test_image() -> None:
         im = Image.open(TEST_IM)
         im.load()
 
     with pytest.warns(ResourceWarning):
-        open()
+        open_test_image()
 
 
 def test_closed_file() -> None:
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 66fa2917709..311085cf790 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -38,12 +38,12 @@ def test_sanity(test_file: str) -> None:
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
-    def open() -> None:
+    def open_test_image() -> None:
         im = Image.open(test_files[0])
         im.load()
 
     with pytest.warns(ResourceWarning):
-        open()
+        open_test_image()
 
 
 def test_closed_file() -> None:
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 5f22001f324..1793c269d59 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -25,12 +25,12 @@ def test_sanity() -> None:
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
-    def open() -> None:
+    def open_test_image() -> None:
         im = Image.open(test_file)
         im.load()
 
     with pytest.warns(ResourceWarning):
-        open()
+        open_test_image()
 
 
 def test_closed_file() -> None:
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 713db848df8..cdb7b3e0ba5 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -24,12 +24,12 @@ def test_sanity() -> None:
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
-    def open() -> None:
+    def open_test_image() -> None:
         im = Image.open(TEST_FILE)
         im.load()
 
     with pytest.warns(ResourceWarning):
-        open()
+        open_test_image()
 
 
 def test_closed_file() -> None:
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index fe8f69848f7..a8a407963c5 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -63,12 +63,12 @@ def test_sanity(self, tmp_path: Path) -> None:
 
     @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
     def test_unclosed_file(self) -> None:
-        def open() -> None:
+        def open_test_image() -> None:
             im = Image.open("Tests/images/multipage.tiff")
             im.load()
 
         with pytest.warns(ResourceWarning):
-            open()
+            open_test_image()
 
     def test_closed_file(self) -> None:
         with warnings.catch_warnings():

From 0fbe1860c4f2688a7e18a1b4e525b4b5fb1c5d41 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= <mgorny@gentoo.org>
Date: Sun, 16 Feb 2025 16:32:24 +0100
Subject: [PATCH 1484/2374] Update `pythoncapi_compat.h` to fix building with
 PyPy3.11
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update `pythoncapi_compat.h` to upstream commit
c84545f0e1e21757d4901f75c47333d25a3fcff0, which includes fixes necessary
for Pillow to build against PyPy3.11.  Otherwise, it fails due to
duplicate declarations:

```
      In file included from src/encode.c:28:
      src/thirdparty/pythoncapi_compat.h:295:1: error: static declaration of ‘PyThreadState_GetInterpreter’ follows non-static declaration
        295 | PyThreadState_GetInterpreter(PyThreadState *tstate)
            | ^~~~~~~~~~~~~~~~~~~~~~~~~~~~
      In file included from /usr/include/pypy3.11/Python.h:80,
                       from src/encode.c:26:
      /usr/include/pypy3.11/pystate.h:35:33: note: previous declaration of ‘PyThreadState_GetInterpreter’ with type ‘PyInterpreterState *(PyThreadState *)’ {aka ‘struct _is *(struct _ts *)’}
         35 | PyAPI_FUNC(PyInterpreterState*) PyThreadState_GetInterpreter(PyThreadState *tstate);
            |                                 ^~~~~~~~~~~~~~~~~~~~~~~~~~~~
```
---
 src/thirdparty/pythoncapi_compat.h | 521 ++++++++++++++++++++++++++++-
 1 file changed, 514 insertions(+), 7 deletions(-)

diff --git a/src/thirdparty/pythoncapi_compat.h b/src/thirdparty/pythoncapi_compat.h
index ca23d5ffa9a..04fcf61e0ef 100644
--- a/src/thirdparty/pythoncapi_compat.h
+++ b/src/thirdparty/pythoncapi_compat.h
@@ -10,7 +10,7 @@
 // https://raw.githubusercontent.com/python/pythoncapi-compat/main/pythoncapi_compat.h
 //
 // This file was vendored from the following commit:
-// https://github.com/python/pythoncapi-compat/commit/0041177c4f348c8952b4c8980b2c90856e61c7c7
+// https://github.com/python/pythoncapi-compat/commit/c84545f0e1e21757d4901f75c47333d25a3fcff0
 //
 // SPDX-License-Identifier: 0BSD
 
@@ -22,11 +22,15 @@ extern "C" {
 #endif
 
 #include <Python.h>
+#include <stddef.h>               // offsetof()
 
 // 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
+#if PY_VERSION_HEX < 0x030C00A3
+#  include <structmember.h>       // T_SHORT, READONLY
+#endif
 
 
 #ifndef _Py_CAST
@@ -290,7 +294,7 @@ PyFrame_GetVarString(PyFrameObject *frame, const char *name)
 
 
 // bpo-39947 added PyThreadState_GetInterpreter() to Python 3.9.0a5
-#if PY_VERSION_HEX < 0x030900A5 || defined(PYPY_VERSION)
+#if PY_VERSION_HEX < 0x030900A5 || (defined(PYPY_VERSION) && PY_VERSION_HEX < 0x030B0000)
 static inline PyInterpreterState *
 PyThreadState_GetInterpreter(PyThreadState *tstate)
 {
@@ -583,7 +587,7 @@ static inline int PyWeakref_GetRef(PyObject *ref, PyObject **pobj)
         return 0;
     }
     *pobj = Py_NewRef(obj);
-    return (*pobj != NULL);
+    return 1;
 }
 #endif
 
@@ -921,7 +925,7 @@ static inline int
 PyObject_VisitManagedDict(PyObject *obj, visitproc visit, void *arg)
 {
     PyObject **dict = _PyObject_GetDictPtr(obj);
-    if (*dict == NULL) {
+    if (dict == NULL || *dict == NULL) {
         return -1;
     }
     Py_VISIT(*dict);
@@ -932,7 +936,7 @@ static inline void
 PyObject_ClearManagedDict(PyObject *obj)
 {
     PyObject **dict = _PyObject_GetDictPtr(obj);
-    if (*dict == NULL) {
+    if (dict == NULL || *dict == NULL) {
         return;
     }
     Py_CLEAR(*dict);
@@ -1207,11 +1211,11 @@ static inline int PyTime_PerfCounter(PyTime_t *result)
 #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.
+// added first as private macros to Python 3.4.0b1 and PyPy 7.3.8.
 #if (!defined(PyHASH_BITS) \
      && ((!defined(PYPY_VERSION) && PY_VERSION_HEX >= 0x030400B1) \
          || (defined(PYPY_VERSION) && PY_VERSION_HEX >= 0x03070000 \
-             && PYPY_VERSION_NUM >= 0x07090000)))
+             && PYPY_VERSION_NUM >= 0x07030800)))
 #  define PyHASH_BITS _PyHASH_BITS
 #  define PyHASH_MODULUS _PyHASH_MODULUS
 #  define PyHASH_INF _PyHASH_INF
@@ -1523,6 +1527,36 @@ static inline int PyLong_GetSign(PyObject *obj, int *sign)
 }
 #endif
 
+// gh-126061 added PyLong_IsPositive/Negative/Zero() to Python in 3.14.0a2
+#if PY_VERSION_HEX < 0x030E00A2
+static inline int PyLong_IsPositive(PyObject *obj)
+{
+    if (!PyLong_Check(obj)) {
+        PyErr_Format(PyExc_TypeError, "expected int, got %s", Py_TYPE(obj)->tp_name);
+        return -1;
+    }
+    return _PyLong_Sign(obj) == 1;
+}
+
+static inline int PyLong_IsNegative(PyObject *obj)
+{
+    if (!PyLong_Check(obj)) {
+        PyErr_Format(PyExc_TypeError, "expected int, got %s", Py_TYPE(obj)->tp_name);
+        return -1;
+    }
+    return _PyLong_Sign(obj) == -1;
+}
+
+static inline int PyLong_IsZero(PyObject *obj)
+{
+    if (!PyLong_Check(obj)) {
+        PyErr_Format(PyExc_TypeError, "expected int, got %s", Py_TYPE(obj)->tp_name);
+        return -1;
+    }
+    return _PyLong_Sign(obj) == 0;
+}
+#endif
+
 
 // gh-124502 added PyUnicode_Equal() to Python 3.14.0a0
 #if PY_VERSION_HEX < 0x030E00A0
@@ -1693,6 +1727,479 @@ static inline int PyLong_AsUInt64(PyObject *obj, uint64_t *pvalue)
 #endif
 
 
+// gh-102471 added import and export API for integers to 3.14.0a2.
+#if PY_VERSION_HEX < 0x030E00A2 && PY_VERSION_HEX >= 0x03000000 && !defined(PYPY_VERSION)
+// Helpers to access PyLongObject internals.
+static inline void
+_PyLong_SetSignAndDigitCount(PyLongObject *op, int sign, Py_ssize_t size)
+{
+#if PY_VERSION_HEX >= 0x030C0000
+    op->long_value.lv_tag = (uintptr_t)(1 - sign) | ((uintptr_t)(size) << 3);
+#elif PY_VERSION_HEX >= 0x030900A4
+    Py_SET_SIZE(op, sign * size);
+#else
+    Py_SIZE(op) = sign * size;
+#endif
+}
+
+static inline Py_ssize_t
+_PyLong_DigitCount(const PyLongObject *op)
+{
+#if PY_VERSION_HEX >= 0x030C0000
+    return (Py_ssize_t)(op->long_value.lv_tag >> 3);
+#else
+    return _PyLong_Sign((PyObject*)op) < 0 ? -Py_SIZE(op) : Py_SIZE(op);
+#endif
+}
+
+static inline digit*
+_PyLong_GetDigits(const PyLongObject *op)
+{
+#if PY_VERSION_HEX >= 0x030C0000
+    return (digit*)(op->long_value.ob_digit);
+#else
+    return (digit*)(op->ob_digit);
+#endif
+}
+
+typedef struct PyLongLayout {
+    uint8_t bits_per_digit;
+    uint8_t digit_size;
+    int8_t digits_order;
+    int8_t digit_endianness;
+} PyLongLayout;
+
+typedef struct PyLongExport {
+    int64_t value;
+    uint8_t negative;
+    Py_ssize_t ndigits;
+    const void *digits;
+    Py_uintptr_t _reserved;
+} PyLongExport;
+
+typedef struct PyLongWriter PyLongWriter;
+
+static inline const PyLongLayout*
+PyLong_GetNativeLayout(void)
+{
+    static const PyLongLayout PyLong_LAYOUT = {
+        PyLong_SHIFT,
+        sizeof(digit),
+        -1,  // least significant first
+        PY_LITTLE_ENDIAN ? -1 : 1,
+    };
+
+    return &PyLong_LAYOUT;
+}
+
+static inline int
+PyLong_Export(PyObject *obj, PyLongExport *export_long)
+{
+    if (!PyLong_Check(obj)) {
+        memset(export_long, 0, sizeof(*export_long));
+        PyErr_Format(PyExc_TypeError, "expected int, got %s",
+                     Py_TYPE(obj)->tp_name);
+        return -1;
+    }
+
+    // Fast-path: try to convert to a int64_t
+    PyLongObject *self = (PyLongObject*)obj;
+    int overflow;
+#if SIZEOF_LONG == 8
+    long value = PyLong_AsLongAndOverflow(obj, &overflow);
+#else
+    // Windows has 32-bit long, so use 64-bit long long instead
+    long long value = PyLong_AsLongLongAndOverflow(obj, &overflow);
+#endif
+    Py_BUILD_ASSERT(sizeof(value) == sizeof(int64_t));
+    // the function cannot fail since obj is a PyLongObject
+    assert(!(value == -1 && PyErr_Occurred()));
+
+    if (!overflow) {
+        export_long->value = value;
+        export_long->negative = 0;
+        export_long->ndigits = 0;
+        export_long->digits = 0;
+        export_long->_reserved = 0;
+    }
+    else {
+        export_long->value = 0;
+        export_long->negative = _PyLong_Sign(obj) < 0;
+        export_long->ndigits = _PyLong_DigitCount(self);
+        if (export_long->ndigits == 0) {
+            export_long->ndigits = 1;
+        }
+        export_long->digits = _PyLong_GetDigits(self);
+        export_long->_reserved = (Py_uintptr_t)Py_NewRef(obj);
+    }
+    return 0;
+}
+
+static inline void
+PyLong_FreeExport(PyLongExport *export_long)
+{
+    PyObject *obj = (PyObject*)export_long->_reserved;
+
+    if (obj) {
+        export_long->_reserved = 0;
+        Py_DECREF(obj);
+    }
+}
+
+static inline PyLongWriter*
+PyLongWriter_Create(int negative, Py_ssize_t ndigits, void **digits)
+{
+    if (ndigits <= 0) {
+        PyErr_SetString(PyExc_ValueError, "ndigits must be positive");
+        return NULL;
+    }
+    assert(digits != NULL);
+
+    PyLongObject *obj = _PyLong_New(ndigits);
+    if (obj == NULL) {
+        return NULL;
+    }
+    _PyLong_SetSignAndDigitCount(obj, negative?-1:1, ndigits);
+
+    *digits = _PyLong_GetDigits(obj);
+    return (PyLongWriter*)obj;
+}
+
+static inline void
+PyLongWriter_Discard(PyLongWriter *writer)
+{
+    PyLongObject *obj = (PyLongObject *)writer;
+
+    assert(Py_REFCNT(obj) == 1);
+    Py_DECREF(obj);
+}
+
+static inline PyObject*
+PyLongWriter_Finish(PyLongWriter *writer)
+{
+    PyObject *obj = (PyObject *)writer;
+    PyLongObject *self = (PyLongObject*)obj;
+    Py_ssize_t j = _PyLong_DigitCount(self);
+    Py_ssize_t i = j;
+    int sign = _PyLong_Sign(obj);
+
+    assert(Py_REFCNT(obj) == 1);
+
+    // Normalize and get singleton if possible
+    while (i > 0 && _PyLong_GetDigits(self)[i-1] == 0) {
+        --i;
+    }
+    if (i != j) {
+        if (i == 0) {
+            sign = 0;
+        }
+        _PyLong_SetSignAndDigitCount(self, sign, i);
+    }
+    if (i <= 1) {
+        long val = sign * (long)(_PyLong_GetDigits(self)[0]);
+        Py_DECREF(obj);
+        return PyLong_FromLong(val);
+    }
+
+    return obj;
+}
+#endif
+
+
+#if PY_VERSION_HEX < 0x030C00A3
+#  define Py_T_SHORT      T_SHORT
+#  define Py_T_INT        T_INT
+#  define Py_T_LONG       T_LONG
+#  define Py_T_FLOAT      T_FLOAT
+#  define Py_T_DOUBLE     T_DOUBLE
+#  define Py_T_STRING     T_STRING
+#  define _Py_T_OBJECT    T_OBJECT
+#  define Py_T_CHAR       T_CHAR
+#  define Py_T_BYTE       T_BYTE
+#  define Py_T_UBYTE      T_UBYTE
+#  define Py_T_USHORT     T_USHORT
+#  define Py_T_UINT       T_UINT
+#  define Py_T_ULONG      T_ULONG
+#  define Py_T_STRING_INPLACE  T_STRING_INPLACE
+#  define Py_T_BOOL       T_BOOL
+#  define Py_T_OBJECT_EX  T_OBJECT_EX
+#  define Py_T_LONGLONG   T_LONGLONG
+#  define Py_T_ULONGLONG  T_ULONGLONG
+#  define Py_T_PYSSIZET   T_PYSSIZET
+
+#  if PY_VERSION_HEX >= 0x03000000 && !defined(PYPY_VERSION)
+#    define _Py_T_NONE      T_NONE
+#  endif
+
+#  define Py_READONLY            READONLY
+#  define Py_AUDIT_READ          READ_RESTRICTED
+#  define _Py_WRITE_RESTRICTED   PY_WRITE_RESTRICTED
+#endif
+
+
+// gh-127350 added Py_fopen() and Py_fclose() to Python 3.14a4
+#if PY_VERSION_HEX < 0x030E00A4
+static inline FILE* Py_fopen(PyObject *path, const char *mode)
+{
+#if 0x030400A2 <= PY_VERSION_HEX && !defined(PYPY_VERSION)
+    PyAPI_FUNC(FILE*) _Py_fopen_obj(PyObject *path, const char *mode);
+
+    return _Py_fopen_obj(path, mode);
+#else
+    FILE *f;
+    PyObject *bytes;
+#if PY_VERSION_HEX >= 0x03000000
+    if (!PyUnicode_FSConverter(path, &bytes)) {
+        return NULL;
+    }
+#else
+    if (!PyString_Check(path)) {
+        PyErr_SetString(PyExc_TypeError, "except str");
+        return NULL;
+    }
+    bytes = Py_NewRef(path);
+#endif
+    const char *path_bytes = PyBytes_AS_STRING(bytes);
+
+    f = fopen(path_bytes, mode);
+    Py_DECREF(bytes);
+
+    if (f == NULL) {
+        PyErr_SetFromErrnoWithFilenameObject(PyExc_OSError, path);
+        return NULL;
+    }
+    return f;
+#endif
+}
+
+static inline int Py_fclose(FILE *file)
+{
+    return fclose(file);
+}
+#endif
+
+
+#if 0x03090000 <= PY_VERSION_HEX && PY_VERSION_HEX < 0x030E0000 && !defined(PYPY_VERSION)
+static inline PyObject*
+PyConfig_Get(const char *name)
+{
+    typedef enum {
+        _PyConfig_MEMBER_INT,
+        _PyConfig_MEMBER_UINT,
+        _PyConfig_MEMBER_ULONG,
+        _PyConfig_MEMBER_BOOL,
+        _PyConfig_MEMBER_WSTR,
+        _PyConfig_MEMBER_WSTR_OPT,
+        _PyConfig_MEMBER_WSTR_LIST,
+    } PyConfigMemberType;
+
+    typedef struct {
+        const char *name;
+        size_t offset;
+        PyConfigMemberType type;
+        const char *sys_attr;
+    } PyConfigSpec;
+
+#define PYTHONCAPI_COMPAT_SPEC(MEMBER, TYPE, sys_attr) \
+    {#MEMBER, offsetof(PyConfig, MEMBER), \
+     _PyConfig_MEMBER_##TYPE, sys_attr}
+
+    static const PyConfigSpec config_spec[] = {
+        PYTHONCAPI_COMPAT_SPEC(argv, WSTR_LIST, "argv"),
+        PYTHONCAPI_COMPAT_SPEC(base_exec_prefix, WSTR_OPT, "base_exec_prefix"),
+        PYTHONCAPI_COMPAT_SPEC(base_executable, WSTR_OPT, "_base_executable"),
+        PYTHONCAPI_COMPAT_SPEC(base_prefix, WSTR_OPT, "base_prefix"),
+        PYTHONCAPI_COMPAT_SPEC(bytes_warning, UINT, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(exec_prefix, WSTR_OPT, "exec_prefix"),
+        PYTHONCAPI_COMPAT_SPEC(executable, WSTR_OPT, "executable"),
+        PYTHONCAPI_COMPAT_SPEC(inspect, BOOL, _Py_NULL),
+#if 0x030C0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(int_max_str_digits, UINT, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(interactive, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(module_search_paths, WSTR_LIST, "path"),
+        PYTHONCAPI_COMPAT_SPEC(optimization_level, UINT, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(parser_debug, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(platlibdir, WSTR, "platlibdir"),
+        PYTHONCAPI_COMPAT_SPEC(prefix, WSTR_OPT, "prefix"),
+        PYTHONCAPI_COMPAT_SPEC(pycache_prefix, WSTR_OPT, "pycache_prefix"),
+        PYTHONCAPI_COMPAT_SPEC(quiet, BOOL, _Py_NULL),
+#if 0x030B0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(stdlib_dir, WSTR_OPT, "_stdlib_dir"),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(use_environment, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(verbose, UINT, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(warnoptions, WSTR_LIST, "warnoptions"),
+        PYTHONCAPI_COMPAT_SPEC(write_bytecode, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(xoptions, WSTR_LIST, "_xoptions"),
+        PYTHONCAPI_COMPAT_SPEC(buffered_stdio, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(check_hash_pycs_mode, WSTR, _Py_NULL),
+#if 0x030B0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(code_debug_ranges, BOOL, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(configure_c_stdio, BOOL, _Py_NULL),
+#if 0x030D0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(cpu_count, INT, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(dev_mode, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(dump_refs, BOOL, _Py_NULL),
+#if 0x030B0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(dump_refs_file, WSTR_OPT, _Py_NULL),
+#endif
+#ifdef Py_GIL_DISABLED
+        PYTHONCAPI_COMPAT_SPEC(enable_gil, INT, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(faulthandler, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(filesystem_encoding, WSTR, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(filesystem_errors, WSTR, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(hash_seed, ULONG, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(home, WSTR_OPT, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(import_time, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(install_signal_handlers, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(isolated, BOOL, _Py_NULL),
+#ifdef MS_WINDOWS
+        PYTHONCAPI_COMPAT_SPEC(legacy_windows_stdio, BOOL, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(malloc_stats, BOOL, _Py_NULL),
+#if 0x030A0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(orig_argv, WSTR_LIST, "orig_argv"),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(parse_argv, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(pathconfig_warnings, BOOL, _Py_NULL),
+#if 0x030C0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(perf_profiling, UINT, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(program_name, WSTR, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(run_command, WSTR_OPT, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(run_filename, WSTR_OPT, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(run_module, WSTR_OPT, _Py_NULL),
+#if 0x030B0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(safe_path, BOOL, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(show_ref_count, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(site_import, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(skip_source_first_line, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(stdio_encoding, WSTR, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(stdio_errors, WSTR, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(tracemalloc, UINT, _Py_NULL),
+#if 0x030B0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(use_frozen_modules, BOOL, _Py_NULL),
+#endif
+        PYTHONCAPI_COMPAT_SPEC(use_hash_seed, BOOL, _Py_NULL),
+        PYTHONCAPI_COMPAT_SPEC(user_site_directory, BOOL, _Py_NULL),
+#if 0x030A0000 <= PY_VERSION_HEX
+        PYTHONCAPI_COMPAT_SPEC(warn_default_encoding, BOOL, _Py_NULL),
+#endif
+    };
+
+#undef PYTHONCAPI_COMPAT_SPEC
+
+    const PyConfigSpec *spec;
+    int found = 0;
+    for (size_t i=0; i < sizeof(config_spec) / sizeof(config_spec[0]); i++) {
+        spec = &config_spec[i];
+        if (strcmp(spec->name, name) == 0) {
+            found = 1;
+            break;
+        }
+    }
+    if (found) {
+        if (spec->sys_attr != NULL) {
+            PyObject *value = PySys_GetObject(spec->sys_attr);
+            if (value == NULL) {
+                PyErr_Format(PyExc_RuntimeError, "lost sys.%s", spec->sys_attr);
+                return NULL;
+            }
+            return Py_NewRef(value);
+        }
+
+        PyAPI_FUNC(const PyConfig*) _Py_GetConfig(void);
+
+        const PyConfig *config = _Py_GetConfig();
+        void *member = (char *)config + spec->offset;
+        switch (spec->type) {
+        case _PyConfig_MEMBER_INT:
+        case _PyConfig_MEMBER_UINT:
+        {
+            int value = *(int *)member;
+            return PyLong_FromLong(value);
+        }
+        case _PyConfig_MEMBER_BOOL:
+        {
+            int value = *(int *)member;
+            return PyBool_FromLong(value != 0);
+        }
+        case _PyConfig_MEMBER_ULONG:
+        {
+            unsigned long value = *(unsigned long *)member;
+            return PyLong_FromUnsignedLong(value);
+        }
+        case _PyConfig_MEMBER_WSTR:
+        case _PyConfig_MEMBER_WSTR_OPT:
+        {
+            wchar_t *wstr = *(wchar_t **)member;
+            if (wstr != NULL) {
+                return PyUnicode_FromWideChar(wstr, -1);
+            }
+            else {
+                return Py_NewRef(Py_None);
+            }
+        }
+        case _PyConfig_MEMBER_WSTR_LIST:
+        {
+            const PyWideStringList *list = (const PyWideStringList *)member;
+            PyObject *tuple = PyTuple_New(list->length);
+            if (tuple == NULL) {
+                return NULL;
+            }
+
+            for (Py_ssize_t i = 0; i < list->length; i++) {
+                PyObject *item = PyUnicode_FromWideChar(list->items[i], -1);
+                if (item == NULL) {
+                    Py_DECREF(tuple);
+                    return NULL;
+                }
+                PyTuple_SET_ITEM(tuple, i, item);
+            }
+            return tuple;
+        }
+        default:
+            Py_UNREACHABLE();
+        }
+    }
+
+    PyErr_Format(PyExc_ValueError, "unknown config option name: %s", name);
+    return NULL;
+}
+
+static inline int
+PyConfig_GetInt(const char *name, int *value)
+{
+    PyObject *obj = PyConfig_Get(name);
+    if (obj == NULL) {
+        return -1;
+    }
+
+    if (!PyLong_Check(obj)) {
+        Py_DECREF(obj);
+        PyErr_Format(PyExc_TypeError, "config option %s is not an int", name);
+        return -1;
+    }
+
+    int as_int = PyLong_AsInt(obj);
+    Py_DECREF(obj);
+    if (as_int == -1 && PyErr_Occurred()) {
+        PyErr_Format(PyExc_OverflowError,
+                     "config option %s value does not fit into a C int", name);
+        return -1;
+    }
+
+    *value = as_int;
+    return 0;
+}
+#endif  // PY_VERSION_HEX > 0x03090000 && !defined(PYPY_VERSION)
+
+
 #ifdef __cplusplus
 }
 #endif

From 216690ff17d03c80860b59f5ba2311383a09525c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 7 Feb 2025 18:11:54 +0200
Subject: [PATCH 1485/2374] Add PyPy3.11 to CI

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 8faab2ef477..ef49ff332f3 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", "3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["pypy3.11", "pypy3.10", "3.10", "3.11", "3.12", "3.13", "3.14"]
         architecture: ["x64"]
         os: ["windows-latest"]
         include:
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index e3efe0b593a..c4ad88be9f0 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -41,6 +41,7 @@ jobs:
           "ubuntu-latest",
         ]
         python-version: [
+          "pypy3.11",
           "pypy3.10",
           "3.14",
           "3.13t",

From 9762c9e30eeb6adc6815b25ad619432f707d4632 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 17 Feb 2025 20:20:02 +1100
Subject: [PATCH 1486/2374] Test unexpected end of tar file

---
 Tests/test_file_tar.py | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index 49220a8b690..d1a4ca9de08 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import warnings
+from pathlib import Path
 
 import pytest
 
@@ -29,6 +30,16 @@ def test_sanity(codec: str, test_path: str, format: str) -> None:
                 assert im.format == format
 
 
+def test_unexpected_end(tmp_path: Path) -> None:
+    tmpfile = str(tmp_path / "temp.tar")
+    with open(tmpfile, "w"):
+        pass
+
+    with pytest.raises(OSError):
+        with TarIO.TarIO(tmpfile, "test"):
+            pass
+
+
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
     with pytest.warns(ResourceWarning):

From 152d982644f4474d14597b4cba878903db400a67 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 17 Feb 2025 20:20:45 +1100
Subject: [PATCH 1487/2374] Test missing subfile

---
 Tests/test_file_tar.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index d1a4ca9de08..e1a6a55d775 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -40,6 +40,12 @@ def test_unexpected_end(tmp_path: Path) -> None:
             pass
 
 
+def test_cannot_find_subfile(tmp_path: Path) -> None:
+    with pytest.raises(OSError):
+        with TarIO.TarIO(TEST_TAR_FILE, "test"):
+            pass
+
+
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:
     with pytest.warns(ResourceWarning):

From 15e4c1a72451672d035e9e1525ccac539252e742 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 21:34:25 +0200
Subject: [PATCH 1488/2374] Fix ShellCheck

---
 .ci/install.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index 5c20e7f3727..e61752750c2 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -2,12 +2,12 @@
 
 aptget_update()
 {
-    if [ ! -z $1 ]; then
+    if [ -n "$1" ]; then
         echo ""
         echo "Retrying apt-get update..."
         echo ""
     fi
-    output=`sudo apt-get update 2>&1`
+    output=$(sudo apt-get update 2>&1)
     echo "$output"
     if [[ $output == *[WE]:\ * ]]; then
         return 1

From 017b16b803347bceb19361230c751267fab6e660 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 17 Feb 2025 21:48:09 +1100
Subject: [PATCH 1489/2374] Removed argument

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

diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index e1a6a55d775..9fc3edcd702 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -40,7 +40,7 @@ def test_unexpected_end(tmp_path: Path) -> None:
             pass
 
 
-def test_cannot_find_subfile(tmp_path: Path) -> None:
+def test_cannot_find_subfile() -> None:
     with pytest.raises(OSError):
         with TarIO.TarIO(TEST_TAR_FILE, "test"):
             pass

From 19010bb301e559dd6c9b255c9e3134bbde31297f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 17 Feb 2025 21:49:08 +1100
Subject: [PATCH 1490/2374] Use match

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

diff --git a/Tests/test_file_tar.py b/Tests/test_file_tar.py
index 9fc3edcd702..084d0f2880d 100644
--- a/Tests/test_file_tar.py
+++ b/Tests/test_file_tar.py
@@ -35,13 +35,13 @@ def test_unexpected_end(tmp_path: Path) -> None:
     with open(tmpfile, "w"):
         pass
 
-    with pytest.raises(OSError):
+    with pytest.raises(OSError, match="unexpected end of tar file"):
         with TarIO.TarIO(tmpfile, "test"):
             pass
 
 
 def test_cannot_find_subfile() -> None:
-    with pytest.raises(OSError):
+    with pytest.raises(OSError, match="cannot find subfile"):
         with TarIO.TarIO(TEST_TAR_FILE, "test"):
             pass
 

From 322e121a92ac6c608ef3d626a19b7d3127ab044f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 18 Feb 2025 07:56:11 +1100
Subject: [PATCH 1491/2374] Corrected type check

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

diff --git a/Tests/test_file_gbr.py b/Tests/test_file_gbr.py
index 5b59cc07ac9..1b834cd3c73 100644
--- a/Tests/test_file_gbr.py
+++ b/Tests/test_file_gbr.py
@@ -16,7 +16,7 @@ def test_load() -> None:
     with Image.open("Tests/images/gbr.gbr") as im:
         px = im.load()
         assert px is not None
-        assert im.load()[0, 0] == (0, 0, 0, 0)
+        assert px[0, 0] == (0, 0, 0, 0)
 
         # Test again now that it has already been loaded once
         px = im.load()

From 1e574e6f8bfd5862a5875db38d08a1e83cadb0e2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 19:28:43 +0200
Subject: [PATCH 1492/2374] Replace slice and comparison with startswith

---
 Tests/test_file_mpo.py                        |  4 ++--
 Tests/test_file_webp_metadata.py              |  2 +-
 Tests/test_image.py                           |  4 ++--
 docs/example/DdsImagePlugin.py                |  2 +-
 .../writing-your-own-image-plugin.rst         |  2 +-
 src/PIL/BdfFontFile.py                        | 10 +++++-----
 src/PIL/BlpImagePlugin.py                     |  2 +-
 src/PIL/BmpImagePlugin.py                     |  2 +-
 src/PIL/BufrStubImagePlugin.py                |  2 +-
 src/PIL/CurImagePlugin.py                     |  2 +-
 src/PIL/DdsImagePlugin.py                     |  2 +-
 src/PIL/EpsImagePlugin.py                     |  6 ++++--
 src/PIL/FitsImagePlugin.py                    |  2 +-
 src/PIL/FpxImagePlugin.py                     |  2 +-
 src/PIL/FtexImagePlugin.py                    |  2 +-
 src/PIL/GifImagePlugin.py                     |  4 ++--
 src/PIL/GimpGradientFile.py                   |  2 +-
 src/PIL/GimpPaletteFile.py                    |  2 +-
 src/PIL/GribStubImagePlugin.py                |  2 +-
 src/PIL/Hdf5StubImagePlugin.py                |  2 +-
 src/PIL/IcnsImagePlugin.py                    |  8 ++++----
 src/PIL/IcoImagePlugin.py                     |  2 +-
 src/PIL/ImImagePlugin.py                      |  4 ++--
 src/PIL/Image.py                              |  2 +-
 src/PIL/Jpeg2KImagePlugin.py                  |  5 ++---
 src/PIL/JpegImagePlugin.py                    | 20 +++++++++----------
 src/PIL/McIdasImagePlugin.py                  |  2 +-
 src/PIL/MicImagePlugin.py                     |  2 +-
 src/PIL/MpegImagePlugin.py                    |  2 +-
 src/PIL/MspImagePlugin.py                     |  4 ++--
 src/PIL/PaletteFile.py                        |  2 +-
 src/PIL/PcdImagePlugin.py                     |  2 +-
 src/PIL/PixarImagePlugin.py                   |  2 +-
 src/PIL/PngImagePlugin.py                     |  2 +-
 src/PIL/PpmImagePlugin.py                     |  2 +-
 src/PIL/PsdImagePlugin.py                     |  2 +-
 src/PIL/QoiImagePlugin.py                     |  2 +-
 src/PIL/TiffImagePlugin.py                    |  4 ++--
 src/PIL/WebPImagePlugin.py                    |  2 +-
 src/PIL/WmfImagePlugin.py                     |  8 +++-----
 src/PIL/XVThumbImagePlugin.py                 |  2 +-
 src/PIL/XbmImagePlugin.py                     |  2 +-
 src/PIL/XpmImagePlugin.py                     |  4 ++--
 43 files changed, 72 insertions(+), 73 deletions(-)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 311085cf790..ab8f2d5a110 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -77,8 +77,8 @@ def test_app(test_file: str) -> None:
     with Image.open(test_file) as im:
         assert im.applist[0][0] == "APP1"
         assert im.applist[1][0] == "APP2"
-        assert (
-            im.applist[1][1][:16] == b"MPF\x00MM\x00*\x00\x00\x00\x08\x00\x03\xb0\x00"
+        assert im.applist[1][1].startswith(
+            b"MPF\x00MM\x00*\x00\x00\x00\x08\x00\x03\xb0\x00"
         )
         assert len(im.applist) == 2
 
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index d9a834c7500..c68a20d7a3f 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -40,7 +40,7 @@ def test_read_exif_metadata() -> None:
 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"
+        assert not im.info["exif"].startswith(b"Exif\x00\x00")
 
         exif = im.getexif()
         assert exif[305] == "Adobe Photoshop CS6 (Macintosh)"
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 4c8aeaa3d85..5474f951cfc 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -74,12 +74,12 @@ def test_exception_inheritance(self) -> None:
 
     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 repr(im).startswith("<PIL.Image.Image image mode=L size=100x100 at")
         assert im.mode == "L"
         assert im.size == (100, 100)
 
         im = Image.new("RGB", (100, 100))
-        assert repr(im)[:45] == "<PIL.Image.Image image mode=RGB size=100x100 "
+        assert repr(im).startswith("<PIL.Image.Image image mode=RGB size=100x100 ")
         assert im.mode == "RGB"
         assert im.size == (100, 100)
 
diff --git a/docs/example/DdsImagePlugin.py b/docs/example/DdsImagePlugin.py
index 10828bff031..e4b6b9c01b6 100644
--- a/docs/example/DdsImagePlugin.py
+++ b/docs/example/DdsImagePlugin.py
@@ -285,7 +285,7 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"DDS "
+    return prefix.startswith(b"DDS ")
 
 
 Image.register_open(DdsImageFile.format, DdsImageFile, _accept)
diff --git a/docs/handbook/writing-your-own-image-plugin.rst b/docs/handbook/writing-your-own-image-plugin.rst
index 2e853224d5a..9e7d14c5716 100644
--- a/docs/handbook/writing-your-own-image-plugin.rst
+++ b/docs/handbook/writing-your-own-image-plugin.rst
@@ -54,7 +54,7 @@ true color.
 
 
     def _accept(prefix: bytes) -> bool:
-        return prefix[:4] == b"SPAM"
+        return prefix.startswith(b"SPAM")
 
 
     class SpamImageFile(ImageFile.ImageFile):
diff --git a/src/PIL/BdfFontFile.py b/src/PIL/BdfFontFile.py
index bfd66aa6a21..f175e2f4f80 100644
--- a/src/PIL/BdfFontFile.py
+++ b/src/PIL/BdfFontFile.py
@@ -43,7 +43,7 @@ def bdf_char(
         s = f.readline()
         if not s:
             return None
-        if s[:9] == b"STARTCHAR":
+        if s.startswith(b"STARTCHAR"):
             break
     id = s[9:].strip().decode("ascii")
 
@@ -51,7 +51,7 @@ def bdf_char(
     props = {}
     while True:
         s = f.readline()
-        if not s or s[:6] == b"BITMAP":
+        if not s or s.startswith(b"BITMAP"):
             break
         i = s.find(b" ")
         props[s[:i].decode("ascii")] = s[i + 1 : -1].decode("ascii")
@@ -60,7 +60,7 @@ def bdf_char(
     bitmap = bytearray()
     while True:
         s = f.readline()
-        if not s or s[:7] == b"ENDCHAR":
+        if not s or s.startswith(b"ENDCHAR"):
             break
         bitmap += s[:-1]
 
@@ -96,7 +96,7 @@ def __init__(self, fp: BinaryIO) -> None:
         super().__init__()
 
         s = fp.readline()
-        if s[:13] != b"STARTFONT 2.1":
+        if not s.startswith(b"STARTFONT 2.1"):
             msg = "not a valid BDF file"
             raise SyntaxError(msg)
 
@@ -105,7 +105,7 @@ def __init__(self, fp: BinaryIO) -> None:
 
         while True:
             s = fp.readline()
-            if not s or s[:13] == b"ENDPROPERTIES":
+            if not s or s.startswith(b"ENDPROPERTIES"):
                 break
             i = s.find(b" ")
             props[s[:i].decode("ascii")] = s[i + 1 : -1].decode("ascii")
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 8585a8e60fd..5747c125275 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -246,7 +246,7 @@ class BLPFormatError(NotImplementedError):
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] in (b"BLP1", b"BLP2")
+    return prefix.startswith((b"BLP1", b"BLP2"))
 
 
 class BlpImageFile(ImageFile.ImageFile):
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index bf8f29577ae..d60ea591ab9 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -50,7 +50,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:2] == b"BM"
+    return prefix.startswith(b"BM")
 
 
 def _dib_accept(prefix: bytes) -> bool:
diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 50c41c48292..8c5da14f5f6 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -33,7 +33,7 @@ def register_handler(handler: ImageFile.StubHandler | None) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"BUFR" or prefix[:4] == b"ZCZC"
+    return prefix.startswith((b"BUFR", b"ZCZC"))
 
 
 class BufrStubImageFile(ImageFile.StubImageFile):
diff --git a/src/PIL/CurImagePlugin.py b/src/PIL/CurImagePlugin.py
index c4be0cecaf8..b817dbc87b8 100644
--- a/src/PIL/CurImagePlugin.py
+++ b/src/PIL/CurImagePlugin.py
@@ -26,7 +26,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"\0\0\2\0"
+    return prefix.startswith(b"\0\0\2\0")
 
 
 ##
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 9349e284178..cdae8dfee23 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -564,7 +564,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"DDS "
+    return prefix.startswith(b"DDS ")
 
 
 Image.register_open(DdsImageFile.format, DdsImageFile, _accept)
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 36ba15ec50f..5e2ddad99e9 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -170,7 +170,9 @@ def Ghostscript(
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"%!PS" or (len(prefix) >= 4 and i32(prefix) == 0xC6D3D0C5)
+    return prefix.startswith(b"%!PS") or (
+        len(prefix) >= 4 and i32(prefix) == 0xC6D3D0C5
+    )
 
 
 ##
@@ -295,7 +297,7 @@ def read_comment(s: str) -> bool:
                     m = field.match(s)
                     if m:
                         k = m.group(1)
-                        if k[:8] == "PS-Adobe":
+                        if k.startswith("PS-Adobe"):
                             self.info["PS-Adobe"] = k[9:]
                         else:
                             self.info[k] = ""
diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index 6bbd2641aba..a3fdc0efeec 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -17,7 +17,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:6] == b"SIMPLE"
+    return prefix.startswith(b"SIMPLE")
 
 
 class FitsImageFile(ImageFile.ImageFile):
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 4cfcb067d03..fd992cd9e20 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -42,7 +42,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:8] == olefile.MAGIC
+    return prefix.startswith(olefile.MAGIC)
 
 
 ##
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index 0516b760c61..26e5bd4a655 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -108,7 +108,7 @@ def load_seek(self, pos: int) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == MAGIC
+    return prefix.startswith(MAGIC)
 
 
 Image.register_open(FtexImageFile.format, FtexImageFile, _accept)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index ff7262efc09..259e93f0933 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -67,7 +67,7 @@ class LoadingStrategy(IntEnum):
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:6] in [b"GIF87a", b"GIF89a"]
+    return prefix.startswith((b"GIF87a", b"GIF89a"))
 
 
 ##
@@ -257,7 +257,7 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
                     # application extension
                     #
                     info["extension"] = block, self.fp.tell()
-                    if block[:11] == b"NETSCAPE2.0":
+                    if block.startswith(b"NETSCAPE2.0"):
                         block = self.data()
                         if block and len(block) >= 3 and block[0] == 1:
                             self.info["loop"] = i16(block, 1)
diff --git a/src/PIL/GimpGradientFile.py b/src/PIL/GimpGradientFile.py
index 220eac57e38..ec62f8e4ebc 100644
--- a/src/PIL/GimpGradientFile.py
+++ b/src/PIL/GimpGradientFile.py
@@ -116,7 +116,7 @@ class GimpGradientFile(GradientFile):
     """File handler for GIMP's gradient format."""
 
     def __init__(self, fp: IO[bytes]) -> None:
-        if fp.readline()[:13] != b"GIMP Gradient":
+        if not fp.readline().startswith(b"GIMP Gradient"):
             msg = "not a GIMP gradient file"
             raise SyntaxError(msg)
 
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index 4cad0ebeea1..1b7a394c01d 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -29,7 +29,7 @@ class GimpPaletteFile:
     def __init__(self, fp: IO[bytes]) -> None:
         palette = [o8(i) * 3 for i in range(256)]
 
-        if fp.readline()[:12] != b"GIMP Palette":
+        if not fp.readline().startswith(b"GIMP Palette"):
             msg = "not a GIMP palette file"
             raise SyntaxError(msg)
 
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index eb1b1483b73..439fc5a3eda 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -33,7 +33,7 @@ def register_handler(handler: ImageFile.StubHandler | None) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"GRIB" and prefix[7] == 1
+    return prefix.startswith(b"GRIB") and prefix[7] == 1
 
 
 class GribStubImageFile(ImageFile.StubImageFile):
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index ddc21850863..76e640f15ab 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -33,7 +33,7 @@ def register_handler(handler: ImageFile.StubHandler | None) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:8] == b"\x89HDF\r\n\x1a\n"
+    return prefix.startswith(b"\x89HDF\r\n\x1a\n")
 
 
 class HDF5StubImageFile(ImageFile.StubImageFile):
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 9757b2b142d..a5d5b93aeac 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -117,14 +117,14 @@ def read_png_or_jpeg2000(
     sig = fobj.read(12)
 
     im: Image.Image
-    if sig[:8] == b"\x89PNG\x0d\x0a\x1a\x0a":
+    if sig.startswith(b"\x89PNG\x0d\x0a\x1a\x0a"):
         fobj.seek(start)
         im = PngImagePlugin.PngImageFile(fobj)
         Image._decompression_bomb_check(im.size)
         return {"RGBA": im}
     elif (
-        sig[:4] == b"\xff\x4f\xff\x51"
-        or sig[:4] == b"\x0d\x0a\x87\x0a"
+        sig.startswith(b"\xff\x4f\xff\x51")
+        or sig.startswith(b"\x0d\x0a\x87\x0a")
         or sig == b"\x00\x00\x00\x0cjP  \x0d\x0a\x87\x0a"
     ):
         if not enable_jpeg2k:
@@ -387,7 +387,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == MAGIC
+    return prefix.startswith(MAGIC)
 
 
 Image.register_open(IcnsImageFile.format, IcnsImageFile, _accept)
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index e879f180154..55c57f203ab 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -118,7 +118,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == _MAGIC
+    return prefix.startswith(_MAGIC)
 
 
 class IconHeader(NamedTuple):
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 2a26d0b29b4..270a294679e 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -209,7 +209,7 @@ def _open(self) -> None:
         self._mode = self.info[MODE]
 
         # Skip forward to start of image data
-        while s and s[:1] != b"\x1a":
+        while s and not s.startswith(b"\x1a"):
             s = self.fp.read(1)
         if not s:
             msg = "File truncated"
@@ -247,7 +247,7 @@ def _open(self) -> None:
 
         self._fp = self.fp  # FIXME: hack
 
-        if self.rawmode[:2] == "F;":
+        if self.rawmode.startswith("F;"):
             # ifunc95 formats
             try:
                 # use bit decoder (if necessary)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index a5243549fa7..6a2aa3e4cd1 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3998,7 +3998,7 @@ def get_ifd(self, tag: int) -> dict[int, Any]:
                 if tag == ExifTags.IFD.MakerNote:
                     from .TiffImagePlugin import ImageFileDirectory_v2
 
-                    if tag_data[:8] == b"FUJIFILM":
+                    if tag_data.startswith(b"FUJIFILM"):
                         ifd_offset = i32le(tag_data, 8)
                         ifd_data = tag_data[ifd_offset:]
 
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 67828358d37..e0f4ecae595 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -352,9 +352,8 @@ def load(self) -> Image.core.PixelAccess | None:
 
 
 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"
+    return prefix.startswith(
+        (b"\xff\x4f\xff\x51", b"\x00\x00\x00\x0cjP  \x0d\x0a\x87\x0a")
     )
 
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index a1c9c443ad5..3e882403b49 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -77,7 +77,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
     self.app[app] = s  # compatibility
     self.applist.append((app, s))
 
-    if marker == 0xFFE0 and s[:4] == b"JFIF":
+    if marker == 0xFFE0 and s.startswith(b"JFIF"):
         # extract JFIF information
         self.info["jfif"] = version = i16(s, 5)  # version
         self.info["jfif_version"] = divmod(version, 256)
@@ -95,19 +95,19 @@ def APP(self: JpegImageFile, marker: int) -> None:
                 self.info["dpi"] = tuple(d * 2.54 for d in jfif_density)
             self.info["jfif_unit"] = jfif_unit
             self.info["jfif_density"] = jfif_density
-    elif marker == 0xFFE1 and s[:6] == b"Exif\0\0":
+    elif marker == 0xFFE1 and s.startswith(b"Exif\0\0"):
         # extract EXIF information
         if "exif" in self.info:
             self.info["exif"] += s[6:]
         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":
+    elif marker == 0xFFE1 and s.startswith(b"http://ns.adobe.com/xap/1.0/\x00"):
         self.info["xmp"] = s.split(b"\x00", 1)[1]
-    elif marker == 0xFFE2 and s[:5] == b"FPXR\0":
+    elif marker == 0xFFE2 and s.startswith(b"FPXR\0"):
         # extract FlashPix information (incomplete)
         self.info["flashpix"] = s  # FIXME: value will change
-    elif marker == 0xFFE2 and s[:12] == b"ICC_PROFILE\0":
+    elif marker == 0xFFE2 and s.startswith(b"ICC_PROFILE\0"):
         # Since an ICC profile can be larger than the maximum size of
         # a JPEG marker (64K), we need provisions to split it into
         # multiple markers. The format defined by the ICC specifies
@@ -120,7 +120,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
         # reassemble the profile, rather than assuming that the APP2
         # markers appear in the correct sequence.
         self.icclist.append(s)
-    elif marker == 0xFFED and s[:14] == b"Photoshop 3.0\x00":
+    elif marker == 0xFFED and s.startswith(b"Photoshop 3.0\x00"):
         # parse the image resource block
         offset = 14
         photoshop = self.info.setdefault("photoshop", {})
@@ -153,7 +153,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
             except struct.error:
                 break  # insufficient data
 
-    elif marker == 0xFFEE and s[:5] == b"Adobe":
+    elif marker == 0xFFEE and s.startswith(b"Adobe"):
         self.info["adobe"] = i16(s, 5)
         # extract Adobe custom properties
         try:
@@ -162,7 +162,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
             pass
         else:
             self.info["adobe_transform"] = adobe_transform
-    elif marker == 0xFFE2 and s[:4] == b"MPF\0":
+    elif marker == 0xFFE2 and s.startswith(b"MPF\0"):
         # extract MPO information
         self.info["mp"] = s[4:]
         # offset is current location minus buffer size
@@ -325,7 +325,7 @@ def DQT(self: JpegImageFile, marker: int) -> None:
 
 def _accept(prefix: bytes) -> bool:
     # Magic number was taken from https://en.wikipedia.org/wiki/JPEG
-    return prefix[:3] == b"\xff\xd8\xff"
+    return prefix.startswith(b"\xff\xd8\xff")
 
 
 ##
@@ -547,7 +547,7 @@ def _getmp(self: JpegImageFile) -> dict[int, Any] | None:
         return None
     file_contents = io.BytesIO(data)
     head = file_contents.read(8)
-    endianness = ">" if head[:4] == b"\x4d\x4d\x00\x2a" else "<"
+    endianness = ">" if head.startswith(b"\x4d\x4d\x00\x2a") else "<"
     # process dictionary
     from . import TiffImagePlugin
 
diff --git a/src/PIL/McIdasImagePlugin.py b/src/PIL/McIdasImagePlugin.py
index 5dd031be369..b4460a9a51f 100644
--- a/src/PIL/McIdasImagePlugin.py
+++ b/src/PIL/McIdasImagePlugin.py
@@ -23,7 +23,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:8] == b"\x00\x00\x00\x00\x00\x00\x00\x04"
+    return prefix.startswith(b"\x00\x00\x00\x00\x00\x00\x00\x04")
 
 
 ##
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index 5f23a34b99c..eb10a4c8259 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -26,7 +26,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:8] == olefile.MAGIC
+    return prefix.startswith(olefile.MAGIC)
 
 
 ##
diff --git a/src/PIL/MpegImagePlugin.py b/src/PIL/MpegImagePlugin.py
index ad4d3e93768..5aa00d05ba6 100644
--- a/src/PIL/MpegImagePlugin.py
+++ b/src/PIL/MpegImagePlugin.py
@@ -54,7 +54,7 @@ def read(self, bits: int) -> int:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"\x00\x00\x01\xb3"
+    return prefix.startswith(b"\x00\x00\x01\xb3")
 
 
 ##
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index ef6ae87f8c0..277087a8677 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -37,7 +37,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] in [b"DanM", b"LinS"]
+    return prefix.startswith((b"DanM", b"LinS"))
 
 
 ##
@@ -69,7 +69,7 @@ def _open(self) -> None:
         self._mode = "1"
         self._size = i16(s, 4), i16(s, 6)
 
-        if s[:4] == b"DanM":
+        if s.startswith(b"DanM"):
             self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 32, "1")]
         else:
             self.tile = [ImageFile._Tile("MSP", (0, 0) + self.size, 32)]
diff --git a/src/PIL/PaletteFile.py b/src/PIL/PaletteFile.py
index 81652e5eec2..2a26e5d4e22 100644
--- a/src/PIL/PaletteFile.py
+++ b/src/PIL/PaletteFile.py
@@ -32,7 +32,7 @@ def __init__(self, fp: IO[bytes]) -> None:
 
             if not s:
                 break
-            if s[:1] == b"#":
+            if s.startswith(b"#"):
                 continue
             if len(s) > 100:
                 msg = "bad palette file"
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index ac40383f972..3aa249988c8 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -34,7 +34,7 @@ def _open(self) -> None:
         self.fp.seek(2048)
         s = self.fp.read(2048)
 
-        if s[:4] != b"PCD_":
+        if not s.startswith(b"PCD_"):
             msg = "not a PCD file"
             raise SyntaxError(msg)
 
diff --git a/src/PIL/PixarImagePlugin.py b/src/PIL/PixarImagePlugin.py
index 5c465bbdc5c..d2b6d0a97e4 100644
--- a/src/PIL/PixarImagePlugin.py
+++ b/src/PIL/PixarImagePlugin.py
@@ -28,7 +28,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"\200\350\000\000"
+    return prefix.startswith(b"\200\350\000\000")
 
 
 ##
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 5ea87686ddc..4fc6217e1ed 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -740,7 +740,7 @@ def chunk_fdAT(self, pos: int, length: int) -> bytes:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:8] == _MAGIC
+    return prefix.startswith(_MAGIC)
 
 
 ##
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index fb228f572d3..03afa2d2ef2 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -47,7 +47,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[0:1] == b"P" and prefix[1] in b"0123456fy"
+    return prefix.startswith(b"P") and prefix[1] in b"0123456fy"
 
 
 ##
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index 8ff5e39088a..c59d302e519 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -47,7 +47,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"8BPS"
+    return prefix.startswith(b"8BPS")
 
 
 ##
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index 01cc868b216..df552243e37 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -14,7 +14,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] == b"qoif"
+    return prefix.startswith(b"qoif")
 
 
 class QoiImageFile(ImageFile.ImageFile):
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index f557d104b2b..0454038e8ab 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -288,7 +288,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:4] in PREFIXES
+    return prefix.startswith(tuple(PREFIXES))
 
 
 def _limit_rational(
@@ -1280,7 +1280,7 @@ def get_photoshop_blocks(self) -> dict[int, dict[str, bytes]]:
         blocks = {}
         val = self.tag_v2.get(ExifTags.Base.ImageResources)
         if val:
-            while val[:4] == b"8BIM":
+            while val.startswith(b"8BIM"):
                 id = i16(val[4:6])
                 n = math.ceil((val[6] + 1) / 2) * 2
                 size = i32(val[6 + n : 10 + n])
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index cbbc24af008..c2dde4431e7 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -21,7 +21,7 @@
 
 
 def _accept(prefix: bytes) -> bool | str:
-    is_riff_file_format = prefix[:4] == b"RIFF"
+    is_riff_file_format = prefix.startswith(b"RIFF")
     is_webp_file = prefix[8:12] == b"WEBP"
     is_valid_vp8_mode = prefix[12:16] in _VP8_MODES_BY_IDENTIFIER
 
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 48e9823e8ad..04abd52f0b1 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -68,9 +68,7 @@ def load(self, im: ImageFile.StubImageFile) -> Image.Image:
 
 
 def _accept(prefix: bytes) -> bool:
-    return (
-        prefix[:6] == b"\xd7\xcd\xc6\x9a\x00\x00" or prefix[:4] == b"\x01\x00\x00\x00"
-    )
+    return prefix.startswith((b"\xd7\xcd\xc6\x9a\x00\x00", b"\x01\x00\x00\x00"))
 
 
 ##
@@ -87,7 +85,7 @@ def _open(self) -> None:
         # check placable header
         s = self.fp.read(80)
 
-        if s[:6] == b"\xd7\xcd\xc6\x9a\x00\x00":
+        if s.startswith(b"\xd7\xcd\xc6\x9a\x00\x00"):
             # placeable windows metafile
 
             # get units per inch
@@ -116,7 +114,7 @@ def _open(self) -> None:
                 msg = "Unsupported WMF file format"
                 raise SyntaxError(msg)
 
-        elif s[:4] == b"\x01\x00\x00\x00" and s[40:44] == b" EMF":
+        elif s.startswith(b"\x01\x00\x00\x00") and s[40:44] == b" EMF":
             # enhanced metafile
 
             # get bounding box
diff --git a/src/PIL/XVThumbImagePlugin.py b/src/PIL/XVThumbImagePlugin.py
index 75333354db2..cde28388ff0 100644
--- a/src/PIL/XVThumbImagePlugin.py
+++ b/src/PIL/XVThumbImagePlugin.py
@@ -34,7 +34,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:6] == _MAGIC
+    return prefix.startswith(_MAGIC)
 
 
 ##
diff --git a/src/PIL/XbmImagePlugin.py b/src/PIL/XbmImagePlugin.py
index 943a0447016..1e57aa162ea 100644
--- a/src/PIL/XbmImagePlugin.py
+++ b/src/PIL/XbmImagePlugin.py
@@ -38,7 +38,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix.lstrip()[:7] == b"#define"
+    return prefix.lstrip().startswith(b"#define")
 
 
 ##
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index b985aa5dcd6..328f88223e1 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -25,7 +25,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[:9] == b"/* XPM */"
+    return prefix.startswith(b"/* XPM */")
 
 
 ##
@@ -81,7 +81,7 @@ def _open(self) -> None:
                     rgb = s[i + 1]
                     if rgb == b"None":
                         self.info["transparency"] = c
-                    elif rgb[:1] == b"#":
+                    elif rgb.startswith(b"#"):
                         # FIXME: handle colour names (see ImagePalette.py)
                         rgb = int(rgb[1:], 16)
                         palette[c] = (

From 9665eb39726b000bf59c0c5e61793fcbb3c6ecd0 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 15 Feb 2025 19:38:03 +0200
Subject: [PATCH 1493/2374] Replace slice and comparison with endswith

---
 src/PIL/ImImagePlugin.py  | 4 ++--
 src/PIL/MicImagePlugin.py | 2 +-
 src/PIL/XpmImagePlugin.py | 4 ++--
 3 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 270a294679e..9f20b30f8e7 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -155,9 +155,9 @@ def _open(self) -> None:
                 msg = "not an IM file"
                 raise SyntaxError(msg)
 
-            if s[-2:] == b"\r\n":
+            if s.endswith(b"\r\n"):
                 s = s[:-2]
-            elif s[-1:] == b"\n":
+            elif s.endswith(b"\n"):
                 s = s[:-1]
 
             try:
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index eb10a4c8259..bbddd972ee0 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -54,7 +54,7 @@ def _open(self) -> None:
         self.images = [
             path
             for path in self.ole.listdir()
-            if path[1:] and path[0][-4:] == ".ACI" and path[1] == "Image"
+            if path[1:] and path[0].endswith(".ACI") and path[1] == "Image"
         ]
 
         # if we didn't find any images, this is probably not
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index 328f88223e1..3c932c41b84 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -67,9 +67,9 @@ def _open(self) -> None:
 
         for _ in range(pal):
             s = self.fp.readline()
-            if s[-2:] == b"\r\n":
+            if s.endswith(b"\r\n"):
                 s = s[:-2]
-            elif s[-1:] in b"\r\n":
+            elif s.endswith((b"\r", b"\n")):
                 s = s[:-1]
 
             c = s[1]

From 4b7e75be2d9305ffa25e113740aa08ff5d4fed74 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 18 Feb 2025 20:47:17 +1100
Subject: [PATCH 1494/2374] Test errors

---
 Tests/test_file_sun.py | 41 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_sun.py b/Tests/test_file_sun.py
index 6cfff87309c..ebb0693793c 100644
--- a/Tests/test_file_sun.py
+++ b/Tests/test_file_sun.py
@@ -1,10 +1,11 @@
 from __future__ import annotations
 
+import io
 import os
 
 import pytest
 
-from PIL import Image, SunImagePlugin
+from PIL import Image, SunImagePlugin, _binary
 
 from .helper import assert_image_equal_tofile, assert_image_similar, hopper
 
@@ -33,6 +34,44 @@ def test_im1() -> None:
         assert_image_equal_tofile(im, "Tests/images/sunraster.im1.png")
 
 
+def _sun_header(
+    depth: int = 0, file_type: int = 0, palette_length: int = 0
+) -> io.BytesIO:
+    return io.BytesIO(
+        _binary.o32be(0x59A66A95)
+        + b"\x00" * 8
+        + _binary.o32be(depth)
+        + b"\x00" * 4
+        + _binary.o32be(file_type)
+        + b"\x00" * 4
+        + _binary.o32be(palette_length)
+    )
+
+
+def test_unsupported_mode_bit_depth() -> None:
+    with pytest.raises(SyntaxError, match="Unsupported Mode/Bit Depth"):
+        with SunImagePlugin.SunImageFile(_sun_header()):
+            pass
+
+
+def test_unsupported_color_palette_length() -> None:
+    with pytest.raises(SyntaxError, match="Unsupported Color Palette Length"):
+        with SunImagePlugin.SunImageFile(_sun_header(depth=1, palette_length=1025)):
+            pass
+
+
+def test_unsupported_palette_type() -> None:
+    with pytest.raises(SyntaxError, match="Unsupported Palette Type"):
+        with SunImagePlugin.SunImageFile(_sun_header(depth=1, palette_length=1)):
+            pass
+
+
+def test_unsupported_file_type() -> None:
+    with pytest.raises(SyntaxError, match="Unsupported Sun Raster file type"):
+        with SunImagePlugin.SunImageFile(_sun_header(depth=1, file_type=6)):
+            pass
+
+
 @pytest.mark.skipif(
     not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
 )

From 5d40e6aead98fd7154c889b027c79f3e15c06661 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 18 Feb 2025 20:29:35 +1100
Subject: [PATCH 1495/2374] Test RGBX raw mode

---
 Tests/test_file_sun.py | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/Tests/test_file_sun.py b/Tests/test_file_sun.py
index ebb0693793c..c2f162cf9b4 100644
--- a/Tests/test_file_sun.py
+++ b/Tests/test_file_sun.py
@@ -72,6 +72,22 @@ def test_unsupported_file_type() -> None:
             pass
 
 
+@pytest.mark.skipif(
+    not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
+)
+def test_rgbx() -> None:
+    with open(os.path.join(EXTRA_DIR, "32bpp.ras"), "rb") as fp:
+        data = fp.read()
+
+    # Set file type to 3
+    data = data[:20] + _binary.o32be(3) + data[24:]
+
+    with Image.open(io.BytesIO(data)) as im:
+        r, g, b = im.split()
+        im = Image.merge("RGB", (b, g, r))
+        assert_image_equal_tofile(im, os.path.join(EXTRA_DIR, "32bpp.png"))
+
+
 @pytest.mark.skipif(
     not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
 )

From b096018fdd5c6c36211023fd372c16a66b7a52f3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 18 Feb 2025 22:27:13 +1100
Subject: [PATCH 1496/2374] Update Sphinx to 8.2 to remove nitpick ignore

---
 docs/conf.py   | 4 ++--
 pyproject.toml | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index e1e3f1b8f8a..bfbcf91516f 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 = "8.1"
+needs_sphinx = "8.2"
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
@@ -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 = [("py:class", "_io.BytesIO"), ("py:class", "_CmsProfileCompatible")]
+nitpick_ignore = [("py:class", "_CmsProfileCompatible")]
 
 
 # -- Options for HTML output ----------------------------------------------
diff --git a/pyproject.toml b/pyproject.toml
index aaaba0032e7..2ffd9faca97 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -43,7 +43,7 @@ dynamic = [
 optional-dependencies.docs = [
   "furo",
   "olefile",
-  "sphinx>=8.1",
+  "sphinx>=8.2",
   "sphinx-copybutton",
   "sphinx-inline-tabs",
   "sphinxext-opengraph",

From 4415b4ad3631a96fb70610ba6672e5c14dcfa174 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 19 Feb 2025 08:47:04 +1100
Subject: [PATCH 1497/2374] Updated libpng to 1.6.47

---
 .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 f0c96d16098..0f8eac5bb51 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -39,7 +39,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=10.2.0
-LIBPNG_VERSION=1.6.46
+LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.4
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index f942716cb0b..5665abaab21 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ def cmd_msbuild(
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
     "LIBIMAGEQUANT": "4.3.4",
-    "LIBPNG": "1.6.46",
+    "LIBPNG": "1.6.47",
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.6.0",

From dc94d1d8bba208cf7f24e207a3536ac6eaf22fa9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 19 Feb 2025 18:27:05 +1100
Subject: [PATCH 1498/2374] Test opening file with plugin directly

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

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index ab8f2d5a110..6b4f6423bd1 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -29,12 +29,17 @@ def roundtrip(im: Image.Image, **options: Any) -> ImageFile.ImageFile:
 
 @pytest.mark.parametrize("test_file", test_files)
 def test_sanity(test_file: str) -> None:
-    with Image.open(test_file) as im:
+    def check(im: ImageFile.ImageFile) -> None:
         im.load()
         assert im.mode == "RGB"
         assert im.size == (640, 480)
         assert im.format == "MPO"
 
+    with Image.open(test_file) as im:
+        check(im)
+    with MpoImagePlugin.MpoImageFile(test_file) as im:
+        check(im)
+
 
 @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
 def test_unclosed_file() -> None:

From ae6bb4cac2f666715666a05b46fa43942ef19201 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 19 Feb 2025 23:28:25 +1100
Subject: [PATCH 1499/2374] Test invalid texture compression format

---
 Tests/test_file_ftex.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/Tests/test_file_ftex.py b/Tests/test_file_ftex.py
index 0c544245a9f..fdd7b375762 100644
--- a/Tests/test_file_ftex.py
+++ b/Tests/test_file_ftex.py
@@ -1,5 +1,8 @@
 from __future__ import annotations
 
+import io
+import struct
+
 import pytest
 
 from PIL import FtexImagePlugin, Image
@@ -23,3 +26,15 @@ def test_invalid_file() -> None:
 
     with pytest.raises(SyntaxError):
         FtexImagePlugin.FtexImageFile(invalid_file)
+
+
+def test_invalid_texture() -> None:
+    with open("Tests/images/ftex_dxt1.ftc", "rb") as fp:
+        data = fp.read()
+
+    # Change texture compression format
+    data = data[:24] + struct.pack("<i", 2) + data[28:]
+
+    with pytest.raises(ValueError, match="Invalid texture compression format: 2"):
+        with Image.open(io.BytesIO(data)):
+            pass

From ddb238c70d7305847a70f95b94974fdff58e47e7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 20 Feb 2025 07:57:10 +1100
Subject: [PATCH 1500/2374] Only set mode when necessary

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

diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index 26e5bd4a655..d60e75bb60b 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -79,8 +79,6 @@ def _open(self) -> None:
         self._size = struct.unpack("<2i", self.fp.read(8))
         mipmap_count, format_count = struct.unpack("<2i", self.fp.read(8))
 
-        self._mode = "RGB"
-
         # Only support single-format files.
         # I don't know of any multi-format file.
         assert format_count == 1
@@ -95,6 +93,7 @@ def _open(self) -> None:
             self._mode = "RGBA"
             self.tile = [ImageFile._Tile("bcn", (0, 0) + self.size, 0, (1,))]
         elif format == Format.UNCOMPRESSED:
+            self._mode = "RGB"
             self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 0, "RGB")]
         else:
             msg = f"Invalid texture compression format: {repr(format)}"

From ae7c4920c9fba33b93c8938d07a9c16495dd6d69 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 22 Feb 2025 08:09:44 +1100
Subject: [PATCH 1501/2374] Test that subsequent compile() calls do not change
 anything

---
 Tests/test_fontfile.py | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/Tests/test_fontfile.py b/Tests/test_fontfile.py
index 206499a047f..575dada86cb 100644
--- a/Tests/test_fontfile.py
+++ b/Tests/test_fontfile.py
@@ -4,7 +4,20 @@
 
 import pytest
 
-from PIL import FontFile
+from PIL import FontFile, Image
+
+
+def test_compile() -> None:
+    font = FontFile.FontFile()
+    font.glyph[0] = ((0, 0), (0, 0, 0, 0), (0, 0, 0, 1), Image.new("L", (0, 0)))
+    font.compile()
+    assert font.ysize == 1
+
+    font.ysize = 2
+    font.compile()
+
+    # Assert that compiling again did not change anything
+    assert font.ysize == 2
 
 
 def test_save(tmp_path: Path) -> None:

From 85f439f575a1ae5e3e11262e9b0a6d838f541aa6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Feb 2025 18:46:22 +1100
Subject: [PATCH 1502/2374] _seek_check already raises an EOFError

---
 src/PIL/MicImagePlugin.py |  7 +------
 src/PIL/PsdImagePlugin.py | 14 +++++---------
 2 files changed, 6 insertions(+), 15 deletions(-)

diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index bbddd972ee0..9ce38c427b6 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -73,12 +73,7 @@ def _open(self) -> None:
     def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
-        try:
-            filename = self.images[frame]
-        except IndexError as e:
-            msg = "no such frame"
-            raise EOFError(msg) from e
-
+        filename = self.images[frame]
         self.fp = self.ole.openstream(filename)
 
         TiffImagePlugin.TiffImageFile._open(self)
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index c59d302e519..0aada8a065e 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -169,15 +169,11 @@ def seek(self, layer: int) -> None:
             return
 
         # seek to given layer (1..max)
-        try:
-            _, mode, _, tile = self.layers[layer - 1]
-            self._mode = mode
-            self.tile = tile
-            self.frame = layer
-            self.fp = self._fp
-        except IndexError as e:
-            msg = "no such layer"
-            raise EOFError(msg) from e
+        _, mode, _, tile = self.layers[layer - 1]
+        self._mode = mode
+        self.tile = tile
+        self.frame = layer
+        self.fp = self._fp
 
     def tell(self) -> int:
         # return layer number (0=image, 1..max=layers)

From 153fd4801c2344a41260fe8b4b83bd491e51f535 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 27 Feb 2025 22:24:48 +1100
Subject: [PATCH 1503/2374] Revert "Do not install libimagequant"

This reverts commit 1e115987afbc92aef02b489ed8fea1875821d174.
---
 .github/workflows/test-mingw.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index 0459264829f..bb6d7dc373e 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -60,6 +60,7 @@ jobs:
               mingw-w64-x86_64-gcc \
               mingw-w64-x86_64-ghostscript \
               mingw-w64-x86_64-lcms2 \
+              mingw-w64-x86_64-libimagequant \
               mingw-w64-x86_64-libjpeg-turbo \
               mingw-w64-x86_64-libraqm \
               mingw-w64-x86_64-libtiff \

From 3407f765cc81f5be9046fe51c36f7cf1dec6790b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 28 Feb 2025 10:28:48 +1100
Subject: [PATCH 1504/2374] Document using encoderinfo on subsequent frames
 from #8483

---
 src/PIL/Image.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 6a2aa3e4cd1..d5bfda40e28 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2475,7 +2475,21 @@ def save(
            format to use is determined from the filename extension.
            If a file object was used instead of a filename, this
            parameter should always be used.
-        :param params: Extra parameters to the image writer.
+        :param params: Extra parameters to the image writer. These can also be
+           set on the image itself through ``encoderinfo``. This is useful when
+           saving multiple images::
+
+             # Saving XMP data to a single image
+             from PIL import Image
+             red = Image.new("RGB", (1, 1), "#f00")
+             red.save("out.mpo", xmp=b"test")
+
+             # Saving XMP data to the second frame of an image
+             from PIL import Image
+             black = Image.new("RGB", (1, 1))
+             red = Image.new("RGB", (1, 1), "#f00")
+             red.encoderinfo = {"xmp": b"test"}
+             black.save("out.mpo", save_all=True, append_images=[red])
         :returns: None
         :exception ValueError: If the output format could not be determined
            from the file name.  Use the format option to solve this.

From 5c93145061953d8633397bb79ace396ab1e71eb5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 28 Feb 2025 22:16:52 +1100
Subject: [PATCH 1505/2374] Allow encoderconfig and encoderinfo to be set for
 appended TIFF images

---
 Tests/test_file_tiff.py              | 12 ++++++++++++
 docs/handbook/image-file-formats.rst |  4 +---
 src/PIL/TiffImagePlugin.py           | 15 ++++++---------
 3 files changed, 19 insertions(+), 12 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index a8a407963c5..dff9616486d 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -661,6 +661,18 @@ def test_rowsperstrip(self, tmp_path: Path) -> None:
             assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.tag_v2[278] == 256
 
+        im = hopper()
+        im2 = Image.new("L", (128, 128))
+        im2.encoderinfo = {"tiffinfo": {278: 256}}
+        im.save(outfile, save_all=True, append_images=[im2])
+
+        with Image.open(outfile) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+            assert im.tag_v2[278] == 128
+
+            im.seek(1)
+            assert im.tag_v2[278] == 256
+
     def test_strip_raw(self) -> None:
         infile = "Tests/images/tiff_strip_raw.tif"
         with Image.open(infile) as im:
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index a915ee4e22e..219a070f35a 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1162,9 +1162,7 @@ The :py:meth:`~PIL.Image.Image.save` method can take the following keyword argum
 
 **append_images**
     A list of images to append as additional frames. Each of the
-    images in the list can be single or multiframe images. Note however, that for
-    correct results, all the appended images should have the same
-    ``encoderinfo`` and ``encoderconfig`` properties.
+    images in the list can be single or multiframe images.
 
     .. versionadded:: 4.2.0
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 0454038e8ab..4e6526be9bf 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2295,9 +2295,7 @@ def fixOffsets(
 
 
 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", []))
+    append_images = list(im.encoderinfo.get("append_images", []))
     if not hasattr(im, "n_frames") and not append_images:
         return _save(im, fp, filename)
 
@@ -2305,12 +2303,11 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     try:
         with AppendingTiffWriter(fp) as tf:
             for ims in [im] + append_images:
-                ims.encoderinfo = encoderinfo
-                ims.encoderconfig = encoderconfig
-                if not hasattr(ims, "n_frames"):
-                    nfr = 1
-                else:
-                    nfr = ims.n_frames
+                if not hasattr(ims, "encoderinfo"):
+                    ims.encoderinfo = {}
+                if not hasattr(ims, "encoderconfig"):
+                    ims.encoderconfig = ()
+                nfr = getattr(ims, "n_frames", 1)
 
                 for idx in range(nfr):
                     ims.seek(idx)

From d6b94421d0eff83249adf0c4191d3b3eda2b5b90 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Mar 2025 11:37:49 +1100
Subject: [PATCH 1506/2374] Updated harfbuzz to 10.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 f0c96d16098..50b7ad48823 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,7 +38,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=10.2.0
+HARFBUZZ_VERSION=10.4.0
 LIBPNG_VERSION=1.6.46
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index f942716cb0b..c21258cb921 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.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "10.2.0",
+    "HARFBUZZ": "10.4.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.16",
     "LIBIMAGEQUANT": "4.3.4",

From ff4f5d4cb68f6cfe9713dd72ad343e505b57b1f5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Mar 2025 21:41:30 +1100
Subject: [PATCH 1507/2374] Test ValueError

---
 Tests/test_font_bdf.py | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/Tests/test_font_bdf.py b/Tests/test_font_bdf.py
index 136070f9e7d..8d78019b3b0 100644
--- a/Tests/test_font_bdf.py
+++ b/Tests/test_font_bdf.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+import io
+
 import pytest
 
 from PIL import BdfFontFile, FontFile
@@ -8,13 +10,20 @@
 
 
 def test_sanity() -> None:
-    with open(filename, "rb") as test_file:
-        font = BdfFontFile.BdfFontFile(test_file)
+    with open(filename, "rb") as fp:
+        font = BdfFontFile.BdfFontFile(fp)
 
     assert isinstance(font, FontFile.FontFile)
     assert len([_f for _f in font.glyph if _f]) == 190
 
 
+def test_valueerror() -> None:
+    with open(filename, "rb") as fp:
+        data = fp.read()
+        data = data[:2650] + b"\x00\x00" + data[2652:]
+        BdfFontFile.BdfFontFile(io.BytesIO(data))
+
+
 def test_invalid_file() -> None:
     with open("Tests/images/flower.jpg", "rb") as fp:
         with pytest.raises(SyntaxError):

From 397f8c752b583cd781fa21fe03149c8781035247 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 1 Mar 2025 20:50:23 +0000
Subject: [PATCH 1508/2374] Update dependency cibuildwheel to v2.23.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 833aca23d4a..2fd3eb6ffe9 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.22.0
+cibuildwheel==2.23.0

From db4534a8cf35bd7d3a531f5e19e889c7b7c63c30 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 2 Mar 2025 12:00:26 +0200
Subject: [PATCH 1509/2374] Build PyPy3.11 wheel for macOS 10.15 x86_64

---
 .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 db8e4d58bab..1fe6badae13 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -63,7 +63,7 @@ jobs:
           - name: "macOS 10.15 x86_64"
             os: macos-13
             cibw_arch: x86_64
-            build: "pp310*"
+            build: "pp3*"
             macosx_deployment_target: "10.15"
           - name: "macOS arm64"
             os: macos-latest

From c60682af67a364fe185c3b9eea0477980af07cdd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 2 Mar 2025 22:34:58 +1100
Subject: [PATCH 1510/2374] JPEG comments are from the COM marker

---
 docs/handbook/image-file-formats.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index a915ee4e22e..991cadaa25a 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -454,7 +454,8 @@ The :py:meth:`~PIL.Image.open` method may set the following
     Raw EXIF data from the image.
 
 **comment**
-    A comment about the image.
+    A comment about the image, from the COM marker. This is separate from the
+    UserComment tag that may be stored in the EXIF data.
 
     .. versionadded:: 7.1.0
 

From ebc7a17d86a7789119e1b9c4ea5d186306ed276c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Mar 2025 07:24:13 +1100
Subject: [PATCH 1511/2374] Removed _show

---
 src/PIL/ImageTk.py | 27 +--------------------------
 1 file changed, 1 insertion(+), 26 deletions(-)

diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index bf29fdba54c..e6a9d8eea2a 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -28,7 +28,7 @@
 
 import tkinter
 from io import BytesIO
-from typing import TYPE_CHECKING, Any, cast
+from typing import TYPE_CHECKING, Any
 
 from . import Image, ImageFile
 
@@ -263,28 +263,3 @@ def getimage(photo: PhotoImage) -> Image.Image:
     _pyimagingtkcall("PyImagingPhotoGet", photo, im.getim())
 
     return im
-
-
-def _show(image: Image.Image, title: str | None) -> None:
-    """Helper for the Image.show method."""
-
-    class UI(tkinter.Label):
-        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)
-            if TYPE_CHECKING:
-                image = cast(tkinter._Image, self.image)
-            else:
-                image = self.image
-            super().__init__(master, image=image, bg="black", bd=0)
-
-    if not getattr(tkinter, "_default_root"):
-        msg = "tkinter not initialized"
-        raise OSError(msg)
-    top = tkinter.Toplevel()
-    if title:
-        top.title(title)
-    UI(top, image).pack()

From 92cc9bf9027c4767967264a9622f8cde674e3c02 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Mar 2025 08:46:20 +1100
Subject: [PATCH 1512/2374] Support reading grayscale images with 4 channels

---
 Tests/test_file_jpeg2k.py     | 12 ++++++++++++
 src/libImaging/Jpeg2KDecode.c |  1 +
 2 files changed, 13 insertions(+)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 5748fa5a1c3..01172fdbb8a 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -313,6 +313,18 @@ def test_rgba(ext: str) -> None:
         assert im.mode == "RGBA"
 
 
+def test_grayscale_four_channels() -> None:
+    with open("Tests/images/rgb_trns_ycbc.jp2", "rb") as fp:
+        data = fp.read()
+
+        # Change color space to OPJ_CLRSPC_GRAY
+        data = data[:76] + b"\x11" + data[77:]
+
+        with Image.open(BytesIO(data)) as im:
+            im.load()
+            assert im.mode == "RGBA"
+
+
 @pytest.mark.skipif(
     not os.path.exists(EXTRA_DIR), reason="Extra image files not installed"
 )
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index 4f185b529ac..cc6955ca53d 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -615,6 +615,7 @@ static const struct j2k_decode_unpacker j2k_unpackers[] = {
     {"RGBA", OPJ_CLRSPC_GRAY, 2, 0, j2ku_graya_la},
     {"RGBA", OPJ_CLRSPC_SRGB, 3, 1, j2ku_srgb_rgb},
     {"RGBA", OPJ_CLRSPC_SYCC, 3, 1, j2ku_sycc_rgb},
+    {"RGBA", OPJ_CLRSPC_GRAY, 4, 1, j2ku_srgba_rgba},
     {"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 2d97521aa3a7a5f4ab114354e881e05916fae483 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 3 Mar 2025 02:38:52 +0000
Subject: [PATCH 1513/2374] Update dependency mypy to v1.15.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 10e59b885ef..2e361047891 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.14.1
+mypy==1.15.0
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From d6272297fc6c8e2e796c264b4229e5d20045aa9c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Mar 2025 14:48:00 +1100
Subject: [PATCH 1514/2374] Ignore override

---
 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 0454038e8ab..3d36d1abc43 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -404,7 +404,7 @@ def limit_rational(self, max_denominator: int) -> tuple[IntegralLike, int]:
     def __repr__(self) -> str:
         return str(float(self._val))
 
-    def __hash__(self) -> int:
+    def __hash__(self) -> int:  # type: ignore[override]
         return self._val.__hash__()
 
     def __eq__(self, other: object) -> bool:

From 4161bb1645fc66c9d587aafc53214f797831fa52 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Mar 2025 19:10:55 +1100
Subject: [PATCH 1515/2374] Corrected error when XMP is tuple

---
 Tests/test_imageops.py |  9 +++++++++
 src/PIL/ImageOps.py    | 14 +++++++++-----
 2 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 3621aa50fbb..9f2fd5ba257 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -448,6 +448,15 @@ def check(orientation_im: Image.Image) -> None:
     assert 0x0112 not in transposed_im.getexif()
 
 
+def test_exif_transpose_with_xmp_tuple() -> None:
+    with Image.open("Tests/images/xmp_tags_orientation.png") as im:
+        assert im.getexif()[0x0112] == 3
+
+        im.info["xmp"] = (b"test",)
+        transposed_im = ImageOps.exif_transpose(im)
+        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
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index fef1d7328c2..75dfbee22bf 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -729,11 +729,15 @@ def exif_transpose(image: Image.Image, *, in_place: bool = False) -> Image.Image
                         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 isinstance(value, str):
+                            value = re.sub(pattern, "", value)
+                        elif isinstance(value, tuple):
+                            value = tuple(
+                                re.sub(pattern.encode(), b"", v) for v in value
+                            )
+                        else:
+                            value = re.sub(pattern.encode(), b"", value)
+                        exif_image.info[key] = value
         if not in_place:
             return transposed_image
     elif not in_place:

From 51183c22042303e464d86a26245c272f733f35f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Mar 2025 21:58:29 +1100
Subject: [PATCH 1516/2374] Fixed loading images

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

diff --git a/Tests/test_file_gd.py b/Tests/test_file_gd.py
index d512df284e1..806532c17ec 100644
--- a/Tests/test_file_gd.py
+++ b/Tests/test_file_gd.py
@@ -4,6 +4,8 @@
 
 from PIL import GdImageFile, UnidentifiedImageError
 
+from .helper import assert_image_similar_tofile
+
 TEST_GD_FILE = "Tests/images/hopper.gd"
 
 
@@ -11,6 +13,7 @@ def test_sanity() -> None:
     with GdImageFile.open(TEST_GD_FILE) as im:
         assert im.size == (128, 128)
         assert im.format == "GD"
+        assert_image_similar_tofile(im.convert("RGB"), "Tests/images/hopper.jpg", 14)
 
 
 def test_bad_mode() -> None:
diff --git a/src/PIL/GdImageFile.py b/src/PIL/GdImageFile.py
index fc4801e9d1c..891225ce2fd 100644
--- a/src/PIL/GdImageFile.py
+++ b/src/PIL/GdImageFile.py
@@ -56,7 +56,7 @@ def _open(self) -> None:
             msg = "Not a valid GD 2.x .gd file"
             raise SyntaxError(msg)
 
-        self._mode = "L"  # FIXME: "P"
+        self._mode = "P"
         self._size = i16(s, 2), i16(s, 4)
 
         true_color = s[6]
@@ -68,14 +68,14 @@ def _open(self) -> None:
             self.info["transparency"] = tindex
 
         self.palette = ImagePalette.raw(
-            "XBGR", s[7 + true_color_offset + 4 : 7 + true_color_offset + 4 + 256 * 4]
+            "RGBX", s[7 + true_color_offset + 6 : 7 + true_color_offset + 6 + 256 * 4]
         )
 
         self.tile = [
             ImageFile._Tile(
                 "raw",
                 (0, 0) + self.size,
-                7 + true_color_offset + 4 + 256 * 4,
+                7 + true_color_offset + 6 + 256 * 4,
                 "L",
             )
         ]

From a1a467bda2d79baa70775c6cd0d52ddcc1496ee8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Mar 2025 23:55:19 +1100
Subject: [PATCH 1517/2374] Image.core.outline will no longer raise an
 AttributeError

---
 Tests/test_imagedraw.py | 4 ----
 src/PIL/ImageDraw.py    | 6 +-----
 2 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index d127175ebfb..232cbb16cde 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -448,7 +448,6 @@ 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)
@@ -470,7 +469,6 @@ 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)
@@ -489,7 +487,6 @@ 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))
@@ -1526,7 +1523,6 @@ 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)
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 742b5f58703..c4ebc5931ab 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -42,11 +42,7 @@
 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
+Outline: Callable[[], Image.core._Outline] = Image.core.outline
 
 if TYPE_CHECKING:
     from . import ImageDraw2, ImageFont

From c1703f53307e668a1eef54e78350f22bb5cbe194 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 3 Mar 2025 17:15:48 +0000
Subject: [PATCH 1518/2374] [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.9.4 → v0.9.9](https://github.com/astral-sh/ruff-pre-commit/compare/v0.9.4...v0.9.9)
- [github.com/PyCQA/bandit: 1.8.2 → 1.8.3](https://github.com/PyCQA/bandit/compare/1.8.2...1.8.3)
- [github.com/python-jsonschema/check-jsonschema: 0.31.1 → 0.31.2](https://github.com/python-jsonschema/check-jsonschema/compare/0.31.1...0.31.2)
- [github.com/woodruffw/zizmor-pre-commit: v1.3.0 → v1.4.1](https://github.com/woodruffw/zizmor-pre-commit/compare/v1.3.0...v1.4.1)
- [github.com/tox-dev/pyproject-fmt: v2.5.0 → v2.5.1](https://github.com/tox-dev/pyproject-fmt/compare/v2.5.0...v2.5.1)
---
 .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 a8c8cee152c..5ff947d4111 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.9.4
+    rev: v0.9.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.8.2
+    rev: 1.8.3
     hooks:
     - id: bandit
       args: [--severity-level=high]
@@ -50,14 +50,14 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.31.1
+    rev: 0.31.2
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: v1.3.0
+    rev: v1.4.1
     hooks:
       - id: zizmor
 
@@ -67,7 +67,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.5.0
+    rev: v2.5.1
     hooks:
       - id: pyproject-fmt
 

From 5ce8929ed467712025c82311f0cdfa196224a06a Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 4 Mar 2025 07:48:12 +1100
Subject: [PATCH 1519/2374] Updated test name

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

diff --git a/Tests/test_font_bdf.py b/Tests/test_font_bdf.py
index 8d78019b3b0..2ece5457a2e 100644
--- a/Tests/test_font_bdf.py
+++ b/Tests/test_font_bdf.py
@@ -17,7 +17,7 @@ def test_sanity() -> None:
     assert len([_f for _f in font.glyph if _f]) == 190
 
 
-def test_valueerror() -> None:
+def test_zero_width_chars() -> None:
     with open(filename, "rb") as fp:
         data = fp.read()
         data = data[:2650] + b"\x00\x00" + data[2652:]

From 1f4beb4a5c5724019ea9b0683432cbc3357d10cc Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 3 Mar 2025 23:53:47 +0200
Subject: [PATCH 1520/2374] Lint with flake8-pie

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

diff --git a/pyproject.toml b/pyproject.toml
index 2ffd9faca97..780a938a32c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -121,6 +121,7 @@ lint.select = [
   "ISC",    # flake8-implicit-str-concat
   "LOG",    # flake8-logging
   "PGH",    # pygrep-hooks
+  "PIE",    # flake8-pie
   "PT",     # flake8-pytest-style
   "PYI",    # flake8-pyi
   "RUF100", # unused noqa (yesqa)
@@ -133,6 +134,7 @@ lint.ignore = [
   "E221",   # Multiple spaces before operator
   "E226",   # Missing whitespace around arithmetic operator
   "E241",   # Multiple spaces after ','
+  "PIE790", # flake8-pie: unnecessary-placeholder
   "PT001",  # pytest-fixture-incorrect-parentheses-style
   "PT007",  # pytest-parametrize-values-wrong-type
   "PT011",  # pytest-raises-too-broad

From e4cac21044d6b7bfe958e9f9d0a4c8d150b444e7 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 3 Mar 2025 23:54:22 +0200
Subject: [PATCH 1521/2374] Don't use start=0 in range()

---
 Tests/test_file_gif.py      |  2 +-
 Tests/test_file_webp.py     |  2 +-
 Tests/test_imagedraw.py     |  4 ++--
 Tests/test_imagepalette.py  |  2 +-
 Tests/test_imagesequence.py |  2 +-
 Tests/test_pickle.py        |  8 ++++----
 src/PIL/Image.py            |  6 +++---
 src/PIL/ImageDraw.py        |  4 ++--
 src/PIL/ImageOps.py         | 10 +++++-----
 src/PIL/JpegImagePlugin.py  |  2 +-
 10 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 2254178d562..d2592da971f 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -601,7 +601,7 @@ def test_save_dispose(tmp_path: Path) -> None:
         Image.new("L", (100, 100), "#111"),
         Image.new("L", (100, 100), "#222"),
     ]
-    for method in range(0, 4):
+    for method in range(4):
         im_list[0].save(out, save_all=True, append_images=im_list[1:], disposal=method)
         with Image.open(out) as img:
             for _ in range(2):
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index abe888241b4..6f6074ef2f3 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -231,7 +231,7 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
 
         with Image.open(out_gif) as reread:
             reread_value = reread.convert("RGB").getpixel((1, 1))
-        difference = sum(abs(original_value[i] - reread_value[i]) for i in range(0, 3))
+        difference = sum(abs(original_value[i] - reread_value[i]) for i in range(3))
         assert difference < 5
 
     def test_duration(self, tmp_path: Path) -> None:
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 232cbb16cde..1b4d09f39f0 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1044,8 +1044,8 @@ def create_base_image_draw(
     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]):
+    for x in range(size[0]):
+        for y in range(size[1]):
             if (x + y) % 2 == 0:
                 img.putpixel((x, y), background2)
     return img, ImageDraw.Draw(img)
diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index e0b6359b044..782022f5171 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -112,7 +112,7 @@ def test_make_linear_lut() -> None:
     assert isinstance(lut, list)
     assert len(lut) == 256
     # Check values
-    for i in range(0, len(lut)):
+    for i in range(len(lut)):
         assert lut[i] == i
 
 
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 9b37435eb61..26b287bb4d3 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -32,7 +32,7 @@ def test_sanity(tmp_path: Path) -> None:
 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):
+        for index in range(im.n_frames):
             assert i[index] == next(i)
         with pytest.raises(IndexError):
             i[index + 1]
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index c4f8de013ec..05c41a802c9 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -65,7 +65,7 @@ def helper_pickle_string(protocol: int, test_file: str, mode: str | None) -> Non
         ("Tests/images/itxt_chunks.png", None),
     ],
 )
-@pytest.mark.parametrize("protocol", range(0, pickle.HIGHEST_PROTOCOL + 1))
+@pytest.mark.parametrize("protocol", range(pickle.HIGHEST_PROTOCOL + 1))
 def test_pickle_image(
     tmp_path: Path, test_file: str, test_mode: str | None, protocol: int
 ) -> None:
@@ -92,7 +92,7 @@ def test_pickle_la_mode_with_palette(tmp_path: Path) -> None:
         im = im.convert("PA")
 
     # Act / Assert
-    for protocol in range(0, pickle.HIGHEST_PROTOCOL + 1):
+    for protocol in range(pickle.HIGHEST_PROTOCOL + 1):
         im._mode = "LA"
         with open(filename, "wb") as f:
             pickle.dump(im, f, protocol)
@@ -133,7 +133,7 @@ def helper_assert_pickled_font_images(
 
 
 @skip_unless_feature("freetype2")
-@pytest.mark.parametrize("protocol", list(range(0, pickle.HIGHEST_PROTOCOL + 1)))
+@pytest.mark.parametrize("protocol", list(range(pickle.HIGHEST_PROTOCOL + 1)))
 def test_pickle_font_string(protocol: int) -> None:
     # Arrange
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
@@ -147,7 +147,7 @@ def test_pickle_font_string(protocol: int) -> None:
 
 
 @skip_unless_feature("freetype2")
-@pytest.mark.parametrize("protocol", list(range(0, pickle.HIGHEST_PROTOCOL + 1)))
+@pytest.mark.parametrize("protocol", list(range(pickle.HIGHEST_PROTOCOL + 1)))
 def test_pickle_font_file(tmp_path: Path, protocol: int) -> None:
     # Arrange
     font = ImageFont.truetype(FONT_PATH, FONT_SIZE)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 6a2aa3e4cd1..684c87c4d78 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1001,7 +1001,7 @@ def convert_transparency(
                 elif len(mode) == 3:
                     transparency = tuple(
                         convert_transparency(matrix[i * 4 : i * 4 + 4], transparency)
-                        for i in range(0, len(transparency))
+                        for i in range(len(transparency))
                     )
                 new_im.info["transparency"] = transparency
             return new_im
@@ -4003,7 +4003,7 @@ def get_ifd(self, tag: int) -> dict[int, Any]:
                         ifd_data = tag_data[ifd_offset:]
 
                         makernote = {}
-                        for i in range(0, struct.unpack("<H", ifd_data[:2])[0]):
+                        for i in range(struct.unpack("<H", ifd_data[:2])[0]):
                             ifd_tag, typ, count, data = struct.unpack(
                                 "<HHL4s", ifd_data[i * 12 + 2 : (i + 1) * 12 + 2]
                             )
@@ -4038,7 +4038,7 @@ def get_ifd(self, tag: int) -> dict[int, Any]:
                         self._ifds[tag] = dict(self._fixup_dict(makernote))
                     elif self.get(0x010F) == "Nintendo":
                         makernote = {}
-                        for i in range(0, struct.unpack(">H", tag_data[:2])[0]):
+                        for i in range(struct.unpack(">H", tag_data[:2])[0]):
                             ifd_tag, typ, count, data = struct.unpack(
                                 ">HHL4s", tag_data[i * 12 + 2 : (i + 1) * 12 + 2]
                             )
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index c4ebc5931ab..c2ed9034d0b 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -1204,7 +1204,7 @@ def _get_angles(n_sides: int, rotation: float) -> list[float]:
         degrees = 360 / n_sides
         # Start with the bottom left polygon vertex
         current_angle = (270 - 0.5 * degrees) + rotation
-        for _ in range(0, n_sides):
+        for _ in range(n_sides):
             angles.append(current_angle)
             current_angle += degrees
             if current_angle > 360:
@@ -1227,4 +1227,4 @@ def _color_diff(
     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)))
+    return sum(abs(first[i] - second[i]) for i in range(len(second)))
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index 75dfbee22bf..da28854b574 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -213,14 +213,14 @@ def colorize(
     blue = []
 
     # Create the low-end values
-    for i in range(0, blackpoint):
+    for i in range(blackpoint):
         red.append(rgb_black[0])
         green.append(rgb_black[1])
         blue.append(rgb_black[2])
 
     # Create the mapping (2-color)
     if rgb_mid is None:
-        range_map = range(0, whitepoint - blackpoint)
+        range_map = range(whitepoint - blackpoint)
 
         for i in range_map:
             red.append(
@@ -235,8 +235,8 @@ def colorize(
 
     # Create the mapping (3-color)
     else:
-        range_map1 = range(0, midpoint - blackpoint)
-        range_map2 = range(0, whitepoint - midpoint)
+        range_map1 = range(midpoint - blackpoint)
+        range_map2 = range(whitepoint - midpoint)
 
         for i in range_map1:
             red.append(
@@ -256,7 +256,7 @@ def colorize(
             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):
+    for i in range(256 - whitepoint):
         red.append(rgb_white[0])
         green.append(rgb_white[1])
         blue.append(rgb_white[2])
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 3e882403b49..9465d8e2dab 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -569,7 +569,7 @@ def _getmp(self: JpegImageFile) -> dict[int, Any] | None:
     mpentries = []
     try:
         rawmpentries = mp[0xB002]
-        for entrynum in range(0, quant):
+        for entrynum in range(quant):
             unpackedentry = struct.unpack_from(
                 f"{endianness}LLLHH", rawmpentries, entrynum * 16
             )

From a2b13cc02a68bd8f0bc3a9f84e603930c3a2496f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 3 Mar 2025 23:56:43 +0200
Subject: [PATCH 1522/2374] Call startswith/endswith once with a tuple

---
 src/PIL/IcnsImagePlugin.py | 3 +--
 src/PIL/TiffImagePlugin.py | 2 +-
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index a5d5b93aeac..5a88429e5e4 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -123,8 +123,7 @@ def read_png_or_jpeg2000(
         Image._decompression_bomb_check(im.size)
         return {"RGBA": im}
     elif (
-        sig.startswith(b"\xff\x4f\xff\x51")
-        or sig.startswith(b"\x0d\x0a\x87\x0a")
+        sig.startswith((b"\xff\x4f\xff\x51", b"\x0d\x0a\x87\x0a"))
         or sig == b"\x00\x00\x00\x0cjP  \x0d\x0a\x87\x0a"
     ):
         if not enable_jpeg2k:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 3d36d1abc43..b8ff47a12cb 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1584,7 +1584,7 @@ def _setup(self) -> None:
             # byte order.
             elif rawmode == "I;16":
                 rawmode = "I;16N"
-            elif rawmode.endswith(";16B") or rawmode.endswith(";16L"):
+            elif rawmode.endswith((";16B", ";16L")):
                 rawmode = rawmode[:-1] + "N"
 
             # Offset in the tile tuple is 0, we go from 0,0 to

From c0b5d013f6e3313456848f3969231e7ee3ee6031 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 4 Mar 2025 22:19:06 +1100
Subject: [PATCH 1523/2374] Test bad image size and unknown PCX mode

---
 Tests/test_file_pcx.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index b3f38c3e5fd..aa24189f47f 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import io
 from pathlib import Path
 
 import pytest
@@ -36,6 +37,28 @@ def test_sanity(tmp_path: Path) -> None:
         im.save(f)
 
 
+def test_bad_image_size() -> None:
+    with open("Tests/images/pil184.pcx", "rb") as fp:
+        data = fp.read()
+        data = data[:4] + b"\xff\xff" + data[6:]
+
+    b = io.BytesIO(data)
+    with pytest.raises(SyntaxError, match="bad PCX image size"):
+        with PcxImagePlugin.PcxImageFile(b):
+            pass
+
+
+def test_unknown_mode() -> None:
+    with open("Tests/images/pil184.pcx", "rb") as fp:
+        data = fp.read()
+        data = data[:3] + b"\xff" + data[4:]
+
+    b = io.BytesIO(data)
+    with pytest.raises(OSError, match="unknown PCX mode"):
+        with Image.open(b):
+            pass
+
+
 def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 

From 3607d1ade397fc5a5b41f2a0607a15927e2810fa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Mar 2025 00:03:37 +1100
Subject: [PATCH 1524/2374] Use match argument

---
 Tests/test_file_libtiff.py |  6 ++----
 Tests/test_file_ppm.py     | 14 +++++---------
 Tests/test_file_tiff.py    |  3 +--
 Tests/test_file_webp.py    |  3 +--
 Tests/test_image.py        |  3 +--
 Tests/test_imagedraw.py    |  7 +++----
 Tests/test_imagefile.py    |  3 +--
 Tests/test_imagemorph.py   | 26 ++++++++++----------------
 Tests/test_imagepath.py    | 12 ++----------
 9 files changed, 26 insertions(+), 51 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 369c2db1be7..f284c3f2fac 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1140,11 +1140,9 @@ def test_sampleformat_not_corrupted(self) -> None:
     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) == "decoder error -9"
+            with pytest.raises(OSError, match="decoder error -9"):
+                im.load()
 
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", "jpeg"))
     def test_save_multistrip(self, compression: str, tmp_path: Path) -> None:
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index d87192ca574..c93a8c73aba 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -293,12 +293,10 @@ def test_header_token_too_long(tmp_path: Path) -> None:
     with open(path, "wb") as f:
         f.write(b"P6\n 01234567890")
 
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(ValueError, match="Token too long in file header: 01234567890"):
         with Image.open(path):
             pass
 
-    assert str(e.value) == "Token too long in file header: 01234567890"
-
 
 def test_truncated_file(tmp_path: Path) -> None:
     # Test EOF in header
@@ -306,12 +304,10 @@ def test_truncated_file(tmp_path: Path) -> None:
     with open(path, "wb") as f:
         f.write(b"P6")
 
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(ValueError, match="Reached EOF while reading header"):
         with Image.open(path):
             pass
 
-    assert str(e.value) == "Reached EOF while reading header"
-
     # Test EOF for PyDecoder
     fp = BytesIO(b"P5 3 1 4")
     with Image.open(fp) as im:
@@ -335,12 +331,12 @@ def test_invalid_maxval(maxval: bytes, tmp_path: Path) -> None:
     with open(path, "wb") as f:
         f.write(b"P6\n3 1 " + maxval)
 
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(
+        ValueError, match="maxval must be greater than 0 and less than 65536"
+    ):
         with Image.open(path):
             pass
 
-    assert str(e.value) == "maxval must be greater than 0 and less than 65536"
-
 
 def test_neg_ppm() -> None:
     # Storage.c accepted negative values for xsize, ysize.  the
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index a8a407963c5..c1ccf3fe2de 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -134,9 +134,8 @@ def test_seek_too_large(self) -> None:
 
     def test_set_legacy_api(self) -> None:
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
-        with pytest.raises(Exception) as e:
+        with pytest.raises(Exception, match="Not allowing setting of legacy api"):
             ifd.legacy_api = False
-        assert str(e.value) == "Not allowing setting of legacy api"
 
     def test_xyres_tiff(self) -> None:
         filename = "Tests/images/pil168.tif"
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index abe888241b4..d8c4eb5899c 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -154,9 +154,8 @@ 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:
         im = Image.new("RGB", (15000, 15000))
-        with pytest.raises(ValueError) as e:
+        with pytest.raises(ValueError, match="encoding error 6"):
             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:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 5474f951cfc..d64816b1ee4 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -65,9 +65,8 @@ def test_image_modes_success(self, mode: str) -> None:
 
     @pytest.mark.parametrize("mode", ("", "bad", "very very long"))
     def test_image_modes_fail(self, mode: str) -> None:
-        with pytest.raises(ValueError) as e:
+        with pytest.raises(ValueError, match="unrecognized image mode"):
             Image.new(mode, (1, 1))
-        assert str(e.value) == "unrecognized image mode"
 
     def test_exception_inheritance(self) -> None:
         assert issubclass(UnidentifiedImageError, OSError)
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 232cbb16cde..1af4455b8cf 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1626,7 +1626,7 @@ def test_compute_regular_polygon_vertices(
             0,
             ValueError,
             "bounding_circle should contain 2D coordinates "
-            "and a radius (e.g. (x, y, r) or ((x, y), r) )",
+            r"and a radius \(e.g. \(x, y, r\) or \(\(x, y\), r\) \)",
         ),
         (
             3,
@@ -1640,7 +1640,7 @@ def test_compute_regular_polygon_vertices(
             ((50, 50, 50), 25),
             0,
             ValueError,
-            "bounding_circle centre should contain 2D coordinates (e.g. (x, y))",
+            r"bounding_circle centre should contain 2D coordinates \(e.g. \(x, y\)\)",
         ),
         (
             3,
@@ -1665,9 +1665,8 @@ def test_compute_regular_polygon_vertices_input_error_handling(
     expected_error: type[Exception],
     error_message: str,
 ) -> None:
-    with pytest.raises(expected_error) as e:
+    with pytest.raises(expected_error, match=error_message):
         ImageDraw._compute_regular_polygon_vertices(bounding_circle, n_sides, rotation)  # type: ignore[arg-type]
-    assert str(e.value) == error_message
 
 
 def test_continuous_horizontal_edges_polygon() -> None:
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index b05d29dae96..c60a475a31b 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -176,9 +176,8 @@ def test_truncated(self) -> None:
                 b"0" * ImageFile.SAFEBLOCK
             )  # only SAFEBLOCK bytes, so that the header is truncated
         )
-        with pytest.raises(OSError) as e:
+        with pytest.raises(OSError, match="Truncated File Read"):
             BmpImagePlugin.BmpImageFile(b)
-        assert str(e.value) == "Truncated File Read"
 
     @skip_unless_feature("zlib")
     def test_truncated_with_errors(self) -> None:
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 6180a7b5d90..515e29cead9 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -80,15 +80,12 @@ 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:
+    with pytest.raises(Exception, match="No operator loaded"):
         mop.apply(im)
-    assert str(e.value) == "No operator loaded"
-    with pytest.raises(Exception) as e:
+    with pytest.raises(Exception, match="No operator loaded"):
         mop.match(im)
-    assert str(e.value) == "No operator loaded"
-    with pytest.raises(Exception) as e:
+    with pytest.raises(Exception, match="No operator loaded"):
         mop.save_lut("")
-    assert str(e.value) == "No operator loaded"
 
 
 # Test the named patterns
@@ -238,15 +235,12 @@ def test_incorrect_mode() -> None:
     im = hopper("RGB")
     mop = ImageMorph.MorphOp(op_name="erosion8")
 
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(ValueError, match="Image mode must be L"):
         mop.apply(im)
-    assert str(e.value) == "Image mode must be L"
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(ValueError, match="Image mode must be L"):
         mop.match(im)
-    assert str(e.value) == "Image mode must be L"
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(ValueError, match="Image mode must be L"):
         mop.get_on_pixels(im)
-    assert str(e.value) == "Image mode must be L"
 
 
 def test_add_patterns() -> None:
@@ -279,9 +273,10 @@ def test_pattern_syntax_error() -> None:
     lb.add_patterns(new_patterns)
 
     # Act / Assert
-    with pytest.raises(Exception) as e:
+    with pytest.raises(
+        Exception, match='Syntax error in pattern "a pattern with a syntax error"'
+    ):
         lb.build_lut()
-    assert str(e.value) == 'Syntax error in pattern "a pattern with a syntax error"'
 
 
 def test_load_invalid_mrl() -> None:
@@ -290,9 +285,8 @@ def test_load_invalid_mrl() -> None:
     mop = ImageMorph.MorphOp()
 
     # Act / Assert
-    with pytest.raises(Exception) as e:
+    with pytest.raises(Exception, match="Wrong size operator file!"):
         mop.load_lut(invalid_mrl)
-    assert str(e.value) == "Wrong size operator file!"
 
 
 def test_roundtrip_mrl(tmp_path: Path) -> None:
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index 1b1ee6bac49..1ebf12d2249 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -81,13 +81,9 @@ def test_path_constructors(
 def test_invalid_path_constructors(
     coords: tuple[str, str] | Sequence[Sequence[int]],
 ) -> None:
-    # Act
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(ValueError, match="incorrect coordinate type"):
         ImagePath.Path(coords)
 
-    # Assert
-    assert str(e.value) == "incorrect coordinate type"
-
 
 @pytest.mark.parametrize(
     "coords",
@@ -99,13 +95,9 @@ def test_invalid_path_constructors(
     ),
 )
 def test_path_odd_number_of_coordinates(coords: Sequence[int]) -> None:
-    # Act
-    with pytest.raises(ValueError) as e:
+    with pytest.raises(ValueError, match="wrong number of coordinates"):
         ImagePath.Path(coords)
 
-    # Assert
-    assert str(e.value) == "wrong number of coordinates"
-
 
 @pytest.mark.parametrize(
     "coords, expected",

From 2309f0fa60bae05881907e374afffc2257376fbc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Mar 2025 21:30:24 +1100
Subject: [PATCH 1525/2374] Inherit classes with abstractmethod from ABC

---
 src/PIL/BlpImagePlugin.py | 2 +-
 src/PIL/Image.py          | 4 ++--
 src/PIL/ImageFile.py      | 2 +-
 src/PIL/ImageFilter.py    | 2 +-
 src/PIL/ImageShow.py      | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index 5747c125275..f7be7746d84 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -291,7 +291,7 @@ def _open(self) -> None:
         self.tile = [ImageFile._Tile(decoder, (0, 0) + self.size, offset, args)]
 
 
-class _BLPBaseDecoder(ImageFile.PyDecoder):
+class _BLPBaseDecoder(abc.ABC, ImageFile.PyDecoder):
     _pulls_fd = True
 
     def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 684c87c4d78..c9c9c2e1b16 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2966,7 +2966,7 @@ def toqpixmap(self) -> ImageQt.QPixmap:
 # Abstract handlers.
 
 
-class ImagePointHandler:
+class ImagePointHandler(abc.ABC):
     """
     Used as a mixin by point transforms
     (for use with :py:meth:`~PIL.Image.Image.point`)
@@ -2977,7 +2977,7 @@ def point(self, im: Image) -> Image:
         pass
 
 
-class ImageTransformHandler:
+class ImageTransformHandler(abc.ABC):
     """
     Used as a mixin by geometry transforms
     (for use with :py:meth:`~PIL.Image.Image.transform`)
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index c3901d4888c..4bc70cc766b 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -438,7 +438,7 @@ def _seek_check(self, frame: int) -> bool:
         return self.tell() != frame
 
 
-class StubHandler:
+class StubHandler(abc.ABC):
     def open(self, im: StubImageFile) -> None:
         pass
 
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 1c8b29b1146..05829d0c63a 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -27,7 +27,7 @@
     from ._typing import NumpyArray
 
 
-class Filter:
+class Filter(abc.ABC):
     @abc.abstractmethod
     def filter(self, image: _imaging.ImagingCore) -> _imaging.ImagingCore:
         pass
diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index d62893d9c8b..dd240fb5500 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -192,7 +192,7 @@ def show_file(self, path: str, **options: Any) -> int:
     register(MacViewer)
 
 
-class UnixViewer(Viewer):
+class UnixViewer(abc.ABC, Viewer):
     format = "PNG"
     options = {"compress_level": 1, "save_all": True}
 

From d186a2a8d60ea1889d3c02c54da9c01076d233e1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Mar 2025 21:50:09 +1100
Subject: [PATCH 1526/2374] Replace NotImplementedError with abstractmethod

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

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 4bc70cc766b..1bf8a7e5f21 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -447,7 +447,7 @@ def load(self, im: StubImageFile) -> Image.Image:
         pass
 
 
-class StubImageFile(ImageFile):
+class StubImageFile(ImageFile, metaclass=abc.ABCMeta):
     """
     Base class for stub image loaders.
 
@@ -455,9 +455,9 @@ class StubImageFile(ImageFile):
     certain format, but relies on external code to load the file.
     """
 
+    @abc.abstractmethod
     def _open(self) -> None:
-        msg = "StubImageFile subclass must implement _open"
-        raise NotImplementedError(msg)
+        pass
 
     def load(self) -> Image.core.PixelAccess | None:
         loader = self._load()
@@ -471,10 +471,10 @@ def load(self) -> Image.core.PixelAccess | None:
         self.__dict__ = image.__dict__
         return image.load()
 
+    @abc.abstractmethod
     def _load(self) -> StubHandler | None:
         """(Hook) Find actual image loader."""
-        msg = "StubImageFile subclass must implement _load"
-        raise NotImplementedError(msg)
+        pass
 
 
 class Parser:

From 5ba72a9b54bd744724e4ec269268c16dd61bb472 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 6 Mar 2025 04:15:55 +1100
Subject: [PATCH 1527/2374] Merge pull request #8800 from radarhere/path_lists

Allow coords to be sequence of lists
---
 Tests/test_imagedraw.py |  4 +++
 Tests/test_imagepath.py | 17 ++-------
 src/path.c              | 78 ++++++++++++++++++++++++++---------------
 3 files changed, 57 insertions(+), 42 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 967bd67384b..2767418eac9 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -39,6 +39,8 @@
 POINTS = (
     ((10, 10), (20, 40), (30, 30)),
     [(10, 10), (20, 40), (30, 30)],
+    ([10, 10], [20, 40], [30, 30]),
+    [[10, 10], [20, 40], [30, 30]],
     (10, 10, 20, 40, 30, 30),
     [10, 10, 20, 40, 30, 30],
 )
@@ -46,6 +48,8 @@
 KITE_POINTS = (
     ((10, 50), (70, 10), (90, 50), (70, 90), (10, 50)),
     [(10, 50), (70, 10), (90, 50), (70, 90), (10, 50)],
+    ([10, 50], [70, 10], [90, 50], [70, 90], [10, 50]),
+    [[10, 50], [70, 10], [90, 50], [70, 90], [10, 50]],
 )
 
 
diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index 1ebf12d2249..ad8acde4938 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -68,21 +68,10 @@ def test_path_constructors(
     assert list(p) == [(0.0, 1.0)]
 
 
-@pytest.mark.parametrize(
-    "coords",
-    (
-        ("a", "b"),
-        ([0, 1],),
-        [[0, 1]],
-        ([0.0, 1.0],),
-        [[0.0, 1.0]],
-    ),
-)
-def test_invalid_path_constructors(
-    coords: tuple[str, str] | Sequence[Sequence[int]],
-) -> None:
+def test_invalid_path_constructors() -> None:
+    # Arrange / Act
     with pytest.raises(ValueError, match="incorrect coordinate type"):
-        ImagePath.Path(coords)
+        ImagePath.Path(("a", "b"))
 
 
 @pytest.mark.parametrize(
diff --git a/src/path.c b/src/path.c
index 5affe3a1fc5..38300547c60 100644
--- a/src/path.c
+++ b/src/path.c
@@ -109,6 +109,39 @@ path_dealloc(PyPathObject *path) {
 
 #define PyPath_Check(op) (Py_TYPE(op) == &PyPathType)
 
+static int
+assign_item_to_array(double *xy, Py_ssize_t j, PyObject *op) {
+    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 (PyList_Check(op)) {
+        for (int k = 0; k < 2; k++) {
+            PyObject *op1 = PyList_GetItemRef(op, k);
+            if (op1 == NULL) {
+                return -1;
+            }
+            j = assign_item_to_array(xy, j, op1);
+            Py_DECREF(op1);
+            if (j == -1) {
+                return -1;
+            }
+        }
+    } else {
+        double x, y;
+        if (PyArg_ParseTuple(op, "dd", &x, &y)) {
+            xy[j++] = x;
+            xy[j++] = y;
+        } else {
+            PyErr_SetString(PyExc_ValueError, "incorrect coordinate type");
+            return -1;
+        }
+    }
+    return j;
+}
+
 Py_ssize_t
 PyPath_Flatten(PyObject *data, double **pxy) {
     Py_ssize_t i, j, n;
@@ -164,48 +197,32 @@ 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;                                                      \
-    }                                                                   \
-    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_GetItemRef(data, i);
             if (op == NULL) {
                 free(xy);
                 return -1;
             }
-            assign_item_to_array(op, 1);
+            j = assign_item_to_array(xy, j, op);
+            Py_DECREF(op);
+            if (j == -1) {
+                free(xy);
+                return -1;
+            }
         }
     } else if (PyTuple_Check(data)) {
         for (i = 0; i < n; i++) {
-            double x, y;
             PyObject *op = PyTuple_GET_ITEM(data, i);
-            assign_item_to_array(op, 0);
+            j = assign_item_to_array(xy, j, op);
+            if (j == -1) {
+                free(xy);
+                return -1;
+            }
         }
     } else {
         for (i = 0; i < n; i++) {
-            double x, y;
             PyObject *op = PySequence_GetItem(data, i);
             if (!op) {
                 /* treat IndexError as end of sequence */
@@ -217,7 +234,12 @@ PyPath_Flatten(PyObject *data, double **pxy) {
                     return -1;
                 }
             }
-            assign_item_to_array(op, 1);
+            j = assign_item_to_array(xy, j, op);
+            Py_DECREF(op);
+            if (j == -1) {
+                free(xy);
+                return -1;
+            }
         }
     }
 

From e946c7b14adc7a0aaa9ac883de217a3c0e556a81 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 7 Mar 2025 02:42:10 +1100
Subject: [PATCH 1528/2374] Test using _seek to skip frames (#8804)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_apng.py | 5 ++++-
 Tests/test_file_fli.py  | 3 +++
 Tests/test_file_gif.py  | 4 ++++
 3 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 9d5154fca07..b9a03617394 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -34,8 +34,11 @@ def test_apng_basic() -> None:
         with pytest.raises(EOFError):
             im.seek(2)
 
-        # test rewind support
         im.seek(0)
+        with pytest.raises(ValueError, match="cannot seek to frame 2"):
+            im._seek(2)
+
+        # test rewind support
         assert im.getpixel((0, 0)) == (255, 0, 0, 255)
         assert im.getpixel((64, 32)) == (255, 0, 0, 255)
         im.seek(1)
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 8adbd30f5ef..8a95af62dcf 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -160,6 +160,9 @@ def test_seek() -> None:
 
         assert_image_equal_tofile(im, "Tests/images/a_fli.png")
 
+        with pytest.raises(ValueError, match="cannot seek to frame 52"):
+            im._seek(52)
+
 
 @pytest.mark.parametrize(
     "test_file",
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index d2592da971f..dbbffc675f5 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -410,6 +410,10 @@ def test_seek() -> None:
         except EOFError:
             assert frame_count == 5
 
+        img.seek(0)
+        with pytest.raises(ValueError, match="cannot seek to frame 2"):
+            img._seek(2)
+
 
 def test_seek_info() -> None:
     with Image.open("Tests/images/iss634.gif") as im:

From 5575c1d072a127e10cf0077ca9dcb7d54ea06c06 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Mar 2025 09:56:00 +1100
Subject: [PATCH 1529/2374] Test missing frame size

---
 Tests/test_file_fli.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 8a95af62dcf..2f39adc69d8 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import io
 import warnings
 
 import pytest
@@ -132,6 +133,15 @@ def test_eoferror() -> None:
         im.seek(n_frames - 1)
 
 
+def test_missing_frame_size() -> None:
+    with open(animated_test_file, "rb") as fp:
+        data = fp.read()
+    data = data[:6188]
+    with Image.open(io.BytesIO(data)) as im:
+        with pytest.raises(EOFError, match="missing frame size"):
+            im.seek(1)
+
+
 def test_seek_tell() -> None:
     with Image.open(animated_test_file) as im:
         layer_number = im.tell()

From baa299a6f42d691653f3a6dcfb067be567319c27 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 8 Mar 2025 09:54:46 +1100
Subject: [PATCH 1530/2374] Moved code outside of context manager

---
 Tests/test_file_jpeg2k.py | 10 +++++-----
 Tests/test_file_pcx.py    |  4 ++--
 Tests/test_font_bdf.py    |  4 ++--
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 01172fdbb8a..e429610ad92 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -317,12 +317,12 @@ def test_grayscale_four_channels() -> None:
     with open("Tests/images/rgb_trns_ycbc.jp2", "rb") as fp:
         data = fp.read()
 
-        # Change color space to OPJ_CLRSPC_GRAY
-        data = data[:76] + b"\x11" + data[77:]
+    # Change color space to OPJ_CLRSPC_GRAY
+    data = data[:76] + b"\x11" + data[77:]
 
-        with Image.open(BytesIO(data)) as im:
-            im.load()
-            assert im.mode == "RGBA"
+    with Image.open(BytesIO(data)) as im:
+        im.load()
+        assert im.mode == "RGBA"
 
 
 @pytest.mark.skipif(
diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index aa24189f47f..21c32268c0e 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -40,7 +40,7 @@ def test_sanity(tmp_path: Path) -> None:
 def test_bad_image_size() -> None:
     with open("Tests/images/pil184.pcx", "rb") as fp:
         data = fp.read()
-        data = data[:4] + b"\xff\xff" + data[6:]
+    data = data[:4] + b"\xff\xff" + data[6:]
 
     b = io.BytesIO(data)
     with pytest.raises(SyntaxError, match="bad PCX image size"):
@@ -51,7 +51,7 @@ def test_bad_image_size() -> None:
 def test_unknown_mode() -> None:
     with open("Tests/images/pil184.pcx", "rb") as fp:
         data = fp.read()
-        data = data[:3] + b"\xff" + data[4:]
+    data = data[:3] + b"\xff" + data[4:]
 
     b = io.BytesIO(data)
     with pytest.raises(OSError, match="unknown PCX mode"):
diff --git a/Tests/test_font_bdf.py b/Tests/test_font_bdf.py
index 2ece5457a2e..b4155c8793b 100644
--- a/Tests/test_font_bdf.py
+++ b/Tests/test_font_bdf.py
@@ -20,8 +20,8 @@ def test_sanity() -> None:
 def test_zero_width_chars() -> None:
     with open(filename, "rb") as fp:
         data = fp.read()
-        data = data[:2650] + b"\x00\x00" + data[2652:]
-        BdfFontFile.BdfFontFile(io.BytesIO(data))
+    data = data[:2650] + b"\x00\x00" + data[2652:]
+    BdfFontFile.BdfFontFile(io.BytesIO(data))
 
 
 def test_invalid_file() -> None:

From a38d4d2583c9ce6e944d44efdb4d5a7106d42ec5 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 10 Mar 2025 22:44:13 +0100
Subject: [PATCH 1531/2374] Replace deprecated Renovate schedule with cron
 syntax

---
 .github/renovate.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/renovate.json b/.github/renovate.json
index f48b670ecdc..91fa0426f9e 100644
--- a/.github/renovate.json
+++ b/.github/renovate.json
@@ -16,6 +16,6 @@
         }
     ],
     "schedule": [
-        "on the 3rd day of the month"
+        "* * 3 * *"
     ]
 }

From 4b9d9f55cdd567d90ea8d885a50489ffd2ccfe2b Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 12 Mar 2025 09:59:25 +1100
Subject: [PATCH 1532/2374] Updated libtiff to 4.7.0 (#8812)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/wheels-dependencies.sh   | 2 +-
 docs/installation/building-from-source.rst | 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 202a8935db4..e9c54536e0a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -43,7 +43,7 @@ LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.4
-TIFF_VERSION=4.6.0
+TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_NG_VERSION=2.2.4
 LIBWEBP_VERSION=1.5.0
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index b400a343611..2790bc2e62c 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -44,7 +44,7 @@ Many of Pillow's features require external libraries:
 
 * **libtiff** provides compressed TIFF functionality
 
-  * Pillow has been tested with libtiff versions **3.x** and **4.0-4.6.0**
+  * Pillow has been tested with libtiff versions **3.x** and **4.0-4.7.0**
 
 * **libfreetype** provides type related services
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index a645722d88e..ea3d9939447 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -120,7 +120,7 @@ def cmd_msbuild(
     "LIBPNG": "1.6.47",
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
-    "TIFF": "4.6.0",
+    "TIFF": "4.7.0",
     "XZ": "5.6.4",
     "ZLIBNG": "2.2.4",
 }

From d97441cb86f1f9187ee303210ccdd34b2f899f6b Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 14 Mar 2025 17:49:59 +1100
Subject: [PATCH 1533/2374] Install libtiff-dev (#8816)

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

diff --git a/.ci/install.sh b/.ci/install.sh
index e61752750c2..62677005e92 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -20,7 +20,7 @@ fi
 set -e
 
 if [[ $(uname) != CYGWIN* ]]; then
-    sudo apt-get -qq install libfreetype6-dev liblcms2-dev python3-tk\
+    sudo apt-get -qq install libfreetype6-dev liblcms2-dev libtiff-dev python3-tk\
                              ghostscript libjpeg-turbo8-dev libopenjp2-7-dev\
                              cmake meson imagemagick libharfbuzz-dev libfribidi-dev\
                              sway wl-clipboard libopenblas-dev

From 5efcaa460372e91d9d18f2f812f590728903927a Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 14 Mar 2025 17:50:28 +1100
Subject: [PATCH 1534/2374] Updated Ghostscript to 10.5.0 (#8814)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/test-windows.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index ef49ff332f3..a780c783576 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -94,8 +94,8 @@ jobs:
         choco install nasm --no-progress
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
-        choco install ghostscript --version=10.4.0 --no-progress
-        echo "C:\Program Files\gs\gs10.04.0\bin" >> $env:GITHUB_PATH
+        choco install ghostscript --version=10.5.0 --no-progress
+        echo "C:\Program Files\gs\gs10.05.0\bin" >> $env:GITHUB_PATH
 
         # Install extra test images
         xcopy /S /Y Tests\test-images\* Tests\images

From 7b725a8fc4e97f150793c8be529c9ae0c80dd64f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Mar 2025 13:04:26 +1100
Subject: [PATCH 1535/2374] DXT3 images are read in RGBA mode

---
 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 a1d93821f0e..b0e20fa8428 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -68,7 +68,7 @@ by DirectX.
 DXT1 and DXT5 pixel formats can be read, only in ``RGBA`` mode.
 
 .. versionadded:: 3.4.0
-   DXT3 images can be read in ``RGB`` mode and DX10 images can be read in
+   DXT3 images can be read in ``RGBA`` mode and DX10 images can be read in
    ``RGB`` and ``RGBA`` mode.
 
 .. versionadded:: 6.0.0

From db30ef74232af617b331e2995cc25ac039def106 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 15 Mar 2025 19:49:03 +0000
Subject: [PATCH 1536/2374] Update dependency cibuildwheel to v2.23.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 2fd3eb6ffe9..f2109ed6194 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.23.0
+cibuildwheel==2.23.1

From 9953256bbf324458b4a7c4e5d070e5e1c4add0dd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 16 Mar 2025 22:12:14 +1100
Subject: [PATCH 1537/2374] Revert "Use Ubuntu 22.04 for 24.04 ppc64le and
 s390x"

This reverts commit e31441fc41ff54217317b61db395dfc9b5a0dc79.
---
 .github/workflows/test-docker.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index da5e191da27..0d9033413e3 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -35,6 +35,10 @@ jobs:
       matrix:
         os: ["ubuntu-latest"]
         docker: [
+          # Run slower jobs first to give them a headstart and reduce waiting time
+          ubuntu-24.04-noble-ppc64le,
+          ubuntu-24.04-noble-s390x,
+          # Then run the remainder
           alpine,
           amazon-2-amd64,
           amazon-2023-amd64,
@@ -52,13 +56,9 @@ jobs:
         dockerTag: [main]
         include:
           - docker: "ubuntu-24.04-noble-ppc64le"
-            os: "ubuntu-22.04"
             qemu-arch: "ppc64le"
-            dockerTag: main
           - docker: "ubuntu-24.04-noble-s390x"
-            os: "ubuntu-22.04"
             qemu-arch: "s390x"
-            dockerTag: main
           - docker: "ubuntu-24.04-noble-arm64v8"
             os: "ubuntu-24.04-arm"
             dockerTag: main

From 7767e83e6c40c01f0d61df480153bf9cf6d12a06 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 16 Mar 2025 22:24:13 +1100
Subject: [PATCH 1538/2374] Use action to setup qemu

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

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 0d9033413e3..25aef55fb13 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -75,8 +75,9 @@ jobs:
 
     - name: Set up QEMU
       if: "matrix.qemu-arch"
-      run: |
-        docker run --rm --privileged aptman/qus -s -- -p ${{ matrix.qemu-arch }}
+      uses: docker/setup-qemu-action@v3
+      with:
+        platforms: ${{ matrix.qemu-arch }}
 
     - name: Docker pull
       run: |

From e1cd9ad5ac17b3923f8842cb0696c94065688f64 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 6 Mar 2025 20:45:49 +1100
Subject: [PATCH 1539/2374] Use maxsplit

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

diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index 1b7a394c01d..74f870ca736 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -45,7 +45,7 @@ def __init__(self, fp: IO[bytes]) -> None:
                 msg = "bad palette file"
                 raise SyntaxError(msg)
 
-            v = tuple(map(int, s.split()[:3]))
+            v = tuple(map(int, s.split(maxsplit=3)[:3]))
             if len(v) != 3:
                 msg = "bad palette entry"
                 raise ValueError(msg)

From 1f6fd3b994f9a810246fa28a863cb849eba4586c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 6 Mar 2025 20:49:37 +1100
Subject: [PATCH 1540/2374] Only convert to int if there are enough items

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

diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index 74f870ca736..f1b3844be99 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -45,12 +45,12 @@ def __init__(self, fp: IO[bytes]) -> None:
                 msg = "bad palette file"
                 raise SyntaxError(msg)
 
-            v = tuple(map(int, s.split(maxsplit=3)[:3]))
-            if len(v) != 3:
+            v = s.split(maxsplit=3)
+            if len(v) < 3:
                 msg = "bad palette entry"
                 raise ValueError(msg)
 
-            palette[i] = o8(v[0]) + o8(v[1]) + o8(v[2])
+            palette[i] = o8(int(v[0])) + o8(int(v[1])) + o8(int(v[2]))
 
         self.palette = b"".join(palette)
 

From 6e597a1ca742ea0fbfaa75f3e02a129d6faa3643 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 6 Mar 2025 22:08:59 +1100
Subject: [PATCH 1541/2374] Do not force palette length to be 256

---
 Tests/test_file_gimppalette.py | 1 +
 src/PIL/GimpPaletteFile.py     | 6 +++---
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_gimppalette.py b/Tests/test_file_gimppalette.py
index e8d5f170506..b362fc8ff4b 100644
--- a/Tests/test_file_gimppalette.py
+++ b/Tests/test_file_gimppalette.py
@@ -32,3 +32,4 @@ def test_get_palette() -> None:
 
     # Assert
     assert mode == "RGB"
+    assert len(palette) / 3 == 11
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index f1b3844be99..b289ecb5239 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -27,12 +27,11 @@ class GimpPaletteFile:
     rawmode = "RGB"
 
     def __init__(self, fp: IO[bytes]) -> None:
-        palette = [o8(i) * 3 for i in range(256)]
-
         if not fp.readline().startswith(b"GIMP Palette"):
             msg = "not a GIMP palette file"
             raise SyntaxError(msg)
 
+        palette: list[int] = []
         for i in range(256):
             s = fp.readline()
             if not s:
@@ -40,6 +39,7 @@ def __init__(self, fp: IO[bytes]) -> None:
 
             # skip fields and comment lines
             if re.match(rb"\w+:|#", s):
+                palette.append(o8(i) * 3)
                 continue
             if len(s) > 100:
                 msg = "bad palette file"
@@ -50,7 +50,7 @@ def __init__(self, fp: IO[bytes]) -> None:
                 msg = "bad palette entry"
                 raise ValueError(msg)
 
-            palette[i] = o8(int(v[0])) + o8(int(v[1])) + o8(int(v[2]))
+            palette.append(o8(int(v[0])) + o8(int(v[1])) + o8(int(v[2])))
 
         self.palette = b"".join(palette)
 

From ca0c940cb1b932c67bf166dc600bd1eb5b264bde Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 6 Mar 2025 22:09:35 +1100
Subject: [PATCH 1542/2374] Do not add palette entries when reading other lines

---
 Tests/test_file_gimppalette.py | 2 +-
 src/PIL/GimpPaletteFile.py     | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_gimppalette.py b/Tests/test_file_gimppalette.py
index b362fc8ff4b..ff9cc91c5c2 100644
--- a/Tests/test_file_gimppalette.py
+++ b/Tests/test_file_gimppalette.py
@@ -32,4 +32,4 @@ def test_get_palette() -> None:
 
     # Assert
     assert mode == "RGB"
-    assert len(palette) / 3 == 11
+    assert len(palette) / 3 == 8
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index b289ecb5239..bbbe2781a49 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -32,14 +32,13 @@ def __init__(self, fp: IO[bytes]) -> None:
             raise SyntaxError(msg)
 
         palette: list[int] = []
-        for i in range(256):
+        for _ in range(256):
             s = fp.readline()
             if not s:
                 break
 
             # skip fields and comment lines
             if re.match(rb"\w+:|#", s):
-                palette.append(o8(i) * 3)
                 continue
             if len(s) > 100:
                 msg = "bad palette file"

From 669a288beb222e61b6e9107940f755517e0ac2ff Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 6 Mar 2025 22:33:43 +1100
Subject: [PATCH 1543/2374] Convert all entries to bytes at once

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

diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index bbbe2781a49..0f079f45758 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -18,8 +18,6 @@
 import re
 from typing import IO
 
-from ._binary import o8
-
 
 class GimpPaletteFile:
     """File handler for GIMP's palette format."""
@@ -49,9 +47,9 @@ def __init__(self, fp: IO[bytes]) -> None:
                 msg = "bad palette entry"
                 raise ValueError(msg)
 
-            palette.append(o8(int(v[0])) + o8(int(v[1])) + o8(int(v[2])))
+            palette += (int(v[i]) for i in range(3))
 
-        self.palette = b"".join(palette)
+        self.palette = bytes(palette)
 
     def getpalette(self) -> tuple[bytes, str]:
         return self.palette, self.rawmode

From 6c7917d7a6031ae22e1d9eaccc2e536123ea25c2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 17 Mar 2025 07:54:47 +1100
Subject: [PATCH 1544/2374] Revert to zlib on macOS < 10.15

---
 .github/workflows/wheels-dependencies.sh | 7 ++++++-
 Tests/check_wheel.py                     | 5 +++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index e9c54536e0a..e0c18d6c274 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -45,6 +45,7 @@ OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.6.4
 TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
+ZLIB_VERSION=1.3.1
 ZLIB_NG_VERSION=2.2.4
 LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
@@ -106,7 +107,11 @@ function build {
     if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
         yum remove -y zlib-devel
     fi
-    build_zlib_ng
+    if [[ -n "$IS_MACOS" ]] && [[ "$MACOSX_DEPLOYMENT_TARGET" == "10.10" || "$MACOSX_DEPLOYMENT_TARGET" == "10.13" ]]; then
+        build_new_zlib
+    else
+        build_zlib_ng
+    fi
 
     build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
     if [ -n "$IS_MACOS" ]; then
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 563be0b7489..8ba40ba3fbe 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -1,9 +1,12 @@
 from __future__ import annotations
 
+import platform
 import sys
 
 from PIL import features
 
+from .helper import is_pypy
+
 
 def test_wheel_modules() -> None:
     expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp"}
@@ -40,5 +43,7 @@ def test_wheel_features() -> None:
 
     if sys.platform == "win32":
         expected_features.remove("xcb")
+    elif sys.platform == "darwin" and not is_pypy() and platform.processor() != "arm":
+        expected_features.remove("zlib_ng")
 
     assert set(features.get_supported_features()) == expected_features

From 3dbd0e57bae0dbe2a3f2c006fb767417a2c5419e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 10 Mar 2025 10:14:38 +1100
Subject: [PATCH 1545/2374] Added DXT1 encoding

---
 Tests/test_file_dds.py     |  31 ++++++-
 setup.py                   |   1 +
 src/PIL/DdsImagePlugin.py  |  57 +++++++-----
 src/_imaging.c             |   3 +
 src/encode.c               |  18 ++++
 src/libImaging/BcnEncode.c | 173 +++++++++++++++++++++++++++++++++++++
 src/libImaging/Imaging.h   |   2 +
 7 files changed, 260 insertions(+), 25 deletions(-)
 create mode 100644 src/libImaging/BcnEncode.c

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 7cc4d79d4e0..7a6099ce77d 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -9,7 +9,12 @@
 
 from PIL import DdsImagePlugin, Image
 
-from .helper import assert_image_equal, assert_image_equal_tofile, hopper
+from .helper import (
+    assert_image_equal,
+    assert_image_equal_tofile,
+    assert_image_similar_tofile,
+    hopper,
+)
 
 TEST_FILE_DXT1 = "Tests/images/dxt1-rgb-4bbp-noalpha_MipMaps-1.dds"
 TEST_FILE_DXT3 = "Tests/images/dxt3-argb-8bbp-explicitalpha_MipMaps-1.dds"
@@ -389,5 +394,25 @@ def test_save(mode: str, test_file: str, tmp_path: Path) -> None:
         assert im.mode == mode
         im.save(out)
 
-        with Image.open(out) as reloaded:
-            assert_image_equal(im, reloaded)
+        assert_image_equal_tofile(im, out)
+
+
+def test_save_dxt1(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.dds")
+    with Image.open(TEST_FILE_DXT1) as im:
+        im.convert("RGB").save(out, pixel_format="DXT1")
+    assert_image_similar_tofile(im, out, 1.84)
+
+    im_alpha = im.copy()
+    im_alpha.putpixel((0, 0), (0, 0, 0, 0))
+    im_alpha.save(out, pixel_format="DXT1")
+    with Image.open(out) as reloaded:
+        assert reloaded.getpixel((0, 0)) == (0, 0, 0, 0)
+
+    im_l = im.convert("L")
+    im_l.save(out, pixel_format="DXT1")
+    assert_image_similar_tofile(im_l.convert("RGBA"), out, 9.25)
+
+    im_alpha.convert("LA").save(out, pixel_format="DXT1")
+    with Image.open(out) as reloaded:
+        assert reloaded.getpixel((0, 0)) == (0, 0, 0, 0)
diff --git a/setup.py b/setup.py
index a85731db936..9fac993b10b 100644
--- a/setup.py
+++ b/setup.py
@@ -68,6 +68,7 @@ def get_version() -> str:
     "Reduce",
     "Bands",
     "BcnDecode",
+    "BcnEncode",
     "BitDecode",
     "Blend",
     "Chops",
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index cdae8dfee23..718f376e8ba 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -518,30 +518,43 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         msg = f"cannot write mode {im.mode} as DDS"
         raise OSError(msg)
 
-    alpha = im.mode[-1] == "A"
-    if im.mode[0] == "L":
-        pixel_flags = DDPF.LUMINANCE
-        rawmode = im.mode
-        if alpha:
-            rgba_mask = [0x000000FF, 0x000000FF, 0x000000FF]
+    flags = DDSD.CAPS | DDSD.HEIGHT | DDSD.WIDTH | DDSD.PIXELFORMAT
+    bitcount = len(im.getbands()) * 8
+    raw = im.encoderinfo.get("pixel_format") != "DXT1"
+    if raw:
+        codec_name = "raw"
+        flags |= DDSD.PITCH
+        pitch = (im.width * bitcount + 7) // 8
+
+        alpha = im.mode[-1] == "A"
+        if im.mode[0] == "L":
+            pixel_flags = DDPF.LUMINANCE
+            rawmode = im.mode
+            if alpha:
+                rgba_mask = [0x000000FF, 0x000000FF, 0x000000FF]
+            else:
+                rgba_mask = [0xFF000000, 0xFF000000, 0xFF000000]
         else:
-            rgba_mask = [0xFF000000, 0xFF000000, 0xFF000000]
-    else:
-        pixel_flags = DDPF.RGB
-        rawmode = im.mode[::-1]
-        rgba_mask = [0x00FF0000, 0x0000FF00, 0x000000FF]
+            pixel_flags = DDPF.RGB
+            rawmode = im.mode[::-1]
+            rgba_mask = [0x00FF0000, 0x0000FF00, 0x000000FF]
 
+            if alpha:
+                r, g, b, a = im.split()
+                im = Image.merge("RGBA", (a, r, g, b))
         if alpha:
-            r, g, b, a = im.split()
-            im = Image.merge("RGBA", (a, r, g, b))
-    if alpha:
-        pixel_flags |= DDPF.ALPHAPIXELS
-    rgba_mask.append(0xFF000000 if alpha else 0)
-
-    flags = DDSD.CAPS | DDSD.HEIGHT | DDSD.WIDTH | DDSD.PITCH | DDSD.PIXELFORMAT
-    bitcount = len(im.getbands()) * 8
-    pitch = (im.width * bitcount + 7) // 8
+            pixel_flags |= DDPF.ALPHAPIXELS
+        rgba_mask.append(0xFF000000 if alpha else 0)
 
+        fourcc = 0
+    else:
+        codec_name = "bcn"
+        flags |= DDSD.LINEARSIZE
+        pitch = (im.width + 3) * 4
+        rawmode = None
+        rgba_mask = [0, 0, 0, 0]
+        pixel_flags = DDPF.FOURCC
+        fourcc = D3DFMT.DXT1
     fp.write(
         o32(DDS_MAGIC)
         + struct.pack(
@@ -556,11 +569,11 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         )
         + struct.pack("11I", *((0,) * 11))  # reserved
         # pfsize, pfflags, fourcc, bitcount
-        + struct.pack("<4I", 32, pixel_flags, 0, bitcount)
+        + struct.pack("<4I", 32, pixel_flags, fourcc, bitcount)
         + struct.pack("<4I", *rgba_mask)  # dwRGBABitMask
         + struct.pack("<5I", DDSCAPS.TEXTURE, 0, 0, 0, 0)
     )
-    ImageFile._save(im, fp, [ImageFile._Tile("raw", (0, 0) + im.size, 0, rawmode)])
+    ImageFile._save(im, fp, [ImageFile._Tile(codec_name, (0, 0) + im.size, 0, rawmode)])
 
 
 def _accept(prefix: bytes) -> bool:
diff --git a/src/_imaging.c b/src/_imaging.c
index fa38dcc0586..330a7eef401 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4041,6 +4041,8 @@ PyImaging_ZipDecoderNew(PyObject *self, PyObject *args);
 
 /* Encoders (in encode.c) */
 extern PyObject *
+PyImaging_BcnEncoderNew(PyObject *self, PyObject *args);
+extern PyObject *
 PyImaging_EpsEncoderNew(PyObject *self, PyObject *args);
 extern PyObject *
 PyImaging_GifEncoderNew(PyObject *self, PyObject *args);
@@ -4109,6 +4111,7 @@ static PyMethodDef functions[] = {
 
     /* Codecs */
     {"bcn_decoder", (PyCFunction)PyImaging_BcnDecoderNew, METH_VARARGS},
+    {"bcn_encoder", (PyCFunction)PyImaging_BcnEncoderNew, METH_VARARGS},
     {"bit_decoder", (PyCFunction)PyImaging_BitDecoderNew, METH_VARARGS},
     {"eps_encoder", (PyCFunction)PyImaging_EpsEncoderNew, METH_VARARGS},
     {"fli_decoder", (PyCFunction)PyImaging_FliDecoderNew, METH_VARARGS},
diff --git a/src/encode.c b/src/encode.c
index 13d5cdaf75e..d27783f0cfc 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -350,6 +350,24 @@ get_packer(ImagingEncoderObject *encoder, const char *mode, const char *rawmode)
     return 0;
 }
 
+/* -------------------------------------------------------------------- */
+/* BCN                                                                  */
+/* -------------------------------------------------------------------- */
+
+PyObject *
+PyImaging_BcnEncoderNew(PyObject *self, PyObject *args) {
+    ImagingEncoderObject *encoder;
+
+    encoder = PyImaging_EncoderNew(0);
+    if (encoder == NULL) {
+        return NULL;
+    }
+
+    encoder->encode = ImagingBcnEncode;
+
+    return (PyObject *)encoder;
+}
+
 /* -------------------------------------------------------------------- */
 /* EPS                                                                  */
 /* -------------------------------------------------------------------- */
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
new file mode 100644
index 00000000000..42a46358cac
--- /dev/null
+++ b/src/libImaging/BcnEncode.c
@@ -0,0 +1,173 @@
+/*
+ * The Python Imaging Library
+ *
+ * encoder for DXT1-compressed data
+ *
+ * Format documentation:
+ *   https://web.archive.org/web/20170802060935/http://oss.sgi.com/projects/ogl-sample/registry/EXT/texture_compression_s3tc.txt
+ *
+ */
+
+#include "Imaging.h"
+
+#include "Bcn.h"
+
+typedef struct {
+    UINT8 color[3];
+} rgb;
+
+typedef struct {
+    UINT8 color[3];
+    int alpha;
+} rgba;
+
+static rgb
+decode_565(UINT16 x) {
+    rgb item;
+    int r, g, b;
+    r = (x & 0xf800) >> 8;
+    r |= r >> 5;
+    item.color[0] = r;
+    g = (x & 0x7e0) >> 3;
+    g |= g >> 6;
+    item.color[1] = g;
+    b = (x & 0x1f) << 3;
+    b |= b >> 5;
+    item.color[2] = b;
+    return item;
+}
+
+static UINT16
+encode_565(rgba item) {
+    UINT8 r, g, b;
+    r = item.color[0] >> (8 - 5);
+    g = item.color[1] >> (8 - 6);
+    b = item.color[2] >> (8 - 5);
+    return (r << (5 + 6)) | (g << 5) | b;
+}
+
+int
+ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
+    UINT8 *dst = buf;
+
+    for (;;) {
+        int i, j, k;
+        UINT16 color_min = 0, color_max = 0;
+        rgb color_min_rgb, color_max_rgb;
+        rgba block[16], *current_rgba;
+
+        // Determine the min and max colors in this 4x4 block
+        int has_alpha_channel =
+            strcmp(im->mode, "RGBA") == 0 || strcmp(im->mode, "LA") == 0;
+        int first = 1;
+        int transparency = 0;
+        for (i = 0; i < 4; i++) {
+            for (j = 0; j < 4; j++) {
+                int x = state->x + i * im->pixelsize;
+                int y = state->y + j;
+                if (x >= state->xsize * im->pixelsize || y >= state->ysize) {
+                    // The 4x4 block extends past the edge of the image
+                    continue;
+                }
+
+                current_rgba = &block[i + j * 4];
+                for (k = 0; k < 3; k++) {
+                    current_rgba->color[k] =
+                        (UINT8)im->image[y][x + (im->pixelsize == 1 ? 0 : k)];
+                }
+                if (has_alpha_channel) {
+                    if ((UINT8)im->image[y][x + 3] == 0) {
+                        current_rgba->alpha = 0;
+                        transparency = 1;
+                        continue;
+                    } else {
+                        current_rgba->alpha = 1;
+                    }
+                }
+
+                UINT16 color = encode_565(*current_rgba);
+                if (first || color < color_min) {
+                    color_min = color;
+                }
+                if (first || color > color_max) {
+                    color_max = color;
+                }
+                first = 0;
+            }
+        }
+
+        if (transparency) {
+            *dst++ = color_min;
+            *dst++ = color_min >> 8;
+        }
+        *dst++ = color_max;
+        *dst++ = color_max >> 8;
+        if (!transparency) {
+            *dst++ = color_min;
+            *dst++ = color_min >> 8;
+        }
+
+        color_min_rgb = decode_565(color_min);
+        color_max_rgb = decode_565(color_max);
+        for (i = 0; i < 4; i++) {
+            UINT8 l = 0;
+            for (j = 3; j > -1; j--) {
+                current_rgba = &block[i * 4 + j];
+                if (transparency && !current_rgba->alpha) {
+                    l |= 3 << (j * 2);
+                    continue;
+                }
+
+                float distance = 0;
+                int total = 0;
+                for (k = 0; k < 3; k++) {
+                    float denom =
+                        (float)abs(color_max_rgb.color[k] - color_min_rgb.color[k]);
+                    if (denom != 0) {
+                        distance +=
+                            abs(current_rgba->color[k] - color_min_rgb.color[k]) /
+                            denom;
+                        total += 1;
+                    }
+                }
+                if (total == 0) {
+                    continue;
+                }
+                distance *= 6 / total;
+                if (transparency) {
+                    if (distance < 1.5) {
+                        // color_max
+                    } else if (distance < 4.5) {
+                        l |= 2 << (j * 2);  // 1/2 * color_min + 1/2 * color_max
+                    } else {
+                        l |= 1 << (j * 2);  // color_min
+                    }
+                } else {
+                    if (distance < 1) {
+                        l |= 1 << (j * 2);  // color_min
+                    } else if (distance < 3) {
+                        l |= 3 << (j * 2);  // 1/3 * color_min + 2/3 * color_max
+                    } else if (distance < 5) {
+                        l |= 2 << (j * 2);  // 2/3 * color_min + 1/3 * color_max
+                    } else {
+                        // color_max
+                    }
+                }
+            }
+            *dst++ = l;
+        }
+
+        state->x += im->pixelsize * 4;
+
+        if (state->x >= state->xsize * im->pixelsize) {
+            state->x = 0;
+            state->y += 4;
+            if (state->y >= state->ysize) {
+                state->errcode = IMAGING_CODEC_END;
+                break;
+            }
+        }
+    }
+
+    return dst - buf;
+}
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 0c2d3fc2e34..0fc191d158b 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -567,6 +567,8 @@ typedef int (*ImagingCodec)(
 extern int
 ImagingBcnDecode(Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
 extern int
+ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);
+extern int
 ImagingBitDecode(Imaging im, ImagingCodecState state, UINT8 *buffer, Py_ssize_t bytes);
 extern int
 ImagingEpsEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes);

From 9430bbe5a133c6e5ccb2ce23e0ea1f7f6adca0fe Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 13 Mar 2025 23:53:08 +1100
Subject: [PATCH 1546/2374] Added DXT5 saving

---
 Tests/test_file_dds.py     |  29 +++-
 src/PIL/DdsImagePlugin.py  |  28 ++--
 src/encode.c               |  11 +-
 src/libImaging/BcnEncode.c | 271 ++++++++++++++++++++++++-------------
 4 files changed, 228 insertions(+), 111 deletions(-)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 7a6099ce77d..17d88451f09 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -398,21 +398,48 @@ def test_save(mode: str, test_file: str, tmp_path: Path) -> None:
 
 
 def test_save_dxt1(tmp_path: Path) -> None:
+    # RGB
     out = str(tmp_path / "temp.dds")
     with Image.open(TEST_FILE_DXT1) as im:
         im.convert("RGB").save(out, pixel_format="DXT1")
     assert_image_similar_tofile(im, out, 1.84)
 
+    # RGBA
     im_alpha = im.copy()
     im_alpha.putpixel((0, 0), (0, 0, 0, 0))
     im_alpha.save(out, pixel_format="DXT1")
     with Image.open(out) as reloaded:
         assert reloaded.getpixel((0, 0)) == (0, 0, 0, 0)
 
+    # L
     im_l = im.convert("L")
     im_l.save(out, pixel_format="DXT1")
-    assert_image_similar_tofile(im_l.convert("RGBA"), out, 9.25)
+    assert_image_similar_tofile(im_l.convert("RGBA"), out, 6.07)
 
+    # LA
     im_alpha.convert("LA").save(out, pixel_format="DXT1")
     with Image.open(out) as reloaded:
         assert reloaded.getpixel((0, 0)) == (0, 0, 0, 0)
+
+
+def test_save_dxt5(tmp_path: Path) -> None:
+    # RGB
+    out = str(tmp_path / "temp.dds")
+    with Image.open(TEST_FILE_DXT1) as im:
+        im.convert("RGB").save(out, pixel_format="DXT5")
+    assert_image_similar_tofile(im, out, 1.84)
+
+    # RGBA
+    with Image.open(TEST_FILE_DXT5) as im_rgba:
+        im_rgba.save(out, pixel_format="DXT5")
+    assert_image_similar_tofile(im_rgba, out, 3.69)
+
+    # L
+    im_l = im.convert("L")
+    im_l.save(out, pixel_format="DXT5")
+    assert_image_similar_tofile(im_l.convert("RGBA"), out, 6.07)
+
+    # LA
+    im_la = im_rgba.convert("LA")
+    im_la.save(out, pixel_format="DXT5")
+    assert_image_similar_tofile(im_la.convert("RGBA"), out, 8.32)
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 718f376e8ba..2d097fd1681 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -520,8 +520,16 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     flags = DDSD.CAPS | DDSD.HEIGHT | DDSD.WIDTH | DDSD.PIXELFORMAT
     bitcount = len(im.getbands()) * 8
-    raw = im.encoderinfo.get("pixel_format") != "DXT1"
-    if raw:
+    pixel_format = im.encoderinfo.get("pixel_format")
+    if pixel_format in ("DXT1", "DXT5"):
+        codec_name = "bcn"
+        flags |= DDSD.LINEARSIZE
+        pitch = (im.width + 3) * 4
+        args = pixel_format
+        rgba_mask = [0, 0, 0, 0]
+        pixel_flags = DDPF.FOURCC
+        fourcc = D3DFMT.DXT1 if pixel_format == "DXT1" else D3DFMT.DXT5
+    else:
         codec_name = "raw"
         flags |= DDSD.PITCH
         pitch = (im.width * bitcount + 7) // 8
@@ -529,14 +537,14 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         alpha = im.mode[-1] == "A"
         if im.mode[0] == "L":
             pixel_flags = DDPF.LUMINANCE
-            rawmode = im.mode
+            args = im.mode
             if alpha:
                 rgba_mask = [0x000000FF, 0x000000FF, 0x000000FF]
             else:
                 rgba_mask = [0xFF000000, 0xFF000000, 0xFF000000]
         else:
             pixel_flags = DDPF.RGB
-            rawmode = im.mode[::-1]
+            args = im.mode[::-1]
             rgba_mask = [0x00FF0000, 0x0000FF00, 0x000000FF]
 
             if alpha:
@@ -546,15 +554,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             pixel_flags |= DDPF.ALPHAPIXELS
         rgba_mask.append(0xFF000000 if alpha else 0)
 
-        fourcc = 0
-    else:
-        codec_name = "bcn"
-        flags |= DDSD.LINEARSIZE
-        pitch = (im.width + 3) * 4
-        rawmode = None
-        rgba_mask = [0, 0, 0, 0]
-        pixel_flags = DDPF.FOURCC
-        fourcc = D3DFMT.DXT1
+        fourcc = D3DFMT.UNKNOWN
     fp.write(
         o32(DDS_MAGIC)
         + struct.pack(
@@ -573,7 +573,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         + struct.pack("<4I", *rgba_mask)  # dwRGBABitMask
         + struct.pack("<5I", DDSCAPS.TEXTURE, 0, 0, 0, 0)
     )
-    ImageFile._save(im, fp, [ImageFile._Tile(codec_name, (0, 0) + im.size, 0, rawmode)])
+    ImageFile._save(im, fp, [ImageFile._Tile(codec_name, (0, 0) + im.size, 0, args)])
 
 
 def _accept(prefix: bytes) -> bool:
diff --git a/src/encode.c b/src/encode.c
index d27783f0cfc..e228237f2bc 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -27,6 +27,7 @@
 
 #include "thirdparty/pythoncapi_compat.h"
 #include "libImaging/Imaging.h"
+#include "libImaging/Bcn.h"
 #include "libImaging/Gif.h"
 
 #ifdef HAVE_UNISTD_H
@@ -358,13 +359,21 @@ PyObject *
 PyImaging_BcnEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    encoder = PyImaging_EncoderNew(0);
+    char *mode;
+    char *pixel_format;
+    if (!PyArg_ParseTuple(args, "ss", &mode, &pixel_format)) {
+        return NULL;
+    }
+
+    encoder = PyImaging_EncoderNew(sizeof(BCNSTATE));
     if (encoder == NULL) {
         return NULL;
     }
 
     encoder->encode = ImagingBcnEncode;
 
+    ((BCNSTATE *)encoder->state.context)->pixel_format = pixel_format;
+
     return (PyObject *)encoder;
 }
 
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 42a46358cac..57353246a4c 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -17,8 +17,7 @@ typedef struct {
 } rgb;
 
 typedef struct {
-    UINT8 color[3];
-    int alpha;
+    UINT8 color[4];
 } rgba;
 
 static rgb
@@ -46,116 +45,198 @@ encode_565(rgba item) {
     return (r << (5 + 6)) | (g << 5) | b;
 }
 
-int
-ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
-    UINT8 *dst = buf;
+static void
+encode_bc1_color(Imaging im, ImagingCodecState state, UINT8 *dst, int separate_alpha) {
+    int i, j, k;
+    UINT16 color_min = 0, color_max = 0;
+    rgb color_min_rgb, color_max_rgb;
+    rgba block[16], *current_rgba;
+
+    // Determine the min and max colors in this 4x4 block
+    int first = 1;
+    int transparency = 0;
+    for (i = 0; i < 4; i++) {
+        for (j = 0; j < 4; j++) {
+            int x = state->x + i * im->pixelsize;
+            int y = state->y + j;
+            if (x >= state->xsize * im->pixelsize || y >= state->ysize) {
+                // The 4x4 block extends past the edge of the image
+                continue;
+            }
 
-    for (;;) {
-        int i, j, k;
-        UINT16 color_min = 0, color_max = 0;
-        rgb color_min_rgb, color_max_rgb;
-        rgba block[16], *current_rgba;
-
-        // Determine the min and max colors in this 4x4 block
-        int has_alpha_channel =
-            strcmp(im->mode, "RGBA") == 0 || strcmp(im->mode, "LA") == 0;
-        int first = 1;
-        int transparency = 0;
-        for (i = 0; i < 4; i++) {
-            for (j = 0; j < 4; j++) {
-                int x = state->x + i * im->pixelsize;
-                int y = state->y + j;
-                if (x >= state->xsize * im->pixelsize || y >= state->ysize) {
-                    // The 4x4 block extends past the edge of the image
+            current_rgba = &block[i + j * 4];
+            for (k = 0; k < 3; k++) {
+                current_rgba->color[k] =
+                    (UINT8)im->image[y][x + (im->pixelsize == 1 ? 0 : k)];
+            }
+            if (separate_alpha) {
+                if ((UINT8)im->image[y][x + 3] == 0) {
+                    current_rgba->color[3] = 0;
+                    transparency = 1;
                     continue;
+                } else {
+                    current_rgba->color[3] = 1;
                 }
+            }
 
-                current_rgba = &block[i + j * 4];
-                for (k = 0; k < 3; k++) {
-                    current_rgba->color[k] =
-                        (UINT8)im->image[y][x + (im->pixelsize == 1 ? 0 : k)];
-                }
-                if (has_alpha_channel) {
-                    if ((UINT8)im->image[y][x + 3] == 0) {
-                        current_rgba->alpha = 0;
-                        transparency = 1;
-                        continue;
-                    } else {
-                        current_rgba->alpha = 1;
-                    }
-                }
+            UINT16 color = encode_565(*current_rgba);
+            if (first || color < color_min) {
+                color_min = color;
+            }
+            if (first || color > color_max) {
+                color_max = color;
+            }
+            first = 0;
+        }
+    }
+
+    if (transparency) {
+        *dst++ = color_min;
+        *dst++ = color_min >> 8;
+    }
+    *dst++ = color_max;
+    *dst++ = color_max >> 8;
+    if (!transparency) {
+        *dst++ = color_min;
+        *dst++ = color_min >> 8;
+    }
+
+    color_min_rgb = decode_565(color_min);
+    color_max_rgb = decode_565(color_max);
+    for (i = 0; i < 4; i++) {
+        UINT8 l = 0;
+        for (j = 3; j > -1; j--) {
+            current_rgba = &block[i * 4 + j];
+            if (transparency && !current_rgba->color[3]) {
+                l |= 3 << (j * 2);
+                continue;
+            }
 
-                UINT16 color = encode_565(*current_rgba);
-                if (first || color < color_min) {
-                    color_min = color;
+            float distance = 0;
+            int total = 0;
+            for (k = 0; k < 3; k++) {
+                float denom =
+                    (float)abs(color_max_rgb.color[k] - color_min_rgb.color[k]);
+                if (denom != 0) {
+                    distance +=
+                        abs(current_rgba->color[k] - color_min_rgb.color[k]) / denom;
+                    total += 1;
                 }
-                if (first || color > color_max) {
-                    color_max = color;
+            }
+            if (total == 0) {
+                continue;
+            }
+            if (transparency) {
+                distance *= 4 / total;
+                if (distance < 1) {
+                    // color_max
+                } else if (distance < 3) {
+                    l |= 2 << (j * 2);  // 1/2 * color_min + 1/2 * color_max
+                } else {
+                    l |= 1 << (j * 2);  // color_min
+                }
+            } else {
+                distance *= 6 / total;
+                if (distance < 1) {
+                    l |= 1 << (j * 2);  // color_min
+                } else if (distance < 3) {
+                    l |= 3 << (j * 2);  // 1/3 * color_min + 2/3 * color_max
+                } else if (distance < 5) {
+                    l |= 2 << (j * 2);  // 2/3 * color_min + 1/3 * color_max
+                } else {
+                    // color_max
                 }
-                first = 0;
             }
         }
+        *dst++ = l;
+    }
+}
+
+static void
+encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
+    int i, j;
+    UINT8 alpha_min = 0, alpha_max = 0;
+    UINT8 block[16], current_alpha;
+
+    // Determine the min and max colors in this 4x4 block
+    int first = 1;
+    for (i = 0; i < 4; i++) {
+        for (j = 0; j < 4; j++) {
+            int x = state->x + i * im->pixelsize;
+            int y = state->y + j;
+            if (x >= state->xsize * im->pixelsize || y >= state->ysize) {
+                // The 4x4 block extends past the edge of the image
+                continue;
+            }
 
-        if (transparency) {
-            *dst++ = color_min;
-            *dst++ = color_min >> 8;
+            current_alpha = (UINT8)im->image[y][x + 3];
+            block[i + j * 4] = current_alpha;
+
+            if (first || current_alpha < alpha_min) {
+                alpha_min = current_alpha;
+            }
+            if (first || current_alpha > alpha_max) {
+                alpha_max = current_alpha;
+            }
+            first = 0;
         }
-        *dst++ = color_max;
-        *dst++ = color_max >> 8;
-        if (!transparency) {
-            *dst++ = color_min;
-            *dst++ = color_min >> 8;
+    }
+
+    *dst++ = alpha_min;
+    *dst++ = alpha_max;
+
+    float denom = (float)abs(alpha_max - alpha_min);
+    for (i = 0; i < 2; i++) {
+        UINT32 l = 0;
+        for (j = 7; j > -1; j--) {
+            current_alpha = block[i * 8 + j];
+            if (!current_alpha) {
+                l |= 6 << (j * 3);
+                continue;
+            } else if (current_alpha == 255 || denom == 0) {
+                l |= 7 << (j * 3);
+                continue;
+            }
+
+            float distance = abs(current_alpha - alpha_min) / denom * 10;
+            if (distance < 3) {
+                l |= 2 << (j * 3);  // 4/5 * alpha_min + 1/5 * alpha_max
+            } else if (distance < 5) {
+                l |= 3 << (j * 3);  // 3/5 * alpha_min + 2/5 * alpha_max
+            } else if (distance < 7) {
+                l |= 4 << (j * 3);  // 2/5 * alpha_min + 3/5 * alpha_max
+            } else {
+                l |= 5 << (j * 3);  // 1/5 * alpha_min + 4/5 * alpha_max
+            }
         }
+        *dst++ = l;
+        *dst++ = l >> 8;
+        *dst++ = l >> 16;
+    }
+}
 
-        color_min_rgb = decode_565(color_min);
-        color_max_rgb = decode_565(color_max);
-        for (i = 0; i < 4; i++) {
-            UINT8 l = 0;
-            for (j = 3; j > -1; j--) {
-                current_rgba = &block[i * 4 + j];
-                if (transparency && !current_rgba->alpha) {
-                    l |= 3 << (j * 2);
-                    continue;
-                }
+int
+ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
+    char *pixel_format = ((BCNSTATE *)state->context)->pixel_format;
+    int n = strcmp(pixel_format, "DXT5") == 0 ? 3 : 1;
+    int has_alpha_channel =
+        strcmp(im->mode, "RGBA") == 0 || strcmp(im->mode, "LA") == 0;
 
-                float distance = 0;
-                int total = 0;
-                for (k = 0; k < 3; k++) {
-                    float denom =
-                        (float)abs(color_max_rgb.color[k] - color_min_rgb.color[k]);
-                    if (denom != 0) {
-                        distance +=
-                            abs(current_rgba->color[k] - color_min_rgb.color[k]) /
-                            denom;
-                        total += 1;
-                    }
-                }
-                if (total == 0) {
-                    continue;
-                }
-                distance *= 6 / total;
-                if (transparency) {
-                    if (distance < 1.5) {
-                        // color_max
-                    } else if (distance < 4.5) {
-                        l |= 2 << (j * 2);  // 1/2 * color_min + 1/2 * color_max
-                    } else {
-                        l |= 1 << (j * 2);  // color_min
-                    }
-                } else {
-                    if (distance < 1) {
-                        l |= 1 << (j * 2);  // color_min
-                    } else if (distance < 3) {
-                        l |= 3 << (j * 2);  // 1/3 * color_min + 2/3 * color_max
-                    } else if (distance < 5) {
-                        l |= 2 << (j * 2);  // 2/3 * color_min + 1/3 * color_max
-                    } else {
-                        // color_max
-                    }
+    UINT8 *dst = buf;
+
+    for (;;) {
+        if (n == 3) {
+            if (has_alpha_channel) {
+                encode_bc3_alpha(im, state, dst);
+                dst += 8;
+            } else {
+                for (int i = 0; i < 8; i++) {
+                    *dst++ = 0xff;
                 }
             }
-            *dst++ = l;
         }
+        encode_bc1_color(im, state, dst, n == 1 && has_alpha_channel);
+        dst += 8;
 
         state->x += im->pixelsize * 4;
 

From 9f619b814f65a99c2107852027ecf7db4ddec7ec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Mar 2025 00:21:34 +1100
Subject: [PATCH 1547/2374] Added BC3 loading and saving

---
 Tests/test_file_dds.py     | 14 ++++++++++++++
 src/PIL/DdsImagePlugin.py  | 17 +++++++++++++++--
 src/libImaging/BcnEncode.c |  2 +-
 3 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 17d88451f09..3c7c8e604ee 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -12,6 +12,7 @@
 from .helper import (
     assert_image_equal,
     assert_image_equal_tofile,
+    assert_image_similar,
     assert_image_similar_tofile,
     hopper,
 )
@@ -114,6 +115,19 @@ def test_sanity_ati1_bc4u(image_path: str) -> None:
         assert_image_equal_tofile(im, TEST_FILE_ATI1.replace(".dds", ".png"))
 
 
+def test_dx10_bc3(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.dds")
+    with Image.open(TEST_FILE_DXT5) as im:
+        im.save(out, pixel_format="BC3")
+
+    with Image.open(out) as reloaded:
+        assert reloaded.format == "DDS"
+        assert reloaded.mode == "RGBA"
+        assert reloaded.size == (256, 256)
+
+        assert_image_similar(im, reloaded, 3.69)
+
+
 @pytest.mark.parametrize(
     "image_path",
     (
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 2d097fd1681..a5e0a712b9c 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -419,6 +419,10 @@ def _open(self) -> None:
                     self._mode = "RGBA"
                     self.pixel_format = "BC1"
                     n = 1
+                elif dxgi_format in (DXGI_FORMAT.BC3_TYPELESS, DXGI_FORMAT.BC3_UNORM):
+                    self._mode = "RGBA"
+                    self.pixel_format = "BC3"
+                    n = 3
                 elif dxgi_format in (DXGI_FORMAT.BC4_TYPELESS, DXGI_FORMAT.BC4_UNORM):
                     self._mode = "L"
                     self.pixel_format = "BC4"
@@ -521,14 +525,18 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     flags = DDSD.CAPS | DDSD.HEIGHT | DDSD.WIDTH | DDSD.PIXELFORMAT
     bitcount = len(im.getbands()) * 8
     pixel_format = im.encoderinfo.get("pixel_format")
-    if pixel_format in ("DXT1", "DXT5"):
+    if pixel_format in ("DXT1", "BC3", "DXT5"):
         codec_name = "bcn"
         flags |= DDSD.LINEARSIZE
         pitch = (im.width + 3) * 4
         args = pixel_format
         rgba_mask = [0, 0, 0, 0]
         pixel_flags = DDPF.FOURCC
-        fourcc = D3DFMT.DXT1 if pixel_format == "DXT1" else D3DFMT.DXT5
+        fourcc = {"DXT1": D3DFMT.DXT1, "BC3": D3DFMT.DX10, "DXT5": D3DFMT.DXT5}[
+            pixel_format
+        ]
+        if fourcc == D3DFMT.DX10:
+            dxgi_format = DXGI_FORMAT.BC3_TYPELESS
     else:
         codec_name = "raw"
         flags |= DDSD.PITCH
@@ -573,6 +581,11 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         + struct.pack("<4I", *rgba_mask)  # dwRGBABitMask
         + struct.pack("<5I", DDSCAPS.TEXTURE, 0, 0, 0, 0)
     )
+    if fourcc == D3DFMT.DX10:
+        fp.write(
+            # dxgi_format, 2D resource, misc, array size, straight alpha
+            struct.pack("<5I", dxgi_format, 3, 0, 0, 1)
+        )
     ImageFile._save(im, fp, [ImageFile._Tile(codec_name, (0, 0) + im.size, 0, args)])
 
 
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 57353246a4c..66f9f39b1e3 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -218,7 +218,7 @@ encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
 int
 ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
     char *pixel_format = ((BCNSTATE *)state->context)->pixel_format;
-    int n = strcmp(pixel_format, "DXT5") == 0 ? 3 : 1;
+    int n = strcmp(pixel_format, "DXT1") == 0 ? 1 : 3;
     int has_alpha_channel =
         strcmp(im->mode, "RGBA") == 0 || strcmp(im->mode, "LA") == 0;
 

From f1a61a1e76cfbc21cd5345f4b87067ace7347ddf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Mar 2025 12:50:30 +1100
Subject: [PATCH 1548/2374] Added DXT3 saving

---
 Tests/test_file_dds.py     | 23 ++++++++++++++++++
 src/PIL/DdsImagePlugin.py  | 20 +++++++++------
 src/encode.c               |  9 +++----
 src/libImaging/BcnEncode.c | 50 ++++++++++++++++++++++++++++++++------
 4 files changed, 83 insertions(+), 19 deletions(-)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 3c7c8e604ee..5ef9fbf0589 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -436,6 +436,29 @@ def test_save_dxt1(tmp_path: Path) -> None:
         assert reloaded.getpixel((0, 0)) == (0, 0, 0, 0)
 
 
+def test_save_dxt3(tmp_path: Path) -> None:
+    # RGB
+    out = str(tmp_path / "temp.dds")
+    with Image.open(TEST_FILE_DXT3) as im:
+        im_rgb = im.convert("RGB")
+    im_rgb.save(out, pixel_format="DXT3")
+    assert_image_similar_tofile(im_rgb.convert("RGBA"), out, 1.26)
+
+    # RGBA
+    im.save(out, pixel_format="DXT3")
+    assert_image_similar_tofile(im, out, 3.81)
+
+    # L
+    im_l = im.convert("L")
+    im_l.save(out, pixel_format="DXT3")
+    assert_image_similar_tofile(im_l.convert("RGBA"), out, 5.89)
+
+    # LA
+    im_la = im.convert("LA")
+    im_la.save(out, pixel_format="DXT3")
+    assert_image_similar_tofile(im_la.convert("RGBA"), out, 8.44)
+
+
 def test_save_dxt5(tmp_path: Path) -> None:
     # RGB
     out = str(tmp_path / "temp.dds")
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index a5e0a712b9c..c30672c865a 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -525,18 +525,24 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     flags = DDSD.CAPS | DDSD.HEIGHT | DDSD.WIDTH | DDSD.PIXELFORMAT
     bitcount = len(im.getbands()) * 8
     pixel_format = im.encoderinfo.get("pixel_format")
-    if pixel_format in ("DXT1", "BC3", "DXT5"):
+    args: tuple[int] | str
+    if pixel_format in ("DXT1", "DXT3", "BC3", "DXT5"):
         codec_name = "bcn"
         flags |= DDSD.LINEARSIZE
         pitch = (im.width + 3) * 4
-        args = pixel_format
         rgba_mask = [0, 0, 0, 0]
         pixel_flags = DDPF.FOURCC
-        fourcc = {"DXT1": D3DFMT.DXT1, "BC3": D3DFMT.DX10, "DXT5": D3DFMT.DXT5}[
-            pixel_format
-        ]
-        if fourcc == D3DFMT.DX10:
-            dxgi_format = DXGI_FORMAT.BC3_TYPELESS
+        if pixel_format == "DXT1":
+            fourcc = D3DFMT.DXT1
+            args = (1,)
+        elif pixel_format == "DXT3":
+            fourcc = D3DFMT.DXT3
+            args = (2,)
+        else:
+            fourcc = D3DFMT.DXT5 if pixel_format == "DXT5" else D3DFMT.DX10
+            args = (3,)
+            if fourcc == D3DFMT.DX10:
+                dxgi_format = DXGI_FORMAT.BC3_TYPELESS
     else:
         codec_name = "raw"
         flags |= DDSD.PITCH
diff --git a/src/encode.c b/src/encode.c
index e228237f2bc..7c365a74f7d 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -360,19 +360,18 @@ PyImaging_BcnEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
     char *mode;
-    char *pixel_format;
-    if (!PyArg_ParseTuple(args, "ss", &mode, &pixel_format)) {
+    int n;
+    if (!PyArg_ParseTuple(args, "si", &mode, &n)) {
         return NULL;
     }
 
-    encoder = PyImaging_EncoderNew(sizeof(BCNSTATE));
+    encoder = PyImaging_EncoderNew(0);
     if (encoder == NULL) {
         return NULL;
     }
 
     encoder->encode = ImagingBcnEncode;
-
-    ((BCNSTATE *)encoder->state.context)->pixel_format = pixel_format;
+    encoder->state.state = n;
 
     return (PyObject *)encoder;
 }
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 66f9f39b1e3..4e0da322e02 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -10,8 +10,6 @@
 
 #include "Imaging.h"
 
-#include "Bcn.h"
-
 typedef struct {
     UINT8 color[3];
 } rgb;
@@ -57,14 +55,18 @@ encode_bc1_color(Imaging im, ImagingCodecState state, UINT8 *dst, int separate_a
     int transparency = 0;
     for (i = 0; i < 4; i++) {
         for (j = 0; j < 4; j++) {
+            current_rgba = &block[i + j * 4];
+
             int x = state->x + i * im->pixelsize;
             int y = state->y + j;
             if (x >= state->xsize * im->pixelsize || y >= state->ysize) {
                 // The 4x4 block extends past the edge of the image
+                for (k = 0; k < 3; k++) {
+                    current_rgba->color[k] = 0;
+                }
                 continue;
             }
 
-            current_rgba = &block[i + j * 4];
             for (k = 0; k < 3; k++) {
                 current_rgba->color[k] =
                     (UINT8)im->image[y][x + (im->pixelsize == 1 ? 0 : k)];
@@ -152,6 +154,36 @@ encode_bc1_color(Imaging im, ImagingCodecState state, UINT8 *dst, int separate_a
     }
 }
 
+static void
+encode_bc2_block(Imaging im, ImagingCodecState state, UINT8 *dst) {
+    int i, j;
+    UINT8 block[16], current_alpha;
+    for (i = 0; i < 4; i++) {
+        for (j = 0; j < 4; j++) {
+            int x = state->x + i * im->pixelsize;
+            int y = state->y + j;
+            if (x >= state->xsize * im->pixelsize || y >= state->ysize) {
+                // The 4x4 block extends past the edge of the image
+                block[i + j * 4] = 0;
+                continue;
+            }
+
+            current_alpha = (UINT8)im->image[y][x + 3];
+            block[i + j * 4] = current_alpha;
+        }
+    }
+
+    for (i = 0; i < 4; i++) {
+        UINT16 l = 0;
+        for (j = 3; j > -1; j--) {
+            current_alpha = block[i * 4 + j];
+            l |= current_alpha << (j * 4);
+        }
+        *dst++ = l;
+        *dst++ = l >> 8;
+    }
+}
+
 static void
 encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
     int i, j;
@@ -166,6 +198,7 @@ encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
             int y = state->y + j;
             if (x >= state->xsize * im->pixelsize || y >= state->ysize) {
                 // The 4x4 block extends past the edge of the image
+                block[i + j * 4] = 0;
                 continue;
             }
 
@@ -217,17 +250,20 @@ encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
 
 int
 ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
-    char *pixel_format = ((BCNSTATE *)state->context)->pixel_format;
-    int n = strcmp(pixel_format, "DXT1") == 0 ? 1 : 3;
+    int n = state->state;
     int has_alpha_channel =
         strcmp(im->mode, "RGBA") == 0 || strcmp(im->mode, "LA") == 0;
 
     UINT8 *dst = buf;
 
     for (;;) {
-        if (n == 3) {
+        if (n == 2 || n == 3) {
             if (has_alpha_channel) {
-                encode_bc3_alpha(im, state, dst);
+                if (n == 2) {
+                    encode_bc2_block(im, state, dst);
+                } else {
+                    encode_bc3_alpha(im, state, dst);
+                }
                 dst += 8;
             } else {
                 for (int i = 0; i < 8; i++) {

From b0315cc6039e1eabacc36b7af0677f69378f26bd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Mar 2025 12:56:32 +1100
Subject: [PATCH 1549/2374] Added BC2 loading and saving

---
 Tests/test_file_dds.py    | 13 +++++++++++++
 src/PIL/DdsImagePlugin.py | 18 ++++++++++++++----
 2 files changed, 27 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 5ef9fbf0589..3239065d7ba 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -115,6 +115,19 @@ def test_sanity_ati1_bc4u(image_path: str) -> None:
         assert_image_equal_tofile(im, TEST_FILE_ATI1.replace(".dds", ".png"))
 
 
+def test_dx10_bc2(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.dds")
+    with Image.open(TEST_FILE_DXT3) as im:
+        im.save(out, pixel_format="BC2")
+
+    with Image.open(out) as reloaded:
+        assert reloaded.format == "DDS"
+        assert reloaded.mode == "RGBA"
+        assert reloaded.size == (256, 256)
+
+        assert_image_similar(im, reloaded, 3.81)
+
+
 def test_dx10_bc3(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.dds")
     with Image.open(TEST_FILE_DXT5) as im:
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index c30672c865a..d65e3fc651e 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -419,6 +419,10 @@ def _open(self) -> None:
                     self._mode = "RGBA"
                     self.pixel_format = "BC1"
                     n = 1
+                elif dxgi_format in (DXGI_FORMAT.BC2_TYPELESS, DXGI_FORMAT.BC2_UNORM):
+                    self._mode = "RGBA"
+                    self.pixel_format = "BC2"
+                    n = 2
                 elif dxgi_format in (DXGI_FORMAT.BC3_TYPELESS, DXGI_FORMAT.BC3_UNORM):
                     self._mode = "RGBA"
                     self.pixel_format = "BC3"
@@ -526,7 +530,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     bitcount = len(im.getbands()) * 8
     pixel_format = im.encoderinfo.get("pixel_format")
     args: tuple[int] | str
-    if pixel_format in ("DXT1", "DXT3", "BC3", "DXT5"):
+    if pixel_format in ("DXT1", "BC2", "DXT3", "BC3", "DXT5"):
         codec_name = "bcn"
         flags |= DDSD.LINEARSIZE
         pitch = (im.width + 3) * 4
@@ -538,10 +542,16 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         elif pixel_format == "DXT3":
             fourcc = D3DFMT.DXT3
             args = (2,)
-        else:
-            fourcc = D3DFMT.DXT5 if pixel_format == "DXT5" else D3DFMT.DX10
+        elif pixel_format == "DXT5":
+            fourcc = D3DFMT.DXT5
             args = (3,)
-            if fourcc == D3DFMT.DX10:
+        else:
+            fourcc = D3DFMT.DX10
+            if pixel_format == "BC2":
+                args = (2,)
+                dxgi_format = DXGI_FORMAT.BC2_TYPELESS
+            else:
+                args = (3,)
                 dxgi_format = DXGI_FORMAT.BC3_TYPELESS
     else:
         codec_name = "raw"

From cd11792c15c60db34b1d506c816d753174422f86 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Mar 2025 20:16:33 +1100
Subject: [PATCH 1550/2374] Added BC5 saving

---
 Tests/test_file_dds.py     | 20 +++++++++++++++++++-
 src/PIL/DdsImagePlugin.py  | 13 +++++++++++--
 src/libImaging/BcnEncode.c | 38 +++++++++++++++++++++++---------------
 3 files changed, 53 insertions(+), 18 deletions(-)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 3239065d7ba..9a6042660c1 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -402,7 +402,7 @@ def test_not_implemented(test_file: str) -> None:
 def test_save_unsupported_mode(tmp_path: Path) -> None:
     out = str(tmp_path / "temp.dds")
     im = hopper("HSV")
-    with pytest.raises(OSError):
+    with pytest.raises(OSError, match="cannot write mode HSV as DDS"):
         im.save(out)
 
 
@@ -424,6 +424,13 @@ def test_save(mode: str, test_file: str, tmp_path: Path) -> None:
         assert_image_equal_tofile(im, out)
 
 
+def test_save_unsupported_pixel_format(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.dds")
+    im = hopper()
+    with pytest.raises(OSError, match="cannot write pixel format UNKNOWN"):
+        im.save(out, pixel_format="UNKNOWN")
+
+
 def test_save_dxt1(tmp_path: Path) -> None:
     # RGB
     out = str(tmp_path / "temp.dds")
@@ -493,3 +500,14 @@ def test_save_dxt5(tmp_path: Path) -> None:
     im_la = im_rgba.convert("LA")
     im_la.save(out, pixel_format="DXT5")
     assert_image_similar_tofile(im_la.convert("RGBA"), out, 8.32)
+
+
+def test_save_dx10_bc5(tmp_path: Path) -> None:
+    out = str(tmp_path / "temp.dds")
+    with Image.open(TEST_FILE_DX10_BC5_TYPELESS) as im:
+        im.save(out, pixel_format="BC5")
+    assert_image_similar_tofile(im, out, 9.56)
+
+    im = hopper("L")
+    with pytest.raises(OSError, match="only RGB mode can be written as BC5"):
+        im.save(out, pixel_format="BC5")
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index d65e3fc651e..26307817c91 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -530,7 +530,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     bitcount = len(im.getbands()) * 8
     pixel_format = im.encoderinfo.get("pixel_format")
     args: tuple[int] | str
-    if pixel_format in ("DXT1", "BC2", "DXT3", "BC3", "DXT5"):
+    if pixel_format:
         codec_name = "bcn"
         flags |= DDSD.LINEARSIZE
         pitch = (im.width + 3) * 4
@@ -550,9 +550,18 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             if pixel_format == "BC2":
                 args = (2,)
                 dxgi_format = DXGI_FORMAT.BC2_TYPELESS
-            else:
+            elif pixel_format == "BC3":
                 args = (3,)
                 dxgi_format = DXGI_FORMAT.BC3_TYPELESS
+            elif pixel_format == "BC5":
+                args = (5,)
+                dxgi_format = DXGI_FORMAT.BC5_TYPELESS
+                if im.mode != "RGB":
+                    msg = "only RGB mode can be written as BC5"
+                    raise OSError(msg)
+            else:
+                msg = f"cannot write pixel format {pixel_format}"
+                raise OSError(msg)
     else:
         codec_name = "raw"
         flags |= DDSD.PITCH
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 4e0da322e02..2bad73b9261 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -185,7 +185,7 @@ encode_bc2_block(Imaging im, ImagingCodecState state, UINT8 *dst) {
 }
 
 static void
-encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
+encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst, int o) {
     int i, j;
     UINT8 alpha_min = 0, alpha_max = 0;
     UINT8 block[16], current_alpha;
@@ -202,7 +202,7 @@ encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
                 continue;
             }
 
-            current_alpha = (UINT8)im->image[y][x + 3];
+            current_alpha = (UINT8)im->image[y][x + o];
             block[i + j * 4] = current_alpha;
 
             if (first || current_alpha < alpha_min) {
@@ -226,12 +226,13 @@ encode_bc3_alpha(Imaging im, ImagingCodecState state, UINT8 *dst) {
             if (!current_alpha) {
                 l |= 6 << (j * 3);
                 continue;
-            } else if (current_alpha == 255 || denom == 0) {
+            } else if (current_alpha == 255) {
                 l |= 7 << (j * 3);
                 continue;
             }
 
-            float distance = abs(current_alpha - alpha_min) / denom * 10;
+            float distance =
+                denom == 0 ? 0 : abs(current_alpha - alpha_min) / denom * 10;
             if (distance < 3) {
                 l |= 2 << (j * 3);  // 4/5 * alpha_min + 1/5 * alpha_max
             } else if (distance < 5) {
@@ -257,21 +258,28 @@ ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
     UINT8 *dst = buf;
 
     for (;;) {
-        if (n == 2 || n == 3) {
-            if (has_alpha_channel) {
-                if (n == 2) {
-                    encode_bc2_block(im, state, dst);
+        if (n == 5) {
+            encode_bc3_alpha(im, state, dst, 0);
+            dst += 8;
+
+            encode_bc3_alpha(im, state, dst, 1);
+        } else {
+            if (n == 2 || n == 3) {
+                if (has_alpha_channel) {
+                    if (n == 2) {
+                        encode_bc2_block(im, state, dst);
+                    } else {
+                        encode_bc3_alpha(im, state, dst, 3);
+                    }
+                    dst += 8;
                 } else {
-                    encode_bc3_alpha(im, state, dst);
-                }
-                dst += 8;
-            } else {
-                for (int i = 0; i < 8; i++) {
-                    *dst++ = 0xff;
+                    for (int i = 0; i < 8; i++) {
+                        *dst++ = 0xff;
+                    }
                 }
             }
+            encode_bc1_color(im, state, dst, n == 1 && has_alpha_channel);
         }
-        encode_bc1_color(im, state, dst, n == 1 && has_alpha_channel);
         dst += 8;
 
         state->x += im->pixelsize * 4;

From 841ba163fd9fc6e1cf04837515c6208d67032a9a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 18 Mar 2025 00:21:08 +1100
Subject: [PATCH 1551/2374] If every tile covers the image, only use the last
 offset

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

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 2b471abac0a..39783f1f8b9 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1608,6 +1608,10 @@ def _setup(self) -> None:
                     raise ValueError(msg)
                 w = tilewidth
 
+            if w == xsize and h == ysize and self._planar_configuration != 2:
+                # Every tile covers the image. Only use the last offset
+                offsets = offsets[-1:]
+
             for offset in offsets:
                 if x + w > xsize:
                     stride = w * sum(bps_tuple) / 8  # bytes per line
@@ -1630,11 +1634,11 @@ def _setup(self) -> None:
                         args,
                     )
                 )
-                x = x + w
+                x += w
                 if x >= xsize:
                     x, y = 0, y + h
                     if y >= ysize:
-                        x = y = 0
+                        y = 0
                         layer += 1
         else:
             logger.debug("- unsupported data organization")

From ba2c4291ea009a91e52512abb0258289b72d74d3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 19 Mar 2025 19:22:15 +1100
Subject: [PATCH 1552/2374] Updated comment

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

diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index c2dde4431e7..1716a18ccda 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -238,7 +238,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     cur_idx = im.tell()
     try:
         for ims in [im] + append_images:
-            # Get # of frames in this image
+            # Get number of frames in this image
             nfr = getattr(ims, "n_frames", 1)
 
             for idx in range(nfr):

From 6cc5f1f0adee0ed79bd6a4595b90933939926645 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 19 Mar 2025 20:58:40 +1100
Subject: [PATCH 1553/2374] Simplified code

---
 Tests/check_j2k_overflow.py       |  2 +-
 Tests/check_large_memory.py       |  2 +-
 Tests/check_large_memory_numpy.py |  2 +-
 Tests/helper.py                   |  8 ++-
 Tests/test_file_apng.py           | 20 +++----
 Tests/test_file_blp.py            |  4 +-
 Tests/test_file_bmp.py            | 12 ++--
 Tests/test_file_bufrstub.py       |  4 +-
 Tests/test_file_dds.py            | 18 +++---
 Tests/test_file_eps.py            |  4 +-
 Tests/test_file_gif.py            | 98 +++++++++++++++----------------
 Tests/test_file_gribstub.py       |  4 +-
 Tests/test_file_hdf5stub.py       |  2 +-
 Tests/test_file_icns.py           |  4 +-
 Tests/test_file_ico.py            | 24 ++++----
 Tests/test_file_im.py             |  8 +--
 Tests/test_file_jpeg.py           | 38 ++++++------
 Tests/test_file_jpeg2k.py         |  6 +-
 Tests/test_file_libtiff.py        | 66 ++++++++++-----------
 Tests/test_file_msp.py            |  4 +-
 Tests/test_file_palm.py           |  4 +-
 Tests/test_file_pcx.py            |  4 +-
 Tests/test_file_pdf.py            | 12 ++--
 Tests/test_file_png.py            | 30 +++++-----
 Tests/test_file_ppm.py            | 36 ++++++------
 Tests/test_file_sgi.py            |  8 +--
 Tests/test_file_spider.py         |  2 +-
 Tests/test_file_tga.py            | 18 +++---
 Tests/test_file_tiff.py           | 48 +++++++--------
 Tests/test_file_tiff_metadata.py  | 38 ++++++------
 Tests/test_file_webp_alpha.py     | 12 ++--
 Tests/test_file_webp_animated.py  | 18 +++---
 Tests/test_file_webp_lossless.py  |  2 +-
 Tests/test_file_webp_metadata.py  |  2 +-
 Tests/test_file_wmf.py            |  4 +-
 Tests/test_file_xbm.py            |  4 +-
 Tests/test_image.py               | 22 +++----
 Tests/test_image_convert.py       |  6 +-
 Tests/test_image_resize.py        |  2 +-
 Tests/test_image_split.py         |  4 +-
 Tests/test_imagefont.py           |  2 +-
 Tests/test_imagesequence.py       |  2 +-
 Tests/test_imagewin_pointers.py   |  2 +-
 Tests/test_mode_i16.py            |  2 +-
 Tests/test_pickle.py              |  6 +-
 Tests/test_psdraw.py              |  2 +-
 Tests/test_shell_injection.py     |  2 +-
 Tests/test_tiff_ifdrational.py    |  2 +-
 48 files changed, 315 insertions(+), 311 deletions(-)

diff --git a/Tests/check_j2k_overflow.py b/Tests/check_j2k_overflow.py
index dbdd5a4f557..58566c4b219 100644
--- a/Tests/check_j2k_overflow.py
+++ b/Tests/check_j2k_overflow.py
@@ -9,6 +9,6 @@
 
 def test_j2k_overflow(tmp_path: Path) -> None:
     im = Image.new("RGBA", (1024, 131584))
-    target = str(tmp_path / "temp.jpc")
+    target = tmp_path / "temp.jpc"
     with pytest.raises(OSError):
         im.save(target)
diff --git a/Tests/check_large_memory.py b/Tests/check_large_memory.py
index a9ce79e57e6..c9feda3b1b0 100644
--- a/Tests/check_large_memory.py
+++ b/Tests/check_large_memory.py
@@ -32,7 +32,7 @@
 
 
 def _write_png(tmp_path: Path, xdim: int, ydim: int) -> None:
-    f = str(tmp_path / "temp.png")
+    f = tmp_path / "temp.png"
     im = Image.new("L", (xdim, ydim), 0)
     im.save(f)
 
diff --git a/Tests/check_large_memory_numpy.py b/Tests/check_large_memory_numpy.py
index f4ca8d0aa68..458b0ab72d2 100644
--- a/Tests/check_large_memory_numpy.py
+++ b/Tests/check_large_memory_numpy.py
@@ -28,7 +28,7 @@
 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")
+    f = tmp_path / "temp.png"
     im = Image.fromarray(a, "L")
     im.save(f)
 
diff --git a/Tests/helper.py b/Tests/helper.py
index 764935f8713..909fff879c8 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -13,6 +13,7 @@
 from collections.abc import Sequence
 from functools import lru_cache
 from io import BytesIO
+from pathlib import Path
 from typing import Any, Callable
 
 import pytest
@@ -95,7 +96,10 @@ def assert_image_equal(a: Image.Image, b: Image.Image, msg: str | None = None) -
 
 
 def assert_image_equal_tofile(
-    a: Image.Image, filename: str, msg: str | None = None, mode: str | None = None
+    a: Image.Image,
+    filename: str | Path,
+    msg: str | None = None,
+    mode: str | None = None,
 ) -> None:
     with Image.open(filename) as img:
         if mode:
@@ -136,7 +140,7 @@ def assert_image_similar(
 
 def assert_image_similar_tofile(
     a: Image.Image,
-    filename: str,
+    filename: str | Path,
     epsilon: float,
     msg: str | None = None,
 ) -> None:
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index b9a03617394..abd7d510b0d 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -345,7 +345,7 @@ def test_apng_sequence_errors(test_file: str) -> None:
 
 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")
+        test_file = tmp_path / "temp.png"
         im.save(test_file, save_all=True)
 
     with Image.open(test_file) as im:
@@ -375,7 +375,7 @@ def test_apng_save(tmp_path: Path) -> None:
 
 
 def test_apng_save_alpha(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
 
     im = Image.new("RGBA", (1, 1), (255, 0, 0, 255))
     im2 = Image.new("RGBA", (1, 1), (255, 0, 0, 127))
@@ -393,7 +393,7 @@ def test_apng_save_split_fdat(tmp_path: Path) -> None:
     # frames with image data spanning multiple fdAT chunks (in this case
     # both the default image and first animation frame will span multiple
     # data chunks)
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
     with Image.open("Tests/images/old-style-jpeg-compression.png") as im:
         frames = [im.copy(), Image.new("RGBA", im.size, (255, 0, 0, 255))]
         im.save(
@@ -408,7 +408,7 @@ def test_apng_save_split_fdat(tmp_path: Path) -> None:
 
 
 def test_apng_save_duration_loop(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
     with Image.open("Tests/images/apng/delay.png") as im:
         frames = []
         durations = []
@@ -471,7 +471,7 @@ def test_apng_save_duration_loop(tmp_path: Path) -> None:
 
 
 def test_apng_save_disposal(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
     size = (128, 64)
     red = Image.new("RGBA", size, (255, 0, 0, 255))
     green = Image.new("RGBA", size, (0, 255, 0, 255))
@@ -572,7 +572,7 @@ def test_apng_save_disposal(tmp_path: Path) -> None:
 
 
 def test_apng_save_disposal_previous(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
     size = (128, 64)
     blue = Image.new("RGBA", size, (0, 0, 255, 255))
     red = Image.new("RGBA", size, (255, 0, 0, 255))
@@ -594,7 +594,7 @@ def test_apng_save_disposal_previous(tmp_path: Path) -> None:
 
 
 def test_apng_save_blend(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
     size = (128, 64)
     red = Image.new("RGBA", size, (255, 0, 0, 255))
     green = Image.new("RGBA", size, (0, 255, 0, 255))
@@ -662,7 +662,7 @@ def test_apng_save_blend(tmp_path: Path) -> None:
 
 
 def test_apng_save_size(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
 
     im = Image.new("L", (100, 100))
     im.save(test_file, save_all=True, append_images=[Image.new("L", (200, 200))])
@@ -686,7 +686,7 @@ def test_seek_after_close() -> None:
 def test_different_modes_in_later_frames(
     mode: str, default_image: bool, duplicate: bool, tmp_path: Path
 ) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
 
     im = Image.new("L", (1, 1))
     im.save(
@@ -700,7 +700,7 @@ def test_different_modes_in_later_frames(
 
 
 def test_different_durations(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.png")
+    test_file = tmp_path / "temp.png"
 
     with Image.open("Tests/images/apng/different_durations.png") as im:
         for _ in range(3):
diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index 9f2de8f982e..9f50df22d86 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -46,7 +46,7 @@ def test_invalid_file() -> None:
 
 
 def test_save(tmp_path: Path) -> None:
-    f = str(tmp_path / "temp.blp")
+    f = tmp_path / "temp.blp"
 
     for version in ("BLP1", "BLP2"):
         im = hopper("P")
@@ -56,7 +56,7 @@ def test_save(tmp_path: Path) -> None:
             assert_image_equal(im.convert("RGB"), reloaded)
 
         with Image.open("Tests/images/transparent.png") as im:
-            f = str(tmp_path / "temp.blp")
+            f = tmp_path / "temp.blp"
             im.convert("P").save(f, blp_version=version)
 
             with Image.open(f) as reloaded:
diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 2ff4160bd71..64d2acaf551 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -17,7 +17,7 @@
 
 def test_sanity(tmp_path: Path) -> None:
     def roundtrip(im: Image.Image) -> None:
-        outfile = str(tmp_path / "temp.bmp")
+        outfile = tmp_path / "temp.bmp"
 
         im.save(outfile, "BMP")
 
@@ -66,7 +66,7 @@ def test_small_palette(tmp_path: Path) -> None:
     colors = [0, 0, 0, 125, 125, 125, 255, 255, 255]
     im.putpalette(colors)
 
-    out = str(tmp_path / "temp.bmp")
+    out = tmp_path / "temp.bmp"
     im.save(out)
 
     with Image.open(out) as reloaded:
@@ -74,7 +74,7 @@ def test_small_palette(tmp_path: Path) -> None:
 
 
 def test_save_too_large(tmp_path: Path) -> None:
-    outfile = str(tmp_path / "temp.bmp")
+    outfile = tmp_path / "temp.bmp"
     with Image.new("RGB", (1, 1)) as im:
         im._size = (37838, 37838)
         with pytest.raises(ValueError):
@@ -96,7 +96,7 @@ def test_dpi() -> None:
 def test_save_bmp_with_dpi(tmp_path: Path) -> None:
     # Test for #1301
     # Arrange
-    outfile = str(tmp_path / "temp.jpg")
+    outfile = tmp_path / "temp.jpg"
     with Image.open("Tests/images/hopper.bmp") as im:
         assert im.info["dpi"] == (95.98654816726399, 95.98654816726399)
 
@@ -112,7 +112,7 @@ def test_save_bmp_with_dpi(tmp_path: Path) -> None:
 
 
 def test_save_float_dpi(tmp_path: Path) -> None:
-    outfile = str(tmp_path / "temp.bmp")
+    outfile = tmp_path / "temp.bmp"
     with Image.open("Tests/images/hopper.bmp") as im:
         im.save(outfile, dpi=(72.21216100543306, 72.21216100543306))
         with Image.open(outfile) as reloaded:
@@ -152,7 +152,7 @@ def test_dib_header_size(header_size: int, path: str) -> None:
 
 
 def test_save_dib(tmp_path: Path) -> None:
-    outfile = str(tmp_path / "temp.dib")
+    outfile = tmp_path / "temp.dib"
 
     with Image.open("Tests/images/clipboard.dib") as im:
         im.save(outfile)
diff --git a/Tests/test_file_bufrstub.py b/Tests/test_file_bufrstub.py
index fc8920317c5..362578c56ef 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -43,7 +43,7 @@ def test_load() -> None:
 def test_save(tmp_path: Path) -> None:
     # Arrange
     im = hopper()
-    tmpfile = str(tmp_path / "temp.bufr")
+    tmpfile = tmp_path / "temp.bufr"
 
     # Act / Assert: stub cannot save without an implemented handler
     with pytest.raises(OSError):
@@ -79,7 +79,7 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
         im.load()
         assert handler.is_loaded()
 
-        temp_file = str(tmp_path / "temp.bufr")
+        temp_file = tmp_path / "temp.bufr"
         im.save(temp_file)
         assert handler.saved
 
diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 9a6042660c1..3388fce164e 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -116,7 +116,7 @@ def test_sanity_ati1_bc4u(image_path: str) -> None:
 
 
 def test_dx10_bc2(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     with Image.open(TEST_FILE_DXT3) as im:
         im.save(out, pixel_format="BC2")
 
@@ -129,7 +129,7 @@ def test_dx10_bc2(tmp_path: Path) -> None:
 
 
 def test_dx10_bc3(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     with Image.open(TEST_FILE_DXT5) as im:
         im.save(out, pixel_format="BC3")
 
@@ -400,7 +400,7 @@ def test_not_implemented(test_file: str) -> None:
 
 
 def test_save_unsupported_mode(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     im = hopper("HSV")
     with pytest.raises(OSError, match="cannot write mode HSV as DDS"):
         im.save(out)
@@ -416,7 +416,7 @@ def test_save_unsupported_mode(tmp_path: Path) -> None:
     ],
 )
 def test_save(mode: str, test_file: str, tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     with Image.open(test_file) as im:
         assert im.mode == mode
         im.save(out)
@@ -425,7 +425,7 @@ def test_save(mode: str, test_file: str, tmp_path: Path) -> None:
 
 
 def test_save_unsupported_pixel_format(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     im = hopper()
     with pytest.raises(OSError, match="cannot write pixel format UNKNOWN"):
         im.save(out, pixel_format="UNKNOWN")
@@ -433,7 +433,7 @@ def test_save_unsupported_pixel_format(tmp_path: Path) -> None:
 
 def test_save_dxt1(tmp_path: Path) -> None:
     # RGB
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     with Image.open(TEST_FILE_DXT1) as im:
         im.convert("RGB").save(out, pixel_format="DXT1")
     assert_image_similar_tofile(im, out, 1.84)
@@ -458,7 +458,7 @@ def test_save_dxt1(tmp_path: Path) -> None:
 
 def test_save_dxt3(tmp_path: Path) -> None:
     # RGB
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     with Image.open(TEST_FILE_DXT3) as im:
         im_rgb = im.convert("RGB")
     im_rgb.save(out, pixel_format="DXT3")
@@ -481,7 +481,7 @@ def test_save_dxt3(tmp_path: Path) -> None:
 
 def test_save_dxt5(tmp_path: Path) -> None:
     # RGB
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     with Image.open(TEST_FILE_DXT1) as im:
         im.convert("RGB").save(out, pixel_format="DXT5")
     assert_image_similar_tofile(im, out, 1.84)
@@ -503,7 +503,7 @@ def test_save_dxt5(tmp_path: Path) -> None:
 
 
 def test_save_dx10_bc5(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.dds")
+    out = tmp_path / "temp.dds"
     with Image.open(TEST_FILE_DX10_BC5_TYPELESS) as im:
         im.save(out, pixel_format="BC5")
     assert_image_similar_tofile(im, out, 9.56)
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index a0c2f921629..f5acc532ca5 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -239,7 +239,7 @@ def test_transparency() -> None:
 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:
+        with open(tmp_path / "temp.eps", "wb") as fh:
             image1.save(fh, "EPS")
 
 
@@ -274,7 +274,7 @@ def test_1(filename: str) -> None:
 
 def test_image_mode_not_supported(tmp_path: Path) -> None:
     im = hopper("RGBA")
-    tmpfile = str(tmp_path / "temp.eps")
+    tmpfile = tmp_path / "temp.eps"
     with pytest.raises(ValueError):
         im.save(tmpfile)
 
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index dbbffc675f5..fb1a636ed1a 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -228,7 +228,7 @@ def test_optimize_if_palette_can_be_reduced_by_half() -> None:
 
 
 def test_full_palette_second_frame(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("P", (1, 256))
 
     full_palette_im = Image.new("P", (1, 256))
@@ -249,7 +249,7 @@ def test_full_palette_second_frame(tmp_path: Path) -> None:
 
 
 def test_roundtrip(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = hopper()
     im.save(out)
     with Image.open(out) as reread:
@@ -258,7 +258,7 @@ def test_roundtrip(tmp_path: Path) -> None:
 
 def test_roundtrip2(tmp_path: Path) -> None:
     # see https://github.com/python-pillow/Pillow/issues/403
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     with Image.open(TEST_GIF) as im:
         im2 = im.copy()
         im2.save(out)
@@ -268,7 +268,7 @@ def test_roundtrip2(tmp_path: Path) -> None:
 
 def test_roundtrip_save_all(tmp_path: Path) -> None:
     # Single frame image
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = hopper()
     im.save(out, save_all=True)
     with Image.open(out) as reread:
@@ -276,7 +276,7 @@ def test_roundtrip_save_all(tmp_path: Path) -> None:
 
     # Multiframe image
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
-        out = str(tmp_path / "temp.gif")
+        out = tmp_path / "temp.gif"
         im.save(out, save_all=True)
 
     with Image.open(out) as reread:
@@ -284,7 +284,7 @@ def test_roundtrip_save_all(tmp_path: Path) -> None:
 
 
 def test_roundtrip_save_all_1(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("1", (1, 1))
     im2 = Image.new("1", (1, 1), 1)
     im.save(out, save_all=True, append_images=[im2])
@@ -329,7 +329,7 @@ def test_headers_saving_for_animated_gifs(tmp_path: Path) -> None:
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
         info = im.info.copy()
 
-        out = str(tmp_path / "temp.gif")
+        out = tmp_path / "temp.gif"
         im.save(out, save_all=True)
     with Image.open(out) as reread:
         for header in important_headers:
@@ -345,7 +345,7 @@ def test_palette_handling(tmp_path: Path) -> None:
         im = im.resize((100, 100), Image.Resampling.LANCZOS)
         im2 = im.convert("P", palette=Image.Palette.ADAPTIVE, colors=256)
 
-        f = str(tmp_path / "temp.gif")
+        f = tmp_path / "temp.gif"
         im2.save(f, optimize=True)
 
     with Image.open(f) as reloaded:
@@ -356,7 +356,7 @@ def test_palette_434(tmp_path: Path) -> None:
     # see https://github.com/python-pillow/Pillow/issues/434
 
     def roundtrip(im: Image.Image, **kwargs: bool) -> Image.Image:
-        out = str(tmp_path / "temp.gif")
+        out = tmp_path / "temp.gif"
         im.copy().save(out, "GIF", **kwargs)
         reloaded = Image.open(out)
 
@@ -599,7 +599,7 @@ def test_previous_frame_loaded() -> None:
 
 
 def test_save_dispose(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im_list = [
         Image.new("L", (100, 100), "#000"),
         Image.new("L", (100, 100), "#111"),
@@ -627,7 +627,7 @@ def test_save_dispose(tmp_path: Path) -> None:
 
 
 def test_dispose2_palette(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     # Four colors: white, gray, black, red
     circles = [(255, 255, 255), (153, 153, 153), (0, 0, 0), (255, 0, 0)]
@@ -661,7 +661,7 @@ def test_dispose2_palette(tmp_path: Path) -> None:
 
 
 def test_dispose2_diff(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     # 4 frames: red/blue, red/red, blue/blue, red/blue
     circles = [
@@ -703,7 +703,7 @@ def test_dispose2_diff(tmp_path: Path) -> None:
 
 
 def test_dispose2_background(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im_list = []
 
@@ -729,7 +729,7 @@ def test_dispose2_background(tmp_path: Path) -> None:
 
 
 def test_dispose2_background_frame(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im_list = [Image.new("RGBA", (1, 20))]
 
@@ -747,7 +747,7 @@ def test_dispose2_background_frame(tmp_path: Path) -> None:
 
 
 def test_dispose2_previous_frame(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im = Image.new("P", (100, 100))
     im.info["transparency"] = 0
@@ -766,7 +766,7 @@ def test_dispose2_previous_frame(tmp_path: Path) -> None:
 
 
 def test_dispose2_without_transparency(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im = Image.new("P", (100, 100))
 
@@ -781,7 +781,7 @@ def test_dispose2_without_transparency(tmp_path: Path) -> None:
 
 
 def test_transparency_in_second_frame(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     with Image.open("Tests/images/different_transparency.gif") as im:
         assert im.info["transparency"] == 0
 
@@ -811,7 +811,7 @@ def test_no_transparency_in_second_frame() -> None:
 
 
 def test_remapped_transparency(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im = Image.new("P", (1, 2))
     im2 = im.copy()
@@ -829,7 +829,7 @@ def test_remapped_transparency(tmp_path: Path) -> None:
 def test_duration(tmp_path: Path) -> None:
     duration = 1000
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("L", (100, 100), "#000")
 
     # Check that the argument has priority over the info settings
@@ -843,7 +843,7 @@ def test_duration(tmp_path: Path) -> None:
 def test_multiple_duration(tmp_path: Path) -> None:
     duration_list = [1000, 2000, 3000]
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im_list = [
         Image.new("L", (100, 100), "#000"),
         Image.new("L", (100, 100), "#111"),
@@ -878,7 +878,7 @@ def test_multiple_duration(tmp_path: Path) -> None:
 def test_roundtrip_info_duration(tmp_path: Path) -> None:
     duration_list = [100, 500, 500]
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     with Image.open("Tests/images/transparent_dispose.gif") as im:
         assert [
             frame.info["duration"] for frame in ImageSequence.Iterator(im)
@@ -893,7 +893,7 @@ def test_roundtrip_info_duration(tmp_path: Path) -> None:
 
 
 def test_roundtrip_info_duration_combined(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     with Image.open("Tests/images/duplicate_frame.gif") as im:
         assert [frame.info["duration"] for frame in ImageSequence.Iterator(im)] == [
             1000,
@@ -911,7 +911,7 @@ def test_roundtrip_info_duration_combined(tmp_path: Path) -> None:
 def test_identical_frames(tmp_path: Path) -> None:
     duration_list = [1000, 1500, 2000, 4000]
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im_list = [
         Image.new("L", (100, 100), "#000"),
         Image.new("L", (100, 100), "#000"),
@@ -944,7 +944,7 @@ def test_identical_frames(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")
+    out = tmp_path / "temp.gif"
     im_list = [
         Image.new("L", (100, 100), "#000"),
         Image.new("L", (100, 100), "#000"),
@@ -961,7 +961,7 @@ def test_identical_frames_to_single_frame(
 
 
 def test_loop_none(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("L", (100, 100), "#000")
     im.save(out, loop=None)
     with Image.open(out) as reread:
@@ -971,7 +971,7 @@ def test_loop_none(tmp_path: Path) -> None:
 def test_number_of_loops(tmp_path: Path) -> None:
     number_of_loops = 2
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("L", (100, 100), "#000")
     im.save(out, loop=number_of_loops)
     with Image.open(out) as reread:
@@ -987,7 +987,7 @@ def test_number_of_loops(tmp_path: Path) -> None:
 
 
 def test_background(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("L", (100, 100), "#000")
     im.info["background"] = 1
     im.save(out)
@@ -996,7 +996,7 @@ def test_background(tmp_path: Path) -> None:
 
 
 def test_webp_background(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     # Test opaque WebP background
     if features.check("webp"):
@@ -1014,7 +1014,7 @@ 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"
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("L", (100, 100), "#000")
     im.info["comment"] = b"Test comment text"
     im.save(out)
@@ -1031,7 +1031,7 @@ def test_comment(tmp_path: Path) -> None:
 
 
 def test_comment_over_255(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("L", (100, 100), "#000")
     comment = b"Test comment text"
     while len(comment) < 256:
@@ -1057,7 +1057,7 @@ def test_read_multiple_comment_blocks() -> None:
 
 
 def test_empty_string_comment(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     with Image.open("Tests/images/chi.gif") as im:
         assert "comment" in im.info
 
@@ -1091,7 +1091,7 @@ def test_retain_comment_in_subsequent_frames(tmp_path: Path) -> None:
         assert "comment" not in im.info
 
     # Test that a saved image keeps the comment
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     with Image.open("Tests/images/dispose_prev.gif") as im:
         im.save(out, save_all=True, comment="Test")
 
@@ -1101,7 +1101,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")
+    out = tmp_path / "temp.gif"
 
     def assert_version_after_save(im: Image.Image, version: bytes) -> None:
         im.save(out)
@@ -1131,7 +1131,7 @@ def assert_version_after_save(im: Image.Image, version: bytes) -> None:
 
 
 def test_append_images(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     # Test appending single frame images
     im = Image.new("RGB", (100, 100), "#f00")
@@ -1160,7 +1160,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
 
 
 def test_append_different_size_image(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im = Image.new("RGB", (100, 100))
     bigger_im = Image.new("RGB", (200, 200), "#f00")
@@ -1187,7 +1187,7 @@ def test_transparent_optimize(tmp_path: Path) -> None:
     im.frombytes(data)
     im.putpalette(palette)
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im.save(out, transparency=im.getpixel((252, 0)))
 
     with Image.open(out) as reloaded:
@@ -1195,7 +1195,7 @@ def test_transparent_optimize(tmp_path: Path) -> None:
 
 
 def test_removed_transparency(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im = Image.new("RGB", (256, 1))
 
     for x in range(256):
@@ -1210,7 +1210,7 @@ def test_removed_transparency(tmp_path: Path) -> None:
 
 
 def test_rgb_transparency(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     # Single frame
     im = Image.new("RGB", (1, 1))
@@ -1232,7 +1232,7 @@ def test_rgb_transparency(tmp_path: Path) -> None:
 
 
 def test_rgba_transparency(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im = hopper("P")
     im.save(out, save_all=True, append_images=[Image.new("RGBA", im.size)])
@@ -1249,7 +1249,7 @@ def test_background_outside_palettte(tmp_path: Path) -> None:
 
 
 def test_bbox(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im = Image.new("RGB", (100, 100), "#fff")
     ims = [Image.new("RGB", (100, 100), "#000")]
@@ -1260,7 +1260,7 @@ def test_bbox(tmp_path: Path) -> None:
 
 
 def test_bbox_alpha(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im = Image.new("RGBA", (1, 2), (255, 0, 0, 255))
     im.putpixel((0, 1), (255, 0, 0, 0))
@@ -1279,7 +1279,7 @@ def test_palette_save_L(tmp_path: Path) -> None:
     palette = im.getpalette()
     assert palette is not None
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im_l.save(out, palette=bytes(palette))
 
     with Image.open(out) as reloaded:
@@ -1290,7 +1290,7 @@ def test_palette_save_P(tmp_path: Path) -> None:
     im = Image.new("P", (1, 2))
     im.putpixel((0, 1), 1)
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im.save(out, palette=bytes((1, 2, 3, 4, 5, 6)))
 
     with Image.open(out) as reloaded:
@@ -1306,7 +1306,7 @@ def test_palette_save_duplicate_entries(tmp_path: Path) -> None:
 
     im.putpalette((0, 0, 0, 0, 0, 0))
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im.save(out, palette=[0, 0, 0, 0, 0, 0, 1, 1, 1])
 
     with Image.open(out) as reloaded:
@@ -1321,7 +1321,7 @@ def test_palette_save_all_P(tmp_path: Path) -> None:
         frame.putpalette(color)
         frames.append(frame)
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     frames[0].save(
         out, save_all=True, palette=[255, 0, 0, 0, 255, 0], append_images=frames[1:]
     )
@@ -1344,7 +1344,7 @@ def test_palette_save_ImagePalette(tmp_path: Path) -> None:
     im = hopper("P")
     palette = ImagePalette.ImagePalette("RGB", list(range(256))[::-1] * 3)
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im.save(out, palette=palette)
 
     with Image.open(out) as reloaded:
@@ -1357,7 +1357,7 @@ def test_save_I(tmp_path: Path) -> None:
 
     im = hopper("I")
 
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     im.save(out)
 
     with Image.open(out) as reloaded:
@@ -1441,7 +1441,7 @@ def test_missing_background() -> None:
 
 
 def test_saving_rgba(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
     with Image.open("Tests/images/transparent.png") as im:
         im.save(out)
 
@@ -1452,7 +1452,7 @@ def test_saving_rgba(tmp_path: Path) -> None:
 
 @pytest.mark.parametrize("params", ({}, {"disposal": 2, "optimize": False}))
 def test_p_rgba(tmp_path: Path, params: dict[str, Any]) -> None:
-    out = str(tmp_path / "temp.gif")
+    out = tmp_path / "temp.gif"
 
     im1 = Image.new("P", (100, 100))
     d = ImageDraw.Draw(im1)
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index 02e464ff190..960e5f4be1f 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -43,7 +43,7 @@ def test_load() -> None:
 def test_save(tmp_path: Path) -> None:
     # Arrange
     im = hopper()
-    tmpfile = str(tmp_path / "temp.grib")
+    tmpfile = tmp_path / "temp.grib"
 
     # Act / Assert: stub cannot save without an implemented handler
     with pytest.raises(OSError):
@@ -79,7 +79,7 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
         im.load()
         assert handler.is_loaded()
 
-        temp_file = str(tmp_path / "temp.grib")
+        temp_file = tmp_path / "temp.grib"
         im.save(temp_file)
         assert handler.saved
 
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index 024be9e80cf..50864009f6a 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -81,7 +81,7 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
         im.load()
         assert handler.is_loaded()
 
-        temp_file = str(tmp_path / "temp.h5")
+        temp_file = tmp_path / "temp.h5"
         im.save(temp_file)
         assert handler.saved
 
diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index 94f16aeecb6..b6dc4bc194f 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -43,7 +43,7 @@ def test_load() -> None:
 
 
 def test_save(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.icns")
+    temp_file = tmp_path / "temp.icns"
 
     with Image.open(TEST_FILE) as im:
         im.save(temp_file)
@@ -60,7 +60,7 @@ def test_save(tmp_path: Path) -> None:
 
 
 def test_save_append_images(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.icns")
+    temp_file = tmp_path / "temp.icns"
     provided_im = Image.new("RGBA", (32, 32), (255, 0, 0, 128))
 
     with Image.open(TEST_FILE) as im:
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 2f5e4ca5ab3..37bfd3f1f7d 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -41,7 +41,7 @@ def test_black_and_white() -> None:
 
 
 def test_palette(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.ico")
+    temp_file = tmp_path / "temp.ico"
 
     im = Image.new("P", (16, 16))
     im.save(temp_file)
@@ -88,7 +88,7 @@ def test_save_to_bytes() -> None:
 
 
 def test_getpixel(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.ico")
+    temp_file = tmp_path / "temp.ico"
 
     im = hopper()
     im.save(temp_file, "ico", sizes=[(32, 32), (64, 64)])
@@ -101,8 +101,8 @@ def test_getpixel(tmp_path: Path) -> None:
 
 
 def test_no_duplicates(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.ico")
-    temp_file2 = str(tmp_path / "temp2.ico")
+    temp_file = tmp_path / "temp.ico"
+    temp_file2 = tmp_path / "temp2.ico"
 
     im = hopper()
     sizes = [(32, 32), (64, 64)]
@@ -115,8 +115,8 @@ def test_no_duplicates(tmp_path: Path) -> None:
 
 
 def test_different_bit_depths(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.ico")
-    temp_file2 = str(tmp_path / "temp2.ico")
+    temp_file = tmp_path / "temp.ico"
+    temp_file2 = tmp_path / "temp2.ico"
 
     im = hopper()
     im.save(temp_file, "ico", bitmap_format="bmp", sizes=[(128, 128)])
@@ -132,8 +132,8 @@ def test_different_bit_depths(tmp_path: Path) -> None:
     assert os.path.getsize(temp_file) != os.path.getsize(temp_file2)
 
     # Test that only matching sizes of different bit depths are saved
-    temp_file3 = str(tmp_path / "temp3.ico")
-    temp_file4 = str(tmp_path / "temp4.ico")
+    temp_file3 = tmp_path / "temp3.ico"
+    temp_file4 = tmp_path / "temp4.ico"
 
     im.save(temp_file3, "ico", bitmap_format="bmp", sizes=[(128, 128)])
     im.save(
@@ -186,7 +186,7 @@ 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:
-        outfile = str(tmp_path / "temp_saved_hopper_256x256.ico")
+        outfile = tmp_path / "temp_saved_hopper_256x256.ico"
 
         # Act
         im.save(outfile)
@@ -202,7 +202,7 @@ def test_only_save_relevant_sizes(tmp_path: Path) -> None:
     """
     # Arrange
     with Image.open("Tests/images/python.ico") as im:  # 16x16, 32x32, 48x48
-        outfile = str(tmp_path / "temp_saved_python.ico")
+        outfile = tmp_path / "temp_saved_python.ico"
         # Act
         im.save(outfile)
 
@@ -215,7 +215,7 @@ 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))
-    outfile = str(tmp_path / "temp_saved_multi_icon.ico")
+    outfile = tmp_path / "temp_saved_multi_icon.ico"
     im.save(outfile, sizes=[(32, 32), (128, 128)], append_images=[provided_im])
 
     with Image.open(outfile) as reread:
@@ -235,7 +235,7 @@ def test_unexpected_size() -> None:
 
 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")
+        outfile = tmp_path / "temp_saved_hopper_draw.ico"
 
         draw = ImageDraw.Draw(im)
         draw.line((0, 0) + im.size, "#f00")
diff --git a/Tests/test_file_im.py b/Tests/test_file_im.py
index d2999880153..235914a2b4f 100644
--- a/Tests/test_file_im.py
+++ b/Tests/test_file_im.py
@@ -23,7 +23,7 @@ def test_sanity() -> None:
 
 
 def test_name_limit(tmp_path: Path) -> None:
-    out = str(tmp_path / ("name_limit_test" * 7 + ".im"))
+    out = tmp_path / ("name_limit_test" * 7 + ".im")
     with Image.open(TEST_IM) as im:
         im.save(out)
     assert filecmp.cmp(out, "Tests/images/hopper_long_name.im")
@@ -87,7 +87,7 @@ def test_eoferror() -> None:
 
 @pytest.mark.parametrize("mode", ("RGB", "P", "PA"))
 def test_roundtrip(mode: str, tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.im")
+    out = tmp_path / "temp.im"
     im = hopper(mode)
     im.save(out)
     assert_image_equal_tofile(im, out)
@@ -98,7 +98,7 @@ def test_small_palette(tmp_path: Path) -> None:
     colors = [0, 1, 2]
     im.putpalette(colors)
 
-    out = str(tmp_path / "temp.im")
+    out = tmp_path / "temp.im"
     im.save(out)
 
     with Image.open(out) as reloaded:
@@ -106,7 +106,7 @@ def test_small_palette(tmp_path: Path) -> None:
 
 
 def test_save_unsupported_mode(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.im")
+    out = tmp_path / "temp.im"
     im = hopper("HSV")
     with pytest.raises(ValueError):
         im.save(out)
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index a2481c336d0..8ab853b85c9 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -83,7 +83,7 @@ def test_sanity(self) -> None:
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
     def test_zero(self, size: tuple[int, int], tmp_path: Path) -> None:
-        f = str(tmp_path / "temp.jpg")
+        f = tmp_path / "temp.jpg"
         im = Image.new("RGB", size)
         with pytest.raises(ValueError):
             im.save(f)
@@ -194,7 +194,7 @@ def test_icc(self, tmp_path: Path) -> None:
             icc_profile = im1.info["icc_profile"]
             assert len(icc_profile) == 3144
             # Roundtrip via physical file.
-            f = str(tmp_path / "temp.jpg")
+            f = tmp_path / "temp.jpg"
             im1.save(f, icc_profile=icc_profile)
         with Image.open(f) as im2:
             assert im2.info.get("icc_profile") == icc_profile
@@ -238,7 +238,7 @@ def test_large_icc_meta(self, tmp_path: Path) -> None:
         # Sometimes the meta data on the icc_profile block is bigger than
         # Image.MAXBLOCK or the image size.
         with Image.open("Tests/images/icc_profile_big.jpg") as im:
-            f = str(tmp_path / "temp.jpg")
+            f = tmp_path / "temp.jpg"
             icc_profile = im.info["icc_profile"]
             # Should not raise OSError for image with icc larger than image size.
             im.save(
@@ -250,11 +250,11 @@ def test_large_icc_meta(self, tmp_path: Path) -> None:
             )
 
         with Image.open("Tests/images/flower2.jpg") as im:
-            f = str(tmp_path / "temp2.jpg")
+            f = tmp_path / "temp2.jpg"
             im.save(f, progressive=True, quality=94, icc_profile=b" " * 53955)
 
         with Image.open("Tests/images/flower2.jpg") as im:
-            f = str(tmp_path / "temp3.jpg")
+            f = tmp_path / "temp3.jpg"
             im.save(f, progressive=True, quality=94, exif=b" " * 43668)
 
     def test_optimize(self) -> None:
@@ -268,7 +268,7 @@ def test_optimize(self) -> None:
 
     def test_optimize_large_buffer(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/148
-        f = str(tmp_path / "temp.jpg")
+        f = tmp_path / "temp.jpg"
         # this requires ~ 1.5x Image.MAXBLOCK
         im = Image.new("RGB", (4096, 4096), 0xFF3333)
         im.save(f, format="JPEG", optimize=True)
@@ -288,13 +288,13 @@ def test_progressive(self) -> None:
         assert im1_bytes >= im3_bytes
 
     def test_progressive_large_buffer(self, tmp_path: Path) -> None:
-        f = str(tmp_path / "temp.jpg")
+        f = 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: Path) -> None:
-        f = str(tmp_path / "temp.jpg")
+        f = 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)
@@ -307,7 +307,7 @@ def test_progressive_cmyk_buffer(self) -> None:
 
     def test_large_exif(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/148
-        f = str(tmp_path / "temp.jpg")
+        f = tmp_path / "temp.jpg"
         im = hopper()
         im.save(f, "JPEG", quality=90, exif=b"1" * 65533)
 
@@ -335,7 +335,7 @@ def test_exif_gps(self, tmp_path: Path) -> None:
             assert exif[gps_index] == expected_exif_gps
 
         # Writing
-        f = str(tmp_path / "temp.jpg")
+        f = tmp_path / "temp.jpg"
         exif = Image.Exif()
         exif[gps_index] = expected_exif_gps
         hopper().save(f, exif=exif)
@@ -505,15 +505,15 @@ def test_mp(self) -> None:
     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")
+            f = tmp_path / "temp.jpg"
             im.save(f, quality="keep")
         # Grayscale
         with Image.open("Tests/images/hopper_gray.jpg") as im:
-            f = str(tmp_path / "temp.jpg")
+            f = tmp_path / "temp.jpg"
             im.save(f, quality="keep")
         # CMYK
         with Image.open("Tests/images/pil_sample_cmyk.jpg") as im:
-            f = str(tmp_path / "temp.jpg")
+            f = tmp_path / "temp.jpg"
             im.save(f, quality="keep")
 
     def test_junk_jpeg_header(self) -> None:
@@ -726,7 +726,7 @@ def test_no_duplicate_0x1001_tag(self) -> None:
 
     def test_MAXBLOCK_scaling(self, tmp_path: Path) -> None:
         im = self.gen_random_image((512, 512))
-        f = str(tmp_path / "temp.jpeg")
+        f = tmp_path / "temp.jpeg"
         im.save(f, quality=100, optimize=True)
 
         with Image.open(f) as reloaded:
@@ -762,7 +762,7 @@ def test_save_wrong_modes(self, mode: str) -> None:
 
     def test_save_tiff_with_dpi(self, tmp_path: Path) -> None:
         # Arrange
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/hopper.tif") as im:
             # Act
             im.save(outfile, "JPEG", dpi=im.info["dpi"])
@@ -773,7 +773,7 @@ def test_save_tiff_with_dpi(self, tmp_path: Path) -> None:
                 assert im.info["dpi"] == reloaded.info["dpi"]
 
     def test_save_dpi_rounding(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.jpg")
+        outfile = tmp_path / "temp.jpg"
         with Image.open("Tests/images/hopper.jpg") as im:
             im.save(outfile, dpi=(72.2, 72.2))
 
@@ -859,7 +859,7 @@ def test_exif_x_resolution(self, tmp_path: Path) -> None:
             exif = im.getexif()
             assert exif[282] == 180
 
-            out = str(tmp_path / "out.jpg")
+            out = tmp_path / "out.jpg"
             with warnings.catch_warnings():
                 warnings.simplefilter("error")
 
@@ -1005,7 +1005,7 @@ def test_getxmp_padded(self) -> None:
                 assert im.getxmp() == {"xmpmeta": None}
 
     def test_save_xmp(self, tmp_path: Path) -> None:
-        f = str(tmp_path / "temp.jpg")
+        f = tmp_path / "temp.jpg"
         im = hopper()
         im.save(f, xmp=b"XMP test")
         with Image.open(f) as reloaded:
@@ -1094,7 +1094,7 @@ def test_deprecation(self) -> None:
 @skip_unless_feature("jpg")
 class TestFileCloseW32:
     def test_fd_leak(self, tmp_path: Path) -> None:
-        tmpfile = str(tmp_path / "temp.jpg")
+        tmpfile = tmp_path / "temp.jpg"
 
         with Image.open("Tests/images/hopper.jpg") as im:
             im.save(tmpfile)
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index e429610ad92..916df25865e 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -99,7 +99,7 @@ def test_bytesio(card: ImageFile.ImageFile) -> None:
 def test_lossless(card: ImageFile.ImageFile, 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")
+        outfile = tmp_path / "temp_test-card.png"
         im.save(outfile)
     assert_image_similar(im, card, 1.0e-3)
 
@@ -213,7 +213,7 @@ def test_header_errors() -> None:
 
 
 def test_layers_type(card: ImageFile.ImageFile, tmp_path: Path) -> None:
-    outfile = str(tmp_path / "temp_layers.jp2")
+    outfile = tmp_path / "temp_layers.jp2"
     for quality_layers in [[100, 50, 10], (100, 50, 10), None]:
         card.save(outfile, quality_layers=quality_layers)
 
@@ -289,7 +289,7 @@ def test_mct(card: ImageFile.ImageFile) -> None:
 
 
 def test_sgnd(tmp_path: Path) -> None:
-    outfile = str(tmp_path / "temp.jp2")
+    outfile = tmp_path / "temp.jp2"
 
     im = Image.new("L", (1, 1))
     im.save(outfile)
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index f284c3f2fac..25d1f57125b 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -39,7 +39,7 @@ def _assert_noerr(self, tmp_path: Path, im: TiffImagePlugin.TiffImageFile) -> No
         assert im._compression == "group4"
 
         # can we write it back out, in a different form.
-        out = str(tmp_path / "temp.png")
+        out = tmp_path / "temp.png"
         im.save(out)
 
         out_bytes = io.BytesIO()
@@ -123,7 +123,7 @@ 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:
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
             rot = orig.transpose(Image.Transpose.ROTATE_90)
             assert rot.size == (500, 500)
             rot.save(out)
@@ -151,7 +151,7 @@ def test_adobe_deflate_tiff(self) -> None:
     @pytest.mark.parametrize("legacy_api", (False, True))
     def test_write_metadata(self, legacy_api: bool, tmp_path: Path) -> None:
         """Test metadata writing through libtiff"""
-        f = str(tmp_path / "temp.tiff")
+        f = tmp_path / "temp.tiff"
         with Image.open("Tests/images/hopper_g4.tif") as img:
             img.save(f, tiffinfo=img.tag)
 
@@ -247,7 +247,7 @@ def test_additional_metadata(
             # Extra samples really doesn't make sense in this application.
             del new_ifd[338]
 
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
             monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
 
             im.save(out, tiffinfo=new_ifd)
@@ -313,7 +313,7 @@ def check_tags(
         ) -> None:
             im = hopper()
 
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
             im.save(out, tiffinfo=tiffinfo)
 
             with Image.open(out) as reloaded:
@@ -347,13 +347,13 @@ def check_tags(
         )
 
     def test_osubfiletype(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+        outfile = 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")
+        outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/g4_orientation_6.tif") as im:
             im.tag_v2[SUBIFD] = 10000
 
@@ -365,7 +365,7 @@ def test_xmlpacket_tag(
     ) -> None:
         monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
 
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         hopper().save(out, tiffinfo={700: b"xmlpacket tag"})
 
         with Image.open(out) as reloaded:
@@ -375,7 +375,7 @@ def test_xmlpacket_tag(
     def test_int_dpi(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
         # issue #1765
         im = hopper("RGB")
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
         im.save(out, dpi=(72, 72))
         with Image.open(out) as reloaded:
@@ -383,7 +383,7 @@ def test_int_dpi(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
 
     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")
+            out = tmp_path / "temp.tif"
             i.save(out, compression="group3")
 
             with Image.open(out) as reread:
@@ -400,7 +400,7 @@ def test_little_endian(self, tmp_path: Path) -> None:
             assert b[0] == ord(b"\xe0")
             assert b[1] == ord(b"\x01")
 
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
             # out = "temp.le.tif"
             im.save(out)
         with Image.open(out) as reread:
@@ -420,7 +420,7 @@ def test_big_endian(self, tmp_path: Path) -> None:
             assert b[0] == ord(b"\x01")
             assert b[1] == ord(b"\xe0")
 
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
             im.save(out)
             with Image.open(out) as reread:
                 assert reread.info["compression"] == im.info["compression"]
@@ -430,7 +430,7 @@ 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:
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
 
             orig.tag[269] = "temp.tif"
             orig.save(out)
@@ -457,7 +457,7 @@ def test_12bit_rawmode(self, monkeypatch: pytest.MonkeyPatch) -> None:
     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")
+        out = tmp_path / "temp.tif"
         with Image.open("Tests/images/pport_g4.tif") as im:
             im = im.convert("L")
 
@@ -470,7 +470,7 @@ def test_compressions(self, tmp_path: Path) -> None:
         # Test various tiff compressions and assert similar image content but reduced
         # file sizes.
         im = hopper("RGB")
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         im.save(out)
         size_raw = os.path.getsize(out)
 
@@ -494,7 +494,7 @@ def test_compressions(self, tmp_path: Path) -> None:
 
     def test_tiff_jpeg_compression(self, tmp_path: Path) -> None:
         im = hopper("RGB")
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         im.save(out, compression="tiff_jpeg")
 
         with Image.open(out) as reloaded:
@@ -502,7 +502,7 @@ def test_tiff_jpeg_compression(self, tmp_path: Path) -> None:
 
     def test_tiff_deflate_compression(self, tmp_path: Path) -> None:
         im = hopper("RGB")
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         im.save(out, compression="tiff_deflate")
 
         with Image.open(out) as reloaded:
@@ -510,7 +510,7 @@ def test_tiff_deflate_compression(self, tmp_path: Path) -> None:
 
     def test_quality(self, tmp_path: Path) -> None:
         im = hopper("RGB")
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
 
         with pytest.raises(ValueError):
             im.save(out, compression="tiff_lzw", quality=50)
@@ -525,7 +525,7 @@ def test_quality(self, tmp_path: Path) -> None:
 
     def test_cmyk_save(self, tmp_path: Path) -> None:
         im = hopper("CMYK")
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
 
         im.save(out, compression="tiff_adobe_deflate")
         assert_image_equal_tofile(im, out)
@@ -534,7 +534,7 @@ def test_cmyk_save(self, 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")
+        out = tmp_path / "temp.tif"
 
         monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
         im.save(out)
@@ -546,7 +546,7 @@ def test_palette_save(
     @pytest.mark.parametrize("compression", ("tiff_ccitt", "group3", "group4"))
     def test_bw_compression_w_rgb(self, compression: str, tmp_path: Path) -> None:
         im = hopper("RGB")
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
 
         with pytest.raises(OSError):
             im.save(out, compression=compression)
@@ -686,7 +686,7 @@ def save_bytesio(compression: str | None = None) -> None:
 
     def test_save_ycbcr(self, tmp_path: Path) -> None:
         im = hopper("YCbCr")
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         im.save(outfile, compression="jpeg")
 
         with Image.open(outfile) as reloaded:
@@ -713,7 +713,7 @@ def test_crashing_metadata(
     ) -> None:
         # issue 1597
         with Image.open("Tests/images/rdf.tif") as im:
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
 
             monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
             # this shouldn't crash
@@ -724,7 +724,7 @@ def test_page_number_x_0(self, tmp_path: Path) -> None:
         # Test TIFF with tag 297 (Page Number) having value of 0 0.
         # The first number is the current page number.
         # The second is the total number of pages, zero means not available.
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         # Created by printing a page in Chrome to PDF, then:
         # /usr/bin/gs -q -sDEVICE=tiffg3 -sOutputFile=total-pages-zero.tif
         # -dNOPAUSE /tmp/test.pdf -c quit
@@ -736,7 +736,7 @@ def test_page_number_x_0(self, tmp_path: Path) -> None:
     def test_fd_duplication(self, tmp_path: Path) -> None:
         # https://github.com/python-pillow/Pillow/issues/1651
 
-        tmpfile = str(tmp_path / "temp.tif")
+        tmpfile = tmp_path / "temp.tif"
         with open(tmpfile, "wb") as f:
             with open("Tests/images/g4-multi.tiff", "rb") as src:
                 f.write(src.read())
@@ -779,7 +779,7 @@ def test_write_icc(
         with Image.open("Tests/images/hopper.iccprofile.tif") as img:
             icc_profile = img.info["icc_profile"]
 
-            out = str(tmp_path / "temp.tif")
+            out = tmp_path / "temp.tif"
             img.save(out, icc_profile=icc_profile)
         with Image.open(out) as reloaded:
             assert icc_profile == reloaded.info["icc_profile"]
@@ -802,7 +802,7 @@ def test_multipage_compression(self) -> None:
 
     def test_save_tiff_with_jpegtables(self, tmp_path: Path) -> None:
         # Arrange
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
 
         # Created with ImageMagick: convert hopper.jpg hopper_jpg.tif
         # Contains JPEGTables (347) tag
@@ -864,7 +864,7 @@ def test_sampleformat_write(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
     ) -> None:
         im = Image.new("F", (1, 1))
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
         im.save(out)
 
@@ -1008,7 +1008,7 @@ def test_strip_planar_16bit_RGBa(self) -> None:
     @pytest.mark.parametrize("compression", (None, "jpeg"))
     def test_block_tile_tags(self, compression: str | None, tmp_path: Path) -> None:
         im = hopper()
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
 
         tags = {
             TiffImagePlugin.TILEWIDTH: 256,
@@ -1147,7 +1147,7 @@ def test_realloc_overflow(self, monkeypatch: pytest.MonkeyPatch) -> None:
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", "jpeg"))
     def test_save_multistrip(self, compression: str, tmp_path: Path) -> None:
         im = hopper("RGB").resize((256, 256))
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         im.save(out, compression=compression)
 
         with Image.open(out) as im:
@@ -1160,7 +1160,7 @@ def test_save_single_strip(
         self, argument: bool, tmp_path: Path, monkeypatch: pytest.MonkeyPatch
     ) -> None:
         im = hopper("RGB").resize((256, 256))
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
 
         if not argument:
             monkeypatch.setattr(TiffImagePlugin, "STRIP_SIZE", 2**18)
@@ -1176,13 +1176,13 @@ def test_save_single_strip(
     @pytest.mark.parametrize("compression", ("tiff_adobe_deflate", 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")
+        out = tmp_path / "temp.tif"
         with pytest.raises(SystemError):
             im.save(out, compression=compression)
 
     def test_save_many_compressed(self, tmp_path: Path) -> None:
         im = hopper()
-        out = str(tmp_path / "temp.tif")
+        out = tmp_path / "temp.tif"
         for _ in range(10000):
             im.save(out, compression="jpeg")
 
diff --git a/Tests/test_file_msp.py b/Tests/test_file_msp.py
index b0964aabe12..8c91922bd0b 100644
--- a/Tests/test_file_msp.py
+++ b/Tests/test_file_msp.py
@@ -15,7 +15,7 @@
 
 
 def test_sanity(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.msp")
+    test_file = tmp_path / "temp.msp"
 
     hopper("1").save(test_file)
 
@@ -84,7 +84,7 @@ def test_msp_v2() -> None:
 def test_cannot_save_wrong_mode(tmp_path: Path) -> None:
     # Arrange
     im = hopper()
-    filename = str(tmp_path / "temp.msp")
+    filename = tmp_path / "temp.msp"
 
     # Act/Assert
     with pytest.raises(OSError):
diff --git a/Tests/test_file_palm.py b/Tests/test_file_palm.py
index 194f39b30b8..a1859bc338c 100644
--- a/Tests/test_file_palm.py
+++ b/Tests/test_file_palm.py
@@ -14,7 +14,7 @@
 def helper_save_as_palm(tmp_path: Path, mode: str) -> None:
     # Arrange
     im = hopper(mode)
-    outfile = str(tmp_path / ("temp_" + mode + ".palm"))
+    outfile = tmp_path / ("temp_" + mode + ".palm")
 
     # Act
     im.save(outfile)
@@ -25,7 +25,7 @@ def helper_save_as_palm(tmp_path: Path, mode: str) -> None:
 
 
 def open_with_magick(magick: list[str], tmp_path: Path, f: str) -> Image.Image:
-    outfile = str(tmp_path / "temp.png")
+    outfile = tmp_path / "temp.png"
     rc = subprocess.call(
         magick + [f, outfile], stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT
     )
diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index 21c32268c0e..5d7fd1c1bb4 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -11,7 +11,7 @@
 
 
 def _roundtrip(tmp_path: Path, im: Image.Image) -> None:
-    f = str(tmp_path / "temp.pcx")
+    f = tmp_path / "temp.pcx"
     im.save(f)
     with Image.open(f) as im2:
         assert im2.mode == im.mode
@@ -31,7 +31,7 @@ def test_sanity(tmp_path: Path) -> None:
     _roundtrip(tmp_path, im)
 
     # Test an unsupported mode
-    f = str(tmp_path / "temp.pcx")
+    f = tmp_path / "temp.pcx"
     im = hopper("RGBA")
     with pytest.raises(ValueError):
         im.save(f)
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index 815686a5249..bde1e3ab847 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -55,7 +55,7 @@ def test_save_alpha(tmp_path: Path, mode: str) -> None:
 
 def test_p_alpha(tmp_path: Path) -> None:
     # Arrange
-    outfile = str(tmp_path / "temp.pdf")
+    outfile = tmp_path / "temp.pdf"
     with Image.open("Tests/images/pil123p.png") as im:
         assert im.mode == "P"
         assert isinstance(im.info["transparency"], bytes)
@@ -80,7 +80,7 @@ def test_monochrome(tmp_path: Path) -> None:
 
 def test_unsupported_mode(tmp_path: Path) -> None:
     im = hopper("PA")
-    outfile = str(tmp_path / "temp_PA.pdf")
+    outfile = tmp_path / "temp_PA.pdf"
 
     with pytest.raises(ValueError):
         im.save(outfile)
@@ -89,7 +89,7 @@ def test_unsupported_mode(tmp_path: Path) -> None:
 def test_resolution(tmp_path: Path) -> None:
     im = hopper()
 
-    outfile = str(tmp_path / "temp.pdf")
+    outfile = tmp_path / "temp.pdf"
     im.save(outfile, resolution=150)
 
     with open(outfile, "rb") as fp:
@@ -117,7 +117,7 @@ def test_resolution(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")
+    outfile = tmp_path / "temp.pdf"
     im.save(outfile, "PDF", **params)
 
     with open(outfile, "rb") as fp:
@@ -144,7 +144,7 @@ def test_save_all(tmp_path: Path) -> None:
 
     # Multiframe image
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
-        outfile = str(tmp_path / "temp.pdf")
+        outfile = tmp_path / "temp.pdf"
         im.save(outfile, save_all=True)
 
         assert os.path.isfile(outfile)
@@ -177,7 +177,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
 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")
+        outfile = tmp_path / "temp.pdf"
         im.save(outfile)
 
     assert os.path.isfile(outfile)
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index efd2e5cd970..f99ca91a316 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -68,7 +68,7 @@ def roundtrip(im: Image.Image, **options: Any) -> PngImagePlugin.PngImageFile:
 
 @skip_unless_feature("zlib")
 class TestFilePng:
-    def get_chunks(self, filename: str) -> list[bytes]:
+    def get_chunks(self, filename: Path) -> list[bytes]:
         chunks = []
         with open(filename, "rb") as fp:
             fp.read(8)
@@ -89,7 +89,7 @@ def test_sanity(self, tmp_path: Path) -> None:
         assert version is not None
         assert re.search(r"\d+(\.\d+){1,3}(\.zlib\-ng)?$", version)
 
-        test_file = str(tmp_path / "temp.png")
+        test_file = tmp_path / "temp.png"
 
         hopper("RGB").save(test_file)
 
@@ -250,7 +250,7 @@ def test_save_p_transparent_palette(self, tmp_path: Path) -> None:
             # each palette entry
             assert len(im.info["transparency"]) == 256
 
-            test_file = str(tmp_path / "temp.png")
+            test_file = tmp_path / "temp.png"
             im.save(test_file)
 
         # check if saved image contains same transparency
@@ -271,7 +271,7 @@ def test_save_p_single_transparency(self, tmp_path: Path) -> None:
             assert im.info["transparency"] == 164
             assert im.getpixel((31, 31)) == 164
 
-            test_file = str(tmp_path / "temp.png")
+            test_file = tmp_path / "temp.png"
             im.save(test_file)
 
         # check if saved image contains same transparency
@@ -294,7 +294,7 @@ def test_save_p_transparent_black(self, tmp_path: Path) -> None:
         assert im.getcolors() == [(100, (0, 0, 0, 0))]
 
         im = im.convert("P")
-        test_file = str(tmp_path / "temp.png")
+        test_file = tmp_path / "temp.png"
         im.save(test_file)
 
         # check if saved image contains same transparency
@@ -315,7 +315,7 @@ def test_save_grayscale_transparency(self, tmp_path: Path) -> None:
                 im_rgba = im.convert("RGBA")
             assert im_rgba.getchannel("A").getcolors()[0][0] == num_transparent
 
-            test_file = str(tmp_path / "temp.png")
+            test_file = tmp_path / "temp.png"
             im.save(test_file)
 
             with Image.open(test_file) as test_im:
@@ -329,7 +329,7 @@ def test_save_grayscale_transparency(self, tmp_path: Path) -> None:
     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")
+            test_file = tmp_path / "temp.png"
             im.save(test_file)
 
     def test_load_verify(self) -> None:
@@ -488,7 +488,7 @@ def test_trns_p(self, tmp_path: Path) -> None:
         im = hopper("P")
         im.info["transparency"] = 0
 
-        f = str(tmp_path / "temp.png")
+        f = tmp_path / "temp.png"
         im.save(f)
 
         with Image.open(f) as im2:
@@ -549,7 +549,7 @@ def test_repr_png_error_returns_none(self) -> None:
 
     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")
+            test_file = tmp_path / "temp.png"
             im.convert("P").save(test_file, dpi=(100, 100))
 
         chunks = self.get_chunks(test_file)
@@ -661,7 +661,7 @@ def test_truncated_chunks(
     def test_specify_bits(self, save_all: bool, tmp_path: Path) -> None:
         im = hopper("P")
 
-        out = str(tmp_path / "temp.png")
+        out = tmp_path / "temp.png"
         im.save(out, bits=4, save_all=save_all)
 
         with Image.open(out) as reloaded:
@@ -671,8 +671,8 @@ def test_plte_length(self, tmp_path: Path) -> None:
         im = Image.new("P", (1, 1))
         im.putpalette((1, 1, 1))
 
-        out = str(tmp_path / "temp.png")
-        im.save(str(tmp_path / "temp.png"))
+        out = tmp_path / "temp.png"
+        im.save(tmp_path / "temp.png")
 
         with Image.open(out) as reloaded:
             assert len(reloaded.png.im_palette[1]) == 3
@@ -721,7 +721,7 @@ def test_exif(self) -> None:
 
     def test_exif_save(self, tmp_path: Path) -> None:
         # Test exif is not saved from info
-        test_file = str(tmp_path / "temp.png")
+        test_file = tmp_path / "temp.png"
         with Image.open("Tests/images/exif.png") as im:
             im.save(test_file)
 
@@ -741,7 +741,7 @@ def test_exif_save(self, tmp_path: Path) -> None:
     )
     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")
+            test_file = tmp_path / "temp.png"
             im.save(test_file, exif=im.getexif())
 
         with Image.open(test_file) as reloaded:
@@ -750,7 +750,7 @@ def test_exif_from_jpg(self, tmp_path: Path) -> None:
 
     def test_exif_argument(self, tmp_path: Path) -> None:
         with Image.open(TEST_PNG_FILE) as im:
-            test_file = str(tmp_path / "temp.png")
+            test_file = tmp_path / "temp.png"
             im.save(test_file, exif=b"exifstring")
 
         with Image.open(test_file) as reloaded:
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index c93a8c73aba..41e2b5416c3 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -94,7 +94,7 @@ def test_16bit_pgm() -> None:
 
 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")
+        filename = tmp_path / "temp.pgm"
         im.save(filename, "PPM")
         assert_image_equal_tofile(im, filename)
 
@@ -106,7 +106,7 @@ def test_pnm(tmp_path: Path) -> None:
     with Image.open("Tests/images/hopper.pnm") as im:
         assert_image_similar(im, hopper(), 0.0001)
 
-        filename = str(tmp_path / "temp.pnm")
+        filename = tmp_path / "temp.pnm"
         im.save(filename)
 
         assert_image_equal_tofile(im, filename)
@@ -117,7 +117,7 @@ def test_pfm(tmp_path: Path) -> None:
         assert im.info["scale"] == 1.0
         assert_image_equal(im, hopper("F"))
 
-        filename = str(tmp_path / "tmp.pfm")
+        filename = tmp_path / "tmp.pfm"
         im.save(filename)
 
         assert_image_equal_tofile(im, filename)
@@ -128,7 +128,7 @@ def test_pfm_big_endian(tmp_path: Path) -> None:
         assert im.info["scale"] == 2.5
         assert_image_equal(im, hopper("F"))
 
-        filename = str(tmp_path / "tmp.pfm")
+        filename = tmp_path / "tmp.pfm"
         im.save(filename)
 
         assert_image_equal_tofile(im, filename)
@@ -194,8 +194,8 @@ def test_16bit_plain_pgm() -> 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")
+    path1 = tmp_path / "temp1.ppm"
+    path2 = tmp_path / "temp2.ppm"
     comment = b"# comment" * comment_count
     with open(path1, "wb") as f1, open(path2, "wb") as f2:
         f1.write(header + b"\n\n" + data)
@@ -207,7 +207,7 @@ def test_plain_data_with_comment(
 
 @pytest.mark.parametrize("data", (b"P1\n128 128\n", b"P3\n128 128\n255\n"))
 def test_plain_truncated_data(tmp_path: Path, data: bytes) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(data)
 
@@ -218,7 +218,7 @@ def test_plain_truncated_data(tmp_path: Path, data: bytes) -> 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: bytes) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(data)
 
@@ -235,7 +235,7 @@ def test_plain_invalid_data(tmp_path: Path, data: bytes) -> None:
     ),
 )
 def test_plain_ppm_token_too_long(tmp_path: Path, data: bytes) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(data)
 
@@ -245,7 +245,7 @@ def test_plain_ppm_token_too_long(tmp_path: Path, data: bytes) -> None:
 
 
 def test_plain_ppm_value_negative(tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(b"P3\n128 128\n255\n-1")
 
@@ -255,7 +255,7 @@ def test_plain_ppm_value_negative(tmp_path: Path) -> None:
 
 
 def test_plain_ppm_value_too_large(tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(b"P3\n128 128\n255\n256")
 
@@ -270,7 +270,7 @@ def test_magic() -> None:
 
 
 def test_header_with_comments(tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(b"P6 #comment\n#comment\r12#comment\r8\n128 #comment\n255\n")
 
@@ -279,7 +279,7 @@ def test_header_with_comments(tmp_path: Path) -> None:
 
 
 def test_non_integer_token(tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(b"P6\nTEST")
 
@@ -289,7 +289,7 @@ def test_non_integer_token(tmp_path: Path) -> None:
 
 
 def test_header_token_too_long(tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(b"P6\n 01234567890")
 
@@ -300,7 +300,7 @@ def test_header_token_too_long(tmp_path: Path) -> None:
 
 def test_truncated_file(tmp_path: Path) -> None:
     # Test EOF in header
-    path = str(tmp_path / "temp.pgm")
+    path = tmp_path / "temp.pgm"
     with open(path, "wb") as f:
         f.write(b"P6")
 
@@ -316,7 +316,7 @@ def test_truncated_file(tmp_path: Path) -> None:
 
 
 def test_not_enough_image_data(tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(b"P2 1 2 255 255")
 
@@ -327,7 +327,7 @@ def test_not_enough_image_data(tmp_path: Path) -> None:
 
 @pytest.mark.parametrize("maxval", (b"0", b"65536"))
 def test_invalid_maxval(maxval: bytes, tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.ppm")
+    path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
         f.write(b"P6\n3 1 " + maxval)
 
@@ -350,7 +350,7 @@ def test_neg_ppm() -> None:
 
 
 def test_mimetypes(tmp_path: Path) -> None:
-    path = str(tmp_path / "temp.pgm")
+    path = tmp_path / "temp.pgm"
 
     with open(path, "wb") as f:
         f.write(b"P4\n128 128\n255")
diff --git a/Tests/test_file_sgi.py b/Tests/test_file_sgi.py
index e13a8019ed4..7d34fa4b557 100644
--- a/Tests/test_file_sgi.py
+++ b/Tests/test_file_sgi.py
@@ -73,11 +73,11 @@ def test_invalid_file() -> None:
 
 def test_write(tmp_path: Path) -> None:
     def roundtrip(img: Image.Image) -> None:
-        out = str(tmp_path / "temp.sgi")
+        out = tmp_path / "temp.sgi"
         img.save(out, format="sgi")
         assert_image_equal_tofile(img, out)
 
-        out = str(tmp_path / "fp.sgi")
+        out = tmp_path / "fp.sgi"
         with open(out, "wb") as fp:
             img.save(fp)
             assert_image_equal_tofile(img, out)
@@ -95,7 +95,7 @@ def test_write16(tmp_path: Path) -> None:
     test_file = "Tests/images/hopper16.rgb"
 
     with Image.open(test_file) as im:
-        out = str(tmp_path / "temp.sgi")
+        out = tmp_path / "temp.sgi"
         im.save(out, format="sgi", bpc=2)
 
         assert_image_equal_tofile(im, out)
@@ -103,7 +103,7 @@ def test_write16(tmp_path: Path) -> None:
 
 def test_unsupported_mode(tmp_path: Path) -> None:
     im = hopper("LA")
-    out = str(tmp_path / "temp.sgi")
+    out = tmp_path / "temp.sgi"
 
     with pytest.raises(ValueError):
         im.save(out, format="sgi")
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index cdb7b3e0ba5..b64a629f581 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -51,7 +51,7 @@ def test_context_manager() -> None:
 
 def test_save(tmp_path: Path) -> None:
     # Arrange
-    temp = str(tmp_path / "temp.spider")
+    temp = tmp_path / "temp.spider"
     im = hopper()
 
     # Act
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index b6396bd64b3..f7b14beab5e 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -24,7 +24,7 @@
 @pytest.mark.parametrize("mode", _MODES)
 def test_sanity(mode: str, tmp_path: Path) -> None:
     def roundtrip(original_im: Image.Image) -> None:
-        out = str(tmp_path / "temp.tga")
+        out = tmp_path / "temp.tga"
 
         original_im.save(out, rle=rle)
         with Image.open(out) as saved_im:
@@ -76,7 +76,7 @@ def test_palette_depth_16(tmp_path: Path) -> None:
         assert im.palette.mode == "RGBA"
         assert_image_equal_tofile(im.convert("RGBA"), "Tests/images/p_16.png")
 
-        out = str(tmp_path / "temp.png")
+        out = tmp_path / "temp.png"
         im.save(out)
         with Image.open(out) as reloaded:
             assert_image_equal_tofile(reloaded.convert("RGBA"), "Tests/images/p_16.png")
@@ -122,7 +122,7 @@ def test_cross_scan_line() -> None:
 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")
+        out = tmp_path / "temp.tga"
 
         # Save
         im.save(out)
@@ -141,7 +141,7 @@ def test_small_palette(tmp_path: Path) -> None:
     colors = [0, 0, 0]
     im.putpalette(colors)
 
-    out = str(tmp_path / "temp.tga")
+    out = tmp_path / "temp.tga"
     im.save(out)
 
     with Image.open(out) as reloaded:
@@ -155,7 +155,7 @@ def test_missing_palette() -> None:
 
 def test_save_wrong_mode(tmp_path: Path) -> None:
     im = hopper("PA")
-    out = str(tmp_path / "temp.tga")
+    out = tmp_path / "temp.tga"
 
     with pytest.raises(OSError):
         im.save(out)
@@ -172,7 +172,7 @@ def test_save_mapdepth() -> None:
 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")
+        out = tmp_path / "temp.tga"
 
         # Check there is no id section
         im.save(out)
@@ -202,7 +202,7 @@ def test_save_id_section(tmp_path: Path) -> None:
 
 def test_save_orientation(tmp_path: Path) -> None:
     test_file = "Tests/images/rgb32rle.tga"
-    out = str(tmp_path / "temp.tga")
+    out = tmp_path / "temp.tga"
     with Image.open(test_file) as im:
         assert im.info["orientation"] == -1
 
@@ -229,7 +229,7 @@ def test_save_rle(tmp_path: Path) -> None:
     with Image.open(test_file) as im:
         assert im.info["compression"] == "tga_rle"
 
-        out = str(tmp_path / "temp.tga")
+        out = tmp_path / "temp.tga"
 
         # Save
         im.save(out)
@@ -266,7 +266,7 @@ def test_save_l_transparency(tmp_path: Path) -> None:
         assert im.mode == "LA"
         assert im.getchannel("A").getcolors()[0][0] == num_transparent
 
-        out = str(tmp_path / "temp.tga")
+        out = tmp_path / "temp.tga"
         im.save(out)
 
     with Image.open(out) as test_im:
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index e98e55acad6..6962a5c9889 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -31,7 +31,7 @@
 
 class TestFileTiff:
     def test_sanity(self, tmp_path: Path) -> None:
-        filename = str(tmp_path / "temp.tif")
+        filename = tmp_path / "temp.tif"
 
         hopper("RGB").save(filename)
 
@@ -112,11 +112,11 @@ 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:
-            outfile = str(tmp_path / "temp.tif")
+            outfile = tmp_path / "temp.tif"
             im.save(outfile, save_all=True, append_images=[im], tiffinfo=im.tag_v2)
 
     def test_bigtiff_save(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         im = hopper()
         im.save(outfile, big_tiff=True)
 
@@ -185,7 +185,7 @@ def test_load_float_dpi(self, resolution_unit: int | None, dpi: float) -> None:
             assert im.info["dpi"] == (dpi, dpi)
 
     def test_save_float_dpi(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/hopper.tif") as im:
             dpi = (72.2, 72.2)
             im.save(outfile, dpi=dpi)
@@ -220,12 +220,12 @@ def test_bad_exif(self) -> None:
 
     def test_save_rgba(self, tmp_path: Path) -> None:
         im = hopper("RGBA")
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         im.save(outfile)
 
     def test_save_unsupported_mode(self, tmp_path: Path) -> None:
         im = hopper("HSV")
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         with pytest.raises(OSError):
             im.save(outfile)
 
@@ -485,14 +485,14 @@ def check_exif(exif: Image.Exif) -> None:
             assert gps[0] == b"\x03\x02\x00\x00"
             assert gps[18] == "WGS-84"
 
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/ifd_tag_type.tiff") as im:
             exif = im.getexif()
             check_exif(exif)
 
             im.save(outfile, exif=exif)
 
-        outfile2 = str(tmp_path / "temp2.tif")
+        outfile2 = tmp_path / "temp2.tif"
         with Image.open(outfile) as im:
             exif = im.getexif()
             check_exif(exif)
@@ -504,7 +504,7 @@ def check_exif(exif: Image.Exif) -> None:
             check_exif(exif)
 
     def test_modify_exif(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/ifd_tag_type.tiff") as im:
             exif = im.getexif()
             exif[264] = 100
@@ -533,7 +533,7 @@ def test_exif_frames(self) -> None:
 
     @pytest.mark.parametrize("mode", ("1", "L"))
     def test_photometric(self, mode: str, tmp_path: Path) -> None:
-        filename = str(tmp_path / "temp.tif")
+        filename = tmp_path / "temp.tif"
         im = hopper(mode)
         im.save(filename, tiffinfo={262: 0})
         with Image.open(filename) as reloaded:
@@ -612,7 +612,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")
+        filename = tmp_path / "temp.tif"
         hopper("RGB").save(filename, "TIFF", **kwargs)
         with Image.open(filename) as im:
             # legacy interface
@@ -630,14 +630,14 @@ def test_roundtrip_tiff_uint16(self, tmp_path: Path) -> None:
         with Image.open(infile) as im:
             assert im.getpixel((0, 0)) == pixel_value
 
-            tmpfile = str(tmp_path / "temp.tif")
+            tmpfile = tmp_path / "temp.tif"
             im.save(tmpfile)
 
             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")
+        outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/hopper.tif") as im:
             im.load()
             assert isinstance(im, TiffImagePlugin.TiffImageFile)
@@ -652,7 +652,7 @@ def test_iptc(self, tmp_path: Path) -> None:
             assert 33723 not in im.tag_v2
 
     def test_rowsperstrip(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         im = hopper()
         im.save(outfile, tiffinfo={278: 256})
 
@@ -703,7 +703,7 @@ def test_planar_configuration_save(self, tmp_path: Path) -> None:
         with Image.open(infile) as im:
             assert im._planar_configuration == 2
 
-            outfile = str(tmp_path / "temp.tif")
+            outfile = tmp_path / "temp.tif"
             im.save(outfile)
 
             with Image.open(outfile) as reloaded:
@@ -718,7 +718,7 @@ def test_invalid_tiled_dimensions(self) -> None:
 
     @pytest.mark.parametrize("mode", ("P", "PA"))
     def test_palette(self, mode: str, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
 
         im = hopper(mode)
         im.save(outfile)
@@ -812,7 +812,7 @@ def test_saving_icc_profile(self, tmp_path: Path) -> None:
         im.info["icc_profile"] = "Dummy value"
 
         # Try save-load round trip to make sure both handle icc_profile.
-        tmpfile = str(tmp_path / "temp.tif")
+        tmpfile = tmp_path / "temp.tif"
         im.save(tmpfile, "TIFF", compression="raw")
         with Image.open(tmpfile) as reloaded:
             assert b"Dummy value" == reloaded.info["icc_profile"]
@@ -821,7 +821,7 @@ def test_save_icc_profile(self, tmp_path: Path) -> None:
         im = hopper()
         assert "icc_profile" not in im.info
 
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
         icc_profile = b"Dummy value"
         im.save(outfile, icc_profile=icc_profile)
 
@@ -832,11 +832,11 @@ 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")
+            outfile = tmp_path / "temp.tif"
             im.save(outfile)
 
     def test_discard_icc_profile(self, tmp_path: Path) -> None:
-        outfile = str(tmp_path / "temp.tif")
+        outfile = tmp_path / "temp.tif"
 
         with Image.open("Tests/images/icc_profile.png") as im:
             assert "icc_profile" in im.info
@@ -889,7 +889,7 @@ def test_get_photoshop_blocks(self) -> None:
             ]
 
     def test_tiff_chunks(self, tmp_path: Path) -> None:
-        tmpfile = str(tmp_path / "temp.tif")
+        tmpfile = tmp_path / "temp.tif"
 
         im = hopper()
         with open(tmpfile, "wb") as fp:
@@ -911,7 +911,7 @@ def test_tiff_chunks(self, tmp_path: Path) -> None:
 
     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")
+        tmpfile = tmp_path / "temp.tif"
 
         with Image.open("Tests/images/uint16_1_4660.tif") as im:
             im.save(tmpfile)
@@ -923,7 +923,7 @@ def test_close_on_load_exclusive(self, tmp_path: Path) -> None:
         assert fp.closed
 
     def test_close_on_load_nonexclusive(self, tmp_path: Path) -> None:
-        tmpfile = str(tmp_path / "temp.tif")
+        tmpfile = tmp_path / "temp.tif"
 
         with Image.open("Tests/images/uint16_1_4660.tif") as im:
             im.save(tmpfile)
@@ -974,7 +974,7 @@ def test_oom(self, test_file: str) -> None:
 @pytest.mark.skipif(not is_win32(), reason="Windows only")
 class TestFileTiffW32:
     def test_fd_leak(self, tmp_path: Path) -> None:
-        tmpfile = str(tmp_path / "temp.tif")
+        tmpfile = tmp_path / "temp.tif"
 
         # this is an mmaped file.
         with Image.open("Tests/images/uint16_1_4660.tif") as im:
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 36aabf4f82c..0734d1db100 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -56,7 +56,7 @@ def test_rt_metadata(tmp_path: Path) -> None:
 
     info[ImageDescription] = text_data
 
-    f = str(tmp_path / "temp.tif")
+    f = tmp_path / "temp.tif"
 
     img.save(f, tiffinfo=info)
 
@@ -128,7 +128,7 @@ def test_read_metadata() -> None:
 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")
+        f = tmp_path / "temp.tiff"
         del img.tag[278]
         img.save(f, tiffinfo=img.tag)
 
@@ -163,7 +163,7 @@ def test_write_metadata(tmp_path: Path) -> None:
 
 
 def test_change_stripbytecounts_tag_type(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     with Image.open("Tests/images/hopper.tif") as im:
         info = im.tag_v2
         del info[278]
@@ -210,7 +210,7 @@ def test_no_duplicate_50741_tag() -> None:
 
 
 def test_iptc(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     with Image.open("Tests/images/hopper.Lab.tif") as im:
         im.save(out)
 
@@ -227,7 +227,7 @@ def test_writing_other_types_to_ascii(
     info[271] = value
 
     im = hopper()
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
@@ -244,7 +244,7 @@ def test_writing_other_types_to_bytes(value: int | IFDRational, tmp_path: Path)
 
     info[700] = value
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
@@ -263,7 +263,7 @@ def test_writing_other_types_to_undefined(
 
     info[33723] = value
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
@@ -296,7 +296,7 @@ def test_empty_metadata() -> None:
 
 def test_iccprofile(tmp_path: Path) -> None:
     # https://github.com/python-pillow/Pillow/issues/1462
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     with Image.open("Tests/images/hopper.iccprofile.tif") as im:
         im.save(out)
 
@@ -317,13 +317,13 @@ def test_iccprofile_binary() -> None:
 
 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")
+        outfile = tmp_path / "temp.png"
         im.save(outfile)
 
 
 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")
+        outfile = tmp_path / "temp.png"
         im.save(outfile)
 
 
@@ -332,7 +332,7 @@ def test_exif_div_zero(tmp_path: Path) -> None:
     info = TiffImagePlugin.ImageFileDirectory_v2()
     info[41988] = TiffImagePlugin.IFDRational(0, 0)
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
@@ -351,7 +351,7 @@ def test_ifd_unsigned_rational(tmp_path: Path) -> None:
 
     info[41493] = TiffImagePlugin.IFDRational(numerator, 1)
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
@@ -363,7 +363,7 @@ def test_ifd_unsigned_rational(tmp_path: Path) -> None:
 
     info[41493] = TiffImagePlugin.IFDRational(numerator, 1)
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
@@ -381,7 +381,7 @@ def test_ifd_signed_rational(tmp_path: Path) -> None:
 
     info[37380] = TiffImagePlugin.IFDRational(numerator, denominator)
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
@@ -393,7 +393,7 @@ def test_ifd_signed_rational(tmp_path: Path) -> None:
 
     info[37380] = TiffImagePlugin.IFDRational(numerator, denominator)
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
@@ -406,7 +406,7 @@ def test_ifd_signed_rational(tmp_path: Path) -> None:
 
     info[37380] = TiffImagePlugin.IFDRational(numerator, denominator)
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
@@ -420,7 +420,7 @@ def test_ifd_signed_long(tmp_path: Path) -> None:
 
     info[37000] = -60000
 
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
@@ -446,7 +446,7 @@ 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)
-        out = str(tmp_path / "temp.tiff")
+        out = tmp_path / "temp.tiff"
         im.save(out)
     with Image.open(out) as reloaded:
         assert len(reloaded.tag_v2[34377]) == 70
@@ -480,7 +480,7 @@ def test_tag_group_data() -> None:
 
 
 def test_empty_subifd(tmp_path: Path) -> None:
-    out = str(tmp_path / "temp.jpg")
+    out = tmp_path / "temp.jpg"
 
     im = hopper()
     exif = im.getexif()
diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index c88fe3589ea..c573390c403 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -42,7 +42,7 @@ def test_write_lossless_rgb(tmp_path: Path) -> None:
     Does it have the bits we expect?
     """
 
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
     # temp_file = "temp.webp"
 
     pil_image = hopper("RGBA")
@@ -71,7 +71,7 @@ def test_write_rgba(tmp_path: Path) -> None:
     Does it have the bits we expect?
     """
 
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
 
     pil_image = Image.new("RGBA", (10, 10), (255, 0, 0, 20))
     pil_image.save(temp_file)
@@ -104,7 +104,7 @@ def test_keep_rgb_values_when_transparent(tmp_path: Path) -> None:
     half_transparent_image.putalpha(new_alpha)
 
     # save with transparent area preserved
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
     half_transparent_image.save(temp_file, exact=True, lossless=True)
 
     with Image.open(temp_file) as reloaded:
@@ -123,7 +123,7 @@ def test_write_unsupported_mode_PA(tmp_path: Path) -> None:
     should work, and be similar to the original file.
     """
 
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
     file_path = "Tests/images/transparent.gif"
     with Image.open(file_path) as im:
         im.save(temp_file)
@@ -142,10 +142,10 @@ def test_write_unsupported_mode_PA(tmp_path: Path) -> None:
 
 def test_alpha_quality(tmp_path: Path) -> None:
     with Image.open("Tests/images/transparent.png") as im:
-        out = str(tmp_path / "temp.webp")
+        out = tmp_path / "temp.webp"
         im.save(out)
 
-        out_quality = str(tmp_path / "quality.webp")
+        out_quality = 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:
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index 967a0aae847..d4b1fda9725 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -39,7 +39,7 @@ def test_write_animation_L(tmp_path: Path) -> None:
     with Image.open("Tests/images/iss634.gif") as orig:
         assert orig.n_frames > 1
 
-        temp_file = str(tmp_path / "temp.webp")
+        temp_file = tmp_path / "temp.webp"
         orig.save(temp_file, save_all=True)
         with Image.open(temp_file) as im:
             assert im.n_frames == orig.n_frames
@@ -67,7 +67,7 @@ def test_write_animation_RGB(tmp_path: Path) -> None:
     are visually similar to the originals.
     """
 
-    def check(temp_file: str) -> None:
+    def check(temp_file: Path) -> None:
         with Image.open(temp_file) as im:
             assert im.n_frames == 2
 
@@ -87,7 +87,7 @@ def check(temp_file: str) -> None:
 
     with Image.open("Tests/images/anim_frame1.webp") as frame1:
         with Image.open("Tests/images/anim_frame2.webp") as frame2:
-            temp_file1 = str(tmp_path / "temp.webp")
+            temp_file1 = tmp_path / "temp.webp"
             frame1.copy().save(
                 temp_file1, save_all=True, append_images=[frame2], lossless=True
             )
@@ -99,7 +99,7 @@ def im_generator(
             ) -> Generator[Image.Image, None, None]:
                 yield from ims
 
-            temp_file2 = str(tmp_path / "temp_generator.webp")
+            temp_file2 = tmp_path / "temp_generator.webp"
             frame1.copy().save(
                 temp_file2,
                 save_all=True,
@@ -116,7 +116,7 @@ def test_timestamp_and_duration(tmp_path: Path) -> None:
     """
 
     durations = [0, 10, 20, 30, 40]
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
     with Image.open("Tests/images/anim_frame1.webp") as frame1:
         with Image.open("Tests/images/anim_frame2.webp") as frame2:
             frame1.save(
@@ -141,7 +141,7 @@ def test_timestamp_and_duration(tmp_path: Path) -> None:
 
 
 def test_float_duration(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
     with Image.open("Tests/images/iss634.apng") as im:
         assert im.info["duration"] == 70.0
 
@@ -159,7 +159,7 @@ def test_seeking(tmp_path: Path) -> None:
     """
 
     dur = 33
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
     with Image.open("Tests/images/anim_frame1.webp") as frame1:
         with Image.open("Tests/images/anim_frame2.webp") as frame2:
             frame1.save(
@@ -196,10 +196,10 @@ 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")
+        out = tmp_path / "temp.webp"
         first_frame.save(out, save_all=True, append_images=[im])
 
-        out_quality = str(tmp_path / "quality.webp")
+        out_quality = tmp_path / "quality.webp"
         first_frame.save(
             out_quality, save_all=True, append_images=[im], alpha_quality=50
         )
diff --git a/Tests/test_file_webp_lossless.py b/Tests/test_file_webp_lossless.py
index 80429715e9e..5eaa4f59906 100644
--- a/Tests/test_file_webp_lossless.py
+++ b/Tests/test_file_webp_lossless.py
@@ -13,7 +13,7 @@
 
 
 def test_write_lossless_rgb(tmp_path: Path) -> None:
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = 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 c68a20d7a3f..d1d3421ec5b 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -146,7 +146,7 @@ def test_write_animated_metadata(tmp_path: Path) -> None:
     exif_data = b"<exif_data>"
     xmp_data = b"<xmp_data>"
 
-    temp_file = str(tmp_path / "temp.webp")
+    temp_file = tmp_path / "temp.webp"
     with Image.open("Tests/images/anim_frame1.webp") as frame1:
         with Image.open("Tests/images/anim_frame2.webp") as frame2:
             frame1.save(
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 97469b77e1e..07c945848ca 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -59,7 +59,7 @@ def save(self, im: Image.Image, fp: IO[bytes], filename: str) -> None:
     WmfImagePlugin.register_handler(handler)
 
     im = hopper()
-    tmpfile = str(tmp_path / "temp.wmf")
+    tmpfile = tmp_path / "temp.wmf"
     im.save(tmpfile)
     assert handler.methodCalled
 
@@ -93,6 +93,6 @@ def test_load_set_dpi() -> None:
 def test_save(ext: str, tmp_path: Path) -> None:
     im = hopper()
 
-    tmpfile = str(tmp_path / ("temp" + ext))
+    tmpfile = tmp_path / ("temp" + ext)
     with pytest.raises(OSError):
         im.save(tmpfile)
diff --git a/Tests/test_file_xbm.py b/Tests/test_file_xbm.py
index 44dd2541fb5..154f3dcc061 100644
--- a/Tests/test_file_xbm.py
+++ b/Tests/test_file_xbm.py
@@ -73,7 +73,7 @@ def test_invalid_file() -> None:
 
 def test_save_wrong_mode(tmp_path: Path) -> None:
     im = hopper()
-    out = str(tmp_path / "temp.xbm")
+    out = tmp_path / "temp.xbm"
 
     with pytest.raises(OSError):
         im.save(out)
@@ -81,7 +81,7 @@ def test_save_wrong_mode(tmp_path: Path) -> None:
 
 def test_hotspot(tmp_path: Path) -> None:
     im = hopper("1")
-    out = str(tmp_path / "temp.xbm")
+    out = tmp_path / "temp.xbm"
 
     hotspot = (0, 7)
     im.save(out, hotspot=hotspot)
diff --git a/Tests/test_image.py b/Tests/test_image.py
index d64816b1ee4..7f46cb7b0a0 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -187,14 +187,14 @@ def test_pathlib(self, tmp_path: Path) -> None:
             for ext in (".jpg", ".jp2"):
                 if ext == ".jp2" and not features.check_codec("jpg_2000"):
                     pytest.skip("jpg_2000 not available")
-                temp_file = str(tmp_path / ("temp." + ext))
+                temp_file = tmp_path / ("temp." + ext)
                 im.save(Path(temp_file))
 
     def test_fp_name(self, tmp_path: Path) -> None:
-        temp_file = str(tmp_path / "temp.jpg")
+        temp_file = tmp_path / "temp.jpg"
 
         class FP(io.BytesIO):
-            name: str
+            name: Path
 
             if sys.version_info >= (3, 12):
                 from collections.abc import Buffer
@@ -225,7 +225,7 @@ def test_tempfile(self) -> None:
 
     def test_unknown_extension(self, tmp_path: Path) -> None:
         im = hopper()
-        temp_file = str(tmp_path / "temp.unknown")
+        temp_file = tmp_path / "temp.unknown"
         with pytest.raises(ValueError):
             im.save(temp_file)
 
@@ -245,7 +245,7 @@ def test_internals(self) -> None:
         reason="Test requires opening an mmaped file for writing",
     )
     def test_readonly_save(self, tmp_path: Path) -> None:
-        temp_file = str(tmp_path / "temp.bmp")
+        temp_file = tmp_path / "temp.bmp"
         shutil.copy("Tests/images/rgb32bf-rgba.bmp", temp_file)
 
         with Image.open(temp_file) as im:
@@ -728,7 +728,7 @@ 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"
-        temp_file = str(tmp_path / "temp.jpg")
+        temp_file = tmp_path / "temp.jpg"
 
         # Act/Assert
         with Image.open(test_file) as im:
@@ -738,7 +738,7 @@ def test_no_resource_warning_on_save(self, tmp_path: Path) -> None:
                 im.save(temp_file)
 
     def test_no_new_file_on_error(self, tmp_path: Path) -> None:
-        temp_file = str(tmp_path / "temp.jpg")
+        temp_file = tmp_path / "temp.jpg"
 
         im = Image.new("RGB", (0, 0))
         with pytest.raises(ValueError):
@@ -805,7 +805,7 @@ def test_exif_jpeg(self, tmp_path: Path) -> None:
             assert exif[296] == 2
             assert exif[11] == "gThumb 3.0.1"
 
-            out = str(tmp_path / "temp.jpg")
+            out = tmp_path / "temp.jpg"
             exif[258] = 8
             del exif[274]
             del exif[282]
@@ -827,7 +827,7 @@ def test_exif_jpeg(self, tmp_path: Path) -> None:
             assert exif[274] == 1
             assert exif[305] == "Adobe Photoshop CC 2017 (Macintosh)"
 
-            out = str(tmp_path / "temp.jpg")
+            out = tmp_path / "temp.jpg"
             exif[258] = 8
             del exif[306]
             exif[274] = 455
@@ -846,7 +846,7 @@ def test_exif_webp(self, tmp_path: Path) -> None:
             exif = im.getexif()
             assert exif == {}
 
-            out = str(tmp_path / "temp.webp")
+            out = tmp_path / "temp.webp"
             exif[258] = 8
             exif[40963] = 455
             exif[305] = "Pillow test"
@@ -868,7 +868,7 @@ def test_exif_png(self, tmp_path: Path) -> None:
             exif = im.getexif()
             assert exif == {274: 1}
 
-            out = str(tmp_path / "temp.png")
+            out = tmp_path / "temp.png"
             exif[258] = 8
             del exif[274]
             exif[40963] = 455
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 5f8b35c79d6..7d4f78c2371 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -118,7 +118,7 @@ def test_trns_p(tmp_path: Path) -> None:
     im = hopper("P")
     im.info["transparency"] = 0
 
-    f = str(tmp_path / "temp.png")
+    f = tmp_path / "temp.png"
 
     im_l = im.convert("L")
     assert im_l.info["transparency"] == 0
@@ -154,7 +154,7 @@ def test_trns_l(tmp_path: Path) -> None:
     im = hopper("L")
     im.info["transparency"] = 128
 
-    f = str(tmp_path / "temp.png")
+    f = tmp_path / "temp.png"
 
     im_la = im.convert("LA")
     assert "transparency" not in im_la.info
@@ -177,7 +177,7 @@ def test_trns_RGB(tmp_path: Path) -> None:
     im = hopper("RGB")
     im.info["transparency"] = im.getpixel((0, 0))
 
-    f = str(tmp_path / "temp.png")
+    f = tmp_path / "temp.png"
 
     im_l = im.convert("L")
     assert im_l.info["transparency"] == im_l.getpixel((0, 0))  # undone
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 1166371b8f9..f700d20c0c9 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -171,7 +171,7 @@ def test_cross_platform(self, tmp_path: Path) -> None:
         # platforms. So if a future Pillow change requires that the test file
         # be updated, that is okay.
         im = hopper().resize((64, 64))
-        temp_file = str(tmp_path / "temp.gif")
+        temp_file = tmp_path / "temp.gif"
         im.save(temp_file)
 
         with Image.open(temp_file) as reloaded:
diff --git a/Tests/test_image_split.py b/Tests/test_image_split.py
index 3385f81f527..43068535e6e 100644
--- a/Tests/test_image_split.py
+++ b/Tests/test_image_split.py
@@ -45,9 +45,9 @@ def test_split_merge(mode: str) -> None:
 
 def test_split_open(tmp_path: Path) -> None:
     if features.check("zlib"):
-        test_file = str(tmp_path / "temp.png")
+        test_file = tmp_path / "temp.png"
     else:
-        test_file = str(tmp_path / "temp.pcx")
+        test_file = tmp_path / "temp.pcx"
 
     def split_open(mode: str) -> int:
         hopper(mode).save(test_file)
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 4cce8f180df..69533c2f840 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -124,7 +124,7 @@ def test_render_equal(layout_engine: ImageFont.Layout) -> None:
 
 
 def test_non_ascii_path(tmp_path: Path, layout_engine: ImageFont.Layout) -> None:
-    tempfile = str(tmp_path / ("temp_" + chr(128) + ".ttf"))
+    tempfile = tmp_path / ("temp_" + chr(128) + ".ttf")
     try:
         shutil.copy(FONT_PATH, tempfile)
     except UnicodeEncodeError:
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 26b287bb4d3..da9e71692b9 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -10,7 +10,7 @@
 
 
 def test_sanity(tmp_path: Path) -> None:
-    test_file = str(tmp_path / "temp.im")
+    test_file = tmp_path / "temp.im"
 
     im = hopper("RGB")
     im.save(test_file)
diff --git a/Tests/test_imagewin_pointers.py b/Tests/test_imagewin_pointers.py
index c23a5c690a2..e8468e59f54 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -88,7 +88,7 @@ def serialize_dib(bi: BITMAPINFOHEADER, pixels: ctypes.c_void_p) -> bytearray:
     def test_pointer(tmp_path: Path) -> None:
         im = hopper()
         (width, height) = im.size
-        opath = str(tmp_path / "temp.png")
+        opath = tmp_path / "temp.png"
         imdib = ImageWin.Dib(im)
 
         hdr = BITMAPINFOHEADER()
diff --git a/Tests/test_mode_i16.py b/Tests/test_mode_i16.py
index e26f5d283ab..b78b7984fe2 100644
--- a/Tests/test_mode_i16.py
+++ b/Tests/test_mode_i16.py
@@ -44,7 +44,7 @@ def test_basic(tmp_path: Path, mode: str) -> None:
     im_out = im_in.transform((w, h), Image.Transform.EXTENT, (0, 0, w, h))
     verify(im_out)  # transform
 
-    filename = str(tmp_path / "temp.im")
+    filename = tmp_path / "temp.im"
     im_in.save(filename)
 
     with Image.open(filename) as im_out:
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index 05c41a802c9..70661ecc17a 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -18,7 +18,7 @@ def helper_pickle_file(
 ) -> None:
     # Arrange
     with Image.open(test_file) as im:
-        filename = str(tmp_path / "temp.pkl")
+        filename = tmp_path / "temp.pkl"
         if mode:
             im = im.convert(mode)
 
@@ -87,7 +87,7 @@ def test_pickle_jpeg() -> None:
 
 def test_pickle_la_mode_with_palette(tmp_path: Path) -> None:
     # Arrange
-    filename = str(tmp_path / "temp.pkl")
+    filename = tmp_path / "temp.pkl"
     with Image.open("Tests/images/hopper.jpg") as im:
         im = im.convert("PA")
 
@@ -151,7 +151,7 @@ def test_pickle_font_string(protocol: int) -> 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")
+    filename = tmp_path / "temp.pkl"
 
     # Act: roundtrip
     with open(filename, "wb") as f:
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index a743d831f5a..78f5632c5d8 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -35,7 +35,7 @@ def test_draw_postscript(tmp_path: Path) -> None:
     # https://pillow.readthedocs.io/en/latest/handbook/tutorial.html#drawing-postscript
 
     # Arrange
-    tempfile = str(tmp_path / "temp.ps")
+    tempfile = tmp_path / "temp.ps"
     with open(tempfile, "wb") as fp:
         # Act
         ps = PSDraw.PSDraw(fp)
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index dd4fc46c374..4fd3aab5df1 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -35,7 +35,7 @@ def assert_save_filename_check(
     @pytest.mark.skipif(not djpeg_available(), reason="djpeg not available")
     def test_load_djpeg_filename(self, tmp_path: Path) -> None:
         for filename in test_filenames:
-            src_file = str(tmp_path / filename)
+            src_file = tmp_path / filename
             shutil.copy(TEST_JPG, src_file)
 
             with Image.open(src_file) as im:
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index 13f1f9c80fe..30dc7365480 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -65,7 +65,7 @@ def test_ifd_rational_save(
     monkeypatch: pytest.MonkeyPatch, tmp_path: Path, libtiff: bool
 ) -> None:
     im = hopper()
-    out = str(tmp_path / "temp.tiff")
+    out = tmp_path / "temp.tiff"
     res = IFDRational(301, 1)
 
     monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", libtiff)

From 700d36f2d2b351074a136243d7d72682bd3113e0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 20 Mar 2025 00:11:18 +1100
Subject: [PATCH 1554/2374] Added release notes for #8807

---
 docs/handbook/image-file-formats.rst | 6 ++++++
 docs/releasenotes/11.2.0.rst         | 8 ++++++++
 2 files changed, 14 insertions(+)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index b0e20fa8428..97599ace546 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -93,6 +93,12 @@ DXT1 and DXT5 pixel formats can be read, only in ``RGBA`` mode.
    in ``P`` mode.
 
 
+.. versionadded:: 11.2.0
+   DXT1, DXT3, DXT5, BC2, BC3 and BC5 pixel formats can be saved::
+
+       im.save(out, pixel_format="DXT1")
+
+
 DIB
 ^^^
 
diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index f7e644cf32d..3e977221eb9 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -66,6 +66,14 @@ libjpeg library, and what version of MozJPEG is being used::
     features.check_feature("mozjpeg")  # True or False
     features.version_feature("mozjpeg")  # "4.1.1" for example, or None
 
+Saving compressed DDS images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Compressed DDS images can now be saved using a ``pixel_format`` argument. DXT1, DXT3,
+DXT5, BC2, BC3 and BC5 are supported::
+
+    im.save("out.dds", pixel_format="DXT1")
+
 Other Changes
 =============
 

From acd8548f6e38b48c2af02d5081584472535afd52 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 20 Mar 2025 22:36:59 +1100
Subject: [PATCH 1555/2374] Removed FIXME

---
 src/PIL/Image.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 884659882b7..e2a76dfe1be 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -548,7 +548,6 @@ class Image:
 
     def __init__(self) -> None:
         # FIXME: take "new" parameters / other image?
-        # FIXME: turn mode and size into delegating properties?
         self._im: core.ImagingCore | DeferredError | None = None
         self._mode = ""
         self._size = (0, 0)

From 0888dc02ac9700acdaf5d07691203fb7e57a538a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 20 Mar 2025 23:10:09 +1100
Subject: [PATCH 1556/2374] Allow for two header fields and a comment

---
 Tests/images/full_gimp_palette.gpl | 260 +++++++++++++++++++++++++++++
 Tests/test_file_gimppalette.py     |  22 ++-
 src/PIL/GimpPaletteFile.py         |   4 +-
 3 files changed, 282 insertions(+), 4 deletions(-)
 create mode 100644 Tests/images/full_gimp_palette.gpl

diff --git a/Tests/images/full_gimp_palette.gpl b/Tests/images/full_gimp_palette.gpl
new file mode 100644
index 00000000000..004217210df
--- /dev/null
+++ b/Tests/images/full_gimp_palette.gpl
@@ -0,0 +1,260 @@
+GIMP Palette
+Name: fullpalette
+Columns: 4
+#
+  0   0   0     Index 0
+  1   1   1     Index 1
+  2   2   2     Index 2
+  3   3   3     Index 3
+  4   4   4     Index 4
+  5   5   5     Index 5
+  6   6   6     Index 6
+  7   7   7     Index 7
+  8   8   8     Index 8
+  9   9   9     Index 9
+ 10  10  10     Index 10
+ 11  11  11     Index 11
+ 12  12  12     Index 12
+ 13  13  13     Index 13
+ 14  14  14     Index 14
+ 15  15  15     Index 15
+ 16  16  16     Index 16
+ 17  17  17     Index 17
+ 18  18  18     Index 18
+ 19  19  19     Index 19
+ 20  20  20     Index 20
+ 21  21  21     Index 21
+ 22  22  22     Index 22
+ 23  23  23     Index 23
+ 24  24  24     Index 24
+ 25  25  25     Index 25
+ 26  26  26     Index 26
+ 27  27  27     Index 27
+ 28  28  28     Index 28
+ 29  29  29     Index 29
+ 30  30  30     Index 30
+ 31  31  31     Index 31
+ 32  32  32     Index 32
+ 33  33  33     Index 33
+ 34  34  34     Index 34
+ 35  35  35     Index 35
+ 36  36  36     Index 36
+ 37  37  37     Index 37
+ 38  38  38     Index 38
+ 39  39  39     Index 39
+ 40  40  40     Index 40
+ 41  41  41     Index 41
+ 42  42  42     Index 42
+ 43  43  43     Index 43
+ 44  44  44     Index 44
+ 45  45  45     Index 45
+ 46  46  46     Index 46
+ 47  47  47     Index 47
+ 48  48  48     Index 48
+ 49  49  49     Index 49
+ 50  50  50     Index 50
+ 51  51  51     Index 51
+ 52  52  52     Index 52
+ 53  53  53     Index 53
+ 54  54  54     Index 54
+ 55  55  55     Index 55
+ 56  56  56     Index 56
+ 57  57  57     Index 57
+ 58  58  58     Index 58
+ 59  59  59     Index 59
+ 60  60  60     Index 60
+ 61  61  61     Index 61
+ 62  62  62     Index 62
+ 63  63  63     Index 63
+ 64  64  64     Index 64
+ 65  65  65     Index 65
+ 66  66  66     Index 66
+ 67  67  67     Index 67
+ 68  68  68     Index 68
+ 69  69  69     Index 69
+ 70  70  70     Index 70
+ 71  71  71     Index 71
+ 72  72  72     Index 72
+ 73  73  73     Index 73
+ 74  74  74     Index 74
+ 75  75  75     Index 75
+ 76  76  76     Index 76
+ 77  77  77     Index 77
+ 78  78  78     Index 78
+ 79  79  79     Index 79
+ 80  80  80     Index 80
+ 81  81  81     Index 81
+ 82  82  82     Index 82
+ 83  83  83     Index 83
+ 84  84  84     Index 84
+ 85  85  85     Index 85
+ 86  86  86     Index 86
+ 87  87  87     Index 87
+ 88  88  88     Index 88
+ 89  89  89     Index 89
+ 90  90  90     Index 90
+ 91  91  91     Index 91
+ 92  92  92     Index 92
+ 93  93  93     Index 93
+ 94  94  94     Index 94
+ 95  95  95     Index 95
+ 96  96  96     Index 96
+ 97  97  97     Index 97
+ 98  98  98     Index 98
+ 99  99  99     Index 99
+100 100 100     Index 100
+101 101 101     Index 101
+102 102 102     Index 102
+103 103 103     Index 103
+104 104 104     Index 104
+105 105 105     Index 105
+106 106 106     Index 106
+107 107 107     Index 107
+108 108 108     Index 108
+109 109 109     Index 109
+110 110 110     Index 110
+111 111 111     Index 111
+112 112 112     Index 112
+113 113 113     Index 113
+114 114 114     Index 114
+115 115 115     Index 115
+116 116 116     Index 116
+117 117 117     Index 117
+118 118 118     Index 118
+119 119 119     Index 119
+120 120 120     Index 120
+121 121 121     Index 121
+122 122 122     Index 122
+123 123 123     Index 123
+124 124 124     Index 124
+125 125 125     Index 125
+126 126 126     Index 126
+127 127 127     Index 127
+128 128 128     Index 128
+129 129 129     Index 129
+130 130 130     Index 130
+131 131 131     Index 131
+132 132 132     Index 132
+133 133 133     Index 133
+134 134 134     Index 134
+135 135 135     Index 135
+136 136 136     Index 136
+137 137 137     Index 137
+138 138 138     Index 138
+139 139 139     Index 139
+140 140 140     Index 140
+141 141 141     Index 141
+142 142 142     Index 142
+143 143 143     Index 143
+144 144 144     Index 144
+145 145 145     Index 145
+146 146 146     Index 146
+147 147 147     Index 147
+148 148 148     Index 148
+149 149 149     Index 149
+150 150 150     Index 150
+151 151 151     Index 151
+152 152 152     Index 152
+153 153 153     Index 153
+154 154 154     Index 154
+155 155 155     Index 155
+156 156 156     Index 156
+157 157 157     Index 157
+158 158 158     Index 158
+159 159 159     Index 159
+160 160 160     Index 160
+161 161 161     Index 161
+162 162 162     Index 162
+163 163 163     Index 163
+164 164 164     Index 164
+165 165 165     Index 165
+166 166 166     Index 166
+167 167 167     Index 167
+168 168 168     Index 168
+169 169 169     Index 169
+170 170 170     Index 170
+171 171 171     Index 171
+172 172 172     Index 172
+173 173 173     Index 173
+174 174 174     Index 174
+175 175 175     Index 175
+176 176 176     Index 176
+177 177 177     Index 177
+178 178 178     Index 178
+179 179 179     Index 179
+180 180 180     Index 180
+181 181 181     Index 181
+182 182 182     Index 182
+183 183 183     Index 183
+184 184 184     Index 184
+185 185 185     Index 185
+186 186 186     Index 186
+187 187 187     Index 187
+188 188 188     Index 188
+189 189 189     Index 189
+190 190 190     Index 190
+191 191 191     Index 191
+192 192 192     Index 192
+193 193 193     Index 193
+194 194 194     Index 194
+195 195 195     Index 195
+196 196 196     Index 196
+197 197 197     Index 197
+198 198 198     Index 198
+199 199 199     Index 199
+200 200 200     Index 200
+201 201 201     Index 201
+202 202 202     Index 202
+203 203 203     Index 203
+204 204 204     Index 204
+205 205 205     Index 205
+206 206 206     Index 206
+207 207 207     Index 207
+208 208 208     Index 208
+209 209 209     Index 209
+210 210 210     Index 210
+211 211 211     Index 211
+212 212 212     Index 212
+213 213 213     Index 213
+214 214 214     Index 214
+215 215 215     Index 215
+216 216 216     Index 216
+217 217 217     Index 217
+218 218 218     Index 218
+219 219 219     Index 219
+220 220 220     Index 220
+221 221 221     Index 221
+222 222 222     Index 222
+223 223 223     Index 223
+224 224 224     Index 224
+225 225 225     Index 225
+226 226 226     Index 226
+227 227 227     Index 227
+228 228 228     Index 228
+229 229 229     Index 229
+230 230 230     Index 230
+231 231 231     Index 231
+232 232 232     Index 232
+233 233 233     Index 233
+234 234 234     Index 234
+235 235 235     Index 235
+236 236 236     Index 236
+237 237 237     Index 237
+238 238 238     Index 238
+239 239 239     Index 239
+240 240 240     Index 240
+241 241 241     Index 241
+242 242 242     Index 242
+243 243 243     Index 243
+244 244 244     Index 244
+245 245 245     Index 245
+246 246 246     Index 246
+247 247 247     Index 247
+248 248 248     Index 248
+249 249 249     Index 249
+250 250 250     Index 250
+251 251 251     Index 251
+252 252 252     Index 252
+253 253 253     Index 253
+254 254 254     Index 254
+255 255 255     Index 255
diff --git a/Tests/test_file_gimppalette.py b/Tests/test_file_gimppalette.py
index ff9cc91c5c2..c122b37b38b 100644
--- a/Tests/test_file_gimppalette.py
+++ b/Tests/test_file_gimppalette.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from io import BytesIO
+
 import pytest
 
 from PIL.GimpPaletteFile import GimpPaletteFile
@@ -22,9 +24,12 @@ def test_sanity() -> None:
             GimpPaletteFile(fp)
 
 
-def test_get_palette() -> None:
+@pytest.mark.parametrize(
+    "filename, size", (("custom_gimp_palette.gpl", 8), ("full_gimp_palette.gpl", 256))
+)
+def test_get_palette(filename: str, size: int) -> None:
     # Arrange
-    with open("Tests/images/custom_gimp_palette.gpl", "rb") as fp:
+    with open("Tests/images/" + filename, "rb") as fp:
         palette_file = GimpPaletteFile(fp)
 
     # Act
@@ -32,4 +37,15 @@ def test_get_palette() -> None:
 
     # Assert
     assert mode == "RGB"
-    assert len(palette) / 3 == 8
+    assert len(palette) / 3 == size
+
+
+def test_palette_limit() -> None:
+    with open("Tests/images/full_gimp_palette.gpl", "rb") as fp:
+        data = fp.read()
+
+    # Test that __init__ only reads 256 entries
+    data = data.replace(b"#\n", b"") + b"  0   0   0     Index 256"
+    b = BytesIO(data)
+    palette = GimpPaletteFile(b)
+    assert len(palette.palette) / 3 == 256
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index 0f079f45758..a8748720901 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -30,7 +30,7 @@ def __init__(self, fp: IO[bytes]) -> None:
             raise SyntaxError(msg)
 
         palette: list[int] = []
-        for _ in range(256):
+        for _ in range(256 + 3):
             s = fp.readline()
             if not s:
                 break
@@ -48,6 +48,8 @@ def __init__(self, fp: IO[bytes]) -> None:
                 raise ValueError(msg)
 
             palette += (int(v[i]) for i in range(3))
+            if len(palette) == 768:
+                break
 
         self.palette = bytes(palette)
 

From 510bc055774291d2380ea5d8e25faa84c7dfc637 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 20 Mar 2025 23:12:35 +1100
Subject: [PATCH 1557/2374] Added frombytes() to allow for unlimited parsing

---
 Tests/test_file_gimppalette.py | 24 +++++++++++++++++++-----
 src/PIL/GimpPaletteFile.py     | 23 +++++++++++++++++++----
 2 files changed, 38 insertions(+), 9 deletions(-)

diff --git a/Tests/test_file_gimppalette.py b/Tests/test_file_gimppalette.py
index c122b37b38b..c3d2bfeb75d 100644
--- a/Tests/test_file_gimppalette.py
+++ b/Tests/test_file_gimppalette.py
@@ -16,11 +16,11 @@ def test_sanity() -> None:
             GimpPaletteFile(fp)
 
     with open("Tests/images/bad_palette_file.gpl", "rb") as fp:
-        with pytest.raises(SyntaxError):
+        with pytest.raises(SyntaxError, match="bad palette file"):
             GimpPaletteFile(fp)
 
     with open("Tests/images/bad_palette_entry.gpl", "rb") as fp:
-        with pytest.raises(ValueError):
+        with pytest.raises(ValueError, match="bad palette entry"):
             GimpPaletteFile(fp)
 
 
@@ -40,12 +40,26 @@ def test_get_palette(filename: str, size: int) -> None:
     assert len(palette) / 3 == size
 
 
-def test_palette_limit() -> None:
+def test_frombytes() -> None:
     with open("Tests/images/full_gimp_palette.gpl", "rb") as fp:
-        data = fp.read()
+        full_data = fp.read()
 
     # Test that __init__ only reads 256 entries
-    data = data.replace(b"#\n", b"") + b"  0   0   0     Index 256"
+    data = full_data.replace(b"#\n", b"") + b"  0   0   0     Index 256"
     b = BytesIO(data)
     palette = GimpPaletteFile(b)
     assert len(palette.palette) / 3 == 256
+
+    # Test that frombytes() can read beyond that
+    palette = GimpPaletteFile.frombytes(data)
+    assert len(palette.palette) / 3 == 257
+
+    # Test that __init__ raises an error if a comment is too long
+    data = full_data[:-1] + b"a" * 100
+    b = BytesIO(data)
+    with pytest.raises(SyntaxError, match="bad palette file"):
+        palette = GimpPaletteFile(b)
+
+    # Test that frombytes() can read the data regardless
+    palette = GimpPaletteFile.frombytes(data)
+    assert len(palette.palette) / 3 == 256
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index a8748720901..379ffd73918 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -16,6 +16,7 @@
 from __future__ import annotations
 
 import re
+from io import BytesIO
 from typing import IO
 
 
@@ -24,13 +25,18 @@ class GimpPaletteFile:
 
     rawmode = "RGB"
 
-    def __init__(self, fp: IO[bytes]) -> None:
+    def _read(self, fp: IO[bytes], limit: bool = True) -> None:
         if not fp.readline().startswith(b"GIMP Palette"):
             msg = "not a GIMP palette file"
             raise SyntaxError(msg)
 
         palette: list[int] = []
-        for _ in range(256 + 3):
+        i = 0
+        while True:
+            if limit and i == 256 + 3:
+                break
+
+            i += 1
             s = fp.readline()
             if not s:
                 break
@@ -38,7 +44,7 @@ def __init__(self, fp: IO[bytes]) -> None:
             # skip fields and comment lines
             if re.match(rb"\w+:|#", s):
                 continue
-            if len(s) > 100:
+            if limit and len(s) > 100:
                 msg = "bad palette file"
                 raise SyntaxError(msg)
 
@@ -48,10 +54,19 @@ def __init__(self, fp: IO[bytes]) -> None:
                 raise ValueError(msg)
 
             palette += (int(v[i]) for i in range(3))
-            if len(palette) == 768:
+            if limit and len(palette) == 768:
                 break
 
         self.palette = bytes(palette)
 
+    def __init__(self, fp: IO[bytes]) -> None:
+        self._read(fp)
+
+    @classmethod
+    def frombytes(cls, data: bytes) -> GimpPaletteFile:
+        self = cls.__new__(cls)
+        self._read(BytesIO(data), False)
+        return self
+
     def getpalette(self) -> tuple[bytes, str]:
         return self.palette, self.rawmode

From 21ff960c9c796892e5e13fa8ca2d382565141539 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 21 Mar 2025 08:51:41 +1100
Subject: [PATCH 1558/2374] Test that an unlimited number of lines is not read
 by __init__

---
 Tests/test_file_gimppalette.py | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_gimppalette.py b/Tests/test_file_gimppalette.py
index c3d2bfeb75d..08862113b15 100644
--- a/Tests/test_file_gimppalette.py
+++ b/Tests/test_file_gimppalette.py
@@ -41,10 +41,17 @@ def test_get_palette(filename: str, size: int) -> None:
 
 
 def test_frombytes() -> None:
-    with open("Tests/images/full_gimp_palette.gpl", "rb") as fp:
-        full_data = fp.read()
+    # Test that __init__ stops reading after 260 lines
+    with open("Tests/images/custom_gimp_palette.gpl", "rb") as fp:
+        custom_data = fp.read()
+    custom_data += b"#\n" * 300 + b"  0   0   0     Index 12"
+    b = BytesIO(custom_data)
+    palette = GimpPaletteFile(b)
+    assert len(palette.palette) / 3 == 8
 
     # Test that __init__ only reads 256 entries
+    with open("Tests/images/full_gimp_palette.gpl", "rb") as fp:
+        full_data = fp.read()
     data = full_data.replace(b"#\n", b"") + b"  0   0   0     Index 256"
     b = BytesIO(data)
     palette = GimpPaletteFile(b)

From 8d440f734bbf1caac75cd3f94dcd737e401a21b0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 21 Mar 2025 20:39:36 +1100
Subject: [PATCH 1559/2374] Removed unused argument

---
 Tests/test_file_gif.py | 2 +-
 Tests/test_file_tga.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index fb1a636ed1a..ba0963e8cd8 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1242,7 +1242,7 @@ def test_rgba_transparency(tmp_path: Path) -> None:
         assert_image_equal(hopper("P").convert("RGB"), reloaded)
 
 
-def test_background_outside_palettte(tmp_path: Path) -> None:
+def test_background_outside_palettte() -> None:
     with Image.open("Tests/images/background_outside_palette.gif") as im:
         im.seek(1)
         assert im.info["background"] == 255
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index f7b14beab5e..a10d4d7ab9d 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -65,7 +65,7 @@ def roundtrip(original_im: Image.Image) -> None:
                     roundtrip(original_im)
 
 
-def test_palette_depth_8(tmp_path: Path) -> None:
+def test_palette_depth_8() -> None:
     with pytest.raises(UnidentifiedImageError):
         Image.open("Tests/images/p_8.tga")
 

From 8d5505487766b3e1c31e90c41599fb84de694174 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 21 Mar 2025 20:41:15 +1100
Subject: [PATCH 1560/2374] Reuse temp 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 f99ca91a316..c969bd502c5 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -672,7 +672,7 @@ def test_plte_length(self, tmp_path: Path) -> None:
         im.putpalette((1, 1, 1))
 
         out = tmp_path / "temp.png"
-        im.save(tmp_path / "temp.png")
+        im.save(out)
 
         with Image.open(out) as reloaded:
             assert len(reloaded.png.im_palette[1]) == 3

From 9334bf040ef35f31c6b388e95d91f8fa8dcfc220 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 21 Mar 2025 20:41:52 +1100
Subject: [PATCH 1561/2374] Do not cast unnecessarily

---
 Tests/test_image.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 7f46cb7b0a0..d13e4760255 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -187,8 +187,7 @@ def test_pathlib(self, tmp_path: Path) -> None:
             for ext in (".jpg", ".jp2"):
                 if ext == ".jp2" and not features.check_codec("jpg_2000"):
                     pytest.skip("jpg_2000 not available")
-                temp_file = tmp_path / ("temp." + ext)
-                im.save(Path(temp_file))
+                im.save(tmp_path / ("temp." + ext))
 
     def test_fp_name(self, tmp_path: Path) -> None:
         temp_file = tmp_path / "temp.jpg"

From c7e3158d515fe339f67e1b0313105ae9b88efa42 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 21 Mar 2025 20:47:38 +1100
Subject: [PATCH 1562/2374] Added explicit test for opening and saving image
 with string

---
 Tests/test_image.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index d13e4760255..f18d8489c62 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -175,6 +175,13 @@ def test_stringio(self) -> None:
             with Image.open(io.StringIO()):  # type: ignore[arg-type]
                 pass
 
+    def test_string(self, tmp_path: Path) -> None:
+        out = str(tmp_path / "temp.png")
+        im = hopper()
+        im.save(out)
+        with Image.open(out) as reloaded:
+            assert_image_equal(im, reloaded)
+
     def test_pathlib(self, tmp_path: Path) -> None:
         with Image.open(Path("Tests/images/multipage-mmap.tiff")) as im:
             assert im.mode == "P"

From bca693bd82ce1dab40a375d101c5292e3a275143 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 24 Mar 2025 17:33:45 +1100
Subject: [PATCH 1563/2374] Updated harfbuzz to 11.0.0 (#8830)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .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 e9c54536e0a..51ba0cf2806 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,7 +38,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=10.4.0
+HARFBUZZ_VERSION=11.0.0
 LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index ea3d9939447..2e9e187192e 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.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "10.4.0",
+    "HARFBUZZ": "11.0.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.17",
     "LIBIMAGEQUANT": "4.3.4",

From 053b5790e13030b9ac13a70489f48453dab7cb8f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 25 Mar 2025 00:22:21 +1100
Subject: [PATCH 1564/2374] Added media_white_point (#8829)

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

diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index 96bd14dd32c..4a1f5a3eed7 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -286,6 +286,14 @@ 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
+        :type: tuple[tuple[float, float, float], tuple[float, float, float]] | None
+
+        This tag specifies the media white point and is used for
+        generating absolute colorimetry.
+
+        The value is in the format ``((X, Y, Z), (x, y, Y))``, if available.
+
     .. py:attribute:: media_white_point_temperature
         :type: float | None
 

From 14d495a519a4c444c3f3ef369c21ad45551f689b Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 25 Mar 2025 00:41:03 +0000
Subject: [PATCH 1565/2374] Update dependency cibuildwheel to v2.23.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 f2109ed6194..db5f89c9a04 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.23.1
+cibuildwheel==2.23.2

From b8abded99b4f77db591e270836156349a074c3bc Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 26 Mar 2025 00:31:49 +1100
Subject: [PATCH 1566/2374] Change back to actions/setup-python (#8833)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .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 c4ad88be9f0..006d574f3fb 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -70,7 +70,7 @@ jobs:
         persist-credentials: false
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: Quansight-Labs/setup-python@v5
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true

From 295a5e9bd7fe021df6ea3aa41d54738dcd3f8250 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 7 Jan 2025 19:23:04 +1100
Subject: [PATCH 1567/2374] Do not convert BC1 LUT to UINT32

---
 src/libImaging/BcnDecode.c | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/src/libImaging/BcnDecode.c b/src/libImaging/BcnDecode.c
index 9a41febc764..7b3d8f908e3 100644
--- a/src/libImaging/BcnDecode.c
+++ b/src/libImaging/BcnDecode.c
@@ -25,7 +25,6 @@ typedef struct {
 
 typedef struct {
     UINT16 c0, c1;
-    UINT32 lut;
 } bc1_color;
 
 typedef struct {
@@ -40,13 +39,10 @@ typedef struct {
 
 #define LOAD16(p) (p)[0] | ((p)[1] << 8)
 
-#define LOAD32(p) (p)[0] | ((p)[1] << 8) | ((p)[2] << 16) | ((p)[3] << 24)
-
 static void
 bc1_color_load(bc1_color *dst, const UINT8 *src) {
     dst->c0 = LOAD16(src);
     dst->c1 = LOAD16(src + 2);
-    dst->lut = LOAD32(src + 4);
 }
 
 static rgba
@@ -70,7 +66,7 @@ static void
 decode_bc1_color(rgba *dst, const UINT8 *src, int separate_alpha) {
     bc1_color col;
     rgba p[4];
-    int n, cw;
+    int n, o, cw;
     UINT16 r0, g0, b0, r1, g1, b1;
     bc1_color_load(&col, src);
 
@@ -103,9 +99,11 @@ decode_bc1_color(rgba *dst, const UINT8 *src, int separate_alpha) {
         p[3].b = 0;
         p[3].a = 0;
     }
-    for (n = 0; n < 16; n++) {
-        cw = 3 & (col.lut >> (2 * n));
-        dst[n] = p[cw];
+    for (n = 0; n < 4; n++) {
+        for (o = 0; o < 4; o++) {
+            cw = 3 & ((src + 4)[n] >> (2 * o));
+            dst[n * 4 + o] = p[cw];
+        }
     }
 }
 

From e1f0def839776c131a8f297c7b05712d1cfbee75 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 27 Mar 2025 23:43:07 +1100
Subject: [PATCH 1568/2374] Updated xz to 5.8.0, except on manylinux2014
 (#8836)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/wheels-dependencies.sh | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 51ba0cf2806..461729a74b2 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -42,7 +42,11 @@ HARFBUZZ_VERSION=11.0.0
 LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
-XZ_VERSION=5.6.4
+if [[ $MB_ML_VER == 2014 ]]; then
+  XZ_VERSION=5.6.4
+else
+  XZ_VERSION=5.8.0
+fi
 TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_NG_VERSION=2.2.4

From 3c185d1f696dfbe20a5401a2f36edd392b2094d2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 27 Mar 2025 23:44:27 +1100
Subject: [PATCH 1569/2374] Do not load image during save if file extension is
 unknown (#8835)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_hdf5stub.py |  2 +-
 src/PIL/Image.py            | 14 +++++++-------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index 50864009f6a..e4f09a09c52 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -43,7 +43,7 @@ def test_save() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
         dummy_fp = BytesIO()
-        dummy_filename = "dummy.filename"
+        dummy_filename = "dummy.h5"
 
         # Act / Assert: stub cannot save without an implemented handler
         with pytest.raises(OSError):
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index e2a76dfe1be..d338e4dfde6 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2510,13 +2510,6 @@ def save(
             # only set the name for metadata purposes
             filename = os.fspath(fp.name)
 
-        # may mutate self!
-        self._ensure_mutable()
-
-        save_all = params.pop("save_all", False)
-        self.encoderinfo = {**getattr(self, "encoderinfo", {}), **params}
-        self.encoderconfig: tuple[Any, ...] = ()
-
         preinit()
 
         filename_ext = os.path.splitext(filename)[1].lower()
@@ -2531,6 +2524,13 @@ def save(
                 msg = f"unknown file extension: {ext}"
                 raise ValueError(msg) from e
 
+        # may mutate self!
+        self._ensure_mutable()
+
+        save_all = params.pop("save_all", False)
+        self.encoderinfo = {**getattr(self, "encoderinfo", {}), **params}
+        self.encoderconfig: tuple[Any, ...] = ()
+
         if format.upper() not in SAVE:
             init()
         if save_all:

From 10ccbd7788532f72939d38c41f3f7303ff07b4da Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 28 Mar 2025 03:01:09 +1100
Subject: [PATCH 1570/2374] If append_images is populated, default save_all to
 True (#8781)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_gif.py               |  6 ++++++
 docs/handbook/image-file-formats.rst | 26 ++++++++++++++------------
 docs/handbook/tutorial.rst           |  1 -
 src/PIL/Image.py                     |  8 ++++++--
 4 files changed, 26 insertions(+), 15 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index ba0963e8cd8..376eab0c682 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1138,6 +1138,12 @@ def test_append_images(tmp_path: Path) -> None:
     ims = [Image.new("RGB", (100, 100), color) for color in ["#0f0", "#00f"]]
     im.copy().save(out, save_all=True, append_images=ims)
 
+    with Image.open(out) as reread:
+        assert reread.n_frames == 3
+
+    # Test append_images without save_all
+    im.copy().save(out, append_images=ims)
+
     with Image.open(out) as reread:
         assert reread.n_frames == 3
 
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 97599ace546..c0b1a9d4e84 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -235,8 +235,9 @@ following options are available::
     im.save(out, save_all=True, append_images=[im1, im2, ...])
 
 **save_all**
-    If present and true, all frames of the image will be saved. If
-    not, then only the first frame of a multiframe image will be saved.
+    If present and true, or if ``append_images`` is not empty, all frames of
+    the image will be saved. Otherwise, only the first frame of a multiframe
+    image will be saved.
 
 **append_images**
     A list of images to append as additional frames. Each of the
@@ -723,8 +724,8 @@ Saving
 
 When calling :py:meth:`~PIL.Image.Image.save` to write an MPO 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
-option will also be available.
+argument is present and true, or if ``append_images`` is not empty, all frames
+will be saved.
 
 **append_images**
     A list of images to append as additional pictures. Each of the
@@ -934,7 +935,8 @@ Saving
 
 When calling :py:meth:`~PIL.Image.Image.save`, by default only a single frame PNG file
 will be saved. To save an APNG file (including a single frame APNG), the ``save_all``
-parameter must be set to ``True``. The following parameters can also be set:
+parameter should be set to ``True`` or ``append_images`` should not be empty. The
+following parameters can also be set:
 
 **default_image**
     Boolean value, specifying whether or not the base image is a default image.
@@ -1163,7 +1165,8 @@ Saving
 The :py:meth:`~PIL.Image.Image.save` method can take the following keyword arguments:
 
 **save_all**
-    If true, Pillow will save all frames of the image to a multiframe tiff document.
+    If true, or if ``append_images`` is not empty, Pillow will save all frames of the
+    image to a multiframe tiff document.
 
     .. versionadded:: 3.4.0
 
@@ -1313,8 +1316,8 @@ Saving sequences
 
 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
-options will also be available.
+argument is present and true, or if ``append_images`` is not empty, all frames
+will be saved, and the following options will also be available.
 
 **append_images**
     A list of images to append as additional frames. Each of the
@@ -1616,15 +1619,14 @@ The :py:meth:`~PIL.Image.Image.save` method can take the following keyword argum
 **save_all**
     If a multiframe image is used, by default, only the first image will be saved.
     To save all frames, each frame to a separate page of the PDF, the ``save_all``
-    parameter must be present and set to ``True``.
+    parameter should be present and set to ``True`` or ``append_images`` should not be
+    empty.
 
     .. versionadded:: 3.0.0
 
 **append_images**
     A list of :py:class:`PIL.Image.Image` objects to append as additional pages. Each
-    of the images in the list can be single or multiframe images. The ``save_all``
-    parameter must be present and set to ``True`` in conjunction with
-    ``append_images``.
+    of the images in the list can be single or multiframe images.
 
     .. versionadded:: 4.2.0
 
diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index f771ae7aea5..f1a2849b897 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -534,7 +534,6 @@ You can create animated GIFs with Pillow, e.g.
     # 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
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index d338e4dfde6..67e068b06fa 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2527,13 +2527,17 @@ def save(
         # may mutate self!
         self._ensure_mutable()
 
-        save_all = params.pop("save_all", False)
+        save_all = params.pop("save_all", None)
         self.encoderinfo = {**getattr(self, "encoderinfo", {}), **params}
         self.encoderconfig: tuple[Any, ...] = ()
 
         if format.upper() not in SAVE:
             init()
-        if save_all:
+        if save_all or (
+            save_all is None
+            and params.get("append_images")
+            and format.upper() in SAVE_ALL
+        ):
             save_handler = SAVE_ALL[format.upper()]
         else:
             save_handler = SAVE[format.upper()]

From 1cb6c7c347a7509e0303c32cfe8f5d1e063be1b3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 28 Mar 2025 23:27:39 +1100
Subject: [PATCH 1571/2374] Parametrize tests (#8838)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_bmp.py | 28 +++++++----------
 Tests/test_file_sgi.py | 28 +++++++++--------
 Tests/test_file_tga.py | 68 ++++++++++++++++++++++--------------------
 3 files changed, 62 insertions(+), 62 deletions(-)

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 64d2acaf551..8a94011e833 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -15,25 +15,19 @@
 )
 
 
-def test_sanity(tmp_path: Path) -> None:
-    def roundtrip(im: Image.Image) -> None:
-        outfile = tmp_path / "temp.bmp"
-
-        im.save(outfile, "BMP")
-
-        with Image.open(outfile) as reloaded:
-            reloaded.load()
-            assert im.mode == reloaded.mode
-            assert im.size == reloaded.size
-            assert reloaded.format == "BMP"
-            assert reloaded.get_format_mimetype() == "image/bmp"
+@pytest.mark.parametrize("mode", ("1", "L", "P", "RGB"))
+def test_sanity(mode: str, tmp_path: Path) -> None:
+    outfile = tmp_path / "temp.bmp"
 
-    roundtrip(hopper())
+    im = hopper(mode)
+    im.save(outfile, "BMP")
 
-    roundtrip(hopper("1"))
-    roundtrip(hopper("L"))
-    roundtrip(hopper("P"))
-    roundtrip(hopper("RGB"))
+    with Image.open(outfile) as reloaded:
+        reloaded.load()
+        assert im.mode == reloaded.mode
+        assert im.size == reloaded.size
+        assert reloaded.format == "BMP"
+        assert reloaded.get_format_mimetype() == "image/bmp"
 
 
 def test_invalid_file() -> None:
diff --git a/Tests/test_file_sgi.py b/Tests/test_file_sgi.py
index 7d34fa4b557..da0965fa14f 100644
--- a/Tests/test_file_sgi.py
+++ b/Tests/test_file_sgi.py
@@ -71,24 +71,26 @@ def test_invalid_file() -> None:
         SgiImagePlugin.SgiImageFile(invalid_file)
 
 
-def test_write(tmp_path: Path) -> None:
-    def roundtrip(img: Image.Image) -> None:
-        out = tmp_path / "temp.sgi"
-        img.save(out, format="sgi")
+def roundtrip(img: Image.Image, tmp_path: Path) -> None:
+    out = tmp_path / "temp.sgi"
+    img.save(out, format="sgi")
+    assert_image_equal_tofile(img, out)
+
+    out = tmp_path / "fp.sgi"
+    with open(out, "wb") as fp:
+        img.save(fp)
         assert_image_equal_tofile(img, out)
 
-        out = tmp_path / "fp.sgi"
-        with open(out, "wb") as fp:
-            img.save(fp)
-            assert_image_equal_tofile(img, out)
+        assert not fp.closed
+
 
-            assert not fp.closed
+@pytest.mark.parametrize("mode", ("L", "RGB", "RGBA"))
+def test_write(mode: str, tmp_path: Path) -> None:
+    roundtrip(hopper(mode), tmp_path)
 
-    for mode in ("L", "RGB", "RGBA"):
-        roundtrip(hopper(mode))
 
-    # Test 1 dimension for an L mode image
-    roundtrip(Image.new("L", (10, 1)))
+def test_write_L_mode_1_dimension(tmp_path: Path) -> None:
+    roundtrip(Image.new("L", (10, 1)), tmp_path)
 
 
 def test_write16(tmp_path: Path) -> None:
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index a10d4d7ab9d..8b6ed3ed226 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -1,8 +1,6 @@
 from __future__ import annotations
 
 import os
-from glob import glob
-from itertools import product
 from pathlib import Path
 
 import pytest
@@ -15,14 +13,27 @@
 _TGA_DIR_COMMON = os.path.join(_TGA_DIR, "common")
 
 
-_MODES = ("L", "LA", "P", "RGB", "RGBA")
 _ORIGINS = ("tl", "bl")
 
 _ORIGIN_TO_ORIENTATION = {"tl": 1, "bl": -1}
 
 
-@pytest.mark.parametrize("mode", _MODES)
-def test_sanity(mode: str, tmp_path: Path) -> None:
+@pytest.mark.parametrize(
+    "size_mode",
+    (
+        ("1x1", "L"),
+        ("200x32", "L"),
+        ("200x32", "LA"),
+        ("200x32", "P"),
+        ("200x32", "RGB"),
+        ("200x32", "RGBA"),
+    ),
+)
+@pytest.mark.parametrize("origin", _ORIGINS)
+@pytest.mark.parametrize("rle", (True, False))
+def test_sanity(
+    size_mode: tuple[str, str], origin: str, rle: str, tmp_path: Path
+) -> None:
     def roundtrip(original_im: Image.Image) -> None:
         out = tmp_path / "temp.tga"
 
@@ -36,33 +47,26 @@ def roundtrip(original_im: Image.Image) -> None:
 
             assert_image_equal(saved_im, original_im)
 
-    png_paths = glob(os.path.join(_TGA_DIR_COMMON, f"*x*_{mode.lower()}.png"))
-
-    for png_path in png_paths:
-        with Image.open(png_path) as reference_im:
-            assert reference_im.mode == mode
-
-            path_no_ext = os.path.splitext(png_path)[0]
-            for origin, rle in product(_ORIGINS, (True, False)):
-                tga_path = "{}_{}_{}.tga".format(
-                    path_no_ext, origin, "rle" if rle else "raw"
-                )
-
-                with Image.open(tga_path) as original_im:
-                    assert original_im.format == "TGA"
-                    assert original_im.get_format_mimetype() == "image/x-tga"
-                    if rle:
-                        assert original_im.info["compression"] == "tga_rle"
-                    assert (
-                        original_im.info["orientation"]
-                        == _ORIGIN_TO_ORIENTATION[origin]
-                    )
-                    if mode == "P":
-                        assert original_im.getpalette() == reference_im.getpalette()
-
-                    assert_image_equal(original_im, reference_im)
-
-                    roundtrip(original_im)
+    size, mode = size_mode
+    png_path = os.path.join(_TGA_DIR_COMMON, size + "_" + mode.lower() + ".png")
+    with Image.open(png_path) as reference_im:
+        assert reference_im.mode == mode
+
+        path_no_ext = os.path.splitext(png_path)[0]
+        tga_path = "{}_{}_{}.tga".format(path_no_ext, origin, "rle" if rle else "raw")
+
+        with Image.open(tga_path) as original_im:
+            assert original_im.format == "TGA"
+            assert original_im.get_format_mimetype() == "image/x-tga"
+            if rle:
+                assert original_im.info["compression"] == "tga_rle"
+            assert original_im.info["orientation"] == _ORIGIN_TO_ORIENTATION[origin]
+            if mode == "P":
+                assert original_im.getpalette() == reference_im.getpalette()
+
+            assert_image_equal(original_im, reference_im)
+
+            roundtrip(original_im)
 
 
 def test_palette_depth_8() -> None:

From 722283e8199ab071906982d5efde51f2122ed5ae Mon Sep 17 00:00:00 2001
From: Adian Kozlica <kozlicaadian@gmail.com>
Date: Fri, 28 Mar 2025 16:43:10 +0100
Subject: [PATCH 1572/2374] Add KDE Wayland support for ImageGrab

---
 Tests/test_imagegrab.py | 4 +---
 src/PIL/ImageGrab.py    | 9 +++++++--
 2 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 5cd510751e2..e8fd9524ce4 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -40,9 +40,7 @@ def test_grab_x11(self) -> None:
 
     @pytest.mark.skipif(Image.core.HAVE_XCB, reason="tests missing XCB")
     def test_grab_no_xcb(self) -> None:
-        if sys.platform not in ("win32", "darwin") and not shutil.which(
-            "gnome-screenshot"
-        ):
+        if sys.platform not in ("win32", "darwin") and not shutil.which("gnome-screenshot") and not shutil.which('spectacle'):
             with pytest.raises(OSError) as e:
                 ImageGrab.grab()
             assert str(e.value).startswith("Pillow was built without XCB support")
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index fe27bfaeb6f..5ac0b6a2199 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -80,11 +80,16 @@ def grab(
         if (
             display_name is None
             and sys.platform not in ("darwin", "win32")
-            and shutil.which("gnome-screenshot")
         ):
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
-            subprocess.call(["gnome-screenshot", "-f", filepath])
+            if shutil.which("gnome-screenshot"):
+                subprocess.call(["gnome-screenshot", "-f", filepath])
+            elif shutil.which("spectacle"):
+                subprocess.call(["spectacle", "-n", "-b", "-f", "-o", filepath])
+            else:
+                os.unlink(filepath)
+                raise           
             im = Image.open(filepath)
             im.load()
             os.unlink(filepath)

From eeb494abf714579c0744381eaaaab1fc1f5eac85 Mon Sep 17 00:00:00 2001
From: Adian Kozlica <kozlicaadian@gmail.com>
Date: Fri, 28 Mar 2025 17:18:09 +0100
Subject: [PATCH 1573/2374] Fix formatting

---
 Tests/test_imagegrab.py | 6 +++++-
 src/PIL/ImageGrab.py    | 7 ++-----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index e8fd9524ce4..ab06f04e25d 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -40,7 +40,11 @@ def test_grab_x11(self) -> None:
 
     @pytest.mark.skipif(Image.core.HAVE_XCB, reason="tests missing XCB")
     def test_grab_no_xcb(self) -> None:
-        if sys.platform not in ("win32", "darwin") and not shutil.which("gnome-screenshot") and not shutil.which('spectacle'):
+        if (
+            sys.platform not in ("win32", "darwin")
+            and not shutil.which("gnome-screenshot")
+            and not shutil.which("spectacle")
+        ):
             with pytest.raises(OSError) as e:
                 ImageGrab.grab()
             assert str(e.value).startswith("Pillow was built without XCB support")
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 5ac0b6a2199..e79b4d651a4 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -77,10 +77,7 @@ def grab(
             raise OSError(msg)
         size, data = Image.core.grabscreen_x11(display_name)
     except OSError:
-        if (
-            display_name is None
-            and sys.platform not in ("darwin", "win32")
-        ):
+        if display_name is None and sys.platform not in ("darwin", "win32"):
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
             if shutil.which("gnome-screenshot"):
@@ -89,7 +86,7 @@ def grab(
                 subprocess.call(["spectacle", "-n", "-b", "-f", "-o", filepath])
             else:
                 os.unlink(filepath)
-                raise           
+                raise
             im = Image.open(filepath)
             im.load()
             os.unlink(filepath)

From e685e2833e9e6de8f03cdc71ac9b58107c909768 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 29 Mar 2025 18:27:02 +1100
Subject: [PATCH 1574/2374] Do not create temporary file if no utility is
 available

---
 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 e79b4d651a4..db2a8db0692 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -78,15 +78,15 @@ def grab(
         size, data = Image.core.grabscreen_x11(display_name)
     except OSError:
         if display_name is None and sys.platform not in ("darwin", "win32"):
-            fh, filepath = tempfile.mkstemp(".png")
-            os.close(fh)
             if shutil.which("gnome-screenshot"):
-                subprocess.call(["gnome-screenshot", "-f", filepath])
+                args = ["gnome-screenshot", "-f"]
             elif shutil.which("spectacle"):
-                subprocess.call(["spectacle", "-n", "-b", "-f", "-o", filepath])
+                args = ["spectacle", "-n", "-b", "-f", "-o"]
             else:
-                os.unlink(filepath)
                 raise
+            fh, filepath = tempfile.mkstemp(".png")
+            os.close(fh)
+            subprocess.call(args + [filepath])
             im = Image.open(filepath)
             im.load()
             os.unlink(filepath)

From ae52f9f37d2bee5ccd2ce10fb9c3d6318e675b89 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 00:21:51 +1100
Subject: [PATCH 1575/2374] Added release notes for #8781 and #8837 (#8843)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 docs/releasenotes/11.2.0.rst | 37 ++++++++++++------------------------
 1 file changed, 12 insertions(+), 25 deletions(-)

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index 3e977221eb9..d40d86f21a8 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -4,21 +4,12 @@
 Security
 ========
 
-TODO
-^^^^
+Undefined shift when loading compressed DDS images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
-
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
-
-Backwards Incompatible Changes
-==============================
-
-TODO
-^^^^
+When loading some compressed DDS formats, an integer was bitshifted by 24 places to
+generate the 32 bits of the lookup table. This was undefined behaviour, and has been
+present since Pillow 3.4.0.
 
 Deprecations
 ============
@@ -36,10 +27,14 @@ an :py:class:`PIL.ImageFile.ImageFile` instance.
 API Changes
 ===========
 
-TODO
-^^^^
+``append_images`` no longer requires ``save_all``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously, ``save_all`` was required to in order to use ``append_images``. Now,
+``save_all`` will default to ``True`` if ``append_images`` is not empty and the format
+supports saving multiple frames::
 
-TODO
+    im.save("out.gif", append_images=ims)
 
 API Additions
 =============
@@ -73,11 +68,3 @@ Compressed DDS images can now be saved using a ``pixel_format`` argument. DXT1,
 DXT5, BC2, BC3 and BC5 are supported::
 
     im.save("out.dds", pixel_format="DXT1")
-
-Other Changes
-=============
-
-TODO
-^^^^
-
-TODO

From 6d42449788e4c05a76cc7c9c81a7c8b2a40d099e Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:25:13 +1100
Subject: [PATCH 1576/2374] Allow loading of EMF images at a given DPI (#8536)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/images/drawing_emf_ref_72_144.png | Bin 0 -> 984 bytes
 Tests/test_file_wmf.py                  |  14 ++++++++++++++
 src/PIL/WmfImagePlugin.py               |  24 ++++++++++++++----------
 3 files changed, 28 insertions(+), 10 deletions(-)
 create mode 100644 Tests/images/drawing_emf_ref_72_144.png

diff --git a/Tests/images/drawing_emf_ref_72_144.png b/Tests/images/drawing_emf_ref_72_144.png
new file mode 100644
index 0000000000000000000000000000000000000000..000377b6c7b1e05688fc17d5da09d163a18c5b4b
GIT binary patch
literal 984
zcmV;}11J26P)<h;3K|Lk000e1NJLTq002?|005*20ssI2i-qpU000A@Nkl<Zc%1E>
z+m?eM3`K+g|If}tT8An^fFxX!{W??4_QVUcOTu}cFoF=ms9ghq-o8T!`G3$n3L4r;
z;S(Tv7<A-iwPWGpZsMaLEia{w!p)n;Lm(%ANNhBOaCSHY0Dio9IcSDC?aq)B8w3D>
z*g4bg5BZ5u>}=ZTECjnbkG7~Y!fVc;t>BC>n)hm}IU`)=UE0dd2#a~U_7G>J-@H+K
zpfl2G-l#p+8R@B^MO*Hfv6kjaTC`_~8fk9zYVCQVM%pr{(;j{$OVW@;o%V#z&{S20
z_H6APQ(GHVd(QU0sJ*sPwP$ulswyOD&)nWI^g2n}^GA))>lB$n90)P+vi2$+jt~Pc
zYp>GbRTQ+>iW;HRT+m)IYD&#H?G>X&ik0WISBx4dR=(Q}jL56@x*d+>>wnc=x5JTq
z{odpet9ST^cZ;<4>K$IhoBYcr9ge)XB(%5haPTI##a(-=6B|hx-L);8*x*fWiy!R`
zPi*Aj^`mX%#D-XV+o%EHVdv+zC0yGQuDvz4pF4cCC;yEGJ66)Z;o6pP?cIql<_Flj
zjDxAPV_e%3u5Ag|wuEb2!nG~o+Lo}TeT_YBX<r-$2issb?a>8{;W*E8=kK*&u$uPh
z0#pg#mvPzBzHn_zxV9x++Y+vA3D>rSYg^&~0E0trLup^5PB5h%<Jy*RZA*N#x4(zQ
zmvOM3wl!Sa66UoBE>oqCm9%f69=AWL)}qDpk;FvW&-2%W_7m4ewmZF(V~zdOPTrXJ
z*G{sz_S<MWrM=PV{r2d&dD?HdcFY!io|z`wIql4t^8FpgGNnwy`#X#m@AG_Y+ctSV
zw(Q&Jxl2)_Sb6qs^vm{nvGUSN6MUtpL8-a4(!_#+Q)=G!l9q?Cc#c99d=RT8ES|Ge
zpA)O4tq0auiW>AfY3qS45;(n1@>+kbrKnL=A$hI8>3{A})shuAu$f!EHj>I!TPwG&
zL#U6Wa@E!;18=CRere*`4+zs%Pqp@J*S59>Y+8SNnpSTPpm8WNL*NZpvWrIT;jP}|
z3_SzSf##jg&^g{7V&3lz{nHG}<}A*@GP|N?&gBeTlS(?~j5kiUxinGpz<tZ)oI(^b
z$KK|BMq-{hMRP9sz<NIaY+2|@6W`C(vuPn=L~5QK+Y)1^hkyOQs58i={lA0MQbgA-
zlSf2hs3WfZ*$r(SCbhAhlJ<SC-=i>U3_C`9IR4e2CH??qha)B=@Nu*N0000<MNUMn
GLSTaTnENdN

literal 0
HcmV?d00001

diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 928493a0f4c..a752f801382 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -97,6 +97,20 @@ def test_load_set_dpi() -> None:
 
             assert_image_similar_tofile(im, "Tests/images/drawing_wmf_ref_144.png", 2.1)
 
+    with Image.open("Tests/images/drawing.emf") as im:
+        assert im.size == (1625, 1625)
+
+        if not hasattr(Image.core, "drawwmf"):
+            return
+        im.load(im.info["dpi"])
+        assert im.size == (1625, 1625)
+
+    with Image.open("Tests/images/drawing.emf") as im:
+        im.load((72, 144))
+        assert im.size == (82, 164)
+
+        assert_image_equal_tofile(im, "Tests/images/drawing_emf_ref_72_144.png")
+
 
 @pytest.mark.parametrize("ext", (".wmf", ".emf"))
 def test_save(ext: str, tmp_path: Path) -> None:
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 04abd52f0b1..f709d026bfd 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -80,8 +80,6 @@ class WmfStubImageFile(ImageFile.StubImageFile):
     format_description = "Windows Metafile"
 
     def _open(self) -> None:
-        self._inch = None
-
         # check placable header
         s = self.fp.read(80)
 
@@ -89,10 +87,11 @@ def _open(self) -> None:
             # placeable windows metafile
 
             # get units per inch
-            self._inch = word(s, 14)
-            if self._inch == 0:
+            inch = word(s, 14)
+            if inch == 0:
                 msg = "Invalid inch"
                 raise ValueError(msg)
+            self._inch: tuple[float, float] = inch, inch
 
             # get bounding box
             x0 = short(s, 6)
@@ -103,8 +102,8 @@ def _open(self) -> None:
             # normalize size to 72 dots per inch
             self.info["dpi"] = 72
             size = (
-                (x1 - x0) * self.info["dpi"] // self._inch,
-                (y1 - y0) * self.info["dpi"] // self._inch,
+                (x1 - x0) * self.info["dpi"] // inch,
+                (y1 - y0) * self.info["dpi"] // inch,
             )
 
             self.info["wmf_bbox"] = x0, y0, x1, y1
@@ -138,6 +137,7 @@ def _open(self) -> None:
                 self.info["dpi"] = xdpi
             else:
                 self.info["dpi"] = xdpi, ydpi
+            self._inch = xdpi, ydpi
 
         else:
             msg = "Unsupported file format"
@@ -153,13 +153,17 @@ def _open(self) -> None:
     def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
-    def load(self, dpi: int | None = None) -> Image.core.PixelAccess | None:
-        if dpi is not None and self._inch is not None:
+    def load(
+        self, dpi: float | tuple[float, float] | None = None
+    ) -> Image.core.PixelAccess | None:
+        if dpi is not None:
             self.info["dpi"] = dpi
             x0, y0, x1, y1 = self.info["wmf_bbox"]
+            if not isinstance(dpi, tuple):
+                dpi = dpi, dpi
             self._size = (
-                (x1 - x0) * self.info["dpi"] // self._inch,
-                (y1 - y0) * self.info["dpi"] // self._inch,
+                int((x1 - x0) * dpi[0] / self._inch[0]),
+                int((y1 - y0) * dpi[1] / self._inch[1]),
             )
         return super().load()
 

From 93cdfeb48879064314af70faf98726e09fb06ab0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:25:57 +1100
Subject: [PATCH 1577/2374] Prevent TIFFRGBAImageBegin from applying image
 orientation (#8556)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_libtiff.py  | 11 +++++++++++
 src/libImaging/TiffDecode.c |  1 +
 2 files changed, 12 insertions(+)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 25d1f57125b..9e63e9c10ae 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1026,6 +1026,17 @@ 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_old_style_jpeg_orientation(self) -> None:
+        with open("Tests/images/old-style-jpeg-compression.tif", "rb") as fp:
+            data = fp.read()
+
+            # Set EXIF Orientation to 2
+            data = data[:102] + b"\x02" + data[103:]
+
+            with Image.open(io.BytesIO(data)) as im:
+                im = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
+            assert_image_equal_tofile(im, "Tests/images/old-style-jpeg-compression.png")
+
     def test_open_missing_samplesperpixel(self) -> None:
         with Image.open(
             "Tests/images/old-style-jpeg-compression-no-samplesperpixel.tif"
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index e4da9162dc9..9a2db95b400 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -299,6 +299,7 @@ _decodeAsRGBA(Imaging im, ImagingCodecState state, TIFF *tiff) {
         return -1;
     }
 
+    img.orientation = ORIENTATION_TOPLEFT;
     img.req_orientation = ORIENTATION_TOPLEFT;
     img.col_offset = 0;
 

From 140e426082bfe1ec84c5d6eb34a3c47eb1d89185 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:27:00 +1100
Subject: [PATCH 1578/2374] Added USE_RAW_ALPHA (#8602)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_bmp.py    | 10 ++++++++++
 src/PIL/BmpImagePlugin.py |  6 +++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 8a94011e833..7576507118b 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -224,3 +224,13 @@ def test_offset() -> None:
     # to exclude the palette size from the pixel data offset
     with Image.open("Tests/images/pal8_offset.bmp") as im:
         assert_image_equal_tofile(im, "Tests/images/bmp/g/pal8.bmp")
+
+
+def test_use_raw_alpha(monkeypatch: pytest.MonkeyPatch) -> None:
+    with Image.open("Tests/images/bmp/g/rgb32.bmp") as im:
+        assert im.info["compression"] == BmpImagePlugin.BmpImageFile.COMPRESSIONS["RAW"]
+        assert im.mode == "RGB"
+
+    monkeypatch.setattr(BmpImagePlugin, "USE_RAW_ALPHA", True)
+    with Image.open("Tests/images/bmp/g/rgb32.bmp") as im:
+        assert im.mode == "RGBA"
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index d60ea591ab9..43131cfe2fa 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -48,6 +48,8 @@
     32: ("RGB", "BGRX"),
 }
 
+USE_RAW_ALPHA = False
+
 
 def _accept(prefix: bytes) -> bool:
     return prefix.startswith(b"BM")
@@ -242,7 +244,9 @@ def _bitmap(self, header: int = 0, offset: int = 0) -> None:
                 msg = "Unsupported BMP bitfields layout"
                 raise OSError(msg)
         elif file_info["compression"] == self.COMPRESSIONS["RAW"]:
-            if file_info["bits"] == 32 and header == 22:  # 32-bit .cur offset
+            if file_info["bits"] == 32 and (
+                header == 22 or USE_RAW_ALPHA  # 32-bit .cur offset
+            ):
                 raw_mode, self._mode = "BGRA", "RGBA"
         elif file_info["compression"] in (
             self.COMPRESSIONS["RLE8"],

From 6bffa3a9d4fe3d5a50c505ec0637d70cc1e8d59b Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:29:02 +1100
Subject: [PATCH 1579/2374] Only read until the offset of the next tile (#8609)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_imagefile.py | 20 ++++++++++++++++++++
 src/PIL/ImageFile.py    |  9 +++++++--
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index c60a475a31b..7622eea99dd 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -131,6 +131,26 @@ def test_safeblock(self) -> None:
 
         assert_image_equal(im1, im2)
 
+    def test_tile_size(self) -> None:
+        with open("Tests/images/hopper.tif", "rb") as im_fp:
+            data = im_fp.read()
+
+        reads = []
+
+        class FP(BytesIO):
+            def read(self, size: int | None = None) -> bytes:
+                reads.append(size)
+                return super().read(size)
+
+        fp = FP(data)
+        with Image.open(fp) as im:
+            assert len(im.tile) == 7
+
+            im.load()
+
+        # Despite multiple tiles, assert only one tile caused a read of maxblock size
+        assert reads.count(im.decodermaxblock) == 1
+
     def test_raise_oserror(self) -> None:
         with pytest.warns(DeprecationWarning):
             with pytest.raises(OSError):
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 1bf8a7e5f21..9470a8dd7d5 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -345,7 +345,7 @@ def load(self) -> Image.core.PixelAccess | None:
                     self.tile, lambda tile: (tile[0], tile[1], tile[3])
                 )
             ]
-            for decoder_name, extents, offset, args in self.tile:
+            for i, (decoder_name, extents, offset, args) in enumerate(self.tile):
                 seek(offset)
                 decoder = Image._getdecoder(
                     self.mode, decoder_name, args, self.decoderconfig
@@ -358,8 +358,13 @@ def load(self) -> Image.core.PixelAccess | None:
                     else:
                         b = prefix
                         while True:
+                            read_bytes = self.decodermaxblock
+                            if i + 1 < len(self.tile):
+                                next_offset = self.tile[i + 1].offset
+                                if next_offset > offset:
+                                    read_bytes = next_offset - offset
                             try:
-                                s = read(self.decodermaxblock)
+                                s = read(read_bytes)
                             except (IndexError, struct.error) as e:
                                 # truncated png/gif
                                 if LOAD_TRUNCATED_IMAGES:

From 03dc994baaa98385ef313669dbfd6e5e80f86380 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:30:30 +1100
Subject: [PATCH 1580/2374] Check that _fp type is not DeferredError before use
 (#8640)

---
 src/PIL/DcxImagePlugin.py    | 3 +++
 src/PIL/FliImagePlugin.py    | 3 +++
 src/PIL/GifImagePlugin.py    | 3 +++
 src/PIL/ImImagePlugin.py     | 3 +++
 src/PIL/ImageFile.py         | 2 +-
 src/PIL/MpoImagePlugin.py    | 5 +++++
 src/PIL/PngImagePlugin.py    | 3 +++
 src/PIL/PsdImagePlugin.py    | 5 +++++
 src/PIL/SpiderImagePlugin.py | 3 +++
 src/PIL/TiffImagePlugin.py   | 4 +++-
 10 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/src/PIL/DcxImagePlugin.py b/src/PIL/DcxImagePlugin.py
index f67f27d73bb..aea661b9cb6 100644
--- a/src/PIL/DcxImagePlugin.py
+++ b/src/PIL/DcxImagePlugin.py
@@ -24,6 +24,7 @@
 
 from . import Image
 from ._binary import i32le as i32
+from ._util import DeferredError
 from .PcxImagePlugin import PcxImageFile
 
 MAGIC = 0x3ADE68B1  # QUIZ: what's this value, then?
@@ -66,6 +67,8 @@ def _open(self) -> None:
     def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
         self.frame = frame
         self.fp = self._fp
         self.fp.seek(self._offset[frame])
diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index b534b30ab83..7c5bfeefa1b 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -22,6 +22,7 @@
 from ._binary import i16le as i16
 from ._binary import i32le as i32
 from ._binary import o8
+from ._util import DeferredError
 
 #
 # decoder
@@ -134,6 +135,8 @@ def seek(self, frame: int) -> None:
             self._seek(f)
 
     def _seek(self, frame: int) -> None:
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
         if frame == 0:
             self.__frame = -1
             self._fp.seek(self.__rewind)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 259e93f0933..045ab102738 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -45,6 +45,7 @@
 from ._binary import i16le as i16
 from ._binary import o8
 from ._binary import o16le as o16
+from ._util import DeferredError
 
 if TYPE_CHECKING:
     from . import _imaging
@@ -167,6 +168,8 @@ def seek(self, frame: int) -> None:
                 raise EOFError(msg) from e
 
     def _seek(self, frame: int, update_image: bool = True) -> None:
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
         if frame == 0:
             # rewind
             self.__offset = 0
diff --git a/src/PIL/ImImagePlugin.py b/src/PIL/ImImagePlugin.py
index 9f20b30f8e7..71b9996780c 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -31,6 +31,7 @@
 from typing import IO, Any
 
 from . import Image, ImageFile, ImagePalette
+from ._util import DeferredError
 
 # --------------------------------------------------------------------
 # Standard tags
@@ -290,6 +291,8 @@ def is_animated(self) -> bool:
     def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
 
         self.frame = frame
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 9470a8dd7d5..f5b72ee0d53 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -167,7 +167,7 @@ def _open(self) -> None:
         pass
 
     def _close_fp(self):
-        if getattr(self, "_fp", False):
+        if getattr(self, "_fp", False) and not isinstance(self._fp, DeferredError):
             if self._fp != self.fp:
                 self._fp.close()
             self._fp = DeferredError(ValueError("Operation on closed image"))
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index e08f80b6b3e..f7393eac059 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -32,6 +32,7 @@
     TiffImagePlugin,
 )
 from ._binary import o32le
+from ._util import DeferredError
 
 
 def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
@@ -125,11 +126,15 @@ def _after_jpeg_open(self, mpheader: dict[int, Any] | None = None) -> None:
         self.readonly = 1
 
     def load_seek(self, pos: int) -> None:
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
         self._fp.seek(pos)
 
     def seek(self, frame: int) -> None:
         if not self._seek_check(frame):
             return
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
         self.fp = self._fp
         self.offset = self.__mpoffsets[frame]
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 4fc6217e1ed..3e3cf65268a 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -48,6 +48,7 @@
 from ._binary import o8
 from ._binary import o16be as o16
 from ._binary import o32be as o32
+from ._util import DeferredError
 
 if TYPE_CHECKING:
     from . import _imaging
@@ -869,6 +870,8 @@ def seek(self, frame: int) -> None:
 
     def _seek(self, frame: int, rewind: bool = False) -> None:
         assert self.png is not None
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
 
         self.dispose: _imaging.ImagingCore | None
         dispose_extent = None
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index 0aada8a065e..f49aaeeb1f5 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -27,6 +27,7 @@
 from ._binary import i32be as i32
 from ._binary import si16be as si16
 from ._binary import si32be as si32
+from ._util import DeferredError
 
 MODES = {
     # (photoshop mode, bits) -> (pil mode, required channels)
@@ -148,6 +149,8 @@ def layers(
     ) -> list[tuple[str, str, tuple[int, int, int, int], list[ImageFile._Tile]]]:
         layers = []
         if self._layers_position is not None:
+            if isinstance(self._fp, DeferredError):
+                raise self._fp.ex
             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)
@@ -167,6 +170,8 @@ def is_animated(self) -> bool:
     def seek(self, layer: int) -> None:
         if not self._seek_check(layer):
             return
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
 
         # seek to given layer (1..max)
         _, mode, _, tile = self.layers[layer - 1]
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index b26e1a996b9..62fa7be03ff 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -40,6 +40,7 @@
 from typing import IO, TYPE_CHECKING, Any, cast
 
 from . import Image, ImageFile
+from ._util import DeferredError
 
 
 def isInt(f: Any) -> int:
@@ -178,6 +179,8 @@ def seek(self, frame: int) -> None:
             raise EOFError(msg)
         if not self._seek_check(frame):
             return
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
         self.stkoffset = self.hdrlen + frame * (self.hdrlen + self.imgbytes)
         self.fp = self._fp
         self.fp.seek(self.stkoffset)
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 39783f1f8b9..ebe599ccaf4 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -58,7 +58,7 @@
 from ._binary import o8
 from ._deprecate import deprecate
 from ._typing import StrOrBytesPath
-from ._util import is_path
+from ._util import DeferredError, is_path
 from .TiffTags import TYPES
 
 if TYPE_CHECKING:
@@ -1222,6 +1222,8 @@ def seek(self, frame: int) -> None:
             self._im = None
 
     def _seek(self, frame: int) -> None:
+        if isinstance(self._fp, DeferredError):
+            raise self._fp.ex
         self.fp = self._fp
 
         while len(self._frame_pos) <= frame:

From e8a9b566036a041f7643d32bf9050ee31de8163c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:33:51 +1100
Subject: [PATCH 1581/2374] Improved connecting discontiguous corners (#8659)

---
 .../discontiguous_corners_polygon.png         | Bin 533 -> 533 bytes
 Tests/test_imagedraw.py                       |   2 +-
 src/libImaging/Draw.c                         |  58 ++++++++----------
 3 files changed, 27 insertions(+), 33 deletions(-)

diff --git a/Tests/images/imagedraw/discontiguous_corners_polygon.png b/Tests/images/imagedraw/discontiguous_corners_polygon.png
index 1b58889c8f3ae45243a7509c907f1928534bcbde..8992a165758676b9ba7777347fb09a3b8c453e3d 100644
GIT binary patch
delta 498
zcmV<O0S*3@1eFAkEq_6>!!QU#x&NVZwfx<mj?>r}B*1oAc++Wu^hDyMmFv3h`#y7(
z^bX*wh={0kNqVm~ZJk<@{7}`frq38OUF0%$Ri9_ST)mw}n@*lB8`kG(v?=7-vMC9z
zPn)FNOFlq0L$jBBfNY*-7kRd9wq_%Fw(J<q)8yH*-@HyH&wrM!aXf)MTlTE)LFC!8
zJ+nq6?-zz7gK$tqK2nv3Jg_VIKS#VaCwYGgDr)x3pljw!tp?4{j|SxZ`AH;icI^v!
zjk`t2JH6}8yv97XN2ue!9Y^=e2D)tIu{r9I4{$+GjFBcSdF)&?)%TirHJK*QbAh37
z+&SD)PX+5I=6|Yw3PRo!R!u=@(yFB(Z9iKf1^G{PiTW3NlG%;C!G%4^PtC=)<n=CW
zPF^z?`;#BKa0>a(TpUFHEepqypH5182bmeUaqnc-s_XgQ{+#-eC+wU`t#9JT<STS<
zzn+=NubzUTsJWR>*W=9jlj!u-K3$uKcEi$mwNKY+qig+H7V^#a7ga8(`}`_7Z^}zP
zQ9q<-<PNVs?WSA&-hK(?LfzXJ%=xoJ?o(Yg+D&f}Pjz)@H(eS38)T?R<=RXIPbMVi
oux?}SPmMdaPvL91U3%pD2eNxR+9QHbW&i*H07*qoM6N<$f~R%@U;qFB

delta 498
zcmV<O0S*3@1eFAkEq_ar!ypVqx&NWKnrAbWO5ri+*HU9f3wBBL`UwX+X}$OBy3Sl%
zc?S@xCgN%gy{gu>sx8egsg|Yw#I!ktma!{-pYw9{cA9Otc{FxdpQqV|m`7tnCY0Yc
zh}>&F0UN>WHJ^ZuV|JNGW22dk=F!+W%xd#!?5C`Y&7-j;iGLTEM`LSqPco0j_UtvF
zc|TaBnTP~M<};~0<^#KGm-vZS{wjg@Oab*XJUP5=3P_!s&8re=9e<X9nm4ERhj~f5
zB<7vj&Gx(`Jak4;@Bj2ZvR^i$%Vs`yj%MZ)Qji-%Oq0}n?7kRko;B`jqBf690YSL#
zJUmfPCG!L4ihq9!Ql1mCPC@FVu}wkQ*`8qv>QD8B{9Jc+$-AK5ydi~mnpf?M*P557
z@N)B#eer(t%M?yAKiL-tnSV;*IP>a^$~!1re}Az#u=?k@{eksw9&mD^TA$$8<{7%T
zU(d|ucb|eKly1+L^El`HZd84>FK6@E9$Xr)_T`*5+iTxtF+aS1Q}Pz|J-^GG59Kvq
z$RE;k<Oz@8_Rwwo*?tT120hyo&iTDV>|Gt3?V-1fyE-1*Ls!QC1{o@oTsl+9J2Pa?
o!@AA+ej3>3+2wVTOis1_06el#wiqRwUjP6A07*qoM6N<$f>{3oE&u=k

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 2767418eac9..ffe9c0979e3 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1704,7 +1704,7 @@ def test_discontiguous_corners_polygon() -> None:
         BLACK,
     )
     expected = os.path.join(IMAGES_PATH, "discontiguous_corners_polygon.png")
-    assert_image_similar_tofile(img, expected, 1)
+    assert_image_equal_tofile(img, expected)
 
 
 def test_polygon2() -> None:
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index ea6f8805efb..d5aff8709f5 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -501,55 +501,49 @@ polygon_generic(
                     // Needed to draw consistent polygons
                     xx[j] = xx[j - 1];
                     j++;
-                } else if (current->dx != 0 && j % 2 == 1 &&
-                           roundf(xx[j - 1]) == xx[j - 1]) {
+                } else if ((ymin == current->ymin || ymin == current->ymax) &&
+                           current->dx != 0) {
                     // Connect discontiguous corners
                     for (k = 0; k < i; k++) {
                         Edge *other_edge = edge_table[k];
-                        if ((current->dx > 0 && other_edge->dx <= 0) ||
-                            (current->dx < 0 && other_edge->dx >= 0)) {
+                        if ((ymin != other_edge->ymin && ymin != other_edge->ymax) ||
+                            other_edge->dx == 0) {
                             continue;
                         }
                         // Check if the two edges join to make a corner
-                        if (xx[j - 1] ==
-                            (ymin - other_edge->y0) * other_edge->dx + other_edge->x0) {
+                        if (roundf(xx[j - 1]) ==
+                            roundf(
+                                (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;
+                            int offset = ymin == current->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;
-                            if (ymin == current->ymax) {
-                                if (current->dx > 0) {
-                                    xx[k] =
-                                        fmax(
+                            if (ymin + offset >= other_edge->ymin &&
+                                ymin + offset <= other_edge->ymax) {
+                                adjacent_line_x_other_edge =
+                                    (ymin + offset - other_edge->y0) * other_edge->dx +
+                                    other_edge->x0;
+                                if (xx[j - 1] > adjacent_line_x + 1 &&
+                                    xx[j - 1] > adjacent_line_x_other_edge + 1) {
+                                    xx[j - 1] =
+                                        roundf(fmax(
                                             adjacent_line_x, adjacent_line_x_other_edge
-                                        ) +
+                                        )) +
                                         1;
-                                } else {
-                                    xx[k] =
-                                        fmin(
+                                } else if (xx[j - 1] < adjacent_line_x - 1 &&
+                                           xx[j - 1] < adjacent_line_x_other_edge - 1) {
+                                    xx[j - 1] =
+                                        roundf(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
-                                    );
-                                } else {
-                                    xx[k] =
-                                        fmax(
-                                            adjacent_line_x, adjacent_line_x_other_edge
-                                        ) +
+                                        )) -
                                         1;
                                 }
+                                break;
                             }
-                            break;
                         }
                     }
                 }

From 25653d2f87f0f0be370442836b472a43c1898b71 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:34:42 +1100
Subject: [PATCH 1582/2374] Corrected P mode save (#8685)

---
 Tests/test_file_palm.py    |  6 +++++-
 src/PIL/PalmImagePlugin.py | 33 +++++++++------------------------
 2 files changed, 14 insertions(+), 25 deletions(-)

diff --git a/Tests/test_file_palm.py b/Tests/test_file_palm.py
index a1859bc338c..58208ba99fa 100644
--- a/Tests/test_file_palm.py
+++ b/Tests/test_file_palm.py
@@ -43,6 +43,11 @@ def roundtrip(tmp_path: Path, mode: str) -> None:
 
     im.save(outfile)
     converted = open_with_magick(magick, tmp_path, outfile)
+    if mode == "P":
+        assert converted.mode == "P"
+
+        im = im.convert("RGB")
+        converted = converted.convert("RGB")
     assert_image_equal(converted, im)
 
 
@@ -55,7 +60,6 @@ def test_monochrome(tmp_path: Path) -> None:
     roundtrip(tmp_path, mode)
 
 
-@pytest.mark.xfail(reason="Palm P image is wrong")
 def test_p_mode(tmp_path: Path) -> None:
     # Arrange
     mode = "P"
diff --git a/src/PIL/PalmImagePlugin.py b/src/PIL/PalmImagePlugin.py
index b33245376dc..15f71290816 100644
--- a/src/PIL/PalmImagePlugin.py
+++ b/src/PIL/PalmImagePlugin.py
@@ -116,9 +116,6 @@ def build_prototype_image() -> Image.Image:
 
 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
-
         rawmode = "P"
         bpp = 8
         version = 1
@@ -172,12 +169,11 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     compression_type = _COMPRESSION_TYPES["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
-        colormap = im.getdata().getpalette()
+    if im.mode == "P":
+        flags |= _FLAGS["custom-colormap"]
+        colormap = im.im.getpalette()
+        colors = len(colormap) // 3
+        colormapsize = 4 * colors + 2
     else:
         colormapsize = 0
 
@@ -196,22 +192,11 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     # now write colormap if necessary
 
-    if colormapsize > 0:
-        fp.write(o16b(256))
-        for i in range(256):
+    if colormapsize:
+        fp.write(o16b(colors))
+        for i in range(colors):
             fp.write(o8(i))
-            if colormapmode == "RGB":
-                fp.write(
-                    o8(colormap[3 * i])
-                    + o8(colormap[3 * i + 1])
-                    + o8(colormap[3 * i + 2])
-                )
-            elif colormapmode == "RGBA":
-                fp.write(
-                    o8(colormap[4 * i])
-                    + o8(colormap[4 * i + 1])
-                    + o8(colormap[4 * i + 2])
-                )
+            fp.write(colormap[3 * i : 3 * i + 3])
 
     # now convert data to raw form
     ImageFile._save(

From bce83ac800dd70c8b49fff9662a2352b2a388a0b Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 03:36:36 +1100
Subject: [PATCH 1583/2374] Enable mmap on PyPy (#8840)

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 67e068b06fa..662afadf43c 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -621,6 +621,8 @@ def close(self) -> None:
         more information.
         """
         if getattr(self, "map", None):
+            if sys.platform == "win32" and hasattr(sys, "pypy_version_info"):
+                self.map.close()
             self.map: mmap.mmap | None = None
 
         # Instead of simply setting to None, we're setting up a
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index f5b72ee0d53..a7848c3695e 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -34,7 +34,6 @@
 import logging
 import os
 import struct
-import sys
 from typing import IO, TYPE_CHECKING, Any, NamedTuple, cast
 
 from . import ExifTags, Image
@@ -278,8 +277,6 @@ def load(self) -> Image.core.PixelAccess | 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")
 
         readonly = 0
 

From e053be3412ea6db562cd4f240471e79f6bdbae53 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 07:27:30 +1100
Subject: [PATCH 1584/2374] Updated version

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index 6435e1a0cee..671d1ccee44 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -43,7 +43,7 @@ or the clipboard to a PIL image memory.
     :param handle:
         HWND, to capture a single window. Windows only.
 
-        .. versionadded:: 11.1.0
+        .. versionadded:: 11.2.0
     :return: An image
 
 .. py:function:: grabclipboard()

From 382c3ab10d5583072a70250218d1bd5bef65ef8a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 11:16:05 +1100
Subject: [PATCH 1585/2374] spectacle may also be used on Linux

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index db2987eb081..1b81bc42c11 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -16,8 +16,9 @@ or the clipboard to a PIL image memory.
     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
-    installed. To disable this behaviour, pass ``xdisplay=""`` instead.
+    a snapshot of the screen, ``gnome-screenshot`` or ``spectacle`` will be used as a
+    fallback if they are installed. To disable this behaviour, pass ``xdisplay=""``
+    instead.
 
     .. versionadded:: 1.1.3 (Windows), 3.0.0 (macOS), 7.1.0 (Linux)
 

From 14fb62e36c5e933faf9f88e9c0418f71be883a9c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 18:42:46 +1100
Subject: [PATCH 1586/2374] Assert image type (#8619)

---
 Tests/test_file_apng.py          | 44 ++++++++++++++++++++++++++++++++
 Tests/test_file_dcx.py           |  2 ++
 Tests/test_file_eps.py           |  6 +++++
 Tests/test_file_fli.py           |  8 ++++++
 Tests/test_file_fpx.py           |  3 ++-
 Tests/test_file_gif.py           | 25 ++++++++++++++++++
 Tests/test_file_icns.py          |  4 +++
 Tests/test_file_ico.py           |  5 ++++
 Tests/test_file_im.py            |  2 ++
 Tests/test_file_jpeg.py          | 10 ++++++++
 Tests/test_file_jpeg2k.py        |  2 ++
 Tests/test_file_libtiff.py       | 21 +++++++++++++++
 Tests/test_file_mic.py           |  5 +++-
 Tests/test_file_mpo.py           |  7 ++++-
 Tests/test_file_png.py           |  7 +++++
 Tests/test_file_psd.py           |  7 +++++
 Tests/test_file_spider.py        |  1 +
 Tests/test_file_tiff.py          | 44 +++++++++++++++++++++++++++++---
 Tests/test_file_tiff_metadata.py | 20 +++++++++++++++
 Tests/test_file_webp_animated.py |  9 ++++++-
 Tests/test_file_webp_metadata.py |  3 ++-
 Tests/test_file_wmf.py           |  3 +++
 Tests/test_file_xpm.py           |  1 +
 Tests/test_imagesequence.py      |  4 ++-
 Tests/test_shell_injection.py    |  1 +
 Tests/test_tiff_ifdrational.py   |  1 +
 26 files changed, 236 insertions(+), 9 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index abd7d510b0d..a5734c202a7 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -12,6 +12,7 @@
 # (referenced from https://wiki.mozilla.org/APNG_Specification)
 def test_apng_basic() -> None:
     with Image.open("Tests/images/apng/single_frame.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert not im.is_animated
         assert im.n_frames == 1
         assert im.get_format_mimetype() == "image/apng"
@@ -20,6 +21,7 @@ def test_apng_basic() -> None:
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/single_frame_default.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.is_animated
         assert im.n_frames == 2
         assert im.get_format_mimetype() == "image/apng"
@@ -52,6 +54,7 @@ def test_apng_basic() -> None:
 )
 def test_apng_fdat(filename: str) -> None:
     with Image.open(filename) as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
@@ -59,31 +62,37 @@ def test_apng_fdat(filename: str) -> None:
 
 def test_apng_dispose() -> None:
     with Image.open("Tests/images/apng/dispose_op_none.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/dispose_op_background.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 0, 0, 0)
         assert im.getpixel((64, 32)) == (0, 0, 0, 0)
 
     with Image.open("Tests/images/apng/dispose_op_background_final.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/dispose_op_previous.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/dispose_op_previous_final.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/dispose_op_previous_first.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 0, 0, 0)
         assert im.getpixel((64, 32)) == (0, 0, 0, 0)
@@ -91,21 +100,25 @@ def test_apng_dispose() -> None:
 
 def test_apng_dispose_region() -> None:
     with Image.open("Tests/images/apng/dispose_op_none_region.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/dispose_op_background_before_region.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 0, 0, 0)
         assert im.getpixel((64, 32)) == (0, 0, 0, 0)
 
     with Image.open("Tests/images/apng/dispose_op_background_region.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 0, 255, 255)
         assert im.getpixel((64, 32)) == (0, 0, 0, 0)
 
     with Image.open("Tests/images/apng/dispose_op_previous_region.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
@@ -132,6 +145,7 @@ def test_apng_dispose_op_previous_frame() -> None:
     #     ],
     # )
     with Image.open("Tests/images/apng/dispose_op_previous_frame.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (255, 0, 0, 255)
 
@@ -145,26 +159,31 @@ def test_apng_dispose_op_background_p_mode() -> None:
 
 def test_apng_blend() -> None:
     with Image.open("Tests/images/apng/blend_op_source_solid.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/blend_op_source_transparent.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 0, 0, 0)
         assert im.getpixel((64, 32)) == (0, 0, 0, 0)
 
     with Image.open("Tests/images/apng/blend_op_source_near_transparent.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 2)
         assert im.getpixel((64, 32)) == (0, 255, 0, 2)
 
     with Image.open("Tests/images/apng/blend_op_over.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/blend_op_over_near_transparent.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 97)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
@@ -178,6 +197,7 @@ def test_apng_blend_transparency() -> None:
 
 def test_apng_chunk_order() -> None:
     with Image.open("Tests/images/apng/fctl_actl.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 255, 0, 255)
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
@@ -233,24 +253,28 @@ def test_apng_num_plays() -> None:
 
 def test_apng_mode() -> None:
     with Image.open("Tests/images/apng/mode_16bit.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "RGBA"
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (0, 0, 128, 191)
         assert im.getpixel((64, 32)) == (0, 0, 128, 191)
 
     with Image.open("Tests/images/apng/mode_grayscale.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "L"
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == 128
         assert im.getpixel((64, 32)) == 255
 
     with Image.open("Tests/images/apng/mode_grayscale_alpha.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "LA"
         im.seek(im.n_frames - 1)
         assert im.getpixel((0, 0)) == (128, 191)
         assert im.getpixel((64, 32)) == (128, 191)
 
     with Image.open("Tests/images/apng/mode_palette.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "P"
         im.seek(im.n_frames - 1)
         im = im.convert("RGB")
@@ -258,6 +282,7 @@ def test_apng_mode() -> None:
         assert im.getpixel((64, 32)) == (0, 255, 0)
 
     with Image.open("Tests/images/apng/mode_palette_alpha.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "P"
         im.seek(im.n_frames - 1)
         im = im.convert("RGBA")
@@ -265,6 +290,7 @@ def test_apng_mode() -> None:
         assert im.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/mode_palette_1bit_alpha.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "P"
         im.seek(im.n_frames - 1)
         im = im.convert("RGBA")
@@ -274,25 +300,31 @@ def test_apng_mode() -> None:
 
 def test_apng_chunk_errors() -> None:
     with Image.open("Tests/images/apng/chunk_no_actl.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert not im.is_animated
 
     with pytest.warns(UserWarning):
         with Image.open("Tests/images/apng/chunk_multi_actl.png") as im:
             im.load()
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert not im.is_animated
 
     with Image.open("Tests/images/apng/chunk_actl_after_idat.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert not im.is_animated
 
     with Image.open("Tests/images/apng/chunk_no_fctl.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         with pytest.raises(SyntaxError):
             im.seek(im.n_frames - 1)
 
     with Image.open("Tests/images/apng/chunk_repeat_fctl.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         with pytest.raises(SyntaxError):
             im.seek(im.n_frames - 1)
 
     with Image.open("Tests/images/apng/chunk_no_fdat.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         with pytest.raises(SyntaxError):
             im.seek(im.n_frames - 1)
 
@@ -300,26 +332,31 @@ def test_apng_chunk_errors() -> None:
 def test_apng_syntax_errors() -> None:
     with pytest.warns(UserWarning):
         with Image.open("Tests/images/apng/syntax_num_frames_zero.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             assert not im.is_animated
             with pytest.raises(OSError):
                 im.load()
 
     with pytest.warns(UserWarning):
         with Image.open("Tests/images/apng/syntax_num_frames_zero_default.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             assert not im.is_animated
             im.load()
 
     # we can handle this case gracefully
     with Image.open("Tests/images/apng/syntax_num_frames_low.png") as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
 
     with pytest.raises(OSError):
         with Image.open("Tests/images/apng/syntax_num_frames_high.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             im.seek(im.n_frames - 1)
             im.load()
 
     with pytest.warns(UserWarning):
         with Image.open("Tests/images/apng/syntax_num_frames_invalid.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             assert not im.is_animated
             im.load()
 
@@ -339,6 +376,7 @@ def test_apng_syntax_errors() -> 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:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             im.seek(im.n_frames - 1)
             im.load()
 
@@ -349,6 +387,7 @@ def test_apng_save(tmp_path: Path) -> None:
         im.save(test_file, save_all=True)
 
     with Image.open(test_file) as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.load()
         assert not im.is_animated
         assert im.n_frames == 1
@@ -364,6 +403,7 @@ def test_apng_save(tmp_path: Path) -> None:
         )
 
     with Image.open(test_file) as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.load()
         assert im.is_animated
         assert im.n_frames == 2
@@ -403,6 +443,7 @@ def test_apng_save_split_fdat(tmp_path: Path) -> None:
             append_images=frames,
         )
     with Image.open(test_file) as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         im.seek(im.n_frames - 1)
         im.load()
 
@@ -445,6 +486,7 @@ def test_apng_save_duration_loop(tmp_path: Path) -> None:
         test_file, save_all=True, append_images=[frame, frame], duration=[500, 100, 150]
     )
     with Image.open(test_file) as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.n_frames == 1
         assert "duration" not in im.info
 
@@ -456,6 +498,7 @@ def test_apng_save_duration_loop(tmp_path: Path) -> None:
         duration=[500, 100, 150],
     )
     with Image.open(test_file) as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.n_frames == 2
         assert im.info["duration"] == 600
 
@@ -466,6 +509,7 @@ def test_apng_save_duration_loop(tmp_path: Path) -> None:
     frame.info["duration"] = 300
     frame.save(test_file, save_all=True, append_images=[frame, different_frame])
     with Image.open(test_file) as im:
+        assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.n_frames == 2
         assert im.info["duration"] == 600
 
diff --git a/Tests/test_file_dcx.py b/Tests/test_file_dcx.py
index ab6b9f983d9..e9d88dd3964 100644
--- a/Tests/test_file_dcx.py
+++ b/Tests/test_file_dcx.py
@@ -69,12 +69,14 @@ def test_tell() -> None:
 
 def test_n_frames() -> None:
     with Image.open(TEST_FILE) as im:
+        assert isinstance(im, DcxImagePlugin.DcxImageFile)
         assert im.n_frames == 1
         assert not im.is_animated
 
 
 def test_eoferror() -> None:
     with Image.open(TEST_FILE) as im:
+        assert isinstance(im, DcxImagePlugin.DcxImageFile)
         n_frames = im.n_frames
 
         # Test seeking past the last frame
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index f5acc532ca5..b484a8cfa0a 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -86,6 +86,8 @@
 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:
+        assert isinstance(image, EpsImagePlugin.EpsImageFile)
+
         image.load(scale=scale)
         assert image.mode == "RGB"
         assert image.size == expected_size
@@ -227,6 +229,8 @@ def test_showpage() -> None:
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
 def test_transparency() -> None:
     with Image.open("Tests/images/eps/reqd_showpage.eps") as plot_image:
+        assert isinstance(plot_image, EpsImagePlugin.EpsImageFile)
+
         plot_image.load(transparency=True)
         assert plot_image.mode == "RGBA"
 
@@ -308,6 +312,7 @@ def test_render_scale2() -> None:
 
     # Zero bounding box
     with Image.open(FILE1) as image1_scale2:
+        assert isinstance(image1_scale2, EpsImagePlugin.EpsImageFile)
         image1_scale2.load(scale=2)
         with Image.open(FILE1_COMPARE_SCALE2) as image1_scale2_compare:
             image1_scale2_compare = image1_scale2_compare.convert("RGB")
@@ -316,6 +321,7 @@ def test_render_scale2() -> None:
 
     # Non-zero bounding box
     with Image.open(FILE2) as image2_scale2:
+        assert isinstance(image2_scale2, EpsImagePlugin.EpsImageFile)
         image2_scale2.load(scale=2)
         with Image.open(FILE2_COMPARE_SCALE2) as image2_scale2_compare:
             image2_scale2_compare = image2_scale2_compare.convert("RGB")
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 2f39adc69d8..81df1ab0b80 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -22,6 +22,8 @@
 
 def test_sanity() -> None:
     with Image.open(static_test_file) as im:
+        assert isinstance(im, FliImagePlugin.FliImageFile)
+
         im.load()
         assert im.mode == "P"
         assert im.size == (128, 128)
@@ -29,6 +31,8 @@ def test_sanity() -> None:
         assert not im.is_animated
 
     with Image.open(animated_test_file) as im:
+        assert isinstance(im, FliImagePlugin.FliImageFile)
+
         assert im.mode == "P"
         assert im.size == (320, 200)
         assert im.format == "FLI"
@@ -112,16 +116,19 @@ def test_palette_chunk_second() -> None:
 
 def test_n_frames() -> None:
     with Image.open(static_test_file) as im:
+        assert isinstance(im, FliImagePlugin.FliImageFile)
         assert im.n_frames == 1
         assert not im.is_animated
 
     with Image.open(animated_test_file) as im:
+        assert isinstance(im, FliImagePlugin.FliImageFile)
         assert im.n_frames == 384
         assert im.is_animated
 
 
 def test_eoferror() -> None:
     with Image.open(animated_test_file) as im:
+        assert isinstance(im, FliImagePlugin.FliImageFile)
         n_frames = im.n_frames
 
         # Test seeking past the last frame
@@ -166,6 +173,7 @@ def test_seek_tell() -> None:
 
 def test_seek() -> None:
     with Image.open(animated_test_file) as im:
+        assert isinstance(im, FliImagePlugin.FliImageFile)
         im.seek(50)
 
         assert_image_equal_tofile(im, "Tests/images/a_fli.png")
diff --git a/Tests/test_file_fpx.py b/Tests/test_file_fpx.py
index e32f30a0123..8d8064692e5 100644
--- a/Tests/test_file_fpx.py
+++ b/Tests/test_file_fpx.py
@@ -22,10 +22,11 @@ def test_sanity() -> None:
 
 def test_close() -> None:
     with Image.open("Tests/images/input_bw_one_band.fpx") as im:
-        pass
+        assert isinstance(im, FpxImagePlugin.FpxImageFile)
     assert im.ole.fp.closed
 
     im = Image.open("Tests/images/input_bw_one_band.fpx")
+    assert isinstance(im, FpxImagePlugin.FpxImageFile)
     im.close()
     assert im.ole.fp.closed
 
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 376eab0c682..20d58a9dda4 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -402,6 +402,7 @@ def test_save_netpbm_l_mode(tmp_path: Path) -> None:
 
 def test_seek() -> None:
     with Image.open("Tests/images/dispose_none.gif") as img:
+        assert isinstance(img, GifImagePlugin.GifImageFile)
         frame_count = 0
         try:
             while True:
@@ -446,10 +447,12 @@ def test_seek_rewind() -> None:
 def test_n_frames(path: str, n_frames: int) -> None:
     # Test is_animated before n_frames
     with Image.open(path) as im:
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert im.is_animated == (n_frames != 1)
 
     # Test is_animated after n_frames
     with Image.open(path) as im:
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert im.n_frames == n_frames
         assert im.is_animated == (n_frames != 1)
 
@@ -459,6 +462,7 @@ def test_no_change() -> None:
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
         im.seek(1)
         expected = im.copy()
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert im.n_frames == 5
         assert_image_equal(im, expected)
 
@@ -466,17 +470,20 @@ def test_no_change() -> None:
     with Image.open("Tests/images/dispose_bgnd.gif") as im:
         im.seek(3)
         expected = im.copy()
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert im.is_animated
         assert_image_equal(im, expected)
 
     with Image.open("Tests/images/comment_after_only_frame.gif") as im:
         expected = Image.new("P", (1, 1))
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert not im.is_animated
         assert_image_equal(im, expected)
 
 
 def test_eoferror() -> None:
     with Image.open(TEST_GIF) as im:
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         n_frames = im.n_frames
 
         # Test seeking past the last frame
@@ -495,6 +502,7 @@ def test_first_frame_transparency() -> None:
 
 def test_dispose_none() -> None:
     with Image.open("Tests/images/dispose_none.gif") as img:
+        assert isinstance(img, GifImagePlugin.GifImageFile)
         try:
             while True:
                 img.seek(img.tell() + 1)
@@ -518,6 +526,7 @@ def test_dispose_none_load_end() -> None:
 
 def test_dispose_background() -> None:
     with Image.open("Tests/images/dispose_bgnd.gif") as img:
+        assert isinstance(img, GifImagePlugin.GifImageFile)
         try:
             while True:
                 img.seek(img.tell() + 1)
@@ -571,6 +580,7 @@ def test_transparent_dispose(
 
 def test_dispose_previous() -> None:
     with Image.open("Tests/images/dispose_prev.gif") as img:
+        assert isinstance(img, GifImagePlugin.GifImageFile)
         try:
             while True:
                 img.seek(img.tell() + 1)
@@ -608,6 +618,7 @@ def test_save_dispose(tmp_path: Path) -> None:
     for method in range(4):
         im_list[0].save(out, save_all=True, append_images=im_list[1:], disposal=method)
         with Image.open(out) as img:
+            assert isinstance(img, GifImagePlugin.GifImageFile)
             for _ in range(2):
                 img.seek(img.tell() + 1)
                 assert img.disposal_method == method
@@ -621,6 +632,7 @@ def test_save_dispose(tmp_path: Path) -> None:
     )
 
     with Image.open(out) as img:
+        assert isinstance(img, GifImagePlugin.GifImageFile)
         for i in range(2):
             img.seek(img.tell() + 1)
             assert img.disposal_method == i + 1
@@ -743,6 +755,7 @@ def test_dispose2_background_frame(tmp_path: Path) -> None:
     im_list[0].save(out, save_all=True, append_images=im_list[1:], disposal=2)
 
     with Image.open(out) as im:
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert im.n_frames == 3
 
 
@@ -924,6 +937,8 @@ def test_identical_frames(tmp_path: Path) -> None:
         out, save_all=True, append_images=im_list[1:], duration=duration_list
     )
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
+
         # Assert that the first three frames were combined
         assert reread.n_frames == 2
 
@@ -953,6 +968,8 @@ def test_identical_frames_to_single_frame(
 
     im_list[0].save(out, save_all=True, append_images=im_list[1:], duration=duration)
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
+
         # Assert that all frames were combined
         assert reread.n_frames == 1
 
@@ -1139,12 +1156,14 @@ def test_append_images(tmp_path: Path) -> None:
     im.copy().save(out, save_all=True, append_images=ims)
 
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
         assert reread.n_frames == 3
 
     # Test append_images without save_all
     im.copy().save(out, append_images=ims)
 
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
         assert reread.n_frames == 3
 
     # Tests appending using a generator
@@ -1154,6 +1173,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
     im.save(out, save_all=True, append_images=im_generator(ims))
 
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
         assert reread.n_frames == 3
 
     # Tests appending single and multiple frame images
@@ -1162,6 +1182,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
             im.save(out, save_all=True, append_images=[im2])
 
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
         assert reread.n_frames == 10
 
 
@@ -1262,6 +1283,7 @@ def test_bbox(tmp_path: Path) -> None:
     im.save(out, save_all=True, append_images=ims)
 
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
         assert reread.n_frames == 2
 
 
@@ -1274,6 +1296,7 @@ def test_bbox_alpha(tmp_path: Path) -> None:
     im.save(out, save_all=True, append_images=[im2])
 
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
         assert reread.n_frames == 2
 
 
@@ -1425,6 +1448,7 @@ def test_extents(
 ) -> None:
     monkeypatch.setattr(GifImagePlugin, "LOADING_STRATEGY", loading_strategy)
     with Image.open("Tests/images/" + test_file) as im:
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert im.size == (100, 100)
 
         # Check that n_frames does not change the size
@@ -1472,4 +1496,5 @@ def test_p_rgba(tmp_path: Path, params: dict[str, Any]) -> None:
     im1.save(out, save_all=True, append_images=[im2], **params)
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, GifImagePlugin.GifImageFile)
         assert reloaded.n_frames == 2
diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index b6dc4bc194f..2dabfd2f30a 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -69,6 +69,7 @@ def test_save_append_images(tmp_path: Path) -> None:
         assert_image_similar_tofile(im, temp_file, 1)
 
         with Image.open(temp_file) as reread:
+            assert isinstance(reread, IcnsImagePlugin.IcnsImageFile)
             reread.size = (16, 16)
             reread.load(2)
             assert_image_equal(reread, provided_im)
@@ -90,6 +91,7 @@ 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:
+        assert isinstance(im, IcnsImagePlugin.IcnsImageFile)
         for w, h, r in im.info["sizes"]:
             wr = w * r
             hr = h * r
@@ -118,6 +120,7 @@ def test_older_icon() -> None:
             wr = w * r
             hr = h * r
             with Image.open("Tests/images/pillow2.icns") as im2:
+                assert isinstance(im2, IcnsImagePlugin.IcnsImageFile)
                 im2.size = (w, h)
                 im2.load(r)
                 assert im2.mode == "RGBA"
@@ -135,6 +138,7 @@ def test_jp2_icon() -> None:
             wr = w * r
             hr = h * r
             with Image.open("Tests/images/pillow3.icns") as im2:
+                assert isinstance(im2, IcnsImagePlugin.IcnsImageFile)
                 im2.size = (w, h)
                 im2.load(r)
                 assert im2.mode == "RGBA"
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 37bfd3f1f7d..5d2ace35e28 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -77,6 +77,7 @@ def test_save_to_bytes() -> None:
     # The other one
     output.seek(0)
     with Image.open(output) as reloaded:
+        assert isinstance(reloaded, IcoImagePlugin.IcoImageFile)
         reloaded.size = (32, 32)
 
         assert im.mode == reloaded.mode
@@ -94,6 +95,7 @@ def test_getpixel(tmp_path: Path) -> None:
     im.save(temp_file, "ico", sizes=[(32, 32), (64, 64)])
 
     with Image.open(temp_file) as reloaded:
+        assert isinstance(reloaded, IcoImagePlugin.IcoImageFile)
         reloaded.load()
         reloaded.size = (32, 32)
 
@@ -167,6 +169,7 @@ def test_save_to_bytes_bmp(mode: str) -> None:
     # The other one
     output.seek(0)
     with Image.open(output) as reloaded:
+        assert isinstance(reloaded, IcoImagePlugin.IcoImageFile)
         reloaded.size = (32, 32)
 
         assert "RGBA" == reloaded.mode
@@ -178,6 +181,7 @@ def test_save_to_bytes_bmp(mode: str) -> None:
 
 def test_incorrect_size() -> None:
     with Image.open(TEST_ICO_FILE) as im:
+        assert isinstance(im, IcoImagePlugin.IcoImageFile)
         with pytest.raises(ValueError):
             im.size = (1, 1)
 
@@ -219,6 +223,7 @@ def test_save_append_images(tmp_path: Path) -> None:
     im.save(outfile, sizes=[(32, 32), (128, 128)], append_images=[provided_im])
 
     with Image.open(outfile) as reread:
+        assert isinstance(reread, IcoImagePlugin.IcoImageFile)
         assert_image_equal(reread, hopper("RGBA"))
 
         reread.size = (32, 32)
diff --git a/Tests/test_file_im.py b/Tests/test_file_im.py
index 235914a2b4f..55c6b730599 100644
--- a/Tests/test_file_im.py
+++ b/Tests/test_file_im.py
@@ -68,12 +68,14 @@ def test_tell() -> None:
 
 def test_n_frames() -> None:
     with Image.open(TEST_IM) as im:
+        assert isinstance(im, ImImagePlugin.ImImageFile)
         assert im.n_frames == 1
         assert not im.is_animated
 
 
 def test_eoferror() -> None:
     with Image.open(TEST_IM) as im:
+        assert isinstance(im, ImImagePlugin.ImImageFile)
         n_frames = im.n_frames
 
         # Test seeking past the last frame
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 8ab853b85c9..79f0ec1a809 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -91,6 +91,7 @@ def test_zero(self, size: tuple[int, int], tmp_path: Path) -> None:
     def test_app(self) -> None:
         # Test APP/COM reader (@PIL135)
         with Image.open(TEST_FILE) as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             assert im.applist[0] == ("APP0", b"JFIF\x00\x01\x01\x01\x00`\x00`\x00\x00")
             assert im.applist[1] == (
                 "COM",
@@ -316,6 +317,8 @@ def test_large_exif(self, tmp_path: Path) -> None:
 
     def test_exif_typeerror(self) -> None:
         with Image.open("Tests/images/exif_typeerror.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
+
             # Should not raise a TypeError
             im._getexif()
 
@@ -500,6 +503,7 @@ def test_get_child_images(self) -> None:
 
     def test_mp(self) -> None:
         with Image.open("Tests/images/pil_sample_rgb.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             assert im._getmp() is None
 
     def test_quality_keep(self, tmp_path: Path) -> None:
@@ -558,12 +562,14 @@ def _n_qtables_helper(n: int, test_file: str) -> None:
             with Image.open(test_file) as im:
                 im.save(b, "JPEG", qtables=[[n] * 64] * n)
             with Image.open(b) as im:
+                assert isinstance(im, JpegImagePlugin.JpegImageFile)
                 assert len(im.quantization) == n
                 reloaded = self.roundtrip(im, qtables="keep")
                 assert im.quantization == reloaded.quantization
                 assert max(reloaded.quantization[0]) <= 255
 
         with Image.open("Tests/images/hopper.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             qtables = im.quantization
             reloaded = self.roundtrip(im, qtables=qtables, subsampling=0)
             assert im.quantization == reloaded.quantization
@@ -663,6 +669,7 @@ def _n_qtables_helper(n: int, test_file: str) -> None:
 
     def test_load_16bit_qtables(self) -> None:
         with Image.open("Tests/images/hopper_16bit_qtables.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             assert len(im.quantization) == 2
             assert len(im.quantization[0]) == 64
             assert max(im.quantization[0]) > 255
@@ -705,6 +712,7 @@ def test_restart_markers(self, blocks: int, rows: int, markers: int) -> None:
     @pytest.mark.skipif(not djpeg_available(), reason="djpeg not available")
     def test_load_djpeg(self) -> None:
         with Image.open(TEST_FILE) as img:
+            assert isinstance(img, JpegImagePlugin.JpegImageFile)
             img.load_djpeg()
             assert_image_similar_tofile(img, TEST_FILE, 5)
 
@@ -909,6 +917,7 @@ def test_photoshop(self) -> None:
 
     def test_photoshop_malformed_and_multiple(self) -> None:
         with Image.open("Tests/images/app13-multiple.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             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"]
@@ -1084,6 +1093,7 @@ def test_repr_jpeg_error_returns_none(self) -> None:
 
     def test_deprecation(self) -> None:
         with Image.open(TEST_FILE) as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             with pytest.warns(DeprecationWarning):
                 assert im.huffman_ac == {}
             with pytest.warns(DeprecationWarning):
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 916df25865e..4095bfaf2c5 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -228,12 +228,14 @@ def test_layers(card: ImageFile.ImageFile) -> None:
     out.seek(0)
 
     with Image.open(out) as im:
+        assert isinstance(im, Jpeg2KImagePlugin.Jpeg2KImageFile)
         im.layers = 1
         im.load()
         assert_image_similar(im, card, 13)
 
     out.seek(0)
     with Image.open(out) as im:
+        assert isinstance(im, Jpeg2KImagePlugin.Jpeg2KImageFile)
         im.layers = 3
         im.load()
         assert_image_similar(im, card, 0.4)
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 9e63e9c10ae..9916215fb95 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -36,6 +36,7 @@ def _assert_noerr(self, tmp_path: Path, im: TiffImagePlugin.TiffImageFile) -> No
         im.load()
         im.getdata()
 
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         assert im._compression == "group4"
 
         # can we write it back out, in a different form.
@@ -153,6 +154,7 @@ def test_write_metadata(self, legacy_api: bool, tmp_path: Path) -> None:
         """Test metadata writing through libtiff"""
         f = tmp_path / "temp.tiff"
         with Image.open("Tests/images/hopper_g4.tif") as img:
+            assert isinstance(img, TiffImagePlugin.TiffImageFile)
             img.save(f, tiffinfo=img.tag)
 
             if legacy_api:
@@ -170,6 +172,7 @@ def test_write_metadata(self, legacy_api: bool, tmp_path: Path) -> None:
         ]
 
         with Image.open(f) as loaded:
+            assert isinstance(loaded, TiffImagePlugin.TiffImageFile)
             if legacy_api:
                 reloaded = loaded.tag.named()
             else:
@@ -212,6 +215,7 @@ def test_additional_metadata(
         # Exclude ones that have special meaning
         # that we're already testing them
         with Image.open("Tests/images/hopper_g4.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             for tag in im.tag_v2:
                 try:
                     del core_items[tag]
@@ -317,6 +321,7 @@ def check_tags(
             im.save(out, tiffinfo=tiffinfo)
 
             with Image.open(out) as reloaded:
+                assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
                 for tag, value in tiffinfo.items():
                     reloaded_value = reloaded.tag_v2[tag]
                     if (
@@ -349,12 +354,14 @@ def check_tags(
     def test_osubfiletype(self, tmp_path: Path) -> None:
         outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/g4_orientation_6.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             im.tag_v2[OSUBFILETYPE] = 1
             im.save(outfile)
 
     def test_subifd(self, tmp_path: Path) -> None:
         outfile = tmp_path / "temp.tif"
         with Image.open("Tests/images/g4_orientation_6.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             im.tag_v2[SUBIFD] = 10000
 
             # Should not segfault
@@ -369,6 +376,7 @@ def test_xmlpacket_tag(
         hopper().save(out, tiffinfo={700: b"xmlpacket tag"})
 
         with Image.open(out) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             if 700 in reloaded.tag_v2:
                 assert reloaded.tag_v2[700] == b"xmlpacket tag"
 
@@ -430,12 +438,15 @@ 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:
+            assert isinstance(orig, TiffImagePlugin.TiffImageFile)
+
             out = tmp_path / "temp.tif"
 
             orig.tag[269] = "temp.tif"
             orig.save(out)
 
         with Image.open(out) as reread:
+            assert isinstance(reread, TiffImagePlugin.TiffImageFile)
             assert "temp.tif" == reread.tag_v2[269]
             assert "temp.tif" == reread.tag[269][0]
 
@@ -541,6 +552,7 @@ def test_palette_save(
 
         with Image.open(out) as reloaded:
             # colormap/palette tag
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             assert len(reloaded.tag_v2[320]) == 768
 
     @pytest.mark.parametrize("compression", ("tiff_ccitt", "group3", "group4"))
@@ -572,6 +584,7 @@ def test_multipage(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/multipage.tiff") as im:
             # file is a multipage tiff,  10x10 green, 10x10 red, 20x20 blue
 
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             im.seek(0)
             assert im.size == (10, 10)
             assert im.convert("RGB").getpixel((0, 0)) == (0, 128, 0)
@@ -591,6 +604,7 @@ def test_multipage_nframes(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # issue #862
         monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/multipage.tiff") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             frames = im.n_frames
             assert frames == 3
             for _ in range(frames):
@@ -610,6 +624,7 @@ def test_multipage_seek_backwards(self, monkeypatch: pytest.MonkeyPatch) -> None
     def test__next(self, monkeypatch: pytest.MonkeyPatch) -> None:
         monkeypatch.setattr(TiffImagePlugin, "READ_LIBTIFF", True)
         with Image.open("Tests/images/hopper.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert not im.tag.next
             im.load()
             assert not im.tag.next
@@ -690,21 +705,25 @@ def test_save_ycbcr(self, tmp_path: Path) -> None:
         im.save(outfile, compression="jpeg")
 
         with Image.open(outfile) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             assert reloaded.tag_v2[530] == (1, 1)
             assert reloaded.tag_v2[532] == (0, 255, 128, 255, 128, 255)
 
     def test_exif_ifd(self) -> None:
         out = io.BytesIO()
         with Image.open("Tests/images/tiff_adobe_deflate.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.tag_v2[34665] == 125456
             im.save(out, "TIFF")
 
             with Image.open(out) as reloaded:
+                assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
                 assert 34665 not in reloaded.tag_v2
 
             im.save(out, "TIFF", tiffinfo={34665: 125456})
 
         with Image.open(out) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             if Image.core.libtiff_support_custom_tags:
                 assert reloaded.tag_v2[34665] == 125456
 
@@ -786,6 +805,7 @@ def test_write_icc(
 
     def test_multipage_compression(self) -> None:
         with Image.open("Tests/images/compression.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             im.seek(0)
             assert im._compression == "tiff_ccitt"
             assert im.size == (10, 10)
@@ -1090,6 +1110,7 @@ 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:
+                    assert isinstance(im, TiffImagePlugin.TiffImageFile)
                     assert 274 in im.tag_v2
 
                     im.load()
diff --git a/Tests/test_file_mic.py b/Tests/test_file_mic.py
index 9a6f13ea366..9aeb306e439 100644
--- a/Tests/test_file_mic.py
+++ b/Tests/test_file_mic.py
@@ -30,11 +30,13 @@ def test_sanity() -> None:
 
 def test_n_frames() -> None:
     with Image.open(TEST_FILE) as im:
+        assert isinstance(im, MicImagePlugin.MicImageFile)
         assert im.n_frames == 1
 
 
 def test_is_animated() -> None:
     with Image.open(TEST_FILE) as im:
+        assert isinstance(im, MicImagePlugin.MicImageFile)
         assert not im.is_animated
 
 
@@ -55,10 +57,11 @@ def test_seek() -> None:
 
 def test_close() -> None:
     with Image.open(TEST_FILE) as im:
-        pass
+        assert isinstance(im, MicImagePlugin.MicImageFile)
     assert im.ole.fp.closed
 
     im = Image.open(TEST_FILE)
+    assert isinstance(im, MicImagePlugin.MicImageFile)
     im.close()
     assert im.ole.fp.closed
 
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 6b4f6423bd1..73838ef4484 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -6,7 +6,7 @@
 
 import pytest
 
-from PIL import Image, ImageFile, MpoImagePlugin
+from PIL import Image, ImageFile, JpegImagePlugin, MpoImagePlugin
 
 from .helper import (
     assert_image_equal,
@@ -80,6 +80,7 @@ def test_context_manager() -> None:
 def test_app(test_file: str) -> None:
     # Test APP/COM reader (@PIL135)
     with Image.open(test_file) as im:
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         assert im.applist[0][0] == "APP1"
         assert im.applist[1][0] == "APP2"
         assert im.applist[1][1].startswith(
@@ -220,12 +221,14 @@ def test_seek(test_file: str) -> None:
 
 def test_n_frames() -> None:
     with Image.open("Tests/images/sugarshack.mpo") as im:
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         assert im.n_frames == 2
         assert im.is_animated
 
 
 def test_eoferror() -> None:
     with Image.open("Tests/images/sugarshack.mpo") as im:
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         n_frames = im.n_frames
 
         # Test seeking past the last frame
@@ -239,6 +242,8 @@ def test_eoferror() -> None:
 
 def test_adopt_jpeg() -> None:
     with Image.open("Tests/images/hopper.jpg") as im:
+        assert isinstance(im, JpegImagePlugin.JpegImageFile)
+
         with pytest.raises(ValueError):
             MpoImagePlugin.MpoImageFile.adopt(im)
 
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index c969bd502c5..0f0886ab8dc 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -576,6 +576,7 @@ def test_getchunks(self) -> None:
 
     def test_read_private_chunks(self) -> None:
         with Image.open("Tests/images/exif.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             assert im.private_chunks == [(b"orNT", b"\x01")]
 
     def test_roundtrip_private_chunk(self) -> None:
@@ -598,6 +599,7 @@ def test_roundtrip_private_chunk(self) -> None:
 
     def test_textual_chunks_after_idat(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/hopper.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             assert "comment" in im.text
             for k, v in {
                 "date:create": "2014-09-04T09:37:08+03:00",
@@ -607,15 +609,19 @@ def test_textual_chunks_after_idat(self, monkeypatch: pytest.MonkeyPatch) -> Non
 
         # Raises a SyntaxError in load_end
         with Image.open("Tests/images/broken_data_stream.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             with pytest.raises(OSError):
                 assert isinstance(im.text, dict)
 
         # Raises an EOFError in load_end
         with Image.open("Tests/images/hopper_idat_after_image_end.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
             assert im.text == {"TXT": "VALUE", "ZIP": "VALUE"}
 
         # Raises a UnicodeDecodeError in load_end
         with Image.open("Tests/images/truncated_image.png") as im:
+            assert isinstance(im, PngImagePlugin.PngImageFile)
+
             # The file is truncated
             with pytest.raises(OSError):
                 im.text
@@ -726,6 +732,7 @@ def test_exif_save(self, tmp_path: Path) -> None:
             im.save(test_file)
 
         with Image.open(test_file) as reloaded:
+            assert isinstance(reloaded, PngImagePlugin.PngImageFile)
             assert reloaded._getexif() is None
 
         # Test passing in exif
diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 1793c269d59..38a88cd17a8 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -59,17 +59,21 @@ def test_invalid_file() -> None:
 
 def test_n_frames() -> None:
     with Image.open("Tests/images/hopper_merged.psd") as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
         assert im.n_frames == 1
         assert not im.is_animated
 
     for path in [test_file, "Tests/images/negative_layer_count.psd"]:
         with Image.open(path) as im:
+            assert isinstance(im, PsdImagePlugin.PsdImageFile)
             assert im.n_frames == 2
             assert im.is_animated
 
 
 def test_eoferror() -> None:
     with Image.open(test_file) as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
+
         # PSD seek index starts at 1 rather than 0
         n_frames = im.n_frames + 1
 
@@ -119,11 +123,13 @@ def test_rgba() -> None:
 
 def test_negative_top_left_layer() -> None:
     with Image.open("Tests/images/negative_top_left_layer.psd") as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
         assert im.layers[0][2] == (-50, -50, 50, 50)
 
 
 def test_layer_skip() -> None:
     with Image.open("Tests/images/five_channels.psd") as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
         assert im.n_frames == 1
 
 
@@ -175,5 +181,6 @@ def test_crashes(test_file: str, raises: type[Exception]) -> None:
 def test_layer_crashes(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
+            assert isinstance(im, PsdImagePlugin.PsdImageFile)
             with pytest.raises(SyntaxError):
                 im.layers
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index b64a629f581..3b3c3b4a518 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -96,6 +96,7 @@ def test_tell() -> None:
 
 def test_n_frames() -> None:
     with Image.open(TEST_FILE) as im:
+        assert isinstance(im, SpiderImagePlugin.SpiderImageFile)
         assert im.n_frames == 1
         assert not im.is_animated
 
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 6962a5c9889..502d9df9a33 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -9,7 +9,13 @@
 
 import pytest
 
-from PIL import Image, ImageFile, TiffImagePlugin, UnidentifiedImageError
+from PIL import (
+    Image,
+    ImageFile,
+    JpegImagePlugin,
+    TiffImagePlugin,
+    UnidentifiedImageError,
+)
 from PIL.TiffImagePlugin import RESOLUTION_UNIT, X_RESOLUTION, Y_RESOLUTION
 
 from .helper import (
@@ -113,6 +119,7 @@ def test_bigtiff(self, tmp_path: Path) -> None:
 
         with Image.open("Tests/images/hopper_bigtiff.tif") as im:
             outfile = tmp_path / "temp.tif"
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             im.save(outfile, save_all=True, append_images=[im], tiffinfo=im.tag_v2)
 
     def test_bigtiff_save(self, tmp_path: Path) -> None:
@@ -121,11 +128,13 @@ def test_bigtiff_save(self, tmp_path: Path) -> None:
         im.save(outfile, big_tiff=True)
 
         with Image.open(outfile) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             assert reloaded.tag_v2._bigtiff is True
 
         im.save(outfile, save_all=True, append_images=[im], big_tiff=True)
 
         with Image.open(outfile) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             assert reloaded.tag_v2._bigtiff is True
 
     def test_seek_too_large(self) -> None:
@@ -140,6 +149,8 @@ def test_set_legacy_api(self) -> None:
     def test_xyres_tiff(self) -> None:
         filename = "Tests/images/pil168.tif"
         with Image.open(filename) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+
             # legacy api
             assert isinstance(im.tag[X_RESOLUTION][0], tuple)
             assert isinstance(im.tag[Y_RESOLUTION][0], tuple)
@@ -153,6 +164,8 @@ def test_xyres_tiff(self) -> None:
     def test_xyres_fallback_tiff(self) -> None:
         filename = "Tests/images/compression.tif"
         with Image.open(filename) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+
             # v2 api
             assert isinstance(im.tag_v2[X_RESOLUTION], TiffImagePlugin.IFDRational)
             assert isinstance(im.tag_v2[Y_RESOLUTION], TiffImagePlugin.IFDRational)
@@ -167,6 +180,8 @@ def test_xyres_fallback_tiff(self) -> None:
     def test_int_resolution(self) -> None:
         filename = "Tests/images/pil168.tif"
         with Image.open(filename) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+
             # Try to read a file where X,Y_RESOLUTION are ints
             im.tag_v2[X_RESOLUTION] = 71
             im.tag_v2[Y_RESOLUTION] = 71
@@ -181,6 +196,7 @@ 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:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.tag_v2.get(RESOLUTION_UNIT) == resolution_unit
             assert im.info["dpi"] == (dpi, dpi)
 
@@ -198,6 +214,7 @@ def test_save_setting_missing_resolution(self) -> None:
         with Image.open("Tests/images/10ct_32bit_128.tiff") as im:
             im.save(b, format="tiff", resolution=123.45)
         with Image.open(b) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.tag_v2[X_RESOLUTION] == 123.45
             assert im.tag_v2[Y_RESOLUTION] == 123.45
 
@@ -213,10 +230,12 @@ def test_invalid_file(self) -> None:
         TiffImagePlugin.PREFIXES.pop()
 
     def test_bad_exif(self) -> None:
-        with Image.open("Tests/images/hopper_bad_exif.jpg") as i:
+        with Image.open("Tests/images/hopper_bad_exif.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
+
             # Should not raise struct.error.
             with pytest.warns(UserWarning):
-                i._getexif()
+                im._getexif()
 
     def test_save_rgba(self, tmp_path: Path) -> None:
         im = hopper("RGBA")
@@ -307,11 +326,13 @@ def test_unknown_pixel_mode(self) -> None:
     )
     def test_n_frames(self, path: str, n_frames: int) -> None:
         with Image.open(path) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.n_frames == n_frames
             assert im.is_animated == (n_frames != 1)
 
     def test_eoferror(self) -> None:
         with Image.open("Tests/images/multipage-lastframe.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             n_frames = im.n_frames
 
             # Test seeking past the last frame
@@ -355,19 +376,24 @@ def test_multipage_last_frame(self) -> None:
     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 isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.n_frames == 1
 
         # A frame can't progress to a frame that has already been read
         with Image.open("Tests/images/multipage_multiple_frame_loop.tiff") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.n_frames == 2
 
         # Frames don't have to be in sequence
         with Image.open("Tests/images/multipage_out_of_order.tiff") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.n_frames == 3
 
     def test___str__(self) -> None:
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+
             # Act
             ret = str(im.ifd)
 
@@ -378,6 +404,8 @@ def test_dict(self) -> None:
         # Arrange
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+
             # v2 interface
             v2_tags = {
                 256: 55,
@@ -417,6 +445,7 @@ def test_dict(self) -> None:
     def test__delitem__(self) -> None:
         filename = "Tests/images/pil136.tiff"
         with Image.open(filename) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             len_before = len(dict(im.ifd))
             del im.ifd[256]
             len_after = len(dict(im.ifd))
@@ -449,6 +478,7 @@ def test_load_double(self) -> None:
 
     def test_ifd_tag_type(self) -> None:
         with Image.open("Tests/images/ifd_tag_type.tiff") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert 0x8825 in im.tag_v2
 
     def test_exif(self, tmp_path: Path) -> None:
@@ -537,6 +567,7 @@ def test_photometric(self, mode: str, tmp_path: Path) -> None:
         im = hopper(mode)
         im.save(filename, tiffinfo={262: 0})
         with Image.open(filename) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             assert reloaded.tag_v2[262] == 0
             assert_image_equal(im, reloaded)
 
@@ -615,6 +646,8 @@ def test_with_underscores(self, tmp_path: Path) -> None:
         filename = tmp_path / "temp.tif"
         hopper("RGB").save(filename, "TIFF", **kwargs)
         with Image.open(filename) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+
             # legacy interface
             assert im.tag[X_RESOLUTION][0][0] == 72
             assert im.tag[Y_RESOLUTION][0][0] == 36
@@ -701,6 +734,7 @@ def test_tiled_planar_raw(self) -> None:
     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 isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im._planar_configuration == 2
 
             outfile = tmp_path / "temp.tif"
@@ -733,6 +767,7 @@ def test_tiff_save_all(self) -> None:
 
         mp.seek(0, os.SEEK_SET)
         with Image.open(mp) as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert im.n_frames == 3
 
         # Test appending images
@@ -743,6 +778,7 @@ def test_tiff_save_all(self) -> None:
 
         mp.seek(0, os.SEEK_SET)
         with Image.open(mp) as reread:
+            assert isinstance(reread, TiffImagePlugin.TiffImageFile)
             assert reread.n_frames == 3
 
         # Test appending using a generator
@@ -754,6 +790,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
 
         mp.seek(0, os.SEEK_SET)
         with Image.open(mp) as reread:
+            assert isinstance(reread, TiffImagePlugin.TiffImageFile)
             assert reread.n_frames == 3
 
     def test_fixoffsets(self) -> None:
@@ -864,6 +901,7 @@ def test_getxmp(self) -> None:
 
     def test_get_photoshop_blocks(self) -> None:
         with Image.open("Tests/images/lab.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
             assert list(im.get_photoshop_blocks().keys()) == [
                 1061,
                 1002,
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 0734d1db100..88486834593 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -61,6 +61,7 @@ def test_rt_metadata(tmp_path: Path) -> None:
     img.save(f, tiffinfo=info)
 
     with Image.open(f) as loaded:
+        assert isinstance(loaded, TiffImagePlugin.TiffImageFile)
         assert loaded.tag[ImageJMetaDataByteCounts] == (len(bin_data),)
         assert loaded.tag_v2[ImageJMetaDataByteCounts] == (len(bin_data),)
 
@@ -80,12 +81,14 @@ def test_rt_metadata(tmp_path: Path) -> None:
     info[ImageJMetaDataByteCounts] = (8, len(bin_data) - 8)
     img.save(f, tiffinfo=info)
     with Image.open(f) as loaded:
+        assert isinstance(loaded, TiffImagePlugin.TiffImageFile)
         assert loaded.tag[ImageJMetaDataByteCounts] == (8, len(bin_data) - 8)
         assert loaded.tag_v2[ImageJMetaDataByteCounts] == (8, len(bin_data) - 8)
 
 
 def test_read_metadata() -> None:
     with Image.open("Tests/images/hopper_g4.tif") as img:
+        assert isinstance(img, TiffImagePlugin.TiffImageFile)
         assert {
             "YResolution": IFDRational(4294967295, 113653537),
             "PlanarConfiguration": 1,
@@ -128,6 +131,7 @@ def test_read_metadata() -> None:
 def test_write_metadata(tmp_path: Path) -> None:
     """Test metadata writing through the python code"""
     with Image.open("Tests/images/hopper.tif") as img:
+        assert isinstance(img, TiffImagePlugin.TiffImageFile)
         f = tmp_path / "temp.tiff"
         del img.tag[278]
         img.save(f, tiffinfo=img.tag)
@@ -135,6 +139,7 @@ def test_write_metadata(tmp_path: Path) -> None:
         original = img.tag_v2.named()
 
     with Image.open(f) as loaded:
+        assert isinstance(loaded, TiffImagePlugin.TiffImageFile)
         reloaded = loaded.tag_v2.named()
 
     ignored = ["StripByteCounts", "RowsPerStrip", "PageNumber", "StripOffsets"]
@@ -165,6 +170,7 @@ def test_write_metadata(tmp_path: Path) -> None:
 def test_change_stripbytecounts_tag_type(tmp_path: Path) -> None:
     out = tmp_path / "temp.tiff"
     with Image.open("Tests/images/hopper.tif") as im:
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         info = im.tag_v2
         del info[278]
 
@@ -178,6 +184,7 @@ def test_change_stripbytecounts_tag_type(tmp_path: Path) -> None:
         im.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert reloaded.tag_v2.tagtype[TiffImagePlugin.STRIPBYTECOUNTS] == TiffTags.LONG
 
 
@@ -231,6 +238,7 @@ def test_writing_other_types_to_ascii(
     im.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert reloaded.tag_v2[271] == expected
 
 
@@ -248,6 +256,7 @@ def test_writing_other_types_to_bytes(value: int | IFDRational, tmp_path: Path)
     im.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert reloaded.tag_v2[700] == b"\x01"
 
 
@@ -267,6 +276,7 @@ def test_writing_other_types_to_undefined(
     im.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert reloaded.tag_v2[33723] == b"1"
 
 
@@ -311,6 +321,7 @@ def test_iccprofile_binary() -> None:
     # but probably won't be able to save it.
 
     with Image.open("Tests/images/hopper.iccprofile_binary.tif") as im:
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         assert im.tag_v2.tagtype[34675] == 1
         assert im.info["icc_profile"]
 
@@ -336,6 +347,7 @@ def test_exif_div_zero(tmp_path: Path) -> None:
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert 0 == reloaded.tag_v2[41988].numerator
         assert 0 == reloaded.tag_v2[41988].denominator
 
@@ -355,6 +367,7 @@ def test_ifd_unsigned_rational(tmp_path: Path) -> None:
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert max_long == reloaded.tag_v2[41493].numerator
         assert 1 == reloaded.tag_v2[41493].denominator
 
@@ -367,6 +380,7 @@ def test_ifd_unsigned_rational(tmp_path: Path) -> None:
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert max_long == reloaded.tag_v2[41493].numerator
         assert 1 == reloaded.tag_v2[41493].denominator
 
@@ -385,6 +399,7 @@ def test_ifd_signed_rational(tmp_path: Path) -> None:
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert numerator == reloaded.tag_v2[37380].numerator
         assert denominator == reloaded.tag_v2[37380].denominator
 
@@ -397,6 +412,7 @@ def test_ifd_signed_rational(tmp_path: Path) -> None:
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert numerator == reloaded.tag_v2[37380].numerator
         assert denominator == reloaded.tag_v2[37380].denominator
 
@@ -410,6 +426,7 @@ def test_ifd_signed_rational(tmp_path: Path) -> None:
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert 2**31 - 1 == reloaded.tag_v2[37380].numerator
         assert -1 == reloaded.tag_v2[37380].denominator
 
@@ -424,6 +441,7 @@ def test_ifd_signed_long(tmp_path: Path) -> None:
     im.save(out, tiffinfo=info, compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert reloaded.tag_v2[37000] == -60000
 
 
@@ -444,11 +462,13 @@ def test_empty_values() -> None:
 
 def test_photoshop_info(tmp_path: Path) -> None:
     with Image.open("Tests/images/issue_2278.tif") as im:
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         assert len(im.tag_v2[34377]) == 70
         assert isinstance(im.tag_v2[34377], bytes)
         out = tmp_path / "temp.tiff"
         im.save(out)
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert len(reloaded.tag_v2[34377]) == 70
         assert isinstance(reloaded.tag_v2[34377], bytes)
 
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index d4b1fda9725..5037613742b 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -6,7 +6,7 @@
 import pytest
 from packaging.version import parse as parse_version
 
-from PIL import Image, features
+from PIL import GifImagePlugin, Image, WebPImagePlugin, features
 
 from .helper import (
     assert_image_equal,
@@ -22,10 +22,12 @@ 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:
+        assert isinstance(im, WebPImagePlugin.WebPImageFile)
         assert im.n_frames == 1
         assert not im.is_animated
 
     with Image.open("Tests/images/iss634.webp") as im:
+        assert isinstance(im, WebPImagePlugin.WebPImageFile)
         assert im.n_frames == 42
         assert im.is_animated
 
@@ -37,11 +39,13 @@ def test_write_animation_L(tmp_path: Path) -> None:
     """
 
     with Image.open("Tests/images/iss634.gif") as orig:
+        assert isinstance(orig, GifImagePlugin.GifImageFile)
         assert orig.n_frames > 1
 
         temp_file = tmp_path / "temp.webp"
         orig.save(temp_file, save_all=True)
         with Image.open(temp_file) as im:
+            assert isinstance(im, WebPImagePlugin.WebPImageFile)
             assert im.n_frames == orig.n_frames
 
             # Compare first and last frames to the original animated GIF
@@ -69,6 +73,7 @@ def test_write_animation_RGB(tmp_path: Path) -> None:
 
     def check(temp_file: Path) -> None:
         with Image.open(temp_file) as im:
+            assert isinstance(im, WebPImagePlugin.WebPImageFile)
             assert im.n_frames == 2
 
             # Compare first frame to original
@@ -127,6 +132,7 @@ def test_timestamp_and_duration(tmp_path: Path) -> None:
             )
 
     with Image.open(temp_file) as im:
+        assert isinstance(im, WebPImagePlugin.WebPImageFile)
         assert im.n_frames == 5
         assert im.is_animated
 
@@ -170,6 +176,7 @@ def test_seeking(tmp_path: Path) -> None:
             )
 
     with Image.open(temp_file) as im:
+        assert isinstance(im, WebPImagePlugin.WebPImageFile)
         assert im.n_frames == 5
         assert im.is_animated
 
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index d1d3421ec5b..7543d22da07 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -6,7 +6,7 @@
 
 import pytest
 
-from PIL import Image
+from PIL import Image, WebPImagePlugin
 
 from .helper import mark_if_feature_version, skip_unless_feature
 
@@ -110,6 +110,7 @@ def test_read_no_exif() -> None:
 
     test_buffer.seek(0)
     with Image.open(test_buffer) as webp_image:
+        assert isinstance(webp_image, WebPImagePlugin.WebPImageFile)
         assert not webp_image._getexif()
 
 
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index a752f801382..dcf5f000ffe 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -89,6 +89,7 @@ def test_load_float_dpi() -> None:
 
 def test_load_set_dpi() -> None:
     with Image.open("Tests/images/drawing.wmf") as im:
+        assert isinstance(im, WmfImagePlugin.WmfStubImageFile)
         assert im.size == (82, 82)
 
         if hasattr(Image.core, "drawwmf"):
@@ -102,10 +103,12 @@ def test_load_set_dpi() -> None:
 
         if not hasattr(Image.core, "drawwmf"):
             return
+        assert isinstance(im, WmfImagePlugin.WmfStubImageFile)
         im.load(im.info["dpi"])
         assert im.size == (1625, 1625)
 
     with Image.open("Tests/images/drawing.emf") as im:
+        assert isinstance(im, WmfImagePlugin.WmfStubImageFile)
         im.load((72, 144))
         assert im.size == (82, 164)
 
diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index 26afe93f450..73c62a44d53 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -30,6 +30,7 @@ def test_invalid_file() -> None:
 def test_load_read() -> None:
     # Arrange
     with Image.open(TEST_FILE) as im:
+        assert isinstance(im, XpmImagePlugin.XpmImageFile)
         dummy_bytes = 1
 
         # Act
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index da9e71692b9..7b9ac80bc5d 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -4,7 +4,7 @@
 
 import pytest
 
-from PIL import Image, ImageSequence, TiffImagePlugin
+from PIL import Image, ImageSequence, PsdImagePlugin, TiffImagePlugin
 
 from .helper import assert_image_equal, hopper, skip_unless_feature
 
@@ -31,6 +31,7 @@ def test_sanity(tmp_path: Path) -> None:
 
 def test_iterator() -> None:
     with Image.open("Tests/images/multipage.tiff") as im:
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         i = ImageSequence.Iterator(im)
         for index in range(im.n_frames):
             assert i[index] == next(i)
@@ -42,6 +43,7 @@ def test_iterator() -> None:
 
 def test_iterator_min_frame() -> None:
     with Image.open("Tests/images/hopper.psd") as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
         i = ImageSequence.Iterator(im)
         for index in range(1, im.n_frames):
             assert i[index] == next(i)
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index 4fd3aab5df1..03e92b5b913 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -39,6 +39,7 @@ def test_load_djpeg_filename(self, tmp_path: Path) -> None:
             shutil.copy(TEST_JPG, src_file)
 
             with Image.open(src_file) as im:
+                assert isinstance(im, JpegImagePlugin.JpegImageFile)
                 im.load_djpeg()
 
     @pytest.mark.skipif(not cjpeg_available(), reason="cjpeg not available")
diff --git a/Tests/test_tiff_ifdrational.py b/Tests/test_tiff_ifdrational.py
index 30dc7365480..42d06b89696 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -72,4 +72,5 @@ def test_ifd_rational_save(
     im.save(out, dpi=(res, res), compression="raw")
 
     with Image.open(out) as reloaded:
+        assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
         assert float(IFDRational(301, 1)) == float(reloaded.tag_v2[282])

From 80d5b421ebd8b8c20c39889862764822366ef183 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 22:13:21 +1100
Subject: [PATCH 1587/2374] Do not import type checking

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

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 0113ebcbf94..e978b5d23ee 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -22,10 +22,9 @@
 import subprocess
 import sys
 import tempfile
-from typing import TYPE_CHECKING
-
 from . import Image
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from . import ImageWin
 

From d2683e052f341a5f53c7bb440af7fba577e0f4d1 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sun, 30 Mar 2025 11:13:48 +0000
Subject: [PATCH 1588/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

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

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index e978b5d23ee..42abdf8c726 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -22,6 +22,7 @@
 import subprocess
 import sys
 import tempfile
+
 from . import Image
 
 TYPE_CHECKING = False

From 4236b583a1578c089cd06538a9ded20bcba1a863 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 22:16:16 +1100
Subject: [PATCH 1589/2374] Do not import TYPE_CHECKING

---
 src/PIL/GifImagePlugin.py    |  3 ++-
 src/PIL/Image.py             | 10 ++--------
 src/PIL/ImageDraw.py         |  3 ++-
 src/PIL/ImageFile.py         |  3 ++-
 src/PIL/ImageFilter.py       |  3 ++-
 src/PIL/ImageFont.py         |  3 ++-
 src/PIL/ImagePalette.py      |  3 ++-
 src/PIL/ImageQt.py           |  3 ++-
 src/PIL/ImageTk.py           |  3 ++-
 src/PIL/JpegImagePlugin.py   |  3 ++-
 src/PIL/PSDraw.py            |  5 ++++-
 src/PIL/PdfParser.py         |  3 ++-
 src/PIL/PngImagePlugin.py    |  3 ++-
 src/PIL/SpiderImagePlugin.py |  4 +++-
 src/PIL/TiffImagePlugin.py   |  3 ++-
 src/PIL/_typing.py           |  3 ++-
 16 files changed, 35 insertions(+), 23 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 045ab102738..4392c4cb909 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -31,7 +31,7 @@
 import subprocess
 from enum import IntEnum
 from functools import cached_property
-from typing import IO, TYPE_CHECKING, Any, Literal, NamedTuple, Union
+from typing import IO, Any, Literal, NamedTuple, Union
 
 from . import (
     Image,
@@ -47,6 +47,7 @@
 from ._binary import o16le as o16
 from ._util import DeferredError
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from . import _imaging
     from ._typing import Buffer
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 662afadf43c..19b22342acb 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,14 +41,7 @@
 from collections.abc import Callable, Iterator, MutableMapping, Sequence
 from enum import IntEnum
 from types import ModuleType
-from typing import (
-    IO,
-    TYPE_CHECKING,
-    Any,
-    Literal,
-    Protocol,
-    cast,
-)
+from typing import IO, Any, Literal, Protocol, cast
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -218,6 +211,7 @@ class Quantize(IntEnum):
 # --------------------------------------------------------------------
 # Registries
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     import mmap
     from xml.etree.ElementTree import Element
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index c2ed9034d0b..e6c7b029830 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -35,7 +35,7 @@
 import struct
 from collections.abc import Sequence
 from types import ModuleType
-from typing import TYPE_CHECKING, Any, AnyStr, Callable, Union, cast
+from typing import Any, AnyStr, Callable, Union, cast
 
 from . import Image, ImageColor
 from ._deprecate import deprecate
@@ -44,6 +44,7 @@
 # experimental access to the outline API
 Outline: Callable[[], Image.core._Outline] = Image.core.outline
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from . import ImageDraw2, ImageFont
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index a7848c3695e..c5d6383a59f 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -34,12 +34,13 @@
 import logging
 import os
 import struct
-from typing import IO, TYPE_CHECKING, Any, NamedTuple, cast
+from typing import IO, Any, NamedTuple, cast
 
 from . import ExifTags, Image
 from ._deprecate import deprecate
 from ._util import DeferredError, is_path
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from ._typing import StrOrBytesPath
 
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index 05829d0c63a..b9ed54ab20a 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -20,8 +20,9 @@
 import functools
 from collections.abc import Sequence
 from types import ModuleType
-from typing import TYPE_CHECKING, Any, Callable, cast
+from typing import Any, Callable, cast
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from . import _imaging
     from ._typing import NumpyArray
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index c8f05fbb7fe..ebe510ba990 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -34,12 +34,13 @@
 from enum import IntEnum
 from io import BytesIO
 from types import ModuleType
-from typing import IO, TYPE_CHECKING, Any, BinaryIO, TypedDict, cast
+from typing import IO, Any, BinaryIO, TypedDict, cast
 
 from . import Image, features
 from ._typing import StrOrBytesPath
 from ._util import DeferredError, is_path
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from . import ImageFile
     from ._imaging import ImagingFont
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 183f85526d2..103697117b9 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -19,10 +19,11 @@
 
 import array
 from collections.abc import Sequence
-from typing import IO, TYPE_CHECKING
+from typing import IO
 
 from . import GimpGradientFile, GimpPaletteFile, ImageColor, PaletteFile
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from . import Image
 
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index 2cc40f85535..df7a57b652c 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -19,11 +19,12 @@
 
 import sys
 from io import BytesIO
-from typing import TYPE_CHECKING, Any, Callable, Union
+from typing import Any, Callable, Union
 
 from . import Image
 from ._util import is_path
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     import PyQt6
     import PySide6
diff --git a/src/PIL/ImageTk.py b/src/PIL/ImageTk.py
index e6a9d8eea2a..3a4cb81e9ef 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -28,10 +28,11 @@
 
 import tkinter
 from io import BytesIO
-from typing import TYPE_CHECKING, Any
+from typing import Any
 
 from . import Image, ImageFile
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from ._typing import CapsuleType
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 9465d8e2dab..cc1d54b93ba 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, TYPE_CHECKING, Any
+from typing import IO, Any
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -52,6 +52,7 @@
 from ._deprecate import deprecate
 from .JpegPresets import presets
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from .MpoImagePlugin import MpoImageFile
 
diff --git a/src/PIL/PSDraw.py b/src/PIL/PSDraw.py
index 02939d26b5f..7fd4c5c94cf 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -17,10 +17,13 @@
 from __future__ import annotations
 
 import sys
-from typing import IO, TYPE_CHECKING
+from typing import IO
 
 from . import EpsImagePlugin
 
+TYPE_CHECKING = False
+
+
 ##
 # Simple PostScript graphics interface.
 
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 41b38ebbf83..73d8c21c023 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,7 @@
 import re
 import time
 import zlib
-from typing import IO, TYPE_CHECKING, Any, NamedTuple, Union
+from typing import IO, Any, NamedTuple, Union
 
 
 # see 7.9.2.2 Text String Type on page 86 and D.3 PDFDocEncoding Character Set
@@ -251,6 +251,7 @@ def __bytes__(self) -> bytes:
         return b"[ " + b" ".join(pdf_repr(x) for x in self) + b" ]"
 
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     _DictBase = collections.UserDict[Union[str, bytes], Any]
 else:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 3e3cf65268a..f3815a12205 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, cast
+from typing import IO, Any, NamedTuple, NoReturn, cast
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
 from ._binary import i16be as i16
@@ -50,6 +50,7 @@
 from ._binary import o32be as o32
 from ._util import DeferredError
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from . import _imaging
 
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 62fa7be03ff..868019e80a8 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,11 +37,13 @@
 import os
 import struct
 import sys
-from typing import IO, TYPE_CHECKING, Any, cast
+from typing import IO, Any, cast
 
 from . import Image, ImageFile
 from ._util import DeferredError
 
+TYPE_CHECKING = False
+
 
 def isInt(f: Any) -> int:
     try:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index ebe599ccaf4..88af9162e0a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -50,7 +50,7 @@
 from collections.abc import Iterator, MutableMapping
 from fractions import Fraction
 from numbers import Number, Rational
-from typing import IO, TYPE_CHECKING, Any, Callable, NoReturn, cast
+from typing import IO, Any, Callable, NoReturn, cast
 
 from . import ExifTags, Image, ImageFile, ImageOps, ImagePalette, TiffTags
 from ._binary import i16be as i16
@@ -61,6 +61,7 @@
 from ._util import DeferredError, is_path
 from .TiffTags import TYPES
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from ._typing import Buffer, IntegralLike
 
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 34a9a81e11f..373938e71e0 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -3,8 +3,9 @@
 import os
 import sys
 from collections.abc import Sequence
-from typing import TYPE_CHECKING, Any, Protocol, TypeVar, Union
+from typing import Any, Protocol, TypeVar, Union
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from numbers import _IntegralLike as IntegralLike
 

From b4a480ff2cc3e418c04993a54f43b16df9174c28 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 31 Mar 2025 00:31:56 +1100
Subject: [PATCH 1590/2374] Corrected documentation

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index 671d1ccee44..54d66db1361 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -9,7 +9,7 @@ or the clipboard to a PIL image memory.
 
 .. versionadded:: 1.1.3
 
-.. py:function:: grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=None)
+.. py:function:: grab(bbox=None, include_layered_windows=False, all_screens=False, xdisplay=None, window=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,
@@ -40,7 +40,7 @@ or the clipboard to a PIL image memory.
 
         .. versionadded:: 7.1.0
 
-    :param handle:
+    :param window:
         HWND, to capture a single window. Windows only.
 
         .. versionadded:: 11.2.0

From 25af4f1841c837c8e7ad370f4b001409c1b221c2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 31 Mar 2025 00:32:35 +1100
Subject: [PATCH 1591/2374] Added release notes

---
 docs/releasenotes/11.2.0.rst | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index d40d86f21a8..9f27d845697 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -51,6 +51,15 @@ aligned using ``"justify"`` in :py:mod:`~PIL.ImageDraw`::
     draw.multiline_text((0, 0), "Multiline\ntext 1", align="justify")
     draw.multiline_textbbox((0, 0), "Multiline\ntext 2", align="justify")
 
+Specify window in ImageGrab on Windows
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When using :py:meth:`~PIL.ImageGrab.grab`, a specific window can be selected using the
+HWND::
+
+    from PIL import ImageGrab
+    ImageGrab.grab(window=hwnd)
+
 Check for MozJPEG
 ^^^^^^^^^^^^^^^^^
 

From 81be8d54103d008dcfb7d75edc5ca43d0f78afd5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 31 Mar 2025 05:16:25 +1100
Subject: [PATCH 1592/2374] Fixed unclosed file warning (#8847)

---
 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 f18d8489c62..c2e850c36c7 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -230,10 +230,10 @@ def test_tempfile(self) -> None:
                 assert_image_similar(im, reloaded, 20)
 
     def test_unknown_extension(self, tmp_path: Path) -> None:
-        im = hopper()
         temp_file = tmp_path / "temp.unknown"
-        with pytest.raises(ValueError):
-            im.save(temp_file)
+        with hopper() as im:
+            with pytest.raises(ValueError):
+                im.save(temp_file)
 
     def test_internals(self) -> None:
         im = Image.new("L", (100, 100))

From f673f3e543881ae283b25ef7db06fa828a4e353a Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 31 Mar 2025 05:16:50 +1100
Subject: [PATCH 1593/2374] Close file handle on error (#8846)

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

diff --git a/src/PIL/TarIO.py b/src/PIL/TarIO.py
index 779288b1ce3..86490a496f3 100644
--- a/src/PIL/TarIO.py
+++ b/src/PIL/TarIO.py
@@ -35,12 +35,16 @@ def __init__(self, tarfile: str, file: str) -> None:
         while True:
             s = self.fh.read(512)
             if len(s) != 512:
+                self.fh.close()
+
                 msg = "unexpected end of tar file"
                 raise OSError(msg)
 
             name = s[:100].decode("utf-8")
             i = name.find("\0")
             if i == 0:
+                self.fh.close()
+
                 msg = "cannot find subfile"
                 raise OSError(msg)
             if i > 0:

From e995eef424cb996ebf933b690d30c1834b99999d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 31 Mar 2025 22:31:24 +0300
Subject: [PATCH 1594/2374] Replace deprecated classifier with licence
 expression (PEP 639)

---
 .ci/install.sh | 2 +-
 pyproject.toml | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index 62677005e92..fbb6c28b502 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -50,7 +50,7 @@ if [[ $(uname) != CYGWIN* ]]; then
     # Pyroma uses non-isolated build and fails with old setuptools
     if [[ $GHA_PYTHON_VERSION == 3.9 ]]; then
         # To match pyproject.toml
-        python3 -m pip install "setuptools>=67.8"
+        python3 -m pip install "setuptools>=77"
     fi
 
     # webp
diff --git a/pyproject.toml b/pyproject.toml
index 780a938a32c..3f9c916c646 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,7 +1,7 @@
 [build-system]
 build-backend = "backend"
 requires = [
-  "setuptools>=67.8",
+  "setuptools>=77",
 ]
 backend-path = [
   "_custom_build",
@@ -14,14 +14,14 @@ readme = "README.md"
 keywords = [
   "Imaging",
 ]
-license = { text = "MIT-CMU" }
+license = "MIT-CMU"
+license-files = [ "LICENSE" ]
 authors = [
   { name = "Jeffrey A. Clark", email = "aclark@aclark.net" },
 ]
 requires-python = ">=3.9"
 classifiers = [
   "Development Status :: 6 - Mature",
-  "License :: OSI Approved :: CMU License (MIT-CMU)",
   "Programming Language :: Python :: 3 :: Only",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",

From d8a0cb5db104cc5d9acc6b4ba1ba871636132f51 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 31 Mar 2025 22:53:51 +0300
Subject: [PATCH 1595/2374] Work around pyroma test

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

diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index c2f7fe22ecb..8235daf3282 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -23,5 +23,11 @@ def test_pyroma() -> None:
         )
 
     else:
-        # Should have a perfect score
-        assert rating == (10, [])
+        # Should have a perfect score, but pyroma does not support PEP 639 yet.
+        assert rating == (
+            9,
+            [
+                "Your package does neither have a license field "
+                "nor any license classifiers."
+            ],
+        )

From 999d9a7f0cab002c78c93c3790307474256f7d90 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 1 Apr 2025 15:09:09 +1100
Subject: [PATCH 1596/2374] Updated xz to 5.8.0 on manylinux2014 by removing
 po4a dependency (#8848)

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 4858f6d69a9..2e842df6478 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -42,11 +42,7 @@ HARFBUZZ_VERSION=11.0.0
 LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
-if [[ $MB_ML_VER == 2014 ]]; then
-  XZ_VERSION=5.6.4
-else
-  XZ_VERSION=5.8.0
-fi
+XZ_VERSION=5.8.0
 TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_VERSION=1.3.1
@@ -56,6 +52,20 @@ BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
 
+if [[ $MB_ML_VER == 2014 ]]; then
+    function build_xz {
+        if [ -e xz-stamp ]; then return; fi
+        yum install -y gettext-devel
+        fetch_unpack https://tukaani.org/xz/xz-$XZ_VERSION.tar.gz
+        (cd xz-$XZ_VERSION \
+            && ./autogen.sh --no-po4a \
+            && ./configure --prefix=$BUILD_PREFIX \
+            && make -j4 \
+            && make install)
+        touch xz-stamp
+    }
+fi
+
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
     # This essentially duplicates the Homebrew recipe

From 7d50816f0a6e607b04f9bdc8af7482a29ba578e3 Mon Sep 17 00:00:00 2001
From: Frankie Dintino <fdintino@gmail.com>
Date: Tue, 1 Apr 2025 00:13:21 -0400
Subject: [PATCH 1597/2374] Add AVIF plugin (decoder + encoder using libavif)
 (#5201)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .ci/install.sh                              |   5 +-
 .github/workflows/macos-install.sh          |   7 +
 .github/workflows/test-mingw.yml            |   1 +
 .github/workflows/test-windows.yml          |   6 +-
 .github/workflows/wheels-dependencies.sh    |  43 +-
 .github/workflows/wheels.yml                |   5 +
 Tests/check_wheel.py                        |   8 +-
 Tests/images/avif/exif.avif                 | Bin 0 -> 16078 bytes
 Tests/images/avif/hopper-missing-pixi.avif  | Bin 0 -> 5435 bytes
 Tests/images/avif/hopper.avif               | Bin 0 -> 3077 bytes
 Tests/images/avif/hopper.heif               | Bin 0 -> 3555 bytes
 Tests/images/avif/hopper_avif_write.png     | Bin 0 -> 30311 bytes
 Tests/images/avif/icc_profile.avif          | Bin 0 -> 6460 bytes
 Tests/images/avif/icc_profile_none.avif     | Bin 0 -> 3303 bytes
 Tests/images/avif/rot0mir0.avif             | Bin 0 -> 16357 bytes
 Tests/images/avif/rot0mir1.avif             | Bin 0 -> 17157 bytes
 Tests/images/avif/rot1mir0.avif             | Bin 0 -> 17182 bytes
 Tests/images/avif/rot1mir1.avif             | Bin 0 -> 16588 bytes
 Tests/images/avif/rot2mir0.avif             | Bin 0 -> 17001 bytes
 Tests/images/avif/rot2mir1.avif             | Bin 0 -> 16387 bytes
 Tests/images/avif/rot3mir0.avif             | Bin 0 -> 16568 bytes
 Tests/images/avif/rot3mir1.avif             | Bin 0 -> 17290 bytes
 Tests/images/avif/star.avifs                | Bin 0 -> 29724 bytes
 Tests/images/avif/star.gif                  | Bin 0 -> 2900 bytes
 Tests/images/avif/star.png                  | Bin 0 -> 3844 bytes
 Tests/images/avif/transparency.avif         | Bin 0 -> 6441 bytes
 Tests/images/avif/xmp_tags_orientation.avif | Bin 0 -> 6686 bytes
 Tests/test_file_avif.py                     | 778 +++++++++++++++++
 depends/install_libavif.sh                  |  64 ++
 docs/handbook/image-file-formats.rst        |  79 +-
 docs/installation/building-from-source.rst  |  29 +-
 docs/reference/features.rst                 |   1 +
 docs/reference/plugins.rst                  |   8 +
 docs/releasenotes/11.2.0.rst                |   9 +
 setup.py                                    |  19 +
 src/PIL/AvifImagePlugin.py                  | 292 +++++++
 src/PIL/Image.py                            |   2 +
 src/PIL/__init__.py                         |   1 +
 src/PIL/_avif.pyi                           |   3 +
 src/PIL/features.py                         |   2 +
 src/_avif.c                                 | 908 ++++++++++++++++++++
 wheels/dependency_licenses/AOM.txt          |  26 +
 wheels/dependency_licenses/DAV1D.txt        |  23 +
 wheels/dependency_licenses/LIBAVIF.txt      | 387 +++++++++
 wheels/dependency_licenses/LIBYUV.txt       |  29 +
 wheels/dependency_licenses/RAV1E.txt        |  25 +
 wheels/dependency_licenses/SVT-AV1.txt      |  26 +
 winbuild/build.rst                          |   1 +
 winbuild/build_prepare.py                   |  28 +
 49 files changed, 2807 insertions(+), 8 deletions(-)
 create mode 100644 Tests/images/avif/exif.avif
 create mode 100644 Tests/images/avif/hopper-missing-pixi.avif
 create mode 100644 Tests/images/avif/hopper.avif
 create mode 100644 Tests/images/avif/hopper.heif
 create mode 100644 Tests/images/avif/hopper_avif_write.png
 create mode 100644 Tests/images/avif/icc_profile.avif
 create mode 100644 Tests/images/avif/icc_profile_none.avif
 create mode 100644 Tests/images/avif/rot0mir0.avif
 create mode 100644 Tests/images/avif/rot0mir1.avif
 create mode 100644 Tests/images/avif/rot1mir0.avif
 create mode 100644 Tests/images/avif/rot1mir1.avif
 create mode 100644 Tests/images/avif/rot2mir0.avif
 create mode 100644 Tests/images/avif/rot2mir1.avif
 create mode 100644 Tests/images/avif/rot3mir0.avif
 create mode 100644 Tests/images/avif/rot3mir1.avif
 create mode 100644 Tests/images/avif/star.avifs
 create mode 100644 Tests/images/avif/star.gif
 create mode 100644 Tests/images/avif/star.png
 create mode 100644 Tests/images/avif/transparency.avif
 create mode 100644 Tests/images/avif/xmp_tags_orientation.avif
 create mode 100644 Tests/test_file_avif.py
 create mode 100755 depends/install_libavif.sh
 create mode 100644 src/PIL/AvifImagePlugin.py
 create mode 100644 src/PIL/_avif.pyi
 create mode 100644 src/_avif.c
 create mode 100644 wheels/dependency_licenses/AOM.txt
 create mode 100644 wheels/dependency_licenses/DAV1D.txt
 create mode 100644 wheels/dependency_licenses/LIBAVIF.txt
 create mode 100644 wheels/dependency_licenses/LIBYUV.txt
 create mode 100644 wheels/dependency_licenses/RAV1E.txt
 create mode 100644 wheels/dependency_licenses/SVT-AV1.txt

diff --git a/.ci/install.sh b/.ci/install.sh
index 62677005e92..83d5df01cf6 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -23,7 +23,7 @@ if [[ $(uname) != CYGWIN* ]]; then
     sudo apt-get -qq install libfreetype6-dev liblcms2-dev libtiff-dev python3-tk\
                              ghostscript libjpeg-turbo8-dev libopenjp2-7-dev\
                              cmake meson imagemagick libharfbuzz-dev libfribidi-dev\
-                             sway wl-clipboard libopenblas-dev
+                             sway wl-clipboard libopenblas-dev nasm
 fi
 
 python3 -m pip install --upgrade pip
@@ -62,6 +62,9 @@ if [[ $(uname) != CYGWIN* ]]; then
     # raqm
     pushd depends && ./install_raqm.sh && popd
 
+    # libavif
+    pushd depends && CMAKE_POLICY_VERSION_MINIMUM=3.5 ./install_libavif.sh && popd
+
     # extra test images
     pushd depends && ./install_extra_test_images.sh && popd
 else
diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index 6aa59a4ac18..099f4a582b0 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -6,6 +6,8 @@ if [[ "$ImageOS" == "macos13" ]]; then
     brew uninstall gradle maven
 fi
 brew install \
+    aom \
+    dav1d \
     freetype \
     ghostscript \
     jpeg-turbo \
@@ -14,6 +16,8 @@ brew install \
     libtiff \
     little-cms2 \
     openjpeg \
+    rav1e \
+    svt-av1 \
     webp
 export PKG_CONFIG_PATH="/usr/local/opt/openblas/lib/pkgconfig"
 
@@ -27,5 +31,8 @@ python3 -m pip install -U pytest-timeout
 python3 -m pip install pyroma
 python3 -m pip install numpy
 
+# libavif
+pushd depends && ./install_libavif.sh && popd
+
 # extra test images
 pushd depends && ./install_extra_test_images.sh && popd
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index bb6d7dc373e..5a83c16c329 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -60,6 +60,7 @@ jobs:
               mingw-w64-x86_64-gcc \
               mingw-w64-x86_64-ghostscript \
               mingw-w64-x86_64-lcms2 \
+              mingw-w64-x86_64-libavif \
               mingw-w64-x86_64-libimagequant \
               mingw-w64-x86_64-libjpeg-turbo \
               mingw-w64-x86_64-libraqm \
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index a780c783576..0c3f44e96ef 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -42,7 +42,7 @@ jobs:
             # Test the oldest Python on 32-bit
             - { python-version: "3.9", architecture: "x86", os: "windows-2019" }
 
-    timeout-minutes: 30
+    timeout-minutes: 45
 
     name: Python ${{ matrix.python-version }} (${{ matrix.architecture }})
 
@@ -145,6 +145,10 @@ jobs:
       if: steps.build-cache.outputs.cache-hit != 'true'
       run: "& winbuild\\build\\build_dep_libpng.cmd"
 
+    - name: Build dependencies / libavif
+      if: steps.build-cache.outputs.cache-hit != 'true' && matrix.architecture == 'x64'
+      run: "& winbuild\\build\\build_dep_libavif.cmd"
+
     # for FreeType WOFF2 font support
     - name: Build dependencies / brotli
       if: steps.build-cache.outputs.cache-hit != 'true'
diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 2e842df6478..2f2e75b6cb4 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -25,7 +25,7 @@ else
     MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
     MB_ML_VER=${AUDITWHEEL_POLICY:9}
 fi
-PLAT=$CIBW_ARCHS
+PLAT="${CIBW_ARCHS:-$AUDITWHEEL_ARCH}"
 
 # Define custom utilities
 source wheels/multibuild/common_utils.sh
@@ -51,6 +51,7 @@ LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
+LIBAVIF_VERSION=1.2.1
 
 if [[ $MB_ML_VER == 2014 ]]; then
     function build_xz {
@@ -116,6 +117,45 @@ function build_harfbuzz {
     touch harfbuzz-stamp
 }
 
+function build_libavif {
+    if [ -e libavif-stamp ]; then return; fi
+
+    python3 -m pip install meson ninja
+
+    if [[ "$PLAT" == "x86_64" ]] || [ -n "$SANITIZER" ]; then
+        build_simple nasm 2.16.03 https://www.nasm.us/pub/nasm/releasebuilds/2.16.03
+    fi
+
+    # For rav1e
+    curl https://sh.rustup.rs -sSf | sh -s -- -y
+    . "$HOME/.cargo/env"
+    if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
+        yum install -y perl
+        if [[ "$MB_ML_VER" == 2014 ]]; then
+            yum install -y perl-IPC-Cmd
+        fi
+    fi
+
+    local out_dir=$(fetch_unpack https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$LIBAVIF_VERSION.tar.gz libavif-$LIBAVIF_VERSION.tar.gz)
+    (cd $out_dir \
+        && CMAKE_POLICY_VERSION_MINIMUM=3.5 cmake \
+            -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX \
+            -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib \
+            -DCMAKE_BUILD_TYPE=Release \
+            -DBUILD_SHARED_LIBS=OFF \
+            -DAVIF_LIBSHARPYUV=LOCAL \
+            -DAVIF_LIBYUV=LOCAL \
+            -DAVIF_CODEC_AOM=LOCAL \
+            -DAVIF_CODEC_DAV1D=LOCAL \
+            -DAVIF_CODEC_RAV1E=LOCAL \
+            -DAVIF_CODEC_SVT=LOCAL \
+            -DENABLE_NASM=ON \
+            -DCMAKE_MODULE_PATH=/tmp/cmake/Modules \
+            . \
+        && make install)
+    touch libavif-stamp
+}
+
 function build {
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
@@ -150,6 +190,7 @@ function build {
         build_tiff
     fi
 
+    build_libavif
     build_libpng
     build_lcms2
     build_openjpeg
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 1fe6badae13..2a8594f4961 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -160,6 +160,11 @@ jobs:
           & python.exe winbuild\build_prepare.py -v --no-imagequant --architecture=${{ matrix.cibw_arch }}
         shell: pwsh
 
+      - name: Update rust
+        if: matrix.cibw_arch == 'AMD64'
+        run: |
+          rustup update
+
       - name: Build wheels
         run: |
           setlocal EnableDelayedExpansion
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 8ba40ba3fbe..582fc92c2f3 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import platform
+import struct
 import sys
 
 from PIL import features
@@ -9,7 +10,7 @@
 
 
 def test_wheel_modules() -> None:
-    expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp"}
+    expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp", "avif"}
 
     # tkinter is not available in cibuildwheel installed CPython on Windows
     try:
@@ -19,6 +20,11 @@ def test_wheel_modules() -> None:
     except ImportError:
         expected_modules.remove("tkinter")
 
+    # libavif is not available on Windows for x86 and ARM64 architectures
+    if sys.platform == "win32":
+        if platform.machine() == "ARM64" or struct.calcsize("P") == 4:
+            expected_modules.remove("avif")
+
     assert set(features.get_supported_modules()) == expected_modules
 
 
diff --git a/Tests/images/avif/exif.avif b/Tests/images/avif/exif.avif
new file mode 100644
index 0000000000000000000000000000000000000000..07964487f3cb9ae2a801dfaf63a01f0ab570cf09
GIT binary patch
literal 16078
zcmX}Sb8u(R^F18fwzIKq+qU_NZ9Cc6wr$(CZEkFBo_&A5^?OcL&zbJice>~PF;#Qx
z0s#RLnY(y87`Xw=f&Sq?wgs3o*#eBr<%F1ofq;NnY|UJZ{?q<}($dt%>HnrcKn?&C
zm;X2ak8J?P|8E%t2Y`$1|1{u#BQ3zj-sC?|6bJ|e=)cH61NH|3;#2tN|DUJxkIDX-
z5CCBJzfS(A;QVvU{!97q2_rW~CJ}oZ`~Nk7{r@ZfWHAqb`G59bA`ZaG?Ee-30zxn`
zbvF55$^VL40UVqh{;>?e!NmR_qXC>9%>MB|{8!?CWsn>I9)SNMpiody{|L^=jY%XB
z81BCis)@aglbwl;$G>Lafgl3@g)jjQwnqPH{{RdG3<eAm4EAqZ-nOPj|GgTB|7%K4
z4v6}n2L%KSi~<Duf2se*e?S3(fx$8s`1u<FWywm!-0OwH2r9?AAVenkUPF9h9mz)3
zivQU>1=dueU!mndS%A{l!iwY^{X3TeCBOwOQz{~Ikf#LsZ(1sO9itM;45v933?*se
zd02#uN(%){V{#_&@$9&-AaRK1sggjHFJ&r0fbb{|O95<%x=k<=lRubd6o^psb#*A$
zO(Ji(H6s0_HMd+gd&qB9jA?mazH;wtQ_oJX=af8cNL1-7UrmtStxSX6vkwk0`~rE|
zJh~RbeAr(4p9E;%Ow6xN{+r4NG5O_T(}2{~kyb5#j_j*E(g@V2vLu3`V&Hff?VQBU
zp@eV6AvvI|Cyl6IA_lIBZ@XsvM>AM&K(wM2iJoRoq&tV;j!B^l6Bbt=YXq!?6`otO
zL9g8quZ*?~z=A=QZBvovEpz*n)}I^FV=m}FhCpz6Vyn5ZiQfsbxU3<5_mog!lXUlg
zBqjL)H(N7Gv68n~e*P$|8^N=R>3z$>gOs1@ay10_TrAq+jzBH97JI7m`hoO;R38ix
zPucuCIp##=LjrS*$HAv}pd4aPT;YA@>=ztBVO%zlo#=^sn43Wr>eyA}EK`Z5=swT0
z303&uu?Igyu^R9g5=n;l69-WoXT$Z0u?oCMO@4LC-}eM{EZC_>lpH#zFXBPwTlPhG
zclbo=il{G73E43-+_=x54Q?kfejxDrLK@GSRcQ0_rFTpZ>AnY_*RjGoSQ$`+#{{`9
z2wV?x1`^FPST99bx{nRC*)JBnGU=IW<A}zXP}GrP?g$Z;pdRm(?f46=d@#4=;(JC{
z{Zm_1MHclwf0=<C2YhDnN{@%}9+QxZLR2@K2sOsC3ft>-VNvdKVIrl3n3cAGT)^1<
zM@336XD@t)5Soc)qxdpRu$)=9Twi#?9Br<WhMf<nP-dP&oI6z(ljaeDI}gx_Gnb3)
zKcj)+7s0D!b-_TMGt5MpC9Z+0M^Y_R&;E32B#&P6g3zb^GWw&q8YI*FgnexJ>wW0*
zSGcp&*M4Ml0XN=00bZENjy4aZ0`uE(jYUX$-upV2l7t%2<^s=#xqO^shX&*(N}O7W
z{Fq1I8M>UfM{Ag%pxBb**Ba!e%ScGN2_*!w%}4_8IMdt2^<B3TvT>Gl>`NW#&uLn*
znOTA}!ZFGK+ZKWb*!Y<~S26<b5G3-(#Sg7toIs*e)X+}hD>JY;$!v(A#4y?_JKoH4
zvX&-!%j<kVVfrf)iH{+zni~5jYQTGH;U~TaurFL88($MSPDl>^1j6^_sF}19<(+So
z=~f=IFKSN!>?hF5>;nXub@2>OQS;bgywkd4<Qv?yYkPh#k*CSm#2D{mU&nGD#u!ri
z`ST!=!L1R#2KD)M1~}(?t1(|)s}P087N(PX4A$%@o^;kWtz;DRjyx%FpZT(O8wwKs
zrK(YfOhfDd4&hj>q!}*G{PT2MmPgir1)?>`n6Wd#EGRyu!Bq>Qy_gzK$yAYm$OA=P
zr{gob3{+rD5t6H5w{$LQcU*Fb95J46^(EvWZcfmzX25_cdZf_P<_j>dMcBb1LQXQ$
zsKDkj&1*$*$M>yM5;oX!jp~rlIO(`mxm)~9!fSfdB&F@9y|XvGZ+JE4V2tjT5XddG
zgR82Wl%ifgXm)o#?hu&)PgAdq+2igIr~OmiI*WF9CBggD`6Z$X=X14R%mG*JEi;Gw
z9rulE$@RD5H?FEzMm{Fj#j_pzm9~b*5Ogkw06CWjjF9wamKzq_rmP`xD*ux#)6u{Y
za^jkQy|VKh;O`z)ZrKx`PP9LcS@jC(N}LSiI;=;^>c*>zmx$2AJgJh;&r3b!N76>;
zH-7UFz_`USgvMZj3~VT&%y=G!LSR$atW^&*navha(<sv*Jh|Pq1y!&S4XFMh>#c^u
z!buuN>8|3$@-&(zDr%2U0jh?=D*C=Dan6w{Aih(qw<N~~%O>7xNo6cnn;*Ek?(*fb
z#N}mdG7_P@Azp1WJfnnZ@I4d%DAihkc>YmeIdn;$j_}bE2+Dm$Os;J<Z#x*^Da-<%
zO=?gWi{Q$vV`Qfw2DyQY2k#N~ysgwNo6ONmv;h~EyDNMZHkl;3oNUw1vQvIX@&hSS
zv1mXSJ(QGu**!AH8}i-{TGfQvFYlGe^IA;|tJ{4G*5x=YAF6nePNKW<V2=PRar0_Z
z;#Dl_0h`&7w(#84p#R=dpSi1oVBgYeNj-AVguE^QOku!Moe%D+`@Tm^BcmoI#bl`c
z#vQU|x&4rYOP_#`^%G6|Dia?$3RnJ%SCG5T%V<d`V?UdGbifO;;2WNv4oSd#{D=C3
zitAVv7>70asCc>dLHs$>ng-1Gy-O~7RTJPTNSeH<GcVe)7D<H~k-8V~X!0H0tdXH1
zCH_>Vi;_BRzlhVw^Le<&g6&r0w8<8;A5&Wqyp@ACJlD)wqkmWAx?1;u16bwXSkb9g
zN#c3Dxw+=O-wAS%0UpVqcTv(1-;0Mt-AZ5OoJYT)?geesBPaPyFj%_$YVV}N4@SG6
z2(tFqtdDCiK_EldI<(HiI`xacqq5BdXDA$WhoxN&0>tRnwo?*uOM1dWNFtOhkCI#i
z<zCFle4fQIf=b^3g(7qnNAf0z<}d+rfFC=Y=cq#96EVerW}V=)%u`M^Zw9kazi=kF
zw8OTYsiE58U@h_wuU#Y6olc_K?}^hjJAdtliDxvz{Af{__Xg5(9Ntph`^~Y&vT&wM
zbzBem*?lhTWPJ3ss`wGnIJDcCS@3;IZ*vm_@XsP>oOg5)M)2q<L2wrlgTBh+*0A@x
z?2)A~J4r<&OdMW!)}hk{nuS1rAakGzt_J)ML@#aOt;8Z3MU9%eB4?3Jf>WGU{tYEb
zMt+VRzGxZd8M+5jC)!#g^eaUisye+K)Lh&9*o$wFn0u5Il3Nukfs6RLD;6YO2}T&I
zSUsHU+m;m%f}4z0AcbcmW%MKR1fP6?r{4l}^DGRo897EZx2`#?=xU0DydiPCKqtP*
zASvSck&-OXXlx0*DEg_ZAzfTlHq`W-=n`=N;~84Xt69VjNDg&yQ;=WbS-vo~1>8$*
zO(4>o3(ep@Z`c%{YR?5(bkBHuOO+Yr>R)>$GU>Y>3`_}c6ic)CV>bPXpfvA8Dm$A_
zK%qV4YS7U{bexUI5Lj%oVhSZH9+$cGAvQwPX~dh;Z%$c)(B*>0>K7#DzS4N772VmY
zLJ-p2Aos8pk?U(lBpQ=G{E>BZy8baH=8<!H&vV6rJPU($fj->>d*j&^1bf?Tc^s-g
z7{z6t`wT&?gAR?K7vc2is%Ju0+OL*c1O{XPPP8lt9<k9|kdDw@w?QAW<gdj{NPdw`
zXRj{KJ=~7HAboy!5;tnrQ54bu<d|w#$nHu^iMf~2xm*a;XU;|=KS&g98mbWPUJFx+
zQe$*(<jSt0Zwcf{AW3`y0-0NSJP$#EU*yQ{f~|3X6H(~0>0XTPj~ZfsQY970F16`E
zkA+Yqdt^;GyW$ZiUV#Zhsz&RntbX_9G=MtXaF%~Y5Y{F;wwvQkD;U3W`7&;3jAc~(
zev%2)i{T`%DqHNl4~p^eHh@QNR?%8j_tJ~T8dpS?V~aj~zpR8KTwf}Kuq)LUE|&UM
zZqaJ3+cTWNLL$Cek2FO0Q0PMbfo0+2DrfWD_NJnKXI(z}-qLjYfYXKM@qgIv+ik3g
ztE$ExG+&UnDbRGLCz#Ebr5RjuB(^xpgp>lPTY8UD-et>VCFRgh>T+=xWu$HJGT^3a
zeH0GpQe2kr3pY+dV#)pWP*4nAQ7KE1*e1ja0w_ri%RUGV?eDPWDGmE~gJ2^I?MnDa
zACiI0ZsjOFsnQ4u+k>KTd17VNmjU({c_B#l2-P)Vt<8Vj$zk}~$h3%IDj8P5hw6ao
zY3KLbE75UF(30vZu_l1%j5P{QVgsGoUGH9cnuN9{WN%|YBf}>aj=8I8dL5z6<}#G8
zQj%^-N|#*&IeYoPqhlz5aZFq}fTBVj;2Ejw*rvP^+F+c2;9ruUcc=A_>D99UwNL^M
zM&O>``^q`u6|z=n;^70D!KzGp3{!F!Hn{uFjwMe4>Tr<;JOZ$98FH3#xp7!YdX$$P
zUb_3m!MXdj0e>_(k{d<=$4u$L;5hTr&41Z&$MFj5aq-F6R&8Gk_)CIaYpkgy_W+>n
zweg#$Ci~%I)g}sk8^e-2Rpn^!uF<?Q5MXdSL0hCV42@XNDX`67%{86PpR~|zz|J{-
zRHEsKA+qq}mrTmC1afVg)PFYTTCt%U1U1wb-n8Mb*cEqJ)J!wWvkTB`Y9hTL9<-3_
z>U|+s3Mb<8(;LT(>QX_PGAOdQ+PD0O5AY1c2&dfzhv0|}3#MK+1_R{~Q)+lQpp{43
z>Zfewan(YzxjrMnE<RvG$VGv<!w?<dsozbJHgP-7-29YL>&D^N3oN5jwhQv_O~R#M
z@crhF>;CLnmnO<_pPpZJC+Tm58aW;7yOBb4He}jLPf!@g=}+cHfQLxj1KFPrCJmjm
zVW+AWK8_wQtE2wBATHLDE5f?B6=Pg9om+fg98&}ks?hlaM0mR8?eQBTPGJSel6qY;
znj4+ay?+|RbCl#Me&;_FkKSrfM;%_0(cm<}bljh6FY7wA5-xF}G4DptK5<GeC9y>n
zttA*l!SDo@^RM#4I!mnEM)EoOR)L0^^arUvZ(T^YWU|TUjA06b$Z5SPbT-XkAl-Js
z1GUYn7GPrAui{5>J>U@*z3fGYfc*q|{^WEBoGz)>3iYD5amio^to<Q>j9kI!F#isX
zOUhaDt4O}T6oEn1oUD%iX+gj)|95sWRH-)1-jKGQjXiYRpk%FUPK-y4xQSJ$qlzHl
z1^tHmE=pCuN9&EYl3KIj9Na#nrPX68)#;_US>#SPVb~nL9yj_}l}>Q}q&{-cm)H&y
zizc1dU_gzTi*^NO5J8}Nsi!xbr|4@~;AD+FWIS_9jDt@odn-M1YL+pJw>^P%N*0O^
z#7?bgsOzrNEMVvV8H61i6|W3Ge2y!%GR}icZy{<<SD#O65`Yr$*ZugDPf#8y&Ag5-
zUuM7kRE9taHPwf^Pf82kd#HI{jI@g^2MqGOMV<^L302l}cZ|5ozZ+U7nr^a7GfIMk
z=&v}xiYSianF1vwZ6e?-lK{Tzpi-~t<7|j^%r-LuH&Wk9#L`$ejZ5y=5rwOCA$F<_
zvVSRjqvsZfQM<k>_xEDrHzKd#ii*wW5ATa{Fso6L{w>n*1*f<K!U=Gd%(T3*s{|Wr
zdz|PTbMn9snowjelOA>pgMq0<dwXZQ6({+|HAb^Y1k%Oxk-MGF(KfbJ?>VcHY0_=}
z47AS@=F(@JnvBvM_<&KCY%E4GPTI@dx3!-#JD=Q5fa{tRfg?gWdJLDW1>FzSa`0Q9
z7YZbH*igDD!_PzUmKSwiF$jO(XKhO}0BWLA;gi(xEWZvAi1sstLJaRJGV2$cE15`$
z2w^`x`J9?96|~6%kN7US<ku<CXp~XScE@hfci*-0I!=w}N?gnK@X*LjhM5SucV-?(
z6US7k4LQGC-%f;+gFanvi3svU#_ra&ieJSV@lvqMtEqHw$)b&__bVbG1X$n=#+$eQ
z<a5HXl87;*mDn_lpNHDG^S9rZ+Dt-&YkP9-1R7@<Qp_1IpxoF1KjC^dj(tlMG4pI%
zL`LSMj2Yj(IX_L}r0w1Xf>7p_R|iPZdJ_9urBn8~z;!fT3l5~IsjbB>C$&S{F+SNE
z(cWx1J;-AcziN{>CITbehXZ1`?G#wlftF&d9X+>%AYA+>o25x(&W63fF#Xg1Rj|14
z6-s>A`)Vx@^bak=GZF2jqaewXb<ouIV6&%7{+syA({_)9gCN>~?*?S$z?d4>>+0z^
zg|l-F*SX0ria9!+>sdAr4xDVbNtn(~gEY|_XONV>4C&2-K<2QInqAqu=F3Ytxd(R6
zY6M<BE<@XRKg>TyNC^!PnI0(OA(*xyX6o~?*V39)tkT)<f$OL-RIJ-Mw(DOd_axSg
zkcOy}<jjl2#ws-8J?zP@XAhd=VYw56Q;!<ss9wexS|!9_Z?U!cp$ofTfZnQK^q+IM
z_$SzI$Wf4PchF@_B2k-16waSN_-Xv;E&;4}$fm7QbiD`E@yf1b3|jIsvpgFhwk<K8
zNkn>ACCk6bn-sM6m6GgzCmWI@Oy&{tG0`9Uvnju`@gS`??6yKo>y%+bnKnH8OA`q-
zQyp-NX=JK4w4j&n2I|7-QD};(gZ*J}_^v(suL*I_o6I4kBjR3X5$k_r;dH$@*dq-v
zOES%7(x^Rg;z^~AbJV4&e;UKhp>>BK7fr&l;VO0+Jka-wB_JlTMIN!Hkb+=h88fCi
zrR3-5zY>Ia#C?chnz0X7W_g)N%gRcMlq%qu#(MWZQpPr|O1N9CX$>aPTeVrn?(N#C
z1t~%bNG`ct2!BaoPC??BevoM4UTYCWOd*@Rpr*H6T38Rq`mQ<l9qJm1L{126p5fV(
zk@UhgE;;<@l=V+II6Yz@;33<PD_01FAZxaWxw;))@G^&>F7E~z8K0~viu2f8#n_iE
zm7qYWSlB1Ezy`pjf(00bNB#`X^f$5WhF+-GJb2}TD!ppLU32u^nBwT=Q8pW7><Ox@
z{2g-_)a_WsV9AFB3UJ8}7T=P_34B_Tv$>$ADkw0kUaDi{#w_0AE7+hxo$`r1`?-)E
zN$>ZTga^H?>1DQ1dH!Y!v@8?YZ`qq5rRu^b-X^OTJ!WNp2+a7TPx{MKHpRqw^I@=~
zE`c#IrZA(y$gXkO-nNv@U1kdULX1|4_wx<E-4*+{M^of$i2z`?7@S1;FqxZs*o~CG
zAixYhfg~Edo>1(eZ3(HqF{r!-d^bkZUaZmy!}6fb`J%K?I=EK7DUe|_GekVyLNm%J
zJK%q&b8dw0gEQsiEt&M`bALz>=S$U?iSm0fW~>UF2;#9OEQLk0iy3+0nel$CSDr|Q
ztd=n%&P#bemWdmk)$p+`Z72V=^*C+%;Szyy(_Am^cffpotW7A76EzCXFMJ2X{9j6$
zI`od~c4n@naBUpEslz(`9<_D5=tDJls}=lbBA8n^1z0jKCdmLJcyp>H3QW+cpyOZl
zEwg)L&g0a#!IhykS(Nkc04QUBJ{KMDOlXo$xvIa73F{fQ=T@PLDm=C;^(&tQ#ZDhP
z<9ftmQKFDOVaFPsMrzyq)bVDV!sOz04?R*dpM}ATlo?E`t4S!*Cb=~3CL=2qT&I23
z+T9o_=%K{5Dj)}NP<Kj*;GO9aTFBB#iNY+O{LV#huno7iIGN@n^>EEX*raMg(l5jq
zph2bl=#sL$Ix1cx=xn=_gQAbU@_{9JPlB~|$Gb9@HC5XSz1r!?dZ40D!dyBQYDOw4
zyXtNX8ZSGebJ1_O5hUQyw=^@liA64^O)K!?o7u#d-2$3DXs7)WCDBL{9L|-eREf^8
zH(N$P0QSf3hczd<hG@WwEQ)?PTg|X90_<^nXOEf?wi(CNq$U|z!T^)VQb;Vtg<b-w
zz&FZBUZGs5LxMOtb|Ph2i?$1?qxE%TM9r^{c7(rF29IKier}n`FYH&pnl?`>$!D7p
zW+DFuX)Z9D)E%FN)%#+MlvkI&X-o_M1|B)&NmSh6Xg!*5B@OgY=aijTbdIJC$xIQ7
zD)lX+@6YPmH!X&4JcvNN`OvD6G9_D%#<!HjH{+XiyRuD|*S-Ig?7dNCpUm13@>Lt&
zb7#H;b(jD%i-w=BJ3xt>rXT+cMUN)G-OZViwlj|z9<T%dQh4<Qrz);Ugl^tna%4Eo
zK3Pre!_|d6znUBlPXu^2mY`LF_o!rsV)s{kmY^b!NC2#g;$(|cUWM9NsRlYs=y);?
zgLl{;L#a9e{iHn~R-u|g76=dS^)cJs9tYa@P7|!XUVF*v>=delD!_UF*|KBkU)f|~
zfxqP_Jv-v88(lgQ7VVQrtbBOY+6@#v(w(JYuDEO+RD-@(iY863fG@T$P7ZS^0Q3c(
zg%<W~Vw8!OEim`w%2$!i<=CZ)L|GUg+CH8ms5#+Nk7xZ==uk;_kuF*G2<wdU5&DgS
zKlvfUK!O3J>=CSbw9tTU!D4A{#-Wu|!HRYEyRXYcyY}GD8;w?2IB-niY0qO*Ekr<<
zh5Y!mt2%>=7pM<9NGW>V(!`AME`)JUJUtecRvG){Sz7fMrj7p<Hx=AdTvxDu#u!a3
z@-RuGvIJUDX+eW|3@~;oTXwmR+r)rAAnXx3SK?(NY&<X<2^rl=NmOw5uEeGXTQFqa
zJ1|xWz9RAu7cKGpIYt@$3Z~32v^+G+wFyL6l+~P!apn%DDMFw!zB1xPvLq0w6Y+*r
z_FX*4J)ukklnZ(TbR^VeK5{9w1pMAtum=J*XR%LEG*!CxPC*Wbril^*)TbRahQwxG
z6EwogiND)EKu`%^YES($O_;9-KF=qJZq1S!_0MpXI7-z(8RnJ_Ze&^R{^_U?Y+(Bn
zFlXP!0kqfhrRhF#yY|9Q^kf@qF2m|oC4H411}uSJBzZA|7Kf<A<weX&FIl!Y=7R{G
zeAdR|F0o9Ex8PH|>k*^BHp5PH(=^od)Y(@q?7KSAu@kycqB$%_NBVuHu5>VH$nCvT
ze>><sqkP>!-wNl~l?tSyj*ts1%%h)I3;Us3FoJ|wLwYTmURF`Ne>?^I(Oa8TWjIFY
z-kUkB_lf-(Nrq$*D36HxAXbLgTzfpueR^jh-Hw|6cBf}(uJoqR;kB8xe;R`6moNW|
zD$ZfC`T*uPnAzp9SD!JC!GQD%cT6Sf>SM1!xk@7~Q0N7fmhZ6W`|BDIyfwhwhULx=
zX@K|E2^ZI?&+qJ&{!YUu8zVZg<~Qgzc(I))HW$a!!;0J!1%4HZpEA@=cY>u(I;QGq
z2MkuL-O{rSPd1J4QjYn-#})bV0Io~MHb{%s{6+aadVrlDBAu9kM8wBzlQRD^SJr71
zC!@04Znqo%5@e9h#xD87R~i5!eIwh25`GTy8TChW%NCef34~O#0$QO<Jy+^QpeiMn
zLDpAw3AdggDslaE(Pa4Si&;u24~ukXgu3<cbE?aWOWaLr*gTJ~k>->IhyPBHG^;}f
zG@M4)jd9vJ&^Ph(vE?V41Z7ZT@y#9*C)?Q$%?-W#z>@(7Q`kOw^I5WL#-!zUi>z@%
zqU!U?E-=;$9G|86npOU@SC(Q@1{G=cR6fOC)2i_aiYN>yD++2+rFphH+fQskaOR&J
zIGC(pq|Q@)K(Jk*ku;lqSzZBu*|mf+3kd1YEm3pAasp{CjEg`*qIdne_MTOZOvP5I
zqMIAXx@XuZ?$XzG=mF$;zJ-8u+j5S*sH82yUAHixN~rYlt?ab~!ptkAz<FpT$olub
zZmTiCGM~Ym-}K;$WBn<g=_%j0?R%9Jj|!uN4lc+P!AhK<%LR#?;35(=9%Tu4`rz*x
z71{U&K%o_ETk5i1nvw*YG4)N#v8P^zTb7GL?1Wiu<0;yVbJ7qmdRip&6~8lVr|MXY
zl8eNhHyuUINRCsFEm?T0GF+YMPv^TdXNB&|+gEviAQ>>5oeSoTt^G0f+Yjjtcq#ew
z26OCFHNoFllhU_B9`5QNPhO=-4_!sSmb4Om)pbzbq;N`t{6}46LV?arfPKpP(yss)
zVW+TJ(!;&5x&BkIrzPUe4ddFb&7dZxiXOjX?IM@WilH+iEx70eW$bRM!_nbNy~J$?
z2`?=F=B`S*wygZ4JMYc7=V=CtQ-=qdHl7KbaNq;ii;<00uq;O<OOj<_;E{-yNYj>5
zIEe}}2%ke;Gt89N*!^FOt$!t$4>@0!eUA#A1V#CM`=|<*8s_ah9eJ=96J&pdE^j^Y
zc=cpOU)OAGDl&VWe1&F?yUEDk%yic><p9!699|Kz55}s%hISUXVmh1%=s9!hS;2&3
z6<(lZ%dqj$CptGO`|JX6P(KG~j{n`lI`>}c1gOu`b~!b34^t;rIz((7=Y+koAL||F
za8Lrir#bt$a9vuh{Bx4Tw$|;Rk7^9Q%khizsWaKkxpc)Ayq9=V=A}q?zUrTG;FCA8
z<<t5W=HoCXW#1@yT$q`xItD;2pfAoZW_}Wj8pb0hlbG0r$i&{xKABG$liqy5u1#)%
z&@o(Du=eaM|E7T`A>aPnAe6$hmjdp4Znda6-8v6?l1MmI@|dSjZkU}{r*U*@`NO9T
z71}(U5Wod;*=0{cftjTk!d%Q=e|h$<^e`biSNrGcEx7>1*UHrDxZymH1{wy!35ML9
zD-GWt)6d6kJ7!2iM6$iXT%h|%yi$OU66r&+h%Ep6op4>xGe$-|W_}>MR?^Yl`EK>^
zCQ-7;&X=P^CMVs^1`1LnNsfqiO6lACy2}t5S-u=5lc?=Efe-tiFRo(D1F`gWP<Keu
z1INSjn1o9w1XFbxmY`R)h}7D{pcBN14?!LRc;X&+S6;<()S7l+%@du=H-akt!~Sce
zkc|@!y%A7>$Vyd1^`)B(rZkAsbICU!x`gmIZb7`wc0f}QFr_@iKFm|J<HSIoUrL*2
z8<sk9n*i9or{S5_ekm3w(E90{4OP+42)YToFR~FB2V%XqCNQ5eHcKQ*cH|?TIkHr)
z@e+^GZkFN5o<z~9%gUHvbYI&^Bg`jX`#Da=WxJFPZ4}}SLv?>?tzl1M+}ZkKKgb$M
zu9ZTo<#=6NlN0I4xHhK0_ec{Iy3C10VO(s0&&i8O;LSa#L-SO%$T6gV!?bq@FL3g-
zATu8Z)i~XHkFylGR?)=dOFdN91AeE2XWPs9?~XrSZD{G^TL+gj7TaU=ifZb3s+B(#
zLv8aOsu<h;Dz%@*Q;)wH_;ksJm=9Z<bXz@3snCi~%NMA#Z8RvcH}m`esU?q!5K#Az
zv#-QrrDm%la-;?k;~o>+<OG{GA|xzi2QzCHb#2w&Z)%PSCc8Ps7pO~~tDYZ52-B5l
zlg%+_XVFdoB*8u?1<O$^r9E>NGcW#8L!Mr;w|a^^_BefJ=hJgvM<a(lZWcDR$CA9I
zn-TK@6r%c$Ah5>V0kC_R39MtY;uULIhMm=PR(u{x)z~x>4SVtL3=2f!0Oh~!;Cr!E
z)5%@d?jtdGhI^WvG?hue1_)d@5qjW8${tgQFZDQ*^e4tUUejP^I23-x_887YPJ{Vk
z27zDCfMS^2X#I^B>l@Rt2Zkil+tLnqIx9w34Y0uNBQ`~(E~MoF_K1HLCNcMlaBvE!
z`qiSTcteQ^KQdQ=$9FnkFe)#Bzn9Umho>tR2F@s8d`slj6}S+4BN<7nvc=Y%3x~We
zDLFr8o98Lu$YvNi!eb9!j7=^cv@<=hcasTc)}k)Iyr}0lHCQYSRLU$*vP1xf%W0$x
zJQ+wUg%x)}>S8)hvi&Q1+7ZO;^l_%$q*nin*uMLg$a~d|t1g8!7h)~b=`l1QZ-Z;}
zuP!~*T`BV#(ck-t;0VW1QSJ;|j4Ydlb{*<il>!IsV0^ct-9)ylF8;vLq8^4^6P^Xg
z{sdq1Yk-^yo%oAnRlY@pbcwavsz-<UYkMKW=1{!;F4&tyL)^;ZHw^vn(G_6^j^7Px
z=|0#MqZ=1+lJ#&JYW#`&{UK^=u0~&6ELnP{jX8tL%|A^2=OHV9%4d$zLK;^u^BHZw
zYNjve6*?E+%-VGxVTpTQK`erKl#_+**B}{C)<yBe96&{WzdE3Wmsrc}JDX=JV*64h
z5LSh;f_gCWiMV>8H8py1NXc7YZ1hIX?UzLS7=?Jrs7ZJsQ|KgU648{>TwkRYx0gq_
ziMn#b^$V(g?~W=OEKz3T7hV-_@i1cI8lua4{JU0SXf#nUYlO$z?Grav(Dah48nGpH
z2lBm$E937#KPhm2V|-eWw4NMW*^p)D;cDwJxSdUPp}M{aO>`UcVFAuboSmTcj1;Mc
zovA<B)rmh*TRZKiy7eX0#yKMJrUo;P5&0cOh-i*E3Kjf}dLQ=UwH0Rn2$NuG&L6kX
zJ@Dd_YY6;)1D?_vJ-J%9##+HJ7}o#2UAORIh_ZZ9*o}V?4d%x2-X<;zyuFmuQN|Pp
za>#4RZ!Qz!4$`lbL(a`DT}gMBQNb8~UTlfe$wOG8CQ`$?C5A9bUcP+2@Uzt;#SoW-
z@DXPOKm_&03kZa0`MhMdYTnl&A+(dzhMH$Ul7hbk-bJ*&LXqrXK2WeviMc>H(N^4U
zLp>=VbAS7`?ZASWGbGlGPeSPD!<r@1OpQaK<AIQBkngBFYs0&$(5_2ishp;?)C+@N
zIhv{YoZojp@go{_yQcIOleg${Q6b44#xdkzafc9}6)s09lxS<h;Nq`WY*5a%fd}`i
z+_w)F3Xs*5C`ei2v>R)C8{V!&Zhm3s+M9!l;kKR}n4Ft4{>`?r0qgrEYr-qQzR2Nn
z;;I;y=v+HL8*jdT8oGN9EQ&m?<;qGpq7Q>+S`kA`5Xj682L`mtL`$DtLSWf4kJs)S
z?~#p7R+k=R==%8sG_7d4En5<ZMU*iaymvJci?c4mnlg!#hoaQJ0(HE>suT}E@U8e@
zv&TvBUxql9-t9%wc=B~qbBH0~9d&c=?{@x%-7Rmw|G@6il_r$ZsWw?R7BYTxWa+Px
zXD;=NvA4F<Ce+%&TGXNyT6r7suE=F%?<ludIls^HTN*=%YZAUCoOz^?jL;bgZaZSZ
z@ISkJx$#u}wm6EM=;%$gO1VCTc=0yb++sv?vV@9#V_GrY;kc@3y-69_-`RH%E-WL4
zc7+{#$*aNOMaIZ)E^W1^4y2cokN`;ZVl#8iY4;%RtY&dHRxl<|1EvbT1!?^wv-dZ*
zS5xsWyOY%63!S&p42@f#SYR?DbAJwm1rnUh4_iyd__Z~aO}Lk%zWShRpti+2c^OIt
zc>@<rFxVs~Wb8NX6$vZqPhdy`9z0JLD4T2=;t?&CC|ZT!i~YUrp;lF0@>1@Y-+qNt
zo-p@LsS%BrSjv*X4OBSKsOgs$q*g&9I8qyiBs4~AUZ?>Q!2W7cXYGu4mh!YR#^%7e
zx1F3FVh&HfptYN(SK&Mq8|RA<4E%v_^9T)pN%IfE$re!%F7mGL<55`E=+H>9qD?$m
z%`VX<qqx8e)nu7HK5wpKE!_y<=YDyaKGw-hkulWT2ZtMc%`yVq)9|q!E4szV3-Jmx
zQ@wc-zm{i1%AKS=J1Vxlj$r<AF03xxoZ>np^#8aA>@t`WawGVn#pAvCHpPT4Y=4+U
zKO&QAYu?~-aX#QU{c1^}-@N{~XduJ~*C7I|U(>8wqfEc<c9g5ZIaRX$uC68?4jxfA
zq<me4BrmJ1*~VS;F1EX-_6-a}!F%B;nCgndpqOo!)@u%qz4@kxW|iLq4(gr>Rl&h{
z)2`i6-)h2ZuJ*Vq><5aIpOsYmNk`~+7>Z)6C!Ow1evn>4ysm_Q;o9_TLhYnVceM1i
z3jBiOGxz=rd@iVfN}G^Jq&e3-Jfz!<SzXL`vZu^*i@D7rCw|0nLY1A91s#9abs`!|
zPUrO(3_Q-480QMyCda9V9dW=uC0ByfU&bRJ<kq(RL|4n7PQx(0IKNSkANdVD-w|XW
zgx%oJ+fN*VC2Bm)ZR4L3&gt^)pmXU7vz{pnLUSow8~#iAi?kB9b$Kv-9$VBK;EtT>
z#je3NW<Ln%4N+g_KgT~U*!K+Ea`GbX9d3^~YCy`C(x5b&WC&eC<Oz|WB2kkQ+`lj2
zTIY9X^@4H<N{$ACkJtEfQ6i5Y_xtS2@(0?1c(t1?Ci)yl&VqFW)@cvwKU*6S0%5Ye
zN!8Br=137~YZq)o7E1s#wJ7eg@U}B7viP_sUmLQiop~F>aFl4Jy^|1M-g3K5bi${=
zgEdS!Wjwg7;U1dzniN8@NO1rDU!1h;y>2Es^WUsWsu+`(UWXc^_XNqPFNf+gXp09s
z=PI1FIhLUMFuU)WtNgaIc5SJmoJ<@<#2NMg3t6ZG!&=jglpdUIhWicqj$)o#WgR4^
zU$8n2vB1WvkuG?A3^8~PvR@_xf1$`Pelm3&!4FZbjcYsYDym;30pt}&WlpXH8loJF
zwfiKlx~gIJ%7wW=@t0`Z|E#?zzqrX3NsPnkK@TBR4q-xTYo|gH{`#6d4!=YY!xW+p
z+rV$nk-z&RcQ&D4-0@>qo+p9hx|6FWsOG&|&2o4y4JcLaPgr(r%q)<e+~sOsrvKIy
zZ;B|Xm+Ab`U>Tk~_w+1Q9*|3<RQPq&uQ(M<L|aL|c!IHV(_f6wzi9ysJB%mLe=&Hz
zX3xI%MZGs1ecR`DNgL!;&}6rIg*^q5o@Q#?Hq~EJw+0lrGNKry599}=XykHRxQAs3
zE;mCMS?A5;><XES)AGbyH=X7c*!V6`AmoSn7?G<Z)jIvMLLw%22HmZyd?#?+^Lo(n
z*9wK-ow4$c|0sA}@e(<I7;eJDt{mK0&vKVIbyUGpLgT9_!wsP6&R&GrJMK%0vvzXy
zN{<_3X9}xx5IO%LCa&O*_l74i0NjjVgGrRE&jx+k>R~>^&M~gEN462mZreKAY>JH9
zw|mvu83w+#oChiterC|MO1x26-i{SqI>2c@pkt-so!q3rp)(0r4IbjI^D@#drfy~R
z&^GL=4Iz^uH%59>V)_8#R>m!HM=mZMDouh;pnN9w`oS&-n+HMXy=LLPl(PE3+n=Ye
zv(bFnqC5My`C&C}fgn%DPA=yI|NAyj&!pAmj8AR$`g4d}l3OAh5t&z(fdwAghIE_K
zxvbbK((WET$XildHov%!KnMFGV*j}T1ijOx1fjRFNH;=0AZ)4?G0qUL-!I^8bNMZ{
z4Ux{3oIvq+;V79qLtMP~j=<lYzLFqY<ssq7n|bnv@vXah7Xhy|c@Y`n+NM9F93jL(
zMJv9#jeGArpp~oW9S0NOlqKZp*rmV(_f-XTBi`8G2uhM~gNqU-mHp?1IQ1ij`94sx
z?7$lHMD4B$0+Dc)p>P-{{g-2iFNsVsqmNj!d7ku`0$+!2%D{^r3@^9cI`xuO0$t0i
zC8Is+b3!r@fs<Rh>VB{zvv{7QNE(p(WdWNX5|`f><A#Xw2O`cGo%XBoY+Aue!gt7w
z9A|FwzNlbzaKn3<b;@D64$gp$Ww~j5KEHRp!uE7<w^XMQO{JC!3WerUe&_v&t>eMt
znpEL*b<-5rM&+rkqkRBhG(!QIi{Q<LO4ME_mco(^W-JGMUe6$`XgtKMD}vq2Xic%s
z+A9OQ@dlzr9`$8#M4y@QAH89o-9<dx*BLDz7F$Y<Q!+>tosYNO=og0@cHZhMoZ2fQ
zCjlUnJ)uea>CjDK#ePLDh%9y$sXO6)cqK_5qTIkKKlbINO9oqc36E!F<B3YJdf6P9
zdr&QjF_yC%1$t6siKdts5!N!Vc3H0^lCF=FVwkAe<Y3^1q?z1p^i?i72nS$|$N;x~
zaXM546RNcSfe`#LLTjsKTbMmEy=p2Xq6Jmcj~G=pqv^DGOQ*e^KR2fx&-Q0vI*6y?
zFyVI8UC5iDvSwXANK^wLVG5dK)BJZ~wG=Sw+w9;;ic8)RWkJ-{YCve`RH5ll*JDjm
zjP5T16i9MKV=q^?w6oSoK%^?Y6Adxu)ZigzC7z2}*<ydSlSp(D`+B~hvuO@U-ly>5
z3EaQg!ec5E|6W{xDyr%^DM)De^l>UTk?j~8Js66E`Bneo3J_IFkbcV0DaUo1>XJ)X
zu?IR1a~V-WAbgK(7Mtqlbn_(Vg2#yNdj^!KC7;L@u469jgYwrIEb7fUnQnMs-k3)V
z=(sMY*J*zjE2r$!`a=DgBG8i*XEf^D#ilY#q-gf{<BGB5tYO9TE?^s)6z~6mm|>Z;
ze0Mshe&N7nB=&fv4wNx8hrk)vO}ACLWK{wB2(z_#v4c;F_aPbtS{<5XblV=h3tev^
z@S?mdfOeK3icE^v3gw@A-Kbe)=<%9RFS_4pU0eCp-c=Rg8X^_xsI@Tt9dk=70QdyO
zAi=iT$I*HIn5s#`S&w@`HGBI_!JNDlWWF&pB6Ig>Ld=!ZiI))i3z3Cz*>xzD)2&^=
zOvJ`*N}<Pd*FptG#7vs*82*_&UffyPjP$ru_U$#C#FoCqb}Jw5;xc{l3+SS8FppFE
ziYX`qAhi&86Z0!Yycw-TACBV6O(DD#?%m8+urSpSNMD2_)IupYqA_>H0+~t)0OjfK
zc^2YR=XM)6-a7HFys;YWEL1b^n62+$EA9CkOMV_vH1pm_I`)!qr|&qki$FX0ud%)|
z3Wn|2A~curuMF^#YAPws1i9Z;5JR)R_rQmTp-HtY!6`s@#{Da`F|ngg(M{mL6P|WL
zAXW`?<{u<u%X1%~E~BF%enDJ<5-QS)#F?}pl0MdGSI3+XyNW>-1=AVru*!$cRi>md
zaIpnxsnRCGFcjwkR6eH&-4rUZ_&~*U*(=$r2zv;ft}E<{!NdU<6$(1;y2p0easv!u
zdj&cJ0Xg5`!!-Lre>;b^ZIpzX7Pv`?a4%1*<CXayto1$hrAlW^mre@}6#^`2F{P6;
zj%7SWp#sg9{ARKsEDSXhb?zAMzu|+LemDpzI$IpXmb(LuW@4~tCY0SVG&0}5L88oM
z09kePO<eRj;Yo&JQJ$lfP=-5wVC9Bgyw2-va+>C~OvO*8t$REPaxJ*3qEa6VNH4QK
zN=zVuuKc4_loft*s3}3=CYFKQw9cH=tYAwCL(jtw@c5yVkRc-`8nKd43<=px^9r||
zSMW~4!oX=aFTvKU=iUs_rq`!lPd<=wz>eEi&;)QBmdQB8kD@Z+k3-H>AJH+R#MxUR
z-1k3(0f!@-&~AsZ0=B+ZohQ`dZ2nWdUBMKz1U=gP8Ms9c@T1MT_h*ZV*h0Ex+;5_1
z5-_x0K1Cpdf_#OuCXzg-7J@<I2JAIzHc4D0Sp}tQM;$9aSyo1HHk8uNdVFJQieU(Z
zs%G9sD(%lM{t}bVzI~2VIet2q3FFa!QD|4z6T0Zt2b<@75BodD(PlHZnj7R%`~DD_
zer7-f_N85J$OLI=%jd;Zy35b9ZOr`36BmM23%|75_pe9h-mcf(en`A;;&R~5#KwTU
zm4?B)VnD<3bFFW`@ULW8<Gq@eI^w#RWePS3W4Fmzd`reEjXNZGnQZAyf7}+Pcmgi6
zu%;#FKU%9a&+X9-4hK2(y?qKTGSh#>D`8b2a;<Q?@0cXd@U+buv$b3*;SOFVC6G!j
z!tJ9AFita)-GBX}Zry}lt$B=DT;nn);>=L^8<OYH{qUwCJ|S4X7;5WKmBGq+!aI|U
z<HQs~7?1foE=sbei`@7AYe_r5O)67H=$Ic+FWG>dU*3uI^kkEH2{`=N<w!Pxx#aCY
zGagHb$8%W0i5*PS%OwCS8y~<PM2LG%LfIQ<6ab4_FDX5%6Pzsk^t{@?pj0Pcy<aLC
zXkgy%X(F0W+iRqhwX=o_z>$&d^T;&hug`h|GaaPnwqC;O&5Q!)4V3nBwg{ntmtc5?
zFDFwhS=^XytAm3py1TVO8<uaftiU*CPkDbI__#D<#iBXLOy1W4vb5uu=fXD<%-#C!
zHMpTorE49h4D^gSR)jwjQD5*bf9~ZylNtk;@c{5YituWjlRE5zfnvYsDWm0Y5QBFV
zB;(EE5BZe54v*Dh?+LfWn&)4Z;clnx_W_)YNP(Pih?_}x85V?juw+$LlfalyvED~<
zb&b`(k)bJidGnxhtACoZ?We?miK!3s_7`cUZiY<&*CY3$Y#u^gk5Xf2H$X8fSFfEa
zb~@XzP3U}Mf=RQ5;5`>oxo4fVCi=`tc+Lei??(Eir4Ee2LV)lYHo#MVQTiM{uyH9_
zbNpGEfYXAX<6BFUoqRlqo}g`$>R6O=JjGQ;dp~VXhTrNy8Eu>$>WG16n(us?6WFdd
zNB$M$ShyZPNvi|w(V=u0=xCYpszihS@P%s_qE<bk7a+Xi=G$zX0EIx~URs$RH+hYR
z!s%HO(=fO<)j;N8B{p<J2rW*PSaRL%!I3b#HL;}h^jRvT(mS89=wJR)y(Q-{eDvb<
zd6-_lYa&}gv*D%W<PVT1MSquG&uveZ4AT@x4s38E`pT<wm#E!%3B`^BsYqT4K%5aU
z&!d(1XR<w0se7pC5|}mA-z@pv%y%B(BxMhRX-0uS-P(5hqrdOiE%$ijpFzAST;C5r
zF_jWHKM8wBmj9H@TXHRM4je|Gf_PnPtYlNTe+m(}li0TT6V<##hLl*ZduV}9UWhd1
zdgXIM3rdri?aOXqu}wC+n!e5VXh#3~S;hft($$Npjn^xL)n1JFg=y1LD<3I!r<sy^
z2uw`mTQW|h{w+-_a>~XJrqOT&w)VL^oOnT72@DxmYxy`FFQ$8CQpBYKh?|K>quHK`
zSkH4|$<W4~#TRIbi-N>;2GWfgQ33@XV6F_A8ECi!n|xx$e#%w+%hhpL1O-;LW(r0p
z85*{3NZd^gz>a_OniC1_ts}(7Ajf6F>S?_JlQek??V!(*xtttLY_RF>rr}eJ<PRJ=
z2ru{I%DLjy>YC@(hx8H*0gwK!76jbQUm2}QQ&`B-;vBMLA0Z#~;OE^NwkhgzjN~ZM
zDy^zS$@j6+=T2p*2^g@swyp<$_%i5gL>8YlAdMmCmx3QERgAwY4LIbt;>+bugltSS
z)2-j&Z8@|XvI8DsUQUZ<LSiSiEgMft?S=(oqJQGQ)^qalo<4YJuk%P$lO|-gYcg6>
zZRM&+@*CIE53V9N&)yQ;A8a`mJB5vgDivTkhM(QAjXuusbevS^HEIV?F{kffZr8B{
z9PQH`Mct}pivrC_?4zYps~%<t!ciwx1oqS$9H9{QDZHl~<nY{T)3G5;6jD}QiDZu)
zYiLJLuEW7je&OhPHu64gC91Hq$*1O&D!<W)%HTE4;_;)H31gk`re%(&9bX^$XHt=&
zMkJfpYB)L{-DiM&BQbW#4Cl1oxOXxW>M7tJ)^kFqWM+K=;K+#BXIW@*7$#Kom{dtU
zVwcn8N!eT<XPhaLe^3uh^BP}TtfcYZly-1eby14H?W*4POZc*XLq8Ko1AG1ue=hud
zJC;=)2V4z<e?FU__I(P%slEx8>-_;Nm$sW&=zvF<&X}k>vox{5v<_%TZTl8>DN<lD
z;RP+5d0I335sQp%cljlqEV7>~JdDQvt#7anU>mUpkneTLaoo_Gsb$2nCr>dmsmva)
z6}`@UrvEMEjIkK)^0K-XMOW1JfAO~Yn0H|ogie6EPN^e5An~km=;6YwFqK>^5eiM!
zg)|@uu@^XcE0P(4vR85BN~JQnRzZ`F;$d3^U?6J$E#C$K7Lt7a-Ir3L2}L<wtk`|k
zBQa_tj<p!+FMing$*%irVj^6#WAUyni^;O&Lm(vCs5_g?v^E_w3x|VbVJ;LQV1i`%
z3A&RdIY#svik2;(iI=oGV3#_(BEIkA=n{_(!oUSV?z##j%_XFJCl54)8{@O!O<!`O
z{JAw#lJb==X2|iLd;sQ+Q6%Ajm~CIALYgvCkH8-c<#$lYAv(BZ*VawjF)MMePOLpe
zj7;U5^F4KG$yuATl_2-?>zc%LaI*Pgq7}%kjkM~6f5v2_la47VZ7`2##3kfZv;b1u
z$n_$U+cSB%cHexUqABb7vUb=ICqRg$u^6em_&o91SKQrahO`VK!qKQm_e2LfsfmgF
z+XkEci8415!Uc)$VBTR4HYP<_0*N~cL25LwbNs!^aaeSNMV?~|KZ2Y#UVtIJRB?EK
zX3q5~GzKqc3QD(n@1gEOE-(XwJE@m!SeHpEk|Huu*ZMbd(lCdb`<EB~gFbcC*s-(6
ze31Tp>*%}*I;x?EfH`(U_Qg4t3C1iEc{Mb6W34D$AcDmKlAjixm+07D!LT_nBUw`r
zalT7Qo3RWZWVfh+cuk9|DE$^n{q<>gXrgm@f1{3)C_R%oG|MqEataX#=-|z*2!2d5
z=goV7B`cqh8Zq*#_qzl(gM@yL;s&oh<sB5tl+)%f1%a`l#qq%7{pvDP!m)D#DeMOr
zO^e4ariuk<<$5@~>km#zk?4iyC7df>4kHn|rVm&<*#?J@ns)iPPNJNWaVy0UpTD$Y
zh=UtgWq3C=7!<wQL4rjc@vA`2LgqBVhkSdPcVK+L*RwEx=3z*CnkVI3#gek9ypPRv
zaMdbKb@V>rcfG+TM0}}4EXaqCoQH)?s0369)pUan{RzBk8ckN@&*b>B3*SX&f~(+W
zhqXj(wHQi$2HDo)!@f=J+qn_QB_{J<9e}6wqjs9JRLWk*nWk*okXE*|XOkv>uWkF;
zf@&ZGPl<-Ip&2Gn)mz$%D?>g9w?$D%n|&3uD{0C`vsziPU7wJuyqZirmP@LN9jFiC
zjx}}k4prrmqX%_fGp@hEMybJhQl-B<02P~L5`@A|JaT{vPB=93m;_b09R@4MQ8u8m
zE3w*l&<+Rb*eCS#pp;v+%2gm3s4o1h(NUCpAyUD8U}}+sYw(_BLCbB+hsbuDq*TrH
zSsYw5gm#_=2niDwoc4=P{}NidA6(!e3NZ&?@v75+P3pSTT|<sPwtqveM_{sXo>0a(
z?7+nao<r(F*t#kgXIKdT^si2y`{RO+0qP!}eHmmo9wco#gCPY@J)tUNN4MfB;>ykQ
zTv%%9Y^R_<PbwukfMJeGaqC*nOBV-jXExYJ261ft$9X4%a4W>kmiHVFgW)Y=w#{6K
Z_~Q~NBps!GIgGP2wZlMPQgBD`{{tjqpyL1l

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/hopper-missing-pixi.avif b/Tests/images/avif/hopper-missing-pixi.avif
new file mode 100644
index 0000000000000000000000000000000000000000..c793ade1c21da30de4937836db18887d311b739f
GIT binary patch
literal 5435
zcmXv}1y~eZuwA;lJ4Cu0SC9}XNs&fkSzyVP4(XEaZjh9vn<bYH=~lYCML>A?zxU4l
z?wpx9^PRaD001yrx_Cm(+#r^KXZ&M(h^2r%#LQAvMnLAdwQdh~G5e=IgWcM~&gp+s
z000UBx%_|rkL@7l|8Ij2g}B)Nry)H@dWfAP=wI~~06=;^{~`bh3jiP$e9qY+5QqPE
z|EEwt7hvRn!_PBjZu|mrj&_d!t<;A=ouJQsAOs3>d}dOJGZg%9@EQL9cX7?!1mpr3
zpDO@>1mtMv<N&hscy_`Ap!+|!$RSXBvwzw%o*#mO6o~Td^UB`B%!L?$jU`Ui`2<G7
zLyr?IU?*HhLj?egHJS?`g7lVT-g6>Wu`GCl#@tJFWRwZ~BDdTH@5NKzuZ(;bs{-&Z
zvM##SJWN>@y=nonity8Y7UZC_Z(k)-3SA_)$5C6#Yw=E}x0R!|KE{uASxjFY5c#5|
z+F8o6x#$<H*B>{T)uyTxV5hO_pp!9BW(!h;zts4Ryj$fdr_r==&OH`Yx5AYP)^aWT
z7LjdIT!a|!FA`~5*l%m+nddS=TuXmsl!j5Z&!Tq@(8o<P(q3lFIEL9eag~2B+7E-$
zMKU)&;#`DqJ-!}6@0=VdE2-HTL&q~A3Gc*ii#iL{D?H8eowCX{yrhOHX!e3DB%0i>
zn*nd2W`gK6w(#OG)&a)6=3KT+rd=Y@K3#?G@cjVoq54X3a}~-?_xe260kjagx5gPW
z*O{?8=Pw(>2a~Mz@ur9KO%I13(-O{Rcvop!HwJ)(WuJ7jZ$Dvxazod2?P?YY-Hx7O
zwl$d<NEkfe4wI#7Qm&SSY*GiFGML%~pC`YtOeQDFYcZ$W)gKSV@u?!e{tQ48gRG*j
zqgn&a4RO(6R2lJd(f6H7TR0Q|j2qc^Vh56&GTDO~hSG+V46o?Dn?~vb0ys9+Fs*d|
zlwe;yQGTvHy+e<m9%3mmt#`E(K@BVM;rX&7kKM&dT#r?dvv>7w3&ZYUm<Vi?m55_2
zjaz`DO^wIUJ`&^EKLlV^*B@Q{_+Vby4A5Pc_uXbartM-YqDJBCOd;0F?ZcD*I)^Bm
zPj}R^74edUmmRWwz@T`<PQ<Hsl45HK7f%i3TKk~Vat|6M;$IzGru7P~>G^PhVPdu;
znN)39p0Ekm-#iUkaLcq(0TY+a|JIsdsGAgBb6sPYx<#~)d3X*ISVLjZq)wedQ&+*%
zizDk?2H`#%iN)}{C1pSO{em!~uPxp=GYGwR_oySe>^q8a>^a6epywV`k1#J#RLQFX
z6!ulSOzRavz5V6<y)QI4anaNp_>KyLEAUFxo~fSn-lk5;lF*vC<%T3=i7~OE^vZCt
z<F3WpK%`Yjw2E}t=MlF3^W`M-s4o;dUZk_o*c~)UkKC1Nog526r89zD*`$v;OQgN&
zBFBh)a~98Zv((Ti%<^dgp$GYk`-hxIjTT8|r2<($#<zRLJUuj1w`{5i6?wO@WIeK`
z6{U%ed^CLsI11yj_c*L6Ja~!yHNOYV4eKDJF+F^)tU`Hf+(P(IOrBndO1DGx&k$+K
znBLTbLOa7q8kuOaR*QD9kJvo{Igr!f$QRbw^KNaq)ss-3nHtqRqJfs+CHK>BMl-A5
z5doLyRc3n?7xm%`I#J)P{jEdgiQ6%0DV$Eo-`-B<Zlbt;CMQHo&4S=ua5lZTh&E4`
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
Tojj2C+Idjr^nh=P!vB8&%2-KI

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/hopper.avif b/Tests/images/avif/hopper.avif
new file mode 100644
index 0000000000000000000000000000000000000000..87e4394f0596e22b50895bef01121f676d731ed1
GIT binary patch
literal 3077
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

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/hopper.heif b/Tests/images/avif/hopper.heif
new file mode 100644
index 0000000000000000000000000000000000000000..f6dbd1b4775035a4555dfa7078c11bb322b46e18
GIT binary patch
literal 3555
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

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/hopper_avif_write.png b/Tests/images/avif/hopper_avif_write.png
new file mode 100644
index 0000000000000000000000000000000000000000..a47a0562bbc672db510f73a7e3e6c65896f90974
GIT binary patch
literal 30311
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
KMNUMnLSTYt*17Qj

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/icc_profile.avif b/Tests/images/avif/icc_profile.avif
new file mode 100644
index 0000000000000000000000000000000000000000..658cfec176e8576bfd28711d879c2cfff4564915
GIT binary patch
literal 6460
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
HF5mwF+?@?J

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/icc_profile_none.avif b/Tests/images/avif/icc_profile_none.avif
new file mode 100644
index 0000000000000000000000000000000000000000..c73e70a3a525c68a16f5c2bbc075b69ab2704cd5
GIT binary patch
literal 3303
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
PMJg=(O0BBIq_F-6#F!Ng

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot0mir0.avif b/Tests/images/avif/rot0mir0.avif
new file mode 100644
index 0000000000000000000000000000000000000000..f57203093656d8c0bf5caaa95928f2447e9e8992
GIT binary patch
literal 16357
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%0Dc5&MM
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
Z0utlbN}(pC9bFqqJiRb;sc5PH{{saMTOI%a

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot0mir1.avif b/Tests/images/avif/rot0mir1.avif
new file mode 100644
index 0000000000000000000000000000000000000000..8a9fb5e5431a4522410ed0b869b64e98bc679e35
GIT binary patch
literal 17157
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

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot1mir0.avif b/Tests/images/avif/rot1mir0.avif
new file mode 100644
index 0000000000000000000000000000000000000000..0c7c7620fd47355a40e72b01b10b601a1230b323
GIT binary patch
literal 17182
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%0AJV1_fM^6
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
RmVbqbo3jf9uwz-@Eq)%)BzFJ+

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot1mir1.avif b/Tests/images/avif/rot1mir1.avif
new file mode 100644
index 0000000000000000000000000000000000000000..0181b088cec5012953258419b42cbc90ea44b948
GIT binary patch
literal 16588
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

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot2mir0.avif b/Tests/images/avif/rot2mir0.avif
new file mode 100644
index 0000000000000000000000000000000000000000..ddaa02f3f890f0cd65035a89294893956c2a30fd
GIT binary patch
literal 17001
zcmXuJV{k4^(=~d<ww>(Qww>(Qwr$(CZDYr_ZQHh;b3gB?ucvBO_v%&C{cmP!1^@sM
znmT*f8@O7S0{*lAp^b$pqm6}usf-|_(0|mIjfu0t|8oBsg}Je{<Nxmh0QMF}&i~K<
zA6i=&{=a45?Jb;b{x1jg-;8fzZD;hqNCW@?`fvPi1^|%&0D_|b`4koww*OcA|1#MB
z1t!4%6aS|%aAjZ=wzIbTzmm=t_Kx=d@yZtVMt1)ps)dui$^V1^0I>gm@~ZzFM0*Q&
zi~lhokdTo70jz;5qi_Ha?EfefBRgwHTO(`t|5k<rfcyVPL0Q;XIR396ObdG(ga7b<
z_Fso!K)^wuA^-I!V`FUKj0}K=#xy1WRw4mq!A4|i3<ScmMU+<$MQk6AjQLMbu)D-8
z93nY>q$_z7jfAj%m@6z8n+<8kMr)3W!k|BZkb1;acZu`~d?~&T*_mjL{SU>>gWBSV
z|J&YMJvSAdB%9+t$PIGEK7YwH&1@T}9OfRz3-j9d1f?Wi)NlCba)tGosoqBy6sVjD
z@>MIa<Sn6KUc%2OmVri^if%`6hia;0Nuu;-`3y2vywC$q)P(uK-%nQK1*j;HsN1l7
z9X$h<YQmp~i_y5;pMytT?S++^Z#z+>g6kS>l`E4R{IDl3#1qEsJ<f9=9nBgwKbYVH
z<OR2_$FpYoI6M|t^Fj0q+h|mzl|!#`Q=4BXL<r=#uch!@V$@`nm{FXRK7UF}Jgd`P
z1}k_x-*$7F@z@+UnvbSocE;)(#9^Y%S@k)SJy_ZcBdNKM`1MAY3VuS*C4XI6M3npU
zaHjJNQnBB}d5s*|WoK#Lp&|-`P~807<?P^Ai;nU#uVq;{$s)kJg(HVlE#v+WzToXf
z?4GT$e5pL38JtP2#3BP)1enAXZGTtJPsU>W{`o@rfCR(pWt)$TbPL1eGe>SzFH~VG
zi{q<i{<#CmBNyRS&M&6Bu;q?(7P2r846pXa@Ng~S(IkBBo0l@7R#2Y@x@+etub{$l
zh(|`<aXPQ8x?Qqe{o_W>_%i!-ix$z<atE=T>+k2bd$M(|{-)vkpS;ORYAi)jw}t#e
zSbH6WTSkm&qEJnQ4~8??4W}X)E8(&8D$W<I3)nu1WMo>PsE3ueJJd2I-K)?nnqJ+(
zJ-=^+=+Y#Vh64Vr9;02xMpTS65;WPz{EFTbOTo!)*<u6X9~P70*?rl$h(<5M(3hg3
z+#|+4jR?5nODU8rNyWsvvjbuKUWen1CurcojGd?MP{rXk7>vA0eSHCR;5!iO8+^#9
ztE+{bD3hARGBt`tOivX9w=#W(ggFH}UziEkz3wmSc}uo0%p&8*!%jN+#o6tIeUv=;
z0@fj04|WDuPmvNX-O{69PK$ml<vX=i9{MZqIS5o^FjZu4rzZl);dtr6j?Rap)PZwI
z&z*9TgG!<*-5;ePPjSt-3()8)uKS_X8{(!ytkPWDfUtW+A8?<T{FMg$NUa9=44#>%
zDDfP(&Xzv`QnZct%a8=g16XBf4vluYNfeDpq%*w}9(+^!j($1|ewYHJ9ZXPI<~BtD
zufM^L8N3ZxJGVS^6a3eTj0STX7{Cd)n>~u>r)8u>oG3SSobIHW<Nne8dR{LZB|X2c
zy?b)bZ#=1&k>1Ms36TO{rpzP~0FQV7$l)BE(gN#+BMD-vW$&UFZB5;nfqI|k6~A+~
zTo}E)VbW0!^u&i`AphO?JJZn`<sHp>!XjQ)c=C54n7dHTlV}lYub-g?eDaLhw<rqo
zq}U&G5^dlrfIRZeK<VIorYR)B=qUn_iw^1;kCaf@d&BH-QXnW}@TgxG{Gg9Y76Z41
z)b?5MeVv$U3XvU#;{feHMS}qEbC>s=$f)7GI+~6O<X<xhS_eqw8pnh%->?oO96{o|
z?}S6><UW>&M~jj?I4xjBH31`I3OQ^`8x#`Z`hh3eOZ$sB=pZ7io|;IFs`}NgZTL(N
z=Q$*N86`ZiEQwC;s#$HxMC`inhf?(4nCzKq)F&^QDbJXq&Lb1D?FP5a$&ClR-h_02
zl3pqCKZ><q#R9{KyMkm2`5J)GJ*w6z{VtX%!HQCy$Pr_j9^`ZU$&Hx0gU3~rnfTc1
zFpqJtgU9(l+S_k@WoiilVnkXvawZclF+KU@y_W^iW(bF%YJ1bdh`u&m-J`JYf9MOS
zt=_X^X_-z8G8cTPPHf7xmGbG`^Xby-U5QqMC=e*c>nAA+Yn>xL6&zE_T$fCP$R}Ex
z<W!6ChrYIc@+iI2SeOa?79(1EdT{M1%0L~AtCA%3H!HFCj?se}mK*55k92{){WaZ%
z(x<pg9*M0ZrzI#9@}FW|kCM_jaZr(fYu=%u+xc_p3;XQK%~6%Kvijz|)D(&$NLzI_
z?sMsE11j$Gi~6NW4SNPFYBD5uCYe#a0zF2NE<Ug^bXkAJM;RC#o^$vajy;YI`ddR5
zXa-&xvTP@2{+R|_51$1a-0y2fmBMn8P*|Ez=a~PazoY4|#;QRkM%AUwD`=4(<2FpZ
z$rRwVSkz9Pc5rvGdHDm9Txe+aGqL<hlge|eHwzlbOZiV@gK>TpRl#4auvg-R_M_*6
zjtw^z%JHtV7$)WU*n>VlVJl*&u>;BSUu1N>5+n3kt>DQeGQ?`Nn9rw(0CS^f9k+H1
zQtHk@kIQ*-&K<hg#huUlqt}KUIC1Xc*^~u*(PeM}D(V@UjWi=F9@SkTbCD8TU^TeP
z>yy6j-T)rf&xN_`C=9z~`hsRaYyNnud&VF;EbW$}N45(`BFc|KW5pfsx7U0(BIzX9
zF6E)vc4Hqm6k#m{nj%t5g18la!;C@45R@xZ1aUY0*#g`6x~u>4uT!cl8-F31m0YQH
zd?V!vkuIh*8M7CM`S~i1n>5hDeGA6vH5vof#TGgu`dfgS(A54-tmxK^9JH2=vaG(e
zLIuR@Foq_1JS&o9o$#<fLcb4S2*cFs4%CwXfm@elsaq_(>Y!43_Da4AW!{BNm;!OI
zA)>e`O&l;5d+FC^Vg2xL1$#)?Ng%2C_pZ)b{uyWAvp=EtQbCs{Y5pDE%-D5sW2=uP
z^@pTVf+M0TU>w;V2OV;qWqlo1jrI-@3K$5~1xf8?#ZL)o0Tk)1-Jhm-Edc9q`0a}W
z|3(w;5Vd-eKjf(kt}26b2+X|nmsrew4B%Q#uYB{!{?Y6khxJizaekIoj(=-2{gHHT
zK|EqomG#gm_;-gBd81B2wmnSfLGR}^AgU|03EHu~?=%G*B0<=8s!ar|V$)*ekdgRu
z^r`+Uudjt7{yOm_GKveMGM=&>T}@7N8+eH>pm-kSpJ)yZMM?^Ha^603MyUB1`!+G7
z@`I#d!5Vxw-;o3+C$c7|dVv`TGOt7I=-BX`NNEDRe&!tdcpXMbX16H-dXF870=-J_
zclJ8k`0oh(%~^z3w75ztF|*!Ct@yZmtule}<UFk5!4pLohNW|=<E5G{b@{h)=H31X
z-k9#t7c9ijK>y96K8VsT1d7}rb3i;}QMbY~gjR4!Hck1B@<IVTp0>E4@No#=4@%8V
zg?CI{glbhqJcbMK&hJn?^XDqLYze7)9&*69GirzJ%L0EeU5X`Mfx^n${AtFsdStUv
zdpFjmo#Q>V9DQU|jox-@-0pNx;!_mG5mOto4XO1w=&SO?LpUZ_N=6Imavlm+oVkx5
z27+%wq+}-$;Zf8Jad8?{*^(|W!>_ULi*C$bZAGP7_?k^9@m>ryJPff6{`qi?SoWeu
zF*_73K|>-%c(iZ)uKIX!m?W8d?DG@x7*`LQ?8*$<^Hbsu9hT}M-mTDlB=->7SLoB+
zLecWEBVs}7M1cX6XcDV~VHcjB11f_#;_*k-h1Q>ho>bdadoPW#BrHMT+0Uvz&W{A@
zKz^Q+0`oFx0j)fWjuF$WSyL|ik*yjBW~{$%rSmqUzya~01BgL~f*va!aG{fPK!r4p
zy{4kl0Ac>81vNTFU`qs)E&8&@&MXxD=n(Vn4b3Iqg<&qw`AC;-Wd~27di8)e!cUGC
z@)h50yDVyrE+>w}3GB{{zhnVMjbI=}fX%62kR9*$7t4K|1t3ugwH)3|8jbcrkRkV$
znbQG9bU_f^9iXGev&}ws`PKZYkvxbX7}#^d6+6)G%j9a?jaCKGwfH0Xqn+4Lh)ScS
z1b@*PdIA&lN2QOLVYB-f#yN)VA;B|tXlpD}-c}|A3g=&LPmzEdR4`UIRH2w*ek%6G
zab8;ecM8Q~^$7)?^gWb4CagWQwL-%>7?YDZ2&G=i2QC4Lk&K*K1vd-6ubV12k8UjH
z4%&!HC!UBRN)U$?WdgC7GDilX@6KsB1$<vOjEB{dkBsS`OkZ<3=sn=hAzQn)ob=&T
zxfv7XiBfj`VF}aiN^iRUWjeES<#2j2JxW;fyJTo3gptu^Z;tvf&p03ah#a=Q4#%#*
znKM>4Hm75ZaLPcnfKnLdGJrjz8cYz#7@2pNv%UNm^~i7L(L)||SU7^#lqGdLoE;%9
zT>=Q|XGPYkuTHV=XsoqEF8?}<TB=o{Fj8B!&L;Dg`{$~(DYC#|0?GROT!ADctCB=x
z+g7(MGp(SiQ<sHkNa9@<oKHfe4XG1$B+e4H&q`v`O#?_%+V$PNntn<?8BuY`Vjn(Q
z`psFO5iib#rV-vJcs5QnMR`nb&n1e#ZFFSB^1kG}r=@Xo{CftTNR*9InVuh~X6Jek
zagomk0edGEq3IYntyI9Gp;OpX-TiuS^eK9l*R2FQiqJc<GBUcMgWBA)l)il^bL5s0
zR^_2n1A-wcDgkA+22o?3_cm!O+YEx$H3#j~knRd2*t^pt{`~@uX&mW;;9jVcdy0mf
z8s9BcN-x96wyiHmXJ<CnNrFKIWNf228WbX1=Uq;9ztY%R(NoAWn{)}otN{frup!5a
zZbaqf`SobUe*H(AQhNHqFWw*&HyqT%?_RB(fWDlPSi|QC{y(J8$VWTq*^Vi7*gpQK
zgs!9!Tl#2<%2ml^o*W69_wXR`cov+vm9^0F0JoDlzonk}H0UcXi18v+x!kaeyISRK
z`S)!ZR*dL0!m0UN_(K_A5j6hq%o|%Wp$<+vL9hP!6Nm$OJG_%1_AaqusU_6Lu~MF3
zH>&`lDACKf$Jz~ILl`meRKeLw6>|wCB+ct?P;Y)TZ<N?MS;fQveQ$z30#^fV(bsUV
zbo4n!SzBMxMRG=9Z4K=lAw(dib72Bh6Wt4h<tVQ6ir8h%qX;qb&K@c7)>U!~ok_K6
z$}0b%#?GwT)DUB0#{<(OlsOKKVLVFtF1d!$P#5osTH+>H$U$Cj;Y*fZG{@c=URUH&
z(KO;yK(&?r&-a^W3|&v6Fhs+Go5!iPo&w>&rjK{Kxf7WZEhUmP-L-_Y?4!6M#$+m)
zvi?n{^@0gSmr>KNCDPrI2B%)kiUPEvs>Q91h<ELbjMs8sXD(@`BxnZuJC|dEq<FF^
z0izDCR#xJEjxr9PzcDnQ{4dVH2<t|y9i>fM{PlD56#Yf~xRmv(0R!=V4%L|-m^EO4
zFj(|(NOt6gxyl-6t+pI|PczmJ_DCiDc>K)_Vwk|SQpoSHwbYS|Z!sf0sfvH=47m=S
z1ER0^dR;rFS6a`4_s!nuhDU{dzvN`<fvnH1NKe2jm9vAO=XAQB^Nd;9IFyPlRvW)r
z9JwTjVoi3&2rg?%4i*(&TXzC<{t0yYShMW|h@3ufBnHrAt4fU+#%ZDxJlmS(@uuVv
zjso=)^@Gu$3fFYP0+o|9u)5AhG1>-J?s`znX0HVqQu2o{5=B^_7HP;|bsTRZQMqO$
zjL!O9qf}2{0Y!JnAw-eKHz|c2a2?pfzwFwgCj2=d@Ji1`7@$BsU3%HbEULduQ<vuO
zCI>-Wz!KMgD<@t;&R9TVlQJ=c`^~f%y~C2F+~S53czCD9-0@5(tt}1&-9}Pb!_Tf`
z&Hl<W+0mk>Md!f-wex0SCC8<D4g7h=v6s)ApD!@yGnN%V(lqxYCNMq=4fj1E>X?68
z*L<Ur)^tKV5pd%?v9J}6zbCK@ZU0rFyoS(0-D}nmYw}=$wlb)c!3PR1S7kjDMjsOg
z`N-y9^v9Hy>nS>gnAOVo<-v%a*djT=wtilEdi0#ys|&rt3)gL=H7e=unz!nDP2E#k
znU=$Ixy{+=$psH_AIVT>Em<`9$!PA1wda#|<<Fl#u^;S%fd;i+2<S+e_X3duO^9@n
z$z^Bmoat)hOKuYiW}epkYdK%GF_$V}m^9o`VxH+JErOUWrwJ%XuTumo-0eC=ta3=%
zpKWMAEfO9V7D1Z6vMmKu1JIwd@!jE$vYir=d*RA!Eqt?Yhbt}h+kxnvb5w7J0wIiW
znSFYd#A(jG5lCzvzk25PEUqD?ahBiXUiOZ_D(kx9b939om@LUpEK^<$lR)`W#MsiJ
zSpv=3-+O&|=v0Sm|K5~Xrg^)7=BM_rt>UcWUQG_)3n7JCYE>9@<~w}#;t4#1$J;a&
zjpG)yCJYSBUvfmSeT>4E;R74a-Zy05h^o{23#K;*W*KKrv36`DhJj8Asx!2^fa)~Y
z@0V)*nL=HMGODDj<>3htE8qSqI3{}`(39a#>*@06H4Fix&Xc8SZd;U#LvMudhJHSB
zut1i}jjv;nR`RGI=E<K!JE9qhD??8IX&@`f&bJre=nAENXg`nDSwiB#j&?MAR^^5b
zss`!Q%aI3ahqqpncj)M=6~NyIw(-y*aS}OJ(&85N5}rQAgXA&OW54QDF5;|lcV&iE
zN+?8smPr`0f`mO?1Ol1WQB9)2R?!D(%x*sCPGqOOZeU;G@4n0)@Qq4d^kK}84O%+b
zqRtjP@#?XEWrFdmW)2=jq7u^;*8~Z55HbVPwCU$>Z6QFwoKOmqx^B!jjpg*+VY55Q
zA)_Mt>i!ZHY2IRhC@(S(ubr6*C`E4H)#U@ntlou1rFfj^ekXm4<b%auY4lPGum<wy
z`8=>-{1TH-;20?eZ{?3A-u7A3kwH@>pvxa*`$INxb^1yshP{fL(iq5#N+ki;v6FIX
z68w!=zv8irW~=Pj@sxu)OL&#fRP@4e$ZpmD=elrCjrkGv%6}|zdI~4bkq5G1J}$%}
zYs*&%7L`9T$FFy|SBvPQ^kg*wJ$mrPC&3z6-X;9xlxk;%ON+-$3_>~276}oQG_vjT
z0d2_D^Jw$lMUA6KQywGx?=;VoO?x@*8%MPrF773DK4MWn=giJ&;|6_2fS*odZXTcJ
zbhr;ns%HP%Ns2`{kwOo(;=nPIrDn1+Y3+q<oC8YYdjQZk(gM7ivV?*q{$3=fv1LYe
zTI*-UH1?>$DjAb6-e%V26jnuU2zfp~8;{#K22k0x*;%#gz}>ftI{RQ#y=S551#t7}
z!2B0?k`O{w@BS0him)lXC_=i0+Y9*j_7JZR4a<<C0a6u9vZF5#WIHm2$XG3xkfrTi
zx6OZ>g}sfZ#HS&Mmt~IqCwB^^{uNDtF6N^=TJrW;Ey<wPQ^Rld?I~i?<3{zT0k3f-
z%3&DiQ5W7#(b>2a)6XjL207)})}cW$c4={~{aK}2NJE$u%LiW<=WkZViHYSEim(lu
zq#YvTq1e6-lz$K`_VG~TsC>>-VGC&@AOmjf%v+St-FlF(4uwXi3OS=Lwub3DeiF<R
zHGn>#U13>hq{hsa>2FM~V#?0=Y5P{`xO`=sH9@*?+!xE|xHP1r;`ra$WX04GDc!1<
zlWPY&CU^&SmA*(%mbMPH5&Gr3#rHhpbA=gh`iytxgd2^)m~Q%+2>}(~?IvN}o4h#;
zie6g_Bj3`f-N7HfCN};Jyyg-9iQq&tIh!)Ry$OvwdSo4@`ID=a(Lb*H`Rs0PRVr}j
zsPZ|}+l!?l#WJvjm^;tw=or(((^O<4NEFM@>}~L|^a;QKlCfRdL98b|_qum$9(M(~
ze;R+In7mX=K<oca6G^MF>S6aT;1K2pGTU{8d^a1Ne4+R2z=ap{a0++D?olDeIlI(+
z1kSjvyWv?8a`KVZ7svbq>Qd$;CUmo5KQKP-Y=Kiz`O21tT=_!0k0$&IQj&c*(lo>)
zG+e&Hg|ztSm~}4=3)lB#9GzX^kF|z99AK&x_24`HUUVK24Us;hu+QQKaWn7yIsGNO
zUMl(1NywZ9QWuw^{J_wl>M!#8!kRN$28F>!!>=X|V>+Pd5)f~hO1-*ScGvMUQ<7Ub
zEq9@U<WeP4pC+)*^%+bR1r9!i374rmT$h0DN|G$FSdyUlb;)2UtInhcYQ#73K-8kE
zJ#yyPlN)<fHrDu3(uo^cpqp|C$cdB57AP5~Gj$9`o6|Og)&ZJI@&yGXzHCE3qr_S4
z_S}Jv(S~jTmok5{MIe7ZJw7;8biaz*%gmV`h*$)j<(HTt30+*i+0$gS#ueO&#`=--
zxoHC2Y`9Y%38Og}mT0Z=luCP)+Zi9VrI6j=wozhT&k-_ho+NW$!-K7Do`?KZHBZQt
zl!s&({67v*UOV<wF}~p?<NoN+RW+sdB(u59V~;0UjauzsZZX}O<bW=O620KOv(4?K
zMZL}E$I^L(d&D~sgh4KZx61{mTl694i=|=+5gW}cw2B^D+x#Wsfin$XOQW}rs3L|W
z7?C=b2!2+%j~BOFLkN5!6N%$U4;;QjBjQ5r@)2Ikp-I_)^ROS;8&Y%R7drI+Lj=_k
zWCMcD5gBf~%3DSWuo>NqAZCP;JsC&jy(5EP!oGm518KOd$RFV_{;Tgm*xD(GMIyYj
ztcVDwtKjfuKV|vRy+%ze9N>t5TqCjx@hGoCZnbv<Q_-j|P5HQZGz~zEj;7QkT&RE1
zD8ajXlTX^(cgmz>ukhh~Qw+5@dW;o~w}2J1)~-G!FsHN<%C`JX(6VBE!Mv^oUbklg
z_~P}rsH7HVYS<gjo?J&fskqfiDVb;44rchf0}gEVwxA5~nzCzx0q%yaM893DQ6W4u
zx|lecEp)6zi}+5bqD2ZZ6gMRShS`}-@u&LUXh^T^rP6D@B&b}Vn1ma(UMLq(0elbp
zyG?9Q5CuH(S4LuWl;ZQX(rJ9H*?*P=JFsh8xWREFN-m)rnv1<ENu;thq6T8Y#wb;F
z)=Wi4**p@S)cXIH9SZ`j?OL4b!_p=fID_#9dMsXmw;TiM3Dv=ts|$Q2*8^3<qM|se
z49i9XFr#O%?eIxR#S^h#4;yS4*xDOICqR@g@-$U00EM>&T^Zt=Hr`#Dl{$8#A;4WA
zK2es|A90F6CqmyHlu)@g2l(E<L!V5n#xBGo)Ah!`e8vABbxnzn^yN2(m+X>cjiQKc
zMpp#O%D%7uE^W)uW>DuOPv=0_q)v<oKg)hPfQS2wp)K1r*h9w=3A@GV*7zXb;w34H
zCcB|;<Dz~$1z#)Rj#T3+w-zQ0e<9ljLZ+pXXllKREkPF-KHpG|p(+wx1Qv-)_jpe|
zNpZ!joc64E-L_M?qB)kjY_g@90hw1NiKLXy{A*9qk}tUULujr=>KF#E(m5TEdIQR<
zoD)<?cSc_YJ_nAzVL7gHTk~Ax^pZE%dCXn$qCClf5*j76bKe4>ui_U^fWqCUiR4~q
z{X;tuOXWJ_2KbXxB#XJo+d8c#cZ@(e2F#artq#v)NT%<C-#?(8RpFxcrxG;tpu9Nd
zA?PBgED}@1p|ER{*TW9&Yl~z*rYUS|UV+EgjH}%nw&EZJW-+RUWQ^T{baHFO7f>|;
zg?||U&1ijl_n|_yuAb&ybyP_?{tpL{)l$BntT@J*^kJ81Q`Y5QTcZu+!G)~#ON7`5
z@1}}71)^e;Bh_X@v2*~FwXQd9PAbolUT(@SixhVzD-e*5V(ZD*F@-rABn6$imm-`~
zg<YBIaQ+BZb*J$Celu|M({;rCw9enS_hJdp)eY{om{XrY;y||Bvnra%)r)?eFYE}H
zPR>Jp$;}AmzsxY4nC&apJEHlSVavDE6Un8L?;l>im|^zMJe8z7VfY_cBx1m~e>({F
z+Ve_g7FavJu~)nv>0k0Cl;zEn$vi6#ZYT|=0FTd@;=&`|PQ*C*lyN#}usT2n*J_vc
z6K*VMc%7Y1%k7TFAa>Z^<#2h=^R5a{xcI<VPOD4p_HT9SU0KaLp*f@Fo3gu4W3gao
zI1RTr&2G_d?rscLi@InSwP-N8rjV^OM1?w=z#A`laZ|=)xRd;h(&c-SLaH?2oAJAu
zw?L!R@yv5(-LE3^AzgJq9)GEIt#gM(tKOxW*@}zp0g{sKi=eU%91T0-VpSF-B8@&p
zuK?D+6ShZ$4CZS!x5>kPr({c(XH;^24#<%3V%1)B0VuQvzXKlc42~9C!a=E(L6QUo
zXx1<4Wj3yB$w<JK`!)tMVPk1I%5@+#n_!#4`@{FeI_!|J<NUC=eY)?7$vM+r3X4EJ
zW_M$#Z;-c_+u<Wzzt2Es{OW0C7lJ$}7uwxDXo((kmuzz8=kea5NA*(xWS&Y+0AIbd
z)(Z6&8Y%-j(!WspV^wDxPBdWd@QIJ&AD3f%jYe<i%YQovM5lpeAW?g%1>)=<dtuhY
z0Dol`yMum-9AjPyB6qbj`DfLq=x&3mzH5@G`v#>q+S1YwOUX?t6uIZ~PF1@Zc-4{o
zcTBwaQfu@fVV8H4y?6?4wV3{)?)?XI8w+j{Hw5;;DYS|JjMuYzf-fo|I$o-;cEdIC
z^Oy1|bD^?NZ{OwMwkj?u7dRILtf&68J~V^8f6RyfFy_Vr4=a`i^Qzrdt`Ix{Owne4
z(DYy`%Y*>wjg6SEw_Ja~Pij^`tW$d)Ol*K9shM<Sv%Zg4f#43I>u^w(RN9iDI=Q~C
zGWv*f=w*$^m9rq)v><%z1~&SPmB;eFsJD&1rOD>BO9eKm=vWOf(s{Ov0~OFms@lab
zE%$+uK%fDD&0ZDDO)uB)FufXyl|>~qQUtX!S7$<xvLm2>z59_7z1e9aoDum@kI=M8
zxWl4-(GYJpg9`%t+a&<tb<VvjH`F?z=PmlM0T~tQy=n1dEL$;}jqQ(+>G6=T)u?$U
zh9l|&j1s{u4>n|>>7?}s<TSaG0DcI{{2OShxW7SLi5w(q)KlBdsq+aR`lZucZQ!$9
z?CZzoPpSkiJ-O)dVC0XAUKE@StVEr}_yJ52$`PvH_~C!Ujeuu3NX~dcaf}uqYlFD<
z*pL5!@M){H7v}5XAzi|VRDF-AZY-LQiMlECGkit+bI|R3)7}3GkHa}iXRD?f5^^MF
zQSxy}5O)l#7{bP5r3CZtG>z-nIs99WBhHU&2U}%BxC?wH5gUk#v8mTGEsDlqPalir
zgDFJ=l9p?Rownyp;gcx!M4KWJeM-TT%Bd-<0pn|gs!Q)md7!nov^m!N2y2+s397Vu
zBGONn@&xLc4MwphRbK(A`4*>TxVQvH`wBj5jw9Z4`|pzVZ>Y)deMyO+^|gp+=HCX)
z{F&*X?}o9kvz#!H?Uzi^t+4#9a|#l<nyztwg(b#M+r*S|U=D3{FSk*fBWL^#Jq{{1
zpbb}C>@zGI6#ga>wOsv(;PNFg8lsrAU~w3*UieIC{~YY+$sM>g-1swq67=+Rlv|WQ
zlW1=zU-<ImxJlVx3i!8YY*{`6C@AG*Ckz=qT5q8@rF$myczQFMHyZBR__cW9v(_*3
zVvQc<A|y57og`X|*8-r%a4xD|N7K{E;EVc-;qn22g;_KIVbDtNzJvXl-AnT38v1F&
zI(55~{`aU773IM_P7Yd1h~*H?pVQYMN>8A)QyL7T*U0O;z8_nA2%J)6WP-@|b)30>
zmh`+M;hnqPR9ls>BK_LpZ*}ftsLJC8s_prONmUa5bl5!(-e>U|h46e|KC2oRug>n;
zQw*t|!lc7EamMUc_?mO$3Xfvyaay;uU*(3ok9|C>3AS1U3!dH2>iu49H#}`RwhF$&
zX#PmpDFwvah8Ux%3T(3r|LCZBP#O6OD(6I^sqtL}e*B}dY_F8&9w9hn#gJfjDv`Hq
z`ZP(m5?a9Lqg93T%{QDTup0b1{D&zRQT21tR21Ptclq<j*C1P1?G~-j(-ophF*V!F
zIZhu>C&7pnTb2A_2&o{D&z(pDG3mY8wrAIN%B3D|XJ(OTdn7&MEV7YMie8BY$R43q
z>uO*fgsSU`Oc~m<fihKk%J+oM^U&@5eqGXUCRa3an}$9rARshEh~fj>pp}_gIX1;_
zg&bB5IFG7*pAS9VYCB(Ath%ems2!X0l!LkxS!B)8(m^7e$8(z@QXKpBeE<>_<&ygR
ze8;1OBJzqOUKT_^1L;36D4$lY0}B={Bj!=GKIcQeRTC`8Kh4{}1JkA6iJw#gUHI8I
z@zW-$kJd|};sqLvDBSNVG~~zWVnc)Wnk8?fDVWtbD*mWYh45KX79$oy%}|o<!fSh8
zcAnB8H+!IB)Og)e!$_`I=4v5r;hP%TG(AS8%$G<s4!W9OsSX!LtZDw*Bmj2;3A+$|
z`{q=-(-w~geTC3{!B?_NW4M+(EpfQO3kxOGwA}iriL*o5AH<G2c-ifu-+GrKiuSfl
zrivLS?36cr@5c4O7s~!foX77Q%N$QeE8x-(EYpJo&R0oHh2-SLAN)-yn`F8&DB!US
z{9CCb#P_eOG^3)uXV=Cg5FQMC$S$8dzRhrhoHmsFi@T%U$ab*@ChFh-E3@0ewIHg3
z5MjI1onM>wm1xO7iBTB|$H?K(eNwP5{ytTgsIf31|6~J~*5-I5k|bvlH)FN)QOP6Z
z)Bob|&S-d{Dfm~V@VbZ7p<;zdNUBN@sPe~f1al+fNqd<mFjs|X;+c^-8d+p_1Gw`!
zKBo=xk!VI&R7^ub;OPxv)f=%d8c{u~)@up8Z|237N!GMnwsgy|q~T5ccC|B2rk3Jt
zE+$%xWIX|e4R?{6Mc2uiQE^jQmE6MC8jTg}KHKPJ;0Tz4V<{@Rt+V>mZoqhcXKyU9
zM~jH>Dl#58nOJ6#GnL(UizrEwvYf|Pk8c9<Iv>-^VZen;^|RTzLool&4-Op~bL17u
zbOc~@AS>I^Gonn`iwg8D?9V0WBj7Fa5n_k#!L+DcImIiEUz;jn*d4pj{4KxE9}gMR
zLSUxtTI`lk=U6KQk=gTTKNEJN6Db6RF-v7i?aNm+e>-vd34^fr&&3oNJ%&@$J85Q1
zo8v#{%;DcwJg{^Cusse`m{9MhkySD!NHinmDa^R=vQj5R-N1ev2XObonDl#G$YXWD
z3I$8%aEqL9hAs>>`=#0(#(JyYT#&R`kt=ons|q$-8mVQ)1eU8VolJogq7f`#k@8UO
z2r1wR)!fkq0z+3=10huLYqh-ag&HBQH6QA|uXbv_27KwL4b?2!^%iX_a%Am0^Jgj@
z>>fR{M$dOgW&zq{ukKD`iG7n8`uw&^tO{u3KLx=%G@7^LmV$s!#utdOl#?}mi60|P
zOj!;x+w=qjADX5BzFNKR<sP@8A<=nWERJ9y0tq3KCe%;K&sYj#<jT`7KRBk2Bi%3j
zE4@^eH})6-P~V5$g-zSNr>G`?+-xHe)*+$=vFY3ti4p~8`%?<N@Fn5$C_NkbVLSI0
z%qR*EV3n`=(0n`y$biO5Wqj4aZBM3J&j@c(985`MTQHY2p&EExr2?1j3u+H8OtVTT
z!OSRn^q$QLWHOm@lR#O#ZLqa}RRdP`C{52sJ@Vx4&p)BcU8hbt5}3Sqh&7kHH@%41
zxTp=sN!j#=C^C*lu=Xo^VAI``*aPX=*wK^%<UnnYd5%y)_1#Y78tfFlA<?%=1Tul}
zQIAfE;Om0KI9Gdrz!qOq^k6Bw%1FSiKG=cVfp~la_4B&;7ss57U$MRo1&GV&d4Khp
zkomuEdcl{1K;V-<%kQ$CQ%`!^Ljl^a@9IBUbxPx7TIH3#F^M`wI)Vbu$B_<R<-bFR
zEW~PYyM#GXiA0T#A@&<|5XS;{CM8FP2V}z^ItLdkcwC_dp~Cm<uM7vOTs#7SN_gkI
zp?>*Fwqw+IX<$0G%gs_6lfbGd>I&4Z(8)sV=8l8#KI#wIb3%F30Gzo(1~{ia$uB21
zQ--_JK~}I>-GqHtn9;)41l64JAD#bXTcLIdu;t2I8H{UeRO^>=kmpWhd7t7BP`}vZ
zxqFzI{ZTBZP_^9IWwv!-my>!<!l5aDV$une1_Dx5XGMg9CGt+w(>~E9&HCGc_I}M@
zRN@^*5)M(JIytiML2zenSsvQ#lL4x|hT4hbny=|LxGsOmhhWGeH3k)vSDJ}PK^P$R
zQ&*nMV6sReRZn`qO+9(7>s5iSHRA4>4}j_Sywh9D?XlVYB#$|H?a-DXDH0aLxDEVm
z=L0=IJIPn<CEF5G(XB09@v2T5lH&N&g@*oaz1%s6X&MdrSsGf;j|H*EsxB{PDy1Sp
zikgY6+OZQ)ji&Sz+Gx7+ZZYd(J>m4bQ{z3de^*?V6S_N(Y>dQfU5)7NM86e(`777;
zK7sdoPrvsv1Q4kp6nWh;ae8kw$zd6s-%1e4(~Pd)EhnImj<lncF;<#5F{5ppO>!6c
z5&c0%^*G=#u9sv5xW-@kYI5J?F!Hds!rko{i&;@Y45cLTW-|f!H(%5Bj4AGB72J9o
zx$Mk5@Iy9`C?L<mc9MvV@`zl{CMw2=rNPfbcU(=*`(0>VXr^T<A4j0Bl*($0wy;gV
z(+s)L;eZg+5J(Lh!?J)EO_fL<d^EUrbUuno)Rbs?5d>qQ1q)|{^xKYG+>vDxs7@&d
zi>CcsZ(=F%mRGS9O#~1PJXHt&rs*e!nSFCCn-TSxmZEH64ys0VJT10#C0-nr?NyeD
z5Lw`Cy=JF{G+vi7RUb8-XN2O9(l<dj>Cr!e0ajD^JRk>)v>P2kbZ7kmzlcupImKK{
zZEjgj+N0THh>BBIX$BaZX*^Vt8BMn&I2%??Rn*cgD#Y@UZPK=A8Jrn?8<2+iL6gm%
zJbWBi10yukO*KL38}*s`U)@14Gso%+unNmk#h206ve*v1+$9p+t-f}2tmF`<)cUaC
z0SguiSbs5Z*qXoi57Ct`E7?eV3Z*+)HYKTd;tEjM82}G#KWJmvj<svMO^Oqt_pg(w
zFjdf-j>+n86iQ6g6BL_WuBi5T^Q{KpTRRQ&;o%D-r4C%AV$P>gXnJN6kK6n@CTLZ)
z7iG%ckB>Hqk8w#;T<;0Dfn+@?NMbe$6?9xg$Q}Gj+8<B^W(Pn`5I%Zu?rX3C+T4qd
ztFz_(IS$KG+ye!lwNK<DvY5R_Bj9mD;QaotE9x6Ebg0-AK0YBD1}pcvKnTYjAL#Oz
zX^}FH*$9Q~)hv=$0d(Ny!7aTN1(T79s%YpXV!sp(9qJaTpez~&B}<FYd5aBl>kTB-
zLHSM{EA8f|quS~c(vNHct^w&B8l-t+VaIjVA2ukjj?11_e$l+xO&dvNUA^%nFzk>!
zb)#ujZ?Cn&X9oQ)aA3cGuxh@pu&1UW7qIizO2cT%nuiLEMZ6u6=O18041^@J&aG|d
zWtxJP`CpjVn85+PX~k>Tb9g}`v`CZqR|pQYHB0J}humfLih{7-&{Am+_-hc(=&NGB
zC@2zqcnx56;!oI=-w|c)OlSg1sTLZ+HFpQ-++2~MFTze)5psq}P2Q4GKnI^>-fi$8
z2%Zsdu28%qiCMvhaxN_ylk}8j@F&rLCaO3jn*}SUceEzB-@E1D>^tEtufo4w`D_Fm
zT?>nU!r6^#F%a*l@gxRIA0qO$XK1hlM#m1=jwWjInB`*g|2nFn`{11FC5&YIFZ4Ta
zZ-lI|;s@tdu>R9sOv~P6i(g<-b@~QN06jW%nS`+{w4Q%>Yjh;wc7;hoR%{VGtIexJ
zgG=DB#gqKSzcD5bbe<T`?6z942}*j6GxlojenC1_LrIx=KiYznQ9uudOm-Irs-)be
zBWhEc12gSh(y-b4{HUY-=w?Kg0|P+U6-WJT$Le_@qJHncvpD9n{(GoTRrkbSFE%g`
zx1Tl+f@j^r2wAy`GEb>vR{tT+-btUWQ3*2^C@>$6j$xArUE}z-8!aEZoMnGmTmEZ3
z3Ql4?`ZGQ9Mi<>2mEhZjdUP<U3+J_*gCUq@XM|Pt*3m&Qqo314eNM2Q3{{Hl!KDaK
zAwRag_}tTba4*NXGv=<VJEFaKKDrk#+RsJ6JT<3MRD9vtF||TpujQ)qN*QlO>|0U7
zMJdN6NRta?4%w5O-PpUVf<flC#jM=?JFDenw76w(L4-8k#sK>8R5a}TxOws9Jsz#P
z#I!lLE|zefCwB#3Qjpptw8uHZI`qxTp{e@tF{q6B)J8_LL-OO{H?snk>>|A1&3DeA
z#7RFDg>R*6gk(|6i!*GOXZjhrKu82LMzd;tE1E`#zx>F^M&3I)@;wTO;n0x@%V8cu
zF1X*At8L;XJkcNJvC=E)CK=WBgJDR4Y=-fv!`hzzUXA-!v|i~Cq@D|9B@fbNtCH3_
z!X8i2D&e{Wo!zN=j^e9Pq8idp;Dr>5)5*EdI#2*|(7e<ulF*7!H*e)A;70P{-{p}$
zf>W+al7K)$U8~l0p7t`4b&tX!#gAEK^|mDQZ8XsU$ZuM4UjaUK4-HEJ-Y1oXOAq^O
zd|b6~W*S|r8%V9Vo;u?_j-hoByvlRs6Yqr2iO>)@z0{_?qW;DAFfYY>P&RQ$)$n@v
z>UiA@%?0UvhTclMW7fdGZKj;Ap-^OGCfn)Ad|xy;hd{PfiBO1&ijm1h*eQ3$P7zX`
zvPy<!Z!vVr<@dF02QTbjl5RM-*-;lFgx6L#12bgxAHxpx0yEC>lAH3$uCvcyLt){v
z7!B!4npzcD0ueI1t&a=JHffFE3u^F{m1;kUc67VlA+#72htm|Y6f{A)b2Yt>34P{S
zG{TdMbT@cuYM2hdoIN-&v7cPK6k+E%X+aFG$4-H!#Yx}=ngqIZ0as$Pa5>?cuusBx
zy%D-C+H#Mvc|v7XBARzQgA3msy3H)G$ZoY@j#!`5nfY9Uw$$`hmhzi!n3J=~`MLc%
zbDHdC8kerYJY`_P!GsWZv~mVB$z)EZB+E{heg*J0yMuV`@D^7Mq-n*bq}s?0;~Wpm
ztzU6wvr=HS(Z&k;iupWvj>;A!;L$wxwB#xY#H!9z1uOm}(53&;2{GYz$d-Unvhgz}
ztv_aK3a7080~tF#CFMf;*mNnOLC?0oVOs2DYw{JZ(6WUeox3G7)&&x}vN@+L$9CxF
zpC_bqnN!@3JCY0vp|hJHZ~CIE-@g?Eya-Uu26g(sz(ie$%*wG&qav?xhU|fgt`+<9
z!E=N_G_DQc#erB=rGNEaHh>(sqz?`}XmHl;7K>QRLHVJRxHE&g@Q3Va9|&q5$PnN(
z*RrN&ZdXsYwxC2Qt8Py|3&iB@^LZNbrC;XU&zstnH=h$xy<0F2MZ<&14`A94oomFZ
zNKevw2DANzjo-UPZ3@90;!qxLaMdbI*wrezidR0&jYl*~X>PQ+dK{+>nI?Bdo4%8e
zq<I!+Hfp<w1s{piocXt8Efy}-F-e2zJUJ|x8<V%2$3*KO_~82#POD$%7Lpp^K;qJO
zk2?11xPZ1h1m#UQ28`ILFxRE@jFsDV#DhEe=6U;_T6!LBt;~$&WZghR+pd~|S97x*
zZVv7;V|`wopa1(#Wkb@1iQ&7i4B+zDZQr>J>*h$VgrZ^g`Ibwg2tO!9c51xo<gubj
zX32bx9j=c{h%761_;x=r7_U|}lC$_F<@Qa;W_%JNAhV!wb7&rT1z|(_D<T@K5L8%<
z;U|^JHkD9Tr;^w(=}EPmUP;?jNAv#GcmqlPONlsI_^!wePWDCJpHN-a=%KiC`Vdk}
zIn2Rz0X61Dos=X=c)@mvpfMblxJ2_aKoK&)JI`39N_ZD-TuzxW{oCu%5<731sy=ZD
zu+)omEuYp-X&1ZS&#q=P@Rf*1e8v^`3OE5*f7m~B6x-1>SeloT$|D=OeVy;s!vioF
z={v^9>EjmNm!V;ApSDz2MhtYB=^j;*Avu!|LPcXQbb6woS!nkz<&VeU>_t&ZEB}iH
zvGz((V1P|#TDehU0P0n_Bo|<WjST#ksK={PlvY4$)f)UOx!3Dl0xzimljjMBP&4J-
zxS6C{-rj+qHG&wzaA#@IXXq#<Ke`=nb0>earBYC&P!CpbT!KN(%CCCU|I{Xh05b|_
zgqj@qeI+j<GOABz_QEr?=<S>9{<123(Yo}uWt%f~6-qKU6bw&5mw;g`N$OH*<MRZ+
zu|O!?S}$}G%7VIL=+@+fp5jOvXS_Zf=1l$c4oXdzG4s8!wT3jAS%oo@gK%VN>8ILm
zs2{KN2QfNMIee|2y@BhzY}DP2T7(BWmixa~NlfnILeuBs#Yy9^Ytze(c_|aa_mkYz
zb6|lLlttV*jaceNUa)3nYX706Aflm<*d)IN|HJaUKeP<)ePPF;DAy!f=FrV-7+eL3
z&VSBtQ5F$@M;A^&V1+lfB=E&>V4SfVnjvV>%*vEFG_^vM2~~>}vxM8Z@o&+-M|INK
z0;#Z4VH35kp$ydiafwZo!cTMS?zEl>--*Bgzdz58jSBqclz9lrND0%15<-4O@q<Rx
z?pwBkA<NW&drZqy^{At6+LhvyD*{4#ZS^}|*l^Xp1)A%YPQET$$3vKGHM15mK^`{B
za|lAL>s>xCLpTPI0)6KEufm~henv=PIk1RJ5iU8@kXU5ClVdf<wLx@S$lqv!SSTgr
zpufsVHZ*Gqt5%<US7TBO>}cJBZY#4u50D08;Bi<_B~ym?a#KFWC0il$aeb6CI6)G$
z)`f2*Wel&uXRsxT%KQ-tV0U%aP)1G0>vG+WQ_?W!bSsYAWg^yp@NYo|?2So^<!I3Z
zSy`K{5_fGRH`dhmz<hIYqn_0y<rC!w;r_;3mp#$O#Wyu2AkAMl$bn<>PR-fcclnu?
zi`k6!D8cBST(9;NPNCjFLIeGtn(1)rA%o#EP~jSI#+T>1Lau&j7!uS{X|k{%pN9i_
z2dj-!g;T-Ya+C-YWNZnbMgm4f+<5O5{9jq&;cAm6U4u42=4FP#)?~7t73|iGJ!bJ6
zA;TTX)qajzld4b3L^BxJJTRMw%`7ZcSDJ0ZHz#bP#8bm!hUzwyCvKgchen-9?~C++
z&eRc`J>V8VD4J03=_+VBoFY@_^PwMGc0ByL@`M5ca4s*-f*G7@;Rq~}2NjFFvi#@(
z#*~P5fQBkg0n{(!nP-QOyJzzE*QSFc*cFb}n+7g)mkOhijYKcvk`=uMoU^Tp3TR97
zGfh9$(8;>^rWNi$*c8A*B)ZF(&)WewJx{d5!da2Bxxz7qW@O;OQN{(|hzn)Rr+8&4
zlG^~ab7?jvZxRC4f5*aCGA+fHPaH$102gkjYHPwf&#nnB?O)+ZQW|Hm$9+uP)F4zL
ziqz%cmlSbu!K+D4fE87qr$m7Ef&3CU#)TI(flh_Ush6T~R6MZMGR~GPngkjZw?8OT
z@_p8lQ$jS^8OgY3C~&bN_mX+`kfG8N!2PwlSHuLr3FDF*{fuUjDl9RrU7^Jl>l`y~
zK_qeI#Co<CJTuks#b-`Kel-?r*bCW2bva`$Puh3@JzOb8sCx&&T4S~~^lrAbdYErk
z8v*Vs8p1``qjCB3{oJPQdgeeeWdHConUuO>G#tD32I^{okaA?GkCPS2SH=>+MdAC~
z0*^>I%mhxcTTC1E-^IaKWX3QC2PMw6n0h&kSxI;6pmFQ3!qt@pwQx{3S@8lxZ{U1g
z&L2q0F8+`M>FE~VYN>h-?KU2VbUV&v5{cDHV6N0jB;xvTtbgKOrq&yk_@V|@*L(r$
zPY(G&+fd`H3juW##!P}3=Yobc{;^H#GgvVKK}t;|D1V2Av^sH)e#SqLc~%2l5*PWj
zJHrURW_$r`YeW52{0r(Kg%=YRS@QGrSNuZ*?!g-U&4{5RO&wS~G>5q1Vc6)35yJ_k
z1jyntP3#~QGdqSk?DW*%!(T*)v9R-1;OpJZ!bw51Ew$F=2zlAQmsiV&vR=sbq5;d*
z>4igZfhV*D#!H6OkC{h<GlA2<>}E~ElYuDEv&Cs^z*mlQDT9C1jK&t0|KfKPuyNf`
z!#ssAZCw&_U8Wt+d0pIU>PbP&_Is&Zn#~Eh?}{Y*PM41qQ4kS`s3-Tm8v&`>MriVV
zjMANx)vax>fZi6wICqRg75G<-1}tWxvfm22`gocR>R8cP8E&;W(Q1)8G`}Sx9DSsl
zF^?5e8+R|BA6ay}vPV*D52Xa6keHvQACP{zX>9J{ZmJsf3d_dHHE7?H1+gy3AZtUp
zu%0S3<ML4RUchZ4FXJay|GI8Jy$3dOMzX`Nz<BBA4CQZu($qiMnr;MY;cV%b<p8_3
z9s22#3ey{n>5k<}>As7(=Oh@Zl^WS7$Fk`2##pQ&OE!7Rpm*CzSSln9X~MNKRW2Vi
zVbWlrk~4Udj{5!h8f2D#6>nfzsH%pL2AXLJv{N&FgGein2Cnp{U|Jr)9nagzNw6Tw
zD=5^5f@RDN&mS3Zx1Uv0ih%G2=A<T@*h0R?f)%d2>u9d7W80uYxywbS+^XE=5Ro5Q
z+F|#_FEY`8Q~Vi(w~(y|3kXP8_RWYv>eJFZ6y%#bm|lAy(BMx$9xT+yJH|_t5%8;q
z!}m!@L3GT<!7{Q_T^4q#TLD@MWmGvrga~-87r67`)9GgfM_|hNHv1&tPC}D5=E%`f
zRl*b<eQ_5rm8Z>{qAvgVxlY`hJTRGL=~A6986?-S#BKP{7wLAMwPx2_Rw+$}H$NIr
zHROu@?=b~=f5_)^t(3-K&lkt5*8<rC5{c?%97GH8MMO(I2&G-VJ48lo-I7MdxY9MC
zL92KFY$zwlaD&DY<?l5Px-pF~jc1KBT+3!RBku>bFx+m&L`-TZUu}F4pBjF!v!Md}
zUi4)Wtqv>j<;yF!LxBVS8Jqal(Kco~62+=Icn8t*J&Iw%*Dz(&X-2u1=z^bR;B2tR
zREJKYbt!yE+Jxt;i`HsyZ$^7g>tDIizSkz+*<Lztijh((fl<1nlTZrPz(|@JV)yM?
zd*IZ6cinihXpL3zD?VDPf1WTH163&A=1dP!j%47Aq}w@~<uqpBL^b<gHk1~(B8d1H
zrT7@p<PgTXk2i5M|F*d#Z2of$nz{Q`%tK6CO1q*B<A2{D@aoCRKGwo^^ZDbipx_7n
zFMi;k-p*0JS?KSY<F^PUpG~aR7R`}AjN>MN%ls0<EynZxiaz>H;9&0#F9yy9(x$*@
z{_GM>l8*UQW)b_xc^OTsr!{tXDt${8%-ictw@t(zCy9vvK54UKkjZm(j~QAz-WuYR
z?)viDb=z&O#gIwWA?>`j>x2&bYz(5fKT|tLmgy!Z79RcPhmKqrxr0v1^LSKb*S``I
z=7=uUc_}2G2|PNfTPY6mkcYH{$!<J3fBoGIc2@RjU2s!zkvP64qMZgbX~C=%*T6UW
zy8*CnK{xYWD&I6ZukmXlj%>5R`ApE($RnIMpk1ZomO#m)KWc65oS0lZfIp+JFWShh
z`eU}qs|V*i0zd0wS}Oue_+|H$MKm2H5xgpiYy#a?WCYDp-0F*!T1IW!dfVTN4mQ%=
zc%%DBr4*kY05hy%Bs>AhQ5Oc5us-0Fz@;@7clf&@mX!Z0n+fhCsEK)pC1=pa>tY-`
zzo`{~S3~Q601vaPx*+<KuK%vj%?ZJ(r@~G~Fzs{Qto>Bp5)Dg|D_~a62DMSK&QKE6
z!IqSOjk=28$@BjO@&OJ0)7!l4h>?<_O?yIp+QKHbBJrsKC&zS^EXNFZ=N%k<Pa;RG
zprrQ>GX@T;G1i@Xl{RTaBVHTf1!t)K5{-`!RS&RpsO6lkY-q#A9AU6M+q3K4s%itl
zs!*D{m>vl^Z?lWE`;&&YLU2BkY?J1$mzEnr7{kLO3Z!M$#}=V`B%)Y%zWvI{IZ4>?
zD`*-jT7aVm0DAtBR86t^v=jkWiY+#xI~CJsAVlsgM>*iVX3T;#CqjHYbWQ|T@Yzhf
z!2bpxtA`@{+5&iob|{u&$XJ7AR`n--zK`(#tjTh<)N}j5GcF0WnTYGewli6V-j40J
zY`U?zctqe>IJJz!HGVcr9~T`sI3U<@KYnY&HX0D52DBU3mFI#x*sCbrTlRdUggDyO
z8!=X)+Q%j9hli<g6WRJQ%wGuHX-JqIt)oC8JsxAd2;&GkbsJQrFceyE?enP}$nrzH
z?oaBSXndxxbNn91C-nG@P8FuANzZ~HsU}d6k_Dg-YL{T|%*PS-TU~k;0hTcB6VI-)
z1)M|eoMu8=HZu0H4lK>ZZ!FNsg>oc*TMnn;MaTcWNt~4UH<SvCD44Uq`dM^M%_4Nk
xp}(bn2=|L2=)Wwi%c<f-Zz8A|?`e{Ow5xF}aIv{TxL#zcZ@HyuoXsnwPe6vBtMLE;

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot2mir1.avif b/Tests/images/avif/rot2mir1.avif
new file mode 100644
index 0000000000000000000000000000000000000000..63326b86caaace19a75cd50d3ad0738f34abb4c5
GIT binary patch
literal 16387
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
Dfy`<9

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot3mir0.avif b/Tests/images/avif/rot3mir0.avif
new file mode 100644
index 0000000000000000000000000000000000000000..ed5dbe3d0bbccaba854491e2388cd1b17e85a3c0
GIT binary patch
literal 16568
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

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/rot3mir1.avif b/Tests/images/avif/rot3mir1.avif
new file mode 100644
index 0000000000000000000000000000000000000000..ccd8861d5ae9378bcb6613f6391f2c4270c5f706
GIT binary patch
literal 17290
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
Wb@)m5lH#=Xog|^q0i|nHm>l5F0VLi4

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/star.avifs b/Tests/images/avif/star.avifs
new file mode 100644
index 0000000000000000000000000000000000000000..f2753395f8c3c131267eb4d1846ca9a21a6a47a3
GIT binary patch
literal 29724
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
IsdR<=FV<&Sp#T5?

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/star.gif b/Tests/images/avif/star.gif
new file mode 100644
index 0000000000000000000000000000000000000000..52076cafdd8fae464c10404ab23e4a9645850091
GIT binary patch
literal 2900
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
LiMQPx1kn2r>+_G5

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/star.png b/Tests/images/avif/star.png
new file mode 100644
index 0000000000000000000000000000000000000000..468dcde005da39fc6807cfda46036dc78a1efe1c
GIT binary patch
literal 3844
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
GLSTY?&Syga

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/transparency.avif b/Tests/images/avif/transparency.avif
new file mode 100644
index 0000000000000000000000000000000000000000..f808357fc7c51828bdd627b9394f181be20a301c
GIT binary patch
literal 6441
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
EAFoQ}(f|Me

literal 0
HcmV?d00001

diff --git a/Tests/images/avif/xmp_tags_orientation.avif b/Tests/images/avif/xmp_tags_orientation.avif
new file mode 100644
index 0000000000000000000000000000000000000000..41faa60501be25947808e8376f1224aca9407538
GIT binary patch
literal 6686
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
CD~X2y

literal 0
HcmV?d00001

diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
new file mode 100644
index 00000000000..392a4bbd5b0
--- /dev/null
+++ b/Tests/test_file_avif.py
@@ -0,0 +1,778 @@
+from __future__ import annotations
+
+import gc
+import os
+import re
+import warnings
+from collections.abc import Generator, Sequence
+from contextlib import contextmanager
+from io import BytesIO
+from pathlib import Path
+from typing import Any
+
+import pytest
+
+from PIL import (
+    AvifImagePlugin,
+    Image,
+    ImageDraw,
+    ImageFile,
+    UnidentifiedImageError,
+    features,
+)
+
+from .helper import (
+    PillowLeakTestCase,
+    assert_image,
+    assert_image_similar,
+    assert_image_similar_tofile,
+    hopper,
+    skip_unless_feature,
+)
+
+try:
+    from PIL import _avif
+
+    HAVE_AVIF = True
+except ImportError:
+    HAVE_AVIF = False
+
+
+TEST_AVIF_FILE = "Tests/images/avif/hopper.avif"
+
+
+def assert_xmp_orientation(xmp: bytes, expected: int) -> None:
+    assert int(xmp.split(b'tiff:Orientation="')[1].split(b'"')[0]) == expected
+
+
+def roundtrip(im: ImageFile.ImageFile, **options: Any) -> ImageFile.ImageFile:
+    out = BytesIO()
+    im.save(out, "AVIF", **options)
+    return Image.open(out)
+
+
+def skip_unless_avif_decoder(codec_name: str) -> pytest.MarkDecorator:
+    reason = f"{codec_name} decode not available"
+    return pytest.mark.skipif(
+        not HAVE_AVIF or not _avif.decoder_codec_available(codec_name), reason=reason
+    )
+
+
+def skip_unless_avif_encoder(codec_name: str) -> pytest.MarkDecorator:
+    reason = f"{codec_name} encode not available"
+    return pytest.mark.skipif(
+        not HAVE_AVIF or not _avif.encoder_codec_available(codec_name), reason=reason
+    )
+
+
+def is_docker_qemu() -> bool:
+    try:
+        init_proc_exe = os.readlink("/proc/1/exe")
+    except (FileNotFoundError, PermissionError):
+        return False
+    return "qemu" in init_proc_exe
+
+
+class TestUnsupportedAvif:
+    def test_unsupported(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(AvifImagePlugin, "SUPPORTED", False)
+
+        with pytest.warns(UserWarning):
+            with pytest.raises(UnidentifiedImageError):
+                with Image.open(TEST_AVIF_FILE):
+                    pass
+
+    def test_unsupported_open(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(AvifImagePlugin, "SUPPORTED", False)
+
+        with pytest.raises(SyntaxError):
+            AvifImagePlugin.AvifImageFile(TEST_AVIF_FILE)
+
+
+@skip_unless_feature("avif")
+class TestFileAvif:
+    def test_version(self) -> None:
+        version = features.version_module("avif")
+        assert version is not None
+        assert re.search(r"^\d+\.\d+\.\d+$", version)
+
+    def test_codec_version(self) -> None:
+        assert AvifImagePlugin.get_codec_version("unknown") is None
+
+        for codec_name in ("aom", "dav1d", "rav1e", "svt"):
+            codec_version = AvifImagePlugin.get_codec_version(codec_name)
+            if _avif.decoder_codec_available(
+                codec_name
+            ) or _avif.encoder_codec_available(codec_name):
+                assert codec_version is not None
+                assert re.search(r"^v?\d+\.\d+\.\d+(-([a-z\d])+)*$", codec_version)
+            else:
+                assert codec_version is None
+
+    def test_read(self) -> None:
+        """
+        Can we read an AVIF file without error?
+        Does it have the bits we expect?
+        """
+
+        with Image.open(TEST_AVIF_FILE) as image:
+            assert image.mode == "RGB"
+            assert image.size == (128, 128)
+            assert image.format == "AVIF"
+            assert image.get_format_mimetype() == "image/avif"
+            image.getdata()
+
+            # generated with:
+            # avifdec hopper.avif hopper_avif_write.png
+            assert_image_similar_tofile(
+                image, "Tests/images/avif/hopper_avif_write.png", 11.5
+            )
+
+    def test_write_rgb(self, tmp_path: Path) -> None:
+        """
+        Can we write a RGB mode file to avif without error?
+        Does it have the bits we expect?
+        """
+
+        temp_file = tmp_path / "temp.avif"
+
+        im = hopper()
+        im.save(temp_file)
+        with Image.open(temp_file) as reloaded:
+            assert reloaded.mode == "RGB"
+            assert reloaded.size == (128, 128)
+            assert reloaded.format == "AVIF"
+            reloaded.getdata()
+
+            # avifdec hopper.avif avif/hopper_avif_write.png
+            assert_image_similar_tofile(
+                reloaded, "Tests/images/avif/hopper_avif_write.png", 6.02
+            )
+
+            # This test asserts that the images are similar. If the average pixel
+            # difference between the two images is less than the epsilon value,
+            # then we're going to accept that it's a reasonable lossy version of
+            # the image.
+            assert_image_similar(reloaded, im, 8.62)
+
+    def test_AvifEncoder_with_invalid_args(self) -> None:
+        """
+        Calling encoder functions with no arguments should result in an error.
+        """
+        with pytest.raises(TypeError):
+            _avif.AvifEncoder()
+
+    def test_AvifDecoder_with_invalid_args(self) -> None:
+        """
+        Calling decoder functions with no arguments should result in an error.
+        """
+        with pytest.raises(TypeError):
+            _avif.AvifDecoder()
+
+    def test_invalid_dimensions(self, tmp_path: Path) -> None:
+        test_file = tmp_path / "temp.avif"
+        im = Image.new("RGB", (0, 0))
+        with pytest.raises(ValueError):
+            im.save(test_file)
+
+    def test_encoder_finish_none_error(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
+        """Save should raise an OSError if AvifEncoder.finish returns None"""
+
+        class _mock_avif:
+            class AvifEncoder:
+                def __init__(self, *args: Any) -> None:
+                    pass
+
+                def add(self, *args: Any) -> None:
+                    pass
+
+                def finish(self) -> None:
+                    return None
+
+        monkeypatch.setattr(AvifImagePlugin, "_avif", _mock_avif)
+
+        im = Image.new("RGB", (150, 150))
+        test_file = tmp_path / "temp.avif"
+        with pytest.raises(OSError):
+            im.save(test_file)
+
+    def test_no_resource_warning(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            with warnings.catch_warnings():
+                warnings.simplefilter("error")
+
+                im.save(tmp_path / "temp.avif")
+
+    @pytest.mark.parametrize("major_brand", [b"avif", b"avis", b"mif1", b"msf1"])
+    def test_accept_ftyp_brands(self, major_brand: bytes) -> None:
+        data = b"\x00\x00\x00\x1cftyp%s\x00\x00\x00\x00" % major_brand
+        assert AvifImagePlugin._accept(data) is True
+
+    def test_file_pointer_could_be_reused(self) -> None:
+        with open(TEST_AVIF_FILE, "rb") as blob:
+            with Image.open(blob) as im:
+                im.load()
+            with Image.open(blob) as im:
+                im.load()
+
+    def test_background_from_gif(self, tmp_path: Path) -> None:
+        with Image.open("Tests/images/chi.gif") as im:
+            original_value = im.convert("RGB").getpixel((1, 1))
+
+            # Save as AVIF
+            out_avif = tmp_path / "temp.avif"
+            im.save(out_avif, save_all=True)
+
+        # Save as GIF
+        out_gif = tmp_path / "temp.gif"
+        with Image.open(out_avif) as im:
+            im.save(out_gif)
+
+        with Image.open(out_gif) as reread:
+            reread_value = reread.convert("RGB").getpixel((1, 1))
+        difference = sum([abs(original_value[i] - reread_value[i]) for i in range(3)])
+        assert difference <= 3
+
+    def test_save_single_frame(self, tmp_path: Path) -> None:
+        temp_file = tmp_path / "temp.avif"
+        with Image.open("Tests/images/chi.gif") as im:
+            im.save(temp_file)
+        with Image.open(temp_file) as im:
+            assert im.n_frames == 1
+
+    def test_invalid_file(self) -> None:
+        invalid_file = "Tests/images/flower.jpg"
+
+        with pytest.raises(SyntaxError):
+            AvifImagePlugin.AvifImageFile(invalid_file)
+
+    def test_load_transparent_rgb(self) -> None:
+        test_file = "Tests/images/avif/transparency.avif"
+        with Image.open(test_file) as im:
+            assert_image(im, "RGBA", (64, 64))
+
+            # image has 876 transparent pixels
+            assert im.getchannel("A").getcolors()[0] == (876, 0)
+
+    def test_save_transparent(self, tmp_path: Path) -> None:
+        im = Image.new("RGBA", (10, 10), (0, 0, 0, 0))
+        assert im.getcolors() == [(100, (0, 0, 0, 0))]
+
+        test_file = tmp_path / "temp.avif"
+        im.save(test_file)
+
+        # check if saved image contains the same transparency
+        with Image.open(test_file) as im:
+            assert_image(im, "RGBA", (10, 10))
+            assert im.getcolors() == [(100, (0, 0, 0, 0))]
+
+    def test_save_icc_profile(self) -> None:
+        with Image.open("Tests/images/avif/icc_profile_none.avif") as im:
+            assert "icc_profile" not in im.info
+
+            with Image.open("Tests/images/avif/icc_profile.avif") as with_icc:
+                expected_icc = with_icc.info["icc_profile"]
+                assert expected_icc is not None
+
+                im = roundtrip(im, icc_profile=expected_icc)
+                assert im.info["icc_profile"] == expected_icc
+
+    def test_discard_icc_profile(self) -> None:
+        with Image.open("Tests/images/avif/icc_profile.avif") as im:
+            im = roundtrip(im, icc_profile=None)
+        assert "icc_profile" not in im.info
+
+    def test_roundtrip_icc_profile(self) -> None:
+        with Image.open("Tests/images/avif/icc_profile.avif") 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) -> None:
+        with Image.open("Tests/images/avif/icc_profile_none.avif") as im:
+            assert "icc_profile" not in im.info
+
+            im = roundtrip(im)
+        assert "icc_profile" not in im.info
+
+    def test_exif(self) -> None:
+        # With an EXIF chunk
+        with Image.open("Tests/images/avif/exif.avif") as im:
+            exif = im.getexif()
+        assert exif[274] == 1
+
+        with Image.open("Tests/images/avif/xmp_tags_orientation.avif") as im:
+            exif = im.getexif()
+        assert exif[274] == 3
+
+    @pytest.mark.parametrize("use_bytes", [True, False])
+    @pytest.mark.parametrize("orientation", [1, 2])
+    def test_exif_save(
+        self,
+        tmp_path: Path,
+        use_bytes: bool,
+        orientation: int,
+    ) -> None:
+        exif = Image.Exif()
+        exif[274] = orientation
+        exif_data = exif.tobytes()
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            im.save(test_file, exif=exif_data if use_bytes else exif)
+
+        with Image.open(test_file) as reloaded:
+            if orientation == 1:
+                assert "exif" not in reloaded.info
+            else:
+                assert reloaded.info["exif"] == exif_data
+
+    def test_exif_without_orientation(self, tmp_path: Path) -> None:
+        exif = Image.Exif()
+        exif[272] = b"test"
+        exif_data = exif.tobytes()
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            im.save(test_file, exif=exif)
+
+        with Image.open(test_file) as reloaded:
+            assert reloaded.info["exif"] == exif_data
+
+    def test_exif_invalid(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            with pytest.raises(SyntaxError):
+                im.save(test_file, exif=b"invalid")
+
+    @pytest.mark.parametrize(
+        "rot, mir, exif_orientation",
+        [
+            (0, 0, 4),
+            (0, 1, 2),
+            (1, 0, 5),
+            (1, 1, 7),
+            (2, 0, 2),
+            (2, 1, 4),
+            (3, 0, 7),
+            (3, 1, 5),
+        ],
+    )
+    def test_rot_mir_exif(
+        self, rot: int, mir: int, exif_orientation: int, tmp_path: Path
+    ) -> None:
+        with Image.open(f"Tests/images/avif/rot{rot}mir{mir}.avif") as im:
+            exif = im.getexif()
+            assert exif[274] == exif_orientation
+
+            test_file = tmp_path / "temp.avif"
+            im.save(test_file, exif=exif)
+        with Image.open(test_file) as reloaded:
+            assert reloaded.getexif()[274] == exif_orientation
+
+    def test_xmp(self) -> None:
+        with Image.open("Tests/images/avif/xmp_tags_orientation.avif") as im:
+            xmp = im.info["xmp"]
+        assert_xmp_orientation(xmp, 3)
+
+    def test_xmp_save(self, tmp_path: Path) -> None:
+        xmp_arg = "\n".join(
+            [
+                '<?xpacket begin="" id="W5M0MpCehiHzreSzNTczkc9d"?>',
+                '<x:xmpmeta xmlns:x="adobe:ns:meta/">',
+                ' <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#">',
+                '  <rdf:Description rdf:about=""',
+                '    xmlns:tiff="http://ns.adobe.com/tiff/1.0/"',
+                '   tiff:Orientation="1"/>',
+                " </rdf:RDF>",
+                "</x:xmpmeta>",
+                '<?xpacket end="r"?>',
+            ]
+        )
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            im.save(test_file, xmp=xmp_arg)
+
+        with Image.open(test_file) as reloaded:
+            xmp = reloaded.info["xmp"]
+        assert_xmp_orientation(xmp, 1)
+
+    def test_tell(self) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            assert im.tell() == 0
+
+    def test_seek(self) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            im.seek(0)
+
+            with pytest.raises(EOFError):
+                im.seek(1)
+
+    @pytest.mark.parametrize("subsampling", ["4:4:4", "4:2:2", "4:2:0", "4:0:0"])
+    def test_encoder_subsampling(self, tmp_path: Path, subsampling: str) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            im.save(test_file, subsampling=subsampling)
+
+    def test_encoder_subsampling_invalid(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            with pytest.raises(ValueError):
+                im.save(test_file, subsampling="foo")
+
+    @pytest.mark.parametrize("value", ["full", "limited"])
+    def test_encoder_range(self, tmp_path: Path, value: str) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            im.save(test_file, range=value)
+
+    def test_encoder_range_invalid(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            with pytest.raises(ValueError):
+                im.save(test_file, range="foo")
+
+    @skip_unless_avif_encoder("aom")
+    def test_encoder_codec_param(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            im.save(test_file, codec="aom")
+
+    def test_encoder_codec_invalid(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            with pytest.raises(ValueError):
+                im.save(test_file, codec="foo")
+
+    @skip_unless_avif_decoder("dav1d")
+    def test_decoder_codec_cannot_encode(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            with pytest.raises(ValueError):
+                im.save(test_file, codec="dav1d")
+
+    @skip_unless_avif_encoder("aom")
+    @pytest.mark.parametrize(
+        "advanced",
+        [
+            {
+                "aq-mode": "1",
+                "enable-chroma-deltaq": "1",
+            },
+            (("aq-mode", "1"), ("enable-chroma-deltaq", "1")),
+            [("aq-mode", "1"), ("enable-chroma-deltaq", "1")],
+        ],
+    )
+    def test_encoder_advanced_codec_options(
+        self, advanced: dict[str, str] | Sequence[tuple[str, str]]
+    ) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            ctrl_buf = BytesIO()
+            im.save(ctrl_buf, "AVIF", codec="aom")
+            test_buf = BytesIO()
+            im.save(
+                test_buf,
+                "AVIF",
+                codec="aom",
+                advanced=advanced,
+            )
+            assert ctrl_buf.getvalue() != test_buf.getvalue()
+
+    @skip_unless_avif_encoder("aom")
+    @pytest.mark.parametrize("advanced", [{"foo": "bar"}, {"foo": 1234}, 1234])
+    def test_encoder_advanced_codec_options_invalid(
+        self, tmp_path: Path, advanced: dict[str, str] | int
+    ) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            with pytest.raises(ValueError):
+                im.save(test_file, codec="aom", advanced=advanced)
+
+    @skip_unless_avif_decoder("aom")
+    def test_decoder_codec_param(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(AvifImagePlugin, "DECODE_CODEC_CHOICE", "aom")
+
+        with Image.open(TEST_AVIF_FILE) as im:
+            assert im.size == (128, 128)
+
+    @skip_unless_avif_encoder("rav1e")
+    def test_encoder_codec_cannot_decode(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
+        monkeypatch.setattr(AvifImagePlugin, "DECODE_CODEC_CHOICE", "rav1e")
+
+        with pytest.raises(ValueError):
+            with Image.open(TEST_AVIF_FILE):
+                pass
+
+    def test_decoder_codec_invalid(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(AvifImagePlugin, "DECODE_CODEC_CHOICE", "foo")
+
+        with pytest.raises(ValueError):
+            with Image.open(TEST_AVIF_FILE):
+                pass
+
+    @skip_unless_avif_encoder("aom")
+    def test_encoder_codec_available(self) -> None:
+        assert _avif.encoder_codec_available("aom") is True
+
+    def test_encoder_codec_available_bad_params(self) -> None:
+        with pytest.raises(TypeError):
+            _avif.encoder_codec_available()
+
+    @skip_unless_avif_decoder("dav1d")
+    def test_encoder_codec_available_cannot_decode(self) -> None:
+        assert _avif.encoder_codec_available("dav1d") is False
+
+    def test_encoder_codec_available_invalid(self) -> None:
+        assert _avif.encoder_codec_available("foo") is False
+
+    def test_encoder_quality_valueerror(self, tmp_path: Path) -> None:
+        with Image.open(TEST_AVIF_FILE) as im:
+            test_file = tmp_path / "temp.avif"
+            with pytest.raises(ValueError):
+                im.save(test_file, quality="invalid")
+
+    @skip_unless_avif_decoder("aom")
+    def test_decoder_codec_available(self) -> None:
+        assert _avif.decoder_codec_available("aom") is True
+
+    def test_decoder_codec_available_bad_params(self) -> None:
+        with pytest.raises(TypeError):
+            _avif.decoder_codec_available()
+
+    @skip_unless_avif_encoder("rav1e")
+    def test_decoder_codec_available_cannot_decode(self) -> None:
+        assert _avif.decoder_codec_available("rav1e") is False
+
+    def test_decoder_codec_available_invalid(self) -> None:
+        assert _avif.decoder_codec_available("foo") is False
+
+    def test_p_mode_transparency(self, tmp_path: Path) -> None:
+        im = Image.new("P", size=(64, 64))
+        draw = ImageDraw.Draw(im)
+        draw.rectangle(xy=[(0, 0), (32, 32)], fill=255)
+        draw.rectangle(xy=[(32, 32), (64, 64)], fill=255)
+
+        out_png = tmp_path / "temp.png"
+        im.save(out_png, transparency=0)
+        with Image.open(out_png) as im_png:
+            out_avif = tmp_path / "temp.avif"
+            im_png.save(out_avif, quality=100)
+
+            with Image.open(out_avif) as expected:
+                assert_image_similar(im_png.convert("RGBA"), expected, 0.17)
+
+    def test_decoder_strict_flags(self) -> None:
+        # This would fail if full avif strictFlags were enabled
+        with Image.open("Tests/images/avif/hopper-missing-pixi.avif") as im:
+            assert im.size == (128, 128)
+
+    @skip_unless_avif_encoder("aom")
+    @pytest.mark.parametrize("speed", [-1, 1, 11])
+    def test_aom_optimizations(self, tmp_path: Path, speed: int) -> None:
+        test_file = tmp_path / "temp.avif"
+        hopper().save(test_file, codec="aom", speed=speed)
+
+    @skip_unless_avif_encoder("svt")
+    def test_svt_optimizations(self, tmp_path: Path) -> None:
+        test_file = tmp_path / "temp.avif"
+        hopper().save(test_file, codec="svt", speed=1)
+
+
+@skip_unless_feature("avif")
+class TestAvifAnimation:
+    @contextmanager
+    def star_frames(self) -> Generator[list[Image.Image], None, None]:
+        with Image.open("Tests/images/avif/star.png") as f:
+            yield [f, f.rotate(90), f.rotate(180), f.rotate(270)]
+
+    def test_n_frames(self) -> None:
+        """
+        Ensure that AVIF format sets n_frames and is_animated attributes
+        correctly.
+        """
+
+        with Image.open(TEST_AVIF_FILE) as im:
+            assert im.n_frames == 1
+            assert not im.is_animated
+
+        with Image.open("Tests/images/avif/star.avifs") as im:
+            assert im.n_frames == 5
+            assert im.is_animated
+
+    def test_write_animation_P(self, tmp_path: Path) -> None:
+        """
+        Convert an animated GIF to animated AVIF, then compare the frame
+        count, and ensure the frames are visually similar to the originals.
+        """
+
+        with Image.open("Tests/images/avif/star.gif") as original:
+            assert original.n_frames > 1
+
+            temp_file = tmp_path / "temp.avif"
+            original.save(temp_file, save_all=True)
+            with Image.open(temp_file) as im:
+                assert im.n_frames == original.n_frames
+
+                # Compare first frame in P mode to frame from original GIF
+                assert_image_similar(im, original.convert("RGBA"), 2)
+
+                # Compare later frames in RGBA mode to frames from original GIF
+                for frame in range(1, original.n_frames):
+                    original.seek(frame)
+                    im.seek(frame)
+                    assert_image_similar(im, original, 2.54)
+
+    def test_write_animation_RGBA(self, tmp_path: Path) -> None:
+        """
+        Write an animated AVIF from RGBA frames, and ensure the frames
+        are visually similar to the originals.
+        """
+
+        def check(temp_file: Path) -> None:
+            with Image.open(temp_file) as im:
+                assert im.n_frames == 4
+
+                # Compare first frame to original
+                assert_image_similar(im, frame1, 2.7)
+
+                # Compare second frame to original
+                im.seek(1)
+                assert_image_similar(im, frame2, 4.1)
+
+        with self.star_frames() as frames:
+            frame1 = frames[0]
+            frame2 = frames[1]
+            temp_file1 = tmp_path / "temp.avif"
+            frames[0].copy().save(temp_file1, save_all=True, append_images=frames[1:])
+            check(temp_file1)
+
+            # Test appending using a generator
+            def imGenerator(
+                ims: list[Image.Image],
+            ) -> Generator[Image.Image, None, None]:
+                yield from ims
+
+            temp_file2 = tmp_path / "temp_generator.avif"
+            frames[0].copy().save(
+                temp_file2,
+                save_all=True,
+                append_images=imGenerator(frames[1:]),
+            )
+            check(temp_file2)
+
+    def test_sequence_dimension_mismatch_check(self, tmp_path: Path) -> None:
+        temp_file = tmp_path / "temp.avif"
+        frame1 = Image.new("RGB", (100, 100))
+        frame2 = Image.new("RGB", (150, 150))
+        with pytest.raises(ValueError):
+            frame1.save(temp_file, save_all=True, append_images=[frame2])
+
+    def test_heif_raises_unidentified_image_error(self) -> None:
+        with pytest.raises(UnidentifiedImageError):
+            with Image.open("Tests/images/avif/hopper.heif"):
+                pass
+
+    @pytest.mark.parametrize("alpha_premultiplied", [False, True])
+    def test_alpha_premultiplied(
+        self, tmp_path: Path, alpha_premultiplied: bool
+    ) -> None:
+        temp_file = tmp_path / "temp.avif"
+        color = (200, 200, 200, 1)
+        im = Image.new("RGBA", (1, 1), color)
+        im.save(temp_file, alpha_premultiplied=alpha_premultiplied)
+
+        expected = (255, 255, 255, 1) if alpha_premultiplied else color
+        with Image.open(temp_file) as reloaded:
+            assert reloaded.getpixel((0, 0)) == expected
+
+    def test_timestamp_and_duration(self, tmp_path: Path) -> None:
+        """
+        Try passing a list of durations, and make sure the encoded
+        timestamps and durations are correct.
+        """
+
+        durations = [1, 10, 20, 30, 40]
+        temp_file = tmp_path / "temp.avif"
+        with self.star_frames() as frames:
+            frames[0].save(
+                temp_file,
+                save_all=True,
+                append_images=(frames[1:] + [frames[0]]),
+                duration=durations,
+            )
+
+        with Image.open(temp_file) as im:
+            assert im.n_frames == 5
+            assert im.is_animated
+
+            # Check that timestamps and durations match original values specified
+            timestamp = 0
+            for frame in range(im.n_frames):
+                im.seek(frame)
+                im.load()
+                assert im.info["duration"] == durations[frame]
+                assert im.info["timestamp"] == timestamp
+                timestamp += durations[frame]
+
+    def test_seeking(self, tmp_path: Path) -> None:
+        """
+        Create an animated AVIF file, and then try seeking through frames in
+        reverse-order, verifying the timestamps and durations are correct.
+        """
+
+        duration = 33
+        temp_file = tmp_path / "temp.avif"
+        with self.star_frames() as frames:
+            frames[0].save(
+                temp_file,
+                save_all=True,
+                append_images=(frames[1:] + [frames[0]]),
+                duration=duration,
+            )
+
+        with Image.open(temp_file) as im:
+            assert im.n_frames == 5
+            assert im.is_animated
+
+            # Traverse frames in reverse, checking timestamps and durations
+            timestamp = duration * (im.n_frames - 1)
+            for frame in reversed(range(im.n_frames)):
+                im.seek(frame)
+                im.load()
+                assert im.info["duration"] == duration
+                assert im.info["timestamp"] == timestamp
+                timestamp -= duration
+
+    def test_seek_errors(self) -> None:
+        with Image.open("Tests/images/avif/star.avifs") as im:
+            with pytest.raises(EOFError):
+                im.seek(-1)
+
+            with pytest.raises(EOFError):
+                im.seek(42)
+
+
+MAX_THREADS = os.cpu_count() or 1
+
+
+@skip_unless_feature("avif")
+class TestAvifLeaks(PillowLeakTestCase):
+    mem_limit = MAX_THREADS * 3 * 1024
+    iterations = 100
+
+    @pytest.mark.skipif(
+        is_docker_qemu(), reason="Skipping on cross-architecture containers"
+    )
+    def test_leak_load(self) -> None:
+        with open(TEST_AVIF_FILE, "rb") as f:
+            im_data = f.read()
+
+        def core() -> None:
+            with Image.open(BytesIO(im_data)) as im:
+                im.load()
+            gc.collect()
+
+        self._test_leak(core)
diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
new file mode 100755
index 00000000000..fc10d3e545c
--- /dev/null
+++ b/depends/install_libavif.sh
@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+set -eo pipefail
+
+version=1.2.1
+
+./download-and-extract.sh libavif-$version https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$version.tar.gz
+
+pushd libavif-$version
+
+if [ $(uname) == "Darwin" ] && [ -x "$(command -v brew)" ]; then
+    PREFIX=$(brew --prefix)
+else
+    PREFIX=/usr
+fi
+
+PKGCONFIG=${PKGCONFIG:-pkg-config}
+
+LIBAVIF_CMAKE_FLAGS=()
+HAS_DECODER=0
+HAS_ENCODER=0
+
+if $PKGCONFIG --exists aom; then
+    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_AOM=SYSTEM)
+    HAS_ENCODER=1
+    HAS_DECODER=1
+fi
+
+if $PKGCONFIG --exists dav1d; then
+    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_DAV1D=SYSTEM)
+    HAS_DECODER=1
+fi
+
+if $PKGCONFIG --exists libgav1; then
+    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_LIBGAV1=SYSTEM)
+    HAS_DECODER=1
+fi
+
+if $PKGCONFIG --exists rav1e; then
+    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_RAV1E=SYSTEM)
+    HAS_ENCODER=1
+fi
+
+if $PKGCONFIG --exists SvtAv1Enc; then
+    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_SVT=SYSTEM)
+    HAS_ENCODER=1
+fi
+
+if [ "$HAS_ENCODER" != 1 ] || [ "$HAS_DECODER" != 1 ]; then
+    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_AOM=LOCAL)
+fi
+
+cmake \
+    -DCMAKE_INSTALL_PREFIX=$PREFIX \
+    -DCMAKE_INSTALL_NAME_DIR=$PREFIX/lib \
+    -DCMAKE_BUILD_TYPE=Release \
+    -DCMAKE_MACOSX_RPATH=OFF \
+    -DAVIF_LIBSHARPYUV=LOCAL \
+    -DAVIF_LIBYUV=LOCAL \
+    "${LIBAVIF_CMAKE_FLAGS[@]}" \
+    .
+
+sudo make install
+
+popd
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index c0b1a9d4e84..bfa462c04c9 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -24,6 +24,83 @@ present, and the :py:attr:`~PIL.Image.Image.format` attribute will be ``None``.
 Fully supported formats
 -----------------------
 
+AVIF
+^^^^
+
+Pillow reads and writes AVIF files, including AVIF sequence images.
+It is only possible to save 8-bit AVIF images, and all AVIF images are decoded
+as 8-bit RGB(A).
+
+The :py:meth:`~PIL.Image.Image.save` method supports the following options:
+
+**quality**
+    Integer, 0-100, defaults to 75. 0 gives the smallest size and poorest
+    quality, 100 the largest size and best quality.
+
+**subsampling**
+    If present, sets the subsampling for the encoder. Defaults to ``4:2:0``.
+    Options include:
+
+    * ``4:0:0``
+    * ``4:2:0``
+    * ``4:2:2``
+    * ``4:4:4``
+
+**speed**
+    Quality/speed trade-off (0=slower/better, 10=fastest). Defaults to 6.
+
+**max_threads**
+    Limit the number of active threads used. By default, there is no limit. If the aom
+    codec is used, there is a maximum of 64.
+
+**range**
+    YUV range, either "full" or "limited". Defaults to "full".
+
+**codec**
+    AV1 codec to use for encoding. Specific values are "aom", "rav1e", and
+    "svt", presuming the chosen codec is available. Defaults to "auto", which
+    will choose the first available codec in the order of the preceding list.
+
+**tile_rows** / **tile_cols**
+    For tile encoding, the (log 2) number of tile rows and columns to use.
+    Valid values are 0-6, default 0. Ignored if "autotiling" is set to true.
+
+**autotiling**
+    Split the image up to allow parallelization. Enabled automatically if "tile_rows"
+    and "tile_cols" both have their default values of zero.
+
+**alpha_premultiplied**
+    Encode the image with premultiplied alpha. Defaults to ``False``.
+
+**advanced**
+    Codec specific options.
+
+**icc_profile**
+    The ICC Profile to include in the saved file.
+
+**exif**
+    The exif data to include in the saved file.
+
+**xmp**
+    The XMP data to include in the saved file.
+
+Saving sequences
+~~~~~~~~~~~~~~~~
+
+When calling :py:meth:`~PIL.Image.Image.save` to write an AVIF 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
+options will also be available.
+
+**append_images**
+    A list of images to append as additional frames. Each of the
+    images in the list can be single or multiframe images.
+
+**duration**
+    The display duration of each frame, in milliseconds. Pass a single
+    integer for a constant duration, or a list or tuple to set the
+    duration for each frame separately.
+
 BLP
 ^^^
 
@@ -242,7 +319,7 @@ following options are available::
 **append_images**
     A list of images to append as additional frames. Each of the
     images in the list can be single or multiframe images.
-    This is currently supported for GIF, PDF, PNG, TIFF, and WebP.
+    This is supported for AVIF, GIF, PDF, PNG, TIFF and WebP.
 
     It is also supported for ICO and ICNS. If images are passed in of relevant
     sizes, they will be used instead of scaling down the main image.
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 2790bc2e62c..9f953e718c3 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -89,6 +89,14 @@ Many of Pillow's features require external libraries:
 
 * **libxcb** provides X11 screengrab support.
 
+* **libavif** provides support for the AVIF format.
+
+  * Pillow requires libavif version **1.0.0** or greater.
+  * libavif is merely an API that wraps AVIF codecs. If you are compiling
+    libavif from source, you will also need to install both an AVIF encoder
+    and decoder, such as rav1e and dav1d, or libaom, which both encodes and
+    decodes AVIF images.
+
 .. tab:: Linux
 
     If you didn't build Python from source, make sure you have Python's
@@ -117,6 +125,12 @@ Many of Pillow's features require external libraries:
     To install libraqm, ``sudo apt-get install meson`` and then see
     ``depends/install_raqm.sh``.
 
+    Build prerequisites for libavif on Ubuntu are installed with::
+
+        sudo apt-get install cmake ninja-build nasm
+
+    Then see ``depends/install_libavif.sh`` to build and install libavif.
+
     Prerequisites are installed on recent **Red Hat**, **CentOS** or **Fedora** with::
 
         sudo dnf install libtiff-devel libjpeg-devel openjpeg2-devel zlib-devel \
@@ -148,7 +162,15 @@ Many of Pillow's features require external libraries:
     The easiest way to install external libraries is via `Homebrew
     <https://brew.sh/>`_. After you install Homebrew, run::
 
-        brew install libjpeg libraqm libtiff little-cms2 openjpeg webp
+        brew install libavif libjpeg libraqm libtiff little-cms2 openjpeg webp
+
+    If you would like to use libavif with more codecs than just aom, then
+    instead of installing libavif through Homebrew directly, you can use
+    Homebrew to install libavif's build dependencies::
+
+        brew install aom dav1d rav1e svt-av1
+
+    Then see ``depends/install_libavif.sh`` to install libavif.
 
 .. tab:: Windows
 
@@ -187,7 +209,8 @@ Many of Pillow's features require external libraries:
             mingw-w64-x86_64-libwebp \
             mingw-w64-x86_64-openjpeg2 \
             mingw-w64-x86_64-libimagequant \
-            mingw-w64-x86_64-libraqm
+            mingw-w64-x86_64-libraqm \
+            mingw-w64-x86_64-libavif
 
 .. tab:: FreeBSD
 
@@ -199,7 +222,7 @@ Many of Pillow's features require external libraries:
 
     Prerequisites are installed on **FreeBSD 10 or 11** with::
 
-        sudo pkg install jpeg-turbo tiff webp lcms2 freetype2 openjpeg harfbuzz fribidi libxcb
+        sudo pkg install jpeg-turbo tiff webp lcms2 freetype2 openjpeg harfbuzz fribidi libxcb libavif
 
     Then see ``depends/install_raqm_cmake.sh`` to install libraqm.
 
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index 0e173fe8785..c5d89b838d9 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -21,6 +21,7 @@ Support for the following modules can be checked:
 * ``freetype2``: FreeType font support via :py:func:`PIL.ImageFont.truetype`.
 * ``littlecms2``: LittleCMS 2 support via :py:mod:`PIL.ImageCms`.
 * ``webp``: WebP image support.
+* ``avif``: AVIF image support.
 
 .. autofunction:: PIL.features.check_module
 .. autofunction:: PIL.features.version_module
diff --git a/docs/reference/plugins.rst b/docs/reference/plugins.rst
index 454b94d8ce7..c789f575700 100644
--- a/docs/reference/plugins.rst
+++ b/docs/reference/plugins.rst
@@ -1,6 +1,14 @@
 Plugin reference
 ================
 
+:mod:`~PIL.AvifImagePlugin` Module
+----------------------------------
+
+.. automodule:: PIL.AvifImagePlugin
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 :mod:`~PIL.BmpImagePlugin` Module
 ---------------------------------
 
diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index d40d86f21a8..dbaa8a4a463 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -68,3 +68,12 @@ Compressed DDS images can now be saved using a ``pixel_format`` argument. DXT1,
 DXT5, BC2, BC3 and BC5 are supported::
 
     im.save("out.dds", pixel_format="DXT1")
+
+Other Changes
+=============
+
+Reading and writing AVIF images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Pillow can now read and write AVIF images. If you are building Pillow from source, this
+will require libavif 1.0.0 or later.
diff --git a/setup.py b/setup.py
index 9fac993b10b..9d69b1d6ea6 100644
--- a/setup.py
+++ b/setup.py
@@ -32,6 +32,7 @@ def get_version() -> str:
 
 
 PILLOW_VERSION = get_version()
+AVIF_ROOT = None
 FREETYPE_ROOT = None
 HARFBUZZ_ROOT = None
 FRIBIDI_ROOT = None
@@ -306,6 +307,7 @@ class ext_feature:
             "jpeg2000",
             "imagequant",
             "xcb",
+            "avif",
         ]
 
         required = {"jpeg", "zlib"}
@@ -481,6 +483,7 @@ def build_extensions(self) -> None:
         #
         # add configured kits
         for root_name, lib_name in {
+            "AVIF_ROOT": "avif",
             "JPEG_ROOT": "libjpeg",
             "JPEG2K_ROOT": "libopenjp2",
             "TIFF_ROOT": ("libtiff-5", "libtiff-4"),
@@ -846,6 +849,12 @@ def build_extensions(self) -> None:
                 if _find_library_file(self, "xcb"):
                     feature.set("xcb", "xcb")
 
+        if feature.want("avif"):
+            _dbg("Looking for avif")
+            if _find_include_file(self, "avif/avif.h"):
+                if _find_library_file(self, "avif"):
+                    feature.set("avif", "avif")
+
         for f in feature:
             if not feature.get(f) and feature.require(f):
                 if f in ("jpeg", "zlib"):
@@ -934,6 +943,14 @@ def build_extensions(self) -> None:
         else:
             self._remove_extension("PIL._webp")
 
+        if feature.get("avif"):
+            libs = [feature.get("avif")]
+            if sys.platform == "win32":
+                libs.extend(["ntdll", "userenv", "ws2_32", "bcrypt"])
+            self._update_extension("PIL._avif", libs)
+        else:
+            self._remove_extension("PIL._avif")
+
         tk_libs = ["psapi"] if sys.platform in ("win32", "cygwin") else []
         self._update_extension("PIL._imagingtk", tk_libs)
 
@@ -976,6 +993,7 @@ def summary_report(self, feature: ext_feature) -> None:
             (feature.get("lcms"), "LITTLECMS2"),
             (feature.get("webp"), "WEBP"),
             (feature.get("xcb"), "XCB (X protocol)"),
+            (feature.get("avif"), "LIBAVIF"),
         ]
 
         all = 1
@@ -1018,6 +1036,7 @@ def debug_build() -> bool:
     Extension("PIL._imagingft", ["src/_imagingft.c"]),
     Extension("PIL._imagingcms", ["src/_imagingcms.c"]),
     Extension("PIL._webp", ["src/_webp.c"]),
+    Extension("PIL._avif", ["src/_avif.c"]),
     Extension("PIL._imagingtk", ["src/_imagingtk.c", "src/Tk/tkImaging.c"]),
     Extension("PIL._imagingmath", ["src/_imagingmath.c"]),
     Extension("PIL._imagingmorph", ["src/_imagingmorph.c"]),
diff --git a/src/PIL/AvifImagePlugin.py b/src/PIL/AvifImagePlugin.py
new file mode 100644
index 00000000000..b2c5ab15d7e
--- /dev/null
+++ b/src/PIL/AvifImagePlugin.py
@@ -0,0 +1,292 @@
+from __future__ import annotations
+
+import os
+from io import BytesIO
+from typing import IO
+
+from . import ExifTags, Image, ImageFile
+
+try:
+    from . import _avif
+
+    SUPPORTED = True
+except ImportError:
+    SUPPORTED = False
+
+# Decoder options as module globals, until there is a way to pass parameters
+# to Image.open (see https://github.com/python-pillow/Pillow/issues/569)
+DECODE_CODEC_CHOICE = "auto"
+# Decoding is only affected by this for libavif **0.8.4** or greater.
+DEFAULT_MAX_THREADS = 0
+
+
+def get_codec_version(codec_name: str) -> str | None:
+    versions = _avif.codec_versions()
+    for version in versions.split(", "):
+        if version.split(" [")[0] == codec_name:
+            return version.split(":")[-1].split(" ")[0]
+    return None
+
+
+def _accept(prefix: bytes) -> bool | str:
+    if prefix[4:8] != b"ftyp":
+        return False
+    major_brand = prefix[8:12]
+    if major_brand in (
+        # coding brands
+        b"avif",
+        b"avis",
+        # We accept files with AVIF container brands; we can't yet know if
+        # the ftyp box has the correct compatible brands, but if it doesn't
+        # then the plugin will raise a SyntaxError which Pillow will catch
+        # before moving on to the next plugin that accepts the file.
+        #
+        # Also, because this file might not actually be an AVIF file, we
+        # don't raise an error if AVIF support isn't properly compiled.
+        b"mif1",
+        b"msf1",
+    ):
+        if not SUPPORTED:
+            return (
+                "image file could not be identified because AVIF support not installed"
+            )
+        return True
+    return False
+
+
+def _get_default_max_threads() -> int:
+    if DEFAULT_MAX_THREADS:
+        return DEFAULT_MAX_THREADS
+    if hasattr(os, "sched_getaffinity"):
+        return len(os.sched_getaffinity(0))
+    else:
+        return os.cpu_count() or 1
+
+
+class AvifImageFile(ImageFile.ImageFile):
+    format = "AVIF"
+    format_description = "AVIF image"
+    __frame = -1
+
+    def _open(self) -> None:
+        if not SUPPORTED:
+            msg = "image file could not be opened because AVIF support not installed"
+            raise SyntaxError(msg)
+
+        if DECODE_CODEC_CHOICE != "auto" and not _avif.decoder_codec_available(
+            DECODE_CODEC_CHOICE
+        ):
+            msg = "Invalid opening codec"
+            raise ValueError(msg)
+        self._decoder = _avif.AvifDecoder(
+            self.fp.read(),
+            DECODE_CODEC_CHOICE,
+            _get_default_max_threads(),
+        )
+
+        # Get info from decoder
+        self._size, self.n_frames, self._mode, icc, exif, exif_orientation, xmp = (
+            self._decoder.get_info()
+        )
+        self.is_animated = self.n_frames > 1
+
+        if icc:
+            self.info["icc_profile"] = icc
+        if xmp:
+            self.info["xmp"] = xmp
+
+        if exif_orientation != 1 or exif:
+            exif_data = Image.Exif()
+            if exif:
+                exif_data.load(exif)
+                original_orientation = exif_data.get(ExifTags.Base.Orientation, 1)
+            else:
+                original_orientation = 1
+            if exif_orientation != original_orientation:
+                exif_data[ExifTags.Base.Orientation] = exif_orientation
+                exif = exif_data.tobytes()
+        if exif:
+            self.info["exif"] = exif
+        self.seek(0)
+
+    def seek(self, frame: int) -> None:
+        if not self._seek_check(frame):
+            return
+
+        # Set tile
+        self.__frame = frame
+        self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, 0, self.mode)]
+
+    def load(self) -> Image.core.PixelAccess | None:
+        if self.tile:
+            # We need to load the image data for this frame
+            data, timescale, pts_in_timescales, duration_in_timescales = (
+                self._decoder.get_frame(self.__frame)
+            )
+            self.info["timestamp"] = round(1000 * (pts_in_timescales / timescale))
+            self.info["duration"] = round(1000 * (duration_in_timescales / timescale))
+
+            if self.fp and self._exclusive_fp:
+                self.fp.close()
+            self.fp = BytesIO(data)
+
+        return super().load()
+
+    def load_seek(self, pos: int) -> None:
+        pass
+
+    def tell(self) -> int:
+        return self.__frame
+
+
+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 | bytes, save_all: bool = False
+) -> None:
+    info = im.encoderinfo.copy()
+    if save_all:
+        append_images = list(info.get("append_images", []))
+    else:
+        append_images = []
+
+    total = 0
+    for ims in [im] + append_images:
+        total += getattr(ims, "n_frames", 1)
+
+    quality = info.get("quality", 75)
+    if not isinstance(quality, int) or quality < 0 or quality > 100:
+        msg = "Invalid quality setting"
+        raise ValueError(msg)
+
+    duration = info.get("duration", 0)
+    subsampling = info.get("subsampling", "4:2:0")
+    speed = info.get("speed", 6)
+    max_threads = info.get("max_threads", _get_default_max_threads())
+    codec = info.get("codec", "auto")
+    if codec != "auto" and not _avif.encoder_codec_available(codec):
+        msg = "Invalid saving codec"
+        raise ValueError(msg)
+    range_ = info.get("range", "full")
+    tile_rows_log2 = info.get("tile_rows", 0)
+    tile_cols_log2 = info.get("tile_cols", 0)
+    alpha_premultiplied = bool(info.get("alpha_premultiplied", False))
+    autotiling = bool(info.get("autotiling", tile_rows_log2 == tile_cols_log2 == 0))
+
+    icc_profile = info.get("icc_profile", im.info.get("icc_profile"))
+    exif_orientation = 1
+    if exif := info.get("exif"):
+        if isinstance(exif, Image.Exif):
+            exif_data = exif
+        else:
+            exif_data = Image.Exif()
+            exif_data.load(exif)
+        if ExifTags.Base.Orientation in exif_data:
+            exif_orientation = exif_data.pop(ExifTags.Base.Orientation)
+            exif = exif_data.tobytes() if exif_data else b""
+        elif isinstance(exif, Image.Exif):
+            exif = exif_data.tobytes()
+
+    xmp = info.get("xmp")
+
+    if isinstance(xmp, str):
+        xmp = xmp.encode("utf-8")
+
+    advanced = info.get("advanced")
+    if advanced is not None:
+        if isinstance(advanced, dict):
+            advanced = advanced.items()
+        try:
+            advanced = tuple(advanced)
+        except TypeError:
+            invalid = True
+        else:
+            invalid = any(not isinstance(v, tuple) or len(v) != 2 for v in advanced)
+        if invalid:
+            msg = (
+                "advanced codec options must be a dict of key-value string "
+                "pairs or a series of key-value two-tuples"
+            )
+            raise ValueError(msg)
+
+    # Setup the AVIF encoder
+    enc = _avif.AvifEncoder(
+        im.size,
+        subsampling,
+        quality,
+        speed,
+        max_threads,
+        codec,
+        range_,
+        tile_rows_log2,
+        tile_cols_log2,
+        alpha_premultiplied,
+        autotiling,
+        icc_profile or b"",
+        exif or b"",
+        exif_orientation,
+        xmp or b"",
+        advanced,
+    )
+
+    # Add each frame
+    frame_idx = 0
+    frame_duration = 0
+    cur_idx = im.tell()
+    is_single_frame = total == 1
+    try:
+        for ims in [im] + append_images:
+            # Get number of frames in this image
+            nfr = getattr(ims, "n_frames", 1)
+
+            for idx in range(nfr):
+                ims.seek(idx)
+
+                # Make sure image mode is supported
+                frame = ims
+                rawmode = ims.mode
+                if ims.mode not in {"RGB", "RGBA"}:
+                    rawmode = "RGBA" if ims.has_transparency_data else "RGB"
+                    frame = ims.convert(rawmode)
+
+                # Update frame duration
+                if isinstance(duration, (list, tuple)):
+                    frame_duration = duration[frame_idx]
+                else:
+                    frame_duration = duration
+
+                # Append the frame to the animation encoder
+                enc.add(
+                    frame.tobytes("raw", rawmode),
+                    frame_duration,
+                    frame.size,
+                    rawmode,
+                    is_single_frame,
+                )
+
+                # Update frame index
+                frame_idx += 1
+
+                if not save_all:
+                    break
+
+    finally:
+        im.seek(cur_idx)
+
+    # Get the final output from the encoder
+    data = enc.finish()
+    if data is None:
+        msg = "cannot write file as AVIF (encoder returned None)"
+        raise OSError(msg)
+
+    fp.write(data)
+
+
+Image.register_open(AvifImageFile.format, AvifImageFile, _accept)
+if SUPPORTED:
+    Image.register_save(AvifImageFile.format, _save)
+    Image.register_save_all(AvifImageFile.format, _save_all)
+    Image.register_extensions(AvifImageFile.format, [".avif", ".avifs"])
+    Image.register_mime(AvifImageFile.format, "image/avif")
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 19b22342acb..60850f4ffaf 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1520,6 +1520,8 @@ def getexif(self) -> Exif:
         # XMP tags
         if ExifTags.Base.Orientation not in self._exif:
             xmp_tags = self.info.get("XML:com.adobe.xmp")
+            if not xmp_tags and (xmp_tags := self.info.get("xmp")):
+                xmp_tags = xmp_tags.decode("utf-8")
             if xmp_tags:
                 match = re.search(r'tiff:Orientation(="|>)([0-9])', xmp_tags)
                 if match:
diff --git a/src/PIL/__init__.py b/src/PIL/__init__.py
index 09546fe6333..6e4c23f897f 100644
--- a/src/PIL/__init__.py
+++ b/src/PIL/__init__.py
@@ -25,6 +25,7 @@
 
 
 _plugins = [
+    "AvifImagePlugin",
     "BlpImagePlugin",
     "BmpImagePlugin",
     "BufrStubImagePlugin",
diff --git a/src/PIL/_avif.pyi b/src/PIL/_avif.pyi
new file mode 100644
index 00000000000..e27843e5338
--- /dev/null
+++ b/src/PIL/_avif.pyi
@@ -0,0 +1,3 @@
+from typing import Any
+
+def __getattr__(name: str) -> Any: ...
diff --git a/src/PIL/features.py b/src/PIL/features.py
index ae7ea4255ef..573f1d41256 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -17,6 +17,7 @@
     "freetype2": ("PIL._imagingft", "freetype2_version"),
     "littlecms2": ("PIL._imagingcms", "littlecms_version"),
     "webp": ("PIL._webp", "webpdecoder_version"),
+    "avif": ("PIL._avif", "libavif_version"),
 }
 
 
@@ -288,6 +289,7 @@ def pilinfo(out: IO[str] | None = None, supported_formats: bool = True) -> None:
         ("freetype2", "FREETYPE2"),
         ("littlecms2", "LITTLECMS2"),
         ("webp", "WEBP"),
+        ("avif", "AVIF"),
         ("jpg", "JPEG"),
         ("jpg_2000", "OPENJPEG (JPEG2000)"),
         ("zlib", "ZLIB (PNG/ZIP)"),
diff --git a/src/_avif.c b/src/_avif.c
new file mode 100644
index 00000000000..eabd9958e10
--- /dev/null
+++ b/src/_avif.c
@@ -0,0 +1,908 @@
+#define PY_SSIZE_T_CLEAN
+
+#include <Python.h>
+#include "avif/avif.h"
+
+// Encoder type
+typedef struct {
+    PyObject_HEAD avifEncoder *encoder;
+    avifImage *image;
+    int first_frame;
+} AvifEncoderObject;
+
+static PyTypeObject AvifEncoder_Type;
+
+// Decoder type
+typedef struct {
+    PyObject_HEAD avifDecoder *decoder;
+    Py_buffer buffer;
+} AvifDecoderObject;
+
+static PyTypeObject AvifDecoder_Type;
+
+static int
+normalize_tiles_log2(int value) {
+    if (value < 0) {
+        return 0;
+    } else if (value > 6) {
+        return 6;
+    } else {
+        return value;
+    }
+}
+
+static PyObject *
+exc_type_for_avif_result(avifResult result) {
+    switch (result) {
+        case AVIF_RESULT_INVALID_EXIF_PAYLOAD:
+        case AVIF_RESULT_INVALID_CODEC_SPECIFIC_OPTION:
+            return PyExc_ValueError;
+        case AVIF_RESULT_INVALID_FTYP:
+        case AVIF_RESULT_BMFF_PARSE_FAILED:
+        case AVIF_RESULT_TRUNCATED_DATA:
+        case AVIF_RESULT_NO_CONTENT:
+            return PyExc_SyntaxError;
+        default:
+            return PyExc_RuntimeError;
+    }
+}
+
+static uint8_t
+irot_imir_to_exif_orientation(const avifImage *image) {
+    uint8_t axis = image->imir.axis;
+    int imir = image->transformFlags & AVIF_TRANSFORM_IMIR;
+    int irot = image->transformFlags & AVIF_TRANSFORM_IROT;
+    if (irot) {
+        uint8_t angle = image->irot.angle;
+        if (angle == 1) {
+            if (imir) {
+                return axis ? 7   // 90 degrees anti-clockwise then swap left and right.
+                            : 5;  // 90 degrees anti-clockwise then swap top and bottom.
+            }
+            return 6;  // 90 degrees anti-clockwise.
+        }
+        if (angle == 2) {
+            if (imir) {
+                return axis
+                           ? 4   // 180 degrees anti-clockwise then swap left and right.
+                           : 2;  // 180 degrees anti-clockwise then swap top and bottom.
+            }
+            return 3;  // 180 degrees anti-clockwise.
+        }
+        if (angle == 3) {
+            if (imir) {
+                return axis
+                           ? 5   // 270 degrees anti-clockwise then swap left and right.
+                           : 7;  // 270 degrees anti-clockwise then swap top and bottom.
+            }
+            return 8;  // 270 degrees anti-clockwise.
+        }
+    }
+    if (imir) {
+        return axis ? 2   // Swap left and right.
+                    : 4;  // Swap top and bottom.
+    }
+    return 1;  // Default orientation ("top-left", no-op).
+}
+
+static void
+exif_orientation_to_irot_imir(avifImage *image, int orientation) {
+    // Mapping from Exif orientation as defined in JEITA CP-3451C section 4.6.4.A
+    // Orientation to irot and imir boxes as defined in HEIF ISO/IEC 28002-12:2021
+    // sections 6.5.10 and 6.5.12.
+    switch (orientation) {
+        case 2:  // The 0th row is at the visual top of the image, and the 0th column is
+                 // the visual right-hand side.
+            image->transformFlags |= AVIF_TRANSFORM_IMIR;
+            image->imir.axis = 1;
+            break;
+        case 3:  // The 0th row is at the visual bottom of the image, and the 0th column
+                 // is the visual right-hand side.
+            image->transformFlags |= AVIF_TRANSFORM_IROT;
+            image->irot.angle = 2;
+            break;
+        case 4:  // The 0th row is at the visual bottom of the image, and the 0th column
+                 // is the visual left-hand side.
+            image->transformFlags |= AVIF_TRANSFORM_IMIR;
+            break;
+        case 5:  // The 0th row is the visual left-hand side of the image, and the 0th
+                 // column is the visual top.
+            image->transformFlags |= AVIF_TRANSFORM_IROT | AVIF_TRANSFORM_IMIR;
+            image->irot.angle = 1;  // applied before imir according to MIAF spec
+                                    // ISO/IEC 28002-12:2021 - section 7.3.6.7
+            break;
+        case 6:  // The 0th row is the visual right-hand side of the image, and the 0th
+                 // column is the visual top.
+            image->transformFlags |= AVIF_TRANSFORM_IROT;
+            image->irot.angle = 3;
+            break;
+        case 7:  // The 0th row is the visual right-hand side of the image, and the 0th
+                 // column is the visual bottom.
+            image->transformFlags |= AVIF_TRANSFORM_IROT | AVIF_TRANSFORM_IMIR;
+            image->irot.angle = 3;  // applied before imir according to MIAF spec
+                                    // ISO/IEC 28002-12:2021 - section 7.3.6.7
+            break;
+        case 8:  // The 0th row is the visual left-hand side of the image, and the 0th
+                 // column is the visual bottom.
+            image->transformFlags |= AVIF_TRANSFORM_IROT;
+            image->irot.angle = 1;
+            break;
+    }
+}
+
+static int
+_codec_available(const char *name, avifCodecFlags flags) {
+    avifCodecChoice codec = avifCodecChoiceFromName(name);
+    if (codec == AVIF_CODEC_CHOICE_AUTO) {
+        return 0;
+    }
+    const char *codec_name = avifCodecName(codec, flags);
+    return (codec_name == NULL) ? 0 : 1;
+}
+
+PyObject *
+_decoder_codec_available(PyObject *self, PyObject *args) {
+    char *codec_name;
+    if (!PyArg_ParseTuple(args, "s", &codec_name)) {
+        return NULL;
+    }
+    int is_available = _codec_available(codec_name, AVIF_CODEC_FLAG_CAN_DECODE);
+    return PyBool_FromLong(is_available);
+}
+
+PyObject *
+_encoder_codec_available(PyObject *self, PyObject *args) {
+    char *codec_name;
+    if (!PyArg_ParseTuple(args, "s", &codec_name)) {
+        return NULL;
+    }
+    int is_available = _codec_available(codec_name, AVIF_CODEC_FLAG_CAN_ENCODE);
+    return PyBool_FromLong(is_available);
+}
+
+PyObject *
+_codec_versions(PyObject *self, PyObject *args) {
+    char buffer[256];
+    avifCodecVersions(buffer);
+    return PyUnicode_FromString(buffer);
+}
+
+static int
+_add_codec_specific_options(avifEncoder *encoder, PyObject *opts) {
+    Py_ssize_t i, size;
+    PyObject *keyval, *py_key, *py_val;
+    if (!PyTuple_Check(opts)) {
+        PyErr_SetString(PyExc_ValueError, "Invalid advanced codec options");
+        return 1;
+    }
+    size = PyTuple_GET_SIZE(opts);
+
+    for (i = 0; i < size; i++) {
+        keyval = PyTuple_GetItem(opts, i);
+        if (!PyTuple_Check(keyval) || PyTuple_GET_SIZE(keyval) != 2) {
+            PyErr_SetString(PyExc_ValueError, "Invalid advanced codec options");
+            return 1;
+        }
+        py_key = PyTuple_GetItem(keyval, 0);
+        py_val = PyTuple_GetItem(keyval, 1);
+        if (!PyUnicode_Check(py_key) || !PyUnicode_Check(py_val)) {
+            PyErr_SetString(PyExc_ValueError, "Invalid advanced codec options");
+            return 1;
+        }
+        const char *key = PyUnicode_AsUTF8(py_key);
+        const char *val = PyUnicode_AsUTF8(py_val);
+        if (key == NULL || val == NULL) {
+            PyErr_SetString(PyExc_ValueError, "Invalid advanced codec options");
+            return 1;
+        }
+
+        avifResult result = avifEncoderSetCodecSpecificOption(encoder, key, val);
+        if (result != AVIF_RESULT_OK) {
+            PyErr_Format(
+                exc_type_for_avif_result(result),
+                "Setting advanced codec options failed: %s",
+                avifResultToString(result)
+            );
+            return 1;
+        }
+    }
+    return 0;
+}
+
+// Encoder functions
+PyObject *
+AvifEncoderNew(PyObject *self_, PyObject *args) {
+    unsigned int width, height;
+    AvifEncoderObject *self = NULL;
+    avifEncoder *encoder = NULL;
+
+    char *subsampling;
+    int quality;
+    int speed;
+    int exif_orientation;
+    int max_threads;
+    Py_buffer icc_buffer;
+    Py_buffer exif_buffer;
+    Py_buffer xmp_buffer;
+    int alpha_premultiplied;
+    int autotiling;
+    int tile_rows_log2;
+    int tile_cols_log2;
+
+    char *codec;
+    char *range;
+
+    PyObject *advanced;
+    int error = 0;
+
+    if (!PyArg_ParseTuple(
+            args,
+            "(II)siiissiippy*y*iy*O",
+            &width,
+            &height,
+            &subsampling,
+            &quality,
+            &speed,
+            &max_threads,
+            &codec,
+            &range,
+            &tile_rows_log2,
+            &tile_cols_log2,
+            &alpha_premultiplied,
+            &autotiling,
+            &icc_buffer,
+            &exif_buffer,
+            &exif_orientation,
+            &xmp_buffer,
+            &advanced
+        )) {
+        return NULL;
+    }
+
+    // Create a new animation encoder and picture frame
+    avifImage *image = avifImageCreateEmpty();
+    if (image == NULL) {
+        PyErr_SetString(PyExc_ValueError, "Image creation failed");
+        error = 1;
+        goto end;
+    }
+
+    // Set these in advance so any upcoming RGB -> YUV use the proper coefficients
+    if (strcmp(range, "full") == 0) {
+        image->yuvRange = AVIF_RANGE_FULL;
+    } else if (strcmp(range, "limited") == 0) {
+        image->yuvRange = AVIF_RANGE_LIMITED;
+    } else {
+        PyErr_SetString(PyExc_ValueError, "Invalid range");
+        error = 1;
+        goto end;
+    }
+    if (strcmp(subsampling, "4:0:0") == 0) {
+        image->yuvFormat = AVIF_PIXEL_FORMAT_YUV400;
+    } else if (strcmp(subsampling, "4:2:0") == 0) {
+        image->yuvFormat = AVIF_PIXEL_FORMAT_YUV420;
+    } else if (strcmp(subsampling, "4:2:2") == 0) {
+        image->yuvFormat = AVIF_PIXEL_FORMAT_YUV422;
+    } else if (strcmp(subsampling, "4:4:4") == 0) {
+        image->yuvFormat = AVIF_PIXEL_FORMAT_YUV444;
+    } else {
+        PyErr_Format(PyExc_ValueError, "Invalid subsampling: %s", subsampling);
+        error = 1;
+        goto end;
+    }
+
+    // Validate canvas dimensions
+    if (width == 0 || height == 0) {
+        PyErr_SetString(PyExc_ValueError, "invalid canvas dimensions");
+        error = 1;
+        goto end;
+    }
+    image->width = width;
+    image->height = height;
+
+    image->depth = 8;
+    image->alphaPremultiplied = alpha_premultiplied ? AVIF_TRUE : AVIF_FALSE;
+
+    encoder = avifEncoderCreate();
+    if (!encoder) {
+        PyErr_SetString(PyExc_MemoryError, "Can't allocate encoder");
+        error = 1;
+        goto end;
+    }
+
+    int is_aom_encode = strcmp(codec, "aom") == 0 ||
+                        (strcmp(codec, "auto") == 0 &&
+                         _codec_available("aom", AVIF_CODEC_FLAG_CAN_ENCODE));
+    encoder->maxThreads = is_aom_encode && max_threads > 64 ? 64 : max_threads;
+
+    encoder->quality = quality;
+
+    if (strcmp(codec, "auto") == 0) {
+        encoder->codecChoice = AVIF_CODEC_CHOICE_AUTO;
+    } else {
+        encoder->codecChoice = avifCodecChoiceFromName(codec);
+    }
+    if (speed < AVIF_SPEED_SLOWEST) {
+        speed = AVIF_SPEED_SLOWEST;
+    } else if (speed > AVIF_SPEED_FASTEST) {
+        speed = AVIF_SPEED_FASTEST;
+    }
+    encoder->speed = speed;
+    encoder->timescale = (uint64_t)1000;
+
+    encoder->autoTiling = autotiling ? AVIF_TRUE : AVIF_FALSE;
+    if (!autotiling) {
+        encoder->tileRowsLog2 = normalize_tiles_log2(tile_rows_log2);
+        encoder->tileColsLog2 = normalize_tiles_log2(tile_cols_log2);
+    }
+
+    if (advanced != Py_None && _add_codec_specific_options(encoder, advanced)) {
+        error = 1;
+        goto end;
+    }
+
+    self = PyObject_New(AvifEncoderObject, &AvifEncoder_Type);
+    if (!self) {
+        PyErr_SetString(PyExc_RuntimeError, "could not create encoder object");
+        error = 1;
+        goto end;
+    }
+    self->first_frame = 1;
+
+    avifResult result;
+    if (icc_buffer.len) {
+        result = avifImageSetProfileICC(image, icc_buffer.buf, icc_buffer.len);
+        if (result != AVIF_RESULT_OK) {
+            PyErr_Format(
+                exc_type_for_avif_result(result),
+                "Setting ICC profile failed: %s",
+                avifResultToString(result)
+            );
+            error = 1;
+            goto end;
+        }
+        // colorPrimaries and transferCharacteristics are ignored when an ICC
+        // profile is present, so set them to UNSPECIFIED.
+        image->colorPrimaries = AVIF_COLOR_PRIMARIES_UNSPECIFIED;
+        image->transferCharacteristics = AVIF_TRANSFER_CHARACTERISTICS_UNSPECIFIED;
+    } else {
+        image->colorPrimaries = AVIF_COLOR_PRIMARIES_BT709;
+        image->transferCharacteristics = AVIF_TRANSFER_CHARACTERISTICS_SRGB;
+    }
+    image->matrixCoefficients = AVIF_MATRIX_COEFFICIENTS_BT601;
+
+    if (exif_buffer.len) {
+        result = avifImageSetMetadataExif(image, exif_buffer.buf, exif_buffer.len);
+        if (result != AVIF_RESULT_OK) {
+            PyErr_Format(
+                exc_type_for_avif_result(result),
+                "Setting EXIF data failed: %s",
+                avifResultToString(result)
+            );
+            error = 1;
+            goto end;
+        }
+    }
+
+    if (xmp_buffer.len) {
+        result = avifImageSetMetadataXMP(image, xmp_buffer.buf, xmp_buffer.len);
+        if (result != AVIF_RESULT_OK) {
+            PyErr_Format(
+                exc_type_for_avif_result(result),
+                "Setting XMP data failed: %s",
+                avifResultToString(result)
+            );
+            error = 1;
+            goto end;
+        }
+    }
+
+    if (exif_orientation > 1) {
+        exif_orientation_to_irot_imir(image, exif_orientation);
+    }
+
+    self->image = image;
+    self->encoder = encoder;
+
+end:
+    PyBuffer_Release(&icc_buffer);
+    PyBuffer_Release(&exif_buffer);
+    PyBuffer_Release(&xmp_buffer);
+
+    if (error) {
+        if (image) {
+            avifImageDestroy(image);
+        }
+        if (encoder) {
+            avifEncoderDestroy(encoder);
+        }
+        if (self) {
+            PyObject_Del(self);
+        }
+        return NULL;
+    }
+
+    return (PyObject *)self;
+}
+
+PyObject *
+_encoder_dealloc(AvifEncoderObject *self) {
+    if (self->encoder) {
+        avifEncoderDestroy(self->encoder);
+    }
+    if (self->image) {
+        avifImageDestroy(self->image);
+    }
+    Py_RETURN_NONE;
+}
+
+PyObject *
+_encoder_add(AvifEncoderObject *self, PyObject *args) {
+    uint8_t *rgb_bytes;
+    Py_ssize_t size;
+    unsigned int duration;
+    unsigned int width;
+    unsigned int height;
+    char *mode;
+    unsigned int is_single_frame;
+    int error = 0;
+
+    avifRGBImage rgb;
+    avifResult result;
+
+    avifEncoder *encoder = self->encoder;
+    avifImage *image = self->image;
+    avifImage *frame = NULL;
+
+    if (!PyArg_ParseTuple(
+            args,
+            "y#I(II)sp",
+            (char **)&rgb_bytes,
+            &size,
+            &duration,
+            &width,
+            &height,
+            &mode,
+            &is_single_frame
+        )) {
+        return NULL;
+    }
+
+    if (image->width != width || image->height != height) {
+        PyErr_Format(
+            PyExc_ValueError,
+            "Image sequence dimensions mismatch, %ux%u != %ux%u",
+            image->width,
+            image->height,
+            width,
+            height
+        );
+        return NULL;
+    }
+
+    if (self->first_frame) {
+        // If we don't have an image populated with yuv planes, this is the first frame
+        frame = image;
+    } else {
+        frame = avifImageCreateEmpty();
+        if (image == NULL) {
+            PyErr_SetString(PyExc_ValueError, "Image creation failed");
+            return NULL;
+        }
+
+        frame->width = width;
+        frame->height = height;
+        frame->colorPrimaries = image->colorPrimaries;
+        frame->transferCharacteristics = image->transferCharacteristics;
+        frame->matrixCoefficients = image->matrixCoefficients;
+        frame->yuvRange = image->yuvRange;
+        frame->yuvFormat = image->yuvFormat;
+        frame->depth = image->depth;
+        frame->alphaPremultiplied = image->alphaPremultiplied;
+    }
+
+    avifRGBImageSetDefaults(&rgb, frame);
+
+    if (strcmp(mode, "RGBA") == 0) {
+        rgb.format = AVIF_RGB_FORMAT_RGBA;
+    } else {
+        rgb.format = AVIF_RGB_FORMAT_RGB;
+    }
+
+    result = avifRGBImageAllocatePixels(&rgb);
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Pixel allocation failed: %s",
+            avifResultToString(result)
+        );
+        error = 1;
+        goto end;
+    }
+
+    if (rgb.rowBytes * rgb.height != size) {
+        PyErr_Format(
+            PyExc_RuntimeError,
+            "rgb data has incorrect size: %u * %u (%u) != %u",
+            rgb.rowBytes,
+            rgb.height,
+            rgb.rowBytes * rgb.height,
+            size
+        );
+        error = 1;
+        goto end;
+    }
+
+    // rgb.pixels is safe for writes
+    memcpy(rgb.pixels, rgb_bytes, size);
+
+    Py_BEGIN_ALLOW_THREADS;
+    result = avifImageRGBToYUV(frame, &rgb);
+    Py_END_ALLOW_THREADS;
+
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Conversion to YUV failed: %s",
+            avifResultToString(result)
+        );
+        error = 1;
+        goto end;
+    }
+
+    uint32_t addImageFlags =
+        is_single_frame ? AVIF_ADD_IMAGE_FLAG_SINGLE : AVIF_ADD_IMAGE_FLAG_NONE;
+
+    Py_BEGIN_ALLOW_THREADS;
+    result = avifEncoderAddImage(encoder, frame, duration, addImageFlags);
+    Py_END_ALLOW_THREADS;
+
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Failed to encode image: %s",
+            avifResultToString(result)
+        );
+        error = 1;
+        goto end;
+    }
+
+end:
+    if (&rgb) {
+        avifRGBImageFreePixels(&rgb);
+    }
+    if (!self->first_frame) {
+        avifImageDestroy(frame);
+    }
+
+    if (error) {
+        return NULL;
+    }
+    self->first_frame = 0;
+    Py_RETURN_NONE;
+}
+
+PyObject *
+_encoder_finish(AvifEncoderObject *self) {
+    avifEncoder *encoder = self->encoder;
+
+    avifRWData raw = AVIF_DATA_EMPTY;
+    avifResult result;
+    PyObject *ret = NULL;
+
+    Py_BEGIN_ALLOW_THREADS;
+    result = avifEncoderFinish(encoder, &raw);
+    Py_END_ALLOW_THREADS;
+
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Failed to finish encoding: %s",
+            avifResultToString(result)
+        );
+        avifRWDataFree(&raw);
+        return NULL;
+    }
+
+    ret = PyBytes_FromStringAndSize((char *)raw.data, raw.size);
+
+    avifRWDataFree(&raw);
+
+    return ret;
+}
+
+// Decoder functions
+PyObject *
+AvifDecoderNew(PyObject *self_, PyObject *args) {
+    Py_buffer buffer;
+    AvifDecoderObject *self = NULL;
+    avifDecoder *decoder;
+
+    char *codec_str;
+    avifCodecChoice codec;
+    int max_threads;
+
+    avifResult result;
+
+    if (!PyArg_ParseTuple(args, "y*si", &buffer, &codec_str, &max_threads)) {
+        return NULL;
+    }
+
+    if (strcmp(codec_str, "auto") == 0) {
+        codec = AVIF_CODEC_CHOICE_AUTO;
+    } else {
+        codec = avifCodecChoiceFromName(codec_str);
+    }
+
+    self = PyObject_New(AvifDecoderObject, &AvifDecoder_Type);
+    if (!self) {
+        PyErr_SetString(PyExc_RuntimeError, "could not create decoder object");
+        PyBuffer_Release(&buffer);
+        return NULL;
+    }
+
+    decoder = avifDecoderCreate();
+    if (!decoder) {
+        PyErr_SetString(PyExc_MemoryError, "Can't allocate decoder");
+        PyBuffer_Release(&buffer);
+        PyObject_Del(self);
+        return NULL;
+    }
+    decoder->maxThreads = max_threads;
+    // Turn off libavif's 'clap' (clean aperture) property validation.
+    decoder->strictFlags &= ~AVIF_STRICT_CLAP_VALID;
+    // Allow the PixelInformationProperty ('pixi') to be missing in AV1 image
+    // items. libheif v1.11.0 and older does not add the 'pixi' item property to
+    // AV1 image items.
+    decoder->strictFlags &= ~AVIF_STRICT_PIXI_REQUIRED;
+    decoder->codecChoice = codec;
+
+    result = avifDecoderSetIOMemory(decoder, buffer.buf, buffer.len);
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Setting IO memory failed: %s",
+            avifResultToString(result)
+        );
+        avifDecoderDestroy(decoder);
+        PyBuffer_Release(&buffer);
+        PyObject_Del(self);
+        return NULL;
+    }
+
+    result = avifDecoderParse(decoder);
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Failed to decode image: %s",
+            avifResultToString(result)
+        );
+        avifDecoderDestroy(decoder);
+        PyBuffer_Release(&buffer);
+        PyObject_Del(self);
+        return NULL;
+    }
+
+    self->decoder = decoder;
+    self->buffer = buffer;
+
+    return (PyObject *)self;
+}
+
+PyObject *
+_decoder_dealloc(AvifDecoderObject *self) {
+    if (self->decoder) {
+        avifDecoderDestroy(self->decoder);
+    }
+    PyBuffer_Release(&self->buffer);
+    Py_RETURN_NONE;
+}
+
+PyObject *
+_decoder_get_info(AvifDecoderObject *self) {
+    avifDecoder *decoder = self->decoder;
+    avifImage *image = decoder->image;
+
+    PyObject *icc = NULL;
+    PyObject *exif = NULL;
+    PyObject *xmp = NULL;
+    PyObject *ret = NULL;
+
+    if (image->xmp.size) {
+        xmp = PyBytes_FromStringAndSize((const char *)image->xmp.data, image->xmp.size);
+    }
+
+    if (image->exif.size) {
+        exif =
+            PyBytes_FromStringAndSize((const char *)image->exif.data, image->exif.size);
+    }
+
+    if (image->icc.size) {
+        icc = PyBytes_FromStringAndSize((const char *)image->icc.data, image->icc.size);
+    }
+
+    ret = Py_BuildValue(
+        "(II)IsSSIS",
+        image->width,
+        image->height,
+        decoder->imageCount,
+        decoder->alphaPresent ? "RGBA" : "RGB",
+        NULL == icc ? Py_None : icc,
+        NULL == exif ? Py_None : exif,
+        irot_imir_to_exif_orientation(image),
+        NULL == xmp ? Py_None : xmp
+    );
+
+    Py_XDECREF(xmp);
+    Py_XDECREF(exif);
+    Py_XDECREF(icc);
+
+    return ret;
+}
+
+PyObject *
+_decoder_get_frame(AvifDecoderObject *self, PyObject *args) {
+    PyObject *bytes;
+    PyObject *ret;
+    Py_ssize_t size;
+    avifResult result;
+    avifRGBImage rgb;
+    avifDecoder *decoder;
+    avifImage *image;
+    uint32_t frame_index;
+
+    decoder = self->decoder;
+
+    if (!PyArg_ParseTuple(args, "I", &frame_index)) {
+        return NULL;
+    }
+
+    result = avifDecoderNthImage(decoder, frame_index);
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Failed to decode frame %u: %s",
+            frame_index,
+            avifResultToString(result)
+        );
+        return NULL;
+    }
+
+    image = decoder->image;
+
+    avifRGBImageSetDefaults(&rgb, image);
+
+    rgb.depth = 8;
+    rgb.format = decoder->alphaPresent ? AVIF_RGB_FORMAT_RGBA : AVIF_RGB_FORMAT_RGB;
+
+    result = avifRGBImageAllocatePixels(&rgb);
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Pixel allocation failed: %s",
+            avifResultToString(result)
+        );
+        return NULL;
+    }
+
+    Py_BEGIN_ALLOW_THREADS;
+    result = avifImageYUVToRGB(image, &rgb);
+    Py_END_ALLOW_THREADS;
+
+    if (result != AVIF_RESULT_OK) {
+        PyErr_Format(
+            exc_type_for_avif_result(result),
+            "Conversion from YUV failed: %s",
+            avifResultToString(result)
+        );
+        avifRGBImageFreePixels(&rgb);
+        return NULL;
+    }
+
+    if (rgb.height > PY_SSIZE_T_MAX / rgb.rowBytes) {
+        PyErr_SetString(PyExc_MemoryError, "Integer overflow in pixel size");
+        return NULL;
+    }
+
+    size = rgb.rowBytes * rgb.height;
+
+    bytes = PyBytes_FromStringAndSize((char *)rgb.pixels, size);
+    avifRGBImageFreePixels(&rgb);
+
+    ret = Py_BuildValue(
+        "SKKK",
+        bytes,
+        decoder->timescale,
+        decoder->imageTiming.ptsInTimescales,
+        decoder->imageTiming.durationInTimescales
+    );
+
+    Py_DECREF(bytes);
+
+    return ret;
+}
+
+/* -------------------------------------------------------------------- */
+/* Type Definitions                                                     */
+/* -------------------------------------------------------------------- */
+
+// AvifEncoder methods
+static struct PyMethodDef _encoder_methods[] = {
+    {"add", (PyCFunction)_encoder_add, METH_VARARGS},
+    {"finish", (PyCFunction)_encoder_finish, METH_NOARGS},
+    {NULL, NULL} /* sentinel */
+};
+
+// AvifEncoder type definition
+static PyTypeObject AvifEncoder_Type = {
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "AvifEncoder",
+    .tp_basicsize = sizeof(AvifEncoderObject),
+    .tp_dealloc = (destructor)_encoder_dealloc,
+    .tp_methods = _encoder_methods,
+};
+
+// AvifDecoder methods
+static struct PyMethodDef _decoder_methods[] = {
+    {"get_info", (PyCFunction)_decoder_get_info, METH_NOARGS},
+    {"get_frame", (PyCFunction)_decoder_get_frame, METH_VARARGS},
+    {NULL, NULL} /* sentinel */
+};
+
+// AvifDecoder type definition
+static PyTypeObject AvifDecoder_Type = {
+    PyVarObject_HEAD_INIT(NULL, 0).tp_name = "AvifDecoder",
+    .tp_basicsize = sizeof(AvifDecoderObject),
+    .tp_dealloc = (destructor)_decoder_dealloc,
+    .tp_methods = _decoder_methods,
+};
+
+/* -------------------------------------------------------------------- */
+/* Module Setup                                                         */
+/* -------------------------------------------------------------------- */
+
+static PyMethodDef avifMethods[] = {
+    {"AvifDecoder", AvifDecoderNew, METH_VARARGS},
+    {"AvifEncoder", AvifEncoderNew, METH_VARARGS},
+    {"decoder_codec_available", _decoder_codec_available, METH_VARARGS},
+    {"encoder_codec_available", _encoder_codec_available, METH_VARARGS},
+    {"codec_versions", _codec_versions, METH_NOARGS},
+    {NULL, NULL}
+};
+
+static int
+setup_module(PyObject *m) {
+    if (PyType_Ready(&AvifDecoder_Type) < 0 || PyType_Ready(&AvifEncoder_Type) < 0) {
+        return -1;
+    }
+
+    PyObject *d = PyModule_GetDict(m);
+    PyObject *v = PyUnicode_FromString(avifVersion());
+    PyDict_SetItemString(d, "libavif_version", v ? v : Py_None);
+    Py_XDECREF(v);
+
+    return 0;
+}
+
+PyMODINIT_FUNC
+PyInit__avif(void) {
+    PyObject *m;
+
+    static PyModuleDef module_def = {
+        PyModuleDef_HEAD_INIT,
+        .m_name = "_avif",
+        .m_size = -1,
+        .m_methods = avifMethods,
+    };
+
+    m = PyModule_Create(&module_def);
+    if (setup_module(m) < 0) {
+        Py_DECREF(m);
+        return NULL;
+    }
+
+#ifdef Py_GIL_DISABLED
+    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
+#endif
+
+    return m;
+}
diff --git a/wheels/dependency_licenses/AOM.txt b/wheels/dependency_licenses/AOM.txt
new file mode 100644
index 00000000000..3a2e46c264b
--- /dev/null
+++ b/wheels/dependency_licenses/AOM.txt
@@ -0,0 +1,26 @@
+Copyright (c) 2016, Alliance for Open Media. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in
+   the documentation and/or other materials provided with the
+   distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/DAV1D.txt b/wheels/dependency_licenses/DAV1D.txt
new file mode 100644
index 00000000000..875b138ecf6
--- /dev/null
+++ b/wheels/dependency_licenses/DAV1D.txt
@@ -0,0 +1,23 @@
+Copyright © 2018-2019, VideoLAN and dav1d authors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/LIBAVIF.txt b/wheels/dependency_licenses/LIBAVIF.txt
new file mode 100644
index 00000000000..350eb9d15ce
--- /dev/null
+++ b/wheels/dependency_licenses/LIBAVIF.txt
@@ -0,0 +1,387 @@
+Copyright 2019 Joe Drago. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+------------------------------------------------------------------------------
+
+Files: src/obu.c
+
+Copyright © 2018-2019, VideoLAN and dav1d authors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+------------------------------------------------------------------------------
+
+Files: third_party/iccjpeg/*
+
+In plain English:
+
+1. We don't promise that this software works.  (But if you find any bugs,
+   please let us know!)
+2. You can use this software for whatever you want.  You don't have to pay us.
+3. You may not pretend that you wrote this software.  If you use it in a
+   program, you must acknowledge somewhere in your documentation that
+   you've used the IJG code.
+
+In legalese:
+
+The authors make NO WARRANTY or representation, either express or implied,
+with respect to this software, its quality, accuracy, merchantability, or
+fitness for a particular purpose.  This software is provided "AS IS", and you,
+its user, assume the entire risk as to its quality and accuracy.
+
+This software is copyright (C) 1991-2013, Thomas G. Lane, Guido Vollbeding.
+All Rights Reserved except as specified below.
+
+Permission is hereby granted to use, copy, modify, and distribute this
+software (or portions thereof) for any purpose, without fee, subject to these
+conditions:
+(1) If any part of the source code for this software is distributed, then this
+README file must be included, with this copyright and no-warranty notice
+unaltered; and any additions, deletions, or changes to the original files
+must be clearly indicated in accompanying documentation.
+(2) If only executable code is distributed, then the accompanying
+documentation must state that "this software is based in part on the work of
+the Independent JPEG Group".
+(3) Permission for use of this software is granted only if the user accepts
+full responsibility for any undesirable consequences; the authors accept
+NO LIABILITY for damages of any kind.
+
+These conditions apply to any software derived from or based on the IJG code,
+not just to the unmodified library.  If you use our work, you ought to
+acknowledge us.
+
+Permission is NOT granted for the use of any IJG author's name or company name
+in advertising or publicity relating to this software or products derived from
+it.  This software may be referred to only as "the Independent JPEG Group's
+software".
+
+We specifically permit and encourage the use of this software as the basis of
+commercial products, provided that all warranty or liability claims are
+assumed by the product vendor.
+
+
+The Unix configuration script "configure" was produced with GNU Autoconf.
+It is copyright by the Free Software Foundation but is freely distributable.
+The same holds for its supporting scripts (config.guess, config.sub,
+ltmain.sh).  Another support script, install-sh, is copyright by X Consortium
+but is also freely distributable.
+
+The IJG distribution formerly included code to read and write GIF files.
+To avoid entanglement with the Unisys LZW patent, GIF reading support has
+been removed altogether, and the GIF writer has been simplified to produce
+"uncompressed GIFs".  This technique does not use the LZW algorithm; the
+resulting GIF files are larger than usual, but are readable by all standard
+GIF decoders.
+
+We are required to state that
+    "The Graphics Interchange Format(c) is the Copyright property of
+    CompuServe Incorporated.  GIF(sm) is a Service Mark property of
+    CompuServe Incorporated."
+
+------------------------------------------------------------------------------
+
+Files: contrib/gdk-pixbuf/*
+
+Copyright 2020 Emmanuel Gil Peyrot. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+------------------------------------------------------------------------------
+
+Files: android_jni/gradlew*
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+------------------------------------------------------------------------------
+
+Files: third_party/libyuv/*
+
+Copyright 2011 The LibYuv Project Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+  * Neither the name of Google nor the names of its contributors may
+    be used to endorse or promote products derived from this software
+    without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/LIBYUV.txt b/wheels/dependency_licenses/LIBYUV.txt
new file mode 100644
index 00000000000..c911747a6b5
--- /dev/null
+++ b/wheels/dependency_licenses/LIBYUV.txt
@@ -0,0 +1,29 @@
+Copyright 2011 The LibYuv Project Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+  * Neither the name of Google nor the names of its contributors may
+    be used to endorse or promote products derived from this software
+    without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/RAV1E.txt b/wheels/dependency_licenses/RAV1E.txt
new file mode 100644
index 00000000000..3d6c825c4eb
--- /dev/null
+++ b/wheels/dependency_licenses/RAV1E.txt
@@ -0,0 +1,25 @@
+BSD 2-Clause License
+
+Copyright (c) 2017-2023, the rav1e contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/SVT-AV1.txt b/wheels/dependency_licenses/SVT-AV1.txt
new file mode 100644
index 00000000000..532a982b3ff
--- /dev/null
+++ b/wheels/dependency_licenses/SVT-AV1.txt
@@ -0,0 +1,26 @@
+Copyright (c) 2019, Alliance for Open Media. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in
+   the documentation and/or other materials provided with the
+   distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
diff --git a/winbuild/build.rst b/winbuild/build.rst
index aae78ce1237..3c20c7d179f 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -61,6 +61,7 @@ Run ``build_prepare.py`` to configure the build::
       --no-imagequant       skip GPL-licensed optional dependency libimagequant
       --no-fribidi, --no-raqm
                             skip LGPL-licensed optional dependency FriBiDi
+      --no-avif             skip optional dependency libavif
 
     Arguments can also be supplied using the environment variables PILLOW_BUILD,
     PILLOW_DEPS, ARCHITECTURE. See winbuild\build.rst for more information.
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 2e9e187192e..e4901859ea3 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,6 +116,7 @@ def cmd_msbuild(
     "HARFBUZZ": "11.0.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.17",
+    "LIBAVIF": "1.2.1",
     "LIBIMAGEQUANT": "4.3.4",
     "LIBPNG": "1.6.47",
     "LIBWEBP": "1.5.0",
@@ -378,6 +379,26 @@ def cmd_msbuild(
         ],
         "bins": [r"*.dll"],
     },
+    "libavif": {
+        "url": f"https://github.com/AOMediaCodec/libavif/archive/v{V['LIBAVIF']}.zip",
+        "filename": f"libavif-{V['LIBAVIF']}.zip",
+        "license": "LICENSE",
+        "build": [
+            f"{sys.executable} -m pip install meson",
+            *cmds_cmake(
+                "avif_static",
+                "-DBUILD_SHARED_LIBS=OFF",
+                "-DAVIF_LIBSHARPYUV=LOCAL",
+                "-DAVIF_LIBYUV=LOCAL",
+                "-DAVIF_CODEC_AOM=LOCAL",
+                "-DAVIF_CODEC_DAV1D=LOCAL",
+                "-DAVIF_CODEC_RAV1E=LOCAL",
+                "-DAVIF_CODEC_SVT=LOCAL",
+            ),
+            cmd_xcopy("include", "{inc_dir}"),
+        ],
+        "libs": ["avif.lib"],
+    },
 }
 
 
@@ -683,6 +704,11 @@ def main() -> None:
         action="store_true",
         help="skip LGPL-licensed optional dependency FriBiDi",
     )
+    parser.add_argument(
+        "--no-avif",
+        action="store_true",
+        help="skip optional dependency libavif",
+    )
     args = parser.parse_args()
 
     arch_prefs = ARCHITECTURES[args.architecture]
@@ -723,6 +749,8 @@ def main() -> None:
         disabled += ["libimagequant"]
     if args.no_fribidi:
         disabled += ["fribidi"]
+    if args.no_avif or args.architecture != "AMD64":
+        disabled += ["libavif"]
 
     prefs = {
         "architecture": args.architecture,

From 81412212016a70eb160460e26dc552a0f8a8c153 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Apr 2025 08:35:19 +1100
Subject: [PATCH 1598/2374] Allow cmake<4 when building libtiff

---
 winbuild/build_prepare.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index e4901859ea3..b45148ee89d 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -235,6 +235,7 @@ def cmd_msbuild(
                 "-DBUILD_SHARED_LIBS:BOOL=OFF",
                 "-DWebP_LIBRARY=libwebp",
                 '-DCMAKE_C_FLAGS="-nologo -DLZMA_API_STATIC"',
+                "-DCMAKE_POLICY_VERSION_MINIMUM=3.5",
             )
         ],
         "headers": [r"libtiff\tiff*.h"],

From 348bf6550d3937d14bbd04251c12bed6dfed9eec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Apr 2025 16:33:55 +1100
Subject: [PATCH 1599/2374] Allow cmake<4 when building libavif

---
 winbuild/build_prepare.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b45148ee89d..e118cd99422 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -395,6 +395,7 @@ def cmd_msbuild(
                 "-DAVIF_CODEC_DAV1D=LOCAL",
                 "-DAVIF_CODEC_RAV1E=LOCAL",
                 "-DAVIF_CODEC_SVT=LOCAL",
+                "-DCMAKE_POLICY_VERSION_MINIMUM=3.5",
             ),
             cmd_xcopy("include", "{inc_dir}"),
         ],

From 5c76e7ec17813eefaa1fdd8948e0165ee644e11f Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Tue, 1 Apr 2025 07:10:45 +0100
Subject: [PATCH 1600/2374] Image -> Arrow support (#8330)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .ci/install.sh                     |   3 +
 .github/workflows/macos-install.sh |   3 +
 .github/workflows/test-windows.yml |   4 +
 Tests/test_arrow.py                | 164 ++++++++++++++++
 Tests/test_pyarrow.py              | 112 +++++++++++
 docs/reference/Image.rst           |   3 +
 docs/reference/arrow_support.rst   |  88 +++++++++
 docs/reference/block_allocator.rst |   3 +
 docs/reference/internal_design.rst |   1 +
 pyproject.toml                     |   5 +
 setup.py                           |   1 +
 src/PIL/Image.py                   |  80 ++++++++
 src/_imaging.c                     | 115 +++++++++++
 src/libImaging/Arrow.c             | 299 +++++++++++++++++++++++++++++
 src/libImaging/Arrow.h             |  48 +++++
 src/libImaging/Imaging.h           |  38 ++++
 src/libImaging/Storage.c           | 199 ++++++++++++++++++-
 17 files changed, 1165 insertions(+), 1 deletion(-)
 create mode 100644 Tests/test_arrow.py
 create mode 100644 Tests/test_pyarrow.py
 create mode 100644 docs/reference/arrow_support.rst
 create mode 100644 src/libImaging/Arrow.c
 create mode 100644 src/libImaging/Arrow.h

diff --git a/.ci/install.sh b/.ci/install.sh
index 83d5df01cf6..ba32eab04ea 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -36,6 +36,9 @@ 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
+# optional test dependency, only install if there's a binary package.
+# fails on beta 3.14 and PyPy
+python3 -m pip install --only-binary=:all: pyarrow || true
 
 if [[ $(uname) != CYGWIN* ]]; then
     python3 -m pip install numpy
diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index 099f4a582b0..94e3d5d085e 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -30,6 +30,9 @@ python3 -m pip install -U pytest-cov
 python3 -m pip install -U pytest-timeout
 python3 -m pip install pyroma
 python3 -m pip install numpy
+# optional test dependency, only install if there's a binary package.
+# fails on beta 3.14 and PyPy
+python3 -m pip install --only-binary=:all: pyarrow || true
 
 # libavif
 pushd depends && ./install_libavif.sh && popd
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 0c3f44e96ef..bf8ec2f2cdf 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -88,6 +88,10 @@ jobs:
       run: |
         python3 -m pip install PyQt6
 
+    - name: Install PyArrow dependency
+      run: |
+        python3 -m pip install --only-binary=:all: pyarrow || true
+
     - name: Install dependencies
       id: install
       run: |
diff --git a/Tests/test_arrow.py b/Tests/test_arrow.py
new file mode 100644
index 00000000000..b86c77b9aa8
--- /dev/null
+++ b/Tests/test_arrow.py
@@ -0,0 +1,164 @@
+from __future__ import annotations
+
+import pytest
+
+from PIL import Image
+
+from .helper import hopper
+
+
+@pytest.mark.parametrize(
+    "mode, dest_modes",
+    (
+        ("L", ["I", "F", "LA", "RGB", "RGBA", "RGBX", "CMYK", "YCbCr", "HSV"]),
+        ("I", ["L", "F"]),  # Technically I;32 can work for any 4x8bit storage.
+        ("F", ["I", "L", "LA", "RGB", "RGBA", "RGBX", "CMYK", "YCbCr", "HSV"]),
+        ("LA", ["L", "F"]),
+        ("RGB", ["L", "F"]),
+        ("RGBA", ["L", "F"]),
+        ("RGBX", ["L", "F"]),
+        ("CMYK", ["L", "F"]),
+        ("YCbCr", ["L", "F"]),
+        ("HSV", ["L", "F"]),
+    ),
+)
+def test_invalid_array_type(mode: str, dest_modes: list[str]) -> None:
+    img = hopper(mode)
+    for dest_mode in dest_modes:
+        with pytest.raises(ValueError):
+            Image.fromarrow(img, dest_mode, img.size)
+
+
+def test_invalid_array_size() -> None:
+    img = hopper("RGB")
+
+    assert img.size != (10, 10)
+    with pytest.raises(ValueError):
+        Image.fromarrow(img, "RGB", (10, 10))
+
+
+def test_release_schema() -> None:
+    # these should not error out, valgrind should be clean
+    img = hopper("L")
+    schema = img.__arrow_c_schema__()
+    del schema
+
+
+def test_release_array() -> None:
+    # these should not error out, valgrind should be clean
+    img = hopper("L")
+    array, schema = img.__arrow_c_array__()
+    del array
+    del schema
+
+
+def test_readonly() -> None:
+    img = hopper("L")
+    reloaded = Image.fromarrow(img, img.mode, img.size)
+    assert reloaded.readonly == 1
+    reloaded._readonly = 0
+    assert reloaded.readonly == 1
+
+
+def test_multiblock_l_image() -> None:
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in single channel mode
+    size = (4096, 2 * block_size // 4096)
+    img = Image.new("L", size, 128)
+
+    with pytest.raises(ValueError):
+        (schema, arr) = img.__arrow_c_array__()
+
+
+def test_multiblock_rgba_image() -> None:
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in 4 channel mode
+    size = (4096, (block_size // 4096) // 2)
+    img = Image.new("RGBA", size, (128, 127, 126, 125))
+
+    with pytest.raises(ValueError):
+        (schema, arr) = img.__arrow_c_array__()
+
+
+def test_multiblock_l_schema() -> None:
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in single channel mode
+    size = (4096, 2 * block_size // 4096)
+    img = Image.new("L", size, 128)
+
+    with pytest.raises(ValueError):
+        img.__arrow_c_schema__()
+
+
+def test_multiblock_rgba_schema() -> None:
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in 4 channel mode
+    size = (4096, (block_size // 4096) // 2)
+    img = Image.new("RGBA", size, (128, 127, 126, 125))
+
+    with pytest.raises(ValueError):
+        img.__arrow_c_schema__()
+
+
+def test_singleblock_l_image() -> None:
+    Image.core.set_use_block_allocator(1)
+
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in 4 channel mode
+    size = (4096, 2 * (block_size // 4096))
+    img = Image.new("L", size, 128)
+    assert img.im.isblock()
+
+    (schema, arr) = img.__arrow_c_array__()
+    assert schema
+    assert arr
+
+    Image.core.set_use_block_allocator(0)
+
+
+def test_singleblock_rgba_image() -> None:
+    Image.core.set_use_block_allocator(1)
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in 4 channel mode
+    size = (4096, (block_size // 4096) // 2)
+    img = Image.new("RGBA", size, (128, 127, 126, 125))
+    assert img.im.isblock()
+
+    (schema, arr) = img.__arrow_c_array__()
+    assert schema
+    assert arr
+    Image.core.set_use_block_allocator(0)
+
+
+def test_singleblock_l_schema() -> None:
+    Image.core.set_use_block_allocator(1)
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in single channel mode
+    size = (4096, 2 * block_size // 4096)
+    img = Image.new("L", size, 128)
+    assert img.im.isblock()
+
+    schema = img.__arrow_c_schema__()
+    assert schema
+    Image.core.set_use_block_allocator(0)
+
+
+def test_singleblock_rgba_schema() -> None:
+    Image.core.set_use_block_allocator(1)
+    block_size = Image.core.get_block_size()
+
+    # check a 2 block image in 4 channel mode
+    size = (4096, (block_size // 4096) // 2)
+    img = Image.new("RGBA", size, (128, 127, 126, 125))
+    assert img.im.isblock()
+
+    schema = img.__arrow_c_schema__()
+    assert schema
+    Image.core.set_use_block_allocator(0)
diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
new file mode 100644
index 00000000000..ece9f8f2657
--- /dev/null
+++ b/Tests/test_pyarrow.py
@@ -0,0 +1,112 @@
+from __future__ import annotations
+
+from typing import Any  # undone
+
+import pytest
+
+from PIL import Image
+
+from .helper import (
+    assert_deep_equal,
+    assert_image_equal,
+    hopper,
+)
+
+pyarrow = pytest.importorskip("pyarrow", reason="PyArrow not installed")
+
+TEST_IMAGE_SIZE = (10, 10)
+
+
+def _test_img_equals_pyarray(
+    img: Image.Image, arr: Any, mask: list[int] | None
+) -> None:
+    assert img.height * img.width == len(arr)
+    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)):
+            if mask:
+                for ix, elt in enumerate(mask):
+                    pixel = px[x, y]
+                    assert isinstance(pixel, tuple)
+                    assert pixel[ix] == arr[y * img.width + x].as_py()[elt]
+            else:
+                assert_deep_equal(px[x, y], arr[y * img.width + x].as_py())
+
+
+# really hard to get a non-nullable list type
+fl_uint8_4_type = pyarrow.field(
+    "_", pyarrow.list_(pyarrow.field("_", pyarrow.uint8()).with_nullable(False), 4)
+).type
+
+
+@pytest.mark.parametrize(
+    "mode, dtype, mask",
+    (
+        ("L", pyarrow.uint8(), None),
+        ("I", pyarrow.int32(), None),
+        ("F", pyarrow.float32(), None),
+        ("LA", fl_uint8_4_type, [0, 3]),
+        ("RGB", fl_uint8_4_type, [0, 1, 2]),
+        ("RGBA", fl_uint8_4_type, None),
+        ("RGBX", fl_uint8_4_type, None),
+        ("CMYK", fl_uint8_4_type, None),
+        ("YCbCr", fl_uint8_4_type, [0, 1, 2]),
+        ("HSV", fl_uint8_4_type, [0, 1, 2]),
+    ),
+)
+def test_to_array(mode: str, dtype: Any, mask: list[int] | None) -> None:
+    img = hopper(mode)
+
+    # Resize to non-square
+    img = img.crop((3, 0, 124, 127))
+    assert img.size == (121, 127)
+
+    arr = pyarrow.array(img)
+    _test_img_equals_pyarray(img, arr, mask)
+    assert arr.type == dtype
+
+    reloaded = Image.fromarrow(arr, mode, img.size)
+
+    assert reloaded
+
+    assert_image_equal(img, reloaded)
+
+
+def test_lifetime() -> None:
+    # valgrind shouldn't error out here.
+    # arrays should be accessible after the image is deleted.
+
+    img = hopper("L")
+
+    arr_1 = pyarrow.array(img)
+    arr_2 = pyarrow.array(img)
+
+    del img
+
+    assert arr_1.sum().as_py() > 0
+    del arr_1
+
+    assert arr_2.sum().as_py() > 0
+    del arr_2
+
+
+def test_lifetime2() -> None:
+    # valgrind shouldn't error out here.
+    # img should remain after the arrays are collected.
+
+    img = hopper("L")
+
+    arr_1 = pyarrow.array(img)
+    arr_2 = pyarrow.array(img)
+
+    assert arr_1.sum().as_py() > 0
+    del arr_1
+
+    assert arr_2.sum().as_py() > 0
+    del arr_2
+
+    img2 = img.copy()
+    px = img2.load()
+    assert px  # make mypy happy
+    assert isinstance(px[0, 0], int)
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index bc3758218db..a3ba8cfd8e1 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -79,6 +79,7 @@ Constructing images
 
 .. autofunction:: new
 .. autofunction:: fromarray
+.. autofunction:: fromarrow
 .. autofunction:: frombytes
 .. autofunction:: frombuffer
 
@@ -370,6 +371,8 @@ Protocols
 
 .. autoclass:: SupportsArrayInterface
     :show-inheritance:
+.. autoclass:: SupportsArrowArrayInterface
+    :show-inheritance:
 .. autoclass:: SupportsGetData
     :show-inheritance:
 
diff --git a/docs/reference/arrow_support.rst b/docs/reference/arrow_support.rst
new file mode 100644
index 00000000000..4a5c45e8624
--- /dev/null
+++ b/docs/reference/arrow_support.rst
@@ -0,0 +1,88 @@
+.. _arrow-support:
+
+=============
+Arrow Support
+=============
+
+`Arrow <https://arrow.apache.org/>`__
+is an in-memory data exchange format that is the spiritual
+successor to the NumPy array interface. It provides for zero-copy
+access to columnar data, which in our case is ``Image`` data.
+
+The goal with Arrow is to provide native zero-copy interoperability
+with any Arrow provider or consumer in the Python ecosystem.
+
+.. warning:: Zero-copy does not mean zero allocation -- the internal
+  memory layout of Pillow images contains an allocation for row
+  pointers, so there is a non-zero, but significantly smaller than a
+  full-copy memory cost to reading an Arrow image.
+
+
+Data Formats
+============
+
+Pillow currently supports exporting Arrow images in all modes
+**except** for ``BGR;15``, ``BGR;16`` and ``BGR;24``. This is due to
+line-length packing in these modes making for non-continuous memory.
+
+For single-band images, the exported array is width*height elements,
+with each pixel corresponding to the appropriate Arrow type.
+
+For multiband images, the exported array is width*height fixed-length
+four-element arrays of uint8. This is memory compatible with the raw
+image storage of four bytes per pixel.
+
+Mode ``1`` images are exported as one uint8 byte/pixel, as this is
+consistent with the internal storage.
+
+Pillow will accept, but not produce, one other format. For any
+multichannel image with 32-bit storage per pixel, Pillow will accept
+an array of width*height int32 elements, which will then be
+interpreted using the mode-specific interpretation of the bytes.
+
+The image mode must match the Arrow band format when reading single
+channel images.
+
+Memory Allocator
+================
+
+Pillow's default memory allocator, the :ref:`block_allocator`,
+allocates up to a 16 MB block for images by default. Larger images
+overflow into additional blocks. Arrow requires a single continuous
+memory allocation, so images allocated in multiple blocks cannot be
+exported in the Arrow format.
+
+To enable the single block allocator::
+
+  from PIL import Image
+  Image.core.set_use_block_allocator(1)
+
+Note that this is a global setting, not a per-image setting.
+
+Unsupported Features
+====================
+
+* Table/dataframe protocol. We support a single array.
+* Null markers, producing or consuming. Null values are inferred from
+  the mode, e.g. RGB images are stored in the first three bytes of
+  each 32-bit pixel, and the last byte is an implied null.
+* Schema negotiation. There is an optional schema for the requested
+  datatype in the Arrow source interface. We ignore that
+  parameter.
+* Array metadata.
+
+Internal Details
+================
+
+Python Arrow C interface:
+https://arrow.apache.org/docs/format/CDataInterface/PyCapsuleInterface.html
+
+The memory that is exported from the Arrow interface is shared -- not
+copied, so the lifetime of the memory allocation is no longer strictly
+tied to the life of the Python object.
+
+The core imaging struct now has a refcount associated with it, and the
+lifetime of the core image struct is now divorced from the Python
+image object. Creating an arrow reference to the image increments the
+refcount, and the imaging struct is only released when the refcount
+reaches zero.
diff --git a/docs/reference/block_allocator.rst b/docs/reference/block_allocator.rst
index 1abe5280fbf..f4d27e24e57 100644
--- a/docs/reference/block_allocator.rst
+++ b/docs/reference/block_allocator.rst
@@ -1,3 +1,6 @@
+
+.. _block_allocator:
+
 Block Allocator
 ===============
 
diff --git a/docs/reference/internal_design.rst b/docs/reference/internal_design.rst
index 99a18e9ea99..0411779535b 100644
--- a/docs/reference/internal_design.rst
+++ b/docs/reference/internal_design.rst
@@ -9,3 +9,4 @@ Internal Reference
   block_allocator
   internal_modules
   c_extension_debugging
+  arrow_support
diff --git a/pyproject.toml b/pyproject.toml
index 780a938a32c..8564192154d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -54,6 +54,10 @@ optional-dependencies.fpx = [
 optional-dependencies.mic = [
   "olefile",
 ]
+optional-dependencies.test-arrow = [
+  "pyarrow",
+]
+
 optional-dependencies.tests = [
   "check-manifest",
   "coverage>=7.4.2",
@@ -67,6 +71,7 @@ optional-dependencies.tests = [
   "pytest-timeout",
   "trove-classifiers>=2024.10.12",
 ]
+
 optional-dependencies.typing = [
   "typing-extensions; python_version<'3.10'",
 ]
diff --git a/setup.py b/setup.py
index 9d69b1d6ea6..5ecd6b8160a 100644
--- a/setup.py
+++ b/setup.py
@@ -65,6 +65,7 @@ def get_version() -> str:
 _LIB_IMAGING = (
     "Access",
     "AlphaComposite",
+    "Arrow",
     "Resample",
     "Reduce",
     "Bands",
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 60850f4ffaf..233df592c33 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -577,6 +577,14 @@ def size(self) -> tuple[int, int]:
     def mode(self) -> str:
         return self._mode
 
+    @property
+    def readonly(self) -> int:
+        return (self._im and self._im.readonly) or self._readonly
+
+    @readonly.setter
+    def readonly(self, readonly: int) -> None:
+        self._readonly = readonly
+
     def _new(self, im: core.ImagingCore) -> Image:
         new = Image()
         new.im = im
@@ -728,6 +736,16 @@ def __array_interface__(self) -> dict[str, str | bytes | int | tuple[int, ...]]:
         new["shape"], new["typestr"] = _conv_type_shape(self)
         return new
 
+    def __arrow_c_schema__(self) -> object:
+        self.load()
+        return self.im.__arrow_c_schema__()
+
+    def __arrow_c_array__(
+        self, requested_schema: object | None = None
+    ) -> tuple[object, object]:
+        self.load()
+        return (self.im.__arrow_c_schema__(), self.im.__arrow_c_array__())
+
     def __getstate__(self) -> list[Any]:
         im_data = self.tobytes()  # load image first
         return [self.info, self.mode, self.size, self.getpalette(), im_data]
@@ -3201,6 +3219,18 @@ def __array_interface__(self) -> dict[str, Any]:
         raise NotImplementedError()
 
 
+class SupportsArrowArrayInterface(Protocol):
+    """
+    An object that has an ``__arrow_c_array__`` method corresponding to the arrow c
+    data interface.
+    """
+
+    def __arrow_c_array__(
+        self, requested_schema: "PyCapsule" = None  # type: ignore[name-defined]  # noqa: F821, UP037
+    ) -> tuple["PyCapsule", "PyCapsule"]:  # type: ignore[name-defined]  # noqa: F821, UP037
+        raise NotImplementedError()
+
+
 def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     """
     Creates an image memory from an object exporting the array interface
@@ -3289,6 +3319,56 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     return frombuffer(mode, size, obj, "raw", rawmode, 0, 1)
 
 
+def fromarrow(obj: SupportsArrowArrayInterface, mode, size) -> Image:
+    """Creates an image with zero-copy shared memory from an object exporting
+    the arrow_c_array interface protocol::
+
+      from PIL import Image
+      import pyarrow as pa
+      arr = pa.array([0]*(5*5*4), type=pa.uint8())
+      im = Image.fromarrow(arr, 'RGBA', (5, 5))
+
+    If the data representation of the ``obj`` is not compatible with
+    Pillow internal storage, a ValueError is raised.
+
+    Pillow images can also be converted to Arrow objects::
+
+      from PIL import Image
+      import pyarrow as pa
+      im = Image.open('hopper.jpg')
+      arr = pa.array(im)
+
+    As with array support, when converting Pillow images to arrays,
+    only pixel values are transferred. This means that P and PA mode
+    images will lose their palette.
+
+    :param obj: Object with an arrow_c_array interface
+    :param mode: Image mode.
+    :param size: Image size. This must match the storage of the arrow object.
+    :returns: An Image object
+
+    Note that according to the Arrow spec, both the producer and the
+    consumer should consider the exported array to be immutable, as
+    unsynchronized updates will potentially cause inconsistent data.
+
+    See: :ref:`arrow-support` for more detailed information
+
+    .. versionadded:: 11.2.0
+
+    """
+    if not hasattr(obj, "__arrow_c_array__"):
+        msg = "arrow_c_array interface not found"
+        raise ValueError(msg)
+
+    (schema_capsule, array_capsule) = obj.__arrow_c_array__()
+    _im = core.new_arrow(mode, size, schema_capsule, array_capsule)
+    if _im:
+        return Image()._new(_im)
+
+    msg = "new_arrow returned None without an exception"
+    raise ValueError(msg)
+
+
 def fromqimage(im: ImageQt.QImage) -> ImageFile.ImageFile:
     """Creates an image instance from a QImage image"""
     from . import ImageQt
diff --git a/src/_imaging.c b/src/_imaging.c
index 330a7eef401..72f12214390 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -230,6 +230,93 @@ PyImaging_GetBuffer(PyObject *buffer, Py_buffer *view) {
     return PyObject_GetBuffer(buffer, view, PyBUF_SIMPLE);
 }
 
+/* -------------------------------------------------------------------- */
+/* Arrow HANDLING                                                       */
+/* -------------------------------------------------------------------- */
+
+PyObject *
+ArrowError(int err) {
+    if (err == IMAGING_CODEC_MEMORY) {
+        return ImagingError_MemoryError();
+    }
+    if (err == IMAGING_ARROW_INCOMPATIBLE_MODE) {
+        return ImagingError_ValueError("Incompatible Pillow mode for Arrow array");
+    }
+    if (err == IMAGING_ARROW_MEMORY_LAYOUT) {
+        return ImagingError_ValueError(
+            "Image is in multiple array blocks, use imaging_new_block for zero copy"
+        );
+    }
+    return ImagingError_ValueError("Unknown error");
+}
+
+void
+ReleaseArrowSchemaPyCapsule(PyObject *capsule) {
+    struct ArrowSchema *schema =
+        (struct ArrowSchema *)PyCapsule_GetPointer(capsule, "arrow_schema");
+    if (schema->release != NULL) {
+        schema->release(schema);
+    }
+    free(schema);
+}
+
+PyObject *
+ExportArrowSchemaPyCapsule(ImagingObject *self) {
+    struct ArrowSchema *schema =
+        (struct ArrowSchema *)calloc(1, sizeof(struct ArrowSchema));
+    int err = export_imaging_schema(self->image, schema);
+    if (err == 0) {
+        return PyCapsule_New(schema, "arrow_schema", ReleaseArrowSchemaPyCapsule);
+    }
+    free(schema);
+    return ArrowError(err);
+}
+
+void
+ReleaseArrowArrayPyCapsule(PyObject *capsule) {
+    struct ArrowArray *array =
+        (struct ArrowArray *)PyCapsule_GetPointer(capsule, "arrow_array");
+    if (array->release != NULL) {
+        array->release(array);
+    }
+    free(array);
+}
+
+PyObject *
+ExportArrowArrayPyCapsule(ImagingObject *self) {
+    struct ArrowArray *array =
+        (struct ArrowArray *)calloc(1, sizeof(struct ArrowArray));
+    int err = export_imaging_array(self->image, array);
+    if (err == 0) {
+        return PyCapsule_New(array, "arrow_array", ReleaseArrowArrayPyCapsule);
+    }
+    free(array);
+    return ArrowError(err);
+}
+
+static PyObject *
+_new_arrow(PyObject *self, PyObject *args) {
+    char *mode;
+    int xsize, ysize;
+    PyObject *schema_capsule, *array_capsule;
+    PyObject *ret;
+
+    if (!PyArg_ParseTuple(
+            args, "s(ii)OO", &mode, &xsize, &ysize, &schema_capsule, &array_capsule
+        )) {
+        return NULL;
+    }
+
+    // ImagingBorrowArrow is responsible for retaining the array_capsule
+    ret =
+        PyImagingNew(ImagingNewArrow(mode, xsize, ysize, schema_capsule, array_capsule)
+        );
+    if (!ret) {
+        return ImagingError_ValueError("Invalid Arrow array mode or size mismatch");
+    }
+    return ret;
+}
+
 /* -------------------------------------------------------------------- */
 /* EXCEPTION REROUTING                                                  */
 /* -------------------------------------------------------------------- */
@@ -3655,6 +3742,10 @@ static struct PyMethodDef methods[] = {
     /* Misc. */
     {"save_ppm", (PyCFunction)_save_ppm, METH_VARARGS},
 
+    /* arrow */
+    {"__arrow_c_schema__", (PyCFunction)ExportArrowSchemaPyCapsule, METH_VARARGS},
+    {"__arrow_c_array__", (PyCFunction)ExportArrowArrayPyCapsule, METH_VARARGS},
+
     {NULL, NULL} /* sentinel */
 };
 
@@ -3722,6 +3813,11 @@ _getattr_unsafe_ptrs(ImagingObject *self, void *closure) {
     );
 }
 
+static PyObject *
+_getattr_readonly(ImagingObject *self, void *closure) {
+    return PyLong_FromLong(self->image->read_only);
+}
+
 static struct PyGetSetDef getsetters[] = {
     {"mode", (getter)_getattr_mode},
     {"size", (getter)_getattr_size},
@@ -3729,6 +3825,7 @@ static struct PyGetSetDef getsetters[] = {
     {"id", (getter)_getattr_id},
     {"ptr", (getter)_getattr_ptr},
     {"unsafe_ptrs", (getter)_getattr_unsafe_ptrs},
+    {"readonly", (getter)_getattr_readonly},
     {NULL}
 };
 
@@ -3983,6 +4080,21 @@ _set_blocks_max(PyObject *self, PyObject *args) {
     Py_RETURN_NONE;
 }
 
+static PyObject *
+_set_use_block_allocator(PyObject *self, PyObject *args) {
+    int use_block_allocator;
+    if (!PyArg_ParseTuple(args, "i:set_use_block_allocator", &use_block_allocator)) {
+        return NULL;
+    }
+    ImagingMemorySetBlockAllocator(&ImagingDefaultArena, use_block_allocator);
+    Py_RETURN_NONE;
+}
+
+static PyObject *
+_get_use_block_allocator(PyObject *self, PyObject *args) {
+    return PyLong_FromLong(ImagingDefaultArena.use_block_allocator);
+}
+
 static PyObject *
 _clear_cache(PyObject *self, PyObject *args) {
     int i = 0;
@@ -4104,6 +4216,7 @@ static PyMethodDef functions[] = {
     {"fill", (PyCFunction)_fill, METH_VARARGS},
     {"new", (PyCFunction)_new, METH_VARARGS},
     {"new_block", (PyCFunction)_new_block, METH_VARARGS},
+    {"new_arrow", (PyCFunction)_new_arrow, METH_VARARGS},
     {"merge", (PyCFunction)_merge, METH_VARARGS},
 
     /* Functions */
@@ -4190,9 +4303,11 @@ static PyMethodDef functions[] = {
     {"get_alignment", (PyCFunction)_get_alignment, METH_VARARGS},
     {"get_block_size", (PyCFunction)_get_block_size, METH_VARARGS},
     {"get_blocks_max", (PyCFunction)_get_blocks_max, METH_VARARGS},
+    {"get_use_block_allocator", (PyCFunction)_get_use_block_allocator, METH_VARARGS},
     {"set_alignment", (PyCFunction)_set_alignment, METH_VARARGS},
     {"set_block_size", (PyCFunction)_set_block_size, METH_VARARGS},
     {"set_blocks_max", (PyCFunction)_set_blocks_max, METH_VARARGS},
+    {"set_use_block_allocator", (PyCFunction)_set_use_block_allocator, METH_VARARGS},
     {"clear_cache", (PyCFunction)_clear_cache, METH_VARARGS},
 
     {NULL, NULL} /* sentinel */
diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
new file mode 100644
index 00000000000..33ff2ce779a
--- /dev/null
+++ b/src/libImaging/Arrow.c
@@ -0,0 +1,299 @@
+
+#include "Arrow.h"
+#include "Imaging.h"
+#include <string.h>
+
+/* struct ArrowSchema* */
+/* _arrow_schema_channel(char* channel, char* format) { */
+
+/* } */
+
+static void
+ReleaseExportedSchema(struct ArrowSchema *array) {
+    // This should not be called on already released array
+    // assert(array->release != NULL);
+
+    if (!array->release) {
+        return;
+    }
+    if (array->format) {
+        free((void *)array->format);
+        array->format = NULL;
+    }
+    if (array->name) {
+        free((void *)array->name);
+        array->name = NULL;
+    }
+    if (array->metadata) {
+        free((void *)array->metadata);
+        array->metadata = NULL;
+    }
+
+    // Release children
+    for (int64_t i = 0; i < array->n_children; ++i) {
+        struct ArrowSchema *child = array->children[i];
+        if (child->release != NULL) {
+            child->release(child);
+            child->release = NULL;
+        }
+        // UNDONE -- should I be releasing the children?
+    }
+
+    // Release dictionary
+    struct ArrowSchema *dict = array->dictionary;
+    if (dict != NULL && dict->release != NULL) {
+        dict->release(dict);
+        dict->release = NULL;
+    }
+
+    // TODO here: release and/or deallocate all data directly owned by
+    // the ArrowArray struct, such as the private_data.
+
+    // Mark array released
+    array->release = NULL;
+}
+
+int
+export_named_type(struct ArrowSchema *schema, char *format, char *name) {
+    char *formatp;
+    char *namep;
+    size_t format_len = strlen(format) + 1;
+    size_t name_len = strlen(name) + 1;
+
+    formatp = calloc(format_len, 1);
+
+    if (!formatp) {
+        return IMAGING_CODEC_MEMORY;
+    }
+
+    namep = calloc(name_len, 1);
+    if (!namep) {
+        free(formatp);
+        return IMAGING_CODEC_MEMORY;
+    }
+
+    strncpy(formatp, format, format_len);
+    strncpy(namep, name, name_len);
+
+    *schema = (struct ArrowSchema){// Type description
+                                   .format = formatp,
+                                   .name = namep,
+                                   .metadata = NULL,
+                                   .flags = 0,
+                                   .n_children = 0,
+                                   .children = NULL,
+                                   .dictionary = NULL,
+                                   // Bookkeeping
+                                   .release = &ReleaseExportedSchema
+    };
+    return 0;
+}
+
+int
+export_imaging_schema(Imaging im, struct ArrowSchema *schema) {
+    int retval = 0;
+
+    if (strcmp(im->arrow_band_format, "") == 0) {
+        return IMAGING_ARROW_INCOMPATIBLE_MODE;
+    }
+
+    /* for now, single block images */
+    if (!(im->blocks_count == 0 || im->blocks_count == 1)) {
+        return IMAGING_ARROW_MEMORY_LAYOUT;
+    }
+
+    if (im->bands == 1) {
+        return export_named_type(schema, im->arrow_band_format, im->band_names[0]);
+    }
+
+    retval = export_named_type(schema, "+w:4", "");
+    if (retval != 0) {
+        return retval;
+    }
+    // if it's not 1 band, it's an int32 at the moment. 4 uint8 bands.
+    schema->n_children = 1;
+    schema->children = calloc(1, sizeof(struct ArrowSchema *));
+    schema->children[0] = (struct ArrowSchema *)calloc(1, sizeof(struct ArrowSchema));
+    retval = export_named_type(schema->children[0], im->arrow_band_format, "pixel");
+    if (retval != 0) {
+        free(schema->children[0]);
+        schema->release(schema);
+        return retval;
+    }
+    return 0;
+}
+
+static void
+release_const_array(struct ArrowArray *array) {
+    Imaging im = (Imaging)array->private_data;
+
+    if (array->n_children == 0) {
+        ImagingDelete(im);
+    }
+
+    //  Free the buffers and the buffers array
+    if (array->buffers) {
+        free(array->buffers);
+        array->buffers = NULL;
+    }
+    if (array->children) {
+        // undone -- does arrow release all the children recursively?
+        for (int i = 0; i < array->n_children; i++) {
+            if (array->children[i]->release) {
+                array->children[i]->release(array->children[i]);
+                array->children[i]->release = NULL;
+                free(array->children[i]);
+            }
+        }
+        free(array->children);
+        array->children = NULL;
+    }
+    // Mark released
+    array->release = NULL;
+}
+
+int
+export_single_channel_array(Imaging im, struct ArrowArray *array) {
+    int length = im->xsize * im->ysize;
+
+    /* for now, single block images */
+    if (!(im->blocks_count == 0 || im->blocks_count == 1)) {
+        return IMAGING_ARROW_MEMORY_LAYOUT;
+    }
+
+    if (im->lines_per_block && im->lines_per_block < im->ysize) {
+        length = im->xsize * im->lines_per_block;
+    }
+
+    MUTEX_LOCK(&im->mutex);
+    im->refcount++;
+    MUTEX_UNLOCK(&im->mutex);
+    // Initialize primitive fields
+    *array = (struct ArrowArray){// Data description
+                                 .length = length,
+                                 .offset = 0,
+                                 .null_count = 0,
+                                 .n_buffers = 2,
+                                 .n_children = 0,
+                                 .children = NULL,
+                                 .dictionary = NULL,
+                                 // Bookkeeping
+                                 .release = &release_const_array,
+                                 .private_data = im
+    };
+
+    // Allocate list of buffers
+    array->buffers = (const void **)malloc(sizeof(void *) * array->n_buffers);
+    // assert(array->buffers != NULL);
+    array->buffers[0] = NULL;  // no nulls, null bitmap can be omitted
+
+    if (im->block) {
+        array->buffers[1] = im->block;
+    } else {
+        array->buffers[1] = im->blocks[0].ptr;
+    }
+    return 0;
+}
+
+int
+export_fixed_pixel_array(Imaging im, struct ArrowArray *array) {
+    int length = im->xsize * im->ysize;
+
+    /* for now, single block images */
+    if (!(im->blocks_count == 0 || im->blocks_count == 1)) {
+        return IMAGING_ARROW_MEMORY_LAYOUT;
+    }
+
+    if (im->lines_per_block && im->lines_per_block < im->ysize) {
+        length = im->xsize * im->lines_per_block;
+    }
+
+    MUTEX_LOCK(&im->mutex);
+    im->refcount++;
+    MUTEX_UNLOCK(&im->mutex);
+    // Initialize primitive fields
+    // Fixed length arrays are 1 buffer of validity, and the length in pixels.
+    // Data is in a child array.
+    *array = (struct ArrowArray){// Data description
+                                 .length = length,
+                                 .offset = 0,
+                                 .null_count = 0,
+                                 .n_buffers = 1,
+                                 .n_children = 1,
+                                 .children = NULL,
+                                 .dictionary = NULL,
+                                 // Bookkeeping
+                                 .release = &release_const_array,
+                                 .private_data = im
+    };
+
+    // Allocate list of buffers
+    array->buffers = (const void **)calloc(1, sizeof(void *) * array->n_buffers);
+    if (!array->buffers) {
+        goto err;
+    }
+    // assert(array->buffers != NULL);
+    array->buffers[0] = NULL;  // no nulls, null bitmap can be omitted
+
+    // if it's not 1 band, it's an int32 at the moment. 4 uint8 bands.
+    array->n_children = 1;
+    array->children = calloc(1, sizeof(struct ArrowArray *));
+    if (!array->children) {
+        goto err;
+    }
+    array->children[0] = (struct ArrowArray *)calloc(1, sizeof(struct ArrowArray));
+    if (!array->children[0]) {
+        goto err;
+    }
+
+    MUTEX_LOCK(&im->mutex);
+    im->refcount++;
+    MUTEX_UNLOCK(&im->mutex);
+    *array->children[0] = (struct ArrowArray){// Data description
+                                              .length = length * 4,
+                                              .offset = 0,
+                                              .null_count = 0,
+                                              .n_buffers = 2,
+                                              .n_children = 0,
+                                              .children = NULL,
+                                              .dictionary = NULL,
+                                              // Bookkeeping
+                                              .release = &release_const_array,
+                                              .private_data = im
+    };
+
+    array->children[0]->buffers =
+        (const void **)calloc(2, sizeof(void *) * array->n_buffers);
+
+    if (im->block) {
+        array->children[0]->buffers[1] = im->block;
+    } else {
+        array->children[0]->buffers[1] = im->blocks[0].ptr;
+    }
+    return 0;
+
+err:
+    if (array->children[0]) {
+        free(array->children[0]);
+    }
+    if (array->children) {
+        free(array->children);
+    }
+    if (array->buffers) {
+        free(array->buffers);
+    }
+    return IMAGING_CODEC_MEMORY;
+}
+
+int
+export_imaging_array(Imaging im, struct ArrowArray *array) {
+    if (strcmp(im->arrow_band_format, "") == 0) {
+        return IMAGING_ARROW_INCOMPATIBLE_MODE;
+    }
+
+    if (im->bands == 1) {
+        return export_single_channel_array(im, array);
+    }
+
+    return export_fixed_pixel_array(im, array);
+}
diff --git a/src/libImaging/Arrow.h b/src/libImaging/Arrow.h
new file mode 100644
index 00000000000..0b285fe8053
--- /dev/null
+++ b/src/libImaging/Arrow.h
@@ -0,0 +1,48 @@
+#include <stdint.h>
+#include <assert.h>
+
+// Apache License 2.0.
+// Source apache arrow project
+// https://arrow.apache.org/docs/format/CDataInterface.html
+
+#ifndef ARROW_C_DATA_INTERFACE
+#define ARROW_C_DATA_INTERFACE
+
+#define ARROW_FLAG_DICTIONARY_ORDERED 1
+#define ARROW_FLAG_NULLABLE 2
+#define ARROW_FLAG_MAP_KEYS_SORTED 4
+
+struct ArrowSchema {
+    // Array type description
+    const char *format;
+    const char *name;
+    const char *metadata;
+    int64_t flags;
+    int64_t n_children;
+    struct ArrowSchema **children;
+    struct ArrowSchema *dictionary;
+
+    // Release callback
+    void (*release)(struct ArrowSchema *);
+    // Opaque producer-specific data
+    void *private_data;
+};
+
+struct ArrowArray {
+    // Array data description
+    int64_t length;
+    int64_t null_count;
+    int64_t offset;
+    int64_t n_buffers;
+    int64_t n_children;
+    const void **buffers;
+    struct ArrowArray **children;
+    struct ArrowArray *dictionary;
+
+    // Release callback
+    void (*release)(struct ArrowArray *);
+    // Opaque producer-specific data
+    void *private_data;
+};
+
+#endif  // ARROW_C_DATA_INTERFACE
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 0fc191d158b..234f9943c5a 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -20,6 +20,8 @@ extern "C" {
 #define M_PI 3.1415926535897932384626433832795
 #endif
 
+#include "Arrow.h"
+
 /* -------------------------------------------------------------------- */
 
 /*
@@ -104,6 +106,21 @@ struct ImagingMemoryInstance {
 
     /* Virtual methods */
     void (*destroy)(Imaging im);
+
+    /* arrow */
+    int refcount;              /* Number of arrow arrays that have been allocated */
+    char band_names[4][3];     /* names of bands, max 2 char + null terminator */
+    char arrow_band_format[2]; /* single character + null terminator */
+
+    int read_only; /* flag for read-only. set for arrow borrowed arrays */
+    PyObject *arrow_array_capsule; /* upstream arrow array source */
+
+    int blocks_count;    /* Number of blocks that have been allocated */
+    int lines_per_block; /* Number of lines in a block have been allocated */
+
+#ifdef Py_GIL_DISABLED
+    PyMutex mutex;
+#endif
 };
 
 #define IMAGING_PIXEL_1(im, x, y) ((im)->image8[(y)][(x)])
@@ -161,6 +178,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 */
+    int use_block_allocator;      /* don't use arena, use block allocator */
 #ifdef Py_GIL_DISABLED
     PyMutex mutex;
 #endif
@@ -174,6 +192,8 @@ extern int
 ImagingMemorySetBlocksMax(ImagingMemoryArena arena, int blocks_max);
 extern void
 ImagingMemoryClearCache(ImagingMemoryArena arena, int new_size);
+extern void
+ImagingMemorySetBlockAllocator(ImagingMemoryArena arena, int use_block_allocator);
 
 extern Imaging
 ImagingNew(const char *mode, int xsize, int ysize);
@@ -187,6 +207,15 @@ ImagingDelete(Imaging im);
 extern Imaging
 ImagingNewBlock(const char *mode, int xsize, int ysize);
 
+extern Imaging
+ImagingNewArrow(
+    const char *mode,
+    int xsize,
+    int ysize,
+    PyObject *schema_capsule,
+    PyObject *array_capsule
+);
+
 extern Imaging
 ImagingNewPrologue(const char *mode, int xsize, int ysize);
 extern Imaging
@@ -700,6 +729,13 @@ _imaging_seek_pyFd(PyObject *fd, Py_ssize_t offset, int whence);
 extern Py_ssize_t
 _imaging_tell_pyFd(PyObject *fd);
 
+/* Arrow */
+
+extern int
+export_imaging_array(Imaging im, struct ArrowArray *array);
+extern int
+export_imaging_schema(Imaging im, struct ArrowSchema *schema);
+
 /* Errcodes */
 #define IMAGING_CODEC_END 1
 #define IMAGING_CODEC_OVERRUN -1
@@ -707,6 +743,8 @@ _imaging_tell_pyFd(PyObject *fd);
 #define IMAGING_CODEC_UNKNOWN -3
 #define IMAGING_CODEC_CONFIG -8
 #define IMAGING_CODEC_MEMORY -9
+#define IMAGING_ARROW_INCOMPATIBLE_MODE -10
+#define IMAGING_ARROW_MEMORY_LAYOUT -11
 
 #include "ImagingUtils.h"
 extern UINT8 *clip8_lookups;
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 522e9f37557..4fa4ecd1ce4 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -58,19 +58,22 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
     /* Setup image descriptor */
     im->xsize = xsize;
     im->ysize = ysize;
-
+    im->refcount = 1;
     im->type = IMAGING_TYPE_UINT8;
+    strcpy(im->arrow_band_format, "C");
 
     if (strcmp(mode, "1") == 0) {
         /* 1-bit images */
         im->bands = im->pixelsize = 1;
         im->linesize = xsize;
+        strcpy(im->band_names[0], "1");
 
     } else if (strcmp(mode, "P") == 0) {
         /* 8-bit palette mapped images */
         im->bands = im->pixelsize = 1;
         im->linesize = xsize;
         im->palette = ImagingPaletteNew("RGB");
+        strcpy(im->band_names[0], "P");
 
     } else if (strcmp(mode, "PA") == 0) {
         /* 8-bit palette with alpha */
@@ -78,23 +81,36 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->pixelsize = 4; /* store in image32 memory */
         im->linesize = xsize * 4;
         im->palette = ImagingPaletteNew("RGB");
+        strcpy(im->band_names[0], "P");
+        strcpy(im->band_names[1], "X");
+        strcpy(im->band_names[2], "X");
+        strcpy(im->band_names[3], "A");
 
     } else if (strcmp(mode, "L") == 0) {
         /* 8-bit grayscale (luminance) images */
         im->bands = im->pixelsize = 1;
         im->linesize = xsize;
+        strcpy(im->band_names[0], "L");
 
     } else if (strcmp(mode, "LA") == 0) {
         /* 8-bit grayscale (luminance) with alpha */
         im->bands = 2;
         im->pixelsize = 4; /* store in image32 memory */
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "L");
+        strcpy(im->band_names[1], "X");
+        strcpy(im->band_names[2], "X");
+        strcpy(im->band_names[3], "A");
 
     } else if (strcmp(mode, "La") == 0) {
         /* 8-bit grayscale (luminance) with premultiplied alpha */
         im->bands = 2;
         im->pixelsize = 4; /* store in image32 memory */
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "L");
+        strcpy(im->band_names[1], "X");
+        strcpy(im->band_names[2], "X");
+        strcpy(im->band_names[3], "a");
 
     } else if (strcmp(mode, "F") == 0) {
         /* 32-bit floating point images */
@@ -102,6 +118,8 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->pixelsize = 4;
         im->linesize = xsize * 4;
         im->type = IMAGING_TYPE_FLOAT32;
+        strcpy(im->arrow_band_format, "f");
+        strcpy(im->band_names[0], "F");
 
     } else if (strcmp(mode, "I") == 0) {
         /* 32-bit integer images */
@@ -109,6 +127,8 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->pixelsize = 4;
         im->linesize = xsize * 4;
         im->type = IMAGING_TYPE_INT32;
+        strcpy(im->arrow_band_format, "i");
+        strcpy(im->band_names[0], "I");
 
     } else if (strcmp(mode, "I;16") == 0 || strcmp(mode, "I;16L") == 0 ||
                strcmp(mode, "I;16B") == 0 || strcmp(mode, "I;16N") == 0) {
@@ -118,12 +138,18 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->pixelsize = 2;
         im->linesize = xsize * 2;
         im->type = IMAGING_TYPE_SPECIAL;
+        strcpy(im->arrow_band_format, "s");
+        strcpy(im->band_names[0], "I");
 
     } else if (strcmp(mode, "RGB") == 0) {
         /* 24-bit true colour images */
         im->bands = 3;
         im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "R");
+        strcpy(im->band_names[1], "G");
+        strcpy(im->band_names[2], "B");
+        strcpy(im->band_names[3], "X");
 
     } else if (strcmp(mode, "BGR;15") == 0) {
         /* EXPERIMENTAL */
@@ -132,6 +158,8 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->pixelsize = 2;
         im->linesize = (xsize * 2 + 3) & -4;
         im->type = IMAGING_TYPE_SPECIAL;
+        /* not allowing arrow due to line length packing */
+        strcpy(im->arrow_band_format, "");
 
     } else if (strcmp(mode, "BGR;16") == 0) {
         /* EXPERIMENTAL */
@@ -140,6 +168,8 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->pixelsize = 2;
         im->linesize = (xsize * 2 + 3) & -4;
         im->type = IMAGING_TYPE_SPECIAL;
+        /* not allowing arrow due to line length packing */
+        strcpy(im->arrow_band_format, "");
 
     } else if (strcmp(mode, "BGR;24") == 0) {
         /* EXPERIMENTAL */
@@ -148,32 +178,54 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->pixelsize = 3;
         im->linesize = (xsize * 3 + 3) & -4;
         im->type = IMAGING_TYPE_SPECIAL;
+        /* not allowing arrow due to line length packing */
+        strcpy(im->arrow_band_format, "");
 
     } else if (strcmp(mode, "RGBX") == 0) {
         /* 32-bit true colour images with padding */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "R");
+        strcpy(im->band_names[1], "G");
+        strcpy(im->band_names[2], "B");
+        strcpy(im->band_names[3], "X");
 
     } else if (strcmp(mode, "RGBA") == 0) {
         /* 32-bit true colour images with alpha */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "R");
+        strcpy(im->band_names[1], "G");
+        strcpy(im->band_names[2], "B");
+        strcpy(im->band_names[3], "A");
 
     } else if (strcmp(mode, "RGBa") == 0) {
         /* 32-bit true colour images with premultiplied alpha */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "R");
+        strcpy(im->band_names[1], "G");
+        strcpy(im->band_names[2], "B");
+        strcpy(im->band_names[3], "a");
 
     } else if (strcmp(mode, "CMYK") == 0) {
         /* 32-bit colour separation */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "C");
+        strcpy(im->band_names[1], "M");
+        strcpy(im->band_names[2], "Y");
+        strcpy(im->band_names[3], "K");
 
     } else if (strcmp(mode, "YCbCr") == 0) {
         /* 24-bit video format */
         im->bands = 3;
         im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "Y");
+        strcpy(im->band_names[1], "Cb");
+        strcpy(im->band_names[2], "Cr");
+        strcpy(im->band_names[3], "X");
 
     } else if (strcmp(mode, "LAB") == 0) {
         /* 24-bit color, luminance, + 2 color channels */
@@ -181,6 +233,10 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->bands = 3;
         im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "L");
+        strcpy(im->band_names[1], "a");
+        strcpy(im->band_names[2], "b");
+        strcpy(im->band_names[3], "X");
 
     } else if (strcmp(mode, "HSV") == 0) {
         /* 24-bit color, luminance, + 2 color channels */
@@ -188,6 +244,10 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         im->bands = 3;
         im->pixelsize = 4;
         im->linesize = xsize * 4;
+        strcpy(im->band_names[0], "H");
+        strcpy(im->band_names[1], "S");
+        strcpy(im->band_names[2], "V");
+        strcpy(im->band_names[3], "X");
 
     } else {
         free(im);
@@ -218,6 +278,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
             break;
     }
 
+    // UNDONE -- not accurate for arrow
     MUTEX_LOCK(&ImagingDefaultArena.mutex);
     ImagingDefaultArena.stats_new_count += 1;
     MUTEX_UNLOCK(&ImagingDefaultArena.mutex);
@@ -238,8 +299,18 @@ ImagingDelete(Imaging im) {
         return;
     }
 
+    MUTEX_LOCK(&im->mutex);
+    im->refcount--;
+
+    if (im->refcount > 0) {
+        MUTEX_UNLOCK(&im->mutex);
+        return;
+    }
+    MUTEX_UNLOCK(&im->mutex);
+
     if (im->palette) {
         ImagingPaletteDelete(im->palette);
+        im->palette = NULL;
     }
 
     if (im->destroy) {
@@ -270,6 +341,7 @@ struct ImagingMemoryArena ImagingDefaultArena = {
     0,
     0,
     0,  // Stats
+    0,  // use_block_allocator
 #ifdef Py_GIL_DISABLED
     {0},
 #endif
@@ -302,6 +374,11 @@ ImagingMemorySetBlocksMax(ImagingMemoryArena arena, int blocks_max) {
     return 1;
 }
 
+void
+ImagingMemorySetBlockAllocator(ImagingMemoryArena arena, int use_block_allocator) {
+    arena->use_block_allocator = use_block_allocator;
+}
+
 void
 ImagingMemoryClearCache(ImagingMemoryArena arena, int new_size) {
     while (arena->blocks_cached > new_size) {
@@ -396,11 +473,13 @@ ImagingAllocateArray(Imaging im, ImagingMemoryArena arena, int dirty, int block_
     if (lines_per_block == 0) {
         lines_per_block = 1;
     }
+    im->lines_per_block = lines_per_block;
     blocks_count = (im->ysize + lines_per_block - 1) / lines_per_block;
     // printf("NEW size: %dx%d, ls: %d, lpb: %d, blocks: %d\n",
     //        im->xsize, im->ysize, aligned_linesize, lines_per_block, blocks_count);
 
     /* One extra pointer is always NULL */
+    im->blocks_count = blocks_count;
     im->blocks = calloc(sizeof(*im->blocks), blocks_count + 1);
     if (!im->blocks) {
         return (Imaging)ImagingError_MemoryError();
@@ -487,6 +566,58 @@ ImagingAllocateBlock(Imaging im) {
     return im;
 }
 
+/* Borrowed Arrow Storage Type */
+/* --------------------------- */
+/* Don't allocate the image. */
+
+static void
+ImagingDestroyArrow(Imaging im) {
+    // Rely on the internal Python destructor for the array capsule.
+    if (im->arrow_array_capsule) {
+        Py_DECREF(im->arrow_array_capsule);
+        im->arrow_array_capsule = NULL;
+    }
+}
+
+Imaging
+ImagingBorrowArrow(
+    Imaging im,
+    struct ArrowArray *external_array,
+    int offset_width,
+    PyObject *arrow_capsule
+) {
+    // offset_width is the number of char* for a single offset from arrow
+    Py_ssize_t y, i;
+
+    char *borrowed_buffer = NULL;
+    struct ArrowArray *arr = external_array;
+
+    if (arr->n_children == 1) {
+        arr = arr->children[0];
+    }
+    if (arr->n_buffers == 2) {
+        // buffer 0 is the null list
+        // buffer 1 is the data
+        borrowed_buffer = (char *)arr->buffers[1] + (offset_width * arr->offset);
+    }
+
+    if (!borrowed_buffer) {
+        return (Imaging
+        )ImagingError_ValueError("Arrow Array, exactly 2 buffers required");
+    }
+
+    for (y = i = 0; y < im->ysize; y++) {
+        im->image[y] = borrowed_buffer + i;
+        i += im->linesize;
+    }
+    im->read_only = 1;
+    Py_INCREF(arrow_capsule);
+    im->arrow_array_capsule = arrow_capsule;
+    im->destroy = ImagingDestroyArrow;
+
+    return im;
+}
+
 /* --------------------------------------------------------------------
  * Create a new, internally allocated, image.
  */
@@ -529,11 +660,17 @@ ImagingNewInternal(const char *mode, int xsize, int ysize, int dirty) {
 
 Imaging
 ImagingNew(const char *mode, int xsize, int ysize) {
+    if (ImagingDefaultArena.use_block_allocator) {
+        return ImagingNewBlock(mode, xsize, ysize);
+    }
     return ImagingNewInternal(mode, xsize, ysize, 0);
 }
 
 Imaging
 ImagingNewDirty(const char *mode, int xsize, int ysize) {
+    if (ImagingDefaultArena.use_block_allocator) {
+        return ImagingNewBlock(mode, xsize, ysize);
+    }
     return ImagingNewInternal(mode, xsize, ysize, 1);
 }
 
@@ -558,6 +695,66 @@ ImagingNewBlock(const char *mode, int xsize, int ysize) {
     return NULL;
 }
 
+Imaging
+ImagingNewArrow(
+    const char *mode,
+    int xsize,
+    int ysize,
+    PyObject *schema_capsule,
+    PyObject *array_capsule
+) {
+    /* A borrowed arrow array */
+    Imaging im;
+    struct ArrowSchema *schema =
+        (struct ArrowSchema *)PyCapsule_GetPointer(schema_capsule, "arrow_schema");
+
+    struct ArrowArray *external_array =
+        (struct ArrowArray *)PyCapsule_GetPointer(array_capsule, "arrow_array");
+
+    if (xsize < 0 || ysize < 0) {
+        return (Imaging)ImagingError_ValueError("bad image size");
+    }
+
+    im = ImagingNewPrologue(mode, xsize, ysize);
+    if (!im) {
+        return NULL;
+    }
+
+    int64_t pixels = (int64_t)xsize * (int64_t)ysize;
+
+    // fmt:off   // don't reformat this
+    if (((strcmp(schema->format, "I") == 0  // int32
+          && im->pixelsize == 4             // 4xchar* storage
+          && im->bands >= 2)                // INT32 into any INT32 Storage mode
+         ||                                 // (()||()) &&
+         (strcmp(schema->format, im->arrow_band_format) == 0  // same mode
+          && im->bands == 1))                                 // Single band match
+        && pixels == external_array->length) {
+        // one arrow element per, and it matches a pixelsize*char
+        if (ImagingBorrowArrow(im, external_array, im->pixelsize, array_capsule)) {
+            return im;
+        }
+    }
+    if (strcmp(schema->format, "+w:4") == 0  // 4 up array
+        && im->pixelsize == 4                // storage as 32 bpc
+        && schema->n_children > 0            // make sure schema is well formed.
+        && schema->children                  // make sure schema is well formed
+        && strcmp(schema->children[0]->format, "C") == 0  // Expected format
+        && strcmp(im->arrow_band_format, "C") == 0        // Expected Format
+        && pixels == external_array->length               // expected length
+        && external_array->n_children == 1                // array is well formed
+        && external_array->children                       // array is well formed
+        && 4 * pixels == external_array->children[0]->length) {
+        // 4 up element of char into pixelsize == 4
+        if (ImagingBorrowArrow(im, external_array, 1, array_capsule)) {
+            return im;
+        }
+    }
+    // fmt: on
+    ImagingDelete(im);
+    return NULL;
+}
+
 Imaging
 ImagingNew2Dirty(const char *mode, Imaging imOut, Imaging imIn) {
     /* allocate or validate output image */

From a7537b1b06490ef3dfbf0bf1c48a0b8c9aa36940 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 30 Mar 2025 07:31:17 +1100
Subject: [PATCH 1601/2374] Only change readonly if saved filename matches
 opened filename

---
 Tests/test_image.py | 9 +++++++++
 src/PIL/Image.py    | 7 ++++++-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index c2e850c36c7..7e6118d5280 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -258,6 +258,15 @@ def test_readonly_save(self, tmp_path: Path) -> None:
             assert im.readonly
             im.save(temp_file)
 
+    def test_save_without_changing_readonly(self, tmp_path: Path) -> None:
+        temp_file = tmp_path / "temp.bmp"
+
+        with Image.open("Tests/images/rgb32bf-rgba.bmp") as im:
+            assert im.readonly
+
+            im.save(temp_file)
+            assert im.readonly
+
     def test_dump(self, tmp_path: Path) -> None:
         im = Image.new("L", (10, 10))
         im._dump(str(tmp_path / "temp_L.ppm"))
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 233df592c33..c62d7a8a3dd 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2540,8 +2540,13 @@ def save(
                 msg = f"unknown file extension: {ext}"
                 raise ValueError(msg) from e
 
+        from . import ImageFile
+
         # may mutate self!
-        self._ensure_mutable()
+        if isinstance(self, ImageFile.ImageFile) and filename == self.filename:
+            self._ensure_mutable()
+        else:
+            self.load()
 
         save_all = params.pop("save_all", None)
         self.encoderinfo = {**getattr(self, "encoderinfo", {}), **params}

From f205a45f44b237374533d5f41db65d75da474a45 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Apr 2025 19:10:11 +1100
Subject: [PATCH 1602/2374] Added release notes for #8330

---
 docs/releasenotes/11.2.0.rst | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index 2c1c761e5d2..de3db3c84fa 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -81,6 +81,28 @@ DXT5, BC2, BC3 and BC5 are supported::
 Other Changes
 =============
 
+Arrow support
+^^^^^^^^^^^^^
+
+`Arrow <https://arrow.apache.org/>`__ is an in-memory data exchange format that is the
+spiritual successor to the NumPy array interface. It provides for zero-copy access to
+columnar data, which in our case is ``Image`` data.
+
+To create an image with zero-copy shared memory from an object exporting the
+arrow_c_array interface protocol::
+
+    from PIL import Image
+    import pyarrow as pa
+    arr = pa.array([0]*(5*5*4), type=pa.uint8())
+    im = Image.fromarrow(arr, 'RGBA', (5, 5))
+
+Pillow images can also be converted to Arrow objects::
+
+    from PIL import Image
+    import pyarrow as pa
+    im = Image.open('hopper.jpg')
+    arr = pa.array(im)
+
 Reading and writing AVIF images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From 867c4772c22455207d6f1982bfbe130b423b53a5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Apr 2025 20:19:40 +1100
Subject: [PATCH 1603/2374] Do not import type checking

---
 Tests/test_image_array.py           | 3 ++-
 Tests/test_numpy.py                 | 2 +-
 Tests/test_qt_image_qapplication.py | 3 ++-
 docs/dater.py                       | 2 +-
 4 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index eb2309e0ffe..25cb99c43ef 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import Any
 
 import pytest
 from packaging.version import parse as parse_version
@@ -13,6 +13,7 @@
 
 im = hopper().resize((128, 100))
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     import numpy.typing as npt
 
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index c4ad19d23eb..ef54deeeb2b 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import warnings
-from typing import TYPE_CHECKING
 
 import pytest
 
@@ -9,6 +8,7 @@
 
 from .helper import assert_deep_equal, assert_image, hopper, skip_unless_feature
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     import numpy
     import numpy.typing as npt
diff --git a/Tests/test_qt_image_qapplication.py b/Tests/test_qt_image_qapplication.py
index 0ed9fbfa5cb..82a3e074120 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -1,7 +1,7 @@
 from __future__ import annotations
 
 from pathlib import Path
-from typing import TYPE_CHECKING, Union
+from typing import Union
 
 import pytest
 
@@ -9,6 +9,7 @@
 
 from .helper import assert_image_equal_tofile, assert_image_similar, hopper
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     import PyQt6
     import PySide6
diff --git a/docs/dater.py b/docs/dater.py
index f9fb0c1da6e..c0302b55c35 100644
--- a/docs/dater.py
+++ b/docs/dater.py
@@ -8,8 +8,8 @@
 
 import re
 import subprocess
-from typing import TYPE_CHECKING
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from sphinx.application import Sphinx
 

From 1103e82d17311dac9ec2f32cb7e738fda8c64271 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 2 Apr 2025 11:14:58 +1100
Subject: [PATCH 1604/2374] Include filename in state

---
 Tests/test_pickle.py       | 1 +
 src/PIL/ImageFile.py       | 4 ++++
 src/PIL/JpegImagePlugin.py | 2 +-
 3 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index 70661ecc17a..1c48cb743e0 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -81,6 +81,7 @@ def test_pickle_jpeg() -> None:
         unpickled_image = pickle.loads(pickle.dumps(image))
 
     # Assert
+    assert unpickled_image.filename == "Tests/images/hopper.jpg"
     assert len(unpickled_image.layer) == 3
     assert unpickled_image.layers == 3
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index c5d6383a59f..bcb7d462eba 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -252,8 +252,12 @@ def get_format_mimetype(self) -> str | None:
             return Image.MIME.get(self.format.upper())
         return None
 
+    def __getstate__(self) -> list[Any]:
+        return super().__getstate__() + [self.filename]
+
     def __setstate__(self, state: list[Any]) -> None:
         self.tile = []
+        self.filename = state[5]
         super().__setstate__(state)
 
     def verify(self) -> None:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index cc1d54b93ba..96952884118 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -403,8 +403,8 @@ def __getstate__(self) -> list[Any]:
         return super().__getstate__() + [self.layers, self.layer]
 
     def __setstate__(self, state: list[Any]) -> None:
+        self.layers, self.layer = state[6:]
         super().__setstate__(state)
-        self.layers, self.layer = state[5:]
 
     def load_read(self, read_bytes: int) -> bytes:
         """

From 8dbbce624f7ce9ad85eb50075d9e3dfdcb0fbfd4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 2 Apr 2025 12:16:25 +1100
Subject: [PATCH 1605/2374] Compare absolute path of filename

---
 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 c62d7a8a3dd..807814c021e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2543,7 +2543,9 @@ def save(
         from . import ImageFile
 
         # may mutate self!
-        if isinstance(self, ImageFile.ImageFile) and filename == self.filename:
+        if isinstance(self, ImageFile.ImageFile) and os.path.abspath(
+            filename
+        ) == os.path.abspath(self.filename):
             self._ensure_mutable()
         else:
             self.load()

From 7e15c54cad753c30974005230699e888e8902b6c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 2 Apr 2025 23:53:14 +1100
Subject: [PATCH 1606/2374] Use multibuild build_github (#8861)

---
 .github/workflows/wheels-dependencies.sh | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 2f2e75b6cb4..accd99901fa 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -80,11 +80,7 @@ function build_pkg_config {
 
 function build_zlib_ng {
     if [ -e zlib-stamp ]; then return; fi
-    fetch_unpack https://github.com/zlib-ng/zlib-ng/archive/$ZLIB_NG_VERSION.tar.gz zlib-ng-$ZLIB_NG_VERSION.tar.gz
-    (cd zlib-ng-$ZLIB_NG_VERSION \
-        && ./configure --prefix=$BUILD_PREFIX --zlib-compat \
-        && make -j4 \
-        && make install)
+    build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --zlib-compat
 
     if [ -n "$IS_MACOS" ]; then
         # Ensure that on macOS, the library name is an absolute path, not an

From f4cd5e750217c8d0c0d5cb5378a49c651d5aa7d8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 3 Apr 2025 18:44:45 +1100
Subject: [PATCH 1607/2374] Assert image type

---
 Tests/test_file_avif.py          |  9 +++++++++
 Tests/test_file_fli.py           |  2 ++
 Tests/test_file_gif.py           |  3 +++
 Tests/test_file_jpeg.py          | 26 +++++++++++++++++++++-----
 Tests/test_file_mpo.py           |  8 ++++++++
 Tests/test_file_png.py           | 30 ++++++++++++++++++++++--------
 Tests/test_file_webp_metadata.py |  2 ++
 7 files changed, 67 insertions(+), 13 deletions(-)

diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index 392a4bbd5b0..069a48940af 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -14,6 +14,7 @@
 
 from PIL import (
     AvifImagePlugin,
+    GifImagePlugin,
     Image,
     ImageDraw,
     ImageFile,
@@ -240,6 +241,7 @@ def test_save_single_frame(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/chi.gif") as im:
             im.save(temp_file)
         with Image.open(temp_file) as im:
+            assert isinstance(im, AvifImagePlugin.AvifImageFile)
             assert im.n_frames == 1
 
     def test_invalid_file(self) -> None:
@@ -595,10 +597,12 @@ def test_n_frames(self) -> None:
         """
 
         with Image.open(TEST_AVIF_FILE) as im:
+            assert isinstance(im, AvifImagePlugin.AvifImageFile)
             assert im.n_frames == 1
             assert not im.is_animated
 
         with Image.open("Tests/images/avif/star.avifs") as im:
+            assert isinstance(im, AvifImagePlugin.AvifImageFile)
             assert im.n_frames == 5
             assert im.is_animated
 
@@ -609,11 +613,13 @@ def test_write_animation_P(self, tmp_path: Path) -> None:
         """
 
         with Image.open("Tests/images/avif/star.gif") as original:
+            assert isinstance(original, GifImagePlugin.GifImageFile)
             assert original.n_frames > 1
 
             temp_file = tmp_path / "temp.avif"
             original.save(temp_file, save_all=True)
             with Image.open(temp_file) as im:
+                assert isinstance(im, AvifImagePlugin.AvifImageFile)
                 assert im.n_frames == original.n_frames
 
                 # Compare first frame in P mode to frame from original GIF
@@ -633,6 +639,7 @@ def test_write_animation_RGBA(self, tmp_path: Path) -> None:
 
         def check(temp_file: Path) -> None:
             with Image.open(temp_file) as im:
+                assert isinstance(im, AvifImagePlugin.AvifImageFile)
                 assert im.n_frames == 4
 
                 # Compare first frame to original
@@ -705,6 +712,7 @@ def test_timestamp_and_duration(self, tmp_path: Path) -> None:
             )
 
         with Image.open(temp_file) as im:
+            assert isinstance(im, AvifImagePlugin.AvifImageFile)
             assert im.n_frames == 5
             assert im.is_animated
 
@@ -734,6 +742,7 @@ def test_seeking(self, tmp_path: Path) -> None:
             )
 
         with Image.open(temp_file) as im:
+            assert isinstance(im, AvifImagePlugin.AvifImageFile)
             assert im.n_frames == 5
             assert im.is_animated
 
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 81df1ab0b80..ff80c92f7e2 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -43,6 +43,7 @@ def test_sanity() -> None:
 def test_prefix_chunk(monkeypatch: pytest.MonkeyPatch) -> None:
     monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
     with Image.open(animated_test_file_with_prefix_chunk) as im:
+        assert isinstance(im, FliImagePlugin.FliImageFile)
         assert im.mode == "P"
         assert im.size == (320, 200)
         assert im.format == "FLI"
@@ -50,6 +51,7 @@ def test_prefix_chunk(monkeypatch: pytest.MonkeyPatch) -> None:
         assert im.is_animated
 
         palette = im.getpalette()
+        assert palette is not None
         assert palette[3:6] == [255, 255, 255]
         assert palette[381:384] == [204, 204, 12]
         assert palette[765:] == [252, 0, 0]
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 20d58a9dda4..3d07159f37c 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -280,6 +280,7 @@ def test_roundtrip_save_all(tmp_path: Path) -> None:
         im.save(out, save_all=True)
 
     with Image.open(out) as reread:
+        assert isinstance(reread, GifImagePlugin.GifImageFile)
         assert reread.n_frames == 5
 
 
@@ -1357,8 +1358,10 @@ def test_palette_save_all_P(tmp_path: Path) -> None:
 
     with Image.open(out) as im:
         # Assert that the frames are correct, and each frame has the same palette
+        assert isinstance(im, GifImagePlugin.GifImageFile)
         assert_image_equal(im.convert("RGB"), frames[0].convert("RGB"))
         assert im.palette is not None
+        assert im.global_palette is not None
         assert im.palette.palette == im.global_palette.palette
 
         im.seek(1)
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 79f0ec1a809..9164882d306 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -334,8 +334,10 @@ def test_exif_gps(self, tmp_path: Path) -> None:
 
         # Reading
         with Image.open("Tests/images/exif_gps.jpg") as im:
-            exif = im._getexif()
-            assert exif[gps_index] == expected_exif_gps
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
+            exif_data = im._getexif()
+            assert exif_data is not None
+            assert exif_data[gps_index] == expected_exif_gps
 
         # Writing
         f = tmp_path / "temp.jpg"
@@ -344,8 +346,10 @@ def test_exif_gps(self, tmp_path: Path) -> None:
         hopper().save(f, exif=exif)
 
         with Image.open(f) as reloaded:
-            exif = reloaded._getexif()
-            assert exif[gps_index] == expected_exif_gps
+            assert isinstance(reloaded, JpegImagePlugin.JpegImageFile)
+            exif_data = reloaded._getexif()
+            assert exif_data is not None
+            assert exif_data[gps_index] == expected_exif_gps
 
     def test_empty_exif_gps(self) -> None:
         with Image.open("Tests/images/empty_gps_ifd.jpg") as im:
@@ -372,6 +376,7 @@ def test_exif_equality(self) -> None:
         exifs = []
         for i in range(2):
             with Image.open("Tests/images/exif-200dpcm.jpg") as im:
+                assert isinstance(im, JpegImagePlugin.JpegImageFile)
                 exifs.append(im._getexif())
         assert exifs[0] == exifs[1]
 
@@ -405,13 +410,17 @@ def test_exif_rollback(self) -> None:
         }
 
         with Image.open("Tests/images/exif_gps.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             exif = im._getexif()
+        assert exif is not None
 
         for tag, value in expected_exif.items():
             assert value == exif[tag]
 
     def test_exif_gps_typeerror(self) -> None:
         with Image.open("Tests/images/exif_gps_typeerror.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
+
             # Should not raise a TypeError
             im._getexif()
 
@@ -491,7 +500,9 @@ def getsampling(
 
     def test_exif(self) -> None:
         with Image.open("Tests/images/pil_sample_rgb.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             info = im._getexif()
+            assert info is not None
             assert info[305] == "Adobe Photoshop CS Macintosh"
 
     def test_get_child_images(self) -> None:
@@ -676,11 +687,13 @@ def test_load_16bit_qtables(self) -> None:
 
     def test_save_multiple_16bit_qtables(self) -> None:
         with Image.open("Tests/images/hopper_16bit_qtables.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             im2 = self.roundtrip(im, qtables="keep")
             assert im.quantization == im2.quantization
 
     def test_save_single_16bit_qtable(self) -> None:
         with Image.open("Tests/images/hopper_16bit_qtables.jpg") as im:
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
             im2 = self.roundtrip(im, qtables={0: im.quantization[0]})
             assert len(im2.quantization) == 1
             assert im2.quantization[0] == im.quantization[0]
@@ -889,7 +902,10 @@ def test_ifd_offset_exif(self) -> None:
         # in contrast to normal 8
         with Image.open("Tests/images/exif-ifd-offset.jpg") as im:
             # Act / Assert
-            assert im._getexif()[306] == "2017:03:13 23:03:09"
+            assert isinstance(im, JpegImagePlugin.JpegImageFile)
+            exif = im._getexif()
+            assert exif is not None
+            assert exif[306] == "2017:03:13 23:03:09"
 
     def test_multiple_exif(self) -> None:
         with Image.open("Tests/images/multiple_exif.jpg") as im:
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 73838ef4484..c5d3142e895 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -120,9 +120,11 @@ 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:
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         assert im.size == (64, 64)
 
         im.seek(1)
+        assert im.mpinfo is not None
         assert (
             im.mpinfo[0xB002][1]["Attribute"]["MPType"]
             == "Multi-Frame Image: (Disparity)"
@@ -155,7 +157,9 @@ def test_reload_exif_after_seek() -> None:
 @pytest.mark.parametrize("test_file", test_files)
 def test_mp(test_file: str) -> None:
     with Image.open(test_file) as im:
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         mpinfo = im._getmp()
+        assert mpinfo is not None
         assert mpinfo[45056] == b"0100"
         assert mpinfo[45057] == 2
 
@@ -164,7 +168,9 @@ 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:
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         mpinfo = im._getmp()
+        assert mpinfo is not None
         assert mpinfo[45056] == b"0100"
         assert mpinfo[45057] == 2
 
@@ -180,7 +186,9 @@ def test_mp_no_data() -> None:
 @pytest.mark.parametrize("test_file", test_files)
 def test_mp_attribute(test_file: str) -> None:
     with Image.open(test_file) as im:
+        assert isinstance(im, MpoImagePlugin.MpoImageFile)
         mpinfo = im._getmp()
+    assert mpinfo is not None
     for frame_number, mpentry in enumerate(mpinfo[0xB002]):
         mpattr = mpentry["Attribute"]
         if frame_number:
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 0f0886ab8dc..13e1c80f47c 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -671,6 +671,9 @@ def test_specify_bits(self, save_all: bool, tmp_path: Path) -> None:
         im.save(out, bits=4, save_all=save_all)
 
         with Image.open(out) as reloaded:
+            assert isinstance(reloaded, PngImagePlugin.PngImageFile)
+            assert reloaded.png is not None
+            assert reloaded.png.im_palette is not None
             assert len(reloaded.png.im_palette[1]) == 48
 
     def test_plte_length(self, tmp_path: Path) -> None:
@@ -681,6 +684,9 @@ def test_plte_length(self, tmp_path: Path) -> None:
         im.save(out)
 
         with Image.open(out) as reloaded:
+            assert isinstance(reloaded, PngImagePlugin.PngImageFile)
+            assert reloaded.png is not None
+            assert reloaded.png.im_palette is not None
             assert len(reloaded.png.im_palette[1]) == 3
 
     def test_getxmp(self) -> None:
@@ -702,13 +708,17 @@ def test_getxmp(self) -> None:
     def test_exif(self) -> None:
         # With an EXIF chunk
         with Image.open("Tests/images/exif.png") as im:
-            exif = im._getexif()
-        assert exif[274] == 1
+            assert isinstance(im, PngImagePlugin.PngImageFile)
+            exif_data = im._getexif()
+        assert exif_data is not None
+        assert exif_data[274] == 1
 
         # With an ImageMagick zTXt chunk
         with Image.open("Tests/images/exif_imagemagick.png") as im:
-            exif = im._getexif()
-            assert exif[274] == 1
+            assert isinstance(im, PngImagePlugin.PngImageFile)
+            exif_data = im._getexif()
+            assert exif_data is not None
+            assert exif_data[274] == 1
 
             # Assert that info still can be extracted
             # when the image is no longer a PngImageFile instance
@@ -717,8 +727,10 @@ def test_exif(self) -> None:
 
         # With a tEXt chunk
         with Image.open("Tests/images/exif_text.png") as im:
-            exif = im._getexif()
-        assert exif[274] == 1
+            assert isinstance(im, PngImagePlugin.PngImageFile)
+            exif_data = im._getexif()
+        assert exif_data is not None
+        assert exif_data[274] == 1
 
         # With XMP tags
         with Image.open("Tests/images/xmp_tags_orientation.png") as im:
@@ -740,8 +752,10 @@ def test_exif_save(self, tmp_path: Path) -> None:
             im.save(test_file, exif=im.getexif())
 
         with Image.open(test_file) as reloaded:
-            exif = reloaded._getexif()
-        assert exif[274] == 1
+            assert isinstance(reloaded, PngImagePlugin.PngImageFile)
+            exif_data = reloaded._getexif()
+        assert exif_data is not None
+        assert exif_data[274] == 1
 
     @mark_if_feature_version(
         pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
diff --git a/Tests/test_file_webp_metadata.py b/Tests/test_file_webp_metadata.py
index 7543d22da07..3de412b832b 100644
--- a/Tests/test_file_webp_metadata.py
+++ b/Tests/test_file_webp_metadata.py
@@ -22,11 +22,13 @@
 def test_read_exif_metadata() -> None:
     file_path = "Tests/images/flower.webp"
     with Image.open(file_path) as image:
+        assert isinstance(image, WebPImagePlugin.WebPImageFile)
         assert image.format == "WEBP"
         exif_data = image.info.get("exif", None)
         assert exif_data
 
         exif = image._getexif()
+        assert exif is not None
 
         # Camera make
         assert exif[271] == "Canon"

From 2d452c82e5f78fb25d0271a4f4534622235176da Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 3 Apr 2025 21:17:54 +1100
Subject: [PATCH 1608/2374] Removed condition that is always true (#8862)

---
 src/_avif.c | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/_avif.c b/src/_avif.c
index eabd9958e10..31228678706 100644
--- a/src/_avif.c
+++ b/src/_avif.c
@@ -568,9 +568,7 @@ _encoder_add(AvifEncoderObject *self, PyObject *args) {
     }
 
 end:
-    if (&rgb) {
-        avifRGBImageFreePixels(&rgb);
-    }
+    avifRGBImageFreePixels(&rgb);
     if (!self->first_frame) {
         avifImageDestroy(frame);
     }

From 8691112a2cba76b7bcf1aaa0f4824ff9063f2f7b Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Thu, 3 Apr 2025 13:23:36 +0300
Subject: [PATCH 1609/2374] Update scientific-python/upload-nightly-action
 action to v0.6.2 (#8865)

---
 .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 2a8594f4961..3b1be9a96b1 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -245,7 +245,7 @@ jobs:
           path: dist
           merge-multiple: true
       - name: Upload wheels to scientific-python-nightly-wheels
-        uses: scientific-python/upload-nightly-action@82396a2ed4269ba06c6b2988bb4fd568ef3c3d6b # 0.6.1
+        uses: scientific-python/upload-nightly-action@b36e8c0c10dbcfd2e05bf95f17ef8c14fd708dbf # 0.6.2
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}

From 9f4195752d2231b34909c95fa70d716d4c664491 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 3 Apr 2025 21:24:37 +1100
Subject: [PATCH 1610/2374] Added type hints (#8867)

---
 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 807814c021e..88ea6f3b53e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3326,7 +3326,9 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     return frombuffer(mode, size, obj, "raw", rawmode, 0, 1)
 
 
-def fromarrow(obj: SupportsArrowArrayInterface, mode, size) -> Image:
+def fromarrow(
+    obj: SupportsArrowArrayInterface, mode: str, size: tuple[int, int]
+) -> Image:
     """Creates an image with zero-copy shared memory from an object exporting
     the arrow_c_array interface protocol::
 

From 61d3dd9e83aee05fb19e28274bcc20a8fb8148f6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 4 Apr 2025 22:12:54 +1100
Subject: [PATCH 1611/2374] Updated xz to 5.8.1, except on Windows x86

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index accd99901fa..04bce62fbbe 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -42,7 +42,7 @@ HARFBUZZ_VERSION=11.0.0
 LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
-XZ_VERSION=5.8.0
+XZ_VERSION=5.8.1
 TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_VERSION=1.3.1
@@ -53,20 +53,6 @@ LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
 LIBAVIF_VERSION=1.2.1
 
-if [[ $MB_ML_VER == 2014 ]]; then
-    function build_xz {
-        if [ -e xz-stamp ]; then return; fi
-        yum install -y gettext-devel
-        fetch_unpack https://tukaani.org/xz/xz-$XZ_VERSION.tar.gz
-        (cd xz-$XZ_VERSION \
-            && ./autogen.sh --no-po4a \
-            && ./configure --prefix=$BUILD_PREFIX \
-            && make -j4 \
-            && make install)
-        touch xz-stamp
-    }
-fi
-
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
     # This essentially duplicates the Homebrew recipe
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index e118cd99422..e8e3aacc248 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -122,7 +122,7 @@ def cmd_msbuild(
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.7.0",
-    "XZ": "5.6.4",
+    "XZ": "5.6.4" if struct.calcsize("P") == 4 else "5.8.1",
     "ZLIBNG": "2.2.4",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])

From 9f654ff748919d92ac0710a573e239b18c82e806 Mon Sep 17 00:00:00 2001
From: Frankie Dintino <fdintino@gmail.com>
Date: Fri, 4 Apr 2025 09:41:11 -0400
Subject: [PATCH 1612/2374] Fixed conversion of AVIF image rotation property to
 EXIF orientation (#8866)

---
 Tests/test_file_avif.py | 3 ++-
 src/_avif.c             | 4 ++--
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index 392a4bbd5b0..bd87947c014 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -309,7 +309,7 @@ def test_exif(self) -> None:
         assert exif[274] == 3
 
     @pytest.mark.parametrize("use_bytes", [True, False])
-    @pytest.mark.parametrize("orientation", [1, 2])
+    @pytest.mark.parametrize("orientation", [1, 2, 3, 4, 5, 6, 7, 8])
     def test_exif_save(
         self,
         tmp_path: Path,
@@ -327,6 +327,7 @@ def test_exif_save(
             if orientation == 1:
                 assert "exif" not in reloaded.info
             else:
+                assert reloaded.getexif()[274] == orientation
                 assert reloaded.info["exif"] == exif_data
 
     def test_exif_without_orientation(self, tmp_path: Path) -> None:
diff --git a/src/_avif.c b/src/_avif.c
index 31228678706..7e7bee7031b 100644
--- a/src/_avif.c
+++ b/src/_avif.c
@@ -59,7 +59,7 @@ irot_imir_to_exif_orientation(const avifImage *image) {
                 return axis ? 7   // 90 degrees anti-clockwise then swap left and right.
                             : 5;  // 90 degrees anti-clockwise then swap top and bottom.
             }
-            return 6;  // 90 degrees anti-clockwise.
+            return 8;  // 90 degrees anti-clockwise.
         }
         if (angle == 2) {
             if (imir) {
@@ -75,7 +75,7 @@ irot_imir_to_exif_orientation(const avifImage *image) {
                            ? 5   // 270 degrees anti-clockwise then swap left and right.
                            : 7;  // 270 degrees anti-clockwise then swap top and bottom.
             }
-            return 8;  // 270 degrees anti-clockwise.
+            return 6;  // 270 degrees anti-clockwise.
         }
     }
     if (imir) {

From 1ba32fce487cba432fd56c694651f15e0b32e25f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Apr 2025 15:44:46 +1100
Subject: [PATCH 1613/2374] Updated harfbuzz to 11.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 accd99901fa..06c968d6744 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,7 +38,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=11.0.0
+HARFBUZZ_VERSION=11.0.1
 LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index e118cd99422..cf6dd066180 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.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "11.0.0",
+    "HARFBUZZ": "11.0.1",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.17",
     "LIBAVIF": "1.2.1",

From 1db27be6a0a56eefb08f7f7ed5064b2af875a6fd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Apr 2025 16:09:12 +1100
Subject: [PATCH 1614/2374] Use same URL as wheels-dependencies.sh

---
 winbuild/build_prepare.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index cf6dd066180..5806d88dadd 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -349,8 +349,8 @@ def cmd_msbuild(
         "libs": [r"..\target\release\imagequant_sys.lib"],
     },
     "harfbuzz": {
-        "url": f"https://github.com/harfbuzz/harfbuzz/archive/{V['HARFBUZZ']}.zip",
-        "filename": f"harfbuzz-{V['HARFBUZZ']}.zip",
+        "url": f"https://github.com/harfbuzz/harfbuzz/releases/download/{V['HARFBUZZ']}/FILENAME",
+        "filename": f"harfbuzz-{V['HARFBUZZ']}.tar.xz",
         "license": "COPYING",
         "build": [
             *cmds_cmake(
@@ -514,8 +514,8 @@ def extract_dep(url: str, filename: str, prefs: dict[str, str]) -> None:
                     msg = "Attempted Path Traversal in Zip File"
                     raise RuntimeError(msg)
             zf.extractall(sources_dir)
-    elif filename.endswith((".tar.gz", ".tgz")):
-        with tarfile.open(file, "r:gz") as tgz:
+    elif filename.endswith((".tar.gz", ".tar.xz")):
+        with tarfile.open(file, "r:xz" if filename.endswith(".xz") else "r:gz") as tgz:
             for member in tgz.getnames():
                 member_abspath = os.path.abspath(os.path.join(sources_dir, member))
                 member_prefix = os.path.commonpath([sources_dir_abs, member_abspath])
@@ -776,7 +776,7 @@ def main() -> None:
 
     for k, v in DEPS.items():
         if "dir" not in v:
-            v["dir"] = re.sub(r"\.(tar\.gz|zip)", "", v["filename"])
+            v["dir"] = re.sub(r"\.(tar\.gz|tar\.xz|zip)", "", v["filename"])
         prefs[f"dir_{k}"] = os.path.join(sources_dir, v["dir"])
 
     print()

From 82bccf70a0113617492b163f30e2bf31294c0a09 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 6 Apr 2025 11:10:05 +1000
Subject: [PATCH 1615/2374] Added XZ_CLMUL_CRC:BOOL=OFF to allow Windows x86 to
 use xz 5.8.1

---
 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 e8e3aacc248..f40312506ef 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -122,7 +122,7 @@ def cmd_msbuild(
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.7.0",
-    "XZ": "5.6.4" if struct.calcsize("P") == 4 else "5.8.1",
+    "XZ": "5.8.1",
     "ZLIBNG": "2.2.4",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
@@ -181,7 +181,11 @@ def cmd_msbuild(
         "filename": f"xz-{V['XZ']}.tar.gz",
         "license": "COPYING",
         "build": [
-            *cmds_cmake("liblzma", "-DBUILD_SHARED_LIBS:BOOL=OFF"),
+            *cmds_cmake(
+                "liblzma",
+                "-DBUILD_SHARED_LIBS:BOOL=OFF"
+                + (" -DXZ_CLMUL_CRC:BOOL=OFF" if struct.calcsize("P") == 4 else ""),
+            ),
             cmd_mkdir(r"{inc_dir}\lzma"),
             cmd_copy(r"src\liblzma\api\lzma\*.h", r"{inc_dir}\lzma"),
         ],

From f6eb2e7fa50fc707aca36efd3d0dccd64edf1979 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 7 Apr 2025 17:17:00 +0000
Subject: [PATCH 1616/2374] [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.9.9 → v0.11.4](https://github.com/astral-sh/ruff-pre-commit/compare/v0.9.9...v0.11.4)
- [github.com/pre-commit/mirrors-clang-format: v19.1.7 → v20.1.0](https://github.com/pre-commit/mirrors-clang-format/compare/v19.1.7...v20.1.0)
- [github.com/python-jsonschema/check-jsonschema: 0.31.2 → 0.32.1](https://github.com/python-jsonschema/check-jsonschema/compare/0.31.2...0.32.1)
- [github.com/woodruffw/zizmor-pre-commit: v1.4.1 → v1.5.2](https://github.com/woodruffw/zizmor-pre-commit/compare/v1.4.1...v1.5.2)
- [github.com/abravalheri/validate-pyproject: v0.23 → v0.24.1](https://github.com/abravalheri/validate-pyproject/compare/v0.23...v0.24.1)
---
 .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 5ff947d4111..66cf6d118e0 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.9.9
+    rev: v0.11.4
     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: v19.1.7
+    rev: v20.1.0
     hooks:
       - id: clang-format
         types: [c]
@@ -50,14 +50,14 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.31.2
+    rev: 0.32.1
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: v1.4.1
+    rev: v1.5.2
     hooks:
       - id: zizmor
 
@@ -72,7 +72,7 @@ repos:
       - id: pyproject-fmt
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.23
+    rev: v0.24.1
     hooks:
       - id: validate-pyproject
         additional_dependencies: [trove-classifiers>=2024.10.12]

From a5a8ece5d2211e3121ba0508d9ca78d4afd90e90 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 7 Apr 2025 17:17:33 +0000
Subject: [PATCH 1617/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 src/libImaging/QuantHash.h | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/QuantHash.h b/src/libImaging/QuantHash.h
index 0462cfd4968..d75d55ce0e4 100644
--- a/src/libImaging/QuantHash.h
+++ b/src/libImaging/QuantHash.h
@@ -20,8 +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

From 8c4510cb236597df034ab3cec97d4ec6ca3ba9a1 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 7 Apr 2025 22:25:12 +0300
Subject: [PATCH 1618/2374] Fix clang-format: Configuration file(s) do(es) not
 support C

---
 .clang-format     | 1 -
 src/_imagingcms.c | 4 ++--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/.clang-format b/.clang-format
index 143dde82c2c..f01a1151ae7 100644
--- a/.clang-format
+++ b/.clang-format
@@ -11,7 +11,6 @@ ColumnLimit: 88
 DerivePointerAlignment: false
 IndentGotoLabels: false
 IndentWidth: 4
-Language: Cpp
 PointerAlignment: Right
 ReflowComments: true
 SortIncludes: false
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index ea2f7018634..f93c1613b47 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1402,8 +1402,8 @@ 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}

From 8b7d72440e5d8a1acbe3f4692003d6c6eabd2205 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 8 Apr 2025 20:15:45 +1000
Subject: [PATCH 1619/2374] Specify both C and Cpp

---
 .clang-format           | 21 +++++++++++++++++++++
 .pre-commit-config.yaml |  1 +
 2 files changed, 22 insertions(+)

diff --git a/.clang-format b/.clang-format
index f01a1151ae7..1871d1f7a7b 100644
--- a/.clang-format
+++ b/.clang-format
@@ -1,5 +1,26 @@
 # A clang-format style that approximates Python's PEP 7
 # Useful for IDE integration
+Language: C
+BasedOnStyle: Google
+AlwaysBreakAfterReturnType: All
+AllowShortIfStatementsOnASingleLine: false
+AlignAfterOpenBracket: BlockIndent
+BinPackArguments: false
+BinPackParameters: false
+BreakBeforeBraces: Attach
+ColumnLimit: 88
+DerivePointerAlignment: false
+IndentGotoLabels: false
+IndentWidth: 4
+PointerAlignment: Right
+ReflowComments: true
+SortIncludes: false
+SpaceBeforeParens: ControlStatements
+SpacesInParentheses: false
+TabWidth: 4
+UseTab: Never
+---
+Language: Cpp
 BasedOnStyle: Google
 AlwaysBreakAfterReturnType: All
 AllowShortIfStatementsOnASingleLine: false
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 66cf6d118e0..140ce33bead 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -44,6 +44,7 @@ repos:
       - id: check-json
       - id: check-toml
       - id: check-yaml
+        args: [--allow-multiple-documents]
       - id: end-of-file-fixer
         exclude: ^Tests/images/
       - id: trailing-whitespace

From 179ae9d395d5ad87e7d9f5db6e93a2cdd69af9ce Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 8 Apr 2025 22:05:29 +1000
Subject: [PATCH 1620/2374] Disable building harfbuzz tests

---
 .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 06c968d6744..7f1f22a3e3d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -107,7 +107,7 @@ function build_harfbuzz {
 
     local out_dir=$(fetch_unpack https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION/harfbuzz-$HARFBUZZ_VERSION.tar.xz harfbuzz-$HARFBUZZ_VERSION.tar.xz)
     (cd $out_dir \
-        && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=release -Dfreetype=enabled -Dglib=disabled)
+        && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=release -Dfreetype=enabled -Dglib=disabled -Dtests=disabled)
     (cd $out_dir/build \
         && meson install)
     touch harfbuzz-stamp

From 6b5f8d768d2d388f2c9475f6ae9ca3780dafb8c8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 13:55:02 +1000
Subject: [PATCH 1621/2374] Do not include libavif in wheels

---
 .github/workflows/wheels-dependencies.sh |  41 ---
 .github/workflows/wheels.yml             |   7 +-
 Tests/check_wheel.py                     |   8 +-
 docs/releasenotes/11.2.0.rst             |   5 +-
 wheels/dependency_licenses/AOM.txt       |  26 --
 wheels/dependency_licenses/DAV1D.txt     |  23 --
 wheels/dependency_licenses/LIBAVIF.txt   | 387 -----------------------
 wheels/dependency_licenses/LIBYUV.txt    |  29 --
 wheels/dependency_licenses/RAV1E.txt     |  25 --
 wheels/dependency_licenses/SVT-AV1.txt   |  26 --
 10 files changed, 5 insertions(+), 572 deletions(-)
 delete mode 100644 wheels/dependency_licenses/AOM.txt
 delete mode 100644 wheels/dependency_licenses/DAV1D.txt
 delete mode 100644 wheels/dependency_licenses/LIBAVIF.txt
 delete mode 100644 wheels/dependency_licenses/LIBYUV.txt
 delete mode 100644 wheels/dependency_licenses/RAV1E.txt
 delete mode 100644 wheels/dependency_licenses/SVT-AV1.txt

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index accd99901fa..395db86b6cb 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -51,7 +51,6 @@ LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
-LIBAVIF_VERSION=1.2.1
 
 if [[ $MB_ML_VER == 2014 ]]; then
     function build_xz {
@@ -113,45 +112,6 @@ function build_harfbuzz {
     touch harfbuzz-stamp
 }
 
-function build_libavif {
-    if [ -e libavif-stamp ]; then return; fi
-
-    python3 -m pip install meson ninja
-
-    if [[ "$PLAT" == "x86_64" ]] || [ -n "$SANITIZER" ]; then
-        build_simple nasm 2.16.03 https://www.nasm.us/pub/nasm/releasebuilds/2.16.03
-    fi
-
-    # For rav1e
-    curl https://sh.rustup.rs -sSf | sh -s -- -y
-    . "$HOME/.cargo/env"
-    if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
-        yum install -y perl
-        if [[ "$MB_ML_VER" == 2014 ]]; then
-            yum install -y perl-IPC-Cmd
-        fi
-    fi
-
-    local out_dir=$(fetch_unpack https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$LIBAVIF_VERSION.tar.gz libavif-$LIBAVIF_VERSION.tar.gz)
-    (cd $out_dir \
-        && CMAKE_POLICY_VERSION_MINIMUM=3.5 cmake \
-            -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX \
-            -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib \
-            -DCMAKE_BUILD_TYPE=Release \
-            -DBUILD_SHARED_LIBS=OFF \
-            -DAVIF_LIBSHARPYUV=LOCAL \
-            -DAVIF_LIBYUV=LOCAL \
-            -DAVIF_CODEC_AOM=LOCAL \
-            -DAVIF_CODEC_DAV1D=LOCAL \
-            -DAVIF_CODEC_RAV1E=LOCAL \
-            -DAVIF_CODEC_SVT=LOCAL \
-            -DENABLE_NASM=ON \
-            -DCMAKE_MODULE_PATH=/tmp/cmake/Modules \
-            . \
-        && make install)
-    touch libavif-stamp
-}
-
 function build {
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
@@ -186,7 +146,6 @@ function build {
         build_tiff
     fi
 
-    build_libavif
     build_libpng
     build_lcms2
     build_openjpeg
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 3b1be9a96b1..40d3dc7e882 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -157,14 +157,9 @@ jobs:
           # Install extra test images
           xcopy /S /Y Tests\test-images\* Tests\images
 
-          & python.exe winbuild\build_prepare.py -v --no-imagequant --architecture=${{ matrix.cibw_arch }}
+          & python.exe winbuild\build_prepare.py -v --no-imagequant --no-avif --architecture=${{ matrix.cibw_arch }}
         shell: pwsh
 
-      - name: Update rust
-        if: matrix.cibw_arch == 'AMD64'
-        run: |
-          rustup update
-
       - name: Build wheels
         run: |
           setlocal EnableDelayedExpansion
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 582fc92c2f3..8ba40ba3fbe 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import platform
-import struct
 import sys
 
 from PIL import features
@@ -10,7 +9,7 @@
 
 
 def test_wheel_modules() -> None:
-    expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp", "avif"}
+    expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp"}
 
     # tkinter is not available in cibuildwheel installed CPython on Windows
     try:
@@ -20,11 +19,6 @@ def test_wheel_modules() -> None:
     except ImportError:
         expected_modules.remove("tkinter")
 
-    # libavif is not available on Windows for x86 and ARM64 architectures
-    if sys.platform == "win32":
-        if platform.machine() == "ARM64" or struct.calcsize("P") == 4:
-            expected_modules.remove("avif")
-
     assert set(features.get_supported_modules()) == expected_modules
 
 
diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index de3db3c84fa..ed41c21164c 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -106,5 +106,6 @@ Pillow images can also be converted to Arrow objects::
 Reading and writing AVIF images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Pillow can now read and write AVIF images. If you are building Pillow from source, this
-will require libavif 1.0.0 or later.
+Pillow can now read and write AVIF images. However, due to concern over size, this
+functionality is not included in our prebuilt wheels. You will need to build Pillow
+from source with libavif 1.0.0 or later.
diff --git a/wheels/dependency_licenses/AOM.txt b/wheels/dependency_licenses/AOM.txt
deleted file mode 100644
index 3a2e46c264b..00000000000
--- a/wheels/dependency_licenses/AOM.txt
+++ /dev/null
@@ -1,26 +0,0 @@
-Copyright (c) 2016, Alliance for Open Media. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
-
-1. Redistributions of source code must retain the above copyright
-   notice, this list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright
-   notice, this list of conditions and the following disclaimer in
-   the documentation and/or other materials provided with the
-   distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
-FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
-BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
-ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/DAV1D.txt b/wheels/dependency_licenses/DAV1D.txt
deleted file mode 100644
index 875b138ecf6..00000000000
--- a/wheels/dependency_licenses/DAV1D.txt
+++ /dev/null
@@ -1,23 +0,0 @@
-Copyright © 2018-2019, VideoLAN and dav1d authors
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/LIBAVIF.txt b/wheels/dependency_licenses/LIBAVIF.txt
deleted file mode 100644
index 350eb9d15ce..00000000000
--- a/wheels/dependency_licenses/LIBAVIF.txt
+++ /dev/null
@@ -1,387 +0,0 @@
-Copyright 2019 Joe Drago. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-this list of conditions and the following disclaimer in the documentation
-and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-------------------------------------------------------------------------------
-
-Files: src/obu.c
-
-Copyright © 2018-2019, VideoLAN and dav1d authors
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
-ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
-SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-------------------------------------------------------------------------------
-
-Files: third_party/iccjpeg/*
-
-In plain English:
-
-1. We don't promise that this software works.  (But if you find any bugs,
-   please let us know!)
-2. You can use this software for whatever you want.  You don't have to pay us.
-3. You may not pretend that you wrote this software.  If you use it in a
-   program, you must acknowledge somewhere in your documentation that
-   you've used the IJG code.
-
-In legalese:
-
-The authors make NO WARRANTY or representation, either express or implied,
-with respect to this software, its quality, accuracy, merchantability, or
-fitness for a particular purpose.  This software is provided "AS IS", and you,
-its user, assume the entire risk as to its quality and accuracy.
-
-This software is copyright (C) 1991-2013, Thomas G. Lane, Guido Vollbeding.
-All Rights Reserved except as specified below.
-
-Permission is hereby granted to use, copy, modify, and distribute this
-software (or portions thereof) for any purpose, without fee, subject to these
-conditions:
-(1) If any part of the source code for this software is distributed, then this
-README file must be included, with this copyright and no-warranty notice
-unaltered; and any additions, deletions, or changes to the original files
-must be clearly indicated in accompanying documentation.
-(2) If only executable code is distributed, then the accompanying
-documentation must state that "this software is based in part on the work of
-the Independent JPEG Group".
-(3) Permission for use of this software is granted only if the user accepts
-full responsibility for any undesirable consequences; the authors accept
-NO LIABILITY for damages of any kind.
-
-These conditions apply to any software derived from or based on the IJG code,
-not just to the unmodified library.  If you use our work, you ought to
-acknowledge us.
-
-Permission is NOT granted for the use of any IJG author's name or company name
-in advertising or publicity relating to this software or products derived from
-it.  This software may be referred to only as "the Independent JPEG Group's
-software".
-
-We specifically permit and encourage the use of this software as the basis of
-commercial products, provided that all warranty or liability claims are
-assumed by the product vendor.
-
-
-The Unix configuration script "configure" was produced with GNU Autoconf.
-It is copyright by the Free Software Foundation but is freely distributable.
-The same holds for its supporting scripts (config.guess, config.sub,
-ltmain.sh).  Another support script, install-sh, is copyright by X Consortium
-but is also freely distributable.
-
-The IJG distribution formerly included code to read and write GIF files.
-To avoid entanglement with the Unisys LZW patent, GIF reading support has
-been removed altogether, and the GIF writer has been simplified to produce
-"uncompressed GIFs".  This technique does not use the LZW algorithm; the
-resulting GIF files are larger than usual, but are readable by all standard
-GIF decoders.
-
-We are required to state that
-    "The Graphics Interchange Format(c) is the Copyright property of
-    CompuServe Incorporated.  GIF(sm) is a Service Mark property of
-    CompuServe Incorporated."
-
-------------------------------------------------------------------------------
-
-Files: contrib/gdk-pixbuf/*
-
-Copyright 2020 Emmanuel Gil Peyrot. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-this list of conditions and the following disclaimer in the documentation
-and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-------------------------------------------------------------------------------
-
-Files: android_jni/gradlew*
-
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-
-------------------------------------------------------------------------------
-
-Files: third_party/libyuv/*
-
-Copyright 2011 The LibYuv Project Authors. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-  * Redistributions of source code must retain the above copyright
-    notice, this list of conditions and the following disclaimer.
-
-  * Redistributions in binary form must reproduce the above copyright
-    notice, this list of conditions and the following disclaimer in
-    the documentation and/or other materials provided with the
-    distribution.
-
-  * Neither the name of Google nor the names of its contributors may
-    be used to endorse or promote products derived from this software
-    without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/LIBYUV.txt b/wheels/dependency_licenses/LIBYUV.txt
deleted file mode 100644
index c911747a6b5..00000000000
--- a/wheels/dependency_licenses/LIBYUV.txt
+++ /dev/null
@@ -1,29 +0,0 @@
-Copyright 2011 The LibYuv Project Authors. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-  * Redistributions of source code must retain the above copyright
-    notice, this list of conditions and the following disclaimer.
-
-  * Redistributions in binary form must reproduce the above copyright
-    notice, this list of conditions and the following disclaimer in
-    the documentation and/or other materials provided with the
-    distribution.
-
-  * Neither the name of Google nor the names of its contributors may
-    be used to endorse or promote products derived from this software
-    without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/RAV1E.txt b/wheels/dependency_licenses/RAV1E.txt
deleted file mode 100644
index 3d6c825c4eb..00000000000
--- a/wheels/dependency_licenses/RAV1E.txt
+++ /dev/null
@@ -1,25 +0,0 @@
-BSD 2-Clause License
-
-Copyright (c) 2017-2023, the rav1e contributors
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-* Redistributions of source code must retain the above copyright notice, this
-  list of conditions and the following disclaimer.
-
-* Redistributions in binary form must reproduce the above copyright notice,
-  this list of conditions and the following disclaimer in the documentation
-  and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/SVT-AV1.txt b/wheels/dependency_licenses/SVT-AV1.txt
deleted file mode 100644
index 532a982b3ff..00000000000
--- a/wheels/dependency_licenses/SVT-AV1.txt
+++ /dev/null
@@ -1,26 +0,0 @@
-Copyright (c) 2019, Alliance for Open Media. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
-
-1. Redistributions of source code must retain the above copyright
-   notice, this list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright
-   notice, this list of conditions and the following disclaimer in
-   the documentation and/or other materials provided with the
-   distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
-FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
-COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
-INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
-BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
-LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
-ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGE.

From c8d98d56a02e0729f794546d6f270b3cea5baecf Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 16:21:48 +1000
Subject: [PATCH 1622/2374] Added avif to config settings (#8875)

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

diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 9f953e718c3..9ba389b6699 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -284,14 +284,16 @@ 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 jpeg2000=disable``, ``-C imagequant=disable``, ``-C xcb=disable``.
+  ``-C jpeg2000=disable``, ``-C imagequant=disable``, ``-C xcb=disable``,
+  ``-C avif=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 jpeg2000=enable``, ``-C imagequant=enable``, ``-C xcb=enable``.
+  ``-C jpeg2000=enable``, ``-C imagequant=enable``, ``-C xcb=enable``,
+  ``-C avif=enable``.
   Require that the corresponding feature is built. The build will raise
   an exception if the libraries are not found. Tcl and Tk must be used
   together.

From 75d3f1d3bdaee8b4e44ac1c437866e63ff577069 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 18:41:12 +1000
Subject: [PATCH 1623/2374] Assert palette is not None

---
 Tests/test_file_gif.py        | 2 ++
 Tests/test_image.py           | 1 +
 Tests/test_image_quantize.py  | 1 +
 Tests/test_image_transform.py | 1 +
 4 files changed, 5 insertions(+)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 20d58a9dda4..7ce6b7c8cd8 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -224,6 +224,7 @@ def test_optimize_if_palette_can_be_reduced_by_half() -> None:
         out = BytesIO()
         im.save(out, "GIF", optimize=optimize)
         with Image.open(out) as reloaded:
+            assert reloaded.palette is not None
             assert len(reloaded.palette.palette) // 3 == colors
 
 
@@ -1359,6 +1360,7 @@ def test_palette_save_all_P(tmp_path: Path) -> None:
         # Assert that the frames are correct, and each frame has the same palette
         assert_image_equal(im.convert("RGB"), frames[0].convert("RGB"))
         assert im.palette is not None
+        assert im.global_palette is not None
         assert im.palette.palette == im.global_palette.palette
 
         im.seek(1)
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 7e6118d5280..2a1911517d2 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -673,6 +673,7 @@ def test_remap_palette(self) -> None:
         im_remapped = im.remap_palette(list(range(256)))
         assert_image_equal(im, im_remapped)
         assert im.palette is not None
+        assert im_remapped.palette is not None
         assert im.palette.palette == im_remapped.palette.palette
 
         # Test illegal image mode
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 0ca7ad86e33..6d313cb8cb3 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -70,6 +70,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 palette.palette is not None
     assert converted.palette.palette == palette.palette.palette
 
 
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 77916929bb5..0429eb99d83 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -48,6 +48,7 @@ def test_palette(self) -> None:
                 im.size, Image.Transform.AFFINE, [1, 0, 0, 0, 1, 0]
             )
             assert im.palette is not None
+            assert transformed.palette is not None
             assert im.palette.palette == transformed.palette.palette
 
     def test_extent(self) -> None:

From 7b459a8524a1aa7b5180cd868df3a78c6fc8ff4b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 9 Apr 2025 19:33:17 +1000
Subject: [PATCH 1624/2374] Improved reading XPM images

---
 Tests/test_file_xpm.py    |  2 +-
 src/PIL/XpmImagePlugin.py | 42 ++++++++++++++++++++++++++++-----------
 2 files changed, 31 insertions(+), 13 deletions(-)

diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index 73c62a44d53..b604f07f5a2 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -17,7 +17,7 @@ def test_sanity() -> None:
         assert im.format == "XPM"
 
         # large error due to quantization->44 colors.
-        assert_image_similar(im.convert("RGB"), hopper("RGB"), 60)
+        assert_image_similar(im.convert("RGB"), hopper("RGB"), 23)
 
 
 def test_invalid_file() -> None:
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index 3c932c41b84..304f5836170 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -53,24 +53,20 @@ def _open(self) -> None:
 
         self._size = int(m.group(1)), int(m.group(2))
 
-        pal = int(m.group(3))
+        palette_length = int(m.group(3))
         bpp = int(m.group(4))
 
-        if pal > 256 or bpp != 1:
+        if palette_length > 256 or bpp != 1:
             msg = "cannot read this XPM file"
             raise ValueError(msg)
 
         #
         # load palette description
 
-        palette = [b"\0\0\0"] * 256
+        palette = {}
 
-        for _ in range(pal):
-            s = self.fp.readline()
-            if s.endswith(b"\r\n"):
-                s = s[:-2]
-            elif s.endswith((b"\r", b"\n")):
-                s = s[:-1]
+        for _ in range(palette_length):
+            s = self.fp.readline().rstrip()
 
             c = s[1]
             s = s[2:-2].split()
@@ -82,7 +78,6 @@ def _open(self) -> None:
                     if rgb == b"None":
                         self.info["transparency"] = c
                     elif rgb.startswith(b"#"):
-                        # FIXME: handle colour names (see ImagePalette.py)
                         rgb = int(rgb[1:], 16)
                         palette[c] = (
                             o8((rgb >> 16) & 255) + o8((rgb >> 8) & 255) + o8(rgb & 255)
@@ -99,9 +94,12 @@ def _open(self) -> None:
                 raise ValueError(msg)
 
         self._mode = "P"
-        self.palette = ImagePalette.raw("RGB", b"".join(palette))
+        self.palette = ImagePalette.raw("RGB", b"".join(palette.values()))
 
-        self.tile = [ImageFile._Tile("raw", (0, 0) + self.size, self.fp.tell(), "P")]
+        palette_keys = tuple(palette.keys())
+        self.tile = [
+            ImageFile._Tile("xpm", (0, 0) + self.size, self.fp.tell(), (palette_keys,))
+        ]
 
     def load_read(self, read_bytes: int) -> bytes:
         #
@@ -114,11 +112,31 @@ def load_read(self, read_bytes: int) -> bytes:
         return b"".join(s)
 
 
+class XpmDecoder(ImageFile.PyDecoder):
+    _pulls_fd = True
+
+    def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
+        assert self.fd is not None
+        self.fd.readline()  # Read '/* pixels */'
+
+        data = bytearray()
+        palette_keys = self.args[0]
+        dest_length = self.state.xsize * self.state.ysize
+        while len(data) < dest_length:
+            s = self.fd.readline().rstrip()[1:]
+            s = s[: -1 if s.endswith(b'"') else -2]
+            for key in s:
+                data += o8(palette_keys.index(key))
+        self.set_as_raw(bytes(data))
+        return -1, 0
+
+
 #
 # Registry
 
 
 Image.register_open(XpmImageFile.format, XpmImageFile, _accept)
+Image.register_decoder("xpm", XpmDecoder)
 
 Image.register_extension(XpmImageFile.format, ".xpm")
 

From 89ac20d2b9690bed2a10195b8acaf405aeaf2fbc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 9 Apr 2025 19:38:13 +1000
Subject: [PATCH 1625/2374] Allow more than 1 character per pixel

---
 Tests/images/hopper_bpp2.xpm | 390 +++++++++++++++++++++++++++++++++++
 Tests/test_file_xpm.py       |   7 +-
 src/PIL/XpmImagePlugin.py    |  15 +-
 3 files changed, 405 insertions(+), 7 deletions(-)
 create mode 100644 Tests/images/hopper_bpp2.xpm

diff --git a/Tests/images/hopper_bpp2.xpm b/Tests/images/hopper_bpp2.xpm
new file mode 100644
index 00000000000..fe97b83baf1
--- /dev/null
+++ b/Tests/images/hopper_bpp2.xpm
@@ -0,0 +1,390 @@
+/* XPM */
+static const char *hopper[] = {
+/* columns rows colors chars-per-pixel */
+"128 128 256 2 ",
+"   c #0C0C0D",
+".  c #0A0708",
+"X  c #1C0A04",
+"o  c #120B0C",
+"O  c #170808",
+"+  c #0B110D",
+"@  c #16120C",
+"#  c #0D0D12",
+"$  c #0D0D1A",
+"%  c #070A16",
+"&  c #120D13",
+"*  c #120E1A",
+"=  c #1A0C16",
+"-  c #0D1114",
+";  c #0D121B",
+":  c #091518",
+">  c #131215",
+",  c #14131B",
+"<  c #1A141C",
+"1  c #1B191D",
+"2  c #191517",
+"3  c #250906",
+"4  c #390904",
+"5  c #27150A",
+"6  c #250A18",
+"7  c #251719",
+"8  c #361410",
+"9  c #342215",
+"0  c #0C0C24",
+"q  c #0C0D2B",
+"w  c #060927",
+"e  c #130D24",
+"r  c #150D2A",
+"t  c #0C1225",
+"y  c #0C122C",
+"u  c #061227",
+"i  c #151422",
+"p  c #1A1522",
+"a  c #1C1B23",
+"s  c #13132C",
+"d  c #19172A",
+"f  c #0C0D35",
+"g  c #130E37",
+"h  c #0D1436",
+"j  c #131333",
+"k  c #13143C",
+"l  c #191838",
+"z  c #241926",
+"x  c #231B38",
+"c  c #2E1226",
+"v  c #372628",
+"b  c #292538",
+"n  c #362B37",
+"m  c #2F2A2F",
+"M  c #1A2233",
+"N  c #4C150D",
+"B  c #740F10",
+"V  c #512916",
+"C  c #793419",
+"Z  c #6D2C13",
+"A  c #4E1524",
+"S  c #741624",
+"D  c #4E332E",
+"F  c #6F3629",
+"G  c #574438",
+"H  c #744831",
+"J  c #775A2E",
+"K  c #0E1444",
+"L  c #141443",
+"P  c #1B1A44",
+"I  c #14144B",
+"U  c #1A1B4C",
+"Y  c #181747",
+"T  c #1B1B53",
+"R  c #181955",
+"E  c #0F0E44",
+"W  c #231C46",
+"Q  c #231C56",
+"!  c #1C234E",
+"~  c #272547",
+"^  c #2E2F52",
+"/  c #2E3765",
+"(  c #483947",
+")  c #742D4A",
+"_  c #364970",
+"`  c #534A51",
+"'  c #6E534D",
+"]  c #756654",
+"[  c #53556D",
+"{  c #6B5B69",
+"}  c #746B71",
+"|  c #5E616A",
+" . c #880C15",
+".. c #881217",
+"X. c #8D0D0F",
+"o. c #8B3218",
+"O. c #8C3828",
+"+. c #AC2F30",
+"@. c #9A1825",
+"#. c #CE202B",
+"$. c #8A452A",
+"%. c #974A2B",
+"&. c #884934",
+"*. c #954B35",
+"=. c #995539",
+"-. c #895736",
+";. c #A75738",
+":. c #A84E30",
+">. c #996839",
+",. c #B6683B",
+"<. c #AE6835",
+"1. c #A35419",
+"2. c #D26D19",
+"3. c #CC712E",
+"4. c #CD6922",
+"5. c #A83152",
+"6. c #985845",
+"7. c #8A5748",
+"8. c #AE5A46",
+"9. c #916A4F",
+"0. c #A96647",
+"q. c #B76947",
+"w. c #BA744A",
+"e. c #B97757",
+"r. c #AB6F53",
+"t. c #8D736D",
+"y. c #B27669",
+"u. c #91566F",
+"i. c #C56B4A",
+"p. c #C8764B",
+"a. c #C87856",
+"s. c #D47A59",
+"d. c #C96E53",
+"f. c #C77C64",
+"g. c #D17969",
+"h. c #D45D68",
+"j. c #C52A46",
+"k. c #D58932",
+"l. c #B38355",
+"z. c #968775",
+"x. c #BA8667",
+"c. c #B38C74",
+"v. c #AB9C73",
+"b. c #C9845A",
+"n. c #D7855B",
+"m. c #D39454",
+"M. c #E28C5B",
+"N. c #F7B251",
+"B. c #C78867",
+"V. c #D98866",
+"C. c #D8956A",
+"Z. c #C79878",
+"A. c #D89876",
+"S. c #CD8C70",
+"D. c #E38A68",
+"F. c #E5956A",
+"G. c #E79776",
+"H. c #ED9176",
+"J. c #D6A371",
+"K. c #E8A379",
+"L. c #F3A677",
+"P. c #D8A05D",
+"I. c #3D65AB",
+"U. c #3F67B2",
+"Y. c #3B5C9C",
+"T. c #506796",
+"R. c #72748D",
+"E. c #446AAE",
+"W. c #4869A9",
+"Q. c #4166B2",
+"!. c #436BB3",
+"~. c #496EB4",
+"^. c #476DB9",
+"/. c #4A71B6",
+"(. c #4C73BA",
+"). c #4772B6",
+"_. c #5176BC",
+"`. c #547BBD",
+"'. c #577BB7",
+"]. c #5572A9",
+"[. c #6B7CAA",
+"{. c #505B8C",
+"}. c #557CC1",
+"|. c #4C73C2",
+" X c #897987",
+".X c #9F7593",
+"XX c #C46B87",
+"oX c #5981BF",
+"OX c #5884BD",
+"+X c #768AB9",
+"@X c #7288B5",
+"#X c #5C83C3",
+"$X c #5D8AC5",
+"%X c #6186C5",
+"&X c #648AC6",
+"*X c #6B8DC6",
+"=X c #668BC9",
+"-X c #6B8ECA",
+";X c #6586C6",
+":X c #738DC7",
+">X c #6D91CB",
+",X c #6C94C6",
+"<X c #7294CC",
+"1X c #7895C8",
+"2X c #6E92D1",
+"3X c #7294D3",
+"4X c #7698D5",
+"5X c #708ED1",
+"6X c #7799E3",
+"7X c #9B9399",
+"8X c #928890",
+"9X c #B89887",
+"0X c #A99191",
+"qX c #B9A598",
+"wX c #B1A394",
+"eX c #8C8EAA",
+"rX c #AB9AA6",
+"tX c #ABA4A9",
+"yX c #B7A9A8",
+"uX c #B7ABB4",
+"iX c #B6AFB7",
+"pX c #C69B86",
+"aX c #D4978B",
+"sX c #EF9C83",
+"dX c #CAA487",
+"fX c #D7A787",
+"gX c #C7A899",
+"hX c #D1B294",
+"jX c #E9A887",
+"kX c #F8A886",
+"lX c #F9B798",
+"zX c #F1B291",
+"xX c #C9B3AD",
+"cX c #F4B9A5",
+"vX c #D497B3",
+"bX c #D5C6B1",
+"nX c #FEC4A6",
+"mX c #EAD0B2",
+"MX c #EDD1A4",
+"NX c #8399C8",
+"BX c #B2B4CD",
+"VX c #C7BBC7",
+"CX c #D3CBCF",
+"ZX c #ECDAD1",
+"AX c #F6E6DA",
+"SX c #F7EACF",
+"DX c #D1D1E9",
+"FX c #E7DDE4",
+"GX c #E9E5E8",
+"HX c #F7EAE6",
+"JX c #FDF6E9",
+"KX c #FEFCFE",
+"LX c #FAF7F7",
+"PX c #F1EBF6",
+"IX c #DCE2E5",
+"UX c #BEC5DF",
+/* pixels */
+"L k f k P l y j T R I I U U L U R Q T L E E E R R R E U j } GX9XfXpXxXR.j ~ ~ = V Z.G > b R.DXPXLXHXHXHXHXCX~ / T.Y.T.T.W.T.W.E.Q.I.E.I.I.E.E.I.I.I.I.I.Y.I.Q.^.Q.E.E.E.E.Q.Q.~.U.U.U.U.U.U.Q.Q.U.U.U.U.U.U.Q.Q.Q.Q.U.U.U.Q.~.~.Q.U.Q.~.^._._._._._._._._.(.(.(.",
+"L k f L L k y h T R I L U U L U R R T L E E E R I R I U l  XuX' fXV v [ / P h z V Z.G a y l [ 7XCXHXJXHXHXCXb ! {.{.T.{._ _ {.T.W.W.T.T.W.I.I.U.U.I.I.E.W.I.I.Q.Q.E.E.E.Q.Q.~.~.~.U.U.U.U.Q.Q.Q.Q.U.U.U.U.U.Q.~.~.~.U.U.U.U.U.Q.~.Q.Q.Q.~.~._._._.'.`._._._._._.",
+"L k f L L k 0 h T T I E U U L T T T U L h h E U R R E U W R.{ D pXF z l L U ^ p F fXD i P W Y ~ n CXHXHXHXFX8Xl W ~ ~ l ^ b b ^ ^ / [ T.W._.U.^.U.U.Q.E.W.W.~.^.E.E.E.~.~.Q.~.~.~.~.~.~.~.~.Q.Q.Q.Q.U.U.U.U.U.U.~.Q.U.U.U.U.U.U.^.~.~.Q.~.~._._.`.`.`.`._._.|.|.",
+"k k f L L k 0 h U T L h I U I T T T U k h k E U Q I E U k ` m ' hXV z k U I Q d V fX( j L U W W z VXLX8X XuX( z b x d `  X X` n n b b ! {.W.~.I.Q.Q.Q.E.W.].~.I.~.~.~.~.~.~.~.Q.~.~.~.~.~.~.~.~.~.Q.Q.Q.U.U.U.U.U.Q.U.U.~.~.Q.Q.Q.Q.Q.Q.Q.~._._._._._._._._.|.|.",
+"k k f L L k q j U T L h U U I T R T U k h h E I E R I I k b p ' Z.V z k ! T U p H Z.c k U L U W n CXCXn z = c c v 7X8X` 8XPX} c R.tX` n b / {.].W.~.~.E.W.E.~.^.~.~.~.~.^.~.~.~.~.~.E.E.~.~.~.~.~.~.~.~.~.~.U.U.~.U.~.~.~.~.~.Q.U.Q.~.~.E.~.~./././.(.(.(.(.(.(.",
+"h k h P L k q j U T L h U U I T R T U h h h E E I R I E k d p ' dXV x P U L L z J fXv l L L P j n IX` m = = 7 ' HXLXKXCX7XKXtXrXLXKXJXqXv n ^ {.T.T.T.W.].E.Q.^.~.~.~.~.^.^.~.~.E.E.E.E.E.~.~.~.~.~.~.~.~.~.U.U.~.~.~.~.U.U.U.U.Q.Q.~.~.E.~.~.E.~.~.~./././.(.(.",
+"j k k P Y k q h U U k h U R I R R T U h h h E E R R E I Y d d ' Z.V p L ! ! Y = H Z.v j h ! l b n iXtX7Xa p t.LXZX0XHXPXKXKXPXLXLXCXbXAXVXn m 8XVXeX[.T.W.W.^.^.~.~.~.^.^.^.^.~.E.E.E.E.E.~.U.U.~.~.~.~.~.~.~.~.~.~.~.U.I.I.I.~.~.Q.Q.~.~.~.~.E.~.~.~./.(.(.(.(.",
+"j k k U P k 0 y L U k h U R I R T Q T E f E E E E I I I f k z ` Z.V d U T L P z >.B.c j l l l } IXKXKX8Xp ` t.` t.' G ] tXIXIXwX] ' z.t.` { c n PXKXLXUX+X].E.~.~.~.~.~.^.^.^.~.Q.E.E.E.E.U.U.U.~.~.~.~.~.~.~.~.~.~.I.I.I.I.~.~.~.Q.Q.Q.~.~.~.~.~.~.~./.(.(.(.(.",
+"j k R.~ k k q q Y T k f Q T I I I Q I L E L E E R I I E f d x ` dXV d T T T U z -.Z.c b s b CXLXKXLXKX} z 7 7 z.hXSXSXz.AXbXmXbX0XJXmXmX` 1 n b iXKXLXLXLXDX@XT.].W.E.(.U.|.^.^.~.~.W.E.~.~.~.~.~.~.U.~.~.~.~.~.~.U.I.I.I.U.~.~.Q.~.~.~.~.E.~.~.~.~.~.~.~.~.^.^.",
+"j ~ DX[ W q s q Q I f h Q L R R R R I I L f E I I I I L P d x ` dXV d R R T Y z -.Z.7 0 ` GXLXKXJXLXJX` 7 7 7 t.hXMXmXJXLXJXJXJXJXSXSXmX' n z b 7XKXKXPXKXLXPXBX].T.W./.^.^.U.|.~.~.~.~.~.~.~.^.~.U.U.~.~.~.~.~.~.~.U.U.I.U.~.~.~.~.~.~.E.E.~.~.~.~.~.~.~.~.^.^.",
+"r x DXIX~ s $ b L U L L Y Q L I I I T L f L U E T T L k k d x ` dXV x T R U L p 9.Z.7 | KXKXLXLXJXSXZXD v 7 7 D mXMXmXSXZXZXCXZXAXZXdXmXG v n n 7XKXLXKXKXKXLXKXDX[.T.]./.I.}.U.~.~.~.~.~.~.~.U.~.U.U.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.U.~.~.~.~.^.^.^.^.",
+"r b CXPX X[ iX[ Y U L k P [.~ k U T U L f f f L I U U k f d x ` dXV z T T U L z 9.x.D LXHXJXJXZXqXqXmXD @ 7 7 9 ] mXbXJXKXKXKXLXJXJXMXv.9 7 7 7 } HXKXKXHXLXJXLXKXDX[.T.W.(.~.^.Q.Q.E.E.E.~.U.U.~.U.U.U.~.U.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.U.~.~.~.~.~.^.^.^.",
+"d x VXKXPXGXCX` P U L Y ~ BX| l k P k k k P w k h L L P j d d ( dXZ z P ! L k z 9.B.mXJXJXSX9Xz.t.D 5 5 5 7 7 9 hXmXv.mXLXKXKXKXJXSXv.mX] v c v D t.xXZXJXJXJXLXPXKXUXT.W.E.~.~.Q.Q.E.E.E.E.Q.Q.~.I.I.~.~.E.E.~.~.~.~.~.~.~.~.~.~.~.~.I.~.~.U.U.~.~.~.~.^.^.^.(.",
+"x 8XGXPXHXHXtXb k U U k l CXtXd b ~ | {.j q k f P / h k k d d ( dXF < k ! L k z 7.zXSXJXSXt.] V 3 3 X 5 @ 2 c 7 z.v.bXSXAXKXLXLXZXmXhXMX' 7 n 7 9 3 8 ] qXZXJXLXLXKXPX@X].W.I.^.~.~.~.E.E.~.~.~.E.I.E.~.~.E.E.~.~.~.~.~.~.~.~.~.~.~.~.~.~.U.U.U.~.~.~.~.^.^.(.(.",
+"uXGXHXLXJXAX} & W Q g g ~ DXCX` [ VXDX[ s j s y ^ eX~ j j d l ( pXF 7 k ! L L z 7.nXJXAX] D 3 3 3 X ' ] 7 1 = 9 t.SXSXMX9XZXJXJXxXmXSXSXJ v v 7 9 ] 9 9 5 ' 9XxXJXHXGXDX{.'.).~.~.~.E.E.E.E.~.~.~.~.~.~.~.E.I.~.~.~.~.~.~.I.I.~.~.~.~.~.~.~.U.~.U.U.~.~.^.(.(.(.",
+"iXFXPXLXLXLXyX( k W k ~ b CXGXFXPXGXtXl l s 0 j ^ DX` d d d x D pXF z P T L P z ' AXAXz.5 X 3 9.] 9 5 v.5 G ` 9 J hXhXhXmX9X' ] qXhXhXMX] 9 D 9 G z.5 ] t.8 8 G wXHXPXIX[.T.W.].~.~.~.~.E.E.~.~.~.~.~.~.~.E.E.~.I.~.~.~.~.I.I.I.~.~.~.~.U.U.U.~.U.U.U.~.^.(.(.(.",
+"d n } LXLXCXVX[ W W d ` tXHXAXAXHXIX^ x j l w s ` GX7X7 n } ~ D dXH p k ! P k l ` xX8X2 @ 5 7 gXbXhXhXv.hXmXSXmXMX9.J 5 5 V 9 9 9 V G dXhXSXSXdXhXl.MXMXdXV J V 9 wXLXFXtXR.T.T.W.~.^.~./.E.E.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.).~.~.~.^.^.^.^.~.^.(.(.(.",
+"d d [ LXVX( ^ ~ k ^ 7XFXLXHXJXHXAX} x l k w l i ` GXCX8XbX Xx v Z.H z k ! P d d i . & @ . 2 7 v z.v.V dXmXdXZ.mXSXSXSXbXt.` 7 D ] bXJXSXSXSXMXSXSXl.hXMXhXmXMXV 5 v xXxX} ^ ! {.W.~.^.U.).E.E.E.~.~.E.E.~.~.~.E.~.~.~.~.~.~.~.~.~.~.).).).).(.(.(.(.(.(.(.(.(.(.",
+"f ~ ` PXR.l l j Y ~ { uXFXLXJXHXFXuX~ W f f d a } HXZXxXyXn d n Z.H 7 j P l j r p & o @ @ @ o 7 X 9 D ] V 5 hXbXqXv.] G D ` n ` G ' 0X9XmXmXz.G 9.9.3 8 ] hXgX9XwXv D z > $ l ! W.~.^.U.).E.~.E.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.^.~.)./.(././.(.(.(.(.(.(.(.(.(.(.",
+"g W ^ DX( l l q L W r b ` CXLXLXPXPXR.k k ^ | 8XCXHXbXxX{ < d v Z.J 7 j l d r * . > 2 o . @ 2 = 7 X X 5 D 5 5 5 9 9 9 @ 7 7 2 v 7 7 v 9 v V D G qXgXxXD 3 3 ' z.D 9 2 > 1 # d u Y.W.~.~.).E.W.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.~.^.~.)././././.(.(.(.(.(.(.(.(.(.(.",
+"U U / eXP P l f L L d r b CXPXR. XUXDX/ k ~ ` 7XCXZXZXyXv p k v B.-.o d l i * * & o o 2 @ . & . < & o 7 o 7 2 @ @ @ 7 2 v < z < z 7 2 7 9 7 5 9 ] z.ZXCX` 7 5 X @ @ & . o # % u _ W.E.E.E.E.E././././././.~.~.~.~.~.~.~.~.~.~.~././.(.(./.(.(.(.(.(.(.(.(.(.(.(.",
+"f U ~ / L U k f U Y k x d DXVX~ x W {.[ f d 2 7 t.ZXZXxX} x k z x.-.3 d a $ & & . 2 o . @ . # p # , & . > & o z 7 2 2 2 o & < & < . > 7 > 7 7 7 v ' m 7 @ 2 . @ . + . > . > % y _ W.E.E.E.E.~./././.(.(././.~.~.(.(.~./.~.~.~.~.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.",
+"I T P P ^ ~ k k L U q l ~ DX{.W W Q Q ~ d * * o { HXxXVXCX^ q z x.>.5 i , # & & > o > . + + > . # . * * . < & . o o 2 7 & 2 2 2 > > < > 2 7 o o @ . @ . o . . + . . # & . . ; u / ].W././././.(././.(.(././././.(.(.(.(.(.(././.(.(.(.(.(.(.(.(.(.(.(.(.(.(.}.}.",
+"E Q L P Q Q P f f L k k ^ BXU ~ P W T Y j i * *  XFX` b 7XR.l 7 l.>.7 , # # < o o . > . - - - $ # # . & , . & . o o o . . o . o o . . . . . o o o @ . . . . 2 . + . - . > > . w _ ].W./././.~.(./.(.(.(.(././.(.(.(.(.(.(.(.(.(.(./.(.(.).).(.(.(.(.(.(.(.(.(.}.",
+"I U U U T Q k h L L h P Q / T L U T T U j 0 0 r 7XuXd r d ^ l < r.0.5 ; - - - & . > # # - + % # . . + . # # . . . . . . . . . . & # . . o o o o . o o . . . . . + . # # . > ; w _ ].]./.E.(.(.}.(.(.(.(./././././.(.(.(.(.(.(.(././././.(.(.(.(._.(.(.(.(.(.(.(.",
+"L U U U T Q k q k L k P U Q U U U T T U k q q r  X( j d 0 t y 7 r.0.@ ; + - - & . > & . . - - , - + + + . . + > . . . . . . . . . . . . o o o o o o o . . . . . . . % . . . - t / ].].]./.`.(.|.(.(._._.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.(.",
+"L U U T T Q k q k k k P I I I T R R T U L f q f / L W q w s s 2 0.r.X ; % - # # > > . # > + . . . . . @ @ o . o o o o o o o o o o o o o o o X X o o o o o . # # - . # > o . # w ^ ].].'./.`.(.}.(._.`.`.`._._._.`.`.`.`._.(.(.(._._.(.(.(.(.(.(.(.(.(.(.(.(.(.(.",
+"L U I T R Q j q k k h L I I R T R R T U L f q f E T U f j j 0 7 0.l.X ; % - # . . # . . . . o @ X X X X X X X 3 3 3 3 3 o o 3 3 o o 3 3 3 3 3 3 3 3 X X o X o o . . . & o o - % ! ].].'./.(.(.}.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.(.`.`._.(.(.(.(.(.(.(.(.(.(.(.(.(.",
+"k U U T R Q k q l k f L T I T T R R T U k f 0 q I R E L q q q 7 >.l.X , % + . . . & = o @ X X X 3 4 N N N V V V V N N N N N N N N N V V F F H H H H F V 8 3 3 3 o . & o . . > % P ].].'./.'._.}.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.(.(.(._._.`.(.(.(.(.(.(._._.",
+"k P U T R Q k q k k k L T I T T R R T U k q 0 q I I T f w j j 6 >.r.3 - . + + . > . X @ X X 3 N F 6.r.y.y.y.y.y.y.r.r.0.6.7.6.7.7.6.6.0.r.y.B.B.y.y.x.x.y.7.V 3 X . & & @ . # % h ].].'.'.'.`.}.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`._._._._.(._._.}.",
+"k P U T Q Q k q f l k L T E T T R R R U j 0 0 y k E I L k j q 7 0.<.3 # . + . . o o X X 3 9 ' c.Z.A.aXaXaXaXjXjXjXA.A.A.S.B.S.B.S.S.A.A.G.K.K.G.A.C.C.Z.A.Z.r.' 9 o X o o @ - ; u ].].'.'.'.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.}.}.`.`.`.`.`._._._.}.}.",
+"d W U R R Q k q f k g L T I Q R T R R U j 0 0 y k L I I f f f 6 r.>.3 # . . . . X 7 7 8 G t.pXaXaXA.A.fXzXzXzXlXzXjXzXlXzXzXzXzXkXzXkXzXlXlXzXjXK.K.K.A.A.K.Z.c.t.G 5 3 X o . t u '.'.'.'.'.'.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.}.`.}.}.`.`.`.`.`.`.}.}.}.}.",
+"` b U Q R Q k q q l L L L T T R T T R U k 0 0 t j U I E L f f 7 r.r.X . . @ o o v ' F H y.Z.fXfXK.jXjXzXzXzXzXlXcXlXzXlXzXzXnXcXzXlXlXlXzXnXnXcXlXjXzXA.jXA.J.B.c.t.-.D 3 X & % K '.'.].'.'.oX`.oX`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.}.}.`.}.}.}.#X#X",
+"xXz W Q I _ ~ y j j f U I I U U U R T U k q 0 t k U I L L f f = 0.l.X @ @ . . 9 ' ' H 0.B.A.fXfXjXjXzXzXzXlXcXcXzXzXlXnXcXzXzXzXcXcXlXcXzXzXzXzXzXcXjXA.G.A.C.B.Z.y.e.-.D o @ % K '.'./.'.'.'.oXoXoX`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.`.}.}.}.}.}.}.}.}.}.}.",
+"HX7Xx ^ eXBXM $ l x Y U R R I R I I T U k q 0 y k U I I k j j = 0.l.X > o o 7 D ' H 7.y.B.A.fXfXjXzXzXzXzXzXjXjXzXzXlXnXlXzXzXzXjXzXzXsXsXD.B.e.x.x.S.A.B.B.S.Z.Z.c.l.e.' 7 @ , ! [.'.`.'.'.oX#XoXoXoXoXoXoXoXoXoXoXoXoXoX`.`.`.`.}.}.#X#X}.#X#X}.}.}.#X}.#X}.}.",
+"AXZX{ CXPX| d 0 ` R.d Y U R I U E L R U k q q y L U U U k h l o r.l.X > . o v D H H r.x.l.B.A.A.B.B.B.e.e.e.B.S.jXzXzXlXzXzXcXzXfXjXjXD.D.a.q.e.r.e.Z.A.jXA.Z.Z.Z.c.e.e.9.G 5 # ^ [.'.`.'.'.'.'.oXoXoXoX#X#XoXoX#XoXoXoXoXoXoXoX#X#X#X#X#X#X#X#X}.}.#X#X#X#X#X#X",
+"ZXHXHXGXVXb i i ` FX^ W Y g ~ P k L U I k q q q L U I U k q y @ >.l.X $ & 7 9 F ' 7.r.e.x.Z.A.A.A.V.a.a.a.f.B.A.A.jXzXzXzXzXlXzXzXfXA.D.D.8.*.=.*.6.r.B.fXaXfXc.c.Z.B.9.t.` v 7 ^ @XoX'.'.#X%X}.#XoXoXoX#X#X#XoXoXoXoXoX#X#X#XoX#X#X#X#X#X#X}.}.#X#X}.}.#X#X$X$X",
+"HXAXZXFX{ x b # { FXrXx x {.eX^ k L U L k q 0 q f L E E f 0 t @ >.<.X , & 7 G 7.7.9.r.x.Z.Z.S.S.B.e.0.6.6.0.0.0.B.A.jXK.A.jXlXzXjXfXA.g.i.:.%.*.O.Z F Z Z F F F H ' -.7.t.` v c [ @X@X'.oX=X#X#XoXoXoX#X#X#X#XoX#XoXoX#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X;X;X",
+"ZXAXZXGX` b & & ` ZXHX} uXGX8Xl k L U L j r r 0 r W Y f q 0 i 5 w.>.5 , . 9 7.9.-.-.9.c.c.x.B.B.x.r.9.7.7.6.r.y.r.B.A.jXG.jXlXlXzXK.B.e.0.=.C N Z &.6.*.&.H N V t.' V F ' { v v [ @XoX'.oX#X`.#X#X#XoX#X#X#X#XoX#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X#X$X",
+"AXJXHXFXIX^ x = ] ZXAXAXCXVXb j k L U Y d i & & x ^ ~ f q q i X 0.<.5 & 7 D 9.9.-.J H ' G V V N 4 8 N N N N V Z $.r.G.lXlXzXlXnXlXK.b.0.C C 6.B.r.y.y.S.r.c.SX9.8 V A D ` ' D D R.eX+X%X$XoXoX$X#X#X#X#X#X#X#XoX&X#X#X#X#X#X#X#X#X#X#X#X%X%X#X#X#X#X#X#X#X#X#X#X",
+"gXAXCXFXPXuXz D bXAXSXZXCX{ b k L L Y W r ` n v 7XtXx j w r r 3 0.>.8 2 9 ] y.9.H F 8 D D V N 0.cXaXy.r.r.B.S.*.O.Z <.n.kXkXL.L.F.p.;.0.jXy.9.V N N F F r.r.c.MXD V ' F D ' u.'  XR.+X%X$X$XoX#X#X#X#X#X#X#X#X#X#X#X%X&X&X%X#X#X#X#X#X%X%X%X#X#X%X#X#X#X#X#X;X;X",
+"z.ZX` ( { eX{ n CXZXZXZXxXm x k L U Y W r ` } z.iX` r w r r 0 3 0.>.8 D G 9.r.-.F V 3 8 3 N r.y.y.7.F V V N &.B.a.w.p.p.F.F.F.b.p.,.,.q.0.6.V H N V V N C $.H C H F V N V H r.9XgXrX[.*X&XOX&X=X%X%X%X#X#X#X#X#X&X&X&X&X&X&X%X%X%X%X%X%X%X%X%X#X#X#X#X%X%X;X=X=X",
+"z.xXx ~ f x x z t.ZXAXAXCX} x Y U T U k p v ] ] } z r r 0 r s 6 r.r.8 D 9.r.6.C V V D D 8 7.9.r.' V N N N N Z F 0.;.;.s.n.p.a.p.3.1.p.p.;.Z O.V 4 N N N B o.o.%.0.-.H H &.r.f.6.y.yX@X:X'.oX-X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X%X%X%X%X#X%X%X%X&X=X=X=X",
+"} } k W U k 0 & v CXAXCXGXCX~ f L T U k z D t.] 9 o p d w r d = >.l.N D c.e.0.6.F H V F V H F 6.V N V 4 4 N &.6.C O.%.s.i.F.zXkXF.n.M.s.;.i.8.=.&.O.F O.%.%.;.q.B.e.b.w.;.;.q.o.Z 0XeX:X[.@X-X'.&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X&X%X=X=X=X=X=X%X%X",
+"[ ( Q L I U r * 7 CX8Xv } iXR.j L T U k r ( } t.{ . r r s 0 r 6 >.w.N ' y.$.$.=.6.6.6.r.6.$.O.O.O.C O.O.=.=.=.w.d.n.n.M.:.G.lXlXL.,.H.H.D.d.q.g.a.q.0.,.q.d.s.p.a.b.C.w.<.;.d.s.Z t. X[.:X;X;X=X&X&X&X&X&X&X&X&X=X=X=X=X&X&X&X&X&X&X&X=X=X=X=X=X&X=X=X=X=X;X;X%X",
+"~ k L T T U 0 $ b CX` x x x ^ k L L U P d ( ' } 7X` r r s s 0 o 0.w.4 7.6.O.8.8.0.6.B.B.0.;.o.o.o.o.:.s.G.V.s.V.s.H.kXF.%.G.lXlXlXF.H.L.D.s.H.G.kXzXsXD.s.D.F.n.V.V.V.w.<.n.V.a.O.y. X[.:X;X;X2X=X=X=X=X=X=X=X=X=X=X=X=X=X&X&X&X&X&X=X=X=X=X=X=X%X=X=X=X=X=X=X=X",
+"f k Y U L k 0 $ b 7Xj W Q L k q L U U Y r p 2 7 [ } d d 0 s t o r.r.4 F &.o.q.8.=.;.a.C.w.w.:.O.O.;.d.sXsXkXH.s.i.L.lXs.q.kXlXzXlXK.a.kXkXV.a.G.L.H.D.M.p.D.F.V.A.A.A.B.q.D.kXV.%.y.eXoX@X*X$X=X=X=X=X=X=X=X=X-X=X=X=X=X=X=X&X&X&X&X=X=X=X=X=X=X=X=X=X=X=X=X=X=X",
+"k j L k P P q 0 x ^ Y Q R R L k h U U k j * # * p x k l q 0 t @ >.w.8 V 6.C a.g.q.%.w.n.p.p.d.q.:.i.i.V.s.i.q.d.lXkXH.,.V.lXlXlXzXlXs.G.K.lXkXn.n.i.p.i.p.p.G.C.B.V.B.B.a.q.V.A.=..X@X*XoX-X=X$X=X=X=X=X>X-X-X>X-X-X-X-X-X=X=X&X-X-X-X=X=X=X&X&X=X=X=X=X=X=X=X=X",
+"j k L U U k q 0 j j Y U U L L L Y W L k y w ; $ 0 q h k q y y o >.w.4 8 r.O.V.s.8.%.d.s.n.p.n.q.%.i.p.a.a.f.sXlXlXzXF.q.kXlXnXcXnXnXjXB.zXlXlXnXlXkXG.V.V.G.L.F.V.n.b.b.8.o.i.D.r.t.@X+X@X*X-X>X>X-X*X*X*X-X*X*X*X*X-X>X-X*X&X*X-X-X-X-X=X=X&X&X=X=X=X=X=X=X=X=X",
+"j k L U U k q 0 j f k Y Y k k L U W L k y u t 0 w j f f k y s 3 0.l.3 V r.=.D.s.:.%.i.i.n.n.V.q.,.s.G.kXlXnXnXcXlXnXb.C.zXlXcXnXnXlXnXS.G.zXlXlXlXlXzXK.K.K.F.V.V.n.,.C.d.o.;.S.c.8XeX:X@X;X-X=X>X-X*X*X*X-X*X*X>X-X-X-X-X*X*X*X-X-X-X-X=X=X=X=X=X=X=X=X=X-X-X=X",
+"j k L L P j 0 0 j k L P Y k k L U U L h y 0 r r f f f f k w i 5 >.w.V 9XcXe.V.V.%.q.s.i.p.n.b.w.:.,.L.nXnXnXnXnXnXlXq.jXlXlXcXnXnXlXlXjXq.sXzXzXlXlXK.F.G.F.V.n.V.p.w.C.sX8.q.f.9X8X+X*X*X-X2X-X>X-X-X-X-X-X-X-X>X-X-X-X-X-X*X>X-X-X-X-X-X=X=X=X=X=X-X-X-X-X-X-X",
+"h k L L P j 0 0 j k Y U P Y k Y Y U k h y w r r j r j f y t r X C C.c.hXcXA.K.p.w.A.C.q.<.p.a.b.p.i.F.lXcXnXlXzXjXq.q.G.kXlXcXlXnXnXnXzX0.:.s.H.G.G.G.K.kXkXF.n.a.e.b.C.kXD.q.y.0XeX+X*X*X-X-X=X>X>X-X-X-X-X-X-X>X-X-X-X>X-X-X>X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"h k L L k s $ $ y j L Y Y L L Y Y U k h y 0 r r r f k r r d & 9 w.C.c.hXcXA.G.n.C.jXG.q.<.p.w.b.D.i.p.D.kXkXV.i.;.:.D.H.kXlXnXcXcXlXlXlXsXi.8.8.:.;.a.G.G.G.F.a.a.a.l.C.kXs.q.S.8X@X:X>X-X-X>X=X>X-X-X-X-X>X-X-X-X-X*X>X>X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"k k L L l t $ $ y k L Y L L L Y Y P k h y 0 r r r f f s r # 7 t.J.P.c.hXMXfXC.G.C.K.K.a.q.i.w.p.F.M.i.:.%.;.;.:.o.s.kXH.kXzXcXlXlXlXzXzXsXH.8.H.H.H.sXkXD.V.V.a.b.e.B.A.G.q.V.B.8X@X*X-X-X-X2X2X>X>X-X-X>X>X>X-X-X-X-X>X>X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"k L L L l t % $ y k L I P P L L L Y h h y y s q r r r s * & ' hXK.J.x.hXcXx.B.K.C.A.J.b.i.i.p.b.a.F.D.s.V.H.V.i.:.H.D.V.G.sXzXzXjXG.sXV.s.s.:.q.H.kXkXH.D.n.n.V.b.e.B.A.b.V.G.c.eX:X>X-X&X*X*X&X>X>X-X-X>X>X>X>X>X-X>X>X>X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"k k L k j t # ; y k L I L L L k g L f h y y s 0 q r s r * D wXgXJ.P.x.cXMXl.b.C.jXA.C.e.q.i.a.b.p.n.V.H.sXkXV.%.o.;.O.%.q.q.f.B.B.f.8.:.Z O.B O.s.G.H.D.H.V.V.C.B.e.B.0.C.K.s.pXeX&X=X-X,X,X<X*X>X>X-X-X>X>X>X>X>X>X>X>X>X-X-X>X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"f P k f ~ 0 $ ; j w I T L L f L Y P k y y y y % 0 w y i ` 0XgXhXP.P.x.cXhXl.x.A.b.b.%.w.p.i.a.n.p.n.V.D.G.V.:.o.V.q.Z Z C o.$.$.$.O.=.o.%.g.:.B :.s.g.s.V.n.V.C.V.B.e.q.q.w.A.9X+X-X=X>X*X*X*X,X*X>X>X>X>X-X>X>X<X>X>X-X-X*X*X*X-X-X-X-X-X-X-X-X-X-X-X-X-X2X3X3X",
+"d j f W s s $ % s k g L L k h g g k f y t t t t w y t | tXwXgXfXP.P.B.cXhXc.x.A.C.B.C.K.V.i.p.n.n.a.F.V.V.i.o.i.G.G.V.V.V.0.o.N C 8.g.V.g.D.i.Z B ;.d.s.s.s.V.C.B.C.kXG.K.C.fX0X+X=X=X-X*X*X*X:X*X>X>X>X>X-X>X>X>X>X>X-X*X*X*X*X-X-X-X-X-X-X-X-X-X-X-X-X-X-X>X>X",
+"p d W / d $ i i 0 k P U P k L k g f q q i i $ i $ d 8XiXrXgXgXfXP.P.B.cXhXZ.x.S.jXA.jXkXsXa.p.n.F.n.n.V.i.O.:.D.H.D.H.V.H.H.g.q.a.V.s.V.s.a.V.q.B o.:.,.i.s.V.C.V.C.jXzXC.fXgX8X+X*X-X>X,X*X:X,X*X>X>X>X-X-X>X>X>X-X-X*X*X*X*X*X*X*X-X-X-X-X-X-X-X-X-X-X-X-X-X>X",
+"( m  X[ d s $ $ l q j k k k h f g k j 0 i , & * x 7XiXtXyXqXgXdXP.P.B.cXhXZ.r.e.jXzXjXlXjXa.b.V.C.n.a.p.%.o.s.D.H.H.G.H.G.G.sXH.sXH.V.V.D.V.H.s.O.B O.;.a.V.s.b.b.A.zXjXK.dX0X8X+X*X-X>X,X:X:X,X*X>X>X>X-X-X-X>X-X-X-X*X*X*X*X*X-X*X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"qX0X8Xx r r * $ 0 s j j j f g k g j j r * & 6 D  XrXuXyXyXgXgXfXP.P.B.zXhXZ.9.=.A.jXjXzXr.e.V.b.F.b.n.<.o.:.s.D.G.sXsXkXsXkXlXzXzXsXsXD.H.G.G.V.s.O.o.:.i.s.V.C.B.B.zXjXB.c.7XeX+X*X-X>X>X*X*X-X-X>X>X>X-X-X-X>X-X-X*X*X*X*X-X-X-X*X*X*X-X-X-X-X-X-X-X-X-X-X-X-X",
+"mXqX} z p z $ * b ` b j l w k k h f s i = 6 A u.rXrXyXxXqXqXxXfXJ.P.B.zXhXZ.-.H >.B.A.0.N -.e.C.C.C.n.:.o.p.d.H.G.sXG.kXsXkXlXzXzXkXsXsXsXG.G.V.V.i.o.d.n.V.F.b.B.*.r.B.e.9XeX@X+X*X-X-X-X*X*X-X-X-X>X>X-X-X-X>X-X-X-X-X-X-X-X-X*X*X*X*X-X-X*X*X-X-X-X-X-X-X-X-X",
+"hXqXD z z e * ( R.[ d $ d s q q h h j r 6 c A u..XvXxXyXqXqXxXdXP.P.x.hXzXZ.7.H -.0.0.Z 4 H w.V.V.G.V.,.:.s.s.D.s.a.q.d.i.d.H.H.g.s.i.s.s.a.s.D.s.V.;.s.H.F.G.V.e.C F 6.fXwX+X+X+X+X-X-X-X*X-X-X-X-X>X-X-X*X-X>X>X>X-X-X-X-X>X>X*X*X*X*X*X*X*X*X-X-X-X-X-X-X-X-X",
+"bXqX( z = p & ` } p d d 0 s q k q h j $ 6 c A &.y.gXxXxXyXqXgXhXP.P.B.fXzXZ.9.H H =.x.9.V V e.C.C.F.kXs.i.d.s.d.%.o.o.o.o.o.:.:.o.o.o.o.o.o.o.:.q.d.D.F.kXF.n.B.B.C *.c.c.z.eX+X:X:X-X5X-X-X>X>X-X-X>X-X-X-X-X>X>X>X>X-X-X>X>X>X-X*X*X*X*X*X-X*X*X-X-X-X-X-X-X-X",
+"ZXxX.Xz z = . ` n x d s l q q h f j s r = A S S r.9XgXyXxXqXgXfXC.F.m.fXfXe.6.H F V D D V N 0.b.V.G.L.L.i.i.:.O.o.%.:.;.8.8.+.+.:.d.H.D.s.D.n.a.i.s.n.L.L.F.S.Z.e.H -.y.qXtX@X,X*X-X5X5X5X>X>X>X>X,X,X,X,X,X-X-X<X>X,X*X>X>X*X*X-X-X-X>X-X-X-X*X*X-X-X-X-X-X-X2X",
+"0XyXuX( = p . { ^ * d j j h y s r j s r 6 A S B 6.pXgXyXgXgXgXfXF.F.m.jXZ.0.>.;.Z N 3 9 v V =.b.b.n.G.L.V.p.a.p.s.s.g.H.sXsXH.sXsXH.G.sXH.D.s.n.V.p.F.L.F.n.A.B.9.H 9.c.yXtX+X+X-X2X5X5X5X-X>X>X>X>X,X,X>X>X-X-X>X,X,X*X*X*X*X>X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X>X",
+"` = { } z & < 7X{ * d r q j 0 s s r y r 6 A S B ..g.gXgXgXgXgXfXF.P.B.fXZ.>.;.,.<.Z N N N N F w.p.n.L.F.n.p.M.n.s.n.n.V.H.sXsXH.H.D.H.V.d.p.n.F.F.p.F.L.n.n.B.x.-.H 9.0XtXeX+X<X2X>X>X>X*X,X>X>X>X>X>X>X>X-X-X-X*X*X,X*X*X*X*X,X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X>X",
+"z p r z r * & }  Xx d r r s 0 s s s t * 6 N S B B r.gXgXgXgXhXfXP.P.B.J.Z.0.,.<.3.3.<.Z N N Z 0.a.b.V.F.M.3.n.M.s.p.p.p.i.q.8.;.:.:.8.q.p.D.F.V.V.a.M.M.M.a.B.r.J -.t.8X7X@X:X<X2X>X>X,X,X,X>X>X<X>X>X>X>X>X-X-X*X*X*X*X*X*X*X*X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"i d r s r * $ < } b d r d r 0 d y s i & 3 N B B B O.aXgXgXgXhXA.P.P.l.J.Z.0.,.<.3.2.k.k.<.Z N *.w.p.p.F.n.p.n.n.F.D.n.d.,.;.;.;.;.:.;.<.p.n.n.p.V.V.n.n.s.a.y.7.7.9.} 8XeX:X<X-X<X>X>X>X>X>X<X5X<X<X>X>X>X>X>X>X<X>X*X*X*X*X*X*X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"y q j q $ r * * b x d r d q i i t i = 6 N B B B B ..h.aXgXgXhXZ.P.m.b.J.A.>.<.<.3.2.2.2.3.1.B *.q.n.p.p.,.n.D.s.p.s.s.a.V.G.G.G.D.V.V.a.p.p.p.n.C.V.s.D.i.a.y.H 9.t.} eX+X1X<X>X>X>X,X>X>X<X3X5X<X<X<X>X>X>X>X>X<X>X>X*X>X>X>X*X>X-X-X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"l w h l s $ . & $ i s q j q y 0 t * 6 A B B B B B  .+.aXaXaXgXZ.P.m.b.K.A.<.,.3.4.2.2.2.4.1...O.d.w.q.a.n.n.D.F.F.D.V.H.zXzXzXzXzXL.kXkXL.L.L.L.C.a.n.d.s.q.B.' } 8XeX+X+X,X,X,X,X,X,X>X2X3X3X3X<X<X<X<X>X<X<X<X<X<X>X>X>X>X>X>X>X>X>X-X-X-X-X-X-X-X-X-X-X-X-X-X",
+"y l h s $ $ * & i 0 j f h q t ; , o 4 A S  .B B B .. .g.aXaXgXZ.m.P.m.G.C.q.3.4.4.2.2.2.4.4.o.o.s.q.p.p.V.a.n.V.s.D.D.D.L.lXlXlXzXH.kXkXL.L.F.L.B.b.a.;.a.e.c.t.} eXeX+X>X>X,X,X,X,X,X2X2X3X3X3X<X<X<X<X<X<X<X<X>X>X<X>X>X>X>X<X>X>X>X>X-X-X-X-X-X-X-X-X-X-X-X-X",
+"y h j s r $ # # i t q y h q t , = c A S  . .B B  .X...+.aXpXpXx.k.N.m.n.n.,.p.4.4.2.2.2.4.3.Z B e.b.q.w.p.b.p.n.n.M.n.n.F.F.L.kXH.G.kXzXkXL.C.C.e.0.;.q.q.r.y.t. XeX:X1X3X2X1X,X,X,X,X>X2X2X3X3X<X<X<X<X<X<X<X<X>X>X<X<X>X>X>X>X<X>X>X>X>X-X-X-X-X-X-X-X-X-X-X-X",
+"y s s s r $ # # $ d l q q q i = c A S ..X.X.B B  .X...@.f.S.aXe.k.N.k.p.p.<.3.4.3.2.2.2.3.,.Z F A.b.;.;.w.p.,.p.n.n.n.p.n.n.F.V.V.D.G.A.F.F.n.e.0.$.%.o.%.x.y.D 7X[.+X5X3X3X-X>X,X,X,X,X>X>X<X3X<X<X<X<X<X<X<X<X<X<X<X>X>X>X>X<X<X>X>X>X-X-X-X-X-X-X-X-X-X-X-X-X",
+"r s s i r $ # # ; d j q r d = 6 A S S ..X.X. .X. .....B :.S.aXe.k.N.k.<.<.<.3.<.2.2.2.k.<.$.8 gXaXB.r.%.$.%.%.;.a.n.b.a.s.e.e.q.e.g.B.f.a.a.q.=.F C Z C r.Z.t.o ^ R.+X5X3X6X6X2X>X,X,X,X>X>X<X<X<X<X<X<X<X<X<X<X<X<X<X>X>X>X<X<X<X<X>X>X-X-X-X-X-X-X-X-X-X-X-X-X",
+"r s s r r $ # - ; i q r r 6 6 A S S ....X.X. . . ..... .o.g.S.b.k.N.k.<.<.1.3.3.k.2.2.3.;.4 9 AXc.S.f.*.Z N Z C =.0.q.0.=.$.&.=.6.6.6.=.=.%.%.o.Z N Z r.B.Z.t.X < M T.:X5X3X3X4X3X<X,X,X,X,X<X<X<X<X<X<X<X<X<X<X<X<X<X>X>X>X>X<X<X<X>X>X-X-X-X-X-X-X-X-X-X-X-X-X",
+"s s s r r $ # - ; i r r 6 6 N S S  .X.X.X.X. .B  . . . .B i.V.b.k.N.k.<.<.:.3.3.3.4.k.<.4 X t.bX9.S.f.e.$.N N N Z F F Z V N V F F V N N Z Z C o.Z Z 0.B.B.Z.t.@ > $ y {.NX3X3X-X3X3X<X,X1X1X1X<X<X<X<X<X<X<X<X<X<X<X<X>X>X>X>X>X<X<X>X>X>X-X-X-X-X-X-X-X-X-X-X-X",
+"j j j r 0 $ # ; i p p 6 8 A S .. .X.X.X.X. . .B B B ..B X.:.D.,.k.N.k.1.:.%.p.<.,.<.-.8 X X wXgXH S.f.f.r.C C Z Z Z N 4 4 8 8 4 4 4 4 4 N C $.$.F 6.f.a.Z.Z.t.o . - $ y [ +X1X6X3X4X4X<X1X1X<X>X<X<X<X<X<X<X<X<X<X<X<X<X<X>X>X>X<X<X<X>X>X>X>X-X>X>X>X>X2X2X2X2X",
+"j j j q 0 $ # ; , * c c A S .. . .X.X.X.X. .B B B B .. .X.+.D.;.k.N.N.1.1.%.w.%.0.V 3 3 = & xXgXZ A.B.e.r.*.&.&.&.H V N 8 8 3 3 3 4 N V F =.6.*.*.0.e.B.B.pXz.X < # # ; % ^ @X,X>X3X4X3X1X<X>X>X<X<X<X<X<X<X<X<X1X<X<X<X<X<X>X>X<X<X<X<X>X>X>X>X>X>X>X>X2X2X2X2X",
+"j j j q 0 $ # - , z ( ) S S ..X. .X.X.X.X.X.B B B S B ..X.X.g.;.m.N.P.1.%.$.r.H 3 3 @ o * . CXmXV C.B.e.e.;.$.6.=.7.F V N 8 8 8 4 N V F &.6.6.*.6.f.e.B.B.mXt.o # , & . - + h _ @X:X1XNX1X<X4X4X<X<X<X<X<X3X<X<X4X4X4X4X1X<X>X>X<X<X<X<X<X<X3X3X>X>X>X>X>X2X2X2X",
+"s s d w r $ # . 7 } vXXXS ..X.X.X.X.X.X.X.B B B B B B X.....f.;.m.L.P.-.Z N 3 X o o # # # & CXZXF e.B.e.e.;.;.=.6.6.&.F Z V N 8 N N Z C =.6.*.*.0.f.e.B.hXZX} ; # # & & # # ; u w ! {.+XNX,X,X4X1X<X>X<X4X4X3X>X3X4X4X1X<X<X<X<X<X<X<X3X3X3X3X<X>X*X*X*X-X<X5X5X",
+"i r s r s $ . v 8XxXgXy.*...X.X. . .X.X.X. .B B B B X.X. .B y.r.0.>.Z 3 X X . . # # # # > @ CXZXF 0.A.e.0.q.;.=.;.=.O.O.C Z V V F C O.%.6.;.%.;.e.e.B.Z.SXAX| % # # # # # # # # ; t u h _ +XNX+X<X<X<X<X<X<X4X4X4X4X4X4X<X<X<X<X<X<X<X3X3X3X3X<X<X,X,X,X<X5X5X5X",
+"i r s s 0 # 2 } yXxX9Xy.g.O.....B ....X.X. .B B B B  .X...S F V 3 3 X X X @ & # # # # # & @ CXZXV -.B.C.a.<.;.;.;.*.O.&.F F F H &.O.$.=.8.=.%.0.q.e.B.hXAXAX` # # # # # # # # # ; % t l h u / [.1X1X1X1X1X1X<X<X1X>X>X4X4X<X1X4X<X<X3X3X3X3X3X>X<X<X,X,X<X<X5X5X",
+"d r s t % # 7 qXyXgX9Xc.aXr.@...B B  ... .B B B B B S B N 4 3 X X o o o . . # - # # # & = X xXHXD F S.V.w.w.;.<.;.=.$.&.F F F =.=.*.*.;.0.;.;.q.e.e.pXAXZXGXn # # # # # # . # # > , i t t y h h ^ T.+X+X+X1X1X<X4X1X4X4X4X>X>X>X<X<X3X3X3X3X3X2X<X<X,X,X<X<X5X5X",
+"d r 0 t ; , 7 qXxXgXqX9XgXaX8... . .....S B N 8 8 8 4 3 3 3 . . # # $ ; $ ; ; # # . . & = o tXHXhXV e.V.a.q.<.w.0.6.*.*.&.$.*.8.;.;.;.8.0.;.;.w.b.r.mXHXGXFX= > # # # # # # # # & # # i d i r t h w h {.eXNX1X1X,X,X1X1X1X<X>X4X<X<X3X3X3X3X3X3X<X>X,X,X<X<X5X5X",
+"r r y t ; 2 7 9XqXxXqXqXxXcXaXO.S S B N N 4 3 X @ X o o o & % % $ $ $ % % # - . . . o > & o  XFXHXt.&.f.a.,.w.<.q.0.=.&.*.*.=.8.;.:.;.0.q.;.;.e.0.pXAXZXPXVXo & # # # # # # # # & & < < , * , a i d y y l / T.+XNX1X1X1X,X,X1X4X<X<X3X3X3X2X2X2X>X>X>X-X5X<X5X5X",
+"r s y 0 # o 9 gXgXxXqXqXxXbXcX7.N 8 4 3 X @ . + - . . . . . # # . # > > > + + + . . . & # # | CXHXZXF 0.s.,.<.w.w.;.=.&.=.*.;.8.;.:.;.w.q.;.0.r.r.ZXAXGXGX} = o # # # # # # # # & & & < < < , < , i i i t y h h ^ _ ].+X1XNX1X,X1X<X<X<X3X3X2X>X2X>X-X-X5X5X5X5X",
+"s q q 0 , o 9 9XgXgXxXyXxXCXgXD 3 o o @ + + + . - . # - > # , . > . . . @ . . . . . . # # , | IXHXHXt.F e.a.,.<.w.;.=.&.=.%.;.8.;.;.;.q.;.=.=.-.hXAXHXGXGX` o & . # # . . . # # & < < * , < < > < < , , i d s y h l h h ! [ @XNX1X1X1X1X<X<X>X-X3X2X>X-X5X-X5X-X",
+"j q s 0 * o 9 9XgXxXxXyXtX X7 o o o . + . . . . & # # - - - - + + . . . o o . . > . # . # # ` IXFXLXZXF =.e.p.<.w.q.=.*.*.o.;.;.;.=.,.q.;.*.F c.ZXJXHXGXFX< & . . . # . . # # # # # * , i i , , < < < p i i i i s d l l y q l ! T.NX1X,X,X1X*X<X>X>X2X2X-X-X5X5X",
+"y y r r = o 5 9XqXbXwX7 2 2 . 2 & & & > # # & o & & # + + . . . . . . . o & & & # # , > - # n GXFXHXJXmX&.r.w.p.w.e.=.$.=.C $.$.$.=.%.w.;.C 9.ZXHXHXLXGX7X& $ # . . # . . . # # * , , , i i i i < < < < < p p p a i i d d s s j h ! T.NX1X,X,X*X<X>X2X2X-X-X5X5X",
+"0 s r r p & @ qXbXyX7 2 o & > & & = & & & # & # . . . . o o o o . . . # # & * * * * * , # & z FXPXHXLXAXZX6.a.s.e.e.6.*.=.C $.*.$.O.0.0.$.7.AXHXKXPXPXGXD . $ # . . . # # # # # * ; ; ; i i i i , < p p < < < < z < < p a p i r y h L _ @XeX1X,X<X<X3X>X-X-X-X-X",
+"i i $ r * & o wXxX` o < . # # # = = & & & & # - . . . . o o o o # # # # $ $ $ * * * * & . & 2 tXFXLXPXLXJXcX6.g.A.e.r.0.%.C *.&.$.&.e.0.H SXHXKXKXLXPXCX2 . # # & # # # . # # - # $ ; ; i t i i i i i i < < < < 7 < < < < < < p d s y h h ^ [.1X:X5X5X5X-X-X-X-X",
+"p = * * * & o 0XyXo 7 . $ 1 # > & & & & & > - - . . . . o o o o # # # $ $ $ $ $ $ # * * & & & ` FXGXKXKXLXJXpX6.B.B.b.e.=.$.r.&.&.y.r.H SXLXLXKXKXKXLX X& & & & > # # # # - - - # - ; i i i i i i i i i , , < < < < < < < < p a a x i t y h / NX:X5X5X5X-X-X-X-X",
+"v = * i # & = 0X' o . 1 , . & > - - & & & > & - . . . . . . . . # # # # # # # # # # & & , & < < xXFXPXKXKXLXJXc.r.B.A.B.e.0.y.0.r.y.7.AXLXLXKXKXKXKXPXn , > & > > > # # - - > > > , , i i i i i i i i i i , p < p , < , p i , , & & z i t y u [.:X<X5X5X5X-X-X-X",
+"{ 7 & , # # = 8Xv o & . - > > . + - & & & & & & # # # # . . . . . o o . . . . + + + + . - # p * t.GXPXKXKXKXJXJXx.e.B.B.x.e.y.e.e.c.AXLXLXKXKXKXKXKXtX# , > > > , ; # # - > > > > > > , , , i i i i i i i i i p i i , i i i t $ 7 o 7 > $ s u _ :X5X5X5X5X-X-X-X",
+"yXD & > # # o } o X > > - # o @ + + o o & & & & . # # # # # # . o o o o . . . . + . . . - # , p ` GXGXKXKXLXLXJXAXx.Z.fXMXnXcXcXcX9XAXKXKXKXKXKXKXLX| , , # < & , ; # - - > > > > > > > , , , i i i i i i i i i , i i i * t i i = 2 & > a % y K :X5X5X5X-X-X-X-X",
+"xX8X3 o o o 2 n o o > > > > & & > - # & o . & # . . . # # # # . # o & o . . . . . . # # # & , , m IXGXLXKXKXKXKXLXJXHXAXAXZXxXwXD 5 D FXKXKXKXKXLXCX, , 1 > . > > > > > > > , , , , , , , , , , i i i i i i , , , , , , , , , , # > , , > - $ q @X:X5X3X-X>X*X>X",
+"xXqXG X o o = z & & o > > & & # & # # . # # # # . . # # # # # . . # # - # # # # # # # # # # & & < tXPXPXLXKXKXKXKX8X` ` n v z < < < & m CXKXKXKXKX} , - > > > > > > > > , , , , , , , i , , , , i i i i i i , , i i i i , , * $ $ ; , , > & # 0 {.:X3X-X>X,X*X<X",
+"gXgXt.D X 3 7 & & & o & & & # # & > # # # . . . - - - # # # . . . . # # # # # # # # # # # # # & < } FXPXKXLXKXLX} < . a > & < > & > z > m IXKXLXGXb 1 , > < > > , , , , , , , , , , i i i i , , p i p p p p i i p p i , , * $ $ $ , , , & & - t ! 1X3X*X>X*X>X>X",
+"gXgXgXt.3 7 7 & & & o & & & # # # - # # # # # . > > > # . . . # . . # # # # # # . # # # # # # & > ` FXKXKXKXLX{ > & 1 1 < a < & 1 o . . a n GXKX8X< , 1 > < > > , , , , , , , , p p p p i , , , i i i p p p i i i i , , * * * $ $ , * * & & - t h +X*X<X*X*X3X-X",
+"hX9XhX9Xv 3 o o o o o & & & & & # # # # # # . . > > # # . . . . . . - - # # # # . # # # # # # & , b CXPXLXKX| # & , , . > , > 1 > 2 < < > & ` GXn , > , > > < > , , , , , , , , a a p p p , , , , i i i i i i i i i , , , , * $ , * * * & # # $ q {.+X<X*X>X3X-X",
+"hXpXgX0X' 7 X o o o o & & & & & # # # - > # # . > > # # # # . . . # - # # # . . # # # # # # # # & a R.PXKX| , , , # & & & > & > & & & & . z # ` 1 # 1 > > > 1 > < < , , , , , , p p p p p i , , , i i i i i i i i i i i , , , * * * * * & # # $ q ! 1X:X,X<X-X3X",
+"fXpXpXc.t.5 o o o o & # # # & & # . > > > > . . # . . . - # # . . . # # # # # # # # # # # # # & # a ` PX} , # # & . > > . > > # > 2 < & a . , 1 a > z , > , < > , , , , , , , , p p p p i , , , i i i i i i i p i i i , i , , * $ $ * * & # # $ t u [.+X,X<X-X3X",
+"hXpXpX9Xt.3 7 . o . # # # # # # # # - > > > . . . . . . - - # . . . # . # # # # . # # # # # > , , # z | & , > . # # > # . # . > & & < > # a , 1 , , , , & 1 > > , , , , , , , , p p p p i , , , , , , , , , , i , * , * , , , , $ $ * & & # # # % u _ +X,X-X3X3X",
+"fXpXpX9Xt.9 X o o . . # # # & > # . . . . # # - > # . # # # . . . . . . # # # # # # # # # # # > , , a # - 1 . > 1 > > > < . > m 7 z m , , , , < , , , , , , , > , , , , , , i p p i , i p p , , , , , * * , , i , , , , , , , * $ $ $ # & & & - ; u P +X1X5X3X2X",
+"fXpXpX9Xt.5 X o o . # # # # # # # - . . # # > > # . . # # # # . . . . . # # # # # # # # # # # & , , 1 > # # . > # # # 8XtXCXCXCXCXCXiX7Xa > , > , , , , , , , > , > > > , , , , , , , i p p < , , , , * * , , i i , , , , , * * $ $ $ # # # # # # % y [.:X<X3X3X",
+"fXdXpX9Xt.3 X o o # # - # # # . # - - - # > > > - # . . . # # # # # . . # # # # # # # # # # # # # ; , , & , 1 & 1 , | CXPXKXKXKXKXKXPXIX| 1 > # > > > , , , , > , , > > & > , , , , , p p p , , , , , * * , , , i , , , * * * $ , , ; - # # # # # % % [ +X1X3X3X",
+"fXdXpX9Xt.3 o o o # # # # # # . - - - - # > > > # . . . . # - # # # # # # # # # # & # # # # # # # ; ; , > , 1 # > 1 uXIXKXKXLXKXKXKXPXIX} 1 # , > > > , , , > > , , > > , , , , , , , p p i , , , , , * * * , , , , , * * * * $ , # # # # # # # # # % ^ :X1X2X3X",
+"fXdX9X9Xt.X o o o # . . # # # # . . . # # # # # - # . . . # # # # - - - # # # # # # # # # # # # , # # , , > < a < { CXLXKXKXKXKXKXKXPXGX( > , ; , , , , , , , < , , , , , , , , , i p p i , & # , , , * $ $ * , , , * * * * * $ # # # # # $ $ # o . $ P NX1X3X2X",
+"fXdXpX9X' X o o # # . . # # # & . . # # # # # # > > # . . # # # - - # - # # # # # # # # # # # # # ; , , a 1 > > n tXFXKXKXKXKXKXKXPXGXtX, , a # , , , , , , , < , , , , , , , , p p p i , * # # , , * * $ $ * , , * * * * * * # # # . # # $ * # o . ; u +X1X3X2X",
+"fXpXpX9XG X o o # # # # # # # # . . . . - # # # > > - . # . . . . . # # # # # # # # # # # # # # # , , # , , & m 7XCXLXKXKXKXKXKXKXPXCX` , , 1 , , , 1 1 , , , , , < , , , , i i p p i , * $ & & , , , , * $ * , , , * * * * $ # # # . . # $ * & o . # w [.1X<X3X",
+"fXpXpX9XD o o & # # # # # # # # . . # @ > @ - . > > - # # . . . . . # # # # # # # # # # # # # & , # , a a # m 7XCXGXKXKXLXKXKXKXPXCXuX< 1 a , i 1 1 1 1 , > > , 1 1 1 < 1 , p a p p < , $ # & * , , , , , ; , , , , , * & & # # # # . # # $ $ # & & # y {.1X<X3X",
+"Z.pXpX9XD @ & . > & # . . # # # . . > . 1 @ . @ > . . > . . . . . 2 & . # # > . > > & # # # # & , # a , a , 7XCXGXKXLXKXKXKXKXLXCXVX( z a 1 , i a 1 , , > > > > 1 - 1 , , 1 , , , & = o , # * = < & , $ , , ; , , - ; & & & # # $ # & # # # $ $ ; # $ t [ NX4X3X",
+"aXpXpX9X9 X & # & & & o . . # # > . . 1 . . 1 . @ @ o 2 . o > > . . . & , < . 1 & & & # # # # # # , , , i M R.CXFXKXKXKXKXKXPXIXrX} z < < a , 1 1 1 , < , > > > < > < a 1 , a < < = = = . & = 6 7 & a # - % ; , , # # # & & & - # # # & # # $ $ $ $ $ 0 _ NX4X3X",
+"fXZ.9X9X5 X & # # # & o . . # # . o 8X8X8X} } | ` ` n m 2 > o . 2 & > & . < . # # & # # # # # # # 1 # , , a ` iXIXPXLXKXKXLXCX7X} n , , , a , , < < < < < > > , , a < < , , < = 6 6 6 c 6 c 6 6 6 6 , ; t : & & = * & & & & . # # # # & # # $ $ $ ; * 0 ^ NX4X4X",
+"fXZ.9X9XX o & # # . o o # . # # 7 . 8XxXKXKXLX7X7X7XrXuXiXxXtXrX8X X{ ` & . 1 > # & # # # # # # # , # , , , a 7XVXHXKXLXLXFXrX{ ` i i a i a i , i < p < < , , , * x p p p < 1 ` D ) ) ) ) ) ) ) ) u.2 + + ; o = & & o > * # # - # # # o # # $ $ $ ; * 0 ! NX3X4X",
+"dXZ.9Xz.X o & # . # o o & # # # . z 8XCXLXKXCXt.8X7X7XrXtXiXxXxXiXiXtXtX{ > . . & & > # # # # # & # , a i i , | iXFXLXHXZX7X} } n t i i a $ i p i p p p p , , , d r * < z & o 8X5.5.5.5.5.5.5.5.5.vX7 + ; , = = 2 > @ > $ % . . # # # & # # $ $ # ; # $ l +X<X3X",
+"pXpXpXt.X o o # # . o o . # # # . v tXxXIXFXCXrX8XtXuXiXiXxXiXxXiXuXtXuX7X` > & & & & & # # - > , # , , i a , m uXVXZXFXtX X8X8Xi t i i a * p p p p p i i 1 , , ; i x = < < 6 0X5.5.5.5.5.5.5.5.5.vXv @ = = 8 3 3 3 X 2 , % # . # # # & & & ; ; ; - , $ h [.1X4X",
+"pXpXpX' o o . # & & o o . . # # < D yXCXCXVXFX7X8XuXVXCXCXCXVXCXCXVXxXiXVX7X` . & & & & # & > > , , , , , i a & 8XCXFXxX8XrXVX` , i p , p p p p i a i i , 1 , , 1 > 6 7 { rXu.u.u.) .Xu.u.u.XXu..X7X' t.u.7.O.@.O.7.9.] ( r o o # # & & > > ; ; ; , < , y {.1X4X",
+"pXpX9XD o o . & > o o o . . # # & `  XuXFXFX7Xt.8XrXrXrXtXuXuXiXiXuXyXtXuXtX7Xz & & & & # # > > # , # a i * a < ` VXxXrX8X8X7X= < * < * * p , , i a i 1 , , , > @ 5 A ' yXPXvXu..X} uX X.Xu.vX{ BX} ] cXXXh.+.j.+.h.pX9X' = o = & - & > > > ; ; - # , $ y [ 1X4X",
+"dX9X9X9 o > # # . . o o . . # # & n { } } }  X7X7X7X7XrXtXtXuXuXtXtXtXtXrXrX7Xz # & # & # # # # > , ; ; , , , < & uXyX} ` 8Xv & < * * * * , , , i , , , < < < 7 4 V O.u.vXPXvXu..X{ VX X7Xt.vX} BXR.9.aXg.h.j.#.#.h.g.pX' z & > & > > > > $ ; ; ; > , $ y / 1X4X",
+"dXpX9X9 @ > . # # . o o o o & > . & & # . . < z m n n ` ` { } } 8X7X8X7X7X7X7Xz # # # # # # # # > > , , , * , * < ' 8X` D { & = , , , , , , , , ; ; , < = 6 6 8 Z *.8.8.5.h.5.u. XrX8X X X7Xu.t.8X} ' 8.5.j.#.#.#.#.+.r.A & . > # > > > , ; ; ; ; > > , y ^ NXNX",
+"pXpXz.5 @ > . - . . o o o . # # # # . # & & # # & & & # . . # & & & 2 z m n n & # . # # # # # > > & # # $ * * & = 7 ` D ( c & & # - - - , , 1 1 1 1 , 2 6 c A F 0.G.G.D.+.j.5.XXrXVX` 7XiXGX( { uXrXu.5.j.#.#.#.#.#.+.h.c * # > # & > > , , ; ; ; - > i t h NX4X",
+"pXpXt.X @ > . > . . . o . . # # . . . # # - # # # # # # # # # & & . o & . . # & # # . # # # # & > & # # $ $ # & & & 7 ( D . < & # - - - - ; 1 1 1 1 , = 6 c D F e.K.A.B.+.+.5.u.rXVX| 7XrXCX' t.uX.Xu.5.j.+.+.+.+.+.+.y.v ; . . # , > > , ; ; ; ; > > i t u NX4X",
+"pX9X] X o & . # # . o o o . # # - > > . . . . # . . # # # # # # o o 2 . # < & . # # # # # # # # & & # # # # # # & & > m < > # , - - - - - - , , 1 , > 2 7 c A A F H F D A A A A ( ( a M b ` c v n m c 4 N N 4 4 N 4 N N O . - , ; , > & & $ ; ; ; , , , t u NX1X",
+"pX9X' X o & . . . . o o o o . # # + - > > > > # # > > > > > > & > & < . . & . # # # # # # # # # & & & # # # # - > & > & . < # - - - - - > , < 1 , ; - > < 7 6 6 6 7 o 7 6 6 7 z z < i a z < , 1 < < 6 c o 2 @ @ 7 3 3 X = . - - ; , * & * $ ; ; ; , , * t u @X1X",
+"pX9XD X o . . . . . . . . . . . > . . . . . # & # & # # . . . . . . > & , . . > # # # # # # # # & # # # # - - , & , > > # - , # - - , * < < p < , ; ; - , > < < p < z z a < = 7 z z a , p x d - , < < z < , , p = < z = = o . # , * * * * $ ; ; ; - , # t u {.NX",
+"pXc.D X o . # # . . o o o o # & # . @ > - > & & & & & & & & & & > . > . > # , # # # # . # # # # & . # # # ; ; , , . # > . - , , , , , < z 6 = * # ; : : : , 1 1 i i p p ; a 7 7 < < < z z = i i , 1 < & , p i r r r * * o & & > $ * , , * , ; ; ; # , # i q _ NX"
+};
diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index b604f07f5a2..7b04293018f 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -17,7 +17,12 @@ def test_sanity() -> None:
         assert im.format == "XPM"
 
         # large error due to quantization->44 colors.
-        assert_image_similar(im.convert("RGB"), hopper("RGB"), 23)
+        assert_image_similar(im.convert("RGB"), hopper(), 23)
+
+
+def test_read_bpp2() -> None:
+    with Image.open("Tests/images/hopper_bpp2.xpm") as im:
+        assert_image_similar(im.convert("RGB"), hopper(), 11)
 
 
 def test_invalid_file() -> None:
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index 304f5836170..fcee142e3c2 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -56,7 +56,7 @@ def _open(self) -> None:
         palette_length = int(m.group(3))
         bpp = int(m.group(4))
 
-        if palette_length > 256 or bpp != 1:
+        if palette_length > 256:
             msg = "cannot read this XPM file"
             raise ValueError(msg)
 
@@ -68,8 +68,8 @@ def _open(self) -> None:
         for _ in range(palette_length):
             s = self.fp.readline().rstrip()
 
-            c = s[1]
-            s = s[2:-2].split()
+            c = s[1 : bpp + 1]
+            s = s[bpp + 1 : -2].split()
 
             for i in range(0, len(s), 2):
                 if s[i] == b"c":
@@ -98,7 +98,9 @@ def _open(self) -> None:
 
         palette_keys = tuple(palette.keys())
         self.tile = [
-            ImageFile._Tile("xpm", (0, 0) + self.size, self.fp.tell(), (palette_keys,))
+            ImageFile._Tile(
+                "xpm", (0, 0) + self.size, self.fp.tell(), (bpp, palette_keys)
+            )
         ]
 
     def load_read(self, read_bytes: int) -> bytes:
@@ -120,12 +122,13 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
         self.fd.readline()  # Read '/* pixels */'
 
         data = bytearray()
-        palette_keys = self.args[0]
+        bpp, palette_keys = self.args
         dest_length = self.state.xsize * self.state.ysize
         while len(data) < dest_length:
             s = self.fd.readline().rstrip()[1:]
             s = s[: -1 if s.endswith(b'"') else -2]
-            for key in s:
+            for i in range(0, len(s), bpp):
+                key = s[i : i + bpp]
                 data += o8(palette_keys.index(key))
         self.set_as_raw(bytes(data))
         return -1, 0

From 395bd6bd12138ec5b6b97ff172758446895cc9c6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 18:56:15 +1000
Subject: [PATCH 1626/2374] Allow more than 256 colours

---
 Tests/images/hopper_rgb.xpm          | 11174 +++++++++++++++++++++++++
 Tests/test_file_xpm.py               |     8 +-
 docs/handbook/image-file-formats.rst |     3 +-
 src/PIL/XpmImagePlugin.py            |    41 +-
 4 files changed, 11207 insertions(+), 19 deletions(-)
 create mode 100644 Tests/images/hopper_rgb.xpm

diff --git a/Tests/images/hopper_rgb.xpm b/Tests/images/hopper_rgb.xpm
new file mode 100644
index 00000000000..063833b3a35
--- /dev/null
+++ b/Tests/images/hopper_rgb.xpm
@@ -0,0 +1,11174 @@
+/* XPM */
+static char *dummy[]={
+"128 128 11043 3",
+".F0 c #000000",
+".Jj c #000001",
+"#94 c #000002",
+".F5 c #000003",
+"ax0 c #000004",
+".Gy c #000005",
+".HF c #000006",
+".Mc c #000007",
+"#G5 c #000008",
+".F2 c #00000b",
+".HC c #00000d",
+".Dj c #000010",
+"#g# c #000012",
+".7l c #00001d",
+"#aa c #00001e",
+".qa c #000028",
+".LB c #00002d",
+".KU c #000100",
+"aPY c #000102",
+".KG c #000103",
+".KV c #000104",
+".KW c #000106",
+"abf c #000107",
+"acJ c #000108",
+".EX c #00010e",
+"#ve c #000114",
+"#D2 c #000121",
+".LC c #000127",
+".Hv c #000200",
+".Jo c #000201",
+"aD6 c #000204",
+"abc c #000205",
+".SU c #000206",
+".QD c #00020b",
+"axP c #00020e",
+".Hp c #000210",
+"#7j c #000214",
+"#Fs c #00021e",
+"#eC c #000220",
+"a.O c #000223",
+".4f c #00022e",
+".2z c #000230",
+".Jn c #000300",
+".Ky c #000304",
+".Jk c #000305",
+".Rr c #000307",
+".IN c #000308",
+"a#G c #00030a",
+"aua c #000313",
+".BL c #000314",
+"#hQ c #000321",
+".N5 c #000332",
+".Kz c #000405",
+".KX c #000407",
+"aIk c #000408",
+".KS c #00040a",
+"aP7 c #00040c",
+"#92 c #00040d",
+"aCO c #00040f",
+".Di c #000412",
+"avW c #000417",
+"#hF c #00041b",
+"#kY c #000421",
+"#mm c #000422",
+".4e c #000436",
+".T5 c #000437",
+"ab# c #000507",
+"aJL c #000508",
+".KR c #00050a",
+"az2 c #00050b",
+"az4 c #00050f",
+"#tr c #000512",
+"#nM c #000522",
+"aN2 c #000609",
+"#uZ c #000616",
+"#3T c #000617",
+"atm c #00061f",
+"#A5 c #00062b",
+"#hW c #00062d",
+"a#D c #000701",
+"aPD c #000709",
+".Jl c #00070a",
+".IX c #00070f",
+"#2x c #000715",
+"#tb c #000716",
+"#Fx c #000717",
+"avo c #00071d",
+".BN c #00071f",
+"axg c #000720",
+"#86 c #000722",
+"#On c #000728",
+"#Cy c #000729",
+"arw c #000730",
+"abe c #000809",
+"#2w c #00080c",
+".Jm c #00080d",
+"#5D c #000818",
+".A# c #00081d",
+"axQ c #000820",
+".IW c #00090f",
+".IY c #000911",
+"#ts c #00091b",
+"asO c #000927",
+"asc c #00092b",
+"az3 c #000a11",
+"awR c #000a25",
+"asN c #000a26",
+"#Rr c #000a2b",
+"aOL c #000a2c",
+"acE c #000b00",
+"#tt c #000b1c",
+"akR c #000b24",
+"akS c #000b27",
+"#87 c #000b29",
+"aPH c #000b2d",
+"aM1 c #000c2e",
+"#D4 c #000c2f",
+"#Cx c #000c30",
+"atn c #000d28",
+"aCB c #000e0a",
+".Sa c #000f33",
+"#7m c #000f35",
+"#tq c #001020",
+".TG c #001032",
+"aiF c #001034",
+"adG c #001232",
+".QE c #001439",
+".Vi c #00143a",
+"#2y c #001c36",
+"aAn c #010000",
+".H0 c #010001",
+"azp c #010002",
+"adp c #010003",
+".I. c #010008",
+"#k3 c #010018",
+".2A c #010020",
+".lR c #010037",
+".l2 c #01003f",
+".IZ c #010107",
+"awn c #01010a",
+"#wx c #010124",
+".DB c #01012f",
+"acM c #010202",
+"asx c #010204",
+".Uv c #01020b",
+"#x4 c #01020d",
+".FX c #010301",
+"as7 c #010304",
+"aQD c #01030a",
+"#7h c #010311",
+"Qta c #010332",
+"aK0 c #010405",
+".Kq c #010406",
+".Kk c #010409",
+".Mh c #01040b",
+".Mi c #010410",
+"#5C c #010414",
+"#K. c #010420",
+".SH c #010424",
+".ht c #010428",
+".fZ c #010429",
+"aPV c #010507",
+".Kr c #010509",
+"#8n c #01050e",
+"ayT c #010513",
+"#kL c #010518",
+"#jl c #01051a",
+"#p# c #010523",
+".IU c #010609",
+"#7i c #010615",
+"#mc c #010616",
+"awo c #010618",
+".Xt c #010622",
+"#qx c #010623",
+"#rX c #010624",
+"aM. c #01070a",
+"#rP c #010714",
+"#qo c #010715",
+"#VG c #010718",
+"akQ c #01071d",
+"ab6 c #010720",
+"aIb c #010723",
+".qc c #010731",
+"#Rs c #010823",
+"aGQ c #010824",
+".IV c #01090d",
+"#7k c #01091f",
+"#Rp c #010929",
+"acF c #010b10",
+"#vc c #010d1c",
+"#5F c #010d25",
+".Go c #020000",
+"agL c #020002",
+"aai c #020003",
+"aj6 c #020004",
+"#Ls c #02000a",
+"#7R c #020015",
+"#eW c #020022",
+".oS c #020032",
+"#95 c #020102",
+"aup c #020109",
+"#x3 c #020113",
+"#Fr c #020124",
+".Oh c #02012f",
+".oR c #020132",
+".Ei c #020200",
+".Kn c #020203",
+".QC c #020207",
+".I5 c #020209",
+"ay4 c #020210",
+"#PV c #020218",
+"acm c #02021b",
+"#M3 c #020225",
+"#hT c #02022d",
+"a#J c #020303",
+"asA c #020304",
+".KB c #020305",
+"aL3 c #020306",
+"aeQ c #020307",
+"abg c #020309",
+".Gz c #02030a",
+"#3i c #02030c",
+"avV c #02030e",
+"#c5 c #020317",
+".#Y c #020332",
+"as4 c #020404",
+"#93 c #020406",
+".Jp c #020408",
+"aMj c #02040b",
+"#8m c #02040d",
+"#ZI c #02040f",
+".Ju c #020412",
+"#wL c #020413",
+"#Cs c #02041b",
+"#Ly c #020420",
+".Re c #020425",
+".PJ c #02042a",
+".5O c #020430",
+"#2v c #020506",
+".Kx c #020507",
+".KQ c #020509",
+".Jq c #02050a",
+".SI c #020523",
+".Lw c #020525",
+"#nR c #020528",
+".ew c #020529",
+".bq c #02052a",
+".Ip c #020534",
+".Jr c #020608",
+"a#H c #02060c",
+"axf c #020613",
+".Y2 c #020616",
+"#o2 c #020617",
+"#nB c #02061a",
+"#SS c #020626",
+"a#C c #020703",
+".SV c #02070c",
+"aD7 c #020710",
+"#nC c #020713",
+"#He c #020716",
+"#jx c #020733",
+"#o3 c #020810",
+"ayR c #020818",
+"a.M c #020820",
+"#Ro c #020822",
+"#hU c #020835",
+"aP8 c #02090f",
+"adF c #020924",
+"#to c #020926",
+"#SR c #02092b",
+"ahw c #020a2a",
+".eJ c #020a4b",
+".iX c #020a4c",
+"#vb c #020b20",
+"#Rq c #020b2f",
+"#D5 c #020c2d",
+"#A4 c #020c32",
+"ajL c #020d2a",
+".Gq c #030000",
+"azg c #030001",
+".HO c #030002",
+".H2 c #030003",
+".I6 c #030005",
+"ayY c #030006",
+".F1 c #030010",
+".HB c #030013",
+".SM c #030037",
+"aJP c #030103",
+"abb c #030105",
+"ami c #030108",
+"axq c #030109",
+"aAF c #03010b",
+"az6 c #03010e",
+"ay5 c #030111",
+".nt c #03013b",
+".QB c #030202",
+"a#K c #030203",
+"arQ c #030204",
+"asF c #030205",
+"aj7 c #030207",
+"awP c #030208",
+"avC c #03020a",
+"#wN c #030214",
+"#wu c #03021d",
+"#c4 c #030221",
+"#Lx c #030225",
+".km c #030244",
+".KF c #030305",
+"aN9 c #030306",
+"#8p c #030307",
+"aeP c #030308",
+".I3 c #030309",
+".I4 c #03030a",
+"#1l c #030312",
+".FR c #030316",
+"#P1 c #030326",
+"#A2 c #030327",
+".LS c #030400",
+".FY c #030402",
+"acL c #030404",
+".KD c #030406",
+"a.E c #030408",
+"ahj c #030409",
+".2e c #03040a",
+"#43 c #03040c",
+"#Yg c #03040f",
+"aAb c #030412",
+".bn c #030433",
+"a#I c #030504",
+"aOV c #030508",
+"a#F c #03050d",
+"avn c #030512",
+"ae2 c #03051e",
+".Lx c #030523",
+".J9 c #030526",
+".IA c #03052b",
+".MH c #03052c",
+".Sy c #030535",
+".GY c #030539",
+"aOY c #030608",
+".Oo c #03060a",
+".M2 c #03060b",
+"#mb c #03061e",
+"#kK c #030621",
+"#jk c #030623",
+"#hE c #030625",
+".#1 c #03062a",
+"Qte c #03062b",
+".Lj c #03062c",
+"aPW c #030709",
+"aCJ c #03070a",
+".PV c #03070c",
+"aNh c #03070d",
+"#1. c #03070e",
+"aL4 c #03070f",
+"aAa c #030714",
+"am7 c #030718",
+"#eD c #030719",
+"#Oz c #03071d",
+".Im c #03072d",
+".Lk c #030731",
+".5N c #030738",
+".Op c #03080d",
+"#SO c #03081c",
+"aa9 c #030900",
+"#qp c #03090e",
+"#91 c #030912",
+"#85 c #03091f",
+"ajK c #030922",
+".hE c #03093b",
+"acD c #030a00",
+"#rQ c #030a0d",
+"aiD c #030a27",
+"aav c #030b28",
+"#jy c #030b36",
+"aPw c #030c0e",
+"ayP c #030c16",
+"alW c #030d23",
+"aiE c #030f30",
+"#tp c #031026",
+"aBf c #031114",
+"#vd c #03111d",
+"adI c #031539",
+".xN c #040000",
+".ET c #040001",
+".KH c #040002",
+".Oq c #040003",
+".HU c #040004",
+".Wj c #040005",
+".HJ c #040007",
+".HI c #040008",
+"ayJ c #04000f",
+"#MX c #040014",
+".vH c #04001e",
+"#jw c #040027",
+"#IE c #040028",
+".Gu c #040101",
+".HP c #040102",
+"aAD c #040105",
+"aei c #040108",
+"acn c #040111",
+".Me c #040201",
+".Ji c #040202",
+".FD c #040203",
+"aJN c #040204",
+".F8 c #040205",
+"ax9 c #040206",
+"avU c #040208",
+"ai3 c #040209",
+"#8l c #04020a",
+"avm c #04020b",
+"aAE c #04020c",
+"axM c #04020f",
+".5K c #040212",
+".0O c #040225",
+".LM c #040304",
+"arR c #040305",
+"#8q c #040306",
+".H7 c #040307",
+"aqZ c #040308",
+"av5 c #04030b",
+"#Ub c #040312",
+".Hq c #040314",
+"aFs c #040315",
+"aaQ c #04031d",
+"#Ox c #040326",
+".Q7 c #04032a",
+".Px c #04032b",
+".nw c #04033c",
+".LR c #040400",
+"acN c #040402",
+"ann c #040405",
+"anm c #040406",
+".KP c #040407",
+"aq0 c #040408",
+"aBp c #040409",
+".Mb c #04040a",
+".EV c #04040b",
+"aCM c #04040c",
+"auN c #04040d",
+"aCN c #04040e",
+"#Rl c #04040f",
+"#SM c #040413",
+"aD8 c #040416",
+".N2 c #04042b",
+".DI c #040432",
+".hH c #040447",
+".KT c #040500",
+"abk c #040505",
+".KE c #040507",
+"#3S c #040509",
+"aBq c #04050a",
+"aA# c #04050b",
+"atl c #04050c",
+"aeR c #04050d",
+"#9Z c #04050f",
+".Ea c #04051c",
+"#tn c #04052a",
+".cY c #040534",
+".MT c #040535",
+".df c #040547",
+"abl c #040604",
+"abj c #040607",
+"aJK c #040608",
+"aOX c #040609",
+".Vh c #04060b",
+"aI. c #04060d",
+"#81 c #04060f",
+"alS c #040618",
+".MP c #040624",
+".IB c #040627",
+".Lv c #04062c",
+".Ht c #040704",
+".Hz c #040705",
+".IT c #040709",
+"aCK c #04070c",
+".NA c #040712",
+"#wv c #040717",
+"aQE c #04071d",
+"#Ha c #040722",
+".Sx c #040732",
+".Kw c #040809",
+".IO c #04080d",
+"aO# c #04080e",
+"awQ c #040817",
+".FQ c #040818",
+"aiC c #040822",
+".Q8 c #040833",
+".2y c #04083c",
+"abd c #04090b",
+"aBo c #04090d",
+"aKS c #040911",
+".VT c #040933",
+".g. c #04093b",
+"ayy c #040a0a",
+".Ks c #040a0e",
+"aFt c #040a27",
+".eG c #040a3c",
+"ab. c #040b0d",
+"aBh c #040b10",
+"#IK c #040b21",
+"aOd c #040c12",
+"ab7 c #040c27",
+".gb c #040c4e",
+"ahx c #040d2f",
+"aqL c #040e3e",
+"aCC c #04100d",
+"#88 c #041032",
+"ajM c #041434",
+"adH c #041738",
+".EP c #050000",
+"#2O c #050001",
+".KI c #050002",
+"aDl c #050004",
+"#pf c #050009",
+"#6e c #05000b",
+"#yc c #050020",
+".87 c #050024",
+"amJ c #050106",
+"al9 c #050107",
+"#zt c #05010f",
+"aaR c #050112",
+".Ay c #050123",
+"#u7 c #05013e",
+"ail c #050206",
+".J# c #050207",
+"afv c #050209",
+"#ZG c #05020a",
+"#09 c #05020b",
+"axN c #050211",
+"#2L c #050221",
+".Sw c #05022a",
+"aN3 c #050304",
+".Gw c #050305",
+".Mf c #050307",
+"ale c #050309",
+"awI c #05030a",
+"av6 c #05030b",
+".3X c #05030c",
+"awN c #05030e",
+"a#E c #05030f",
+"axd c #050310",
+"aAc c #050313",
+".5J c #050318",
+"#qz c #05031d",
+".2s c #050323",
+".0V c #050326",
+".Ed c #050403",
+"alc c #050404",
+"anl c #050406",
+"arf c #050407",
+"#6I c #050408",
+"#44 c #050409",
+".HH c #05040a",
+".H9 c #05040b",
+".I# c #05040c",
+"awl c #05040d",
+"awM c #05040e",
+"#W8 c #05040f",
+"aDB c #050411",
+"#Rk c #050413",
+"#Z0 c #050418",
+".uj c #05041d",
+"aaO c #05041f",
+".4g c #050422",
+".rw c #050426",
+"#zz c #05042d",
+"#u2 c #050430",
+".kn c #050446",
+".Ej c #050503",
+"aee c #050504",
+".O8 c #050506",
+".KC c #050507",
+"apj c #050508",
+"apk c #050509",
+"ajw c #05050a",
+"aFp c #05050b",
+".I2 c #05050c",
+"#Rm c #05050d",
+"#SN c #05050e",
+"#YA c #05050f",
+"#Z1 c #050510",
+"aGP c #050515",
+"#ST c #05051f",
+".Fn c #050538",
+"Qtx c #050548",
+"asB c #050607",
+"ay0 c #050609",
+"ahi c #05060a",
+"ay1 c #05060b",
+"aqK c #05060c",
+"asa c #05060e",
+"#hX c #050624",
+"#x6 c #050626",
+"#Cv c #050628",
+"#o4 c #05062d",
+"#rR c #05062e",
+"#eL c #05062f",
+".Rg c #05063e",
+".FV c #050705",
+".IR c #050706",
+"as6 c #050708",
+"aOT c #050709",
+"ayZ c #05070b",
+"aGO c #05070e",
+"aeS c #05070f",
+"#zu c #05071f",
+"#IG c #050723",
+".K. c #050725",
+".2v c #05072c",
+".at c #050730",
+".et c #050736",
+".iR c #05073f",
+"aA. c #05080c",
+"aMk c #05080e",
+"aJy c #050814",
+"aJz c #050815",
+"aPG c #05081e",
+"ab5 c #050820",
+".PK c #050826",
+"#ms c #050827",
+"aNi c #05090f",
+"aFq c #050911",
+"#90 c #050912",
+"#Rt c #05091b",
+"aOK c #05091f",
+".iV c #05093f",
+".iW c #050943",
+"aD5 c #050a08",
+"ayO c #050a13",
+"#Hb c #050a20",
+"#mr c #050a30",
+"#zC c #050a34",
+".da c #050a3c",
+".g# c #050a3f",
+".hF c #050a43",
+".Kt c #050b11",
+"#hP c #050b2d",
+".bC c #050b3d",
+"ayB c #050c11",
+"#Uc c #050c1e",
+"am8 c #050c20",
+"#k1 c #050c35",
+"#vf c #050d1e",
+".a# c #050d4f",
+"#5E c #050e22",
+"QtH c #050e37",
+"aD0 c #050f09",
+"#tc c #050f16",
+".BM c #050f25",
+"#Hd c #050f27",
+"aQB c #051112",
+".W6 c #05193e",
+".A9 c #060000",
+".KJ c #060002",
+".Nv c #060004",
+"aMd c #060005",
+".HT c #060008",
+"#7S c #060009",
+"#bK c #06000e",
+"##9 c #06000f",
+"#AW c #060010",
+".7m c #06001c",
+".xt c #060026",
+".HV c #060103",
+"ax4 c #060104",
+"aNb c #060105",
+"#8k c #060106",
+".lM c #060125",
+"#3k c #060205",
+"ahh c #060206",
+"aqj c #060207",
+".HL c #060208",
+"ak4 c #060209",
+"aj0 c #06020a",
+".k. c #060229",
+".CE c #060303",
+".O7 c #060304",
+"#45 c #060305",
+"awm c #060307",
+".I8 c #060308",
+"aef c #06030a",
+".Zf c #060320",
+".Ze c #060329",
+".Wb c #06032d",
+".Uo c #06032f",
+".Gv c #060404",
+"ai2 c #060405",
+"aK2 c #060406",
+"aPP c #060407",
+"atd c #060409",
+"aeg c #06040b",
+"atA c #06040c",
+"awk c #06040d",
+"ay# c #06040e",
+"a.G c #060410",
+"avk c #060411",
+"a.H c #060413",
+"#Yz c #060418",
+"#W7 c #060419",
+".4# c #06041a",
+".2t c #06041c",
+".0P c #06041e",
+".sU c #060420",
+".oT c #060436",
+".lS c #06043d",
+".l1 c #060443",
+"acP c #060500",
+"agO c #060505",
+".LP c #060506",
+"api c #060507",
+"ano c #060508",
+"amg c #060509",
+"anp c #06050a",
+"avl c #06050b",
+".I0 c #06050c",
+"avB c #06050d",
+"aAG c #06050e",
+"awL c #060510",
+"asM c #060513",
+"aCR c #06051a",
+".4. c #060523",
+".MU c #06052f",
+".nu c #06053e",
+".nz c #060543",
+".l3 c #060544",
+".ko c #060547",
+".LU c #060601",
+"acO c #060603",
+"ank c #060607",
+"aqY c #060608",
+".TE c #060609",
+".S. c #06060a",
+"aim c #06060b",
+"aGM c #06060c",
+".Kl c #06060d",
+"aqJ c #06060e",
+"#VF c #06060f",
+"aog c #060610",
+"ay2 c #060611",
+"#IL c #060612",
+"asb c #060614",
+"aIa c #060616",
+"a#b c #060620",
+"#Ka c #060626",
+"#Cw c #06062a",
+".Ri c #060641",
+"acR c #060705",
+"abm c #060706",
+"abh c #06070b",
+"aH8 c #06070c",
+"art c #06070e",
+"af7 c #06070f",
+".S# c #060710",
+"aBr c #060713",
+"#82 c #060714",
+"#hR c #060722",
+"#nD c #06072e",
+"#qq c #06072f",
+".0U c #060738",
+".GR c #06073c",
+".PO c #06073f",
+".hy c #060740",
+".f4 c #060741",
+".c6 c #060742",
+".U. c #060747",
+".FU c #060806",
+".Ny c #06080a",
+"abi c #06080b",
+".Nz c #06080f",
+"af8 c #060810",
+".P. c #060812",
+"amY c #06081a",
+"amZ c #06081b",
+"ajJ c #06081d",
+"#mn c #060823",
+".IG c #060830",
+".hU c #060831",
+".PI c #060834",
+"#qv c #060836",
+".GT c #06083d",
+".eA c #060841",
+".8X c #060845",
+".Js c #06090d",
+"aMl c #06090f",
+"aMm c #060910",
+".KY c #060912",
+"ay3 c #060917",
+"aM0 c #06091f",
+".IC c #060927",
+"Qtf c #06092d",
+".Oc c #060935",
+".PA c #060938",
+".Kv c #060a0b",
+"aPZ c #060a0c",
+"aNT c #060a0d",
+"aCL c #060a0f",
+"aL5 c #060a1f",
+"#M4 c #060a20",
+"#ta c #060a26",
+"#g. c #060a27",
+"#IJ c #060a29",
+".br c #060a2d",
+".eH c #060a44",
+"aGN c #060b11",
+"aJA c #060b12",
+"#rW c #060b33",
+"Qtr c #060b3d",
+".db c #060b40",
+".Ku c #060c12",
+"aKi c #060c14",
+"#qw c #060c34",
+"aO7 c #060d13",
+"aNm c #060d14",
+"#ZJ c #060d1e",
+"alV c #060d21",
+"#PT c #060d2d",
+"#7l c #06102c",
+"a.N c #06102f",
+"aOc c #061117",
+"#tu c #06111f",
+"#Fw c #06122c",
+"aBg c #061719",
+".Jf c #070000",
+".EC c #070002",
+".Eo c #070004",
+".El c #070009",
+"#1W c #07000c",
+"ahK c #070017",
+"aD3 c #070100",
+".M5 c #070101",
+".KK c #070102",
+"abp c #070103",
+"aq# c #070104",
+"aqi c #070106",
+"aK8 c #070107",
+"aK7 c #070108",
+"#Ow c #070127",
+".Er c #070200",
+".Gs c #070202",
+".sF c #070203",
+".M4 c #070204",
+"aNc c #070206",
+"aM# c #070208",
+".Wh c #07020a",
+".Uu c #07020b",
+"aER c #070212",
+"#Or c #070213",
+"##0 c #070228",
+"#mp c #07022a",
+".Je c #070303",
+".Jd c #070304",
+"amf c #070306",
+"af6 c #070307",
+".HK c #070309",
+"#2N c #070311",
+"#mt c #070318",
+".XG c #070323",
+".sJ c #070326",
+"#.E c #070327",
+"#wH c #07032c",
+".PW c #070401",
+".LZ c #070402",
+".KO c #070405",
+"auq c #070406",
+".H4 c #070407",
+"aec c #070408",
+".I7 c #070409",
+"ar0 c #07040a",
+"ai4 c #07040b",
+"aCi c #070410",
+"avT c #070411",
+"aqH c #070414",
+"#6d c #07041a",
+"#2M c #07041d",
+".Fq c #070433",
+".GZ c #070437",
+"#y. c #070438",
+"#wD c #07043b",
+"aJM c #070505",
+"aed c #070506",
+"aK1 c #070507",
+"azn c #070508",
+"ax8 c #070509",
+"ark c #07050a",
+"#3j c #07050b",
+"auM c #07050c",
+"aun c #07050d",
+"auL c #07050e",
+"#9Y c #07050f",
+"auK c #070510",
+"au# c #070511",
+"au. c #070512",
+"aCQ c #070513",
+".HD c #070514",
+".4a c #070515",
+"#bt c #070518",
+"#VE c #070519",
+"#Ua c #07051a",
+"#VI c #070520",
+"#9w c #070521",
+"#7Q c #070522",
+".XF c #07052d",
+"#x9 c #070537",
+".kd c #070541",
+".Ef c #070605",
+"abn c #070606",
+".LL c #070608",
+"arX c #070609",
+".Mg c #07060b",
+".XR c #07060c",
+".IP c #07060d",
+"acH c #07060e",
+"azs c #07060f",
+"awj c #070611",
+"asL c #070612",
+"as# c #070613",
+"apQ c #070614",
+"atk c #070615",
+"#pe c #07061e",
+"#LA c #070621",
+".sV c #070622",
+".5I c #070624",
+"#II c #07062c",
+".LV c #070701",
+"abX c #070706",
+"awx c #070708",
+".H6 c #070709",
+"apl c #07070b",
+"aky c #07070c",
+"apN c #07070e",
+"aoc c #07070f",
+"#YB c #070710",
+"aH9 c #070711",
+"aru c #070712",
+"arv c #070713",
+"ao5 c #070714",
+"aoh c #070715",
+"#nE c #070732",
+".iL c #07073a",
+".T9 c #070740",
+".bv c #070742",
+".Ra c #070743",
+"aD4 c #070804",
+"acK c #070809",
+"#8o c #07080c",
+".O9 c #07080e",
+"aLn c #07080f",
+"af9 c #070812",
+"aCP c #070813",
+"#nN c #070823",
+"#nS c #070824",
+"#pd c #070828",
+".fW c #070837",
+".ho c #07083a",
+".Of c #07083d",
+".#5 c #070843",
+"Qtj c #070844",
+".bH c #07084a",
+".FZ c #070907",
+".IS c #070909",
+"as5 c #07090a",
+".Kp c #07090b",
+"aOI c #070910",
+"aeT c #070912",
+".EW c #070914",
+"#W9 c #070919",
+"#D0 c #070922",
+"#qy c #070923",
+"#rY c #070924",
+"#MU c #070926",
+"#gg c #070932",
+".rB c #070935",
+"#o9 c #070937",
+".Sz c #07093c",
+".Ul c #070946",
+".Um c #070948",
+".Hy c #070a07",
+"aNj c #070a10",
+"aPm c #070a12",
+".Jt c #070a13",
+"am0 c #070a1d",
+"#rO c #070a25",
+"#P2 c #070a26",
+"#qn c #070a27",
+".c2 c #070a2d",
+".ex c #070a2e",
+"#zD c #070a31",
+".Iz c #070a35",
+".R. c #070a39",
+"aOG c #070b0f",
+"aO8 c #070b11",
+"am1 c #070b1f",
+"#Rn c #070b20",
+"#Ft c #070b22",
+".JY c #070b35",
+".2x c #070b3d",
+".bD c #070b45",
+"aOH c #070c14",
+"ayD c #070c15",
+"a.L c #070c23",
+"#va c #070c28",
+"#Oo c #070c2a",
+"Qts c #070c41",
+"#p. c #070d34",
+".iY c #070d4f",
+".Dk c #070f22",
+"aO6 c #071017",
+"ayQ c #07101c",
+"#hV c #07103c",
+"ayS c #07111e",
+"aNl c #071319",
+"#89 c #071437",
+".P# c #071d45",
+".M6 c #080000",
+".zu c #080001",
+"abq c #080003",
+"aps c #080004",
+"aFW c #080005",
+".SW c #080006",
+"ayN c #08000a",
+"#Ix c #08000e",
+".ml c #080010",
+".7e c #08001c",
+"#s7 c #080025",
+"am# c #080101",
+".HS c #08010c",
+"#Ot c #08010d",
+"#J2 c #08010f",
+".9. c #080110",
+".ES c #080201",
+".A5 c #080202",
+"al# c #080203",
+"a#M c #080204",
+"aEe c #080206",
+"aGX c #080207",
+"aKR c #080208",
+"agy c #08021d",
+"#ab c #08021e",
+".HX c #080302",
+".Jc c #080305",
+"azl c #080306",
+"aMa c #080309",
+"aiS c #08030e",
+"#zs c #080315",
+".n# c #080321",
+".Oi c #080327",
+"#.F c #080328",
+".L0 c #080402",
+"aPO c #080403",
+"awO c #080406",
+"atI c #080407",
+".HM c #080408",
+"aeb c #080409",
+"aMb c #08040a",
+".Hb c #080410",
+"aHt c #080415",
+".XH c #08041f",
+".V7 c #080426",
+".lO c #080428",
+"#hS c #08042c",
+"#u6 c #08043f",
+".Km c #080502",
+".LY c #080503",
+".TD c #080504",
+"a#L c #080506",
+".HN c #080507",
+".HY c #080508",
+"aea c #080509",
+".J. c #08050a",
+"ald c #08050c",
+"aBe c #08050e",
+".3W c #080512",
+"at9 c #080513",
+"apM c #080515",
+".HA c #08051a",
+".V8 c #080521",
+"#wI c #080527",
+"acQ c #080600",
+".R9 c #080605",
+"aJO c #080608",
+"azm c #080609",
+"aPS c #08060a",
+"aoR c #08060b",
+"afy c #08060c",
+"afx c #08060d",
+"auo c #08060e",
+"avj c #080611",
+"avS c #080612",
+"aap c #080613",
+"apL c #080615",
+"#Rj c #08061a",
+"#r2 c #080624",
+".B8 c #08062e",
+".MQ c #080631",
+"#u3 c #080636",
+".l7 c #080648",
+"aa8 c #080700",
+".Eg c #080706",
+".Nx c #080708",
+".LN c #080709",
+"aow c #08070b",
+"anq c #08070c",
+"aEB c #08070d",
+"aHj c #08070e",
+"atB c #08070f",
+"azr c #080710",
+"avi c #080711",
+"awK c #080712",
+"apO c #080713",
+"aof c #080714",
+"as. c #080715",
+"aqI c #080716",
+"aBs c #08071d",
+".5P c #080724",
+"#v# c #08072b",
+".2r c #080730",
+".0N c #080733",
+"#eB c #080735",
+".LQ c #080803",
+"acS c #080806",
+"aw1 c #08080a",
+"aO. c #08080b",
+"amM c #08080d",
+".I1 c #08080e",
+"aO0 c #080810",
+".Wi c #080811",
+"aod c #080813",
+"apP c #080816",
+"#Kb c #08081b",
+"#wK c #08081c",
+"#M5 c #08081d",
+"#ew c #080831",
+"asz c #08090b",
+"alG c #08090d",
+"avN c #08090f",
+"ahk c #080911",
+"acj c #080923",
+"aaP c #080925",
+"acl c #080926",
+"#jn c #080934",
+".hp c #080938",
+".fV c #08093b",
+"#dc c #080943",
+".PD c #080944",
+"aOF c #080a0e",
+"aJB c #080a11",
+"ain c #080a12",
+"aio c #080a13",
+"ag. c #080a14",
+"#wM c #080a16",
+".4b c #080a2d",
+".iM c #080a39",
+".N6 c #080a3e",
+".T4 c #080a41",
+"##1 c #080a47",
+".Hw c #080b08",
+".Hu c #080b09",
+"aLo c #080b12",
+"aQt c #080b14",
+".KZ c #080b18",
+"aas c #080b24",
+".CA c #080b26",
+"#o1 c #080b29",
+".f0 c #080b2e",
+".hu c #080b2f",
+".vU c #080b32",
+".SG c #080b36",
+".J8 c #080b37",
+".KA c #080c0d",
+"aKj c #080c13",
+"#84 c #080c1e",
+"Qtt c #080c46",
+"#Hc c #080d30",
+".Z# c #080d45",
+"#tv c #080e18",
+"adE c #080e28",
+"#nL c #080e35",
+"#SQ c #080f2e",
+"aCA c #081011",
+"#Om c #081133",
+".bR c #08123a",
+"agl c #081339",
+"aPx c #081717",
+"#5G c #081736",
+"a#N c #090003",
+"#D7 c #090013",
+".Eb c #090016",
+".Rl c #09001b",
+"#VJ c #09001e",
+"aLc c #090107",
+"aBl c #09010a",
+"#zF c #09011e",
+"#4x c #090203",
+"arU c #090207",
+"#9W c #09020d",
+"ayH c #090214",
+"##R c #09021a",
+".CB c #09021d",
+"#nP c #090229",
+".Gl c #090301",
+".Eq c #090302",
+"aCG c #090305",
+"arV c #090308",
+"aK6 c #090309",
+"aFn c #09030b",
+".Up c #09031e",
+"#bL c #09031f",
+"adX c #090324",
+".bY c #090325",
+"#r1 c #090326",
+".QA c #090404",
+"aAo c #090406",
+".Gb c #090407",
+".Jb c #090409",
+".Ja c #09040a",
+".Uw c #09040c",
+"#9X c #09040e",
+"adY c #09041e",
+"#qC c #090428",
+".IQ c #090502",
+".LW c #090503",
+"abo c #090506",
+".M3 c #090507",
+"aq8 c #090508",
+"ae# c #090509",
+"afu c #09050a",
+".BJ c #09050b",
+"#4w c #090511",
+"ayU c #090514",
+"#PW c #090517",
+"#Ln c #09051d",
+".Ui c #090523",
+".Uh c #090528",
+".V6 c #090530",
+"#wE c #09053e",
+".L1 c #090603",
+".LX c #090604",
+"acT c #090607",
+"#6J c #090608",
+".Nw c #09060a",
+".Dg c #09060b",
+"arl c #09060c",
+"afz c #09060d",
+"aLl c #09060e",
+"aLm c #09060f",
+".5u c #090612",
+"#SU c #090616",
+"#9x c #090619",
+".Zg c #09061e",
+"#1k c #090621",
+"#yb c #09062c",
+".Ug c #090631",
+".T6 c #090632",
+".VW c #090636",
+".oH c #09063a",
+"acC c #090700",
+".Md c #090701",
+"aM8 c #090709",
+".F7 c #09070a",
+"aba c #09070b",
+"anO c #09070c",
+"aj9 c #09070e",
+"atE c #09070f",
+"aJx c #090710",
+"aEC c #090711",
+"awi c #090712",
+"avR c #090713",
+"auI c #090714",
+"ao4 c #090716",
+".2u c #09071a",
+"#ZZ c #090721",
+"a#. c #090722",
+".XL c #09072f",
+"#Fu c #090733",
+".nk c #09073d",
+"aw0 c #09080a",
+"ay. c #09080b",
+"aQA c #09080d",
+"#ZH c #090810",
+"aDn c #090811",
+"aFr c #090813",
+"aOJ c #090814",
+"aoe c #090816",
+"ay6 c #09081f",
+"a## c #090824",
+"#9v c #090826",
+"#J9 c #09082b",
+"#x8 c #090833",
+"#zA c #090834",
+"#y# c #090836",
+"axp c #09090b",
+"atb c #09090c",
+"alb c #09090f",
+".GB c #090914",
+"aF6 c #090918",
+"#OA c #09091b",
+"adB c #09091e",
+".39 c #090930",
+"#qk c #090936",
+"#js c #09093a",
+".gv c #09093b",
+".Fm c #09093c",
+".Ko c #090a0b",
+"aaj c #090a0c",
+"ayv c #090a0d",
+"avd c #090a0f",
+"auB c #090a10",
+"aOa c #090a11",
+".TF c #090a12",
+"aip c #090a15",
+"ahl c #090a16",
+"amQ c #090a17",
+"#83 c #090a1a",
+"ae1 c #090a22",
+"ack c #090a26",
+"#Cu c #090a29",
+".Kd c #090a2d",
+".hM c #090a30",
+"#mq c #090a33",
+"#hH c #090a35",
+"#oY c #090a36",
+".W# c #090a49",
+".gd c #090a4c",
+"aCI c #090b0d",
+"akz c #090b13",
+"amP c #090b16",
+"#Ru c #090b18",
+".A. c #090b19",
+"#nA c #090b2d",
+"#nK c #090b39",
+".iQ c #090b41",
+"#VH c #090c21",
+"#Oy c #090c28",
+".xH c #090c31",
+".Lu c #090c38",
+".J0 c #090c3b",
+".V0 c #090c52",
+"aPX c #090d0f",
+".EY c #090d1b",
+"#PU c #090d28",
+".XA c #090d48",
+"aQa c #090e0c",
+"aNU c #090e13",
+"aPE c #090e15",
+"#IH c #090e24",
+"aau c #090e29",
+"aP9 c #090f14",
+"#SP c #090f28",
+"#ml c #090f37",
+".5D c #090f3e",
+".0K c #090f44",
+"#vg c #09111f",
+"ab8 c #09122f",
+"ayx c #091311",
+"aLr c #09131a",
+".Aa c #091731",
+".M. c #0a0000",
+"#8j c #0a0003",
+"#ye c #0a000c",
+"aco c #0a0104",
+"aBi c #0a010c",
+".zy c #0a0203",
+"aiT c #0a0206",
+".On c #0a020a",
+"ayK c #0a0214",
+"#IB c #0a0216",
+"aak c #0a030d",
+".HR c #0a0310",
+"adZ c #0a0313",
+".za c #0a0329",
+"#kZ c #0a032a",
+".0b c #0a0400",
+".ER c #0a0402",
+".A8 c #0a0404",
+"acU c #0a0407",
+".F9 c #0a0408",
+"as9 c #0a0409",
+"aK5 c #0a040a",
+".89 c #0a0420",
+"afi c #0a0423",
+"#ID c #0a042a",
+".Jh c #0a0504",
+"aN1 c #0a0505",
+"ame c #0a0506",
+"ahT c #0a0507",
+"azi c #0a0508",
+"am. c #0a0509",
+"aM9 c #0a050a",
+"aMc c #0a050b",
+".86 c #0a0520",
+"#Rf c #0a052b",
+".k# c #0a052c",
+"#v. c #0a0530",
+".ks c #0a0545",
+"axe c #0a0605",
+".HW c #0a0606",
+"ar# c #0a0609",
+"agN c #0a060a",
+"agM c #0a060b",
+"aJw c #0a060f",
+"a.F c #0a0612",
+".Ar c #0a0628",
+"#dl c #0a062a",
+"#H. c #0a062e",
+".CH c #0a0706",
+"#96 c #0a0709",
+"ahU c #0a070b",
+".I9 c #0a070c",
+"agP c #0a070e",
+"aao c #0a0713",
+"aob c #0a0717",
+"a#c c #0a0719",
+"#r3 c #0a071a",
+".0Q c #0a071c",
+"#Yy c #0a0721",
+"#W6 c #0a0722",
+"#4u c #0a0726",
+".sZ c #0a0734",
+".H1 c #0a080a",
+"aPR c #0a080b",
+"aOU c #0a080c",
+"anN c #0a080d",
+"aN5 c #0a080e",
+"ai6 c #0a080f",
+"atD c #0a0810",
+"aDm c #0a0812",
+"atj c #0a0813",
+"at5 c #0a0814",
+"at6 c #0a0815",
+"aoa c #0a0817",
+"apK c #0a0818",
+"#9u c #0a0824",
+"#6c c #0a0825",
+".ry c #0a082a",
+".Zl c #0a082d",
+"#zB c #0a0836",
+".G2 c #0a0838",
+"#f7 c #0a0849",
+".kk c #0a084b",
+"adq c #0a0907",
+".Ee c #0a0908",
+"arS c #0a090b",
+".Gx c #0a090c",
+"ai1 c #0a090e",
+"avh c #0a0910",
+"avA c #0a0911",
+"avQ c #0a0913",
+"auH c #0a0914",
+"akL c #0a0919",
+"#P3 c #0a091a",
+"#MW c #0a0920",
+".sT c #0a0925",
+"#u0 c #0a0930",
+".IF c #0a0933",
+"#ex c #0a093a",
+".dx c #0a0941",
+".H5 c #0a0a0a",
+"atT c #0a0a10",
+"#Yf c #0a0a11",
+"acG c #0a0a12",
+"aDD c #0a0a17",
+"akD c #0a0a19",
+"a.I c #0a0a1b",
+"#jA c #0a0a26",
+"a#a c #0a0a27",
+"#H# c #0a0a2d",
+"#nw c #0a0a35",
+".Uj c #0a0a3a",
+".es c #0a0a3d",
+".gw c #0a0a3e",
+".XK c #0a0a41",
+".VY c #0a0a46",
+".LT c #0a0b05",
+".FW c #0a0b09",
+"asw c #0a0b0c",
+"ayw c #0a0b0d",
+"azM c #0a0b0f",
+"ave c #0a0b10",
+"a.D c #0a0b11",
+".Dh c #0a0b15",
+".0A c #0a0b16",
+"ag# c #0a0b17",
+"amR c #0a0b18",
+"akC c #0a0b1a",
+"amX c #0a0b1b",
+"alR c #0a0b1d",
+"#zw c #0a0b28",
+"#zy c #0a0b2f",
+".do c #0a0b31",
+"#l8 c #0a0b35",
+"Qt# c #0a0b3c",
+".Zk c #0a0b3f",
+".c5 c #0a0b46",
+".bu c #0a0b47",
+"aOW c #0a0c0e",
+"acI c #0a0c13",
+"alH c #0a0c14",
+"alI c #0a0c15",
+"aDy c #0a0c18",
+"#uY c #0a0c28",
+".MJ c #0a0c40",
+".hx c #0a0c43",
+".W. c #0a0c48",
+"#gh c #0a0c49",
+".Py c #0a0d38",
+".Ll c #0a0d39",
+".kp c #0a0d50",
+"aP0 c #0a0e10",
+"ayA c #0a0e12",
+"aQC c #0a0e16",
+".MI c #0a0e38",
+".i7 c #0a0e3d",
+".hG c #0a0e4b",
+".qd c #0a0f3c",
+"#Yh c #0a1023",
+"aD9 c #0a102f",
+"#kX c #0a1038",
+".35 c #0a1040",
+".2n c #0a1042",
+"#PS c #0a1437",
+"aQd c #0a171a",
+".Os c #0b0000",
+".PZ c #0b0001",
+".M# c #0b0003",
+".Nu c #0b0004",
+"aLj c #0b0005",
+"#Cn c #0b0013",
+"#0B c #0b0107",
+"aFo c #0b010c",
+".Jg c #0b0200",
+"aCF c #0b0203",
+".M1 c #0b020a",
+"aaS c #0b0306",
+".PU c #0b030b",
+"aiQ c #0b0314",
+"aIS c #0b040e",
+"akN c #0b0410",
+"#P0 c #0b0417",
+".oY c #0b0433",
+".kt c #0b0437",
+".Df c #0b0505",
+".O6 c #0b0508",
+"aK4 c #0b050b",
+"az9 c #0b050e",
+"##S c #0b0515",
+"ayG c #0b0517",
+".Wc c #0b051f",
+"#bO c #0b0521",
+".FB c #0b0524",
+"#G9 c #0b052a",
+"#wG c #0b0534",
+"axO c #0b0605",
+".Gn c #0b0606",
+"ax6 c #0b0609",
+"ak5 c #0b060a",
+"al8 c #0b060d",
+"#MY c #0b0617",
+"ahL c #0b0618",
+"#Lp c #0b061c",
+".yR c #0b0622",
+".nf c #0b0624",
+".lH c #0b062a",
+"#bM c #0b062b",
+"#VA c #0b062c",
+"#t. c #0b0634",
+".Gr c #0b0706",
+"aq9 c #0b070a",
+"af5 c #0b070b",
+"ajv c #0b070c",
+"asr c #0b070d",
+".F3 c #0b0714",
+"#bs c #0b0724",
+"#J8 c #0b072f",
+".nA c #0b0742",
+".ge c #0b0743",
+"#ti c #0b0745",
+".CI c #0b0808",
+"alF c #0b080c",
+"a.C c #0b080d",
+"aoT c #0b080e",
+"aeh c #0b080f",
+"aEZ c #0b0812",
+"axL c #0b0815",
+"alO c #0b0817",
+"ao# c #0b0818",
+"#LB c #0b081f",
+"#VD c #0b0822",
+"#U# c #0b0823",
+"#k0 c #0b0831",
+".HZ c #0b090b",
+"#2u c #0b090c",
+"ai0 c #0b090d",
+"aoS c #0b090e",
+"ahV c #0b090f",
+"atQ c #0b0910",
+"au2 c #0b0911",
+"avP c #0b0912",
+"auG c #0b0913",
+"an1 c #0b0914",
+"an0 c #0b0915",
+"at7 c #0b0916",
+"ao. c #0b0919",
+"#uX c #0b092f",
+".p8 c #0b0933",
+"#ya c #0b0934",
+".Zd c #0b0938",
+".Uf c #0b093d",
+".lU c #0b0948",
+"aCH c #0b0a0b",
+"abW c #0b0a0c",
+".H8 c #0b0a0f",
+"avg c #0b0a10",
+"auF c #0b0a11",
+".HG c #0b0a12",
+"anS c #0b0a13",
+"anT c #0b0a14",
+"anU c #0b0a15",
+"aDC c #0b0a17",
+"alP c #0b0a19",
+"ab3 c #0b0a1e",
+".Kb c #0b0a35",
+"#kS c #0b0a3b",
+"#jr c #0b0a3f",
+".kc c #0b0a42",
+"#f6 c #0b0a47",
+".l4 c #0b0a49",
+"anQ c #0b0b0f",
+"anR c #0b0b10",
+"aj8 c #0b0b11",
+"aP1 c #0b0b12",
+".GA c #0b0b14",
+"aEO c #0b0b19",
+"alK c #0b0b1a",
+"ajz c #0b0b1b",
+"ab4 c #0b0b21",
+".Ke c #0b0b22",
+".5H c #0b0b31",
+"#kN c #0b0b36",
+".V9 c #0b0b3a",
+"#jo c #0b0b3b",
+".Wa c #0b0b43",
+".f6 c #0b0b49",
+"asy c #0b0c0d",
+"azN c #0b0c0e",
+"aA0 c #0b0c10",
+"amh c #0b0c11",
+"awf c #0b0c12",
+"aKg c #0b0c13",
+"akA c #0b0c16",
+"ajx c #0b0c17",
+"alJ c #0b0c18",
+"ahm c #0b0c19",
+"ajy c #0b0c1a",
+"#MV c #0b0c26",
+"#ma c #0b0c30",
+"#jm c #0b0c33",
+"#hy c #0b0c34",
+"#kG c #0b0c35",
+".cX c #0b0c3e",
+".Rf c #0b0c42",
+".ez c #0b0c46",
+".ML c #0b0c47",
+".eC c #0b0c48",
+".#4 c #0b0c49",
+".hA c #0b0c4b",
+".Hx c #0b0d0b",
+"as3 c #0b0d0e",
+"aKh c #0b0d14",
+"aQn c #0b0d15",
+"aCd c #0b0d18",
+"#D1 c #0b0d2a",
+".Li c #0b0d3a",
+"#mk c #0b0d3b",
+".PB c #0b0d40",
+".f3 c #0b0d44",
+".7a c #0b0d4a",
+"aLp c #0b0e15",
+".0B c #0b0e16",
+"ae3 c #0b0e28",
+".iO c #0b0e34",
+".hs c #0b0e35",
+".JZ c #0b0e3a",
+".Io c #0b0e3b",
+".ga c #0b0e4b",
+"aMn c #0b0f15",
+"aat c #0b0f29",
+".Ih c #0b0f3b",
+".eI c #0b0f4c",
+"azO c #0b1012",
+"aLs c #0b1017",
+"#ww c #0b1019",
+".E# c #0b1024",
+"#Ue c #0b102c",
+"#k2 c #0b1033",
+"#Fv c #0b1035",
+"#jv c #0b1038",
+".uw c #0b1043",
+".s7 c #0b1044",
+".V2 c #0b104c",
+".de c #0b1053",
+"aQ# c #0b1110",
+"#hO c #0b1139",
+"aD1 c #0b120a",
+"auO c #0b122a",
+"#jz c #0b1237",
+"aL6 c #0b183a",
+".Qx c #0c0000",
+"a#x c #0c0001",
+".R7 c #0c0004",
+"ad0 c #0c0005",
+"aH6 c #0c0009",
+"#1V c #0c0011",
+"#nO c #0c0026",
+"aiU c #0c0100",
+".Rt c #0c0106",
+"#Kc c #0c010c",
+".Dd c #0c0200",
+"abZ c #0c020a",
+"ayV c #0c0211",
+".FS c #0c0214",
+"aHw c #0c0215",
+"amc c #0c0301",
+".PY c #0c0307",
+".LJ c #0c030b",
+"akM c #0c030d",
+"#9V c #0c030e",
+"#zr c #0c031c",
+"#bF c #0c0320",
+".z# c #0c032f",
+".YA c #0c0400",
+"agI c #0c0403",
+".KN c #0c0404",
+".XS c #0c040a",
+".Rq c #0c040c",
+"#Os c #0c0410",
+"#MZ c #0c0411",
+"#J1 c #0c0413",
+".7n c #0c0414",
+"#eG c #0c0427",
+"adW c #0c042a",
+"#uV c #0c042e",
+".an c #0c0435",
+"aC2 c #0c0507",
+"aqf c #0c0509",
+"apw c #0c050a",
+"aBk c #0c050d",
+"aHv c #0c0517",
+"#6a c #0c0522",
+".B9 c #0c0533",
+"a#B c #0c0605",
+".B. c #0c0606",
+"#6K c #0c0607",
+".Ep c #0c0608",
+"aAA c #0c0609",
+".Ma c #0c060a",
+"aBC c #0c060b",
+"aK3 c #0c060c",
+"aA3 c #0c060e",
+"aKf c #0c0610",
+"aJv c #0c0611",
+".Ca c #0c0629",
+".sI c #0c0635",
+".Gt c #0c0706",
+"agJ c #0c0707",
+"ae. c #0c0709",
+"azj c #0c070a",
+".G. c #0c070b",
+"am5 c #0c0710",
+"aiR c #0c0715",
+"#eX c #0c0723",
+".A3 c #0c0726",
+"#dm c #0c072c",
+"#Yw c #0c072d",
+".Gp c #0c0807",
+"#8r c #0c080a",
+"aNa c #0c080c",
+"amI c #0c080d",
+"ap5 c #0c080e",
+"aBn c #0c080f",
+"aIT c #0c0811",
+"QtO c #0c081b",
+"#Rg c #0c082b",
+"#VB c #0c082c",
+"#pc c #0c082d",
+".0H c #0c082f",
+".p2 c #0c083a",
+"ax3 c #0c090a",
+"aN6 c #0c090d",
+"aqp c #0c090f",
+"afw c #0c0910",
+"aO1 c #0c0912",
+".FC c #0c0916",
+"an9 c #0c0919",
+"#4v c #0c0921",
+"#Ri c #0c0923",
+"#7P c #0c0927",
+"#ZY c #0c0928",
+"ax1 c #0c0a0b",
+"aIl c #0c0a0c",
+"aPQ c #0c0a0d",
+"ala c #0c0a0e",
+".F6 c #0c0a0f",
+"ai5 c #0c0a11",
+"aPF c #0c0a12",
+"aoZ c #0c0a13",
+"ao0 c #0c0a14",
+"anZ c #0c0a15",
+"apI c #0c0a16",
+"at4 c #0c0a17",
+"ao2 c #0c0a19",
+"an8 c #0c0a1a",
+"ahv c #0c0a1f",
+"#zE c #0c0a2d",
+".Pw c #0c0a39",
+".oU c #0c0a3c",
+".V5 c #0c0a3d",
+".nj c #0c0a40",
+".LK c #0c0b0d",
+"aoV c #0c0b0f",
+"aoW c #0c0b10",
+"aoX c #0c0b11",
+"aoY c #0c0b12",
+"apH c #0c0b13",
+"azG c #0c0b15",
+"aqD c #0c0b16",
+"aNV c #0c0b17",
+"aaq c #0c0b19",
+"aF7 c #0c0b1a",
+"#wJ c #0c0b26",
+"#qD c #0c0b2a",
+".rv c #0c0b2d",
+".N1 c #0c0b39",
+"#nx c #0c0b3a",
+".XE c #0c0b3c",
+"#ny c #0c0b3e",
+"#l9 c #0c0b3f",
+"aN7 c #0c0c0f",
+"auE c #0c0c10",
+"avO c #0c0c11",
+"atS c #0c0c12",
+"aGg c #0c0c14",
+"ayE c #0c0c17",
+"aga c #0c0c1a",
+"amS c #0c0c1b",
+"#zx c #0c0c2d",
+"#D3 c #0c0c2e",
+"#hz c #0c0c39",
+".MG c #0c0c3a",
+"#kT c #0c0c3b",
+"#hI c #0c0c3c",
+"#kH c #0c0c3f",
+".N8 c #0c0c48",
+".Iu c #0c0c4c",
+"aA1 c #0c0d10",
+"azP c #0c0d11",
+"avf c #0c0d12",
+"auC c #0c0d13",
+"aEY c #0c0d14",
+"amO c #0c0d16",
+"akB c #0c0d18",
+"aeU c #0c0d19",
+"aeV c #0c0d1b",
+"aiq c #0c0d1c",
+"agj c #0c0d24",
+"#hG c #0c0d34",
+"#kM c #0c0d35",
+".MB c #0c0d3a",
+"#f5 c #0c0d40",
+".PM c #0c0d43",
+".Lm c #0c0d45",
+".Ln c #0c0d49",
+"Qti c #0c0d4b",
+".kq c #0c0d52",
+"amN c #0c0e16",
+"aCc c #0c0e19",
+"#kW c #0c0e3c",
+"Qtm c #0c0e42",
+".SJ c #0c0e47",
+".SK c #0c0e4b",
+".VZ c #0c0e50",
+"aOZ c #0c0f11",
+".fY c #0c0f35",
+".2w c #0c0f3a",
+".N4 c #0c0f3b",
+".dq c #0c0f3e",
+".dc c #0c0f4c",
+"aPU c #0c1011",
+"#DX c #0c101d",
+"a.K c #0c1026",
+".go c #0c103f",
+".bE c #0c104d",
+".Ub c #0c105d",
+".5E c #0c1141",
+".rK c #0c1147",
+".oV c #0c1244",
+"ab9 c #0c1633",
+"aaw c #0c1635",
+"a.P c #0c183a",
+"ahy c #0c183d",
+".L8 c #0d0000",
+".Nt c #0d0003",
+".Qy c #0d0004",
+"azX c #0d000c",
+".FK c #0d0011",
+"aJJ c #0d0100",
+"afk c #0d0107",
+"aze c #0d0201",
+".xQ c #0d0204",
+"alT c #0d0208",
+"abY c #0d020b",
+".M7 c #0d0300",
+".O4 c #0d0302",
+"az7 c #0d0310",
+"acB c #0d0400",
+"al. c #0d0403",
+".2H c #0d0406",
+".EA c #0d0407",
+".O5 c #0d0408",
+"ahN c #0d0409",
+"aph c #0d040a",
+".Rs c #0d040b",
+".ST c #0d040c",
+"aIR c #0d040e",
+".H# c #0d0434",
+"#6L c #0d0504",
+"#97 c #0d0506",
+"aK9 c #0d050b",
+".Kj c #0d050d",
+"ayX c #0d050f",
+".Gf c #0d0510",
+"ajY c #0d0511",
+"#dn c #0d0515",
+"#hY c #0d0519",
+"aAB c #0d060a",
+"aqh c #0d060b",
+".En c #0d060d",
+".HQ c #0d0613",
+"#PX c #0d0614",
+"#bP c #0d0615",
+"ayL c #0d0618",
+".MW c #0d0619",
+".R8 c #0d0707",
+".5R c #0d0709",
+"aAm c #0d070b",
+"arc c #0d070c",
+"akG c #0d0714",
+"#bE c #0d0732",
+"#wF c #0d0738",
+"aIj c #0d0808",
+"ajE c #0d0817",
+"agz c #0d081e",
+"afj c #0d0820",
+".lN c #0d082c",
+"#bN c #0d082d",
+".j9 c #0d082f",
+".VQ c #0d083c",
+"#tj c #0d0847",
+"apz c #0d090d",
+"aq1 c #0d090e",
+"ak3 c #0d0911",
+"aiy c #0d0919",
+"#Yx c #0d0928",
+"#VC c #0d0929",
+"#ZX c #0d092c",
+".rn c #0d0931",
+".VU c #0d0932",
+".Sv c #0d0938",
+".Sr c #0d0939",
+".Fo c #0d093b",
+".oX c #0d0940",
+".CD c #0d0a0a",
+"atG c #0d0a0c",
+"aO9 c #0d0a0d",
+"are c #0d0a0e",
+"azE c #0d0a14",
+"alN c #0d0a17",
+"an3 c #0d0a1a",
+"#Rh c #0d0a29",
+"#c0 c #0d0a35",
+".Q6 c #0d0a38",
+".Q1 c #0d0a39",
+"#wC c #0d0a3e",
+"#u5 c #0d0a42",
+"aN4 c #0d0b0d",
+".EU c #0d0b0f",
+"aoU c #0d0b10",
+"aqw c #0d0b13",
+"aqx c #0d0b14",
+"aqy c #0d0b15",
+".Kf c #0d0b16",
+"arp c #0d0b17",
+"at3 c #0d0b18",
+"amU c #0d0b19",
+"ao3 c #0d0b1a",
+"an7 c #0d0b1b",
+"#A6 c #0d0b2c",
+"#nQ c #0d0b32",
+".q# c #0d0b34",
+".uo c #0d0b36",
+".Pr c #0d0b39",
+".G1 c #0d0b3c",
+".oQ c #0d0b3d",
+".nh c #0d0b40",
+".lZ c #0d0b4a",
+".Hc c #0d0c0a",
+".LO c #0d0c0e",
+"aqt c #0d0c10",
+"aqu c #0d0c11",
+"aqv c #0d0c12",
+"arm c #0d0c13",
+"arn c #0d0c14",
+"aro c #0d0c15",
+"awh c #0d0c16",
+"ao1 c #0d0c17",
+"aGf c #0d0c18",
+"aEP c #0d0c1a",
+"akK c #0d0c1c",
+"#Oq c #0d0c21",
+"#Cz c #0d0c2a",
+"#A3 c #0d0c34",
+"#u1 c #0d0c35",
+"#eK c #0d0c3c",
+"#ql c #0d0c3e",
+"#hA c #0d0c3f",
+"#kR c #0d0c40",
+".kl c #0d0c4e",
+"aOB c #0d0d07",
+"atU c #0d0d13",
+"aEX c #0d0d17",
+"aGe c #0d0d1a",
+"aeW c #0d0d1c",
+"#wy c #0d0d31",
+"#rT c #0d0d3c",
+"#kO c #0d0d3d",
+"#mg c #0d0d3e",
+".bm c #0d0d40",
+".SL c #0d0d4b",
+".Lo c #0d0d4c",
+".iT c #0d0d4d",
+"aCh c #0d0e12",
+"atW c #0d0e13",
+"auD c #0d0e14",
+"aIU c #0d0e15",
+"aDH c #0d0e16",
+"aDz c #0d0e1a",
+"agb c #0d0e1c",
+"air c #0d0e1d",
+"akP c #0d0e1f",
+".zo c #0d0e30",
+"#jj c #0d0e36",
+"#rN c #0d0e37",
+"#hD c #0d0e38",
+".qe c #0d0e40",
+".c8 c #0d0e47",
+".ab c #0d0e50",
+"aFm c #0d0f0b",
+"as8 c #0d0f10",
+"aNk c #0d0f16",
+"aQk c #0d0f17",
+"aEN c #0d0f1c",
+"adC c #0d0f26",
+"#zv c #0d0f29",
+"#A0 c #0d0f2a",
+".eT c #0d0f35",
+".ev c #0d0f36",
+"#f4 c #0d0f3b",
+".ux c #0d0f3d",
+".2q c #0d0f3e",
+".#7 c #0d0f44",
+".XJ c #0d0f4c",
+".l6 c #0d0f51",
+"a.J c #0d1023",
+"aiB c #0d1028",
+".s9 c #0d103f",
+".PH c #0d1042",
+".0S c #0d1045",
+".a. c #0d104d",
+"Qtu c #0d104e",
+"aQb c #0d110d",
+"aLq c #0d1117",
+"#DY c #0d1121",
+".4d c #0d1141",
+".qn c #0d114a",
+"#Lz c #0d1228",
+"adD c #0d122a",
+".A2 c #0d1232",
+".36 c #0d1243",
+".bG c #0d1255",
+"aQ. c #0d1315",
+"Qtw c #0d1355",
+"aMq c #0d141a",
+"Qtv c #0d1657",
+".dp c #0d173f",
+".Hs c #0e0000",
+"aDL c #0e0008",
+"azW c #0e000e",
+".L7 c #0e0100",
+"#nU c #0e0105",
+"#0A c #0e010a",
+"aC1 c #0e0202",
+".KL c #0e0301",
+"au1 c #0e0305",
+"aGK c #0e030d",
+"amb c #0e0401",
+".KM c #0e0403",
+"a#w c #0e0404",
+".xO c #0e0406",
+"aGY c #0e0408",
+"az8 c #0e040f",
+"aiP c #0e0415",
+"#pb c #0e042a",
+"#8t c #0e0506",
+".Qz c #0e0508",
+"apv c #0e0509",
+"acV c #0e050a",
+"#eZ c #0e050c",
+"#Z2 c #0e0516",
+"#mo c #0e052c",
+".Rk c #0e0531",
+".SN c #0e0532",
+".CQ c #0e0600",
+"#46 c #0e0604",
+".Ex c #0e0606",
+".zx c #0e0607",
+"arb c #0e060c",
+"#qE c #0e060d",
+".IM c #0e060e",
+"#gs c #0e0616",
+"afh c #0e0629",
+".TC c #0e0707",
+"aAz c #0e070b",
+"aal c #0e0712",
+".Wd c #0e0716",
+"#yd c #0e0720",
+".PP c #0e072f",
+".qg c #0e0734",
+".W5 c #0e0805",
+"afs c #0e0808",
+"#8s c #0e0809",
+".Or c #0e080b",
+"asD c #0e080d",
+"ahM c #0e0814",
+"ahq c #0e0819",
+"#gj c #0e0833",
+".t9 c #0e0836",
+"#rU c #0e083f",
+".Vg c #0e090a",
+"aBV c #0e090e",
+"#2t c #0e0913",
+"ajZ c #0e0915",
+"ajD c #0e0917",
+".hT c #0e0922",
+"#4t c #0e0928",
+".b1 c #0e0935",
+"#eJ c #0e0942",
+"aq6 c #0e0a0d",
+"amL c #0e0a0e",
+"aP2 c #0e0a13",
+".5Q c #0e0a17",
+"#6b c #0e0a28",
+"#th c #0e0a44",
+".kg c #0e0a50",
+".kh c #0e0a52",
+"ar. c #0e0b0d",
+"alE c #0e0b0f",
+"arj c #0e0b11",
+"ahW c #0e0b12",
+"aLt c #0e0b13",
+"auJ c #0e0b18",
+"an4 c #0e0b1b",
+"adA c #0e0b1c",
+"agf c #0e0b1f",
+"ahu c #0e0b20",
+".oI c #0e0b3c",
+".Rj c #0e0b40",
+".nn c #0e0b42",
+".YB c #0e0c08",
+"apG c #0e0c11",
+"awe c #0e0c12",
+"atP c #0e0c13",
+"ar5 c #0e0c14",
+"ar6 c #0e0c15",
+"ar7 c #0e0c16",
+"anY c #0e0c17",
+".HE c #0e0c18",
+"at8 c #0e0c19",
+"an2 c #0e0c1b",
+"apJ c #0e0c1c",
+".uk c #0e0c25",
+".oM c #0e0c36",
+".T8 c #0e0c40",
+".ns c #0e0c46",
+"ar2 c #0e0d11",
+"ar3 c #0e0d12",
+"ar4 c #0e0d13",
+"asJ c #0e0d14",
+"asK c #0e0d15",
+"aBX c #0e0d16",
+"atg c #0e0d17",
+"anX c #0e0d18",
+"aEW c #0e0d19",
+"aDE c #0e0d1b",
+"amV c #0e0d1c",
+"amW c #0e0d1d",
+"#X. c #0e0d21",
+"agi c #0e0d24",
+".ui c #0e0d25",
+".LD c #0e0d27",
+".sS c #0e0d29",
+"#te c #0e0d3b",
+"#md c #0e0d3d",
+"#nG c #0e0d3e",
+"#oZ c #0e0d40",
+"#hL c #0e0d41",
+".lQ c #0e0d42",
+".e3 c #0e0d46",
+".Eh c #0e0e0d",
+"atf c #0e0e12",
+"atX c #0e0e13",
+"atV c #0e0e14",
+"aCg c #0e0e15",
+"azK c #0e0e16",
+"aAZ c #0e0e17",
+"aAY c #0e0e18",
+"aCf c #0e0e19",
+"aDG c #0e0e1a",
+"agc c #0e0e1e",
+"#D6 c #0e0e2b",
+"#IF c #0e0e31",
+"#qm c #0e0e38",
+"#nH c #0e0e3c",
+"#mh c #0e0e3d",
+".#X c #0e0e41",
+".Un c #0e0e48",
+".SC c #0e0e4f",
+"awg c #0e0f15",
+"ayt c #0e0f16",
+"aAV c #0e0f19",
+"alQ c #0e0f20",
+".38 c #0e0f3c",
+"Qt. c #0e0f41",
+".GX c #0e0f44",
+".by c #0e0f46",
+".MK c #0e0f47",
+"#eN c #0e0f49",
+".Rh c #0e0f4b",
+".iZ c #0e0f51",
+"azR c #0e1016",
+".c1 c #0e1037",
+".5G c #0e103c",
+"#hN c #0e103e",
+".XI c #0e104a",
+"aIW c #0e1119",
+".bp c #0e1138",
+".Q9 c #0e113d",
+".Pz c #0e113e",
+".Ob c #0e1143",
+".Iy c #0e1144",
+".0T c #0e1148",
+".l5 c #0e1151",
+"aMo c #0e1219",
+".N3 c #0e123d",
+".Za c #0e124a",
+".XB c #0e124d",
+".o5 c #0e124e",
+".Uc c #0e1250",
+".2o c #0e1345",
+".0L c #0e1348",
+"#Ud c #0e142b",
+"awp c #0e1a37",
+".FT c #0f0000",
+".Ru c #0f0001",
+"a#A c #0f0002",
+"#Cm c #0f0017",
+"#rZ c #0f0022",
+"au0 c #0f0101",
+"#8i c #0f0102",
+".L6 c #0f0200",
+"#gm c #0f0201",
+"acA c #0f0300",
+"axZ c #0f0303",
+"aCE c #0f0305",
+"aHC c #0f0308",
+"adr c #0f030b",
+"ayM c #0f030d",
+"ayW c #0f0310",
+"#r0 c #0f0327",
+"aj4 c #0f0401",
+".CL c #0f0402",
+".CK c #0f0404",
+"atz c #0f0406",
+".01 c #0f0407",
+"ap4 c #0f0408",
+"agB c #0f0409",
+".Hr c #0f0414",
+"agw c #0f0423",
+"#qB c #0f0429",
+".f# c #0f050b",
+"ab0 c #0f050d",
+"aPv c #0f050e",
+".EQ c #0f0600",
+"aj1 c #0f0605",
+".zv c #0f0608",
+"ady c #0f0609",
+"aMe c #0f060c",
+"#PY c #0f0612",
+"#Fk c #0f0613",
+"#M6 c #0f061a",
+".Oj c #0f061e",
+"#6# c #0f0620",
+"#eP c #0f0623",
+".AB c #0f062a",
+".DV c #0f0635",
+"ak6 c #0f0707",
+".Ey c #0f0709",
+"al7 c #0f070d",
+"aBm c #0f0710",
+"aE0 c #0f0711",
+"#4s c #0f0724",
+"agx c #0f0725",
+"#bp c #0f073e",
+".02 c #0f080b",
+".Gi c #0f080d",
+".PX c #0f080e",
+".LF c #0f080f",
+"aKe c #0f0812",
+"#SV c #0f0813",
+".XN c #0f0815",
+".Ho c #0f0817",
+"ayI c #0f081a",
+".A6 c #0f0909",
+".A7 c #0f090a",
+"aq. c #0f090c",
+".0X c #0f0910",
+"azD c #0f0914",
+"akF c #0f0915",
+"#Lr c #0f091b",
+"#7O c #0f0922",
+"#a. c #0f0925",
+"#Uf c #0f0927",
+"#2K c #0f0928",
+"#J7 c #0f092f",
+".s0 c #0f0933",
+"#qt c #0f0940",
+".Gm c #0f0a06",
+"ax5 c #0f0a0d",
+".G# c #0f0a0e",
+"aNd c #0f0a0f",
+"aQj c #0f0a15",
+"akH c #0f0a18",
+"aHu c #0f0a1b",
+".xv c #0f0a22",
+"#a# c #0f0a2e",
+"#tm c #0f0a36",
+"#o8 c #0f0a40",
+".l8 c #0f0a48",
+"aAC c #0f0b0f",
+"arO c #0f0b10",
+"arP c #0f0b11",
+"aO2 c #0f0b14",
+"aan c #0f0b16",
+".4h c #0f0b19",
+".2B c #0f0b1a",
+"aiz c #0f0b1c",
+".zr c #0f0b2f",
+".VV c #0f0b36",
+"amH c #0f0c10",
+"aqs c #0f0c12",
+"auA c #0f0c13",
+".F4 c #0f0c17",
+"alM c #0f0c19",
+"amT c #0f0c1a",
+"ajF c #0f0c1b",
+"an6 c #0f0c1c",
+"#rV c #0f0c40",
+"#tg c #0f0c42",
+"ax7 c #0f0d11",
+"anP c #0f0d12",
+"axc c #0f0d17",
+"anW c #0f0d18",
+"anV c #0f0d19",
+"aqG c #0f0d1c",
+"an5 c #0f0d1d",
+".7c c #0f0d42",
+".nl c #0f0d43",
+".nq c #0f0d47",
+".ki c #0f0d50",
+"aN8 c #0f0e11",
+"atc c #0f0e12",
+"atY c #0f0e14",
+"atZ c #0f0e15",
+"at0 c #0f0e16",
+"at1 c #0f0e17",
+"aAT c #0f0e18",
+"ati c #0f0e19",
+"aCe c #0f0e1a",
+"aDF c #0f0e1b",
+"aGb c #0f0e1d",
+"aHA c #0f0e1e",
+"#nF c #0f0e42",
+"#m. c #0f0e43",
+".Ue c #0f0e49",
+".l0 c #0f0e4d",
+"awJ c #0f0f15",
+"azL c #0f0f16",
+"azJ c #0f0f18",
+"aEV c #0f0f1c",
+"ahn c #0f0f1e",
+"#o0 c #0f0f3a",
+".DF c #0f0f3d",
+".MS c #0f0f40",
+".f5 c #0f0f4c",
+".MM c #0f0f4e",
+"aPc c #0f1014",
+"axa c #0f1015",
+"ayu c #0f1016",
+"aAW c #0f101a",
+".BK c #0f101c",
+"agk c #0f1028",
+"#Ct c #0f102b",
+".gm c #0f1036",
+"Qtb c #0f103d",
+".0M c #0f1042",
+".8Y c #0f104a",
+".eB c #0f104b",
+".hz c #0f104d",
+"az1 c #0f1119",
+".hr c #0f113b",
+".#Z c #0f113d",
+".0R c #0f113e",
+".rM c #0f1142",
+"#eM c #0f114f",
+"ayz c #0f1214",
+"#MT c #0f1230",
+".#0 c #0f1238",
+"Qtd c #0f1239",
+".c0 c #0f123b",
+".5F c #0f1241",
+".37 c #0f1243",
+".SF c #0f1245",
+".V3 c #0f124f",
+"#K# c #0f132a",
+".nH c #0f1351",
+".V1 c #0f135b",
+".f9 c #0f1449",
+"aPb c #0f1719",
+"ayC c #0f171e",
+"am9 c #0f192e",
+"aMp c #0f1b21",
+".N# c #100000",
+".Wk c #100001",
+"a#y c #100002",
+"aGL c #10000e",
+"#P4 c #100010",
+"#Ye c #100100",
+"azV c #100110",
+"#gn c #100200",
+".L5 c #100201",
+"avz c #100202",
+".Ec c #100205",
+"aQr c #10020f",
+"#OB c #100214",
+"#DU c #100217",
+".SO c #100224",
+"aM7 c #100300",
+"aot c #100306",
+".CC c #10030b",
+"#CA c #10031c",
+"#2s c #100402",
+".Zs c #100409",
+"aJu c #10040c",
+"#mu c #10040d",
+"ajX c #100410",
+"#gl c #100411",
+"ahI c #10041d",
+".xP c #100507",
+"aIQ c #100511",
+".A4 c #100512",
+"#LC c #100516",
+"#zq c #100520",
+".CN c #100600",
+"#JZ c #100617",
+"ahJ c #10061e",
+"#X# c #100620",
+"afg c #10062a",
+".i0 c #100635",
+".EN c #100702",
+".De c #100704",
+"apu c #10070b",
+"aMi c #10070d",
+"aA2 c #100711",
+"#k4 c #100715",
+"aG. c #100719",
+"#jB c #10071a",
+"#.z c #100723",
+"#3l c #100806",
+"amd c #100807",
+"#.H c #10080f",
+"aOA c #100907",
+"aP. c #10090b",
+"aDZ c #10090d",
+"a#d c #10090e",
+".XQ c #100910",
+"aPq c #100915",
+"#.G c #100918",
+"#s9 c #100937",
+"#u9 c #100939",
+"aMZ c #100a0a",
+".B# c #100a0b",
+".4i c #100a0d",
+".2C c #100a0e",
+"aix c #100a1a",
+".vI c #100a25",
+".yY c #100a26",
+".Y5 c #100a29",
+"#Fp c #100a30",
+"##3 c #100a35",
+"#nI c #100a41",
+".Gc c #100b0e",
+"aN. c #100b10",
+"#08 c #100b18",
+"aES c #100b1a",
+"aF8 c #100b1c",
+".bI c #100b47",
+"agK c #100c0e",
+"alD c #100c10",
+"aPr c #100c14",
+"alL c #100c1a",
+"ais c #100c1b",
+"#9t c #100c26",
+".88 c #100c30",
+"#M2 c #100c34",
+".oF c #100c43",
+".ac c #100c48",
+".IJ c #100d0e",
+"au6 c #100d0f",
+"aik c #100d11",
+"avc c #100d14",
+"aOb c #100d15",
+"#YC c #100d1d",
+".MV c #100d2c",
+"#bB c #100d35",
+".Lz c #100d38",
+"#qu c #100d40",
+".kC c #100d47",
+"anM c #100e13",
+"ax# c #100e15",
+"ar9 c #100e19",
+"aqC c #100e1a",
+"aqF c #100e1d",
+"aqE c #100e1e",
+".xK c #100e35",
+".B7 c #100e36",
+".Y8 c #100e3f",
+"#rS c #100e44",
+".mg c #100e46",
+".kr c #100e53",
+"aJQ c #100f11",
+"asG c #100f13",
+"axb c #100f14",
+"azt c #100f18",
+"axK c #100f19",
+"ar8 c #100f1a",
+"aEU c #100f1d",
+"#x7 c #100f36",
+"#td c #100f38",
+".DH c #100f3d",
+"#kI c #100f44",
+"#jh c #100f45",
+".MD c #100f4a",
+"axE c #101016",
+"ays c #101018",
+"aPl c #101019",
+"aAX c #10101b",
+"aGd c #10101e",
+"#db c #101038",
+"#nz c #10103d",
+"#o7 c #10103e",
+"#qs c #10103f",
+"#o6 c #101041",
+".bZ c #101042",
+".PL c #101043",
+".Le c #10104a",
+".iS c #10104e",
+"aCb c #10111c",
+".Kc c #10113b",
+"Qtl c #101148",
+"Qtk c #10114a",
+".bw c #10114b",
+"#Op c #10122c",
+"Qtc c #10123b",
+".bo c #10123e",
+".qp c #101246",
+".c7 c #10124b",
+".Ud c #10124f",
+".Xz c #101253",
+"aPn c #10131b",
+".bS c #101342",
+".J7 c #101345",
+".2p c #101346",
+".SD c #101353",
+".md c #101354",
+".hC c #101451",
+".d# c #10154a",
+".Cz c #10172f",
+".rz c #101839",
+"asd c #101f42",
+".Na c #110000",
+"a#z c #110002",
+".Ot c #110200",
+"#pa c #110227",
+"aa7 c #110300",
+".5V c #110302",
+".L4 c #110303",
+"aA5 c #11030b",
+"#jC c #11030f",
+"#zG c #110319",
+"ahO c #110402",
+"aL2 c #110404",
+".TB c #110407",
+".gE c #110409",
+"aLk c #11040b",
+"aGi c #11040d",
+"#G3 c #110410",
+"azT c #110413",
+"#.l c #110428",
+".O3 c #110500",
+"aPy c #11050c",
+"#yf c #11050f",
+"adu c #11060c",
+"#2I c #110720",
+"#u8 c #11073b",
+"#ad c #11080f",
+"#gt c #110810",
+".zs c #11081a",
+"#4r c #110821",
+".80 c #110825",
+"adV c #11082f",
+".EF c #110906",
+"ani c #11090f",
+"#PZ c #110916",
+".ku c #110929",
+"#bq c #11093f",
+".Ew c #110a09",
+"arT c #110a0f",
+"apx c #110a10",
+"aIX c #110a11",
+".Em c #110a13",
+".Zn c #110a15",
+"#eY c #110a1a",
+"#Ou c #110a1d",
+"#Ov c #110a28",
+".Ha c #110a29",
+".Ba c #110b0c",
+"aam c #110b16",
+"aET c #110b1b",
+"ayF c #110b1c",
+".rD c #110b36",
+"aNg c #110c11",
+"ahr c #110c1e",
+"#eV c #110c31",
+"#mi c #110c42",
+".Q3 c #110c48",
+".eL c #110c49",
+"aft c #110d10",
+"akx c #110d11",
+"amK c #110d12",
+"apm c #110d13",
+"aOs c #110d17",
+".pS c #110d1b",
+".LE c #110d1c",
+".DX c #110d1d",
+"age c #110d20",
+".ox c #110d23",
+".Ps c #110d49",
+".CF c #110e0d",
+".CG c #110e0e",
+"atK c #110e10",
+".H3 c #110e11",
+"aqr c #110e14",
+"akI c #110e1c",
+"aeX c #110e23",
+".DN c #110e32",
+".G0 c #110e41",
+"#u4 c #110e42",
+".no c #110e45",
+".NX c #110e49",
+"anL c #110f14",
+"axA c #110f16",
+"axJ c #110f18",
+"ars c #110f1a",
+"at2 c #110f1b",
+"akJ c #110f1e",
+"agg c #110f24",
+"aeY c #110f25",
+".B2 c #110f37",
+".vX c #110f38",
+".o8 c #110f43",
+"#.x c #110f44",
+"#hB c #110f46",
+"av8 c #111018",
+"ayb c #111019",
+"aqB c #11101b",
+"aGc c #11101f",
+".Od c #11103f",
+".ka c #111043",
+"#jp c #111044",
+"#jq c #111045",
+"#o5 c #111046",
+".np c #111049",
+".dy c #11104a",
+"axF c #111117",
+"aI# c #11111a",
+"aC. c #11111c",
+".kI c #111132",
+"#m# c #111140",
+".Fi c #111144",
+".f7 c #11114f",
+"azH c #11121b",
+"aC# c #11121d",
+".Zc c #111247",
+".#6 c #111249",
+".bx c #11124a",
+".PN c #11124b",
+".Y1 c #111327",
+".cZ c #11133f",
+".iP c #111346",
+".Zi c #11134b",
+".kA c #111355",
+".Lt c #111446",
+".f8 c #111451",
+".Lq c #111454",
+".cb c #111539",
+".In c #11153f",
+".eE c #111552",
+".MO c #111555",
+".#9 c #11164b",
+"Qtq c #11164c",
+".aa c #111659",
+".zq c #11183c",
+".bF c #11195b",
+".vW c #111a44",
+"adJ c #112650",
+".NB c #112752",
+"#41 c #120000",
+".Ns c #120105",
+"aKb c #12020a",
+"#Z3 c #120217",
+".Bc c #120300",
+".Dc c #120400",
+".L3 c #120405",
+".L2 c #120406",
+".eX c #120423",
+".r2 c #120500",
+"#42 c #120505",
+"aHy c #120519",
+"aOS c #120602",
+"ak9 c #120806",
+"#6H c #120808",
+"adv c #12080c",
+".dL c #12081c",
+".CS c #120900",
+"aOk c #120907",
+".ED c #12090b",
+".Zr c #12090e",
+"#go c #120910",
+"aKd c #120913",
+"aQe c #120915",
+".8W c #12092d",
+".AL c #120936",
+"Qtz c #120937",
+"#J6 c #120a28",
+".C. c #120a37",
+".Ev c #120b09",
+"aEA c #120b10",
+".Gg c #120b14",
+"aP3 c #120b15",
+"akE c #120b17",
+"ajC c #120b18",
+"agA c #120b19",
+"aiw c #120b1a",
+"#IC c #120b28",
+"ab2 c #120c13",
+"aO3 c #120c15",
+".up c #120c36",
+"#.y c #120c37",
+"#kU c #120c43",
+".Gd c #120d0f",
+".jb c #120d20",
+".XM c #120d24",
+".Y6 c #120d32",
+"aiZ c #120e11",
+"as1 c #120e14",
+"aPf c #120e17",
+"aQh c #120e19",
+".0W c #120e20",
+"#Lw c #120e36",
+"#c1 c #120e44",
+".lW c #120e50",
+"aq7 c #120f11",
+"ate c #120f15",
+"amj c #120f16",
+"aAS c #120f1a",
+"aht c #120f23",
+".T7 c #120f3e",
+"#nJ c #120f43",
+".ni c #120f45",
+"#ey c #120f4a",
+"azo c #121013",
+"aPT c #121014",
+"aoQ c #121015",
+"axI c #121018",
+"arr c #12101b",
+"aqA c #12101c",
+"agh c #121026",
+".qb c #121039",
+".qq c #121041",
+"#dd c #121044",
+"axH c #121117",
+"av7 c #121119",
+"aFX c #12111a",
+"ath c #12111c",
+"aar c #12111f",
+"aHB c #121120",
+".A0 c #12112f",
+".rN c #121140",
+"#qr c #121143",
+"#kP c #121145",
+"#me c #121146",
+"#kQ c #121147",
+"azI c #12121b",
+"ae0 c #121229",
+".Og c #121247",
+".XD c #121249",
+".e2 c #12124a",
+"##2 c #12124d",
+".bs c #121250",
+".hB c #121252",
+".o7 c #12134a",
+".N7 c #12134b",
+".eD c #12134e",
+".c3 c #12134f",
+".V4 c #121350",
+".eu c #121440",
+".Zh c #121444",
+"Qtn c #121447",
+".Iq c #121448",
+".Zj c #12144e",
+".jc c #121537",
+".oW c #12154a",
+".d. c #121552",
+".Rc c #121555",
+"aQc c #121611",
+".eV c #121645",
+".bA c #121653",
+".J5 c #121656",
+"aQm c #12171e",
+"aIV c #12171f",
+".xJ c #121a42",
+".A1 c #121b37",
+".gn c #121b44",
+".zp c #121c3e",
+".xI c #121e42",
+".vV c #121f45",
+"agm c #121f46",
+".YC c #122549",
+".Ow c #130000",
+"aQy c #13000b",
+"aH7 c #13000f",
+"arJ c #130100",
+"#DS c #130114",
+".Vf c #130200",
+"aIH c #13020b",
+"#Fy c #13030f",
+"QtK c #130424",
+"azU c #130514",
+"#AU c #13051d",
+".pk c #130600",
+"aqX c #130608",
+"acz c #130700",
+"aPN c #130702",
+"aP6 c #130712",
+".PQ c #130723",
+".xS c #13080a",
+".CU c #130903",
+".gD c #130910",
+".Az c #130936",
+".eM c #130938",
+".CR c #130a00",
+"am4 c #130a0f",
+".7o c #130a11",
+".9# c #130a12",
+".MX c #130a16",
+".rF c #130a1f",
+"#2J c #130a26",
+".s1 c #130a2c",
+".gy c #130a2f",
+".gf c #130a38",
+"afr c #130b09",
+"#bQ c #130b12",
+"aOq c #130b16",
+"ajB c #130b18",
+"aiv c #130b19",
+".Uq c #130b1b",
+"#df c #130b27",
+"#G8 c #130b29",
+".gp c #130b3b",
+".Gj c #130c0e",
+"aoJ c #130c12",
+"aPs c #130c15",
+"aO4 c #130c16",
+"aQs c #130c18",
+"#Lt c #130c1a",
+"ahp c #130c1c",
+"#Fo c #130c2a",
+"#ge c #130c4f",
+"asC c #130d12",
+"aDk c #130d13",
+".FP c #130d1d",
+".zb c #130d29",
+"#jt c #130d44",
+".Ge c #130e10",
+"aN# c #130e13",
+"aQo c #130e16",
+"#wt c #130e32",
+".p1 c #130e44",
+".dg c #130e4a",
+"atH c #130f12",
+"aeO c #130f13",
+"ayp c #130f19",
+"aiA c #130f21",
+"#x2 c #130f29",
+"#gr c #130f33",
+".j6 c #130f36",
+"ax2 c #131011",
+"atF c #131012",
+"ajG c #131020",
+".rC c #13103f",
+".oG c #131045",
+"#eA c #13104c",
+".lV c #131051",
+"apF c #131116",
+"atR c #131117",
+"axD c #131118",
+"atC c #131119",
+"aya c #13111b",
+"aqz c #13111c",
+".q. c #13113b",
+".MR c #131140",
+"#mj c #131144",
+"#gi c #131146",
+"#mf c #131147",
+".nv c #13114b",
+"axG c #131217",
+"awy c #13121a",
+".t. c #13123e",
+"#kJ c #131243",
+"#hJ c #131246",
+"#hK c #131248",
+".Ek c #131312",
+"ayr c #13131c",
+"aCa c #13131e",
+"#wz c #13133a",
+".uy c #13133e",
+".Oe c #131345",
+".Z. c #13134a",
+"#bC c #13134e",
+".#2 c #131353",
+".iU c #131354",
+".Ld c #131447",
+".Xy c #131453",
+".fX c #131541",
+".JW c #131548",
+".hv c #131549",
+".PC c #13154c",
+".Zb c #13154d",
+".XC c #13154f",
+"#Cr c #131629",
+".am c #131645",
+".Ii c #131648",
+".PG c #13164e",
+".Oa c #13164f",
+"Qto c #131653",
+".O. c #131656",
+".PF c #131657",
+".SE c #13174f",
+".Rd c #131754",
+".Ua c #131760",
+".eK c #13185b",
+"aBj c #14000e",
+"axo c #140100",
+".Nb c #140200",
+"#8h c #140201",
+"aIO c #14030c",
+"#DT c #14041a",
+"#6G c #140500",
+"aHz c #140519",
+".Bd c #140600",
+"aLu c #14060f",
+"aQz c #140610",
+"#Fj c #140611",
+".AV c #140618",
+".ds c #140625",
+"#eR c #140706",
+".2G c #140708",
+"ap3 c #14070a",
+"#1m c #140719",
+"#Ug c #14071e",
+"ads c #140810",
+"aIP c #140813",
+"#eQ c #140815",
+"aPh c #140816",
+"aHx c #14081b",
+"#tk c #14083d",
+"aH5 c #14090d",
+"aCm c #140912",
+"aP5 c #140914",
+"aA4 c #140a11",
+".zz c #140b0d",
+"aou c #140b11",
+"ab1 c #140b13",
+"aP4 c #140b15",
+"aO5 c #140b16",
+"ajA c #140b17",
+"#YD c #140b1f",
+"#gk c #140b27",
+"##N c #140b2e",
+".vF c #140b36",
+".FA c #140b3b",
+".Gh c #140c14",
+".oZ c #140c2c",
+".dw c #140c35",
+"aqe c #140d11",
+".vl c #140d22",
+".DW c #140d2f",
+".rk c #140d47",
+"ayo c #140e18",
+"#Iy c #140e1c",
+"#gq c #140e2a",
+".dz c #140e40",
+"azk c #140f12",
+".z9 c #140f15",
+"aQf c #140f1a",
+"#nT c #140f1e",
+"Qty c #140f4b",
+"aBW c #141014",
+"#Lo c #141027",
+".Ax c #141032",
+".j5 c #141036",
+"#gf c #14104e",
+"ar1 c #141116",
+"ak. c #141118",
+"ajH c #141122",
+"au3 c #14121a",
+"arq c #14121d",
+"aeZ c #141229",
+".NW c #141246",
+"ayq c #14131c",
+"ajI c #141325",
+"#ji c #141345",
+"#hC c #141346",
+".Y9 c #141348",
+"aB9 c #14141f",
+"aDA c #141420",
+".DC c #141442",
+".MC c #141447",
+".nJ c #14144e",
+".7b c #14144f",
+".N9 c #141452",
+".J4 c #141454",
+".bQ c #14153b",
+".GU c #14154a",
+".Uk c #14154b",
+".J2 c #14154d",
+".c9 c #14154e",
+".c4 c #141550",
+".bt c #141552",
+".MN c #141555",
+".hq c #141642",
+".J1 c #141649",
+".#8 c #14164a",
+".f1 c #14164c",
+".ny c #141653",
+".Ix c #141750",
+".Lr c #141754",
+".O# c #141755",
+".Iv c #141757",
+".U# c #14175d",
+".J6 c #141855",
+"aQg c #141c23",
+"aub c #141c35",
+".dd c #141c5e",
+".P0 c #150000",
+"aC0 c #150100",
+"aQv c #150110",
+".N. c #150200",
+"aQw c #150210",
+".Nc c #150300",
+"#Vh c #150303",
+"#mv c #150407",
+"anh c #150505",
+"aPB c #15050e",
+"aMr c #15050f",
+"azY c #150514",
+"#qA c #150529",
+".r1 c #150600",
+"#ZF c #150706",
+"apf c #150708",
+".PR c #15071c",
+"aFh c #150806",
+"aLd c #15080f",
+"aNn c #150811",
+"aiX c #150905",
+"adt c #150910",
+"aPt c #150a14",
+"#JY c #150a1b",
+"aG# c #150a1d",
+"aP# c #150b0b",
+"az5 c #150b1d",
+"adx c #150c0f",
+"#G4 c #150c19",
+"#uU c #150c2c",
+".uq c #150c2e",
+"#ac c #150d1d",
+".xL c #150d22",
+".5C c #150d26",
+".rE c #150d2e",
+"#gc c #150d34",
+"#6f c #150e0d",
+"aF9 c #150f20",
+"#Lq c #150f23",
+".yW c #150f2b",
+"at# c #151015",
+"aPd c #151017",
+"adz c #151021",
+".zc c #151025",
+".Xw c #151039",
+".DK c #15103f",
+".DJ c #151041",
+".Ss c #151045",
+"ahs c #151123",
+".Q2 c #151145",
+"azq c #151216",
+".Aw c #151233",
+"#Fq c #151239",
+"#kV c #151246",
+"#ez c #151252",
+"arZ c #151318",
+".II c #15131c",
+"aHk c #15131d",
+"#wB c #151343",
+"#bD c #151348",
+".nr c #15134d",
+"au4 c #15141c",
+"aED c #15141d",
+".ug c #15142d",
+"#f8 c #151450",
+"asH c #151518",
+".mf c #151551",
+".#3 c #151555",
+"Qtg c #151556",
+".iN c #151643",
+"#f9 c #151644",
+".hw c #15164b",
+".bz c #15164c",
+".R# c #15164e",
+".ey c #151750",
+".5L c #15183a",
+".Ls c #151850",
+".Iw c #151856",
+".nx c #151953",
+".gc c #151b5d",
+".hN c #151f47",
+".Uy c #160000",
+"#Xa c #16001b",
+".Rv c #160100",
+".Ut c #160300",
+".L9 c #160303",
+"aDM c #16030b",
+".rZ c #160400",
+".R6 c #160404",
+"#Hf c #16040e",
+".SP c #16041e",
+"azZ c #160515",
+"aKc c #16060f",
+"aPC c #160610",
+".Ux c #160709",
+".qE c #160800",
+"aDJ c #160814",
+".4l c #160908",
+"aCl c #160914",
+".Ct c #16091a",
+".vv c #160924",
+"aIY c #160a0f",
+"aGa c #160a1d",
+"agH c #160b09",
+".EB c #160c12",
+"#wp c #160c22",
+".zw c #160d0f",
+"aiu c #160d1a",
+".qi c #160d21",
+"##4 c #160d2a",
+".Cj c #160d3c",
+".t7 c #160d49",
+"aOj c #160e09",
+".Ez c #160e10",
+"aqg c #160e14",
+"aGh c #160e15",
+".8V c #160e25",
+".m. c #160e2e",
+".qh c #160e2f",
+"#c9 c #160e35",
+".eW c #160e3f",
+"aqa c #160f13",
+".Xu c #160f31",
+"#.w c #160f34",
+"aqc c #161014",
+"at. c #161015",
+".C# c #161038",
+"#eO c #16103b",
+".gx c #16103c",
+"aOu c #16111a",
+"aPg c #16111c",
+".E. c #161125",
+".Zm c #161126",
+".T2 c #16114d",
+"ara c #161215",
+"aPk c #16121c",
+".p3 c #16123e",
+"au5 c #161315",
+"axB c #16131a",
+".Cy c #16132c",
+".Xx c #161341",
+".oJ c #161342",
+".qf c #161346",
+"#ju c #161347",
+"aqq c #161419",
+"awH c #16141b",
+"axs c #16141c",
+"azF c #16141d",
+".je c #161430",
+".oN c #161446",
+"#hM c #161447",
+"ayc c #16151e",
+".rx c #161536",
+"#wA c #161540",
+".kb c #16154a",
+".VX c #16154b",
+".Fj c #161649",
+".kB c #161652",
+".It c #161655",
+".i6 c #16173d",
+".au c #161741",
+".f2 c #16174e",
+".me c #161751",
+".Ij c #161756",
+"#DZ c #16182d",
+".hD c #161a54",
+"aCS c #161c3c",
+".P1 c #170000",
+".Ng c #170100",
+".Nh c #170200",
+"aGj c #17020e",
+"#A7 c #170217",
+"#Uh c #170311",
+"aBB c #170400",
+"#It c #170511",
+"aos c #170605",
+"aKk c #17060d",
+"ap2 c #170706",
+"#k5 c #170810",
+".i5 c #170911",
+".uv c #170a17",
+".s6 c #170a18",
+".hI c #170a26",
+".SX c #170b11",
+"aQq c #170b16",
+"aCk c #170b18",
+".r4 c #170c02",
+".1O c #170c0a",
+".jk c #170c11",
+"#Iw c #170c19",
+".H. c #170c46",
+"adw c #170d11",
+"#wq c #170d28",
+"##Q c #170e33",
+"aCj c #170f1c",
+".e1 c #170f38",
+".xs c #170f3a",
+".Eu c #17100d",
+"anF c #171015",
+".x# c #171028",
+".34 c #17102d",
+"azS c #17111b",
+".x. c #171128",
+".7k c #17112d",
+".rm c #171141",
+"aFl c #17120b",
+".Ga c #171215",
+".as c #17122b",
+".ne c #171230",
+"#de c #17123c",
+".Kg c #171316",
+"aOr c #17131d",
+"aqk c #171418",
+"aEQ c #171423",
+".ro c #171432",
+".Y7 c #17143f",
+"#c3 c #171442",
+"axC c #17151c",
+"axr c #17151d",
+".B6 c #17153d",
+"#tf c #171547",
+".lX c #171554",
+".ME c #171555",
+".uh c #17162e",
+".Lg c #171654",
+".Lf c #171655",
+"am6 c #171724",
+"#wO c #171728",
+".p7 c #171731",
+".Ik c #171755",
+".JX c #171756",
+"Qth c #171757",
+"#A1 c #171838",
+".nI c #171850",
+".PE c #171856",
+".o6 c #17194e",
+".SA c #171950",
+".eF c #171b55",
+".eU c #172049",
+"#40 c #180000",
+"#LD c #180008",
+".tj c #180200",
+"aQx c #180211",
+"aQu c #180212",
+"aOR c #180300",
+"#VK c #18031f",
+".Ov c #180400",
+"#zH c #180414",
+".Wg c #180500",
+"aCD c #18050b",
+"#8g c #180600",
+"#3h c #180602",
+"aE2 c #180713",
+".eO c #180912",
+".k7 c #180a11",
+".vT c #180a16",
+"#hZ c #180a18",
+".bU c #180a29",
+"aOi c #180b07",
+"aPz c #180b12",
+".Cs c #180b1a",
+".to c #180c03",
+".Ok c #180c1c",
+"#JX c #180c1e",
+"#AV c #180c23",
+".yZ c #180c36",
+".M8 c #180d0a",
+".xR c #180d0f",
+"apg c #180d11",
+".7# c #180e31",
+"ahS c #180f0d",
+".dh c #180f3d",
+".m# c #18101f",
+"alU c #18111a",
+".vY c #181128",
+".nB c #181141",
+"aPj c #18121d",
+".p0 c #18124b",
+".St c #181252",
+".Q4 c #181253",
+"aNf c #181318",
+"agd c #181326",
+".Q5 c #181352",
+".Pu c #181353",
+".Pt c #181354",
+"azf c #181415",
+"aox c #18141a",
+".hW c #181437",
+".Fp c #181445",
+".NZ c #181453",
+".NY c #181454",
+"akO c #181523",
+".0J c #181542",
+".DY c #18161a",
+".c. c #181623",
+".G5 c #181642",
+".lY c #181656",
+".oP c #181749",
+"aPo c #181821",
+"aAU c #181822",
+".b0 c #18184b",
+".Lp c #181858",
+".rr c #181924",
+".Xs c #181a3b",
+"#AZ c #181b32",
+".qo c #181b4d",
+".bB c #181c56",
+"ac. c #182d51",
+"aiG c #182d55",
+"a#v c #190000",
+".Om c #190100",
+"#1U c #190108",
+".Nf c #190300",
+".Nr c #190407",
+"aCz c #190411",
+"as0 c #190502",
+".zA c #190600",
+"asq c #190603",
+"aqW c #190604",
+".Ou c #190702",
+"aIZ c #19080d",
+"aHs c #19080f",
+"aE3 c #190813",
+".Bo c #19090c",
+"aOe c #190910",
+".03 c #190a0d",
+"agC c #190b08",
+"am2 c #190b0c",
+".gh c #190b14",
+".rJ c #190b1b",
+".nX c #190c03",
+"am3 c #190c0f",
+".AU c #190c1b",
+".5W c #190d0d",
+".CW c #190d0e",
+".v3 c #190d10",
+"aPa c #190e0e",
+".dK c #190f23",
+".VO c #190f32",
+"ait c #19101d",
+".s2 c #191026",
+".EI c #191108",
+".G7 c #19113a",
+".i8 c #191142",
+"#eH c #191145",
+".sG c #19114c",
+"aC3 c #191214",
+".dI c #19131c",
+".8Z c #19133e",
+".e4 c #191346",
+".7d c #19143e",
+".DL c #191440",
+"#d# c #191444",
+"avD c #191518",
+".DM c #19153e",
+"atJ c #191619",
+"azQ c #19171d",
+"aDI c #191723",
+"aAH c #191821",
+".G6 c #191843",
+".LA c #191846",
+"#x5 c #191a37",
+".Fh c #191a4c",
+".jd c #191b3f",
+"ae4 c #191c37",
+".4c c #191c44",
+".rL c #191c4c",
+"Qtp c #191d57",
+".0c c #192a4d",
+".Mj c #192f5c",
+"#XI c #1a0000",
+"aOy c #1a0008",
+"aKl c #1a0109",
+".M0 c #1a0200",
+"aFg c #1a0309",
+".Ne c #1a0400",
+"#IM c #1a040b",
+"ap1 c #1a0501",
+"#YE c #1a051f",
+"aFA c #1a0600",
+"aE4 c #1a0712",
+"aPi c #1a0718",
+".kD c #1a0923",
+"aJ7 c #1a0a12",
+".mh c #1a0a23",
+".xG c #1a0b16",
+".h3 c #1a0c0f",
+".dn c #1a0c14",
+".D5 c #1a0c1e",
+".qm c #1a0c1f",
+".ao c #1a0c2b",
+".xg c #1a0c36",
+".C1 c #1a0e0a",
+".v2 c #1a0e10",
+"aOv c #1a0e18",
+".CJ c #1a0f10",
+".xM c #1a0f11",
+".T0 c #1a0f3a",
+"##P c #1a0f3c",
+".G9 c #1a0f47",
+"aiY c #1a100d",
+"apr c #1a1015",
+"#tl c #1a1042",
+".BI c #1a1111",
+"#s8 c #1a113b",
+"ayn c #1a121d",
+".kv c #1a1220",
+"#x1 c #1a1232",
+".t8 c #1a1249",
+".gu c #1a1336",
+".xr c #1a1337",
+"ad9 c #1a1416",
+"aqd c #1a1417",
+".yX c #1a1430",
+".rl c #1a144a",
+".Es c #1a1510",
+"apy c #1a151a",
+"aPe c #1a151d",
+"ass c #1a161c",
+".lL c #1a163a",
+".kf c #1a175a",
+"ata c #1a181b",
+"aBY c #1a1822",
+".B3 c #1a1840",
+".oO c #1a184a",
+"azu c #1a1922",
+".Rb c #1a1a59",
+"QtP c #1a1d3f",
+".s8 c #1a1d4a",
+".hO c #1a1e4d",
+".Np c #1b0000",
+".ti c #1b0400",
+".Zq c #1b0600",
+"aD2 c #1b0702",
+"aGW c #1b0801",
+"auZ c #1b0804",
+".M9 c #1b0900",
+"aOz c #1b090d",
+".nK c #1b0b22",
+".Rm c #1b0b23",
+".Db c #1b0d00",
+".hJ c #1b0d16",
+".zj c #1b0d1f",
+".Hk c #1b0e21",
+".v4 c #1b1012",
+"aoI c #1b1015",
+".Fy c #1b1145",
+".CP c #1b1206",
+".zt c #1b1314",
+"#J5 c #1b1327",
+".vG c #1b133c",
+".hP c #1b1344",
+"aj5 c #1b1413",
+"aqb c #1b1418",
+".vE c #1b1436",
+".l9 c #1b1446",
+"ard c #1b151a",
+".0G c #1b1536",
+".2c c #1b1625",
+"#c2 c #1b1650",
+"arK c #1b181d",
+"atM c #1b181f",
+".Fr c #1b1846",
+"aJR c #1b191b",
+".Fv c #1b193f",
+".lP c #1b1a4e",
+".SB c #1b1b5a",
+".J3 c #1b1c58",
+".sY c #1b1d46",
+".Il c #1b1d53",
+".c# c #1b1f43",
+".dU c #1b264a",
+"apR c #1b265d",
+".yt c #1b2c49",
+".tg c #1c0000",
+".Nq c #1c0304",
+"aLv c #1c030d",
+"#M7 c #1c0314",
+".LI c #1c0400",
+".2F c #1c0500",
+"aOC c #1c0506",
+".00 c #1c0600",
+".Nd c #1c0601",
+".uE c #1c0700",
+"aI0 c #1c070b",
+".rY c #1c0902",
+".zn c #1c0c14",
+".o9 c #1c0c20",
+".vt c #1c0d35",
+".qD c #1c0e05",
+".o4 c #1c0e24",
+".gg c #1c0f2a",
+".0a c #1c1006",
+".CY c #1c1014",
+"aDK c #1c1019",
+".uD c #1c1100",
+".C4 c #1c1104",
+".CT c #1c1209",
+".CM c #1c120d",
+"#bu c #1c1212",
+"aMf c #1c1219",
+"aOp c #1c121e",
+"#.n c #1c1224",
+".ad c #1c1241",
+".CO c #1c1309",
+".EO c #1c130d",
+"apt c #1c1318",
+"aNC c #1c131f",
+".2j c #1c132b",
+".AK c #1c133e",
+".EM c #1c140e",
+"aov c #1c151c",
+"aQp c #1c151e",
+"aho c #1c1525",
+".DR c #1c1633",
+".ng c #1c1835",
+"aPp c #1c1923",
+"arW c #1c1a1e",
+".N0 c #1c1a52",
+".p9 c #1c1b44",
+".MF c #1c1b52",
+".T3 c #1c1b56",
+".Lh c #1c1c53",
+".Fl c #1c1d4f",
+".GV c #1c1d52",
+"QtI c #1c204f",
+"aQl c #1c2128",
+".Ni c #1d0000",
+"#CB c #1d0316",
+"#0z c #1d070a",
+"#3g c #1d0800",
+".Cx c #1d0907",
+".rX c #1d0a03",
+"#Fi c #1d0a14",
+".AZ c #1d0b0e",
+"#Ck c #1d0b17",
+".Br c #1d0d04",
+".qr c #1d0d1f",
+".pl c #1d0f06",
+".D6 c #1d0f23",
+".qG c #1d1007",
+".C0 c #1d110f",
+".h2 c #1d1218",
+"aOt c #1d121f",
+"#J0 c #1d1323",
+"##O c #1d133f",
+"#.o c #1d141e",
+".EH c #1d150d",
+".nC c #1d1525",
+".0F c #1d1530",
+".sH c #1d154c",
+"#gd c #1d154f",
+"#Fn c #1d1629",
+"#.v c #1d1631",
+"#eI c #1d1652",
+"aBD c #1d1719",
+"#br c #1d1742",
+".Su c #1d1851",
+".As c #1d193b",
+".Pv c #1d1951",
+"asI c #1d1b20",
+".2d c #1d1b26",
+".sK c #1d1b33",
+".rs c #1d1b3d",
+".Fs c #1d1b46",
+".hV c #1d1e48",
+".GS c #1d1e53",
+".VS c #1d1f4d",
+".cd c #1d2245",
+"aKT c #1d2b4d",
+".Ab c #1d2e4b",
+"#A8 c #1e000f",
+"#VL c #1e0013",
+".Nj c #1e0100",
+".Rw c #1e0300",
+"aOD c #1e0608",
+"aJt c #1e0708",
+"aOE c #1e070a",
+"aI1 c #1e070b",
+".D9 c #1e0902",
+"aOw c #1e0914",
+"#DR c #1e0b14",
+"aQi c #1e0d1d",
+".Bb c #1e0f07",
+".gF c #1e0f12",
+".i1 c #1e0f18",
+".rO c #1e0f1d",
+".nG c #1e0f28",
+"aPA c #1e1018",
+".i9 c #1e1030",
+".tn c #1e1108",
+"#zp c #1e1129",
+".mu c #1e1208",
+".v5 c #1e1214",
+".C5 c #1e1304",
+"aoH c #1e1318",
+".vM c #1e1319",
+".EE c #1e1515",
+"aJ6 c #1e151b",
+"#gp c #1e1726",
+".xu c #1e1737",
+".Fw c #1e173c",
+".Gk c #1e1817",
+".na c #1e1937",
+"azh c #1e1a1c",
+".pT c #1e1a28",
+"asE c #1e1b1f",
+"agQ c #1e1b22",
+".0I c #1e1b46",
+".lT c #1e1c58",
+".DG c #1e1e4c",
+".aE c #1e1f2e",
+"#AX c #1e2134",
+"#WM c #1e2234",
+".ce c #1e2246",
+".fn c #1e2345",
+"#3U c #1e283d",
+".O1 c #1f0000",
+".O2 c #1f0100",
+"aOf c #1f060e",
+"aE5 c #1f0613",
+".Rp c #1f0700",
+"asZ c #1f0701",
+"arI c #1f0a06",
+"aHD c #1f0c14",
+".pA c #1f0d0c",
+".SY c #1f0e10",
+".TA c #1f0e12",
+".r0 c #1f0f07",
+"#Cl c #1f0f23",
+"#pg c #1f100f",
+"aCn c #1f1017",
+".t# c #1f101c",
+".mc c #1f102b",
+".kR c #1f1109",
+"aLe c #1f1219",
+".bP c #1f121a",
+".Hj c #1f1224",
+"#.m c #1f1230",
+".Xo c #1f152a",
+".bJ c #1f1544",
+"#7T c #1f1613",
+".o0 c #1f1627",
+".ur c #1f162d",
+"#M1 c #1f172b",
+".z. c #1f173e",
+"QtJ c #1f1747",
+"aL. c #1f181d",
+".3V c #1f1829",
+"#d. c #1f1848",
+".Xv c #1f193d",
+"#ga c #1f1a1d",
+".lI c #1f1a3e",
+"aq2 c #1f1b21",
+".p4 c #1f1c42",
+"#cZ c #1f1d40",
+".oL c #1f1d47",
+".nm c #1f1d54",
+".ke c #1f1d5c",
+"#t# c #1f1e46",
+".GW c #1f2055",
+".Ir c #1f2058",
+".ca c #1f2346",
+"aKm c #200109",
+".Nk c #200400",
+".yn c #200800",
+"#Ui c #200810",
+"aBd c #200817",
+"#1n c #200b21",
+".kz c #20102c",
+"aE1 c #20121e",
+".eS c #20131b",
+"aPu c #20131d",
+".C2 c #20140d",
+"ak2 c #20141b",
+".kH c #201630",
+".e5 c #201641",
+".EG c #201812",
+".VP c #201845",
+".dr c #201849",
+".yS c #201a36",
+"#uW c #201a45",
+".5t c #201b2b",
+".xq c #201c2f",
+".kj c #201f61",
+"#9. c #203057",
+".No c #210100",
+"aA7 c #21020e",
+"#D8 c #210416",
+".SS c #210900",
+".FO c #210a00",
+"aKZ c #210b03",
+".pB c #210d17",
+"aum c #210e09",
+".Bq c #211109",
+"afl c #21110d",
+".Bn c #211111",
+"#AT c #211122",
+".uL c #21120a",
+".Be c #211305",
+".CZ c #211413",
+".62 c #21141b",
+"#9y c #211610",
+".dB c #21161c",
+".dA c #211642",
+".2i c #211728",
+"#.D c #211929",
+".AC c #211935",
+".rc c #211d23",
+".j8 c #211d44",
+"#Kd c #220107",
+".Ve c #220300",
+"aOg c #22040b",
+"#zI c #220915",
+".5U c #220a00",
+"asp c #220b06",
+"aAl c #220f08",
+".gq c #221433",
+".CX c #221619",
+"#wr c #22183b",
+".AA c #221842",
+".f. c #221920",
+"azC c #221a26",
+".Et c #221b18",
+".oy c #221d33",
+".DD c #22214f",
+".Fk c #222255",
+"#1# c #22364e",
+"aFk c #230000",
+"aB. c #23000d",
+".Nl c #230600",
+"ang c #230a02",
+".Hn c #230b00",
+".BD c #230f00",
+".ja c #231108",
+".2I c #231112",
+"az0 c #23121e",
+".kS c #23130b",
+".FL c #231529",
+".Bg c #231602",
+".Bl c #231606",
+".D4 c #231624",
+"afq c #231814",
+".G8 c #231949",
+"aIG c #231a20",
+".DS c #231c40",
+"atN c #232027",
+".K0 c #233867",
+"#Rv c #24000b",
+"a#u c #240100",
+"#6F c #240200",
+"#0y c #240300",
+".P2 c #240600",
+"aMs c #240612",
+"aOo c #240615",
+"aNo c #240a14",
+"aty c #24110d",
+".mw c #24140c",
+".fi c #24141b",
+"aNH c #241423",
+".tm c #24150d",
+".Bm c #241510",
+".vu c #241539",
+"aNG c #241624",
+".qF c #24170e",
+"aLi c #24171e",
+".Bh c #241802",
+".r3 c #24180e",
+"a#e c #24180f",
+".jC c #24181a",
+"aoG c #24191e",
+".fa c #24191f",
+".TZ c #241937",
+"aHi c #241b21",
+".7. c #241b30",
+".b2 c #241b40",
+".hX c #241c38",
+"aNe c #241f24",
+".u. c #241f41",
+".Cb c #24203c",
+"atL c #242123",
+".G3 c #242250",
+".kJ c #242642",
+".dT c #242a42",
+".cg c #242c4d",
+"aa6 c #250000",
+"aB# c #25000f",
+"aBc c #250013",
+"#YF c #25001b",
+"#1T c #250100",
+"aOh c #25020a",
+".7s c #250500",
+"aA6 c #250613",
+".Nn c #250900",
+".Nm c #250901",
+".tK c #250e00",
+".mM c #251524",
+"#eS c #25170e",
+".xC c #251729",
+".BH c #251814",
+".kQ c #251a10",
+"##8 c #251c24",
+"aL# c #251e24",
+"aJS c #251e25",
+".xf c #251e36",
+"aw2 c #25232b",
+".dS c #252536",
+".cf c #25294d",
+"#9U c #260000",
+"#Xb c #260019",
+"#OC c #260112",
+".9m c #260200",
+".uF c #260300",
+"aKn c #26040c",
+"aA9 c #260412",
+"aOl c #260610",
+"aA8 c #260613",
+"aGk c #260f1c",
+".e0 c #26111e",
+"ad1 c #261611",
+".k9 c #261628",
+"#.k c #26193a",
+".Bi c #261a02",
+".Hg c #261a21",
+".CV c #261b18",
+".VN c #261b30",
+".y0 c #261b41",
+".Fz c #261c53",
+".T1 c #261d54",
+"#c6 c #261e1f",
+".gC c #261e27",
+"#bo c #261f4d",
+"aNE c #26202b",
+".rj c #262128",
+".2m c #262145",
+".0z c #262333",
+".dR c #262430",
+".aD c #262634",
+"ajN c #26395c",
+".O0 c #270503",
+".3t c #27151e",
+".Bp c #27161c",
+".nY c #271810",
+".AW c #27192d",
+"agG c #271a16",
+".gl c #271a22",
+".Bj c #271b05",
+"#Lv c #271f33",
+".gT c #272034",
+".y9 c #27223b",
+"aEE c #27262f",
+"aBt c #272d4e",
+".sW c #27304c",
+".EZ c #273f6d",
+"#VM c #280009",
+"aBb c #280211",
+".9k c #280300",
+"#Z4 c #280923",
+".z0 c #280f00",
+".Da c #281a0d",
+".mv c #281a11",
+".xD c #281a2e",
+"#yg c #281b2e",
+".eN c #281b37",
+"#bx c #281f37",
+".bT c #282050",
+".AM c #282146",
+"aAy c #282226",
+"aoK c #282429",
+".nd c #282441",
+"apE c #28262b",
+".DQ c #282643",
+".hY c #282939",
+".GC c #283e69",
+".Ox c #290000",
+"#8f c #290700",
+"aJI c #29140c",
+".mN c #291929",
+".Bt c #291a0c",
+".qC c #291a11",
+".Cu c #291c2f",
+".C3 c #291d13",
+"#.j c #291e33",
+".Fx c #29204c",
+".5B c #292138",
+"aND c #29222d",
+"apA c #29262a",
+"atO c #29262d",
+".u# c #29273c",
+".fm c #292b40",
+".cc c #292d51",
+".fo c #29315f",
+".Ia c #293d66",
+"aOn c #2a0616",
+".v. c #2a0d00",
+".u7 c #2a1200",
+".wh c #2a1408",
+".qU c #2a141a",
+".BC c #2a1601",
+".zB c #2a1705",
+"#2P c #2a1719",
+".Yz c #2a1809",
+".fb c #2a1a21",
+".dj c #2a1b24",
+"aaT c #2a1d12",
+".tp c #2a1f15",
+"aEf c #2a2124",
+".e9 c #2a222a",
+"QtZ c #2a2b3b",
+"avX c #2a3857",
+".1P c #2a395a",
+"#2z c #2a4a6c",
+"#0T c #2b0000",
+".6A c #2b0600",
+".nN c #2b1508",
+".XT c #2b1718",
+".Bk c #2b1f0a",
+"#xY c #2b1f2f",
+".C6 c #2b2111",
+"#M0 c #2b2330",
+".gU c #2b2543",
+"axt c #2b2931",
+".rA c #2b3158",
+".ul c #2b354d",
+".ys c #2b364d",
+"aJC c #2b385a",
+".Jv c #2b4070",
+"#0U c #2c0000",
+"#M8 c #2c000b",
+"#P5 c #2c0011",
+"#jF c #2c0100",
+".th c #2c0300",
+"aFi c #2c0502",
+"#CC c #2c0513",
+"aOm c #2c0514",
+"aBa c #2c0615",
+"aLw c #2c0813",
+".sj c #2c1100",
+".u4 c #2c1212",
+".kG c #2c1319",
+".x8 c #2c1519",
+".uJ c #2c1710",
+".4m c #2c1717",
+"#nV c #2c1915",
+"acp c #2c1e12",
+".uO c #2c2218",
+"#4y c #2c231d",
+"aJT c #2c252c",
+".Ck c #2c2548",
+".e6 c #2c262f",
+"aDx c #2c2e3a",
+"#7n c #2c3f69",
+"#9T c #2d0000",
+"aOx c #2d111d",
+".qV c #2d171e",
+"##T c #2d201f",
+"##Z c #2d2748",
+".gz c #2d2b38",
+".IH c #2d2d43",
+"ahz c #2d3f66",
+"#2b c #2e0303",
+"#4Z c #2e0d00",
+".SZ c #2e1613",
+".sh c #2e161a",
+".zF c #2e1d00",
+".ob c #2e1e20",
+".nW c #2e2218",
+".ii c #2e2232",
+".dJ c #2e2438",
+".EJ c #2e2620",
+".Is c #2e2f6a",
+".5M c #2e3158",
+"aax c #2e3a5b",
+"aFj c #2f0000",
+"#LE c #2f0005",
+"#0S c #2f0100",
+".tF c #2f1617",
+".mk c #2f1715",
+"aIi c #2f1911",
+".gt c #2f1a21",
+".qT c #2f1b17",
+".R5 c #2f1c17",
+"akw c #2f2b2f",
+"ato c #2f4465",
+".Dl c #2f4a7c",
+"aa5 c #300002",
+"aNJ c #300314",
+".Oy c #300400",
+".9l c #300e00",
+".tI c #301600",
+".sk c #301707",
+".sf c #301a13",
+".wg c #301c06",
+".hS c #301d1b",
+".k8 c #302131",
+".pm c #302219",
+".qH c #30231a",
+"ajW c #30232d",
+".Xp c #302848",
+"#eE c #302a2c",
+".gV c #302a4f",
+"aAR c #302b37",
+"awz c #302d30",
+".al c #303a62",
+".ch c #303b60",
+".aJ c #304475",
+"#HA c #310000",
+"#1S c #310400",
+"aI2 c #310a00",
+"#Z. c #310e00",
+".tG c #311600",
+".z1 c #311800",
+"ak8 c #312623",
+"aLa c #312a2f",
+".8U c #312b2e",
+"#2a c #320604",
+"#2c c #320909",
+".7t c #321700",
+"aNI c #321827",
+".wk c #321921",
+".Zt c #321a1a",
+".1N c #32221c",
+".zk c #322438",
+".Cr c #322630",
+".EL c #322923",
+"aIm c #323033",
+"ari c #323035",
+".B4 c #323058",
+"#da c #32305c",
+"aql c #323134",
+".Wl c #331b0d",
+".3s c #331d21",
+"azd c #331f18",
+"aIN c #33222b",
+".xT c #33282a",
+".vm c #332b40",
+"anj c #332d34",
+".vD c #332f40",
+"Qt9 c #335e9d",
+".#g c #3365a8",
+".#f c #3367a8",
+".#e c #3368a8",
+"#2d c #340806",
+"aNp c #340d19",
+".7z c #341304",
+".v# c #341608",
+".wl c #341f08",
+"#.A c #342835",
+"Qt0 c #343748",
+"aQF c #344d7b",
+".#h c #3463a8",
+"#8e c #350000",
+"#Zo c #350100",
+"a#t c #350103",
+"aDY c #350a1e",
+"#h2 c #350b00",
+".7r c #350c00",
+"#XH c #350d00",
+"aMY c #351717",
+".si c #351806",
+".vP c #352739",
+".xh c #35284c",
+"anE c #352e33",
+"#Vi c #35374b",
+".d6 c #355d9e",
+".aW c #3565aa",
+"#Zn c #360000",
+"#9S c #360005",
+"#Xc c #360011",
+"#SW c #360213",
+"#0R c #360703",
+".Rx c #361609",
+"#3f c #361c0c",
+".Bu c #362716",
+".zi c #362938",
+".0E c #362c41",
+"aLb c #362f35",
+".Ly c #36325a",
+"#Zt c #370000",
+"#Zp c #370500",
+"#0V c #370600",
+".9c c #370c00",
+".wj c #371e22",
+".yo c #37231c",
+".Bv c #372916",
+".aj c #372931",
+".7h c #372a20",
+"al6 c #372b2f",
+"aoF c #372c31",
+"#Fm c #372f3c",
+"aAx c #373134",
+"aJU c #373137",
+"afA c #37343b",
+".DE c #373664",
+"ac# c #374d71",
+".#i c #3763ac",
+".aX c #3766ab",
+"#9R c #38040a",
+"#Zq c #380700",
+".OM c #380800",
+"#9Q c #38080c",
+"#Wf c #380900",
+"#h3 c #380b00",
+"aL1 c #380e0e",
+".04 c #381b1a",
+".48 c #381d2d",
+".tD c #382017",
+".pz c #382a14",
+".mL c #382a2f",
+".ih c #382b37",
+".us c #382e3e",
+".dQ c #382e42",
+".dH c #38313a",
+".VR c #38376a",
+"#YG c #390018",
+"#Zs c #390300",
+"#Zr c #390400",
+"aa4 c #390608",
+"#HB c #39100c",
+".OZ c #39130f",
+"aHE c #39202b",
+".49 c #392236",
+"#TV c #392626",
+".z7 c #392822",
+".Bs c #392a1f",
+".FJ c #392c3b",
+".jD c #392f31",
+".Ci c #393060",
+"#ws c #393157",
+"#80 c #39353b",
+"aAd c #393e60",
+"#5H c #394b71",
+".aK c #394e7f",
+".#a c #395ea5",
+".## c #3960a4",
+".yy c #3966b3",
+".wL c #3966b4",
+".Oz c #3a0e02",
+".P3 c #3a1a0c",
+".tE c #3a2121",
+".tJ c #3a220e",
+".uI c #3a231d",
+".wi c #3a2320",
+".7g c #3a2d2c",
+".vN c #3a2d38",
+"aMh c #3a3137",
+"alX c #3a465d",
+"Qt3 c #3a5a93",
+".lk c #3a5fab",
+".aT c #3a62ad",
+".m2 c #3a64b8",
+".aV c #3a6bb0",
+"#e2 c #3b0200",
+"#0Q c #3b0a03",
+".OK c #3b0b03",
+"#D9 c #3b101d",
+".nZ c #3b2b23",
+".xe c #3b344b",
+".cq c #3b62ad",
+".a1 c #3b63a9",
+".su c #3b64a9",
+".cm c #3b64ac",
+".oq c #3b67bc",
+"#dq c #3c0400",
+"aNR c #3c0408",
+".OL c #3c0c04",
+"#2e c #3c0d0a",
+"#2# c #3c0e0b",
+"#.K c #3c0f00",
+"aMt c #3c121f",
+".sg c #3c2427",
+"#Cj c #3c2a28",
+".od c #3c2a37",
+".oc c #3c2b37",
+"anG c #3c363b",
+"#bn c #3c3759",
+".At c #3c385a",
+"adK c #3c517e",
+"Qt2 c #3c5b95",
+".ct c #3c64a6",
+".cs c #3c64a9",
+".cr c #3c64ac",
+".#j c #3c65b0",
+".#B c #3c66b0",
+".cJ c #3c66b1",
+"##j c #3d0000",
+"#Rw c #3d0113",
+".58 c #3d0900",
+".OJ c #3d0d04",
+"#VN c #3d0d12",
+"#Wg c #3d180b",
+".u2 c #3d2419",
+".zO c #3d292c",
+".zE c #3d2c12",
+".b3 c #3d2d30",
+".z8 c #3d3130",
+".8O c #3d3336",
+"aFB c #3d3437",
+".xd c #3d364e",
+".Av c #3d395b",
+".aS c #3d62aa",
+".#A c #3d65b2",
+".#C c #3d66b1",
+".vj c #3d67ae",
+".#F c #3d67b1",
+".a9 c #3d67b2",
+".r# c #3d69b8",
+"#Zu c #3e0000",
+"aNO c #3e0001",
+"aNK c #3e0012",
+"#gw c #3e0300",
+"#Zm c #3e0600",
+"#Z5 c #3e0b28",
+"aNS c #3e181b",
+"#FW c #3e1d1d",
+"#dg c #3e3340",
+"#gb c #3e3749",
+".t6 c #3e3936",
+"ahg c #3e3b3f",
+"aIc c #3e507a",
+".dV c #3e507f",
+".BO c #3e5d93",
+".oo c #3e64af",
+".a8 c #3e66b2",
+".#z c #3e66b3",
+".a0 c #3e67ad",
+".#G c #3e67b2",
+".lx c #3e68af",
+".lw c #3e68b0",
+".m9 c #3e68b1",
+".#D c #3e68b2",
+".#E c #3e68b3",
+".ly c #3e69b0",
+".ln c #3e69c1",
+".Af c #3e6ab4",
+".Dp c #3e6cab",
+"#CZ c #3f0200",
+"aa3 c #3f0b0d",
+"#ag c #3f0f01",
+"#A9 c #3f1823",
+"axY c #3f2b25",
+".8K c #3f3147",
+".63 c #3f3333",
+"#G7 c #3f3744",
+".Ka c #3f3b64",
+".un c #3f4268",
+".g3 c #3f63af",
+".jX c #3f64b1",
+".jY c #3f65b0",
+".a2 c #3f66ad",
+".#o c #3f66ae",
+".cp c #3f66b3",
+".#n c #3f67ad",
+".#y c #3f67b3",
+".#x c #3f67b4",
+".#H c #3f68b3",
+".lv c #3f69b0",
+".m6 c #3f69b1",
+".lq c #3f69b2",
+".#I c #3f69b3",
+".lu c #3f6ab1",
+".wN c #3f6bae",
+".E4 c #3f6dab",
+".Uz c #401615",
+"#HC c #401a14",
+"aym c #403541",
+".5s c #40374b",
+".dY c #4061a7",
+".d2 c #4061ae",
+".#d c #4062b0",
+".fJ c #4065b3",
+".a4 c #4067ae",
+".cy c #4067af",
+".#p c #4067b0",
+".#k c #4067b4",
+".#m c #4068ae",
+".cI c #4068b3",
+".a7 c #4068b4",
+".#w c #4068b5",
+".cu c #4069a9",
+".jS c #4069af",
+".wU c #4069b0",
+".eg c #4069b3",
+".cH c #4069b4",
+".jT c #406aaf",
+".iy c #406ab0",
+".os c #406ab1",
+".m5 c #406ab2",
+".ls c #406ab3",
+".eh c #406ab4",
+".fI c #406ab5",
+".or c #406bb2",
+".lp c #406bb3",
+".yA c #406caf",
+".pO c #406cbe",
+"aNQ c #410003",
+"#UN c #410900",
+"#bT c #410d01",
+".6C c #411912",
+".wB c #41281c",
+".wm c #412b13",
+"aNA c #41313f",
+"#Co c #413647",
+".3u c #414e6d",
+".#b c #4165af",
+".#L c #4166b2",
+".ba c #4166b3",
+".#K c #4166b4",
+".#t c #4167b5",
+".a3 c #4168ae",
+".cx c #4168af",
+".cz c #4168b1",
+".#q c #4168b3",
+".#v c #4168b5",
+".d9 c #4169b0",
+".ef c #4169b3",
+".cG c #4169b4",
+".a6 c #4169b5",
+".#u c #4169b6",
+".#. c #416aab",
+".jU c #416aaf",
+".iz c #416ab0",
+".yD c #416ab1",
+".ha c #416ab2",
+".fH c #416ab3",
+".ee c #416ab4",
+".cF c #416ab5",
+".aU c #416ab7",
+".lz c #416bb2",
+".pP c #416bb3",
+".lr c #416bb4",
+".hb c #416bb5",
+".lC c #416bb6",
+"Qt8 c #416caa",
+".m7 c #416cb3",
+".ou c #416cb4",
+".aY c #416eb3",
+".Do c #416fb0",
+"aNN c #420004",
+"#Hg c #420c17",
+"#0W c #420d05",
+"#Fz c #420d1a",
+".59 c #420e00",
+".7D c #420e02",
+".ON c #42130a",
+"aNq c #421320",
+".OA c #42160a",
+"aKQ c #421714",
+".ym c #422604",
+".x9 c #422b32",
+".qB c #42332b",
+".pj c #42352c",
+"##5 c #423643",
+"arY c #424245",
+"#AY c #424559",
+".d1 c #4261b1",
+".jZ c #4267b1",
+".cM c #4267b2",
+".cL c #4267b3",
+".fK c #4267b4",
+".b# c #4267b5",
+".a5 c #4268b3",
+".#s c #4268b5",
+".#l c #4268b6",
+".cw c #4269b0",
+".e. c #4269b2",
+".cA c #4269b4",
+".#r c #4269b5",
+".cC c #4269b6",
+".d8 c #426ab0",
+".wW c #426ab2",
+".fG c #426ab3",
+".ed c #426ab4",
+".cE c #426ab5",
+".cD c #426ab6",
+".wS c #426bb1",
+".wV c #426bb2",
+".fF c #426bb3",
+".m4 c #426bb4",
+".ec c #426bb5",
+".lD c #426bb6",
+".yE c #426cb2",
+".lA c #426cb3",
+".m8 c #426cb4",
+".lt c #426cb5",
+".hc c #426cb6",
+".ov c #426cb7",
+".lm c #426cc2",
+".Dq c #426daf",
+".wX c #426db2",
+".ot c #426db4",
+".sw c #426db5",
+".E3 c #426fae",
+"#9P c #430103",
+"#OD c #430513",
+"aLx c #431622",
+".6B c #431d14",
+".rW c #432215",
+".eR c #432409",
+".7A c #432418",
+"ape c #432c26",
+".bX c #432e35",
+".tf c #433121",
+".Bf c #433624",
+"aLg c #43363d",
+"aMg c #433940",
+"#r4 c #433a3f",
+".qj c #433a44",
+"aGJ c #433b39",
+"ado c #433f48",
+"awd c #434047",
+".ej c #4368b2",
+".ei c #4368b3",
+".hd c #4368b4",
+".cK c #4368b5",
+".#J c #4368b6",
+".yw c #4369ae",
+".iA c #4369b2",
+".eb c #4369b6",
+".fA c #436ab2",
+".fB c #436ab3",
+".e# c #436ab5",
+".cB c #436ab6",
+".h# c #436ab7",
+".d5 c #436bac",
+".d7 c #436bb1",
+".yF c #436bb3",
+".lo c #436bb5",
+".yB c #436cb0",
+".wR c #436cb2",
+".wT c #436cb3",
+".yG c #436cb4",
+".jV c #436cb7",
+".lB c #436db6",
+".lE c #436db7",
+".vk c #436db8",
+".wY c #436eb4",
+".E5 c #436fb0",
+".BS c #4370b1",
+".Ah c #4370b2",
+".tV c #4370ba",
+".wM c #4372b9",
+"#Zl c #440a00",
+"#IN c #440a12",
+".OI c #44140c",
+".9n c #44180a",
+".44 c #441c0f",
+".qW c #443124",
+"aLh c #44373f",
+"#bG c #443946",
+".rG c #443a47",
+".s3 c #443a49",
+"ast c #444046",
+"ay7 c #44496c",
+".aP c #44629b",
+".aQ c #4464a2",
+".Dn c #4468ab",
+".yC c #4469b1",
+".cN c #4469b3",
+".#M c #4469b4",
+".fL c #4469b5",
+".b. c #4469b7",
+".j0 c #446ab1",
+".iB c #446ab2",
+".he c #446ab3",
+".ea c #446ab6",
+".fE c #446ab7",
+".jR c #446ab8",
+".fz c #446bb2",
+".g6 c #446bb3",
+".g7 c #446bb4",
+".fC c #446bb6",
+".h. c #446bb8",
+".yH c #446cb4",
+".tU c #446daf",
+".wQ c #446db3",
+".Aj c #446db4",
+".BX c #446db5",
+".ra c #446db8",
+".tW c #446eb6",
+".pQ c #446eb7",
+".lF c #446eb8",
+".n. c #446eb9",
+".yx c #446eba",
+".aZ c #446fb4",
+".yI c #446fb5",
+".vi c #4471b9",
+".yz c #4472b9",
+"#ay c #450000",
+"aNP c #450003",
+"#M9 c #450109",
+"#I9 c #451200",
+".OO c #45150d",
+"aFf c #451528",
+".9Z c #451809",
+"#HD c #451a09",
+".41 c #451b02",
+"#6O c #451c01",
+"#FX c #451e0c",
+"aK# c #45353d",
+".vQ c #45374b",
+".Bw c #453822",
+"aNB c #453845",
+".d0 c #4562b5",
+"Qt4 c #45649e",
+"Qt6 c #45659e",
+".jW c #4569b7",
+".iE c #456baf",
+".iD c #456bb1",
+".iC c #456bb2",
+".fM c #456bb3",
+".fD c #456bb7",
+".ix c #456bb8",
+".j1 c #456caf",
+".Jz c #456cb2",
+".fy c #456cb3",
+".it c #456cb4",
+".iu c #456cb5",
+".g8 c #456cb7",
+".g9 c #456cb8",
+".jQ c #456cb9",
+".co c #456cba",
+".E2 c #456db0",
+".wO c #456db1",
+".g5 c #456db3",
+".Dr c #456db4",
+".Ai c #456eb2",
+".BW c #456eb4",
+".Ak c #456eb5",
+".Al c #456eb6",
+".BT c #456fb2",
+".wZ c #456fb5",
+".lG c #456fb9",
+".w0 c #4570b5",
+".m3 c #4571c8",
+".GH c #4573af",
+".9O c #460500",
+".6. c #461200",
+"#3D c #461803",
+"#zJ c #462b34",
+".zM c #46342b",
+".BG c #463730",
+".nV c #463b31",
+"#ZK c #465470",
+".ci c #465580",
+".aL c #465b8c",
+".dZ c #4662b7",
+".E1 c #4667a7",
+".aR c #4669ac",
+".fw c #4669b2",
+".#c c #4669b5",
+".hf c #466cb3",
+".ek c #466cb4",
+".bb c #466cb5",
+".hh c #466db0",
+".BU c #466db4",
+".jN c #466db5",
+".jO c #466db6",
+".iv c #466db7",
+".jP c #466db8",
+".iw c #466db9",
+".m1 c #466dbc",
+".g4 c #466eb4",
+".Am c #466eb6",
+".BV c #466fb5",
+".BY c #466fb6",
+".BZ c #466fb7",
+".r. c #466fb8",
+".yJ c #4670b6",
+".w6 c #4670b8",
+".ow c #4670ba",
+".wK c #4670be",
+".w1 c #4671b6",
+".w5 c #4671b8",
+".sv c #4673bf",
+".BR c #4674b7",
+".If c #4675b1",
+"#Hz c #470b00",
+".OH c #47170f",
+".40 c #471901",
+".90 c #47190a",
+".8a c #47231c",
+".5X c #473131",
+".di c #473a56",
+"aJV c #474047",
+"#bm c #47435c",
+"ao6 c #47518e",
+"arx c #475680",
+".aI c #475b8c",
+".aF c #475b8d",
+".ck c #47659f",
+".fv c #4766b1",
+".Ac c #4769a3",
+".q9 c #476aa9",
+".d3 c #476ab3",
+".jJ c #476bb0",
+".wP c #476bb4",
+".fx c #476cb5",
+".iF c #476db1",
+".hg c #476db3",
+".BQ c #476db4",
+".ir c #476dba",
+".j2 c #476eb2",
+".jM c #476eb5",
+".is c #476fb5",
+".Ae c #476fb9",
+".cv c #4770af",
+".Du c #4770b6",
+".Dv c #4770b7",
+".Dx c #4770b8",
+".tX c #4770bb",
+".yL c #4771b7",
+".w4 c #4771b8",
+".pR c #4771bb",
+".yK c #4772b7",
+".Dy c #4772b8",
+".w3 c #4772b9",
+".cn c #4772bd",
+".GG c #4773b1",
+".GI c #4774b4",
+".Ag c #4775ba",
+"a#s c #480209",
+".57 c #480400",
+"#KC c #480700",
+"#Fl c #484453",
+".li c #4866a7",
+"Qt5 c #4867a1",
+".g2 c #4868b0",
+".st c #486aa4",
+".iq c #486bb5",
+".yv c #486ca9",
+".wJ c #486eac",
+".hi c #486eb2",
+".fN c #486eb5",
+".cO c #486eb6",
+".iG c #486fb4",
+".jL c #4870b6",
+".Dw c #4870b8",
+".Ds c #4871b7",
+".Dt c #4871b8",
+".GN c #4871b9",
+".w2 c #4872b8",
+".yO c #4872ba",
+".rb c #4872bc",
+".tY c #4872bd",
+".yM c #4873b8",
+".An c #4873b9",
+"aNL c #490010",
+"#E. c #49131d",
+".OG c #491910",
+".6H c #492f4b",
+"#xX c #493d47",
+".vJ c #493f3c",
+"aPI c #496190",
+".Ad c #496daf",
+".#N c #496eb8",
+".j3 c #496fb5",
+".iH c #496fb6",
+".K4 c #4970b4",
+".hj c #4970b5",
+".Fa c #4971b9",
+".E9 c #4972b8",
+".E8 c #4972b9",
+".F# c #4972ba",
+".Dz c #4973b9",
+".w7 c #4973ba",
+".Ap c #4973bb",
+".sx c #4973bd",
+".Fb c #4974b9",
+".yN c #4974ba",
+".yP c #4974bb",
+".Ie c #4975b2",
+"#Ke c #4a0a0f",
+".6# c #4a1500",
+"#J# c #4a1603",
+"#0P c #4a160e",
+".OB c #4a1e12",
+".xW c #4a3519",
+".dv c #4a3542",
+".Y3 c #4a415a",
+"#tw c #4a4348",
+"aAI c #4a4852",
+".yu c #4a5e7f",
+".tS c #4a6085",
+".dW c #4a639d",
+".Ic c #4a69a5",
+".vg c #4a6a9d",
+".GE c #4a6aa7",
+".hk c #4a70b6",
+".iI c #4a70b7",
+".hl c #4a70b8",
+".hm c #4a70b9",
+".JS c #4a71b8",
+".K6 c #4a71b9",
+".Lc c #4a72b8",
+".MA c #4a72b9",
+".GM c #4a72ba",
+".E6 c #4a73b9",
+".F. c #4a73bb",
+".JK c #4a74b8",
+".Ao c #4a74ba",
+".Aq c #4a74bb",
+".tZ c #4a74be",
+".Fc c #4a75ba",
+".Fe c #4a75bb",
+".w8 c #4a75bc",
+"aNM c #4b020d",
+"#SX c #4b0617",
+"#.0 c #4b0c00",
+"#3C c #4b1804",
+"#CD c #4b1b25",
+".OP c #4b1c12",
+"#1o c #4b2741",
+".gk c #4b2c11",
+"#G2 c #4b3a44",
+".uM c #4b3e35",
+".o1 c #4b424a",
+"aNF c #4b424e",
+"aAw c #4b4549",
+"ax. c #4b494f",
+".Dm c #4b69a3",
+".m0 c #4b6eb7",
+".iJ c #4b70ba",
+".fP c #4b71b5",
+".fO c #4b71b8",
+".bc c #4b71b9",
+".JB c #4b71ba",
+".Mp c #4b72b8",
+".Mn c #4b73b5",
+".JR c #4b73ba",
+".GL c #4b73bb",
+".vh c #4b74b5",
+".JL c #4b74b9",
+".E7 c #4b74ba",
+".GJ c #4b74bb",
+".JJ c #4b75b8",
+".My c #4b75b9",
+".Ff c #4b75bb",
+".B0 c #4b75bc",
+".yQ c #4b75bd",
+".Fd c #4b76bb",
+".B1 c #4b76bd",
+"#.2 c #4c0a00",
+"#I8 c #4c1100",
+"#XY c #4c1200",
+"aNr c #4c1826",
+"#2f c #4c1913",
+"#.R c #4c1c08",
+".9d c #4c2a1d",
+"#FV c #4c2a2e",
+".W4 c #4c2e1f",
+".u3 c #4c3231",
+".pa c #4c3720",
+".zC c #4c3a25",
+".bM c #4c3d3a",
+".8J c #4c414a",
+".nD c #4c4449",
+".pZ c #4c4856",
+"aej c #4c4a51",
+"a.Q c #4c5a7e",
+".aG c #4c6192",
+".aN c #4c679b",
+".fu c #4c67b3",
+".q8 c #4c689a",
+".BP c #4c6dac",
+".Jy c #4c6fb5",
+".d4 c #4c71b6",
+".el c #4c71b9",
+".hn c #4c71bc",
+".jK c #4c71bd",
+".GF c #4c72b3",
+".fQ c #4c72b6",
+".j4 c #4c72bb",
+".NF c #4c73b3",
+".JT c #4c73ba",
+".NT c #4c74ba",
+".JV c #4c74bb",
+".JI c #4c75b8",
+".JM c #4c75b9",
+".JN c #4c75ba",
+".GK c #4c75bb",
+".JF c #4c76b7",
+".JE c #4c76b8",
+".JH c #4c76b9",
+".JO c #4c76ba",
+".GO c #4c76bc",
+".w9 c #4c76bd",
+".DA c #4c77be",
+"#ax c #4d0700",
+"#Bs c #4d0d00",
+"#KB c #4d0e00",
+".4T c #4d0f00",
+"#J. c #4d1c0c",
+"#0x c #4d2004",
+".Qw c #4d2113",
+".ma c #4d4549",
+".AD c #4d475b",
+".fl c #4d4c55",
+".jq c #4d4e45",
+".gZ c #4d5e9a",
+".ip c #4d6dae",
+".fT c #4d72ba",
+".#V c #4d72bc",
+".Id c #4d73b3",
+".fR c #4d73b9",
+".fS c #4d73ba",
+".#W c #4d73be",
+".Mz c #4d74bb",
+".NH c #4d75b8",
+".JU c #4d75bb",
+".JQ c #4d75bc",
+".ll c #4d75c6",
+".L# c #4d76b8",
+".JG c #4d76b9",
+".JP c #4d76ba",
+".Mx c #4d76bb",
+".JD c #4d77b8",
+".L. c #4d77b9",
+".Lb c #4d77ba",
+".NS c #4d77bb",
+".Fg c #4d77be",
+"#Xd c #4e0912",
+"aNz c #4e1721",
+".OF c #4e1e16",
+"QtL c #4e2400",
+".7C c #4e2419",
+".OY c #4e241f",
+".wA c #4e2f0b",
+".jl c #4e3f41",
+"aBU c #4e4a4e",
+".av c #4e4a6d",
+".sR c #4e4c68",
+".mm c #4e4e65",
+".fp c #4e588f",
+"avp c #4e5c7e",
+".fr c #4e60af",
+".pM c #4e6ca7",
+".pN c #4e73b8",
+".#O c #4e73bc",
+".fU c #4e73be",
+".#U c #4e74bc",
+".iK c #4e74be",
+".NU c #4e75bc",
+".Pd c #4e76b3",
+".NV c #4e76bc",
+".K9 c #4e77b9",
+".La c #4e77ba",
+".Mw c #4e77bc",
+".K8 c #4e78b9",
+".Mr c #4e78ba",
+".Mu c #4e78bb",
+".Mv c #4e78bc",
+".GP c #4e78bf",
+".GQ c #4e79c0",
+"#Z6 c #4f031d",
+"#Uj c #4f0b1c",
+"#aq c #4f1f07",
+"a.# c #4f2513",
+"#6E c #4f2615",
+".ky c #4f2813",
+"#.T c #4f2814",
+".wy c #4f300c",
+".6G c #4f3148",
+".TY c #4f4359",
+"aoE c #4f444a",
+".dP c #4f4458",
+".yT c #4f4965",
+"aGR c #4f608b",
+".E0 c #4f6aa1",
+".aO c #4f6ba1",
+".dX c #4f6daf",
+"Qt1 c #4f6fa8",
+".on c #4f70b3",
+".bj c #4f75be",
+".bk c #4f75bf",
+".QY c #4f76bd",
+".Pp c #4f77bd",
+".Mt c #4f78bb",
+".NR c #4f78bc",
+".NQ c #4f78bd",
+".Mq c #4f79ba",
+".NM c #4f79bb",
+".Ms c #4f79bc",
+".Pm c #4f79bd",
+".op c #4f79ca",
+"#9O c #500409",
+"#.Z c #501200",
+"#3E c #501500",
+"#.L c #50291e",
+".mb c #502a14",
+".7B c #502e23",
+"#DQ c #503d36",
+"aHl c #503f46",
+".oa c #504330",
+".81 c #504451",
+"#x0 c #504665",
+"aEz c #50494e",
+"ap6 c #504c52",
+"ai7 c #504d54",
+"#Yi c #505b79",
+".gY c #505e96",
+".aH c #506596",
+".cj c #506699",
+".Jx c #506dae",
+".ep c #5075bf",
+".bl c #5075c0",
+".K7 c #5075c1",
+".bd c #5076bd",
+".#P c #5076be",
+".Pf c #5077b8",
+".em c #5077ba",
+".QX c #5077be",
+".Pq c #5078be",
+".NG c #5079b9",
+".NP c #5079bc",
+".QR c #5079bd",
+".Pn c #5079be",
+".NL c #507abb",
+".NK c #507abc",
+".NO c #507abd",
+".Po c #507abe",
+".Ig c #507ac1",
+".5d c #507dbb",
+"#XQ c #510900",
+"#.1 c #511000",
+".9v c #511305",
+"acy c #512320",
+".OC c #512519",
+".dm c #513217",
+"aPM c #513327",
+".BB c #513d28",
+".Bx c #51442d",
+"#DV c #514456",
+".5. c #515d7b",
+".aM c #516596",
+".fs c #5165b3",
+".ft c #5167b5",
+"Qt7 c #5171aa",
+".K3 c #5174b8",
+".eq c #5176c0",
+".#T c #5177bd",
+".#Q c #5177be",
+".cU c #5177c0",
+".cV c #5177c1",
+".#R c #5178bb",
+".en c #5178bc",
+".QZ c #5178bf",
+".QK c #5179b7",
+".So c #5179bf",
+".TV c #5179c0",
+".Pe c #517ab7",
+".VF c #517aba",
+".NJ c #517abc",
+".NN c #517abd",
+".QS c #517abe",
+".QT c #517abf",
+".Pj c #517bbc",
+".Pi c #517bbd",
+".Pl c #517bbe",
+".Sm c #517bbf",
+"#L4 c #520300",
+".73 c #52130a",
+"#.Q c #521d09",
+".6a c #521e07",
+"#jG c #522512",
+".6D c #522928",
+".ai c #523318",
+".jA c #524140",
+"aK. c #52424a",
+".uN c #52473d",
+".vw c #524756",
+"aGZ c #52484c",
+"#c8 c #524a64",
+".85 c #524b5b",
+".sO c #52506c",
+"#3V c #525f79",
+"#9# c #52648b",
+".mX c #526ba1",
+".io c #526ca3",
+".K2 c #526fb0",
+".mZ c #5272b4",
+".Vl c #5275b6",
+".cl c #5276b8",
+".er c #5277c2",
+".#S c #5278bd",
+".eo c #5278be",
+".be c #5278bf",
+".cT c #5278c0",
+".cW c #5278c2",
+".JA c #5279bf",
+".Sn c #5279c0",
+".VE c #527abb",
+".Mo c #527abd",
+".K5 c #527abf",
+".Q0 c #527ac0",
+".Sp c #527ac1",
+".VD c #527bbb",
+".Pk c #527bbe",
+".QU c #527bbf",
+".QV c #527bc0",
+".QJ c #527cb7",
+".Ph c #527cbd",
+".QP c #527cbe",
+".QQ c #527cbf",
+".QW c #527cc0",
+"#P6 c #530a1a",
+"#Et c #531705",
+"#0X c #53180d",
+"#0O c #531d13",
+".nF c #532d15",
+".i4 c #533419",
+"axn c #533a30",
+".xw c #534846",
+".7f c #534855",
+"arg c #535256",
+"#Cq c #535666",
+".mY c #536eaa",
+".lj c #5375bb",
+".JC c #5377c4",
+".bf c #5379bd",
+".bi c #5379bf",
+".cP c #537abd",
+".TT c #537ac1",
+".VC c #537bbc",
+".TU c #537bc2",
+".TK c #537cb3",
+".QI c #537cb6",
+".Sg c #537cb8",
+".Vw c #537cbb",
+".TS c #537cc0",
+".TR c #537cc1",
+".TL c #537db4",
+".Sf c #537db6",
+".QO c #537dbe",
+".QN c #537dbf",
+".TQ c #537dc1",
+".6O c #5380bf",
+".5e c #5383c1",
+"#8d c #540007",
+".OE c #54271c",
+".OD c #54281c",
+".Zu c #543424",
+".Tz c #544040",
+".zQ c #544233",
+".xa c #544d65",
+".ak c #54567c",
+"axR c #54668b",
+".in c #546995",
+".pL c #546c9b",
+".ol c #546c9d",
+".lh c #5470ac",
+".W9 c #5477b8",
+".Mm c #5477ba",
+".X# c #5478b3",
+".bg c #547abe",
+".bh c #547abf",
+".cS c #547ac0",
+".QL c #547bbd",
+".cQ c #547bbf",
+".TW c #547bc2",
+".Xh c #547cbb",
+".VB c #547cbc",
+".Sq c #547cc3",
+".Se c #547db6",
+".Vv c #547dbc",
+".VA c #547dbd",
+".Sl c #547dbf",
+".QM c #547ebf",
+".Sk c #547ec0",
+"#X3 c #551506",
+"#XX c #551904",
+".9t c #551b0c",
+"aLy c #552330",
+".OQ c #55261b",
+"#ah c #55281f",
+"aLN c #553d4e",
+"aIL c #55434c",
+"ahR c #554843",
+"aLf c #55484f",
+".Hf c #554a4c",
+".dM c #554b5f",
+"#dk c #554e5e",
+".sN c #555758",
+".lg c #5570aa",
+".Ml c #5572b0",
+".TI c #5574a7",
+".NE c #5578b8",
+".Vn c #557ab4",
+".NI c #557ac2",
+".cR c #557bc0",
+".Sh c #557cbc",
+".Vz c #557dbe",
+".VH c #557dbf",
+".Vs c #557ebb",
+".Xg c #557ebc",
+".Vu c #557ebd",
+".Vy c #557ebe",
+".VG c #557ebf",
+".Sj c #557ec0",
+".Xd c #557fbc",
+".Si c #557fc0",
+".TP c #557fc1",
+".8o c #5587bc",
+"aNw c #560a13",
+"#LF c #560b0f",
+"aNy c #560b1b",
+".74 c #56140b",
+".9u c #561a0b",
+".55 c #561d0c",
+"#5l c #56200c",
+"#.S c #562d18",
+"aeo c #563726",
+"aNu c #56392a",
+".XU c #563b2c",
+".ar c #564341",
+"QtN c #56443c",
+".zX c #564628",
+".fe c #56464d",
+".DU c #564c80",
+"aAv c #564f53",
+".Cl c #565165",
+"aB8 c #565561",
+"agn c #566790",
+".wI c #566b8e",
+".g0 c #566cac",
+".GD c #5670a3",
+".g1 c #5671b6",
+".ND c #5674af",
+".TJ c #567bb2",
+".0h c #567cb9",
+".Pg c #567cc0",
+".TX c #567dc4",
+".Xb c #567eb5",
+".0o c #567ebd",
+".Xj c #567ebe",
+".Xi c #567ebf",
+".VI c #567ec0",
+".TM c #567fb9",
+".Vr c #567fbc",
+".Vt c #567fbd",
+".Vx c #567fbe",
+".TO c #567fc1",
+".0j c #5681ba",
+".8n c #5689bb",
+"##k c #571002",
+".9Q c #571105",
+"#X4 c #571401",
+"#XZ c #571f0d",
+".dt c #572806",
+"#FU c #572b27",
+".o3 c #573116",
+".8# c #57342c",
+".zP c #574349",
+".zL c #574636",
+"aoD c #574c51",
+"amk c #574c58",
+"#7g c #575359",
+".oC c #575369",
+".Pb c #5775ae",
+".Sc c #5776aa",
+".tT c #5778ad",
+".0f c #577aba",
+".Pc c #577bb8",
+".Vm c #577bba",
+".X. c #577cbb",
+".0g c #577cbc",
+".5c c #577dbe",
+".Vp c #577eb4",
+".YN c #577fbe",
+".Xk c #577fc1",
+".0i c #5780ba",
+".Vq c #5780bd",
+".Xc c #5780be",
+".Xf c #5780bf",
+".VJ c #5780c2",
+".0m c #5781be",
+".1W c #5784bf",
+".8l c #5787bf",
+"#YH c #58081a",
+"##l c #580d00",
+"#WG c #581000",
+"#Zv c #581502",
+"#3e c #58371d",
+"aOQ c #583b2f",
+"aF5 c #58484f",
+".i2 c #584946",
+".0C c #584d5b",
+"aFV c #584f55",
+".kw c #585053",
+".nO c #585151",
+"aJW c #585158",
+"avb c #58565c",
+".q7 c #586b90",
+".QG c #5876ad",
+".1S c #587bba",
+".YH c #587db9",
+".1T c #587dbd",
+".Xa c #587fb6",
+".TN c #587fbe",
+".YO c #5880c0",
+".YP c #5880c1",
+".Xl c #5880c2",
+".Xe c #5881be",
+".YK c #5881bf",
+".YM c #5881c0",
+".YQ c #5881c1",
+".0r c #5881c3",
+"a#r c #59040f",
+"#XR c #590e00",
+"#av c #591400",
+".9M c #591803",
+"#gx c #591a16",
+".9Y c #592e1e",
+".9j c #592f1d",
+".0# c #594534",
+"aLJ c #594555",
+"aCo c #59464d",
+".D# c #594b3e",
+".gB c #59545e",
+"ae5 c #59678f",
+".K1 c #5971a8",
+".om c #5975af",
+".Vk c #597ab4",
+".Sd c #597eb6",
+".1Z c #5981c0",
+".YR c #5981c2",
+".YT c #5981c3",
+".0k c #5982bf",
+".0l c #5982c0",
+".YL c #5982c1",
+".YS c #5982c2",
+".VK c #5982c3",
+".0s c #5982c4",
+".3B c #5988c4",
+"#8# c #5a0009",
+".9R c #5a1205",
+"#au c #5a1501",
+".56 c #5a1b0c",
+"#3B c #5a200c",
+".6b c #5a260f",
+"aMu c #5a2635",
+"#2. c #5a2a24",
+"#k8 c #5a2f10",
+".bO c #5a3b20",
+"#Is c #5a4753",
+".mt c #5a5147",
+".Ib c #5a72a4",
+".Mk c #5a72a7",
+".Jw c #5a72aa",
+".W8 c #5a7ab4",
+".5b c #5a7cbb",
+".QH c #5a7eb8",
+".15 c #5a82c2",
+".0p c #5a82c3",
+".YU c #5a82c4",
+".1X c #5a83c0",
+".3F c #5a83c1",
+".0n c #5a83c2",
+".0q c #5a83c3",
+".0t c #5a83c4",
+".VL c #5a83c5",
+".1V c #5a84bf",
+".1Y c #5a84c1",
+".6P c #5a8ac9",
+"#Wn c #5b1000",
+"aI3 c #5b1814",
+"#Eu c #5b1e06",
+".72 c #5b2611",
+"#5m c #5b2915",
+".ap c #5b3000",
+".7y c #5b3323",
+".ql c #5b3618",
+"aor c #5b4139",
+".x7 c #5b4542",
+".lK c #5b577a",
+"#vh c #5b5e68",
+".lf c #5b6f7b",
+".mW c #5b72a6",
+".ss c #5b739e",
+".NC c #5b74a7",
+".YF c #5b7ebe",
+".Vo c #5b81b8",
+".3y c #5b81c1",
+".YI c #5b82bb",
+".1U c #5b83c0",
+".3G c #5b83c2",
+".3M c #5b83c3",
+".14 c #5b83c4",
+".3N c #5b83c5",
+".YJ c #5b84bc",
+".3C c #5b84c1",
+".10 c #5b84c2",
+".3E c #5b84c3",
+".13 c #5b84c4",
+".3D c #5b85c2",
+".3A c #5b87c3",
+".8m c #5b8ec1",
+"#R0 c #5c0d00",
+"aGV c #5c4032",
+".zN c #5c4847",
+".zR c #5c4a3a",
+"#eT c #5c535a",
+"amG c #5c595d",
+".p6 c #5c5b77",
+".jp c #5c5d55",
+".Pa c #5c75a5",
+".QF c #5c76a3",
+".3x c #5c7fbe",
+".YG c #5c81c0",
+".5h c #5c84c3",
+".5k c #5c84c4",
+".12 c #5c84c5",
+".16 c #5c84c6",
+".5f c #5c85c2",
+".3H c #5c85c3",
+".3J c #5c85c4",
+".11 c #5c85c5",
+".5l c #5c85c6",
+".6V c #5c85c7",
+".6N c #5c86c5",
+"#OE c #5d0812",
+"#24 c #5d0a00",
+"#az c #5d1703",
+"#.Y c #5d200e",
+"#1Z c #5d2700",
+"#ao c #5d2c13",
+".1M c #5d4539",
+".3U c #5d5265",
+".DT c #5d5483",
+".rt c #5d5c7d",
+".gX c #5d69a0",
+".wH c #5d708f",
+".Sb c #5d77a2",
+".8p c #5d85c1",
+".3I c #5d85c4",
+".3L c #5d85c6",
+".17 c #5d85c7",
+".6Q c #5d86c3",
+".5i c #5d86c4",
+".5j c #5d86c5",
+".3K c #5d86c6",
+".9P c #5e1a10",
+".Vd c #5e3325",
+"#8w c #5e3822",
+".dk c #5e4e4b",
+".gi c #5e4f4c",
+".vZ c #5e5254",
+".vs c #5e576c",
+"aAu c #5e595b",
+"aay c #5e6c8e",
+"aca c #5e749b",
+".TH c #5e79a3",
+".5g c #5e86c5",
+".6T c #5e86c6",
+".6U c #5e86c7",
+".18 c #5e86c8",
+".6S c #5e87c6",
+".5m c #5e87c9",
+".99 c #5e8abf",
+"#ht c #5e91d1",
+"aNx c #5f0517",
+"#Uk c #5f0c1c",
+"#X2 c #5f2115",
+".9s c #5f2616",
+"aNv c #5f312b",
+".rI c #5f3a19",
+".2J c #5f3e3c",
+".S0 c #5f4139",
+".hK c #5f504d",
+"acW c #5f545a",
+".oE c #5f5b71",
+"aIn c #5f5d5f",
+"#bd c #5f7fbf",
+".8G c #5f85c5",
+".8t c #5f87c3",
+".3O c #5f87c9",
+".3z c #5f88c6",
+"#.. c #5f8bc0",
+"##m c #601202",
+"#XS c #601401",
+"##i c #601905",
+"#Zk c #602312",
+".3k c #603016",
+".OR c #603225",
+"#49 c #603415",
+"awZ c #60463c",
+".u5 c #604a2c",
+"#qF c #60504b",
+".mK c #605545",
+".k6 c #605647",
+"#WN c #606986",
+".fq c #606ca8",
+".0e c #607eb7",
+".8F c #6085c5",
+".8u c #6086c4",
+".8E c #6086c5",
+"#.f c #6086c6",
+"#.d c #6087c4",
+".6M c #6087c7",
+".8q c #6088c4",
+".6R c #6089c7",
+".3P c #6089ca",
+"#Rx c #61091a",
+"aKo c #611d08",
+"#3F c #612209",
+"#5k c #612411",
+".OX c #61342e",
+".8c c #613b34",
+".tL c #614b3c",
+".eP c #61524f",
+"#dh c #615453",
+".EK c #615953",
+".gW c #615b84",
+".wG c #616d85",
+".YE c #6180b9",
+".8k c #6186bf",
+".8v c #6186c5",
+".8D c #6186c6",
+".8w c #6187c5",
+"#.e c #6187c6",
+".8C c #6187c7",
+"#.a c #6188c4",
+".8r c #6189c5",
+"#hs c #618eca",
+"#vR c #621400",
+".6E c #623c42",
+".s5 c #623d1b",
+"aHF c #624554",
+".wn c #624d33",
+"aH4 c #625251",
+".gG c #625254",
+".Y0 c #626078",
+".W7 c #627baa",
+".Vj c #627cab",
+"##D c #6282be",
+".8x c #6287c6",
+".8B c #6287c7",
+".8y c #6288c6",
+".8A c #6288c7",
+".8z c #6288c8",
+".8s c #6289c5",
+"#.b c #6289c6",
+"#.c c #628ac6",
+"#rD c #628cc6",
+"#X5 c #631d05",
+"#X0 c #632b1a",
+"#FT c #632c18",
+"#ap c #63361c",
+".8d c #633c36",
+".uu c #633f1b",
+".va c #634437",
+"aJ8 c #63535c",
+".8N c #635763",
+"aDj c #635d62",
+".AN c #635e76",
+".pK c #63759a",
+"asP c #63799c",
+"##E c #6386bf",
+"#bj c #6388c7",
+"#.g c #6388c8",
+"##J c #6389c7",
+"##I c #6389c8",
+"##K c #6389c9",
+"#nu c #638aca",
+"##H c #638bc7",
+"#fW c #638bc8",
+"#rC c #6391cf",
+"#fX c #6391d2",
+"#s1 c #6393d2",
+"#9N c #640711",
+"##n c #641603",
+"#Zj c #642715",
+"#a8 c #642722",
+".45 c #643c34",
+"#4Y c #643d1a",
+".05 c #643f2e",
+"aMK c #645160",
+"#Iu c #645360",
+".2b c #645b6b",
+"#IA c #645d6a",
+".2k c #645d7b",
+"arN c #646066",
+"aDo c #64636c",
+".ru c #646384",
+"axh c #64769c",
+"#ba c #647cb9",
+"#em c #6485c3",
+".6L c #6486c4",
+"#bi c #6489c8",
+"#bl c #6489c9",
+"#bh c #648ac8",
+"#cY c #648ac9",
+"#bk c #648aca",
+"#rG c #648bc6",
+"#be c #648bc7",
+"#bf c #648cc8",
+".98 c #648ec7",
+"#N. c #650c0f",
+"#KD c #65210f",
+"#.3 c #652212",
+"#XW c #652710",
+".3i c #652712",
+".9X c #653a2a",
+".9e c #65462d",
+".jn c #65504e",
+"aj3 c #655a56",
+".y1 c #655b7a",
+"#5B c #656168",
+".Fu c #65638a",
+"#7o c #6579a6",
+"aiH c #657da8",
+".1R c #6582ba",
+"#cU c #658ac9",
+"#f1 c #658aca",
+"#cV c #658bc9",
+"#cX c #658bca",
+"#cW c #658bcb",
+"#bg c #658cc8",
+"#cR c #658dc9",
+"#kA c #658dce",
+"#GG c #6593c4",
+"a#q c #660714",
+"#WF c #662209",
+"#CY c #662c18",
+".vS c #664531",
+".6I c #66728f",
+".im c #667696",
+"aOM c #667fad",
+".5a c #6681b7",
+"#hq c #668abd",
+"##G c #668bc7",
+"#jb c #668bc8",
+"#jc c #668bc9",
+"#jd c #668bca",
+"#f2 c #668bcb",
+"apV c #668cc4",
+"#er c #668cca",
+"#et c #668ccb",
+"#eu c #668ccc",
+"#cS c #668dca",
+"#oV c #668dcb",
+"aoo c #668ec6",
+"#cT c #668eca",
+"#s0 c #6690cc",
+"#38 c #6691d0",
+"#8. c #670209",
+"#IO c #670b16",
+"#VO c #670f1e",
+"#Wm c #671f08",
+".75 c #67231a",
+"#2g c #672d25",
+"aN0 c #67493d",
+"aJX c #676067",
+".uV c #676250",
+"aBT c #676267",
+"#G6 c #676271",
+"aq5 c #676368",
+"aFu c #6778a3",
+".0d c #677eaa",
+"#ky c #6788c3",
+"#Ol c #678ac8",
+"#rE c #678bc1",
+"#ja c #678bc8",
+"#kF c #678bc9",
+"#je c #678bca",
+"#j# c #678cc9",
+"#jf c #678cca",
+"#es c #678ccb",
+"#ev c #678ccc",
+"#hw c #678dcb",
+"#f3 c #678dcd",
+"#eq c #678eca",
+"#qd c #678fca",
+"#eo c #678fcb",
+"anc c #6790ca",
+"and c #6791c8",
+"#qc c #6791ce",
+"#s2 c #6792cc",
+"#.# c #6794cc",
+"#Hh c #680d1b",
+".3f c #682612",
+"#e3 c #682b27",
+"afX c #683115",
+".3j c #68311a",
+"aNs c #683326",
+".UB c #68362e",
+"#3o c #683a1a",
+".3r c #684c48",
+"aKa c #685760",
+".bL c #685962",
+".AT c #685c67",
+".YD c #6880ae",
+"#cP c #6884c3",
+"#fU c #6887bd",
+"#2A c #6888bc",
+"#iX c #6889c5",
+"#MS c #688bc9",
+"#rF c #688cc4",
+"#j. c #688cc9",
+"#kz c #688cca",
+"#jg c #688ccb",
+"#i5 c #688dc7",
+"#kE c #688dca",
+"#l6 c #688dcb",
+"#hv c #688dcc",
+"#hx c #688dcd",
+"aom c #688ec6",
+"#kC c #688ec8",
+"al3 c #688fca",
+"#ep c #688fcb",
+"#GC c #688fce",
+"#fY c #6890cc",
+"al4 c #6891c8",
+"#GF c #6892c5",
+"#Im c #6894c7",
+"#23 c #690800",
+"#SY c #690b1b",
+"#cJ c #692219",
+"#62 c #692d19",
+".9i c #693a28",
+"aeH c #693e29",
+".xF c #694832",
+".ag c #695957",
+".8L c #695a75",
+".69 c #696160",
+".AJ c #696283",
+"au7 c #696668",
+".xp c #696768",
+"#bb c #6984c0",
+"#kx c #6988c3",
+"#cQ c #6989cb",
+"#l0 c #698ac5",
+"#GV c #698bc9",
+"#GU c #698cc8",
+"#GT c #698cc9",
+"#Ca c #698cca",
+"#zk c #698dc7",
+"#AI c #698dc9",
+"#i9 c #698dca",
+"#DG c #698dcb",
+"#l7 c #698dcc",
+"#i2 c #698ec8",
+"#i8 c #698ecb",
+"#nv c #698ecc",
+"al2 c #698ecd",
+"#i1 c #698fc8",
+"#oW c #698fc9",
+"akZ c #698fca",
+"#Cb c #698fce",
+"ap# c #6990c9",
+"#fZ c #6990cc",
+"#f0 c #6990cd",
+"ak0 c #6991c8",
+"#hu c #6991cd",
+"#iZ c #6991d4",
+"#T5 c #6994c8",
+"#SE c #6996c8",
+"#FA c #6a0f20",
+"#Xe c #6a1d20",
+"#X9 c #6a270e",
+"#X1 c #6a2d23",
+".OS c #6a3c2e",
+".bV c #6a3d13",
+".jx c #6a4e4b",
+"arH c #6a5149",
+".tC c #6a5637",
+"aMG c #6a5b69",
+"#bJ c #6a6269",
+"adL c #6a80b0",
+".3w c #6a87bd",
+"#Ym c #6a87d4",
+"#iW c #6a88c3",
+"#DM c #6a8bc9",
+"#DN c #6a8bca",
+"#uH c #6a8cc9",
+"#Cg c #6a8cca",
+"#xU c #6a8dc8",
+"#GS c #6a8dc9",
+"#GW c #6a8dca",
+"#GY c #6a8dcb",
+"#GN c #6a8ec5",
+"#ut c #6a8ec6",
+"##F c #6a8ec7",
+"#wm c #6a8ec8",
+"#nt c #6a8eca",
+"#i7 c #6a8ecb",
+"#kD c #6a8ecc",
+"#iY c #6a8ecd",
+"#i3 c #6a8fc9",
+"#i6 c #6a8fcc",
+"#oX c #6a8fcd",
+"#qi c #6a8fce",
+"#DH c #6a8fcf",
+"#kB c #6a90c9",
+"#l4 c #6a90ca",
+"#AJ c #6a90cd",
+"ap. c #6a91c9",
+"#uu c #6a91ca",
+"#Ii c #6a91cf",
+"#l3 c #6a91d2",
+"#Il c #6a93c7",
+"#SF c #6a98cb",
+"#4O c #6b0702",
+"#Kf c #6b0c12",
+"#WH c #6b2000",
+"#XT c #6b270d",
+"#3A c #6b2916",
+"ac1 c #6b2b16",
+"#19 c #6b3831",
+".Zv c #6b422e",
+".se c #6b593c",
+"#by c #6b6483",
+".ok c #6b7eaa",
+"#1a c #6b86ab",
+"#uI c #6b8cc9",
+"#AO c #6b8cca",
+"#AP c #6b8ccb",
+"#fV c #6b8dc6",
+"asS c #6b8dc7",
+"#uG c #6b8dc9",
+"#uL c #6b8dca",
+"#zl c #6b8dcb",
+"ajT c #6b8dcd",
+"aqP c #6b8ec3",
+"#nr c #6b8ec9",
+"#GR c #6b8eca",
+"#Cc c #6b8ecb",
+"#GX c #6b8ecc",
+"#Io c #6b8fc6",
+"#GM c #6b8fc7",
+"#wf c #6b8fc8",
+"#uE c #6b8fc9",
+"ajU c #6b8fca",
+"#GQ c #6b8fcb",
+"#rI c #6b8fcc",
+"#rJ c #6b8fcd",
+"#qj c #6b8fce",
+"ajV c #6b90c8",
+"#xO c #6b90c9",
+"#i0 c #6b90ca",
+"apW c #6b90cc",
+"#rK c #6b90cd",
+"#rL c #6b90ce",
+"#Fa c #6b90d0",
+"#T2 c #6b90d2",
+"#hr c #6b91c9",
+"#rB c #6b91cb",
+"#zg c #6b91cd",
+"#wg c #6b92cc",
+"#MI c #6b94cc",
+"#Ob c #6b95ca",
+"#T6 c #6b97cb",
+"#Ra c #6b97ce",
+"#R# c #6b98cc",
+"#Z7 c #6c081a",
+"#25 c #6c0a02",
+"#8c c #6c0a15",
+"#Wo c #6c1f09",
+"#Vc c #6c2000",
+"#aw c #6c2712",
+".4U c #6c2a19",
+"#61 c #6c2d18",
+"#5o c #6c2e14",
+"#1p c #6c314e",
+"#0E c #6c3512",
+".54 c #6c3925",
+".3m c #6c442b",
+".6F c #6c4a59",
+"aLO c #6c5163",
+".C7 c #6c5e51",
+"abr c #6c6166",
+"aB7 c #6c6468",
+"av9 c #6c686b",
+"ap9 c #6c686e",
+".vf c #6c81a3",
+"#cO c #6c84c1",
+"#el c #6c88c3",
+"#Cd c #6c8cc7",
+"#Ce c #6c8dc7",
+"#DJ c #6c8dc8",
+"#uJ c #6c8dca",
+"#xV c #6c8dcb",
+"#xW c #6c8dcc",
+"aiN c #6c8dce",
+"anb c #6c8dd0",
+"#uF c #6c8eca",
+"#uK c #6c8ecb",
+"#uM c #6c8ecc",
+"#ns c #6c8fc8",
+"#zj c #6c8fca",
+"#AK c #6c8fcb",
+"#GP c #6c8fcc",
+"#DI c #6c8fcd",
+"#GL c #6c90c7",
+"#GK c #6c90c8",
+"aaN c #6c90c9",
+"#wl c #6c90ca",
+"#uD c #6c90cb",
+"#Iq c #6c90cc",
+"#rM c #6c90cf",
+"#PG c #6c91c3",
+"#uv c #6c91c8",
+"#4l c #6c91c9",
+"#i4 c #6c91cb",
+"#oS c #6c91cc",
+"aqQ c #6c92ca",
+"#xP c #6c92cd",
+"#JR c #6c92cf",
+"#JT c #6c93ca",
+"#qg c #6c93cf",
+"#JQ c #6c93d0",
+"#Vr c #6c94cb",
+"#Lh c #6c94ce",
+"#T4 c #6c95c9",
+"#JU c #6c95ca",
+"#MJ c #6c95cc",
+"#Oc c #6c96cc",
+"#1i c #6c96cd",
+"#37 c #6c96d5",
+"#SD c #6c97c8",
+"#SG c #6c97cd",
+"#PK c #6c98cd",
+"#8a c #6d0d18",
+"#y1 c #6d0e00",
+"#ub c #6d1700",
+"aCp c #6d2238",
+"abv c #6d3b2c",
+"#8x c #6d3f29",
+".3l c #6d4226",
+"aGl c #6d5564",
+".5v c #6d5d57",
+".2f c #6d6064",
+".uW c #6d695a",
+".jr c #6d6e65",
+".6K c #6d88bd",
+"#qb c #6d8dc4",
+"#AL c #6d8dc6",
+"#DK c #6d8dc9",
+"al1 c #6d8dd0",
+"akY c #6d8dd1",
+"#AM c #6d8ec7",
+"#l1 c #6d8ec9",
+"#Fc c #6d8eca",
+"#uN c #6d8ecc",
+"#uO c #6d8ecd",
+"#uw c #6d8fc3",
+"#ux c #6d8fc4",
+"#JS c #6d8fc9",
+"#Cf c #6d8fcb",
+"#DL c #6d8fcc",
+"#uP c #6d8fcd",
+"asi c #6d8fcf",
+"aiO c #6d90c9",
+"#AN c #6d90ca",
+"#uz c #6d90cb",
+"#GO c #6d90cc",
+"#Ip c #6d90cd",
+"#Fb c #6d90ce",
+"#qe c #6d91c8",
+"#wh c #6d91c9",
+"#56 c #6d91ca",
+"#oU c #6d91cb",
+"#Lj c #6d91cc",
+"#JV c #6d91cd",
+"#4k c #6d92c9",
+"#9q c #6d92ca",
+"#l5 c #6d92cc",
+"#Li c #6d92cd",
+"aaM c #6d93ca",
+"#rH c #6d93cd",
+"#s5 c #6d93ce",
+"#en c #6d93d5",
+"aug c #6d93dd",
+"#Vq c #6d94cc",
+"#Vt c #6d95cb",
+"#MK c #6d95cd",
+"#Rb c #6d95d0",
+"#Vs c #6d96cc",
+"#PI c #6d97cb",
+"#Od c #6d97ce",
+"#PJ c #6d98cc",
+"#PL c #6d98cf",
+"#R. c #6d99cc",
+"#4P c #6e0000",
+"#P7 c #6e0f19",
+"#1q c #6e1933",
+"#vS c #6e2203",
+"#KA c #6e2d03",
+"#XV c #6e2d15",
+"#FS c #6e2f10",
+".UA c #6e413e",
+".9W c #6e4434",
+"aNt c #6e4939",
+"aFz c #6e5244",
+".sl c #6e5a4b",
+".FE c #6e6462",
+"#Lu c #6e6773",
+".jf c #6e677c",
+"aAt c #6e6a6b",
+"as2 c #6e6a70",
+"#DW c #6e727e",
+"auP c #6e7da0",
+"akT c #6e7e9b",
+".1Q c #6e83ae",
+"#fT c #6e84b0",
+"#C# c #6e8bc2",
+"#DF c #6e8bc4",
+"#bc c #6e8bc8",
+"#AH c #6e8cc2",
+"adU c #6e8ccc",
+"agt c #6e8dce",
+"ajS c #6e8dd1",
+"#PE c #6e8eba",
+"#nq c #6e8ec8",
+"#Fd c #6e8eca",
+"ahG c #6e8ecb",
+"aiM c #6e8ed1",
+"#wi c #6e8fc5",
+"#zh c #6e8fc7",
+"ahH c #6e8fc9",
+"#Ik c #6e8fca",
+"#Ij c #6e8fcb",
+"#wn c #6e8fcd",
+"#uQ c #6e8fce",
+"#wj c #6e90c5",
+"#4m c #6e90cb",
+"#Fe c #6e90cd",
+"#wo c #6e90ce",
+"arC c #6e90d1",
+"#uy c #6e91c7",
+"#oT c #6e91c9",
+"#Lk c #6e91cb",
+"#uA c #6e91cc",
+"#Lm c #6e91cd",
+"#Ok c #6e91ce",
+"#Ir c #6e91cf",
+"#GH c #6e92c9",
+"#In c #6e92ca",
+"#xQ c #6e92cb",
+"#uC c #6e92cc",
+"#PR c #6e92ce",
+"#l2 c #6e92cf",
+"#Vu c #6e93c9",
+"a.7 c #6e93ca",
+"#qh c #6e93cd",
+"#oR c #6e93cf",
+"#4j c #6e94ca",
+"#55 c #6e94cb",
+"#T7 c #6e94cc",
+"#SH c #6e94cd",
+"#ML c #6e95ce",
+"#Q7 c #6e96c2",
+"#Q6 c #6e97c6",
+"#4d c #6e97cb",
+"#5Y c #6e97cd",
+"#4e c #6e98cb",
+"#5Z c #6e98cd",
+"#Oe c #6e98d0",
+"#1B c #6f0100",
+"a#p c #6f0c19",
+"#2T c #6f1719",
+"aCq c #6f233a",
+"#Y. c #6f290c",
+".9S c #6f2918",
+"#Hy c #6f2b02",
+".46 c #6f4b49",
+".zm c #6f4c32",
+".yr c #6f7281",
+"#ej c #6f7eb0",
+"#lZ c #6f8ac1",
+"#F# c #6f8cc5",
+"#us c #6f8dbf",
+"adT c #6f8dcc",
+"afd c #6f8dce",
+"#Ih c #6f8ebb",
+"agu c #6f8ecb",
+"adS c #6f8ecc",
+"ahF c #6f8ed1",
+"afc c #6f8ed2",
+"ao9 c #6f8fc7",
+"#xR c #6f90c6",
+"#xS c #6f90c7",
+"#GE c #6f90cb",
+"#9r c #6f90cc",
+"#uR c #6f90ce",
+"#uS c #6f90cf",
+"#zi c #6f91ca",
+"#Oa c #6f91cc",
+"#uT c #6f91cf",
+"#wk c #6f92c9",
+"#uB c #6f92cd",
+"#W5 c #6f92ce",
+"#JW c #6f92cf",
+"#GJ c #6f93ca",
+"#MR c #6f93cb",
+"#Ll c #6f93cc",
+"#U. c #6f93cf",
+"#s3 c #6f94c9",
+"#9p c #6f94cb",
+"#s6 c #6f94ce",
+"#MM c #6f94cf",
+"#T3 c #6f94d4",
+"#Yu c #6f95c7",
+"a.6 c #6f95cb",
+"#54 c #6f95cc",
+"auT c #6f95de",
+"#9l c #6f96ce",
+"#PM c #6f96d1",
+"#4c c #6f97cc",
+"#SB c #6f97ce",
+"#9m c #6f98d0",
+"#50 c #6f99ce",
+"#7C c #6f99d0",
+"#Q9 c #6f9acc",
+"#6w c #700005",
+"#79 c #70030c",
+"#L3 c #702202",
+"#X6 c #70280c",
+"aMv c #703746",
+".XW c #704436",
+".47 c #705158",
+".BE c #705c47",
+"ak1 c #706166",
+".jB c #706263",
+"aIq c #706e70",
+"QtG c #707197",
+"aoi c #707bba",
+"#DD c #7086b3",
+"aqN c #7087b8",
+"#zf c #708dc2",
+"afe c #708dcb",
+"#we c #708ec0",
+"#JP c #708ec7",
+"aci c #708ecd",
+"apU c #708fc5",
+"agv c #708fc9",
+"ach c #708fce",
+"#1c c #7090c7",
+".97 c #7090c9",
+"#GD c #7090cd",
+"#57 c #7091cd",
+"adP c #7091cf",
+"#7J c #7091d0",
+"#xT c #7092ca",
+"agr c #7092cc",
+"#4n c #7092ce",
+"avs c #7092d4",
+"#MN c #7093cf",
+"#Vz c #7093d0",
+"#WZ c #7094c7",
+"#MQ c #7094cb",
+"#qf c #7094cc",
+"#W4 c #7094d0",
+"#PH c #7095c5",
+"#PF c #7095c6",
+"#WY c #7095c9",
+"adR c #7095cc",
+"#7y c #7095ce",
+"#WX c #7096cc",
+"#9o c #7096cd",
+"#WV c #7096cf",
+"#5Q c #7096d0",
+"af# c #7096d2",
+"#1h c #7097cf",
+"#Of c #7097d1",
+"#7B c #7098d0",
+"#OF c #710c10",
+"#LG c #710d10",
+"#9H c #711215",
+"##g c #711f07",
+"#Zi c #712911",
+"#5j c #712e1a",
+".4S c #713013",
+".OT c #714233",
+"aJs c #714942",
+".Yy c #71533e",
+".rV c #715849",
+".zK c #71614a",
+".30 c #71656f",
+"aHT c #716973",
+"#eU c #716a79",
+"aIp c #716f71",
+"#Vj c #717692",
+"#xN c #718ec2",
+"aff c #718ec9",
+"al0 c #718ed2",
+"akX c #718ed3",
+"#7N c #718fce",
+"#9s c #718fcf",
+"aiL c #718fd3",
+"#7L c #7190ce",
+"#7M c #7190cf",
+"ahE c #7190d3",
+"afb c #7190d4",
+"#MP c #7191ce",
+"ahD c #7192cb",
+"#MO c #7192ce",
+"ags c #7192cf",
+"acg c #7192d0",
+"afa c #7192d2",
+"#33 c #7193ca",
+"#7w c #7193cb",
+"ash c #7193cd",
+"#53 c #7193d1",
+"av0 c #7193d3",
+"#W0 c #7194c7",
+"#7E c #7194cb",
+"#SL c #7194d0",
+"awV c #7194d4",
+"#Sz c #7194d7",
+"#PQ c #7195cc",
+"#Vy c #7195cd",
+"#7x c #7195ce",
+"#WU c #7195d0",
+"#WT c #7195d1",
+"#WW c #7196ce",
+"avt c #7196de",
+"#Q5 c #7197c6",
+"#7K c #7197cd",
+"adQ c #7197ce",
+"apa c #7197d1",
+"#ZU c #7198cc",
+"#4b c #7198ce",
+"aon c #7198d0",
+"#SA c #7198d4",
+"#5X c #7199d0",
+"#SC c #719bcc",
+"#2H c #719cd5",
+"#VP c #720d1c",
+"#6C c #721819",
+"#To c #72270a",
+".3h c #72301c",
+"#5n c #72361c",
+"#am c #72361f",
+".9V c #72371d",
+".XV c #72493d",
+".Ry c #724d3e",
+"aDv c #72666c",
+".zd c #726866",
+".YX c #726870",
+".te c #726a55",
+"##M c #726b7f",
+"#sZ c #728cbb",
+"a.9 c #728fcf",
+"aiJ c #7290cb",
+"aue c #7290cc",
+"a.8 c #7290cf",
+"#6. c #7290d0",
+"#MH c #7291d2",
+"#GB c #7292b8",
+"#58 c #7292cf",
+"#O# c #7293cb",
+"aaK c #7293d0",
+"a.5 c #7293d1",
+"aaL c #7293d2",
+"#Vv c #7294ca",
+"#SK c #7294cc",
+"aaJ c #7294d0",
+"#Og c #7294d1",
+"#Rc c #7294d2",
+"#Vp c #7294de",
+"#s4 c #7295cc",
+"#Vx c #7295cd",
+"#34 c #7295cf",
+"#Yn c #7295d1",
+"auS c #7295d9",
+"#GI c #7296cd",
+"#W3 c #7296ce",
+"av1 c #7296db",
+"#Yt c #7297ca",
+"#Q8 c #7298c1",
+"#2G c #7299d3",
+"#5R c #7299d4",
+"#7A c #729ad2",
+"#7D c #729cd3",
+"#0f c #730202",
+"#1E c #730307",
+"#Kh c #730b07",
+"a#o c #730f1c",
+"#sE c #731d04",
+".OW c #73433c",
+".91 c #734436",
+".OU c #734536",
+"aJ# c #735468",
+"aww c #735950",
+".uP c #73602c",
+"#AS c #736368",
+"QtA c #736682",
+".D3 c #736772",
+".kP c #736a60",
+"apq c #736a6f",
+"aJY c #736c73",
+".j7 c #736f96",
+"aIo c #737173",
+".96 c #737eaa",
+".le c #738590",
+"#9c c #738ab7",
+"asf c #7390bc",
+"ajR c #7390d2",
+"aiK c #7391ce",
+"#59 c #7391d0",
+"#Lg c #7391d2",
+"#Vn c #7391d9",
+"a.V c #7392c2",
+"#SI c #7393cf",
+"#4o c #7393d0",
+"asg c #7394c7",
+"#ZO c #7394cf",
+"adO c #7394d1",
+"#PN c #7394d2",
+"#W1 c #7395cd",
+"#4g c #7395ce",
+"#4h c #7395cf",
+"#2F c #7395d0",
+"#Yo c #7395d1",
+"#52 c #7395d2",
+"#4i c #7395d3",
+"#ZV c #7396cd",
+"#1j c #7396ce",
+"aEa c #7396da",
+"aCV c #7396db",
+"az. c #7396de",
+"#Oj c #7397ce",
+"#W2 c #7397cf",
+"aBw c #7397dd",
+"aAg c #7397de",
+"#4a c #7398d0",
+"aqR c #7398d4",
+"#7z c #7399d1",
+"#36 c #739bd8",
+"#1C c #74000a",
+"#LH c #740205",
+"#Kg c #74020a",
+"#IP c #740210",
+"#YI c #74131c",
+"#Nx c #741903",
+"#RZ c #741f00",
+"#t1 c #742408",
+"#gz c #742611",
+"aCr c #74263d",
+"#I7 c #742f00",
+"#bU c #744139",
+".7x c #744837",
+"aGz c #745361",
+".uH c #745b56",
+".tk c #746059",
+"#6g c #746a62",
+"#.C c #746b72",
+"#bA c #747097",
+"QtQ c #74769a",
+".sr c #74829d",
+"#N9 c #748bb2",
+"#C. c #748bbd",
+"aok c #748cc7",
+"ana c #748ed1",
+"ajP c #748fcb",
+"#Oi c #748fd0",
+"akW c #748fd1",
+"ajQ c #7490ce",
+"ahB c #7491c3",
+"#Oh c #7491d0",
+"aaF c #7492c5",
+"#2B c #7492c7",
+"#4q c #7492d2",
+"#1b c #7493c1",
+"a.W c #7493c4",
+"aol c #7493cd",
+"#4p c #7493d2",
+"atq c #7494c5",
+"agq c #7495cd",
+"#T8 c #7495cf",
+"#Yp c #7495d0",
+"#7I c #7495d2",
+"#T1 c #7495da",
+"#7v c #7496cd",
+"#4f c #7496ce",
+"#Yq c #7496cf",
+"a.4 c #7496d0",
+"#39 c #7496d1",
+"#51 c #7496d2",
+"a.3 c #7497cf",
+"#5P c #7497d0",
+"arA c #7497d1",
+"arB c #7497d5",
+"#ZW c #7498cf",
+"#Yv c #7498d0",
+"#9k c #749ad1",
+"#5W c #749ad2",
+"#35 c #749ad5",
+"#Na c #750301",
+"#4N c #750605",
+"#t0 c #752307",
+"aCs c #75253d",
+"#b8 c #752811",
+"#E3 c #753112",
+"#3G c #753118",
+".3g c #75321f",
+"#0Y c #753325",
+"#Ja c #753c23",
+".52 c #754931",
+"ajp c #754f40",
+".AY c #755032",
+".8b c #75514a",
+".wz c #755732",
+"#cM c #7582b8",
+"ahA c #758bb7",
+"#cN c #758bc7",
+"#AG c #758cbd",
+"#DE c #758cbf",
+"#kw c #758cc3",
+"#ur c #758dba",
+"#ek c #758ec7",
+"akU c #758ecb",
+"#5K c #758fc3",
+"akV c #758fce",
+"#E9 c #7590c0",
+"asQ c #7591bb",
+"auR c #7592cd",
+"#WR c #7592df",
+"aaG c #7593c8",
+"axS c #7593cc",
+"#32 c #7594cb",
+"atr c #7595d7",
+"asR c #7596c7",
+"axT c #7596d4",
+"a.2 c #7597cf",
+"#7F c #7597d0",
+"#4. c #7597d1",
+"#9n c #7597d2",
+"#Yr c #7598cf",
+"#4# c #7598d1",
+"auf c #7598de",
+"#Ys c #7599cd",
+"a.0 c #7599cf",
+"aFw c #7599db",
+"a.1 c #759ad1",
+"#5V c #759ad3",
+"#0g c #76000b",
+"#Hi c #760214",
+"#OH c #760400",
+"#Ul c #760c1b",
+"#N# c #760d0d",
+"#xx c #761500",
+"#sG c #761902",
+"#vZ c #762004",
+"#Vb c #762d10",
+"ah9 c #763213",
+".6p c #763417",
+"#XU c #76341a",
+"#0N c #763f33",
+".4Z c #76402b",
+"#Ep c #76461c",
+"#N4 c #764737",
+"aid c #764a36",
+"azB c #766c79",
+"avM c #76737a",
+".Ce c #767383",
+"#b# c #7685be",
+"aoj c #7686c4",
+"awS c #7689b0",
+".5# c #7689b1",
+"#iV c #768bc1",
+"#5I c #768cb8",
+"avq c #768cba",
+"#F. c #768cc0",
+"an. c #768dca",
+"#wd c #768ebb",
+"#ze c #768ebd",
+"alY c #768eca",
+"an# c #768ecd",
+"alZ c #768ece",
+"#oQ c #768fc2",
+".jI c #7691bc",
+"#PO c #7692d3",
+"arz c #7694c3",
+"aqO c #7694c7",
+"#Sy c #7694da",
+"aaH c #7695cb",
+"#WS c #7695e5",
+"#Vw c #7696cd",
+"#ZP c #7696d1",
+"aws c #7696d4",
+"#7H c #7697d3",
+"#Vo c #7697e1",
+"aaI c #7698d0",
+"adN c #7698d1",
+"#7G c #7698d2",
+"#ZT c #7699d0",
+"#9i c #769ad0",
+"#5S c #769eda",
+"#FB c #770317",
+"#Q. c #770500",
+"#6x c #77050d",
+"#9M c #770a18",
+"aCx c #77294b",
+"#Zh c #772f17",
+"#3z c #77301c",
+"#as c #773420",
+"#6D c #773a30",
+"#Eo c #77411b",
+".Wo c #77463a",
+".uz c #77494a",
+"aHL c #775a73",
+".z2 c #775e42",
+".u1 c #776141",
+"aGI c #77635e",
+".wf c #776545",
+".qS c #77664d",
+"##7 c #776a60",
+"#.u c #77707c",
+"#J3 c #77717f",
+"aAQ c #77727e",
+"asv c #777379",
+".pC c #777469",
+"aoP c #77747a",
+"aJh c #77757b",
+"#TX c #777da3",
+".3v c #778ab4",
+".8j c #778ab5",
+"#WP c #778cc5",
+"auQ c #778dbd",
+"##C c #778dc7",
+"ae8 c #778ebe",
+"#xM c #778fbd",
+"acf c #7790c3",
+"#3Z c #7792c8",
+"ae9 c #7793c7",
+"#T0 c #7793d8",
+"aaE c #7794c5",
+"#2E c #7794cf",
+"ats c #7795dc",
+"#5N c #7796cb",
+"axj c #7796d0",
+"a.X c #7797c9",
+"ahC c #7797ca",
+"asj c #7797da",
+"#5O c #7798ce",
+"#9j c #779bd2",
+"#5U c #779bd5",
+"#6v c #780007",
+"#1A c #780201",
+"#LI c #780402",
+"#4U c #780c0b",
+"#P8 c #780c10",
+"#Xf c #780d19",
+"#dE c #782309",
+"aCu c #78243d",
+"#Vd c #782d09",
+"ag5 c #782f10",
+"#Zz c #78371d",
+"#CU c #78421c",
+"##t c #784225",
+".06 c #784e36",
+".Wm c #784f49",
+".y. c #78634f",
+"#PA c #786667",
+"##L c #78727d",
+".sE c #787474",
+"#N7 c #78767e",
+".oK c #7876a2",
+"#B9 c #7885ab",
+"#TY c #7885b8",
+"aqM c #7887b7",
+"acb c #788eb8",
+"awT c #7892c5",
+"awr c #7892c8",
+"#Rd c #7892d5",
+"#WQ c #7892d7",
+"avZ c #7894cc",
+"avr c #7894ce",
+"#5M c #7895c8",
+"#1d c #7896ce",
+"#1g c #7896cf",
+"awU c #7897d3",
+"asT c #7897dc",
+"#ZS c #7898d0",
+"#9h c #789bd1",
+"#YQ c #790304",
+"#OG c #790b09",
+"#8b c #791421",
+"aCt c #79273f",
+"#e5 c #792e18",
+"#Zg c #79331b",
+"#60 c #793620",
+"#Tp c #793627",
+"#5p c #79381e",
+"#.P c #793e1d",
+"#63 c #79402d",
+"##u c #794125",
+".8e c #79504b",
+"aML c #796374",
+".82 c #796c6a",
+"aJZ c #797379",
+"apn c #79757b",
+"#Le c #7985ad",
+"ao7 c #7989c4",
+"ary c #798fba",
+"#PP c #7990d3",
+"#Lf c #7991c9",
+"#Vm c #7992d3",
+"#hp c #7993bd",
+"#Yl c #7993d9",
+"#Q4 c #7994bd",
+"#MG c #7995d0",
+"#SJ c #7995d4",
+"aId c #7996ce",
+"aGS c #7996cf",
+"aFv c #7996d0",
+"#31 c #7997cd",
+"#ZR c #7997d1",
+"#ZQ c #7998d2",
+"a.Z c #799cd0",
+"aGT c #799ddf",
+"#YR c #7a010c",
+"#RC c #7a0401",
+"#P9 c #7a0805",
+"#26 c #7a0907",
+"#v0 c #7a1900",
+"#t2 c #7a2c0f",
+"afP c #7a2d0d",
+"#X7 c #7a3011",
+"#8J c #7a3620",
+".P4 c #7a3b2b",
+".9N c #7a3e2a",
+"#an c #7a432c",
+".hQ c #7a4e1c",
+".W3 c #7a503d",
+".43 c #7a5343",
+"aM6 c #7a5c50",
+"aHU c #7a6971",
+".Y4 c #7a728c",
+".vn c #7a7388",
+"#Cp c #7a7e8c",
+"#qa c #7a87af",
+"#np c #7a8ab8",
+"#9a c #7a8db6",
+"#rA c #7a8fbc",
+"#TZ c #7a8fcd",
+"aud c #7a91c1",
+"#9d c #7a94c2",
+"#7r c #7a94c3",
+"#5L c #7a96c9",
+"aE# c #7a96d2",
+"#O. c #7a98ca",
+"#7u c #7a9acf",
+"a.Y c #7a9ccf",
+"#5T c #7a9dd7",
+"#1D c #7b0b13",
+"aCv c #7b253f",
+"##o c #7b2f19",
+"aGF c #7b2f2f",
+"a#n c #7b3233",
+"#Zw c #7b331d",
+".76 c #7b372a",
+"#.4 c #7b3828",
+".9U c #7b3d25",
+"#Pz c #7b4d40",
+".Zw c #7b503b",
+"#L# c #7b522d",
+".3n c #7b533a",
+".3o c #7b533c",
+"aKC c #7b5f71",
+".zD c #7b6a52",
+".bK c #7b6e89",
+"ama c #7b7270",
+"#3R c #7b777e",
+".jo c #7b7c74",
+"#Vl c #7b8dc4",
+"#9b c #7b90bb",
+"avY c #7b90bc",
+"#Sx c #7b91d4",
+"apT c #7b92c8",
+"axi c #7b95c6",
+"atp c #7b97bf",
+"#9f c #7b97c8",
+"aCU c #7b97d4",
+"#T9 c #7b98d4",
+"aNX c #7b9bd0",
+"#YU c #7c0102",
+"#0e c #7c0202",
+"#S3 c #7c0302",
+"#22 c #7c0704",
+"#0h c #7c0a12",
+"#Ry c #7c0b19",
+"#1r c #7c0d1f",
+"#b9 c #7c2f18",
+"#a7 c #7c350f",
+".6o c #7c351a",
+"#Dx c #7c3819",
+"#E# c #7c4149",
+".53 c #7c4e37",
+".8g c #7c524d",
+".Cw c #7c5633",
+".jw c #7c605b",
+".u8 c #7c624c",
+"aKF c #7c6974",
+"#3W c #7c8dae",
+"aE. c #7c8dba",
+"#JO c #7c90bf",
+"#Re c #7c91d6",
+"#7q c #7c94c3",
+"aJD c #7c95c3",
+"#30 c #7c98d0",
+"#1f c #7c98d2",
+"aON c #7c9cd1",
+"af. c #7c9cd4",
+"#9g c #7c9ed4",
+"#Uu c #7d0302",
+"#Xm c #7d0305",
+"#O4 c #7d1700",
+"aCw c #7d2640",
+"#Wp c #7d2e19",
+"#5i c #7d3621",
+"#65 c #7d3a1f",
+"#8K c #7d3a26",
+".3e c #7d3c28",
+".UC c #7d4638",
+"#JJ c #7d4c2c",
+".Wn c #7d5149",
+".4n c #7d5956",
+"aJi c #7d5d62",
+".tH c #7d624a",
+"#N5 c #7d6657",
+".x6 c #7d685d",
+"#Q1 c #7d6e7a",
+"#MC c #7d6f68",
+"#Iv c #7d6f7c",
+"#GA c #7d8fab",
+"#MF c #7d92c1",
+"#PD c #7d93b6",
+"#3Y c #7d95c5",
+"aiI c #7d97c4",
+"#ZM c #7d97ce",
+"#2D c #7d98d1",
+"#7s c #7d99ca",
+"aBv c #7d99d7",
+"#1e c #7d9ad3",
+"aM3 c #7d9cd2",
+"aIe c #7da1e2",
+"#Uq c #7e0303",
+"#Xn c #7e030d",
+"#78 c #7e0410",
+"#YS c #7e0810",
+"#IQ c #7e221d",
+".7O c #7e2d08",
+"#b7 c #7e3119",
+"##p c #7e371d",
+"#Ib c #7e4426",
+"a#S c #7e4938",
+"aKG c #7e4956",
+".tl c #7e6c65",
+"aIK c #7e6c75",
+"#.B c #7e7066",
+"aIr c #7e7d7f",
+"##B c #7e7faa",
+"#lY c #7e86b0",
+"#Sw c #7e8cc4",
+"awq c #7e92bb",
+"#ZL c #7e93bd",
+"ao8 c #7e96cf",
+"aNW c #7e97c5",
+"ace c #7e97c8",
+"aaA c #7e99c3",
+"aaD c #7e9ac8",
+"#2C c #7e9ad1",
+"#7t c #7e9cd0",
+"#RB c #7f0203",
+"#VV c #7f0304",
+"#0j c #7f0405",
+"#6p c #7f0607",
+"#6y c #7f0610",
+"#Xg c #7f0b16",
+"#Va c #7f3a22",
+"#Dy c #7f3a28",
+"aGq c #7f3a5b",
+"#0M c #7f463a",
+".Qv c #7f5142",
+"#MA c #7f6043",
+"#2Q c #7f6667",
+".qA c #7f6f67",
+".fh c #7f6f76",
+"#bH c #7f7270",
+".vO c #7f7281",
+"aG5 c #7f7679",
+".fj c #7f7a75",
+"aAs c #7f7b7c",
+"aur c #7f7c7f",
+"azv c #7f7e87",
+"#Ig c #7f92b5",
+"a.U c #7f94bd",
+"agp c #7f98c9",
+"#9e c #7f9bcb",
+"aAf c #7f9bda",
+"aJE c #7f9ed4",
+"aKV c #7f9fd5",
+"#0i c #800e12",
+"#EF c #80290f",
+"#aC c #802a07",
+"ag9 c #803314",
+"#h5 c #80331f",
+"#X8 c #803413",
+"#e4 c #803e31",
+"#Gv c #804025",
+"#Bn c #804b24",
+".OV c #804e46",
+".eY c #80522f",
+"aGn c #805f72",
+".pn c #806a4c",
+"alf c #80727f",
+".8i c #807c8e",
+"#WO c #808eb9",
+"auc c #808fb4",
+".6J c #8092ba",
+"ae7 c #8093c0",
+"ajO c #8094b9",
+"ay9 c #809cdb",
+"aPJ c #809fd5",
+"#Q# c #810000",
+"#4H c #810200",
+"#S2 c #810304",
+"#73 c #81030c",
+"#Nb c #810403",
+"#VW c #81040c",
+"#OJ c #810708",
+"#Xo c #81070e",
+"#YK c #810810",
+"#VQ c #810a17",
+"#SZ c #810b19",
+"#Xr c #810d07",
+"#Qb c #811016",
+"#EQ c #81240b",
+"#aU c #81311d",
+"aey c #813212",
+"#c. c #81351d",
+"#8I c #813c25",
+".4V c #813e2d",
+"#C0 c #81422a",
+".gr c #81542b",
+".51 c #81553c",
+"#La c #815d3e",
+"aDw c #81767b",
+"arL c #817d83",
+"#PC c #81879d",
+"#DC c #818b9c",
+"#Vk c #818cb5",
+"#sY c #818db0",
+"aaz c #8190b2",
+"#7p c #8198c6",
+"aKU c #8199c8",
+"aaB c #819cc6",
+"#ZN c #819fdd",
+"#4T c #820005",
+"#Ur c #820309",
+"#VZ c #820707",
+"#4Q c #82080c",
+"#yI c #822905",
+"#t3 c #823719",
+"#aT c #823824",
+"#1R c #823917",
+"afG c #825740",
+".7u c #82623d",
+".u9 c #826653",
+".zY c #82694d",
+"#di c #82746b",
+".dO c #82778b",
+"aju c #827e83",
+".sX c #8288aa",
+"#ME c #828dac",
+"#N8 c #828ea6",
+"apS c #8292c8",
+"a.R c #8293b8",
+"aaC c #829dc9",
+"#OI c #830200",
+"#9L c #830a1b",
+"#Z8 c #830c14",
+"#YJ c #83181b",
+"#dD c #832a14",
+"#dC c #833117",
+"#b6 c #83311d",
+"ajm c #83442b",
+"#dr c #834b45",
+".4p c #83573d",
+".3p c #835c4a",
+"#xZ c #837790",
+"aC8 c #837c7e",
+".K# c #837da3",
+"abV c #837e86",
+"aBS c #837f83",
+"#ho c #838197",
+"#Sv c #8389b6",
+"ase c #8399c0",
+"#Yk c #8399d4",
+"acc c #839ac7",
+"aQG c #83a3d8",
+"#6u c #84000a",
+"#Z9 c #840104",
+"#Up c #840305",
+"#S4 c #840308",
+"#4M c #840609",
+"#9I c #840616",
+"#Xp c #84080d",
+"#Xq c #840909",
+"#29 c #84110f",
+"#t9 c #843516",
+"#vQ c #843518",
+"#5h c #843d25",
+"#dt c #844027",
+"ajj c #844528",
+"#mw c #844913",
+"aha c #844a2c",
+"aHR c #844f70",
+".50 c #84573f",
+"##6 c #847776",
+".Hi c #847786",
+"aBR c #847f84",
+".yV c #847f9b",
+".oB c #848096",
+"#Su c #8485aa",
+"a.T c #8498c1",
+"acd c #849ccc",
+"#Xl c #850406",
+"#RD c #850408",
+"#Qa c #850709",
+"#4E c #851318",
+"#xy c #852508",
+"#A# c #852f09",
+"#dF c #853117",
+"#b5 c #853a23",
+"#WE c #853c13",
+"#6Y c #853e24",
+"#6Z c #853f28",
+"#66 c #854026",
+"#64 c #854329",
+"#bW c #85492e",
+"##v c #854c2f",
+"#ar c #854c36",
+"#6P c #855339",
+"aHP c #855575",
+".ta c #85574f",
+".D8 c #855d35",
+"aJf c #856377",
+"#Yd c #856b61",
+".mx c #85746c",
+".dN c #857a8f",
+"aAp c #858082",
+"ay8 c #8595c6",
+"ago c #859ac7",
+"#27 c #860206",
+"#RA c #860308",
+"#0. c #860309",
+"#6z c #860311",
+"#1z c #860402",
+"#VU c #860406",
+"#VX c #86060d",
+"#6q c #86070a",
+"#9J c #860718",
+"#Nc c #861414",
+"#F8 c #862807",
+"##h c #863b25",
+"#US c #863c1d",
+"a.l c #863e27",
+"#3y c #863e28",
+"ai# c #863f24",
+"#FR c #864418",
+"#b4 c #86462b",
+".R4 c #86583b",
+"av4 c #866c63",
+".zZ c #866d51",
+".jm c #867372",
+".rU c #867966",
+".b9 c #86838f",
+"#iU c #8685a9",
+"#oP c #8689a9",
+"ae6 c #8695bf",
+"#74 c #87040f",
+"#6A c #870412",
+"#VY c #87050b",
+"#YL c #87070e",
+"#YT c #871115",
+"#6B c #87121b",
+"aGC c #874349",
+"#Wv c #87462a",
+".9w c #87473a",
+"#Zb c #874d31",
+".Vc c #875242",
+".9h c #875330",
+".XX c #875745",
+"ahb c #875a43",
+"#3d c #875f39",
+"akq c #876357",
+"aKD c #87687b",
+"#ZE c #876e64",
+"#ph c #87736a",
+".dF c #877e86",
+"#E8 c #8796ab",
+"#Yj c #8797c3",
+"aAe c #8797c8",
+"aCT c #8798c6",
+"#3X c #879cc5",
+"adM c #879ccd",
+"aL7 c #879fce",
+"#0d c #880403",
+"#S1 c #880409",
+"#Rz c #880711",
+"#9K c #88091a",
+"#Um c #880a17",
+"#V0 c #881d14",
+"#Au c #882c0d",
+"#TR c #883c18",
+"a.k c #884228",
+"#XP c #88422d",
+"#bX c #884325",
+"aia c #88452a",
+"#2h c #88463b",
+".9r c #885140",
+"#JI c #885530",
+".rP c #885b45",
+".uG c #885b5d",
+".8f c #885f59",
+"aEd c #886c5f",
+"aJd c #886d7f",
+"#.p c #887977",
+".xB c #887b8a",
+".Hd c #887e7b",
+"#ei c #887e9d",
+"#J4 c #88808d",
+"ad8 c #888180",
+"#fS c #88839c",
+".Xq c #8883a9",
+".rd c #88848a",
+".Cf c #888496",
+"aKE c #888993",
+"#AF c #8889a4",
+"#Q3 c #8893b2",
+"#5J c #88a0d2",
+"aM2 c #88a1cf",
+"#1u c #890104",
+"#Xh c #890711",
+"#aV c #893520",
+"ag6 c #894021",
+".9T c #894631",
+"#15 c #894723",
+".mi c #895531",
+"aHJ c #895a75",
+"aGB c #895c61",
+"aso c #896d65",
+"ap0 c #897068",
+"#XJ c #89736d",
+"#bI c #897b71",
+"aBE c #898486",
+"#q# c #8986a0",
+"#kv c #898bb1",
+"#JN c #898daa",
+"#77 c #8a0414",
+"#4I c #8a0505",
+"#Us c #8a050c",
+"#YV c #8a0d09",
+"#72 c #8a1219",
+"#iP c #8a2f17",
+"#ES c #8a3116",
+"#pG c #8a3210",
+"#BA c #8a330d",
+"#eg c #8a3e2f",
+"#t7 c #8a3f20",
+".3c c #8a4328",
+"#aA c #8a432f",
+"#8G c #8a4428",
+".1z c #8a4a32",
+".4Y c #8a4d3a",
+".kE c #8a5536",
+"##s c #8a5537",
+"#.U c #8a5847",
+"#Y9 c #8a5b31",
+".2L c #8a5f45",
+".07 c #8a5f46",
+".2K c #8a614f",
+"aGH c #8a625d",
+"aGo c #8a6378",
+"aHN c #8a6581",
+"#MB c #8a705b",
+"aKz c #8a7484",
+".we c #8a7952",
+".h4 c #8a797a",
+"#cL c #8a7ea3",
+"aJ0 c #8a8288",
+"#MD c #8a8894",
+"#rz c #8a90b0",
+"aBu c #8a9aca",
+"#S0 c #8b0711",
+"#6n c #8b0c13",
+"aI4 c #8b2d3a",
+"#ER c #8b3015",
+"#E4 c #8b4836",
+".Qh c #8b4939",
+"#.X c #8b4e3c",
+"#CV c #8b592e",
+".4q c #8b5f45",
+"#B. c #8b616a",
+".qX c #8b796c",
+"aG0 c #8b8184",
+"#b. c #8b83ac",
+".33 c #8b849e",
+"#wP c #8b8d9b",
+"#TW c #8b8dab",
+"#4S c #8c0008",
+"#2X c #8c0402",
+"#YP c #8c0406",
+"#0# c #8c0409",
+"#Uo c #8c040a",
+"aGD c #8c2c36",
+"afQ c #8c3f1f",
+"#1P c #8c4120",
+"#t6 c #8c4222",
+"#8H c #8c462c",
+".3d c #8c472b",
+"#02 c #8c4c32",
+"#Ww c #8c4d33",
+"aa2 c #8c5554",
+"#Bm c #8c5a39",
+"#Mz c #8c5d49",
+"a#O c #8c8185",
+".ij c #8c8193",
+".DZ c #8c827f",
+"aqo c #8c898f",
+"#28 c #8d0005",
+"#S5 c #8d040b",
+"#75 c #8d0513",
+"#1G c #8d0605",
+"#1F c #8d1113",
+"#EH c #8d3219",
+"#EG c #8d341b",
+".7N c #8d3d17",
+"#Zx c #8d422a",
+"#t4 c #8d4324",
+".6c c #8d4827",
+"##q c #8d482c",
+"#UM c #8d491f",
+"#Bt c #8d4b31",
+".P5 c #8d4f3f",
+"#18 c #8d5950",
+"#Eq c #8d5b38",
+".6z c #8d644c",
+"aKw c #8d6e81",
+"asY c #8d7167",
+"aJb c #8d7586",
+"aFY c #8d7d84",
+"#N6 c #8d7e77",
+".ae c #8d809b",
+"#PB c #8d848d",
+"#RE c #8e030a",
+"#Xk c #8e0408",
+"#VR c #8e0812",
+"#2U c #8e141a",
+"#71 c #8e2428",
+"aGw c #8e315a",
+"#Zy c #8e4127",
+"#TP c #8e4428",
+"#WD c #8e451e",
+"#5q c #8e4930",
+".4X c #8e4d3c",
+".7M c #8e4f44",
+".7w c #8e5e3a",
+".5Y c #8e6965",
+"#2r c #8e766c",
+"aKA c #8e7889",
+"#St c #8e7a7b",
+"aF2 c #8e7e85",
+".83 c #8e8077",
+"aEK c #8e8086",
+"#zd c #8e8394",
+"aC4 c #8e878a",
+"aAq c #8e898b",
+"#Q2 c #8e899c",
+"a.S c #8ea0c8",
+"#6t c #8f020d",
+"#VT c #8f0409",
+"#YM c #8f050b",
+"#6r c #8f060e",
+"#21 c #8f0709",
+"#Un c #8f0710",
+"#0k c #8f0c0a",
+"#vI c #8f3311",
+"#u. c #8f3e21",
+"ag8 c #8f4325",
+"a.m c #8f4430",
+"a.j c #8f4a2d",
+"ac9 c #8f4c29",
+"abE c #8f4c2a",
+"ajl c #8f5032",
+"aGG c #8f514e",
+"#Gw c #8f543b",
+"#HE c #8f5b3a",
+".FN c #8f653a",
+".3q c #8f6d61",
+"aL9 c #8f7266",
+"#Lb c #8f7361",
+"#no c #8f879f",
+"#1v c #900406",
+"#76 c #900515",
+"#4R c #900710",
+"#EP c #903118",
+"#BW c #903416",
+"#ss c #903514",
+"aGu c #903961",
+"#aD c #903b17",
+"#4D c #903d3e",
+"a#2 c #90482d",
+"#UR c #90492a",
+"#aS c #904935",
+"a#1 c #904c2c",
+"aGp c #904d6d",
+".4A c #90553f",
+"ah2 c #905642",
+"#17 c #905a51",
+"#CT c #905e3d",
+".qs c #906341",
+"atx c #90776d",
+".Ty c #907b77",
+".C8 c #908275",
+"aoC c #90858a",
+"aJ5 c #90878d",
+".AO c #908c9b",
+"aIs c #908e90",
+"aGE c #91202e",
+"#6m c #912c2e",
+"#EM c #912d16",
+"#kq c #91361e",
+"#su c #913a1b",
+"afS c #913f20",
+"aKp c #914235",
+"a#3 c #91442d",
+"#t5 c #914829",
+"#Wl c #914c34",
+"#0K c #914d2e",
+".4B c #915640",
+".4o c #916451",
+".1K c #916b51",
+"#.M c #916c56",
+".jz c #917c7a",
+".gL c #918482",
+"aG6 c #91858b",
+"ak7 c #918785",
+".jj c #918a94",
+"aAr c #918c8e",
+".mO c #919898",
+".il c #919eb6",
+"#RF c #92050b",
+"#Xi c #92050d",
+"#1H c #921108",
+"#S7 c #921817",
+"#EI c #92341c",
+"#F7 c #923913",
+"aGs c #924569",
+"#fQ c #924632",
+"ai. c #924d2f",
+"a.i c #924e2e",
+".Qg c #925141",
+"#Wx c #92533a",
+"aeG c #925737",
+"#.O c #925f3b",
+".2M c #92674c",
+".j. c #92682f",
+".42 c #926d5d",
+"#WL c #92766d",
+"avy c #92786f",
+".ff c #928289",
+"aEM c #92848b",
+".ID c #928cb1",
+"aw3 c #928f91",
+"#VS c #93050d",
+"#1y c #930605",
+"#2Y c #930606",
+"#4L c #93070d",
+"#Ut c #930c12",
+"#1s c #930e17",
+"#Qv c #932705",
+"#Qw c #93281a",
+"#EJ c #93331c",
+"#5t c #934329",
+"afR c #934625",
+"#8N c #934a2f",
+"#0v c #934b20",
+"#0L c #934d2f",
+"#TS c #935132",
+"#8L c #93523e",
+".Qf c #935241",
+".Qi c #935544",
+"#Es c #935947",
+"#b1 c #935b3d",
+"aep c #936149",
+"#Vg c #93766e",
+"aul c #937a70",
+".7i c #938a92",
+"#.h c #938c87",
+"axu c #939199",
+".B5 c #9391b9",
+".oe c #939b94",
+"#YO c #940407",
+"#Xj c #94040a",
+"#6s c #94040f",
+"#0c c #940505",
+"#6o c #94050f",
+"#0a c #940609",
+"#4J c #94070b",
+"#sF c #943a22",
+"#sv c #944122",
+".1x c #944a30",
+"#6X c #944e32",
+"ah8 c #945031",
+"aMO c #945067",
+".4W c #945140",
+".Qj c #945745",
+"aCy c #945c76",
+"agX c #945f47",
+"afY c #946e5a",
+"aGA c #94747b",
+".0. c #94755e",
+".8h c #94807d",
+".zW c #948467",
+".v1 c #94888b",
+".uC c #948a77",
+".aw c #948ca8",
+"#Ld c #9492a6",
+"#YN c #950409",
+"#1t c #950507",
+"#UT c #95492b",
+"#5g c #954f35",
+"#B3 c #955132",
+"#2l c #95553b",
+"#zY c #956442",
+"#4X c #956940",
+".1L c #957560",
+".tq c #958254",
+"aHp c #95848c",
+"#eF c #958f9e",
+"#EO c #96341c",
+"#tX c #963918",
+"#aX c #964228",
+"#gD c #964826",
+"afN c #964a29",
+"#1O c #964b1e",
+"#hm c #964b34",
+"#WC c #964d2b",
+"#8O c #964d31",
+"#8M c #964d33",
+".1y c #964e34",
+"#zZ c #96603a",
+"#Ic c #966147",
+".4r c #966950",
+".Hm c #966b3e",
+".SR c #966f47",
+"a#R c #966f61",
+"#iT c #967781",
+"auY c #967c72",
+"#zK c #967e90",
+"#lX c #968495",
+"#Lc c #968686",
+"#zo c #968897",
+"aFI c #968a90",
+".Hh c #968a95",
+"#E7 c #968e85",
+"aBJ c #969192",
+"af4 c #969296",
+"#4F c #970812",
+"#S6 c #970c13",
+"#O5 c #973227",
+"#EN c #97341c",
+"#xe c #973e1a",
+"#Hj c #97453f",
+"#3J c #97462d",
+"#2k c #974735",
+"#UU c #97492c",
+"#0t c #974c24",
+"#tK c #974f27",
+"adi c #975328",
+"a#0 c #975532",
+"ac8 c #975630",
+"##y c #975b40",
+"#Dz c #975d49",
+"#b3 c #976041",
+".Wp c #97614f",
+".nL c #97663e",
+"#En c #976644",
+".9f c #977450",
+"#4z c #978484",
+"#oO c #978899",
+"aEL c #978990",
+".vL c #978c8e",
+".dE c #978e95",
+"aIt c #979097",
+"#Iz c #9791a0",
+"#B8 c #9799a3",
+"#0b c #980607",
+"#1w c #980708",
+"aH0 c #983237",
+"#y0 c #98371a",
+"#At c #98381b",
+"#y2 c #983b1d",
+"#aW c #98432b",
+"abF c #984830",
+"#TQ c #984a28",
+"#0s c #984d1b",
+"ag4 c #984f2f",
+"ag7 c #984f30",
+"#WB c #985032",
+"#0Z c #98503f",
+"#WA c #985239",
+"#8F c #985435",
+".Qe c #985646",
+"abD c #985732",
+"#ds c #985b4d",
+"ajd c #986456",
+".5Z c #986a57",
+".IL c #987048",
+".4k c #98733e",
+".jy c #987f7c",
+"aBK c #989094",
+"aJ1 c #989095",
+".2l c #9893b5",
+"#2V c #99010c",
+"#4K c #99080f",
+"aMP c #99354f",
+"#sH c #993b25",
+"#Ny c #993d36",
+"#EE c #994328",
+"#L5 c #994940",
+"#01 c #994b36",
+"#dQ c #994c25",
+"#t8 c #994c2d",
+"ag3 c #995031",
+"#3H c #995037",
+"#67 c #995137",
+"#3x c #995139",
+"#gy c #995348",
+".6q c #995c3e",
+"#I3 c #99643a",
+"#Bo c #996538",
+"#cK c #996b75",
+"#Q0 c #996c60",
+".kT c #998880",
+"aHq c #998890",
+".fd c #998990",
+".xz c #998d94",
+"aEm c #998f94",
+"#bw c #99909e",
+"aJ2 c #999197",
+"aIu c #999299",
+".Cm c #99969f",
+"#1x c #9a0807",
+"#2Z c #9a080b",
+"#20 c #9a080d",
+"#aE c #9a4823",
+"#7. c #9a4c30",
+"#lc c #9a4d29",
+"afO c #9a4d2c",
+".Qk c #9a5d4a",
+"#.V c #9a5f4e",
+"aic c #9a644c",
+"#CE c #9a656c",
+"#eh c #9a6a6f",
+"aac c #9a6f56",
+"#JK c #9a7058",
+"apd c #9a7e75",
+"#Fh c #9a838a",
+".r5 c #9a8560",
+"aJ9 c #9a8a92",
+".xi c #9a8eaa",
+"aD# c #9a9196",
+"#LJ c #9b3634",
+"aKv c #9b385f",
+"#fc c #9b3d25",
+"#fd c #9b4024",
+"ad# c #9b4a31",
+"aex c #9b4c2c",
+"#at c #9b513f",
+".4R c #9b553a",
+"#aB c #9b5541",
+"#dx c #9b5638",
+"#Wu c #9b583a",
+"#0J c #9b593a",
+".1A c #9b5a42",
+".4z c #9b604a",
+"#gu c #9b6634",
+".xU c #9b866e",
+"aIM c #9b8992",
+"aLK c #9b8a99",
+".kX c #9b8f69",
+"#AE c #9b9294",
+"aFH c #9b9295",
+".8H c #9b9482",
+".h1 c #9b949d",
+"aBZ c #9b99a3",
+".wF c #9b9eae",
+"aMW c #9c3941",
+"#jM c #9c4926",
+"#3K c #9c4931",
+"#jL c #9c4b28",
+".3b c #9c5238",
+".2X c #9c5a44",
+"aji c #9c5d3f",
+"#k6 c #9c632c",
+"#ae c #9c6433",
+"##r c #9c6749",
+"#5. c #9c684b",
+".2D c #9c6c31",
+"#FY c #9c6c44",
+".Ro c #9c754c",
+"#xL c #9c858d",
+".k2 c #9c908f",
+"aC9 c #9c9398",
+"aJ3 c #9c9499",
+"aAP c #9c9699",
+"ayd c #9c9aa4",
+"aMC c #9d2e3f",
+"#Ml c #9d4828",
+"aGt c #9d4a70",
+"a#4 c #9d4b37",
+"aew c #9d4f2e",
+"#ca c #9d5139",
+"#c# c #9d513a",
+"adg c #9d532c",
+"#Wq c #9d5330",
+"#jI c #9d533e",
+"#V# c #9d5626",
+".2W c #9d5b45",
+"#We c #9d612e",
+".71 c #9d634d",
+".7E c #9d6356",
+"#bR c #9d6635",
+"ac0 c #9d6c5e",
+".9g c #9d704a",
+".Yx c #9d745b",
+".Ki c #9d764d",
+"abQ c #9d7760",
+".2E c #9d7845",
+".u6 c #9d866a",
+"aDN c #9d868f",
+".BF c #9d8974",
+"aMH c #9d909e",
+"#yh c #9d94a4",
+"aEy c #9d969b",
+"aDW c #9e315e",
+"aKu c #9e3b5d",
+"#cb c #9e533b",
+"#5e c #9e542c",
+"ad. c #9e5536",
+"#2i c #9e5647",
+"#ZA c #9e593b",
+"#Wz c #9e5949",
+"#bZ c #9e5b42",
+"#CX c #9e674c",
+"#0w c #9e6942",
+".We c #9e6d3c",
+".XO c #9e6e3a",
+".92 c #9e6e60",
+".2N c #9e7156",
+"aHK c #9e849c",
+".Xn c #9e949c",
+"aD. c #9e9599",
+"aFU c #9e959b",
+"aBL c #9e969a",
+"aIF c #9e969c",
+"aIv c #9e969d",
+"auz c #9e9ca3",
+"#2W c #9f0004",
+"aE7 c #9f2953",
+"aMA c #9f2b33",
+"#Gd c #9f3f2c",
+"#rh c #9f432c",
+"#sr c #9f4532",
+"#fb c #9f482b",
+"#h9 c #9f4a27",
+"#aR c #9f4e38",
+"#lk c #9f5125",
+"#ch c #9f522b",
+"#2j c #9f5242",
+"#Y4 c #9f5422",
+"#3v c #9f542d",
+"aa# c #9f5430",
+"afW c #9f5a36",
+"#CW c #9f6b46",
+".7q c #9f6b4b",
+".Ol c #9f6c3a",
+".MY c #9f6c3b",
+"#Ea c #9f6f81",
+"a.x c #9f7059",
+"aHO c #9f7492",
+".5T c #9f7a44",
+".S1 c #9f7b6d",
+"aCZ c #9f8375",
+"#07 c #9f867c",
+"aKy c #9f8798",
+"aG4 c #9f9699",
+"#OK c #a0363a",
+"#F9 c #a04121",
+"aeC c #a04925",
+"aev c #a05131",
+"#bY c #a05338",
+"#Wy c #a05b4c",
+"a.h c #a05c3b",
+"#al c #a05d3f",
+"#h0 c #a06730",
+".9b c #a06c4c",
+"ajo c #a06f5c",
+".0Y c #a07038",
+"#4W c #a07144",
+".p. c #a07148",
+"#Ss c #a08179",
+".qz c #a08774",
+"aJ4 c #a0989e",
+"#dj c #a0989f",
+".uf c #a09fb8",
+"#4G c #a1010e",
+"aMB c #a11e31",
+"aDO c #a1274c",
+"aLS c #a13149",
+"#Gc c #a1402d",
+"#q5 c #a14725",
+"a#7 c #a14b2f",
+"#ua c #a14c2f",
+"#sD c #a14f35",
+"#XA c #a1541a",
+"#69 c #a15438",
+"#5s c #a1543a",
+"#8P c #a1573b",
+"adh c #a15b31",
+"#16 c #a15d3a",
+".2Y c #a15f49",
+"#Hw c #a16339",
+"#b0 c #a16348",
+"#FQ c #a1653c",
+"akl c #a1674a",
+"#Hv c #a16d46",
+"#Sr c #a16f5b",
+".Zx c #a1735c",
+"aJ. c #a17f94",
+"#TU c #a1827a",
+"#ku c #a18693",
+"aB6 c #a1999d",
+".h7 c #a19b95",
+"#0l c #a2261c",
+"aE8 c #a22a55",
+"#EK c #a24029",
+"#oj c #a24e2b",
+"#3u c #a25430",
+"#00 c #a25642",
+"#1N c #a25719",
+"#e8 c #a25737",
+"#0r c #a25815",
+"#Hx c #a25c30",
+"#a5 c #a25c36",
+"#6W c #a25c3f",
+"#5f c #a25c41",
+"#3# c #a25e4c",
+"ac7 c #a26139",
+"#14 c #a2613d",
+"#ak c #a26646",
+"#do c #a26d3b",
+".PS c #a26f3d",
+"aMN c #a27c8e",
+".Us c #a27f56",
+"aKB c #a28a9b",
+"aJc c #a28a9c",
+".8M c #a294aa",
+"aMI c #a295a2",
+"aG7 c #a2969b",
+".2h c #a296a2",
+"aj2 c #a29793",
+"#wR c #a2989a",
+"#If c #a2a1b4",
+"aLZ c #a3282d",
+"aKs c #a33c50",
+"#KV c #a34b2e",
+"afT c #a34f2d",
+"#oy c #a35030",
+"#9G c #a35050",
+"a.p c #a35338",
+"a.q c #a35438",
+"abN c #a35832",
+".9L c #a35b42",
+"#Ts c #a35e34",
+"#dA c #a36540",
+"#Ia c #a36747",
+"akn c #a3694c",
+".LG c #a3703e",
+"#CF c #a3788a",
+".zS c #a3917e",
+".uK c #a39189",
+".fc c #a39299",
+".zJ c #a39478",
+"aDu c #a3979d",
+"aIw c #a39ca3",
+"aLE c #a41e35",
+"aLD c #a42633",
+"aFd c #a4416c",
+"#pC c #a4432a",
+"aKH c #a44655",
+"#ET c #a44c30",
+"#yH c #a44d28",
+"a#8 c #a44f32",
+"afU c #a4502a",
+"#oz c #a45131",
+"#m7 c #a45338",
+"aeA c #a45534",
+"#du c #a4563c",
+"#6U c #a4572f",
+"a.n c #a45846",
+"#Y3 c #a4591f",
+"#3w c #a45d44",
+"ah# c #a4603f",
+".2Z c #a4634d",
+".P6 c #a46556",
+".Ql c #a46753",
+"#jH c #a46a5c",
+"#Ku c #a46c3f",
+".7I c #a46c5f",
+"#XG c #a46f3c",
+"#iS c #a46f64",
+".R3 c #a47356",
+".08 c #a4765c",
+"#fR c #a47776",
+".PT c #a47d54",
+".Z9 c #a47d60",
+".XP c #a48054",
+"aKY c #a4867a",
+"#JL c #a4867d",
+"anf c #a4877d",
+"#nn c #a48890",
+"#zn c #a49699",
+"aG8 c #a4989e",
+".IE c #a4a0c7",
+".G4 c #a4a2cf",
+"aDQ c #a5274e",
+"aI9 c #a5497e",
+"#Av c #a54d2d",
+"#Mm c #a5512e",
+"#dG c #a55137",
+"#V9 c #a55619",
+"afM c #a55838",
+"#5r c #a55b42",
+"aLR c #a55d73",
+"#8E c #a56040",
+"abC c #a5633c",
+"a#Z c #a5633e",
+".Qd c #a56353",
+"#XL c #a56850",
+"#L. c #a5755d",
+".LH c #a57d55",
+"#zc c #a59089",
+".tM c #a59183",
+"aF3 c #a5959c",
+"aIE c #a59ca2",
+".js c #a5a59d",
+".rq c #a5a5b4",
+"#Uv c #a64338",
+"#pB c #a64729",
+"#Aa c #a64c29",
+"#Mh c #a64f32",
+"abG c #a6503c",
+"aeB c #a65232",
+"#5u c #a6543b",
+"a.o c #a6553b",
+"#aY c #a65639",
+"#So c #a65836",
+"aeF c #a65b34",
+"ag2 c #a65d3d",
+"#03 c #a66244",
+".20 c #a6644e",
+"#Br c #a66852",
+".7p c #a66d3d",
+".Rn c #a67341",
+"aGx c #a6738e",
+"##z c #a67975",
+"#.N c #a67c5a",
+".7v c #a67e56",
+".w. c #a6906e",
+"aHr c #a6959c",
+".95 c #a69aab",
+"azA c #a69ca8",
+"aID c #a69da3",
+"#vi c #a69ea2",
+"aBQ c #a69fa3",
+"aDP c #a72c52",
+"aI5 c #a7485f",
+"#Nw c #a74b1e",
+"#F6 c #a74f29",
+"a#6 c #a74f34",
+"#Y# c #a75e3a",
+"aGr c #a75e80",
+"#dB c #a76040",
+"#a4 c #a7633c",
+"#.W c #a76455",
+"#I4 c #a76539",
+".6w c #a76b5a",
+"#h4 c #a76b5e",
+".4C c #a76c56",
+"#jD c #a76e37",
+".Kh c #a77442",
+".Qu c #a77565",
+".Ur c #a77747",
+"aGy c #a77c92",
+".wu c #a78863",
+".yg c #a78a69",
+"anD c #a79ba1",
+"aDa c #a79ea3",
+".uU c #a7a088",
+"aDR c #a82850",
+"aLF c #a83048",
+"aKO c #a8312d",
+"#Ge c #a84931",
+"aKq c #a84a49",
+"#xf c #a84d2b",
+"#Mi c #a85035",
+"#Mk c #a85334",
+"#5d c #a85a34",
+"#3I c #a85a42",
+"#sC c #a85b3f",
+"#68 c #a85e43",
+"ah7 c #a86345",
+".Zp c #a88456",
+"#tx c #a89190",
+"afp c #a89b96",
+"ahX c #a8a5ac",
+".h0 c #a8a5b1",
+".jv c #a8a8a0",
+"aE9 c #a92e5a",
+"aMV c #a92f39",
+"aKr c #a9434d",
+"#EL c #a94730",
+"#xz c #a94d2e",
+"#KW c #a95133",
+"#Mj c #a95137",
+"aez c #a95a39",
+"#0n c #a95b3b",
+"a.t c #a95e3c",
+"#KE c #a96252",
+"#Zf c #a9664d",
+"#z4 c #a9664e",
+".2V c #a96751",
+"ajk c #a96a4c",
+"#Y8 c #a96d33",
+"akg c #a96f52",
+".7J c #a96f62",
+"ako c #a97059",
+".Vb c #a97060",
+".9a c #a97140",
+"a.a c #a9715d",
+".9o c #a97365",
+".SQ c #a97644",
+"#yt c #a97755",
+"#h1 c #a9784a",
+".Zo c #a97943",
+"#s# c #a98161",
+"#7Y c #a98178",
+"aKx c #a98d9f",
+"aHo c #a9989f",
+".gO c #a99c9a",
+".tu c #a99e86",
+"ad7 c #a9a09e",
+"aIx c #a9a2a9",
+".7j c #a9a2b1",
+".ri c #a9a5ab",
+"aF. c #aa2b58",
+"#ie c #aa4a24",
+"#tW c #aa4e2d",
+"abJ c #aa4f33",
+"#oi c #aa5532",
+".7X c #aa5b2b",
+"#vT c #aa5d3e",
+"aaa c #aa613b",
+".Qc c #aa6858",
+".ZZ c #aa6c4f",
+".IK c #aa7746",
+"#hn c #aa7f7b",
+".MZ c #aa835a",
+"akf c #aa8b81",
+".xV c #aa957b",
+"aiV c #aa9c97",
+".qQ c #aa9d6e",
+"#7U c #aa9f94",
+"aHf c #aaa1a7",
+".y8 c #aaa7af",
+".Xr c #aaaacf",
+"#uc c #ab4a2d",
+"#aO c #ab4e33",
+"abI c #ab4e34",
+"#y3 c #ab5333",
+"#Bz c #ab572f",
+"#aQ c #ab5741",
+"#1J c #ab5b3b",
+"#UV c #ab5c3f",
+"#cG c #ab5e33",
+"#Y2 c #ab6118",
+"a.g c #ab6744",
+".6s c #ab6859",
+".77 c #ab6959",
+"abw c #ab6b55",
+".78 c #ab6e5a",
+"#e0 c #ab7644",
+"#b2 c #ab7757",
+".5S c #ab7b3d",
+"#a9 c #ab8594",
+".Wf c #ab875d",
+"aEn c #aba1a6",
+"aEl c #aba3a5",
+".oD c #aba6bd",
+"awA c #aba7aa",
+"alC c #aba7ab",
+"#G. c #ac4d2f",
+"ada c #ac523e",
+"##c c #ac5426",
+"#kr c #ac583f",
+"a.r c #ac5e40",
+"#FC c #ac6159",
+"#Y6 c #ac632b",
+"#Tt c #ac643b",
+"#Wt c #ac6647",
+"#TO c #ac664e",
+"#R3 c #ac6737",
+"#OV c #ac6a36",
+".Qb c #ac6a5a",
+"#sT c #ac6c46",
+"#No c #ac6d3b",
+"alu c #ac7659",
+"#Id c #ac8373",
+".0Z c #ac8757",
+"asn c #ac8d80",
+"aBA c #ac9083",
+"aME c #ac96a7",
+".qJ c #ac9983",
+"#zL c #ac99a8",
+".zT c #ac9a85",
+"aG9 c #aca0a6",
+"aH. c #aca1a6",
+"aHh c #aca4aa",
+"aus c #aca9ab",
+"#KU c #ad523b",
+"abK c #ad5537",
+"#C6 c #ad5631",
+"a#5 c #ad5947",
+"aMD c #ad5964",
+"adf c #ad5d39",
+"#I6 c #ad622a",
+"#8Q c #ad6244",
+"abz c #ad6431",
+"#6V c #ad6439",
+".6n c #ad6449",
+"#Kz c #ad652f",
+"#B4 c #ad6753",
+"#LV c #ad7242",
+".4y c #ad725c",
+"##w c #ad7357",
+"#gv c #ad7657",
+".XY c #ad7963",
+".4j c #ad7c40",
+"akp c #ad7c69",
+".Z8 c #ad8161",
+"#B6 c #ad8266",
+"#lW c #ad8584",
+"aPL c #ad897b",
+"aE6 c #ad8f9d",
+"#GZ c #ad949b",
+"#r5 c #ad9d95",
+"#DB c #ada194",
+".vx c #ada5a6",
+"aEw c #ada6ac",
+"aDh c #ada7ac",
+"aoy c #ada9af",
+"#Gz c #ada9b4",
+".fk c #adaaaa",
+"#O3 c #ae470f",
+"#gK c #ae4f33",
+"#ow c #ae573f",
+"#A. c #ae5a32",
+"#3t c #ae5b3a",
+"#UE c #ae5d24",
+"#.7 c #ae5d38",
+"#8S c #ae6142",
+".1w c #ae6148",
+"a.s c #ae6242",
+"#8R c #ae6243",
+"a.u c #ae6341",
+"#dw c #ae6348",
+"abO c #ae663e",
+"#a6 c #ae6841",
+"#7a c #ae6b4b",
+"#Sq c #ae6b4d",
+"#0I c #ae6e4e",
+"aib c #ae7056",
+".9p c #ae7163",
+".4D c #ae745d",
+"#.I c #ae7645",
+"alv c #ae7a64",
+"#aj c #ae7b5d",
+"#Gx c #ae7e6c",
+"#6k c #ae7e79",
+"#tF c #ae8266",
+"#Z# c #aea09e",
+"#JM c #aea0a9",
+"aFC c #aea4a7",
+"aEg c #aea5a8",
+"aDb c #aea5aa",
+"aIC c #aea5ab",
+"aIB c #aea6ac",
+"#yj c #aea9af",
+"#bz c #aea9cd",
+"awG c #aeabb2",
+"aJg c #aebdc2",
+"aMS c #af1d30",
+"aKI c #af2a39",
+"aDS c #af2b54",
+"aF# c #af2c5a",
+"aKt c #af4a66",
+"#st c #af5534",
+"##f c #af583c",
+"#hj c #af6045",
+"#WI c #af6641",
+"#Wr c #af6643",
+"#8D c #af6738",
+"a#X c #af6932",
+"ah6 c #af6a4b",
+"aMX c #af6d71",
+"#3N c #af7048",
+"#8U c #af7456",
+"#9D c #af9084",
+"QtC c #af9f9c",
+"aHe c #afa6ac",
+"aIy c #afa7ae",
+"aDi c #afa9ae",
+"aFa c #b02959",
+"#pF c #b04e3d",
+"#v1 c #b05033",
+"#Dq c #b05436",
+"#70 c #b05c5b",
+"#3L c #b06541",
+".4Q c #b0674c",
+"ac5 c #b06b30",
+".4E c #b06c4c",
+"#Ve c #b06f50",
+"afH c #b07054",
+".Qm c #b0735e",
+"akk c #b07659",
+"#dp c #b0795a",
+"alo c #b0795d",
+"#4C c #b07977",
+"#wc c #b08f90",
+"aeI c #b09081",
+"#AD c #b0947b",
+"aGm c #b095a5",
+".z6 c #b09c93",
+"#B7 c #b09d8b",
+"#AR c #b0a097",
+"aHa c #b0a4aa",
+"aBP c #b0a9ad",
+"aMR c #b1243c",
+"aDU c #b12752",
+"aGv c #b1567f",
+"aeD c #b15830",
+"#iO c #b1593d",
+"#.6 c #b15e3a",
+"#7# c #b16145",
+"#L2 c #b16332",
+"#ec c #b1633a",
+"aa. c #b16341",
+"aKP c #b1635e",
+"#Nz c #b16737",
+"ah. c #b16746",
+"#Sn c #b1674a",
+"#ip c #b16c49",
+"#UQ c #b16d4c",
+"a#Y c #b16e48",
+".P7 c #b17263",
+"#bS c #b17b5c",
+".09 c #b18165",
+".Rz c #b18a78",
+"aOP c #b18d7f",
+"aLQ c #b18d9e",
+"arG c #b19387",
+"ad2 c #b19d93",
+".qy c #b19f8d",
+"acq c #b1a08c",
+".sm c #b1a193",
+"ahP c #b1a29b",
+"al5 c #b1a2a4",
+".vb c #b1a38a",
+"#zm c #b1a39f",
+".gS c #b1aab3",
+".sy c #b1adad",
+"avE c #b1aeb0",
+"axz c #b1afb6",
+".mV c #b1b9c6",
+"aDT c #b22a55",
+"#RG c #b23836",
+"#pE c #b2503e",
+"#pD c #b2513b",
+"#G# c #b25237",
+"#Gb c #b2523c",
+"#QW c #b25937",
+"#cw c #b25a40",
+"#Mg c #b25c3c",
+"#h8 c #b25f3d",
+".7P c #b2623d",
+"#m6 c #b26448",
+"#fp c #b2653e",
+"#XE c #b2660f",
+"#Xz c #b26627",
+"#Qm c #b26d39",
+"#XO c #b26e58",
+"#a3 c #b27048",
+"#Gu c #b27156",
+"#nW c #b27740",
+"als c #b27b5f",
+"#yu c #b27c56",
+"#FP c #b27f59",
+".p# c #b28e6d",
+"avx c #b29181",
+"#Ba c #b294a3",
+"#Bd c #b2a39b",
+"aEJ c #b2a5ab",
+"aH# c #b2a6ac",
+"#98 c #b2a7a9",
+"aFJ c #b2a7ac",
+"aHg c #b2a9af",
+"#wQ c #b2b2ba",
+"#lT c #b35a42",
+"#xA c #b35b3b",
+"#dv c #b35d46",
+"#Mn c #b35e39",
+"#sw c #b36447",
+".9K c #b36546",
+"#id c #b3663b",
+"#cF c #b3683c",
+"#1Q c #b36949",
+"#kn c #b36a44",
+"#Kv c #b36b3e",
+"#Ws c #b36b4a",
+"#f# c #b37047",
+"#.J c #b37f5f",
+".W2 c #b3806b",
+"#uq c #b38d8a",
+"auX c #b39283",
+"aAk c #b39789",
+"aqV c #b3978d",
+"afm c #b3a097",
+"#zM c #b3a5b0",
+"#9z c #b3a698",
+"aIz c #b3abb2",
+"#yi c #b3adb9",
+"aFc c #b4295a",
+"#e7 c #b45843",
+"abH c #b45948",
+"add c #b45a3c",
+"#KT c #b45a41",
+"#gQ c #b46040",
+"#ld c #b46440",
+"#vP c #b46448",
+"a.d c #b4663f",
+"#8C c #b4683d",
+"a#V c #b46840",
+"aby c #b4693f",
+"#YY c #b46949",
+"ac4 c #b46c37",
+"#Px c #b46d54",
+"abA c #b46e35",
+".Qa c #b47262",
+"#Jb c #b47557",
+"ajn c #b47a63",
+".7H c #b47e6f",
+"ams c #b48064",
+".1H c #b48969",
+"awv c #b49383",
+"aJH c #b4968a",
+".z5 c #b49c80",
+"#vj c #b49c9a",
+"aMM c #b4a1b0",
+"a#f c #b4a594",
+".61 c #b4a5b6",
+"agF c #b4a6a0",
+"aiW c #b4a7a3",
+".gN c #b4a7a5",
+"#zN c #b4aaad",
+".31 c #b4aabb",
+".t0 c #b4afad",
+".hZ c #b4b4c2",
+"aFb c #b52b5c",
+"aMU c #b52f39",
+"#fe c #b55b3f",
+"#xw c #b55e43",
+"#n8 c #b5633c",
+"#Tw c #b56640",
+"#oM c #b5684d",
+"a.e c #b56a3c",
+"#V. c #b56d40",
+"#U3 c #b5714f",
+"abB c #b5734b",
+"#13 c #b57752",
+"ajh c #b57759",
+"#af c #b58060",
+"#bV c #b5806f",
+"a.w c #b58267",
+"#r8 c #b58366",
+"#JH c #b58469",
+"#kt c #b5857d",
+".2O c #b5866b",
+"#my c #b58869",
+"aH3 c #b59591",
+".wC c #b59f97",
+".ph c #b5a99f",
+"aEo c #b5aaaf",
+"aIA c #b5aeb5",
+"#pT c #b65c44",
+"#KX c #b65e3e",
+".9H c #b66330",
+"#5c c #b66342",
+"#6T c #b66542",
+"a#9 c #b66545",
+"#UL c #b66625",
+"#UD c #b6662d",
+"#V8 c #b66829",
+"#fM c #b66847",
+".7Y c #b66941",
+"#Qy c #b66a40",
+"#ll c #b66b3f",
+"#cc c #b66b53",
+".6d c #b67150",
+"#z5 c #b67154",
+"#Y7 c #b6732e",
+".6t c #b67364",
+"#C1 c #b67655",
+".P8 c #b67768",
+"#uo c #b67d4c",
+"#Er c #b68167",
+"#qJ c #b68468",
+"#jE c #b68557",
+"#B# c #b693a5",
+"#E6 c #b6947e",
+"auk c #b69585",
+"awY c #b69586",
+"azc c #b69a8c",
+"aLH c #b69bad",
+"#Be c #b6a290",
+"agD c #b6a49c",
+".pg c #b6aba1",
+".y2 c #b6adc3",
+"aEx c #b6aeb4",
+"aEv c #b6afb4",
+".t5 c #b6b2af",
+"aHY c #b72a40",
+"adc c #b7593d",
+"#KY c #b7603d",
+"#Tf c #b76330",
+"#cv c #b7634a",
+"abM c #b76845",
+"#mW c #b76846",
+"#Np c #b76936",
+"#jS c #b76a3f",
+"#lC c #b76c50",
+"#Xy c #b76d20",
+"a.v c #b76d4a",
+"a#W c #b76e3d",
+"ag1 c #b76e4f",
+".ZY c #b77155",
+"abP c #b77249",
+"#5w c #b7734f",
+"aHW c #b7747e",
+"ac6 c #b7754c",
+".ZH c #b7785c",
+".UD c #b77e67",
+"#N3 c #b77e6a",
+".9q c #b78070",
+"#k7 c #b78457",
+".Zy c #b7856a",
+"#TT c #b78672",
+".Yw c #b7886c",
+"atw c #b79687",
+"asX c #b79689",
+"aHG c #b798a9",
+"aJe c #b798ac",
+"axX c #b79b8e",
+"#Ef c #b7a48d",
+"aG1 c #b7adb1",
+".dG c #b7b0b9",
+"auy c #b7b5bc",
+".l. c #b7b8bd",
+".jH c #b7cce7",
+"aMQ c #b83a54",
+"#YW c #b84538",
+"#jT c #b86339",
+"#e6 c #b8634a",
+"#mI c #b8643e",
+"#mH c #b86540",
+"#5b c #b86548",
+"#lU c #b8664d",
+"#mV c #b86743",
+"#cu c #b86950",
+"#I5 c #b86c3f",
+"#sg c #b86c43",
+"#LW c #b86d3c",
+"a.f c #b8703e",
+"#5v c #b8704d",
+".ZX c #b87055",
+"#Sm c #b8715a",
+".70 c #b8765c",
+".1B c #b8765e",
+"#Ev c #b8795a",
+".Q# c #b8796a",
+"#0H c #b87a59",
+"#2S c #b87d7d",
+"#e1 c #b88162",
+"#8V c #b88165",
+"#3p c #b88263",
+"alt c #b88266",
+".Zz c #b88364",
+".4s c #b88a71",
+"#vr c #b88b70",
+"alw c #b88d7d",
+"aNZ c #b89385",
+"axm c #b89788",
+"#G0 c #b8a0a8",
+"#G1 c #b8a3ad",
+"#CK c #b8a58f",
+"aaU c #b8a894",
+"aLP c #b8a9b7",
+".zI c #b8aa8b",
+".zh c #b8acb7",
+".py c #b8ad83",
+"aDf c #b8b2b7",
+"aAJ c #b8b6c0",
+".q6 c #b8c3db",
+"aMT c #b92435",
+"adb c #b95a49",
+"#Ki c #b9605d",
+"ade c #b96443",
+"#tZ c #b9654a",
+"#4V c #b96a5f",
+"#Sp c #b96c49",
+"#sx c #b96d51",
+".3a c #b96d54",
+"#Tu c #b96f47",
+".Z0 c #b97a5d",
+".P9 c #b97a6b",
+"#T# c #b97d60",
+".W1 c #b9826d",
+".Qt c #b98371",
+"#w1 c #b98766",
+"#k9 c #b98d7a",
+".j# c #b99872",
+"#yl c #b9a399",
+".r6 c #b9a584",
+"#Ci c #b9a796",
+"#CJ c #b9a99e",
+".af c #b9aab3",
+"#zO c #b9aca7",
+"#Za c #b9acaa",
+".v6 c #b9aeb0",
+"#KS c #ba6045",
+"#aP c #ba6148",
+"#LX c #ba6432",
+"#RQ c #ba6435",
+"#.5 c #ba6743",
+"#gC c #ba6749",
+"#Kw c #ba6839",
+"#gV c #ba6843",
+"#OW c #ba6934",
+"#pu c #ba6a43",
+"#n7 c #ba6a44",
+"#nl c #ba6a51",
+"aeu c #ba6b4a",
+"#qT c #ba6d44",
+"afK c #ba6d4d",
+"#8T c #ba6d4e",
+"#ls c #ba6e4b",
+"agY c #ba7158",
+"#un c #ba723f",
+"aab c #ba734c",
+"#l# c #ba755e",
+".1f c #ba775f",
+"#Dw c #ba794b",
+".ZI c #ba7a5e",
+".Q. c #ba7b6b",
+".Qn c #ba7d66",
+".Qr c #ba7e6a",
+".4x c #ba7f69",
+"aln c #ba8467",
+"alr c #ba8468",
+"amA c #ba9385",
+".qt c #ba9778",
+"#7X c #ba9d94",
+"a#i c #baa695",
+".Cq c #baaeb5",
+"#yk c #baafad",
+"aEs c #bab0b4",
+"aHd c #bab1b7",
+"aBM c #bab2b6",
+".p5 c #bab8d8",
+".sP c #bab9d4",
+"aLY c #bb1c26",
+"#Ga c #bb5b43",
+"#ri c #bb5e48",
+"#F5 c #bb653f",
+"#Th c #bb681e",
+"#ND c #bb693b",
+".9J c #bb6943",
+"#UG c #bb6b1e",
+"#p8 c #bb6b4f",
+"aet c #bb6c4b",
+"#fa c #bb6f4c",
+"#tL c #bb6f4e",
+"#V7 c #bb7024",
+"#L6 c #bb723e",
+"#Gm c #bb723f",
+"#R4 c #bb7344",
+".Yl c #bb7b5e",
+".Qs c #bb816e",
+".1. c #bb8769",
+"#ai c #bb8f7b",
+"aHM c #bb9ab5",
+"##A c #bba1b2",
+"a#j c #bba493",
+"#6h c #bba7a4",
+"aIJ c #bba9b2",
+"aaY c #bbaa97",
+"aDg c #bbb5ba",
+".yq c #bbb5bc",
+"aHS c #bbb5c2",
+"aLT c #bc2641",
+"aDV c #bc305c",
+"#cx c #bc6246",
+"#ox c #bc634b",
+"aeE c #bc663b",
+"#Da c #bc674d",
+"afI c #bc684b",
+"#xo c #bc684d",
+"#ov c #bc684f",
+"afV c #bc6c45",
+"#aZ c #bc6d4e",
+"#UC c #bc6e2b",
+"#qU c #bc6e45",
+"#mE c #bc744d",
+"#Mx c #bc7454",
+"#N2 c #bc7458",
+"#QY c #bc755d",
+"#sR c #bc7a50",
+"#a1 c #bc7c53",
+".ZG c #bc7c61",
+".Qq c #bc7e6a",
+"akm c #bc8265",
+"#My c #bc836a",
+"#E5 c #bc8371",
+"#tC c #bc8a5d",
+".93 c #bc8b7d",
+".1J c #bc9274",
+"aoq c #bc9e93",
+"a#g c #bca493",
+"afn c #bcaca5",
+"ad6 c #bcb0ad",
+"aHc c #bcb3b9",
+"aBN c #bcb5b9",
+".ik c #bcc6da",
+"#mN c #bd6e44",
+"#gH c #bd6e48",
+"#pw c #bd7045",
+"##. c #bd704a",
+"#U4 c #bd705e",
+"#XC c #bd732f",
+"#U1 c #bd7552",
+"ac2 c #bd7555",
+"#gE c #bd764e",
+"#U2 c #bd7755",
+".2U c #bd7b65",
+"#Zd c #bd8065",
+"##x c #bd8166",
+"#12 c #bd825c",
+"#QZ c #bd8574",
+".1G c #bd8e70",
+"aIg c #bd998a",
+"aM5 c #bd998b",
+"#6j c #bd9d98",
+"aIh c #bd9f93",
+"#Gy c #bda19c",
+".uX c #bda594",
+"#9C c #bda597",
+"#zP c #bda89a",
+"#Bb c #bda8b2",
+"#0D c #bdb0aa",
+"aEq c #bdb3b8",
+"aDd c #bdb5b9",
+"aEu c #bdb5bb",
+"#lf c #be6743",
+"#C5 c #be6a42",
+".9z c #be6d48",
+"aL0 c #be6e6f",
+"#sh c #be7147",
+"afL c #be7150",
+"#cE c #be7347",
+"#0u c #be744d",
+".4P c #be745a",
+"#TN c #be7843",
+"#gG c #be794d",
+"#p4 c #be7950",
+"ah5 c #be7a5b",
+"#Uy c #be7e61",
+"#Ze c #be7e63",
+".4u c #be8671",
+"#Py c #be8674",
+"#sa c #be895c",
+".Yv c #be8a6e",
+"#vo c #be8d60",
+"#I# c #be8d6f",
+".Z7 c #be8f6e",
+"#qM c #be9374",
+"aad c #be9784",
+"aBz c #be9a86",
+"aAj c #be9a87",
+"#DP c #beac95",
+"aLL c #beacbb",
+"aaX c #bead99",
+"aHb c #beb2b7",
+"aDc c #beb5b9",
+"aFT c #beb6bc",
+".DP c #bebcd9",
+"aKN c #bf1f1f",
+"aes c #bf5b3a",
+"aLz c #bf614a",
+"#Qo c #bf662d",
+".9I c #bf6b3e",
+"abL c #bf6c4b",
+"#Qn c #bf6e37",
+"#tN c #bf6f4a",
+"#pv c #bf7047",
+"#8B c #bf704b",
+"#8A c #bf7051",
+"#O8 c #bf7145",
+"#Qz c #bf7148",
+"#eb c #bf7249",
+"#W# c #bf7327",
+"#ct c #bf735a",
+"#XB c #bf7436",
+"aeq c #bf785b",
+"#R1 c #bf7e4c",
+"ajg c #bf8062",
+"#7b c #bf8160",
+".Qo c #bf836b",
+"#RK c #bf8468",
+".Hl c #bf8553",
+"#tG c #bf8d6c",
+"#vs c #bf8e6c",
+"#pk c #bf8e71",
+"#Eb c #bf97a5",
+"asW c #bf9988",
+"aJG c #bf9a8c",
+"aCY c #bf9b88",
+"apZ c #bfa196",
+"#FH c #bfa89d",
+"#Ie c #bfa8a7",
+"#FF c #bfaaa4",
+".x0 c #bfac86",
+"aEF c #bfb1b7",
+"QtF c #bfb2ba",
+"aEr c #bfb5ba",
+".6W c #bfb89d",
+".0y c #bfb8c9",
+".oj c #bfd1f9",
+"#Wb c #c06701",
+"#cr c #c0684f",
+"#cm c #c06942",
+"#RS c #c06b24",
+"#W. c #c0722e",
+"#tM c #c07251",
+"#O7 c #c07447",
+"#qV c #c07449",
+"#sk c #c07548",
+"ag0 c #c07757",
+"#04 c #c07955",
+"#e9 c #c07c56",
+"#rs c #c07d53",
+"#Bu c #c07e5b",
+"#WJ c #c08060",
+"#5x c #c08560",
+"#FZ c #c08952",
+"alq c #c08a6e",
+"aCX c #c0967d",
+"aEc c #c0967e",
+"aKX c #c09c8e",
+"#Ee c #c0afa3",
+".zG c #c0b091",
+".AS c #c0b4bb",
+"aDp c #c0b5ba",
+".o. c #c0b78f",
+"aBO c #c0b9bd",
+"#vJ c #c16443",
+"#Dc c #c1684e",
+"#vY c #c16b4f",
+"#xB c #c16d4c",
+"#F4 c #c16e46",
+"#vz c #c1724d",
+"#aG c #c1734d",
+"#O6 c #c17649",
+"a#U c #c17657",
+"#lQ c #c17a54",
+"#Tr c #c17f54",
+"#oI c #c18057",
+"#XN c #c18069",
+".Yn c #c18362",
+".Qp c #c1856c",
+".FM c #c18858",
+".6x c #c18c78",
+".Tx c #c1936c",
+"#Bl c #c19479",
+"aBy c #c1977f",
+".nM c #c19a7d",
+"azb c #c19d89",
+"aFy c #c19d8a",
+"QtE c #c1a387",
+"#CH c #c1a6ae",
+"#Hn c #c1a89c",
+".xX c #c1ad8f",
+"#Hm c #c1ada5",
+"acu c #c1b4a0",
+".v0 c #c1b5b8",
+".zg c #c1b5bb",
+"aEp c #c1b7bc",
+"aFS c #c1b9be",
+".84 c #c1b9c0",
+".Cc c #c1bdd4",
+"#Nq c #c26935",
+"#Aw c #c26e4c",
+"#oA c #c2704f",
+"#ih c #c2714e",
+"#6S c #c27153",
+"#o. c #c2754a",
+"#lP c #c2754e",
+"a.c c #c27557",
+"#5a c #c27559",
+"##a c #c2764f",
+"#nm c #c27a5f",
+"#2m c #c27f60",
+".1g c #c27f67",
+".6v c #c28071",
+"#dy c #c28361",
+".7L c #c28478",
+".7K c #c28579",
+"#0G c #c28866",
+".6r c #c28868",
+"#K9 c #c2886c",
+"#FD c #c28880",
+"#11 c #c28a63",
+"#Nl c #c28c4f",
+"#7c c #c28c6c",
+".Z6 c #c29271",
+"#w0 c #c2967a",
+".1I c #c29777",
+".mj c #c29983",
+"av3 c #c29a85",
+"aM4 c #c29a8b",
+"#2R c #c29d9d",
+"aqT c #c29e8e",
+"#Ec c #c2a4ac",
+"#IU c #c2aaa2",
+"#r6 c #c2ab9c",
+"#7V c #c2aca5",
+".By c #c2ae99",
+"#FG c #c2afa8",
+"#CI c #c2b0af",
+"aII c #c2b0b9",
+"ad3 c #c2b1aa",
+"anC c #c2b5bb",
+"aEt c #c2b7bc",
+".D2 c #c2b7bd",
+"aDe c #c2b9bd",
+".5A c #c2b9cb",
+"aBF c #c2bcbe",
+"#EU c #c36245",
+"#gM c #c3674a",
+"#KR c #c36a4c",
+"#xd c #c36c46",
+"#Db c #c36d52",
+"#oh c #c36e59",
+"#3s c #c36f52",
+"aH1 c #c36f70",
+"#Te c #c37040",
+"#n9 c #c3734a",
+"#3r c #c37559",
+"#Y5 c #c37946",
+"#ng c #c37951",
+"#U8 c #c37956",
+"#ZB c #c37c56",
+".1e c #c38068",
+".ZF c #c38367",
+"#Yb c #c38565",
+"#sS c #c3875d",
+".Va c #c38778",
+".XZ c #c38c70",
+"#wX c #c39164",
+"#zX c #c3967b",
+"#CS c #c3977b",
+"#ZD c #c39781",
+".kF c #c39989",
+"awX c #c39b86",
+"avw c #c39b87",
+"aL8 c #c39b8b",
+"axl c #c39c87",
+"aNY c #c39c8c",
+"axW c #c39f8c",
+"#Hl c #c3aba5",
+"#4A c #c3abaa",
+"#7W c #c3aca4",
+"ahQ c #c3b5af",
+"ayl c #c3b7c4",
+".VM c #c3b8c5",
+"aEh c #c3bbbe",
+"azw c #c3c2cb",
+"aHX c #c45b6b",
+"#gJ c #c4624a",
+"#h# c #c46942",
+"#OX c #c46b34",
+"#cy c #c46c4d",
+"#R7 c #c47548",
+"#xp c #c47556",
+".ZW c #c47960",
+"#R5 c #c47a4c",
+"#fu c #c47b56",
+"#yA c #c47b5c",
+"#6l c #c47b79",
+"#U9 c #c47c53",
+"#2n c #c47d59",
+".6u c #c48071",
+"#Wk c #c48168",
+"a#T c #c4826b",
+".Ym c #c48867",
+"#8y c #c48871",
+"#2p c #c48968",
+"#HF c #c48a5d",
+"akj c #c48a6d",
+".Wq c #c48b72",
+".D7 c #c48c5f",
+"#qN c #c48c61",
+"#Ej c #c49366",
+"#5y c #c49574",
+"aAi c #c49a82",
+".S2 c #c49b8a",
+"arE c #c49e8c",
+".94 c #c4a6a3",
+"#IV c #c4a99c",
+"#wS c #c4ada7",
+"#Ed c #c4afae",
+"aF1 c #c4b4bb",
+"#.i c #c4bcc1",
+".8T c #c4bdaf",
+".oz c #c4c0d6",
+"QtY c #c4c2cf",
+"#gI c #c56b4d",
+"#KK c #c57141",
+"#N1 c #c5714e",
+"#D# c #c57156",
+"#pt c #c57850",
+"#Tv c #c57851",
+"ac3 c #c57a4f",
+"#sB c #c57b5e",
+"#lV c #c57b61",
+"#oH c #c57e55",
+"#Xu c #c57e5f",
+"ah3 c #c57f6c",
+"#g2 c #c5825c",
+".4w c #c58372",
+"#6Q c #c5876d",
+".4v c #c58774",
+"#LS c #c59057",
+".Cv c #c59068",
+".R2 c #c59274",
+"#CP c #c59466",
+"#3O c #c5946f",
+"#AC c #c59472",
+"#nY c #c59679",
+"aKW c #c59d8d",
+"aOO c #c59e8e",
+"acx c #c59e98",
+".eZ c #c5a191",
+"#4B c #c5a29f",
+"#CM c #c5a884",
+"aJa c #c5aabc",
+".z4 c #c5ac90",
+"acs c #c5b09b",
+".Bz c #c5b19d",
+".ws c #c5b28c",
+"#Bc c #c5b6b7",
+"aFK c #c5b9bf",
+"aFO c #c5babf",
+".vr c #c5bed3",
+".xc c #c5bed6",
+".kK c #c5c4d4",
+"#Tj c #c66002",
+"#q4 c #c66554",
+"#Nd c #c6686a",
+"#jN c #c66f4c",
+"#gP c #c67051",
+"#Mo c #c6734b",
+"#cA c #c6734f",
+"#QA c #c6754c",
+"#lj c #c6794e",
+"#hi c #c6795e",
+"#w8 c #c67a58",
+"#ii c #c67c5b",
+"#sy c #c67d63",
+"#ij c #c68363",
+".Yk c #c68367",
+".1C c #c6846c",
+"#Wi c #c6866c",
+"ajf c #c68769",
+"#rt c #c6895f",
+".2Q c #c68e74",
+"#OS c #c68f50",
+"#10 c #c69068",
+"alp c #c69074",
+"#FM c #c69164",
+".Yu c #c69175",
+"#Hs c #c69263",
+"aHQ c #c693b3",
+"#yq c #c69467",
+"#Bi c #c69567",
+"#Gt c #c69576",
+"#ys c #c6997e",
+"#Yc c #c69984",
+"aza c #c69c84",
+"auW c #c69e89",
+"asl c #c69e8b",
+"ajc c #c69e8f",
+"asm c #c6a292",
+"apY c #c6a496",
+"#Kl c #c6a79f",
+"#Eg c #c6ae8e",
+"ad4 c #c6b6af",
+".FH c #c6bbc1",
+".pY c #c6c2d0",
+"aye c #c6c4ce",
+"#Di c #c7674e",
+"#vH c #c76d4a",
+"#ha c #c76e44",
+"#jO c #c76e4a",
+"#ig c #c76f4b",
+"#BX c #c76f4f",
+"#KZ c #c7704a",
+"#iQ c #c7715a",
+"#Tn c #c7723e",
+"#QV c #c77250",
+"#oF c #c77750",
+"#oG c #c77751",
+"#K4 c #c7794d",
+"#cH c #c7794f",
+"#si c #c77b50",
+"### c #c77b54",
+"#px c #c77c50",
+"#U7 c #c77c5e",
+"#sf c #c77d55",
+"#K8 c #c77e5b",
+"#2o c #c7825c",
+"#E2 c #c78558",
+"#XF c #c7863f",
+".ZE c #c7886c",
+"#B5 c #c78973",
+"akh c #c78d70",
+".V# c #c78f68",
+".79 c #c79078",
+".AX c #c79471",
+".2P c #c79478",
+".4t c #c7947d",
+"#zU c #c79568",
+".Z5 c #c79674",
+"#WK c #c79984",
+"axk c #c79a81",
+"#Kt c #c79b6e",
+"#Em c #c79b7f",
+"axV c #c79d85",
+"aHI c #c79eb6",
+"aPK c #c79f8f",
+".aq c #c7a585",
+"apb c #c7a698",
+"#zQ c #c7a893",
+"aaV c #c7ae9b",
+".wo c #c7b396",
+".yp c #c7b9b8",
+"#0C c #c7bcbc",
+"aB0 c #c7bec3",
+"aFR c #c7bec4",
+".DO c #c7c4e5",
+"aLU c #c81831",
+"#Tm c #c8681e",
+"#pA c #c86947",
+"#Gf c #c86a51",
+"#g9 c #c86f4c",
+"#EB c #c8714c",
+"#cd c #c8714e",
+"#gR c #c87554",
+".9y c #c87651",
+"#NU c #c8774b",
+"#NT c #c8774d",
+"#p2 c #c87851",
+"#Tx c #c87852",
+".9A c #c87853",
+"#H5 c #c87946",
+"#JB c #c87949",
+"#QU c #c87b5a",
+".3# c #c87d63",
+"#KF c #c87f4c",
+"#nh c #c8845d",
+"#Az c #c88464",
+"#a2 c #c8865e",
+"#v7 c #c88a5f",
+"#p5 c #c88a60",
+"#XM c #c88a72",
+".2R c #c88b71",
+".Z4 c #c89272",
+"#w2 c #c8936c",
+"#I0 c #c89462",
+"#3c c #c89a6a",
+"#up c #c89b81",
+"#I2 c #c89d73",
+"#06 c #c89e87",
+"asV c #c89f8b",
+"auj c #c8a08c",
+"aJF c #c8a090",
+".bW c #c8a48e",
+".hR c #c8a686",
+"#xK c #c8a898",
+"#Km c #c8a89a",
+"#9A c #c8b1a5",
+".v9 c #c8b293",
+"ak# c #c8b8c5",
+"aFQ c #c8c0c6",
+"##Y c #c8c2da",
+".ld c #c8d8e2",
+"#Xs c #c96253",
+"#ED c #c96c4b",
+"#ob c #c96f48",
+"aer c #c96f50",
+"#LZ c #c97024",
+"#HN c #c97048",
+"#3. c #c97166",
+"#Mf c #c97350",
+"#kp c #c97357",
+"#mD c #c97547",
+"#yG c #c9754d",
+"#mJ c #c9774f",
+"#UF c #c97834",
+"#aF c #c97853",
+"#Td c #c9793f",
+".7W c #c97a44",
+"#NB c #c97c4c",
+"#w9 c #c97c52",
+"#Jc c #c97f4e",
+"#sW c #c98265",
+"#QT c #c98364",
+"#tJ c #c98553",
+".RO c #c98569",
+"#ix c #c98666",
+"#V3 c #c98668",
+"#R2 c #c98755",
+"#ry c #c9896b",
+".ZD c #c9896d",
+"#y8 c #c98a5e",
+"#JG c #c98e6e",
+".W0 c #c9907b",
+".ZA c #c9916e",
+"#Bp c #c9926c",
+"#Kr c #c9955f",
+"atu c #c99c83",
+"#CG c #c9a4b3",
+".FI c #c9bdc8",
+"#8u c #c9bfbf",
+"aah c #c9c2c7",
+".Cg c #c9c3df",
+"aw. c #c9c5c8",
+".rp c #c9c8de",
+".tR c #c9d4e7",
+"aKM c #ca1115",
+"#gL c #ca6c50",
+"#if c #ca6d48",
+"#S8 c #ca6e61",
+"#BB c #ca704d",
+"##b c #ca7342",
+"#lg c #ca744f",
+"#Jh c #ca7548",
+"#nf c #ca7752",
+"#QX c #ca7758",
+"#ef c #ca7952",
+"#NC c #ca7b4c",
+"#um c #ca7b60",
+"#o# c #ca7f53",
+"#qW c #ca8054",
+"abx c #ca8162",
+"#cB c #ca8255",
+"#3M c #ca835d",
+"#q. c #ca886a",
+".Yq c #ca8969",
+".9x c #ca8a7d",
+"#Hk c #ca8a83",
+"aje c #ca8b6d",
+".ZJ c #ca8b6f",
+"#Zc c #ca8f73",
+".WZ c #ca936d",
+".Yt c #ca9571",
+"amt c #ca9579",
+"#Qg c #ca9a7c",
+"#Vf c #ca9a85",
+"awW c #ca9d84",
+"atv c #caa28d",
+"aIf c #caa292",
+"#zb c #caa483",
+"apc c #caab9e",
+"#9B c #cab3a6",
+"aHn c #cab9c0",
+"aF4 c #cabac1",
+".ig c #cabcc3",
+".dC c #cabfc5",
+".YY c #cac2d5",
+"aux c #cac7ce",
+"#O2 c #cb6211",
+"#BV c #cb6b4e",
+"#v2 c #cb6e50",
+"##e c #cb714e",
+"#i. c #cb7350",
+"#HL c #cb754c",
+"#EA c #cb774f",
+"#NV c #cb7b4c",
+"#UW c #cb7b50",
+"#Ky c #cb7c3d",
+"#vD c #cb7c50",
+"#tQ c #cb7d51",
+"#KG c #cb804d",
+"#qS c #cb8058",
+"#IR c #cb807b",
+"#L7 c #cb814e",
+"#he c #cb8265",
+"#cC c #cb8356",
+"#sz c #cb8369",
+"#05 c #cb845f",
+"#tI c #cb8850",
+"#gF c #cb885c",
+".21 c #cb8968",
+"#9F c #cb8a86",
+"#B2 c #cb8b5e",
+"#a0 c #cb8b62",
+"#dz c #cb906b",
+"#wa c #cb9567",
+".zl c #cb9a7b",
+".Tw c #cb9b74",
+".hL c #cb9d7c",
+"aEb c #cb9d82",
+"aui c #cb9e85",
+".kx c #cba085",
+".nE c #cba183",
+".o2 c #cba281",
+"#IX c #cba68e",
+".du c #cba797",
+"#LN c #cba798",
+"apX c #cba899",
+"#ym c #cbaa99",
+"#Hp c #cbac94",
+"#FJ c #cbb098",
+"aLI c #cbb3c4",
+"act c #cbbca6",
+".AE c #cbc6d2",
+"aq3 c #cbc7cd",
+"aut c #cbc8ca",
+"aij c #cbc8cc",
+"#Qu c #cc5e1e",
+"aLG c #cc677c",
+"#Nv c #cc6f2c",
+"#BC c #cc704e",
+"#oc c #cc724f",
+"#Pv c #cc7450",
+"#gA c #cc745c",
+"#ib c #cc7750",
+"#xu c #cc775a",
+"#NK c #cc7954",
+".9B c #cc7c57",
+"#vA c #cc7d50",
+"#vU c #cc7e5f",
+"#L8 c #cc7f4d",
+"#y6 c #cc7f5b",
+"#fL c #cc805e",
+"#hh c #cc8064",
+"#Qx c #cc8156",
+"#UZ c #cc8159",
+"#sA c #cc8366",
+"#Ya c #cc845f",
+"#oN c #cc876b",
+".4F c #cc8867",
+".Yo c #cc8b6b",
+".2S c #cc8d73",
+"#uk c #cc8e63",
+"#Gs c #cc916d",
+"#8W c #cc9d85",
+".eQ c #cc9f7d",
+"aFx c #cc9f84",
+".S3 c #cca18e",
+".rH c #cca37d",
+".qk c #cca37f",
+".s4 c #cca47c",
+"QtM c #ccab85",
+"#IW c #ccab98",
+"#IT c #ccaca7",
+"#Ho c #ccb09d",
+".qI c #ccb698",
+"#qG c #ccb7aa",
+"ad5 c #ccbeb8",
+".AR c #ccc1c3",
+".FG c #ccc1c4",
+"aFF c #ccc3c6",
+"aC5 c #ccc5c7",
+".Ft c #cccaf2",
+"aKL c #cd0a13",
+"aKJ c #cd2935",
+"aJm c #cd2e2a",
+"#Qp c #cd6820",
+"#RT c #cd6917",
+"afJ c #cd6e50",
+"#fl c #cd7250",
+"#KP c #cd7452",
+"#KQ c #cd7454",
+"#ff c #cd7458",
+"agZ c #cd775e",
+"#cz c #cd7855",
+"#xn c #cd795e",
+"#O9 c #cd7c51",
+"#fy c #cd7d5a",
+"#dK c #cd7e62",
+"#mK c #cd7f54",
+"#U5 c #cd806c",
+"#RN c #cd813e",
+"#sj c #cd8256",
+"#U0 c #cd845e",
+".4O c #cd866b",
+"#Uz c #cd8823",
+"#3q c #cd8a6d",
+".1h c #cd8a72",
+".2T c #cd8b75",
+"#Ay c #cd8d60",
+"#C2 c #cd8d67",
+".Yr c #cd906f",
+".Ys c #cd9673",
+"#OP c #cd9c7f",
+".ah c #cda07e",
+"aCW c #cda085",
+"awu c #cda087",
+"#Ko c #cda28a",
+".ut c #cda47b",
+"#yn c #cda490",
+"#LM c #cda49d",
+"#ty c #cda59f",
+".gs c #cda993",
+"#FE c #cdaaa3",
+"aop c #cdaea1",
+".wx c #cdaf8a",
+"a#h c #cdb7a6",
+"aaZ c #cdb7a7",
+".BA c #cdbaa5",
+"aMF c #cdbac9",
+"#Ch c #cdbca1",
+".qY c #cdbdb2",
+".sc c #cdbe8c",
+"aEG c #cdbfc5",
+"aoL c #cdcace",
+".sQ c #cdcce8",
+"aLX c #ce1c28",
+"aJo c #ce1f1a",
+"#OZ c #ce6915",
+"#fE c #ce744c",
+"#y4 c #ce7a59",
+"#ne c #ce7f57",
+"#QF c #ce8053",
+"#p3 c #ce8059",
+"#iN c #ce805f",
+"#B1 c #ce825e",
+"#Tc c #ce833a",
+"#UB c #ce8431",
+"#V6 c #ce852a",
+"a.b c #ce8871",
+"#Qj c #ce9655",
+".1# c #ce9676",
+"#Qe c #ce9b8c",
+"#ON c #ce9e8f",
+"#LU c #ce9f6f",
+"axU c #cea085",
+"aGU c #cea186",
+"auV c #cea188",
+"#Ng c #cea394",
+"#vk c #cea79f",
+"aqU c #ceada0",
+"#Eh c #ceb28d",
+"#6i c #ceb6b2",
+".uY c #ceb995",
+"afo c #cebfb8",
+".uS c #cec29c",
+"aFP c #cec2c8",
+".xA c #cec2cc",
+"aFN c #cec3c8",
+"#bv c #cec4c9",
+".pU c #cec9d7",
+".lJ c #cec9ed",
+".aC c #cecbd7",
+".ua c #cecdd6",
+".pJ c #cedaf8",
+"aLV c #cf0f26",
+"#OY c #cf6a1f",
+"#Ns c #cf6f1d",
+"#cq c #cf745a",
+"#Dd c #cf745b",
+"#i# c #cf7552",
+"#KO c #cf7651",
+"#C7 c #cf7652",
+"aMw c #cf7662",
+"#M# c #cf7a4a",
+"#cs c #cf7a61",
+"#jU c #cf7c53",
+"#NJ c #cf7c55",
+"#oL c #cf7c61",
+"#dH c #cf7c62",
+"#XD c #cf7e1e",
+"#yF c #cf7e54",
+"#NS c #cf7e57",
+"#.8 c #cf7f59",
+".9F c #cf825b",
+"#mL c #cf8358",
+"#Pt c #cf8360",
+"#rr c #cf845c",
+"#iM c #cf8560",
+"#j3 c #cf8561",
+"#yB c #cf865e",
+"#hf c #cf8669",
+"#Wd c #cf873f",
+".6m c #cf886d",
+"#z7 c #cf895e",
+".RA c #cf8d77",
+"#xE c #cf9165",
+"#RI c #cf9178",
+"#ZC c #cf9372",
+".Z3 c #cf9476",
+".1E c #cf967b",
+"#Ni c #cf9f83",
+"#LP c #cfa087",
+".bN c #cfa180",
+".i3 c #cfa280",
+"ask c #cfa691",
+"#wb c #cfa791",
+"#zR c #cfaa90",
+"#Kn c #cfaa96",
+"arF c #cfac9d",
+"#FI c #cfb5a2",
+"acr c #cfb6a1",
+"aaW c #cfbaa6",
+".xZ c #cfbc98",
+".uQ c #cfbe8d",
+"aEk c #cfc7c9",
+".k1 c #cfcbbc",
+"axv c #cfccce",
+"QtR c #cfcde9",
+"aKK c #d01721",
+"#Nt c #d0711c",
+"#ud c #d07154",
+"#Gl c #d0744d",
+"#Jw c #d07653",
+"#dZ c #d0785a",
+"#RR c #d07b3f",
+"#qX c #d07b51",
+"#Tg c #d07c3d",
+"#hb c #d07c4d",
+"#Mr c #d07d50",
+"#NH c #d07d53",
+"#u# c #d07d60",
+"#Wc c #d07e24",
+"#fo c #d07e5a",
+"#vW c #d07e61",
+"#D. c #d07e62",
+"#tO c #d07f51",
+"#TB c #d07f52",
+"#xr c #d07f61",
+"#ic c #d08056",
+"#xC c #d0805e",
+"#UY c #d08259",
+"#ul c #d08a6a",
+".1d c #d08c74",
+"#vv c #d08d5c",
+"aJr c #d08d80",
+".RZ c #d09270",
+"#Ql c #d09561",
+"aH2 c #d09695",
+"#0F c #d09775",
+"#z0 c #d09969",
+"#RJ c #d0997c",
+"#n1 c #d0997e",
+"#pn c #d0a083",
+"avv c #d0a38a",
+"arD c #d0a895",
+".my c #d0bc8f",
+".vq c #d0c8dd",
+".kZ c #d0c9b2",
+"auv c #d0cdd0",
+".um c #d0d7f5",
+"#RY c #d17138",
+"#UJ c #d17211",
+"#d6 c #d17654",
+"#Dl c #d1775c",
+"#Qc c #d1777b",
+"#Jx c #d17852",
+"#pH c #d17b59",
+"#le c #d17d59",
+"#v4 c #d17d5c",
+"#Pw c #d17d5d",
+"#M. c #d17f4f",
+"#mM c #d18055",
+"#Gn c #d1814d",
+"#ed c #d18159",
+"#y5 c #d1815e",
+"#km c #d1825d",
+"#R6 c #d18456",
+"#rv c #d18666",
+"#hg c #d1866a",
+"#U6 c #d1866d",
+"#sQ c #d1875f",
+"#TM c #d18a58",
+"#iF c #d18a64",
+"#V4 c #d18c1f",
+".RM c #d18d71",
+".Z1 c #d18f73",
+"#sX c #d19274",
+"#po c #d1956b",
+".xE c #d1a085",
+"az# c #d1a489",
+"#wU c #d1a495",
+"#Hu c #d1a57e",
+"#DA c #d1ab93",
+"#wT c #d1aca0",
+"#Bf c #d1b59b",
+"aHm c #d1c0c8",
+".b4 c #d1c3c6",
+"aFM c #d1c6cb",
+".Cn c #d1c7c4",
+"#c7 c #d1c9d3",
+".Ch c #d1c9f1",
+".Au c #d1cdef",
+"auw c #d1cfd5",
+"aHZ c #d2304a",
+"#EV c #d27255",
+"#Nu c #d27423",
+"#LY c #d27628",
+"##d c #d2784f",
+"#rg c #d27961",
+"#V1 c #d27966",
+"#HM c #d27a51",
+"#v3 c #d27a5a",
+"#Mw c #d27d57",
+"#rf c #d27d64",
+"#NI c #d27f56",
+"#fk c #d28062",
+"#TG c #d2806b",
+"#L1 c #d28143",
+"aMz c #d28177",
+"#R8 c #d28255",
+"#UX c #d28257",
+".7Q c #d2825d",
+"#xa c #d28357",
+"#.9 c #d2845e",
+"#NA c #d28757",
+"#HG c #d2875a",
+"#V2 c #d2886e",
+".RN c #d28d72",
+"#S9 c #d28f77",
+"#Wj c #d29177",
+"#Ew c #d2936e",
+".ZC c #d29870",
+".UE c #d29879",
+"#mx c #d29d71",
+".7G c #d29e8f",
+"#UO c #d2a098",
+"#Qf c #d2a38a",
+"aBx c #d2a58a",
+"aqS c #d2ad9b",
+"#3P c #d2b096",
+"#Bg c #d2b192",
+"a#k c #d2b1a4",
+".yj c #d2b594",
+".v8 c #d2bb9e",
+".ty c #d2bbab",
+".64 c #d2c0bd",
+"aFZ c #d2c2c9",
+"##U c #d2c6c6",
+"#1X c #d2c6c7",
+"au8 c #d2ced1",
+"aLW c #d30c20",
+"#Tk c #d36b0c",
+"#O0 c #d36b0f",
+"#UI c #d3710a",
+"#Dj c #d3745b",
+"#sI c #d3765a",
+"#h. c #d37853",
+"#Dm c #d37a5f",
+"#NG c #d37b4f",
+"#m8 c #d37f66",
+"#TA c #d38051",
+"#xt c #d38063",
+".9G c #d3814a",
+"#NR c #d3815d",
+"#NQ c #d3815e",
+"#re c #d38267",
+"#vV c #d38365",
+"#tR c #d38459",
+"#dL c #d38468",
+"#cI c #d3855a",
+"#lN c #d3855d",
+"#vy c #d38667",
+".1v c #d3866d",
+"#Dv c #d38763",
+".Yp c #d39071",
+"#qP c #d3986e",
+"#I. c #d39876",
+".R0 c #d39978",
+"#nX c #d39c70",
+"#vt c #d39d77",
+"#Nf c #d39f99",
+"#IS c #d3a19c",
+"aAh c #d3a68b",
+"adj c #d3b09b",
+"a.. c #d3b1a0",
+".tN c #d3bfb2",
+".x5 c #d3c0ac",
+".ax c #d3c0c0",
+"#XK c #d3c1c0",
+".uR c #d3c397",
+".6Y c #d3c7c9",
+"#6M c #d3c9c7",
+".e7 c #d3cdd6",
+"axy c #d3d0d7",
+"#RX c #d46a1d",
+"#RU c #d46c15",
+"#C8 c #d47957",
+"#Jj c #d47b50",
+"#gO c #d47d5e",
+"#QC c #d47e57",
+"#NZ c #d47f58",
+"#BY c #d4805f",
+"#Mq c #d48154",
+"#P. c #d48157",
+"#xb c #d48359",
+"#uh c #d48462",
+"#vB c #d48553",
+"#E0 c #d48764",
+"#HH c #d4885b",
+"#sl c #d4885d",
+".ZV c #d4886f",
+"#Jd c #d48959",
+"#Ms c #d48d66",
+"#Ta c #d48e32",
+"#z6 c #d48e69",
+"#Ps c #d48e6d",
+"#xF c #d48f6f",
+".RL c #d48f74",
+"#ka c #d49071",
+"#xI c #d49467",
+".RY c #d49470",
+"#pq c #d4956c",
+".WY c #d49a75",
+"aki c #d49a7d",
+"#OU c #d49c68",
+".X0 c #d49c79",
+"#Nn c #d4a16f",
+".Tv c #d4a179",
+".1F c #d4a184",
+"#Kk c #d4aaa6",
+".wt c #d4b590",
+"ane c #d4b5a9",
+".wp c #d4c0a0",
+".kU c #d4c18d",
+"#DO c #d4c2a2",
+"acv c #d4c3b2",
+"##W c #d4cbd2",
+"aw9 c #d4d2d8",
+"aJn c #d52b26",
+"#O1 c #d56d0f",
+"#Qq c #d56d1a",
+"#HO c #d57856",
+"#Dr c #d57c5d",
+"#uf c #d57d5d",
+"#g8 c #d57e5b",
+"#yZ c #d57e62",
+"#RP c #d58156",
+"#Xt c #d58168",
+"#lh c #d5825a",
+"#xs c #d58265",
+"#fP c #d58464",
+"#jR c #d5855b",
+"#iL c #d58560",
+"#li c #d5865c",
+"#Mt c #d5875e",
+"#Ax c #d58865",
+"#Uw c #d58872",
+"#y7 c #d58965",
+".1u c #d58970",
+"#g7 c #d58a63",
+"#E1 c #d58a66",
+"#p9 c #d58a6f",
+".ZU c #d58b71",
+"#8z c #d58d74",
+".RQ c #d59175",
+".RR c #d59275",
+".1i c #d5927a",
+".RB c #d5937c",
+"#5# c #d59478",
+".S5 c #d5967b",
+"#OM c #d59993",
+"aMy c #d59a82",
+"#zT c #d59c60",
+"#3a c #d59e62",
+".R1 c #d59e7f",
+"#tH c #d59f79",
+"#vl c #d5a499",
+".vR c #d5a58b",
+"#OO c #d5a78f",
+"#LO c #d5ac96",
+".yh c #d5b896",
+"agE c #d5c6bf",
+"aFL c #d5cacf",
+".e8 c #d5cdd6",
+".gA c #d5d2de",
+"apB c #d5d4d7",
+".sM c #d5d5da",
+".sL c #d5d5e2",
+"#HP c #d67958",
+"#Gi c #d67959",
+"#Dk c #d67a60",
+"#q0 c #d67c5d",
+"#L0 c #d68139",
+"#Me c #d6815b",
+"#NL c #d68260",
+"#OL c #d68285",
+"#q8 c #d68465",
+"#By c #d6855b",
+"#x. c #d68958",
+"#ui c #d68965",
+"#Xx c #d68e31",
+".RP c #d69277",
+"#Qd c #d6948f",
+".S6 c #d6977c",
+"#Bq c #d69c7f",
+"#CO c #d69d61",
+"awt c #d6a68b",
+".dl c #d6a887",
+"#9E c #d6a89f",
+"asU c #d6ab96",
+"#Ks c #d6ac7b",
+".z3 c #d6bda2",
+".8P c #d6c6c3",
+"anK c #d6d4d9",
+"#gB c #d77864",
+"#yJ c #d77b59",
+"#Jk c #d77c58",
+"#dM c #d77d5b",
+"#dY c #d77e5f",
+"#vG c #d7805b",
+"#Kx c #d7833d",
+"#sO c #d7855f",
+"#yE c #d7885d",
+"#TD c #d78c62",
+"#iG c #d78d66",
+"#JF c #d78d67",
+"#K3 c #d78f64",
+"#NX c #d7916d",
+"#vu c #d7965f",
+"#Nk c #d79753",
+"a#m c #d79895",
+"#mB c #d79980",
+"#yp c #d79e62",
+".Tu c #d7a177",
+"av2 c #d7a78c",
+"#LT c #d7aa76",
+"QtD c #d7aa88",
+"#Nh c #d7ab94",
+".y# c #d7c2ad",
+".uZ c #d7c590",
+"#47 c #d7ceca",
+".n6 c #d7cfcd",
+".jg c #d7dbec",
+"#Qr c #d86d0d",
+"#UH c #d8750c",
+"#Dh c #d8765e",
+"#aL c #d87e54",
+"#ce c #d8815e",
+"#Mu c #d88258",
+"#jQ c #d8835c",
+"#cf c #d8845f",
+"#Mp c #d8855a",
+"#rp c #d88760",
+"#NW c #d88859",
+"#rq c #d88860",
+"#gW c #d88c65",
+"#ks c #d88c72",
+"#H9 c #d88e65",
+"#H4 c #d88f5e",
+"#yC c #d88f61",
+".3. c #d89176",
+"#vw c #d8926a",
+"#j4 c #d8926f",
+"#n4 c #d8946c",
+"#Tq c #d8976c",
+".1j c #d89979",
+"#7Z c #d89c97",
+".ZB c #d89e79",
+"#Ei c #d89f62",
+".Wr c #d89f7e",
+"avu c #d8a88d",
+".gj c #d8ab89",
+"#mz c #d8ac99",
+".zH c #d8c8a7",
+"#AQ c #d8c8b7",
+".5r c #d8cbe1",
+"#3m c #d8ceca",
+".AP c #d8cecb",
+"aC7 c #d8d1d4",
+".nb c #d8d4f1",
+".vC c #d8d7d4",
+"#Qt c #d96a12",
+"#RV c #d96d11",
+"aJk c #d96d70",
+"#As c #d9785b",
+"#lb c #d97f53",
+"#KN c #d9815b",
+"#jP c #d9825d",
+"#Pu c #d98560",
+"#yU c #d98568",
+"#ro c #d98661",
+"#la c #d98664",
+"#Pe c #d98960",
+"#xq c #d9896b",
+"#lM c #d98c64",
+"#v5 c #d98c68",
+"#ea c #d98d63",
+"#e# c #d98e65",
+"#lR c #d98e6c",
+"#6R c #d98e74",
+"#TF c #d99068",
+"#Xv c #d99325",
+"#oJ c #d9946f",
+"ah4 c #d99476",
+"#Sl c #d9955d",
+".RS c #d99678",
+".1c c #d9967e",
+"#sb c #d99965",
+"#Hr c #d99a65",
+".S4 c #d99b7f",
+".1b c #d99c7b",
+".V. c #d99e78",
+".1a c #d99e7d",
+"#wW c #d9a064",
+"#pj c #d9a176",
+"#tz c #d9a79e",
+"auU c #d9a98e",
+"#nZ c #d9ae9b",
+"#CL c #d9c0a1",
+".ve c #d9e2f1",
+"#jK c #da7c51",
+"#HQ c #da7c5e",
+"#tV c #da805d",
+"#Jy c #da8159",
+"#yV c #da8569",
+"#og c #da856f",
+"#Tz c #da8655",
+"#vO c #da876c",
+"#z9 c #da895f",
+"#sm c #da8b64",
+"#rw c #da8b6f",
+"#F0 c #da8f64",
+"#Ne c #da9393",
+".Yj c #da9478",
+"#y9 c #da9576",
+".RX c #da9874",
+"#OR c #da9a54",
+".U9 c #da9c76",
+"#T. c #da9f83",
+".Tt c #daa075",
+"#LL c #daa2a0",
+"#FO c #daac88",
+"#wZ c #dab096",
+"#yr c #dab097",
+"#vq c #dab197",
+".w# c #dac5a0",
+".ye c #dac7a6",
+".sd c #daca9a",
+".px c #dacfa3",
+".68 c #dad4bf",
+"aAO c #dad4d8",
+"anr c #dad6dc",
+"#Qs c #db6d09",
+"#EC c #db7f5d",
+"#q1 c #db7f64",
+"#H2 c #db805a",
+"#Jl c #db805d",
+"#ia c #db825d",
+"#Go c #db834d",
+"#QD c #db835d",
+"#lO c #db8561",
+"#Sa c #db8857",
+"#RO c #db8a56",
+"#ee c #db8a62",
+"#cg c #db8a64",
+"#Pd c #db8b60",
+"#p1 c #db8b64",
+"#fN c #db8b6b",
+"#ko c #db8e6c",
+"#e. c #db9167",
+"#sU c #db9271",
+"#ni c #db9370",
+".1t c #db9479",
+"#v8 c #db9575",
+"#se c #db986e",
+".RC c #db9882",
+"#LR c #db995a",
+"#Bv c #db9970",
+".WV c #db9976",
+"#Ux c #db997e",
+"#IZ c #db9a63",
+"#f. c #db9b71",
+"#FL c #db9c68",
+"#vn c #dba265",
+"#tB c #dba266",
+"#za c #dba27b",
+"auh c #dbab90",
+"#xJ c #dbac84",
+"att c #dbac91",
+"#tE c #dbb198",
+".ie c #dbcac7",
+".pi c #dbcfc5",
+"abs c #dbcfd4",
+".xy c #dbd0d2",
+"aFD c #dbd1d4",
+"aFE c #dbd2d5",
+".n7 c #dbd5d5",
+".mn c #dbdcef",
+"#Nr c #dc7b2c",
+"#Do c #dc7b5f",
+"#aN c #dc7d5d",
+"#Mv c #dc8258",
+"#QE c #dc835d",
+"#sq c #dc836e",
+"#xv c #dc866a",
+"#xc c #dc8961",
+"#C4 c #dc8b61",
+"#fH c #dc8e5d",
+"#kk c #dc8e66",
+"#LK c #dc8e8d",
+"#KH c #dc8f5d",
+"#n3 c #dc8f5f",
+"#Ex c #dc8f62",
+"#iR c #dc8f75",
+"#v6 c #dc916d",
+"#ru c #dc9c76",
+"#qQ c #dc9d73",
+"#sd c #dc9f74",
+"#Qk c #dca56c",
+"#Nm c #dcac76",
+"#FN c #dcae87",
+"#I1 c #dcb184",
+"#Ek c #dcb191",
+"#zW c #dcb298",
+"acw c #dcc1b5",
+".0D c #dcd2e2",
+".k0 c #dcd7c5",
+"aAK c #dcd7da",
+"azz c #dcd8db",
+"aJq c #dd7467",
+"#Tl c #dd761d",
+"#Wa c #dd8014",
+"#Gk c #dd815c",
+"#Jm c #dd8161",
+"#ue c #dd8163",
+"#Jv c #dd8363",
+"#yX c #dd876b",
+"#Ty c #dd8857",
+"#d9 c #dd8b60",
+"#Bx c #dd8f63",
+"#fK c #dd916f",
+"#TK c #dd926a",
+"#mF c #dd926c",
+"#RL c #dd9740",
+"#Kq c #dd9c60",
+"#Kj c #dd9d9a",
+".WX c #dd9f7b",
+"#ik c #dd9f81",
+"#pi c #dda06a",
+".rQ c #ddbba4",
+".pp c #ddcab4",
+".r7 c #ddccaf",
+"#1Y c #ddcec6",
+"ayk c #ddd0dd",
+".8I c #ddd4cd",
+".mJ c #ddd5b1",
+"auu c #ddd9dc",
+"aJp c #de4c43",
+"#Ti c #de7a1e",
+"#h7 c #de7d54",
+"#Gh c #de8063",
+"#cp c #de8064",
+"#aM c #de815b",
+"#nk c #de886e",
+"#NE c #de895c",
+"#ug c #de8968",
+"#tY c #de896e",
+"#QB c #de8a62",
+"#vX c #de8a6e",
+"#vN c #de8a6f",
+"#HK c #de8b60",
+"#tT c #de8b63",
+"#tS c #de8d63",
+"#p0 c #de8d67",
+"#tP c #de8e5a",
+"#QG c #de8f63",
+"#vC c #de9064",
+"#TC c #de9065",
+"#NY c #de916c",
+"#fJ c #de9371",
+"#fI c #de9471",
+"#TL c #de9567",
+"#cD c #de9569",
+".6e c #de9978",
+"#Qh c #de9a4d",
+".4G c #de9a79",
+".RD c #de9b85",
+".RE c #de9c86",
+"#UP c #de9d7c",
+".UF c #dea57f",
+".UG c #dea77c",
+"#OT c #deaa72",
+"amz c #dead98",
+"#Ht c #deb289",
+"aHV c #debac1",
+".gK c #ded1cf",
+"acX c #ded1d8",
+".uT c #ded4b6",
+".5z c #ded4e0",
+"aB5 c #ded5da",
+".uc c #dedfda",
+"aJl c #df5454",
+"#C9 c #df8262",
+"#fD c #df845f",
+"#h6 c #df8464",
+"#H3 c #df855d",
+"#UK c #df8631",
+"#iK c #df8663",
+"#BT c #df876c",
+"#xk c #df876d",
+"#vM c #df886e",
+"#K7 c #df895f",
+"#Md c #df8a63",
+"#rn c #df8a67",
+"#vF c #df8b63",
+"#fx c #df8c6a",
+"#ok c #df8d6c",
+"#hl c #df8f74",
+"#hk c #df9075",
+"aFe c #df91b3",
+"#B0 c #df926e",
+"#hd c #df945f",
+"#TE c #df956d",
+"#YZ c #df982e",
+"#Sk c #df9964",
+"#iE c #df9974",
+"#p6 c #df9c77",
+".RT c #df9c7d",
+".RF c #df9d87",
+"#wV c #dfa15b",
+"#r7 c #dfa57a",
+".X2 c #dfa67c",
+".Wt c #dfa77d",
+"a#l c #dfb0a8",
+"#Bk c #dfb59b",
+"#r9 c #dfb6a2",
+"#Fg c #dfc5cb",
+"aG3 c #dfd5d8",
+"aEi c #dfd6d9",
+".k5 c #dfd8b5",
+"#.t c #dfd8d6",
+".pX c #dfdbe9",
+"awB c #dfdcde",
+"aek c #dfdce3",
+"avL c #dfdde4",
+".jt c #dfe0d7",
+"#Jn c #e08466",
+"#xi c #e0856c",
+"#Dn c #e0886d",
+"#Ar c #e0896d",
+"#Ma c #e08a5b",
+"#S# c #e08b59",
+"#P# c #e08b61",
+"#Jg c #e08d60",
+"#sN c #e08d68",
+"#BZ c #e08f6d",
+"#dJ c #e09074",
+".7V c #e09258",
+"#mO c #e0926b",
+"#io c #e09773",
+"#kb c #e0977a",
+"#FK c #e09c63",
+".RJ c #e09c80",
+".U7 c #e09d7a",
+".22 c #e09e7e",
+".WW c #e09f7c",
+"#Qi c #e0a159",
+"#vm c #e0a15b",
+".1D c #e0a188",
+".S7 c #e0a286",
+".Ts c #e0a376",
+".ZR c #e0a384",
+"#qI c #e0a77b",
+"#CQ c #e0b494",
+".id c #e0cdc6",
+"aMJ c #e0d1df",
+".tt c #e0d2b3",
+".D. c #e0d2c5",
+".wE c #e0d9e0",
+"aeN c #e0dde1",
+"#1I c #e17a64",
+"#Dp c #e18164",
+"#xg c #e18464",
+"#EW c #e18567",
+"#K6 c #e18759",
+"#gN c #e1876a",
+"#RH c #e1887a",
+"#Mb c #e1895a",
+"#KL c #e18b5c",
+"#JE c #e18b5d",
+"#yT c #e18c70",
+"#Pc c #e19165",
+"#QH c #e19167",
+".9D c #e1936d",
+"#TJ c #e19371",
+"#yD c #e19467",
+"#xD c #e19571",
+"#Kp c #e19657",
+"#uj c #e19672",
+"#JA c #e1986a",
+"#rx c #e1997d",
+"#qR c #e19c73",
+".25 c #e19f7f",
+".RG c #e19f89",
+"#w4 c #e1a172",
+"#yo c #e1a25c",
+"#iw c #e1a281",
+"#tA c #e1a35d",
+"#CR c #e1b89e",
+"ah1 c #e1bba7",
+".yi c #e1c5a3",
+".qK c #e1d1c2",
+"aDt c #e1d6db",
+".xj c #e1d7e8",
+".o# c #e1d8b1",
+".y3 c #e1d9e5",
+".nc c #e1dcfa",
+"azx c #e1dee1",
+"apD c #e1dee4",
+"ava c #e1dfe6",
+"#RW c #e2741a",
+"#BU c #e28164",
+"#pz c #e2845f",
+"#sL c #e28a6a",
+"#An c #e28a6f",
+"#kl c #e28b67",
+"#K2 c #e28c61",
+"#q7 c #e28c6c",
+"#xm c #e28c71",
+"#pZ c #e28f6c",
+"#NP c #e2906f",
+"#TH c #e29079",
+"#oB c #e2916e",
+"#vE c #e29267",
+"#sP c #e2926a",
+"#mG c #e2926d",
+"#EZ c #e2926f",
+".9C c #e2936d",
+"#q9 c #e29376",
+".9E c #e2946e",
+"#x# c #e29568",
+"#LQ c #e29754",
+"#dR c #e29870",
+"#z# c #e29c7e",
+"#n2 c #e29e77",
+".RK c #e29e82",
+".4I c #e29f7e",
+".RH c #e2a08a",
+"#CN c #e2a45e",
+"amu c #e2ae92",
+"#pl c #e2b8a5",
+".v7 c #e2cbaf",
+".sa c #e2cdbe",
+".n1 c #e2ceac",
+".6Z c #e2d4e4",
+"#.q c #e2d5cf",
+".Cp c #e2d7d9",
+"ael c #e2ddde",
+"agR c #e2dfe6",
+"arh c #e2e2e5",
+".ju c #e2e3da",
+"aLC c #e37d79",
+"#q3 c #e38370",
+"#Gj c #e38663",
+"#YX c #e3866e",
+"#R9 c #e38b57",
+"#jJ c #e38b6a",
+"#K5 c #e38c5e",
+"#fF c #e38c61",
+"#yY c #e38d71",
+"#d1 c #e39072",
+"#L9 c #e39463",
+"#jV c #e3956d",
+"#w. c #e39571",
+"#n# c #e39573",
+"#Du c #e39672",
+"#lJ c #e39873",
+"#rc c #e3997c",
+"#g3 c #e39a75",
+"#Y1 c #e39b41",
+".RW c #e3a07e",
+".RU c #e3a180",
+"#zS c #e3a55f",
+".X9 c #e3a687",
+".Ws c #e3aa83",
+"#l. c #e3ad9e",
+"#wY c #e3b797",
+"#vp c #e3b898",
+"#El c #e3b99f",
+"#qK c #e3baa6",
+".u0 c #e3d19d",
+".sb c #e3d1b1",
+".zU c #e3d2ba",
+".5w c #e3d4d0",
+".n4 c #e3d6c8",
+".qZ c #e3d6cb",
+"aG2 c #e3dadd",
+".8S c #e3dbc6",
+".k4 c #e3ddb8",
+"anH c #e3dee3",
+"avF c #e3dfe2",
+"ap7 c #e3dfe5",
+"amm c #e3e2e8",
+".ub c #e3e4e4",
+"#Jt c #e4896e",
+"#od c #e48c6b",
+"#S. c #e48d59",
+"#KM c #e48d5e",
+"#Ji c #e48d61",
+"#pS c #e48d74",
+"#K0 c #e48e66",
+"#yR c #e48e73",
+"#Ds c #e4906f",
+"#sn c #e49370",
+"#BE c #e49377",
+"#Sc c #e49668",
+"#na c #e49673",
+"#F1 c #e4986e",
+"aI8 c #e498c4",
+"#0o c #e49b38",
+"aJj c #e49da2",
+"#w# c #e49f6e",
+".4H c #e4a080",
+".RV c #e4a17f",
+".24 c #e4a282",
+".WU c #e4a381",
+".UI c #e4a583",
+"#Bh c #e4a660",
+".X1 c #e4ab84",
+"#Bj c #e4b898",
+"#tD c #e4b998",
+"#7d c #e4ba9f",
+"#qL c #e4bfaa",
+".n2 c #e4d3b6",
+"a#P c #e4d8dc",
+"aDq c #e4d9de",
+"aka c #e4dae2",
+"apo c #e4e0e6",
+"awc c #e4e1e8",
+"ayf c #e4e2e4",
+"aqm c #e4e3e7",
+"#yO c #e58e74",
+"#NO c #e59074",
+"#Ac c #e59277",
+"#KJ c #e59363",
+"#oE c #e5956e",
+"#kj c #e59770",
+"#aH c #e59972",
+"#IY c #e59b60",
+"#ps c #e59d75",
+"#Hq c #e59e64",
+"#OQ c #e59f54",
+".4N c #e5a084",
+".1s c #e5a386",
+".Tr c #e5a577",
+".UJ c #e5a584",
+".UH c #e5a684",
+".Wu c #e5a887",
+".X8 c #e5a889",
+".Ye c #e5a98a",
+".7F c #e5b1a2",
+"#zV c #e5ba9a",
+"aEI c #e5d8de",
+".re c #e5e1e7",
+".tQ c #e5e6e8",
+"#pU c #e68b73",
+"#yL c #e68d74",
+"#EX c #e68e6e",
+"#vL c #e68e75",
+"#NF c #e68f63",
+"#yW c #e69074",
+"#dW c #e6926f",
+"#dP c #e69570",
+"#Dt c #e69673",
+"#dV c #e69772",
+"#fz c #e69874",
+"#Nj c #e69e56",
+"#qO c #e6a46f",
+".Tq c #e6a576",
+".Wv c #e6a988",
+"#sc c #e6ad81",
+"#s. c #e6c2ad",
+"aa0 c #e6c4b9",
+".wd c #e6d5ab",
+"aF0 c #e6d6dd",
+"anB c #e6dae0",
+".D1 c #e6dbde",
+".D0 c #e6dcdb",
+".n5 c #e6ddd5",
+".h6 c #e6e0da",
+".t1 c #e6e2df",
+"aeJ c #e6e3e7",
+".ue c #e6e4fd",
+".y7 c #e6e5e1",
+".mU c #e6eefa",
+"#Dg c #e7846c",
+"#Gg c #e7896e",
+"#yK c #e78a69",
+"#H1 c #e78c68",
+"#xh c #e78c73",
+"#fC c #e78d6b",
+"#qZ c #e78f6a",
+"#sM c #e7916e",
+"#NM c #e79373",
+"#fj c #e79476",
+"aDX c #e794b7",
+"#dI c #e7967b",
+"#Bw c #e79a6d",
+"#lL c #e79a73",
+"#1K c #e79c3f",
+"#iH c #e79c74",
+"#n6 c #e79c75",
+"#Gr c #e79d72",
+"#pp c #e7a06d",
+"#yz c #e7a085",
+".23 c #e7a484",
+"#pr c #e7a57c",
+".ZK c #e7a98a",
+".WR c #e7af8f",
+".n9 c #e7dbc4",
+"#3n c #e7ddd7",
+".Co c #e7dddc",
+".nU c #e7ded4",
+".b8 c #e7e3ed",
+".mR c #e7eef3",
+".jE c #e7f1eb",
+"#0m c #e8846d",
+"#Ju c #e88d6f",
+"#N0 c #e88f68",
+"#d7 c #e88f6a",
+"#BS c #e89075",
+"#tU c #e8916b",
+"#m9 c #e89379",
+"#TI c #e8987c",
+"#Ey c #e8996d",
+"#iJ c #e89a72",
+"#n. c #e89b79",
+"#p7 c #e89c7c",
+"#mX c #e89d7c",
+".7Z c #e89f7f",
+".Yi c #e8a086",
+".29 c #e8a488",
+".RI c #e8a489",
+"#AB c #e8a68c",
+".UK c #e8a988",
+"#w3 c #e8aa75",
+"#qH c #e8ab75",
+".U5 c #e8ab85",
+"#3b c #e8b47c",
+"#n0 c #e8bba9",
+".yl c #e8cba9",
+".qu c #e8d5ba",
+".5q c #e8d8e8",
+".66 c #e8dcc5",
+".2a c #e8dce6",
+".8R c #e8ddca",
+".32 c #e8dff5",
+"alg c #e8e0e9",
+".YZ c #e8e3fb",
+"af3 c #e8e4e8",
+".AI c #e8e4f5",
+"aeM c #e8e5e9",
+"awF c #e8e5ec",
+"#HR c #e98b6f",
+"#Pb c #e99068",
+"#yM c #e99077",
+"#Pa c #e99169",
+"#Aq c #e99276",
+"#K1 c #e99368",
+"#qY c #e9936b",
+"#fG c #e99768",
+"#BG c #e9977b",
+"#Sb c #e99869",
+"#Jf c #e9996a",
+"#rd c #e99d80",
+"#rb c #e9a284",
+".ZT c #e9a488",
+".Ww c #e9ab8a",
+".X7 c #e9ad8d",
+"#pm c #e9c1ad",
+"afF c #e9cfbf",
+".n0 c #e9d4b0",
+".po c #e9d4b9",
+".zV c #e9d8be",
+".qR c #e9dbae",
+"aEH c #e9dbe1",
+".2g c #e9dce3",
+".sn c #e9ddd0",
+"a.B c #e9dfe1",
+"aFG c #e9e0e3",
+".0x c #e9e0eb",
+"##X c #e9e2f0",
+"afB c #e9e7ee",
+"#py c #ea8c65",
+"#q2 c #ea8c76",
+"#Jr c #ea8c77",
+"#HX c #ea8d73",
+"#oa c #ea8f67",
+"#Ao c #ea9277",
+"#gU c #ea9370",
+"#d8 c #ea956c",
+"#z8 c #ea9c6f",
+"#sV c #ea9d80",
+"#lK c #ea9e78",
+"#ci c #ea9f78",
+"#r. c #ea9f84",
+"#1M c #eaa051",
+"#vx c #eaa07f",
+"#0q c #eaa14d",
+".Yh c #eaa287",
+".6l c #eaa589",
+"#ft c #eaa780",
+"#yx c #eaaa87",
+".Z2 c #eaaa8e",
+"#z2 c #eaad8e",
+"#yv c #eaaf7c",
+".WQ c #eaaf90",
+"#z1 c #eab087",
+"amy c #eab69a",
+".wc c #ead6ab",
+".tz c #ead6b3",
+"ai8 c #ead9e4",
+"ahY c #eadae3",
+".C9 c #eadccf",
+".0u c #eaddc8",
+".YW c #eadfd9",
+"#48 c #eadfdb",
+".zf c #eadfe1",
+"aEj c #eae2e5",
+".tv c #eae3d2",
+"QtS c #eae3f8",
+"#De c #eb8e76",
+"#d5 c #eb9070",
+"#Js c #eb9076",
+"#JC c #eb9362",
+"#aK c #eb9367",
+"#xl c #eb947a",
+"#Sf c #eb957e",
+"#Mc c #eb966e",
+"#Pf c #eb9a74",
+"#oC c #eb9a75",
+"#hc c #eb9d6a",
+"#lD c #eb9d81",
+"#Sj c #eba372",
+"#kg c #eba37d",
+".4J c #eba787",
+".U8 c #eba985",
+".26 c #eba989",
+".1k c #ebab8b",
+".1r c #ebad8f",
+".X3 c #ebaf8f",
+".Yc c #ebb192",
+".WJ c #ebb294",
+"#mA c #ebbaa9",
+"#2q c #ebc1ab",
+"ai9 c #ebe0e6",
+".He c #ebe1e0",
+"abU c #ebe1ea",
+".rT c #ebe5cf",
+".h8 c #ebe5df",
+".sz c #ebe6e7",
+"au9 c #ebe8eb",
+".sq c #ebf1fc",
+".jG c #ebfcff",
+"#Ab c #ec8f6e",
+"#xj c #ec9279",
+"#Jz c #ec936a",
+"#pW c #ec9577",
+"#NN c #ec977a",
+"#C3 c #ec9d71",
+"#HI c #ec9e72",
+"#ol c #ec9f7f",
+"#w7 c #eca285",
+"#iq c #ecab89",
+".Th c #ecac88",
+".S8 c #ecad92",
+".WH c #ecb395",
+"abu c #ecc8bd",
+".mz c #ecd9af",
+".8Q c #ecddd3",
+".r9 c #ece0d2",
+"afC c #ece3e6",
+".67 c #ece4c7",
+".yU c #ece7ff",
+"ans c #ece8ed",
+"axw c #ece9ec",
+".Cd c #ece9fc",
+"#Jo c #ed9075",
+"#q6 c #ed9574",
+"#Ap c #ed957a",
+"#rm c #ed9675",
+"aLB c #ed9988",
+"#pR c #ed9b80",
+"#pJ c #ed9d7d",
+".7U c #ed9f79",
+"#Pr c #eda06e",
+"#QR c #eda06f",
+"#iI c #eda078",
+"#mC c #eda27d",
+"aMx c #eda890",
+".Tb c #edad89",
+"#z3 c #edad94",
+".Wx c #edb08f",
+".UW c #edb192",
+".WS c #edb28d",
+".Y. c #edb293",
+".8. c #edb99f",
+".pf c #eddccb",
+".mA c #edddb7",
+"QtB c #eddee7",
+"#8Z c #ede1df",
+"anz c #ede1e6",
+"#6N c #ede2df",
+".mH c #ede3cf",
+".vK c #ede3e2",
+".mI c #ede5bf",
+"aml c #ede6f0",
+"aii c #ede9ed",
+"aw8 c #edebf2",
+".xo c #edede2",
+".vB c #edeede",
+"#HU c #ee8f7a",
+"#co c #ee9071",
+"#Ag c #ee997e",
+"#Ae c #ee9a7f",
+"#Sg c #ee9a81",
+"#Pq c #eea070",
+"#nb c #eea07c",
+"#Je c #eea171",
+"#pK c #eea284",
+"#lI c #eea47f",
+"#w5 c #eeaa85",
+".U6 c #eead89",
+".ZS c #eead90",
+".Te c #eeae8a",
+".UR c #eeb698",
+"aen c #eedcd3",
+".2# c #eee1df",
+"anA c #eee2e8",
+"#.s c #eee6dc",
+"avK c #eeebf2",
+".ud c #eeedff",
+".lc c #eefaff",
+"#BD c #ef9271",
+"#sK c #ef9576",
+"#H6 c #ef9763",
+"#yQ c #ef997e",
+"#BI c #ef9a7f",
+"#mU c #ef9c78",
+"#oD c #ef9f79",
+"#KI c #efa06f",
+"#xG c #efa289",
+".UL c #efaf8e",
+".1n c #efaf8f",
+".U0 c #efaf92",
+".X6 c #efb293",
+".X4 c #efb393",
+".WI c #efb798",
+"a.y c #efc8b7",
+".xx c #efe5e4",
+".b7 c #efe8f0",
+".sD c #efeaeb",
+"aeL c #efebf0",
+"awb c #efecf3",
+".q4 c #eff1fa",
+"#sJ c #f09477",
+"#vK c #f0977d",
+"#yP c #f0997f",
+"#lS c #f09b7f",
+"#ou c #f0a085",
+"#F2 c #f0a279",
+"#lm c #f0a87f",
+"#lt c #f0a886",
+"#lB c #f0aa8c",
+".Tf c #f0b08c",
+".Yf c #f0b193",
+".WC c #f0b799",
+".UU c #f0b89a",
+".wa c #f0dbb4",
+"#7f c #f0e1db",
+".3Y c #f0e1e1",
+"#99 c #f0e5e7",
+".aB c #f0e9f2",
+".rh c #f0ebf1",
+".rg c #f0ecf2",
+"#yN c #f1997f",
+"#d0 c #f19b7d",
+"#fh c #f19c7e",
+"aLA c #f19c85",
+"#d2 c #f1a083",
+"#QM c #f1a27d",
+"#QS c #f1a472",
+"#g4 c #f1a480",
+"#ki c #f1a57e",
+"#kh c #f1a780",
+"#n5 c #f1aa83",
+".Tk c #f1ad89",
+".Tj c #f1ad8a",
+".Yg c #f1ad91",
+"#j5 c #f1af8e",
+".1l c #f1b191",
+".1m c #f1b192",
+"#ir c #f1b393",
+".ZL c #f1b495",
+".Yd c #f1b697",
+".UT c #f1b99b",
+"#Ff c #f1d5da",
+".5n c #f1decd",
+".60 c #f1e2f8",
+"agT c #f1e6e7",
+".oA c #f1ecff",
+".rf c #f1edf3",
+"af1 c #f1eef2",
+".AH c #f1eff5",
+"#H0 c #f29674",
+"#HY c #f2967a",
+"#BR c #f2987d",
+"#dN c #f29a77",
+"#fB c #f29b7a",
+"#pV c #f29b7d",
+"#fg c #f29b7e",
+"#yS c #f29d81",
+"#F3 c #f2a179",
+"#BF c #f2a185",
+"aI6 c #f2a5c0",
+"#xH c #f2a786",
+"#jW c #f2aa84",
+"#ra c #f2ab91",
+"#iD c #f2ae89",
+".1q c #f2b292",
+".WP c #f2b295",
+".S9 c #f2b498",
+".ZO c #f2b596",
+".Y# c #f2b798",
+".WD c #f2b99b",
+".WE c #f2ba9b",
+".US c #f2ba9c",
+"amx c #f2bea2",
+".U3 c #f2c09e",
+"aa1 c #f2c3be",
+"aaf c #f2dcda",
+".x1 c #f2dfb8",
+"adm c #f2e3ec",
+".3T c #f2e3f0",
+".gH c #f2e4e2",
+"#8v c #f2e6e6",
+".0w c #f2e7e7",
+"adn c #f2eaf6",
+".vA c #f2edd5",
+".y6 c #f2eee4",
+"asu c #f2eef4",
+".pW c #f2eefb",
+"axx c #f2eff6",
+".pD c #f2f0e6",
+"#HT c #f3947d",
+"#Df c #f3967e",
+"#H8 c #f39c6c",
+"#oK c #f3a486",
+"#fq c #f3aa82",
+".Tl c #f3af8a",
+".Ti c #f3af8d",
+".28 c #f3b191",
+"#mT c #f3b296",
+".Tc c #f3b38f",
+"#yw c #f3b68a",
+".Wy c #f3b695",
+".ZM c #f3b697",
+".X5 c #f3b797",
+"#g0 c #f3ba92",
+"amv c #f3bfa3",
+".3Q c #f3e2ce",
+"#5A c #f3e3da",
+".if c #f3e3e4",
+".n3 c #f3e4ce",
+".2. c #f3e4d6",
+"aag c #f3e5e9",
+".b5 c #f3e7eb",
+"aDs c #f3e8ed",
+".xb c #f3ecff",
+".vz c #f3edda",
+"ahe c #f3eff3",
+".pc c #f3f2e8",
+"alh c #f3f2f6",
+".og c #f3f9f6",
+"#rj c #f4997c",
+"#Al c #f49a7f",
+"#so c #f4a083",
+"#Af c #f4a084",
+"#Ad c #f4a185",
+"#HJ c #f4a479",
+"#Pl c #f4a480",
+"#Po c #f4a579",
+"#kf c #f4ad88",
+".Ta c #f4b48f",
+".Tg c #f4b490",
+".1o c #f4b495",
+".T. c #f4b69a",
+".Ya c #f4b99a",
+"abR c #f4d3c3",
+".ww c #f4d5b0",
+"alx c #f4d9d2",
+"#3Q c #f4e2d8",
+"abT c #f4e2e7",
+".3S c #f4e3e5",
+".AQ c #f4e9e8",
+".kY c #f4eacc",
+"aB1 c #f4ebf0",
+".xl c #f4ede7",
+".h9 c #f4efe8",
+".sA c #f4f0f0",
+"af0 c #f4f0f4",
+"aoA c #f4f0f5",
+"aoz c #f4f0f6",
+"av# c #f4f1f8",
+".vd c #f4f3ef",
+".la c #f4f9ff",
+".lb c #f4fdff",
+"#pY c #f5a17f",
+"#nj c #f5a386",
+"#Pn c #f5a67d",
+"#fv c #f5a684",
+"#nd c #f5a780",
+"#QQ c #f5a879",
+"#r# c #f5ad92",
+".4M c #f5b296",
+".UM c #f5b594",
+"#j6 c #f5b797",
+".T# c #f5b79b",
+".ZQ c #f5b899",
+".tb c #f5d2c6",
+"agW c #f5d5c0",
+".wv c #f5d6b2",
+"#8Y c #f5ddd3",
+"akr c #f5ded8",
+"aLM c #f5e0f0",
+".65 c #f5e6da",
+"any c #f5e9ee",
+".YV c #f5eadc",
+"#.r c #f5eae0",
+"QtW c #f5eaef",
+"afD c #f5ebea",
+".b6 c #f5ebf1",
+".6X c #f5ecdd",
+".vy c #f5efe4",
+".xn c #f5f1de",
+".y5 c #f5f1eb",
+"ahf c #f5f1f5",
+"akb c #f5f3f5",
+"awE c #f5f3fa",
+".jF c #f5ffff",
+"#Am c #f69d82",
+"#Gq c #f69f6d",
+"#pX c #f6a080",
+"#Pp c #f6a87a",
+".7T c #f6a882",
+"#v9 c #f6a88e",
+"#Sd c #f6a97e",
+"#mY c #f6af8f",
+".ZN c #f6b99a",
+".U4 c #f6bb95",
+".WG c #f6bd9e",
+".UQ c #f6bea0",
+"#j0 c #f6c1a1",
+".xY c #f6e2c1",
+"a.A c #f6e4e1",
+".r8 c #f6e7d1",
+".ze c #f6ebeb",
+"##V c #f6ecee",
+"QtX c #f6eff9",
+"aAL c #f6f0f3",
+".pG c #f6f1ef",
+"aeK c #f6f2f6",
+"arM c #f6f2f8",
+".oi c #f6f3fe",
+"apC c #f6f5f9",
+".q5 c #f6fbff",
+".mT c #f6ffff",
+"#HS c #f7997f",
+"#HW c #f79a81",
+"#HZ c #f79b7c",
+"#cn c #f79c79",
+"#fm c #f79e7b",
+"#Pm c #f7a781",
+"#QN c #f7a982",
+"#nc c #f7a984",
+"#Si c #f7ac81",
+"#om c #f7ad8e",
+"#pL c #f7ae92",
+"#w6 c #f7af91",
+"#AA c #f7af9a",
+".6h c #f7b291",
+".6f c #f7b292",
+".UZ c #f7b699",
+".Td c #f7b793",
+"ajq c #f7dbd0",
+".wq c #f7e3c1",
+".yd c #f7e4c4",
+".n8 c #f7e8e4",
+".3Z c #f7eaee",
+"agS c #f7eaf0",
+".Xm c #f7ecec",
+".qx c #f7efdc",
+".tP c #f7f0e5",
+"aBI c #f7f2f4",
+".t2 c #f7f3f0",
+"app c #f7f3f9",
+"aw5 c #f7f4f7",
+"alz c #f7f5f9",
+".mP c #f7fefe",
+"#HV c #f89985",
+"#Jq c #f89a84",
+"#BP c #f89c82",
+"#d4 c #f8a082",
+"#BJ c #f8a287",
+"#QI c #f8a883",
+"#g6 c #f8ab86",
+"#Se c #f8ac81",
+"#z. c #f8ae96",
+"#RM c #f8af60",
+"#aJ c #f8af87",
+"#m5 c #f8b092",
+".6g c #f8b392",
+".Tm c #f8b48e",
+".Tp c #f8b58b",
+".Wz c #f8ba99",
+"#lp c #f8c4a4",
+".3R c #f8e7dc",
+".ts c #f8e8c2",
+".kW c #f8e9bd",
+"alm c #f8eae3",
+".5y c #f8ebf2",
+".FF c #f8eded",
+"aDr c #f8edf2",
+".vc c #f8eedd",
+".nT c #f8f0e6",
+".gR c #f8f1f0",
+".t4 c #f8f3f0",
+".sC c #f8f3f4",
+"aAM c #f8f3f6",
+".kL c #f8f3fa",
+"avI c #f8f4f7",
+".AF c #f8f4fa",
+"amF c #f8f5f9",
+"ap8 c #f8f5fa",
+".oh c #f8f7fe",
+"aqn c #f8f8fb",
+"amp c #f8fbf6",
+"amD c #f8fefe",
+"amC c #f8ffff",
+"#fi c #f9a688",
+"#fO c #f9a988",
+"#pQ c #f9aa8f",
+"#lu c #f9b494",
+"#pM c #f9b499",
+".WO c #f9b69a",
+"#fs c #f9b991",
+".UN c #f9b998",
+"#m1 c #f9b99d",
+".UX c #f9bb9d",
+".WT c #f9bc98",
+"#il c #f9bda0",
+"amw c #f9c5a9",
+"afZ c #f9dcce",
+".5p c #f9e7eb",
+".fg c #f9e8ef",
+".aA c #f9eef4",
+".td c #f9efd9",
+".dD c #f9eff5",
+"aB4 c #f9f1f5",
+"ahZ c #f9f2ed",
+".vo c #f9f2ff",
+"aAN c #f9f4f7",
+"azy c #f9f5f8",
+"af2 c #f9f5f9",
+"avJ c #f9f6fd",
+"alj c #f9fcf7",
+"amE c #f9fcf8",
+"amo c #f9fefb",
+".mQ c #f9ffff",
+"#JD c #fa9f6d",
+"#sp c #faa38a",
+"#cl c #faa67d",
+"#pI c #faa686",
+"#Pi c #faa889",
+"#in c #faaf89",
+"#pP c #fab093",
+"#iy c #fab395",
+"#V5 c #fab44d",
+".To c #fab68d",
+"#yy c #fab69b",
+".Tn c #fab78f",
+".WA c #fabd9c",
+".Yb c #fabfa1",
+"#it c #fac0a1",
+".UP c #fac2a4",
+"#5z c #fadac3",
+"abS c #fae0dc",
+".5x c #faecec",
+".0v c #faede0",
+".vp c #faf3ff",
+"ant c #faf6fc",
+".AG c #faf7f9",
+"anJ c #faf7fd",
+"aoM c #faf9fc",
+"aoN c #fafafd",
+"alB c #fafcfb",
+"amn c #fafeff",
+".of c #fafffc",
+"#BO c #fb9e84",
+"#Jp c #fb9e85",
+"#H7 c #fb9f6b",
+"#oe c #fba487",
+"#of c #fba58c",
+"#fA c #fba685",
+"#Ah c #fba78c",
+"#BH c #fba88d",
+".7R c #fbac86",
+"#Sh c #fbac88",
+"#QP c #fbad81",
+"#kc c #fbaf92",
+".6k c #fbb89c",
+".27 c #fbb999",
+".UO c #fbbb9a",
+".WL c #fbbd9f",
+".WB c #fbbe9d",
+".ZP c #fbbe9f",
+".WK c #fbbfa0",
+"#iu c #fbc19f",
+".WF c #fbc2a3",
+".UV c #fbc3a5",
+"ahc c #fbdbca",
+"adk c #fbddd0",
+".yk c #fbdebc",
+".uB c #fbe6d9",
+"anx c #fbeef4",
+"aem c #fbf2f0",
+".xk c #fbf3f8",
+".ia c #fbf6ef",
+".t3 c #fbf6f4",
+"aq4 c #fbf7fd",
+"aw7 c #fbf8fa",
+"ayh c #fbf9fb",
+".jh c #fbfdff",
+".mS c #fbffff",
+"#BQ c #fca187",
+"#rl c #fca384",
+"#dX c #fca484",
+"#fw c #fcaa88",
+"#Ez c #fcab81",
+"#QO c #fcae85",
+"#1L c #fcb258",
+"#gX c #fcb48c",
+"#dS c #fcb58c",
+"#os c #fcb597",
+"#mS c #fcba9d",
+"#op c #fcba9e",
+"#jX c #fcbb97",
+"#g1 c #fcbf98",
+"#j7 c #fcc0a1",
+".tA c #fcebb7",
+".x2 c #fcecc5",
+"QtV c #fcecee",
+".so c #fcf3e7",
+".nS c #fcf5ea",
+"akt c #fcf5f2",
+"aC6 c #fcf5f7",
+".pu c #fcf5fc",
+".nQ c #fcf6f2",
+".xm c #fcf7e8",
+"awC c #fcf8fb",
+"aih c #fcf8fc",
+".pV c #fcf8ff",
+"avG c #fcf9fb",
+"awD c #fcf9fc",
+"akv c #fcf9fd",
+"ayi c #fcfafc",
+"aj# c #fcfbf2",
+"anI c #fcfcff",
+"akc c #fcfef9",
+"ali c #fcffff",
+"#rk c #fda385",
+"#QK c #fdac8d",
+"#Tb c #fdb660",
+"#Xw c #fdb74e",
+".4L c #fdb999",
+".WM c #fdbb9e",
+".UY c #fdbc9f",
+".1p c #fdbd9e",
+"#lz c #fdbe9d",
+"#k. c #fdc09f",
+"#is c #fdc2a3",
+"aie c #fdddcc",
+"a.z c #fde0d7",
+"adl c #fde5e4",
+".tc c #fde8d6",
+".19 c #fdeed8",
+"afE c #fdeee6",
+".az c #fdeff2",
+".s. c #fdf5f3",
+"aB3 c #fdf5f9",
+".mD c #fdf6e5",
+".tx c #fdf8ef",
+".mq c #fdf9ed",
+"aw# c #fdf9fc",
+"ajt c #fdf9fd",
+"anv c #fdf9ff",
+"aw4 c #fdfafc",
+"alk c #fdfbf4",
+"ayj c #fdfbfd",
+"aoO c #fdfbff",
+"alA c #fdffff",
+"#d3 c #feaa8d",
+"#Pj c #feac8e",
+"#UA c #feb758",
+"#on c #feb89b",
+"#ke c #feb995",
+"#or c #feb99a",
+".4K c #feba9a",
+"#mZ c #feba9c",
+"#iC c #febb96",
+"#ly c #fec09f",
+"#lw c #fec0a2",
+"#iv c #fec2a0",
+".yf c #fee2c0",
+"acY c #fee5de",
+".wb c #fee9c0",
+".yb c #feebd0",
+".tB c #feedba",
+".k3 c #fef5e1",
+".tw c #fef8ec",
+".i# c #fef8f1",
+".y4 c #fef9fa",
+".sB c #fefafa",
+"aw6 c #fefafd",
+"anu c #fefaff",
+"av. c #fefbfd",
+"ayg c #fefcfe",
+"awa c #fefcff",
+".nP c #fefeff",
+"#BN c #ffa288",
+"#Ak c #ffa68b",
+"#Gp c #ffa872",
+"#BL c #ffa88e",
+"#BM c #ffa88f",
+"#gT c #ffaa88",
+"#dO c #ffab87",
+"#EY c #ffad8c",
+"#Aj c #ffad92",
+"#lF c #ffad93",
+"#fn c #ffae8b",
+"#QJ c #ffae8d",
+"#Pk c #ffaf8c",
+"#gS c #ffaf8d",
+"#lE c #ffaf95",
+"#lr c #ffb08c",
+"#Pg c #ffb08d",
+"#Ph c #ffb08f",
+"#BK c #ffb096",
+"#QL c #ffb395",
+".7S c #ffb48e",
+"#iA c #ffb499",
+"#j1 c #ffb58f",
+"#Ai c #ffb59a",
+"#aI c #ffb68e",
+"#lH c #ffb693",
+"#iz c #ffb699",
+"#dU c #ffb790",
+"#im c #ffb892",
+"#mP c #ffb994",
+"#g5 c #ffb995",
+"#0p c #ffba5c",
+"#pO c #ffba9c",
+".6j c #ffbb9b",
+"#pN c #ffbb9c",
+"#ot c #ffbb9e",
+"#kd c #ffbba0",
+"#ck c #ffbc94",
+"#lG c #ffbc99",
+".WN c #ffbca0",
+"#iB c #ffbca1",
+"#Y0 c #ffbd58",
+".6i c #ffbd9d",
+"#gZ c #ffbe94",
+"#cj c #ffbe96",
+"#lv c #ffbe9f",
+"#m0 c #ffbea1",
+"#fr c #ffbf96",
+"#lq c #ffbf9a",
+"#mQ c #ffbf9d",
+"#lA c #ffbf9f",
+"#oq c #ffc0a1",
+"#dT c #ffc197",
+"#mR c #ffc1a2",
+"#m4 c #ffc2a3",
+"#gY c #ffc39a",
+"#j2 c #ffc39e",
+"#m3 c #ffc3a3",
+"#k# c #ffc4a4",
+".U1 c #ffc4a5",
+"#oo c #ffc4a7",
+"#m2 c #ffc5a5",
+"#j9 c #ffc6a4",
+"#lo c #ffc7a4",
+"#lx c #ffc7aa",
+"#jY c #ffc8a6",
+"#j8 c #ffc9aa",
+"#ln c #ffcaa3",
+".U2 c #ffcaaa",
+"#jZ c #ffcdac",
+"aI7 c #ffd2f3",
+".6y c #ffdbc4",
+"amr c #ffdcc0",
+".uA c #ffddd8",
+"#8X c #ffdfcd",
+"#Wh c #ffdfdd",
+"aae c #ffe0d6",
+"#7e c #ffe6d5",
+"abt c #ffe7de",
+"aHH c #ffe7fb",
+"a#Q c #ffe8db",
+"ahd c #ffebde",
+"acZ c #ffebe1",
+".wr c #ffecc8",
+".rR c #ffecd4",
+"amB c #ffece7",
+".tr c #ffedc3",
+"agV c #ffeddf",
+".x3 c #ffeecb",
+".yc c #ffeed1",
+"aif c #ffeee1",
+".qP c #ffefd2",
+".ic c #ffefe5",
+".ay c #ffeff0",
+"QtU c #fff0ef",
+"ake c #fff1e7",
+".5o c #fff2e9",
+"ajb c #fff3e3",
+".wD c #fff3f2",
+"aly c #fff3f3",
+".kV c #fff4c2",
+".pw c #fff4da",
+".pq c #fff4e4",
+"QtT c #fff4f2",
+".nR c #fff5eb",
+"ajs c #fff5ec",
+".pr c #fff5ed",
+".ps c #fff5f4",
+".mB c #fff6d7",
+".pe c #fff6e8",
+".qO c #fff6eb",
+".pt c #fff6fa",
+"aoB c #fff6fc",
+".x4 c #fff7db",
+".rS c #fff7df",
+"ah0 c #fff7e5",
+"all c #fff7ef",
+".gJ c #fff7f6",
+".mC c #fff8e1",
+"ajr c #fff8ef",
+".q0 c #fff8f0",
+".mG c #fff8f6",
+".h5 c #fff8f7",
+".mp c #fff8f8",
+".tO c #fff9e8",
+".ms c #fff9ee",
+".pv c #fff9f1",
+"aks c #fff9f6",
+".gI c #fff9f7",
+"aBH c #fff9fb",
+".qM c #fff9fd",
+"anw c #fff9ff",
+".ya c #fffae2",
+".qv c #fffae3",
+"aja c #fffaed",
+".q1 c #fffaf4",
+".q2 c #fffaf5",
+".qL c #fffaf9",
+".pI c #fffafd",
+"aB2 c #fffafe",
+".kO c #fffbef",
+"akd c #fffbf0",
+".gQ c #fffbf3",
+".ib c #fffbf5",
+".gM c #fffbf9",
+".s# c #fffbfb",
+".pH c #fffbfc",
+"aBG c #fffbfd",
+".qN c #fffbff",
+".qw c #fffce8",
+".pb c #fffcee",
+".mE c #fffcf0",
+".sp c #fffcf6",
+"avH c #fffcfe",
+".mo c #fffcff",
+".kN c #fffdf0",
+".gP c #fffdf1",
+".pE c #fffdf5",
+"aig c #fffdff",
+".mr c #fffef3",
+".pd c #fffef4",
+"amq c #fffef8",
+".pF c #fffef9",
+"aj. c #fffefc",
+".ji c #fffeff",
+".kM c #fffff4",
+".mF c #fffff7",
+"agU c #fffff8",
+"aku c #fffffa",
+".q3 c #fffffb",
+".i. c #fffffc",
+".l# c #ffffff",
+"Qt.Qt#QtaQtbQtcQtdQteQtfQtgQthQtiQtjQtkQtlQtmQtnQtoQtpQtqQtrQtrQtsQttQtuQtvQtwQtxQtyQtzQtAQtBQtCQtDQtEQtFQtGQtHQtIQtJQtKQtLQtMQtNQtOQtPQtQQtRQtSQtTQtUQtVQtWQtXQtYQtZQt0Qt1Qt2Qt3Qt4Qt5Qt6Qt7Qt5Qt8Qt9.#..##.#a.#b.#c.#d.#e.#f.#g.#h.#i.#j.#k.#l.#m.#n.#o.#p.#q.#r.#s.#t.#u.#v.#w.#x.#y.#z.#A.#A.#B.#C.#D.#E.#E.#D.#C.#B.#D.#D.#F.#F.#F.#G.#H.#I.#J.#K.#L.#M.#N.#O.#P.#Q.#R.#S.#S.#T.#U.#V.#V.#W",
+".#XQt#.#Y.#ZQtc.#0.#1Qtf.#2.#3.#4.#5Qtk.#6.#7.#8QtoQtp.#9QtrQtrQtsQtt.a..a#.aa.ab.ac.ad.ae.af.ag.ah.ai.aj.ak.al.am.an.ao.ap.aq.ar.as.at.au.av.aw.ax.ay.az.aA.aB.aC.aD.aE.aF.aG.aH.aI.aJ.aK.aL.aM.aN.aO.aP.aQ.aR.aS.aT.aU.aV.aW.aX.aY.aZ.a0.a1.a2.a3.a4.#o.#p.a5.#r.#s.#t.#u.#u.a6.a7.#x.#y.#z.a8.#D.#G.a9.#F.#F.a9.#G.#D.#E.#D.#F.#F.#F.#G.#E.#I.b..b#.ba.a5.bb.bc.bd.be.bf.bg.bh.bi.#P.bj.bk.bl",
+".bmQt#.bn.boQtc.bp.bq.br.bs.bt.bu.bv.bw.bx.by.bz.bA.bB.#9.bC.bCQts.bD.bE.bF.bG.bH.bI.bJ.bK.bL.bM.bN.bO.bP.bQ.bR.bS.bT.bU.bV.bW.bX.bY.bZ.b0.b1.b2.b3.b4.b5.b6.b7.b8.b9.c..c#.ca.c#.cb.cc.cd.ce.cf.cg.ch.ci.cj.ck.cl.cm.cn.co.cp.cq.cr.cs.ct.cu.cv.cw.cx.cy.cz.cA.cB.cC.#v.cD.cE.cF.cG.cH.cI.#H.#y.cH.#I.a9.cJ.cJ.a9.#I.cH.#I.#E.#D.#F.#F.#G.#E.#I.b..cK.cL.cM.cN.cO.#U.bi.cP.cQ.cR.cS.cT.cU.cV.cW",
+".cXQt#.cY.cZ.c0.c1.bq.c2.c3.c4.c5.c6.bw.c7.c8.c9.d..bB.d#.da.da.db.bD.dc.dd.de.df.dg.dh.di.dj.dk.dl.dm.dn.do.dp.dq.dr.ds.dt.du.dv.dw.dx.dy.dz.dA.dB.dC.dD.dE.dF.dG.dH.dI.dJ.dK.dL.dM.dN.dO.dP.dQ.dR.dS.dT.dU.dV.dW.dX.dY.dZ.d0.d1.d2.d3.d4.d5.d6.d7.d8.d9.e..e#.ea.eb.#l.ec.ec.ed.ed.ee.ef.ef.eg.eh.#I.#E.#D.#D.#E.#I.eh.eh.#I.#D.a9.#F.#D.#E.#I.b#.cK.cK.ei.ej.ek.el.bd.em.en.#S.eo.#P.ep.eq.er",
+".esQt#.et.eu.c0.ev.ew.ex.c9.ey.ez.eA.eB.eB.eC.eD.eE.eF.d#.eG.eG.db.eH.eI.eJ.eK.ab.eL.eM.eN.eO.eP.eQ.eR.eS.eT.eU.eV.eW.eX.eY.eZ.e0.e1.e2.e3.e4.e5.e6.e7.e8.e9.f..f#.fa.dB.fb.fc.fd.fe.ff.fg.fh.fi.fj.fk.fl.fm.fn.fo.fp.fq.fr.fs.ft.fu.fv.fw.fx.cO.fy.fz.fA.fB.fC.fD.fE.eb.fF.fF.fF.fG.fG.fH.fH.fH.#I.#I.eh.fI.fI.eh.#I.#I.fI.eh.#I.#D.a9.#D.#D.#H.fJ.fK.fL.#M.cN.fM.fN.fO.fP.fQ.fR.fS.fT.#V.fU.bk",
+".fVQt#.fW.fX.c0.fY.fZ.f0.f1.f2.f3.f4.eB.f5.f6.f7.f8.eF.f9.g..g..g#.eH.ga.gb.gc.gd.ge.gf.gg.gh.gi.gj.gk.gl.gm.gn.go.gp.gq.gr.gs.gt.gu.gv.gw.gx.gy.gz.gA.gB.gC.gD.gE.gF.gG.gH.gI.gJ.gK.gL.gM.gN.gO.gP.gQ.gR.gS.gT.gU.gV.gW.gX.gY.gZ.g0.g1.g2.g3.b#.g4.g5.g6.g7.g8.g9.h..h#.ha.ha.ha.ha.ha.ha.ha.ha.#I.eh.hb.hc.hc.hb.eh.#I.hb.fI.#I.#D.#G.#D.#D.#E.fJ.#K.hd.#M.he.fM.hf.hg.hh.hi.hj.hk.hl.hm.hn.fU",
+".hoQt#.hp.hq.hr.hs.ht.hu.hv.hw.hx.hy.eB.hz.hA.hB.hC.hD.f9.g..hE.g#.hF.hGQtvQtw.hH.ge.eM.hI.hJ.hK.hL.gk.dn.hM.hN.hO.hP.eX.hQ.hR.hS.hT.hU.hV.hW.hX.hY.hZ.h0.h1.h2.h3.h4.h5.h6.h7.h8.h9.i..i#.ia.ib.ic.id.ie.if.ig.ih.ii.ij.ik.il.im.in.io.ip.iq.ir.is.g4.it.iu.iv.iw.ix.fE.iy.iy.iz.iz.iz.iz.iz.iz.hb.hb.hb.hb.hb.hb.hb.hb.hc.hb.cH.#E.#D.#D.#D.#E.b#.#K.ba.cM.iA.iB.iC.iD.iE.iF.iG.iH.iI.iJ.#V.iK",
+".iLQt#.iM.iN.hr.iO.ht.hu.iP.hv.iQ.iR.eB.iS.iT.iU.hC.hD.f9.hE.hE.iV.iW.hG.iX.iY.iZ.eL.i0.gg.i1.i2.i3.i4.i5.i6.eU.i7.i8.i9.j..j#.ja.jb.jc.jd.je.jf.jg.jh.ji.jj.jk.jl.jm.jn.jo.jp.jq.jr.js.jt.ju.jv.jw.jx.jy.jz.jA.jB.jC.jD.jE.jF.jG.jH.jIQt1.jJ.jK.jL.jM.jN.jO.jP.iw.jQ.jR.jS.jS.jS.jS.jT.jU.iz.iz.jV.hc.hb.eh.eh.hb.hc.jV.hc.hb.eh.#E.#D.#D.#D.#D.jW.fK.jX.jY.jZ.iB.iC.j0.j1.j2.j3.iI.bc.j4.fU.bl",
+".j5.j6.j7.j8.j6.j9.k..k#.ka.kb.kc.kd.ke.kf.kg.kh.ki.kj.kk.kl.km.kl.kn.ko.kp.kq.kr.ks.kt.ku.kv.kw.kx.ky.kz.kA.kB.kB.kC.kD.kE.kF.kG.kH.kI.kJ.kK.kL.kM.kN.kO.kP.kQ.kR.kS.kT.kU.kV.kW.kX.kY.kZ.k0.k1.k2.k3.k4.k5.k6.k7.k8.k9.l..l#.la.lb.lc.ld.le.lf.lg.lh.li.lj.lk.ll.lm.ln.lo.lo.lo.lo.lo.lo.lo.lo.lp.lq.lq.lr.lr.ls.ls.lt.lu.lv.lw.lx.ly.lu.lz.lA.lp.lt.lB.lt.ls.lq.ls.lt.hc.lC.hb.hb.lD.lE.lF.lG",
+".lH.lI.lJ.lK.lL.lM.lN.lO.lP.lQ.lR.lS.lT.lU.lV.lW.lX.lY.lZ.l0.l1.l2.l3.l4.l5.l6.l7.l8.l9.m..m#.ma.kx.mb.mc.md.me.mf.mg.mh.mi.mj.mk.ml.mm.mn.mo.mp.mq.mr.ms.mt.mu.mv.mw.mx.my.mz.mA.mB.mC.mD.mE.mF.mG.mH.mI.mJ.mK.mL.mM.mN.mO.mP.mQ.mR.mS.mT.mU.mV.mW.mX.mY.mZ.m0.m1.m2.m3.m4.m4.m4.m4.m4.m4.m4.m4.lp.lq.lq.lr.lr.ls.ls.lt.m5.lu.lv.lv.m6.m5.m7.m8.lq.ls.ls.m5.m6.m9.m9.lq.hc.lC.hb.hb.hc.lE.n..lG",
+".n#.na.nb.nc.nd.ne.nf.ng.nh.ni.nj.nk.nl.nm.nn.no.np.nq.nr.ns.nt.nu.nv.nw.nx.ny.nz.nA.nB.m..nC.nD.nE.nF.nG.nH.nI.nJ.no.nK.nL.nM.nN.nO.nP.l#.nQ.nR.nS.nT.nU.nV.nW.nX.nY.nZ.n0.n1.n2.n3.n4.n5.n6.n7.n8.n9.o..o#.oa.ob.oc.od.oe.of.og.l#.l#.oh.ji.oi.oj.ok.ol.om.on.oo.op.oq.fH.fH.fH.fH.fH.fH.fH.fH.lp.lq.lq.lr.lr.ls.ls.lt.lz.or.m5.os.m5.lz.lA.ot.lt.ou.lr.lr.lr.lr.lp.ls.hc.lC.lC.lC.ov.lF.lG.ow",
+".ox.oy.oz.oA.oB.oC.oD.oE.oF.oG.oH.oI.oJ.oK.oL.oM.oN.oO.oP.oQ.oR.oS.oT.oU.oV.oW.e3.oX.oY.oZ.o0.o1.o2.o3.o4.o5.o6.o7.o8.o9.p..p#.pa.pb.pc.pd.pe.pf.pg.ph.pi.pj.pk.nX.pl.pm.pn.po.pp.pq.pr.ps.pt.pu.pv.pw.px.py.pz.pA.pB.pB.pC.pD.pE.pF.pG.pH.pI.mo.mT.pJ.pK.pL.pM.pN.aU.pO.ef.ef.ef.ef.ef.ef.ef.ef.lp.lq.lq.lr.lr.ls.ls.lt.m7.m7.pP.pP.pP.m7.lA.lA.pQ.lt.lr.lr.lB.lB.lt.ls.hc.hc.lD.hc.lE.n..ow.pR",
+".pS.pT.pU.pV.pW.pX.pY.pZ.p0.p1.p2.p3.p4.p5.p6.p7.p8.p9.q..q#.oM.q..qa.qb.qc.qd.qe.qf.qg.qh.qi.qj.qk.ql.qm.qn.qo.qp.qq.qr.qs.qt.qu.qv.qw.qx.qy.qz.qA.qB.qC.qD.qE.qF.qG.qH.qI.po.qJ.qK.pv.qL.qM.qN.qO.qP.qQ.qR.qS.qT.qU.qV.qW.qX.qY.qZ.q0.q1.q2.q3.q4.q5.q6.q7.q8.q9.r..r#.ef.ef.ef.ef.ef.ef.ef.ef.lp.lq.lq.lr.lr.ls.ls.lt.m7.m7.m7.lA.m7.m7.pP.lz.lt.ls.lq.lq.lr.lr.ls.m9.hc.hc.hc.ov.ra.lG.pR.rb",
+".rc.rd.re.rf.rg.rh.ri.rj.rk.rl.rm.rn.ro.rp.rq.rr.rs.rs.rt.ru.rv.rw.rx.ry.rz.rA.rB.rC.rD.rE.rF.rG.rH.rI.rJ.rK.rL.rM.rN.rO.rP.rQ.rR.rS.rT.rU.rV.rW.rX.rY.rZ.r0.r1.r2.r3.r4.r5.r6.r7.r8.r9.q0.s..s#.sa.sb.sc.sd.se.sf.sg.sh.si.sj.sk.sl.sm.sn.so.gP.sp.l#.sq.sr.ss.st.su.sv.fH.fH.fH.fH.fH.fH.fH.fH.lp.lq.lq.lr.lr.ls.ls.lt.lz.pP.m7.lA.m7.lz.os.lu.sw.lt.lr.lr.ou.ou.lr.ls.hc.hc.hc.lE.lF.ow.rb.sx",
+".sy.sz.sA.sB.sC.sD.sE.sF.sG.sH.sI.sJ.sK.sL.sM.sN.sO.sP.sQ.sR.sS.sT.sU.sV.sW.sX.sY.sZ.s0.s1.s2.s3.s4.s5.s6.s7.s8.s9.t..t#.ta.tb.tc.td.te.tf.tg.th.ti.tj.tk.tl.tm.tn.to.tp.tq.tr.ts.tt.tu.tv.tw.tx.ty.tz.tA.tB.tC.tD.tE.tF.tG.tH.tI.tJ.tK.tL.tM.tN.tO.tP.tQ.tR.tS.tT.tU.tV.m4.m4.m4.m4.m4.m4.m4.m4.lp.lq.lq.lr.lr.ls.ls.lt.os.or.pP.m7.lz.os.lv.lx.lB.pQ.pQ.tW.sw.lt.lt.lB.hc.hc.ov.lE.lG.tX.tY.tZ",
+".t0.t1.t2.t2.t3.t4.t5.t6.t7.t8.t9.u..u#.ua.ub.uc.ud.ue.uf.ug.uh.ui.uj.uk.ul.um.un.uo.up.uq.ur.us.ut.uu.uv.uw.s8.ux.uy.t#.uz.uA.uB.uC.uD.uE.uF.uG.uH.uI.uJ.uK.uL.uM.uN.uO.uP.uQ.uR.uS.uT.uU.uV.uW.uX.uY.uZ.u0.u1.u2.u3.u4.u5.u6.u7.u8.u9.v..v#.va.vb.vc.vd.ve.vf.vg.vh.vi.lo.lo.lo.lo.lo.lo.lo.lo.lp.lq.lq.lr.lr.ls.ls.lt.lu.os.lz.lz.or.lu.lx.vj.ls.lt.lB.lt.ls.lq.ls.lt.hc.hc.ov.vk.lG.pR.sx.tZ",
+".vl.vm.vn.vo.vp.vq.vr.vs.vt.vu.vv.vw.vx.vy.vz.vA.vB.vC.vD.vE.vF.vG.vH.vI.vJ.vK.vL.vM.vN.vO.vP.vQ.vR.vS.vT.vU.vV.vW.vX.vY.vZ.v0.v1.v2.v3.v4.v5.v6.v7.v8.v9.w..w#.wa.wb.wc.wd.we.wf.wg.wh.wi.wj.wk.wl.wm.wn.wo.wp.wq.wr.ws.wt.wu.wv.ww.wx.wy.wz.wA.wB.wC.wD.wE.wF.wG.wH.wI.wJ.cx.wK.wL.wM.wN.wO.wP.wQ.wR.iz.wS.wR.wT.wS.wU.wV.wV.wV.wV.wW.wW.wW.wW.wX.wY.wZ.w0.wZ.w0.w1.w2.w3.w4.w5.w6.w4.w7.w8.w9",
+".x..x#.xa.xb.xc.xd.xe.xf.xg.xh.xi.xj.xk.xl.xm.xn.xo.xp.xq.xr.xs.xt.xu.xv.xw.xx.xy.xz.xA.xB.xC.xD.xE.xF.xG.xH.xI.xJ.xK.xL.xM.xN.xO.xP.xQ.xR.xS.xT.xU.xV.xW.xX.xY.xZ.x0.x1.x2.x3.x4.x5.x6.x7.x8.x9.y..y#.ya.yb.yc.yd.ye.x3.yf.yg.yh.yi.yj.yk.yl.ym.yn.yo.yp.yq.yr.ys.yt.yu.yv.yw.yx.yy.yz.yA.yB.yC.wQ.wS.iz.yD.yE.wR.wS.jS.ha.ha.wW.fF.yF.yG.yG.yH.yI.yJ.yK.yK.yL.yL.yM.yN.w4.w4.w4.w3.yO.yP.w8.yQ",
+".yR.yS.yT.yU.yV.yW.yX.yY.yZ.y0.y1.y2.y3.y4.y5.y6.y7.y8.y9.z..z#.za.zb.zc.zd.ze.zf.zg.zh.zi.zj.zk.zl.zm.zn.zo.zp.zq.zr.zs.zt.zu.zv.zw.zx.zv.zy.zz.zA.zB.zC.zD.zE.zF.zG.zH.zI.zJ.zK.zL.zM.zN.zO.zP.zQ.zR.zS.zT.zU.zV.zW.zX.zY.zZ.z0.z1.z2.z3.z4.z5.z6.z7.z8.z9.A..A#.Aa.Ab.Ac.Ad.Ae.Af.Ag.Ah.Ai.iB.wQ.wR.wS.wS.wR.wR.wS.iz.ha.wV.fF.yG.Aj.Ak.Al.Am.w0.yL.w2.w2.yK.yK.An.Ao.w5.w4.yO.Ap.Aq.w8.w8.w8",
+".Ar.As.At.Au.Av.Aw.Ax.Ay.Az.AA.AB.AC.AD.AE.AF.AG.AH.AI.AJ.AK.AL.AM.AN.AO.AP.AQ.AR.AS.AT.AU.AV.AW.AX.AY.AZ.A0.A1.A2.A3.A4.A5.A6.A7.A8.A9.B..B#.Ba.Bb.Bc.Bd.Be.Bf.Bg.Bh.Bi.Bj.Bk.Bl.qE.Bm.Bn.Bo.Bp.Bq.Br.Bs.Bt.Bu.Bv.Bw.Bx.By.Bz.BA.BB.BC.BD.BE.BF.BG.BH.BI.BJ.BK.BL.BM.BN.BO.BP.BQ.ou.BR.BS.BT.BU.BV.BW.BW.BW.BW.BW.wQ.wQ.Aj.BX.BX.Ak.Al.Am.BY.BZ.wZ.w1.yK.yK.w1.w1.yK.An.w6.w3.Ap.B0.w9.B1.B0.w8",
+".B2.B3.B4.B5.B6.B3.B7.B8.B9.C..C#.Ca.Cb.Cc.Cd.Ce.Cf.Cg.Ch.Ci.Cj.Ck.Cl.Cm.Cn.Co.Cp.Cq.Cr.Cs.Ct.Cu.Cv.Cw.Cx.Cy.Cz.CA.CB.CC.CD.CE.CE.CF.CG.CH.CI.CE.CJ.CK.CL.CM.CN.CO.CP.CQ.CR.CS.CT.CU.CV.CW.CX.CY.CZ.C0.C1.C2.C3.C4.C5.C6.C7.C8.C9.D..D#.Da.Db.Dc.Dd.De.Df.Dg.Dh.Di.Dj.Dk.Dl.Dm.Dn.jU.Do.Dp.Dq.Dr.Ds.Dt.w2.Ds.yL.Du.Du.Dv.Dt.Dw.Dx.Dv.BZ.BZ.BY.Am.w1.yK.yM.w2.yL.yL.Dy.Dz.w4.yO.Aq.w9.DA.DA.w9.yQ",
+".DB.DC.DD.DE.DF.DG.DH.DI.DJ.DK.DL.DM.DN.DO.DP.DQ.DR.DS.DT.DU.DV.DW.DX.DY.DZ.D0.D1.D2.D3.D4.D5.D6.D7.D8.D9.E..E#.Ea.Eb.Ec.Ed.Ee.Ef.Eg.Eh.Ei.Ej.Ek.El.Em.En.Eo.Ep.Eq.Er.Es.Et.Eu.Ev.Ew.Ex.Ey.Ez.EA.EB.EC.ED.EE.EF.EG.EH.EI.EJ.EK.EL.EM.EN.EO.EP.EQ.ER.ES.ET.EU.EV.EW.EX.EY.EZ.E0.E1.E2.E3.E4.E5.yL.E6.E7.E7.E7.E8.E9.E9.E6.F..F..F#.Fa.Dt.Dx.BZ.BZ.Fb.Fc.Fd.Fe.yN.Dz.Ao.Ff.w7.yP.w8.B1.DA.Fg.Fg.Fg",
+"Qt..Fh.Fi.Fj.Fk.Fl.Fm.Fn.Fo.Fp.Fq.Fr.Fs.Ft.Fu.Fv.Fw.Fx.Fy.Fz.FA.FB.FC.FD.FE.FF.FG.FH.FI.FJ.FK.FL.FM.FN.FO.FP.FQ.FR.FS.FT.FU.FV.FW.FX.FY.FU.FZ.F0.F1.F2.F3.F4.F5.F6.F7.F8.F9.G..G#.Ga.Gb.Gc.Gd.Ge.Gf.Gg.Gh.Gi.Gj.Gk.Gl.Gm.Gn.Go.Gp.Gq.Gr.Gs.Gq.Gt.Gu.Gv.Gw.Gx.Gy.Gz.GA.GB.GC.GD.GE.GF.GG.GH.GI.Fb.E6.GJ.GK.GJ.E6.E9.E6.E7.GL.F..F..GM.F#.Fa.GN.GN.Fc.Fd.GO.Fd.Ao.Fb.Fc.Fd.w8.w8.w8.B0.w9.Fg.GP.GQ",
+".GR.GS.GT.GU.GV.GW.GX.GY.GZ.G0.G1.G2.G3.G4.G5.G6.G7.G8.G9.H..H#.Ha.Hb.Hc.Hd.He.Hf.Hg.Hh.Hi.Hj.Hk.Hl.Hm.Hn.Ho.Hp.Hq.Hr.Hs.FU.Ht.Hu.Hv.Hw.Hx.Hy.Hz.HA.HB.HC.HD.HE.HF.HG.HH.HI.HJ.HK.HL.HM.HN.HO.HP.HQ.HR.HS.HT.HU.HV.HW.HX.HY.HZ.F0.H0.H1.H2.H3.H4.H5.F0.H6.H7.H8.H9.I..I#.Ia.Ib.Ic.Id.Ie.If.GI.yK.E6.E7.GK.E7.E9.Dt.E8.E7.F..F..F..F..F..F..F..F..Dz.Ao.Fe.Ao.An.w2.An.yN.w9.yQ.w8.w8.yQ.Fg.GQ.Ig",
+".Ih.Ii.bw.Ij.Ik.Il.Ih.Im.In.Io.Ip.Iq.Ir.Is.It.Iu.Iv.Iw.Ix.Iy.Iz.IA.IB.IC.ID.IE.IF.IG.zo.IH.II.IJ.IK.IL.Hn.IM.IN.IO.IP.IQ.IR.IS.IT.IU.IV.IW.IX.IY.IZ.I0.I1.I2.I3.I4.I5.HF.I6.I7.I8.I8.I9.J..J#.I7.Ja.Ja.Jb.Gb.Jc.Jd.Je.Je.Jf.Jg.Jh.Ji.Jj.Jk.Jl.Jm.Jn.Jo.Jp.Jq.Jr.Js.Jt.Ju.Jv.Jw.Jx.Jy.Jz.JA.JB.JC.JD.JD.JD.JD.JE.JF.JF.JF.JG.JH.JH.JH.JI.JJ.JJ.JJ.JK.JK.JL.JL.JM.JN.JO.JP.JQ.JR.JS.JS.JT.JU.JU.JV",
+".Io.JW.bw.JX.Ik.Il.Io.Im.JY.JZ.J0.J1.J2.J3.f7.J4.J5.J6.Ix.J7.J8Qte.J9.K..K#.Ka.Kb.Kc.Kd.Ke.Kf.Kg.Kh.Ki.yn.Kj.Kk.IO.Kl.Km.Kn.Ko.Kp.Kq.Kr.Ks.Kt.Ku.Kv.Kw.Kx.Jk.Ky.Kz.Kw.KA.KB.KC.KD.KB.KE.KF.KG.KB.KH.KH.KI.KJ.KK.ES.Gl.ER.KL.KM.KN.KO.KP.KQ.KR.KS.KT.KU.KV.KW.F5.KX.KY.KZ.K0.K1.K2.K3.K4.K5.K6.K7.K8.K8.K9.L..JD.JD.L#.JE.La.Lb.Lb.Lb.JG.JH.JH.JH.JO.JN.JN.JN.JN.JN.JN.JM.JU.JR.JS.Lc.JT.JU.JU.JV",
+".Io.Ld.Le.Lf.Lg.Lh.Li.Lj.Lk.Ll.J0.iP.Lm.Ln.Lo.Lp.Lq.Lr.Ls.Lt.Lu.Lv.Lw.Lx.Ly.Lz.LA.LB.LC.LD.LE.LF.LG.LH.LI.LJ.Jq.IO.I0.Km.LK.LL.LM.LN.LO.LP.F0.F0.LQ.LR.LS.LQ.LT.LQ.LU.LV.LW.LX.LY.LZ.LY.LY.L0.L1.L2.L3.L4.L5.L6.L7.L8.L8.L9.FT.M..M#.Ma.I9.Mb.Mc.Md.Me.Mf.Mg.KD.Jk.Mh.Mi.Mj.Mk.Ml.Mm.Mn.Mo.Mp.eq.Mq.Mq.Mq.Mr.K8.K8.K8.K8.Ms.Ms.Mt.Mt.Mu.Mu.La.La.Mv.Mw.Mw.Mx.JP.JN.JN.My.Mz.JT.MA.MA.JT.Mz.JU.Mz",
+".MB.MC.MD.ME.lX.MF.MG.MH.MI.Ll.Ip.MJ.MK.ML.MM.MN.MO.Lr.Ix.J7.J8Qte.Lw.MP.MQ.MR.MS.MT.MU.MV.MW.MX.MY.MZ.M0.M1.M2.IO.I2.Km.H4.M3.M4.M5.M6.M6.M7.M8.M9.N..N#.Na.Nb.Nc.Nb.Nb.Nd.Ne.Nf.tj.Ng.Nh.Nf.Nf.Ni.Ni.Nj.Nk.Nl.Nm.Nm.Nn.No.Ni.Np.Nq.Nr.Ns.Nt.Nu.Jf.Gq.Nv.Nw.Nx.Ny.Nz.NA.NB.NC.ND.NE.NF.NG.NH.NI.NJ.NK.NK.NL.NL.NM.NM.Mq.NN.NN.NO.NO.NP.NP.Ms.Ms.NQ.NQ.NR.Mv.Mw.Mw.NS.NS.JU.JV.JT.JR.NT.Mz.NU.NV",
+".MG.NW.NX.NY.NZ.N0.N1.N2.N3.N4.N5.N6.N7.N8.N9.J4.O..O#.Oa.Ob.Oc.bq.J9.K..Od.Oe.Of.Og.Oh.Oi.Oj.Ok.Ol.MZ.Om.On.Oo.Op.H9.L0.Oq.Or.zv.Os.Ot.Ou.Ov.Ow.Ox.Oy.Oz.OA.OB.OC.OD.OE.OF.OG.OH.OI.OJ.OK.OL.OM.ON.OO.OP.OQ.OR.OS.OT.OU.OV.OW.OX.OY.OZ.O0.O1.O2.O3.O4.O5.O6.O7.O8.O9.P..P#.Pa.Pb.Pc.Pd.Pe.Pf.Pg.Ph.Ph.Ph.Ph.Pi.Pj.Pj.Pj.Pk.Pk.Pl.Pl.Pl.NN.NN.NO.NQ.NQ.NQ.Pm.Pn.Pn.Po.Po.NV.NU.NU.JU.JU.NU.Pp.Pq",
+".Pr.NW.Ps.Pt.Pu.Pv.Pw.Px.Py.Pz.PA.PB.PC.PD.PEQth.PF.O#.PG.PH.PI.PJ.J9.PK.PL.PM.PN.PO.oS.PP.PQ.PR.PS.PT.LI.PU.Kr.PV.H9.PW.PX.PY.PZ.Na.P0.P1.P2.P3.P4.P5.P6.P7.P8.P9.Q..Q#.Qa.Qb.Qc.Qd.Qe.Qf.Qg.Qh.Qi.Qj.Qk.Ql.Qm.Qn.Qo.Qp.Qq.Qr.Qs.Qt.Qu.Qv.Qw.Ox.N#.Qx.Qy.Qz.QA.QB.QC.QD.QE.QF.QG.QH.QI.QJ.QK.QL.QM.QM.QN.QO.QO.QO.QP.QP.QQ.QQ.QQ.Pk.Pl.Pl.Pl.NN.Pm.QR.Pn.QS.QT.QU.QV.QW.QX.QX.QX.Pp.QY.Pp.QZ.Q0",
+".Q1.Q2.Q3.Q4.Q5.Pv.Q6.Q7.Q8.Q9.R..MJ.R#.Ra.Rb.#3.Rc.Rd.Oa.Ob.rB.bq.Re.MP.Rf.Rg.Rh.Ri.Rj.Rk.Rl.Rm.Rn.Ro.Rp.Rq.Rr.PV.I2.PW.Rs.Rt.Ru.Rv.Rw.Rx.Ry.Rz.RA.RB.RC.RD.RE.RF.RG.RH.RI.RJ.RK.RJ.RL.RM.RN.RO.RP.RQ.RR.RS.RT.RU.RV.RW.RX.RY.RZ.R0.R1.R2.R3.R4.R5.R6.M6.R7.R8.R9.S..S#.Sa.Sb.Sc.Sd.Se.Sf.Sg.Sh.Si.Si.Sj.Sk.QM.QM.QM.Sl.QQ.QQ.QP.Pk.Pl.Pl.Pl.NN.Sm.QU.QU.QV.QV.QV.QV.QV.QZ.Sn.Q0.So.Pq.QZ.Sp.Sq",
+".Sr.Ss.Q3.Q4.St.Su.Sv.Sw.Sx.Io.Sy.Sz.SA.c5.SB.SC.SDQto.SE.SF.SG.bq.SH.SI.f3.SJ.SK.SL.SM.SN.SO.SP.SQ.SR.SS.ST.SU.SV.I2.PW.SW.SX.SY.SZ.S0.S1.S2.S3.S4.S5.S6.S7.S8.S9.T..T#.Ta.Tb.Tc.Td.Te.Tf.Tg.Th.Ti.Tj.Tk.Tl.Tm.Tn.To.Tp.Tq.Tr.Ts.Tt.Tu.Tv.Tw.Tx.Ty.Tz.TA.TB.TC.TD.TE.TF.TG.TH.TI.TJ.TK.TL.TM.TN.TO.TP.Si.Si.Si.Sk.Sk.QM.QQ.QQ.Pk.Pk.Pl.Pl.NN.NN.TQ.TQ.TR.TS.QV.QV.Sm.QT.Sn.TT.TU.TT.So.TV.TW.TX",
+".TY.TZ.T0.T1.T2.T3.T4.T5.T6.T7.T8.T9.U..U#.Ua.Ub.Uc.nH.Ud.Ue.Uf.Ug.Uh.Ui.Uj.Uk.Ul.Um.Un.Uo.Up.Uq.Ur.Us.Ut.Uu.Uv.Uw.Ux.Uy.Uz.UA.UB.UC.UD.UE.UF.UG.UH.UI.UJ.UK.UL.UM.UN.UO.UP.UQ.UR.US.UT.UU.UV.UP.UW.UX.UY.UZ.U0.U1.U2.U3.U4.U5.U6.U7.U8.U9.V..V#.Va.Vb.Vc.Vd.Ve.Vf.Vg.Vh.Vi.Vj.Vk.Vl.Vm.Vn.Vo.Vp.Vq.Vr.Vs.Vr.Vq.Vq.Vt.Vs.Vu.Vv.Vw.Vv.Vu.Vx.Vu.Vv.Vy.Vz.VA.VB.VC.VD.VE.VF.VG.VH.VH.VH.VI.VJ.VK.VL",
+".VM.VN.VO.VP.VQ.VR.VS.VT.VU.VV.VW.VX.VY.VZ.V0.V1.V2.V3.V4.dy.V5.V6.V7.V8.V9.GU.W..W#.Wa.Wb.Wc.Wd.We.Wf.Wg.Wh.Wi.Wj.Wk.Wl.Wm.Wn.Wo.Wp.Wq.Wr.Ws.Wt.Wu.Wv.Ww.Wx.Wy.Wz.WA.WB.WC.WD.WE.WF.WG.WH.WI.WJ.WK.WL.WM.WN.WO.WP.WQ.WR.WS.WT.WU.WV.WW.WX.WY.WZ.W0.W1.W2.W3.W4.Nb.W5.Jj.W6.W7.W8.W9.X..X#.Xa.Xb.Xc.Vt.Xd.Vr.Vq.Xe.Vq.Vr.Xf.Vt.Xg.Xg.Vt.Vt.Xg.Xh.Xi.Xi.Xi.Xj.Vy.Vy.Vy.Vy.VI.VI.Xk.Xk.Xl.Xl.Xl.Xl",
+".Xm.Xn.Xo.Xp.Xq.Xr.Xs.Xt.Xu.Xv.Xw.Xx.nh.bw.Xy.Xz.XA.XB.XC.XD.XE.XF.XG.XH.MB.Ld.XI.XJ.XK.XL.XM.XN.XO.XP.Ov.XQ.XR.XS.XT.XU.XV.XW.XX.XY.XZ.X0.X1.X2.X3.X4.X5.X5.X6.X7.X8.X9.Y..Y#.Ya.Yb.Ya.Yc.Yd.Y..Ye.Yf.Yg.Yh.Yi.Yj.Yk.Yl.Ym.Yn.Yo.Yp.Yq.Yr.Ys.Yt.Yu.Yv.Yw.Yx.Yy.Yz.YA.YB.YC.YD.YE.YF.YG.YH.YI.YJ.Xe.Vq.Vr.Vq.Xe.YK.Xe.Vt.YL.YM.YN.Vx.YN.Vx.Xg.Xh.YO.YP.YP.YQ.YQ.YR.YR.YS.Xk.VJ.YT.YU.YU.YT.VJ.TO",
+".YV.YW.YX.YY.YZ.Y0.Y1.Y2.Y3.Y4.Y5.Y6.Y7.Y8.Y9.Z..Z#.Za.Zb.Zc.Zd.Ze.Zf.Zg.hr.Zh.Zi.Zj.Zk.Zl.Zm.Zn.Zo.Zp.Zq.Zr.Wj.Zs.Zt.Zu.Zv.Zw.Zx.Zy.Zz.ZA.ZB.ZC.ZD.ZE.ZF.ZG.ZH.ZI.ZF.ZJ.ZK.ZL.ZM.ZN.ZO.ZO.ZP.ZQ.ZR.ZS.ZT.ZU.ZV.ZW.ZX.ZY.ZZ.Z0.Z1.Z1.Z2.Z3.Z4.Z5.Z6.Z7.Z8.Z9.0..0#.0a.0b.0c.0d.0e.0f.0g.0h.0i.0j.0k.Xe.Vq.Xe.0k.0l.0k.0m.0n.YL.YK.YK.YM.YM.Xf.0o.0p.0p.0p.0p.0q.0q.0q.0q.Xl.0r.0s.YU.0t.YU.0s.YT",
+".0u.0v.0w.0x.0y.0z.0A.0B.0C.0D.0E.0F.0G.0H.0I.0J.0K.0L.oW.0M.0N.0O.0P.0Q.ev.0R.0S.0T.0U.0V.0W.0X.0Y.0Z.00.01.02.03.04.05.06.07.08.09.1..1#.1a.1b.1c.1d.1e.1f.1f.1g.1h.1i.1j.1k.1l.1m.1n.1o.1p.1q.1r.1s.1t.1u.1v.1w.1x.1y.1z.1A.1B.1C.1D.1E.1F.1G.1H.1I.1J.1K.1L.1M.1N.1O.1P.1Q.1R.1S.1T.1U.1V.1W.1X.0k.YK.0k.1X.1Y.1X.0k.0n.YL.1Z.YL.0n.10.0n.0l.11.12.13.14.0q.15.YS.YS.0s.YT.YT.0s.0t.16.17.18",
+".19.2..2#.2a.2b.2c.2d.2e.2f.2g.2h.2i.2j.2k.2l.2m.2n.2o.2p.2q.2r.2s.2t.2u.2v.2w.2x.2y.2z.2A.2B.2C.2D.2E.2F.2G.2H.2I.2J.2K.2L.2M.2N.2O.2P.2Q.2R.2S.2T.2U.2V.2W.2X.2Y.2Z.20.21.22.23.24.25.26.27.28.U0.29.3..3#.3a.3b.3c.3d.3e.3f.3g.3h.3i.3j.3k.3l.3m.3n.3o.3p.3q.3r.3s.3t.3u.3v.3w.3x.3y.3z.3A.3B.10.1X.0l.1X.3C.3D.3C.1X.3E.0n.3F.3G.3H.3I.3J.3E.3K.3L.11.13.3M.0p.YS.YR.3N.0t.YU.YU.3N.17.3O.3P",
+".3Q.3R.3S.3T.3U.3V.3W.3X.i2.3Y.3Z.30.31.32.33.34.35.36.37.38.39.4..4#.4a.4b.4c.4d.4e.4f.4g.4h.4i.4j.4k.FO.4l.A9.4m.4n.4o.4p.4q.4r.4s.4t.4u.4v.4w.4x.4y.4z.4A.4B.4z.4C.4D.4E.4F.4G.4H.4I.4J.4K.4L.4M.4N.4O.4P.4Q.4R.4S.4T.4U.4V.4W.4X.4Y.4Z.40.41.42.43.44.45.46.47.48.49.5..5#.5a.5b.5c.YM.5d.5e.5f.3C.1X.3C.5f.5f.10.3F.5g.3I.5h.3H.5i.5j.3J.3E.3K.3K.3L.11.11.5k.13.13.16.16.16.5l.17.18.5m.3O",
+".5n.5o.5p.5q.5r.5s.5t.5u.5v.5w.5x.5y.5z.5A.5B.5C.5D.5E.5F.5G.5H.5I.5J.5K.5L.5MQtI.5N.5O.5P.5Q.5R.5S.5T.5U.5V.5W.5X.5Y.5Z.50.51.52.53.54.55.56.57.58.59.6..6..6..6#.6a.6b.6c.6d.6e.6f.6g.6h.6i.6j.6k.6l.6m.6n.6o.6p.6q.6r.6s.6t.6u.6v.6w.6x.6y.6z.6A.6B.6C.6D.6E.6F.6G.6H.6I.6J.6K.6L.6M.6N.6O.6P.6Q.10.3C.3C.5f.6Q.5f.3C.6R.6S.5j.5i.5j.5j.5h.0n.3L.3L.3K.3K.3K.6T.6U.6U.16.17.18.3O.3O.18.17.6V",
+".6W.6X.6Y.6Z.60.61.62.63.64.65.66.67.68.69.7..7#.7a.7b.7c.7d.7e.7f.7g.7h.7i.7j.7k.zr.7l.7m.7n.7o.7p.7q.7r.7s.7t.7u.7v.7w.7x.7y.7z.7A.7B.7C.7D.7E.7F.7G.7H.7I.7J.7K.7L.7M.7N.7O.7P.7Q.7R.7S.7T.7U.7V.7W.7X.7Y.7Z.70.71.72.73.74.75.76.77.78.79.8..8#.8a.8b.8c.8d.8e.8f.8g.8h.8i.8j.8k.8l.8m.8n.8o.8p.8p.8p.8p.8p.8p.8p.8p.8q.8q.8r.8s.8s.8r.8q.8t.8u.8u.8u.8v.8w.8x.8y.8y.8z.8A.8B.8C.8D.8E.8F.8G",
+".8H.8I.8J.8K.8L.8M.8N.8O.8P.8Q.8R.8S.8T.8U.8V.8W.8X.8Y.T8.8Z.80.81.82.83.84.85.86.87.88.89.9..9#.9a.9b.9c.9d.9e.9f.9g.9h.9i.9j.9k.9l.9m.9n.9o.9p.9q.9r.9s.9t.9u.9v.9w.9x.9y.9z.9A.9B.9C.9D.9E.9F.9G.9H.9I.9J.9K.9L.9M.9N.9O.9P.9Q.9R.9S.9T.9U.9V.9W.9X.9Y.9Z.90.91.92.93.94.95.96.97.98.99#..#.#.8t.8t.8t.8t.8t.8t.8t.8t#.a.8r#.b#.c#.c.8r.8q#.d.8x#.e#.e.8w.8w.8w.8w.8w.8E#.f#.f#.e.8B.8A.8z#.g",
+"#.h#.i#.j#.k#.l#.m#.n#.o#.p#.q#.r#.s#.t#.u#.v#.w.SK.7b#.x#.y#.z#.A.82#.B#.C#.D.86#.E#.F.89#.G#.H#.I#.J#.K#.L#.M#.N#.O#.P#.Q#.R#.S#.T.7r#.U#.V#.W#.X#.Y#.Z#.0#.1#.2#.3#.4#.5#.6#.7#.8#.9##.#####a##b##c##d##e##f##g##h##i##j##k##l##m##n##o##p##q##r##s##t##u##v##w##x##y##z##A##B##C##D##E##F##G.8r.8r.8r.8r.8r.8r.8r.8r#.c#.c##H##H##H#.c.8r.8q##I##J##J.8y.8y.8w.8w.8v.8D#.e.8C.8B.8z#.g##K##K",
+"##L##M##N##O##P##Q##R##S##T##U##V##W##X##Y##Z##0##1##2.NW##3##4##5##6##7##8##9#a.#a##aa#ab#ac#ad#ae#af#ag#ah#ai#aj#ak#al#am#an#ao#ap#aq#ar#as#at#au#av#aw#ax#ay#az#aA#aB#aC#aD#aE#aF#aG#aH#aI#aJ#aK#aL#aM#aN#aO#aP#aQ#aR#aS#aT#aU#aV#aW#aX#aY#aZ#a0#a1#a2#a3#a4#a5#a6#a7#a8#a9#b.#b##ba#bb#bc#bd##H##H##H##H##H##H##H##H#be#bf#bf#bg#bf##H#.c.8r#bh#bh#bi##J##J#bj.8y.8y#bk#bk#bl##K#.g.8z.8A.8B",
+"#bm#bn#bo#bp#bq#br#bs#bt#bu#bv#bw#bx#by#bz#bA#bB.Ud#bC#bD#bE#bF#bG#bH#bI#bJ#bK#bL#bM#bN#bO#bP#bQ#bR#bS#bT#bU#bV#bW#bX#bY#bZ#b0#b1#b2#b3#b4#b5#b6#b7#b8#b9#c.#c##ca#cb#cc#cd#ce#cf#cg#ch#ci#cj#ck#cl#cm#cn#co#cp#cq#cr#cs#ct#cu#cv#cw#cx#cy#cz#cA#cB#cC#cD#cE#cF#cG#cH#cI#cJ#cK#cL#cM#cN#cO#cP#cQ#cR#cR#cR#cR#cR#cR#cR#cR#cR#cS#cT#cT#cR#bf##H#.c##J##I#bh#bh#bh#cU#cV#cV#cW#cW#cX#bk#cY##K##I#.g",
+"#cZ#c0#c1.dg#c2#c3#c4#c5#c6#c7#c8#c9#d.#d##da#db.7a#dc#dd#de#df#dg#dh#di#dj#dk#ab#dl#dm#a.#dn#.H#do#dp#dq#dr#ds#dt#du#dv#dw#dx#dy#dz#dA#dB#dC#dD#dE#dF#dG#dH#dI#dJ#dK#dL#dM#dN#dO#dP#dQ#dR#dS#dT#dU#dV#dW#dX#dY#dZ#d0#d1#d2#d3#d4#d5#d6#d7#d8#d9#e.#e##ea#eb#ec#ed#ee#ef#eg#eh#ei#ej#ek#el#em#en#cT#cT#cT#cT#cT#cT#cT#cT#eo#eo#ep#eo#eq#cR#bf##H#bh#bh#bh#cV#cX#er#er#es#bl#cY#bk#cX#cW#et#eu#ev",
+"#ew#ex#ey#ez#eA#eB#eC#eD#eE#eF#eG#eH#eI#eJ#eK#eL#eM#eN.oG#eO#eP#eQ#eR#eS#eT#eU.yY#eV#eW#eX#eY#eZ#e0#e1#e2#e3#e4#e5#e6#e7#aY#e8#e9#f.#f##fa#fb#fc#fd#fe#ff#fg#fh#fi#fj#fk#fl#fm#fn#fo#fp#fq#fr.To#fs#ft#fu#fv#fw#fx#fy#fz#fA#fB#fC#fD#fE#fF#fG#fH#fI#fJ#fK#fL#fM#fN#fO#fP#fQ#fR#fS#fT#fU#fV#fW#fX#eo#eo#eo#eo#eo#eo#eo#eo#fY#fZ#f0#fY#eo#cT#bg#be#er#er#er#er#er#er#er#er#f1#f1#cW#f2#eu#ev#f3#f3",
+"#f4#f5#f6#f7#f8#f9#g.#g##ga#gb#gc#gd#ge#gf.gv#gg#gh.c4#gi#gj#gk#gl#gm#gn#go#gp#gq#gr#dl#ab#gs#gt#gu#gv#gw#gx#gy#gz#gA#gB#gC#gD#gE#gF#gG#gH#gI#gJ#gK#gL#gM#gN#gO#gP#gQ#gR#gS#gT#gU#gV#gW#gX#gY#gZ#g0#g1#g2#g3#g4#g5#g6#g7#g8#g9#h.#h##ha#hb#hc#hd#he#hf#hg#hh#hi#hj#hk#hl#hm#hn#ho#hp#hq#hr#hs#ht#eo#eo#eo#eo#eo#eo#eo#eo#hu#hu#hu#hu#fY#cT#cR#bf#hv#hw#hw#es#er#er#cV#cV#hx#hx#f3#ev#eu#f2#cW#cX",
+"#hy#hz#hA#hB#hC#hD#hE#hF#hG#hH#hI#hJ#hK#hL.XE.DF.p1#hM#hN#hO#hP#hQ#hR.uj#hS#hT#hU#hV#hW#hX#hY#hZ#h0#h1#h2#h3#h4#h5#h6#h7#h8#h9#i.#i##ia#ib#ic#id#ie#if#ig#ih#ii#ij#ik#il#im#in#io#ip#iq#ir#is#it#iu#iv#iw#ix#iy#iz#iA#iB#iC#iD#iE#iF#iG#iH#iI#iJ#iK#iL#iM#iN#iO#iP#iQ#iR#iS#iT#iU#iV#iW#iX#iY#iZ#i0#i1#i2#i2#i3#i0#i3#i2#i3#i2#i3#i4#i4#i2#i5#i2#i6#i7#i8#i9#j.#j##ja#jb#jc#jd#je#je#jf#es#jg#jg",
+"#hy#hz#hA#jh#ji#jj#jk#jl#jm#jn#jo#jp#jq#jr#js.V9#jt#ju.ux#jv#hP#hQ#hR.uj#jw.IF#jx#jy#jz#jA#jB#jC#jD#jE#jF#jG#jH#jI#jJ#jK#jL#jM#jN#jO#jP#jQ#jR#jS#jT#jU#jV#jW#jX#jY#jZ#j0#j1#j2#j3#j4#j5#j6#j7#j8#j9#k.#k##ka#kb#kc#kd#iA#ke#g5#kf#kg#kh#ki#kj#kk#kl#km#kn#ko#kp#kq#kr#ks#kt#ku#kv#kw#kx#ky#kz#kA#i0#i3#i2#i2#kB#i0#i3#i2#i4#i3#i2#i0#i3#kC#i2#i3#i6#kD#i8#i9#kE#j##kF#ja#je#je#je#jf#jg#jg#jg#jg",
+"#kG.MG#kH#kI#kJ#hG#kK#kL#kM#kN#kO#kP#kQ#kR#kS#kT#kU#kV#kW#kX#hP#kY#hR.uj#kZ#k0.Lk#k1#k2#k3#k4#k5#k6#k7#k8#k9#l.#l##la#lb#lc#ld#le#lf#lg#lh#li#lj#lk#ll#lm#ln#j2#lo#jZ#lp#lq#lr#ls#lt#lu#lv#lw#lx#ly#lz#lA#lB#lC#lD#lE#lF#lG#lH#lI#lJ#lK#lL#lM#lN#lO#lP#lQ#lR#lS#lT#lU#lV#lW#lX#lY#lZ#l0#l1#l2#l3#i0#i3#i2#i3#i0#i0#l4#i2#l5#i0#i2#i3#i2#i5#i1#i4#i6#kD#i7#i8#kE#kE#j.#j##jf#jf#jg#jg#jg#l6#l7#l7",
+"#l8.MG#l9#m.#m##ma#mb#mc#hy#kN#md#me#mf#m.#mg#mh#mi#mj#mk#ml#hP#mm#mn.uj#mo#mp#mq#mr#ms#mt#mu#mv#mw#mx#my#mz#mA#mB#mC#mD#mE#mF#mG#mH#mI#mJ#mK#mL#mM#mN#mO#mP#mQ#mR#mS#mT#mU#mV#mW#mX#mY#mZ#m0#m1#m2#m3#m4#m5#m6#m7#m8#m9#n.#n##na#nb#nc#nd#jV#ne#nf#ng#nh#ni#nj#nk#nl#nm#nn#no#np#nq#nr#ns#nt#nu#i4#i0#i3#i3#i0#i4#i0#i3#l5#i0#i3#i0#i0#i2#i3#i4#i6#i6#i7#i8#i8#i9#kE#kE#jg#jg#l6#l7#l7#l7#nv#nv",
+"#nw#nx#ny#hL#nz#nA#nB#nC#nD#nE.Uj#nF#jh#nF#nG#nH#nI#nJ#nK#nL#hP#nM#nN.uj#nO#nP#nQ#nR#nS#nT#nU#nV#nW#nX#nY#nZ#n0#n1#n2#n3#n4#n5#n6#n7#n8#n9#o.#o##oa#ob#oc#od#oe#of#og#oh#oi#oj#ok#ol#om#on#oo#op#oq#or#os#ot#ou#ov#ow#ox#oy#oz#oA#oB#oC#oD#oE#oF#oG#oH#oI#oJ#oK#oL#oM#oN#oO#oP#oQ#oR#oS#oT#oU#oV#i4#i0#i3#i0#i4#i4#i4#kB#i4#i0#i0#l5#l5#i3#oW#i0#i6#i6#i6#kD#i7#i7#i8#i8#l7#l7#l7#nv#iY#iY#iY#oX",
+"#oY#jo#ny#oZ#o0#o1#o2#o3#o4#nE#jo#nF#o5#jp#o6#o7#o8.G0#o9#p.#hP#p##nN.uj#pa#pb#pc#pd#pe#pf#pg#ph#pi#pj#pk#pl#pm#pn#po#pp#pq#pr#ps#pt#pu#pv#pw#px#py#pz#pA#pB#pC#pD#pE#pF#pG#pH#pI#pJ#pK#pL.WN#pM#pN#pO#pP#pQ#pR#pS#pT#pU#pV#pW#pX#pY#pZ#p0#p1#p2#p3#p4#p5#p6#p7#p8#p9#q.#q##qa#qb#qc#qd#qe#qf#qg#l5#i4#i0#i0#i4#l5#i4#i0#i4#i0#i4#qh#qh#i0#i3#kB#i6#i6#i6#i6#i6#i6#i6#i6#iY#iY#iY#iY#qi#qj#qj#qj",
+"#qk#jo#ny#ql#qm#qn#qo#qp#qq#hH#kO#kI#kQ#hJ#qr#qs#qt#qu#qv#qw#hP#qx#qy#qz#qA#qB#qC#qD.5J#qE#qF#qG#qH#qI#qJ#qK#qL#qM#qN#qO#qP#qQ#qR#qS#qT#qU#qV#qW#qX#qY#qZ#q0#q1#q2#q3#q4#q5#q6#q7#q8#q9#r.#r##ra#rb#rc#rd#re#rf#rg#rh#ri#rj#rk#rl#rm#rn#ro#rp#rq#rr#rs#rt#ru#rv#rw#rx#ry#rz#rA#rB#rC#rD#rE#rF#rG#l5#i4#i0#i4#l5#l5#i4#i0#rH#i4#i4#qh#l5#i0#i0#i4#i6#i6#rI#rI#rI#rJ#rK#rK#oX#oX#qj#qj#qj#rL#rM#rM",
+"#qk#jo#ny#ql#rN#rO#rP#rQ#rR#jn#hI.lQ#rS#kI.MS#rT#rU#rV#qv#rW#hP#rX#rY#qz#rZ#r0#r1#r2#r3#r4#r5#r6#pi#r7#r8#r9#s.#s##sa#sb#sc#sd#se#sf#sg#sh#si#sj#sk#sl#sm#sn#so#sp#sq#sr#ss#st#su#sv#sw#sx#sy#sz#sA#sB#sC#sD#sE#sF#sG#sH#sI#sJ#sK#sL#sM#sN#sO#sP#sQ#sR#sS#sT#sU#sV#sW#sX#sY#sZ#s0#s1#s2#s3#s4#s5#l5#i4#i0#i4#l5#rH#l5#i4#s6#l5#i0#i4#i4#i0#i4#qh#i6#i6#rI#rJ#rK#rK#rK#rK#qj#qj#qj#qj#rL#rM#rM#rM",
+"#s7#s8#s9#t.#t##ta#tb#tc#td.qa#te#tf#tg#th#ti#tj#tk#tl#tm#tn#to#tp#tq#tr#ts#tt#tu#tv#tw#tx#ty#tz#tA#tB#tC#tD#tE#tF#tG#tH#tI#tJ#tK#tL#tM#tN#tO#tP#tQ#tR#tS#tT#tU#tV#tW#tX#tY#tZ#t0#t1#t2#t3#t4#t5#t6#t7#t8#t9#u.#u##ua#ub#uc#ud#ue#uf#ug#uh#ui#uj#uk#ul#um#tN#un#uo#up#uq#ur#us#ut#uu#uv#uw#ux#uy#uz#uA#uB#uC#uz#uD#oU#uC#uB#uA#uz#uE#nr#nr#nr#uE#uF#uG#uH#uI#uJ#uK#uL#uH#uM#uN#uO#uP#uQ#uR#uS#uT",
+"#uU.8W#uV#uW#uX#uY#uZ.HF#u0#u1#u2#u3#u4#u5#u6#u7#u8#u9#v.#v##va#vb#vc#vd#ve#vf#vg#vh#vi#vj#vk#vl#vm#vn#vo#vp#vq#vr#vs#vt#vu#vv#vw#vx#vy#vz#vA#vB#vC#vD#vE#vF#vG#vH#vI#vJ#vK#vL#vM#vN#vO#vP#vQ#vR#vS#vT#vU#vV#vW#vX#vY#vZ#v0#v1#v2#v3#v4#uh#v5#v6#v7#v8#v9#w.#w##wa#wb#wc#wd#we#wf#wg#wh#wi#wj#wk#uz#uA#uC#uA#uz#wl#oU#uC#uC#oU#wl#nr#wm#wm#wm#nr#uF#uG#uH#uI#uJ#uK#uL#uH#uM#uM#uN#uP#wn#wo#uR#uS",
+"#wp#wq#wr#ws#wt#wu#wv#ww#wx#wy#wz#wA#wB#wC#wD#wE#wF#wG#wH#wI#wJ#wK#wL#wM#wN#wO#wP#wQ#wR#wS#wT#wU#wV#wW#wX#wY#wZ#w0#w1#w2#w3#w4#w5#w6#w7#w8#w9#x.#x##xa#xb#xc#xd#xe#xf#xg#xh#xi#xj#xk#xl#xm#xn#xo#xp#xq#xr#xs#xt#xu#xv#xw#xx#xy#xz#xA#xB#xC#v5#xD#xE#xF#xG#xH#xI#xJ#xK#xL#xM#xN#xO#xP#xQ#xR#xS#xT#wl#oU#uC#uA#uz#wl#oU#uC#oU#wl#uE#wm#xU#xU#wm#nr#uF#uG#uH#uI#uJ#uK#uL#uH#xV#xW#uM#uO#uP#uQ#wo#uR",
+"#xX#xY#xZ#x0#x1#x2#x3#x4#x5#x6.zo#x7#x8.Zd#x9#y.#y##ya#yb#yc#yd.zs#ye#yf#yg#yh#yi#yj#yk#yl#ym#yn#yo#yp#yq#tD#yr#ys#yt#yu#yv#yw#yx#yy#yz#yA#yB#yC#yD#yE#yF#yG#yH#yI#yJ#yK#yL#yM#yN#yO#xl#yP#yQ#yR#yS#yT#yU#yV#yW#yX#yY#yZ#y0#y1#y2#y3#y4#y5#y6#y7#y8#y9#z.#z##za#zb#zc#zd#ze#zf#uE#zg#oU#zh#zh#zi#wl#oU#uA#uA#wl#zj#uz#uA#uD#zj#nr#xU#zk#xU#wm#nr#uF#uG#uH#uI#uJ#uK#uL#uH#zl#zl#xV#uM#uO#uP#wn#uQ",
+"#zm#zn#zo#zp#zq#zr#zs#zt#zu#zv#zw#zx#zy#zz#zA#zB#zC#zD#zE#zF#zG#zH#zI#zJ#zK#zL#zM#zN#zO#zP#zQ#zR#zS#zT#zU#zV#zW#zX#zY#zZ#z0#z1#z2#z3#z4#z5#z6#z7#z8#xa#z9#A.#A##Aa#yJ#Ab#Ac#Ad#Ae#Af#Ag#Ah#Ai#Aj#Ak#Al#Am#An#Ao#Ap#Aq#Ar#As#At#Au#Av#Aw#fy#Ax#xD#Ay#Az#AA#AB#AC#AD#AE#AF#AG#AH#AI#AJ#AK#AL#AM#AN#zj#uz#uA#oU#wl#zj#wl#uA#wl#zj#nr#xU#xU#wm#nr#uE#uF#uG#uH#uI#uJ#uK#uL#uH#AO#AP#zl#xV#uM#uO#uP#uP",
+"#AQ#AR#AS#AT#AU#AV#AW.7n#AX#AY#AZ#A0#A1#A2#u0#A3#A4#A5#A6#zq#A7#A8#A9#B.#B##Ba#Bb#Bc#Bd#Be#Bf#Bg#Bh#zT#Bi#Bj#Bk#Bl#Bm#Bn#Bo#Bp#Bq#Br#Bs#Bt#Bu#Bv#Bw#Bx#By#Bz#BA#BB#BC#BD#BE#BF#BG#BH#BI#BJ#BK#BL#BM#BN#BO#BP#BQ#BR#BS#BT#BU#BV#BW#BX#BY#BZ#B0#B1#B2#B3#B4#B5#B6#B7#B8#B9#C.#C##Ca#Cb#Cc#Cd#Ce#Cf#zj#uz#oU#oU#zj#uE#wl#oU#uz#wl#uE#nr#nr#uE#wl#uz#uF#uG#uH#uI#uJ#uK#uL#uH#Cg#Cg#AO#zl#xV#uM#uN#uO",
+"#Ch#Ci#Cj#Ck#Cl#Cm#Cn#Co#Cp#Cq#Cr#Cs#Ct#Cu#Cv#Cw#Cx#Cy#Cz#CA#CB#CC#CD#CE#CF#CG#CH#CI#CJ#CK#CL#CM#CN#CO#CP#CQ#CR#CS#CT#CU#CV#CW#CX#CY#CZ#C0#C1#C2#Bx#C3#C4#C5#C6#C7#C8#C9#D.#D##Da#Db#Dc#Dd#De#Df#Dg#Dh#Di#Dj#Dk#Dl#Dm#Dn#Do#Dp#Dq#Dr#Ds#Dt#Du#Dv#Dw#Dx#Dy#Dz#DA#DB#DC#DD#DE#DF#DG#DH#DI#DJ#DK#DL#uE#wl#oU#uz#zj#uE#wl#oU#oU#uz#wl#zj#zj#wl#oU#uA#uF#uG#uH#uI#uJ#uK#uL#uH#DM#DN#Cg#AP#zl#xW#uM#uN",
+"#DO#DP#DQ#DR#DS#DT#DU#DV#DW#DX#DY#DZ#D0#D1#D2#D3#D4#D5#D6#D7#D8#D9#E.#E##Ea#Eb#Ec#Ed#Ee#Ef#Eg#Eh#wV#Ei#Ej#Ek#El#Em#En#Eo#Ep#Eq#Er#Es#Et#Eu#Ev#Ew#Ex#Ey#Ez#EA#EB#C7#EC#ED#EE#EF#EG#EH#EI#EJ#EK#EL#EM#EN#EO#EP#EQ#ER#ES#ET#EU#EV#EW#EX#EY#EZ#E0#E1#E2#E3#E4#E5#E6#E7#E8#E9#F.#F##kD#Fa#Fb#Fc#Fd#Fe#uE#wl#oU#uz#zj#uE#zj#uz#uA#oU#uz#wl#uD#oU#uC#uB#uF#uG#uH#uI#uJ#uK#uL#uH#DM#DM#Cg#AO#zl#xV#uM#uM",
+"#Ff#Fg#Fh#Fi#Fj#Fk.9.#Fl#Fm#Fn#Fo#Fp#Fq#Fr#Fs#Ft#Fu#Fv#Fw#Fx#Fy#Fz#FA#FB#FC#FD#FE#FF#FG#FH#FI#FJ#FK#FL#FM#FN#FO#FP#FQ#FR#FS#FT#FU#FV#FW#FX#FY#FZ#F0#F1#F2#F3#F4#F5#F6#F7#F8#F9#G.#G##Ga#Gb#Gc#Gd#Ge#Gf#Gg#Gh#Gi#Gj#Gk#Gl#Gm#Gn#Go#Gp#Gq#Gr#Gs#Gt#Gu#Gv#Gw#Gx#Gy#Gz#GA#GB#GC#qj#uQ#GD#GE#uv#GF#GG#GH#GH#GH#wh#wh#qe#qe#qe#GI#GJ#GK#GL#GL#GK#GM#GN#GO#GO#GP#GQ#GR#GS#GT#GU#GV#GW#GX#GX#GY#Cc#GP#Fb",
+"#GZ#G0#G1#G2#G3#G4#G5#G6#G7#hY#G8#G9#H.#H##Ha#Hb.2r#Hc#Hd#He#Hf#Hg#Hh#Hi#Hj#Hk#ty#Hl#Hm#Hn#Ho#Hp#Hq#Hr#Hs#Ht#Hu#Hv#Hw#Hx#Hy#Hz#HA#HB#HC#HD#HE#HF#HG#HH#HI#HJ#HK#HL#HM#HN#HO#HP#HQ#HR#HS#HT#HU#HV#HW#HX#HY#HZ#H0#H1#H2#H3#H4#H5#H6#H7#H8#H9#I.#I##Ia#Ib#Ic#Id#Ie#If#Ig#Ih#Ii#rM#uP#Ij#Ik#uv#Il#Im#In#GH#GH#GH#wh#qe#qe#qe#In#GH#qe#GL#Io#Io#GL#qe#Ip#GO#Iq#AK#GR#GS#AI#GU#Ca#Cc#DI#DI#GX#uM#Ip#Ir",
+"#Is#It#Iu#Iv#Iw#Ix#Iy#Iz#IA#IB#IC#ID#IE#IF#IG#IH#II#IJ#IK#IL#IM#IN#IO#IP#IQ#IR#IS#IT#IU#IV#IW#IX#IY#IZ#I0#I1#I2#I3#I4#I5#I6#I7#I8#I9#J.#J##Ja#Jb#Jc#Jd#Je#Jf#Jg#Jh#Ji#Jj#Jk#Jl#Jm#Jn#Jo#Jp#Jq#Jr#Js#Jt#Ju#Jv#Jw#Jx#Jy#Jz#JA#JB#JC#JD#JE#JF#JG#JH#JI#JJ#JK#JL#JM#JN#JO#JP#JQ#JR#Ip#Cf#JS#wh#JT#JU#GJ#GJ#In#GH#GH#GH#wh#wh#GL#qe#wh#GL#GN#GN#GL#In#JV#GO#Iq#AK#GR#GS#GS#GT#GY#GX#Ip#Ip#DI#DI#Fb#JW",
+"#JX#JY#JZ#J0#J1#J1#J2#J3#J4#J5#J6#J7#J8#J9#K.#K##Ka#rY#Kb#Kc#Kd#Ke#Kf#Kg#Kh#Ki#Kj#Kk#Kl#Km#Kn#Ko#Kp#Kq#Kr#Ks#Kt#Ku#Kv#Kw#Kx#Ky#Kz#KA#KB#KC#KD#KE#KF#KG#KH#KI#KJ#KK#KL#KM#KN#KO#KP#KQ#KR#KS#KT#KU#KV#KW#KX#KY#KZ#K0#K1#K2#K3#K4#K5#K6#K7#K8#K9#L.#L##La#Lb#Lc#Ld#Le#Lf#Lg#Lh#Lh#Li#Lj#Lk#uC#Ll#Ll#GJ#GJ#GJ#GJ#In#GH#GH#GH#qe#qe#qe#GL#ut#ut#GL#qe#Lm#JV#GO#AK#GR#nt#GS#AI#Ca#Cc#DI#DI#GX#GX#Ip#Ir",
+"#Ln#Lo#Lp#Lq#Lr##S#Ls#Lt#Lu#Lv#J6#Fp#Lw#Lx#Ly#Lz#LA#LB#LC#LD#LE#LF#LG#LH#LI#LJ#LK#LL#LM#LN#LO#LP#LQ#LR#LS#LT#LU#LV#LW#LX#LY#LZ#L0#L1#L2#L3#L4#L5#L6#L7#L8#L9#M.#M##Ma#Mb#Mc#Md#Me#Mf#Mg#Mh#Mi#Mj#Mk#Ml#Mm#Mn#Mo#Mp#Mq#Mr#Ms#Mt#Mu#Mv#Mw#Mx#My#Mz#MA#MB#MC#MD#ME#MF#MG#MH#MI#MJ#MK#ML#MM#MN#MO#MP#MQ#MQ#MR#GJ#GJ#GJ#In#In#qf#GJ#GK#GM#GL#GL#GM#Io#Lm#Lm#GO#GP#GQ#GR#GS#GS#MS#Ca#GY#Cc#GY#GY#GX#DI",
+"#MT#MU#MV#MW#MX#MY#.G#MZ#M0#M1#IC#ID#M2#M3#rO#M4#M5#M6#M7#M8#M9#N.#N##Na#Nb#Nc#Nd#Ne#Nf#Ng#Nh#Ni#Nj#Nk#Nl#Nm#Nn#No#Np#Nq#Nr#Ns#Nt#Nu#Nv#Nw#Nx#Ny#Nz#NA#NB#NC#ND#NE#NF#NG#NH#NI#NJ#NK#NL#NM#NN#NO#NP#NQ#NR#NS#NT#NU#NV#NW#NX#NY#NZ#N0#N1#N2#N3#N4#N5#N6#N7#N8#N9#O.#O##Oa#Ob#Oc#Od#Oe#Of#Og#Oh#Oi#qf#MQ#MQ#MQ#MR#GJ#GJ#GJ#Oj#MQ#qe#GK#qe#wh#GL#ut#Ok#Lm#Ip#GO#AK#GR#nt#GS#Ol#GT#GW#GY#Ca#Ca#zl#GP",
+"#Om#On#Oo#Op#Oq#Or.I.#Os#Ot#Ou#Ov#Ow.0H#Ox#Oy#Oz#OA#OB#OC#OD#OE#OF#OG#OH#OI#OJ#OK#OL#OM#ON#OO#OP#OQ#OR#OS#OT#OU#OV#OW#OX#OY#OZ#O0#O1#O2#O3#O4#O5#O6#O7#O8#O9#P.#P##Pa#Pb#Pc#Pd#Pe#Pf#Pg#Ph#Pi#Pj#Pk#Pl#Pm#Pn#Po#Pp#Pq#Pr#Ps#Pt#Pu#Pv#Pw#Px#Py#Pz#PA#PB#PC#PD#PE#PF#PG#PH#PI#PJ#PK#PL#PM#PN#PO#PP#PQ#qf#qf#MQ#MQ#MR#MR#MR#GI#PQ#GJ#GH#GH#GH#GH#GH#PR#Lm#JV#GO#AK#GR#GR#GW#MS#Ca#GY#GY#GY#GY#GX#DI",
+"#A5#PS#PT#PU#PV#PW#PX#PY#PZ#P0#Ov#ID#J8#P1#P2#Hb#P3#P4#P5#P6#P7#P8#P9#Q.#Q##Qa#Qb#Qc#Qd#Qe#Qf#Qg#Qh#Qi#Qj#Qk#Ql#Qm#Qn#Qo#Qp#Qq#Qr#Qs#Qt#Qu#Qv#Qw#Qx#Qy#Qz#QA#QB#QC#QD#QE#QF#QG#QH#oE#QI#QJ#QK#QL#Pg#QM#QN#QO#QP#QQ#QR#QS#QT#QU#QV#QW#QX#QY#QZ#Q0#Q1#Q2#Q3#Q4#Q5#Q6#Q7#Q8#Q9#R.#R##Ra#Rb#Rc#Rd#Re#PQ#PQ#qf#qf#MQ#MQ#MQ#MR#MQ#qf#PQ#MR#GH#GH#MQ#GI#PR#Lm#Lm#GO#AK#Cc#GR#nt#Ca#GY#GX#GX#Cc#GX#DI#Fb",
+"#Rf#Rg#Rh#Ri#Rj#Rk#Rl#Rm#Rn#Ro#Rp#Rq#Rr#Rs#Rt#Ru#Rv#Rw#Rx#Ry#Rz#RA#RB#RC#RD#RE#RF#RG#RH#RI#RJ#RK#RL#RM#RN#RO#RP#RQ#RR#RS#RT#RU#RV#RW#RX#RY#RZ#R0#R1#R2#R3#R4#R5#R6#R7#R8#R9#S.#S##Sa#Sb#Sc#Sd#Se#Sf#Sg#nj#Sh#Si#Sj#Sk#Sl#Sm#Sn#So#Sp#Sq#Sr#Ss#St#Su#Sv#Sw#Sx#Sy#Sz#SA#SB#SC#SD#SE#SF#SG#SH#SI#SJ#SK#SK#SK#SK#SK#SK#SK#SK#In#GJ#qf#PQ#PQ#MQ#GJ#GH#SL#MN#JW#Lm#GO#GQ#GR#GS#GP#GP#GP#GP#GP#GP#GP#GP",
+"#Rf#Rg#Rh#Ri#Rj#SM#Rl#SN#SO#SP#SQ#SR#SS#ST#SU#SV#SW#SX#SY#SZ#S0#S1#S2#S3#S4#S5#S6#S7#S8#S9#T.#T##Ta#Tb#Tc#Td#Te#Tf#Tg#Th#Ti#Tj#Tk#Tl#Tm#Tn#To#Tp#Tq#Tr#Ts#Tt#Tu#Tv#Tw#Tx#Ty#Tz#TA#TB#TC#TD#TE#TF#TG#TH#TI#TJ#TK#TL#TM#TN#TO#TP#TQ#TR#TS#TT#TU#TV#TW#TX#TY#TZ#T0#T1#T2#T3#T4#Il#T5#T6#Oc#T7#T8#T9#s4#s4#s4#s4#s4#s4#s4#s4#MQ#MQ#qf#qf#qf#MQ#MR#GJ#SL#MN#U.#Lm#GO#AK#GR#nt#DI#DI#DI#DI#DI#DI#DI#DI",
+"#Rf#Rg#Rh#U##Ua#Ub#Rl#SN#Uc#Ud#Ue#pd#Uf#Ug#Uh#Ui#Uj#Uk#Ul#Um#Un#Uo#Up#Uq#Ur#Us#Ut#Uu#Uv#Uw#Ux#Uy#Uz#UA#UB#UC#UD#UE#UF#UG#UH#UI#UJ#UK#UL#UM#UN#UO#UP.21#UQ#UR#US#UT#UU#UV#UW#UX#UY#UZ#U0#U1#U2#U3#U4#U5#U6#U7#U8#U9#V.#V##Va#Vb#Vc#Vd#Ve#Vf#Vg#Vh#Vi#Vj#Vk#Vl#Vm#Vn#Vo#Vp#Vq#Vr#MJ#Vs#Vt#Vu#Vv#Vw#Vx#Vx#Vx#Vx#Vx#Vx#Vx#Vx#Vy#PQ#qf#MQ#MR#MQ#MQ#MQ#SL#Vz#U.#PR#JV#Iq#AK#Cc#DI#DI#DI#DI#DI#DI#DI#DI",
+"#VA#VB#VC#VD#VE#Ub#Rl#VF#VG#VH#VI#VJ#VK#VL#VM#VN#VO#VP#VQ#VR#VS#VT#VU#VV#VW#VX#VY#VZ#V0#V1#V2#V3#V4#V5#V6#V7#V8#V9#W.#W##Wa#Wb#Wc#Wd#We#Wf#Wg#Wh#Wi#Wj#Wk#Wl#Wm#Wn#Wo#Wp#Wq#Wr#Ws#Wt#Wu#Wv#Ww#Wx#Wy#Wz#aB#WA#WB#WC#WD#WE#WF#WG#WH#WI#WJ#WK#WL.N#.BK#WM#WN#WO#WP#WQ#WR#WS#WT#WU#WV#WW#WX#WY#WZ#W0#W1#W1#W1#W1#W1#W1#W1#W1#W2#W3#PQ#MR#GJ#MR#qf#PQ#SL#W4#MN#W5#Lm#GO#Iq#AK#Fb#Fb#Fb#Fb#Fb#Fb#Fb#Fb",
+"#VA#VB#VC#W6#W7#Ub#W8#VF#W9#X.#X##Xa#Xb#Xc#Xd#Xe#Xf#Xg#Xh#Xi#Xj#Xk#Xl#Xm#Xn#Xo#Xp#Xq#Xr#Xs#Xt#Xu#Xv#Xw#Xx#Xy#Xz#XA#XB#XC#XD#XE#XF#XG#XH#XI#XJ#XK#XL#XM#XN#XO#XP#XQ#XR#XS#XT#XU#XV#XW#XX#XY#XZ#X0#X1#X2#X3#X4#X5#X6#X7#X8#X9#Y.#Y##Ya#Yb#Yc#Yd#Ye#Yf#Yg#Yh#Yi#Yj#Yk#Yl#Ym#Yn#Yo#Yp#Yq#Yr#Ys#Yt#Yu#W1#W1#W1#W1#W1#W1#W1#W1#Yv#W2#GI#MQ#MR#MQ#qf#PQ#SL#SL#MN#U.#W5#Lm#JV#GO#Fb#Fb#Fb#Fb#Fb#Fb#Fb#Fb",
+"#Yw.lN#Yx#Yy#Yz#Ub#YA#YB#YC#YD#YE#YF#YG#YH#YI#YJ#YK#YL#YM#YN#YO#YP#S2#YQ#YR#YS#YT#YU#YV#YW#YX#YY#YZ#Y0#Y1#Y2#Y3#Y4#Y5#Y6#Y7#Y8#Y9#Z..Om.FT#Z##Za#Zb#Zc#Zd#Ze#Zf#Zg#Zh#Zi#Zj#Zk#Zl#Zm#Zn#Zo#Zp#Zq#Zr#Zs#Zt#Zu#Zv#Zw#Zx#Zy#Zz#ZA#K8#ZB#ZC#ZD#ZE#ZF#ZG#ZH#ZI#ZJ#ZK#ZL#ZM#ZN#ZO#ZP#ZQ#ZR#ZS#ZT#ZU#T4#ZV#ZV#ZV#ZV#ZV#ZV#ZV#ZV#Yv#ZW#Oj#GI#PQ#qf#qf#qf#SL#SL#W4#MN#JW#W5#PR#Lm#Ir#Ir#Ir#Ir#Ir#Ir#Ir#Ir",
+"#Yw#ZX#ZY#ZZ#Z0#Ub#Z1#YB#Z2#Z3#Z4#Z5#Z6#Z7#Z8#Z9#0.#0##0a#0b#0c#0d#0e#0f#0g#0h#0i#0j#0k#0l#0m#0n#0o#0p#0q#0r#0s#0t#0u#0v#0w#0x#0y#0z#0A#0B#0C#0D#0E#0F#0G#0H#0I#0J#0K#0L#0M#0N#0O#0P#0Q#0R#0S#0T#0U#0V#0W#0X#0Y#0Z#00#01#02#03#04#05.Ym#06#07.L8#08#09.XR#1..HC#1##1a#1b#1c#1d#1e#1f#1g#Yq#1h#1i#1j#1j#1j#1j#1j#1j#1j#1j#ZW#ZW#ZW#W2#W3#PQ#MQ#GJ#SL#SL#W4#MN#MN#JW#W5#W5#Ir#Ir#Ir#Ir#Ir#Ir#Ir#Ir",
+"#pc#ZX#ZY#1k.5J#1l#Z1#YB#1m#1n#1o#1p#1q#1r#1s#1t#1u#1v#1w#1x#1y#1z#1A#1B#1C#1D#1E#1F#1G#1H#1I#1J#1K#1L#1M#1N#1O#1P#1Q#1R#1S#1T#1U#1V#hY#1W#1X#1Y#1Z#10#11#12#13#14#15#16#17#18#19#2.#2##2a#2b#2c#2d#2e#2f#2g#2h#2i#2j#2k#2l#2m#2n#2o#2p#2q#2r#2s##9#2t#2u#2v#2w#2x#2y#2z#2A#2B#2C#2D#2E#2F#2G#2H#1j#1j#1j#1j#1j#1j#1j#1j#W2#ZW#Yv#Yv#W2#Vy#MQ#In#SL#SL#SL#Vz#MN#MN#U.#JW#JW#JW#JW#JW#JW#JW#JW#JW",
+"#2I#2J#2K#2L#2M#2N#2O.Jf#2P#2Q#2R#2S#2T#2U#2V#2W#2X#2Y#2Z#20#21#22#23#24#25#26#27#28#YM#29#3.#3##3a#3b#3c#3d#3e#3f#3g#3h#3i#Rm#3j#3k.B.#3l#3m#3n#3o#3p#3q#3r#3s#3t#3u#3v#3w#3x#3y#3z#3A#3B#3C#3D#XY#3E#3F#3G#3H#3I#3J#3K#3L#3M#3N#3O#3P#3Q#3R#ve#3S#3S#3S#3S#3S#3S#3S#3S#3T#3U#3V#3W#3X#3Y#3Z#30#31#32#33#34#35#36#37#38#39#4.#4##4a#4b#4c#4d#4e#4f#1j#4g#4h#2F#PN#4i#4i#4j#4k#4l#4m#4n#4o#4p#4q",
+"#4r#4s#4t#4u#4v#4w#4x#4y#4z#4A#4B#4C#4D#4E#4F#4G#4H#4I#4J#4K#4L#4M#4N#4O#4P#4Q#4R#4S#4T#4U#4V.6w#4W#4X#4Y#4Z#40#41.Hs#42#43.I4#44#45.B.#46#47#48#49#5.#5##5a#5b#5c#5d#5e#5f#5g#5h#5i#5j#5k#5l#5m#5n#5o#5p#5q#5r#5s#5t#5u#5v#5w#5x#5y#5z#5A#5B#5C#3S#3S#3S#3S#3S#3S#3S#3S#5D#5E#5F#5G#5H#5I#5J#5K#5L#5M#5N#5O#5P#5Q#5R#5S#5T#5U#5V#5W#5X#5Y#5Z#50#s4#W1#Yq#39#51#52#Rc#53#54#55#56#Lk#57#58#59#6.",
+"#6##6a#6b#6c#6d#6e#6f#6g#6h#6i#6j#6k#6l#6m#6n#6o#6p#6q#6r#6s#6t#6u#6v#6w#6x#6y#6z#6A#6B#6C#6D#6E#6F.7s.Np#41#6G#6H.F9.HK.O9.Mb#6I#6J#6K#6L#6M#6N#6O#6P#6Q#6R#6S#6T#6U#6V#6W#6X#6Y#6Z#60#61#62#63#64#65#66#67#68#69#7.#7##7a#7b#7c#7d#7e#7f#7g#7h#3S#3S#3S#3S#3S#3S#3S#3S#7i#7j#7k#7l#Rr#7m#7n#7o#7p#7q#7r#7s#7t#7u#7v#7w#5P#7x#7y#7z#7A#7B#7C#7D#7E#W1#7F#7G#7H#7I#53#7J#7K#54#In#Lk#57#7L#7M#7N",
+"#7O.yR#7P#7Q#7R#7S#7T#7U#7V#7W#7X#7Y#7Z#70#71#72#73#74#75#76#77#78#79#8.#8##8a#8b#8c#8d#8e#8f#8g.N.#8h#8i#8j#8k#8l#8m#8n#8o#8p#8q#8r#8s#8t#8u#8v#8w#8x#8y#8z#8A#8B#8C#8D#8E#8F#8G#8H#8I#8J#8K#8L#8M#8N#8O#8P#8Q#8R#8S#8T#8U#8V#8W#8X#8Y#8Z#80#81#3S#3S#3S#3S#3S#3S#3S#3S#82#83#84#85#86#87#88#89#9.#9##9a#9b#9c#9d#9e#9f#9g#9h#9i#9j#9k#9l#MK#9m#s4#1j#7F#9n#9n#52#53#7J#9o#9p#9q#4m#9r#7L#9s#7N",
+"#9t#9u#9v#9w#9x.LF#9y#9z#9A#9B#9C#9D#9E#9F#9G#9H#9I#9J#9K#9L#9M#9N#9O#9P#9Q#9R#9S#9T#9U.Np.Jg.Hv#9V#9W#9X#9Y#9Z#90#91#92#93#94#95#96.Ep#97#98#99a..a.#a.aa.ba.ca.da.ea.fa.ga.ha.ia.ja.ka.la.ma.na.oa.pa.qa.ra.sa.ta.ua.va.wa.xa.ya.za.Aa.Ba.Ca.Da.Ea.Ea.Ea.Ea.Ea.Ea.Ea.Ea.Fa.Ga.Ha.Ia.Ja.Ka.La.Ma.Na.Oa.Pa.Qa.Ra.Sa.Ta.Ua.Va.Wa.Xa.Ya.Za.0#ZWa.1a.2a.3#Yqa.4#2F#Oga.5#53a.6a.7#wh#AN#9r#MPa.8a.9",
+"a#.a##a#aa#ba#ca#da#ea#fa#ga#ha#ia#ja#ka#la#ma#na#oa#pa#qa#ra#sa#ta#ua#va#wa#xa#ya#za#Aa#Ba#Ca#Da#Ea#E#YAa#Fa#Ga#H.SV.SUa#Ia#Ja#Ka#La#Ma#Na#Oa#Pa#Qa#Ra#Sa#Ta#Ua#Va#Wa#Xa#Ya#Za#0a#1a#2a#3a#4a#5a#6a#7a#8a#9aa.aa#aaaaabaacaadaaeaafaagaahaaiaaja.Ea.Ea.Ea.Ea.Ea.Ea.Ea.EaakaalaamaanaaoaapaaqaaraasaataauaavaawaaxaayaazaaAaaBaaCaaDaaEaaFaaGaaHaaI#7F#Yq#4haaJaaKa.5aaL#55aaMaaN#AN#9r#MPa.8#9s",
+"aaOaaP#zwaaQaaRaaSaaTaaUaaVaaWaaXaaYaaZaa0aa1aa2aa3aa4aa5aa6.Npaa7aa8aa9ab.ab#.S.abaabbabcabdabeabfabgabhabiabjabk.FVablablabmabnaboabpabqabrabsabtabuabvabwabxabyabzabAabBabCabDabE#WBabFabGabHabIabJabKabLabMabNabOabPabQabRabSabTabUabVabWabXa.Ea.Ea.Ea.Ea.Ea.Ea.Ea.EabYabZab0ab1.Gh.XQ.0Xab2#VEab3ab4ab5ab6ab7ab8ab9ac.ac#acaacbaccacdaceacfa.2a.2#7F#39#Yo#Ogacg#7J#WX#55#wh#AN#9r#GDachaci",
+"acjackaclacmacnacoacpacqacracsactacuacvacwacxacyacz.O3acAacBacCacDacEacEacF.KW.KSacGacH.I2acIacJacKacLacMacNacOacPacPacQ.JnacRacSacTacUacVacWacXacYacZac0ac1ac2ac3ac4ac5ac6ac7ac8ac9ad.ad#adaadb#G#adcaddadeadfadgadhadiadjadkadladmadnadoadpadqa.Ea.Ea.Ea.Ea.Ea.Ea.Ea.EadradsadtaduadvadwadxadyadzadA#RjadBadCadDadEadFadGadHadI.ViadJadKadLadM#ZVa.3adN#7G#9nadOadP#woadQadR#In#AN#IjadSadTadU",
+"adVadWadXadYadZad0ad1ad2ad3ad4ad5ad6ad7ad8ad9ae.ae#ae#aeaaeb.HM.HMaecaecaedaedaedaedaedaedaedaedaeeaeeaeeaeeaeeaeeaeeaeeaefaegaehaeiaefaefaejaekaelaemaenaeoaepaeqaeraesaetaeuaevaewaexaeyaezaeAaeBaeCaeDaeEaeFaeGaeHaeIaeJaeKaeLaeMaeNaeOaecaea#3Sa.EaePaeQaeQaePa.E#3SaeRaeSaeT.0AaeUaeVaeWaeW.LE.LE.LE.LE.LE.LE.LE.LEaeXaeYaeZae0ae1ae2ae3ae4ae5ae6ae7ae8ae9af.#wlaf##Ll#MNafaafbafcafdafeaff",
+"afgafhafiafj.Hoafkaflafmafnafoafpafqafrafs.KIaft.Nwafuafuae#aeaaebaeb.HMaedaedaedaedaedaedaedaed.O8.O8.O8.O8.O8.O8.O8.O8afvafvafwafxafyafzafAafBafCafDafEafFafGafHafIafJafKafLafMafNafOafPafQafRafSafTafUafVafWafXafYafZaf0af1af2af3af4af5af6af6#3S#3Sa.EaeQaeQa.E#3S#3Saf7af8af9ag.ag#agaagbagc.LE.LE.LE.LE.LE.LE.LE.LEagdageagfaggaghagiagjagkaglagmagnagoagp#2Bagq#nsagragsafaafbafcagtaguagv",
+"agwagxagyagzagAagBagCagDagEagFagGagHagIagJagKagLagMagMagNagN.Nwafuae#ae#agOagOagOagOagOagOagOagO#44#44#44#44#44#44#44#44afzaegagPafxaefagPagQagRagSagTagUagVagWagXagYagZag0ag1ag2ag3ag4ag5ag6ag7ag8ag9ah.ah#ahaahbahcahd.moaheahfaeJahg.H2ahhaf6ahi#3Sahja.Ea.Eahj#3SahiahkaeTaf9.EWahlahmagbahn.pS.pS.pS.pS.pS.pS.pS.pSahoahpahqahrahsahtahuahvahwahxahyahzahA#7rahBahCahD#58#MHahEahFagtahGahH",
+"ahIahJahKahLahMahNahOahPahQahRacAahS.JfahT.F7.Mfaf5af5ahUagMagNagN.Nw.NwagOagOagOagOagOagOagOagO.H9.H9.H9.H9.H9.H9.H9.H9agPafx#3jafzaefahVahWahXahY.ptahZ.mEah0ah1ah2ah3ah4ah5ah6ah7ah8ah9ah8ai.ai#aiaaibaicaidaieaif.nRaigaihaiiaijaikaaiail.HMaimahi#3S#3S#3S#3Sahiaimainainaioaipag#ahmaiqairaisaisaisaisaisaisaisaisaitaiuaivaiwaixaiyaizaiAaiBaiCaiDaiEaiFaiGaiHaiIaiJaiK#LgaiLaiMaiN#uFaiO",
+".CtaiPaiQaiRaiSaiTaiUaiVaiWaiXaiY.xN.xNaiZai0ai1af5af5ahUagMagNagN.Nw.Nwai2ai2ai2ai2ai2ai2ai2ai2.H9.H9.H9.H9.H9.H9.H9.H9ai3afzai4ai5ai6ai5afxai7ai8ai9aj.aj#ajaajbajcajdajeajfajgajhajiajjajkajlajmajnajoajpajqajrajs.q0ajt.l#ahfajuajvaecaf6aeaabhabhahiajwajwahiabhabhahkaio.DhajxahmajyajyajzaisaisaisaisaisaisaisaisajAajAajBajCajDajEajFajGajHajIajJajKajLajMajNajOajPajQajRaiLajSajTajUajV",
+"ajWajXajYajZaj0.F9aj1aj2aj3aj4.Jgaj5.HVaj6aj7aj8agMagMagNagN.Nwafuae#ae#ai2ai2ai2ai2ai2ai2ai2ai2#44#44#44#44#44#44#44#44aeiaj9aegagPaj9ai6aehak.ak#akaakbakcagUakdakeakfakgakhakiakjakkaklakmaknakoakpakqakraksaktaku.ibakvaigaiiakwakxajvahUafu#8oakyabhahiahiabhaky#8oainakzakAakBaeUajyakCakDaisaisaisaisaisaisaisaisakEakFakGakHakIakJakKakLakMakNakOakPakQakRakSakTakUakVakWakXakY#iYakZak0",
+"ak1ak2.IMak3ak4ak5ak6ak7ak8ak9al.al#.HNalaalbabf.Nwafuafuae#aeaaebaeb.HMalcalcalcalcalcalcalcalc.O8.O8.O8.O8.O8.O8.O8.O8aefafzaldaleaefai4afwaj9alfalgalhalialjalkallalmalnaloalpalqalralsaltalualvalwalxalyalzalAalBaku.moaihalCagNalDafualEalFalG#8oabhabhabhabh#8oalGalHalIakAajxalJahmalKakCalLalLalLalLalLalLalLalLalMalNalOalPagcalQalRalS.CYalTalUa#E.DjalValWalXalYalZakWal0al1al2al3al4",
+"al5al6al7al8al9am.am#amaambamcamdameamfamgamh.Nzae#ae#aeaaeb.HM.HMaecaecalcalcalcalcalcalcalcalcaeeaeeaeeaeeaeeaeeaeeaeeamiaegafwai4aldaegafzamjamkamlammamnamoampamqakuamramsamtamuamvamwamxamyamzamAamB.l#.mSamCamDamE.jiamFamGamHamIamJamKamLalGamM#8oabhabh#8oamMalGamNamOalIamPamQamRajyamSamTamTamTamTamTamTamTamTamUamVamWamXamYamZam0am1am2am3am4am5am6am7am8am9an.an#anaal0anbal2ancand",
+"aneanfang.Nhanh.R7anianjaeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankank.KC.KC.O8.O8anlanmannannanoanoanoanoanoanoanoano#44#44anpanp.Mg.Mganqanq.rcanransantanuanv.jianuanwanxanyanzanAanBanCanDanEanFanGanH.mo.ji.l#anIanJanKanLanLanManNanOanPanQanRanR.HGanSanTanUanUanVanWanXanY.KfanZan0an1#YCan2an3an4an5#YCan6an7an8an8an9ao.ao#aoaaobaobaocaodaoeaofaoc.Klaogaohaoiaojaokaolaomaonaoo#ML",
+"aopaoqaor.Neaosaotaouaovaeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankank.KC.KC.KC.O8anlanmanmannanoanoanoanoanoanoanoano#44#44anpanp.Mg.Mgaowanqaoxaoy.rgaozaoA.l#.AF.qNaoBaoCaoDaoEaoFaoGaoHaoIaoJanF.JbaoKaoLaoM.l#aoNaoOaoPaoQaoRanOaoSaoTaoUaoVaoWaoXaoYaoZao0anZanZao1anYanYanYanYanYanYanYan4an3an9ao2an4an4ao3an9an7an3an8ao.ao#aobao4#SUaocaodaoeaofaf7.Klaogao5ao6ao7ao8ao9#9qap.ap#apa",
+"apbapcapdape.Ncapfapgaphaeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankankapiapi.KC.O8.O8anlanmanmapjapjapjapjapjapjapjapj#44#44apkanp.S..Mgaplanqapmapnapoaoz.l#appaiganuapqaprapsaptapuahNam4apvapwapxapyapzapAapB.jiapCapDapEapFapGanNanLapGaoUaoWaoWaoXaoYapHao0anZapIanWanWanWanWanWanWanWanW#YCan6apJan6#YC#YCan5apJapJan4an3an9apKao4apLapMapNapOapPaof#VF.KlaogapQapRapSapTapU#GHapV#rHapW",
+"apXapYapZap0ap1ap2ap3ap4aeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankankankankapi.KC.O8.O8anlanlapjapjapjapjapjapjapjapj#6I#44#44anpanp.Mg.Mg.Mgap5ap6ap7.moanuanvap8ap9aq.aq#aqaaqbaqcaqdaqeaqfaqgaqhaqiaqjaqkaqlaqmaqnaqoapFaqpaqqapGaqraqsaqpaqtaquaqvaqwaqxaqy.Kf.KfaqzaqAaqBaqCanWanY.KfaqDaqEaqF#YC#YCaqEaqEaqE#YCaqGapJan7an9aoa#SUapMaqHapNapOaqIao5aqJaqKaogapQaqLaqMaqNaqOaqPaqQaqR#Ol",
+"aqSaqTaqUaqV.uIaqW.FTaqXaeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankankaqYankankapi.KC.O8.O8.O8#6I#6I#6I#6I#6I#6I#6I#6IaqZaq0#44apkanp.S..Mg.Mgaq1aq2aq3.rfaq4.moaq5.BJaq6aftaq7aq8aq9ar.ar#araarbarcardakxarearfargarhariarjarkanPapGaoRanParlaquaquaqvarmarnaro.KfarparqaqzarrarsanWanY.KfapIan7an4an4an4an4an7an4an4aqGapJan7an9aoa#SUapMaqHartaruaqIarvaqJ.I2#VFapQarwarxaryarz#uwarAarBarC",
+"arDarEarFarGarHarIarJanhaeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankankaqYaqYankankapi.KC.KC.O8arfarfarfarfarfarfarfarfaqZaqZ#44#44anpanp.Mg.Mg.HKarKarLarM.l#arNarOarP.LOarQapiarRanlarS.LN.LOarTarUarVagNaecarWarXarYapFanOarZanOanMar0ar1anNar2ar3ar4ar5ar6ar7anYanYarsarsar8ar9anVanWanXanYan3an4an6an2an7an3an4apJapJan4an3an9apKao4apLapMaqJaruas.as#asa.I2#YAasbascasdaseasfasgashasiasj",
+"askaslasmasnasoaspasqarJaeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankank.LL.LLaqYankankapi.KC.KC.KP.KP.KP.KP.KP.KP.KP.KPaqZaqZaq0#44apkanp.S..Mgasrassastasuasva.C.HL.HLaswasxasyaszasAaswaswasBaqhasCasDaf5asEasFasGasHaqq.F6asIarjaqsarjaoQanPar3ar3ar4asJasKar7anY.HEarsar8ar9anVanWanYao1.Kfan7an6#YCan6an4ao3an4an5an7an3an8ao.ao#aobao4#SU.KlasLaohas##SN.I2#YAasMasNasOasPasQasRasSaiNasT",
+"asUasVasWasXasYasZas0.Hsaeaaeaaeaaeaaeaaeaaeaaeaankankankankankankankank.LL.LLaqYaqYankapi.KC.KC.KP.KP.KP.KP.KP.KP.KP.KPaqZaqZaqZ#44apkanpanp.S.as1adpaoxas2a.Cap5arPadpas3as4as5as6as7abjas6as8aqhas9at.at#aaiataatbatcanManPanMaqratdateanOanLatfar3ar4asJasKatganY.HEaqzatharsatianYanZan1atjapKan9an3an8ao#aoaao.an3an8an8an9ao.ao#aoaaobaob.KlasLatkas##SNatl#YAasMatmatnatoatpatq#Ceatrats",
+"attatuatvatwatxaty.Hsatzapjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapiankankapi.KC.O8anlanmanmarfarfarfarfarfarfarfarfanpanpanpanpanpanpanpanpatAatBatCatDatDarn.McatEatFatGatHatIatJ.OqatKatLatMatNatOatPatQahWahVatRatSa.DatTaj8atUatVatWatSatfatXatYatZat0at1anWanVatianXanYatiarsat2ar9anYat3at4an0at5at6at7at3at8at7at7at7an0at6at6at5at5at9au.au##9Y.XR.S..TEaqY#YAauaaubaucaudaueaufaug",
+"auhauiaujaukaulaum.Hsatzapjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapi.KC.KC.KC.KC.O8.O8.O8.O8arfarfarfarfarfarfarfarfanpanpanpanpanpanpanpanpatEacHarn#ZHaunauoaupauoauqatI.HYaurausautauuauvauwauxauyauzatMauAatQaldaj8atTauBa.DauCatVauDauCauEaoWaoXauF.HGauGauHat5arp.KfanYar9aqBarrar9anYarpapIat6auIauIan0at4auJarpat4apIan0at5auIaapaapau.au.auKauLauM.S..TEaqYauN#wLauOauPauQauRauSauT",
+"auUauVauWauXauYauZau0au1apjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapi.O8.O8.O8.KC.KCapiankank#6I#6I#6I#6I#6I#6I#6I#6IanpanpanpanpanpanpanpanpatAau2arnatBauoau3au4aunau5au6au7au8au9av.aig.ji.mo.moav#avaavbavcaj9ai4avdalbalbaveavfauDauDatWanQ.H8avgavh#ZHaviavjau#anUanZanYar9aqBarsanW.Kfat4at7auIaapaapauIat7at4at3arpat4an0auIaapau.avkau#auK#9YauL.I0avlanpanpavmavnavoavpavqavravsavt",
+"avuavvavwavxavy.Utavzau1apjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapianl.O8.O8.KCankankaqYaqYapjapjapjapjapjapjapjapjanpanpanpanpanpanpanpanpatE.HGavAavhavBaoYatCavC#6JavDavEavFavGavHavI.l#avJavJavKavLavMai5afzavcavNavNavda.DatSatUatVatVaqtavOaoX.HGavPavQatjatjanZ.KfanWar8ar8anWanZatjapIan0avR.3Wau.aapat5at7at4apIat7at6avRavSau.avT#9YauLauLavBavB.I0avlaegavUavVavWavXavYavZav0av1",
+"av2avvav3avxav4.Ow.5Vau1apjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapi.KCapiapiankankankaqYaqYanoanoanoanoanoanoanoanoanpanpanpanpanpanpanpanpau2av5av6av7av8avAav8atCau6av9aw.aw#.l#aig.jiaw#.l#awaawbawcawdafwaweaehalbauBa.DawfatSatUatVawgaquaquaqvarmarnawh.KfarpanYanWar9ar9anYanUawiawjat4an0avRau.au.avSauIat6at6at6at5auIavRaapavSavS.XRauM.I0avBavBawkawlawlawmawnawoawpawqawraws#Sz",
+"awtawuav3awvaww#41avzau1apjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapiawxawx.LLaqYankapi.KC.KCanoanoanoanoanoanoanoanoanpanpanpanpanpanpanpanpatAatBatBapHawyawyar5apHawzawAawBaigawCawD.l#.moawEav#awFawGavcaweawHawIaj8atSatUatUauCauCauDawJaquaquaqvar5asKatganXanWar9arsar8anXanUawKauKawLarpat7auIavSau.aapauIat6auIauIavRaapaapaapavSavS.S..S.avl.I0awkawMawNa#EawOawPawQawRawSawTawUawV",
+"awtawWawXawYawZ.Owavzau1apjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapiaw0aw1.LNawxank.O8anmannamgamgamgamgamgamgamgamganpanpanpanpanpanpanpanpacHarnar5av6atBatBatEaw2aw3au8aw4aw5aig.l#aw6aw7aoOaw8aw9ax.afwax#ak.auAatUawgaxaawgatWauCauDawJasGaxbatYatZat0axcanWanWarsarsatiaqDawiauKauKavj.HEat4at6aapavSaapauIat6at5auIauIaapavSau.avkavk.TE.TEanpavlawlawNa#Eaxdaxearkaxfaxgaxhaxiaxj#4i",
+"awtaxkaxlaxmaxnaxoau0au1apjapjapjapjapjapjapjapjapiapiapiapiapiapiapiapiarSaxpaw1awxankanlarR.KF.TE.TE.TE.TE.TE.TE.TE.TEanpanpanpanpanpanpanpanp#ZHaxqarnaxraxsacHaxtaxuaxvaxw.l#.moaw4aig.l#.l#axxaxyaxzaxAaxBaxCafzaxDawJaxEaxFaxEatVauCauDawJaxGaxGaxHaxIaxJaxKar9atiaqCar9anXan1avjawLavjatjat8at3an0auIaapavRat5an0at7axLat5aapau.avkaxdaxMaqYaqYanpaegawla#EaxdaxNaxO#2uaxPaxQaxRaceaxSaxT",
+"axUaxVaxWaxXaxYaxZas9ax0apiapiapiapiapiapiapiapi.KO.KOax1.F0ax2ax3a#La#L.Gbax4ax4ax5.KHax6.Gb.Oqaj6ax7#2uadpax8ax9ay.#8q.XR.XR.I0avlavl.HH.HH.HHaroay#ayaaybaycar7aydayeayfaygayhaigaigayiawDayjaykaylaymaynayoaypavPayqayraysaytayuatWayvaszaywayxayyayzayAayBayCayDayEayFayGahqayHayIayJayKayLayMayNat1ayOayPayQ#2xayRaySayTayUayVayWayXayYayZay0ahiay1aqKasa#VFaogay2ay3ay4ay5ay6ay7ay8ay9az.",
+"az#azaazbazcazdaze.Maaeiapiapiapiapiapiapiapiapi.IJ.KOacTazfazgazgazhacTaziazjax5azk.KHazl.Gbaziazm.F0abbaznazoax7azpazq.XR.XR.I0avlavl.H9.HH.HHay#aqyazrazsaztazuazvazwazx.l#avGawCaw6aigazyazzazAazBazCazDazEazFazGazHazIazJazKazLatXazMayvazNazOazPar1azQawgazRaxJazS.CsazTazUazVazWazXazYazZaz0akMaz1az2az3az4alOaz5#wMaz6.HRaz7az8az9.QCaA.#3S#3SaA#.I2#Rm#YA#Z1awLaAaaAbaAcay6aAdaAeaAfaAg",
+"aAhaAiaAjaAkaAl.QxaAmafxapiapiapiapiapiapiapiapiaAnaAoaApaAqaAraAsaAtaAuaAvaAwaAxaAyaAzaAA.F9aABareahUaACalEailalEaADafu.XR.XR.I0.I0avlavlavl.H9aAEayaaAFaAGauGaAHaAIaAJaAKaALaAMaig.qNaANaAOaAPaAQaARaASanYaATaAUaAVaAWaAXaAYaAZaytatVamhaA0aA1aqxazSaA2aA2aA3ab2aA4aA5aA6aA7aA8aA9aB.aB#aBaaBbaBcaBdaBeaBfaBgaBhaBiaBjaBkaBlaBkaBmaBn.XR.KkaBoaq0aBpaBqaA#aeR#SN#YA#Z1.MiaBra.HaBsaBtaBuaBvaBw",
+"aBxaByaBzaBAaBBaiUaBCaj9apiapiapiapiapiapiapiapiaBD#2OaBEaBFaBGaBHaBIaBJaBKaBL#viaBMaBNaBOaBPaBQaBRaBSaBTaBUaBV.H0aBWaAC.XR.XR.I0.I0.I0.I0avlavlaAGaroawlaBXao0aroaBYaBZaB0aB1aB2aB3aB4aB5aB6aB7aB8aB9aC.aC#aCaaCbaCcaCdaCeaCfaAYaAZaCgatUavfaChaCiaCjaCkaClaCmaA4aCnaCoaCpaCqaCraCsaCtaCuaCvaCwaCxaCyaCzaCAaCBaCCabpaCDaCEaCFaCGaCHaCIaCJaCKaCLa.Eahj.Mb.EVaCMaCN#W8#W8aCOaCPaCQaCRaCSaCTaCUaCV",
+"aCWaCXaCYaCZaC0aC1.F9ai4apiapiapiapiapiapiapiapiaC2aC3aC4aC5aC6aBHaC7aC8aC9aD.aD#aDaaDbaDcaDdaDeaDfaDgaDhaDiaDjaDk.HOaDl.I0.I0auM.XR.XR.XR.XR.XRaDmaAEaDmaBXaxcaqyaDnaDoaDpaDqaDraDsaDtaDuaDvaDwaDxaDyaeUaDzaDAaDBaDCaDDaDEaDFaDGanXaDHazKaCgauDaDI.HQayWaDJaDKaDLaDMaDNaDOaDPaDQaDRaDSaDTaDUaDVaDWaDXaDYaDZaD0aD1.EN.RvaD2#6GaD3aD4aD5aD6.I3axqaq0aBp.MbaA#aeR#SN#YA#Z1aD7aeTasLaD8aD9aE.aE#aEa",
+"aEbaEcazbaEdaBBaxZaEeawIapiapiapiapiapiapiapiapiacoaEfaEgaEhaEiaEjaEkaElaEmaEnaEoaEpaEqaEraEsaEtaEuaEvaEwaExaEyaEzaEAarU.I0.I0auM.XR.XR.IP.IPaEBar7ay#aqyaECat1aEDar7aEEaEFaEGaEHaEIaEJaEKaELaEMaENamRaEOaEPaEQaERaESaETamVaEUaEVaEWaEXaAZazKaEYaEZaE0aE1aE2aE3aE4aE5aE6aE7aE8aE9aF.aF#aFaaFbaFcaFdaFeaFfaFgaFh.UyaFiaFjaFk#6F#8gaFlaFm#94aFnaFo#3SaBqaFp.I2#Rm#YAawLawLaFqaf8aFraFsaFtaFuaFvaFw",
+"aFxaAiaFyaFzaFAaxZaEeauMapiapiapiapiapiapiapiapiadxaFBaFCaFDaFEaFFaFGaFHaFIaFJaFKaFLaFMaFNaFOaFPaFQaFRaFSaFTaFRaFUaFVaFWavl.I0auM.XR.IPaEBaEBaEBaqyanSauGanSaroayaaFXanSaFYaFZaF0aF1aF2aF3aF4aF5aF6aF7#YCaF8aF9aG.aG#aGaaGbaGcaGdaGeaGfaAYaAZaGgaGhaGiaGjaGkaGlaGmaGnaGoaGpaGqaGraGsaGtaGuaGvaGwaGxaGyaGzaGAaGBaGCaGDaGEaGFaGGaGHaGIaGJ.4iaGKaGLahiay1aGM.KlaqJaogawjawjaGNaGOatgaGPaGQaGRaGSaGT",
+"aGUaxVaFyaGVaGWaC1aGXagPapiapiapiapiapiapiapiapiaGYaGZaG0aG1aG2aG3aG4aG5aG6aG7aG8aG9aH.aH#aHaaHbaHcaHdaHeaHfaHgaHhaFUaHiavlavlauM.XR.IPaEBaHjaHjay#anSawlaHkaqyaECayaaztaHlaHmaHnaHoaHpaHqaHraHsan7aHtaHuaHvaHwaHxaHyaHzaHAaHBaGcaGeaGfaCfaAZ.GAaHCaHDaHEaHFaHGaHHaHIaHJaHKaHLaHMaHNaHOaHPaHQaHRaHSaHTaHUaHVaHWaHXaHYaHZaH0aH1aH2aH3aH4aH5aH6aH7abhabhaH8apNaocaH9aruaruaGNaI.aI#aIaaIbaIcaIdaIe",
+"aIfaIgaIhaIi.L8aIj.NyaIkai2agOagOaedaedabnabnabnaIlaImaInaIoaIpaIqaIraIsaItaIuaIvaIwaIxaIyaIzaIAaIBaHgaHfaICaIDaIEaIFaIG#44#44apkanpanpanp.S..S.acHauoatB#ZHatDavA.HG.HGaIHaIIaIJaIKaILaIMaINaIOaIPaIQaIRaISaITar5aCgaIUaIVaIWarmaIXaIYaIZaI0aI1aI2aI3aI4aI5aI6aI7aI8aI9aJ.aJ#aJaaJbaJcaJdaJeaJfaJgaJhaJiaJjaJkaJlaJmaJnaJoaJpaJqaJraJsaJtaJuaJvaJwatEaJxaviaruaBraJyaJzaJAaJBar5aap#RnaJCaJDaJE",
+"aJFaJGaJHaJIaJJaIjaJKaJLai2ai2agOaJMaedaedabnabnaJNaJO.HZ.LLaJPanlaJQaJRaJSaJTaJUaJVaJWaJXaJYaJZaJ0aJ1aJ2aFUaJ3aJ4aJ5aJ6#44#44#44apkanpanpanp.S.acHauoatBatB#ZH#ZHatDavAaJ7aJ8aJ9aK.aK#aKaaKbaKcaKdaKeaKfaJwatDacGaKgaKhaKiaKjaqw.7oaKkaKlaKmaKnaKoaKpaKqaKraKsaKtaKuaKvaKwaKxaKyaKzaKAaKBaKCaKDaKEaKFaKGaKHaKIaKJaKKaKLaKMaKNaKOaKPaKQ.N#aKR.GAaJwatEaJxaviaruaBraJyaJzaKS.Nz.HGat7#M4aKTaKUaKV",
+"aKWaKXaKYaKZ.L7.GpaK0.IUai2ai2ai2agOaedaedaedabn.F7apiaJNaJNanlaK1aK2arRaK3aK3aK4aK5aK6aKRaK7aK8aK9aqha#daL.aL#aLaaLbaLc#44#44#44#44anpanpanpanpacHacHauoauoauoauoauoauoaLdaLeaLfaLgaLhaLiaLjaLkaLlaLmatBaocaLnaLoaLpaLqaLraLsaLtaLuaLvaLwaLxaLyaLzaLAaLBaLCaLDaLEaLFaLGaLHaLIaLJaLKaLLaLMaLNaLOaLPaLQaLRaLSaLTaLUaLVaLWaLXaLYaLZaL0aL1aL2aL3.KtaJwatEaJxaviaruaBraJyaJzaL4aGOatEaEWaL5aL6aL7aJE",
+"aL8aKXaL9.Nf.L6agJaD6aM.alcai2ai2ai2agOaedaedaedaJN.GwaK1aK1aK1apiaK1aznaM#aM#.HKaMaaMb.Ja.BJaMcarcaMdaMdaBCaqiaMdaGX.HOaq0#44#44#44apkanpanpanpacHacHacHacHaunavBavBavBaphaMeaMfaMgaMhaFWaMiaMeaMjaI.aMkaMlaMmaLoaMnaMoaMpaMqahWaMraMsaMtaMuaMvaMwaMxaMyaMzaMAaMBaMCaMDaMEaMFaMGaMHaMIaMJaMKaMLaMMaMNaMOaMPaMQaMRaMSaMTaMUaMVaMWaMXaMYaMZ.Jk.KRaJwatEaJxaviaruaBraJyaJzaL4.NzauoanVaM0aM1aM2aM3",
+"aM4aM5aM6.P0aM7.GraD6aM.alcalc.Gvai2ai2agOaJMaedaJOazmaJO.GwaaiaaiaK2aM8.I7.I7.I7.I7.I7.I7.I7.I7.OqaM9aN..HM.HMaN#aNaaNbaqZaq0aq0#44#44#44apkanpacHacHacHaunavBavBavBavBaf5aNcaNdaNeaNfakx.HUaNgaNhaNiaNjaNjaMmaJBacIaNkaNlaNmatDaNnaNoaNpaNqaNraNsaNtaNuaNvaNwaNxaNyaNzaNAaNBaNCaNDaNEaNFaNGaNH.ihaNIaNJaNKaNLaNMaNNaNOaNPaNQaNRaNS.L8aAnaNTaNUaJwatEaJxaviaruaBraJyaJzaFqaJBatEaNVaL5ascaNWaNX",
+"aNYaNZaN0.P0.O3aN1#93aN2aN3aN3alc.Gvai2ai2agOagOaK1aK2aK1.H1aN4.LO.HZazmanNanNanNanNanNanNaN5aN5amIaN6aikaADazpawmailaecaqZaqZaqZaq0#44#44#44apkaunaunaun.IPacHacHacHacHano.TEaN7ano.KPaN8aN9aO.aO#aNiaNjaOaacGapHar5aObaOcaOd.O9.LFaOeaOfaOgaOhaOiaOjaOk.SYaOlaOmaOnaOoaOpaOqaOraEDaHkaOsaynaOtaOuaOvaOwaOxaOyaOzaOAaOBaOCaODaOE.FT.NuaaiaOFaOGaJwatEaJxaviaruaBraJyaJzaOHaOIavAaOJaOKaOLaOMaON",
+"aOOaOPaOQaORaOS.QAaOTaIkaN3aN3aN3alcai2ai2ai2agOaN4aM8.GwaJN.GwaK1aK2.Gwanpanpamg#44#6IaqZaqZ.H7azn#94#2uaOU.Nwaaiax8alEaqZaqZaqZaq0#44#44#44#44avBavBaunacHauoatBatBatEaOVaOWaOXaJKaOVaOYaOZ.Kx.NzaLnaO0aO1aO2aO3aO4aO5aO6aO7aO8azMaO9aP.aP#aPaaPbaPcaPdaPeaPfaPgaPhaPiaPjaPkaPlaPmaPnaPoaPpaPqaPraPsaPtaPuaPv.H8aPwaPxaPyaPzaPAaPBaPC.LJajwaPDaJwatEaJxaviaruaBraJyaJzaPEaI.aPFau.aPGaPHaPIaPJ",
+"aPKaPLaPM.ZqaPNaPO.Kp.RraN3aN3aN3alcalcai2ai2ai2aJOaM8aM8aPPaJNarR.LNaPQanpanpanpanp.S..S.aimaimaPRano.EUasFaPSai0aPTabbaqZaqZaqZaqZaq0#44#44#44avBavBaunacHatB#ZHatDavAaPUaPVaPWaPXaPYaPZ.KAaP0aGgaP1aO1aP2aP3aP4aP5aP6aP7aP8aP9aQ.aQ#aQaaQbaQcaQdaEYaQeaQfaKSaQgaQhaQiaQjaFXaQkaQlaQmaQnay#aOsaQoaQpaQqaQrayWaQsazGaQtaQuaQvaQwaQxaQyaQzaQAaQBaJwatEaJxaviaruaBraJyaJzaQCaQDaPFavkaQEaOLaQFaQG"};
diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index 7b04293018f..04df023cb19 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -20,11 +20,17 @@ def test_sanity() -> None:
         assert_image_similar(im.convert("RGB"), hopper(), 23)
 
 
-def test_read_bpp2() -> None:
+def test_bpp2() -> None:
     with Image.open("Tests/images/hopper_bpp2.xpm") as im:
         assert_image_similar(im.convert("RGB"), hopper(), 11)
 
 
+def test_rgb() -> None:
+    with Image.open("Tests/images/hopper_rgb.xpm") as im:
+        assert im.mode == "RGB"
+        assert_image_similar(im, hopper(), 16)
+
+
 def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index bfa462c04c9..51d829abe8f 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1650,7 +1650,8 @@ handler. ::
 XPM
 ^^^
 
-Pillow reads X pixmap files (mode ``P``) with 256 colors or less.
+Pillow reads X pixmap files as P mode images if there are 256 colors or less, and as
+RGB images otherwise.
 
 .. _xpm-opening:
 
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index fcee142e3c2..d80ca7ce45e 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -56,10 +56,6 @@ def _open(self) -> None:
         palette_length = int(m.group(3))
         bpp = int(m.group(4))
 
-        if palette_length > 256:
-            msg = "cannot read this XPM file"
-            raise ValueError(msg)
-
         #
         # load palette description
 
@@ -93,15 +89,16 @@ def _open(self) -> None:
                 msg = "cannot read this XPM file"
                 raise ValueError(msg)
 
-        self._mode = "P"
-        self.palette = ImagePalette.raw("RGB", b"".join(palette.values()))
+        args: tuple[int, dict[bytes, bytes] | tuple[bytes, ...]]
+        if palette_length > 256:
+            self._mode = "RGB"
+            args = (bpp, palette)
+        else:
+            self._mode = "P"
+            self.palette = ImagePalette.raw("RGB", b"".join(palette.values()))
+            args = (bpp, tuple(palette.keys()))
 
-        palette_keys = tuple(palette.keys())
-        self.tile = [
-            ImageFile._Tile(
-                "xpm", (0, 0) + self.size, self.fp.tell(), (bpp, palette_keys)
-            )
-        ]
+        self.tile = [ImageFile._Tile("xpm", (0, 0) + self.size, self.fp.tell(), args)]
 
     def load_read(self, read_bytes: int) -> bytes:
         #
@@ -119,17 +116,27 @@ class XpmDecoder(ImageFile.PyDecoder):
 
     def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         assert self.fd is not None
-        self.fd.readline()  # Read '/* pixels */'
 
         data = bytearray()
-        bpp, palette_keys = self.args
+        bpp, palette = self.args
         dest_length = self.state.xsize * self.state.ysize
+        if self.mode == "RGB":
+            dest_length *= 3
+        pixel_header = False
         while len(data) < dest_length:
-            s = self.fd.readline().rstrip()[1:]
-            s = s[: -1 if s.endswith(b'"') else -2]
+            s = self.fd.readline()
+            if s.rstrip() == b"/* pixels */" and not pixel_header:
+                pixel_header = True
+                continue
+            if not s:
+                break
+            s = b'"'.join(s.split(b'"')[1:-1])
             for i in range(0, len(s), bpp):
                 key = s[i : i + bpp]
-                data += o8(palette_keys.index(key))
+                if self.mode == "RGB":
+                    data += palette[key]
+                else:
+                    data += o8(palette.index(key))
         self.set_as_raw(bytes(data))
         return -1, 0
 

From 6512a8e371476b91bc5adfbe076ace2c0f076da2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 9 Apr 2025 23:41:45 +1000
Subject: [PATCH 1627/2374] Test not enough image data

---
 Tests/test_file_xpm.py    | 10 ++++++++++
 src/PIL/XpmImagePlugin.py |  4 ++--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index 04df023cb19..96365d7f441 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from io import BytesIO
+
 import pytest
 
 from PIL import Image, XpmImagePlugin
@@ -31,6 +33,14 @@ def test_rgb() -> None:
         assert_image_similar(im, hopper(), 16)
 
 
+def test_not_enough_image_data() -> None:
+    with open(TEST_FILE, "rb") as fp:
+        data = fp.read().split(b"/* pixels */")[0]
+        with Image.open(BytesIO(data)) as im:
+            with pytest.raises(ValueError, match="not enough image data"):
+                im.load()
+
+
 def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 
diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index d80ca7ce45e..ff216a6c1eb 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -125,11 +125,11 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
         pixel_header = False
         while len(data) < dest_length:
             s = self.fd.readline()
+            if not s:
+                break
             if s.rstrip() == b"/* pixels */" and not pixel_header:
                 pixel_header = True
                 continue
-            if not s:
-                break
             s = b'"'.join(s.split(b'"')[1:-1])
             for i in range(0, len(s), bpp):
                 key = s[i : i + bpp]

From 34efaaddf306f3a435f490ca6082fc80bc7cad37 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 18:57:31 +1000
Subject: [PATCH 1628/2374] Improved type hints

---
 src/PIL/XpmImagePlugin.py | 32 ++++++++++++++++++--------------
 1 file changed, 18 insertions(+), 14 deletions(-)

diff --git a/src/PIL/XpmImagePlugin.py b/src/PIL/XpmImagePlugin.py
index ff216a6c1eb..3be240fbc1a 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -37,17 +37,18 @@ class XpmImageFile(ImageFile.ImageFile):
     format_description = "X11 Pixel Map"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(9)):
             msg = "not an XPM file"
             raise SyntaxError(msg)
 
         # skip forward to next string
         while True:
-            s = self.fp.readline()
-            if not s:
+            line = self.fp.readline()
+            if not line:
                 msg = "broken XPM file"
                 raise SyntaxError(msg)
-            m = xpm_head.match(s)
+            m = xpm_head.match(line)
             if m:
                 break
 
@@ -62,10 +63,10 @@ def _open(self) -> None:
         palette = {}
 
         for _ in range(palette_length):
-            s = self.fp.readline().rstrip()
+            line = self.fp.readline().rstrip()
 
-            c = s[1 : bpp + 1]
-            s = s[bpp + 1 : -2].split()
+            c = line[1 : bpp + 1]
+            s = line[bpp + 1 : -2].split()
 
             for i in range(0, len(s), 2):
                 if s[i] == b"c":
@@ -74,9 +75,11 @@ def _open(self) -> None:
                     if rgb == b"None":
                         self.info["transparency"] = c
                     elif rgb.startswith(b"#"):
-                        rgb = int(rgb[1:], 16)
+                        rgb_int = int(rgb[1:], 16)
                         palette[c] = (
-                            o8((rgb >> 16) & 255) + o8((rgb >> 8) & 255) + o8(rgb & 255)
+                            o8((rgb_int >> 16) & 255)
+                            + o8((rgb_int >> 8) & 255)
+                            + o8(rgb_int & 255)
                         )
                     else:
                         # unknown colour
@@ -106,6 +109,7 @@ def load_read(self, read_bytes: int) -> bytes:
 
         xsize, ysize = self.size
 
+        assert self.fp is not None
         s = [self.fp.readline()[1 : xsize + 1].ljust(xsize) for i in range(ysize)]
 
         return b"".join(s)
@@ -124,15 +128,15 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
             dest_length *= 3
         pixel_header = False
         while len(data) < dest_length:
-            s = self.fd.readline()
-            if not s:
+            line = self.fd.readline()
+            if not line:
                 break
-            if s.rstrip() == b"/* pixels */" and not pixel_header:
+            if line.rstrip() == b"/* pixels */" and not pixel_header:
                 pixel_header = True
                 continue
-            s = b'"'.join(s.split(b'"')[1:-1])
-            for i in range(0, len(s), bpp):
-                key = s[i : i + bpp]
+            line = b'"'.join(line.split(b'"')[1:-1])
+            for i in range(0, len(line), bpp):
+                key = line[i : i + bpp]
                 if self.mode == "RGB":
                     data += palette[key]
                 else:

From af52060e973063b259708a8e91bfbbf13376c247 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 20:45:53 +1000
Subject: [PATCH 1629/2374] Mention that tobytes() with the raw encoder uses
 Pack.c

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 88ea6f3b53e..b419405fb7a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -767,18 +767,20 @@ def tobytes(self, encoder_name: str = "raw", *args: Any) -> bytes:
 
         .. warning::
 
-            This method returns the raw image data from the internal
-            storage.  For compressed image data (e.g. PNG, JPEG) use
-            :meth:`~.save`, with a BytesIO parameter for in-memory
-            data.
-
-        :param encoder_name: What encoder to use.  The default is to
-                             use the standard "raw" encoder.
-
-                             A list of C encoders can be seen under
-                             codecs section of the function array in
-                             :file:`_imaging.c`. Python encoders are
-                             registered within the relevant plugins.
+            This method returns raw image data derived from Pillow's internal
+            storage. For compressed image data (e.g. PNG, JPEG) use
+            :meth:`~.save`, with a BytesIO parameter for in-memory data.
+
+        :param encoder_name: What encoder to use.
+
+                             The default is to use the standard "raw" encoder.
+                             To see how this packs pixel data into the returned
+                             bytes, see :file:`libImaging/Pack.c`.
+
+                             A list of C encoders can be seen under codecs
+                             section of the function array in
+                             :file:`_imaging.c`. Python encoders are registered
+                             within the relevant plugins.
         :param args: Extra arguments to the encoder.
         :returns: A :py:class:`bytes` object.
         """

From dce96089614a2bfac112b5baa5f19d87874f526b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 21:59:04 +1000
Subject: [PATCH 1630/2374] Test unknown colour and missing colour key

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

diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index 96365d7f441..de2d9bb793a 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -33,12 +33,23 @@ def test_rgb() -> None:
         assert_image_similar(im, hopper(), 16)
 
 
+def test_cannot_read() -> None:
+    with open(TEST_FILE, "rb") as fp:
+        data = fp.read().split(b"#")[0]
+    with pytest.raises(ValueError, match="cannot read this XPM file"):
+        with Image.open(BytesIO(data)) as im:
+            pass
+    with pytest.raises(ValueError, match="cannot read this XPM file"):
+        with Image.open(BytesIO(data+b"invalid")) as im:
+            pass
+
+
 def test_not_enough_image_data() -> None:
     with open(TEST_FILE, "rb") as fp:
         data = fp.read().split(b"/* pixels */")[0]
-        with Image.open(BytesIO(data)) as im:
-            with pytest.raises(ValueError, match="not enough image data"):
-                im.load()
+    with Image.open(BytesIO(data)) as im:
+        with pytest.raises(ValueError, match="not enough image data"):
+            im.load()
 
 
 def test_invalid_file() -> None:

From b2945ec2aaf20d4698479c843f0d26ffcaf6222b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Apr 2025 22:07:55 +1000
Subject: [PATCH 1631/2374] Test truncated header

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

diff --git a/Tests/test_file_xpm.py b/Tests/test_file_xpm.py
index de2d9bb793a..86d86602f17 100644
--- a/Tests/test_file_xpm.py
+++ b/Tests/test_file_xpm.py
@@ -33,14 +33,22 @@ def test_rgb() -> None:
         assert_image_similar(im, hopper(), 16)
 
 
-def test_cannot_read() -> None:
+def test_truncated_header() -> None:
+    data = b"/* XPM */"
+    with pytest.raises(SyntaxError, match="broken XPM file"):
+        with XpmImagePlugin.XpmImageFile(BytesIO(data)):
+            pass
+
+
+def test_cannot_read_color() -> None:
     with open(TEST_FILE, "rb") as fp:
         data = fp.read().split(b"#")[0]
     with pytest.raises(ValueError, match="cannot read this XPM file"):
-        with Image.open(BytesIO(data)) as im:
+        with Image.open(BytesIO(data)):
             pass
+
     with pytest.raises(ValueError, match="cannot read this XPM file"):
-        with Image.open(BytesIO(data+b"invalid")) as im:
+        with Image.open(BytesIO(data + b"invalid")):
             pass
 
 

From 79f834ef6500774f63b49e19f5c150d9ed6f2681 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Apr 2025 22:26:42 +1000
Subject: [PATCH 1632/2374] If pasting an image onto itself at a lower
 position, copy from bottom

---
 Tests/test_image_paste.py | 12 ++++++++++++
 src/libImaging/Paste.c    | 10 ++++++++--
 2 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index 2cff6c89378..5fee8172950 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -124,6 +124,18 @@ def test_image_solid(self, mode: str) -> None:
         im = im.crop((12, 23, im2.width + 12, im2.height + 23))
         assert_image_equal(im, im2)
 
+    @pytest.mark.parametrize("y", [10, -10])
+    def test_image_self(self, y: int) -> None:
+        im = self.gradient_RGB
+
+        im_self = im.copy()
+        im_self.paste(im_self, (0, y))
+
+        im_copy = im.copy()
+        im_copy.paste(im_copy.copy(), (0, y))
+
+        assert_image_equal(im_self, im_copy)
+
     @pytest.mark.parametrize("mode", ["RGBA", "RGB", "L"])
     def test_image_mask_1(self, mode: str) -> None:
         im = Image.new(mode, (200, 200), "white")
diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index 86085942a2e..e2ce00ea626 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -44,8 +44,14 @@ paste(
 
     xsize *= pixelsize;
 
-    for (y = 0; y < ysize; y++) {
-        memcpy(imOut->image[y + dy] + dx, imIn->image[y + sy] + sx, xsize);
+    if (imOut == imIn && dy > sy) {
+        for (y = ysize - 1; y >= 0; y--) {
+            memcpy(imOut->image[y + dy] + dx, imIn->image[y + sy] + sx, xsize);
+        }
+    } else {
+        for (y = 0; y < ysize; y++) {
+            memcpy(imOut->image[y + dy] + dx, imIn->image[y + sy] + sx, xsize);
+        }
     }
 }
 

From 81fa4e18c7c11c115c3bed5200b4129f0097b00f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 08:19:18 +1000
Subject: [PATCH 1633/2374] If pasting image to self at lower position with
 mask, copy from bottom

---
 Tests/test_image_paste.py | 11 +++++---
 src/libImaging/Paste.c    | 53 +++++++++++++++++++++++----------------
 2 files changed, 38 insertions(+), 26 deletions(-)

diff --git a/Tests/test_image_paste.py b/Tests/test_image_paste.py
index 5fee8172950..37e4df10370 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -125,14 +125,17 @@ def test_image_solid(self, mode: str) -> None:
         assert_image_equal(im, im2)
 
     @pytest.mark.parametrize("y", [10, -10])
-    def test_image_self(self, y: int) -> None:
-        im = self.gradient_RGB
+    @pytest.mark.parametrize("mode", ["L", "RGB"])
+    @pytest.mark.parametrize("mask_mode", ["", "1", "L", "LA", "RGBa"])
+    def test_image_self(self, y: int, mode: str, mask_mode: str) -> None:
+        im = getattr(self, "gradient_" + mode)
+        mask = Image.new(mask_mode, im.size, 0xFFFFFFFF) if mask_mode else None
 
         im_self = im.copy()
-        im_self.paste(im_self, (0, y))
+        im_self.paste(im_self, (0, y), mask)
 
         im_copy = im.copy()
-        im_copy.paste(im_copy.copy(), (0, y))
+        im_copy.paste(im_copy.copy(), (0, y), mask)
 
         assert_image_equal(im_self, im_copy)
 
diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index e2ce00ea626..9942f9c1c61 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -23,6 +23,18 @@
 
 #include "Imaging.h"
 
+#define PREPARE_PASTE_LOOP()        \
+    int y, y_end, offset;           \
+    if (imOut == imIn && dy > sy) { \
+        y = ysize - 1;              \
+        y_end = -1;                 \
+        offset = -1;                \
+    } else {                        \
+        y = 0;                      \
+        y_end = ysize;              \
+        offset = 1;                 \
+    }
+
 static inline void
 paste(
     Imaging imOut,
@@ -37,21 +49,14 @@ paste(
 ) {
     /* paste opaque region */
 
-    int y;
-
     dx *= pixelsize;
     sx *= pixelsize;
 
     xsize *= pixelsize;
 
-    if (imOut == imIn && dy > sy) {
-        for (y = ysize - 1; y >= 0; y--) {
-            memcpy(imOut->image[y + dy] + dx, imIn->image[y + sy] + sx, xsize);
-        }
-    } else {
-        for (y = 0; y < ysize; y++) {
-            memcpy(imOut->image[y + dy] + dx, imIn->image[y + sy] + sx, xsize);
-        }
+    PREPARE_PASTE_LOOP();
+    for (; y != y_end; y += offset) {
+        memcpy(imOut->image[y + dy] + dx, imIn->image[y + sy] + sx, xsize);
     }
 }
 
@@ -70,12 +75,13 @@ paste_mask_1(
 ) {
     /* paste with mode "1" mask */
 
-    int x, y;
+    int x;
 
+    PREPARE_PASTE_LOOP();
     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++) {
+        for (; y != y_end; y += offset) {
             UINT8 *out = imOut->image8[y + dy] + dx;
             if (out_i16) {
                 out += dx;
@@ -103,7 +109,7 @@ paste_mask_1(
         }
 
     } else {
-        for (y = 0; y < ysize; y++) {
+        for (; y != y_end; y += offset) {
             INT32 *out = imOut->image32[y + dy] + dx;
             INT32 *in = imIn->image32[y + sy] + sx;
             UINT8 *mask = imMask->image8[y + sy] + sx;
@@ -132,11 +138,12 @@ paste_mask_L(
 ) {
     /* paste with mode "L" matte */
 
-    int x, y;
+    int x;
     unsigned int tmp1;
 
+    PREPARE_PASTE_LOOP();
     if (imOut->image8) {
-        for (y = 0; y < ysize; y++) {
+        for (; y != y_end; y += offset) {
             UINT8 *out = imOut->image8[y + dy] + dx;
             UINT8 *in = imIn->image8[y + sy] + sx;
             UINT8 *mask = imMask->image8[y + sy] + sx;
@@ -147,7 +154,7 @@ paste_mask_L(
         }
 
     } else {
-        for (y = 0; y < ysize; y++) {
+        for (; y != y_end; y += offset) {
             UINT8 *out = (UINT8 *)(imOut->image32[y + dy] + dx);
             UINT8 *in = (UINT8 *)(imIn->image32[y + sy] + sx);
             UINT8 *mask = (UINT8 *)(imMask->image8[y + sy] + sx);
@@ -180,11 +187,12 @@ paste_mask_RGBA(
 ) {
     /* paste with mode "RGBA" matte */
 
-    int x, y;
+    int x;
     unsigned int tmp1;
 
+    PREPARE_PASTE_LOOP();
     if (imOut->image8) {
-        for (y = 0; y < ysize; y++) {
+        for (; y != y_end; y += offset) {
             UINT8 *out = imOut->image8[y + dy] + dx;
             UINT8 *in = imIn->image8[y + sy] + sx;
             UINT8 *mask = (UINT8 *)imMask->image[y + sy] + sx * 4 + 3;
@@ -195,7 +203,7 @@ paste_mask_RGBA(
         }
 
     } else {
-        for (y = 0; y < ysize; y++) {
+        for (; y != y_end; y += offset) {
             UINT8 *out = (UINT8 *)(imOut->image32[y + dy] + dx);
             UINT8 *in = (UINT8 *)(imIn->image32[y + sy] + sx);
             UINT8 *mask = (UINT8 *)(imMask->image32[y + sy] + sx);
@@ -228,11 +236,12 @@ paste_mask_RGBa(
 ) {
     /* paste with mode "RGBa" matte */
 
-    int x, y;
+    int x;
     unsigned int tmp1;
 
+    PREPARE_PASTE_LOOP();
     if (imOut->image8) {
-        for (y = 0; y < ysize; y++) {
+        for (; y != y_end; y += offset) {
             UINT8 *out = imOut->image8[y + dy] + dx;
             UINT8 *in = imIn->image8[y + sy] + sx;
             UINT8 *mask = (UINT8 *)imMask->image[y + sy] + sx * 4 + 3;
@@ -243,7 +252,7 @@ paste_mask_RGBa(
         }
 
     } else {
-        for (y = 0; y < ysize; y++) {
+        for (; y != y_end; y += offset) {
             UINT8 *out = (UINT8 *)(imOut->image32[y + dy] + dx);
             UINT8 *in = (UINT8 *)(imIn->image32[y + sy] + sx);
             UINT8 *mask = (UINT8 *)(imMask->image32[y + sy] + sx);

From 04909483a70e29cd265446199a8f22c1acdc6db7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 17:29:06 +1000
Subject: [PATCH 1634/2374] Remove GPL v2 license (#8884)

---
 wheels/dependency_licenses/FREETYPE2.txt | 345 -----------------------
 1 file changed, 345 deletions(-)

diff --git a/wheels/dependency_licenses/FREETYPE2.txt b/wheels/dependency_licenses/FREETYPE2.txt
index 93efc612676..8f2345992b0 100644
--- a/wheels/dependency_licenses/FREETYPE2.txt
+++ b/wheels/dependency_licenses/FREETYPE2.txt
@@ -211,351 +211,6 @@ Legal Terms
 
 --- end of FTL.TXT ---
 
---------------------------------------------------------------------------
-
-            GNU GENERAL PUBLIC LICENSE
-               Version 2, June 1991
-
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
-     51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-                Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-License is intended to guarantee your freedom to share and change free
-software--to make sure the software is free for all its users.  This
-General Public License applies to most of the Free Software
-Foundation's software and to any other program whose authors commit to
-using it.  (Some other Free Software Foundation software is covered by
-the GNU Library General Public License instead.)  You can apply it to
-your programs, too.
-
-  When we speak of free software, we are referring to freedom, not
-price.  Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-this service if you wish), that you receive source code or can get it
-if you want it, that you can change the software or use pieces of it
-in new free programs; and that you know you can do these things.
-
-  To protect your rights, we need to make restrictions that forbid
-anyone to deny you these rights or to ask you to surrender the rights.
-These restrictions translate to certain responsibilities for you if you
-distribute copies of the software, or if you modify it.
-
-  For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must give the recipients all the rights that
-you have.  You must make sure that they, too, receive or can get the
-source code.  And you must show them these terms so they know their
-rights.
-
-  We protect your rights with two steps: (1) copyright the software, and
-(2) offer you this license which gives you legal permission to copy,
-distribute and/or modify the software.
-
-  Also, for each author's protection and ours, we want to make certain
-that everyone understands that there is no warranty for this free
-software.  If the software is modified by someone else and passed on, we
-want its recipients to know that what they have is not the original, so
-that any problems introduced by others will not reflect on the original
-authors' reputations.
-
-  Finally, any free program is threatened constantly by software
-patents.  We wish to avoid the danger that redistributors of a free
-program will individually obtain patent licenses, in effect making the
-program proprietary.  To prevent this, we have made it clear that any
-patent must be licensed for everyone's free use or not licensed at all.
-
-  The precise terms and conditions for copying, distribution and
-modification follow.
-
-            GNU GENERAL PUBLIC LICENSE
-   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
-
-  0. This License applies to any program or other work which contains
-a notice placed by the copyright holder saying it may be distributed
-under the terms of this General Public License.  The "Program", below,
-refers to any such program or work, and a "work based on the Program"
-means either the Program or any derivative work under copyright law:
-that is to say, a work containing the Program or a portion of it,
-either verbatim or with modifications and/or translated into another
-language.  (Hereinafter, translation is included without limitation in
-the term "modification".)  Each licensee is addressed as "you".
-
-Activities other than copying, distribution and modification are not
-covered by this License; they are outside its scope.  The act of
-running the Program is not restricted, and the output from the Program
-is covered only if its contents constitute a work based on the
-Program (independent of having been made by running the Program).
-Whether that is true depends on what the Program does.
-
-  1. You may copy and distribute verbatim copies of the Program's
-source code as you receive it, in any medium, provided that you
-conspicuously and appropriately publish on each copy an appropriate
-copyright notice and disclaimer of warranty; keep intact all the
-notices that refer to this License and to the absence of any warranty;
-and give any other recipients of the Program a copy of this License
-along with the Program.
-
-You may charge a fee for the physical act of transferring a copy, and
-you may at your option offer warranty protection in exchange for a fee.
-
-  2. You may modify your copy or copies of the Program or any portion
-of it, thus forming a work based on the Program, and copy and
-distribute such modifications or work under the terms of Section 1
-above, provided that you also meet all of these conditions:
-
-    a) You must cause the modified files to carry prominent notices
-    stating that you changed the files and the date of any change.
-
-    b) You must cause any work that you distribute or publish, that in
-    whole or in part contains or is derived from the Program or any
-    part thereof, to be licensed as a whole at no charge to all third
-    parties under the terms of this License.
-
-    c) If the modified program normally reads commands interactively
-    when run, you must cause it, when started running for such
-    interactive use in the most ordinary way, to print or display an
-    announcement including an appropriate copyright notice and a
-    notice that there is no warranty (or else, saying that you provide
-    a warranty) and that users may redistribute the program under
-    these conditions, and telling the user how to view a copy of this
-    License.  (Exception: if the Program itself is interactive but
-    does not normally print such an announcement, your work based on
-    the Program is not required to print an announcement.)
-
-These requirements apply to the modified work as a whole.  If
-identifiable sections of that work are not derived from the Program,
-and can be reasonably considered independent and separate works in
-themselves, then this License, and its terms, do not apply to those
-sections when you distribute them as separate works.  But when you
-distribute the same sections as part of a whole which is a work based
-on the Program, the distribution of the whole must be on the terms of
-this License, whose permissions for other licensees extend to the
-entire whole, and thus to each and every part regardless of who wrote it.
-
-Thus, it is not the intent of this section to claim rights or contest
-your rights to work written entirely by you; rather, the intent is to
-exercise the right to control the distribution of derivative or
-collective works based on the Program.
-
-In addition, mere aggregation of another work not based on the Program
-with the Program (or with a work based on the Program) on a volume of
-a storage or distribution medium does not bring the other work under
-the scope of this License.
-
-  3. You may copy and distribute the Program (or a work based on it,
-under Section 2) in object code or executable form under the terms of
-Sections 1 and 2 above provided that you also do one of the following:
-
-    a) Accompany it with the complete corresponding machine-readable
-    source code, which must be distributed under the terms of Sections
-    1 and 2 above on a medium customarily used for software interchange; or,
-
-    b) Accompany it with a written offer, valid for at least three
-    years, to give any third party, for a charge no more than your
-    cost of physically performing source distribution, a complete
-    machine-readable copy of the corresponding source code, to be
-    distributed under the terms of Sections 1 and 2 above on a medium
-    customarily used for software interchange; or,
-
-    c) Accompany it with the information you received as to the offer
-    to distribute corresponding source code.  (This alternative is
-    allowed only for noncommercial distribution and only if you
-    received the program in object code or executable form with such
-    an offer, in accord with Subsection b above.)
-
-The source code for a work means the preferred form of the work for
-making modifications to it.  For an executable work, complete source
-code means all the source code for all modules it contains, plus any
-associated interface definition files, plus the scripts used to
-control compilation and installation of the executable.  However, as a
-special exception, the source code distributed need not include
-anything that is normally distributed (in either source or binary
-form) with the major components (compiler, kernel, and so on) of the
-operating system on which the executable runs, unless that component
-itself accompanies the executable.
-
-If distribution of executable or object code is made by offering
-access to copy from a designated place, then offering equivalent
-access to copy the source code from the same place counts as
-distribution of the source code, even though third parties are not
-compelled to copy the source along with the object code.
-
-  4. You may not copy, modify, sublicense, or distribute the Program
-except as expressly provided under this License.  Any attempt
-otherwise to copy, modify, sublicense or distribute the Program is
-void, and will automatically terminate your rights under this License.
-However, parties who have received copies, or rights, from you under
-this License will not have their licenses terminated so long as such
-parties remain in full compliance.
-
-  5. You are not required to accept this License, since you have not
-signed it.  However, nothing else grants you permission to modify or
-distribute the Program or its derivative works.  These actions are
-prohibited by law if you do not accept this License.  Therefore, by
-modifying or distributing the Program (or any work based on the
-Program), you indicate your acceptance of this License to do so, and
-all its terms and conditions for copying, distributing or modifying
-the Program or works based on it.
-
-  6. Each time you redistribute the Program (or any work based on the
-Program), the recipient automatically receives a license from the
-original licensor to copy, distribute or modify the Program subject to
-these terms and conditions.  You may not impose any further
-restrictions on the recipients' exercise of the rights granted herein.
-You are not responsible for enforcing compliance by third parties to
-this License.
-
-  7. If, as a consequence of a court judgment or allegation of patent
-infringement or for any other reason (not limited to patent issues),
-conditions are imposed on you (whether by court order, agreement or
-otherwise) that contradict the conditions of this License, they do not
-excuse you from the conditions of this License.  If you cannot
-distribute so as to satisfy simultaneously your obligations under this
-License and any other pertinent obligations, then as a consequence you
-may not distribute the Program at all.  For example, if a patent
-license would not permit royalty-free redistribution of the Program by
-all those who receive copies directly or indirectly through you, then
-the only way you could satisfy both it and this License would be to
-refrain entirely from distribution of the Program.
-
-If any portion of this section is held invalid or unenforceable under
-any particular circumstance, the balance of the section is intended to
-apply and the section as a whole is intended to apply in other
-circumstances.
-
-It is not the purpose of this section to induce you to infringe any
-patents or other property right claims or to contest validity of any
-such claims; this section has the sole purpose of protecting the
-integrity of the free software distribution system, which is
-implemented by public license practices.  Many people have made
-generous contributions to the wide range of software distributed
-through that system in reliance on consistent application of that
-system; it is up to the author/donor to decide if he or she is willing
-to distribute software through any other system and a licensee cannot
-impose that choice.
-
-This section is intended to make thoroughly clear what is believed to
-be a consequence of the rest of this License.
-
-  8. If the distribution and/or use of the Program is restricted in
-certain countries either by patents or by copyrighted interfaces, the
-original copyright holder who places the Program under this License
-may add an explicit geographical distribution limitation excluding
-those countries, so that distribution is permitted only in or among
-countries not thus excluded.  In such case, this License incorporates
-the limitation as if written in the body of this License.
-
-  9. The Free Software Foundation may publish revised and/or new versions
-of the General Public License from time to time.  Such new versions will
-be similar in spirit to the present version, but may differ in detail to
-address new problems or concerns.
-
-Each version is given a distinguishing version number.  If the Program
-specifies a version number of this License which applies to it and "any
-later version", you have the option of following the terms and conditions
-either of that version or of any later version published by the Free
-Software Foundation.  If the Program does not specify a version number of
-this License, you may choose any version ever published by the Free Software
-Foundation.
-
-  10. If you wish to incorporate parts of the Program into other free
-programs whose distribution conditions are different, write to the author
-to ask for permission.  For software which is copyrighted by the Free
-Software Foundation, write to the Free Software Foundation; we sometimes
-make exceptions for this.  Our decision will be guided by the two goals
-of preserving the free status of all derivatives of our free software and
-of promoting the sharing and reuse of software generally.
-
-                NO WARRANTY
-
-  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
-FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
-OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
-PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
-OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
-MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
-TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
-PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
-REPAIR OR CORRECTION.
-
-  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
-WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
-REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
-INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
-OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
-TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
-YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
-PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGES.
-
-             END OF TERMS AND CONDITIONS
-
-        How to Apply These Terms to Your New Programs
-
-  If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these terms.
-
-  To do so, attach the following notices to the program.  It is safest
-to attach them to the start of each source file to most effectively
-convey the exclusion of warranty; and each file should have at least
-the "copyright" line and a pointer to where the full notice is found.
-
-    <one line to give the program's name and a brief idea of what it does.>
-    Copyright (C) <year>  <name of author>
-
-    This program is free software; you can redistribute it and/or modify
-    it under the terms of the GNU General Public License as published by
-    the Free Software Foundation; either version 2 of the License, or
-    (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU General Public License for more details.
-
-    You should have received a copy of the GNU General Public License
-    along with this program; if not, write to the Free Software
-    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
-
-
-Also add information on how to contact you by electronic and paper mail.
-
-If the program is interactive, make it output a short notice like this
-when it starts in an interactive mode:
-
-    Gnomovision version 69, Copyright (C) year  name of author
-    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-    This is free software, and you are welcome to redistribute it
-    under certain conditions; type `show c' for details.
-
-The hypothetical commands `show w' and `show c' should show the appropriate
-parts of the General Public License.  Of course, the commands you use may
-be called something other than `show w' and `show c'; they could even be
-mouse-clicks or menu items--whatever suits your program.
-
-You should also get your employer (if you work as a programmer) or your
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary.  Here is a sample; alter the names:
-
-  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
-  `Gnomovision' (which makes passes at compilers) written by James Hacker.
-
-  <signature of Ty Coon>, 1 April 1989
-  Ty Coon, President of Vice
-
-This General Public License does not permit incorporating your program into
-proprietary programs.  If your program is a subroutine library, you may
-consider it more useful to permit linking proprietary applications with the
-library.  If this is what you want to do, use the GNU Library General
-Public License instead of this License.
-
---------------------------------------------------------------------------
-
 The following license details are part of `src/bdf/README`:
 
 ```

From 07d78002488063f29cd24e49dd38b5fc2f319989 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 19:08:45 +1000
Subject: [PATCH 1635/2374] Removed release notes update

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

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index ed41c21164c..de3db3c84fa 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -106,6 +106,5 @@ Pillow images can also be converted to Arrow objects::
 Reading and writing AVIF images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Pillow can now read and write AVIF images. However, due to concern over size, this
-functionality is not included in our prebuilt wheels. You will need to build Pillow
-from source with libavif 1.0.0 or later.
+Pillow can now read and write AVIF images. If you are building Pillow from source, this
+will require libavif 1.0.0 or later.

From 8dafc38371b99616d3fdcc926f4f5a1f7762ae3f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 19:24:35 +1000
Subject: [PATCH 1636/2374] Added 11.2.1 release notes

---
 docs/releasenotes/11.2.0.rst |  6 ++++++
 docs/releasenotes/11.2.1.rst | 11 +++++++++++
 docs/releasenotes/index.rst  |  1 +
 3 files changed, 18 insertions(+)
 create mode 100644 docs/releasenotes/11.2.1.rst

diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
index de3db3c84fa..3a7d618e4e5 100644
--- a/docs/releasenotes/11.2.0.rst
+++ b/docs/releasenotes/11.2.0.rst
@@ -1,6 +1,12 @@
 11.2.0
 ------
 
+.. warning::
+
+    The release of Pillow 11.2.0 was halted prematurely, due to concern over the size
+    of Pillow wheels containing libavif. Instead, Pillow 11.2.1 has been released,
+    without libavif included in the wheels.
+
 Security
 ========
 
diff --git a/docs/releasenotes/11.2.1.rst b/docs/releasenotes/11.2.1.rst
new file mode 100644
index 00000000000..7d9a4038268
--- /dev/null
+++ b/docs/releasenotes/11.2.1.rst
@@ -0,0 +1,11 @@
+11.2.1
+------
+
+Reading and writing AVIF images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The release of Pillow 11.2.0 was halted prematurely, due to concern over the size of
+Pillow wheels containing libavif.
+
+Instead, Pillow 11.2.1's wheels do not contain libavif. If you wish to read and write
+AVIF images, you will need to build Pillow from source with libavif 1.0.0 or later.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index be9f623d05d..0d159fc510d 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.2.1
   11.2.0
   11.1.0
   11.0.0

From 7a0092f2072a5deca433e2a6b752eced49e4ee16 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 12 Apr 2025 18:56:38 +0300
Subject: [PATCH 1637/2374] Remove incomplete 11.2.0 release, bill as 11.2.1
 instead

---
 docs/deprecations.rst                |   2 +-
 docs/handbook/image-file-formats.rst |   2 +-
 docs/reference/ImageDraw.rst         |   8 +-
 docs/reference/ImageGrab.rst         |   2 +-
 docs/releasenotes/11.2.0.rst         | 116 --------------------------
 docs/releasenotes/11.2.1.rst         | 117 +++++++++++++++++++++++++--
 docs/releasenotes/index.rst          |   1 -
 src/PIL/Image.py                     |   2 +-
 8 files changed, 120 insertions(+), 130 deletions(-)
 delete mode 100644 docs/releasenotes/11.2.0.rst

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 634cee6894c..7f8e76bccc5 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -186,7 +186,7 @@ ExifTags.IFD.Makernote
 Image.Image.get_child_images()
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. deprecated:: 11.2.0
+.. deprecated:: 11.2.1
 
 ``Image.Image.get_child_images()`` has been deprecated. and will be removed in Pillow
 13 (2026-10-15). It will be moved to ``ImageFile.ImageFile.get_child_images()``. The
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index bfa462c04c9..49431b3d095 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -170,7 +170,7 @@ DXT1 and DXT5 pixel formats can be read, only in ``RGBA`` mode.
    in ``P`` mode.
 
 
-.. versionadded:: 11.2.0
+.. versionadded:: 11.2.1
    DXT1, DXT3, DXT5, BC2, BC3 and BC5 pixel formats can be saved::
 
        im.save(out, pixel_format="DXT1")
diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index b2f1bdc9314..bd6f6b048ac 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -391,7 +391,7 @@ Methods
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
 
-                  .. versionadded:: 11.2.0 ``"justify"``
+                  .. versionadded:: 11.2.1 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -462,7 +462,7 @@ Methods
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
 
-                  .. versionadded:: 11.2.0 ``"justify"``
+                  .. versionadded:: 11.2.1 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -609,7 +609,7 @@ Methods
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
 
-                  .. versionadded:: 11.2.0 ``"justify"``
+                  .. versionadded:: 11.2.1 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
@@ -663,7 +663,7 @@ Methods
                   the relative alignment of lines. Use the ``anchor`` parameter to
                   specify the alignment to ``xy``.
 
-                  .. versionadded:: 11.2.0 ``"justify"``
+                  .. versionadded:: 11.2.1 ``"justify"``
     :param direction: Direction of the text. It can be ``"rtl"`` (right to
                       left), ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
                       Requires libraqm.
diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index d59ed0bd6fd..1e827a6764e 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -44,7 +44,7 @@ or the clipboard to a PIL image memory.
     :param window:
         HWND, to capture a single window. Windows only.
 
-        .. versionadded:: 11.2.0
+        .. versionadded:: 11.2.1
     :return: An image
 
 .. py:function:: grabclipboard()
diff --git a/docs/releasenotes/11.2.0.rst b/docs/releasenotes/11.2.0.rst
deleted file mode 100644
index 3a7d618e4e5..00000000000
--- a/docs/releasenotes/11.2.0.rst
+++ /dev/null
@@ -1,116 +0,0 @@
-11.2.0
-------
-
-.. warning::
-
-    The release of Pillow 11.2.0 was halted prematurely, due to concern over the size
-    of Pillow wheels containing libavif. Instead, Pillow 11.2.1 has been released,
-    without libavif included in the wheels.
-
-Security
-========
-
-Undefined shift when loading compressed DDS images
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-When loading some compressed DDS formats, an integer was bitshifted by 24 places to
-generate the 32 bits of the lookup table. This was undefined behaviour, and has been
-present since Pillow 3.4.0.
-
-Deprecations
-============
-
-Image.Image.get_child_images()
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. deprecated:: 11.2.0
-
-``Image.Image.get_child_images()`` has been deprecated. and will be removed in Pillow
-13 (2026-10-15). It will be moved to ``ImageFile.ImageFile.get_child_images()``. The
-method uses an image's file pointer, and so child images could only be retrieved from
-an :py:class:`PIL.ImageFile.ImageFile` instance.
-
-API Changes
-===========
-
-``append_images`` no longer requires ``save_all``
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Previously, ``save_all`` was required to in order to use ``append_images``. Now,
-``save_all`` will default to ``True`` if ``append_images`` is not empty and the format
-supports saving multiple frames::
-
-    im.save("out.gif", append_images=ims)
-
-API Additions
-=============
-
-``"justify"`` multiline text alignment
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-In addition to ``"left"``, ``"center"`` and ``"right"``, multiline text can also be
-aligned using ``"justify"`` in :py:mod:`~PIL.ImageDraw`::
-
-    from PIL import Image, ImageDraw
-    im = Image.new("RGB", (50, 25))
-    draw = ImageDraw.Draw(im)
-    draw.multiline_text((0, 0), "Multiline\ntext 1", align="justify")
-    draw.multiline_textbbox((0, 0), "Multiline\ntext 2", align="justify")
-
-Specify window in ImageGrab on Windows
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-When using :py:meth:`~PIL.ImageGrab.grab`, a specific window can be selected using the
-HWND::
-
-    from PIL import ImageGrab
-    ImageGrab.grab(window=hwnd)
-
-Check for MozJPEG
-^^^^^^^^^^^^^^^^^
-
-You can check if Pillow has been built against the MozJPEG version of the
-libjpeg library, and what version of MozJPEG is being used::
-
-    from PIL import features
-    features.check_feature("mozjpeg")  # True or False
-    features.version_feature("mozjpeg")  # "4.1.1" for example, or None
-
-Saving compressed DDS images
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Compressed DDS images can now be saved using a ``pixel_format`` argument. DXT1, DXT3,
-DXT5, BC2, BC3 and BC5 are supported::
-
-    im.save("out.dds", pixel_format="DXT1")
-
-Other Changes
-=============
-
-Arrow support
-^^^^^^^^^^^^^
-
-`Arrow <https://arrow.apache.org/>`__ is an in-memory data exchange format that is the
-spiritual successor to the NumPy array interface. It provides for zero-copy access to
-columnar data, which in our case is ``Image`` data.
-
-To create an image with zero-copy shared memory from an object exporting the
-arrow_c_array interface protocol::
-
-    from PIL import Image
-    import pyarrow as pa
-    arr = pa.array([0]*(5*5*4), type=pa.uint8())
-    im = Image.fromarrow(arr, 'RGBA', (5, 5))
-
-Pillow images can also be converted to Arrow objects::
-
-    from PIL import Image
-    import pyarrow as pa
-    im = Image.open('hopper.jpg')
-    arr = pa.array(im)
-
-Reading and writing AVIF images
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Pillow can now read and write AVIF images. If you are building Pillow from source, this
-will require libavif 1.0.0 or later.
diff --git a/docs/releasenotes/11.2.1.rst b/docs/releasenotes/11.2.1.rst
index 7d9a4038268..5c6d40d9df3 100644
--- a/docs/releasenotes/11.2.1.rst
+++ b/docs/releasenotes/11.2.1.rst
@@ -1,11 +1,118 @@
 11.2.1
 ------
 
+.. warning::
+
+   The release of Pillow *11.2.0* was halted prematurely, due to hitting PyPI's
+   project size limit and concern over the size of Pillow wheels containing libavif.
+   The PyPI limit has now been increased and Pillow *11.2.1* has been released
+   instead, without libavif included in the wheels.
+   To avoid confusion, the incomplete 11.2.0 release has been removed from PyPI.
+
+Security
+========
+
+Undefined shift when loading compressed DDS images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When loading some compressed DDS formats, an integer was bitshifted by 24 places to
+generate the 32 bits of the lookup table. This was undefined behaviour, and has been
+present since Pillow 3.4.0.
+
+Deprecations
+============
+
+Image.Image.get_child_images()
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.2.1
+
+``Image.Image.get_child_images()`` has been deprecated. and will be removed in Pillow
+13 (2026-10-15). It will be moved to ``ImageFile.ImageFile.get_child_images()``. The
+method uses an image's file pointer, and so child images could only be retrieved from
+an :py:class:`PIL.ImageFile.ImageFile` instance.
+
+API Changes
+===========
+
+``append_images`` no longer requires ``save_all``
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Previously, ``save_all`` was required to in order to use ``append_images``. Now,
+``save_all`` will default to ``True`` if ``append_images`` is not empty and the format
+supports saving multiple frames::
+
+    im.save("out.gif", append_images=ims)
+
+API Additions
+=============
+
+``"justify"`` multiline text alignment
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In addition to ``"left"``, ``"center"`` and ``"right"``, multiline text can also be
+aligned using ``"justify"`` in :py:mod:`~PIL.ImageDraw`::
+
+    from PIL import Image, ImageDraw
+    im = Image.new("RGB", (50, 25))
+    draw = ImageDraw.Draw(im)
+    draw.multiline_text((0, 0), "Multiline\ntext 1", align="justify")
+    draw.multiline_textbbox((0, 0), "Multiline\ntext 2", align="justify")
+
+Specify window in ImageGrab on Windows
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When using :py:meth:`~PIL.ImageGrab.grab`, a specific window can be selected using the
+HWND::
+
+    from PIL import ImageGrab
+    ImageGrab.grab(window=hwnd)
+
+Check for MozJPEG
+^^^^^^^^^^^^^^^^^
+
+You can check if Pillow has been built against the MozJPEG version of the
+libjpeg library, and what version of MozJPEG is being used::
+
+    from PIL import features
+    features.check_feature("mozjpeg")  # True or False
+    features.version_feature("mozjpeg")  # "4.1.1" for example, or None
+
+Saving compressed DDS images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Compressed DDS images can now be saved using a ``pixel_format`` argument. DXT1, DXT3,
+DXT5, BC2, BC3 and BC5 are supported::
+
+    im.save("out.dds", pixel_format="DXT1")
+
+Other Changes
+=============
+
+Arrow support
+^^^^^^^^^^^^^
+
+`Arrow <https://arrow.apache.org/>`__ is an in-memory data exchange format that is the
+spiritual successor to the NumPy array interface. It provides for zero-copy access to
+columnar data, which in our case is ``Image`` data.
+
+To create an image with zero-copy shared memory from an object exporting the
+arrow_c_array interface protocol::
+
+    from PIL import Image
+    import pyarrow as pa
+    arr = pa.array([0]*(5*5*4), type=pa.uint8())
+    im = Image.fromarrow(arr, 'RGBA', (5, 5))
+
+Pillow images can also be converted to Arrow objects::
+
+    from PIL import Image
+    import pyarrow as pa
+    im = Image.open('hopper.jpg')
+    arr = pa.array(im)
+
 Reading and writing AVIF images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The release of Pillow 11.2.0 was halted prematurely, due to concern over the size of
-Pillow wheels containing libavif.
-
-Instead, Pillow 11.2.1's wheels do not contain libavif. If you wish to read and write
-AVIF images, you will need to build Pillow from source with libavif 1.0.0 or later.
+Pillow can now read and write AVIF images when built from source with libavif 1.0.0
+or later.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 0d159fc510d..a116ef056a7 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -15,7 +15,6 @@ expected to be backported to earlier versions.
   :maxdepth: 2
 
   11.2.1
-  11.2.0
   11.1.0
   11.0.0
   10.4.0
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 88ea6f3b53e..ded40bc5ddc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3362,7 +3362,7 @@ def fromarrow(
 
     See: :ref:`arrow-support` for more detailed information
 
-    .. versionadded:: 11.2.0
+    .. versionadded:: 11.2.1
 
     """
     if not hasattr(obj, "__arrow_c_array__"):

From 339bc5db93bd95decf65a59fab273f300db6594d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 12 Apr 2025 19:55:46 +0300
Subject: [PATCH 1638/2374] 11.2.1 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 e93c7887b80..9380e992753 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.2.0.dev0"
+__version__ = "11.2.1"

From f9083264ff561389ee5931598df9bffe269db504 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 12 Apr 2025 20:56:35 +0300
Subject: [PATCH 1639/2374] 11.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 9380e992753..ac678c7d26e 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.2.1"
+__version__ = "11.3.0.dev0"

From 529402143826732973463104000fd91d0a271103 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 3 Apr 2025 12:09:46 +1100
Subject: [PATCH 1640/2374] Removed Fedora 40

---
 .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 25aef55fb13..9e42ed884ae 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -47,7 +47,6 @@ jobs:
           centos-stream-10-amd64,
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
-          fedora-40-amd64,
           fedora-41-amd64,
           gentoo,
           ubuntu-22.04-jammy-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 9eafad3c4b7..36b9a7bddfc 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -31,8 +31,6 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
 +----------------------------------+----------------------------+---------------------+
-| Fedora 40                        | 3.12                       | x86-64              |
-+----------------------------------+----------------------------+---------------------+
 | Fedora 41                        | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |

From c6434dbbbc667d42ad236aa2eeb407a44bbd2174 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 13 Apr 2025 23:00:06 +1000
Subject: [PATCH 1641/2374] Set color table fourth channel to zero for 1 and L
 mode when saving

---
 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 43131cfe2fa..54fc69ab454 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -445,9 +445,9 @@ def _save(
     image = stride * im.size[1]
 
     if im.mode == "1":
-        palette = b"".join(o8(i) * 4 for i in (0, 255))
+        palette = b"".join(o8(i) * 3 + b"\x00" for i in (0, 255))
     elif im.mode == "L":
-        palette = b"".join(o8(i) * 4 for i in range(256))
+        palette = b"".join(o8(i) * 3 + b"\x00" for i in range(256))
     elif im.mode == "P":
         palette = im.im.getpalette("RGB", "BGRX")
         colors = len(palette) // 4

From 4716bb78189108ceffcc80db226fe099cca20448 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 13 Apr 2025 23:59:05 +1000
Subject: [PATCH 1642/2374] Update macOS tested Pillow versions (#8890)

---
 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 36b9a7bddfc..ca810dc2ad3 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -71,7 +71,7 @@ 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.9, 3.10, 3.11, 3.12, 3.13| 11.1.0           |arm           |
+| macOS 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13| 11.2.1           |arm           |
 |                                  +----------------------------+------------------+              |
 |                                  | 3.8                        | 10.4.0           |              |
 +----------------------------------+----------------------------+------------------+--------------+

From 8b1777b9997a48cd59a3bddd888bebddd8adc6de Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Mon, 14 Apr 2025 14:51:01 -0400
Subject: [PATCH 1643/2374] Move XV Thumbnails to read only section

---
 docs/handbook/image-file-formats.rst | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 49431b3d095..46fe8b630db 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1664,6 +1664,11 @@ The :py:meth:`~PIL.Image.open` method sets the following
     Transparency color index. This key is omitted if the image is not
     transparent.
 
+XV Thumbnails
+^^^^^^^^^^^^^
+
+Pillow can read XV thumbnail files.
+
 Write-only formats
 ------------------
 
@@ -1769,11 +1774,6 @@ The :py:meth:`~PIL.Image.Image.save` method can take the following keyword argum
 
     .. versionadded:: 5.3.0
 
-XV Thumbnails
-^^^^^^^^^^^^^
-
-Pillow can read XV thumbnail files.
-
 Identify-only formats
 ---------------------
 

From 507fefbce4c3b8c46c6c21483d488884f1b5a8e1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 15 Apr 2025 21:02:35 +1000
Subject: [PATCH 1644/2374] Python 3.13 is tested on Arch (#8894)

---
 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 ca810dc2ad3..d5634b384a5 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -23,7 +23,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Amazon Linux 2023                | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Arch                             | 3.12                       | x86-64              |
+| Arch                             | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | CentOS Stream 9                  | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+

From 6ea7dc8eeafaf7528d2817bdd443de367eca2940 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 16 Apr 2025 17:06:52 +1000
Subject: [PATCH 1645/2374] Add Fedora 42 (#8899)

---
 .github/workflows/test-docker.yml      | 1 +
 docs/installation/platform-support.rst | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 9e42ed884ae..0b90732eba7 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -48,6 +48,7 @@ jobs:
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
           fedora-41-amd64,
+          fedora-42-amd64,
           gentoo,
           ubuntu-22.04-jammy-amd64,
           ubuntu-24.04-noble-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index d5634b384a5..d751620fd2b 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -33,6 +33,8 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Fedora 41                        | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
+| Fedora 42                        | 3.13                       | x86-64              |
++----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 13 Ventura                 | 3.9                        | x86-64              |

From f630ec097b4d5d2a132d4ade5e5b903452bf27d8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 16 Apr 2025 21:05:08 +1000
Subject: [PATCH 1646/2374] Build Windows arm64 wheels on arm64 runner (#8898)

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

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 40d3dc7e882..33e1976f096 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -121,14 +121,17 @@ jobs:
   windows:
     if: github.event_name != 'schedule' || github.repository_owner == 'python-pillow'
     name: Windows ${{ matrix.cibw_arch }}
-    runs-on: windows-latest
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         include:
           - cibw_arch: x86
+            os: windows-latest
           - cibw_arch: AMD64
+            os: windows-latest
           - cibw_arch: ARM64
+            os: windows-11-arm
     steps:
       - uses: actions/checkout@v4
         with:

From 3d4119521c853e1014012f73fdf9b2a8dc137722 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 17 Apr 2025 01:49:57 +1000
Subject: [PATCH 1647/2374] Close file pointer earlier (#8895)

---
 Tests/test_file_bmp.py           | 12 ++++++------
 Tests/test_file_jpeg2k.py        |  4 ++--
 Tests/test_file_libtiff.py       | 12 ++++++------
 Tests/test_file_libtiff_small.py |  2 +-
 4 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 7576507118b..746b2e18061 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -190,9 +190,9 @@ def test_rle8() -> None:
     # Signal end of bitmap before the image is finished
     with open("Tests/images/bmp/g/pal8rle.bmp", "rb") as fp:
         data = fp.read(1063) + b"\x01"
-        with Image.open(io.BytesIO(data)) as im:
-            with pytest.raises(ValueError):
-                im.load()
+    with Image.open(io.BytesIO(data)) as im:
+        with pytest.raises(ValueError):
+            im.load()
 
 
 def test_rle4() -> None:
@@ -214,9 +214,9 @@ def test_rle4() -> 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:
-            with pytest.raises(ValueError):
-                im.load()
+    with Image.open(io.BytesIO(data)) as im:
+        with pytest.raises(ValueError):
+            im.load()
 
 
 def test_offset() -> None:
diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 4095bfaf2c5..a5365a90d44 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -457,8 +457,8 @@ def test_comment() -> None:
     # Test an image that is truncated partway through a codestream
     with open("Tests/images/comment.jp2", "rb") as fp:
         b = BytesIO(fp.read(130))
-        with Image.open(b) as im:
-            pass
+    with Image.open(b) as im:
+        pass
 
 
 def test_save_comment(card: ImageFile.ImageFile) -> None:
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 9916215fb95..1ec39eba588 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -81,7 +81,7 @@ def test_g4_tiff_bytesio(self, tmp_path: Path) -> None:
         s = io.BytesIO()
         with open(test_file, "rb") as f:
             s.write(f.read())
-            s.seek(0)
+        s.seek(0)
         with Image.open(s) as im:
             assert im.size == (500, 500)
             self._assert_noerr(tmp_path, im)
@@ -1050,12 +1050,12 @@ def test_old_style_jpeg_orientation(self) -> None:
         with open("Tests/images/old-style-jpeg-compression.tif", "rb") as fp:
             data = fp.read()
 
-            # Set EXIF Orientation to 2
-            data = data[:102] + b"\x02" + data[103:]
+        # Set EXIF Orientation to 2
+        data = data[:102] + b"\x02" + data[103:]
 
-            with Image.open(io.BytesIO(data)) as im:
-                im = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
-            assert_image_equal_tofile(im, "Tests/images/old-style-jpeg-compression.png")
+        with Image.open(io.BytesIO(data)) as im:
+            im = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
+        assert_image_equal_tofile(im, "Tests/images/old-style-jpeg-compression.png")
 
     def test_open_missing_samplesperpixel(self) -> None:
         with Image.open(
diff --git a/Tests/test_file_libtiff_small.py b/Tests/test_file_libtiff_small.py
index 617e1e89c72..65ba80c2076 100644
--- a/Tests/test_file_libtiff_small.py
+++ b/Tests/test_file_libtiff_small.py
@@ -32,7 +32,7 @@ def test_g4_hopper_bytesio(self, tmp_path: Path) -> None:
         s = BytesIO()
         with open(test_file, "rb") as f:
             s.write(f.read())
-            s.seek(0)
+        s.seek(0)
         with Image.open(s) as im:
             assert im.size == (128, 128)
             self._assert_noerr(tmp_path, im)

From ccc4668d4ed27754a09f819462732dc42c584fc0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Apr 2025 08:04:34 +1000
Subject: [PATCH 1648/2374] Updated harfbuzz to 11.1.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 0df22c4cbe9..d53cf059bab 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,7 +38,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=11.0.1
+HARFBUZZ_VERSION=11.1.0
 LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 3e75c141105..17fc37572e8 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.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "11.0.1",
+    "HARFBUZZ": "11.1.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.17",
     "LIBAVIF": "1.2.1",

From cccc07269ae60226f0bb6475970d6fab255538b4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Apr 2025 19:23:24 +1000
Subject: [PATCH 1649/2374] Do not justify a single word

---
 .../multiline_text_justify_single_word.png    | Bin 0 -> 2436 bytes
 Tests/test_imagefont.py                       |  12 ++++++
 src/PIL/ImageDraw.py                          |  36 +++++++++---------
 3 files changed, 31 insertions(+), 17 deletions(-)
 create mode 100644 Tests/images/multiline_text_justify_single_word.png

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

literal 0
HcmV?d00001

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 69533c2f840..a6a8cdfc676 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -267,6 +267,18 @@ def test_render_multiline_text_align(
     assert_image_similar_tofile(im, f"Tests/images/multiline_text{ext}.png", 0.01)
 
 
+def test_render_multiline_text_align_justify_single_word(
+    font: ImageFont.FreeTypeFont,
+) -> None:
+    im = Image.new("RGB", (185, 65))
+    draw = ImageDraw.Draw(im)
+    draw.multiline_text(
+        (0, 0), "hey you\nyou are awesome\nthis", font=font, align="justify"
+    )
+
+    assert_image_equal_tofile(im, "Tests/images/multiline_text_justify_single_word.png")
+
+
 def test_unknown_align(font: ImageFont.FreeTypeFont) -> None:
     im = Image.new(mode="RGB", size=(300, 100))
     draw = ImageDraw.Draw(im)
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index e6c7b029830..e865f451631 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -772,24 +772,26 @@ def _prepare_multiline_text(
 
             if align == "justify" and width_difference != 0:
                 words = line.split(" " if isinstance(text, str) else b" ")
-                word_widths = [
-                    self.textlength(
-                        word,
-                        font,
-                        direction=direction,
-                        features=features,
-                        language=language,
-                        embedded_color=embedded_color,
-                    )
-                    for word in words
-                ]
-                width_difference = max_width - sum(word_widths)
-                for i, word in enumerate(words):
-                    parts.append(((left, top), word))
-                    left += word_widths[i] + width_difference / (len(words) - 1)
-            else:
-                parts.append(((left, top), line))
+                if len(words) > 1:
+                    word_widths = [
+                        self.textlength(
+                            word,
+                            font,
+                            direction=direction,
+                            features=features,
+                            language=language,
+                            embedded_color=embedded_color,
+                        )
+                        for word in words
+                    ]
+                    width_difference = max_width - sum(word_widths)
+                    for i, word in enumerate(words):
+                        parts.append(((left, top), word))
+                        left += word_widths[i] + width_difference / (len(words) - 1)
+                    top += line_spacing
+                    continue
 
+            parts.append(((left, top), line))
             top += line_spacing
 
         return font, anchor, parts

From b955cee725da2613b34145eea56227c57ec414d4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Apr 2025 19:36:52 +1000
Subject: [PATCH 1650/2374] Do not justify last line

---
 .../images/multiline_text_justify_last_line.png  | Bin 0 -> 3581 bytes
 .../multiline_text_justify_single_word.png       | Bin 2436 -> 0 bytes
 Tests/test_imagefont.py                          |  11 +++++++----
 src/PIL/ImageDraw.py                             |   2 +-
 4 files changed, 8 insertions(+), 5 deletions(-)
 create mode 100644 Tests/images/multiline_text_justify_last_line.png
 delete mode 100644 Tests/images/multiline_text_justify_single_word.png

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

literal 0
HcmV?d00001

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

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

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index a6a8cdfc676..f99275925aa 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -267,16 +267,19 @@ def test_render_multiline_text_align(
     assert_image_similar_tofile(im, f"Tests/images/multiline_text{ext}.png", 0.01)
 
 
-def test_render_multiline_text_align_justify_single_word(
+def test_render_multiline_text_align_justify_last_line(
     font: ImageFont.FreeTypeFont,
 ) -> None:
-    im = Image.new("RGB", (185, 65))
+    im = Image.new("RGB", (280, 60))
     draw = ImageDraw.Draw(im)
     draw.multiline_text(
-        (0, 0), "hey you\nyou are awesome\nthis", font=font, align="justify"
+        (0, 0),
+        "hey you you are awesome\nthis\nlooks awkward",
+        font=font,
+        align="justify",
     )
 
-    assert_image_equal_tofile(im, "Tests/images/multiline_text_justify_single_word.png")
+    assert_image_equal_tofile(im, "Tests/images/multiline_text_justify_last_line.png")
 
 
 def test_unknown_align(font: ImageFont.FreeTypeFont) -> None:
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index e865f451631..47ae575c9e6 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -770,7 +770,7 @@ def _prepare_multiline_text(
                 msg = 'align must be "left", "center", "right" or "justify"'
                 raise ValueError(msg)
 
-            if align == "justify" and width_difference != 0:
+            if align == "justify" and width_difference != 0 and idx != len(lines) - 1:
                 words = line.split(" " if isinstance(text, str) else b" ")
                 if len(words) > 1:
                     word_widths = [

From bc05a88ce664dff5eee1bb024e4922d86ad86f96 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Apr 2025 20:56:02 +1000
Subject: [PATCH 1651/2374] Anchor left when justifying words

---
 .../images/multiline_text_justify_anchor.png  | Bin 0 -> 11282 bytes
 .../multiline_text_justify_last_line.png      | Bin 3581 -> 0 bytes
 Tests/test_imagefont.py                       |  20 +++++-----
 src/PIL/ImageDraw.py                          |  37 ++++++++++--------
 4 files changed, 32 insertions(+), 25 deletions(-)
 create mode 100644 Tests/images/multiline_text_justify_anchor.png
 delete mode 100644 Tests/images/multiline_text_justify_last_line.png

diff --git a/Tests/images/multiline_text_justify_anchor.png b/Tests/images/multiline_text_justify_anchor.png
new file mode 100644
index 0000000000000000000000000000000000000000..6d3fb421d1832e82dcfba255891240cf2aa5b92d
GIT binary patch
literal 11282
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
HzUTh}m8~Dn

literal 0
HcmV?d00001

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

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

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index f99275925aa..fd622c945de 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -267,19 +267,21 @@ def test_render_multiline_text_align(
     assert_image_similar_tofile(im, f"Tests/images/multiline_text{ext}.png", 0.01)
 
 
-def test_render_multiline_text_align_justify_last_line(
+def test_render_multiline_text_justify_anchor(
     font: ImageFont.FreeTypeFont,
 ) -> None:
-    im = Image.new("RGB", (280, 60))
+    im = Image.new("RGB", (280, 240))
     draw = ImageDraw.Draw(im)
-    draw.multiline_text(
-        (0, 0),
-        "hey you you are awesome\nthis\nlooks awkward",
-        font=font,
-        align="justify",
-    )
+    for xy, anchor in (((0, 0), "la"), ((140, 80), "ma"), ((280, 160), "ra")):
+        draw.multiline_text(
+            xy,
+            "hey you you are awesome\nthis looks awkward\nthis\nlooks awkward",
+            font=font,
+            anchor=anchor,
+            align="justify",
+        )
 
-    assert_image_equal_tofile(im, "Tests/images/multiline_text_justify_last_line.png")
+    assert_image_equal_tofile(im, "Tests/images/multiline_text_justify_anchor.png")
 
 
 def test_unknown_align(font: ImageFont.FreeTypeFont) -> None:
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 47ae575c9e6..d35cda6024d 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -702,8 +702,7 @@ def _prepare_multiline_text(
         font_size: float | None,
     ) -> tuple[
         ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont,
-        str,
-        list[tuple[tuple[float, float], AnyStr]],
+        list[tuple[tuple[float, float], str, AnyStr]],
     ]:
         if direction == "ttb":
             msg = "ttb direction is unsupported for multiline text"
@@ -753,13 +752,7 @@ def _prepare_multiline_text(
             left = xy[0]
             width_difference = max_width - widths[idx]
 
-            # first align left by anchor
-            if anchor[0] == "m":
-                left -= width_difference / 2.0
-            elif anchor[0] == "r":
-                left -= width_difference
-
-            # then align by align parameter
+            # align by align parameter
             if align in ("left", "justify"):
                 pass
             elif align == "center":
@@ -773,6 +766,12 @@ def _prepare_multiline_text(
             if align == "justify" and width_difference != 0 and idx != len(lines) - 1:
                 words = line.split(" " if isinstance(text, str) else b" ")
                 if len(words) > 1:
+                    # align left by anchor
+                    if anchor[0] == "m":
+                        left -= max_width / 2.0
+                    elif anchor[0] == "r":
+                        left -= max_width
+
                     word_widths = [
                         self.textlength(
                             word,
@@ -784,17 +783,23 @@ def _prepare_multiline_text(
                         )
                         for word in words
                     ]
+                    word_anchor = "l" + anchor[1]
                     width_difference = max_width - sum(word_widths)
                     for i, word in enumerate(words):
-                        parts.append(((left, top), word))
+                        parts.append(((left, top), word_anchor, word))
                         left += word_widths[i] + width_difference / (len(words) - 1)
                     top += line_spacing
                     continue
 
-            parts.append(((left, top), line))
+            # align left by anchor
+            if anchor[0] == "m":
+                left -= width_difference / 2.0
+            elif anchor[0] == "r":
+                left -= width_difference
+            parts.append(((left, top), anchor, line))
             top += line_spacing
 
-        return font, anchor, parts
+        return font, parts
 
     def multiline_text(
         self,
@@ -819,7 +824,7 @@ def multiline_text(
         *,
         font_size: float | None = None,
     ) -> None:
-        font, anchor, lines = self._prepare_multiline_text(
+        font, lines = self._prepare_multiline_text(
             xy,
             text,
             font,
@@ -834,7 +839,7 @@ def multiline_text(
             font_size,
         )
 
-        for xy, line in lines:
+        for xy, anchor, line in lines:
             self.text(
                 xy,
                 line,
@@ -949,7 +954,7 @@ def multiline_textbbox(
         *,
         font_size: float | None = None,
     ) -> tuple[float, float, float, float]:
-        font, anchor, lines = self._prepare_multiline_text(
+        font, lines = self._prepare_multiline_text(
             xy,
             text,
             font,
@@ -966,7 +971,7 @@ def multiline_textbbox(
 
         bbox: tuple[float, float, float, float] | None = None
 
-        for xy, line in lines:
+        for xy, anchor, line in lines:
             bbox_line = self.textbbox(
                 xy,
                 line,

From 3d77723a0c9d245f61e124c58a11e3a1779b3c0d Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Thu, 17 Apr 2025 21:42:42 +0100
Subject: [PATCH 1652/2374] Added arrow support for a flat array of 4*uint8 for
 image32 modes

---
 Tests/test_pyarrow.py    | 66 +++++++++++++++++++++++++++++++++++++---
 src/libImaging/Storage.c | 14 +++++++++
 2 files changed, 75 insertions(+), 5 deletions(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index ece9f8f2657..e7f2bc5f909 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -18,18 +18,25 @@
 
 
 def _test_img_equals_pyarray(
-    img: Image.Image, arr: Any, mask: list[int] | None
+    img: Image.Image, arr: Any, mask: list[int] | None, elts_per_pixel: int = 1
 ) -> None:
-    assert img.height * img.width == len(arr)
+    assert img.height * img.width * elts_per_pixel == len(arr)
     px = img.load()
     assert px is not None
+    if elts_per_pixel > 1 and mask is None:
+        # have to do element wise comparison when we're comparing
+        # flattened r,g,b,a to a pixel.
+        mask = list(range(elts_per_pixel))
     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)):
             if mask:
+                pixel = px[x, y]
+                assert isinstance(pixel, tuple)
                 for ix, elt in enumerate(mask):
-                    pixel = px[x, y]
-                    assert isinstance(pixel, tuple)
-                    assert pixel[ix] == arr[y * img.width + x].as_py()[elt]
+                    if elts_per_pixel == 1:
+                        assert pixel[ix] == arr[y * img.width + x].as_py()[elt]
+                    else:
+                        assert pixel[ix] == arr[(y * img.width + x) * elts_per_pixel + elt].as_py()
             else:
                 assert_deep_equal(px[x, y], arr[y * img.width + x].as_py())
 
@@ -110,3 +117,52 @@ def test_lifetime2() -> None:
     px = img2.load()
     assert px  # make mypy happy
     assert isinstance(px[0, 0], int)
+
+
+UINT_ARR = (
+    fl_uint8_4_type,
+    [1,2,3,4],
+    1
+)
+UINT = (
+    pyarrow.uint8(),
+    3,
+    4
+)
+
+
+
+@pytest.mark.parametrize(
+    "mode, data_tp, mask",
+    (
+        ("L", (pyarrow.uint8(), 3, 1), None),
+        ("I", (pyarrow.int32(), 1<<24, 1), None),
+        ("F", (pyarrow.float32(), 3.14159, 1), None),
+        ("LA", UINT_ARR, [0, 3]),
+        ("LA", UINT, [0, 3]),
+        ("RGB", UINT_ARR, [0, 1, 2]),
+        ("RGBA", UINT_ARR, None),
+        ("RGBA", UINT_ARR, None),
+        ("CMYK", UINT_ARR, None),
+        ("YCbCr", UINT_ARR,  [0, 1, 2]),
+        ("HSV", UINT_ARR,  [0, 1, 2]),
+        ("RGB", UINT, [0, 1, 2]),
+        ("RGBA", UINT, None),
+        ("RGBA", UINT, None),
+        ("CMYK", UINT, None),
+        ("YCbCr", UINT,  [0, 1, 2]),
+        ("HSV", UINT,  [0, 1, 2]),
+    ),
+)
+def test_fromarray(mode: str,
+                   data_tp: tuple,
+                   mask:list[int] | None) -> None:
+    (dtype,
+     elt,
+     elts_per_pixel) = data_tp
+
+    ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
+    arr = pyarrow.array([elt]*(ct_pixels*elts_per_pixel), type=dtype)
+    img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
+
+    _test_img_equals_pyarray(img, arr, mask, elts_per_pixel)
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 4fa4ecd1ce4..7f8d9c4a044 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -723,6 +723,8 @@ ImagingNewArrow(
     int64_t pixels = (int64_t)xsize * (int64_t)ysize;
 
     // fmt:off   // don't reformat this
+    // stored as a single array, one element per pixel, either single band
+    // or multiband, where each pixel is an I32.
     if (((strcmp(schema->format, "I") == 0  // int32
           && im->pixelsize == 4             // 4xchar* storage
           && im->bands >= 2)                // INT32 into any INT32 Storage mode
@@ -735,6 +737,7 @@ ImagingNewArrow(
             return im;
         }
     }
+    // Stored as [[r,g,b,a],....]
     if (strcmp(schema->format, "+w:4") == 0  // 4 up array
         && im->pixelsize == 4                // storage as 32 bpc
         && schema->n_children > 0            // make sure schema is well formed.
@@ -750,6 +753,17 @@ ImagingNewArrow(
             return im;
         }
     }
+    // Stored as [r,g,b,a,r,g,b,a....]
+    if (strcmp(schema->format, "C") == 0  // uint8
+        && im->pixelsize == 4                // storage as 32 bpc
+        && schema->n_children == 0            // make sure schema is well formed.
+        && strcmp(im->arrow_band_format, "C") == 0        // Expected Format
+        && 4* pixels == external_array->length) {         // expected length
+        // single flat array, interleaved storage.
+        if (ImagingBorrowArrow(im, external_array, 1, array_capsule)) {
+            return im;
+        }
+    }
     // fmt: on
     ImagingDelete(im);
     return NULL;

From c729d4e2085b96662b89ad09f99327f4516ce4ed Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Thu, 17 Apr 2025 22:16:27 +0100
Subject: [PATCH 1653/2374] Test uint32 array creation -> image32 images

---
 Tests/test_pyarrow.py | 61 ++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 60 insertions(+), 1 deletion(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index e7f2bc5f909..92bc4c807e4 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -9,6 +9,7 @@
 from .helper import (
     assert_deep_equal,
     assert_image_equal,
+    is_big_endian,
     hopper,
 )
 
@@ -41,6 +42,34 @@ def _test_img_equals_pyarray(
                 assert_deep_equal(px[x, y], arr[y * img.width + x].as_py())
 
 
+def _test_img_equals_int32_pyarray(
+    img: Image.Image, arr: Any, mask: list[int] | None, elts_per_pixel: int = 1
+) -> None:
+    assert img.height * img.width * elts_per_pixel == len(arr)
+    px = img.load()
+    assert px is not None
+    if mask is None:
+        # have to do element wise comparison when we're comparing
+        # flattened rgba in an uint32 to a pixel.
+        mask = list(range(elts_per_pixel))
+    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)):
+            pixel = px[x, y]
+            assert isinstance(pixel, tuple)
+            arr_pixel_int = arr[y * img.width + x].as_py()
+            arr_pixel_tuple = (
+                arr_pixel_int % 256,
+                (arr_pixel_int // 256) % 256,
+                (arr_pixel_int // 256**2) % 256,
+                (arr_pixel_int // 256**3),
+            )
+            if is_big_endian():
+                arr_pixel_tuple = arr_pixel_tuple[::-1]
+
+            for ix, elt in enumerate(mask):
+                assert pixel[ix] == arr_pixel_tuple[elt]
+
+
 # really hard to get a non-nullable list type
 fl_uint8_4_type = pyarrow.field(
     "_", pyarrow.list_(pyarrow.field("_", pyarrow.uint8()).with_nullable(False), 4)
@@ -129,7 +158,11 @@ def test_lifetime2() -> None:
     3,
     4
 )
-
+INT32 = (
+    pyarrow.uint32(),
+    0xabcdef45,
+    1
+)
 
 
 @pytest.mark.parametrize(
@@ -166,3 +199,29 @@ def test_fromarray(mode: str,
     img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
 
     _test_img_equals_pyarray(img, arr, mask, elts_per_pixel)
+
+
+@pytest.mark.parametrize(
+    "mode, data_tp, mask",
+    (
+        ("LA", INT32, [0, 3]),
+        ("RGB", INT32, [0, 1, 2]),
+        ("RGBA", INT32, None),
+        ("RGBA", INT32, None),
+        ("CMYK", INT32, None),
+        ("YCbCr", INT32,  [0, 1, 2]),
+        ("HSV", INT32,  [0, 1, 2]),
+    ),
+)
+def test_from_int32array(mode: str,
+                         data_tp: tuple,
+                         mask:list[int] | None) -> None:
+    (dtype,
+     elt,
+     elts_per_pixel) = data_tp
+
+    ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
+    arr = pyarrow.array([elt]*(ct_pixels*elts_per_pixel), type=dtype)
+    img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
+
+    _test_img_equals_int32_pyarray(img, arr, mask, elts_per_pixel)

From ac500460dfc6ddaa7c0660de3f0233d05e207852 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Thu, 17 Apr 2025 22:22:31 +0100
Subject: [PATCH 1654/2374] lint

---
 Tests/test_pyarrow.py    | 44 ++++++++++++++++------------------------
 src/libImaging/Storage.c | 10 ++++-----
 2 files changed, 23 insertions(+), 31 deletions(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index 92bc4c807e4..bcdd7ddc9d0 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -9,8 +9,8 @@
 from .helper import (
     assert_deep_equal,
     assert_image_equal,
-    is_big_endian,
     hopper,
+    is_big_endian,
 )
 
 pyarrow = pytest.importorskip("pyarrow", reason="PyArrow not installed")
@@ -37,7 +37,10 @@ def _test_img_equals_pyarray(
                     if elts_per_pixel == 1:
                         assert pixel[ix] == arr[y * img.width + x].as_py()[elt]
                     else:
-                        assert pixel[ix] == arr[(y * img.width + x) * elts_per_pixel + elt].as_py()
+                        assert (
+                            pixel[ix]
+                            == arr[(y * img.width + x) * elts_per_pixel + elt].as_py()
+                        )
             else:
                 assert_deep_equal(px[x, y], arr[y * img.width + x].as_py())
 
@@ -169,33 +172,27 @@ def test_lifetime2() -> None:
     "mode, data_tp, mask",
     (
         ("L", (pyarrow.uint8(), 3, 1), None),
-        ("I", (pyarrow.int32(), 1<<24, 1), None),
+        ("I", (pyarrow.int32(), 1 << 24, 1), None),
         ("F", (pyarrow.float32(), 3.14159, 1), None),
         ("LA", UINT_ARR, [0, 3]),
         ("LA", UINT, [0, 3]),
         ("RGB", UINT_ARR, [0, 1, 2]),
         ("RGBA", UINT_ARR, None),
-        ("RGBA", UINT_ARR, None),
         ("CMYK", UINT_ARR, None),
-        ("YCbCr", UINT_ARR,  [0, 1, 2]),
-        ("HSV", UINT_ARR,  [0, 1, 2]),
+        ("YCbCr", UINT_ARR, [0, 1, 2]),
+        ("HSV", UINT_ARR, [0, 1, 2]),
         ("RGB", UINT, [0, 1, 2]),
         ("RGBA", UINT, None),
-        ("RGBA", UINT, None),
         ("CMYK", UINT, None),
-        ("YCbCr", UINT,  [0, 1, 2]),
-        ("HSV", UINT,  [0, 1, 2]),
+        ("YCbCr", UINT, [0, 1, 2]),
+        ("HSV", UINT, [0, 1, 2]),
     ),
 )
-def test_fromarray(mode: str,
-                   data_tp: tuple,
-                   mask:list[int] | None) -> None:
-    (dtype,
-     elt,
-     elts_per_pixel) = data_tp
+def test_fromarray(mode: str, data_tp: tuple, mask: list[int] | None) -> None:
+    (dtype, elt, elts_per_pixel) = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
-    arr = pyarrow.array([elt]*(ct_pixels*elts_per_pixel), type=dtype)
+    arr = pyarrow.array([elt] * (ct_pixels * elts_per_pixel), type=dtype)
     img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
 
     _test_img_equals_pyarray(img, arr, mask, elts_per_pixel)
@@ -207,21 +204,16 @@ def test_fromarray(mode: str,
         ("LA", INT32, [0, 3]),
         ("RGB", INT32, [0, 1, 2]),
         ("RGBA", INT32, None),
-        ("RGBA", INT32, None),
         ("CMYK", INT32, None),
-        ("YCbCr", INT32,  [0, 1, 2]),
-        ("HSV", INT32,  [0, 1, 2]),
+        ("YCbCr", INT32, [0, 1, 2]),
+        ("HSV", INT32, [0, 1, 2]),
     ),
 )
-def test_from_int32array(mode: str,
-                         data_tp: tuple,
-                         mask:list[int] | None) -> None:
-    (dtype,
-     elt,
-     elts_per_pixel) = data_tp
+def test_from_int32array(mode: str, data_tp: tuple, mask: list[int] | None) -> None:
+    (dtype, elt, elts_per_pixel) = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
-    arr = pyarrow.array([elt]*(ct_pixels*elts_per_pixel), type=dtype)
+    arr = pyarrow.array([elt] * (ct_pixels * elts_per_pixel), type=dtype)
     img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
 
     _test_img_equals_int32_pyarray(img, arr, mask, elts_per_pixel)
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 7f8d9c4a044..2c57165c1e7 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -754,11 +754,11 @@ ImagingNewArrow(
         }
     }
     // Stored as [r,g,b,a,r,g,b,a....]
-    if (strcmp(schema->format, "C") == 0  // uint8
-        && im->pixelsize == 4                // storage as 32 bpc
-        && schema->n_children == 0            // make sure schema is well formed.
-        && strcmp(im->arrow_band_format, "C") == 0        // Expected Format
-        && 4* pixels == external_array->length) {         // expected length
+    if (strcmp(schema->format, "C") == 0            // uint8
+        && im->pixelsize == 4                       // storage as 32 bpc
+        && schema->n_children == 0                  // make sure schema is well formed.
+        && strcmp(im->arrow_band_format, "C") == 0  // Expected Format
+        && 4 * pixels == external_array->length) {  // expected length
         // single flat array, interleaved storage.
         if (ImagingBorrowArrow(im, external_array, 1, array_capsule)) {
             return im;

From 00ae9dda35e512e3bdfa69daff1625fd006cff21 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 18 Apr 2025 18:49:11 +1000
Subject: [PATCH 1655/2374] Changed harfbuzz buildtype to minsize

---
 .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 d53cf059bab..a4592871f69 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -92,7 +92,7 @@ function build_harfbuzz {
 
     local out_dir=$(fetch_unpack https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION/harfbuzz-$HARFBUZZ_VERSION.tar.xz harfbuzz-$HARFBUZZ_VERSION.tar.xz)
     (cd $out_dir \
-        && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=release -Dfreetype=enabled -Dglib=disabled -Dtests=disabled)
+        && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=minsize -Dfreetype=enabled -Dglib=disabled -Dtests=disabled)
     (cd $out_dir/build \
         && meson install)
     touch harfbuzz-stamp

From cf48bbf0c48f871ecd62fb473611a7e2552580d9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 19 Apr 2025 20:26:03 +1000
Subject: [PATCH 1656/2374] Removed indentation from list

---
 docs/handbook/concepts.rst         | 44 +++++++++++++++---------------
 docs/reference/block_allocator.rst | 18 ++++++------
 2 files changed, 31 insertions(+), 31 deletions(-)

diff --git a/docs/handbook/concepts.rst b/docs/handbook/concepts.rst
index 7da1078c14e..fe874a740b4 100644
--- a/docs/handbook/concepts.rst
+++ b/docs/handbook/concepts.rst
@@ -30,35 +30,35 @@ image. Each pixel uses the full range of the bit depth. So a 1-bit pixel has a r
 INT32 and a 32-bit floating point pixel has the range of FLOAT32. The current release
 supports the following standard modes:
 
-    * ``1`` (1-bit pixels, black and white, stored with one pixel per byte)
-    * ``L`` (8-bit pixels, grayscale)
-    * ``P`` (8-bit pixels, mapped to any other mode using a color palette)
-    * ``RGB`` (3x8-bit pixels, true color)
-    * ``RGBA`` (4x8-bit pixels, true color with transparency mask)
-    * ``CMYK`` (4x8-bit pixels, color separation)
-    * ``YCbCr`` (3x8-bit pixels, color video format)
+* ``1`` (1-bit pixels, black and white, stored with one pixel per byte)
+* ``L`` (8-bit pixels, grayscale)
+* ``P`` (8-bit pixels, mapped to any other mode using a color palette)
+* ``RGB`` (3x8-bit pixels, true color)
+* ``RGBA`` (4x8-bit pixels, true color with transparency mask)
+* ``CMYK`` (4x8-bit pixels, color separation)
+* ``YCbCr`` (3x8-bit pixels, color video format)
 
-      * Note that this refers to the JPEG, and not the ITU-R BT.2020, standard
+  * Note that this refers to the JPEG, and not the ITU-R BT.2020, standard
 
-    * ``LAB`` (3x8-bit pixels, the L*a*b color space)
-    * ``HSV`` (3x8-bit pixels, Hue, Saturation, Value color space)
+* ``LAB`` (3x8-bit pixels, the L*a*b color space)
+* ``HSV`` (3x8-bit pixels, Hue, Saturation, Value color space)
 
-      * Hue's range of 0-255 is a scaled version of 0 degrees <= Hue < 360 degrees
+  * Hue's range of 0-255 is a scaled version of 0 degrees <= Hue < 360 degrees
 
-    * ``I`` (32-bit signed integer pixels)
-    * ``F`` (32-bit floating point pixels)
+* ``I`` (32-bit signed integer pixels)
+* ``F`` (32-bit floating point pixels)
 
 Pillow also provides limited support for a few additional modes, including:
 
-    * ``LA`` (L with alpha)
-    * ``PA`` (P with alpha)
-    * ``RGBX`` (true color with padding)
-    * ``RGBa`` (true color with premultiplied alpha)
-    * ``La`` (L with premultiplied alpha)
-    * ``I;16`` (16-bit unsigned integer pixels)
-    * ``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)
+* ``LA`` (L with alpha)
+* ``PA`` (P with alpha)
+* ``RGBX`` (true color with padding)
+* ``RGBa`` (true color with premultiplied alpha)
+* ``La`` (L with premultiplied alpha)
+* ``I;16`` (16-bit unsigned integer pixels)
+* ``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)
 
 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/docs/reference/block_allocator.rst b/docs/reference/block_allocator.rst
index f4d27e24e57..c6be5b7e6ed 100644
--- a/docs/reference/block_allocator.rst
+++ b/docs/reference/block_allocator.rst
@@ -37,14 +37,14 @@ fresh allocation. This caching of free blocks is currently disabled by
 default, but can be enabled and tweaked using three environment
 variables:
 
-  * ``PILLOW_ALIGNMENT``, in bytes. Specifies the alignment of memory
-    allocations. Valid values are powers of 2 between 1 and
-    128, inclusive. Defaults to 1.
+* ``PILLOW_ALIGNMENT``, in bytes. Specifies the alignment of memory
+  allocations. Valid values are powers of 2 between 1 and
+  128, inclusive. Defaults to 1.
 
-  * ``PILLOW_BLOCK_SIZE``, in bytes, K, or M.  Specifies the maximum
-    block size for ``ImagingAllocateArray``. Valid values are
-    integers, with an optional ``k`` or ``m`` suffix. Defaults to 16M.
+* ``PILLOW_BLOCK_SIZE``, in bytes, K, or M.  Specifies the maximum
+  block size for ``ImagingAllocateArray``. Valid values are
+  integers, with an optional ``k`` or ``m`` suffix. Defaults to 16M.
 
-  * ``PILLOW_BLOCKS_MAX`` Specifies the number of freed blocks to
-    retain to fill future memory requests. Any freed blocks over this
-    threshold will be returned to the OS immediately. Defaults to 0.
+* ``PILLOW_BLOCKS_MAX`` Specifies the number of freed blocks to
+  retain to fill future memory requests. Any freed blocks over this
+  threshold will be returned to the OS immediately. Defaults to 0.

From 03e7871afdb8f558cddc10cc9013e1db143298d9 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 20 Apr 2025 00:18:01 +0300
Subject: [PATCH 1657/2374] Add `make [-C docs] htmllive` to rebuild and reload
 HTML files (#8913)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Makefile       |  5 +++++
 docs/Guardfile | 10 ----------
 docs/Makefile  |  9 +++++----
 pyproject.toml |  1 +
 4 files changed, 11 insertions(+), 14 deletions(-)
 delete mode 100755 docs/Guardfile

diff --git a/Makefile b/Makefile
index 53164b08a90..5a815245402 100644
--- a/Makefile
+++ b/Makefile
@@ -23,6 +23,10 @@ doc html:
 htmlview:
 	$(MAKE) -C docs htmlview
 
+.PHONY: htmllive
+htmllive:
+	$(MAKE) -C docs htmllive
+
 .PHONY: doccheck
 doccheck:
 	$(MAKE) doc
@@ -43,6 +47,7 @@ help:
 	@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 "  htmllive           rebuild and reload HTML files in your browser"
 	@echo "  install            make and install"
 	@echo "  install-coverage   make and install with C coverage"
 	@echo "  lint               run the lint checks"
diff --git a/docs/Guardfile b/docs/Guardfile
deleted file mode 100755
index 16a891a730d..00000000000
--- a/docs/Guardfile
+++ /dev/null
@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-from livereload.compiler import shell
-from livereload.task import Task
-
-Task.add("*.rst", shell("make html"))
-Task.add("*/*.rst", shell("make html"))
-Task.add("Makefile", shell("make html"))
-Task.add("conf.py", shell("make html"))
diff --git a/docs/Makefile b/docs/Makefile
index e90af0519c6..4412fc80687 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -20,8 +20,8 @@ help:
 	@echo "Please use \`make <target>' where <target> is one of"
 	@echo "  html       to make standalone HTML files"
 	@echo "  htmlview   to open the index page built by the html target in your browser"
+	@echo "  htmllive   to rebuild and reload HTML files in your browser"
 	@echo "  serve      to start a local server for viewing docs"
-	@echo "  livehtml   to start a local server for viewing docs and auto-reload on change"
 	@echo "  dirhtml    to make HTML files named index.html in directories"
 	@echo "  singlehtml to make a single large HTML file"
 	@echo "  pickle     to make pickle files"
@@ -201,9 +201,10 @@ doctest:
 htmlview: html
 	$(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('$(BUILDDIR)/html/index.html'))"
 
-.PHONY: livehtml
-livehtml: html
-	livereload $(BUILDDIR)/html -p 33233
+.PHONY: htmllive
+htmllive: SPHINXBUILD = $(PYTHON) -m sphinx_autobuild
+htmllive: SPHINXOPTS = --open-browser --delay 0
+htmllive: html
 
 .PHONY: serve
 serve:
diff --git a/pyproject.toml b/pyproject.toml
index e8e76796a69..a3ff9723b4e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -44,6 +44,7 @@ optional-dependencies.docs = [
   "furo",
   "olefile",
   "sphinx>=8.2",
+  "sphinx-autobuild",
   "sphinx-copybutton",
   "sphinx-inline-tabs",
   "sphinxext-opengraph",

From 4402797b35137666413efcc04fb91064e846cd90 Mon Sep 17 00:00:00 2001
From: Adian Kozlica <105174725+AdianKozlica@users.noreply.github.com>
Date: Mon, 21 Apr 2025 04:36:40 +0200
Subject: [PATCH 1658/2374] Add support for Grim in Wayland sessions ImageGrab
 (#8912)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_imagegrab.py      | 1 +
 docs/reference/ImageGrab.rst | 6 +++---
 src/PIL/ImageGrab.py         | 2 ++
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 5f51171f197..01fa090dc3a 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -43,6 +43,7 @@ def test_grab_no_xcb(self) -> None:
         if (
             sys.platform not in ("win32", "darwin")
             and not shutil.which("gnome-screenshot")
+            and not shutil.which("grim")
             and not shutil.which("spectacle")
         ):
             with pytest.raises(OSError) as e:
diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index 1e827a6764e..0fd8f68df7c 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -16,9 +16,9 @@ or the clipboard to a PIL image memory.
     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`` or ``spectacle`` will be used as a
-    fallback if they are installed. To disable this behaviour, pass ``xdisplay=""``
-    instead.
+    a snapshot of the screen, ``gnome-screenshot``, ``grim`` or ``spectacle`` will be
+    used as a fallback if they are installed. To disable this behaviour, pass
+    ``xdisplay=""`` instead.
 
     .. versionadded:: 1.1.3 (Windows), 3.0.0 (macOS), 7.1.0 (Linux)
 
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 4da14f8e4b5..c29350b7a81 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -89,6 +89,8 @@ def grab(
         if display_name is None and sys.platform not in ("darwin", "win32"):
             if shutil.which("gnome-screenshot"):
                 args = ["gnome-screenshot", "-f"]
+            elif shutil.which("grim"):
+                args = ["grim"]
             elif shutil.which("spectacle"):
                 args = ["spectacle", "-n", "-b", "-f", "-o"]
             else:

From 8fe7a7aaf89a5f312fe60382c1c5196876f53452 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 21 Apr 2025 17:32:47 +1000
Subject: [PATCH 1659/2374] Update redirected URL

---
 docs/releasenotes/10.1.0.rst | 2 +-
 src/PIL/ImageFont.py         | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/releasenotes/10.1.0.rst b/docs/releasenotes/10.1.0.rst
index fd556bdf17f..e4efb069e03 100644
--- a/docs/releasenotes/10.1.0.rst
+++ b/docs/releasenotes/10.1.0.rst
@@ -71,7 +71,7 @@ size and font_size arguments when using default font
 
 Pillow has had a "better than nothing" default font, which can only be drawn at
 one font size. Now, if FreeType support is available, a version of
-`Aileron Regular <https://dotcolon.net/font/aileron>`_ is loaded, which can be
+`Aileron Regular <https://dotcolon.net/fonts/aileron>`_ is loaded, which can be
 drawn at chosen font sizes.
 
 The following ``size`` and ``font_size`` arguments can now be used to specify a
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index ebe510ba990..329c463ff86 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -1093,7 +1093,7 @@ def load_default_imagefont() -> ImageFont:
 
 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.
+    https://dotcolon.net/fonts/aileron, with a more limited character set.
 
     Otherwise, load a "better than nothing" font.
 

From d03ce3d235c9a80fb5a336634115a331749af9f8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 21 Apr 2025 11:22:03 +0300
Subject: [PATCH 1660/2374] Docs: remove unused Makefile targets (#8917)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/Makefile | 135 --------------------------------------------------
 docs/conf.py  |  91 ----------------------------------
 docs/make.bat | 123 ---------------------------------------------
 3 files changed, 349 deletions(-)

diff --git a/docs/Makefile b/docs/Makefile
index 4412fc80687..1e6c06ede80 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -24,22 +24,7 @@ help:
 	@echo "  serve      to start a local server for viewing docs"
 	@echo "  dirhtml    to make HTML files named index.html in directories"
 	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
 	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
 
 .PHONY: clean
 clean:
@@ -69,119 +54,6 @@ singlehtml:
 	@echo
 	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
 
-.PHONY: pickle
-pickle:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-.PHONY: json
-json:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-.PHONY: htmlhelp
-htmlhelp:
-	$(MAKE) install-sphinx
-	$(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."
-
-.PHONY: qthelp
-qthelp:
-	$(MAKE) install-sphinx
-	$(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:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/PillowPILfork.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/PillowPILfork.qhc"
-
-.PHONY: devhelp
-devhelp:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/PillowPILfork"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/PillowPILfork"
-	@echo "# devhelp"
-
-.PHONY: epub
-epub:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-.PHONY: latex
-latex:
-	$(MAKE) install-sphinx
-	$(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" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-.PHONY: latexpdf
-latexpdf:
-	$(MAKE) install-sphinx
-	$(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."
-
-.PHONY: text
-text:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-.PHONY: man
-man:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-.PHONY: texinfo
-texinfo:
-	$(MAKE) install-sphinx
-	$(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" \
-	      "(use \`make info' here to do that automatically)."
-
-.PHONY: info
-info:
-	$(MAKE) install-sphinx
-	$(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."
-
-.PHONY: gettext
-gettext:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-.PHONY: changes
-changes:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
 .PHONY: linkcheck
 linkcheck:
 	$(MAKE) install-sphinx
@@ -190,13 +62,6 @@ linkcheck:
 	@echo "Link check complete; look for any errors in the above output " \
 	      "or in $(BUILDDIR)/linkcheck/output.txt."
 
-.PHONY: doctest
-doctest:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
-
 .PHONY: htmlview
 htmlview: html
 	$(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('$(BUILDDIR)/html/index.html'))"
diff --git a/docs/conf.py b/docs/conf.py
index bfbcf91516f..040301433f9 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -229,97 +229,6 @@
 # implements a search results scorer. If empty, the default will be used.
 # html_search_scorer = 'scorer.js'
 
-# Output file base name for HTML help builder.
-htmlhelp_basename = "PillowPILForkdoc"
-
-# -- Options for LaTeX output ---------------------------------------------
-
-latex_elements: dict[str, str] = {
-    # The paper size ('letterpaper' or 'a4paper').
-    # 'papersize': 'letterpaper',
-    # The font size ('10pt', '11pt' or '12pt').
-    # 'pointsize': '10pt',
-    # Additional stuff for the LaTeX preamble.
-    # 'preamble': '',
-    # Latex figure (float) alignment
-    # 'figure_align': 'htbp',
-}
-
-# Grouping the document tree into LaTeX files. List of tuples
-# (source start file, target name, title,
-#  author, documentclass [howto, manual, or own class]).
-latex_documents = [
-    (
-        master_doc,
-        "PillowPILFork.tex",
-        "Pillow (PIL Fork) Documentation",
-        "Jeffrey A. Clark",
-        "manual",
-    )
-]
-
-# The name of an image file (relative to this directory) to place at the top of
-# the title page.
-# latex_logo = None
-
-# For "manual" documents, if this is true, then toplevel headings are parts,
-# not chapters.
-# latex_use_parts = False
-
-# If true, show page references after internal links.
-# latex_show_pagerefs = False
-
-# If true, show URL addresses after external links.
-# latex_show_urls = False
-
-# Documents to append as an appendix to all manuals.
-# latex_appendices = []
-
-# If false, no module index is generated.
-# latex_domain_indices = True
-
-
-# -- Options for manual page output ---------------------------------------
-
-# One entry per manual page. List of tuples
-# (source start file, name, description, authors, manual section).
-man_pages = [
-    (master_doc, "pillowpilfork", "Pillow (PIL Fork) Documentation", [author], 1)
-]
-
-# If true, show URL addresses after external links.
-# man_show_urls = False
-
-
-# -- Options for Texinfo output -------------------------------------------
-
-# Grouping the document tree into Texinfo files. List of tuples
-# (source start file, target name, title, author,
-#  dir menu entry, description, category)
-texinfo_documents = [
-    (
-        master_doc,
-        "PillowPILFork",
-        "Pillow (PIL Fork) Documentation",
-        author,
-        "PillowPILFork",
-        "Pillow is the friendly PIL fork by Jeffrey A. Clark and contributors.",
-        "Miscellaneous",
-    )
-]
-
-# Documents to append as an appendix to all manuals.
-# texinfo_appendices = []
-
-# If false, no module index is generated.
-# texinfo_domain_indices = True
-
-# How to display URL addresses: 'footnote', 'no', or 'inline'.
-# texinfo_show_urls = 'footnote'
-
-# If true, do not generate a @detailmenu in the "Top" node's menu.
-# texinfo_no_detailmenu = False
-
 
 linkcheck_allowed_redirects = {
     r"https://www.bestpractices.dev/projects/6331": r"https://www.bestpractices.dev/en/.*",
diff --git a/docs/make.bat b/docs/make.bat
index 0ed5ee1a57e..4126f786b8d 100644
--- a/docs/make.bat
+++ b/docs/make.bat
@@ -22,20 +22,7 @@ if "%1" == "help" (
 	echo.  htmlview   to open the index page built by the html target in your browser
 	echo.  dirhtml    to make HTML files named index.html in directories
 	echo.  singlehtml to make a single large HTML file
-	echo.  pickle     to make pickle files
-	echo.  json       to make JSON files
-	echo.  htmlhelp   to make HTML files and a HTML help project
-	echo.  qthelp     to make HTML files and a qthelp project
-	echo.  devhelp    to make HTML files and a Devhelp project
-	echo.  epub       to make an epub
-	echo.  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
-	echo.  text       to make text files
-	echo.  man        to make manual pages
-	echo.  texinfo    to make Texinfo files
-	echo.  gettext    to make PO message catalogs
-	echo.  changes    to make an overview over all changed/added/deprecated items
 	echo.  linkcheck  to check all external links for integrity
-	echo.  doctest    to run all doctests embedded in the documentation if enabled
 	goto end
 )
 
@@ -80,107 +67,6 @@ if "%1" == "singlehtml" (
 	goto end
 )
 
-if "%1" == "pickle" (
-	%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the pickle files.
-	goto end
-)
-
-if "%1" == "json" (
-	%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can process the JSON files.
-	goto end
-)
-
-if "%1" == "htmlhelp" (
-	%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run HTML Help Workshop with the ^
-.hhp project file in %BUILDDIR%/htmlhelp.
-	goto end
-)
-
-if "%1" == "qthelp" (
-	%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; now you can run "qcollectiongenerator" with the ^
-.qhcp project file in %BUILDDIR%/qthelp, like this:
-	echo.^> qcollectiongenerator %BUILDDIR%\qthelp\PillowPILfork.qhcp
-	echo.To view the help file:
-	echo.^> assistant -collectionFile %BUILDDIR%\qthelp\PillowPILfork.ghc
-	goto end
-)
-
-if "%1" == "devhelp" (
-	%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished.
-	goto end
-)
-
-if "%1" == "epub" (
-	%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The epub file is in %BUILDDIR%/epub.
-	goto end
-)
-
-if "%1" == "latex" (
-	%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
-	goto end
-)
-
-if "%1" == "text" (
-	%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The text files are in %BUILDDIR%/text.
-	goto end
-)
-
-if "%1" == "man" (
-	%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The manual pages are in %BUILDDIR%/man.
-	goto end
-)
-
-if "%1" == "texinfo" (
-	%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
-	goto end
-)
-
-if "%1" == "gettext" (
-	%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
-	goto end
-)
-
-if "%1" == "changes" (
-	%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.The overview file is in %BUILDDIR%/changes.
-	goto end
-)
-
 if "%1" == "linkcheck" (
 	%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
 	if errorlevel 1 exit /b 1
@@ -190,13 +76,4 @@ or in %BUILDDIR%/linkcheck/output.txt.
 	goto end
 )
 
-if "%1" == "doctest" (
-	%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
-	if errorlevel 1 exit /b 1
-	echo.
-	echo.Testing of doctests in the sources finished, look at the ^
-results in %BUILDDIR%/doctest/output.txt.
-	goto end
-)
-
 :end

From 348589a367bba81bd9e2d1f4b6280ada91caae2e Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 21 Apr 2025 12:03:31 +0300
Subject: [PATCH 1661/2374] Docs: use sentence case for headers (#8914)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/README.rst                              |  2 +-
 docs/PIL.rst                                  | 32 +++----
 docs/deprecations.rst                         |  2 +-
 docs/handbook/concepts.rst                    |  2 +-
 docs/handbook/image-file-formats.rst          |  4 +-
 docs/handbook/overview.rst                    |  6 +-
 docs/handbook/tutorial.rst                    |  4 +-
 .../writing-your-own-image-plugin.rst         |  6 +-
 docs/installation.rst                         | 10 +-
 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 +-
 docs/reference/ExifTags.rst                   |  2 +-
 docs/reference/Image.rst                      |  6 +-
 docs/reference/ImageChops.rst                 |  2 +-
 docs/reference/ImageCms.rst                   |  2 +-
 docs/reference/ImageColor.rst                 |  4 +-
 docs/reference/ImageDraw.rst                  |  8 +-
 docs/reference/ImageEnhance.rst               |  2 +-
 docs/reference/ImageFile.rst                  |  2 +-
 docs/reference/ImageFilter.rst                |  2 +-
 docs/reference/ImageFont.rst                  |  2 +-
 docs/reference/ImageGrab.rst                  |  2 +-
 docs/reference/ImageMath.rst                  | 10 +-
 docs/reference/ImageMorph.rst                 |  2 +-
 docs/reference/ImageOps.rst                   |  2 +-
 docs/reference/ImagePalette.rst               |  2 +-
 docs/reference/ImagePath.rst                  |  2 +-
 docs/reference/ImageQt.rst                    |  2 +-
 docs/reference/ImageSequence.rst              |  2 +-
 docs/reference/ImageShow.rst                  |  4 +-
 docs/reference/ImageStat.rst                  |  2 +-
 docs/reference/ImageTk.rst                    |  2 +-
 docs/reference/ImageTransform.rst             |  2 +-
 docs/reference/ImageWin.rst                   |  2 +-
 docs/reference/JpegPresets.rst                |  2 +-
 docs/reference/PSDraw.rst                     |  2 +-
 docs/reference/PixelAccess.rst                |  4 +-
 docs/reference/TiffTags.rst                   |  2 +-
 docs/reference/arrow_support.rst              | 10 +-
 docs/reference/block_allocator.rst            |  8 +-
 docs/reference/c_extension_debugging.rst      |  8 +-
 docs/reference/features.rst                   |  2 +-
 docs/reference/internal_design.rst            |  2 +-
 docs/reference/internal_modules.rst           | 16 ++--
 docs/reference/limits.rst                     |  6 +-
 docs/reference/open_files.rst                 |  6 +-
 docs/reference/plugins.rst                    | 92 +++++++++----------
 docs/releasenotes/10.0.0.rst                  |  8 +-
 docs/releasenotes/10.0.1.rst                  |  2 +-
 docs/releasenotes/10.1.0.rst                  |  6 +-
 docs/releasenotes/10.2.0.rst                  |  6 +-
 docs/releasenotes/10.3.0.rst                  |  6 +-
 docs/releasenotes/10.4.0.rst                  |  4 +-
 docs/releasenotes/11.0.0.rst                  | 12 +--
 docs/releasenotes/11.1.0.rst                  |  6 +-
 docs/releasenotes/11.2.1.rst                  |  6 +-
 docs/releasenotes/2.7.0.rst                   |  6 +-
 docs/releasenotes/3.0.0.rst                   | 12 +--
 docs/releasenotes/3.1.0.rst                   |  4 +-
 docs/releasenotes/3.2.0.rst                   |  4 +-
 docs/releasenotes/3.3.0.rst                   |  4 +-
 docs/releasenotes/3.3.2.rst                   |  4 +-
 docs/releasenotes/3.4.0.rst                   |  8 +-
 docs/releasenotes/4.0.0.rst                   |  2 +-
 docs/releasenotes/4.1.0.rst                   | 10 +-
 docs/releasenotes/4.1.1.rst                   |  2 +-
 docs/releasenotes/4.2.0.rst                   | 12 +--
 docs/releasenotes/4.2.1.rst                   |  2 +-
 docs/releasenotes/4.3.0.rst                   | 26 +++---
 docs/releasenotes/5.0.0.rst                   | 22 ++---
 docs/releasenotes/5.1.0.rst                   | 10 +-
 docs/releasenotes/5.2.0.rst                   |  6 +-
 docs/releasenotes/5.3.0.rst                   |  6 +-
 docs/releasenotes/5.4.0.rst                   |  4 +-
 docs/releasenotes/6.0.0.rst                   |  8 +-
 docs/releasenotes/6.1.0.rst                   |  4 +-
 docs/releasenotes/6.2.0.rst                   |  6 +-
 docs/releasenotes/6.2.1.rst                   |  4 +-
 docs/releasenotes/7.0.0.rst                   |  6 +-
 docs/releasenotes/7.1.0.rst                   |  6 +-
 docs/releasenotes/7.2.0.rst                   |  2 +-
 docs/releasenotes/8.0.0.rst                   |  8 +-
 docs/releasenotes/8.1.0.rst                   |  6 +-
 docs/releasenotes/8.1.1.rst                   |  2 +-
 docs/releasenotes/8.2.0.rst                   |  6 +-
 docs/releasenotes/8.3.0.rst                   |  6 +-
 docs/releasenotes/8.3.2.rst                   |  2 +-
 docs/releasenotes/8.4.0.rst                   |  4 +-
 docs/releasenotes/9.0.0.rst                   |  8 +-
 docs/releasenotes/9.0.1.rst                   |  2 +-
 docs/releasenotes/9.1.0.rst                   |  6 +-
 docs/releasenotes/9.2.0.rst                   |  4 +-
 docs/releasenotes/9.3.0.rst                   |  4 +-
 docs/releasenotes/9.4.0.rst                   |  4 +-
 docs/releasenotes/9.5.0.rst                   |  4 +-
 docs/releasenotes/index.rst                   |  2 +-
 docs/releasenotes/template.rst                |  8 +-
 99 files changed, 313 insertions(+), 313 deletions(-)

diff --git a/Tests/README.rst b/Tests/README.rst
index 2d014e5a46e..a955ec4fa56 100644
--- a/Tests/README.rst
+++ b/Tests/README.rst
@@ -1,4 +1,4 @@
-Pillow Tests
+Pillow tests
 ============
 
 Test scripts are named ``test_xxx.py``. Helper classes and functions can be found in ``helper.py``.
diff --git a/docs/PIL.rst b/docs/PIL.rst
index bdbf1373d88..5225e9644cd 100644
--- a/docs/PIL.rst
+++ b/docs/PIL.rst
@@ -1,10 +1,10 @@
-PIL Package (autodoc of remaining modules)
+PIL package (autodoc of remaining modules)
 ==========================================
 
 Reference for modules whose documentation has not yet been ported or written
 can be found here.
 
-:mod:`PIL` Module
+:mod:`PIL` module
 -----------------
 
 .. py:module:: PIL
@@ -12,7 +12,7 @@ can be found here.
 .. autoexception:: UnidentifiedImageError
     :show-inheritance:
 
-:mod:`~PIL.BdfFontFile` Module
+:mod:`~PIL.BdfFontFile` module
 ------------------------------
 
 .. automodule:: PIL.BdfFontFile
@@ -20,7 +20,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.ContainerIO` Module
+:mod:`~PIL.ContainerIO` module
 ------------------------------
 
 .. automodule:: PIL.ContainerIO
@@ -28,7 +28,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.FontFile` Module
+:mod:`~PIL.FontFile` module
 ---------------------------
 
 .. automodule:: PIL.FontFile
@@ -36,7 +36,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.GdImageFile` Module
+:mod:`~PIL.GdImageFile` module
 ------------------------------
 
 .. automodule:: PIL.GdImageFile
@@ -44,7 +44,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.GimpGradientFile` Module
+:mod:`~PIL.GimpGradientFile` module
 -----------------------------------
 
 .. automodule:: PIL.GimpGradientFile
@@ -52,7 +52,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.GimpPaletteFile` Module
+:mod:`~PIL.GimpPaletteFile` module
 ----------------------------------
 
 .. automodule:: PIL.GimpPaletteFile
@@ -60,7 +60,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.ImageDraw2` Module
+:mod:`~PIL.ImageDraw2` module
 -----------------------------
 
 .. automodule:: PIL.ImageDraw2
@@ -69,7 +69,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.ImageMode` Module
+:mod:`~PIL.ImageMode` module
 ----------------------------
 
 .. automodule:: PIL.ImageMode
@@ -77,7 +77,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PaletteFile` Module
+:mod:`~PIL.PaletteFile` module
 ------------------------------
 
 .. automodule:: PIL.PaletteFile
@@ -85,7 +85,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PcfFontFile` Module
+:mod:`~PIL.PcfFontFile` module
 ------------------------------
 
 .. automodule:: PIL.PcfFontFile
@@ -93,7 +93,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:class:`.PngImagePlugin.iTXt` Class
+:class:`.PngImagePlugin.iTXt` class
 -----------------------------------
 
 .. autoclass:: PIL.PngImagePlugin.iTXt
@@ -107,7 +107,7 @@ can be found here.
         :param lang: language code
         :param tkey: UTF-8 version of the key name
 
-:class:`.PngImagePlugin.PngInfo` Class
+:class:`.PngImagePlugin.PngInfo` class
 --------------------------------------
 
 .. autoclass:: PIL.PngImagePlugin.PngInfo
@@ -116,7 +116,7 @@ can be found here.
     :show-inheritance:
 
 
-:mod:`~PIL.TarIO` Module
+:mod:`~PIL.TarIO` module
 ------------------------
 
 .. automodule:: PIL.TarIO
@@ -124,7 +124,7 @@ can be found here.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.WalImageFile` Module
+:mod:`~PIL.WalImageFile` module
 -------------------------------
 
 .. automodule:: PIL.WalImageFile
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 7f8e76bccc5..0490ba439fd 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -155,7 +155,7 @@ 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
+Specific WebP feature checks
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 11.0.0
diff --git a/docs/handbook/concepts.rst b/docs/handbook/concepts.rst
index fe874a740b4..c9d3f5e91cb 100644
--- a/docs/handbook/concepts.rst
+++ b/docs/handbook/concepts.rst
@@ -84,7 +84,7 @@ pixels.
 
 .. _coordinate-system:
 
-Coordinate System
+Coordinate system
 -----------------
 
 The Python Imaging Library uses a Cartesian pixel coordinate system, with (0,0)
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 46fe8b630db..5ca549c3787 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1222,7 +1222,7 @@ numbers are returned as a tuple of ``(numerator, denominator)``.
 
     .. deprecated:: 3.0.0
 
-Reading Multi-frame TIFF Images
+Reading multi-frame TIFF images
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The TIFF loader supports the :py:meth:`~PIL.Image.Image.seek` and
@@ -1664,7 +1664,7 @@ The :py:meth:`~PIL.Image.open` method sets the following
     Transparency color index. This key is omitted if the image is not
     transparent.
 
-XV Thumbnails
+XV thumbnails
 ^^^^^^^^^^^^^
 
 Pillow can read XV thumbnail files.
diff --git a/docs/handbook/overview.rst b/docs/handbook/overview.rst
index 17964d1c5f3..ab22b9807a1 100644
--- a/docs/handbook/overview.rst
+++ b/docs/handbook/overview.rst
@@ -13,7 +13,7 @@ processing tool.
 
 Let’s look at a few possible uses of this library.
 
-Image Archives
+Image archives
 --------------
 
 The Python Imaging Library is ideal for image archival and batch processing
@@ -24,7 +24,7 @@ The current version identifies and reads a large number of formats. Write
 support is intentionally restricted to the most commonly used interchange and
 presentation formats.
 
-Image Display
+Image display
 -------------
 
 The current release includes Tk :py:class:`~PIL.ImageTk.PhotoImage` and
@@ -36,7 +36,7 @@ support.
 For debugging, there’s also a :py:meth:`~PIL.Image.Image.show` method which saves an image to
 disk, and calls an external display utility.
 
-Image Processing
+Image processing
 ----------------
 
 The library contains basic image processing functionality, including point operations, filtering with a set of built-in convolution kernels, and colour space conversions.
diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index f1a2849b897..28c0abe4437 100644
--- a/docs/handbook/tutorial.rst
+++ b/docs/handbook/tutorial.rst
@@ -122,7 +122,7 @@ This means that opening an image file is a fast operation, which is independent
 of the file size and compression type. Here’s a simple script to quickly
 identify a set of image files:
 
-Identify Image Files
+Identify image files
 ^^^^^^^^^^^^^^^^^^^^
 
 ::
@@ -399,7 +399,7 @@ Applying filters
 .. image:: enhanced_hopper.webp
     :align: center
 
-Point Operations
+Point operations
 ^^^^^^^^^^^^^^^^
 
 The :py:meth:`~PIL.Image.Image.point` method can be used to translate the pixel
diff --git a/docs/handbook/writing-your-own-image-plugin.rst b/docs/handbook/writing-your-own-image-plugin.rst
index 9e7d14c5716..21a9124d781 100644
--- a/docs/handbook/writing-your-own-image-plugin.rst
+++ b/docs/handbook/writing-your-own-image-plugin.rst
@@ -1,6 +1,6 @@
 .. _image-plugins:
 
-Writing Your Own Image Plugin
+Writing your own image plugin
 =============================
 
 Pillow uses a plugin model which allows you to add your own
@@ -329,7 +329,7 @@ The fields are used as follows:
 
 .. _file-codecs:
 
-Writing Your Own File Codec in C
+Writing your own file codec in C
 ================================
 
 There are 3 stages in a file codec's lifetime:
@@ -414,7 +414,7 @@ memory and release any resources from external libraries.
 
 .. _file-codecs-py:
 
-Writing Your Own File Codec in Python
+Writing your own file codec in Python
 =====================================
 
 Python file decoders and encoders should derive from
diff --git a/docs/installation.rst b/docs/installation.rst
index b4bf2fa00e8..03f18c195e4 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -3,27 +3,27 @@
 Installation
 ============
 
-Basic Installation
+Basic installation
 ------------------
 
 .. Note:: This section has moved to :ref:`basic-installation`. Please update references accordingly.
 
-Python Support
+Python support
 --------------
 
 .. Note:: This section has moved to :ref:`python-support`. Please update references accordingly.
 
-Platform Support
+Platform support
 ----------------
 
 .. Note:: This section has moved to :ref:`platform-support`. Please update references accordingly.
 
-Building From Source
+Building from source
 --------------------
 
 .. Note:: This section has moved to :ref:`building-from-source`. Please update references accordingly.
 
-Old Versions
+Old versions
 ------------
 
 .. Note:: This section has moved to :ref:`old-versions`. Please update references accordingly.
diff --git a/docs/installation/basic-installation.rst b/docs/installation/basic-installation.rst
index 989f72dddde..f66ee8707f1 100644
--- a/docs/installation/basic-installation.rst
+++ b/docs/installation/basic-installation.rst
@@ -8,7 +8,7 @@
 
 .. _basic-installation:
 
-Basic Installation
+Basic installation
 ==================
 
 .. note::
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 9ba389b6699..c72568b208e 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -8,12 +8,12 @@
 
 .. _building-from-source:
 
-Building From Source
+Building from source
 ====================
 
 .. _external-libraries:
 
-External Libraries
+External libraries
 ------------------
 
 .. note::
@@ -271,7 +271,7 @@ After navigating to the Pillow directory, run::
 
 .. _compressed archive from PyPI: https://pypi.org/project/pillow/#files
 
-Build Options
+Build options
 ^^^^^^^^^^^^^
 
 * Config setting: ``-C parallel=n``. Can also be given
@@ -319,7 +319,7 @@ Sample usage::
 
 .. _old-versions:
 
-Old Versions
+Old versions
 ============
 
 You can download old distributions from the `release history at PyPI
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index d751620fd2b..93486d034c8 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -1,6 +1,6 @@
 .. _platform-support:
 
-Platform Support
+Platform support
 ================
 
 Current platform support for Pillow. Binary distributions are
@@ -9,7 +9,7 @@ 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
+Continuous integration targets
 ------------------------------
 
 These platforms are built and tested for every change.
@@ -59,7 +59,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 
 
-Other Platforms
+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 dd5765b6b70..7daee8afc78 100644
--- a/docs/installation/python-support.rst
+++ b/docs/installation/python-support.rst
@@ -1,6 +1,6 @@
 .. _python-support:
 
-Python Support
+Python support
 ==============
 
 Pillow supports these Python versions.
diff --git a/docs/reference/ExifTags.rst b/docs/reference/ExifTags.rst
index 06965ead3f0..e6bcd9d59c2 100644
--- a/docs/reference/ExifTags.rst
+++ b/docs/reference/ExifTags.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ExifTags
 .. py:currentmodule:: PIL.ExifTags
 
-:py:mod:`~PIL.ExifTags` Module
+:py:mod:`~PIL.ExifTags` module
 ==============================
 
 The :py:mod:`~PIL.ExifTags` module exposes several :py:class:`enum.IntEnum`
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index a3ba8cfd8e1..e687229000b 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.Image
 .. py:currentmodule:: PIL.Image
 
-:py:mod:`~PIL.Image` Module
+:py:mod:`~PIL.Image` module
 ===========================
 
 The :py:mod:`~PIL.Image` module provides a class with the same name which is
@@ -113,7 +113,7 @@ Registering plugins
 .. autofunction:: register_decoder
 .. autofunction:: register_encoder
 
-The Image Class
+The Image class
 ---------------
 
 .. autoclass:: PIL.Image.Image
@@ -261,7 +261,7 @@ method. ::
 .. automethod:: PIL.Image.Image.load
 .. automethod:: PIL.Image.Image.close
 
-Image Attributes
+Image attributes
 ----------------
 
 Instances of the :py:class:`Image` class have the following attributes:
diff --git a/docs/reference/ImageChops.rst b/docs/reference/ImageChops.rst
index 9519361a7e6..505181db6b5 100644
--- a/docs/reference/ImageChops.rst
+++ b/docs/reference/ImageChops.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageChops
 .. py:currentmodule:: PIL.ImageChops
 
-:py:mod:`~PIL.ImageChops` ("Channel Operations") Module
+:py:mod:`~PIL.ImageChops` ("channel operations") module
 =======================================================
 
 The :py:mod:`~PIL.ImageChops` module contains a number of arithmetical image
diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index 4a1f5a3eed7..238390e75f7 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageCms
 .. py:currentmodule:: PIL.ImageCms
 
-:py:mod:`~PIL.ImageCms` Module
+:py:mod:`~PIL.ImageCms` module
 ==============================
 
 The :py:mod:`~PIL.ImageCms` module provides color profile management
diff --git a/docs/reference/ImageColor.rst b/docs/reference/ImageColor.rst
index 31faeac788b..68e228dba0f 100644
--- a/docs/reference/ImageColor.rst
+++ b/docs/reference/ImageColor.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageColor
 .. py:currentmodule:: PIL.ImageColor
 
-:py:mod:`~PIL.ImageColor` Module
+:py:mod:`~PIL.ImageColor` module
 ================================
 
 The :py:mod:`~PIL.ImageColor` module contains color tables and converters from
@@ -11,7 +11,7 @@ others.
 
 .. _color-names:
 
-Color Names
+Color names
 -----------
 
 The ImageColor module supports the following string formats:
diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index bd6f6b048ac..6e73233a1ce 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageDraw
 .. py:currentmodule:: PIL.ImageDraw
 
-:py:mod:`~PIL.ImageDraw` Module
+:py:mod:`~PIL.ImageDraw` module
 ===============================
 
 The :py:mod:`~PIL.ImageDraw` module provides simple 2D graphics for
@@ -54,7 +54,7 @@ later, you can also use RGB 3-tuples or color names (see below). The drawing
 layer will automatically assign color indexes, as long as you don’t draw with
 more than 256 colors.
 
-Color Names
+Color names
 ^^^^^^^^^^^
 
 See :ref:`color-names` for the color names supported by Pillow.
@@ -75,7 +75,7 @@ To load a OpenType/TrueType font, use the truetype function in the
 :py:mod:`~PIL.ImageFont` module. Note that this function depends on third-party
 libraries, and may not available in all PIL builds.
 
-Example: Draw Partial Opacity Text
+Example: Draw partial opacity text
 ----------------------------------
 
 ::
@@ -102,7 +102,7 @@ Example: Draw Partial Opacity Text
 
         out.show()
 
-Example: Draw Multiline Text
+Example: Draw multiline text
 ----------------------------
 
 ::
diff --git a/docs/reference/ImageEnhance.rst b/docs/reference/ImageEnhance.rst
index 529acad4a91..334d1d4b228 100644
--- a/docs/reference/ImageEnhance.rst
+++ b/docs/reference/ImageEnhance.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageEnhance
 .. py:currentmodule:: PIL.ImageEnhance
 
-:py:mod:`~PIL.ImageEnhance` Module
+:py:mod:`~PIL.ImageEnhance` module
 ==================================
 
 The :py:mod:`~PIL.ImageEnhance` module contains a number of classes that can be used
diff --git a/docs/reference/ImageFile.rst b/docs/reference/ImageFile.rst
index 64abd71d156..043559352ab 100644
--- a/docs/reference/ImageFile.rst
+++ b/docs/reference/ImageFile.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageFile
 .. py:currentmodule:: PIL.ImageFile
 
-:py:mod:`~PIL.ImageFile` Module
+:py:mod:`~PIL.ImageFile` module
 ===============================
 
 The :py:mod:`~PIL.ImageFile` module provides support functions for the image open
diff --git a/docs/reference/ImageFilter.rst b/docs/reference/ImageFilter.rst
index 5f2b6af7c10..1c201cacca4 100644
--- a/docs/reference/ImageFilter.rst
+++ b/docs/reference/ImageFilter.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageFilter
 .. py:currentmodule:: PIL.ImageFilter
 
-:py:mod:`~PIL.ImageFilter` Module
+:py:mod:`~PIL.ImageFilter` module
 =================================
 
 The :py:mod:`~PIL.ImageFilter` module contains definitions for a pre-defined set of
diff --git a/docs/reference/ImageFont.rst b/docs/reference/ImageFont.rst
index d9d9cac6e13..8b2f923234b 100644
--- a/docs/reference/ImageFont.rst
+++ b/docs/reference/ImageFont.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageFont
 .. py:currentmodule:: PIL.ImageFont
 
-:py:mod:`~PIL.ImageFont` Module
+:py:mod:`~PIL.ImageFont` module
 ===============================
 
 The :py:mod:`~PIL.ImageFont` module defines a class with the same name. Instances of
diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index 0fd8f68df7c..f6a2ec5bc03 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageGrab
 .. py:currentmodule:: PIL.ImageGrab
 
-:py:mod:`~PIL.ImageGrab` Module
+:py:mod:`~PIL.ImageGrab` module
 ===============================
 
 The :py:mod:`~PIL.ImageGrab` module can be used to copy the contents of the screen
diff --git a/docs/reference/ImageMath.rst b/docs/reference/ImageMath.rst
index f4e1081e6b7..0ee49b15008 100644
--- a/docs/reference/ImageMath.rst
+++ b/docs/reference/ImageMath.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageMath
 .. py:currentmodule:: PIL.ImageMath
 
-:py:mod:`~PIL.ImageMath` Module
+:py:mod:`~PIL.ImageMath` module
 ===============================
 
 The :py:mod:`~PIL.ImageMath` module can be used to evaluate “image expressions”, that
@@ -86,7 +86,7 @@ Expression syntax
   It is not recommended to process expressions without considering this.
   :py:meth:`lambda_eval` is a more secure alternative.
 
-Standard Operators
+Standard operators
 ^^^^^^^^^^^^^^^^^^
 
 You can use standard arithmetical operators for addition (+), subtraction (-),
@@ -102,7 +102,7 @@ an 8-bit image, the result will be a 32-bit floating point image.
 You can force conversion using the ``convert()``, ``float()``, and ``int()``
 functions described below.
 
-Bitwise Operators
+Bitwise operators
 ^^^^^^^^^^^^^^^^^
 
 The module also provides operations that operate on individual bits. This
@@ -116,7 +116,7 @@ mask off unwanted bits.
 
 Bitwise operators don’t work on floating point images.
 
-Logical Operators
+Logical operators
 ^^^^^^^^^^^^^^^^^
 
 Logical operators like ``and``, ``or``, and ``not`` work
@@ -128,7 +128,7 @@ treated as true.
 Note that ``and`` and ``or`` return the last evaluated operand,
 while not always returns a boolean value.
 
-Built-in Functions
+Built-in functions
 ^^^^^^^^^^^^^^^^^^
 
 These functions are applied to each individual pixel.
diff --git a/docs/reference/ImageMorph.rst b/docs/reference/ImageMorph.rst
index d4522a06ae3..30b89a54df5 100644
--- a/docs/reference/ImageMorph.rst
+++ b/docs/reference/ImageMorph.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageMorph
 .. py:currentmodule:: PIL.ImageMorph
 
-:py:mod:`~PIL.ImageMorph` Module
+:py:mod:`~PIL.ImageMorph` module
 ================================
 
 The :py:mod:`~PIL.ImageMorph` module provides morphology operations on images.
diff --git a/docs/reference/ImageOps.rst b/docs/reference/ImageOps.rst
index fcaa3c8f675..1ecff09f000 100644
--- a/docs/reference/ImageOps.rst
+++ b/docs/reference/ImageOps.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageOps
 .. py:currentmodule:: PIL.ImageOps
 
-:py:mod:`~PIL.ImageOps` Module
+:py:mod:`~PIL.ImageOps` module
 ==============================
 
 The :py:mod:`~PIL.ImageOps` module contains a number of ‘ready-made’ image
diff --git a/docs/reference/ImagePalette.rst b/docs/reference/ImagePalette.rst
index 72ccfac7d83..42ce5cb134c 100644
--- a/docs/reference/ImagePalette.rst
+++ b/docs/reference/ImagePalette.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImagePalette
 .. py:currentmodule:: PIL.ImagePalette
 
-:py:mod:`~PIL.ImagePalette` Module
+:py:mod:`~PIL.ImagePalette` module
 ==================================
 
 The :py:mod:`~PIL.ImagePalette` module contains a class of the same name to
diff --git a/docs/reference/ImagePath.rst b/docs/reference/ImagePath.rst
index 23544b613a0..5f560634998 100644
--- a/docs/reference/ImagePath.rst
+++ b/docs/reference/ImagePath.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImagePath
 .. py:currentmodule:: PIL.ImagePath
 
-:py:mod:`~PIL.ImagePath` Module
+:py:mod:`~PIL.ImagePath` module
 ===============================
 
 The :py:mod:`~PIL.ImagePath` module is used to store and manipulate 2-dimensional
diff --git a/docs/reference/ImageQt.rst b/docs/reference/ImageQt.rst
index 7e67a44d364..88d7b8a2095 100644
--- a/docs/reference/ImageQt.rst
+++ b/docs/reference/ImageQt.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageQt
 .. py:currentmodule:: PIL.ImageQt
 
-:py:mod:`~PIL.ImageQt` Module
+:py:mod:`~PIL.ImageQt` module
 =============================
 
 The :py:mod:`~PIL.ImageQt` module contains support for creating PyQt6 or PySide6
diff --git a/docs/reference/ImageSequence.rst b/docs/reference/ImageSequence.rst
index a27b2fb4efc..0d6f394dd6f 100644
--- a/docs/reference/ImageSequence.rst
+++ b/docs/reference/ImageSequence.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageSequence
 .. py:currentmodule:: PIL.ImageSequence
 
-:py:mod:`~PIL.ImageSequence` Module
+:py:mod:`~PIL.ImageSequence` module
 ===================================
 
 The :py:mod:`~PIL.ImageSequence` module contains a wrapper class that lets you
diff --git a/docs/reference/ImageShow.rst b/docs/reference/ImageShow.rst
index 5cedede69e6..12c8741cee2 100644
--- a/docs/reference/ImageShow.rst
+++ b/docs/reference/ImageShow.rst
@@ -1,10 +1,10 @@
 .. py:module:: PIL.ImageShow
 .. py:currentmodule:: PIL.ImageShow
 
-:py:mod:`~PIL.ImageShow` Module
+:py:mod:`~PIL.ImageShow` module
 ===============================
 
-The :py:mod:`~PIL.ImageShow` Module is used to display images.
+The :py:mod:`~PIL.ImageShow` module is used to display images.
 All default viewers convert the image to be shown to PNG format.
 
 .. autofunction:: PIL.ImageShow.show
diff --git a/docs/reference/ImageStat.rst b/docs/reference/ImageStat.rst
index f694663828a..ede1199209c 100644
--- a/docs/reference/ImageStat.rst
+++ b/docs/reference/ImageStat.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageStat
 .. py:currentmodule:: PIL.ImageStat
 
-:py:mod:`~PIL.ImageStat` Module
+:py:mod:`~PIL.ImageStat` module
 ===============================
 
 The :py:mod:`~PIL.ImageStat` module calculates global statistics for an image, or
diff --git a/docs/reference/ImageTk.rst b/docs/reference/ImageTk.rst
index 134ef565188..3ab72b83dbf 100644
--- a/docs/reference/ImageTk.rst
+++ b/docs/reference/ImageTk.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageTk
 .. py:currentmodule:: PIL.ImageTk
 
-:py:mod:`~PIL.ImageTk` Module
+:py:mod:`~PIL.ImageTk` module
 =============================
 
 The :py:mod:`~PIL.ImageTk` module contains support to create and modify Tkinter
diff --git a/docs/reference/ImageTransform.rst b/docs/reference/ImageTransform.rst
index 5b0a5ce49dc..5302799349a 100644
--- a/docs/reference/ImageTransform.rst
+++ b/docs/reference/ImageTransform.rst
@@ -2,7 +2,7 @@
 .. py:module:: PIL.ImageTransform
 .. py:currentmodule:: PIL.ImageTransform
 
-:py:mod:`~PIL.ImageTransform` Module
+:py:mod:`~PIL.ImageTransform` module
 ====================================
 
 The :py:mod:`~PIL.ImageTransform` module contains implementations of
diff --git a/docs/reference/ImageWin.rst b/docs/reference/ImageWin.rst
index 4151be4a746..c0b9bd2ba95 100644
--- a/docs/reference/ImageWin.rst
+++ b/docs/reference/ImageWin.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.ImageWin
 .. py:currentmodule:: PIL.ImageWin
 
-:py:mod:`~PIL.ImageWin` Module (Windows-only)
+:py:mod:`~PIL.ImageWin` module (Windows-only)
 =============================================
 
 The :py:mod:`~PIL.ImageWin` module contains support to create and display images on
diff --git a/docs/reference/JpegPresets.rst b/docs/reference/JpegPresets.rst
index aafae44cf4a..b0a3ba8b532 100644
--- a/docs/reference/JpegPresets.rst
+++ b/docs/reference/JpegPresets.rst
@@ -1,6 +1,6 @@
 .. py:currentmodule:: PIL.JpegPresets
 
-:py:mod:`~PIL.JpegPresets` Module
+:py:mod:`~PIL.JpegPresets` module
 =================================
 
 .. automodule:: PIL.JpegPresets
diff --git a/docs/reference/PSDraw.rst b/docs/reference/PSDraw.rst
index 3e8512e7aa8..9eed775fc09 100644
--- a/docs/reference/PSDraw.rst
+++ b/docs/reference/PSDraw.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.PSDraw
 .. py:currentmodule:: PIL.PSDraw
 
-:py:mod:`~PIL.PSDraw` Module
+:py:mod:`~PIL.PSDraw` module
 ============================
 
 The :py:mod:`~PIL.PSDraw` module provides simple print support for PostScript
diff --git a/docs/reference/PixelAccess.rst b/docs/reference/PixelAccess.rst
index 1ac3d034b49..9d7cf83b640 100644
--- a/docs/reference/PixelAccess.rst
+++ b/docs/reference/PixelAccess.rst
@@ -1,6 +1,6 @@
 .. _PixelAccess:
 
-:py:class:`PixelAccess` Class
+:py:class:`PixelAccess` class
 =============================
 
 The PixelAccess class provides read and write access to
@@ -40,7 +40,7 @@ Access using negative indexes is also possible. ::
 
 
 
-:py:class:`PixelAccess` Class
+:py:class:`PixelAccess` class
 -----------------------------
 
 .. class:: PixelAccess
diff --git a/docs/reference/TiffTags.rst b/docs/reference/TiffTags.rst
index 7cb7d16ae47..d75a4847897 100644
--- a/docs/reference/TiffTags.rst
+++ b/docs/reference/TiffTags.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.TiffTags
 .. py:currentmodule:: PIL.TiffTags
 
-:py:mod:`~PIL.TiffTags` Module
+:py:mod:`~PIL.TiffTags` module
 ==============================
 
 The :py:mod:`~PIL.TiffTags` module exposes many of the standard TIFF
diff --git a/docs/reference/arrow_support.rst b/docs/reference/arrow_support.rst
index 4a5c45e8624..063046d8c22 100644
--- a/docs/reference/arrow_support.rst
+++ b/docs/reference/arrow_support.rst
@@ -1,7 +1,7 @@
 .. _arrow-support:
 
 =============
-Arrow Support
+Arrow support
 =============
 
 `Arrow <https://arrow.apache.org/>`__
@@ -18,7 +18,7 @@ with any Arrow provider or consumer in the Python ecosystem.
   full-copy memory cost to reading an Arrow image.
 
 
-Data Formats
+Data formats
 ============
 
 Pillow currently supports exporting Arrow images in all modes
@@ -43,7 +43,7 @@ interpreted using the mode-specific interpretation of the bytes.
 The image mode must match the Arrow band format when reading single
 channel images.
 
-Memory Allocator
+Memory allocator
 ================
 
 Pillow's default memory allocator, the :ref:`block_allocator`,
@@ -59,7 +59,7 @@ To enable the single block allocator::
 
 Note that this is a global setting, not a per-image setting.
 
-Unsupported Features
+Unsupported features
 ====================
 
 * Table/dataframe protocol. We support a single array.
@@ -71,7 +71,7 @@ Unsupported Features
   parameter.
 * Array metadata.
 
-Internal Details
+Internal details
 ================
 
 Python Arrow C interface:
diff --git a/docs/reference/block_allocator.rst b/docs/reference/block_allocator.rst
index c6be5b7e6ed..5ad9d9fd123 100644
--- a/docs/reference/block_allocator.rst
+++ b/docs/reference/block_allocator.rst
@@ -1,10 +1,10 @@
 
 .. _block_allocator:
 
-Block Allocator
+Block allocator
 ===============
 
-Previous Design
+Previous design
 ---------------
 
 Historically there have been two image allocators in Pillow:
@@ -16,7 +16,7 @@ large images and makes one allocation for each scan line of size
 between one allocation and potentially thousands of small allocations,
 leading to unpredictable performance penalties around the transition.
 
-New Design
+New design
 ----------
 
 ``ImagingAllocateArray`` now allocates space for images as a chain of
@@ -28,7 +28,7 @@ line. This is now the default for all internal allocations.
 specifically requesting a single segment of memory for sharing with
 other code.
 
-Memory Pools
+Memory pools
 ------------
 
 There is now a memory pool to contain a supply of recently freed
diff --git a/docs/reference/c_extension_debugging.rst b/docs/reference/c_extension_debugging.rst
index 5e85869058c..12dca6cf2c9 100644
--- a/docs/reference/c_extension_debugging.rst
+++ b/docs/reference/c_extension_debugging.rst
@@ -1,5 +1,5 @@
-C Extension debugging on Linux, with gbd/valgrind.
-==================================================
+C extension debugging on Linux, with GBD/Valgrind
+=================================================
 
 Install the tools
 -----------------
@@ -17,7 +17,7 @@ Then ``sudo apt-get install libtiff5-dbgsym``
 
 -  There's a bug with the ``python3-dbg`` package for at least Python 3.8 on
    Ubuntu 20.04, and you need to add a new link or two to make it autoload when
-   running python:
+   running Python:
 
 ::
 
@@ -49,7 +49,7 @@ Then ``sudo apt-get install libtiff5-dbgsym``
     source ~/vpy38-dbg/bin/activate
     cd ~/Pillow && make install
 
-Test Case
+Test case
 ---------
 
 Take your test image, and make a really simple harness.
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index c5d89b838d9..381d7830aac 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -1,7 +1,7 @@
 .. py:module:: PIL.features
 .. py:currentmodule:: PIL.features
 
-:py:mod:`~PIL.features` Module
+:py:mod:`~PIL.features` module
 ==============================
 
 The :py:mod:`PIL.features` module can be used to detect which Pillow features are available on your system.
diff --git a/docs/reference/internal_design.rst b/docs/reference/internal_design.rst
index 0411779535b..6bba673b9d6 100644
--- a/docs/reference/internal_design.rst
+++ b/docs/reference/internal_design.rst
@@ -1,4 +1,4 @@
-Internal Reference
+Internal reference
 ==================
 
 .. toctree::
diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index 93fd82cf9df..19f78864d1d 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -1,7 +1,7 @@
-Internal Modules
+Internal modules
 ================
 
-:mod:`~PIL._binary` Module
+:mod:`~PIL._binary` module
 --------------------------
 
 .. automodule:: PIL._binary
@@ -9,7 +9,7 @@ Internal Modules
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL._deprecate` Module
+:mod:`~PIL._deprecate` module
 -----------------------------
 
 .. automodule:: PIL._deprecate
@@ -17,7 +17,7 @@ Internal Modules
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL._tkinter_finder` Module
+:mod:`~PIL._tkinter_finder` module
 ----------------------------------
 
 .. automodule:: PIL._tkinter_finder
@@ -25,7 +25,7 @@ Internal Modules
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL._typing` Module
+:mod:`~PIL._typing` module
 --------------------------
 
 .. module:: PIL._typing
@@ -58,7 +58,7 @@ on some Python versions.
 
     See :py:obj:`typing.TypeGuard`.
 
-:mod:`~PIL._util` Module
+:mod:`~PIL._util` module
 ------------------------
 
 .. automodule:: PIL._util
@@ -66,7 +66,7 @@ on some Python versions.
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL._version` Module
+:mod:`~PIL._version` module
 ---------------------------
 
 .. module:: PIL._version
@@ -78,7 +78,7 @@ on some Python versions.
     This is the master version number for Pillow,
     all other uses reference this module.
 
-:mod:`PIL.Image.core` Module
+:mod:`PIL.Image.core` module
 ----------------------------
 
 .. module:: PIL._imaging
diff --git a/docs/reference/limits.rst b/docs/reference/limits.rst
index a71b514b5aa..d2f8f7d1fab 100644
--- a/docs/reference/limits.rst
+++ b/docs/reference/limits.rst
@@ -4,7 +4,7 @@ Limits
 This page is documentation to the various fundamental size limits in
 the Pillow implementation.
 
-Internal Limits
+Internal limits
 ===============
 
 * Image sizes cannot be negative. These are checked both in
@@ -25,10 +25,10 @@ Internal Limits
   is smaller than 2GB, as calculated by ``y*stride`` (so 2Gpx for 'L'
   images, and .5Gpx for 'RGB'
 
-Format Size Limits
+Format size limits
 ==================
 
 * ICO: Max size is 256x256
 
-* Webp: 16383x16383 (underlying library size limit:
+* WebP: 16383x16383 (underlying library size limit:
   https://developers.google.com/speed/webp/docs/api)
diff --git a/docs/reference/open_files.rst b/docs/reference/open_files.rst
index 730c8da5b80..0d43cbc730e 100644
--- a/docs/reference/open_files.rst
+++ b/docs/reference/open_files.rst
@@ -1,6 +1,6 @@
 .. _file-handling:
 
-File Handling in Pillow
+File handling in Pillow
 =======================
 
 When opening a file as an image, Pillow requires a filename, ``os.PathLike``
@@ -36,7 +36,7 @@ have multiple frames.
 Pillow cannot in general close and reopen a file, so any access to
 that file needs to be prior to the close.
 
-Image Lifecycle
+Image lifecycle
 ---------------
 
 * ``Image.open()`` Filenames and ``Path`` objects are opened as a file.
@@ -97,7 +97,7 @@ Complications
     im6.load()  # FAILS, closed file
 
 
-Proposed File Handling
+Proposed file handling
 ----------------------
 
 * ``Image.Image.load()`` should close the image file, unless there are
diff --git a/docs/reference/plugins.rst b/docs/reference/plugins.rst
index c789f575700..243d4f353f5 100644
--- a/docs/reference/plugins.rst
+++ b/docs/reference/plugins.rst
@@ -1,7 +1,7 @@
 Plugin reference
 ================
 
-:mod:`~PIL.AvifImagePlugin` Module
+:mod:`~PIL.AvifImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.AvifImagePlugin
@@ -9,7 +9,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.BmpImagePlugin` Module
+:mod:`~PIL.BmpImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.BmpImagePlugin
@@ -17,7 +17,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.BufrStubImagePlugin` Module
+:mod:`~PIL.BufrStubImagePlugin` module
 --------------------------------------
 
 .. automodule:: PIL.BufrStubImagePlugin
@@ -25,7 +25,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.CurImagePlugin` Module
+:mod:`~PIL.CurImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.CurImagePlugin
@@ -33,7 +33,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.DcxImagePlugin` Module
+:mod:`~PIL.DcxImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.DcxImagePlugin
@@ -41,7 +41,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.DdsImagePlugin` Module
+:mod:`~PIL.DdsImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.DdsImagePlugin
@@ -49,7 +49,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.EpsImagePlugin` Module
+:mod:`~PIL.EpsImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.EpsImagePlugin
@@ -57,15 +57,15 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.FitsImagePlugin` Module
---------------------------------------
+:mod:`~PIL.FitsImagePlugin` module
+----------------------------------
 
 .. automodule:: PIL.FitsImagePlugin
     :members:
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.FliImagePlugin` Module
+:mod:`~PIL.FliImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.FliImagePlugin
@@ -73,7 +73,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.FpxImagePlugin` Module
+:mod:`~PIL.FpxImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.FpxImagePlugin
@@ -81,7 +81,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.GbrImagePlugin` Module
+:mod:`~PIL.GbrImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.GbrImagePlugin
@@ -89,7 +89,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.GifImagePlugin` Module
+:mod:`~PIL.GifImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.GifImagePlugin
@@ -97,7 +97,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.GribStubImagePlugin` Module
+:mod:`~PIL.GribStubImagePlugin` module
 --------------------------------------
 
 .. automodule:: PIL.GribStubImagePlugin
@@ -105,7 +105,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.Hdf5StubImagePlugin` Module
+:mod:`~PIL.Hdf5StubImagePlugin` module
 --------------------------------------
 
 .. automodule:: PIL.Hdf5StubImagePlugin
@@ -113,7 +113,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.IcnsImagePlugin` Module
+:mod:`~PIL.IcnsImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.IcnsImagePlugin
@@ -121,7 +121,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.IcoImagePlugin` Module
+:mod:`~PIL.IcoImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.IcoImagePlugin
@@ -129,7 +129,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.ImImagePlugin` Module
+:mod:`~PIL.ImImagePlugin` module
 --------------------------------
 
 .. automodule:: PIL.ImImagePlugin
@@ -137,7 +137,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.ImtImagePlugin` Module
+:mod:`~PIL.ImtImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.ImtImagePlugin
@@ -145,7 +145,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.IptcImagePlugin` Module
+:mod:`~PIL.IptcImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.IptcImagePlugin
@@ -153,7 +153,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.JpegImagePlugin` Module
+:mod:`~PIL.JpegImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.JpegImagePlugin
@@ -161,7 +161,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.Jpeg2KImagePlugin` Module
+:mod:`~PIL.Jpeg2KImagePlugin` module
 ------------------------------------
 
 .. automodule:: PIL.Jpeg2KImagePlugin
@@ -169,7 +169,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.McIdasImagePlugin` Module
+:mod:`~PIL.McIdasImagePlugin` module
 ------------------------------------
 
 .. automodule:: PIL.McIdasImagePlugin
@@ -177,7 +177,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.MicImagePlugin` Module
+:mod:`~PIL.MicImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.MicImagePlugin
@@ -185,7 +185,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.MpegImagePlugin` Module
+:mod:`~PIL.MpegImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.MpegImagePlugin
@@ -193,15 +193,15 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.MpoImagePlugin` Module
-----------------------------------
+:mod:`~PIL.MpoImagePlugin` module
+---------------------------------
 
 .. automodule:: PIL.MpoImagePlugin
     :members:
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.MspImagePlugin` Module
+:mod:`~PIL.MspImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.MspImagePlugin
@@ -209,7 +209,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PalmImagePlugin` Module
+:mod:`~PIL.PalmImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.PalmImagePlugin
@@ -217,7 +217,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PcdImagePlugin` Module
+:mod:`~PIL.PcdImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.PcdImagePlugin
@@ -225,7 +225,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PcxImagePlugin` Module
+:mod:`~PIL.PcxImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.PcxImagePlugin
@@ -233,7 +233,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PdfImagePlugin` Module
+:mod:`~PIL.PdfImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.PdfImagePlugin
@@ -241,7 +241,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PixarImagePlugin` Module
+:mod:`~PIL.PixarImagePlugin` module
 -----------------------------------
 
 .. automodule:: PIL.PixarImagePlugin
@@ -249,7 +249,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PngImagePlugin` Module
+:mod:`~PIL.PngImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.PngImagePlugin
@@ -260,7 +260,7 @@ Plugin reference
     :member-order: groupwise
 
 
-:mod:`~PIL.PpmImagePlugin` Module
+:mod:`~PIL.PpmImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.PpmImagePlugin
@@ -268,7 +268,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.PsdImagePlugin` Module
+:mod:`~PIL.PsdImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.PsdImagePlugin
@@ -276,7 +276,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.SgiImagePlugin` Module
+:mod:`~PIL.SgiImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.SgiImagePlugin
@@ -284,7 +284,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.SpiderImagePlugin` Module
+:mod:`~PIL.SpiderImagePlugin` module
 ------------------------------------
 
 .. automodule:: PIL.SpiderImagePlugin
@@ -292,7 +292,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.SunImagePlugin` Module
+:mod:`~PIL.SunImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.SunImagePlugin
@@ -300,7 +300,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.TgaImagePlugin` Module
+:mod:`~PIL.TgaImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.TgaImagePlugin
@@ -308,7 +308,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.TiffImagePlugin` Module
+:mod:`~PIL.TiffImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.TiffImagePlugin
@@ -316,7 +316,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.WebPImagePlugin` Module
+:mod:`~PIL.WebPImagePlugin` module
 ----------------------------------
 
 .. automodule:: PIL.WebPImagePlugin
@@ -324,7 +324,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.WmfImagePlugin` Module
+:mod:`~PIL.WmfImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.WmfImagePlugin
@@ -332,7 +332,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.XVThumbImagePlugin` Module
+:mod:`~PIL.XVThumbImagePlugin` module
 -------------------------------------
 
 .. automodule:: PIL.XVThumbImagePlugin
@@ -340,7 +340,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.XbmImagePlugin` Module
+:mod:`~PIL.XbmImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.XbmImagePlugin
@@ -348,7 +348,7 @@ Plugin reference
     :undoc-members:
     :show-inheritance:
 
-:mod:`~PIL.XpmImagePlugin` Module
+:mod:`~PIL.XpmImagePlugin` module
 ---------------------------------
 
 .. automodule:: PIL.XpmImagePlugin
diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index 2ea973c5c76..3e2aa84b1ce 100644
--- a/docs/releasenotes/10.0.0.rst
+++ b/docs/releasenotes/10.0.0.rst
@@ -28,7 +28,7 @@ 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
+Backwards incompatible changes
 ==============================
 
 Categories
@@ -164,7 +164,7 @@ Since Pillow's C API is now faster than PyAccess on PyPy,
 ``Image.USE_CFFI_ACCESS``, for switching from the C API to PyAccess, is
 similarly deprecated.
 
-API Changes
+API changes
 ===========
 
 Added line width parameter to ImageDraw regular_polygon
@@ -173,7 +173,7 @@ Added line width parameter to ImageDraw regular_polygon
 An optional line ``width`` parameter has been added to
 ``ImageDraw.Draw.regular_polygon``.
 
-API Additions
+API additions
 =============
 
 Added ``alpha_only`` argument to ``getbbox()``
@@ -184,7 +184,7 @@ Added ``alpha_only`` argument to ``getbbox()``
 and the image has an alpha channel, trim transparent pixels. Otherwise, trim
 pixels when all channels are zero.
 
-Other Changes
+Other changes
 =============
 
 32-bit wheels
diff --git a/docs/releasenotes/10.0.1.rst b/docs/releasenotes/10.0.1.rst
index 02189d51405..aa17a62e02b 100644
--- a/docs/releasenotes/10.0.1.rst
+++ b/docs/releasenotes/10.0.1.rst
@@ -11,7 +11,7 @@ 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
+Other changes
 =============
 
 Updated tests to pass with latest zlib version
diff --git a/docs/releasenotes/10.1.0.rst b/docs/releasenotes/10.1.0.rst
index fd556bdf17f..649c2bdf971 100644
--- a/docs/releasenotes/10.1.0.rst
+++ b/docs/releasenotes/10.1.0.rst
@@ -1,7 +1,7 @@
 10.1.0
 ------
 
-API Changes
+API changes
 ===========
 
 Setting image mode
@@ -35,7 +35,7 @@ to be specified, rather than a single number for both dimensions. ::
     ImageFilter.BoxBlur((2, 5))
     ImageFilter.GaussianBlur((2, 5))
 
-API Additions
+API additions
 =============
 
 EpsImagePlugin.gs_binary
@@ -84,7 +84,7 @@ font size for this new builtin font::
     draw.multiline_text((0, 0), "test", font_size=24)
     draw.multiline_textbbox((0, 0), "test", font_size=24)
 
-Other Changes
+Other changes
 =============
 
 Python 3.12
diff --git a/docs/releasenotes/10.2.0.rst b/docs/releasenotes/10.2.0.rst
index 1c6b78b0841..3377487857e 100644
--- a/docs/releasenotes/10.2.0.rst
+++ b/docs/releasenotes/10.2.0.rst
@@ -53,7 +53,7 @@ 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.
 
-API Changes
+API changes
 ===========
 
 Zero or negative font size error
@@ -63,7 +63,7 @@ When creating a :py:class:`~PIL.ImageFont.FreeTypeFont` instance, either directl
 through :py:func:`~PIL.ImageFont.truetype`, if the font size is zero or less, a
 :py:exc:`ValueError` will now be raised.
 
-API Additions
+API additions
 =============
 
 Added DdsImagePlugin enums
@@ -95,7 +95,7 @@ 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.
 
-Other Changes
+Other changes
 =============
 
 Added DDS BC4U and DX10 BC1 and BC4 reading
diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index 2f0437d94f9..6c7d8ea0a11 100644
--- a/docs/releasenotes/10.3.0.rst
+++ b/docs/releasenotes/10.3.0.rst
@@ -65,7 +65,7 @@ ImageMath.eval()
 :py:meth:`~PIL.ImageMath.unsafe_eval` instead. See earlier security notes for more
 information.
 
-API Changes
+API changes
 ===========
 
 Added alpha_quality argument when saving WebP images
@@ -87,7 +87,7 @@ 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
+API additions
 =============
 
 Added PerspectiveTransform
@@ -97,7 +97,7 @@ Added PerspectiveTransform
 that all of the :py:data:`~PIL.Image.Transform` values now have a corresponding
 subclass of :py:class:`~PIL.ImageTransform.Transform`.
 
-Other Changes
+Other changes
 =============
 
 Portable FloatMap (PFM) images
diff --git a/docs/releasenotes/10.4.0.rst b/docs/releasenotes/10.4.0.rst
index 8d3706be617..84a6091c96d 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -41,7 +41,7 @@ ImageDraw.getdraw hints parameter
 
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
 
-API Additions
+API additions
 =============
 
 ImageDraw.circle
@@ -51,7 +51,7 @@ 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.
 
-Other Changes
+Other changes
 =============
 
 Python 3.13 beta
diff --git a/docs/releasenotes/11.0.0.rst b/docs/releasenotes/11.0.0.rst
index c3f18140f42..020fbf7df7d 100644
--- a/docs/releasenotes/11.0.0.rst
+++ b/docs/releasenotes/11.0.0.rst
@@ -1,7 +1,7 @@
 11.0.0
 ------
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Python 3.8
@@ -103,7 +103,7 @@ 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
+Specific WebP feature checks
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 11.0.0
@@ -113,7 +113,7 @@ Specific WebP Feature Checks
 ``True`` if the WebP module is installed, until they are removed in Pillow
 12.0.0 (2025-10-15).
 
-API Changes
+API changes
 ===========
 
 Default resampling filter for I;16* image modes
@@ -122,7 +122,7 @@ Default resampling filter for I;16* image modes
 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
+API additions
 =============
 
 Writing XMP bytes to JPEG and MPO
@@ -138,7 +138,7 @@ either JPEG or MPO images::
     im.info["xmp"] = b"test"
     im.save("out.jpg")
 
-Other Changes
+Other changes
 =============
 
 Python 3.13
@@ -154,7 +154,7 @@ Support has also been added for the experimental free-threaded mode of :pep:`703
 
 Python 3.13 only supports macOS versions 10.13 and later.
 
-C-level Flags
+C-level flags
 ^^^^^^^^^^^^^
 
 Some compiling flags like ``WITH_THREADING``, ``WITH_IMAGECHOPS``, and other
diff --git a/docs/releasenotes/11.1.0.rst b/docs/releasenotes/11.1.0.rst
index 0d56cb4204b..4888ddf56d3 100644
--- a/docs/releasenotes/11.1.0.rst
+++ b/docs/releasenotes/11.1.0.rst
@@ -10,7 +10,7 @@ ExifTags.IFD.Makernote
 ``ExifTags.IFD.Makernote`` has been deprecated. Instead, use
 ``ExifTags.IFD.MakerNote``.
 
-API Changes
+API changes
 ===========
 
 Writing XMP bytes to JPEG and MPO
@@ -34,7 +34,7 @@ be used::
     second_im.encoderinfo = {"xmp": b"test"}
     im.save("out.mpo", save_all=True, append_images=[second_im])
 
-API Additions
+API additions
 =============
 
 Check for zlib-ng
@@ -54,7 +54,7 @@ TIFF images can now be saved as BigTIFF using a ``big_tiff`` argument::
 
     im.save("out.tiff", big_tiff=True)
 
-Other Changes
+Other changes
 =============
 
 Reading JPEG 2000 comments
diff --git a/docs/releasenotes/11.2.1.rst b/docs/releasenotes/11.2.1.rst
index 5c6d40d9df3..f55b0d7d776 100644
--- a/docs/releasenotes/11.2.1.rst
+++ b/docs/releasenotes/11.2.1.rst
@@ -32,7 +32,7 @@ Image.Image.get_child_images()
 method uses an image's file pointer, and so child images could only be retrieved from
 an :py:class:`PIL.ImageFile.ImageFile` instance.
 
-API Changes
+API changes
 ===========
 
 ``append_images`` no longer requires ``save_all``
@@ -44,7 +44,7 @@ supports saving multiple frames::
 
     im.save("out.gif", append_images=ims)
 
-API Additions
+API additions
 =============
 
 ``"justify"`` multiline text alignment
@@ -86,7 +86,7 @@ DXT5, BC2, BC3 and BC5 are supported::
 
     im.save("out.dds", pixel_format="DXT1")
 
-Other Changes
+Other changes
 =============
 
 Arrow support
diff --git a/docs/releasenotes/2.7.0.rst b/docs/releasenotes/2.7.0.rst
index e9b0995bb9f..a1ddd117873 100644
--- a/docs/releasenotes/2.7.0.rst
+++ b/docs/releasenotes/2.7.0.rst
@@ -1,13 +1,13 @@
 2.7.0
 -----
 
-Sane Plugin
+Sane plugin
 ^^^^^^^^^^^
 
 The Sane plugin has now been split into its own repo:
 https://github.com/python-pillow/Sane .
 
-Png text chunk size limits
+PNG text chunk size limits
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To prevent potential denial of service attacks using compressed text
@@ -155,7 +155,7 @@ so the quality was worse compared to other Gaussian blur software.
 
 The new implementation does not have this drawback.
 
-TIFF Parameter Changes
+TIFF parameter changes
 ^^^^^^^^^^^^^^^^^^^^^^
 
 Several kwarg parameters for saving TIFF images were previously
diff --git a/docs/releasenotes/3.0.0.rst b/docs/releasenotes/3.0.0.rst
index 8bc477f7020..dcd8031f588 100644
--- a/docs/releasenotes/3.0.0.rst
+++ b/docs/releasenotes/3.0.0.rst
@@ -1,7 +1,7 @@
 3.0.0
 -----
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Several methods that have been marked as deprecated for many releases
@@ -18,10 +18,10 @@ have been removed in this release:
 * ``ImageWin.fromstring()``
 * ``ImageWin.tostring()``
 
-Other Changes
+Other changes
 =============
 
-Saving Multipage Images
+Saving multipage images
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 There is now support for saving multipage images in the ``GIF`` and
@@ -30,10 +30,10 @@ as a keyword argument to the save::
 
     im.save('test.pdf', save_all=True)
 
-Tiff ImageFileDirectory Rewrite
+TIFF ImageFileDirectory rewrite
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-The Tiff ImageFileDirectory metadata code has been rewritten. Where
+The TIFF ImageFileDirectory metadata code has been rewritten. Where
 previously it returned a somewhat arbitrary set of values and tuples,
 it now returns bare values where appropriate and tuples when the
 metadata item is a sequence or collection.
@@ -41,7 +41,7 @@ metadata item is a sequence or collection.
 The original metadata is still available in the TiffImage.tags, the
 new values are available in the TiffImage.tags_v2 member. The old
 structures will be deprecated at some point in the future.  When
-saving Tiff metadata, new code should use the
+saving TIFF metadata, new code should use the
 TiffImagePlugin.ImageFileDirectory_v2 class.
 
 LibJpeg and Zlib are required by default
diff --git a/docs/releasenotes/3.1.0.rst b/docs/releasenotes/3.1.0.rst
index 951819f1956..90f77ff6150 100644
--- a/docs/releasenotes/3.1.0.rst
+++ b/docs/releasenotes/3.1.0.rst
@@ -22,7 +22,7 @@ not the absolute height of each line.
 
 There is also now a default spacing of 4px between lines.
 
-Exif, Jpeg and Tiff Metadata
+EXIF, JPEG and TIFF metadata
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There were major changes in the TIFF ImageFileDirectory support in
@@ -63,7 +63,7 @@ single item tuples have been unwrapped and return a bare element.
 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
+Out of spec metadata
 ++++++++++++++++++++
 
 In Pillow 3.0 and 3.1, images that contain metadata that is internally
diff --git a/docs/releasenotes/3.2.0.rst b/docs/releasenotes/3.2.0.rst
index 3ed8fae574b..20d7d073eee 100644
--- a/docs/releasenotes/3.2.0.rst
+++ b/docs/releasenotes/3.2.0.rst
@@ -1,7 +1,7 @@
 3.2.0
 -----
 
-New DDS and FTEX Image Plugins
+New DDS and FTEX image plugins
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The ``DdsImagePlugin`` reading DXT1 and DXT5 encoded ``.dds`` images was
@@ -18,7 +18,7 @@ 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.
 
-Passthrough Parameters for ImageDraw.text
+Passthrough parameters for ImageDraw.text
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 ``ImageDraw.multiline_text`` and ``ImageDraw.multiline_size`` take extra
diff --git a/docs/releasenotes/3.3.0.rst b/docs/releasenotes/3.3.0.rst
index cd6f7e2f93c..9447245c495 100644
--- a/docs/releasenotes/3.3.0.rst
+++ b/docs/releasenotes/3.3.0.rst
@@ -11,7 +11,7 @@ libimagequant. We cannot distribute binaries due to licensing
 differences.
 
 
-New Setup.py options
+New setup.py options
 ^^^^^^^^^^^^^^^^^^^^
 
 There are two new options to control the ``build_ext`` task in ``setup.py``:
@@ -43,7 +43,7 @@ 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
+Image metadata
 ^^^^^^^^^^^^^^
 
 The return type for binary data in version 2 Exif and Tiff metadata
diff --git a/docs/releasenotes/3.3.2.rst b/docs/releasenotes/3.3.2.rst
index 73156a65dbb..60ffbdcbadb 100644
--- a/docs/releasenotes/3.3.2.rst
+++ b/docs/releasenotes/3.3.2.rst
@@ -4,7 +4,7 @@
 Security
 ========
 
-Integer overflow in Map.c
+Integer overflow in map.c
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow prior to 3.3.2 may experience integer overflow errors in map.c
@@ -27,7 +27,7 @@ memory without duplicating the image first.
 
 This issue was found by Cris Neckar at Divergent Security.
 
-Sign Extension in Storage.c
+Sign extension in Storage.c
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow prior to 3.3.2 and PIL 1.1.7 (at least) do not check for
diff --git a/docs/releasenotes/3.4.0.rst b/docs/releasenotes/3.4.0.rst
index 8a5a7efe350..01ec77a58cc 100644
--- a/docs/releasenotes/3.4.0.rst
+++ b/docs/releasenotes/3.4.0.rst
@@ -1,7 +1,7 @@
 3.4.0
 -----
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Image.core.open_ppm removed
@@ -14,7 +14,7 @@ been removed. If you were using this function, please use
 Deprecations
 ============
 
-Deprecation Warning when Saving JPEGs
+Deprecation warning when saving JPEGs
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 JPEG images cannot contain an alpha channel. Pillow prior to 3.4.0
@@ -22,7 +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.
 
-API Additions
+API additions
 =============
 
 New resizing filters
@@ -37,7 +37,7 @@ 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.
 
-New DDS Decoders
+New DDS decoders
 ^^^^^^^^^^^^^^^^
 
 Pillow can now decode DXT3 images, as well as the previously supported
diff --git a/docs/releasenotes/4.0.0.rst b/docs/releasenotes/4.0.0.rst
index 625f237e841..dd97463f6e3 100644
--- a/docs/releasenotes/4.0.0.rst
+++ b/docs/releasenotes/4.0.0.rst
@@ -1,7 +1,7 @@
 4.0.0
 -----
 
-Python 2.6 and 3.2 Dropped
+Python 2.6 and 3.2 dropped
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow 4.0 no longer supports Python 2.6 and 3.2. We will not be
diff --git a/docs/releasenotes/4.1.0.rst b/docs/releasenotes/4.1.0.rst
index 80ad9b9fb63..1f809ad18cb 100644
--- a/docs/releasenotes/4.1.0.rst
+++ b/docs/releasenotes/4.1.0.rst
@@ -15,10 +15,10 @@ Several deprecated items have been removed.
   ``PIL.ImageDraw.ImageDraw.setfont`` have been removed.
 
 
-Other Changes
+Other changes
 =============
 
-Closing Files When Opening Images
+Closing files when opening images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The file handling when opening images has been overhauled. Previously,
@@ -41,7 +41,7 @@ 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
+Changes to GIF handling when saving
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The :py:class:`PIL.GifImagePlugin` code has been refactored to fix the flow when
@@ -57,14 +57,14 @@ saving images. There are two external changes that arise from this:
 This refactor fixed some bugs with palette handling when saving
 multiple frame GIFs.
 
-New Method: Image.remap_palette
+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
+Added decoder registry and support for Python-based decoders
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 There is now a decoder registry similar to the image plugin
diff --git a/docs/releasenotes/4.1.1.rst b/docs/releasenotes/4.1.1.rst
index 8c8055bfad8..1cbd3853b30 100644
--- a/docs/releasenotes/4.1.1.rst
+++ b/docs/releasenotes/4.1.1.rst
@@ -1,7 +1,7 @@
 4.1.1
 -----
 
-Fix Regression with reading DPI from EXIF data
+Fix regression with reading DPI from EXIF data
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Some JPEG images don't contain DPI information in the image metadata,
diff --git a/docs/releasenotes/4.2.0.rst b/docs/releasenotes/4.2.0.rst
index bc2a45f025f..0ea3de39906 100644
--- a/docs/releasenotes/4.2.0.rst
+++ b/docs/releasenotes/4.2.0.rst
@@ -1,7 +1,7 @@
 4.2.0
 -----
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Several deprecated items have been removed
@@ -17,17 +17,17 @@ Several deprecated items have been removed
   was shown. From Pillow 4.2.0, the deprecation warning is removed and
   an :py:exc:`IOError` is raised.
 
-Removed Core Image Function
+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
+Other changes
 =============
 
-Added Complex Text Rendering
+Added complex text rendering
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow now supports complex text rendering for scripts requiring glyph
@@ -36,7 +36,7 @@ dependencies: harfbuzz, fribidi, and raqm. See the :doc:`install documentation
 <../installation>` for further details. This feature is tested and works on
 Unix and Mac, but has not yet been built on Windows platforms.
 
-New Optional Parameters
+New optional parameters
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 * :py:meth:`PIL.ImageDraw.floodfill` has a new optional parameter:
@@ -47,7 +47,7 @@ New Optional Parameters
   optional parameter for specifying additional images to create
   multipage outputs.
 
-New DecompressionBomb Warning
+New DecompressionBomb warning
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 :py:meth:`PIL.Image.Image.crop` now may raise a DecompressionBomb
diff --git a/docs/releasenotes/4.2.1.rst b/docs/releasenotes/4.2.1.rst
index 2061f646746..617d51e52c2 100644
--- a/docs/releasenotes/4.2.1.rst
+++ b/docs/releasenotes/4.2.1.rst
@@ -3,7 +3,7 @@
 
 There are no functional changes in this release.
 
-Fixed Windows PyPy Build
+Fixed Windows PyPy build
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 A change in the 4.2.0 cycle broke the Windows PyPy build. This has
diff --git a/docs/releasenotes/4.3.0.rst b/docs/releasenotes/4.3.0.rst
index ea81fc45ea0..87a57799f5a 100644
--- a/docs/releasenotes/4.3.0.rst
+++ b/docs/releasenotes/4.3.0.rst
@@ -1,7 +1,7 @@
 4.3.0
 -----
 
-API Changes
+API changes
 ===========
 
 Deprecations
@@ -12,7 +12,7 @@ Several undocumented functions in ImageOps have been deprecated:
 ``box_blur``. Use the equivalent operations in ``ImageFilter``
 instead. These functions will be removed in a future release.
 
-TIFF Metadata Changes
+TIFF metadata changes
 ^^^^^^^^^^^^^^^^^^^^^
 
 * TIFF tags with unknown type/quantity now default to being bare
@@ -27,7 +27,7 @@ TIFF Metadata Changes
   items, as there can be multiple items, one for UTF-8, and one for
   UTF-16.
 
-Core Image API Changes
+Core Image API changes
 ^^^^^^^^^^^^^^^^^^^^^^
 
 These are internal functions that should not have been used by user
@@ -44,10 +44,10 @@ The ``PIL.Image.core.getcount`` methods have been removed, use
 ``PIL.Image.core.get_stats()['new_count']`` property instead.
 
 
-API Additions
+API additions
 =============
 
-Get One Channel From Image
+Get one channel from image
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 A new method :py:meth:`PIL.Image.Image.getchannel` has been added to
@@ -56,14 +56,14 @@ return a single channel by index or name. For example,
 ``getchannel`` should work up to 6 times faster than
 ``image.split()[0]`` in previous Pillow versions.
 
-Box Blur
+Box blur
 ^^^^^^^^
 
 A new filter, :py:class:`PIL.ImageFilter.BoxBlur`, has been
 added. This is a filter with similar results to a Gaussian blur, but
 is much faster.
 
-Partial Resampling
+Partial resampling
 ^^^^^^^^^^^^^^^^^^
 
 Added new argument ``box`` for :py:meth:`PIL.Image.Image.resize`. This
@@ -71,14 +71,14 @@ argument defines a source rectangle from within the source image to be
 resized.  This is very similar to the ``image.crop(box).resize(size)``
 sequence except that ``box`` can be specified with subpixel accuracy.
 
-New Transpose Operation
+New transpose operation
 ^^^^^^^^^^^^^^^^^^^^^^^
 
 The ``Image.TRANSVERSE`` operation has been added to
 :py:meth:`PIL.Image.Image.transpose`. This is equivalent to a transpose
 operation about the opposite diagonal.
 
-Multiband Filters
+Multiband filters
 ^^^^^^^^^^^^^^^^^
 
 There is a new :py:class:`PIL.ImageFilter.MultibandFilter` base class
@@ -87,10 +87,10 @@ operation. The original :py:class:`PIL.ImageFilter.Filter` class
 remains for image filters that can process only single band images, or
 require splitting of channels prior to filtering.
 
-Other Changes
+Other changes
 =============
 
-Loading 16-bit TIFF Images
+Loading 16-bit TIFF images
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow now can read 16-bit multichannel TIFF files including files
@@ -101,7 +101,7 @@ Pillow now can read 16-bit signed integer single channel TIFF
 files. The image data is promoted to 32-bit for storage and
 processing.
 
-SGI Images
+SGI images
 ^^^^^^^^^^
 
 Pillow can now read and write uncompressed 16-bit multichannel SGI
@@ -129,7 +129,7 @@ This release contains several performance improvements:
   falling back to an allocation for each scan line for images larger
   than the block size.
 
-CMYK Conversion
+CMYK conversion
 ^^^^^^^^^^^^^^^
 
 The basic CMYK->RGB conversion has been tweaked to match the formula
diff --git a/docs/releasenotes/5.0.0.rst b/docs/releasenotes/5.0.0.rst
index be00a45cd87..2b93e032287 100644
--- a/docs/releasenotes/5.0.0.rst
+++ b/docs/releasenotes/5.0.0.rst
@@ -1,10 +1,10 @@
 5.0.0
 -----
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
-Python 3.3 Dropped
+Python 3.3 dropped
 ^^^^^^^^^^^^^^^^^^
 
 Python 3.3 is EOL and no longer supported due to moving testing from nose,
@@ -12,7 +12,7 @@ which is deprecated, to pytest, which doesn't support Python 3.3. We will not
 be creating binaries, testing, or retaining compatibility with this version.
 The final version of Pillow for Python 3.3 is 4.3.0.
 
-Decompression Bombs now raise Exceptions
+Decompression bombs now raise exceptions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Pillow has previously emitted warnings for images that are
@@ -31,7 +31,7 @@ separate package, pillow-scripts, living at
 https://github.com/python-pillow/pillow-scripts.
 
 
-API Changes
+API changes
 ===========
 
 OleFileIO.py
@@ -54,7 +54,7 @@ Several image plugins supported a named ``check`` parameter on their
 nominally private ``_save`` method to preflight if the image could be
 saved in that format. That parameter has been removed.
 
-API Additions
+API additions
 =============
 
 Image.transform
@@ -65,16 +65,16 @@ A new named parameter, ``fillcolor``, has been added to
 the area outside the transformed area in the output image. This
 parameter takes the same color specifications as used in ``Image.new``.
 
-GIF Disposal
+GIF disposal
 ^^^^^^^^^^^^
 
 Multiframe GIF images now take an optional disposal parameter to
 specify the disposal option for changed pixels.
 
-Other Changes
+Other changes
 =============
 
-Compressed TIFF Images
+Compressed TIFF images
 ^^^^^^^^^^^^^^^^^^^^^^
 
 Previously, there were some compression modes (JPEG, Packbits, and
@@ -82,7 +82,7 @@ LZW) that were supported with Pillow's internal TIFF decoder. All
 compressed TIFFs are now read using the ``libtiff`` decoder, as it
 implements the compression schemes more correctly.
 
-Libraqm is now Dynamically Linked
+Libraqm is now dynamically linked
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 The libraqm dependency for complex text scripts is now linked
@@ -90,14 +90,14 @@ dynamically at runtime rather than at packaging time. This allows us
 to release binaries with support for libraqm if it is installed on the
 user's machine.
 
-Source Layout Changes
+Source layout changes
 ^^^^^^^^^^^^^^^^^^^^^
 
 The Pillow source is now stored within the ``src`` directory of the
 distribution. This prevents accidental imports of the PIL directory
 when running Python from the project directory.
 
-Setup.py Changes
+Setup.py changes
 ^^^^^^^^^^^^^^^^
 
 Multiarch support on Linux should be more robust, especially on Debian
diff --git a/docs/releasenotes/5.1.0.rst b/docs/releasenotes/5.1.0.rst
index 4e3d10ac596..4b80e8521cf 100644
--- a/docs/releasenotes/5.1.0.rst
+++ b/docs/releasenotes/5.1.0.rst
@@ -1,7 +1,7 @@
 5.1.0
 -----
 
-API Changes
+API changes
 ===========
 
 Optional channels for TIFF files
@@ -12,22 +12,22 @@ 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
+API additions
 =============
 
-Append to PDF Files
+Append to PDF files
 ^^^^^^^^^^^^^^^^^^^
 
 Images can now be appended to PDF files in place by passing in
 ``append=True`` when saving the image.
 
-New BLP File Format
+New BLP file format
 ^^^^^^^^^^^^^^^^^^^
 
 Pillow now supports reading the BLP "Blizzard Mipmap" file format used
 for tiles in Blizzard's engine.
 
-Other Changes
+Other changes
 =============
 
 WebP memory leak
diff --git a/docs/releasenotes/5.2.0.rst b/docs/releasenotes/5.2.0.rst
index d9b8f0fb7c8..d183378201b 100644
--- a/docs/releasenotes/5.2.0.rst
+++ b/docs/releasenotes/5.2.0.rst
@@ -1,7 +1,7 @@
 5.2.0
 -----
 
-API Changes
+API changes
 ===========
 
 Deprecations
@@ -17,7 +17,7 @@ Pillow 6.0.0, and ``PILLOW_VERSION`` will be removed after that.
 
 Use ``PIL.__version__`` instead.
 
-API Additions
+API additions
 =============
 
 3D color lookup tables
@@ -75,7 +75,7 @@ TGA file format
 Pillow can now read and write LA data (in addition to L, P, RGB and RGBA), and
 write RLE data (in addition to uncompressed).
 
-Other Changes
+Other changes
 =============
 
 Support added for Python 3.7
diff --git a/docs/releasenotes/5.3.0.rst b/docs/releasenotes/5.3.0.rst
index 8f276da2407..6adce95b210 100644
--- a/docs/releasenotes/5.3.0.rst
+++ b/docs/releasenotes/5.3.0.rst
@@ -1,7 +1,7 @@
 5.3.0
 -----
 
-API Changes
+API changes
 ===========
 
 Image size
@@ -20,7 +20,7 @@ The exceptions to this are:
   as direct image size setting was previously necessary to work around an issue with tile extents.
 
 
-API Additions
+API additions
 =============
 
 Added line width parameter to rectangle and ellipse-based shapes
@@ -59,7 +59,7 @@ and size, new method ``ImageOps.pad`` pads images to fill a requested aspect
 ratio and size, filling new space with a provided ``color`` and positioning the
 image within the new area through a ``centering`` argument.
 
-Other Changes
+Other changes
 =============
 
 Added support for reading tiled TIFF images through LibTIFF. Compressed TIFF
diff --git a/docs/releasenotes/5.4.0.rst b/docs/releasenotes/5.4.0.rst
index 6d7277c70ea..13b540d600b 100644
--- a/docs/releasenotes/5.4.0.rst
+++ b/docs/releasenotes/5.4.0.rst
@@ -1,7 +1,7 @@
 5.4.0
 -----
 
-API Changes
+API changes
 ===========
 
 APNG extension to PNG plugin
@@ -55,7 +55,7 @@ TIFF images can now be saved with custom integer, float and string TIFF tags::
     print(im2.tag_v2[37002])  # "custom tag value"
     print(im2.tag_v2[37004])  # b"custom tag value"
 
-Other Changes
+Other changes
 =============
 
 ImageOps.fit
diff --git a/docs/releasenotes/6.0.0.rst b/docs/releasenotes/6.0.0.rst
index 5e69f0b6b5a..b788b2eeb71 100644
--- a/docs/releasenotes/6.0.0.rst
+++ b/docs/releasenotes/6.0.0.rst
@@ -1,7 +1,7 @@
 6.0.0
 -----
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Python 3.4 dropped
@@ -32,7 +32,7 @@ Removed deprecated VERSION
 ``VERSION`` (the old PIL version, always 1.1.7) has been removed. Use ``__version__``
 instead.
 
-API Changes
+API changes
 ===========
 
 Deprecations
@@ -137,7 +137,7 @@ loaded, ``Image.MIME["PPM"]`` will now return the generic "image/x-portable-anym
 The TGA, PCX and ICO formats also now have MIME types: "image/x-tga", "image/x-pcx" and
 "image/x-icon" respectively.
 
-API Additions
+API additions
 =============
 
 DIB file format
@@ -186,7 +186,7 @@ EXIF data can now be read from and saved to PNG images. However, unlike other im
 formats, EXIF data is not guaranteed to be present in :py:attr:`~PIL.Image.Image.info`
 until :py:meth:`~PIL.Image.Image.load` has been called.
 
-Other Changes
+Other changes
 =============
 
 Reading new DDS image format
diff --git a/docs/releasenotes/6.1.0.rst b/docs/releasenotes/6.1.0.rst
index ce3edc5fa9b..761f435f391 100644
--- a/docs/releasenotes/6.1.0.rst
+++ b/docs/releasenotes/6.1.0.rst
@@ -23,7 +23,7 @@ Use instead::
     with Image.open("hopper.png") as im:
         im.save("out.jpg")
 
-API Additions
+API additions
 =============
 
 Image.entropy
@@ -61,7 +61,7 @@ file. ``ImageFont.FreeTypeFont`` has four new methods,
 instead. An :py:exc:`IOError` will be raised if the font is not a variation font. FreeType
 2.9.1 or greater is required.
 
-Other Changes
+Other changes
 =============
 
 ImageTk.getimage
diff --git a/docs/releasenotes/6.2.0.rst b/docs/releasenotes/6.2.0.rst
index b851c56fc0e..b37cd7160e7 100644
--- a/docs/releasenotes/6.2.0.rst
+++ b/docs/releasenotes/6.2.0.rst
@@ -29,7 +29,7 @@ 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
+API changes
 ===========
 
 Image.getexif
@@ -48,7 +48,7 @@ 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
+API additions
 =============
 
 Text stroking
@@ -93,7 +93,7 @@ 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.
 
-Other Changes
+Other changes
 =============
 
 Removed bdist_wininst .exe installers
diff --git a/docs/releasenotes/6.2.1.rst b/docs/releasenotes/6.2.1.rst
index 372298fbc2a..0ede05917a4 100644
--- a/docs/releasenotes/6.2.1.rst
+++ b/docs/releasenotes/6.2.1.rst
@@ -1,7 +1,7 @@
 6.2.1
 -----
 
-API Changes
+API changes
 ===========
 
 Deprecations
@@ -15,7 +15,7 @@ Python 2.7 reaches end-of-life on 2020-01-01.
 Pillow 7.0.0 will be released on 2020-01-01 and will drop support for Python
 2.7, making Pillow 6.2.x the last release series to support Python 2.
 
-Other Changes
+Other changes
 =============
 
 Support added for Python 3.8
diff --git a/docs/releasenotes/7.0.0.rst b/docs/releasenotes/7.0.0.rst
index ed6026593e6..9504c974a11 100644
--- a/docs/releasenotes/7.0.0.rst
+++ b/docs/releasenotes/7.0.0.rst
@@ -1,7 +1,7 @@
 7.0.0
 -----
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Python 2.7
@@ -78,7 +78,7 @@ bounds of resulting image. This may be useful in a subsequent
 .. _chain methods: https://en.wikipedia.org/wiki/Method_chaining
 
 
-API Additions
+API additions
 =============
 
 Custom unidentified image error
@@ -124,7 +124,7 @@ now also be loaded at another resolution::
     with Image.open("drawing.wmf") as im:
         im.load(dpi=144)
 
-Other Changes
+Other changes
 =============
 
 Image.__del__
diff --git a/docs/releasenotes/7.1.0.rst b/docs/releasenotes/7.1.0.rst
index 0dd8669a5b8..c2aeb0f749b 100644
--- a/docs/releasenotes/7.1.0.rst
+++ b/docs/releasenotes/7.1.0.rst
@@ -35,7 +35,7 @@ out-of-bounds reads via a crafted JP2 file.
 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
+API changes
 ===========
 
 Allow saving of zero quality JPEG images
@@ -50,7 +50,7 @@ been resolved. ::
     im = Image.open("hopper.jpg")
     im.save("out.jpg", quality=0)
 
-API Additions
+API additions
 =============
 
 New channel operations
@@ -101,7 +101,7 @@ 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.
 
-Other Changes
+Other changes
 =============
 
 If present, only use alpha channel for bounding box
diff --git a/docs/releasenotes/7.2.0.rst b/docs/releasenotes/7.2.0.rst
index 91e54da1999..12bafa8ce90 100644
--- a/docs/releasenotes/7.2.0.rst
+++ b/docs/releasenotes/7.2.0.rst
@@ -1,7 +1,7 @@
 7.2.0
 -----
 
-API Changes
+API changes
 ===========
 
 Replaced TiffImagePlugin DEBUG with logging
diff --git a/docs/releasenotes/8.0.0.rst b/docs/releasenotes/8.0.0.rst
index 1fc245c9a3c..d0dde756fc3 100644
--- a/docs/releasenotes/8.0.0.rst
+++ b/docs/releasenotes/8.0.0.rst
@@ -1,7 +1,7 @@
 8.0.0
 -----
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Python 3.5
@@ -44,7 +44,7 @@ Removed                   Use instead
 ``product_model``         Unicode :py:attr:`~.CmsProfile.model`
 ========================  ===================================================
 
-API Changes
+API changes
 ===========
 
 ImageDraw.text: stroke_width
@@ -67,7 +67,7 @@ Add MIME type to PsdImagePlugin
 "image/vnd.adobe.photoshop" is now registered as the
 :py:class:`.PsdImagePlugin.PsdImageFile` MIME type.
 
-API Additions
+API additions
 =============
 
 Image.open: add formats parameter
@@ -135,7 +135,7 @@ and :py:meth:`.FreeTypeFont.getbbox` return the bounding box of rendered text.
 
 These functions accept an ``anchor`` parameter, see :ref:`text-anchors` for details.
 
-Other Changes
+Other changes
 =============
 
 Improved ellipse-drawing algorithm
diff --git a/docs/releasenotes/8.1.0.rst b/docs/releasenotes/8.1.0.rst
index 5c399331846..06e6d997484 100644
--- a/docs/releasenotes/8.1.0.rst
+++ b/docs/releasenotes/8.1.0.rst
@@ -26,7 +26,7 @@ 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`_.
 
-: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
@@ -64,7 +64,7 @@ Makefile
 
 The ``install-venv`` target has been deprecated.
 
-API Additions
+API additions
 =============
 
 Append images to ICO
@@ -77,7 +77,7 @@ 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.
 
-Other Changes
+Other changes
 =============
 
 Makefile
diff --git a/docs/releasenotes/8.1.1.rst b/docs/releasenotes/8.1.1.rst
index 690421c2a56..b8ad5a898a0 100644
--- a/docs/releasenotes/8.1.1.rst
+++ b/docs/releasenotes/8.1.1.rst
@@ -32,7 +32,7 @@ DOS attack.
 
 There is an out-of-bounds read in ``SgiRleDecode.c`` since Pillow 4.3.0.
 
-Other Changes
+Other changes
 =============
 
 A crash with the feature flags for libimagequant, libjpeg-turbo, WebP and XCB on
diff --git a/docs/releasenotes/8.2.0.rst b/docs/releasenotes/8.2.0.rst
index 50fe9aa1988..a59560695eb 100644
--- a/docs/releasenotes/8.2.0.rst
+++ b/docs/releasenotes/8.2.0.rst
@@ -74,7 +74,7 @@ Tk/Tcl 8.4
 Support for Tk/Tcl 8.4 is deprecated and will be removed in Pillow 10.0.0 (2023-07-01),
 when Tk/Tcl 8.5 will be the minimum supported.
 
-API Changes
+API changes
 ===========
 
 Image.alpha_composite: dest
@@ -107,7 +107,7 @@ removed. Instead, ``Image.getmodebase()``, ``Image.getmodetype()``,
 ``Image.getmodebandnames()``, ``Image.getmodebands()`` or ``ImageMode.getmode()``
 can be used.
 
-API Additions
+API additions
 =============
 
 getxmp() for JPEG images
@@ -177,7 +177,7 @@ be specified through a keyword argument::
 
     im.save("out.tif", icc_profile=...)
 
-Other Changes
+Other changes
 =============
 
 GIF writer uses LZW encoding
diff --git a/docs/releasenotes/8.3.0.rst b/docs/releasenotes/8.3.0.rst
index 4ef914f6471..c4624085400 100644
--- a/docs/releasenotes/8.3.0.rst
+++ b/docs/releasenotes/8.3.0.rst
@@ -33,7 +33,7 @@ dictionary. The ``convert_dict_qtables`` method no longer
 performs any operations on the data given to it, has been deprecated and will be
 removed in Pillow 10.0.0 (2023-07-01).
 
-API Changes
+API changes
 ===========
 
 Changed WebP default "method" value when saving
@@ -73,7 +73,7 @@ through :py:meth:`~PIL.Image.Image.getexif`. This also provides access to the GP
 EXIF IFDs, through ``im.getexif().get_ifd(0x8825)`` and
 ``im.getexif().get_ifd(0x8769)`` respectively.
 
-API Additions
+API additions
 =============
 
 ImageOps.contain
@@ -100,7 +100,7 @@ format, through the new ``bitmap_format`` argument::
 
     im.save("out.ico", bitmap_format="bmp")
 
-Other Changes
+Other changes
 =============
 
 Added DDS BC5 reading and uncompressed saving
diff --git a/docs/releasenotes/8.3.2.rst b/docs/releasenotes/8.3.2.rst
index 34ba703f70a..e26a6ceda4c 100644
--- a/docs/releasenotes/8.3.2.rst
+++ b/docs/releasenotes/8.3.2.rst
@@ -20,7 +20,7 @@ bytes off the end of the allocated buffer from the heap. Present since Pillow 7.
 
 This bug was found by Google's `OSS-Fuzz`_ `CIFuzz`_ runs.
 
-Other Changes
+Other changes
 =============
 
 Python 3.10 wheels
diff --git a/docs/releasenotes/8.4.0.rst b/docs/releasenotes/8.4.0.rst
index bdc8e802082..3bdf77d564d 100644
--- a/docs/releasenotes/8.4.0.rst
+++ b/docs/releasenotes/8.4.0.rst
@@ -13,7 +13,7 @@ Before Pillow 8.3.0, ``ImagePalette`` required palette data of particular length
 default, and the size parameter could be used to override that. Pillow 8.3.0 removed
 the default required length, also removing the need for the size parameter.
 
-API Additions
+API additions
 =============
 
 Added "transparency" argument for loading EPS images
@@ -33,7 +33,7 @@ Added WalImageFile class
 :py:class:`PIL.Image.Image` instance. It now returns a dedicated
 :py:class:`PIL.WalImageFile.WalImageFile` class.
 
-Other Changes
+Other changes
 =============
 
 Speed improvement when rotating square images
diff --git a/docs/releasenotes/9.0.0.rst b/docs/releasenotes/9.0.0.rst
index fee66b6d0b5..660e5514cf8 100644
--- a/docs/releasenotes/9.0.0.rst
+++ b/docs/releasenotes/9.0.0.rst
@@ -59,7 +59,7 @@ initializing ``ImagePath.Path``.
 
 .. _OSS-Fuzz: https://github.com/google/oss-fuzz
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 Python 3.6
@@ -102,7 +102,7 @@ ImageFile.raise_ioerror
 has been removed. Use ``ImageFile.raise_oserror`` instead.
 
 
-API Changes
+API changes
 ===========
 
 Added line width parameter to ImageDraw polygon
@@ -111,7 +111,7 @@ Added line width parameter to ImageDraw polygon
 An optional line ``width`` parameter has been added to ``ImageDraw.Draw.polygon``.
 
 
-API Additions
+API additions
 =============
 
 ImageShow.XDGViewer
@@ -132,7 +132,7 @@ 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")``.
 
-Other Changes
+Other changes
 =============
 
 Convert subsequent GIF frames to RGB or RGBA
diff --git a/docs/releasenotes/9.0.1.rst b/docs/releasenotes/9.0.1.rst
index f65e3bcc2ec..5326afe782c 100644
--- a/docs/releasenotes/9.0.1.rst
+++ b/docs/releasenotes/9.0.1.rst
@@ -21,7 +21,7 @@ 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.
 
-Other Changes
+Other changes
 =============
 
 Pillow 9.0 added support for ``xdg-open`` as an image viewer, but there have been
diff --git a/docs/releasenotes/9.1.0.rst b/docs/releasenotes/9.1.0.rst
index 5b83d1e9c56..72749ce8c54 100644
--- a/docs/releasenotes/9.1.0.rst
+++ b/docs/releasenotes/9.1.0.rst
@@ -94,7 +94,7 @@ 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
+API changes
 ===========
 
 Raise an error when performing a negative crop
@@ -137,7 +137,7 @@ On macOS, the last argument may need to be wrapped in quotes, e.g.
 Therefore ``requirements.txt`` has been removed along with the ``make install-req``
 command for installing its contents.
 
-API Additions
+API additions
 =============
 
 Added get_photoshop_blocks() to parse Photoshop TIFF tag
@@ -193,7 +193,7 @@ palette. ::
     from PIL import GifImagePlugin
     GifImagePlugin.LOADING_STRATEGY = GifImagePlugin.LoadingStrategy.RGB_AFTER_DIFFERENT_PALETTE_ONLY
 
-Other Changes
+Other changes
 =============
 
 musllinux wheels
diff --git a/docs/releasenotes/9.2.0.rst b/docs/releasenotes/9.2.0.rst
index 6e064734391..a3c9800b683 100644
--- a/docs/releasenotes/9.2.0.rst
+++ b/docs/releasenotes/9.2.0.rst
@@ -126,7 +126,7 @@ Use instead::
     draw = ImageDraw.Draw(im)
     draw.text((100 / 2, 100 / 2), "Hello world", font=font, anchor="mm")
 
-API Additions
+API additions
 =============
 
 Image.apply_transparency
@@ -137,7 +137,7 @@ 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``.
 
-Other Changes
+Other changes
 =============
 
 Using gnome-screenshot on Linux
diff --git a/docs/releasenotes/9.3.0.rst b/docs/releasenotes/9.3.0.rst
index e5987ce086c..bb1e731fd75 100644
--- a/docs/releasenotes/9.3.0.rst
+++ b/docs/releasenotes/9.3.0.rst
@@ -28,7 +28,7 @@ This was introduced in Pillow 9.2.0, found with `OSS-Fuzz`_ and fixed by limitin
 ``SAMPLESPERPIXEL`` to the number of planes that we can decode.
 
 
-API Additions
+API additions
 =============
 
 Allow default ImageDraw font to be set
@@ -65,7 +65,7 @@ The data from :py:data:`~PIL.ExifTags.TAGS` and
 :py:data:`~PIL.ExifTags.GPS`.
 
 
-Other Changes
+Other changes
 =============
 
 Python 3.11 wheels
diff --git a/docs/releasenotes/9.4.0.rst b/docs/releasenotes/9.4.0.rst
index 37f26a22c05..3b202157dc0 100644
--- a/docs/releasenotes/9.4.0.rst
+++ b/docs/releasenotes/9.4.0.rst
@@ -20,7 +20,7 @@ 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
+API additions
 =============
 
 Added start position for getmask and getmask2
@@ -88,7 +88,7 @@ When saving a JPEG image, a comment can now be written from
 
     im.save(out, comment="Test comment")
 
-Other Changes
+Other changes
 =============
 
 Added support for DDS L and LA images
diff --git a/docs/releasenotes/9.5.0.rst b/docs/releasenotes/9.5.0.rst
index 501479bb6df..6bf2079c812 100644
--- a/docs/releasenotes/9.5.0.rst
+++ b/docs/releasenotes/9.5.0.rst
@@ -37,7 +37,7 @@ 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.
 
-API Additions
+API additions
 =============
 
 QOI file format
@@ -71,7 +71,7 @@ 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.
 
-Other Changes
+Other changes
 =============
 
 Added support for saving PDFs in RGBA mode
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index a116ef056a7..5d7b21d593d 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -1,4 +1,4 @@
-Release Notes
+Release notes
 =============
 
 Pillow is released quarterly on January 2nd, April 1st, July 1st and October 15th.
diff --git a/docs/releasenotes/template.rst b/docs/releasenotes/template.rst
index cfc7221a3cc..a453d2a436d 100644
--- a/docs/releasenotes/template.rst
+++ b/docs/releasenotes/template.rst
@@ -14,7 +14,7 @@ TODO
 
 TODO
 
-Backwards Incompatible Changes
+Backwards incompatible changes
 ==============================
 
 TODO
@@ -28,7 +28,7 @@ TODO
 
 TODO
 
-API Changes
+API changes
 ===========
 
 TODO
@@ -36,7 +36,7 @@ TODO
 
 TODO
 
-API Additions
+API additions
 =============
 
 TODO
@@ -44,7 +44,7 @@ TODO
 
 TODO
 
-Other Changes
+Other changes
 =============
 
 TODO

From 58e48745cc7b6c6f7dd26a50fe68d1a82ea51562 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 21 Apr 2025 19:14:08 +1000
Subject: [PATCH 1662/2374] Add list of third-party plugins (#8910)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/handbook/appendices.rst          |  1 +
 docs/handbook/third-party-plugins.rst | 18 ++++++++++++++++++
 2 files changed, 19 insertions(+)
 create mode 100644 docs/handbook/third-party-plugins.rst

diff --git a/docs/handbook/appendices.rst b/docs/handbook/appendices.rst
index 347a8848b37..c20d8bc8bb2 100644
--- a/docs/handbook/appendices.rst
+++ b/docs/handbook/appendices.rst
@@ -8,4 +8,5 @@ Appendices
 
   image-file-formats
   text-anchors
+  third-party-plugins
   writing-your-own-image-plugin
diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst
new file mode 100644
index 00000000000..a189a5773c7
--- /dev/null
+++ b/docs/handbook/third-party-plugins.rst
@@ -0,0 +1,18 @@
+Third-party plugins
+===================
+
+Pillow uses a plugin model which allows users to add their own
+decoders and encoders to the library, without any changes to the library
+itself.
+
+Here is a list of PyPI projects that offer additional plugins:
+
+* :pypi:`DjvuRleImagePlugin`: Plugin for the DjVu RLE image format as defined in the DjVuLibre docs.
+* :pypi:`heif-image-plugin`: Simple HEIF/HEIC images plugin, based on the pyheif library.
+* :pypi:`jxlpy`: Introduces reading and writing support for JPEG XL.
+* :pypi:`pillow-heif`: Python bindings to libheif for working with HEIF images.
+* :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implemetation. Python bindings implemented using pybind11.
+* :pypi:`pillow-jxl-plugin`: Plugin for JPEG-XL, using Rust for bindings.
+* :pypi:`pillow-mbm`: Adds support for KSP's proprietary MBM texture format.
+* :pypi:`pillow-svg`: Implements basic SVG read support. Supports basic paths, shapes, and text.
+* :pypi:`raw-pillow-opener`: Simple camera raw opener, based on the rawpy library.

From 6bf791a3e7b2490bcb34ae9eb44419ee65c3caee Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Apr 2025 10:27:49 +0100
Subject: [PATCH 1663/2374] Use a named tuple for the packed parameters

---
 Tests/test_pyarrow.py | 56 ++++++++++++++++++++++++-------------------
 1 file changed, 32 insertions(+), 24 deletions(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index bcdd7ddc9d0..822cd18ac29 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Any  # undone
+from typing import Any, NamedTuple
 
 import pytest
 
@@ -151,29 +151,37 @@ def test_lifetime2() -> None:
     assert isinstance(px[0, 0], int)
 
 
-UINT_ARR = (
-    fl_uint8_4_type,
-    [1,2,3,4],
-    1
+class DataShape(NamedTuple):
+    dtype: Any
+    elt: Any
+    elts_per_pixel: int
+
+
+UINT_ARR = DataShape(
+    dtype=fl_uint8_4_type,
+    elt=[1, 2, 3, 4],  # array of 4 uint 8 per pixel
+    elts_per_pixel=1,  # only one array per pixel
 )
-UINT = (
-    pyarrow.uint8(),
-    3,
-    4
+
+UINT = DataShape(
+    dtype=pyarrow.uint8(),
+    elt=3,  # one uint8,
+    elts_per_pixel=4,  # but repeated 4x per pixel
 )
-INT32 = (
-    pyarrow.uint32(),
-    0xabcdef45,
-    1
+
+UINT32 = DataShape(
+    dtype=pyarrow.uint32(),
+    elt=0xABCDEF45,  # one packed int, doesn't fit in a int32 > 0x80000000
+    elts_per_pixel=1,  # one per pixel
 )
 
 
 @pytest.mark.parametrize(
     "mode, data_tp, mask",
     (
-        ("L", (pyarrow.uint8(), 3, 1), None),
-        ("I", (pyarrow.int32(), 1 << 24, 1), None),
-        ("F", (pyarrow.float32(), 3.14159, 1), None),
+        ("L", DataShape(pyarrow.uint8(), 3, 1), None),
+        ("I", DataShape(pyarrow.int32(), 1 << 24, 1), None),
+        ("F", DataShape(pyarrow.float32(), 3.14159, 1), None),
         ("LA", UINT_ARR, [0, 3]),
         ("LA", UINT, [0, 3]),
         ("RGB", UINT_ARR, [0, 1, 2]),
@@ -188,7 +196,7 @@ def test_lifetime2() -> None:
         ("HSV", UINT, [0, 1, 2]),
     ),
 )
-def test_fromarray(mode: str, data_tp: tuple, mask: list[int] | None) -> None:
+def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
     (dtype, elt, elts_per_pixel) = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
@@ -201,15 +209,15 @@ def test_fromarray(mode: str, data_tp: tuple, mask: list[int] | None) -> None:
 @pytest.mark.parametrize(
     "mode, data_tp, mask",
     (
-        ("LA", INT32, [0, 3]),
-        ("RGB", INT32, [0, 1, 2]),
-        ("RGBA", INT32, None),
-        ("CMYK", INT32, None),
-        ("YCbCr", INT32, [0, 1, 2]),
-        ("HSV", INT32, [0, 1, 2]),
+        ("LA", UINT32, [0, 3]),
+        ("RGB", UINT32, [0, 1, 2]),
+        ("RGBA", UINT32, None),
+        ("CMYK", UINT32, None),
+        ("YCbCr", UINT32, [0, 1, 2]),
+        ("HSV", UINT32, [0, 1, 2]),
     ),
 )
-def test_from_int32array(mode: str, data_tp: tuple, mask: list[int] | None) -> None:
+def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
     (dtype, elt, elts_per_pixel) = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]

From ce204f47f45f2ecdc831faac9c1b7ad8192a9fc7 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Apr 2025 10:37:32 +0100
Subject: [PATCH 1664/2374] lint

---
 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 2c57165c1e7..1a9171a0cbb 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -737,7 +737,7 @@ ImagingNewArrow(
             return im;
         }
     }
-    // Stored as [[r,g,b,a],....]
+    // Stored as [[r,g,b,a],...]
     if (strcmp(schema->format, "+w:4") == 0  // 4 up array
         && im->pixelsize == 4                // storage as 32 bpc
         && schema->n_children > 0            // make sure schema is well formed.
@@ -753,7 +753,7 @@ ImagingNewArrow(
             return im;
         }
     }
-    // Stored as [r,g,b,a,r,g,b,a....]
+    // Stored as [r,g,b,a,r,g,b,a,...]
     if (strcmp(schema->format, "C") == 0            // uint8
         && im->pixelsize == 4                       // storage as 32 bpc
         && schema->n_children == 0                  // make sure schema is well formed.

From bc4b664b7094a311eb516e7eab1b88acf7496b67 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Apr 2025 10:46:45 +0100
Subject: [PATCH 1665/2374] Add integer range tests

---
 Tests/test_pyarrow.py | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index 822cd18ac29..6eedcafe72a 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -153,7 +153,10 @@ def test_lifetime2() -> None:
 
 class DataShape(NamedTuple):
     dtype: Any
-    elt: Any
+    elt: Any  # Strictly speaking, this should be a pixel or pixel component,
+              # so list[uint8][4], float, int, uint32, uint8, etc.
+              # But more correctly, it should be exactly the dtype from the
+              # line above.
     elts_per_pixel: int
 
 
@@ -175,6 +178,12 @@ class DataShape(NamedTuple):
     elts_per_pixel=1,  # one per pixel
 )
 
+INT32 = DataShape(
+    dtype=pyarrow.uint32(),
+    elt=0x12CDEF45,  # one packed int
+    elts_per_pixel=1,  # one per pixel
+)
+
 
 @pytest.mark.parametrize(
     "mode, data_tp, mask",
@@ -215,6 +224,12 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
         ("CMYK", UINT32, None),
         ("YCbCr", UINT32, [0, 1, 2]),
         ("HSV", UINT32, [0, 1, 2]),
+        ("LA", INT32, [0, 3]),
+        ("RGB", INT32, [0, 1, 2]),
+        ("RGBA", INT32, None),
+        ("CMYK", INT32, None),
+        ("YCbCr", INT32, [0, 1, 2]),
+        ("HSV", INT32, [0, 1, 2]),
     ),
 )
 def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:

From 45e24e429f7d443000a6955d228fa00055104414 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Apr 2025 10:54:00 +0100
Subject: [PATCH 1666/2374] Rearrance so black doesn't screw up the formatting

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

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index 6eedcafe72a..e7fce1e3399 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -153,10 +153,10 @@ def test_lifetime2() -> None:
 
 class DataShape(NamedTuple):
     dtype: Any
-    elt: Any  # Strictly speaking, this should be a pixel or pixel component,
-              # so list[uint8][4], float, int, uint32, uint8, etc.
-              # But more correctly, it should be exactly the dtype from the
-              # line above.
+    # Strictly speaking, elt should be a pixel or pixel component, so
+    # list[uint8][4], float, int, uint32, uint8, etc.  But more
+    # correctly, it should be exactly the dtype from the line above.
+    elt: Any
     elts_per_pixel: int
 
 

From 7a48a9fae083697bb30a6bec42c0c73399f3979a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 23 Apr 2025 20:34:53 +1000
Subject: [PATCH 1667/2374] Do not load image more than once

---
 src/PIL/IptcImagePlugin.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 60ab7c83f37..4336b815450 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -179,6 +179,7 @@ def load(self) -> Image.core.PixelAccess | None:
         with Image.open(o) as _im:
             _im.load()
             self.im = _im.im
+        self.tile = []
         return None
 
 

From 1e365d8c7282f77f5959ba9b772c5fd1b9aa4315 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 23 Apr 2025 21:10:54 +1000
Subject: [PATCH 1668/2374] Return PixelAccess on first load

---
 Tests/test_file_ico.py     | 1 +
 Tests/test_file_iptc.py    | 3 +++
 src/PIL/IcoImagePlugin.py  | 2 +-
 src/PIL/IptcImagePlugin.py | 2 +-
 4 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 5d2ace35e28..0eef7c07a83 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -99,6 +99,7 @@ def test_getpixel(tmp_path: Path) -> None:
         reloaded.load()
         reloaded.size = (32, 32)
 
+        assert reloaded.load() is not None
         assert reloaded.getpixel((0, 0)) == (18, 20, 62)
 
 
diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index c6c0c1aab9d..424820ce47d 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -23,6 +23,9 @@ def test_open() -> None:
         assert im.tile == [("iptc", (0, 0, 1, 1), 25, "raw")]
         assert_image_equal(im, expected)
 
+    with Image.open(f) as im:
+        assert im.load() is not None
+
 
 def test_getiptcinfo_jpg_none() -> None:
     # Arrange
diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 55c57f203ab..bd35ac890e6 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -362,7 +362,7 @@ def load(self) -> Image.core.PixelAccess | None:
             self.info["sizes"] = set(sizes)
 
             self.size = im.size
-        return None
+        return Image.Image.load(self)
 
     def load_seek(self, pos: int) -> None:
         # Flag the ImageFile.Parser so that it
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 4336b815450..637f67810f5 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -180,7 +180,7 @@ def load(self) -> Image.core.PixelAccess | None:
             _im.load()
             self.im = _im.im
         self.tile = []
-        return None
+        return Image.Image.load(self)
 
 
 Image.register_open(IptcImageFile.format, IptcImageFile)

From d8afcb762fdc2a8d8e06deedd903993ab26805d8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 23 Apr 2025 23:09:08 +1000
Subject: [PATCH 1669/2374] Do not update palette for L mode frame

---
 .../no_palette_with_transparency_after_rgb.gif  | Bin 0 -> 16290 bytes
 Tests/test_file_gif.py                          |  12 ++++++++++++
 src/PIL/GifImagePlugin.py                       |   9 ++++++---
 3 files changed, 18 insertions(+), 3 deletions(-)
 create mode 100644 Tests/images/no_palette_with_transparency_after_rgb.gif

diff --git a/Tests/images/no_palette_with_transparency_after_rgb.gif b/Tests/images/no_palette_with_transparency_after_rgb.gif
new file mode 100644
index 0000000000000000000000000000000000000000..41357c1471db6ffeff5ac16d717b97e73f24094d
GIT binary patch
literal 16290
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
C{X?7p

literal 0
HcmV?d00001

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 20d58a9dda4..db8de0637fd 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -100,6 +100,18 @@ def test_l_mode_after_rgb() -> None:
         assert im.mode == "RGB"
 
 
+def test_l_mode_transparency_after_rgb() -> None:
+    with Image.open("Tests/images/no_palette_with_transparency_after_rgb.gif") as im:
+        expected = im.convert("RGB")
+        d = ImageDraw.Draw(expected)
+        d.rectangle([(0, 0), (64, 128)], fill="#000")
+
+        im.seek(1)
+        assert im.mode == "RGB"
+
+        assert_image_equal(im, expected)
+
+
 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)
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 4392c4cb909..2102614db9f 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -477,8 +477,11 @@ def load_end(self) -> None:
             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")
+            if self.mode == "L":
+                frame_im = self.im.convert_transparent("LA", self._frame_transparency)
+            else:
+                self.im.putpalettealpha(self._frame_transparency, 0)
+                frame_im = self.im.convert("RGBA")
         else:
             frame_im = self.im.convert("RGB")
 
@@ -487,7 +490,7 @@ def load_end(self) -> None:
 
         self.im = self._prev_im
         self._mode = self.im.mode
-        if frame_im.mode == "RGBA":
+        if frame_im.mode in ("LA", "RGBA"):
             self.im.paste(frame_im, self.dispose_extent, frame_im)
         else:
             self.im.paste(frame_im, self.dispose_extent)

From 3bd55822cd81930231db9bcb3bdc53deeeb56736 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 24 Apr 2025 13:26:58 +1000
Subject: [PATCH 1670/2374] Handle IPTC TIFF tags with incorrect type

---
 Tests/test_file_iptc.py    | 16 +++++++++++-----
 src/PIL/IptcImagePlugin.py |  2 +-
 2 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index c6c0c1aab9d..07335c269a9 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -5,7 +5,7 @@
 
 import pytest
 
-from PIL import Image, IptcImagePlugin
+from PIL import Image, IptcImagePlugin, TiffImagePlugin, TiffTags
 
 from .helper import assert_image_equal, hopper
 
@@ -75,13 +75,19 @@ def test_getiptcinfo_zero_padding() -> None:
 
 
 def test_getiptcinfo_tiff() -> None:
-    # Arrange
+    expected = {(1, 90): b"\x1b%G", (2, 0): b"\xcf\xc0"}
+
     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"}
+    assert iptc == expected
+
+    # Test with LONG tag type
+    with Image.open("Tests/images/hopper.Lab.tif") as im:
+        im.tag_v2.tagtype[TiffImagePlugin.IPTC_NAA_CHUNK] = TiffTags.LONG
+        iptc = IptcImagePlugin.getiptcinfo(im)
+
+    assert iptc == expected
 
 
 def test_getiptcinfo_tiff_none() -> None:
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 60ab7c83f37..9df498e26e3 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -219,7 +219,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_v2[TiffImagePlugin.IPTC_NAA_CHUNK]
+            data = im.tag_v2._tagdata[TiffImagePlugin.IPTC_NAA_CHUNK]
         except KeyError:
             pass
 

From 225182414c3c5cccc2fa42b3dd47147ef06790f9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 25 Apr 2025 17:14:13 +1000
Subject: [PATCH 1671/2374] libavif below 1.0 is not supported

---
 src/PIL/AvifImagePlugin.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/PIL/AvifImagePlugin.py b/src/PIL/AvifImagePlugin.py
index b2c5ab15d7e..366e0c864bf 100644
--- a/src/PIL/AvifImagePlugin.py
+++ b/src/PIL/AvifImagePlugin.py
@@ -16,7 +16,6 @@
 # Decoder options as module globals, until there is a way to pass parameters
 # to Image.open (see https://github.com/python-pillow/Pillow/issues/569)
 DECODE_CODEC_CHOICE = "auto"
-# Decoding is only affected by this for libavif **0.8.4** or greater.
 DEFAULT_MAX_THREADS = 0
 
 

From 4c2227758ec7bda10213220dc022e0e105533391 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 07:09:53 -0400
Subject: [PATCH 1672/2374] Add template for quarterly release issue

---
 .github/ISSUE_TEMPLATE/RELEASE.md | 45 +++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 .github/ISSUE_TEMPLATE/RELEASE.md

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
new file mode 100644
index 00000000000..db4c94a0975
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -0,0 +1,45 @@
+---
+name: Release
+about: Schedule a release
+---
+
+## Main Release
+
+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.
+  * [ ] Add release notes for 11.2.1 https://github.com/python-pillow/Pillow/pull/8885
+* [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) to confirm passing tests in `main` branch.
+* [ ] 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`
+* [ ] Run pre-release check via `make release-test` in a freshly cloned repo.
+* [ ] Create branch and tag for release e.g.:
+  ```bash
+  git branch [[MAJOR.MINOR.PATCH]]
+  git tag [[MAJOR.MINOR.PATCH]]
+  git push --tags
+  ```
+* [ ] 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
+  git push --all
+   ```
+
+## Publicize Release
+
+* [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321
+
+## Documentation
+
+* [ ] Make sure the [default version for Read the Docs](https://pillow.readthedocs.io/en/stable/) is up-to-date with the release changes
+
+## Docker Images
+
+* [ ] Update Pillow in the Docker Images repository
+  ```bash
+  git clone https://github.com/python-pillow/docker-images
+  cd docker-images
+  ./update-pillow-tag.sh [[release tag]]
+  ```

From da9d5522f7c7cd96d99a25a580ac6488f63bedaf Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 27 Apr 2025 21:35:08 +1000
Subject: [PATCH 1673/2374] Update dependency cibuildwheel to v2.23.3 (#8931)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
---
 .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 db5f89c9a04..0e314b8bf59 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.23.2
+cibuildwheel==2.23.3

From 8ab3bc469ec4ebcc7e5bc5a848fd59bd4a9a8221 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 08:21:48 -0400
Subject: [PATCH 1674/2374] Update .github/ISSUE_TEMPLATE/RELEASE.md

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

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
index db4c94a0975..c5bae8b2a68 100644
--- a/.github/ISSUE_TEMPLATE/RELEASE.md
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -9,7 +9,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.
-  * [ ] Add release notes for 11.2.1 https://github.com/python-pillow/Pillow/pull/8885
+  * [ ] Add release notes e.g. https://github.com/python-pillow/Pillow/pull/8885
 * [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) to confirm passing tests in `main` branch.
 * [ ] 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`

From 0205fb4fa2e9905dcec12715d60b5f4a75e30266 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 08:21:57 -0400
Subject: [PATCH 1675/2374] Update .github/ISSUE_TEMPLATE/RELEASE.md

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/RELEASE.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
index c5bae8b2a68..72499e01dad 100644
--- a/.github/ISSUE_TEMPLATE/RELEASE.md
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -16,8 +16,8 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 * [ ] Run pre-release check via `make release-test` in a freshly cloned repo.
 * [ ] Create branch and tag for release e.g.:
   ```bash
-  git branch [[MAJOR.MINOR.PATCH]]
-  git tag [[MAJOR.MINOR.PATCH]]
+  git branch [[MAJOR.MINOR]].0
+  git tag [[MAJOR.MINOR]].0
   git push --tags
   ```
 * [ ] 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.

From 6f672191ad83b522c47e1facdeb12889f91a5824 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 27 Apr 2025 22:30:35 +1000
Subject: [PATCH 1676/2374] Branch uses .x

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

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
index 72499e01dad..5dd070886d9 100644
--- a/.github/ISSUE_TEMPLATE/RELEASE.md
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -16,7 +16,7 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 * [ ] Run pre-release check via `make release-test` in a freshly cloned repo.
 * [ ] Create branch and tag for release e.g.:
   ```bash
-  git branch [[MAJOR.MINOR]].0
+  git branch [[MAJOR.MINOR]].x
   git tag [[MAJOR.MINOR]].0
   git push --tags
   ```

From 6881863eab8106a6a0e3cb788f11c7d0d71cf124 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 15:37:42 -0400
Subject: [PATCH 1677/2374] Update .github/ISSUE_TEMPLATE/RELEASE.md

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .github/ISSUE_TEMPLATE/RELEASE.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
index 5dd070886d9..97701f30e66 100644
--- a/.github/ISSUE_TEMPLATE/RELEASE.md
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -1,6 +1,7 @@
 ---
-name: Release
-about: Schedule a release
+name: "Maintainers only: Release"
+about: For maintainers to schedule a quarterly release
+labels: Release
 ---
 
 ## Main Release

From fcaffa22293c41851e9e28b3229b981398deacda Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 15:37:50 -0400
Subject: [PATCH 1678/2374] Update .github/ISSUE_TEMPLATE/RELEASE.md

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

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
index 97701f30e66..d7b246378b1 100644
--- a/.github/ISSUE_TEMPLATE/RELEASE.md
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -4,7 +4,7 @@ about: For maintainers to schedule a quarterly release
 labels: Release
 ---
 
-## Main Release
+## Main release
 
 Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 

From 1eba198b62d1444e72f598db805121022a19ab04 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 15:37:56 -0400
Subject: [PATCH 1679/2374] Update .github/ISSUE_TEMPLATE/RELEASE.md

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

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
index d7b246378b1..16bf30fdcf9 100644
--- a/.github/ISSUE_TEMPLATE/RELEASE.md
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -28,7 +28,7 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
   git push --all
    ```
 
-## Publicize Release
+## Publicize release
 
 * [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321
 

From e6ff42303b54d16e213b2152984a39f07742fcaf Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 15:38:02 -0400
Subject: [PATCH 1680/2374] Update .github/ISSUE_TEMPLATE/RELEASE.md

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

diff --git a/.github/ISSUE_TEMPLATE/RELEASE.md b/.github/ISSUE_TEMPLATE/RELEASE.md
index 16bf30fdcf9..20d1ac79b2a 100644
--- a/.github/ISSUE_TEMPLATE/RELEASE.md
+++ b/.github/ISSUE_TEMPLATE/RELEASE.md
@@ -36,7 +36,7 @@ Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 
 * [ ] Make sure the [default version for Read the Docs](https://pillow.readthedocs.io/en/stable/) is up-to-date with the release changes
 
-## Docker Images
+## Docker images
 
 * [ ] Update Pillow in the Docker Images repository
   ```bash

From e140027262b95d26080b5d58e095d2e294609e69 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Sun, 27 Apr 2025 15:45:40 -0400
Subject: [PATCH 1681/2374] Move checklist to issue template

---
 RELEASING.md | 23 ++---------------------
 1 file changed, 2 insertions(+), 21 deletions(-)

diff --git a/RELEASING.md b/RELEASING.md
index 932beb2c26e..b626d7d232f 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -7,27 +7,8 @@ information about how the version numbers line up with releases.
 
 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) to confirm passing tests in `main` branch.
-* [ ] 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`
-* [ ] Run pre-release check via `make release-test` in a freshly cloned repo.
-* [ ] Create branch and tag for release e.g.:
-  ```bash
-  git branch 5.2.x
-  git tag 5.2.0
-  git push --tags
-  ```
-* [ ] 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
-  git push --all
-   ```
+* [ ] Create a new issue and select the "Release" template.
+
 ## Point Release
 
 Released as needed for security, installation or critical bug fixes.

From f1d5cdaa07fbf4377d3cf4c68377e64998619b60 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 28 Apr 2025 06:17:47 +1000
Subject: [PATCH 1682/2374] Use sentence case

---
 README.md    |  4 ++--
 RELEASING.md | 12 ++++++------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 1cae558ada3..365d356a00c 100644
--- a/README.md
+++ b/README.md
@@ -95,7 +95,7 @@ This library provides extensive file format support, an efficient internal repre
 
 The core image library is designed for fast access to data stored in a few basic pixel formats. It should provide a solid foundation for a general image processing tool.
 
-## More Information
+## More information
 
 - [Documentation](https://pillow.readthedocs.io/)
   - [Installation](https://pillow.readthedocs.io/en/latest/installation/basic-installation.html)
@@ -107,6 +107,6 @@ The core image library is designed for fast access to data stored in a few basic
 - [Changelog](https://github.com/python-pillow/Pillow/releases)
   - [Pre-fork](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst#pre-fork)
 
-## Report a Vulnerability
+## Report a vulnerability
 
 To report a security vulnerability, please follow the procedure described in the [Tidelift security policy](https://tidelift.com/docs/security).
diff --git a/RELEASING.md b/RELEASING.md
index b626d7d232f..c160e96f513 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -1,15 +1,15 @@
-# Release Checklist
+# Release checklist
 
 See https://pillow.readthedocs.io/en/stable/releasenotes/versioning.html for
 information about how the version numbers line up with releases.
 
-## Main Release
+## Main release
 
 Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 
 * [ ] Create a new issue and select the "Release" template.
 
-## Point Release
+## Point release
 
 Released as needed for security, installation or critical bug fixes.
 
@@ -39,7 +39,7 @@ Released as needed for security, installation or critical bug fixes.
   git push
   ```
 
-## Embargoed Release
+## Embargoed release
 
 Released as needed privately to individual vendors for critical security-related bug fixes.
 
@@ -63,7 +63,7 @@ Released as needed privately to individual vendors for critical security-related
   git push origin 2.5.x
   ```
 
-## Publicize Release
+## Publicize release
 
 * [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321
 
@@ -71,7 +71,7 @@ Released as needed privately to individual vendors for critical security-related
 
 * [ ] Make sure the [default version for Read the Docs](https://pillow.readthedocs.io/en/stable/) is up-to-date with the release changes
 
-## Docker Images
+## Docker images
 
 * [ ] Update Pillow in the Docker Images repository
   ```bash

From dbe538a1307dc14c3ecb685819f28f22c02060ab Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 28 Apr 2025 06:19:18 +1000
Subject: [PATCH 1683/2374] Updated template name

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

diff --git a/RELEASING.md b/RELEASING.md
index c160e96f513..3c6188c8261 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -7,7 +7,7 @@ information about how the version numbers line up with releases.
 
 Released quarterly on January 2nd, April 1st, July 1st and October 15th.
 
-* [ ] Create a new issue and select the "Release" template.
+* [ ] Create a new issue and select the "Maintainers only: Release" template.
 
 ## Point release
 

From 47bebfc801c3905979715d0d22a9560c395581e6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 29 Apr 2025 14:57:10 +1000
Subject: [PATCH 1684/2374] Allow loading state from Pillow < 11.2.1

---
 Tests/test_pickle.py | 10 ++++++++++
 src/PIL/ImageFile.py |  3 ++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index 1c48cb743e0..54cef00ad38 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -162,3 +162,13 @@ def test_pickle_font_file(tmp_path: Path, protocol: int) -> None:
 
     # Assert
     helper_assert_pickled_font_images(font, unpickled_font)
+
+
+def test_load_earlier_data() -> None:
+    im = pickle.loads(
+        b"\x80\x04\x95@\x00\x00\x00\x00\x00\x00\x00\x8c\x12PIL.PngImagePlugin"
+        b"\x94\x8c\x0cPngImageFile\x94\x93\x94)\x81\x94]\x94(}\x94\x8c\x01L\x94K\x01"
+        b"K\x01\x86\x94NC\x01\x00\x94eb."
+    )
+    assert im.mode == "L"
+    assert im.size == (1, 1)
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index bcb7d462eba..bf556a2c690 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -257,7 +257,8 @@ def __getstate__(self) -> list[Any]:
 
     def __setstate__(self, state: list[Any]) -> None:
         self.tile = []
-        self.filename = state[5]
+        if len(state) > 5:
+            self.filename = state[5]
         super().__setstate__(state)
 
     def verify(self) -> None:

From 07df26aa5d2cf0937737c787bc88ff05454e53d2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 29 Apr 2025 15:37:45 +0300
Subject: [PATCH 1685/2374] Refactor docs `Makefile` (#8933)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 docs/Makefile | 42 ++++++++++++++++++------------------------
 docs/make.bat |  2 --
 2 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/docs/Makefile b/docs/Makefile
index 1e6c06ede80..8c10192940d 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -3,17 +3,23 @@
 
 # You can set these variables from the command line.
 PYTHON        = python3
-SPHINXOPTS    =
 SPHINXBUILD   = $(PYTHON) -m sphinx.cmd.build
-PAPER         =
+SPHINXOPTS    = --fail-on-warning
 BUILDDIR      = _build
+BUILDER       = html
+JOBS          = auto
+PAPER         =
 
 # Internal variables.
 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) .
+
+ALLSPHINXOPTS   = --builder $(BUILDER) \
+                  --doctree-dir $(BUILDDIR)/doctrees \
+                  --jobs $(JOBS) \
+                  $(PAPEROPT_$(PAPER)) \
+                  $(SPHINXOPTS) \
+                  . $(BUILDDIR)/$(BUILDER)
 
 .PHONY: help
 help:
@@ -36,31 +42,19 @@ install-sphinx:
 .PHONY: html
 html:
 	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder html --fail-on-warning --keep-going $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+	$(SPHINXBUILD) $(ALLSPHINXOPTS)
 
 .PHONY: dirhtml
-dirhtml:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+dirhtml: BUILDER = dirhtml
+dirhtml: html
 
 .PHONY: singlehtml
-singlehtml:
-	$(MAKE) install-sphinx
-	$(SPHINXBUILD) --builder singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+singlehtml: BUILDER = singlehtml
+singlehtml: html
 
 .PHONY: linkcheck
-linkcheck:
-	$(MAKE) install-sphinx
-	$(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."
+linkcheck: BUILDER = linkcheck
+linkcheck: html
 
 .PHONY: htmlview
 htmlview: html
diff --git a/docs/make.bat b/docs/make.bat
index 4126f786b8d..9d15537fb9e 100644
--- a/docs/make.bat
+++ b/docs/make.bat
@@ -7,10 +7,8 @@ if "%SPHINXBUILD%" == "" (
 )
 set BUILDDIR=_build
 set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
-set I18NSPHINXOPTS=%SPHINXOPTS% .
 if NOT "%PAPER%" == "" (
 	set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
-	set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
 )
 
 if "%1" == "" goto help

From 2245fd09de9c358bce2cb7f6f49b3f9710229489 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 30 Apr 2025 07:54:07 +1000
Subject: [PATCH 1686/2374] Updated Ghostscript to 10.5.1

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index bf8ec2f2cdf..abbfd95c891 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -98,8 +98,8 @@ jobs:
         choco install nasm --no-progress
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
-        choco install ghostscript --version=10.5.0 --no-progress
-        echo "C:\Program Files\gs\gs10.05.0\bin" >> $env:GITHUB_PATH
+        choco install ghostscript --version=10.5.1 --no-progress
+        echo "C:\Program Files\gs\gs10.05.1\bin" >> $env:GITHUB_PATH
 
         # Install extra test images
         xcopy /S /Y Tests\test-images\* Tests\images

From 0e292a80c8bed0f98cd56141431632a9433c5274 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 3 May 2025 00:52:35 +1000
Subject: [PATCH 1687/2374] Restore original encoderinfo after saving

---
 Tests/test_file_mpo.py | 3 +++
 src/PIL/Image.py       | 8 +++-----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 73838ef4484..71642253720 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -315,6 +315,9 @@ def test_save_xmp() -> None:
     im2.encoderinfo = {"xmp": b"Second frame"}
     im_reloaded = roundtrip(im, xmp=b"First frame", save_all=True, append_images=[im2])
 
+    # Test that encoderinfo is unchanged
+    assert im2.encoderinfo == {"xmp": b"Second frame"}
+
     assert im_reloaded.info["xmp"] == b"First frame"
 
     im_reloaded.seek(1)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ded40bc5ddc..02627c37af4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2551,7 +2551,8 @@ def save(
             self.load()
 
         save_all = params.pop("save_all", None)
-        self.encoderinfo = {**getattr(self, "encoderinfo", {}), **params}
+        encoderinfo = getattr(self, "encoderinfo", {})
+        self.encoderinfo = {**encoderinfo, **params}
         self.encoderconfig: tuple[Any, ...] = ()
 
         if format.upper() not in SAVE:
@@ -2589,10 +2590,7 @@ def save(
                     pass
             raise
         finally:
-            try:
-                del self.encoderinfo
-            except AttributeError:
-                pass
+            self.encoderinfo = encoderinfo
         if open_fp:
             fp.close()
 

From 4d56b90f38eda564ce8913bdc9b5222c3407652f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 5 May 2025 07:12:20 +1000
Subject: [PATCH 1688/2374] Updated docstring

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

diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index 26307817c91..f9ade18f9a1 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -1,5 +1,5 @@
 """
-A Pillow loader for .dds files (S3TC-compressed aka DXTC)
+A Pillow plugin for .dds files (S3TC-compressed aka DXTC)
 Jerome Leclanche <jerome@leclan.ch>
 
 Documentation:

From 349cc44fd47427a7cefbf5444dcd4010c8723360 Mon Sep 17 00:00:00 2001
From: Stefan <96178532+stefan6419846@users.noreply.github.com>
Date: Wed, 7 May 2025 17:21:22 +0200
Subject: [PATCH 1689/2374] Add Apache-2.0 notice to IcoImagePlugin

Closes #8946.
---
 src/PIL/IcoImagePlugin.py | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/PIL/IcoImagePlugin.py b/src/PIL/IcoImagePlugin.py
index 55c57f203ab..8ddb94b3710 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -17,6 +17,20 @@
 # <casadebender@gmail.com>.
 # https://code.google.com/archive/p/casadebender/wikis/Win32IconImagePlugin.wiki
 #
+# Copyright 2008 Bryan Davis
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
 # Icon format references:
 #   * https://en.wikipedia.org/wiki/ICO_(file_format)
 #   * https://msdn.microsoft.com/en-us/library/ms997538.aspx

From d02f7868732cdacc227dd794f6ff84bd6f1858c9 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Thu, 8 May 2025 19:16:40 +1000
Subject: [PATCH 1690/2374] [pre-commit.ci] pre-commit autoupdate (#8944)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .github/zizmor.yml      | 7 +++++++
 .pre-commit-config.yaml | 8 ++++----
 2 files changed, 11 insertions(+), 4 deletions(-)
 create mode 100644 .github/zizmor.yml

diff --git a/.github/zizmor.yml b/.github/zizmor.yml
new file mode 100644
index 00000000000..5bdc48c301b
--- /dev/null
+++ b/.github/zizmor.yml
@@ -0,0 +1,7 @@
+# Configuration for the zizmor static analysis tool, run via pre-commit in CI
+# https://woodruffw.github.io/zizmor/configuration/
+rules:
+  unpinned-uses:
+    config:
+      policies:
+        "*": ref-pin
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 140ce33bead..e15e6f6390a 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.11.4
+    rev: v0.11.8
     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: v20.1.0
+    rev: v20.1.3
     hooks:
       - id: clang-format
         types: [c]
@@ -51,14 +51,14 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.32.1
+    rev: 0.33.0
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: v1.5.2
+    rev: v1.6.0
     hooks:
       - id: zizmor
 

From c7193f74fc5ce1a0fe1742a0845165024be45ef5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 8 May 2025 20:10:34 +1000
Subject: [PATCH 1691/2374] Updated error message

---
 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 ce6209c0da4..73b25ed51b2 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -462,7 +462,7 @@ def test_wrong_arguments(self, resample: Image.Resampling) -> None:
         im.resize((32, 32), resample, (20, 20, 20, 100))
         im.resize((32, 32), resample, (20, 20, 100, 20))
 
-        with pytest.raises(TypeError, match="must be sequence of length 4"):
+        with pytest.raises(TypeError, match="must be (sequence|tuple) of length 4"):
             im.resize((32, 32), resample, (im.width, im.height))  # type: ignore[arg-type]
 
         with pytest.raises(ValueError, match="can't be negative"):

From 71a916ad53502ed8cb8ea71c40081c169c3eae0f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 8 May 2025 22:10:22 +1000
Subject: [PATCH 1692/2374] Do not install PyQt6 on Python 3.14

---
 .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 bf8ec2f2cdf..12f06ee0391 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -84,7 +84,7 @@ jobs:
         python3 -m pip install --upgrade pip
 
     - name: Install CPython dependencies
-      if: "!contains(matrix.python-version, 'pypy') && matrix.architecture != 'x86'"
+      if: "!contains(matrix.python-version, 'pypy') && !contains(matrix.python-version, '3.14') && matrix.architecture != 'x86'"
       run: |
         python3 -m pip install PyQt6
 

From 215069af5ddec6f4d3b92b8bc7554a10e2efb669 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 8 May 2025 22:13:13 +1000
Subject: [PATCH 1693/2374] Added support for Python 3.14

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 5ecd6b8160a..5d41e27d981 100644
--- a/setup.py
+++ b/setup.py
@@ -46,7 +46,7 @@ def get_version() -> str:
 ZLIB_ROOT = None
 FUZZING_BUILD = "LIB_FUZZING_ENGINE" in os.environ
 
-if sys.platform == "win32" and sys.version_info >= (3, 14):
+if sys.platform == "win32" and sys.version_info >= (3, 15):
     import atexit
 
     atexit.register(

From 78887f6114e68d4208a6d5e8f3d5134a6da6831a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 9 May 2025 23:52:18 +1000
Subject: [PATCH 1694/2374] Corrected comment

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

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index e7fce1e3399..c5872231b3b 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -162,7 +162,7 @@ class DataShape(NamedTuple):
 
 UINT_ARR = DataShape(
     dtype=fl_uint8_4_type,
-    elt=[1, 2, 3, 4],  # array of 4 uint 8 per pixel
+    elt=[1, 2, 3, 4],  # array of 4 uint8 per pixel
     elts_per_pixel=1,  # only one array per pixel
 )
 

From 74ab5ac4cda564714545eee52ab789d4bddf1516 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Sun, 11 May 2025 23:46:21 +0200
Subject: [PATCH 1695/2374] Fix memory leak in arrow export using array
 structure

---
 src/libImaging/Arrow.c | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index 33ff2ce779a..36f4554fc75 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -127,9 +127,7 @@ static void
 release_const_array(struct ArrowArray *array) {
     Imaging im = (Imaging)array->private_data;
 
-    if (array->n_children == 0) {
-        ImagingDelete(im);
-    }
+    ImagingDelete(im);
 
     //  Free the buffers and the buffers array
     if (array->buffers) {

From c64a7b50983d64b15bc8551315e28f4ac0cd8e84 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 May 2025 07:41:00 +1000
Subject: [PATCH 1696/2374] Updated harfbuzz to 11.2.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 a4592871f69..a6b52064ceb 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -38,7 +38,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=11.1.0
+HARFBUZZ_VERSION=11.2.1
 LIBPNG_VERSION=1.6.47
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 17fc37572e8..fbe47929194 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.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "11.1.0",
+    "HARFBUZZ": "11.2.1",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.17",
     "LIBAVIF": "1.2.1",

From 4984c45da2f6b854cb49dc81fc56372f335d43a0 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 10:27:38 +0200
Subject: [PATCH 1697/2374] valgrind memory leak check

---
 Makefile                   |  6 ++++++
 Tests/oss-fuzz/python.supp | 20 ++++++++++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/Makefile b/Makefile
index 53164b08a90..fd124d12427 100644
--- a/Makefile
+++ b/Makefile
@@ -99,6 +99,12 @@ valgrind:
             --log-file=/tmp/valgrind-output \
             python3 -m pytest --no-memcheck -vv --valgrind --valgrind-log=/tmp/valgrind-output
 
+.PHONY: valgrind-leak
+valgrind-leak:
+	PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp --leak-check=full --show-leak-kinds=definite --errors-for-leak-kinds=definite \
+            --log-file=/tmp/valgrind-output \
+            python3 -m pytest -vv --valgrind --valgrind-log=/tmp/valgrind-output Tests/
+
 .PHONY: readme
 readme:
 	python3 -c "import markdown2" > /dev/null 2>&1 || python3 -m pip install markdown2
diff --git a/Tests/oss-fuzz/python.supp b/Tests/oss-fuzz/python.supp
index 36385d67266..1ea2a8eb5a6 100644
--- a/Tests/oss-fuzz/python.supp
+++ b/Tests/oss-fuzz/python.supp
@@ -14,3 +14,23 @@
    fun:_TIFFReadEncodedTileAndAllocBuffer
    ...
 }
+
+{
+   <python_alloc_possible_leak>
+   Memcheck:Leak
+   match-leak-kinds: possible
+   fun:malloc
+   fun:_PyMem_RawMalloc
+   fun:PyObject_Malloc
+   ...
+}
+
+{
+   <python_realloc_possible_leak>
+   Memcheck:Leak
+   match-leak-kinds: possible
+   fun:malloc
+   fun:_PyMem_RawRealloc
+   fun:PyMem_Realloc
+   ...
+}

From fdfba982c8d514240435f3ecef540939fb97f120 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 10:28:09 +0200
Subject: [PATCH 1698/2374] fix memory leak in arrow schema

---
 src/libImaging/Arrow.c | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index 36f4554fc75..7d330612367 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -37,6 +37,10 @@ ReleaseExportedSchema(struct ArrowSchema *array) {
             child->release = NULL;
         }
         // UNDONE -- should I be releasing the children?
+        free(array->children[i]);
+    }
+    if (array->children) {
+        free(array->children);
     }
 
     // Release dictionary
@@ -117,6 +121,7 @@ export_imaging_schema(Imaging im, struct ArrowSchema *schema) {
     retval = export_named_type(schema->children[0], im->arrow_band_format, "pixel");
     if (retval != 0) {
         free(schema->children[0]);
+        free(schema->children);
         schema->release(schema);
         return retval;
     }

From 84b88a9fbc9c4cfd2bfb7d7a8d18225ee43efedb Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 10:58:12 +0200
Subject: [PATCH 1699/2374] Suppress all python level leaks for now

---
 Tests/oss-fuzz/python.supp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/oss-fuzz/python.supp b/Tests/oss-fuzz/python.supp
index 1ea2a8eb5a6..4803497adeb 100644
--- a/Tests/oss-fuzz/python.supp
+++ b/Tests/oss-fuzz/python.supp
@@ -18,7 +18,7 @@
 {
    <python_alloc_possible_leak>
    Memcheck:Leak
-   match-leak-kinds: possible
+   match-leak-kinds: all
    fun:malloc
    fun:_PyMem_RawMalloc
    fun:PyObject_Malloc
@@ -28,7 +28,7 @@
 {
    <python_realloc_possible_leak>
    Memcheck:Leak
-   match-leak-kinds: possible
+   match-leak-kinds: all
    fun:malloc
    fun:_PyMem_RawRealloc
    fun:PyMem_Realloc

From eaab43540344e26889116262651001f4e42b1630 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 10:58:37 +0200
Subject: [PATCH 1700/2374] Fix leak in webp_encode

* Free the output buffer on webp encode error
---
 src/_webp.c | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/src/_webp.c b/src/_webp.c
index 3aa4c408b71..a7809c40e59 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -641,6 +641,10 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     ImagingSectionLeave(&cookie);
 
     WebPPictureFree(&pic);
+
+    output = writer.mem;
+    ret_size = writer.size;
+
     if (!ok) {
         int error_code = (&pic)->error_code;
         char message[50] = "";
@@ -652,10 +656,9 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
             );
         }
         PyErr_Format(PyExc_ValueError, "encoding error %d%s", error_code, message);
+        free(output);
         return NULL;
     }
-    output = writer.mem;
-    ret_size = writer.size;
 
     {
         /* I want to truncate the *_size items that get passed into WebP

From a9bcd7db884d89bbfe1966c0611f7f3dda1f8f08 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 19:50:55 +0200
Subject: [PATCH 1701/2374] Fix leak of destination image in ImagingUnsharpMask
 when an error occurs

---
 src/_imaging.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/_imaging.c b/src/_imaging.c
index 72f12214390..79e0a2b2321 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -2226,6 +2226,7 @@ _unsharp_mask(ImagingObject *self, PyObject *args) {
     }
 
     if (!ImagingUnsharpMask(imOut, imIn, radius, percent, threshold)) {
+        ImagingDelete(imOut);
         return NULL;
     }
 

From e2e40c54568236d2504921eb0b335cdab734a7d5 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 22:33:27 +0200
Subject: [PATCH 1702/2374] Fix memory leak in TiffEncode

* If setimage errors out, the tiff client state was not freed.
---
 src/encode.c                |  2 ++
 src/libImaging/TiffDecode.c | 42 ++++++++++++++++++-------------------
 src/libImaging/TiffDecode.h |  2 ++
 3 files changed, 25 insertions(+), 21 deletions(-)

diff --git a/src/encode.c b/src/encode.c
index 7c365a74f7d..e56494036ff 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -703,6 +703,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    encoder->cleanup = ImagingLibTiffEncodeCleanup;
+
     num_core_tags = sizeof(core_tags) / sizeof(int);
     for (pos = 0; pos < tags_size; pos++) {
         item = PyList_GetItemRef(tags, pos);
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 9a2db95b400..173eca160d2 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -929,6 +929,27 @@ ImagingLibTiffSetField(ImagingCodecState state, ttag_t tag, ...) {
     return status;
 }
 
+int
+ImagingLibTiffEncodeCleanup(ImagingCodecState state) {
+    TIFFSTATE *clientstate = (TIFFSTATE *)state->context;
+    TIFF *tiff = clientstate->tiff;
+
+    if (!tiff) {
+        return 0;
+    }
+    // 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);
+    }
+    return 0;
+}
+
 int
 ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int bytes) {
     /* One shot encoder. Encode everything to the tiff in the clientstate.
@@ -1010,16 +1031,6 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
                 TRACE(("Encode Error, row %d\n", state->y));
                 state->errcode = IMAGING_CODEC_BROKEN;
 
-                // 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);
                 }
@@ -1036,22 +1047,11 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
                 TRACE(("Error flushing the tiff"));
                 // likely reason is memory.
                 state->errcode = IMAGING_CODEC_MEMORY;
-                if (clientstate->fp) {
-                    TIFFCleanup(tiff);
-                } else {
-                    TIFFClose(tiff);
-                }
                 if (!clientstate->fp) {
                     free(clientstate->data);
                 }
                 return -1;
             }
-            TRACE(("Closing \n"));
-            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?
diff --git a/src/libImaging/TiffDecode.h b/src/libImaging/TiffDecode.h
index 22361210dcb..77808b543fc 100644
--- a/src/libImaging/TiffDecode.h
+++ b/src/libImaging/TiffDecode.h
@@ -40,6 +40,8 @@ ImagingLibTiffInit(ImagingCodecState state, int fp, uint32_t offset);
 extern int
 ImagingLibTiffEncodeInit(ImagingCodecState state, char *filename, int fp);
 extern int
+ImagingLibTiffEncodeCleanup(ImagingCodecState state);
+extern int
 ImagingLibTiffMergeFieldInfo(
     ImagingCodecState state, TIFFDataType field_type, int key, int is_var_length
 );

From f792e0b1ef4f25e0df33e8e971056142f9f5248d Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 22:48:36 +0200
Subject: [PATCH 1703/2374] Fix memory leak

* Return after setting the error for advanced features without
  libraqm. Not returning here leads to an alloc that's never freed.
---
 src/_imagingft.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 62dab73e5c0..ca8e556f0c4 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -425,6 +425,7 @@ text_layout_fallback(
             "setting text direction, language or font features is not supported "
             "without libraqm"
         );
+        return 0;
     }
 
     if (PyUnicode_Check(string)) {

From 789631c60c3760beeb623cd1728a737502fd9ca3 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 23:31:09 +0200
Subject: [PATCH 1704/2374] Fix memory leak when JpegEncode returns an error.

---
 src/libImaging/JpegEncode.c | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/libImaging/JpegEncode.c b/src/libImaging/JpegEncode.c
index 3c11eac2206..79a38e12fb3 100644
--- a/src/libImaging/JpegEncode.c
+++ b/src/libImaging/JpegEncode.c
@@ -131,6 +131,7 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     break;
                 default:
                     state->errcode = IMAGING_CODEC_CONFIG;
+                    jpeg_destroy_compress(&context->cinfo);
                     return -1;
             }
 
@@ -161,6 +162,7 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                                 /* Would subsample the green and blue
                                    channels, which doesn't make sense */
                                 state->errcode = IMAGING_CODEC_CONFIG;
+                                jpeg_destroy_compress(&context->cinfo);
                                 return -1;
                         }
                         jpeg_set_colorspace(&context->cinfo, JCS_RGB);

From 7aa6a61d430c585cd10c91c5a73ce13f9f851b9e Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Tue, 13 May 2025 23:50:52 +0200
Subject: [PATCH 1705/2374] Wrap Makefile

---
 Makefile | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index fd124d12427..15f03ba4527 100644
--- a/Makefile
+++ b/Makefile
@@ -101,7 +101,8 @@ valgrind:
 
 .PHONY: valgrind-leak
 valgrind-leak:
-	PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp --leak-check=full --show-leak-kinds=definite --errors-for-leak-kinds=definite \
+	PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp \
+	    --leak-check=full --show-leak-kinds=definite --errors-for-leak-kinds=definite \
             --log-file=/tmp/valgrind-output \
             python3 -m pytest -vv --valgrind --valgrind-log=/tmp/valgrind-output Tests/
 

From efa2288643a3d2840b573d14b1aec41f6fd2b80c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 15 May 2025 08:38:33 +1000
Subject: [PATCH 1706/2374] Updated libavif to 1.3.0

---
 Tests/test_file_avif.py    | 2 +-
 depends/install_libavif.sh | 2 +-
 winbuild/build_prepare.py  | 3 +--
 3 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index bd87947c014..b2e586637fa 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -233,7 +233,7 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
         with Image.open(out_gif) as reread:
             reread_value = reread.convert("RGB").getpixel((1, 1))
         difference = sum([abs(original_value[i] - reread_value[i]) for i in range(3)])
-        assert difference <= 3
+        assert difference <= 6
 
     def test_save_single_frame(self, tmp_path: Path) -> None:
         temp_file = tmp_path / "temp.avif"
diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
index fc10d3e545c..26af8a36ce7 100755
--- a/depends/install_libavif.sh
+++ b/depends/install_libavif.sh
@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -eo pipefail
 
-version=1.2.1
+version=1.3.0
 
 ./download-and-extract.sh libavif-$version https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$version.tar.gz
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 17fc37572e8..9fee5bd9066 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "HARFBUZZ": "11.1.0",
     "JPEGTURBO": "3.1.0",
     "LCMS2": "2.17",
-    "LIBAVIF": "1.2.1",
+    "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.3.4",
     "LIBPNG": "1.6.47",
     "LIBWEBP": "1.5.0",
@@ -399,7 +399,6 @@ def cmd_msbuild(
                 "-DAVIF_CODEC_DAV1D=LOCAL",
                 "-DAVIF_CODEC_RAV1E=LOCAL",
                 "-DAVIF_CODEC_SVT=LOCAL",
-                "-DCMAKE_POLICY_VERSION_MINIMUM=3.5",
             ),
             cmd_xcopy("include", "{inc_dir}"),
         ],

From fb126af7a6a12e0870e56187257f75f35fe8558b Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Thu, 15 May 2025 21:10:48 +0200
Subject: [PATCH 1707/2374] Adding pytest-valgrind install

---
 Makefile | 1 +
 1 file changed, 1 insertion(+)

diff --git a/Makefile b/Makefile
index 15f03ba4527..bdddecda57c 100644
--- a/Makefile
+++ b/Makefile
@@ -101,6 +101,7 @@ valgrind:
 
 .PHONY: valgrind-leak
 valgrind-leak:
+	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=full --show-leak-kinds=definite --errors-for-leak-kinds=definite \
             --log-file=/tmp/valgrind-output \

From d5449d576013566100d8a0d41bbc1a756df86da5 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Thu, 15 May 2025 21:11:31 +0200
Subject: [PATCH 1708/2374] Guess so.

---
 src/libImaging/Arrow.c | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index 7d330612367..0b8c89a0773 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -36,7 +36,6 @@ ReleaseExportedSchema(struct ArrowSchema *array) {
             child->release(child);
             child->release = NULL;
         }
-        // UNDONE -- should I be releasing the children?
         free(array->children[i]);
     }
     if (array->children) {

From 218f055865a4f0abd05ac221c48cf86127907ca9 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Thu, 15 May 2025 21:59:02 +0200
Subject: [PATCH 1709/2374] Add github workflow/test-script

---
 .github/workflows/test-valgrind-memory.yml | 60 ++++++++++++++++++++++
 depends/docker-test-valgrind-memory.sh     | 11 ++++
 2 files changed, 71 insertions(+)
 create mode 100644 .github/workflows/test-valgrind-memory.yml
 create mode 100644 depends/docker-test-valgrind-memory.sh

diff --git a/.github/workflows/test-valgrind-memory.yml b/.github/workflows/test-valgrind-memory.yml
new file mode 100644
index 00000000000..e6a5f6e779f
--- /dev/null
+++ b/.github/workflows/test-valgrind-memory.yml
@@ -0,0 +1,60 @@
+name: Test Valgrind Memory Leaks
+
+# like the Docker tests, but running valgrind only on *.c/*.h changes.
+
+# this is very expensive. Only run on the pull request.
+on:
+  # push:
+  #   branches:
+  #     - "**"
+  #   paths:
+  #     - ".github/workflows/test-valgrind.yml"
+  #     - "**.c"
+  #     - "**.h"
+  pull_request:
+    paths:
+      - ".github/workflows/test-valgrind.yml"
+      - "**.c"
+      - "**.h"
+      - "depends/docker-test-valgrind-memory.sh"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        docker: [
+          ubuntu-22.04-jammy-amd64-valgrind,
+        ]
+        dockerTag: [main]
+
+    name: ${{ matrix.docker }}
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        persist-credentials: false
+
+    - name: Build system information
+      run: python3 .github/workflows/system-info.py
+
+    - name: Docker pull
+      run: |
+        docker pull pythonpillow/${{ matrix.docker }}:${{ matrix.dockerTag }}
+
+    - name: Build and Run Valgrind
+      run: |
+        # 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 }} /Pillow/depends/docker-test-valgrind-memory.sh
+        sudo chown -R runner $GITHUB_WORKSPACE
diff --git a/depends/docker-test-valgrind-memory.sh b/depends/docker-test-valgrind-memory.sh
new file mode 100644
index 00000000000..4fd6652d871
--- /dev/null
+++ b/depends/docker-test-valgrind-memory.sh
@@ -0,0 +1,11 @@
+#!/bin/bash
+
+## Run this as the test script in the docker valgrind image.
+## Note -- can be included directly into the docker image,
+## but requires the currnet python.supp.
+
+source /vpy3/bin/activate
+cd /Pillow
+make clean
+make install
+make valgrind-memory

From a6b8b3af7709081d8c53818e68b8bc15e9a48f34 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Thu, 15 May 2025 22:04:14 +0200
Subject: [PATCH 1710/2374] executable

---
 depends/docker-test-valgrind-memory.sh | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 mode change 100644 => 100755 depends/docker-test-valgrind-memory.sh

diff --git a/depends/docker-test-valgrind-memory.sh b/depends/docker-test-valgrind-memory.sh
old mode 100644
new mode 100755

From 2d506f6f5a478b4a798b3ce71f31b5e5f6f6b60f Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Thu, 15 May 2025 22:06:35 +0200
Subject: [PATCH 1711/2374] correct target

---
 depends/docker-test-valgrind-memory.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/depends/docker-test-valgrind-memory.sh b/depends/docker-test-valgrind-memory.sh
index 4fd6652d871..29fc6f2300d 100755
--- a/depends/docker-test-valgrind-memory.sh
+++ b/depends/docker-test-valgrind-memory.sh
@@ -8,4 +8,4 @@ source /vpy3/bin/activate
 cd /Pillow
 make clean
 make install
-make valgrind-memory
+make valgrind-leak

From f1957b49b2d01a9d063aed4000f985b220e30fa0 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Fri, 16 May 2025 12:08:45 +0200
Subject: [PATCH 1712/2374] Xfail timouts in Valgrind tests

* ensure that the env variable is set in the makefile
---
 Makefile                   | 4 ++--
 Tests/test_file_jpeg.py    | 5 +++++
 Tests/test_imagefontpil.py | 6 ++++++
 3 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index bdddecda57c..82c2c085fd9 100644
--- a/Makefile
+++ b/Makefile
@@ -95,14 +95,14 @@ test:
 .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 \
+	PILLOW_VALGRIND_TEST=true 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: valgrind-leak
 valgrind-leak:
 	python3 -c "import pytest_valgrind" > /dev/null 2>&1 || python3 -m pip install pytest-valgrind
-	PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp \
+	PILLOW_VALGRIND_TEST=true PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp \
 	    --leak-check=full --show-leak-kinds=definite --errors-for-leak-kinds=definite \
             --log-file=/tmp/valgrind-output \
             python3 -m pytest -vv --valgrind --valgrind-log=/tmp/valgrind-output Tests/
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 79f0ec1a809..fb9f26fc7fc 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1034,6 +1034,11 @@ def test_save_xmp(self, tmp_path: Path) -> None:
             im.save(f, xmp=b"1" * 65505)
 
     @pytest.mark.timeout(timeout=1)
+    @pytest.mark.xfail(
+        "PILLOW_VALGRIND_TEST" in os.environ,
+        reason="Valgrind is slower",
+        raises=TimeoutError
+    )
     def test_eof(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Even though this decoder never says that it is finished
         # the image should still end when there is no new data
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index 695aecbded2..adce4a75ca5 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -2,6 +2,7 @@
 
 import struct
 from io import BytesIO
+import os
 
 import pytest
 
@@ -73,6 +74,11 @@ def test_decompression_bomb() -> None:
 
 
 @pytest.mark.timeout(4)
+@pytest.mark.xfail(
+    "PILLOW_VALGRIND_TEST" in os.environ,
+    reason="Valgrind is slower",
+    raises=TimeoutError
+)
 def test_oom() -> None:
     glyph = struct.pack(
         ">hhhhhhhhhh", 1, 0, -32767, -32767, 32767, 32767, -32767, -32767, 32767, 32767

From ff50e30d3e9f1425ca6af95ac044d365c63719d1 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Fri, 16 May 2025 12:47:22 +0200
Subject: [PATCH 1713/2374] Fix memory leak in text_layout_raqm on 0 length
 string

---
 src/_imagingft.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index ca8e556f0c4..0d70544a545 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -275,6 +275,7 @@ text_layout_raqm(
         if (!text || !size) {
             /* return 0 and clean up, no glyphs==no size,
                and raqm fails with empty strings */
+            PyMem_Free(text);
             goto failed;
         }
         set_text = raqm_set_text(rq, text, size);

From 20b49a332bd0f0f39660fbb3587cfc4b6d539f0c Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Sat, 17 May 2025 10:45:43 +0200
Subject: [PATCH 1714/2374] Remove timeout as the specific reason,

pytest-timeout doesn't raise a timeout error.
---
 Tests/test_file_jpeg.py    | 3 +--
 Tests/test_imagefontpil.py | 3 +--
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index fb9f26fc7fc..d923020c8c7 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1036,8 +1036,7 @@ def test_save_xmp(self, tmp_path: Path) -> None:
     @pytest.mark.timeout(timeout=1)
     @pytest.mark.xfail(
         "PILLOW_VALGRIND_TEST" in os.environ,
-        reason="Valgrind is slower",
-        raises=TimeoutError
+        reason="Valgrind is slower"
     )
     def test_eof(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Even though this decoder never says that it is finished
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index adce4a75ca5..bd9bafb5535 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -76,8 +76,7 @@ def test_decompression_bomb() -> None:
 @pytest.mark.timeout(4)
 @pytest.mark.xfail(
     "PILLOW_VALGRIND_TEST" in os.environ,
-    reason="Valgrind is slower",
-    raises=TimeoutError
+    reason="Valgrind is slower"
 )
 def test_oom() -> None:
     glyph = struct.pack(

From c35082b619899d5351ba249e8ea23a4412d0c728 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Sat, 17 May 2025 08:47:59 +0000
Subject: [PATCH 1715/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_file_jpeg.py    | 3 +--
 Tests/test_imagefontpil.py | 7 ++-----
 2 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index d923020c8c7..7c33c751720 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1035,8 +1035,7 @@ def test_save_xmp(self, tmp_path: Path) -> None:
 
     @pytest.mark.timeout(timeout=1)
     @pytest.mark.xfail(
-        "PILLOW_VALGRIND_TEST" in os.environ,
-        reason="Valgrind is slower"
+        "PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower"
     )
     def test_eof(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Even though this decoder never says that it is finished
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index bd9bafb5535..e5b770745c9 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -1,8 +1,8 @@
 from __future__ import annotations
 
+import os
 import struct
 from io import BytesIO
-import os
 
 import pytest
 
@@ -74,10 +74,7 @@ def test_decompression_bomb() -> None:
 
 
 @pytest.mark.timeout(4)
-@pytest.mark.xfail(
-    "PILLOW_VALGRIND_TEST" in os.environ,
-    reason="Valgrind is slower"
-)
+@pytest.mark.xfail("PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower")
 def test_oom() -> None:
     glyph = struct.pack(
         ">hhhhhhhhhh", 1, 0, -32767, -32767, 32767, 32767, -32767, -32767, 32767, 32767

From a666057989efc669909e85754943f2734c5f2055 Mon Sep 17 00:00:00 2001
From: Stefan <96178532+stefan6419846@users.noreply.github.com>
Date: Wed, 21 May 2025 15:40:16 +0200
Subject: [PATCH 1716/2374] HTTP -> HTTPS

Co-authored-by: Andrew Murray <3112309+radarhere@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 8ddb94b3710..151eef2c9b9 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -23,7 +23,7 @@
 # not use this file except in compliance with the License. You may obtain
 # a copy of the License at
 #
-#     http://www.apache.org/licenses/LICENSE-2.0
+#     https://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,

From 45d1c4162b9666281857f3b5d38fdefdbf9b1979 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 May 2025 15:55:43 +1000
Subject: [PATCH 1717/2374] Do not build against libavif < 1

---
 setup.py | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/setup.py b/setup.py
index 5d41e27d981..ab36c6b1783 100644
--- a/setup.py
+++ b/setup.py
@@ -224,13 +224,14 @@ def _add_directory(
         path.insert(where, subdir)
 
 
-def _find_include_file(self: pil_build_ext, include: str) -> int:
+def _find_include_file(self: pil_build_ext, include: str) -> str | None:
     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)):
+        path = os.path.join(directory, include)
+        if os.path.isfile(path):
             _dbg("Found %s", include)
-            return 1
-    return 0
+            return path
+    return None
 
 
 def _find_library_file(self: pil_build_ext, library: str) -> str | None:
@@ -852,9 +853,13 @@ def build_extensions(self) -> None:
 
         if feature.want("avif"):
             _dbg("Looking for avif")
-            if _find_include_file(self, "avif/avif.h"):
-                if _find_library_file(self, "avif"):
-                    feature.set("avif", "avif")
+            if avif_h := _find_include_file(self, "avif/avif.h"):
+                with open(avif_h, "rb") as fp:
+                    major_version = int(
+                        fp.read().split(b"#define AVIF_VERSION_MAJOR ")[1].split()[0]
+                    )
+                    if major_version >= 1 and _find_library_file(self, "avif"):
+                        feature.set("avif", "avif")
 
         for f in feature:
             if not feature.get(f) and feature.require(f):

From 7824d2f8c61648c6ea0185b50e55df1a71213168 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 23 May 2025 08:48:38 +1000
Subject: [PATCH 1718/2374] Update rust when building libavif

---
 winbuild/build_prepare.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 9fee5bd9066..6cdcf6f0db3 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -389,6 +389,7 @@ def cmd_msbuild(
         "filename": f"libavif-{V['LIBAVIF']}.zip",
         "license": "LICENSE",
         "build": [
+            "rustup update",
             f"{sys.executable} -m pip install meson",
             *cmds_cmake(
                 "avif_static",

From 2603a249df9223133b74c671acfcdc6a51567843 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 23 May 2025 10:57:03 +0100
Subject: [PATCH 1719/2374] Update depends/docker-test-valgrind-memory.sh

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 depends/docker-test-valgrind-memory.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/depends/docker-test-valgrind-memory.sh b/depends/docker-test-valgrind-memory.sh
index 29fc6f2300d..5f7805421f4 100755
--- a/depends/docker-test-valgrind-memory.sh
+++ b/depends/docker-test-valgrind-memory.sh
@@ -2,7 +2,7 @@
 
 ## Run this as the test script in the docker valgrind image.
 ## Note -- can be included directly into the docker image,
-## but requires the currnet python.supp.
+## but requires the current python.supp.
 
 source /vpy3/bin/activate
 cd /Pillow

From 9526d949b07bbddfc7e515810dc23738b778bee4 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 23 May 2025 10:58:28 +0100
Subject: [PATCH 1720/2374] Update Tests/test_pyarrow.py

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

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index e7fce1e3399..c5872231b3b 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -162,7 +162,7 @@ class DataShape(NamedTuple):
 
 UINT_ARR = DataShape(
     dtype=fl_uint8_4_type,
-    elt=[1, 2, 3, 4],  # array of 4 uint 8 per pixel
+    elt=[1, 2, 3, 4],  # array of 4 uint8 per pixel
     elts_per_pixel=1,  # only one array per pixel
 )
 

From 6807bd3d70cc5873b3cad29d598e08a34fdc1fa0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 May 2025 00:03:08 +1000
Subject: [PATCH 1721/2374] Added type hints

---
 .ci/requirements-mypy.txt |  1 +
 Tests/test_pyarrow.py     | 20 ++++++++++++--------
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 2e361047891..86ac2e0b26b 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -4,6 +4,7 @@ IceSpringPySideStubs-PySide6
 ipython
 numpy
 packaging
+pyarrow-stubs
 pytest
 sphinx
 types-atheris
diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index c5872231b3b..2029f96f568 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -13,7 +13,11 @@
     is_big_endian,
 )
 
-pyarrow = pytest.importorskip("pyarrow", reason="PyArrow not installed")
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    import pyarrow
+else:
+    pyarrow = pytest.importorskip("pyarrow", reason="PyArrow not installed")
 
 TEST_IMAGE_SIZE = (10, 10)
 
@@ -94,14 +98,14 @@ def _test_img_equals_int32_pyarray(
         ("HSV", fl_uint8_4_type, [0, 1, 2]),
     ),
 )
-def test_to_array(mode: str, dtype: Any, mask: list[int] | None) -> None:
+def test_to_array(mode: str, dtype: pyarrow.DataType, mask: list[int] | None) -> None:
     img = hopper(mode)
 
     # Resize to non-square
     img = img.crop((3, 0, 124, 127))
     assert img.size == (121, 127)
 
-    arr = pyarrow.array(img)
+    arr = pyarrow.array(img)  # type: ignore[call-overload]
     _test_img_equals_pyarray(img, arr, mask)
     assert arr.type == dtype
 
@@ -118,8 +122,8 @@ def test_lifetime() -> None:
 
     img = hopper("L")
 
-    arr_1 = pyarrow.array(img)
-    arr_2 = pyarrow.array(img)
+    arr_1 = pyarrow.array(img)  # type: ignore[call-overload]
+    arr_2 = pyarrow.array(img)  # type: ignore[call-overload]
 
     del img
 
@@ -136,8 +140,8 @@ def test_lifetime2() -> None:
 
     img = hopper("L")
 
-    arr_1 = pyarrow.array(img)
-    arr_2 = pyarrow.array(img)
+    arr_1 = pyarrow.array(img)  # type: ignore[call-overload]
+    arr_2 = pyarrow.array(img)  # type: ignore[call-overload]
 
     assert arr_1.sum().as_py() > 0
     del arr_1
@@ -152,7 +156,7 @@ def test_lifetime2() -> None:
 
 
 class DataShape(NamedTuple):
-    dtype: Any
+    dtype: pyarrow.DataType
     # Strictly speaking, elt should be a pixel or pixel component, so
     # list[uint8][4], float, int, uint32, uint8, etc.  But more
     # correctly, it should be exactly the dtype from the line above.

From 60a1a20536fe18cfe936e90140ed56c3eb31bd81 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Fri, 23 May 2025 15:32:46 +0200
Subject: [PATCH 1722/2374] add timeouts to two more tests

---
 Tests/test_file_tiff.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 502d9df9a33..050bfe57809 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -990,6 +990,10 @@ def test_string_dimension(self) -> None:
 
     @pytest.mark.timeout(6)
     @pytest.mark.filterwarnings("ignore:Truncated File Read")
+    @pytest.mark.xfail(
+        "PILLOW_VALGRIND_TEST" in os.environ,
+        reason="Valgrind is slower"
+    )
     def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/timeout-6646305047838720") as im:
             monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
@@ -1002,6 +1006,10 @@ def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
         ],
     )
     @pytest.mark.timeout(2)
+    @pytest.mark.xfail(
+        "PILLOW_VALGRIND_TEST" in os.environ,
+        reason="Valgrind is slower"
+    )
     def test_oom(self, test_file: str) -> None:
         with pytest.raises(UnidentifiedImageError):
             with pytest.warns(UserWarning):

From c63db77db3850c51df38af8f4a96f5c13f286b42 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Fri, 23 May 2025 13:37:02 +0000
Subject: [PATCH 1723/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_file_tiff.py | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 050bfe57809..b6985b83b36 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -991,8 +991,7 @@ def test_string_dimension(self) -> None:
     @pytest.mark.timeout(6)
     @pytest.mark.filterwarnings("ignore:Truncated File Read")
     @pytest.mark.xfail(
-        "PILLOW_VALGRIND_TEST" in os.environ,
-        reason="Valgrind is slower"
+        "PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower"
     )
     def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/timeout-6646305047838720") as im:
@@ -1007,8 +1006,7 @@ def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
     )
     @pytest.mark.timeout(2)
     @pytest.mark.xfail(
-        "PILLOW_VALGRIND_TEST" in os.environ,
-        reason="Valgrind is slower"
+        "PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower"
     )
     def test_oom(self, test_file: str) -> None:
         with pytest.raises(UnidentifiedImageError):

From 4d0678ca33b65af2686fe93be5b77c2b28027959 Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Fri, 23 May 2025 16:35:57 +0200
Subject: [PATCH 1724/2374] Add parallel test target, using pytest-xdist

---
 Makefile       | 8 +++++++-
 pyproject.toml | 1 +
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/Makefile b/Makefile
index 5a815245402..a56fe8fec3c 100644
--- a/Makefile
+++ b/Makefile
@@ -95,7 +95,13 @@ sdist:
 .PHONY: test
 test:
 	python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
-	python3 -m pytest -qq
+	python3 -m pytest -qq Tests/
+
+.PHONY: test-p
+test-p:
+	python3 -c "import xdist" > /dev/null 2>&1 || python3 -m pip install pytest-xdist
+	python3 -m pytest -qq -n auto Tests/
+
 
 .PHONY: valgrind
 valgrind:
diff --git a/pyproject.toml b/pyproject.toml
index a3ff9723b4e..683ab24ef07 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -70,6 +70,7 @@ optional-dependencies.tests = [
   "pytest",
   "pytest-cov",
   "pytest-timeout",
+  "pytest-xdist",
   "trove-classifiers>=2024.10.12",
 ]
 

From e018dc99faf8d7196ec2a2e7d2760cede851fbd9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 24 May 2025 08:51:51 +1000
Subject: [PATCH 1725/2374] Updated libpng to 1.6.48

---
 .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 a6b52064ceb..1583435c13f 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -39,7 +39,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=11.2.1
-LIBPNG_VERSION=1.6.47
+LIBPNG_VERSION=1.6.48
 JPEGTURBO_VERSION=3.1.0
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.8.1
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index d23f0eb5b59..6e176e29cf3 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -118,7 +118,7 @@ def cmd_msbuild(
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.3.4",
-    "LIBPNG": "1.6.47",
+    "LIBPNG": "1.6.48",
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.7.0",

From 4eb89f8e5bcd19ad64ed2328c9566061a7116cc2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 21 May 2025 20:36:19 +1000
Subject: [PATCH 1726/2374] Reduced number of bytes read for header

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

diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index f709d026bfd..d569cb4b819 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -81,7 +81,7 @@ class WmfStubImageFile(ImageFile.StubImageFile):
 
     def _open(self) -> None:
         # check placable header
-        s = self.fp.read(80)
+        s = self.fp.read(44)
 
         if s.startswith(b"\xd7\xcd\xc6\x9a\x00\x00"):
             # placeable windows metafile

From 57b77bde96484d4a1d6f92adec9a2c2b86485f55 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 24 May 2025 11:55:18 +1000
Subject: [PATCH 1727/2374] Removed CMAKE_POLICY_VERSION_MINIMUM=3.5

---
 .ci/install.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index d065e7ab5c5..acb84f046d1 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -66,7 +66,7 @@ if [[ $(uname) != CYGWIN* ]]; then
     pushd depends && ./install_raqm.sh && popd
 
     # libavif
-    pushd depends && CMAKE_POLICY_VERSION_MINIMUM=3.5 ./install_libavif.sh && popd
+    pushd depends && ./install_libavif.sh && popd
 
     # extra test images
     pushd depends && ./install_extra_test_images.sh && popd

From 041acf13440f9307dcc129eff21bcd065362ae91 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 25 May 2025 15:00:47 +1000
Subject: [PATCH 1728/2374] Clear core image if memory mapping was used for
 last load

---
 Tests/test_tiff_crashes.py | 14 ++++++++++++++
 src/PIL/TiffImagePlugin.py |  5 +++--
 2 files changed, 17 insertions(+), 2 deletions(-)

diff --git a/Tests/test_tiff_crashes.py b/Tests/test_tiff_crashes.py
index 073e5415c41..976f6238465 100644
--- a/Tests/test_tiff_crashes.py
+++ b/Tests/test_tiff_crashes.py
@@ -52,3 +52,17 @@ def test_tiff_crashes(test_file: str) -> None:
         pytest.skip("test image not found")
     except OSError:
         pass
+
+
+def test_tiff_mmap() -> None:
+    try:
+        with Image.open("Tests/images/crash_mmap.tif") as im:
+            im.seek(1)
+            im.load()
+
+            im.seek(0)
+            im.load()
+    except FileNotFoundError:
+        if on_ci():
+            raise
+        pytest.skip("test image not found")
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 88af9162e0a..5cbac0c2679 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1217,9 +1217,10 @@ def seek(self, frame: int) -> None:
             return
         self._seek(frame)
         if self._im is not None and (
-            self.im.size != self._tile_size or self.im.mode != self.mode
+            self.im.size != self._tile_size
+            or self.im.mode != self.mode
+            or self.readonly
         ):
-            # The core image will no longer be used
             self._im = None
 
     def _seek(self, frame: int) -> None:

From eff667a8614ba3b567684597795924387c8cbaaa Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 23 May 2025 10:22:59 +0100
Subject: [PATCH 1729/2374] Mark the image read-only in the C layer if it's
 created from a read only buffer

---
 src/map.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/map.c b/src/map.c
index c66702981d3..9a3144ab904 100644
--- a/src/map.c
+++ b/src/map.c
@@ -137,6 +137,7 @@ PyImaging_MapBuffer(PyObject *self, PyObject *args) {
         }
     }
 
+    im->read_only = view.readonly;
     im->destroy = mapping_destroy_buffer;
 
     Py_INCREF(target);

From bcc6e42bf82dfc962d49ed1876a946bd7be16b4f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 27 May 2025 21:08:58 +1000
Subject: [PATCH 1730/2374] Fixed saving MPO with more than one appended image

---
 Tests/test_file_mpo.py    | 22 ++++++++++++----------
 src/PIL/MpoImagePlugin.py | 13 ++++++++++---
 2 files changed, 22 insertions(+), 13 deletions(-)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 73838ef4484..adfa61962b7 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -293,16 +293,18 @@ def test_save_all() -> None:
             assert_image_similar(im, im_reloaded, 30)
 
     im = Image.new("RGB", (1, 1))
-    im2 = Image.new("RGB", (1, 1), "#f00")
-    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)
-    assert_image_similar(im2, im_reloaded, 1)
+    for colors in (("#f00",), ("#f00", "#0f0")):
+        append_images = (Image.new("RGB", (1, 1), color) for color in colors)
+        im_reloaded = roundtrip(im, save_all=True, append_images=append_images)
+
+        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"
+
+        for im_expected in append_images:
+            im_reloaded.seek(im_reloaded.tell() + 1)
+            assert_image_similar(im_reloaded, im_expected, 1)
 
     # Test that a single frame image will not be saved as an MPO
     jpg = roundtrip(im, save_all=True)
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index f7393eac059..f96f658fcdb 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -19,7 +19,6 @@
 #
 from __future__ import annotations
 
-import itertools
 import os
 import struct
 from typing import IO, Any, cast
@@ -47,12 +46,20 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     mpf_offset = 28
     offsets: list[int] = []
-    for imSequence in itertools.chain([im], append_images):
+    total = 0
+    imSequences = [im] + list(append_images)
+    for imSequence in imSequences:
+        total += getattr(imSequence, "n_frames", 1)
+    for imSequence in imSequences:
         for im_frame in ImageSequence.Iterator(imSequence):
             if not offsets:
                 # APP2 marker
+                ifd_length = 66 + 16 * total
                 im_frame.encoderinfo["extra"] = (
-                    b"\xff\xe2" + struct.pack(">H", 6 + 82) + b"MPF\0" + b" " * 82
+                    b"\xff\xe2"
+                    + struct.pack(">H", 6 + ifd_length)
+                    + b"MPF\0"
+                    + b" " * ifd_length
                 )
                 exif = im_frame.encoderinfo.get("exif")
                 if isinstance(exif, Image.Exif):

From 5a04b9581b16a7f1e1109f1e31a206a6550f314c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 28 May 2025 08:20:35 +1000
Subject: [PATCH 1731/2374] Run slow tests on valgrind, but without timeout
 (#8975)

---
 Tests/helper.py            |  6 ++++++
 Tests/test_file_eps.py     |  3 ++-
 Tests/test_file_fli.py     |  9 +++++++--
 Tests/test_file_jpeg.py    |  3 ++-
 Tests/test_file_pdf.py     | 10 +++++++---
 Tests/test_file_tiff.py    |  5 +++--
 Tests/test_image.py        |  6 ++----
 Tests/test_imagefontpil.py |  4 ++--
 8 files changed, 31 insertions(+), 15 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 909fff879c8..ec61cd263e9 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -161,6 +161,12 @@ def assert_tuple_approx_equal(
             pytest.fail(msg + ": " + repr(actuals) + " != " + repr(targets))
 
 
+def timeout_unless_slower_valgrind(timeout: float) -> pytest.MarkDecorator:
+    if "PILLOW_VALGRIND_TEST" in os.environ:
+        return pytest.mark.pil_noop_mark()
+    return pytest.mark.timeout(timeout)
+
+
 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/test_file_eps.py b/Tests/test_file_eps.py
index b484a8cfa0a..d94de728709 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -15,6 +15,7 @@
     is_win32,
     mark_if_feature_version,
     skip_unless_feature,
+    timeout_unless_slower_valgrind,
 )
 
 HAS_GHOSTSCRIPT = EpsImagePlugin.has_ghostscript()
@@ -398,7 +399,7 @@ def test_emptyline() -> None:
     assert image.format == "EPS"
 
 
-@pytest.mark.timeout(timeout=5)
+@timeout_unless_slower_valgrind(5)
 @pytest.mark.parametrize(
     "test_file",
     ["Tests/images/eps/timeout-d675703545fee17acab56e5fec644c19979175de.eps"],
diff --git a/Tests/test_file_fli.py b/Tests/test_file_fli.py
index 81df1ab0b80..0fadd01d0c9 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -7,7 +7,12 @@
 
 from PIL import FliImagePlugin, Image, ImageFile
 
-from .helper import assert_image_equal, assert_image_equal_tofile, is_pypy
+from .helper import (
+    assert_image_equal,
+    assert_image_equal_tofile,
+    is_pypy,
+    timeout_unless_slower_valgrind,
+)
 
 # created as an export of a palette image from Gimp2.6
 # save as...-> hopper.fli, default options.
@@ -189,7 +194,7 @@ def test_seek() -> None:
         "Tests/images/timeout-bff0a9dc7243a8e6ede2408d2ffa6a9964698b87.fli",
     ],
 )
-@pytest.mark.timeout(timeout=3)
+@timeout_unless_slower_valgrind(3)
 def test_timeouts(test_file: str) -> None:
     with open(test_file, "rb") as f:
         with Image.open(f) as im:
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 79f0ec1a809..b9eec591dcf 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -32,6 +32,7 @@
     is_win32,
     mark_if_feature_version,
     skip_unless_feature,
+    timeout_unless_slower_valgrind,
 )
 
 ElementTree: ModuleType | None
@@ -1033,7 +1034,7 @@ def test_save_xmp(self, tmp_path: Path) -> None:
         with pytest.raises(ValueError):
             im.save(f, xmp=b"1" * 65505)
 
-    @pytest.mark.timeout(timeout=1)
+    @timeout_unless_slower_valgrind(1)
     def test_eof(self, monkeypatch: pytest.MonkeyPatch) -> None:
         # Even though this decoder never says that it is finished
         # the image should still end when there is no new data
diff --git a/Tests/test_file_pdf.py b/Tests/test_file_pdf.py
index bde1e3ab847..a2218673b44 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -13,7 +13,12 @@
 
 from PIL import Image, PdfParser, features
 
-from .helper import hopper, mark_if_feature_version, skip_unless_feature
+from .helper import (
+    hopper,
+    mark_if_feature_version,
+    skip_unless_feature,
+    timeout_unless_slower_valgrind,
+)
 
 
 def helper_save_as_pdf(tmp_path: Path, mode: str, **kwargs: Any) -> str:
@@ -339,8 +344,7 @@ def test_pdf_append_to_bytesio() -> None:
     assert len(f.getvalue()) > initial_size
 
 
-@pytest.mark.timeout(1)
-@pytest.mark.skipif("PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower")
+@timeout_unless_slower_valgrind(1)
 @pytest.mark.parametrize("newline", (b"\r", b"\n"))
 def test_redos(newline: bytes) -> None:
     malicious = b" trailer<<>>" + newline * 3456
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 502d9df9a33..d0d394aa9cd 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -26,6 +26,7 @@
     hopper,
     is_pypy,
     is_win32,
+    timeout_unless_slower_valgrind,
 )
 
 ElementTree: ModuleType | None
@@ -988,7 +989,7 @@ def test_string_dimension(self) -> None:
             with pytest.raises(OSError):
                 im.load()
 
-    @pytest.mark.timeout(6)
+    @timeout_unless_slower_valgrind(6)
     @pytest.mark.filterwarnings("ignore:Truncated File Read")
     def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/timeout-6646305047838720") as im:
@@ -1001,7 +1002,7 @@ def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
             "Tests/images/oom-225817ca0f8c663be7ab4b9e717b02c661e66834.tif",
         ],
     )
-    @pytest.mark.timeout(2)
+    @timeout_unless_slower_valgrind(2)
     def test_oom(self, test_file: str) -> None:
         with pytest.raises(UnidentifiedImageError):
             with pytest.warns(UserWarning):
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 7e6118d5280..14a0671277d 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -34,6 +34,7 @@
     is_win32,
     mark_if_feature_version,
     skip_unless_feature,
+    timeout_unless_slower_valgrind,
 )
 
 ElementTree: ModuleType | None
@@ -572,10 +573,7 @@ def test_check_size(self) -> None:
         i = Image.new("RGB", [1, 1])
         assert isinstance(i.size, tuple)
 
-    @pytest.mark.timeout(0.75)
-    @pytest.mark.skipif(
-        "PILLOW_VALGRIND_TEST" in os.environ, reason="Valgrind is slower"
-    )
+    @timeout_unless_slower_valgrind(0.75)
     @pytest.mark.parametrize("size", ((0, 100000000), (100000000, 0)))
     def test_empty_image(self, size: tuple[int, int]) -> None:
         Image.new("RGB", size)
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index 695aecbded2..3eb98d3797d 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -7,7 +7,7 @@
 
 from PIL import Image, ImageDraw, ImageFont, _util, features
 
-from .helper import assert_image_equal_tofile
+from .helper import assert_image_equal_tofile, timeout_unless_slower_valgrind
 
 fonts = [ImageFont.load_default_imagefont()]
 if not features.check_module("freetype2"):
@@ -72,7 +72,7 @@ def test_decompression_bomb() -> None:
         font.getmask("A" * 1_000_000)
 
 
-@pytest.mark.timeout(4)
+@timeout_unless_slower_valgrind(4)
 def test_oom() -> None:
     glyph = struct.pack(
         ">hhhhhhhhhh", 1, 0, -32767, -32767, 32767, 32767, -32767, -32767, 32767, 32767

From 5000c83bcc1514d371be53b52b50aaf7237506d5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 28 May 2025 23:50:18 +1000
Subject: [PATCH 1732/2374] Use multi-phase initialization

---
 src/_avif.c         | 24 ++++++++++--------------
 src/_imaging.c      | 25 ++++++++++---------------
 src/_imagingcms.c   | 26 +++++++++++---------------
 src/_imagingft.c    | 24 ++++++++++--------------
 src/_imagingmath.c  | 24 ++++++++++--------------
 src/_imagingmorph.c | 19 +++++++++----------
 src/_imagingtk.c    | 22 ++++++++++------------
 src/_webp.c         | 24 ++++++++++--------------
 8 files changed, 80 insertions(+), 108 deletions(-)

diff --git a/src/_avif.c b/src/_avif.c
index 7e7bee7031b..3585297fe87 100644
--- a/src/_avif.c
+++ b/src/_avif.c
@@ -881,26 +881,22 @@ setup_module(PyObject *m) {
     return 0;
 }
 
+static PyModuleDef_Slot slots[] = {
+    {Py_mod_exec, setup_module},
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__avif(void) {
-    PyObject *m;
-
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_avif",
-        .m_size = -1,
         .m_methods = avifMethods,
+        .m_slots = slots
     };
 
-    m = PyModule_Create(&module_def);
-    if (setup_module(m) < 0) {
-        Py_DECREF(m);
-        return NULL;
-    }
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
-
-    return m;
+    return PyModuleDef_Init(&module_def);
 }
diff --git a/src/_imaging.c b/src/_imaging.c
index 72f12214390..0c93a96bc81 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4460,27 +4460,22 @@ setup_module(PyObject *m) {
     return 0;
 }
 
+static PyModuleDef_Slot slots[] = {
+    {Py_mod_exec, setup_module},
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__imaging(void) {
-    PyObject *m;
-
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_imaging",
-        .m_size = -1,
         .m_methods = functions,
+        .m_slots = slots
     };
 
-    m = PyModule_Create(&module_def);
-
-    if (setup_module(m) < 0) {
-        Py_DECREF(m);
-        return NULL;
-    }
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
-
-    return m;
+    return PyModuleDef_Init(&module_def);
 }
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index f93c1613b47..e2f29d1b708 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1463,28 +1463,24 @@ setup_module(PyObject *m) {
     return 0;
 }
 
+static PyModuleDef_Slot slots[] = {
+    {Py_mod_exec, setup_module},
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__imagingcms(void) {
-    PyObject *m;
+    PyDateTime_IMPORT;
 
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_imagingcms",
-        .m_size = -1,
         .m_methods = pyCMSdll_methods,
+        .m_slots = slots
     };
 
-    m = PyModule_Create(&module_def);
-
-    if (setup_module(m) < 0) {
-        return NULL;
-    }
-
-    PyDateTime_IMPORT;
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
-
-    return m;
+    return PyModuleDef_Init(&module_def);
 }
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 62dab73e5c0..c3e6e2f391a 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1599,26 +1599,22 @@ setup_module(PyObject *m) {
     return 0;
 }
 
+static PyModuleDef_Slot slots[] = {
+    {Py_mod_exec, setup_module},
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__imagingft(void) {
-    PyObject *m;
-
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_imagingft",
-        .m_size = -1,
         .m_methods = _functions,
+        .m_slots = slots
     };
 
-    m = PyModule_Create(&module_def);
-
-    if (setup_module(m) < 0) {
-        return NULL;
-    }
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
-
-    return m;
+    return PyModuleDef_Init(&module_def);
 }
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index 4b9bf08ba00..48c3959003e 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -302,26 +302,22 @@ setup_module(PyObject *m) {
     return 0;
 }
 
+static PyModuleDef_Slot slots[] = {
+    {Py_mod_exec, setup_module},
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__imagingmath(void) {
-    PyObject *m;
-
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_imagingmath",
-        .m_size = -1,
         .m_methods = _functions,
+        .m_slots = slots
     };
 
-    m = PyModule_Create(&module_def);
-
-    if (setup_module(m) < 0) {
-        return NULL;
-    }
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
-
-    return m;
+    return PyModuleDef_Init(&module_def);
 }
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index a2088829424..5995f9d429e 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -246,23 +246,22 @@ static PyMethodDef functions[] = {
     {NULL, NULL, 0, NULL}
 };
 
+static PyModuleDef_Slot slots[] = {
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__imagingmorph(void) {
-    PyObject *m;
-
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_imagingmorph",
         .m_doc = "A module for doing image morphology",
-        .m_size = -1,
         .m_methods = functions,
+        .m_slots = slots
     };
 
-    m = PyModule_Create(&module_def);
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
-
-    return m;
+    return PyModuleDef_Init(&module_def);
 }
diff --git a/src/_imagingtk.c b/src/_imagingtk.c
index 4e06fe9b848..68d7bf4cd11 100644
--- a/src/_imagingtk.c
+++ b/src/_imagingtk.c
@@ -46,24 +46,22 @@ static PyMethodDef functions[] = {
     {NULL, NULL} /* sentinel */
 };
 
+static PyModuleDef_Slot slots[] = {
+    {Py_mod_exec, load_tkinter_funcs},
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__imagingtk(void) {
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_imagingtk",
-        .m_size = -1,
         .m_methods = functions,
+        .m_slots = slots
     };
-    PyObject *m;
-    m = PyModule_Create(&module_def);
-    if (load_tkinter_funcs() != 0) {
-        Py_DECREF(m);
-        return NULL;
-    }
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
 
-    return m;
+    return PyModuleDef_Init(&module_def);
 }
diff --git a/src/_webp.c b/src/_webp.c
index 3aa4c408b71..0dff9f6dd51 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -777,26 +777,22 @@ setup_module(PyObject *m) {
     return 0;
 }
 
+static PyModuleDef_Slot slots[] = {
+    {Py_mod_exec, setup_module},
+#ifdef Py_GIL_DISABLED
+    {Py_mod_gil, Py_MOD_GIL_NOT_USED},
+#endif
+    {0, NULL}
+};
+
 PyMODINIT_FUNC
 PyInit__webp(void) {
-    PyObject *m;
-
     static PyModuleDef module_def = {
         PyModuleDef_HEAD_INIT,
         .m_name = "_webp",
-        .m_size = -1,
         .m_methods = webpMethods,
+        .m_slots = slots
     };
 
-    m = PyModule_Create(&module_def);
-    if (setup_module(m) < 0) {
-        Py_DECREF(m);
-        return NULL;
-    }
-
-#ifdef Py_GIL_DISABLED
-    PyUnstable_Module_SetGIL(m, Py_MOD_GIL_NOT_USED);
-#endif
-
-    return m;
+    return PyModuleDef_Init(&module_def);
 }

From 2ee2a1496d9d4b2cc1f8455342d0e2f5da8f542c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 21 May 2025 22:06:27 +1000
Subject: [PATCH 1733/2374] Simplified code

---
 src/PIL/ImageGrab.py       | 5 +----
 src/PIL/JpegImagePlugin.py | 9 +++------
 src/libImaging/Arrow.c     | 6 +++---
 3 files changed, 7 insertions(+), 13 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index c29350b7a81..d11609483d0 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -134,10 +134,7 @@ def grabclipboard() -> Image.Image | list[str] | None:
             import struct
 
             o = struct.unpack_from("I", data)[0]
-            if data[16] != 0:
-                files = data[o:].decode("utf-16le").split("\0")
-            else:
-                files = data[o:].decode("mbcs").split("\0")
+            files = data[o:].decode("mbcs" if data[16] == 0 else "utf-16le").split("\0")
             return files[: files.index("")]
         if isinstance(data, bytes):
             data = io.BytesIO(data)
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 96952884118..defe9f773f9 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -762,8 +762,7 @@ def validate_qtables(
     extra = info.get("extra", b"")
 
     MAX_BYTES_IN_MARKER = 65533
-    xmp = info.get("xmp")
-    if xmp:
+    if xmp := info.get("xmp"):
         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:
@@ -772,8 +771,7 @@ def validate_qtables(
         size = o16(2 + overhead_len + len(xmp))
         extra += b"\xff\xe1" + size + b"http://ns.adobe.com/xap/1.0/\x00" + xmp
 
-    icc_profile = info.get("icc_profile")
-    if icc_profile:
+    if icc_profile := info.get("icc_profile"):
         overhead_len = 14  # b"ICC_PROFILE\0" + o8(i) + o8(len(markers))
         max_data_bytes_in_marker = MAX_BYTES_IN_MARKER - overhead_len
         markers = []
@@ -831,7 +829,6 @@ def validate_qtables(
     # in a shot. Guessing on the size, at im.size bytes. (raw pixel size is
     # channels*size, this is a value that's been used in a django patch.
     # https://github.com/matthewwithanm/django-imagekit/issues/50
-    bufsize = 0
     if optimize or progressive:
         # CMYK can be bigger
         if im.mode == "CMYK":
@@ -848,7 +845,7 @@ def validate_qtables(
     else:
         # The EXIF info needs to be written as one block, + APP1, + one spare byte.
         # Ensure that our buffer is big enough. Same with the icc_profile block.
-        bufsize = max(bufsize, len(exif) + 5, len(extra) + 1)
+        bufsize = max(len(exif) + 5, len(extra) + 1)
 
     ImageFile._save(
         im, fp, [ImageFile._Tile("jpeg", (0, 0) + im.size, 0, rawmode)], bufsize
diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index 33ff2ce779a..3d34076dc63 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -98,7 +98,7 @@ export_imaging_schema(Imaging im, struct ArrowSchema *schema) {
     }
 
     /* for now, single block images */
-    if (!(im->blocks_count == 0 || im->blocks_count == 1)) {
+    if (im->blocks_count > 1) {
         return IMAGING_ARROW_MEMORY_LAYOUT;
     }
 
@@ -157,7 +157,7 @@ export_single_channel_array(Imaging im, struct ArrowArray *array) {
     int length = im->xsize * im->ysize;
 
     /* for now, single block images */
-    if (!(im->blocks_count == 0 || im->blocks_count == 1)) {
+    if (im->blocks_count > 1) {
         return IMAGING_ARROW_MEMORY_LAYOUT;
     }
 
@@ -200,7 +200,7 @@ export_fixed_pixel_array(Imaging im, struct ArrowArray *array) {
     int length = im->xsize * im->ysize;
 
     /* for now, single block images */
-    if (!(im->blocks_count == 0 || im->blocks_count == 1)) {
+    if (im->blocks_count > 1) {
         return IMAGING_ARROW_MEMORY_LAYOUT;
     }
 

From fcac6e78966f7cac4813731dc2303f80f844b320 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 29 May 2025 18:27:17 +1000
Subject: [PATCH 1734/2374] Removed hasAlpha argument

---
 src/libImaging/Draw.c | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index d5aff8709f5..0462933790a 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -439,9 +439,7 @@ 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) {
     Edge **edge_table;
     float *xx;
     int edge_count = 0;
@@ -461,6 +459,7 @@ polygon_generic(
         return -1;
     }
 
+    int hasAlpha = hline == hline32rgba;
     for (i = 0; i < n; i++) {
         if (ymin > e[i].ymin) {
             ymin = e[i].ymin;
@@ -592,17 +591,17 @@ polygon_generic(
 
 static inline int
 polygon8(Imaging im, int n, Edge *e, int ink, int eofill) {
-    return polygon_generic(im, n, e, ink, eofill, hline8, 0);
+    return polygon_generic(im, n, e, ink, eofill, hline8);
 }
 
 static inline int
 polygon32(Imaging im, int n, Edge *e, int ink, int eofill) {
-    return polygon_generic(im, n, e, ink, eofill, hline32, 0);
+    return polygon_generic(im, n, e, ink, eofill, hline32);
 }
 
 static inline int
 polygon32rgba(Imaging im, int n, Edge *e, int ink, int eofill) {
-    return polygon_generic(im, n, e, ink, eofill, hline32rgba, 1);
+    return polygon_generic(im, n, e, ink, eofill, hline32rgba);
 }
 
 static inline void

From 62da23bf83a568079cd514cbac6a99bf37009820 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 29 May 2025 18:22:49 +1000
Subject: [PATCH 1735/2374] Removed polygon from DRAW struct

---
 src/libImaging/Draw.c | 28 ++++++----------------------
 1 file changed, 6 insertions(+), 22 deletions(-)

diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index 0462933790a..4c08e985504 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -589,21 +589,6 @@ polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler h
     return 0;
 }
 
-static inline int
-polygon8(Imaging im, int n, Edge *e, int ink, int eofill) {
-    return polygon_generic(im, n, e, ink, eofill, hline8);
-}
-
-static inline int
-polygon32(Imaging im, int n, Edge *e, int ink, int eofill) {
-    return polygon_generic(im, n, e, ink, eofill, hline32);
-}
-
-static inline int
-polygon32rgba(Imaging im, int n, Edge *e, int ink, int eofill) {
-    return polygon_generic(im, n, e, ink, eofill, hline32rgba);
-}
-
 static inline void
 add_edge(Edge *e, int x0, int y0, int x1, int y1) {
     /* printf("edge %d %d %d %d\n", x0, y0, x1, y1); */
@@ -640,12 +625,11 @@ typedef struct {
     void (*point)(Imaging im, int x, int y, int ink);
     void (*hline)(Imaging im, int x0, int y0, int x1, int ink);
     void (*line)(Imaging im, int x0, int y0, int x1, int y1, int ink);
-    int (*polygon)(Imaging im, int n, Edge *e, int ink, int eofill);
 } DRAW;
 
-DRAW draw8 = {point8, hline8, line8, polygon8};
-DRAW draw32 = {point32, hline32, line32, polygon32};
-DRAW draw32rgba = {point32rgba, hline32rgba, line32rgba, polygon32rgba};
+DRAW draw8 = {point8, hline8, line8};
+DRAW draw32 = {point32, hline32, line32};
+DRAW draw32rgba = {point32rgba, hline32rgba, line32rgba};
 
 /* -------------------------------------------------------------------- */
 /* Interface                                                            */
@@ -730,7 +714,7 @@ ImagingDrawWideLine(
         add_edge(e + 2, vertices[2][0], vertices[2][1], vertices[3][0], vertices[3][1]);
         add_edge(e + 3, vertices[3][0], vertices[3][1], vertices[0][0], vertices[0][1]);
 
-        draw->polygon(im, 4, e, ink, 0);
+        polygon_generic(im, 4, e, ink, 0, draw->hline);
     }
     return 0;
 }
@@ -838,7 +822,7 @@ ImagingDrawPolygon(
         if (xy[i * 2] != xy[0] || xy[i * 2 + 1] != xy[1]) {
             add_edge(&e[n++], xy[i * 2], xy[i * 2 + 1], xy[0], xy[1]);
         }
-        draw->polygon(im, n, e, ink, 0);
+        polygon_generic(im, n, e, ink, 0, draw->hline);
         free(e);
 
     } else {
@@ -1988,7 +1972,7 @@ ImagingDrawOutline(
 
     DRAWINIT();
 
-    draw->polygon(im, outline->count, outline->edges, ink, 0);
+    polygon_generic(im, outline->count, outline->edges, ink, 0, draw->hline);
 
     return 0;
 }

From 6a60b2e6dd0909f627d093cbc431891a79d2b987 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 30 May 2025 10:27:11 +0100
Subject: [PATCH 1736/2374] Remove Tests/ path arg, this is already configured

---
 Makefile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Makefile b/Makefile
index a56fe8fec3c..1f9d2ce1330 100644
--- a/Makefile
+++ b/Makefile
@@ -95,12 +95,12 @@ sdist:
 .PHONY: test
 test:
 	python3 -c "import pytest" > /dev/null 2>&1 || python3 -m pip install pytest
-	python3 -m pytest -qq Tests/
+	python3 -m pytest -qq
 
 .PHONY: test-p
 test-p:
 	python3 -c "import xdist" > /dev/null 2>&1 || python3 -m pip install pytest-xdist
-	python3 -m pytest -qq -n auto Tests/
+	python3 -m pytest -qq -n auto
 
 
 .PHONY: valgrind

From 98cf15e9e487cbc53b101498d43cc0cc141ee7e7 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 30 May 2025 10:35:13 +0100
Subject: [PATCH 1737/2374] Update depends/docker-test-valgrind-memory.sh

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 depends/docker-test-valgrind-memory.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/depends/docker-test-valgrind-memory.sh b/depends/docker-test-valgrind-memory.sh
index 5f7805421f4..f0d1d851dd1 100755
--- a/depends/docker-test-valgrind-memory.sh
+++ b/depends/docker-test-valgrind-memory.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 
-## Run this as the test script in the docker valgrind image.
-## Note -- can be included directly into the docker image,
+## Run this as the test script in the Docker valgrind image.
+## Note -- can be included directly into the Docker image,
 ## but requires the current python.supp.
 
 source /vpy3/bin/activate

From 399b6c1045ff2387e7db8206e72baec33f996030 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 30 May 2025 10:40:07 +0100
Subject: [PATCH 1738/2374] Update Makefile

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

diff --git a/Makefile b/Makefile
index 4f63cfe020f..27d70dcb720 100644
--- a/Makefile
+++ b/Makefile
@@ -110,7 +110,7 @@ valgrind-leak:
 	PILLOW_VALGRIND_TEST=true PYTHONMALLOC=malloc valgrind --suppressions=Tests/oss-fuzz/python.supp \
 	    --leak-check=full --show-leak-kinds=definite --errors-for-leak-kinds=definite \
             --log-file=/tmp/valgrind-output \
-            python3 -m pytest -vv --valgrind --valgrind-log=/tmp/valgrind-output Tests/
+            python3 -m pytest -vv --valgrind --valgrind-log=/tmp/valgrind-output
 
 .PHONY: readme
 readme:

From 506691729a2f9d33228f8693cdbe90418e1b321a Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 30 May 2025 10:40:35 +0100
Subject: [PATCH 1739/2374] Apply suggestions from code review

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 Tests/test_pyarrow.py    | 4 ++--
 src/libImaging/Storage.c | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index 2029f96f568..8dad94fe035 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -29,7 +29,7 @@ def _test_img_equals_pyarray(
     px = img.load()
     assert px is not None
     if elts_per_pixel > 1 and mask is None:
-        # have to do element wise comparison when we're comparing
+        # have to do element-wise comparison when we're comparing
         # flattened r,g,b,a to a pixel.
         mask = list(range(elts_per_pixel))
     for x in range(0, img.size[0], int(img.size[0] / 10)):
@@ -56,7 +56,7 @@ def _test_img_equals_int32_pyarray(
     px = img.load()
     assert px is not None
     if mask is None:
-        # have to do element wise comparison when we're comparing
+        # have to do element-wise comparison when we're comparing
         # flattened rgba in an uint32 to a pixel.
         mask = list(range(elts_per_pixel))
     for x in range(0, img.size[0], int(img.size[0] / 10)):
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 1a9171a0cbb..6f0a1bfa3a1 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -757,7 +757,7 @@ ImagingNewArrow(
     if (strcmp(schema->format, "C") == 0            // uint8
         && im->pixelsize == 4                       // storage as 32 bpc
         && schema->n_children == 0                  // make sure schema is well formed.
-        && strcmp(im->arrow_band_format, "C") == 0  // Expected Format
+        && strcmp(im->arrow_band_format, "C") == 0  // expected format
         && 4 * pixels == external_array->length) {  // expected length
         // single flat array, interleaved storage.
         if (ImagingBorrowArrow(im, external_array, 1, array_capsule)) {

From 3944db288a5b54ea6171fd1334e517fbcc3c9136 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=BB=93=E9=BC=A0?= <zhuxx2003@gmail.com>
Date: Sat, 31 May 2025 09:10:45 +0800
Subject: [PATCH 1740/2374] Update MinGW package names (#8987)

---
 docs/installation/building-from-source.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index c72568b208e..8988a92ce36 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -194,9 +194,9 @@ Many of Pillow's features require external libraries:
 
         pacman -S \
             mingw-w64-x86_64-gcc \
-            mingw-w64-x86_64-python3 \
-            mingw-w64-x86_64-python3-pip \
-            mingw-w64-x86_64-python3-setuptools
+            mingw-w64-x86_64-python \
+            mingw-w64-x86_64-python-pip \
+            mingw-w64-x86_64-python-setuptools
 
     Prerequisites are installed on **MSYS2 MinGW 64-bit** with::
 

From bc4138f1692d718ec9fe7b3b7449dc20d0e2d85e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 31 May 2025 11:48:49 +1000
Subject: [PATCH 1741/2374] ubuntu-latest now uses Ubuntu 24.04

---
 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 93486d034c8..1071380fdf3 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -42,11 +42,13 @@ These platforms are built and tested for every change.
 | macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13,    | arm64               |
 |                                  | PyPy3                      |                     |
 +----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 22.04 LTS (Jammy)   | 3.9, 3.10, 3.11,           | x86-64              |
-|                                  | 3.12, 3.13, PyPy3          |                     |
+| Ubuntu Linux 22.04 LTS (Jammy)   | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, arm64v8,    |
-|                                  |                            | ppc64le, s390x      |
+| Ubuntu Linux 24.04 LTS (Noble)   | 3.9, 3.10, 3.11,           | x86-64              |
+|                                  | 3.12, 3.13, PyPy3          |                     |
+|                                  +----------------------------+---------------------+
+|                                  | 3.12                       | arm64v8, ppc64le,   |
+|                                  |                            | s390x               |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2019              | 3.9                        | x86                 |
 +----------------------------------+----------------------------+---------------------+

From 9327e425ba77523ec9d98eb9558806ecf29b9365 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 31 May 2025 12:02:16 +1000
Subject: [PATCH 1742/2374] Stop testing deprecated Windows Server 2019

---
 .github/workflows/test-windows.yml     | 5 ++---
 docs/installation/platform-support.rst | 6 +++---
 winbuild/README.md                     | 3 +--
 3 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index bfa4c7cd3d6..6b76351b001 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -31,16 +31,15 @@ env:
 
 jobs:
   build:
-    runs-on: ${{ matrix.os }}
+    runs-on: windows-latest
     strategy:
       fail-fast: false
       matrix:
         python-version: ["pypy3.11", "pypy3.10", "3.10", "3.11", "3.12", "3.13", "3.14"]
         architecture: ["x64"]
-        os: ["windows-latest"]
         include:
             # Test the oldest Python on 32-bit
-            - { python-version: "3.9", architecture: "x86", os: "windows-2019" }
+            - { python-version: "3.9", architecture: "x86" }
 
     timeout-minutes: 45
 
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 93486d034c8..f262d861c07 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -48,9 +48,9 @@ These platforms are built and tested for every change.
 | Ubuntu Linux 24.04 LTS (Noble)   | 3.12                       | x86-64, arm64v8,    |
 |                                  |                            | ppc64le, s390x      |
 +----------------------------------+----------------------------+---------------------+
-| Windows Server 2019              | 3.9                        | x86                 |
-+----------------------------------+----------------------------+---------------------+
-| Windows Server 2022              | 3.10, 3.11, 3.12, 3.13,    | x86-64              |
+| Windows Server 2022              | 3.9                        | x86                 |
+|                                  +----------------------------+---------------------+
+|                                  | 3.10, 3.11, 3.12, 3.13,    | x86-64              |
 |                                  | PyPy3                      |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12 (MinGW)               | x86-64              |
diff --git a/winbuild/README.md b/winbuild/README.md
index c474f12ceee..0d3ec8d8aa4 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -11,8 +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 2022 with Visual Studio 2022 Enterprise and Windows Server
-  2019 with Visual Studio 2019 Enterprise (GitHub Actions).
+* Tested on Windows Server 2022 with Visual Studio 2022 Enterprise (GitHub Actions).
 
 Here's an example script to build on Windows:
 

From 2059e060051acd2024360834da435a266d9dc665 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 30 May 2025 09:56:47 +0100
Subject: [PATCH 1743/2374] Add parallel compile from pybind11

---
 pyproject.toml | 1 +
 setup.py       | 5 ++++-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 683ab24ef07..ae4b70990bf 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,7 @@
 [build-system]
 build-backend = "backend"
 requires = [
+  "pybind11",
   "setuptools>=77",
 ]
 backend-path = [
diff --git a/setup.py b/setup.py
index ab36c6b1783..ec6b47b1c8c 100644
--- a/setup.py
+++ b/setup.py
@@ -18,9 +18,12 @@
 from collections.abc import Iterator
 from typing import Any
 
+from pybind11.setup_helpers import ParallelCompile
 from setuptools import Extension, setup
 from setuptools.command.build_ext import build_ext
 
+ParallelCompile("MAX_CONCURRENCY", default=0).install()
+
 
 def get_version() -> str:
     version_file = "src/PIL/_version.py"
@@ -1048,12 +1051,12 @@ def debug_build() -> bool:
     Extension("PIL._imagingmorph", ["src/_imagingmorph.c"]),
 ]
 
-
 # parse configuration from _custom_build/backend.py
 while sys.argv[-1].startswith("--pillow-configuration="):
     _, key, value = sys.argv.pop().split("=", 2)
     configuration.setdefault(key, []).append(value)
 
+
 try:
     setup(
         cmdclass={"build_ext": pil_build_ext},

From b931402046f840bedc09b3c2b0c4039ac28531dc Mon Sep 17 00:00:00 2001
From: Eric Soroos <eric-github@soroos.net>
Date: Sat, 31 May 2025 15:14:17 +0200
Subject: [PATCH 1744/2374] add pybind11 elsewhere so mypy can find it

---
 .ci/requirements-mypy.txt | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 86ac2e0b26b..645605aa67a 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -5,6 +5,7 @@ ipython
 numpy
 packaging
 pyarrow-stubs
+pybind11
 pytest
 sphinx
 types-atheris

From 892fd2c2affa4980121a059bc2b7875834571804 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 1 Jun 2025 15:41:48 +1000
Subject: [PATCH 1745/2374] Removed unreachable code (#8918)

---
 src/PIL/MpegImagePlugin.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/src/PIL/MpegImagePlugin.py b/src/PIL/MpegImagePlugin.py
index 5aa00d05ba6..47ebe9d62c4 100644
--- a/src/PIL/MpegImagePlugin.py
+++ b/src/PIL/MpegImagePlugin.py
@@ -33,11 +33,7 @@ def next(self) -> int:
 
     def peek(self, bits: int) -> int:
         while self.bits < bits:
-            c = self.next()
-            if c < 0:
-                self.bits = 0
-                continue
-            self.bitbuffer = (self.bitbuffer << 8) + c
+            self.bitbuffer = (self.bitbuffer << 8) + self.next()
             self.bits += 8
         return self.bitbuffer >> (self.bits - bits) & (1 << bits) - 1
 

From 95603e9717c81d3492933c3a8d094bfbb7e90340 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 2 Jun 2025 20:14:11 +1000
Subject: [PATCH 1746/2374] Use ImageFile.MAXBLOCK in tobytes() (#8906)

---
 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 aaa3332ee2e..ed2f728aab5 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -802,7 +802,9 @@ def tobytes(self, encoder_name: str = "raw", *args: Any) -> bytes:
         e = _getencoder(self.mode, encoder_name, encoder_args)
         e.setimage(self.im)
 
-        bufsize = max(65536, self.size[0] * 4)  # see RawEncode.c
+        from . import ImageFile
+
+        bufsize = max(ImageFile.MAXBLOCK, self.size[0] * 4)  # see RawEncode.c
 
         output = []
         while True:

From 070e1eba626736a5cfa4a90a8a97dfbbf6278b91 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 3 Jun 2025 14:08:24 +1000
Subject: [PATCH 1747/2374] [pre-commit.ci] pre-commit autoupdate (#8993)

---
 .pre-commit-config.yaml       | 8 ++++----
 src/_imaging.c                | 9 +++++----
 src/display.c                 | 8 ++++----
 src/libImaging/Fill.c         | 5 +++--
 src/libImaging/Filter.c       | 6 ++++--
 src/libImaging/Jpeg2KEncode.c | 8 ++++----
 src/libImaging/Point.c        | 5 +++--
 src/libImaging/Resample.c     | 6 ++++--
 src/libImaging/Storage.c      | 5 +++--
 src/libImaging/TiffDecode.c   | 3 ++-
 10 files changed, 36 insertions(+), 27 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index e15e6f6390a..a1a054e008f 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.11.8
+    rev: v0.11.12
     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: v20.1.3
+    rev: v20.1.5
     hooks:
       - id: clang-format
         types: [c]
@@ -58,7 +58,7 @@ repos:
       - id: check-renovate
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: v1.6.0
+    rev: v1.9.0
     hooks:
       - id: zizmor
 
@@ -68,7 +68,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.5.1
+    rev: v2.6.0
     hooks:
       - id: pyproject-fmt
 
diff --git a/src/_imaging.c b/src/_imaging.c
index 79e0a2b2321..9213ba13dff 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -308,9 +308,9 @@ _new_arrow(PyObject *self, PyObject *args) {
     }
 
     // ImagingBorrowArrow is responsible for retaining the array_capsule
-    ret =
-        PyImagingNew(ImagingNewArrow(mode, xsize, ysize, schema_capsule, array_capsule)
-        );
+    ret = PyImagingNew(
+        ImagingNewArrow(mode, xsize, ysize, schema_capsule, array_capsule)
+    );
     if (!ret) {
         return ImagingError_ValueError("Invalid Arrow array mode or size mismatch");
     }
@@ -1665,7 +1665,8 @@ _putdata(ImagingObject *self, PyObject *args) {
                 int bigendian = 0;
                 if (image->type == IMAGING_TYPE_SPECIAL) {
                     // I;16*
-                    if (strcmp(image->mode, "I;16B") == 0
+                    if (
+                        strcmp(image->mode, "I;16B") == 0
 #ifdef WORDS_BIGENDIAN
                         || strcmp(image->mode, "I;16N") == 0
 #endif
diff --git a/src/display.c b/src/display.c
index 11742a8952f..3215f6691ee 100644
--- a/src/display.c
+++ b/src/display.c
@@ -327,11 +327,11 @@ 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) {
-        GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext
-        )GetProcAddress(user32, "GetWindowDpiAwarenessContext");
+        GetWindowDpiAwarenessContext_function = (Func_GetWindowDpiAwarenessContext)
+            GetProcAddress(user32, "GetWindowDpiAwarenessContext");
         if (screens == -1 && GetWindowDpiAwarenessContext_function != NULL) {
             dpiAwareness = GetWindowDpiAwarenessContext_function(wnd);
         }
diff --git a/src/libImaging/Fill.c b/src/libImaging/Fill.c
index 8fb481e7e4d..28f42737053 100644
--- a/src/libImaging/Fill.c
+++ b/src/libImaging/Fill.c
@@ -118,8 +118,9 @@ 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 7b7b2e4292d..c46dd3cd1cd 100644
--- a/src/libImaging/Filter.c
+++ b/src/libImaging/Filter.c
@@ -155,7 +155,8 @@ ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
         } else {
             int bigendian = 0;
             if (im->type == IMAGING_TYPE_SPECIAL) {
-                if (strcmp(im->mode, "I;16B") == 0
+                if (
+                    strcmp(im->mode, "I;16B") == 0
 #ifdef WORDS_BIGENDIAN
                     || strcmp(im->mode, "I;16N") == 0
 #endif
@@ -308,7 +309,8 @@ ImagingFilter5x5(Imaging imOut, Imaging im, const float *kernel, float offset) {
         } else {
             int bigendian = 0;
             if (im->type == IMAGING_TYPE_SPECIAL) {
-                if (strcmp(im->mode, "I;16B") == 0
+                if (
+                    strcmp(im->mode, "I;16B") == 0
 #ifdef WORDS_BIGENDIAN
                     || strcmp(im->mode, "I;16N") == 0
 #endif
diff --git a/src/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index 34d1a22949c..61e095ad67d 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -207,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;
@@ -243,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/Point.c b/src/libImaging/Point.c
index 6a4060b4bc1..b11ea62ed85 100644
--- a/src/libImaging/Point.c
+++ b/src/libImaging/Point.c
@@ -197,8 +197,9 @@ 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/Resample.c b/src/libImaging/Resample.c
index f5e386dc2ba..b114e002330 100644
--- a/src/libImaging/Resample.c
+++ b/src/libImaging/Resample.c
@@ -470,7 +470,8 @@ ImagingResampleHorizontal_16bpc(
     double *k;
 
     int bigendian = 0;
-    if (strcmp(imIn->mode, "I;16N") == 0
+    if (
+        strcmp(imIn->mode, "I;16N") == 0
 #ifdef WORDS_BIGENDIAN
         || strcmp(imIn->mode, "I;16B") == 0
 #endif
@@ -509,7 +510,8 @@ ImagingResampleVertical_16bpc(
     double *k;
 
     int bigendian = 0;
-    if (strcmp(imIn->mode, "I;16N") == 0
+    if (
+        strcmp(imIn->mode, "I;16N") == 0
 #ifdef WORDS_BIGENDIAN
         || strcmp(imIn->mode, "I;16B") == 0
 #endif
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 6f0a1bfa3a1..11d6c06cc63 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -602,8 +602,9 @@ ImagingBorrowArrow(
     }
 
     if (!borrowed_buffer) {
-        return (Imaging
-        )ImagingError_ValueError("Arrow Array, exactly 2 buffers required");
+        return (Imaging)ImagingError_ValueError(
+            "Arrow Array, exactly 2 buffers required"
+        );
     }
 
     for (y = i = 0; y < im->ysize; y++) {
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 173eca160d2..2e83fb847c9 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -557,7 +557,8 @@ _decodeStrip(
                     (tdata_t)state->buffer,
                     strip_size
                 ) == -1) {
-                TRACE(("Decode Error, strip %d\n", TIFFComputeStrip(tiff, state->y, 0))
+                TRACE(
+                    ("Decode Error, strip %d\n", TIFFComputeStrip(tiff, state->y, 0))
                 );
                 state->errcode = IMAGING_CODEC_BROKEN;
                 return -1;

From fa7413904b4eee630401c31994eeb5bcda2441a5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Jun 2025 14:13:22 +1000
Subject: [PATCH 1748/2374] Updated ruff ID

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

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index a1a054e008f..1b8fa7199dd 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -2,7 +2,7 @@ repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.11.12
     hooks:
-      - id: ruff
+      - id: ruff-check
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror

From eb0256acc082e362b4172f3256a551a412ef4b09 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 3 Jun 2025 22:44:26 +1000
Subject: [PATCH 1749/2374] Fixed test

---
 Tests/test_deprecate.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Tests/test_deprecate.py b/Tests/test_deprecate.py
index 82ff14181a3..88479ff0d1d 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -47,7 +47,6 @@ def test_unknown_version() -> 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)
 

From cb077a16c80e9d23bb3976182acae7fc090aa5dc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 4 Jun 2025 20:07:13 +1000
Subject: [PATCH 1750/2374] Handle UNDEFINED XMP data

---
 Tests/test_file_tiff.py    | 24 ++++++++++++++++++++++++
 src/PIL/TiffImagePlugin.py |  5 ++++-
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index d0d394aa9cd..73046eb5fd4 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -14,6 +14,7 @@
     ImageFile,
     JpegImagePlugin,
     TiffImagePlugin,
+    TiffTags,
     UnidentifiedImageError,
 )
 from PIL.TiffImagePlugin import RESOLUTION_UNIT, X_RESOLUTION, Y_RESOLUTION
@@ -900,6 +901,29 @@ def test_getxmp(self) -> None:
                 assert description[0]["format"] == "image/tiff"
                 assert description[3]["BitsPerSample"]["Seq"]["li"] == ["8", "8", "8"]
 
+    def test_getxmp_undefined(self, tmp_path: Path) -> None:
+        tmpfile = tmp_path / "temp.tif"
+        im = Image.new("L", (1, 1))
+        ifd = TiffImagePlugin.ImageFileDirectory_v2()
+        ifd.tagtype[700] = TiffTags.UNDEFINED
+        with Image.open("Tests/images/lab.tif") as im_xmp:
+            ifd[700] = im_xmp.info["xmp"]
+        im.save(tmpfile, tiffinfo=ifd)
+
+        with Image.open(tmpfile) as im_reloaded:
+            if ElementTree is None:
+                with pytest.warns(
+                    UserWarning,
+                    match="XMP data cannot be read without defusedxml dependency",
+                ):
+                    assert im_reloaded.getxmp() == {}
+            else:
+                assert "xmp" in im_reloaded.info
+                xmp = im_reloaded.getxmp()
+
+                description = xmp["xmpmeta"]["RDF"]["Description"]
+                assert description[0]["format"] == "image/tiff"
+
     def test_get_photoshop_blocks(self) -> None:
         with Image.open("Tests/images/lab.tif") as im:
             assert isinstance(im, TiffImagePlugin.TiffImageFile)
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 88af9162e0a..22c5208e29d 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1259,7 +1259,10 @@ def _seek(self, frame: int) -> None:
         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]
+            xmp = self.tag_v2[XMP]
+            if isinstance(xmp, tuple) and len(xmp) == 1:
+                xmp = xmp[0]
+            self.info["xmp"] = xmp
         elif "xmp" in self.info:
             del self.info["xmp"]
         self._reload_exif()

From f03c23683ed83a9d8f73e73073ac28f1ab2b74ea Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 4 Jun 2025 20:08:58 +1000
Subject: [PATCH 1751/2374] Trim whitespace from end when parsing XMP data

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

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 14a0671277d..ac358f5bf47 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -989,7 +989,7 @@ 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'
+            b'<x:xmpmeta xmlns:x="adobe:ns:meta/" />\n<?xpacket end="w"?>\x00\x00 '
         )
         if ElementTree is None:
             with pytest.warns(
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ed2f728aab5..e03e9cc8adc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1511,7 +1511,7 @@ def get_value(element: Element) -> str | dict[str, Any] | None:
             return {}
         if "xmp" not in self.info:
             return {}
-        root = ElementTree.fromstring(self.info["xmp"].rstrip(b"\x00"))
+        root = ElementTree.fromstring(self.info["xmp"].rstrip(b"\x00 "))
         return {get_name(root.tag): get_value(root)}
 
     def getexif(self) -> Exif:

From 9d5ea827e4ac401b85ec0ed61b7d2e97a101b05a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 5 Jun 2025 18:16:05 +1000
Subject: [PATCH 1752/2374] Call startswith once with a tuple

---
 setup.py | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/setup.py b/setup.py
index ab36c6b1783..3716a7b9f66 100644
--- a/setup.py
+++ b/setup.py
@@ -163,7 +163,7 @@ def _find_library_dirs_ldconfig() -> list[str]:
     args: list[str]
     env: dict[str, str]
     expr: str
-    if sys.platform.startswith("linux") or sys.platform.startswith("gnu"):
+    if sys.platform.startswith(("linux", "gnu")):
         if struct.calcsize("l") == 4:
             machine = os.uname()[4] + "-32"
         else:
@@ -623,11 +623,7 @@ def build_extensions(self) -> None:
 
                 for extension in self.extensions:
                     extension.extra_compile_args = ["-Wno-nullability-completeness"]
-        elif (
-            sys.platform.startswith("linux")
-            or sys.platform.startswith("gnu")
-            or sys.platform.startswith("freebsd")
-        ):
+        elif sys.platform.startswith(("linux", "gnu", "freebsd")):
             for dirname in _find_library_dirs_ldconfig():
                 _add_directory(library_dirs, dirname)
             if sys.platform.startswith("linux") and os.environ.get("ANDROID_ROOT"):

From f3b05d6fab2a8fb0db033fc507d0d6f19ed2330e Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 7 Jun 2025 11:07:21 +1000
Subject: [PATCH 1753/2374] Update dependency mypy to v1.16.0 (#8991)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .ci/requirements-mypy.txt |  2 +-
 Tests/test_file_jpeg.py   | 10 ++++++----
 Tests/test_image.py       |  1 +
 src/PIL/GifImagePlugin.py |  9 ++++++---
 4 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 86ac2e0b26b..a9c18ae2bfd 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.15.0
+mypy==1.16.0
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index b9eec591dcf..2827937cf57 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -145,14 +145,16 @@ def test_cmyk(self) -> None:
             assert k > 0.9
             # roundtrip, and check again
             im = self.roundtrip(im)
-            c, m, y, k = (x / 255.0 for x in im.getpixel((0, 0)))
+            cmyk = im.getpixel((0, 0))
+            assert isinstance(cmyk, tuple)
+            c, m, y, k = (x / 255.0 for x in cmyk)
             assert c == 0.0
             assert m > 0.8
             assert y > 0.8
             assert k == 0.0
-            c, m, y, k = (
-                x / 255.0 for x in im.getpixel((im.size[0] - 1, im.size[1] - 1))
-            )
+            cmyk = im.getpixel((im.size[0] - 1, im.size[1] - 1))
+            assert isinstance(cmyk, tuple)
+            k = cmyk[3] / 255.0
             assert k > 0.9
 
     def test_rgb(self) -> None:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 14a0671277d..4cc8416037e 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -671,6 +671,7 @@ def test_remap_palette(self) -> None:
         im_remapped = im.remap_palette(list(range(256)))
         assert_image_equal(im, im_remapped)
         assert im.palette is not None
+        assert im_remapped.palette is not None
         assert im.palette.palette == im_remapped.palette.palette
 
         # Test illegal image mode
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 4392c4cb909..c98e02f69e0 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -31,7 +31,7 @@
 import subprocess
 from enum import IntEnum
 from functools import cached_property
-from typing import IO, Any, Literal, NamedTuple, Union
+from typing import IO, Any, Literal, NamedTuple, Union, cast
 
 from . import (
     Image,
@@ -350,12 +350,15 @@ def _rgb(color: int) -> tuple[int, int, int]:
             if self._frame_palette:
                 if color * 3 + 3 > len(self._frame_palette.palette):
                     color = 0
-                return tuple(self._frame_palette.palette[color * 3 : color * 3 + 3])
+                return cast(
+                    tuple[int, int, int],
+                    tuple(self._frame_palette.palette[color * 3 : color * 3 + 3]),
+                )
             else:
                 return (color, color, color)
 
         self.dispose = None
-        self.dispose_extent = frame_dispose_extent
+        self.dispose_extent: tuple[int, int, int, int] | None = frame_dispose_extent
         if self.dispose_extent and self.disposal_method >= 2:
             try:
                 if self.disposal_method == 2:

From 0d1edba311ffdc9683c6541a5133c60d425debe8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 14:16:49 +1000
Subject: [PATCH 1754/2374] Assert tile args is tuple

---
 Tests/test_file_gif.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 20d58a9dda4..2712e683ccd 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1422,7 +1422,9 @@ def test_getdata(monkeypatch: pytest.MonkeyPatch) -> None:
 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
+        args = im.tile[0][3]
+        assert isinstance(args, tuple)
+        assert args[0] == 11  # LZW bits
         # codec error prepatch
         im.load()
 

From 33460d2f82ee148eff2451cfe7e8bc4b6f33b66a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 14:22:02 +1000
Subject: [PATCH 1755/2374] Assert _getmp() does not return None

---
 Tests/test_file_mpo.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 73838ef4484..462c955355f 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -156,6 +156,7 @@ def test_reload_exif_after_seek() -> None:
 def test_mp(test_file: str) -> None:
     with Image.open(test_file) as im:
         mpinfo = im._getmp()
+        assert mpinfo is not None
         assert mpinfo[45056] == b"0100"
         assert mpinfo[45057] == 2
 
@@ -165,6 +166,7 @@ def test_mp_offset() -> None:
     # in APP2 data, in contrast to normal 8
     with Image.open("Tests/images/sugarshack_ifd_offset.mpo") as im:
         mpinfo = im._getmp()
+        assert mpinfo is not None
         assert mpinfo[45056] == b"0100"
         assert mpinfo[45057] == 2
 
@@ -181,6 +183,7 @@ def test_mp_no_data() -> None:
 def test_mp_attribute(test_file: str) -> None:
     with Image.open(test_file) as im:
         mpinfo = im._getmp()
+    assert mpinfo is not None
     for frame_number, mpentry in enumerate(mpinfo[0xB002]):
         mpattr = mpentry["Attribute"]
         if frame_number:

From cba096b4a99f92eb865c7fb127b9783dbd38643e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Jun 2025 11:13:12 +1000
Subject: [PATCH 1756/2374] Assert pixel data is tuple

---
 Tests/test_file_gif.py  |  8 ++++++--
 Tests/test_file_jpeg.py | 10 ++++++----
 Tests/test_file_tga.py  |  8 ++++++--
 Tests/test_file_webp.py |  2 ++
 4 files changed, 20 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 2712e683ccd..f46a28971dc 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -540,7 +540,9 @@ def test_dispose_background_transparency() -> None:
         img.seek(2)
         px = img.load()
         assert px is not None
-        assert px[35, 30][3] == 0
+        value = px[35, 30]
+        assert isinstance(value, tuple)
+        assert value[3] == 0
 
 
 @pytest.mark.parametrize(
@@ -1479,7 +1481,9 @@ 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
+        value = reloaded_rgba.load()[0, 0]
+        assert isinstance(value, tuple)
+        assert value[3] == 0
 
 
 @pytest.mark.parametrize("params", ({}, {"disposal": 2, "optimize": False}))
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 2827937cf57..50ee046114c 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -133,15 +133,17 @@ def test_cmyk(self) -> None:
         f = "Tests/images/pil_sample_cmyk.jpg"
         with Image.open(f) as im:
             # the source image has red pixels in the upper left corner.
-            c, m, y, k = (x / 255.0 for x in im.getpixel((0, 0)))
+            cmyk = im.getpixel((0, 0))
+            assert isinstance(cmyk, tuple)
+            c, m, y, k = (x / 255.0 for x in cmyk)
             assert c == 0.0
             assert m > 0.8
             assert y > 0.8
             assert k == 0.0
             # the opposite corner is black
-            c, m, y, k = (
-                x / 255.0 for x in im.getpixel((im.size[0] - 1, im.size[1] - 1))
-            )
+            cmyk = im.getpixel((im.size[0] - 1, im.size[1] - 1))
+            assert isinstance(cmyk, tuple)
+            k = cmyk[3] / 255.0
             assert k > 0.9
             # roundtrip, and check again
             im = self.roundtrip(im)
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index 8b6ed3ed226..d3cceb37f25 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -220,12 +220,16 @@ def test_horizontal_orientations() -> None:
     with Image.open("Tests/images/rgb32rle_top_right.tga") as im:
         px = im.load()
         assert px is not None
-        assert px[90, 90][:3] == (0, 0, 0)
+        value = px[90, 90]
+        assert isinstance(value, tuple)
+        assert value[:3] == (0, 0, 0)
 
     with Image.open("Tests/images/rgb32rle_bottom_right.tga") as im:
         px = im.load()
         assert px is not None
-        assert px[90, 90][:3] == (0, 255, 0)
+        value = px[90, 90]
+        assert isinstance(value, tuple)
+        assert value[:3] == (0, 255, 0)
 
 
 def test_save_rle(tmp_path: Path) -> None:
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index f61e2c82ee5..4ea7629d1d5 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -219,6 +219,7 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
         # Save P mode GIF with background
         with Image.open("Tests/images/chi.gif") as im:
             original_value = im.convert("RGB").getpixel((1, 1))
+            assert isinstance(original_value, tuple)
 
             # Save as WEBP
             im.save(out_webp, save_all=True)
@@ -230,6 +231,7 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
 
         with Image.open(out_gif) as reread:
             reread_value = reread.convert("RGB").getpixel((1, 1))
+        assert isinstance(reread_value, tuple)
         difference = sum(abs(original_value[i] - reread_value[i]) for i in range(3))
         assert difference < 5
 

From a3da70e76e14da1bc0e5b1c2331d746e4a095a6b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 14:23:58 +1000
Subject: [PATCH 1757/2374] Assert load() does not return None

---
 Tests/test_file_gif.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index f46a28971dc..e418af45ce7 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1481,7 +1481,9 @@ def test_saving_rgba(tmp_path: Path) -> None:
 
     with Image.open(out) as reloaded:
         reloaded_rgba = reloaded.convert("RGBA")
-        value = reloaded_rgba.load()[0, 0]
+        px = reloaded_rgba.load()
+        assert px is not None
+        value = px[0, 0]
         assert isinstance(value, tuple)
         assert value[3] == 0
 

From 89c38258dc33fd410858c6b760d533789578e15e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Apr 2025 14:24:20 +1000
Subject: [PATCH 1758/2374] Assert getcolors() does not return None

---
 Tests/test_file_avif.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index b2e586637fa..6d0cc74f9f9 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -254,7 +254,9 @@ def test_load_transparent_rgb(self) -> None:
             assert_image(im, "RGBA", (64, 64))
 
             # image has 876 transparent pixels
-            assert im.getchannel("A").getcolors()[0] == (876, 0)
+            colors = im.getchannel("A").getcolors()
+            assert colors is not None
+            assert colors[0] == (876, 0)
 
     def test_save_transparent(self, tmp_path: Path) -> None:
         im = Image.new("RGBA", (10, 10), (0, 0, 0, 0))

From 04c984f2f202639479a161dc44ba378b9ebee931 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Jun 2025 11:29:11 +1000
Subject: [PATCH 1759/2374] Removed duplicate code

---
 Tests/test_file_jpeg.py | 22 +++++++---------------
 1 file changed, 7 insertions(+), 15 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 50ee046114c..00f2c004d46 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -130,9 +130,7 @@ def test_comment_write(self) -> None:
     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"
-        with Image.open(f) as im:
-            # the source image has red pixels in the upper left corner.
+        def check(im: ImageFile.ImageFile) -> None:
             cmyk = im.getpixel((0, 0))
             assert isinstance(cmyk, tuple)
             c, m, y, k = (x / 255.0 for x in cmyk)
@@ -145,19 +143,13 @@ def test_cmyk(self) -> None:
             assert isinstance(cmyk, tuple)
             k = cmyk[3] / 255.0
             assert k > 0.9
+
+        with Image.open("Tests/images/pil_sample_cmyk.jpg") as im:
+            # the source image has red pixels in the upper left corner.
+            check(im)
+
             # roundtrip, and check again
-            im = self.roundtrip(im)
-            cmyk = im.getpixel((0, 0))
-            assert isinstance(cmyk, tuple)
-            c, m, y, k = (x / 255.0 for x in cmyk)
-            assert c == 0.0
-            assert m > 0.8
-            assert y > 0.8
-            assert k == 0.0
-            cmyk = im.getpixel((im.size[0] - 1, im.size[1] - 1))
-            assert isinstance(cmyk, tuple)
-            k = cmyk[3] / 255.0
-            assert k > 0.9
+            check(self.roundtrip(im))
 
     def test_rgb(self) -> None:
         def getchannels(im: JpegImagePlugin.JpegImageFile) -> tuple[int, ...]:

From 0bb99e5561e1e2b87f94d6ae30f07eba1744421c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Jun 2025 15:08:16 +1000
Subject: [PATCH 1760/2374] Use save parameters as encoderinfo defaults

---
 Tests/test_file_mpo.py     | 20 +++++++++++++++-----
 Tests/test_file_tiff.py    | 13 +++++++++----
 src/PIL/Image.py           |  9 ++++++++-
 src/PIL/MpoImagePlugin.py  |  1 +
 src/PIL/TiffImagePlugin.py |  3 +--
 5 files changed, 34 insertions(+), 12 deletions(-)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 73838ef4484..c192f017f70 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -312,10 +312,20 @@ def test_save_all() -> None:
 def test_save_xmp() -> None:
     im = Image.new("RGB", (1, 1))
     im2 = Image.new("RGB", (1, 1), "#f00")
-    im2.encoderinfo = {"xmp": b"Second frame"}
-    im_reloaded = roundtrip(im, xmp=b"First frame", save_all=True, append_images=[im2])
 
-    assert im_reloaded.info["xmp"] == b"First frame"
+    def roundtrip_xmp():
+        im_reloaded = roundtrip(im, xmp=b"Default", save_all=True, append_images=[im2])
+        xmp = [im_reloaded.info["xmp"]]
+        im_reloaded.seek(1)
+        return xmp + [im_reloaded.info["xmp"]]
 
-    im_reloaded.seek(1)
-    assert im_reloaded.info["xmp"] == b"Second frame"
+    # Use the save parameters for all frames by default
+    assert roundtrip_xmp() == [b"Default", b"Default"]
+
+    # Specify a value for the first frame
+    im.encoderinfo = {"xmp": b"First frame"}
+    assert roundtrip_xmp() == [b"First frame", b"Default"]
+
+    # Specify value for the second frame
+    im2.encoderinfo = {"xmp": b"Second frame"}
+    assert roundtrip_xmp() == [b"Default", b"Second frame"]
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index d0d394aa9cd..d192e9685dd 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -695,16 +695,21 @@ def test_rowsperstrip(self, tmp_path: Path) -> None:
             assert im.tag_v2[278] == 256
 
         im = hopper()
+        im.encoderinfo = {"tiffinfo": {278: 100}}
         im2 = Image.new("L", (128, 128))
-        im2.encoderinfo = {"tiffinfo": {278: 256}}
-        im.save(outfile, save_all=True, append_images=[im2])
+        im3 = im2.copy()
+        im3.encoderinfo = {"tiffinfo": {278: 300}}
+        im.save(outfile, save_all=True, tiffinfo={278: 200}, append_images=[im2, im3])
 
         with Image.open(outfile) as im:
             assert isinstance(im, TiffImagePlugin.TiffImageFile)
-            assert im.tag_v2[278] == 128
+            assert im.tag_v2[278] == 100
 
             im.seek(1)
-            assert im.tag_v2[278] == 256
+            assert im.tag_v2[278] == 200
+
+            im.seek(2)
+            assert im.tag_v2[278] == 300
 
     def test_strip_raw(self) -> None:
         infile = "Tests/images/tiff_strip_raw.tif"
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ed2f728aab5..7a8d937936a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2555,7 +2555,8 @@ def save(
             self.load()
 
         save_all = params.pop("save_all", None)
-        self.encoderinfo = {**getattr(self, "encoderinfo", {}), **params}
+        self._default_encoderinfo = params
+        self._attach_default_encoderinfo(self)
         self.encoderconfig: tuple[Any, ...] = ()
 
         if format.upper() not in SAVE:
@@ -2600,6 +2601,12 @@ def save(
         if open_fp:
             fp.close()
 
+    def _attach_default_encoderinfo(self, im: Image) -> Any:
+        self.encoderinfo = {
+            **im._default_encoderinfo,
+            **getattr(self, "encoderinfo", {}),
+        }
+
     def seek(self, frame: int) -> None:
         """
         Seeks to the given frame in this sequence file. If you seek
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index f7393eac059..f1f44c0ff0e 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -64,6 +64,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                 JpegImagePlugin._save(im_frame, fp, filename)
                 offsets.append(fp.tell())
             else:
+                im_frame._attach_default_encoderinfo(im)
                 im_frame.save(fp, "JPEG")
                 offsets.append(fp.tell() - offsets[-1])
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 88af9162e0a..e1b10fea501 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -2310,8 +2310,7 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     try:
         with AppendingTiffWriter(fp) as tf:
             for ims in [im] + append_images:
-                if not hasattr(ims, "encoderinfo"):
-                    ims.encoderinfo = {}
+                ims._attach_default_encoderinfo(im)
                 if not hasattr(ims, "encoderconfig"):
                     ims.encoderconfig = ()
                 nfr = getattr(ims, "n_frames", 1)

From ef1f90fe1c92ec4d038ddf4d03638f467ba94181 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 9 Jun 2025 09:06:08 +1000
Subject: [PATCH 1761/2374] Check for equality rather than inequality

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

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index d11609483d0..1eb4507344c 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -134,7 +134,10 @@ def grabclipboard() -> Image.Image | list[str] | None:
             import struct
 
             o = struct.unpack_from("I", data)[0]
-            files = data[o:].decode("mbcs" if data[16] == 0 else "utf-16le").split("\0")
+            if data[16] == 0:
+                files = data[o:].decode("mbcs").split("\0")
+            else:
+                files = data[o:].decode("utf-16le").split("\0")
             return files[: files.index("")]
         if isinstance(data, bytes):
             data = io.BytesIO(data)

From 313969cf0bcf6b6185d486830478d2864eb56fe1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 9 Jun 2025 12:21:49 +1000
Subject: [PATCH 1762/2374] Removed unnecessary seek

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

diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 299405ae0a5..47b6e80e2df 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -66,6 +66,8 @@ def _open(self) -> None:
             raise SyntaxError(msg)
         logger.debug("BBox: %s %s %s %s", *bbox)
 
+        offset = self.fp.tell()
+
         # format
         version = s[1]
         bits = s[3]
@@ -102,7 +104,6 @@ def _open(self) -> None:
                         break
                 if mode == "P":
                     self.palette = ImagePalette.raw("RGB", s[1:])
-            self.fp.seek(128)
 
         elif version == 5 and bits == 8 and planes == 3:
             mode = "RGB"
@@ -128,9 +129,7 @@ def _open(self) -> None:
         bbox = (0, 0) + self.size
         logger.debug("size: %sx%s", *self.size)
 
-        self.tile = [
-            ImageFile._Tile("pcx", bbox, self.fp.tell(), (rawmode, planes * stride))
-        ]
+        self.tile = [ImageFile._Tile("pcx", bbox, offset, (rawmode, planes * stride))]
 
 
 # --------------------------------------------------------------------

From 7341e70f6be9c3e910c81f563bb7900167873c02 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 9 Jun 2025 12:20:52 +1000
Subject: [PATCH 1763/2374] Reduced number of bytes read for header

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

diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 47b6e80e2df..458d586c463 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -54,7 +54,7 @@ def _open(self) -> None:
         # header
         assert self.fp is not None
 
-        s = self.fp.read(128)
+        s = self.fp.read(68)
         if not _accept(s):
             msg = "not a PCX file"
             raise SyntaxError(msg)
@@ -66,7 +66,7 @@ def _open(self) -> None:
             raise SyntaxError(msg)
         logger.debug("BBox: %s %s %s %s", *bbox)
 
-        offset = self.fp.tell()
+        offset = self.fp.tell() + 60
 
         # format
         version = s[1]

From 7b163cc35d3ef9bb0204613add92f05eda65ab63 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 10 Jun 2025 11:46:12 +1000
Subject: [PATCH 1764/2374] Use mask in C when drawing wide polygon lines
 (#8984)

---
 src/PIL/ImageDraw.py     |  16 +-----
 src/_imaging.c           |  20 +++++--
 src/libImaging/Draw.c    | 113 ++++++++++++++++++++++++++++-----------
 src/libImaging/Imaging.h |  19 ++++++-
 4 files changed, 116 insertions(+), 52 deletions(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index e6c7b029830..98ae67539ab 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -365,22 +365,10 @@ def polygon(
                 # use the fill as a mask
                 mask = Image.new("1", self.im.size)
                 mask_ink = self._getink(1)[0]
-
-                fill_im = mask.copy()
-                draw = Draw(fill_im)
+                draw = Draw(mask)
                 draw.draw.draw_polygon(xy, mask_ink, 1)
 
-                ink_im = mask.copy()
-                draw = Draw(ink_im)
-                width = width * 2 - 1
-                draw.draw.draw_polygon(xy, mask_ink, 0, width)
-
-                mask.paste(ink_im, mask=fill_im)
-
-                im = Image.new(self.mode, self.im.size)
-                draw = Draw(im)
-                draw.draw.draw_polygon(xy, ink, 0, width)
-                self.im.paste(im.im, (0, 0) + im.size, mask.im)
+                self.draw.draw_polygon(xy, ink, 0, width * 2 - 1, mask.im)
 
     def regular_polygon(
         self,
diff --git a/src/_imaging.c b/src/_imaging.c
index 9213ba13dff..2a7bc8d3f5e 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3220,7 +3220,8 @@ _draw_lines(ImagingDrawObject *self, PyObject *args) {
                     (int)p[3],
                     &ink,
                     width,
-                    self->blend
+                    self->blend,
+                    NULL
                 ) < 0) {
                 free(xy);
                 return NULL;
@@ -3358,7 +3359,10 @@ _draw_polygon(ImagingDrawObject *self, PyObject *args) {
     int ink;
     int fill = 0;
     int width = 0;
-    if (!PyArg_ParseTuple(args, "Oi|ii", &data, &ink, &fill, &width)) {
+    ImagingObject *maskp = NULL;
+    if (!PyArg_ParseTuple(
+            args, "Oi|iiO!", &data, &ink, &fill, &width, &Imaging_Type, &maskp
+        )) {
         return NULL;
     }
 
@@ -3388,8 +3392,16 @@ _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,
+            maskp ? maskp->image : NULL
+        ) < 0) {
         free(ixy);
         return NULL;
     }
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index 4c08e985504..70f267ae4a9 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -63,7 +63,7 @@ typedef struct {
 } Edge;
 
 /* Type used in "polygon*" functions */
-typedef void (*hline_handler)(Imaging, int, int, int, int);
+typedef void (*hline_handler)(Imaging, int, int, int, int, Imaging);
 
 static inline void
 point8(Imaging im, int x, int y, int ink) {
@@ -103,7 +103,7 @@ point32rgba(Imaging im, int x, int y, int ink) {
 }
 
 static inline void
-hline8(Imaging im, int x0, int y0, int x1, int ink) {
+hline8(Imaging im, int x0, int y0, int x1, int ink, Imaging mask) {
     int pixelwidth;
 
     if (y0 >= 0 && y0 < im->ysize) {
@@ -119,15 +119,30 @@ 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
-            );
+            if (mask == NULL) {
+                memset(
+                    im->image8[y0] + x0 * pixelwidth,
+                    (UINT8)ink,
+                    (x1 - x0 + 1) * pixelwidth
+                );
+            } else {
+                UINT8 *p = im->image8[y0];
+                while (x0 <= x1) {
+                    if (mask->image8[y0][x0]) {
+                        p[x0 * pixelwidth] = ink;
+                        if (pixelwidth == 2) {
+                            p[x0 * pixelwidth + 1] = ink;
+                        }
+                    }
+                    x0++;
+                }
+            }
         }
     }
 }
 
 static inline void
-hline32(Imaging im, int x0, int y0, int x1, int ink) {
+hline32(Imaging im, int x0, int y0, int x1, int ink, Imaging mask) {
     INT32 *p;
 
     if (y0 >= 0 && y0 < im->ysize) {
@@ -143,13 +158,16 @@ hline32(Imaging im, int x0, int y0, int x1, int ink) {
         }
         p = im->image32[y0];
         while (x0 <= x1) {
-            p[x0++] = ink;
+            if (mask == NULL || mask->image8[y0][x0]) {
+                p[x0] = ink;
+            }
+            x0++;
         }
     }
 }
 
 static inline void
-hline32rgba(Imaging im, int x0, int y0, int x1, int ink) {
+hline32rgba(Imaging im, int x0, int y0, int x1, int ink, Imaging mask) {
     unsigned int tmp;
 
     if (y0 >= 0 && y0 < im->ysize) {
@@ -167,9 +185,11 @@ hline32rgba(Imaging im, int x0, int y0, int x1, int ink) {
             UINT8 *out = (UINT8 *)im->image[y0] + x0 * 4;
             UINT8 *in = (UINT8 *)&ink;
             while (x0 <= x1) {
-                out[0] = BLEND(in[3], out[0], in[0], tmp);
-                out[1] = BLEND(in[3], out[1], in[1], tmp);
-                out[2] = BLEND(in[3], out[2], in[2], tmp);
+                if (mask == NULL || mask->image8[y0][x0]) {
+                    out[0] = BLEND(in[3], out[0], in[0], tmp);
+                    out[1] = BLEND(in[3], out[1], in[1], tmp);
+                    out[2] = BLEND(in[3], out[2], in[2], tmp);
+                }
                 x0++;
                 out += 4;
             }
@@ -407,7 +427,14 @@ 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,
+    Imaging mask
 ) {
     int i;
     for (i = 0; i < n; i++) {
@@ -429,7 +456,7 @@ draw_horizontal_lines(
                 }
             }
 
-            (*hline)(im, xmin, e[i].ymin, xmax, ink);
+            (*hline)(im, xmin, e[i].ymin, xmax, ink, mask);
             *x_pos = xmax + 1;
         }
     }
@@ -439,7 +466,9 @@ 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) {
+polygon_generic(
+    Imaging im, int n, Edge *e, int ink, int eofill, hline_handler hline, Imaging mask
+) {
     Edge **edge_table;
     float *xx;
     int edge_count = 0;
@@ -469,7 +498,7 @@ polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler h
         }
         if (e[i].ymin == e[i].ymax) {
             if (hasAlpha != 1) {
-                (*hline)(im, e[i].xmin, e[i].ymin, e[i].xmax, ink);
+                (*hline)(im, e[i].xmin, e[i].ymin, e[i].xmax, ink, mask);
             }
             continue;
         }
@@ -557,7 +586,7 @@ polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler h
                     // Line would be before the current position
                     continue;
                 }
-                draw_horizontal_lines(im, n, e, ink, &x_pos, ymin, hline);
+                draw_horizontal_lines(im, n, e, ink, &x_pos, ymin, hline, mask);
                 if (x_end < x_pos) {
                     // Line would be before the current position
                     continue;
@@ -573,13 +602,13 @@ polygon_generic(Imaging im, int n, Edge *e, int ink, int eofill, hline_handler h
                         continue;
                     }
                 }
-                (*hline)(im, x_start, ymin, x_end, ink);
+                (*hline)(im, x_start, ymin, x_end, ink, mask);
                 x_pos = x_end + 1;
             }
-            draw_horizontal_lines(im, n, e, ink, &x_pos, ymin, hline);
+            draw_horizontal_lines(im, n, e, ink, &x_pos, ymin, hline, mask);
         } else {
             for (i = 1; i < j; i += 2) {
-                (*hline)(im, ROUND_UP(xx[i - 1]), ymin, ROUND_DOWN(xx[i]), ink);
+                (*hline)(im, ROUND_UP(xx[i - 1]), ymin, ROUND_DOWN(xx[i]), ink, mask);
             }
         }
     }
@@ -623,7 +652,7 @@ add_edge(Edge *e, int x0, int y0, int x1, int y1) {
 
 typedef struct {
     void (*point)(Imaging im, int x, int y, int ink);
-    void (*hline)(Imaging im, int x0, int y0, int x1, int ink);
+    void (*hline)(Imaging im, int x0, int y0, int x1, int ink, Imaging mask);
     void (*line)(Imaging im, int x0, int y0, int x1, int y1, int ink);
 } DRAW;
 
@@ -674,7 +703,15 @@ 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,
+    Imaging mask
 ) {
     DRAW *draw;
     INT32 ink;
@@ -714,7 +751,7 @@ ImagingDrawWideLine(
         add_edge(e + 2, vertices[2][0], vertices[2][1], vertices[3][0], vertices[3][1]);
         add_edge(e + 3, vertices[3][0], vertices[3][1], vertices[0][0], vertices[0][1]);
 
-        polygon_generic(im, 4, e, ink, 0, draw->hline);
+        polygon_generic(im, 4, e, ink, 0, draw->hline, mask);
     }
     return 0;
 }
@@ -757,7 +794,7 @@ ImagingDrawRectangle(
         }
 
         for (y = y0; y <= y1; y++) {
-            draw->hline(im, x0, y, x1, ink);
+            draw->hline(im, x0, y, x1, ink, NULL);
         }
 
     } else {
@@ -766,8 +803,8 @@ ImagingDrawRectangle(
             width = 1;
         }
         for (i = 0; i < width; i++) {
-            draw->hline(im, x0, y0 + i, x1, ink);
-            draw->hline(im, x0, y1 - i, x1, ink);
+            draw->hline(im, x0, y0 + i, x1, ink, NULL);
+            draw->hline(im, x0, y1 - i, x1, ink, NULL);
             draw->line(im, x1 - i, y0 + width, x1 - i, y1 - width + 1, ink);
             draw->line(im, x0 + i, y0 + width, x0 + i, y1 - width + 1, ink);
         }
@@ -778,7 +815,14 @@ 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,
+    Imaging mask
 ) {
     int i, n, x0, y0, x1, y1;
     DRAW *draw;
@@ -822,7 +866,7 @@ ImagingDrawPolygon(
         if (xy[i * 2] != xy[0] || xy[i * 2 + 1] != xy[1]) {
             add_edge(&e[n++], xy[i * 2], xy[i * 2 + 1], xy[0], xy[1]);
         }
-        polygon_generic(im, n, e, ink, 0, draw->hline);
+        polygon_generic(im, n, e, ink, 0, draw->hline, mask);
         free(e);
 
     } else {
@@ -844,11 +888,12 @@ ImagingDrawPolygon(
                     xy[i * 2 + 3],
                     ink_,
                     width,
-                    op
+                    op,
+                    mask
                 );
             }
             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, mask
             );
         }
     }
@@ -1519,7 +1564,9 @@ ellipseNew(
     ellipse_init(&st, a, b, width);
     int32_t X0, Y, X1;
     while (ellipse_next(&st, &X0, &Y, &X1) != -1) {
-        draw->hline(im, x0 + (X0 + a) / 2, y0 + (Y + b) / 2, x0 + (X1 + a) / 2, ink);
+        draw->hline(
+            im, x0 + (X0 + a) / 2, y0 + (Y + b) / 2, x0 + (X1 + a) / 2, ink, NULL
+        );
     }
     return 0;
 }
@@ -1554,7 +1601,9 @@ clipEllipseNew(
     int32_t X0, Y, X1;
     int next_code;
     while ((next_code = clip_ellipse_next(&st, &X0, &Y, &X1)) >= 0) {
-        draw->hline(im, x0 + (X0 + a) / 2, y0 + (Y + b) / 2, x0 + (X1 + a) / 2, ink);
+        draw->hline(
+            im, x0 + (X0 + a) / 2, y0 + (Y + b) / 2, x0 + (X1 + a) / 2, ink, NULL
+        );
     }
     clip_ellipse_free(&st);
     return next_code == -1 ? 0 : -1;
@@ -1972,7 +2021,7 @@ ImagingDrawOutline(
 
     DRAWINIT();
 
-    polygon_generic(im, outline->count, outline->edges, ink, 0, draw->hline);
+    polygon_generic(im, outline->count, outline->edges, ink, 0, draw->hline, NULL);
 
     return 0;
 }
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 234f9943c5a..39ecdbff63d 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -510,7 +510,15 @@ 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,
+    Imaging mask
 );
 extern int
 ImagingDrawPieslice(
@@ -530,7 +538,14 @@ 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,
+    Imaging mask
 );
 extern int
 ImagingDrawRectangle(

From 6bd55684e0d172749a74dd2098ebc18ce5f34fdd Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 10 Jun 2025 16:00:08 +1000
Subject: [PATCH 1765/2374] Only accept missing tkinter when building wheels on
 Windows (#8981)

---
 Tests/check_wheel.py | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 8ba40ba3fbe..9602410da52 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -11,13 +11,14 @@
 def test_wheel_modules() -> None:
     expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp"}
 
-    # tkinter is not available in cibuildwheel installed CPython on Windows
-    try:
-        import tkinter
+    if sys.platform == "win32":
+        # tkinter is not available in cibuildwheel installed CPython on Windows
+        try:
+            import tkinter
 
-        assert tkinter
-    except ImportError:
-        expected_modules.remove("tkinter")
+            assert tkinter
+        except ImportError:
+            expected_modules.remove("tkinter")
 
     assert set(features.get_supported_modules()) == expected_modules
 

From e65e5bea45e92a118590c69c022d6e6741e3b101 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Jun 2025 20:30:18 +1000
Subject: [PATCH 1766/2374] Start decoding with a zero-initialized array of
 previously seen pixels

---
 Tests/images/op_index.qoi | Bin 0 -> 15 bytes
 Tests/test_file_qoi.py    |   6 ++++++
 src/PIL/QoiImagePlugin.py |   2 +-
 3 files changed, 7 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/op_index.qoi

diff --git a/Tests/images/op_index.qoi b/Tests/images/op_index.qoi
new file mode 100644
index 0000000000000000000000000000000000000000..e626aafe6a433487cbacb4bdbcbbe5e66e8d07db
GIT binary patch
literal 15
TcmXTS&rD-rU|<Ac76wxQ7b*ek

literal 0
HcmV?d00001

diff --git a/Tests/test_file_qoi.py b/Tests/test_file_qoi.py
index fd4b981ce93..7ce1da2099d 100644
--- a/Tests/test_file_qoi.py
+++ b/Tests/test_file_qoi.py
@@ -28,3 +28,9 @@ def test_invalid_file() -> None:
 
     with pytest.raises(SyntaxError):
         QoiImagePlugin.QoiImageFile(invalid_file)
+
+
+def test_op_index() -> None:
+    # QOI_OP_INDEX as the first chunk
+    with Image.open("Tests/images/op_index.qoi") as im:
+        assert im.getpixel((0, 0)) == (0, 0, 0, 0)
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index df552243e37..75070abd740 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -51,7 +51,7 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
         assert self.fd is not None
 
         self._previously_seen_pixels = {}
-        self._add_to_previous_pixels(bytearray((0, 0, 0, 255)))
+        self._previous_pixel = bytearray((0, 0, 0, 255))
 
         data = bytearray()
         bands = Image.getmodebands(self.mode)

From 646885e546ecd02a8162d91b51d32eed9da67b7a Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 10 Jun 2025 21:06:28 +1000
Subject: [PATCH 1767/2374] Parse XMP tag bytes without decoding to string
 (#8960)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_image.py | 5 +++++
 src/PIL/Image.py    | 5 +++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 4cc8416037e..512a52433bc 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -974,6 +974,11 @@ def test_exif_hide_offsets(self) -> None:
                     assert tag not in exif.get_ifd(0x8769)
                 assert exif.get_ifd(0xA005)
 
+    def test_exif_from_xmp_bytes(self) -> None:
+        im = Image.new("RGB", (1, 1))
+        im.info["xmp"] = b'\xff tiff:Orientation="2"'
+        assert im.getexif()[274] == 2
+
     def test_empty_xmp(self) -> None:
         with Image.open("Tests/images/hopper.gif") as im:
             if ElementTree is None:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index ed2f728aab5..216022565b2 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1542,10 +1542,11 @@ def getexif(self) -> Exif:
         # XMP tags
         if ExifTags.Base.Orientation not in self._exif:
             xmp_tags = self.info.get("XML:com.adobe.xmp")
+            pattern: str | bytes = r'tiff:Orientation(="|>)([0-9])'
             if not xmp_tags and (xmp_tags := self.info.get("xmp")):
-                xmp_tags = xmp_tags.decode("utf-8")
+                pattern = rb'tiff:Orientation(="|>)([0-9])'
             if xmp_tags:
-                match = re.search(r'tiff:Orientation(="|>)([0-9])', xmp_tags)
+                match = re.search(pattern, xmp_tags)
                 if match:
                     self._exif[ExifTags.Base.Orientation] = int(match[2])
 

From 36cea1953231d71f1184ef1396c1f01ff11c939a Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 10 Jun 2025 21:08:29 +1000
Subject: [PATCH 1768/2374] Do not decode bytes in PPM error message (#8958)

---
 Tests/test_file_ppm.py    | 7 ++++---
 src/PIL/PpmImagePlugin.py | 4 ++--
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 41e2b5416c3..c7d1f4df4d6 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -288,12 +288,13 @@ def test_non_integer_token(tmp_path: Path) -> None:
             pass
 
 
-def test_header_token_too_long(tmp_path: Path) -> None:
+@pytest.mark.parametrize("data", (b"P3\x0cAAAAAAAAAA\xee", b"P6\n 01234567890"))
+def test_header_token_too_long(tmp_path: Path, data: bytes) -> None:
     path = tmp_path / "temp.ppm"
     with open(path, "wb") as f:
-        f.write(b"P6\n 01234567890")
+        f.write(data)
 
-    with pytest.raises(ValueError, match="Token too long in file header: 01234567890"):
+    with pytest.raises(ValueError, match="Token too long in file header: "):
         with Image.open(path):
             pass
 
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index 03afa2d2ef2..db34d107a4f 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -94,8 +94,8 @@ def _read_token(self) -> bytes:
             msg = "Reached EOF while reading header"
             raise ValueError(msg)
         elif len(token) > 10:
-            msg = f"Token too long in file header: {token.decode()}"
-            raise ValueError(msg)
+            msg_too_long = b"Token too long in file header: %s" % token
+            raise ValueError(msg_too_long)
         return token
 
     def _open(self) -> None:

From d7a45cc250f8ae35ee8095753eff0cad1c9f8216 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 10 Jun 2025 21:57:37 +1000
Subject: [PATCH 1769/2374] ImageFont does not handle multiline text (#9000)

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

diff --git a/docs/reference/ImageFont.rst b/docs/reference/ImageFont.rst
index 8b2f923234b..aac55fe6b05 100644
--- a/docs/reference/ImageFont.rst
+++ b/docs/reference/ImageFont.rst
@@ -18,6 +18,9 @@ OpenType fonts (as well as other font formats supported by the FreeType
 library). For earlier versions, TrueType support is only available as part of
 the imToolkit package.
 
+When measuring text sizes, this module will not break at newline characters. For
+multiline text, see the :py:mod:`~PIL.ImageDraw` module.
+
 .. warning::
     To protect against potential DOS attacks when using arbitrary strings as
     text input, Pillow will raise a :py:exc:`ValueError` if the number of characters

From 056dc89a3c85cbd6d6c960cbfc5aaa52f996bd3d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 10 Jun 2025 22:12:40 +1000
Subject: [PATCH 1770/2374] Correct drawing I;16 horizontal lines (#8985)

---
 Tests/images/imagedraw_rectangle_I.tiff | Bin 20122 -> 20122 bytes
 Tests/test_imagedraw.py                 |   3 ++-
 src/libImaging/Draw.c                   |  34 +++++++++++++++---------
 3 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/Tests/images/imagedraw_rectangle_I.tiff b/Tests/images/imagedraw_rectangle_I.tiff
index 9b9eda883a371d9cc88b4677b09d2e351c42e609..f0cb534b63e47c940ecb6c3323cb9de3dce573d4 100644
GIT binary patch
literal 20122
zcmeI&F%AJy7=_V)j0hbKjY4fF8mq7hdz`h*7CbV=ls6F~a){*R<r8t-(&cilbyaPu
zx@C3kbZf6}c3yP->weqr`|14bR<rYN>hJA-KYQ<CI-jmp$64Pp4*~=T5FkK+009C7
z2oNAZfB*pk1b$Lr9KP}V{8t|bpOFf%N~Nk;vC0MV(ymzL0(ogyta5?8v@2G*KwjDv
zt6U&2?TS?{ke7DFDi_F0yJD3K<fUD)$_4V$u2|&)d1+Uya)G?GD^|HcUfLC_Tp%y)
vid8O<mv+S}7s$*1+0}piA1?pplmrM6AV7cs0RjXF5FkK+009C7-W7NNFeP4m

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==

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index ffe9c0979e3..37669a2e55b 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -783,9 +783,10 @@ def test_rectangle_I16(bbox: Coords) -> None:
     draw = ImageDraw.Draw(im)
 
     # Act
-    draw.rectangle(bbox, outline=0xFFFF)
+    draw.rectangle(bbox, outline=0xCDEF)
 
     # Assert
+    assert im.getpixel((X0, Y0)) == 0xCDEF
     assert_image_equal_tofile(im, "Tests/images/imagedraw_rectangle_I.tiff")
 
 
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index 70f267ae4a9..27cac687e5d 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -104,8 +104,6 @@ point32rgba(Imaging im, int x, int y, int ink) {
 
 static inline void
 hline8(Imaging im, int x0, int y0, int x1, int ink, Imaging mask) {
-    int pixelwidth;
-
     if (y0 >= 0 && y0 < im->ysize) {
         if (x0 < 0) {
             x0 = 0;
@@ -118,20 +116,30 @@ hline8(Imaging im, int x0, int y0, int x1, int ink, Imaging mask) {
             x1 = im->xsize - 1;
         }
         if (x0 <= x1) {
-            pixelwidth = strncmp(im->mode, "I;16", 4) == 0 ? 2 : 1;
-            if (mask == NULL) {
-                memset(
-                    im->image8[y0] + x0 * pixelwidth,
-                    (UINT8)ink,
-                    (x1 - x0 + 1) * pixelwidth
-                );
+            int bigendian = -1;
+            if (strncmp(im->mode, "I;16", 4) == 0) {
+                bigendian =
+                    (
+#ifdef WORDS_BIGENDIAN
+                        strcmp(im->mode, "I;16") == 0 || strcmp(im->mode, "I;16L") == 0
+#else
+                        strcmp(im->mode, "I;16B") == 0
+#endif
+                    )
+                        ? 1
+                        : 0;
+            }
+            if (mask == NULL && bigendian == -1) {
+                memset(im->image8[y0] + x0, (UINT8)ink, (x1 - x0 + 1));
             } else {
                 UINT8 *p = im->image8[y0];
                 while (x0 <= x1) {
-                    if (mask->image8[y0][x0]) {
-                        p[x0 * pixelwidth] = ink;
-                        if (pixelwidth == 2) {
-                            p[x0 * pixelwidth + 1] = ink;
+                    if (mask == NULL || mask->image8[y0][x0]) {
+                        if (bigendian == -1) {
+                            p[x0] = ink;
+                        } else {
+                            p[x0 * 2 + (bigendian ? 1 : 0)] = ink;
+                            p[x0 * 2 + (bigendian ? 0 : 1)] = ink >> 8;
                         }
                     }
                     x0++;

From 3eb893f0c16c958962758c03a597454aacac8f84 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 11 Jun 2025 20:56:28 +1000
Subject: [PATCH 1771/2374] Updated libjpeg-turbo to 3.1.1 (#9009)

---
 .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 1583435c13f..b46811f5a01 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -40,7 +40,7 @@ ARCHIVE_SDIR=pillow-depends-main
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=11.2.1
 LIBPNG_VERSION=1.6.48
-JPEGTURBO_VERSION=3.1.0
+JPEGTURBO_VERSION=3.1.1
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.8.1
 TIFF_VERSION=4.7.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 6e176e29cf3..0cc383733b7 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -114,7 +114,7 @@ def cmd_msbuild(
     "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "11.2.1",
-    "JPEGTURBO": "3.1.0",
+    "JPEGTURBO": "3.1.1",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.3.4",

From 8ccdc399df1254c89bdb4e8fda6d6daf98943ab6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 11 Jun 2025 23:19:09 +1000
Subject: [PATCH 1772/2374] Remove padding between interleaved PCX palette data
 (#9005)

---
 Tests/images/p_4_planes.pcx | Bin 0 -> 136 bytes
 Tests/test_file_pcx.py      |   5 +++++
 src/libImaging/PcxDecode.c  |  22 ++++++++++++++++------
 3 files changed, 21 insertions(+), 6 deletions(-)
 create mode 100644 Tests/images/p_4_planes.pcx

diff --git a/Tests/images/p_4_planes.pcx b/Tests/images/p_4_planes.pcx
new file mode 100644
index 0000000000000000000000000000000000000000..8c5743a98554c89fa46188308332461a4aa87f91
GIT binary patch
literal 136
ocmd;LWn^T4f)s`n7?XkFKZ1#u#lpnE2!?o7;goD(XaLIr0O6ei;s5{u

literal 0
HcmV?d00001

diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index 5d7fd1c1bb4..2e999eff6e1 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -37,6 +37,11 @@ def test_sanity(tmp_path: Path) -> None:
         im.save(f)
 
 
+def test_p_4_planes() -> None:
+    with Image.open("Tests/images/p_4_planes.pcx") as im:
+        assert im.getpixel((0, 0)) == 3
+
+
 def test_bad_image_size() -> None:
     with open("Tests/images/pil184.pcx", "rb") as fp:
         data = fp.read()
diff --git a/src/libImaging/PcxDecode.c b/src/libImaging/PcxDecode.c
index 942c8dc224d..a65952fb1da 100644
--- a/src/libImaging/PcxDecode.c
+++ b/src/libImaging/PcxDecode.c
@@ -60,15 +60,25 @@ ImagingPcxDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t byt
         }
 
         if (state->x >= state->bytes) {
-            if (state->bytes % state->xsize && state->bytes > state->xsize) {
-                int bands = state->bytes / state->xsize;
-                int stride = state->bytes / bands;
+            int bands;
+            int xsize = 0;
+            int stride = 0;
+            if (state->bits == 2 || state->bits == 4) {
+                xsize = (state->xsize + 7) / 8;
+                bands = state->bits;
+                stride = state->bytes / state->bits;
+            } else {
+                xsize = state->xsize;
+                bands = state->bytes / state->xsize;
+                if (bands != 0) {
+                    stride = state->bytes / bands;
+                }
+            }
+            if (stride > xsize) {
                 int i;
                 for (i = 1; i < bands; i++) {  // note -- skipping first band
                     memmove(
-                        &state->buffer[i * state->xsize],
-                        &state->buffer[i * stride],
-                        state->xsize
+                        &state->buffer[i * xsize], &state->buffer[i * stride], xsize
                     );
                 }
             }

From b65a7acf259682c9d02d7ab6bef57bd4ca596c74 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 11 Jun 2025 13:20:34 +0000
Subject: [PATCH 1773/2374] Update dependency cibuildwheel to v3

---
 .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 0e314b8bf59..520b6e32084 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==2.23.3
+cibuildwheel==3.0.0

From d2295c0843e828816af892da53b03d1698a3a616 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Jun 2025 18:53:35 +1000
Subject: [PATCH 1774/2374] Do not activate virtualenv

---
 .github/workflows/wheels-test.ps1 | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/wheels-test.ps1 b/.github/workflows/wheels-test.ps1
index a1edc14ef25..256e84edf08 100644
--- a/.github/workflows/wheels-test.ps1
+++ b/.github/workflows/wheels-test.ps1
@@ -9,17 +9,16 @@ if ("$venv" -like "*\cibw-run-*\pp*-win_amd64\*") {
     C:\vc_redist.x64.exe /install /quiet /norestart | Out-Null
 }
 $env:path += ";$pillow\winbuild\build\bin\"
-& "$venv\Scripts\activate.ps1"
 & reg add "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\python.exe" /v "GlobalFlag" /t REG_SZ /d "0x02000000" /f
 if ("$venv" -like "*\cibw-run-*-win_amd64\*") {
-  & python -m pip install numpy
+  & $venv\Scripts\python.exe -m pip install numpy
 }
 cd $pillow
-& python -VV
+& $venv\Scripts\python.exe -VV
 if (!$?) { exit $LASTEXITCODE }
-& python selftest.py
+& $venv\Scripts\python.exe selftest.py
 if (!$?) { exit $LASTEXITCODE }
-& python -m pytest -vx Tests\check_wheel.py
+& $venv\Scripts\python.exe -m pytest -vx Tests\check_wheel.py
 if (!$?) { exit $LASTEXITCODE }
-& python -m pytest -vx Tests
+& $venv\Scripts\python.exe -m pytest -vx Tests
 if (!$?) { exit $LASTEXITCODE }

From b9aac77003cda8c4af13fcf7f4fd712506374951 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Jun 2025 22:48:27 +1000
Subject: [PATCH 1775/2374] Test Python 3.14t

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

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 006d574f3fb..b4b5162281c 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -43,6 +43,7 @@ jobs:
         python-version: [
           "pypy3.11",
           "pypy3.10",
+          "3.14t",
           "3.14",
           "3.13t",
           "3.13",
@@ -55,6 +56,7 @@ jobs:
         - { python-version: "3.11", PYTHONOPTIMIZE: 1, REVERSE: "--reverse" }
         - { python-version: "3.10", PYTHONOPTIMIZE: 2 }
         # Free-threaded
+        - { python-version: "3.14t", disable-gil: true }
         - { python-version: "3.13t", disable-gil: true }
         # M1 only available for 3.10+
         - { os: "macos-13", python-version: "3.9" }

From 9bffc015e6d97151cf49e71eed31deb20548652f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Jun 2025 23:52:51 +1000
Subject: [PATCH 1776/2374] Use pypy.exe if it exists

---
 .github/workflows/wheels-test.ps1 | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/wheels-test.ps1 b/.github/workflows/wheels-test.ps1
index 256e84edf08..54e7fbbfc30 100644
--- a/.github/workflows/wheels-test.ps1
+++ b/.github/workflows/wheels-test.ps1
@@ -9,16 +9,21 @@ if ("$venv" -like "*\cibw-run-*\pp*-win_amd64\*") {
     C:\vc_redist.x64.exe /install /quiet /norestart | Out-Null
 }
 $env:path += ";$pillow\winbuild\build\bin\"
+if (Test-Path $venv\Scripts\pypy.exe) {
+  $python = "pypy.exe"
+} else {
+  $python = "python.exe"
+}
 & reg add "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\python.exe" /v "GlobalFlag" /t REG_SZ /d "0x02000000" /f
 if ("$venv" -like "*\cibw-run-*-win_amd64\*") {
-  & $venv\Scripts\python.exe -m pip install numpy
+  & $venv\Scripts\$python -m pip install numpy
 }
 cd $pillow
-& $venv\Scripts\python.exe -VV
+& $venv\Scripts\$python -VV
 if (!$?) { exit $LASTEXITCODE }
-& $venv\Scripts\python.exe selftest.py
+& $venv\Scripts\$python selftest.py
 if (!$?) { exit $LASTEXITCODE }
-& $venv\Scripts\python.exe -m pytest -vx Tests\check_wheel.py
+& $venv\Scripts\$python -m pytest -vx Tests\check_wheel.py
 if (!$?) { exit $LASTEXITCODE }
-& $venv\Scripts\python.exe -m pytest -vx Tests
+& $venv\Scripts\$python -m pytest -vx Tests
 if (!$?) { exit $LASTEXITCODE }

From 4a1eea84669dec76e573db2fc25e9b0ec3ea58e3 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 9 Jun 2025 13:15:49 +0300
Subject: [PATCH 1777/2374] Add Python 3.14 beta wheels

---
 docs/releasenotes/11.3.0.rst | 56 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 tox.ini                      |  2 +-
 3 files changed, 58 insertions(+), 1 deletion(-)
 create mode 100644 docs/releasenotes/11.3.0.rst

diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
new file mode 100644
index 00000000000..b0595def9b8
--- /dev/null
+++ b/docs/releasenotes/11.3.0.rst
@@ -0,0 +1,56 @@
+11.3.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards incompatible changes
+==============================
+
+TODO
+^^^^
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+API changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API additions
+=============
+
+TODO
+^^^^
+
+TODO
+
+Other changes
+=============
+
+Python 3.14 beta
+^^^^^^^^^^^^^^^^
+
+To help other projects prepare for Python 3.14, wheels are now built for the
+3.14 beta as a preview. This is not official support for Python 3.14, but rather
+an opportunity for you to test how Pillow works with the beta and report any
+problems.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 5d7b21d593d..a85f1e0752e 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.3.0
   11.2.1
   11.1.0
   11.0.0
diff --git a/tox.ini b/tox.ini
index 4065245ee11..967d4b53768 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}
+    py{py3, 314, 313, 312, 311, 310, 39}
 
 [testenv]
 deps =

From aca0e57126ce5938dfd3cd57eed1a668cac5abc7 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 12 Jun 2025 19:22:35 +0300
Subject: [PATCH 1778/2374] Add 3.14 to CI targets

---
 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 57a2298f8c0..a56f9431652 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -40,12 +40,12 @@ These platforms are built and tested for every change.
 | macOS 13 Ventura                 | 3.9                        | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13,    | arm64               |
-|                                  | PyPy3                      |                     |
+|                                  | 3.14, PyPy3                |                     |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 24.04 LTS (Noble)   | 3.9, 3.10, 3.11,           | x86-64              |
-|                                  | 3.12, 3.13, PyPy3          |                     |
+|                                  | 3.12, 3.13, 3.14, PyPy3    |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12                       | arm64v8, ppc64le,   |
 |                                  |                            | s390x               |
@@ -53,7 +53,7 @@ These platforms are built and tested for every change.
 | Windows Server 2022              | 3.9                        | x86                 |
 |                                  +----------------------------+---------------------+
 |                                  | 3.10, 3.11, 3.12, 3.13,    | x86-64              |
-|                                  | PyPy3                      |                     |
+|                                  | 3.14, PyPy3                |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12 (MinGW)               | x86-64              |
 |                                  +----------------------------+---------------------+

From 3841db0252cc2dfd485eae96363dc91cffd65c0c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 13 Jun 2025 00:08:52 +0300
Subject: [PATCH 1779/2374] Fix: Invalid skip selector: 'pp39-*'

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

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 33e1976f096..72516651f42 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -110,7 +110,6 @@ jobs:
           CIBW_MANYLINUX_PYPY_AARCH64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_PYPY_X86_64_IMAGE: ${{ matrix.manylinux }}
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
-          CIBW_SKIP: pp39-*
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
       - uses: actions/upload-artifact@v4
@@ -188,7 +187,6 @@ jobs:
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
           CIBW_CACHE_PATH: "C:\\cibw"
           CIBW_ENABLE: cpython-prerelease cpython-freethreading pypy
-          CIBW_SKIP: pp39-*
           CIBW_TEST_SKIP: "*-win_arm64"
           CIBW_TEST_COMMAND: 'docker run --rm
             -v {project}:C:\pillow

From a3d91cb0ce30bc5c8418956ab9dd32d1b7a13f00 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 14 Jun 2025 05:21:31 +0300
Subject: [PATCH 1780/2374] CI: Require Python >= 3.13.5 on Windows (#9017)

---
 .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 6b76351b001..6d8acc44f25 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.11", "pypy3.10", "3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["pypy3.11", "pypy3.10", "3.10", "3.11", "3.12", ">=3.13.5", "3.14"]
         architecture: ["x64"]
         include:
             # Test the oldest Python on 32-bit

From a219e96fd3e0d4be53b2dad9dfa08bed993c6f80 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Jun 2025 21:03:08 +1000
Subject: [PATCH 1781/2374] Fixed warning

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

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index c7d1f4df4d6..68f2f946855 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -294,9 +294,10 @@ def test_header_token_too_long(tmp_path: Path, data: bytes) -> None:
     with open(path, "wb") as f:
         f.write(data)
 
-    with pytest.raises(ValueError, match="Token too long in file header: "):
+    with pytest.raises(ValueError) as e:
         with Image.open(path):
             pass
+    assert "Token too long in file header: " in repr(e)
 
 
 def test_truncated_file(tmp_path: Path) -> None:

From 4ba97d13276f7406c6355e9f81df3255ad392f92 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Jun 2025 19:36:31 +1000
Subject: [PATCH 1782/2374] Removed entries for non-existent modes

---
 src/PIL/TiffImagePlugin.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 946fbd531c5..4c0ed01efd1 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1680,7 +1680,6 @@ def _setup(self) -> None:
     "PA": ("PA", II, 3, 1, (8, 8), 2),
     "I": ("I;32S", II, 1, 2, (32,), None),
     "I;16": ("I;16", II, 1, 1, (16,), None),
-    "I;16S": ("I;16S", II, 1, 2, (16,), None),
     "F": ("F;32F", II, 1, 3, (32,), None),
     "RGB": ("RGB", II, 2, 1, (8, 8, 8), None),
     "RGBX": ("RGBX", II, 2, 1, (8, 8, 8, 8), 0),
@@ -1688,10 +1687,7 @@ def _setup(self) -> None:
     "CMYK": ("CMYK", II, 5, 1, (8, 8, 8, 8), None),
     "YCbCr": ("YCbCr", II, 6, 1, (8, 8, 8), None),
     "LAB": ("LAB", II, 8, 1, (8, 8, 8), None),
-    "I;32BS": ("I;32BS", MM, 1, 2, (32,), None),
     "I;16B": ("I;16B", MM, 1, 1, (16,), None),
-    "I;16BS": ("I;16BS", MM, 1, 2, (16,), None),
-    "F;32BF": ("F;32BF", MM, 1, 3, (32,), None),
 }
 
 

From 925fe519043a5056384b2eb4caa4cab792c92780 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Jun 2025 19:41:20 +1000
Subject: [PATCH 1783/2374] Support saving I;16L images

---
 Tests/test_file_tiff.py    | 23 ++++-------------------
 src/PIL/TiffImagePlugin.py |  3 ++-
 2 files changed, 6 insertions(+), 20 deletions(-)

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 73046eb5fd4..e92b97c8a5e 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -49,25 +49,10 @@ def test_sanity(self, tmp_path: Path) -> None:
         assert im.size == (128, 128)
         assert im.format == "TIFF"
 
-        hopper("1").save(filename)
-        with Image.open(filename):
-            pass
-
-        hopper("L").save(filename)
-        with Image.open(filename):
-            pass
-
-        hopper("P").save(filename)
-        with Image.open(filename):
-            pass
-
-        hopper("RGB").save(filename)
-        with Image.open(filename):
-            pass
-
-        hopper("I").save(filename)
-        with Image.open(filename):
-            pass
+        for mode in ("1", "L", "P", "RGB", "I", "I;16", "I;16L"):
+            hopper(mode).save(filename)
+            with Image.open(filename):
+                pass
 
     @pytest.mark.skipif(is_pypy(), reason="Requires CPython")
     def test_unclosed_file(self) -> None:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 4c0ed01efd1..146b01e5f08 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1680,6 +1680,7 @@ def _setup(self) -> None:
     "PA": ("PA", II, 3, 1, (8, 8), 2),
     "I": ("I;32S", II, 1, 2, (32,), None),
     "I;16": ("I;16", II, 1, 1, (16,), None),
+    "I;16L": ("I;16L", II, 1, 1, (16,), None),
     "F": ("F;32F", II, 1, 3, (32,), None),
     "RGB": ("RGB", II, 2, 1, (8, 8, 8), None),
     "RGBX": ("RGBX", II, 2, 1, (8, 8, 8, 8), 0),
@@ -1963,7 +1964,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         # we're storing image byte order. So, if the rawmode
         # contains I;16, we need to convert from native to image
         # byte order.
-        if im.mode in ("I;16B", "I;16"):
+        if im.mode in ("I;16", "I;16B", "I;16L"):
             rawmode = "I;16N"
 
         # Pass tags as sorted list so that the tags are set in a fixed order.

From 5aa09cd1078440578b6cd040f86977358c7983b9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Jun 2025 14:56:18 +1000
Subject: [PATCH 1784/2374] Updated libpng to 1.6.49

---
 .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 b46811f5a01..996d32bc253 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -39,7 +39,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=11.2.1
-LIBPNG_VERSION=1.6.48
+LIBPNG_VERSION=1.6.49
 JPEGTURBO_VERSION=3.1.1
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.8.1
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 0cc383733b7..098716b6075 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -118,7 +118,7 @@ def cmd_msbuild(
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.3.4",
-    "LIBPNG": "1.6.48",
+    "LIBPNG": "1.6.49",
     "LIBWEBP": "1.5.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.7.0",

From e6af31e709eb61c553d13fb8648772379211f250 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Jun 2025 16:09:11 +1000
Subject: [PATCH 1785/2374] Deprecate fromarray mode argument

---
 Tests/test_image_array.py    | 6 ++++--
 docs/deprecations.rst        | 8 ++++++++
 docs/releasenotes/11.3.0.rst | 7 ++++---
 src/PIL/Image.py             | 3 ++-
 4 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index eb2309e0ffe..2c71dceb841 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -101,7 +101,8 @@ def __init__(self, arr_params: dict[str, Any]) -> None:
 
     with pytest.raises(ValueError):
         wrapped = Wrapper({"shape": (1, 1), "strides": (1, 1)})
-        Image.fromarray(wrapped, "L")
+        with pytest.warns(DeprecationWarning):
+            Image.fromarray(wrapped, "L")
 
 
 def test_fromarray_palette() -> None:
@@ -110,7 +111,8 @@ def test_fromarray_palette() -> None:
     a = numpy.array(i)
 
     # Act
-    out = Image.fromarray(a, "P")
+    with pytest.warns(DeprecationWarning):
+        out = Image.fromarray(a, "P")
 
     # Assert that the Python and C palettes match
     assert out.palette is not None
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 0490ba439fd..a5d89408b96 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -193,6 +193,14 @@ Image.Image.get_child_images()
 method uses an image's file pointer, and so child images could only be retrieved from
 an :py:class:`PIL.ImageFile.ImageFile` instance.
 
+Image.fromarray mode parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.3.0
+
+The ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` has been deprecated. The
+mode can be automatically determined from the object's shape and type instead.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index b0595def9b8..f0fa8c85801 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -23,10 +23,11 @@ TODO
 Deprecations
 ============
 
-TODO
-^^^^
+Image.fromarray mode parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+The ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` has been deprecated. The
+mode can be automatically determined from the object's shape and type instead.
 
 API changes
 ===========
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 7e9540e48ce..0be9e8ce491 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3272,7 +3272,7 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
 
     :param obj: Object with array interface
     :param mode: Optional mode to use when reading ``obj``. Will be determined from
-      type if ``None``.
+      type if ``None``. Deprecated.
 
       This will not be used to convert the data after reading, but will be used to
       change how the data is read::
@@ -3307,6 +3307,7 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
             msg = f"Cannot handle this data type: {typekey_shape}, {typestr}"
             raise TypeError(msg) from e
     else:
+        deprecate("'mode' parameter", 13)
         rawmode = mode
     if mode in ["1", "L", "I", "P", "F"]:
         ndmax = 2

From 27ce12bb7a4b5e7d8f662d7eb3a6e39fe636b7c8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Jun 2025 16:44:42 +1000
Subject: [PATCH 1786/2374] Added release notes for #8969

---
 docs/releasenotes/11.3.0.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index b0595def9b8..bf9506a3bd6 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -47,6 +47,13 @@ TODO
 Other changes
 =============
 
+Do not build against libavif < 1
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Pillow only supports libavif 1.0.0 or later. In order to prevent errors when building
+from source, if a user happens to have an earlier libavif on their system, Pillow will
+now ignore it.
+
 Python 3.14 beta
 ^^^^^^^^^^^^^^^^
 

From 3ac1edf6dafddd26ecfae1dbf041e678d4eda97c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Jun 2025 17:13:02 +1000
Subject: [PATCH 1787/2374] Added release notes for #8912

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

diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index bf9506a3bd6..ea22a9c8e31 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -47,6 +47,12 @@ TODO
 Other changes
 =============
 
+Support using grim with ImageGrab on Linux
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+:py:meth:`~PIL.ImageGrab.grab` is now able to use ``gnome-screenshot``, ``grim`` or
+``spectacle`` on Linux in order to take a snapshot of the screen.
+
 Do not build against libavif < 1
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 

From 59667bbec54c7e37887ba1dfd0a3389c2d5bc413 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Jun 2025 18:39:30 +1000
Subject: [PATCH 1788/2374] Use *_tofile helpers

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

diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index 9f50df22d86..f64a9d420c4 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -7,9 +7,8 @@
 from PIL import BlpImagePlugin, Image
 
 from .helper import (
-    assert_image_equal,
     assert_image_equal_tofile,
-    assert_image_similar,
+    assert_image_similar_tofile,
     hopper,
 )
 
@@ -52,15 +51,13 @@ def test_save(tmp_path: Path) -> None:
         im = hopper("P")
         im.save(f, blp_version=version)
 
-        with Image.open(f) as reloaded:
-            assert_image_equal(im.convert("RGB"), reloaded)
+        assert_image_equal_tofile(im.convert("RGB"), f)
 
         with Image.open("Tests/images/transparent.png") as im:
             f = tmp_path / "temp.blp"
             im.convert("P").save(f, blp_version=version)
 
-            with Image.open(f) as reloaded:
-                assert_image_similar(im, reloaded, 8)
+            assert_image_similar_tofile(im, f, 8)
 
     im = hopper()
     with pytest.raises(ValueError):

From ce8083e0d871899294142e09c88d249409334aaf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Jun 2025 18:40:03 +1000
Subject: [PATCH 1789/2374] Match error message

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

diff --git a/Tests/test_file_blp.py b/Tests/test_file_blp.py
index f64a9d420c4..5f6b263a1e3 100644
--- a/Tests/test_file_blp.py
+++ b/Tests/test_file_blp.py
@@ -60,7 +60,7 @@ def test_save(tmp_path: Path) -> None:
             assert_image_similar_tofile(im, f, 8)
 
     im = hopper()
-    with pytest.raises(ValueError):
+    with pytest.raises(ValueError, match="Unsupported BLP image mode"):
         im.save(f)
 
 

From cb433ad00ad4ad6eeaed8e70c191ea94e8087298 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Jun 2025 08:15:08 +1000
Subject: [PATCH 1790/2374] Replaced ImagingError_Clear with PyErr_Clear

---
 src/_imaging.c           | 5 -----
 src/libImaging/Imaging.h | 2 --
 src/libImaging/Storage.c | 2 +-
 3 files changed, 1 insertion(+), 8 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 2a7bc8d3f5e..2e8c8b0adb9 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -369,11 +369,6 @@ ImagingError_ValueError(const char *message) {
     return NULL;
 }
 
-void
-ImagingError_Clear(void) {
-    PyErr_Clear();
-}
-
 /* -------------------------------------------------------------------- */
 /* HELPERS                                */
 /* -------------------------------------------------------------------- */
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 39ecdbff63d..29e21c55123 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -280,8 +280,6 @@ extern void *
 ImagingError_Mismatch(void); /* maps to ValueError by default */
 extern void *
 ImagingError_ValueError(const char *message);
-extern void
-ImagingError_Clear(void);
 
 /* Transform callbacks */
 /* ------------------- */
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 11d6c06cc63..6fe26e1bd1a 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -645,7 +645,7 @@ ImagingNewInternal(const char *mode, int xsize, int ysize, int dirty) {
         return im;
     }
 
-    ImagingError_Clear();
+    PyErr_Clear();
 
     // Try to allocate the image once more with smallest possible block size
     MUTEX_LOCK(&ImagingDefaultArena.mutex);

From 8309962926f8e4f77c9899c4c5b763e9f5966311 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Jun 2025 08:19:27 +1000
Subject: [PATCH 1791/2374] Replaced ImagingError_OSError with PyErr_SetString

---
 src/_imaging.c           | 6 ------
 src/libImaging/File.c    | 2 +-
 src/libImaging/Imaging.h | 2 --
 3 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 2e8c8b0adb9..6241dc3ca08 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -338,12 +338,6 @@ static const char *no_palette = "image has no palette";
 static const char *readonly = "image is readonly";
 /* static const char* no_content = "image has no content"; */
 
-void *
-ImagingError_OSError(void) {
-    PyErr_SetString(PyExc_OSError, "error when accessing file");
-    return NULL;
-}
-
 void *
 ImagingError_MemoryError(void) {
     return PyErr_NoMemory();
diff --git a/src/libImaging/File.c b/src/libImaging/File.c
index 76d0abccc4f..901fe83ad27 100644
--- a/src/libImaging/File.c
+++ b/src/libImaging/File.c
@@ -54,7 +54,7 @@ ImagingSavePPM(Imaging im, const char *outfile) {
 
     fp = fopen(outfile, "wb");
     if (!fp) {
-        (void)ImagingError_OSError();
+        PyErr_SetString(PyExc_OSError, "error when accessing file");
         return 0;
     }
 
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 29e21c55123..bfe67d46213 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -270,8 +270,6 @@ ImagingSectionLeave(ImagingSectionCookie *cookie);
 /* Exceptions */
 /* ---------- */
 
-extern void *
-ImagingError_OSError(void);
 extern void *
 ImagingError_MemoryError(void);
 extern void *

From c19afb94301de3980ea0a6fd7c26aa9ab3c05065 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 16 Jun 2025 20:05:34 +1000
Subject: [PATCH 1792/2374] Use names

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

diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index ea22a9c8e31..45dff04decb 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -50,8 +50,8 @@ Other changes
 Support using grim with ImageGrab on Linux
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-:py:meth:`~PIL.ImageGrab.grab` is now able to use ``gnome-screenshot``, ``grim`` or
-``spectacle`` on Linux in order to take a snapshot of the screen.
+:py:meth:`~PIL.ImageGrab.grab` is now able to use GNOME Screenshot, grim or
+Spectacle on Linux in order to take a snapshot of the screen.
 
 Do not build against libavif < 1
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

From 7b5e11deb7441cab16df247f1f0890cd0d303372 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Jun 2025 20:06:53 +1000
Subject: [PATCH 1793/2374] Updated heading

---
 docs/releasenotes/11.3.0.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index 45dff04decb..ba091fa2c4f 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -47,11 +47,11 @@ TODO
 Other changes
 =============
 
-Support using grim with ImageGrab on Linux
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Support using more screenshot utilities with ImageGrab on Linux
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-:py:meth:`~PIL.ImageGrab.grab` is now able to use GNOME Screenshot, grim or
-Spectacle on Linux in order to take a snapshot of the screen.
+:py:meth:`~PIL.ImageGrab.grab` is now able to use GNOME Screenshot, grim or Spectacle
+on Linux in order to take a snapshot of the screen.
 
 Do not build against libavif < 1
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

From d23d56e195d34734b42452995682e4a9649e5332 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 17 Jun 2025 23:10:15 +1000
Subject: [PATCH 1794/2374] Deprecate saving I mode images as PNG

---
 Tests/test_file_png.py       | 14 ++++++++++++--
 docs/deprecations.rst        | 14 ++++++++++++++
 docs/releasenotes/11.3.0.rst | 13 ++++++++++---
 src/PIL/PngImagePlugin.py    |  3 +++
 4 files changed, 39 insertions(+), 5 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 0f0886ab8dc..15f67385a2d 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -100,11 +100,11 @@ def test_sanity(self, tmp_path: Path) -> None:
             assert im.format == "PNG"
             assert im.get_format_mimetype() == "image/png"
 
-        for mode in ["1", "L", "P", "RGB", "I", "I;16", "I;16B"]:
+        for mode in ["1", "L", "P", "RGB", "I;16", "I;16B"]:
             im = hopper(mode)
             im.save(test_file)
             with Image.open(test_file) as reloaded:
-                if mode in ("I", "I;16B"):
+                if mode == "I;16B":
                     reloaded = reloaded.convert(mode)
                 assert_image_equal(reloaded, im)
 
@@ -801,6 +801,16 @@ def test_truncated_end_chunk(self, monkeypatch: pytest.MonkeyPatch) -> None:
         with Image.open("Tests/images/truncated_end_chunk.png") as im:
             assert_image_equal_tofile(im, "Tests/images/hopper.png")
 
+    def test_deprecation(self, tmp_path: Path) -> None:
+        test_file = tmp_path / "out.png"
+
+        im = hopper("I")
+        with pytest.warns(DeprecationWarning):
+            im.save(test_file)
+
+        with Image.open(test_file) as reloaded:
+            assert_image_equal(im, reloaded.convert("I"))
+
 
 @pytest.mark.skipif(is_win32(), reason="Requires Unix or macOS")
 @skip_unless_feature("zlib")
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 0490ba439fd..a36eb4aa74b 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -193,6 +193,20 @@ Image.Image.get_child_images()
 method uses an image's file pointer, and so child images could only be retrieved from
 an :py:class:`PIL.ImageFile.ImageFile` instance.
 
+Saving I mode images as PNG
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.3.0
+
+In order to fit the 32 bits of I mode images into PNG, when PNG images can only contain
+at most 16 bits for a channel, Pillow has been clipping the values. Rather than quietly
+changing the data, this is now deprecated. Instead, the image can be converted to
+another mode before saving::
+
+    from PIL import Image
+    im = Image.new("I", (1, 1))
+    im.convert("I;16").save("out.png")
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index ba091fa2c4f..5dd151bf38a 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -23,10 +23,17 @@ TODO
 Deprecations
 ============
 
-TODO
-^^^^
+Saving I mode images as PNG
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+In order to fit the 32 bits of I mode images into PNG, when PNG images can only contain
+at most 16 bits for a channel, Pillow has been clipping the values. Rather than quietly
+changing the data, this is now deprecated. Instead, the image can be converted to
+another mode before saving::
+
+    from PIL import Image
+    im = Image.new("I", (1, 1))
+    im.convert("I;16").save("out.png")
 
 API changes
 ===========
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index f3815a12205..7999381a6b9 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -48,6 +48,7 @@
 from ._binary import o8
 from ._binary import o16be as o16
 from ._binary import o32be as o32
+from ._deprecate import deprecate
 from ._util import DeferredError
 
 TYPE_CHECKING = False
@@ -1368,6 +1369,8 @@ def _save(
     except KeyError as e:
         msg = f"cannot write mode {mode} as PNG"
         raise OSError(msg) from e
+    if outmode == "I":
+        deprecate("Saving I mode images as PNG", 13)
 
     #
     # write minimal PNG file

From a4e8d675b4e0eeba79d4579bca8621bea7ee68fe Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Jun 2025 21:59:31 +1000
Subject: [PATCH 1795/2374] Only check DHT marker for libjpeg-turbo

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

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 2827937cf57..614044d97eb 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1067,10 +1067,16 @@ def test_separate_tables(self) -> None:
         for marker in b"\xff\xd8", b"\xff\xd9":
             assert marker in data[1]
             assert marker in data[2]
-        # DHT, DQT
-        for marker in b"\xff\xc4", b"\xff\xdb":
+
+        # DQT
+        markers = [b"\xff\xdb"]
+        if features.check_feature("libjpeg_turbo"):
+            # DHT
+            markers.append(b"\xff\xc4")
+        for marker in markers:
             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]

From 79e0b0b6ada86f16bf7a8cf1c878756225d85d44 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Jun 2025 22:19:20 +1000
Subject: [PATCH 1796/2374] Allow for custom stacklevel in deprecations

---
 src/PIL/PngImagePlugin.py | 2 +-
 src/PIL/_deprecate.py     | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 7999381a6b9..1b9a89aef0d 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1370,7 +1370,7 @@ def _save(
         msg = f"cannot write mode {mode} as PNG"
         raise OSError(msg) from e
     if outmode == "I":
-        deprecate("Saving I mode images as PNG", 13)
+        deprecate("Saving I mode images as PNG", 13, stacklevel=4)
 
     #
     # write minimal PNG file
diff --git a/src/PIL/_deprecate.py b/src/PIL/_deprecate.py
index 9f9d8bbc9cc..170d4449049 100644
--- a/src/PIL/_deprecate.py
+++ b/src/PIL/_deprecate.py
@@ -12,6 +12,7 @@ def deprecate(
     *,
     action: str | None = None,
     plural: bool = False,
+    stacklevel: int = 3,
 ) -> None:
     """
     Deprecations helper.
@@ -67,5 +68,5 @@ def deprecate(
     warnings.warn(
         f"{deprecated} {is_} deprecated and will be removed in {removed}{action}",
         DeprecationWarning,
-        stacklevel=3,
+        stacklevel=stacklevel,
     )

From 92de1db067112d5b15c034036b2216009822a3b0 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Thu, 19 Jun 2025 11:12:40 +1000
Subject: [PATCH 1797/2374] Update dependency mypy to v1.16.1 (#9026)

---
 .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 a9c18ae2bfd..44b5badabf1 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.16.0
+mypy==1.16.1
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From ef0bab0c6579fd00987740a6a327603ff3886a38 Mon Sep 17 00:00:00 2001
From: thisismypassport <109758321+thisismypassport@users.noreply.github.com>
Date: Thu, 19 Jun 2025 11:16:26 +0300
Subject: [PATCH 1798/2374] Support writing QOI images (#9007)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_qoi.py               |  23 +++++-
 docs/handbook/image-file-formats.rst |  29 +++++--
 docs/releasenotes/11.3.0.rst         |   7 ++
 src/PIL/QoiImagePlugin.py            | 119 +++++++++++++++++++++++++++
 4 files changed, 168 insertions(+), 10 deletions(-)

diff --git a/Tests/test_file_qoi.py b/Tests/test_file_qoi.py
index 7ce1da2099d..b9becb24f77 100644
--- a/Tests/test_file_qoi.py
+++ b/Tests/test_file_qoi.py
@@ -1,10 +1,12 @@
 from __future__ import annotations
 
+from pathlib import Path
+
 import pytest
 
 from PIL import Image, QoiImagePlugin
 
-from .helper import assert_image_equal_tofile
+from .helper import assert_image_equal_tofile, hopper
 
 
 def test_sanity() -> None:
@@ -34,3 +36,22 @@ def test_op_index() -> None:
     # QOI_OP_INDEX as the first chunk
     with Image.open("Tests/images/op_index.qoi") as im:
         assert im.getpixel((0, 0)) == (0, 0, 0, 0)
+
+
+def test_save(tmp_path: Path) -> None:
+    f = tmp_path / "temp.qoi"
+
+    im = hopper()
+    im.save(f, colorspace="sRGB")
+
+    assert_image_equal_tofile(im, f)
+
+    for path in ("Tests/images/default_font.png", "Tests/images/pil123rgba.png"):
+        with Image.open(path) as im:
+            im.save(f)
+
+            assert_image_equal_tofile(im, f)
+
+    im = hopper("P")
+    with pytest.raises(ValueError, match="Unsupported QOI image mode"):
+        im.save(f)
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 5ca549c3787..a15e845745f 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1082,6 +1082,26 @@ Pillow reads and writes PBM, PGM, PPM and PNM files containing ``1``, ``L``, ``I
 
 Since Pillow 9.2.0, "plain" (P1 to P3) formats can be read as well.
 
+QOI
+^^^
+
+.. versionadded:: 9.5.0
+
+Pillow reads and writes images in Quite OK Image format using a Python codec. 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.
+
+.. _qoi-saving:
+
+Saving
+~~~~~~
+
+The :py:meth:`~PIL.Image.Image.save` method can take the following keyword arguments:
+
+**colorspace**
+    If set to "sRGB", the colorspace will be written as sRGB with linear alpha, instead
+    of all channels being linear.
+
 SGI
 ^^^
 
@@ -1578,15 +1598,6 @@ PSD
 
 Pillow identifies and reads PSD files written by Adobe Photoshop 2.5 and 3.0.
 
-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.
-
 SUN
 ^^^
 
diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index ba091fa2c4f..6bd4f7481c4 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -47,6 +47,13 @@ TODO
 Other changes
 =============
 
+Added QOI saving
+^^^^^^^^^^^^^^^^
+
+Support has been added for saving QOI images. ``colorspace`` can be used to specify the
+colorspace as sRGB with linear alpha, e.g. ``im.save("out.qoi", colorspace="sRGB")``.
+By default, all channels will be linear.
+
 Support using more screenshot utilities with ImageGrab on Linux
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index 75070abd740..dba5d809fef 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -8,9 +8,12 @@
 from __future__ import annotations
 
 import os
+from typing import IO
 
 from . import Image, ImageFile
 from ._binary import i32be as i32
+from ._binary import o8
+from ._binary import o32be as o32
 
 
 def _accept(prefix: bytes) -> bool:
@@ -110,6 +113,122 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
         return -1, 0
 
 
+def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
+    if im.mode == "RGB":
+        channels = 3
+    elif im.mode == "RGBA":
+        channels = 4
+    else:
+        msg = "Unsupported QOI image mode"
+        raise ValueError(msg)
+
+    colorspace = 0 if im.encoderinfo.get("colorspace") == "sRGB" else 1
+
+    fp.write(b"qoif")
+    fp.write(o32(im.size[0]))
+    fp.write(o32(im.size[1]))
+    fp.write(o8(channels))
+    fp.write(o8(colorspace))
+
+    ImageFile._save(im, fp, [ImageFile._Tile("qoi", (0, 0) + im.size)])
+
+
+class QoiEncoder(ImageFile.PyEncoder):
+    _pushes_fd = True
+    _previous_pixel: tuple[int, int, int, int] | None = None
+    _previously_seen_pixels: dict[int, tuple[int, int, int, int]] = {}
+    _run = 0
+
+    def _write_run(self) -> bytes:
+        data = o8(0b11000000 | (self._run - 1))  # QOI_OP_RUN
+        self._run = 0
+        return data
+
+    def _delta(self, left: int, right: int) -> int:
+        result = (left - right) & 255
+        if result >= 128:
+            result -= 256
+        return result
+
+    def encode(self, bufsize: int) -> tuple[int, int, bytes]:
+        assert self.im is not None
+
+        self._previously_seen_pixels = {0: (0, 0, 0, 0)}
+        self._previous_pixel = (0, 0, 0, 255)
+
+        data = bytearray()
+        w, h = self.im.size
+        bands = Image.getmodebands(self.mode)
+
+        for y in range(h):
+            for x in range(w):
+                pixel = self.im.getpixel((x, y))
+                if bands == 3:
+                    pixel = (*pixel, 255)
+
+                if pixel == self._previous_pixel:
+                    self._run += 1
+                    if self._run == 62:
+                        data += self._write_run()
+                else:
+                    if self._run:
+                        data += self._write_run()
+
+                    r, g, b, a = pixel
+                    hash_value = (r * 3 + g * 5 + b * 7 + a * 11) % 64
+                    if self._previously_seen_pixels.get(hash_value) == pixel:
+                        data += o8(hash_value)  # QOI_OP_INDEX
+                    elif self._previous_pixel:
+                        self._previously_seen_pixels[hash_value] = pixel
+
+                        prev_r, prev_g, prev_b, prev_a = self._previous_pixel
+                        if prev_a == a:
+                            delta_r = self._delta(r, prev_r)
+                            delta_g = self._delta(g, prev_g)
+                            delta_b = self._delta(b, prev_b)
+
+                            if (
+                                -2 <= delta_r < 2
+                                and -2 <= delta_g < 2
+                                and -2 <= delta_b < 2
+                            ):
+                                data += o8(
+                                    0b01000000
+                                    | (delta_r + 2) << 4
+                                    | (delta_g + 2) << 2
+                                    | (delta_b + 2)
+                                )  # QOI_OP_DIFF
+                            else:
+                                delta_gr = self._delta(delta_r, delta_g)
+                                delta_gb = self._delta(delta_b, delta_g)
+                                if (
+                                    -8 <= delta_gr < 8
+                                    and -32 <= delta_g < 32
+                                    and -8 <= delta_gb < 8
+                                ):
+                                    data += o8(
+                                        0b10000000 | (delta_g + 32)
+                                    )  # QOI_OP_LUMA
+                                    data += o8((delta_gr + 8) << 4 | (delta_gb + 8))
+                                else:
+                                    data += o8(0b11111110)  # QOI_OP_RGB
+                                    data += bytes(pixel[:3])
+                        else:
+                            data += o8(0b11111111)  # QOI_OP_RGBA
+                            data += bytes(pixel)
+
+                self._previous_pixel = pixel
+
+        if self._run:
+            data += self._write_run()
+        data += bytes((0, 0, 0, 0, 0, 0, 0, 1))  # padding
+
+        return len(data), 0, data
+
+
 Image.register_open(QoiImageFile.format, QoiImageFile, _accept)
 Image.register_decoder("qoi", QoiDecoder)
 Image.register_extension(QoiImageFile.format, ".qoi")
+
+Image.register_save(QoiImageFile.format, _save)
+Image.register_encoder("qoi", QoiEncoder)

From 2316c930f9b2985d27894f043f5f2e4787543dca Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 19 Jun 2025 22:46:09 +1000
Subject: [PATCH 1799/2374] Removed default argument

---
 setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index ec6b47b1c8c..23381119219 100644
--- a/setup.py
+++ b/setup.py
@@ -22,7 +22,7 @@
 from setuptools import Extension, setup
 from setuptools.command.build_ext import build_ext
 
-ParallelCompile("MAX_CONCURRENCY", default=0).install()
+ParallelCompile("MAX_CONCURRENCY").install()
 
 
 def get_version() -> str:
@@ -1051,12 +1051,12 @@ def debug_build() -> bool:
     Extension("PIL._imagingmorph", ["src/_imagingmorph.c"]),
 ]
 
+
 # parse configuration from _custom_build/backend.py
 while sys.argv[-1].startswith("--pillow-configuration="):
     _, key, value = sys.argv.pop().split("=", 2)
     configuration.setdefault(key, []).append(value)
 
-
 try:
     setup(
         cmdclass={"build_ext": pil_build_ext},

From f937dd27cd670971b93f4bdf17abccc0338e6b4c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 20 Jun 2025 23:44:30 +1000
Subject: [PATCH 1800/2374] Do not call sys.executable in PyInstaller
 application

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

diff --git a/src/PIL/ImageShow.py b/src/PIL/ImageShow.py
index dd240fb5500..7705608e3ec 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -175,7 +175,9 @@ def show_file(self, path: str, **options: Any) -> int:
         if not os.path.exists(path):
             raise FileNotFoundError
         subprocess.call(["open", "-a", "Preview.app", path])
-        executable = sys.executable or shutil.which("python3")
+
+        pyinstaller = getattr(sys, "frozen", False) and hasattr(sys, "_MEIPASS")
+        executable = (not pyinstaller and sys.executable) or shutil.which("python3")
         if executable:
             subprocess.Popen(
                 [

From 216dc4ca60947b4076defa2f0565f8b74a7864e0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Jun 2025 19:12:23 +1000
Subject: [PATCH 1801/2374] Added Python 3.14 macOS x86-64 wheels

---
 .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 72516651f42..229e23ef04e 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -58,7 +58,7 @@ jobs:
           - name: "macOS 10.13 x86_64"
             os: macos-13
             cibw_arch: x86_64
-            build: "cp3{12,13}*"
+            build: "cp3{12,13,14}*"
             macosx_deployment_target: "10.13"
           - name: "macOS 10.15 x86_64"
             os: macos-13

From ae025183148a900511e7f8866ca5c28f3efc7b5f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 22 Jun 2025 22:08:51 +1000
Subject: [PATCH 1802/2374] Use same AVIF URL when fetching dependency (#8871)

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

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 098716b6075..4baa5ccefb8 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -385,8 +385,8 @@ def cmd_msbuild(
         "bins": [r"*.dll"],
     },
     "libavif": {
-        "url": f"https://github.com/AOMediaCodec/libavif/archive/v{V['LIBAVIF']}.zip",
-        "filename": f"libavif-{V['LIBAVIF']}.zip",
+        "url": f"https://github.com/AOMediaCodec/libavif/archive/v{V['LIBAVIF']}.tar.gz",
+        "filename": f"libavif-{V['LIBAVIF']}.tar.gz",
         "license": "LICENSE",
         "build": [
             "rustup update",

From 2954964cd2b70c463d75bd7f828c7bb7f3802bf2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 23 Jun 2025 07:05:43 +1000
Subject: [PATCH 1803/2374] Removed ImageCmsProfile._set method (#9032)

Co-authored-by: Luke Granger-Brown <git@lukegb.com>
---
 src/PIL/ImageCms.py | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index fdfbee78974..a1584f111d4 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -248,6 +248,9 @@ def __init__(self, profile: str | SupportsRead[bytes] | core.CmsProfile) -> None
             low-level profile object
 
         """
+        self.filename = None
+        self.product_name = None  # profile.product_name
+        self.product_info = None  # profile.product_info
 
         if isinstance(profile, str):
             if sys.platform == "win32":
@@ -256,23 +259,18 @@ def __init__(self, profile: str | SupportsRead[bytes] | core.CmsProfile) -> None
                     profile_bytes_path.decode("ascii")
                 except UnicodeDecodeError:
                     with open(profile, "rb") as f:
-                        self._set(core.profile_frombytes(f.read()))
+                        self.profile = core.profile_frombytes(f.read())
                     return
-            self._set(core.profile_open(profile), profile)
+            self.filename = profile
+            self.profile = core.profile_open(profile)
         elif hasattr(profile, "read"):
-            self._set(core.profile_frombytes(profile.read()))
+            self.profile = core.profile_frombytes(profile.read())
         elif isinstance(profile, core.CmsProfile):
-            self._set(profile)
+            self.profile = profile
         else:
             msg = "Invalid type for Profile"  # type: ignore[unreachable]
             raise TypeError(msg)
 
-    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) -> bytes:
         """
         Returns the profile in a format suitable for embedding in

From 1557585411f1f891180775dab40cfeec236d69bf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 24 Jun 2025 20:29:38 +1000
Subject: [PATCH 1804/2374] Use percent formatting

---
 setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index 3716a7b9f66..256c78fc99c 100644
--- a/setup.py
+++ b/setup.py
@@ -509,11 +509,11 @@ def build_extensions(self) -> None:
 
             if root is None and pkg_config:
                 if isinstance(lib_name, str):
-                    _dbg(f"Looking for `{lib_name}` using pkg-config.")
+                    _dbg("Looking for `%s` using pkg-config.", lib_name)
                     root = pkg_config(lib_name)
                 else:
                     for lib_name2 in lib_name:
-                        _dbg(f"Looking for `{lib_name2}` using pkg-config.")
+                        _dbg("Looking for `%s` using pkg-config.", lib_name2)
                         root = pkg_config(lib_name2)
                         if root:
                             break

From 18f8af78d3f56639f91f4b788ab9d89ae573b72c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 24 Jun 2025 20:35:09 +1000
Subject: [PATCH 1805/2374] Pass strings or tuples of strings to _dbg

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

diff --git a/setup.py b/setup.py
index 256c78fc99c..f05379d6d8b 100644
--- a/setup.py
+++ b/setup.py
@@ -16,7 +16,6 @@
 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
@@ -148,7 +147,7 @@ class RequiredDependencyException(Exception):
 PLATFORM_MINGW = os.name == "nt" and "GCC" in sys.version
 
 
-def _dbg(s: str, tp: Any = None) -> None:
+def _dbg(s: str, tp: str | tuple[str, ...] | None = None) -> None:
     if DEBUG:
         if tp:
             print(s % tp)
@@ -732,7 +731,7 @@ def build_extensions(self) -> None:
                             best_path = os.path.join(directory, name)
                             _dbg(
                                 "Best openjpeg version %s so far in %s",
-                                (best_version, best_path),
+                                (str(best_version), best_path),
                             )
 
             if best_version and _find_library_file(self, "openjp2"):

From acd8b0c2acfa1c69f91a14d5881a7f9bf436900f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 25 Jun 2025 09:09:31 +1000
Subject: [PATCH 1806/2374] Fix libtiff cleanup (#9002)

---
 src/libImaging/TiffDecode.c | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 2e83fb847c9..e289ce4056e 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -1032,7 +1032,10 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
                 TRACE(("Encode Error, row %d\n", state->y));
                 state->errcode = IMAGING_CODEC_BROKEN;
 
-                if (!clientstate->fp) {
+                if (clientstate->fp) {
+                    TIFFCleanup(tiff);
+                    clientstate->tiff = NULL;
+                } else {
                     free(clientstate->data);
                 }
                 return -1;

From e1ee8afc7d1d0a1b3b91ce4caa018e4bb0a96e71 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 24 Jun 2025 18:58:29 +1000
Subject: [PATCH 1807/2374] Search for libtiff library file first on Windows
 and macOS

---
 setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index f05379d6d8b..354e09f85f2 100644
--- a/setup.py
+++ b/setup.py
@@ -753,12 +753,12 @@ def build_extensions(self) -> None:
         if feature.want("tiff"):
             _dbg("Looking for tiff")
             if _find_include_file(self, "tiff.h"):
-                if _find_library_file(self, "tiff"):
-                    feature.set("tiff", "tiff")
                 if sys.platform in ["win32", "darwin"] and _find_library_file(
                     self, "libtiff"
                 ):
                     feature.set("tiff", "libtiff")
+                elif _find_library_file(self, "tiff"):
+                    feature.set("tiff", "tiff")
 
         if feature.want("freetype"):
             _dbg("Looking for freetype")

From ecd264fffc680ab05da6a71ff4466c774185ab90 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Jun 2025 22:22:46 +1000
Subject: [PATCH 1808/2374] Use "parallel" config setting and 4 as defaults

---
 setup.py | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/setup.py b/setup.py
index 1134879beec..6c2180ebd15 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,15 @@
 from setuptools import Extension, setup
 from setuptools.command.build_ext import build_ext
 
-ParallelCompile("MAX_CONCURRENCY").install()
+configuration: dict[str, list[str]] = {}
+
+# parse configuration from _custom_build/backend.py
+while sys.argv[-1].startswith("--pillow-configuration="):
+    _, key, value = sys.argv.pop().split("=", 2)
+    configuration.setdefault(key, []).append(value)
+
+default = int(configuration.get("parallel", ["4"])[-1])
+ParallelCompile("MAX_CONCURRENCY", default).install()
 
 
 def get_version() -> str:
@@ -30,9 +38,6 @@ def get_version() -> str:
         return f.read().split('"')[1]
 
 
-configuration: dict[str, list[str]] = {}
-
-
 PILLOW_VERSION = get_version()
 AVIF_ROOT = None
 FREETYPE_ROOT = None
@@ -1047,11 +1052,6 @@ def debug_build() -> bool:
 ]
 
 
-# parse configuration from _custom_build/backend.py
-while sys.argv[-1].startswith("--pillow-configuration="):
-    _, key, value = sys.argv.pop().split("=", 2)
-    configuration.setdefault(key, []).append(value)
-
 try:
     setup(
         cmdclass={"build_ext": pil_build_ext},

From 23ed906b622e25466981fa7c2b80f2a1da612661 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Jun 2025 22:00:36 +1000
Subject: [PATCH 1809/2374] Removed default limit of 4

---
 docs/installation/building-from-source.rst | 5 ++---
 setup.py                                   | 6 ++----
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 8988a92ce36..4c114a5e27f 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -276,10 +276,9 @@ Build options
 
 * 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``
+  multiprocessing to build the extensions. 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.
+  using a setting of 1. By default, it uses as many CPUs as are present.
 
 * Config settings: ``-C zlib=disable``, ``-C jpeg=disable``,
   ``-C tiff=disable``, ``-C freetype=disable``, ``-C raqm=disable``,
diff --git a/setup.py b/setup.py
index 6c2180ebd15..aee1b04eb54 100644
--- a/setup.py
+++ b/setup.py
@@ -28,7 +28,7 @@
     _, key, value = sys.argv.pop().split("=", 2)
     configuration.setdefault(key, []).append(value)
 
-default = int(configuration.get("parallel", ["4"])[-1])
+default = int(configuration.get("parallel", ["0"])[-1])
 ParallelCompile("MAX_CONCURRENCY", default).install()
 
 
@@ -394,9 +394,7 @@ def finalize_options(self) -> 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))
-                    )
+                    self.parallel = int(os.environ.get("MAX_CONCURRENCY", cpu_count))
                 except TypeError:
                     pass
         for x in self.feature:

From 3d261a210192509f2c7980f87a922b7b3f3404dc Mon Sep 17 00:00:00 2001
From: Frankie Dintino <fdintino@gmail.com>
Date: Thu, 26 Jun 2025 02:21:44 -0400
Subject: [PATCH 1810/2374] Add AVIF to wheels using only aomenc and dav1d AVIF
 codecs for reduced size (#8858)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .github/workflows/wheels-dependencies.sh |  55 ++++
 .github/workflows/wheels.yml             |   2 +-
 Tests/check_wheel.py                     |   6 +-
 docs/releasenotes/11.3.0.rst             |   6 +
 wheels/dependency_licenses/AOM.txt       |  26 ++
 wheels/dependency_licenses/DAV1D.txt     |  23 ++
 wheels/dependency_licenses/LIBAVIF.txt   | 387 +++++++++++++++++++++++
 wheels/dependency_licenses/LIBYUV.txt    |  29 ++
 winbuild/build_prepare.py                |  15 +-
 9 files changed, 542 insertions(+), 7 deletions(-)
 create mode 100644 wheels/dependency_licenses/AOM.txt
 create mode 100644 wheels/dependency_licenses/DAV1D.txt
 create mode 100644 wheels/dependency_licenses/LIBAVIF.txt
 create mode 100644 wheels/dependency_licenses/LIBYUV.txt

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 996d32bc253..5384a74c0cd 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -51,6 +51,7 @@ LIBWEBP_VERSION=1.5.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0
+LIBAVIF_VERSION=1.3.0
 
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
@@ -98,6 +99,59 @@ function build_harfbuzz {
     touch harfbuzz-stamp
 }
 
+function build_libavif {
+    if [ -e libavif-stamp ]; then return; fi
+
+    python3 -m pip install meson ninja
+
+    if [[ "$PLAT" == "x86_64" ]] || [ -n "$SANITIZER" ]; then
+        build_simple nasm 2.16.03 https://www.nasm.us/pub/nasm/releasebuilds/2.16.03
+    fi
+
+    local build_type=MinSizeRel
+    local lto=ON
+
+    local libavif_cmake_flags
+
+    if [ -n "$IS_MACOS" ]; then
+        lto=OFF
+        libavif_cmake_flags=(
+            -DCMAKE_C_FLAGS_MINSIZEREL="-Oz -DNDEBUG -flto" \
+            -DCMAKE_CXX_FLAGS_MINSIZEREL="-Oz -DNDEBUG -flto" \
+            -DCMAKE_SHARED_LINKER_FLAGS_INIT="-Wl,-S,-x,-dead_strip_dylibs" \
+        )
+    else
+        if [[ "$MB_ML_VER" == 2014 ]] && [[ "$PLAT" == "x86_64" ]]; then
+            build_type=Release
+        fi
+        libavif_cmake_flags=(-DCMAKE_SHARED_LINKER_FLAGS_INIT="-Wl,--strip-all,-z,relro,-z,now")
+    fi
+
+    local out_dir=$(fetch_unpack https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$LIBAVIF_VERSION.tar.gz libavif-$LIBAVIF_VERSION.tar.gz)
+    # CONFIG_AV1_HIGHBITDEPTH=0 is a flag for libaom (included as a subproject
+    # of libavif) that disables support for encoding high bit depth images.
+    (cd $out_dir \
+        && cmake \
+            -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX \
+            -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib \
+            -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib \
+            -DBUILD_SHARED_LIBS=ON \
+            -DAVIF_LIBSHARPYUV=LOCAL \
+            -DAVIF_LIBYUV=LOCAL \
+            -DAVIF_CODEC_AOM=LOCAL \
+            -DCONFIG_AV1_HIGHBITDEPTH=0 \
+            -DAVIF_CODEC_AOM_DECODE=OFF \
+            -DAVIF_CODEC_DAV1D=LOCAL \
+            -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=$lto \
+            -DCMAKE_C_VISIBILITY_PRESET=hidden \
+            -DCMAKE_CXX_VISIBILITY_PRESET=hidden \
+            -DCMAKE_BUILD_TYPE=$build_type \
+            "${libavif_cmake_flags[@]}" \
+            . \
+        && make install)
+    touch libavif-stamp
+}
+
 function build {
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
@@ -132,6 +186,7 @@ function build {
         build_tiff
     fi
 
+    build_libavif
     build_libpng
     build_lcms2
     build_openjpeg
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 229e23ef04e..16c350a1484 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -159,7 +159,7 @@ jobs:
           # Install extra test images
           xcopy /S /Y Tests\test-images\* Tests\images
 
-          & python.exe winbuild\build_prepare.py -v --no-imagequant --no-avif --architecture=${{ matrix.cibw_arch }}
+          & python.exe winbuild\build_prepare.py -v --no-imagequant --architecture=${{ matrix.cibw_arch }}
         shell: pwsh
 
       - name: Build wheels
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
index 9602410da52..a78fb09b041 100644
--- a/Tests/check_wheel.py
+++ b/Tests/check_wheel.py
@@ -9,7 +9,7 @@
 
 
 def test_wheel_modules() -> None:
-    expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp"}
+    expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp", "avif"}
 
     if sys.platform == "win32":
         # tkinter is not available in cibuildwheel installed CPython on Windows
@@ -20,6 +20,10 @@ def test_wheel_modules() -> None:
         except ImportError:
             expected_modules.remove("tkinter")
 
+        # libavif is not available on Windows for ARM64 architectures
+        if platform.machine() == "ARM64":
+            expected_modules.remove("avif")
+
     assert set(features.get_supported_modules()) == expected_modules
 
 
diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index 82e4d44b692..654a7e6b6f1 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -80,6 +80,12 @@ Pillow only supports libavif 1.0.0 or later. In order to prevent errors when bui
 from source, if a user happens to have an earlier libavif on their system, Pillow will
 now ignore it.
 
+AVIF support in wheels
+^^^^^^^^^^^^^^^^^^^^^^
+
+Support for reading and writing AVIF images is now included in Pillow's wheels, except
+for Windows ARM64. libaom is available as an encoder and dav1d as a decoder.
+
 Python 3.14 beta
 ^^^^^^^^^^^^^^^^
 
diff --git a/wheels/dependency_licenses/AOM.txt b/wheels/dependency_licenses/AOM.txt
new file mode 100644
index 00000000000..3a2e46c264b
--- /dev/null
+++ b/wheels/dependency_licenses/AOM.txt
@@ -0,0 +1,26 @@
+Copyright (c) 2016, Alliance for Open Media. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in
+   the documentation and/or other materials provided with the
+   distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/DAV1D.txt b/wheels/dependency_licenses/DAV1D.txt
new file mode 100644
index 00000000000..875b138ecf6
--- /dev/null
+++ b/wheels/dependency_licenses/DAV1D.txt
@@ -0,0 +1,23 @@
+Copyright © 2018-2019, VideoLAN and dav1d authors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/LIBAVIF.txt b/wheels/dependency_licenses/LIBAVIF.txt
new file mode 100644
index 00000000000..350eb9d15ce
--- /dev/null
+++ b/wheels/dependency_licenses/LIBAVIF.txt
@@ -0,0 +1,387 @@
+Copyright 2019 Joe Drago. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+------------------------------------------------------------------------------
+
+Files: src/obu.c
+
+Copyright © 2018-2019, VideoLAN and dav1d authors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+------------------------------------------------------------------------------
+
+Files: third_party/iccjpeg/*
+
+In plain English:
+
+1. We don't promise that this software works.  (But if you find any bugs,
+   please let us know!)
+2. You can use this software for whatever you want.  You don't have to pay us.
+3. You may not pretend that you wrote this software.  If you use it in a
+   program, you must acknowledge somewhere in your documentation that
+   you've used the IJG code.
+
+In legalese:
+
+The authors make NO WARRANTY or representation, either express or implied,
+with respect to this software, its quality, accuracy, merchantability, or
+fitness for a particular purpose.  This software is provided "AS IS", and you,
+its user, assume the entire risk as to its quality and accuracy.
+
+This software is copyright (C) 1991-2013, Thomas G. Lane, Guido Vollbeding.
+All Rights Reserved except as specified below.
+
+Permission is hereby granted to use, copy, modify, and distribute this
+software (or portions thereof) for any purpose, without fee, subject to these
+conditions:
+(1) If any part of the source code for this software is distributed, then this
+README file must be included, with this copyright and no-warranty notice
+unaltered; and any additions, deletions, or changes to the original files
+must be clearly indicated in accompanying documentation.
+(2) If only executable code is distributed, then the accompanying
+documentation must state that "this software is based in part on the work of
+the Independent JPEG Group".
+(3) Permission for use of this software is granted only if the user accepts
+full responsibility for any undesirable consequences; the authors accept
+NO LIABILITY for damages of any kind.
+
+These conditions apply to any software derived from or based on the IJG code,
+not just to the unmodified library.  If you use our work, you ought to
+acknowledge us.
+
+Permission is NOT granted for the use of any IJG author's name or company name
+in advertising or publicity relating to this software or products derived from
+it.  This software may be referred to only as "the Independent JPEG Group's
+software".
+
+We specifically permit and encourage the use of this software as the basis of
+commercial products, provided that all warranty or liability claims are
+assumed by the product vendor.
+
+
+The Unix configuration script "configure" was produced with GNU Autoconf.
+It is copyright by the Free Software Foundation but is freely distributable.
+The same holds for its supporting scripts (config.guess, config.sub,
+ltmain.sh).  Another support script, install-sh, is copyright by X Consortium
+but is also freely distributable.
+
+The IJG distribution formerly included code to read and write GIF files.
+To avoid entanglement with the Unisys LZW patent, GIF reading support has
+been removed altogether, and the GIF writer has been simplified to produce
+"uncompressed GIFs".  This technique does not use the LZW algorithm; the
+resulting GIF files are larger than usual, but are readable by all standard
+GIF decoders.
+
+We are required to state that
+    "The Graphics Interchange Format(c) is the Copyright property of
+    CompuServe Incorporated.  GIF(sm) is a Service Mark property of
+    CompuServe Incorporated."
+
+------------------------------------------------------------------------------
+
+Files: contrib/gdk-pixbuf/*
+
+Copyright 2020 Emmanuel Gil Peyrot. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+------------------------------------------------------------------------------
+
+Files: android_jni/gradlew*
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+------------------------------------------------------------------------------
+
+Files: third_party/libyuv/*
+
+Copyright 2011 The LibYuv Project Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+  * Neither the name of Google nor the names of its contributors may
+    be used to endorse or promote products derived from this software
+    without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/wheels/dependency_licenses/LIBYUV.txt b/wheels/dependency_licenses/LIBYUV.txt
new file mode 100644
index 00000000000..c911747a6b5
--- /dev/null
+++ b/wheels/dependency_licenses/LIBYUV.txt
@@ -0,0 +1,29 @@
+Copyright 2011 The LibYuv Project Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in
+    the documentation and/or other materials provided with the
+    distribution.
+
+  * Neither the name of Google nor the names of its contributors may
+    be used to endorse or promote products derived from this software
+    without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 4baa5ccefb8..187d07b20c2 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -57,7 +57,10 @@ def cmd_nmake(
 
 
 def cmds_cmake(
-    target: str | tuple[str, ...] | list[str], *params: str, build_dir: str = "."
+    target: str | tuple[str, ...] | list[str],
+    *params: str,
+    build_dir: str = ".",
+    build_type: str = "Release",
 ) -> list[str]:
     if not isinstance(target, str):
         target = " ".join(target)
@@ -66,7 +69,7 @@ def cmds_cmake(
         " ".join(
             [
                 "{cmake}",
-                "-DCMAKE_BUILD_TYPE=Release",
+                f"-DCMAKE_BUILD_TYPE={build_type}",
                 "-DCMAKE_VERBOSE_MAKEFILE=ON",
                 "-DCMAKE_RULE_MESSAGES:BOOL=OFF",  # for NMake
                 "-DCMAKE_C_COMPILER=cl.exe",  # for Ninja
@@ -397,9 +400,11 @@ def cmd_msbuild(
                 "-DAVIF_LIBSHARPYUV=LOCAL",
                 "-DAVIF_LIBYUV=LOCAL",
                 "-DAVIF_CODEC_AOM=LOCAL",
+                "-DCONFIG_AV1_HIGHBITDEPTH=0",
+                "-DAVIF_CODEC_AOM_DECODE=OFF",
                 "-DAVIF_CODEC_DAV1D=LOCAL",
-                "-DAVIF_CODEC_RAV1E=LOCAL",
-                "-DAVIF_CODEC_SVT=LOCAL",
+                "-DCMAKE_INTERPROCEDURAL_OPTIMIZATION=ON",
+                build_type="MinSizeRel",
             ),
             cmd_xcopy("include", "{inc_dir}"),
         ],
@@ -755,7 +760,7 @@ def main() -> None:
         disabled += ["libimagequant"]
     if args.no_fribidi:
         disabled += ["fribidi"]
-    if args.no_avif or args.architecture != "AMD64":
+    if args.no_avif or args.architecture == "ARM64":
         disabled += ["libavif"]
 
     prefs = {

From b9afe18646c5dc28efed1a74579129f8c64976e2 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 25 Jun 2025 15:00:19 +0300
Subject: [PATCH 1811/2374] Bump pre-commit hooks

---
 .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 a1a054e008f..c6485829984 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.11.12
+    rev: v0.12.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.8.3
+    rev: 1.8.5
     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: v20.1.5
+    rev: v20.1.6
     hooks:
       - id: clang-format
         types: [c]
@@ -51,7 +51,7 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.33.0
+    rev: 0.33.1
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs

From 234875bf9001037f7510769f83e281bfe6012441 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 25 Jun 2025 15:01:14 +0300
Subject: [PATCH 1812/2374] Update Ruff hook from legacy

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

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index c6485829984..6abb732bbaa 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -2,7 +2,7 @@ repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.12.0
     hooks:
-      - id: ruff
+      - id: ruff-check
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror

From d1894dcd46c9096a91dd6ab39fe1df918ba18d6c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 25 Jun 2025 16:47:06 +0300
Subject: [PATCH 1813/2374] Add match parameter to pytest.warns()

---
 Tests/helper.py                     |  2 +-
 Tests/test_core_resources.py        |  2 +-
 Tests/test_features.py              | 13 ++++++-------
 Tests/test_file_apng.py             |  8 ++++----
 Tests/test_file_avif.py             |  4 ++--
 Tests/test_file_gif.py              |  6 ++++--
 Tests/test_file_icns.py             |  4 +++-
 Tests/test_file_ico.py              |  2 +-
 Tests/test_file_iptc.py             |  6 +++---
 Tests/test_file_jpeg.py             | 13 +++++++------
 Tests/test_file_png.py              |  2 +-
 Tests/test_file_tga.py              |  4 +++-
 Tests/test_file_tiff.py             |  4 ++--
 Tests/test_file_tiff_metadata.py    |  4 ++--
 Tests/test_file_webp.py             |  4 ++--
 Tests/test_image.py                 | 12 ++++++------
 Tests/test_image_access.py          |  2 +-
 Tests/test_image_array.py           |  6 +++---
 Tests/test_image_convert.py         |  5 ++++-
 Tests/test_image_getim.py           |  4 ++--
 Tests/test_image_putdata.py         |  2 +-
 Tests/test_imagecms.py              | 14 +++++++-------
 Tests/test_imagedraw.py             |  2 +-
 Tests/test_imagefile.py             |  2 +-
 Tests/test_imagefont.py             | 12 ++++++------
 Tests/test_imagemath_lambda_eval.py |  2 +-
 Tests/test_imagemath_unsafe_eval.py |  4 ++--
 Tests/test_lib_pack.py              |  4 +++-
 28 files changed, 80 insertions(+), 69 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index ec61cd263e9..e71b4665b28 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -272,7 +272,7 @@ def _cached_hopper(mode: str) -> Image.Image:
     else:
         im = hopper()
     if mode.startswith("BGR;"):
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="BGR;"):
             im = im.convert(mode)
     else:
         try:
diff --git a/Tests/test_core_resources.py b/Tests/test_core_resources.py
index 2c1de8bc3d2..2a22f805d8d 100644
--- a/Tests/test_core_resources.py
+++ b/Tests/test_core_resources.py
@@ -188,5 +188,5 @@ def test_units(self) -> None:
         ),
     )
     def test_warnings(self, var: dict[str, str]) -> None:
-        with pytest.warns(UserWarning):
+        with pytest.warns(UserWarning, match=list(var)[0]):
             Image._apply_env_variables(var)
diff --git a/Tests/test_features.py b/Tests/test_features.py
index f8f7f6eec59..d06fb4d841c 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -19,7 +19,7 @@ def test_check() -> None:
         assert features.check_codec(codec) == features.check(codec)
     for feature in features.features:
         if "webp" in feature:
-            with pytest.warns(DeprecationWarning):
+            with pytest.warns(DeprecationWarning, match="webp"):
                 assert features.check_feature(feature) == features.check(feature)
         else:
             assert features.check_feature(feature) == features.check(feature)
@@ -49,24 +49,24 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
         test(codec, features.version_codec)
     for feature in features.features:
         if "webp" in feature:
-            with pytest.warns(DeprecationWarning):
+            with pytest.warns(DeprecationWarning, match="webp"):
                 test(feature, features.version_feature)
         else:
             test(feature, features.version_feature)
 
 
 def test_webp_transparency() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="transp_webp"):
         assert (features.check("transp_webp") or False) == features.check_module("webp")
 
 
 def test_webp_mux() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="webp_mux"):
         assert (features.check("webp_mux") or False) == features.check_module("webp")
 
 
 def test_webp_anim() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="webp_anim"):
         assert (features.check("webp_anim") or False) == features.check_module("webp")
 
 
@@ -95,10 +95,9 @@ def test_check_codecs(feature: str) -> None:
 
 
 def test_check_warns_on_nonexistent() -> None:
-    with pytest.warns(UserWarning) as cm:
+    with pytest.warns(UserWarning, match="Unknown feature 'typo'."):
         has_feature = features.check("typo")
     assert has_feature is False
-    assert str(cm[-1].message) == "Unknown feature 'typo'."
 
 
 def test_supported_modules() -> None:
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index a5734c202a7..66410b3dad8 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -303,7 +303,7 @@ def test_apng_chunk_errors() -> None:
         assert isinstance(im, PngImagePlugin.PngImageFile)
         assert not im.is_animated
 
-    with pytest.warns(UserWarning):
+    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
         with Image.open("Tests/images/apng/chunk_multi_actl.png") as im:
             im.load()
         assert isinstance(im, PngImagePlugin.PngImageFile)
@@ -330,14 +330,14 @@ def test_apng_chunk_errors() -> None:
 
 
 def test_apng_syntax_errors() -> None:
-    with pytest.warns(UserWarning):
+    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
         with Image.open("Tests/images/apng/syntax_num_frames_zero.png") as im:
             assert isinstance(im, PngImagePlugin.PngImageFile)
             assert not im.is_animated
             with pytest.raises(OSError):
                 im.load()
 
-    with pytest.warns(UserWarning):
+    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
         with Image.open("Tests/images/apng/syntax_num_frames_zero_default.png") as im:
             assert isinstance(im, PngImagePlugin.PngImageFile)
             assert not im.is_animated
@@ -354,7 +354,7 @@ def test_apng_syntax_errors() -> None:
             im.seek(im.n_frames - 1)
             im.load()
 
-    with pytest.warns(UserWarning):
+    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
         with Image.open("Tests/images/apng/syntax_num_frames_invalid.png") as im:
             assert isinstance(im, PngImagePlugin.PngImageFile)
             assert not im.is_animated
diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index b2e586637fa..e42e1029161 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -77,8 +77,8 @@ class TestUnsupportedAvif:
     def test_unsupported(self, monkeypatch: pytest.MonkeyPatch) -> None:
         monkeypatch.setattr(AvifImagePlugin, "SUPPORTED", False)
 
-        with pytest.warns(UserWarning):
-            with pytest.raises(UnidentifiedImageError):
+        with pytest.raises(UnidentifiedImageError):
+            with pytest.warns(UserWarning, match="AVIF support not installed"):
                 with Image.open(TEST_AVIF_FILE):
                     pass
 
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 20d58a9dda4..29bc55ee55d 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1229,7 +1229,9 @@ def test_removed_transparency(tmp_path: Path) -> None:
         im.putpixel((x, 0), (x, 0, 0))
 
     im.info["transparency"] = (255, 255, 255)
-    with pytest.warns(UserWarning):
+    with pytest.warns(
+        UserWarning, match="Couldn't allocate palette entry for transparency"
+    ):
         im.save(out)
 
     with Image.open(out) as reloaded:
@@ -1251,7 +1253,7 @@ def test_rgb_transparency(tmp_path: Path) -> None:
     im = Image.new("RGB", (1, 1))
     im.info["transparency"] = b""
     ims = [Image.new("RGB", (1, 1))]
-    with pytest.warns(UserWarning):
+    with pytest.warns(UserWarning, match="should be converted to RGBA images"):
         im.save(out, save_all=True, append_images=ims)
 
     with Image.open(out) as reloaded:
diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index 2dabfd2f30a..8ff59161ff3 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -95,7 +95,9 @@ def test_sizes() -> None:
         for w, h, r in im.info["sizes"]:
             wr = w * r
             hr = h * r
-            with pytest.warns(DeprecationWarning):
+            with pytest.warns(
+                DeprecationWarning, match=r"Setting size to \(width, height, scale\)"
+            ):
                 im.size = (w, h, r)
             im.load()
             assert im.mode == "RGBA"
diff --git a/Tests/test_file_ico.py b/Tests/test_file_ico.py
index 5d2ace35e28..99c312ead92 100644
--- a/Tests/test_file_ico.py
+++ b/Tests/test_file_ico.py
@@ -233,7 +233,7 @@ def test_save_append_images(tmp_path: Path) -> None:
 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):
+    with pytest.warns(UserWarning, match="Image was not the expected size"):
         with Image.open("Tests/images/hopper_unexpected.ico") as im:
             assert im.size == (16, 16)
 
diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index c6c0c1aab9d..ffd3aad3e30 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -99,7 +99,7 @@ def test_i() -> None:
     c = b"a"
 
     # Act
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="IptcImagePlugin.i"):
         ret = IptcImagePlugin.i(c)
 
     # Assert
@@ -114,7 +114,7 @@ def test_dump(monkeypatch: pytest.MonkeyPatch) -> None:
     monkeypatch.setattr(sys, "stdout", mystdout)
 
     # Act
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="IptcImagePlugin.dump"):
         IptcImagePlugin.dump(c)
 
     # Assert
@@ -122,5 +122,5 @@ def test_dump(monkeypatch: pytest.MonkeyPatch) -> None:
 
 
 def test_pad_deprecation() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="IptcImagePlugin.PAD"):
         assert IptcImagePlugin.PAD == b"\0\0\0\0"
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 614044d97eb..0ba08aaf954 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -752,10 +752,11 @@ def test_bad_mpo_header(self) -> None:
 
         # Act
         # Shouldn't raise error
-        fn = "Tests/images/sugarshack_bad_mpo_header.jpg"
-        with pytest.warns(UserWarning, Image.open, fn) as im:
-            # Assert
-            assert im.format == "JPEG"
+        with pytest.warns(UserWarning, match="malformed MPO file"):
+            im = Image.open("Tests/images/sugarshack_bad_mpo_header.jpg")
+
+        # Assert
+        assert im.format == "JPEG"
 
     @pytest.mark.parametrize("mode", ("1", "L", "RGB", "RGBX", "CMYK", "YCbCr"))
     def test_save_correct_modes(self, mode: str) -> None:
@@ -1103,9 +1104,9 @@ def test_repr_jpeg_error_returns_none(self) -> None:
     def test_deprecation(self) -> None:
         with Image.open(TEST_FILE) as im:
             assert isinstance(im, JpegImagePlugin.JpegImageFile)
-            with pytest.warns(DeprecationWarning):
+            with pytest.warns(DeprecationWarning, match="huffman_ac"):
                 assert im.huffman_ac == {}
-            with pytest.warns(DeprecationWarning):
+            with pytest.warns(DeprecationWarning, match="huffman_dc"):
                 assert im.huffman_dc == {}
 
 
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 15f67385a2d..0a51fd49338 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -805,7 +805,7 @@ def test_deprecation(self, tmp_path: Path) -> None:
         test_file = tmp_path / "out.png"
 
         im = hopper("I")
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="Saving I mode images as PNG"):
             im.save(test_file)
 
         with Image.open(test_file) as reloaded:
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index 8b6ed3ed226..27ff4f1a4b8 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -190,7 +190,9 @@ def test_save_id_section(tmp_path: Path) -> None:
 
     # Save with custom id section greater than 255 characters
     id_section = b"Test content" * 25
-    with pytest.warns(UserWarning):
+    with pytest.warns(
+        UserWarning, match="id_section has been trimmed to 255 characters"
+    ):
         im.save(out, id_section=id_section)
 
     with Image.open(out) as test_im:
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index e92b97c8a5e..046a9f1f16e 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -221,7 +221,7 @@ def test_bad_exif(self) -> None:
             assert isinstance(im, JpegImagePlugin.JpegImageFile)
 
             # Should not raise struct.error.
-            with pytest.warns(UserWarning):
+            with pytest.warns(UserWarning, match="Corrupt EXIF data"):
                 im._getexif()
 
     def test_save_rgba(self, tmp_path: Path) -> None:
@@ -1014,7 +1014,7 @@ def test_timeout(self, monkeypatch: pytest.MonkeyPatch) -> None:
     @timeout_unless_slower_valgrind(2)
     def test_oom(self, test_file: str) -> None:
         with pytest.raises(UnidentifiedImageError):
-            with pytest.warns(UserWarning):
+            with pytest.warns(UserWarning, match="Corrupt EXIF data"):
                 with Image.open(test_file):
                     pass
 
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 88486834593..36ad8cee93b 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -300,7 +300,7 @@ def test_empty_metadata() -> None:
     head = f.read(8)
     info = TiffImagePlugin.ImageFileDirectory(head)
     # Should not raise struct.error.
-    with pytest.warns(UserWarning):
+    with pytest.warns(UserWarning, match="Corrupt EXIF data"):
         info.load(f)
 
 
@@ -481,7 +481,7 @@ def test_too_many_entries() -> None:
     ifd.tagtype[277] = TiffTags.SHORT
 
     # Should not raise ValueError.
-    with pytest.warns(UserWarning):
+    with pytest.warns(UserWarning, match="Metadata Warning"):
         assert ifd[277] == 4
 
 
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index f61e2c82ee5..916ea56fcb6 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -33,8 +33,8 @@ def test_unsupported(self, monkeypatch: pytest.MonkeyPatch) -> None:
             monkeypatch.setattr(WebPImagePlugin, "SUPPORTED", False)
 
         file_path = "Tests/images/hopper.webp"
-        with pytest.warns(UserWarning):
-            with pytest.raises(OSError):
+        with pytest.raises(OSError):
+            with pytest.warns(UserWarning, match="WEBP support not installed"):
                 with Image.open(file_path):
                     pass
 
diff --git a/Tests/test_image.py b/Tests/test_image.py
index b018b4309e9..069083b1963 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -53,7 +53,7 @@
 # Deprecation helper
 def helper_image_new(mode: str, size: tuple[int, int]) -> Image.Image:
     if mode.startswith("BGR;"):
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="BGR;"):
             return Image.new(mode, size)
     else:
         return Image.new(mode, size)
@@ -141,8 +141,8 @@ def test_open_verbose_failure(self, monkeypatch: pytest.MonkeyPatch) -> None:
         monkeypatch.setattr(Image, "WARN_POSSIBLE_FORMATS", True)
 
         im = io.BytesIO(b"")
-        with pytest.warns(UserWarning):
-            with pytest.raises(UnidentifiedImageError):
+        with pytest.raises(UnidentifiedImageError):
+            with pytest.warns(UserWarning, match="opening failed"):
                 with Image.open(im):
                     pass
 
@@ -1008,7 +1008,7 @@ def test_getxmp_padded(self) -> None:
 
     def test_get_child_images(self) -> None:
         im = Image.new("RGB", (1, 1))
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="Image.Image.get_child_images"):
             assert im.get_child_images() == []
 
     @pytest.mark.parametrize("size", ((1, 0), (0, 1), (0, 0)))
@@ -1139,7 +1139,7 @@ def test_close_graceful(self, caplog: pytest.LogCaptureFixture) -> None:
             assert im.fp is None
 
     def test_deprecation(self) -> None:
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="Image.isImageType"):
             assert not Image.isImageType(None)
 
 
@@ -1150,7 +1150,7 @@ def test_roundtrip_bytes_constructor(self, mode: str) -> None:
         source_bytes = im.tobytes()
 
         if mode.startswith("BGR;"):
-            with pytest.warns(DeprecationWarning):
+            with pytest.warns(DeprecationWarning, match=mode):
                 reloaded = Image.frombytes(mode, im.size, source_bytes)
         else:
             reloaded = Image.frombytes(mode, im.size, source_bytes)
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 14a5e2e7bfe..66412a03582 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -193,7 +193,7 @@ def test_basic(self, mode: str) -> None:
 
     @pytest.mark.parametrize("mode", ("BGR;15", "BGR;16", "BGR;24"))
     def test_deprecated(self, mode: str) -> None:
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="BGR;"):
             self.check(mode)
 
     def test_list(self) -> None:
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index 2c71dceb841..c27ce13d5be 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(DeprecationWarning):
+            with pytest.warns(DeprecationWarning, match="__array_interface__"):
                 numpy.array(im_truncated)
 
 
@@ -101,7 +101,7 @@ def __init__(self, arr_params: dict[str, Any]) -> None:
 
     with pytest.raises(ValueError):
         wrapped = Wrapper({"shape": (1, 1), "strides": (1, 1)})
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="'mode' parameter"):
             Image.fromarray(wrapped, "L")
 
 
@@ -111,7 +111,7 @@ def test_fromarray_palette() -> None:
     a = numpy.array(i)
 
     # Act
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="'mode' parameter"):
         out = Image.fromarray(a, "P")
 
     # Assert that the Python and C palettes match
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 7d4f78c2371..33f8444378d 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -203,7 +203,10 @@ def test_trns_RGB(tmp_path: Path) -> None:
     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)
+    with pytest.warns(
+        UserWarning, match="Couldn't allocate palette entry for transparency"
+    ):
+        im_p = im.convert("P", palette=Image.Palette.ADAPTIVE)
     assert "transparency" not in im_p.info
     im_p.save(f)
 
diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index fa58492fc76..7b5f7a5890f 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -11,9 +11,9 @@ def test_sanity() -> None:
     type_repr = repr(type(im.getim()))
     assert "PyCapsule" in type_repr
 
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="id property"):
         assert isinstance(im.im.id, int)
 
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="unsafe_ptrs property"):
         ptrs = dict(im.im.unsafe_ptrs)
     assert ptrs.keys() == {"image8", "image32", "image"}
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index 27cb7c59d89..34c1763b886 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -81,7 +81,7 @@ 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)]
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match=mode):
         im = Image.new(mode, (1, 2))
     im.putdata(data)
 
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index f062651f0c5..b6db0ab5c1b 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -54,7 +54,7 @@ def skip_missing() -> None:
 def test_sanity() -> None:
     # basic smoke test.
     # this mostly follows the cms_test outline.
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="PIL.ImageCms.versions"):
         v = ImageCms.versions()  # should return four strings
     assert v[0] == "1.0.0 pil"
     assert list(map(type, v)) == [str, str, str, str]
@@ -679,7 +679,7 @@ def test_auxiliary_channels_isolated() -> None:
 
 def test_long_modes() -> None:
     p = ImageCms.getOpenProfile("Tests/icc/sGrey-v2-nano.icc")
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="ABCDEFGHI"):
         ImageCms.buildTransform(p, p, "ABCDEFGHI", "ABCDEFGHI")
 
 
@@ -703,15 +703,15 @@ def test_cmyk_lab() -> None:
 
 
 def test_deprecation() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="ImageCms.DESCRIPTION"):
         assert ImageCms.DESCRIPTION.strip().startswith("pyCMS")
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="ImageCms.VERSION"):
         assert ImageCms.VERSION == "1.0.0 pil"
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="ImageCms.FLAGS"):
         assert isinstance(ImageCms.FLAGS, dict)
 
     profile = ImageCmsProfile(ImageCms.createProfile("sRGB"))
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="RGBA;16B"):
         ImageCms.ImageCmsTransform(profile, profile, "RGBA;16B", "RGB")
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="RGBA;16B"):
         ImageCms.ImageCmsTransform(profile, profile, "RGB", "RGBA;16B")
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 37669a2e55b..881f9c85dd2 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1735,5 +1735,5 @@ def test_incorrectly_ordered_coordinates(xy: tuple[int, int, int, int]) -> None:
 
 
 def test_getdraw() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="'hints' parameter"):
         ImageDraw.getdraw(None, [])
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 7622eea99dd..a9444c26d5b 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -152,7 +152,7 @@ def read(self, size: int | None = None) -> bytes:
         assert reads.count(im.decodermaxblock) == 1
 
     def test_raise_oserror(self) -> None:
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="raise_oserror"):
             with pytest.raises(OSError):
                 ImageFile.raise_oserror(1)
 
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 69533c2f840..aa8bbb3394d 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -1175,15 +1175,15 @@ def test_oom(test_file: str) -> None:
 
 def test_raqm_missing_warning(monkeypatch: pytest.MonkeyPatch) -> None:
     monkeypatch.setattr(ImageFont.core, "HAVE_RAQM", False)
-    with pytest.warns(UserWarning) as record:
+    with pytest.warns(
+        UserWarning,
+        match="Raqm layout was requested, but Raqm is not available. "
+        "Falling back to basic layout.",
+    ):
         font = ImageFont.truetype(
             FONT_PATH, FONT_SIZE, layout_engine=ImageFont.Layout.RAQM
         )
     assert font.layout_engine == ImageFont.Layout.BASIC
-    assert str(record[-1].message) == (
-        "Raqm layout was requested, but Raqm is not available. "
-        "Falling back to basic layout."
-    )
 
 
 @pytest.mark.parametrize("size", [-1, 0])
@@ -1202,5 +1202,5 @@ def fake_version_module(module: str) -> str:
     monkeypatch.setattr(features, "version_module", fake_version_module)
 
     # Act / Assert
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="FreeType 2.9.0"):
         ImageFont.truetype(FONT_PATH, FONT_SIZE)
diff --git a/Tests/test_imagemath_lambda_eval.py b/Tests/test_imagemath_lambda_eval.py
index 360325780bb..eec76118af0 100644
--- a/Tests/test_imagemath_lambda_eval.py
+++ b/Tests/test_imagemath_lambda_eval.py
@@ -56,7 +56,7 @@ def test_sanity() -> None:
 
 
 def test_options_deprecated() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="ImageMath.lambda_eval options"):
         assert ImageMath.lambda_eval(lambda args: 1, images) == 1
 
 
diff --git a/Tests/test_imagemath_unsafe_eval.py b/Tests/test_imagemath_unsafe_eval.py
index b7ac8469180..60ad6aafa49 100644
--- a/Tests/test_imagemath_unsafe_eval.py
+++ b/Tests/test_imagemath_unsafe_eval.py
@@ -36,12 +36,12 @@ def test_sanity() -> None:
 
 
 def test_eval_deprecated() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="ImageMath.eval"):
         assert ImageMath.eval("1") == 1
 
 
 def test_options_deprecated() -> None:
-    with pytest.warns(DeprecationWarning):
+    with pytest.warns(DeprecationWarning, match="ImageMath.unsafe_eval options"):
         assert ImageMath.unsafe_eval("1", images) == 1
 
 
diff --git a/Tests/test_lib_pack.py b/Tests/test_lib_pack.py
index b4a300d0c59..2d6af70eb78 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -362,13 +362,15 @@ def test_RGB(self) -> None:
         )
 
     def test_BGR(self) -> None:
-        with pytest.warns(DeprecationWarning):
+        with pytest.warns(DeprecationWarning, match="BGR;15"):
             self.assert_unpack(
                 "BGR;15", "BGR;15", 3, (8, 131, 0), (24, 0, 8), (41, 131, 8)
             )
+        with pytest.warns(DeprecationWarning, match="BGR;16"):
             self.assert_unpack(
                 "BGR;16", "BGR;16", 3, (8, 64, 0), (24, 129, 0), (41, 194, 0)
             )
+        with pytest.warns(DeprecationWarning, match="BGR;24"):
             self.assert_unpack("BGR;24", "BGR;24", 3, (1, 2, 3), (4, 5, 6), (7, 8, 9))
 
     def test_RGBA(self) -> None:

From a61a23d7ae054581db05d7eb94817685bc3ab3e4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Jun 2025 13:00:48 +1000
Subject: [PATCH 1814/2374] Fixed PT031

---
 Tests/test_file_apng.py | 45 ++++++++++++++++++++++-------------------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 66410b3dad8..12204b5b78c 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -303,11 +303,11 @@ def test_apng_chunk_errors() -> None:
         assert isinstance(im, PngImagePlugin.PngImageFile)
         assert not im.is_animated
 
-    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
-        with Image.open("Tests/images/apng/chunk_multi_actl.png") as im:
-            im.load()
-        assert isinstance(im, PngImagePlugin.PngImageFile)
-        assert not im.is_animated
+    with pytest.warns(UserWarning, match="Invalid APNG"):
+        im = Image.open("Tests/images/apng/chunk_multi_actl.png")
+    assert isinstance(im, PngImagePlugin.PngImageFile)
+    assert not im.is_animated
+    im.close()
 
     with Image.open("Tests/images/apng/chunk_actl_after_idat.png") as im:
         assert isinstance(im, PngImagePlugin.PngImageFile)
@@ -330,18 +330,20 @@ def test_apng_chunk_errors() -> None:
 
 
 def test_apng_syntax_errors() -> None:
-    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
-        with Image.open("Tests/images/apng/syntax_num_frames_zero.png") as im:
-            assert isinstance(im, PngImagePlugin.PngImageFile)
-            assert not im.is_animated
-            with pytest.raises(OSError):
-                im.load()
+    with pytest.warns(UserWarning, match="Invalid APNG"):
+        im = Image.open("Tests/images/apng/syntax_num_frames_zero.png")
+    assert isinstance(im, PngImagePlugin.PngImageFile)
+    assert not im.is_animated
+    with pytest.raises(OSError):
+        im.load()
+    im.close()
 
-    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
-        with Image.open("Tests/images/apng/syntax_num_frames_zero_default.png") as im:
-            assert isinstance(im, PngImagePlugin.PngImageFile)
-            assert not im.is_animated
-            im.load()
+    with pytest.warns(UserWarning, match="Invalid APNG"):
+        im = Image.open("Tests/images/apng/syntax_num_frames_zero_default.png")
+    assert isinstance(im, PngImagePlugin.PngImageFile)
+    assert not im.is_animated
+    im.load()
+    im.close()
 
     # we can handle this case gracefully
     with Image.open("Tests/images/apng/syntax_num_frames_low.png") as im:
@@ -354,11 +356,12 @@ def test_apng_syntax_errors() -> None:
             im.seek(im.n_frames - 1)
             im.load()
 
-    with pytest.warns(UserWarning, match="Invalid APNG"):  # noqa: PT031
-        with Image.open("Tests/images/apng/syntax_num_frames_invalid.png") as im:
-            assert isinstance(im, PngImagePlugin.PngImageFile)
-            assert not im.is_animated
-            im.load()
+    with pytest.warns(UserWarning, match="Invalid APNG"):
+        im = Image.open("Tests/images/apng/syntax_num_frames_invalid.png")
+    assert isinstance(im, PngImagePlugin.PngImageFile)
+    assert not im.is_animated
+    im.load()
+    im.close()
 
 
 @pytest.mark.parametrize(

From e783aff6885c8b5d92f819bd9a7bc1566f1b5318 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 27 Jun 2025 22:32:30 +1000
Subject: [PATCH 1815/2374] Improve SgiImagePlugin test coverage (#8896)

---
 Tests/test_file_sgi.py    | 18 ++++++++++++++++++
 src/PIL/SgiImagePlugin.py | 30 +++++++-----------------------
 2 files changed, 25 insertions(+), 23 deletions(-)

diff --git a/Tests/test_file_sgi.py b/Tests/test_file_sgi.py
index da0965fa14f..abf424dbf11 100644
--- a/Tests/test_file_sgi.py
+++ b/Tests/test_file_sgi.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from io import BytesIO
 from pathlib import Path
 
 import pytest
@@ -71,6 +72,15 @@ def test_invalid_file() -> None:
         SgiImagePlugin.SgiImageFile(invalid_file)
 
 
+def test_unsupported_image_mode() -> None:
+    with open("Tests/images/hopper.rgb", "rb") as fp:
+        data = fp.read()
+    data = data[:3] + b"\x03" + data[4:]
+    with pytest.raises(ValueError, match="Unsupported SGI image mode"):
+        with Image.open(BytesIO(data)):
+            pass
+
+
 def roundtrip(img: Image.Image, tmp_path: Path) -> None:
     out = tmp_path / "temp.sgi"
     img.save(out, format="sgi")
@@ -109,3 +119,11 @@ def test_unsupported_mode(tmp_path: Path) -> None:
 
     with pytest.raises(ValueError):
         im.save(out, format="sgi")
+
+
+def test_unsupported_number_of_bytes_per_pixel(tmp_path: Path) -> None:
+    im = hopper()
+    out = tmp_path / "temp.sgi"
+
+    with pytest.raises(ValueError, match="Unsupported number of bytes per pixel"):
+        im.save(out, bpc=3)
diff --git a/src/PIL/SgiImagePlugin.py b/src/PIL/SgiImagePlugin.py
index 44254b7a4b4..853022150ae 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -82,17 +82,10 @@ def _open(self) -> None:
         # zsize : channels count
         zsize = i16(s, 10)
 
-        # layout
-        layout = bpc, dimension, zsize
-
         # determine mode from bits/zsize
-        rawmode = ""
         try:
-            rawmode = MODES[layout]
+            rawmode = MODES[(bpc, dimension, zsize)]
         except KeyError:
-            pass
-
-        if rawmode == "":
             msg = "Unsupported SGI image mode"
             raise ValueError(msg)
 
@@ -156,24 +149,15 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     # Run-Length Encoding Compression - Unsupported at this time
     rle = 0
 
-    # Number of dimensions (x,y,z)
-    dim = 3
     # X Dimension = width / Y Dimension = height
     x, y = im.size
-    if im.mode == "L" and y == 1:
-        dim = 1
-    elif im.mode == "L":
-        dim = 2
     # Z Dimension: Number of channels
     z = len(im.mode)
-
-    if dim in {1, 2}:
-        z = 1
-
-    # assert we've got the right number of bands.
-    if len(im.getbands()) != z:
-        msg = f"incorrect number of bands in SGI write: {z} vs {len(im.getbands())}"
-        raise ValueError(msg)
+    # Number of dimensions (x,y,z)
+    if im.mode == "L":
+        dimension = 1 if y == 1 else 2
+    else:
+        dimension = 3
 
     # Minimum Byte value
     pinmin = 0
@@ -188,7 +172,7 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     fp.write(struct.pack(">h", magic_number))
     fp.write(o8(rle))
     fp.write(o8(bpc))
-    fp.write(struct.pack(">H", dim))
+    fp.write(struct.pack(">H", dimension))
     fp.write(struct.pack(">H", x))
     fp.write(struct.pack(">H", y))
     fp.write(struct.pack(">H", z))

From 958c449b988e49aa88a412990bebdb799a97a39f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 27 Jun 2025 16:17:20 +0300
Subject: [PATCH 1816/2374] Close image after assert

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

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index c0e6b467ec6..6dab418bfda 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -752,6 +752,8 @@ def test_bad_mpo_header(self) -> None:
         # Assert
         assert im.format == "JPEG"
 
+        im.close()
+
     @pytest.mark.parametrize("mode", ("1", "L", "RGB", "RGBX", "CMYK", "YCbCr"))
     def test_save_correct_modes(self, mode: str) -> None:
         out = BytesIO()

From ef98b3510e3e4f14b547762764813d7e5ca3c5a4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 00:29:58 +1000
Subject: [PATCH 1817/2374] Fix buffer overflow when saving compressed DDS
 images (#9041)

Co-authored-by: Eric Soroos <eric-github@soroos.net>
---
 Tests/test_file_dds.py     | 17 +++++++++++++++++
 src/libImaging/BcnEncode.c |  4 ++++
 2 files changed, 21 insertions(+)

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 3388fce164e..5c7a943b1b7 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -511,3 +511,20 @@ def test_save_dx10_bc5(tmp_path: Path) -> None:
     im = hopper("L")
     with pytest.raises(OSError, match="only RGB mode can be written as BC5"):
         im.save(out, pixel_format="BC5")
+
+
+@pytest.mark.parametrize(
+    "pixel_format, mode",
+    (
+        ("DXT1", "RGBA"),
+        ("DXT3", "RGBA"),
+        ("DXT5", "RGBA"),
+        ("BC2", "RGBA"),
+        ("BC3", "RGBA"),
+        ("BC5", "RGB"),
+    ),
+)
+def test_save_large_file(tmp_path: Path, pixel_format: str, mode: str) -> None:
+    im = hopper(mode).resize((440, 440))
+    # should not error in valgrind
+    im.save(tmp_path / "img.dds", pixel_format=pixel_format)
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 2bad73b9261..7a5072ddee6 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -258,6 +258,10 @@ ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
     UINT8 *dst = buf;
 
     for (;;) {
+        // Loop writes a max of 16 bytes per iteration
+        if (dst + 16 >= bytes + buf) {
+            break;
+        }
         if (n == 5) {
             encode_bc3_alpha(im, state, dst, 0);
             dst += 8;

From d07aa6fd17d356b8f09f89a5c485fc8b1532635f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 00:30:22 +1000
Subject: [PATCH 1818/2374] Added release notes for #9041 (#9042)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/11.3.0.rst | 38 +++++++++++-------------------------
 1 file changed, 11 insertions(+), 27 deletions(-)

diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index 654a7e6b6f1..2d35d8228fc 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -4,21 +4,21 @@
 Security
 ========
 
-TODO
-^^^^
+:cve:`2025-48379`: Write buffer overflow on BCn encoding
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+There is a heap buffer overflow when writing a sufficiently large (>64k encoded with
+default settings) image in the DDS format due to writing into a buffer without checking
+for available space.
 
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
+This only affects users who save untrusted data as a compressed DDS image.
 
-TODO
+* Unclear how large the potential write could be. It is likely limited by process
+  segfault, so it's not necessarily deterministic. It may be practically unbounded.
+* Unclear if there's a restriction on the bytes that could be emitted. It's likely that
+  the only restriction is that the bytes would be emitted in chunks of 8 or 16.
 
-Backwards incompatible changes
-==============================
-
-TODO
-^^^^
+This was introduced in Pillow 11.2.0 when the feature was added.
 
 Deprecations
 ============
@@ -41,22 +41,6 @@ another mode before saving::
     im = Image.new("I", (1, 1))
     im.convert("I;16").save("out.png")
 
-API changes
-===========
-
-TODO
-^^^^
-
-TODO
-
-API additions
-=============
-
-TODO
-^^^^
-
-TODO
-
 Other changes
 =============
 

From 41129ce1cb88ae6f7733b40f3f6a9f1a5662d2af Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 01:20:02 +1000
Subject: [PATCH 1819/2374] Use list

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

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index adfa61962b7..840202214a3 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -294,7 +294,7 @@ def test_save_all() -> None:
 
     im = Image.new("RGB", (1, 1))
     for colors in (("#f00",), ("#f00", "#0f0")):
-        append_images = (Image.new("RGB", (1, 1), color) for color in colors)
+        append_images = [Image.new("RGB", (1, 1), color) for color in colors]
         im_reloaded = roundtrip(im, save_all=True, append_images=append_images)
 
         assert_image_equal(im, im_reloaded)

From 69c0c422c86b1b1a8a7f5fca5e2f464cadfcf7f2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 10:29:01 +1000
Subject: [PATCH 1820/2374] Increase pytest verbosity (#9040)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .ci/test.cmd                      | 2 +-
 .ci/test.sh                       | 2 +-
 .github/workflows/wheels-test.ps1 | 4 ++--
 .github/workflows/wheels-test.sh  | 4 ++--
 winbuild/README.md                | 2 +-
 winbuild/build.rst                | 2 +-
 6 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.ci/test.cmd b/.ci/test.cmd
index aafc9290c80..acfac3d1acd 100644
--- a/.ci/test.cmd
+++ b/.ci/test.cmd
@@ -1,3 +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
+python.exe -bb -m pytest -vv -x -W always --cov PIL --cov Tests --cov-report term --cov-report xml Tests
diff --git a/.ci/test.sh b/.ci/test.sh
index 3f0ddc350a9..87a605d84be 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 --cov-report xml Tests $REVERSE
+python3 -bb -m pytest -vv -x -W always --cov PIL --cov Tests --cov-report term --cov-report xml Tests $REVERSE
diff --git a/.github/workflows/wheels-test.ps1 b/.github/workflows/wheels-test.ps1
index 54e7fbbfc30..9f5561c46d4 100644
--- a/.github/workflows/wheels-test.ps1
+++ b/.github/workflows/wheels-test.ps1
@@ -23,7 +23,7 @@ cd $pillow
 if (!$?) { exit $LASTEXITCODE }
 & $venv\Scripts\$python selftest.py
 if (!$?) { exit $LASTEXITCODE }
-& $venv\Scripts\$python -m pytest -vx Tests\check_wheel.py
+& $venv\Scripts\$python -m pytest -vv -x Tests\check_wheel.py
 if (!$?) { exit $LASTEXITCODE }
-& $venv\Scripts\$python -m pytest -vx Tests
+& $venv\Scripts\$python -m pytest -vv -x Tests
 if (!$?) { exit $LASTEXITCODE }
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index ce83a4278cd..94dbb46791e 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -35,5 +35,5 @@ fi
 
 # Runs tests
 python3 selftest.py
-python3 -m pytest Tests/check_wheel.py
-python3 -m pytest
+python3 -m pytest -vv -x Tests/check_wheel.py
+python3 -m pytest -vv -x
diff --git a/winbuild/README.md b/winbuild/README.md
index 0d3ec8d8aa4..62345af60bc 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -24,6 +24,6 @@ cd ..
 %PYTHON%\python.exe -m pip install -v -C raqm=vendor -C fribidi=vendor .
 path C:\Pillow\winbuild\build\bin;%PATH%
 %PYTHON%\python.exe selftest.py
-%PYTHON%\python.exe -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests
+%PYTHON%\python.exe -m pytest -vv -x --cov PIL --cov Tests --cov-report term --cov-report xml Tests
 %PYTHON%\python.exe -m pip wheel -v -C raqm=vendor -C fribidi=vendor .
 ```
diff --git a/winbuild/build.rst b/winbuild/build.rst
index 3c20c7d179f..aa4677ad595 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -124,5 +124,5 @@ Here's an example script to build on Windows::
     %PYTHON%\python.exe -m pip install -v -C raqm=vendor -C fribidi=vendor .
     path C:\Pillow\winbuild\build\bin;%PATH%
     %PYTHON%\python.exe selftest.py
-    %PYTHON%\python.exe -m pytest -vx --cov PIL --cov Tests --cov-report term --cov-report xml Tests
+    %PYTHON%\python.exe -m pytest -vv -x --cov PIL --cov Tests --cov-report term --cov-report xml Tests
     %PYTHON%\python.exe -m pip wheel -v -C raqm=vendor -C fribidi=vendor .

From 5732a86cc6f8aad4a28a92b7c7c78748000c8d1d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 10:52:25 +1000
Subject: [PATCH 1821/2374] Use snake case

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

diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index f96f658fcdb..784b6f2089b 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -46,12 +46,10 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
     mpf_offset = 28
     offsets: list[int] = []
-    total = 0
-    imSequences = [im] + list(append_images)
-    for imSequence in imSequences:
-        total += getattr(imSequence, "n_frames", 1)
-    for imSequence in imSequences:
-        for im_frame in ImageSequence.Iterator(imSequence):
+    im_sequences = [im, *append_images]
+    total = sum(getattr(seq, "n_frames", 1) for seq in im_sequences)
+    for im_sequence in im_sequences:
+        for im_frame in ImageSequence.Iterator(im_sequence):
             if not offsets:
                 # APP2 marker
                 ifd_length = 66 + 16 * total

From ed82f4d235eb6a739699e8485748204818393442 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 10:57:23 +1000
Subject: [PATCH 1822/2374] Use unpacking

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

diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index 484797f912c..c33809ced89 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -308,7 +308,7 @@ def unsafe_eval(
 
     # build execution namespace
     args: dict[str, Any] = ops.copy()
-    for k in list(options.keys()) + list(kw.keys()):
+    for k in [*options, *kw]:
         if "__" in k or hasattr(builtins, k):
             msg = f"'{k}' not allowed"
             raise ValueError(msg)
diff --git a/src/PIL/McIdasImagePlugin.py b/src/PIL/McIdasImagePlugin.py
index b4460a9a51f..4c34dd7e542 100644
--- a/src/PIL/McIdasImagePlugin.py
+++ b/src/PIL/McIdasImagePlugin.py
@@ -44,7 +44,7 @@ def _open(self) -> None:
             raise SyntaxError(msg)
 
         self.area_descriptor_raw = s
-        self.area_descriptor = w = [0] + list(struct.unpack("!64i", s))
+        self.area_descriptor = w = [0, *struct.unpack("!64i", s)]
 
         # get mode
         if w[11] == 1:

From 4ac24035320cb213d1f0175f9b0e53fcab6d3445 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 15:48:44 +1000
Subject: [PATCH 1823/2374] Read 16-bit images into I;16B mode to allow for
 memory mapping

---
 .../cmx3g8_wv_1998.260_0745_mcidas.tiff       | Bin 2880134 -> 1440122 bytes
 Tests/test_file_mcidas.py                     |   2 +-
 src/PIL/McIdasImagePlugin.py                  |   4 +---
 3 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/Tests/images/cmx3g8_wv_1998.260_0745_mcidas.tiff b/Tests/images/cmx3g8_wv_1998.260_0745_mcidas.tiff
index b72509cc4b3c57c901fb02c24c2b201e94d99fa3..2ebb287e26d6901319b9a05900212b9a65536ce7 100644
GIT binary patch
literal 1440122
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%0D<ynI{C>Zo@}6W>k|Mg*(s&HqJQQBdm@XCpqm8
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%0A@LyZ-@
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

literal 2880134
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%0Ae`LX{L@;Kj9
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

diff --git a/Tests/test_file_mcidas.py b/Tests/test_file_mcidas.py
index e11e6bb5284..7e236028d18 100644
--- a/Tests/test_file_mcidas.py
+++ b/Tests/test_file_mcidas.py
@@ -27,6 +27,6 @@ def test_valid_file() -> None:
 
         # Assert
         assert im.format == "MCIDAS"
-        assert im.mode == "I"
+        assert im.mode == "I;16B"
         assert im.size == (1800, 400)
         assert_image_equal_tofile(im, saved_file)
diff --git a/src/PIL/McIdasImagePlugin.py b/src/PIL/McIdasImagePlugin.py
index b4460a9a51f..a1214ad5047 100644
--- a/src/PIL/McIdasImagePlugin.py
+++ b/src/PIL/McIdasImagePlugin.py
@@ -50,9 +50,7 @@ def _open(self) -> None:
         if w[11] == 1:
             mode = rawmode = "L"
         elif w[11] == 2:
-            # FIXME: add memory map support
-            mode = "I"
-            rawmode = "I;16B"
+            mode = rawmode = "I;16B"
         elif w[11] == 4:
             # FIXME: add memory map support
             mode = "I"

From d4162f85056223098fef0ba3f87e58519ba2955f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Jun 2025 18:27:49 +1000
Subject: [PATCH 1824/2374] Updated return type

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

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 682fc7361a5..6c9c541f126 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -316,7 +316,7 @@ def test_save_xmp() -> None:
     im = Image.new("RGB", (1, 1))
     im2 = Image.new("RGB", (1, 1), "#f00")
 
-    def roundtrip_xmp():
+    def roundtrip_xmp() -> list[Any]:
         im_reloaded = roundtrip(im, xmp=b"Default", save_all=True, append_images=[im2])
         xmp = [im_reloaded.info["xmp"]]
         im_reloaded.seek(1)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 7b1b575a0ff..9fc1c70671b 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2600,7 +2600,7 @@ def save(
         if open_fp:
             fp.close()
 
-    def _attach_default_encoderinfo(self, im: Image) -> Any:
+    def _attach_default_encoderinfo(self, im: Image) -> dict[str, Any]:
         encoderinfo = getattr(self, "encoderinfo", {})
         self.encoderinfo = {**im._default_encoderinfo, **encoderinfo}
         return encoderinfo

From be2b4e78644fdc85e63f08a22514e4d32072439f Mon Sep 17 00:00:00 2001
From: Kylian Ronfleux--Corail <35237015+Kyliroco@users.noreply.github.com>
Date: Mon, 30 Jun 2025 12:46:40 +0200
Subject: [PATCH 1825/2374] Fix qtables and quality scaling (#8879)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_jpeg.py              | 18 ++++++++++++++++++
 docs/handbook/image-file-formats.rst |  7 +++++++
 src/libImaging/JpegEncode.c          | 15 +++++++++++----
 3 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 6dab418bfda..5afae041287 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -611,6 +611,24 @@ def _n_qtables_helper(n: int, test_file: str) -> None:
                     None
                 )
             ]
+
+            for quality in range(101):
+                qtable_from_qtable_quality = self.roundtrip(
+                    im,
+                    qtables={0: standard_l_qtable, 1: standard_chrominance_qtable},
+                    quality=quality,
+                ).quantization
+
+                qtable_from_quality = self.roundtrip(im, quality=quality).quantization
+
+                if features.check_feature("libjpeg_turbo"):
+                    assert qtable_from_qtable_quality == qtable_from_quality
+                else:
+                    assert qtable_from_qtable_quality[0] == qtable_from_quality[0]
+                    assert (
+                        qtable_from_qtable_quality[1][1:] == qtable_from_quality[1][1:]
+                    )
+
             # list of qtable lists
             assert_image_similar(
                 im,
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 83df2bd5c4f..03ee96c0f00 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -557,6 +557,8 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
     hardly any gain in image quality. The value ``keep`` is only valid for JPEG
     files and will retain the original image quality level, subsampling, and
     qtables.
+    For more information on how qtables are modified based on the quality parameter,
+    see the qtables section.
 
 **optimize**
     If present and true, indicates that the encoder should make an extra pass
@@ -622,6 +624,11 @@ The :py:meth:`~PIL.Image.Image.save` method supports the following options:
        range(len(keys))) of lists of 64 integers. There must be
        between 2 and 4 tables.
 
+    If a quality parameter is provided, the qtables will be adjusted accordingly.
+    By default, the qtables are based on a standard JPEG table with a quality of 50.
+    The qtable values will be reduced if the quality is higher than 50 and increased
+    if the quality is lower than 50.
+
     .. versionadded:: 2.5.0
 
 **streamtype**
diff --git a/src/libImaging/JpegEncode.c b/src/libImaging/JpegEncode.c
index 79a38e12fb3..972435ee117 100644
--- a/src/libImaging/JpegEncode.c
+++ b/src/libImaging/JpegEncode.c
@@ -175,18 +175,21 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
             /* Use custom quantization tables */
             if (context->qtables) {
                 int i;
-                int quality = 100;
+                int quality = 50;
                 int last_q = 0;
+                boolean force_baseline = FALSE;
                 if (context->quality != -1) {
                     quality = context->quality;
+                    force_baseline = TRUE;
                 }
+                int scale_factor = jpeg_quality_scaling(quality);
                 for (i = 0; i < context->qtablesLen; i++) {
                     jpeg_add_quant_table(
                         &context->cinfo,
                         i,
                         &context->qtables[i * DCTSIZE2],
-                        quality,
-                        FALSE
+                        scale_factor,
+                        force_baseline
                     );
                     context->cinfo.comp_info[i].quant_tbl_no = i;
                     last_q = i;
@@ -195,7 +198,11 @@ 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],
+                        scale_factor,
+                        force_baseline
                     );
                 }
                 for (i = last_q; i < context->cinfo.num_components; i++) {

From da10ed1cf3c4123a98a2f765d3beaf830d47d113 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Mon, 30 Jun 2025 21:46:07 +1000
Subject: [PATCH 1826/2374] Add support for iOS (#9030)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/wheels-dependencies.sh      | 207 ++++++++++++++----
 .github/workflows/wheels-test.ps1             |   5 +-
 .github/workflows/wheels-test.sh              |   4 +-
 .github/workflows/wheels.yml                  |  23 +-
 .pre-commit-config.yaml                       |   6 +-
 MANIFEST.in                                   |   2 +
 Tests/oss-fuzz/test_fuzzers.py                |   5 +-
 Tests/test_main.py                            |   1 +
 Tests/test_pyroma.py                          |   4 +-
 {Tests => checks}/32bit_segfault_check.py     |   0
 {Tests => checks}/check_fli_oob.py            |   0
 {Tests => checks}/check_fli_overflow.py       |   0
 {Tests => checks}/check_icns_dos.py           |   0
 {Tests => checks}/check_imaging_leaks.py      |   0
 {Tests => checks}/check_j2k_dos.py            |   0
 {Tests => checks}/check_j2k_leaks.py          |   0
 {Tests => checks}/check_j2k_overflow.py       |   0
 {Tests => checks}/check_jp2_overflow.py       |   0
 {Tests => checks}/check_jpeg_leaks.py         |   0
 {Tests => checks}/check_large_memory.py       |   0
 {Tests => checks}/check_large_memory_numpy.py |   0
 {Tests => checks}/check_libtiff_segfault.py   |   0
 {Tests => checks}/check_png_dos.py            |   0
 {Tests => checks}/check_release_notes.py      |   0
 {Tests => checks}/check_wheel.py              |  12 +-
 docs/releasenotes/11.3.0.rst                  |   8 +-
 patches/README.md                             |  14 ++
 patches/iOS/brotli-1.1.0.tar.gz.patch         |  46 ++++
 patches/iOS/libwebp-1.5.0.tar.gz.patch        |  42 ++++
 pyproject.toml                                |  46 +++-
 setup.py                                      |  39 ++++
 31 files changed, 406 insertions(+), 58 deletions(-)
 rename {Tests => checks}/32bit_segfault_check.py (100%)
 rename {Tests => checks}/check_fli_oob.py (100%)
 rename {Tests => checks}/check_fli_overflow.py (100%)
 rename {Tests => checks}/check_icns_dos.py (100%)
 rename {Tests => checks}/check_imaging_leaks.py (100%)
 rename {Tests => checks}/check_j2k_dos.py (100%)
 rename {Tests => checks}/check_j2k_leaks.py (100%)
 rename {Tests => checks}/check_j2k_overflow.py (100%)
 rename {Tests => checks}/check_jp2_overflow.py (100%)
 rename {Tests => checks}/check_jpeg_leaks.py (100%)
 rename {Tests => checks}/check_large_memory.py (100%)
 rename {Tests => checks}/check_large_memory_numpy.py (100%)
 rename {Tests => checks}/check_libtiff_segfault.py (100%)
 rename {Tests => checks}/check_png_dos.py (100%)
 rename {Tests => checks}/check_release_notes.py (100%)
 rename {Tests => checks}/check_wheel.py (75%)
 create mode 100644 patches/README.md
 create mode 100644 patches/iOS/brotli-1.1.0.tar.gz.patch
 create mode 100644 patches/iOS/libwebp-1.5.0.tar.gz.patch

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 5384a74c0cd..d761d93b62c 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -1,42 +1,98 @@
 #!/bin/bash
 
-# Setup that needs to be done before multibuild utils are invoked
-PROJECTDIR=$(pwd)
-if [[ "$(uname -s)" == "Darwin" ]]; then
-    # Safety check - macOS builds require that CIBW_ARCHS is set, and that it
-    # only contains a single value (even though cibuildwheel allows multiple
-    # values in CIBW_ARCHS).
+# Safety check - Pillow builds require that CIBW_ARCHS is set, and that it only
+# contains a single value (even though cibuildwheel allows multiple values in
+# CIBW_ARCHS). This check doesn't work on Linux because of how the CIBW_ARCHS
+# variable is exposed.
+function check_cibw_archs {
     if [[ -z "$CIBW_ARCHS" ]]; then
-        echo "ERROR: Pillow macOS builds require CIBW_ARCHS be defined."
+        echo "ERROR: Pillow builds require CIBW_ARCHS be defined."
         exit 1
     fi
     if [[ "$CIBW_ARCHS" == *" "* ]]; then
-        echo "ERROR: Pillow macOS builds only support a single architecture in CIBW_ARCHS."
+        echo "ERROR: Pillow builds only support a single architecture in CIBW_ARCHS."
         exit 1
     fi
+}
+
+# Setup that needs to be done before multibuild utils are invoked. Process
+# potential cross-build platforms before native platforms to ensure that we pick
+# up the cross environment.
+PROJECTDIR=$(pwd)
+if [[ "$CIBW_PLATFORM" == "ios" ]]; then
+    check_cibw_archs
+    # On iOS, CIBW_ARCHS is actually a multi-arch - arm64_iphoneos,
+    # arm64_iphonesimulator or x86_64_iphonesimulator. Split into the CPU
+    # platform, and the iOS SDK.
+    PLAT=$(echo $CIBW_ARCHS | sed "s/\(.*\)_\(.*\)/\1/")
+    IOS_SDK=$(echo $CIBW_ARCHS | sed "s/\(.*\)_\(.*\)/\2/")
+
+    # Build iOS builds in `build/iphoneos` or `build/iphonesimulator`
+    # (depending on the build target). Install them into `build/deps/iphoneos`
+    # or `build/deps/iphonesimulator`
+    WORKDIR=$(pwd)/build/$IOS_SDK
+    BUILD_PREFIX=$(pwd)/build/deps/$IOS_SDK
+    PATCH_DIR=$(pwd)/patches/iOS
+
+    # GNU tooling insists on using aarch64 rather than arm64
+    if [[ $PLAT == "arm64" ]]; then
+        GNU_ARCH=aarch64
+    else
+        GNU_ARCH=x86_64
+    fi
+
+    IOS_SDK_PATH=$(xcrun --sdk $IOS_SDK --show-sdk-path)
+    CMAKE_SYSTEM_NAME=iOS
+    IOS_HOST_TRIPLE=$PLAT-apple-ios$IPHONEOS_DEPLOYMENT_TARGET
+    if [[ "$IOS_SDK" == "iphonesimulator" ]]; then
+        IOS_HOST_TRIPLE=$IOS_HOST_TRIPLE-simulator
+    fi
 
+    # GNU Autotools doesn't recognize the existence of arm64-apple-ios-simulator
+    # as a valid host. However, the only difference between arm64-apple-ios and
+    # arm64-apple-ios-simulator is the choice of sysroot, and that is
+    # coordinated by CC, CFLAGS etc. From the perspective of configure, the two
+    # platforms are identical, so we can use arm64-apple-ios consistently.
+    # This (mostly) avoids us needing to patch config.sub in dependency sources.
+    HOST_CONFIGURE_FLAGS="--disable-shared --enable-static --host=$GNU_ARCH-apple-ios --build=$GNU_ARCH-apple-darwin"
+
+    # CMake has native support for iOS. However, most of that support is based
+    # on using the Xcode builder, which isn't very helpful for most of Pillow's
+    # dependencies. Therefore, we lean on the OSX configurations, plus CC, CFLAGS
+    # etc. to ensure the right sysroot is selected.
+    HOST_CMAKE_FLAGS="-DCMAKE_SYSTEM_NAME=$CMAKE_SYSTEM_NAME -DCMAKE_SYSTEM_PROCESSOR=$GNU_ARCH -DCMAKE_OSX_DEPLOYMENT_TARGET=$IPHONEOS_DEPLOYMENT_TARGET -DCMAKE_OSX_SYSROOT=$IOS_SDK_PATH -DBUILD_SHARED_LIBS=NO"
+
+    # Meson needs to be pointed at a cross-platform configuration file
+    # This will be generated once CC etc. have been evaluated.
+    HOST_MESON_FLAGS="--cross-file $WORKDIR/meson-cross.txt -Dprefer_static=true -Ddefault_library=static"
+
+elif [[ "$(uname -s)" == "Darwin" ]]; then
+    check_cibw_archs
     # Build macOS dependencies in `build/darwin`
     # Install them into `build/deps/darwin`
+    PLAT=$CIBW_ARCHS
     WORKDIR=$(pwd)/build/darwin
     BUILD_PREFIX=$(pwd)/build/deps/darwin
 else
     # Build prefix will default to /usr/local
+    PLAT="${CIBW_ARCHS:-$AUDITWHEEL_ARCH}"
     WORKDIR=$(pwd)/build
     MB_ML_LIBC=${AUDITWHEEL_POLICY::9}
     MB_ML_VER=${AUDITWHEEL_POLICY:9}
 fi
-PLAT="${CIBW_ARCHS:-$AUDITWHEEL_ARCH}"
 
 # Define custom utilities
 source wheels/multibuild/common_utils.sh
 source wheels/multibuild/library_builders.sh
-if [ -z "$IS_MACOS" ]; then
+if [[ -z "$IS_MACOS" ]]; then
     source wheels/multibuild/manylinux_utils.sh
 fi
 
 ARCHIVE_SDIR=pillow-depends-main
 
-# Package versions for fresh source builds
+# Package versions for fresh source builds. Version numbers with "Patched"
+# annotations have a source code patch that is required for some platforms. If
+# you change those versions, ensure the patch is also updated.
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=11.2.1
 LIBPNG_VERSION=1.6.49
@@ -47,32 +103,58 @@ TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_VERSION=1.3.1
 ZLIB_NG_VERSION=2.2.4
-LIBWEBP_VERSION=1.5.0
+LIBWEBP_VERSION=1.5.0  # Patched; next release won't need patching. See patch file.
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
-BROTLI_VERSION=1.1.0
+BROTLI_VERSION=1.1.0  # Patched; next release won't need patching. See patch file.
 LIBAVIF_VERSION=1.3.0
 
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
-    # This essentially duplicates the Homebrew recipe
-    CFLAGS="$CFLAGS -Wno-int-conversion" build_simple pkg-config 0.29.2 https://pkg-config.freedesktop.org/releases tar.gz \
+    # This essentially duplicates the Homebrew recipe.
+    # On iOS, we need a binary that can be executed on the build machine; but we
+    # can create a host-specific pc-path to store iOS .pc files. To ensure a
+    # macOS-compatible build, we temporarily clear environment flags that set
+    # iOS-specific values.
+    if [[ -n "$IOS_SDK" ]]; then
+        ORIGINAL_HOST_CONFIGURE_FLAGS=$HOST_CONFIGURE_FLAGS
+        ORIGINAL_IPHONEOS_DEPLOYMENT_TARGET=$IPHONEOS_DEPLOYMENT_TARGET
+        unset HOST_CONFIGURE_FLAGS
+        unset IPHONEOS_DEPLOYMENT_TARGET
+    fi
+
+    CFLAGS="$CFLAGS -Wno-int-conversion" CPPFLAGS="" build_simple pkg-config 0.29.2 https://pkg-config.freedesktop.org/releases tar.gz \
         --disable-debug --disable-host-tool --with-internal-glib \
         --with-pc-path=$BUILD_PREFIX/share/pkgconfig:$BUILD_PREFIX/lib/pkgconfig \
         --with-system-include-path=$(xcrun --show-sdk-path --sdk macosx)/usr/include
+
+    if [[ -n "$IOS_SDK" ]]; then
+        HOST_CONFIGURE_FLAGS=$ORIGINAL_HOST_CONFIGURE_FLAGS
+        IPHONEOS_DEPLOYMENT_TARGET=$ORIGINAL_IPHONEOS_DEPLOYMENT_TARGET
+    fi;
+
     export PKG_CONFIG=$BUILD_PREFIX/bin/pkg-config
     touch pkg-config-stamp
 }
 
 function build_zlib_ng {
     if [ -e zlib-stamp ]; then return; fi
+    # zlib-ng uses a "configure" script, but it's not a GNU autotools script, so
+    # it doesn't honor the usual flags. Temporarily disable any
+    # cross-compilation flags.
+    ORIGINAL_HOST_CONFIGURE_FLAGS=$HOST_CONFIGURE_FLAGS
+    unset HOST_CONFIGURE_FLAGS
+
     build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --zlib-compat
 
-    if [ -n "$IS_MACOS" ]; then
+    HOST_CONFIGURE_FLAGS=$ORIGINAL_HOST_CONFIGURE_FLAGS
+
+    if [[ -n "$IS_MACOS" ]] && [[ -z "$IOS_SDK" ]]; then
         # Ensure that on macOS, the library name is an absolute path, not an
         # @rpath, so that delocate picks up the right library (and doesn't need
         # DYLD_LIBRARY_PATH to be set). The default Makefile doesn't have an
-        # option to control the install_name.
+        # option to control the install_name. This isn't needed on iOS, as iOS
+        # only builds the static library.
         install_name_tool -id $BUILD_PREFIX/lib/libz.1.dylib $BUILD_PREFIX/lib/libz.1.dylib
     fi
     touch zlib-stamp
@@ -82,7 +164,7 @@ function build_brotli {
     if [ -e brotli-stamp ]; then return; fi
     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_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib . \
+        && cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib $HOST_CMAKE_FLAGS . \
         && make install)
     touch brotli-stamp
 }
@@ -93,7 +175,7 @@ function build_harfbuzz {
 
     local out_dir=$(fetch_unpack https://github.com/harfbuzz/harfbuzz/releases/download/$HARFBUZZ_VERSION/harfbuzz-$HARFBUZZ_VERSION.tar.xz harfbuzz-$HARFBUZZ_VERSION.tar.xz)
     (cd $out_dir \
-        && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=minsize -Dfreetype=enabled -Dglib=disabled -Dtests=disabled)
+        && meson setup build --prefix=$BUILD_PREFIX --libdir=$BUILD_PREFIX/lib --buildtype=minsize -Dfreetype=enabled -Dglib=disabled -Dtests=disabled $HOST_MESON_FLAGS)
     (cd $out_dir/build \
         && meson install)
     touch harfbuzz-stamp
@@ -164,19 +246,19 @@ function build {
     fi
 
     build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
-    if [ -n "$IS_MACOS" ]; then
+    if [[ -n "$IS_MACOS" ]]; then
         build_simple xorgproto 2024.1 https://www.x.org/pub/individual/proto
         build_simple libXau 1.0.12 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
     else
-        sed s/\${pc_sysrootdir\}// $BUILD_PREFIX/share/pkgconfig/xcb-proto.pc > $BUILD_PREFIX/lib/pkgconfig/xcb-proto.pc
+        sed "s/\${pc_sysrootdir\}//" $BUILD_PREFIX/share/pkgconfig/xcb-proto.pc > $BUILD_PREFIX/lib/pkgconfig/xcb-proto.pc
     fi
     build_simple libxcb $LIBXCB_VERSION https://www.x.org/releases/individual/lib
 
     build_libjpeg_turbo
-    if [ -n "$IS_MACOS" ]; then
+    if [[ -n "$IS_MACOS" ]]; then
         # Custom tiff build to include jpeg; by default, configure won't include
-        # headers/libs in the custom macOS prefix. Explicitly disable webp,
+        # headers/libs in the custom macOS/iOS prefix. Explicitly disable webp,
         # libdeflate and zstd, because on x86_64 macs, it will pick up the
         # Homebrew versions of those libraries from /usr/local.
         build_simple tiff $TIFF_VERSION https://download.osgeo.org/libtiff tar.gz \
@@ -186,7 +268,10 @@ function build {
         build_tiff
     fi
 
-    build_libavif
+    if [[ -z "$IOS_SDK" ]]; then
+        # Short term workaround; don't build libavif on iOS
+        build_libavif
+    fi
     build_libpng
     build_lcms2
     build_openjpeg
@@ -201,14 +286,44 @@ function build {
 
     build_brotli
 
-    if [ -n "$IS_MACOS" ]; then
+    if [[ -n "$IS_MACOS" ]]; then
         # Custom freetype build
         build_simple freetype $FREETYPE_VERSION https://download.savannah.gnu.org/releases/freetype tar.gz --with-harfbuzz=no
     else
         build_freetype
     fi
 
-    build_harfbuzz
+    if [[ -z "$IOS_SDK" ]]; then
+        # On iOS, there's no vendor-provided raqm, and we can't ship it due to
+        # licensing, so there's no point building harfbuzz.
+        build_harfbuzz
+    fi
+}
+
+function create_meson_cross_config {
+    cat << EOF > $WORKDIR/meson-cross.txt
+[binaries]
+pkg-config = '$BUILD_PREFIX/bin/pkg-config'
+cmake = '$(which cmake)'
+c = '$CC'
+cpp = '$CXX'
+strip = '$STRIP'
+
+[built-in options]
+c_args = '$CFLAGS -I$BUILD_PREFIX/include'
+cpp_args = '$CXXFLAGS -I$BUILD_PREFIX/include'
+c_link_args = '$CFLAGS -L$BUILD_PREFIX/lib'
+cpp_link_args = '$CFLAGS -L$BUILD_PREFIX/lib'
+
+[host_machine]
+system = 'darwin'
+subsystem = 'ios'
+kernel = 'xnu'
+cpu_family = '$(uname -m)'
+cpu = '$(uname -m)'
+endian = 'little'
+
+EOF
 }
 
 # Perform all dependency builds in the build subfolder.
@@ -227,24 +342,40 @@ if [[ ! -d $WORKDIR/pillow-depends-main ]]; then
 fi
 
 if [[ -n "$IS_MACOS" ]]; then
-    # Homebrew (or similar packaging environments) install can contain some of
-    # the libraries that we're going to build. However, they may be compiled
-    # with a MACOSX_DEPLOYMENT_TARGET that doesn't match what we want to use,
-    # and they may bring in other dependencies that we don't want. The same will
-    # be true of any other locations on the path. To avoid conflicts, strip the
-    # path down to the bare minimum (which, on macOS, won't include any
-    # development dependencies).
-    export PATH="$BUILD_PREFIX/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
-    export CMAKE_PREFIX_PATH=$BUILD_PREFIX
-
     # Ensure the basic structure of the build prefix directory exists.
     mkdir -p "$BUILD_PREFIX/bin"
     mkdir -p "$BUILD_PREFIX/lib"
 
-    # Ensure pkg-config is available
+    # Ensure pkg-config is available. This is done *before* setting CC, CFLAGS
+    # etc. to ensure that the build is *always* a macOS build, even when building
+    # for iOS.
     build_pkg_config
-    # Ensure cmake is available
+
+    # Ensure cmake is available, and that the default prefix used by CMake is
+    # the build prefix
     python3 -m pip install cmake
+    export CMAKE_PREFIX_PATH=$BUILD_PREFIX
+
+    if [[ -n "$IOS_SDK" ]]; then
+        export AR="$(xcrun --find --sdk $IOS_SDK ar)"
+        export CPP="$(xcrun --find --sdk $IOS_SDK clang) -E"
+        export CC=$(xcrun --find --sdk $IOS_SDK clang)
+        export CXX=$(xcrun --find --sdk $IOS_SDK clang++)
+        export LD=$(xcrun --find --sdk $IOS_SDK ld)
+        export STRIP=$(xcrun --find --sdk $IOS_SDK strip)
+
+        CPPFLAGS="$CPPFLAGS --sysroot=$IOS_SDK_PATH"
+        CFLAGS="-target $IOS_HOST_TRIPLE --sysroot=$IOS_SDK_PATH -mios-version-min=$IPHONEOS_DEPLOYMENT_TARGET"
+        CXXFLAGS="-target $IOS_HOST_TRIPLE --sysroot=$IOS_SDK_PATH -mios-version-min=$IPHONEOS_DEPLOYMENT_TARGET"
+
+        # Having IPHONEOS_DEPLOYMENT_TARGET in the environment causes problems
+        # with some cross-building toolchains, because it introduces implicit
+        # behavior into clang.
+        unset IPHONEOS_DEPLOYMENT_TARGET
+
+        # Now that we know CC etc., we can create a meson cross-configuration file
+        create_meson_cross_config
+    fi
 fi
 
 wrap_wheel_builder build
diff --git a/.github/workflows/wheels-test.ps1 b/.github/workflows/wheels-test.ps1
index 9f5561c46d4..e6453d09118 100644
--- a/.github/workflows/wheels-test.ps1
+++ b/.github/workflows/wheels-test.ps1
@@ -15,15 +15,12 @@ if (Test-Path $venv\Scripts\pypy.exe) {
   $python = "python.exe"
 }
 & reg add "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\python.exe" /v "GlobalFlag" /t REG_SZ /d "0x02000000" /f
-if ("$venv" -like "*\cibw-run-*-win_amd64\*") {
-  & $venv\Scripts\$python -m pip install numpy
-}
 cd $pillow
 & $venv\Scripts\$python -VV
 if (!$?) { exit $LASTEXITCODE }
 & $venv\Scripts\$python selftest.py
 if (!$?) { exit $LASTEXITCODE }
-& $venv\Scripts\$python -m pytest -vv -x Tests\check_wheel.py
+& $venv\Scripts\$python -m pytest -vv -x checks\check_wheel.py
 if (!$?) { exit $LASTEXITCODE }
 & $venv\Scripts\$python -m pytest -vv -x Tests
 if (!$?) { exit $LASTEXITCODE }
diff --git a/.github/workflows/wheels-test.sh b/.github/workflows/wheels-test.sh
index 94dbb46791e..d73b6be5847 100755
--- a/.github/workflows/wheels-test.sh
+++ b/.github/workflows/wheels-test.sh
@@ -25,8 +25,6 @@ else
     yum install -y fribidi
 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
     unzip pillow-test-images.zip
@@ -35,5 +33,5 @@ fi
 
 # Runs tests
 python3 selftest.py
-python3 -m pytest -vv -x Tests/check_wheel.py
+python3 -m pytest -vv -x checks/check_wheel.py
 python3 -m pytest -vv -x
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 16c350a1484..52a3f2cdb2a 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -51,40 +51,60 @@ jobs:
       matrix:
         include:
           - name: "macOS 10.10 x86_64"
+            platform: macos
             os: macos-13
             cibw_arch: x86_64
             build: "cp3{9,10,11}*"
             macosx_deployment_target: "10.10"
           - name: "macOS 10.13 x86_64"
+            platform: macos
             os: macos-13
             cibw_arch: x86_64
             build: "cp3{12,13,14}*"
             macosx_deployment_target: "10.13"
           - name: "macOS 10.15 x86_64"
+            platform: macos
             os: macos-13
             cibw_arch: x86_64
             build: "pp3*"
             macosx_deployment_target: "10.15"
           - name: "macOS arm64"
+            platform: macos
             os: macos-latest
             cibw_arch: arm64
             macosx_deployment_target: "11.0"
           - name: "manylinux2014 and musllinux x86_64"
+            platform: linux
             os: ubuntu-latest
             cibw_arch: x86_64
           - name: "manylinux_2_28 x86_64"
+            platform: linux
             os: ubuntu-latest
             cibw_arch: x86_64
             build: "*manylinux*"
             manylinux: "manylinux_2_28"
           - name: "manylinux2014 and musllinux aarch64"
+            platform: linux
             os: ubuntu-24.04-arm
             cibw_arch: aarch64
           - name: "manylinux_2_28 aarch64"
+            platform: linux
             os: ubuntu-24.04-arm
             cibw_arch: aarch64
             build: "*manylinux*"
             manylinux: "manylinux_2_28"
+          - name: "iOS arm64 device"
+            platform: ios
+            os: macos-latest
+            cibw_arch: arm64_iphoneos
+          - name: "iOS arm64 simulator"
+            platform: ios
+            os: macos-latest
+            cibw_arch: arm64_iphonesimulator
+          - name: "iOS x86_64 simulator"
+            platform: ios
+            os: macos-13
+            cibw_arch: x86_64_iphonesimulator
     steps:
       - uses: actions/checkout@v4
         with:
@@ -103,6 +123,7 @@ jobs:
         run: |
           python3 -m cibuildwheel --output-dir wheelhouse
         env:
+          CIBW_PLATFORM: ${{ matrix.platform }}
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BUILD: ${{ matrix.build }}
           CIBW_ENABLE: cpython-prerelease cpython-freethreading pypy
@@ -114,7 +135,7 @@ jobs:
 
       - uses: actions/upload-artifact@v4
         with:
-          name: dist-${{ matrix.os }}${{ matrix.macosx_deployment_target && format('-{0}', matrix.macosx_deployment_target) }}-${{ matrix.cibw_arch }}${{ matrix.manylinux && format('-{0}', matrix.manylinux) }}
+          name: dist-${{ matrix.name }}
           path: ./wheelhouse/*.whl
 
   windows:
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 6abb732bbaa..d5fd964f128 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -21,7 +21,7 @@ repos:
     rev: v1.5.5
     hooks:
       - id: remove-tabs
-        exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
+        exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$|\.patch$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
     rev: v20.1.6
@@ -46,9 +46,9 @@ repos:
       - id: check-yaml
         args: [--allow-multiple-documents]
       - id: end-of-file-fixer
-        exclude: ^Tests/images/
+        exclude: ^Tests/images/|\.patch$
       - id: trailing-whitespace
-        exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
+        exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
     rev: 0.33.1
diff --git a/MANIFEST.in b/MANIFEST.in
index 48085b82ed0..95a6b1b9297 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -13,6 +13,8 @@ include LICENSE
 include Makefile
 include tox.ini
 graft Tests
+graft checks
+graft patches
 graft src
 graft depends
 graft winbuild
diff --git a/Tests/oss-fuzz/test_fuzzers.py b/Tests/oss-fuzz/test_fuzzers.py
index e42ec90aa54..37d11e0ba4c 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -10,8 +10,9 @@
 from PIL import Image, features
 from Tests.helper import skip_unless_feature
 
-if sys.platform.startswith("win32"):
-    pytest.skip("Fuzzer is linux only", allow_module_level=True)
+if sys.platform.startswith("win32") or sys.platform == "ios":
+    pytest.skip("Fuzzer doesn't run on Windows or iOS", allow_module_level=True)
+
 libjpeg_turbo_version = features.version("libjpeg_turbo")
 if libjpeg_turbo_version is not None:
     version = packaging.version.parse(libjpeg_turbo_version)
diff --git a/Tests/test_main.py b/Tests/test_main.py
index 2582dbee3db..65e7a44d8d0 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -7,6 +7,7 @@
 import pytest
 
 
+@pytest.mark.skipif(sys.platform == "ios", reason="Processes not supported on iOS")
 @pytest.mark.parametrize(
     "args, report",
     ((["PIL"], False), (["PIL", "--report"], True), (["PIL.report"], True)),
diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index 8235daf3282..9669f485a6f 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from importlib.metadata import metadata
+
 import pytest
 
 from PIL import __version__
@@ -9,7 +11,7 @@
 
 def test_pyroma() -> None:
     # Arrange
-    data = pyroma.projectdata.get_data(".")
+    data = pyroma.projectdata.map_metadata_keys(metadata("Pillow"))
 
     # Act
     rating = pyroma.ratings.rate(data)
diff --git a/Tests/32bit_segfault_check.py b/checks/32bit_segfault_check.py
similarity index 100%
rename from Tests/32bit_segfault_check.py
rename to checks/32bit_segfault_check.py
diff --git a/Tests/check_fli_oob.py b/checks/check_fli_oob.py
similarity index 100%
rename from Tests/check_fli_oob.py
rename to checks/check_fli_oob.py
diff --git a/Tests/check_fli_overflow.py b/checks/check_fli_overflow.py
similarity index 100%
rename from Tests/check_fli_overflow.py
rename to checks/check_fli_overflow.py
diff --git a/Tests/check_icns_dos.py b/checks/check_icns_dos.py
similarity index 100%
rename from Tests/check_icns_dos.py
rename to checks/check_icns_dos.py
diff --git a/Tests/check_imaging_leaks.py b/checks/check_imaging_leaks.py
similarity index 100%
rename from Tests/check_imaging_leaks.py
rename to checks/check_imaging_leaks.py
diff --git a/Tests/check_j2k_dos.py b/checks/check_j2k_dos.py
similarity index 100%
rename from Tests/check_j2k_dos.py
rename to checks/check_j2k_dos.py
diff --git a/Tests/check_j2k_leaks.py b/checks/check_j2k_leaks.py
similarity index 100%
rename from Tests/check_j2k_leaks.py
rename to checks/check_j2k_leaks.py
diff --git a/Tests/check_j2k_overflow.py b/checks/check_j2k_overflow.py
similarity index 100%
rename from Tests/check_j2k_overflow.py
rename to checks/check_j2k_overflow.py
diff --git a/Tests/check_jp2_overflow.py b/checks/check_jp2_overflow.py
similarity index 100%
rename from Tests/check_jp2_overflow.py
rename to checks/check_jp2_overflow.py
diff --git a/Tests/check_jpeg_leaks.py b/checks/check_jpeg_leaks.py
similarity index 100%
rename from Tests/check_jpeg_leaks.py
rename to checks/check_jpeg_leaks.py
diff --git a/Tests/check_large_memory.py b/checks/check_large_memory.py
similarity index 100%
rename from Tests/check_large_memory.py
rename to checks/check_large_memory.py
diff --git a/Tests/check_large_memory_numpy.py b/checks/check_large_memory_numpy.py
similarity index 100%
rename from Tests/check_large_memory_numpy.py
rename to checks/check_large_memory_numpy.py
diff --git a/Tests/check_libtiff_segfault.py b/checks/check_libtiff_segfault.py
similarity index 100%
rename from Tests/check_libtiff_segfault.py
rename to checks/check_libtiff_segfault.py
diff --git a/Tests/check_png_dos.py b/checks/check_png_dos.py
similarity index 100%
rename from Tests/check_png_dos.py
rename to checks/check_png_dos.py
diff --git a/Tests/check_release_notes.py b/checks/check_release_notes.py
similarity index 100%
rename from Tests/check_release_notes.py
rename to checks/check_release_notes.py
diff --git a/Tests/check_wheel.py b/checks/check_wheel.py
similarity index 75%
rename from Tests/check_wheel.py
rename to checks/check_wheel.py
index a78fb09b041..c89d32ed7aa 100644
--- a/Tests/check_wheel.py
+++ b/checks/check_wheel.py
@@ -4,8 +4,7 @@
 import sys
 
 from PIL import features
-
-from .helper import is_pypy
+from Tests.helper import is_pypy
 
 
 def test_wheel_modules() -> None:
@@ -24,6 +23,11 @@ def test_wheel_modules() -> None:
         if platform.machine() == "ARM64":
             expected_modules.remove("avif")
 
+    elif sys.platform == "ios":
+        # tkinter is not available on iOS
+        # libavif is not available on iOS (for now)
+        expected_modules -= {"tkinter", "avif"}
+
     assert set(features.get_supported_modules()) == expected_modules
 
 
@@ -50,5 +54,9 @@ def test_wheel_features() -> None:
         expected_features.remove("xcb")
     elif sys.platform == "darwin" and not is_pypy() and platform.processor() != "arm":
         expected_features.remove("zlib_ng")
+    elif sys.platform == "ios":
+        # Can't distribute raqm due to licensing, and there's no system version;
+        # fribidi and harfbuzz won't be available if raqm isn't available.
+        expected_features -= {"raqm", "fribidi", "harfbuzz"}
 
     assert set(features.get_supported_features()) == expected_features
diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index 2d35d8228fc..4af1f68ede0 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -68,7 +68,13 @@ AVIF support in wheels
 ^^^^^^^^^^^^^^^^^^^^^^
 
 Support for reading and writing AVIF images is now included in Pillow's wheels, except
-for Windows ARM64. libaom is available as an encoder and dav1d as a decoder.
+for Windows ARM64 and iOS. libaom is available as an encoder and dav1d as a decoder.
+
+iOS
+^^^
+
+Pillow now provides wheels that can be used on iOS ARM64 devices, and on the iOS
+simulator on ARM64 and x86_64. Currently, only Python 3.13 wheels are available.
 
 Python 3.14 beta
 ^^^^^^^^^^^^^^^^
diff --git a/patches/README.md b/patches/README.md
new file mode 100644
index 00000000000..ff4a8f0994f
--- /dev/null
+++ b/patches/README.md
@@ -0,0 +1,14 @@
+Although we try to use official sources for dependencies, sometimes the official
+sources don't support a platform (especially mobile platforms), or there's a bug
+fix/feature that is required to support Pillow's usage.
+
+This folder contains patches that must be applied to official sources, organized
+by the platforms that need those patches.
+
+Each patch is against the root of the unpacked official tarball, and is named by
+appending `.patch` to the end of the tarball that is to be patched. This
+includes the full version number; so if the version is bumped, the patch will
+at a minimum require a filename change.
+
+Wherever possible, these patches should be contributed upstream, in the hope that
+future Pillow versions won't need to maintain these patches.
diff --git a/patches/iOS/brotli-1.1.0.tar.gz.patch b/patches/iOS/brotli-1.1.0.tar.gz.patch
new file mode 100644
index 00000000000..f165a9ac12f
--- /dev/null
+++ b/patches/iOS/brotli-1.1.0.tar.gz.patch
@@ -0,0 +1,46 @@
+# Brotli 1.1.0 doesn't have explicit support for iOS as a CMAKE_SYSTEM_NAME.
+# That release was from 2023; there have been subsequent changes that allow
+# Brotli to build on iOS without any patches, as long as -DBROTLI_BUILD_TOOLS=NO
+# is specified on the command line.
+#
+diff -ru brotli-1.1.0-orig/CMakeLists.txt brotli-1.1.0/CMakeLists.txt
+--- brotli-1.1.0-orig/CMakeLists.txt	2023-08-29 19:00:29
++++ brotli-1.1.0/CMakeLists.txt	2024-11-07 10:46:26
+@@ -114,6 +114,8 @@
+   add_definitions(-DOS_MACOSX)
+   set(CMAKE_MACOS_RPATH TRUE)
+   set(CMAKE_INSTALL_NAME_DIR "${CMAKE_INSTALL_PREFIX}/lib")
++elseif(${CMAKE_SYSTEM_NAME} MATCHES "iOS")
++  add_definitions(-DOS_IOS)
+ endif()
+ 
+ if(BROTLI_EMSCRIPTEN)
+@@ -174,10 +176,12 @@
+ 
+ # Installation
+ if(NOT BROTLI_BUNDLED_MODE)
+-  install(
+-    TARGETS brotli
+-    RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}"
+-  )
++  if(NOT ${CMAKE_SYSTEM_NAME} MATCHES "iOS")
++    install(
++      TARGETS brotli
++      RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}"
++    )
++  endif()
+ 
+   install(
+     TARGETS ${BROTLI_LIBRARIES_CORE}
+diff -ru brotli-1.1.0-orig/c/common/platform.h brotli-1.1.0/c/common/platform.h
+--- brotli-1.1.0-orig/c/common/platform.h	2023-08-29 19:00:29
++++ brotli-1.1.0/c/common/platform.h	2024-11-07 10:47:28
+@@ -33,7 +33,7 @@
+ #include <endian.h>
+ #elif defined(OS_FREEBSD)
+ #include <machine/endian.h>
+-#elif defined(OS_MACOSX)
++#elif defined(OS_MACOSX) || defined(OS_IOS)
+ #include <machine/endian.h>
+ /* Let's try and follow the Linux convention */
+ #define BROTLI_X_BYTE_ORDER BYTE_ORDER
diff --git a/patches/iOS/libwebp-1.5.0.tar.gz.patch b/patches/iOS/libwebp-1.5.0.tar.gz.patch
new file mode 100644
index 00000000000..fefb72b68d2
--- /dev/null
+++ b/patches/iOS/libwebp-1.5.0.tar.gz.patch
@@ -0,0 +1,42 @@
+# libwebp example binaries require dependencies that aren't available for iOS builds.
+# There's also no easy way to invoke the build to *exclude* the example builds.
+# Since we don't need the examples anyway, remove them from the Makefile.
+#
+# As a point of reference, libwebp provides an XCFramework build script that involves
+# 7 separate invocations of make to avoid building the examples. Patching the Makefile
+# to remove the examples is a simpler approach, and one that is more compatible with
+# the existing multibuild infrastructure.
+# 
+# In the next release, it should be possible to pass --disable-libwebpexamples 
+# instead of applying this patch.
+#
+diff -ur libwebp-1.5.0-orig/Makefile.am libwebp-1.5.0/Makefile.am
+--- libwebp-1.5.0-orig/Makefile.am	2024-12-20 09:17:50
++++ libwebp-1.5.0/Makefile.am	2025-01-09 11:24:17
+@@ -5,5 +5,3 @@
+ if BUILD_EXTRAS
+   SUBDIRS += extras
+ endif
+-
+-SUBDIRS += examples
+diff -ur libwebp-1.5.0-orig/Makefile.in libwebp-1.5.0/Makefile.in
+--- libwebp-1.5.0-orig/Makefile.in	2024-12-20 09:52:53
++++ libwebp-1.5.0/Makefile.in	2025-01-09 11:24:17
+@@ -156,7 +156,7 @@
+   unique=`for i in $$list; do \
+     if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
+   done | $(am__uniquify_input)`
+-DIST_SUBDIRS = sharpyuv src imageio man extras examples
++DIST_SUBDIRS = sharpyuv src imageio man extras
+ am__DIST_COMMON = $(srcdir)/Makefile.in \
+ 	$(top_srcdir)/src/webp/config.h.in AUTHORS COPYING ChangeLog \
+ 	NEWS README.md ar-lib compile config.guess config.sub \
+@@ -351,7 +351,7 @@
+ top_srcdir = @top_srcdir@
+ webp_libname_prefix = @webp_libname_prefix@
+ ACLOCAL_AMFLAGS = -I m4
+-SUBDIRS = sharpyuv src imageio man $(am__append_1) examples
++SUBDIRS = sharpyuv src imageio man $(am__append_1)
+ EXTRA_DIST = COPYING autogen.sh
+ all: all-recursive
+ 
diff --git a/pyproject.toml b/pyproject.toml
index 683ab24ef07..582d742b4d3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -103,15 +103,55 @@ before-all = ".github/workflows/wheels-dependencies.sh"
 build-verbosity = 1
 
 config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable"
-# Disable platform guessing on macOS
-macos.config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable platform-guessing=disable"
 
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
+test-requires = [
+  "numpy",
+]
+xbuild-tools = [  ]
+
+[tool.cibuildwheel.macos]
+# Disable platform guessing on macOS to avoid picking up Homebrew etc.
+config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable platform-guessing=disable"
 
 [tool.cibuildwheel.macos.environment]
+# Isolate macOS build environment from Homebrew etc.
 PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
 
+[tool.cibuildwheel.ios]
+# Disable platform guessing on iOS, and disable raqm (since there won't be a
+# vendor version, and we can't distribute it due to licensing)
+config-settings = "raqm=disable imagequant=disable platform-guessing=disable"
+
+# iOS needs to be given a specific pytest invocation and list of test sources.
+test-sources = [
+  "checks",
+  "Tests",
+  "selftest.py",
+]
+test-command = [
+  "python -m selftest",
+  "python -m pytest -vv -x -W always checks/check_wheel.py Tests",
+]
+
+# There's no numpy wheel for iOS (yet...)
+test-requires = [  ]
+
+[[tool.cibuildwheel.overrides]]
+# iOS environment is isolated by cibuildwheel, but needs the dependencies
+select = "*_iphoneos"
+environment.PATH = "$(pwd)/build/deps/iphoneos/bin:$PATH"
+
+[[tool.cibuildwheel.overrides]]
+# iOS simulator environment is isolated by cibuildwheel, but needs the dependencies
+select = "*_iphonesimulator"
+environment.PATH = "$(pwd)/build/deps/iphonesimulator/bin:$PATH"
+
+[[tool.cibuildwheel.overrides]]
+select = "*-win32"
+test-requires = [  ]
+
 [tool.black]
 exclude = "wheels/multibuild"
 
@@ -168,7 +208,7 @@ lint.isort.required-imports = [
 max_supported_python = "3.13"
 
 [tool.pytest.ini_options]
-addopts = "-ra --color=yes"
+addopts = "-ra --color=auto"
 testpaths = [
   "Tests",
 ]
diff --git a/setup.py b/setup.py
index 354e09f85f2..477d187a278 100644
--- a/setup.py
+++ b/setup.py
@@ -473,6 +473,19 @@ def get_macos_sdk_path(self) -> str | None:
                 sdk_path = commandlinetools_sdk_path
         return sdk_path
 
+    def get_ios_sdk_path(self) -> str:
+        try:
+            sdk = sys.implementation._multiarch.split("-")[-1]
+            _dbg("Using %s SDK", sdk)
+            return (
+                subprocess.check_output(["xcrun", "--show-sdk-path", "--sdk", sdk])
+                .strip()
+                .decode("latin1")
+            )
+        except Exception:
+            msg = "Unable to identify location of iOS SDK."
+            raise ValueError(msg)
+
     def build_extensions(self) -> None:
         library_dirs: list[str] = []
         include_dirs: list[str] = []
@@ -622,6 +635,18 @@ def build_extensions(self) -> None:
 
                 for extension in self.extensions:
                     extension.extra_compile_args = ["-Wno-nullability-completeness"]
+
+        elif sys.platform == "ios":
+            # Add the iOS SDK path.
+            sdk_path = self.get_ios_sdk_path()
+
+            # Add the iOS 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", "gnu", "freebsd")):
             for dirname in _find_library_dirs_ldconfig():
                 _add_directory(library_dirs, dirname)
@@ -877,6 +902,9 @@ def build_extensions(self) -> None:
                 # 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))
+            elif sys.platform == "ios":
+                # Ensure transitive dependencies are linked.
+                libs.append("lzma")
         if feature.get("jpeg"):
             libs.append(feature.get("jpeg"))
             defs.append(("HAVE_LIBJPEG", None))
@@ -893,6 +921,9 @@ def build_extensions(self) -> None:
             defs.append(("HAVE_LIBIMAGEQUANT", None))
         if feature.get("xcb"):
             libs.append(feature.get("xcb"))
+            if sys.platform == "ios":
+                # Ensure transitive dependencies are linked.
+                libs.append("Xau")
             defs.append(("HAVE_XCB", None))
         if sys.platform == "win32":
             libs.extend(["kernel32", "user32", "gdi32"])
@@ -924,6 +955,11 @@ def build_extensions(self) -> None:
                         libs.append(feature.get("fribidi"))
                     else:  # building FriBiDi shim from src/thirdparty
                         srcs.append("src/thirdparty/fribidi-shim/fribidi.c")
+
+            if sys.platform == "ios":
+                # Ensure transitive dependencies are linked.
+                libs.extend(["z", "bz2", "brotlicommon", "brotlidec", "png"])
+
             self._update_extension("PIL._imagingft", libs, defs, srcs)
 
         else:
@@ -940,6 +976,9 @@ def build_extensions(self) -> None:
         webp = feature.get("webp")
         if isinstance(webp, str):
             libs = [webp, webp + "mux", webp + "demux"]
+            if sys.platform == "ios":
+                # Ensure transitive dependencies are linked.
+                libs.append("sharpyuv")
             self._update_extension("PIL._webp", libs)
         else:
             self._remove_extension("PIL._webp")

From 49efe40f28ce0413ced31d8dcc0c707b0134d6bf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Jun 2025 22:19:14 +1000
Subject: [PATCH 1827/2374] Escape period

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

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index d5fd964f128..c5276723a2b 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -48,7 +48,7 @@ repos:
       - id: end-of-file-fixer
         exclude: ^Tests/images/|\.patch$
       - id: trailing-whitespace
-        exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
+        exclude: ^\.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
     rev: 0.33.1

From 204d11d4da15879946c1120c43e6f75b2a338d5b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Jun 2025 22:29:24 +1000
Subject: [PATCH 1828/2374] Raise FileNotFoundError when opening an empty path

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

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 069083b1963..6b8b6d42b07 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -160,6 +160,10 @@ def test_set_mode(self) -> None:
         with pytest.raises(AttributeError):
             im.mode = "P"  # type: ignore[misc]
 
+    def test_empty_path(self) -> None:
+        with pytest.raises(FileNotFoundError):
+            Image.open("")
+
     def test_invalid_image(self) -> None:
         im = io.BytesIO(b"")
         with pytest.raises(UnidentifiedImageError):
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9fc1c70671b..d209405c4c5 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3510,8 +3510,6 @@ def open(
     filename: str | bytes = ""
     if is_path(fp):
         filename = os.fspath(fp)
-
-    if filename:
         fp = builtins.open(filename, "rb")
         exclusive_fp = True
     else:

From f2de251c769ed76acfe94b54cc87c2aee77bdadf Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 15:17:56 +1000
Subject: [PATCH 1829/2374] Updated check script paths (#9052)

---
 .coveragerc                | 3 +--
 Makefile                   | 2 +-
 checks/check_jpeg_leaks.py | 2 +-
 codecov.yml                | 3 +--
 4 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/.coveragerc b/.coveragerc
index a94a2567854..1f474015e30 100644
--- a/.coveragerc
+++ b/.coveragerc
@@ -18,6 +18,5 @@ exclude_also =
 
 [run]
 omit =
-    Tests/32bit_segfault_check.py
-    Tests/check_*.py
+    checks/*.py
     Tests/createfontdatachunk.py
diff --git a/Makefile b/Makefile
index ce780acbc00..6e050c715d2 100644
--- a/Makefile
+++ b/Makefile
@@ -75,7 +75,7 @@ debug:
 
 .PHONY: release-test
 release-test:
-	python3 Tests/check_release_notes.py
+	python3 checks/check_release_notes.py
 	python3 -m pip install -e .[tests]
 	python3 selftest.py
 	python3 -m pytest Tests
diff --git a/checks/check_jpeg_leaks.py b/checks/check_jpeg_leaks.py
index 5f290c6cd37..2f42ad734a8 100644
--- a/checks/check_jpeg_leaks.py
+++ b/checks/check_jpeg_leaks.py
@@ -13,7 +13,7 @@
 When run on a system without the jpeg leak fixes,
 the valgrind runs look like this.
 
-valgrind --tool=massif python test-installed.py -s -v Tests/check_jpeg_leaks.py
+valgrind --tool=massif python test-installed.py -s -v checks/check_jpeg_leaks.py
 
 """
 
diff --git a/codecov.yml b/codecov.yml
index 84920238ffc..c29b4bc9015 100644
--- a/codecov.yml
+++ b/codecov.yml
@@ -16,6 +16,5 @@ coverage:
 
 # Matches 'omit:' in .coveragerc
 ignore:
-  - "Tests/32bit_segfault_check.py"
-  - "Tests/check_*.py"
+  - "checks/*.py"
   - "Tests/createfontdatachunk.py"

From 89f1f4626a2aaf5f3d5ca6437f41def2998fbe09 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 17:41:24 +1000
Subject: [PATCH 1830/2374] 11.3.0 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 ac678c7d26e..74e63356c95 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.3.0.dev0"
+__version__ = "11.3.0"

From 37cd041e5e9041b0708551c02655328e8761226d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 19:25:23 +1000
Subject: [PATCH 1831/2374] 12.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 74e63356c95..6a3c01f2607 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.3.0"
+__version__ = "12.0.0.dev0"

From 0cd2d3b24b32d458ad47f885314e20faaab548a1 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Tue, 1 Jul 2025 09:10:20 -0400
Subject: [PATCH 1832/2374] Setup nit: "fork" should be lowercased

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

diff --git a/pyproject.toml b/pyproject.toml
index 582d742b4d3..abab61e6b2e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -9,7 +9,7 @@ backend-path = [
 
 [project]
 name = "pillow"
-description = "Python Imaging Library (Fork)"
+description = "Python Imaging Library (fork)"
 readme = "README.md"
 keywords = [
   "Imaging",

From d4ef93150f055c342baccd01e079eb70a9e7f189 Mon Sep 17 00:00:00 2001
From: "Jeffrey A. Clark" <aclark@aclark.net>
Date: Tue, 1 Jul 2025 09:25:32 -0400
Subject: [PATCH 1833/2374] Thanks, folks!

As a general rule I think we should acknowledge when significant
contribtions come from outside the core team. We know the core team
does a lot of work (thank you!) but it's not always obvious when
significant contributions come from outside the core team.

In the old change log, we had ACKs via `[radarhere]` syntax which I
miss. I don't expect we'll start using the old change log again but
maybe we can make a note in the release notes to include such ACKs as
needed and appropriate.
---
 docs/releasenotes/11.3.0.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index 4af1f68ede0..409d50295dd 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -69,12 +69,14 @@ AVIF support in wheels
 
 Support for reading and writing AVIF images is now included in Pillow's wheels, except
 for Windows ARM64 and iOS. libaom is available as an encoder and dav1d as a decoder.
+(Thank you Frankie Dintino and Andrew Murray!)
 
 iOS
 ^^^
 
 Pillow now provides wheels that can be used on iOS ARM64 devices, and on the iOS
 simulator on ARM64 and x86_64. Currently, only Python 3.13 wheels are available.
+(Thank you Russell Keith-Magee and Andrew Murray!)
 
 Python 3.14 beta
 ^^^^^^^^^^^^^^^^

From 583f0a50d50107bf7857548efa5c990d1a7cb362 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 23:57:46 +1000
Subject: [PATCH 1834/2374] Removed BGR;15, BGR;16 and BGR;24 modes

---
 Tests/helper.py                  | 18 +++----
 Tests/test_image.py              | 32 +++--------
 Tests/test_image_access.py       | 16 +-----
 Tests/test_image_putdata.py      | 10 ----
 Tests/test_image_resize.py       |  2 +-
 Tests/test_lib_pack.py           | 12 -----
 docs/deprecations.rst            | 15 +++---
 docs/reference/arrow_support.rst |  4 +-
 src/PIL/Image.py                 | 11 +---
 src/PIL/ImageMode.py             |  7 ---
 src/_imaging.c                   | 91 ++++++++------------------------
 src/libImaging/Access.c          | 38 -------------
 src/libImaging/Convert.c         | 35 ------------
 src/libImaging/Pack.c            |  9 ----
 src/libImaging/Storage.c         | 30 -----------
 src/libImaging/Unpack.c          | 10 ----
 16 files changed, 50 insertions(+), 290 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index e71b4665b28..34e4d6e75fb 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -271,17 +271,13 @@ def _cached_hopper(mode: str) -> Image.Image:
         im = hopper("L")
     else:
         im = hopper()
-    if mode.startswith("BGR;"):
-        with pytest.warns(DeprecationWarning, match="BGR;"):
-            im = im.convert(mode)
-    else:
-        try:
-            im = im.convert(mode)
-        except ImportError:
-            if mode == "LAB":
-                im = Image.open("Tests/images/hopper.Lab.tif")
-            else:
-                raise
+    try:
+        im = im.convert(mode)
+    except ImportError:
+        if mode == "LAB":
+            im = Image.open("Tests/images/hopper.Lab.tif")
+        else:
+            raise
     return im
 
 
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 6b8b6d42b07..1aa810e22ac 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -30,7 +30,6 @@
     assert_image_similar_tofile,
     assert_not_all_same,
     hopper,
-    is_big_endian,
     is_win32,
     mark_if_feature_version,
     skip_unless_feature,
@@ -50,19 +49,10 @@
     PrettyPrinter = None
 
 
-# Deprecation helper
-def helper_image_new(mode: str, size: tuple[int, int]) -> Image.Image:
-    if mode.startswith("BGR;"):
-        with pytest.warns(DeprecationWarning, match="BGR;"):
-            return Image.new(mode, size)
-    else:
-        return Image.new(mode, size)
-
-
 class TestImage:
-    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
+    @pytest.mark.parametrize("mode", Image.MODES)
     def test_image_modes_success(self, mode: str) -> None:
-        helper_image_new(mode, (1, 1))
+        Image.new(mode, (1, 1))
 
     @pytest.mark.parametrize("mode", ("", "bad", "very very long"))
     def test_image_modes_fail(self, mode: str) -> None:
@@ -1148,33 +1138,27 @@ def test_deprecation(self) -> None:
 
 
 class TestImageBytes:
-    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
+    @pytest.mark.parametrize("mode", Image.MODES)
     def test_roundtrip_bytes_constructor(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
 
-        if mode.startswith("BGR;"):
-            with pytest.warns(DeprecationWarning, match=mode):
-                reloaded = Image.frombytes(mode, im.size, source_bytes)
-        else:
-            reloaded = Image.frombytes(mode, im.size, source_bytes)
+        reloaded = Image.frombytes(mode, im.size, source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
+    @pytest.mark.parametrize("mode", Image.MODES)
     def test_roundtrip_bytes_method(self, mode: str) -> None:
         im = hopper(mode)
         source_bytes = im.tobytes()
 
-        reloaded = helper_image_new(mode, im.size)
+        reloaded = Image.new(mode, im.size)
         reloaded.frombytes(source_bytes)
         assert reloaded.tobytes() == source_bytes
 
-    @pytest.mark.parametrize("mode", Image.MODES + ["BGR;15", "BGR;16", "BGR;24"])
+    @pytest.mark.parametrize("mode", Image.MODES)
     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")
         im = hopper(mode)
-        reloaded = helper_image_new(mode, im.size)
+        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 66412a03582..b3de5c13d3e 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -123,10 +123,6 @@ def color(mode: str) -> int | tuple[int, ...]:
         bands = Image.getmodebands(mode)
         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.
-            return (16, 32, 49)
         return tuple(range(1, bands + 1))
 
     def check(self, mode: str, expected_color_int: int | None = None) -> None:
@@ -191,11 +187,6 @@ def check(self, mode: str, expected_color_int: int | None = None) -> None:
     def test_basic(self, mode: str) -> None:
         self.check(mode)
 
-    @pytest.mark.parametrize("mode", ("BGR;15", "BGR;16", "BGR;24"))
-    def test_deprecated(self, mode: str) -> None:
-        with pytest.warns(DeprecationWarning, match="BGR;"):
-            self.check(mode)
-
     def test_list(self) -> None:
         im = hopper()
         assert im.getpixel([0, 0]) == (20, 20, 70)
@@ -218,7 +209,7 @@ def test_p_putpixel_rgb_rgba(self, mode: str, color: tuple[int, ...]) -> None:
 
 
 class TestImagePutPixelError:
-    IMAGE_MODES1 = ["LA", "RGB", "RGBA", "BGR;15"]
+    IMAGE_MODES1 = ["LA", "RGB", "RGBA"]
     IMAGE_MODES2 = ["L", "I", "I;16"]
     INVALID_TYPES = ["foo", 1.0, None]
 
@@ -234,11 +225,6 @@ def test_putpixel_type_error1(self, mode: str) -> None:
         (
             ("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"),
-            (
-                "BGR;15",
-                (0, 2),
-                "color must be int, or tuple of one or three elements",
-            ),
             (
                 "RGB",
                 (0, 2, 5),
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index 34c1763b886..bf8e89b53ce 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -78,16 +78,6 @@ def test_mode_F() -> None:
     assert list(im.getdata()) == target
 
 
-@pytest.mark.parametrize("mode", ("BGR;15", "BGR;16", "BGR;24"))
-def test_mode_BGR(mode: str) -> None:
-    data = [(16, 32, 49), (32, 32, 98)]
-    with pytest.warns(DeprecationWarning, match=mode):
-        im = Image.new(mode, (1, 2))
-    im.putdata(data)
-
-    assert list(im.getdata()) == data
-
-
 def test_array_B() -> None:
     # shouldn't segfault
     # see https://github.com/python-pillow/Pillow/issues/1008
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index f700d20c0c9..270500a44b4 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -324,7 +324,7 @@ 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", "BGR;15", "BGR;16"))
+    @pytest.mark.parametrize("mode", ("1", "P"))
     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_lib_pack.py b/Tests/test_lib_pack.py
index 2d6af70eb78..da6157d4e56 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -361,18 +361,6 @@ def test_RGB(self) -> None:
             "RGB", "CMYK", 4, (250, 249, 248), (242, 241, 240), (234, 233, 233)
         )
 
-    def test_BGR(self) -> None:
-        with pytest.warns(DeprecationWarning, match="BGR;15"):
-            self.assert_unpack(
-                "BGR;15", "BGR;15", 3, (8, 131, 0), (24, 0, 8), (41, 131, 8)
-            )
-        with pytest.warns(DeprecationWarning, match="BGR;16"):
-            self.assert_unpack(
-                "BGR;16", "BGR;16", 3, (8, 64, 0), (24, 129, 0), (41, 194, 0)
-            )
-        with pytest.warns(DeprecationWarning, match="BGR;24"):
-            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))
         self.assert_unpack(
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index def98b80afb..b4eb1fa4c51 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -78,13 +78,6 @@ 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.
-
 Non-image modes in ImageCms
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -221,6 +214,14 @@ Removed features
 Deprecated features are only removed in major releases after an appropriate
 period of deprecation has passed.
 
+BGR;15, BGR 16 and BGR;24
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
+
 TiffImagePlugin IFD_LEGACY_API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/reference/arrow_support.rst b/docs/reference/arrow_support.rst
index 063046d8c22..8e8b86c8e4d 100644
--- a/docs/reference/arrow_support.rst
+++ b/docs/reference/arrow_support.rst
@@ -21,9 +21,7 @@ with any Arrow provider or consumer in the Python ecosystem.
 Data formats
 ============
 
-Pillow currently supports exporting Arrow images in all modes
-**except** for ``BGR;15``, ``BGR;16`` and ``BGR;24``. This is due to
-line-length packing in these modes making for non-continuous memory.
+Pillow currently supports exporting Arrow images in all modes.
 
 For single-band images, the exported array is width*height elements,
 with each pixel corresponding to the appropriate Arrow type.
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index d209405c4c5..9df253498ea 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -980,9 +980,6 @@ 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
@@ -2229,8 +2226,6 @@ 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 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
@@ -2253,8 +2248,7 @@ def resize(
         """
 
         if resample is None:
-            bgr = self.mode.startswith("BGR;")
-            resample = Resampling.NEAREST if bgr else Resampling.BICUBIC
+            resample = Resampling.BICUBIC
         elif resample not in (
             Resampling.NEAREST,
             Resampling.BILINEAR,
@@ -3085,9 +3079,6 @@ 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 92a08d2cbcb..b7c6c863659 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -18,8 +18,6 @@
 from functools import lru_cache
 from typing import NamedTuple
 
-from ._deprecate import deprecate
-
 
 class ModeDescriptor(NamedTuple):
     """Wrapper for mode strings."""
@@ -57,16 +55,11 @@ def getmode(mode: str) -> ModeDescriptor:
         "HSV": ("RGB", "L", ("H", "S", "V"), "|u1"),
         # extra experimental modes
         "RGBa": ("RGB", "L", ("R", "G", "B", "a"), "|u1"),
-        "BGR;15": ("RGB", "L", ("B", "G", "R"), "|u1"),
-        "BGR;16": ("RGB", "L", ("B", "G", "R"), "|u1"),
-        "BGR;24": ("RGB", "L", ("B", "G", "R"), "|u1"),
         "LA": ("L", "L", ("L", "A"), "|u1"),
         "La": ("L", "L", ("L", "a"), "|u1"),
         "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)
 
diff --git a/src/_imaging.c b/src/_imaging.c
index 6f13834a9d4..7cc1fb1a4b9 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -681,30 +681,6 @@ getink(PyObject *color, Imaging im, char *ink) {
                 } else if (!PyArg_ParseTuple(color, "iiL", &b, &g, &r)) {
                     return NULL;
                 }
-                if (!strcmp(im->mode, "BGR;15")) {
-                    UINT16 v = ((((UINT16)r) << 7) & 0x7c00) +
-                               ((((UINT16)g) << 2) & 0x03e0) +
-                               ((((UINT16)b) >> 3) & 0x001f);
-
-                    ink[0] = (UINT8)v;
-                    ink[1] = (UINT8)(v >> 8);
-                    ink[2] = ink[3] = 0;
-                    return ink;
-                } else if (!strcmp(im->mode, "BGR;16")) {
-                    UINT16 v = ((((UINT16)r) << 8) & 0xf800) +
-                               ((((UINT16)g) << 3) & 0x07e0) +
-                               ((((UINT16)b) >> 3) & 0x001f);
-                    ink[0] = (UINT8)v;
-                    ink[1] = (UINT8)(v >> 8);
-                    ink[2] = ink[3] = 0;
-                    return ink;
-                } else if (!strcmp(im->mode, "BGR;24")) {
-                    ink[0] = (UINT8)b;
-                    ink[1] = (UINT8)g;
-                    ink[2] = (UINT8)r;
-                    ink[3] = 0;
-                    return ink;
-                }
             }
     }
 
@@ -1650,54 +1626,33 @@ _putdata(ImagingObject *self, PyObject *args) {
                 return NULL;
             }
             double value;
-            if (image->bands == 1) {
-                int bigendian = 0;
-                if (image->type == IMAGING_TYPE_SPECIAL) {
-                    // I;16*
-                    if (
-                        strcmp(image->mode, "I;16B") == 0
+            int bigendian = 0;
+            if (image->type == IMAGING_TYPE_SPECIAL) {
+                // I;16*
+                if (
+                    strcmp(image->mode, "I;16B") == 0
 #ifdef WORDS_BIGENDIAN
-                        || strcmp(image->mode, "I;16N") == 0
+                    || strcmp(image->mode, "I;16N") == 0
 #endif
-                    ) {
-                        bigendian = 1;
-                    }
+                ) {
+                    bigendian = 1;
                 }
-                for (i = x = y = 0; i < n; i++) {
-                    set_value_to_item(seq, i);
-                    if (scale != 1.0 || offset != 0.0) {
-                        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);
-                    } else {
-                        image->image8[y][x] = (UINT8)CLIP8(value);
-                    }
-                    if (++x >= (int)image->xsize) {
-                        x = 0, y++;
-                    }
+            }
+            for (i = x = y = 0; i < n; i++) {
+                set_value_to_item(seq, i);
+                if (scale != 1.0 || offset != 0.0) {
+                    value = value * scale + offset;
                 }
-            } else {
-                // BGR;*
-                int b;
-                for (i = x = y = 0; i < n; i++) {
-                    char ink[4];
-
-                    op = PySequence_Fast_GET_ITEM(seq, i);
-                    if (!op || !getink(op, image, ink)) {
-                        Py_DECREF(seq);
-                        return NULL;
-                    }
-                    /* FIXME: what about scale and offset? */
-                    for (b = 0; b < image->pixelsize; b++) {
-                        image->image8[y][x * image->pixelsize + b] = ink[b];
-                    }
-                    if (++x >= (int)image->xsize) {
-                        x = 0, y++;
-                    }
+                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);
+                } else {
+                    image->image8[y][x] = (UINT8)CLIP8(value);
+                }
+                if (++x >= (int)image->xsize) {
+                    x = 0, y++;
                 }
             }
             PyErr_Clear(); /* Avoid weird exceptions */
diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 1c193710531..3db52377e80 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -82,31 +82,6 @@ get_pixel_16B(Imaging im, int x, int y, void *color) {
 #endif
 }
 
-static void
-get_pixel_BGR15(Imaging im, int x, int y, void *color) {
-    UINT8 *in = (UINT8 *)&im->image8[y][x * 2];
-    UINT16 pixel = in[0] + (in[1] << 8);
-    char *out = color;
-    out[0] = (pixel & 31) * 255 / 31;
-    out[1] = ((pixel >> 5) & 31) * 255 / 31;
-    out[2] = ((pixel >> 10) & 31) * 255 / 31;
-}
-
-static void
-get_pixel_BGR16(Imaging im, int x, int y, void *color) {
-    UINT8 *in = (UINT8 *)&im->image8[y][x * 2];
-    UINT16 pixel = in[0] + (in[1] << 8);
-    char *out = color;
-    out[0] = (pixel & 31) * 255 / 31;
-    out[1] = ((pixel >> 5) & 63) * 255 / 63;
-    out[2] = ((pixel >> 11) & 31) * 255 / 31;
-}
-
-static void
-get_pixel_BGR24(Imaging im, int x, int y, void *color) {
-    memcpy(color, &im->image8[y][x * 3], sizeof(UINT8) * 3);
-}
-
 static void
 get_pixel_32(Imaging im, int x, int y, void *color) {
     memcpy(color, &im->image32[y][x], sizeof(INT32));
@@ -154,16 +129,6 @@ put_pixel_16B(Imaging im, int x, int y, const void *color) {
     out[1] = in[0];
 }
 
-static void
-put_pixel_BGR1516(Imaging im, int x, int y, const void *color) {
-    memcpy(&im->image8[y][x * 2], color, 2);
-}
-
-static void
-put_pixel_BGR24(Imaging im, int x, int y, const void *color) {
-    memcpy(&im->image8[y][x * 3], color, 3);
-}
-
 static void
 put_pixel_32L(Imaging im, int x, int y, const void *color) {
     memcpy(&im->image8[y][x * 4], color, 4);
@@ -212,9 +177,6 @@ ImagingAccessInit(void) {
     ADD("F", get_pixel_32, put_pixel_32);
     ADD("P", get_pixel_8, put_pixel_8);
     ADD("PA", get_pixel_32_2bands, put_pixel_32);
-    ADD("BGR;15", get_pixel_BGR15, put_pixel_BGR1516);
-    ADD("BGR;16", get_pixel_BGR16, put_pixel_BGR1516);
-    ADD("BGR;24", get_pixel_BGR24, put_pixel_BGR24);
     ADD("RGB", get_pixel_32, put_pixel_32);
     ADD("RGBA", get_pixel_32, put_pixel_32);
     ADD("RGBa", get_pixel_32, put_pixel_32);
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index c8f23426105..9a2c9ff1667 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -277,38 +277,6 @@ rgb2f(UINT8 *out_, const UINT8 *in, int xsize) {
     }
 }
 
-static void
-rgb2bgr15(UINT8 *out_, const UINT8 *in, int xsize) {
-    int x;
-    for (x = 0; x < xsize; x++, in += 4, out_ += 2) {
-        UINT16 v = ((((UINT16)in[0]) << 7) & 0x7c00) +
-                   ((((UINT16)in[1]) << 2) & 0x03e0) +
-                   ((((UINT16)in[2]) >> 3) & 0x001f);
-        memcpy(out_, &v, sizeof(v));
-    }
-}
-
-static void
-rgb2bgr16(UINT8 *out_, const UINT8 *in, int xsize) {
-    int x;
-    for (x = 0; x < xsize; x++, in += 4, out_ += 2) {
-        UINT16 v = ((((UINT16)in[0]) << 8) & 0xf800) +
-                   ((((UINT16)in[1]) << 3) & 0x07e0) +
-                   ((((UINT16)in[2]) >> 3) & 0x001f);
-        memcpy(out_, &v, sizeof(v));
-    }
-}
-
-static void
-rgb2bgr24(UINT8 *out, const UINT8 *in, int xsize) {
-    int x;
-    for (x = 0; x < xsize; x++, in += 4) {
-        *out++ = in[2];
-        *out++ = in[1];
-        *out++ = in[0];
-    }
-}
-
 static void
 rgb2hsv_row(UINT8 *out, const UINT8 *in) {  // following colorsys.py
     float h, s, rc, gc, bc, cr;
@@ -971,9 +939,6 @@ static struct {
     {"RGB", "I;16N", rgb2i16l},
 #endif
     {"RGB", "F", rgb2f},
-    {"RGB", "BGR;15", rgb2bgr15},
-    {"RGB", "BGR;16", rgb2bgr16},
-    {"RGB", "BGR;24", rgb2bgr24},
     {"RGB", "RGBA", rgb2rgba},
     {"RGB", "RGBa", rgb2rgba},
     {"RGB", "RGBX", rgb2rgba},
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index c29473d90db..7f8a50d198e 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -471,12 +471,6 @@ copy2(UINT8 *out, const UINT8 *in, int pixels) {
     memcpy(out, in, pixels * 2);
 }
 
-static void
-copy3(UINT8 *out, const UINT8 *in, int pixels) {
-    /* BGR;24, etc */
-    memcpy(out, in, pixels * 3);
-}
-
 static void
 copy4(UINT8 *out, const UINT8 *in, int pixels) {
     /* RGBA, CMYK quadruples */
@@ -657,9 +651,6 @@ static struct {
     {"I;16", "I;16N", 16, packI16N_I16},  // LibTiff native->image endian.
     {"I;16L", "I;16N", 16, packI16N_I16},
     {"I;16B", "I;16N", 16, packI16N_I16B},
-    {"BGR;15", "BGR;15", 16, copy2},
-    {"BGR;16", "BGR;16", 16, copy2},
-    {"BGR;24", "BGR;24", 24, copy3},
 
     {NULL} /* sentinel */
 };
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 6fe26e1bd1a..4640f078a62 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -151,36 +151,6 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "B");
         strcpy(im->band_names[3], "X");
 
-    } else if (strcmp(mode, "BGR;15") == 0) {
-        /* EXPERIMENTAL */
-        /* 15-bit reversed true colour */
-        im->bands = 3;
-        im->pixelsize = 2;
-        im->linesize = (xsize * 2 + 3) & -4;
-        im->type = IMAGING_TYPE_SPECIAL;
-        /* not allowing arrow due to line length packing */
-        strcpy(im->arrow_band_format, "");
-
-    } else if (strcmp(mode, "BGR;16") == 0) {
-        /* EXPERIMENTAL */
-        /* 16-bit reversed true colour */
-        im->bands = 3;
-        im->pixelsize = 2;
-        im->linesize = (xsize * 2 + 3) & -4;
-        im->type = IMAGING_TYPE_SPECIAL;
-        /* not allowing arrow due to line length packing */
-        strcpy(im->arrow_band_format, "");
-
-    } else if (strcmp(mode, "BGR;24") == 0) {
-        /* EXPERIMENTAL */
-        /* 24-bit reversed true colour */
-        im->bands = 3;
-        im->pixelsize = 3;
-        im->linesize = (xsize * 3 + 3) & -4;
-        im->type = IMAGING_TYPE_SPECIAL;
-        /* not allowing arrow due to line length packing */
-        strcpy(im->arrow_band_format, "");
-
     } else if (strcmp(mode, "RGBX") == 0) {
         /* 32-bit true colour images with padding */
         im->bands = im->pixelsize = 4;
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 9c3ee26655f..976baa72673 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1284,12 +1284,6 @@ copy2(UINT8 *out, const UINT8 *in, int pixels) {
     memcpy(out, in, pixels * 2);
 }
 
-static void
-copy3(UINT8 *out, const UINT8 *in, int pixels) {
-    /* BGR;24 */
-    memcpy(out, in, pixels * 3);
-}
-
 static void
 copy4(UINT8 *out, const UINT8 *in, int pixels) {
     /* RGBA, CMYK quadruples */
@@ -1649,10 +1643,6 @@ static struct {
     {"RGB", "B;16B", 16, band216B},
     {"RGB", "CMYK", 32, cmyk2rgb},
 
-    {"BGR;15", "BGR;15", 16, copy2},
-    {"BGR;16", "BGR;16", 16, copy2},
-    {"BGR;24", "BGR;24", 24, copy3},
-
     /* true colour w. alpha */
     {"RGBA", "LA", 16, unpackRGBALA},
     {"RGBA", "LA;16B", 32, unpackRGBALA16B},

From 5d4a05465d064147951178e140520d704b1092f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:06:00 +1000
Subject: [PATCH 1835/2374] Removed Image isImageType()

---
 Tests/test_image.py   |  4 ----
 docs/deprecations.rst | 17 +++++++++--------
 src/PIL/Image.py      | 17 +----------------
 3 files changed, 10 insertions(+), 28 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 1aa810e22ac..83b027aa238 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1132,10 +1132,6 @@ 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, match="Image.isImageType"):
-            assert not Image.isImageType(None)
-
 
 class TestImageBytes:
     @pytest.mark.parametrize("mode", Image.MODES)
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index b4eb1fa4c51..5ecd7de4240 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -123,14 +123,6 @@ ICNS (width, height, scale) sizes
 Setting an ICNS image size to ``(width, height, scale)`` before loading has been
 deprecated. Instead, ``load(scale)`` can be used.
 
-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
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -222,6 +214,15 @@ BGR;15, BGR 16 and BGR;24
 
 The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
 
+Image isImageType()
+^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+.. versionremoved:: 12.0.0
+
+``Image.isImageType(im)`` has been removed. Use ``isinstance(im, Image.Image)``
+instead.
+
 TiffImagePlugin IFD_LEGACY_API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9df253498ea..59168f5e3d1 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -115,21 +115,6 @@ class DecompressionBombError(Exception):
     raise
 
 
-def isImageType(t: Any) -> TypeGuard[Image]:
-    """
-    Checks if an object is an image object.
-
-    .. warning::
-
-       This function is for internal use only.
-
-    :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")
-
-
 #
 # Constants
 
@@ -219,7 +204,7 @@ class Quantize(IntEnum):
     from IPython.lib.pretty import PrettyPrinter
 
     from . import ImageFile, ImageFilter, ImagePalette, ImageQt, TiffImagePlugin
-    from ._typing import CapsuleType, NumpyArray, StrOrBytesPath, TypeGuard
+    from ._typing import CapsuleType, NumpyArray, StrOrBytesPath
 ID: list[str] = []
 OPEN: dict[
     str,

From 1800e580d2310e5b7bb8e958d96c11691f5ce9df Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:07:31 +1000
Subject: [PATCH 1836/2374] Removed ImageFile raise_oserror()

---
 Tests/test_imagefile.py |  5 -----
 docs/deprecations.rst   | 20 ++++++++++----------
 src/PIL/ImageFile.py    | 11 -----------
 3 files changed, 10 insertions(+), 26 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index a9444c26d5b..d4dfb1b6d59 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -151,11 +151,6 @@ def read(self, size: int | None = None) -> bytes:
         # Despite multiple tiles, assert only one tile caused a read of maxblock size
         assert reads.count(im.decodermaxblock) == 1
 
-    def test_raise_oserror(self) -> None:
-        with pytest.warns(DeprecationWarning, match="raise_oserror"):
-            with pytest.raises(OSError):
-                ImageFile.raise_oserror(1)
-
     def test_raise_typeerror(self) -> None:
         with pytest.raises(TypeError):
             parser = ImageFile.Parser()
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 5ecd7de4240..4a208f212db 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.
 
-ImageFile.raise_oserror
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. deprecated:: 10.2.0
-
-``ImageFile.raise_oserror()`` has been deprecated and will be removed in Pillow
-12.0.0 (2025-10-15). The function is undocumented and is only useful for translating
-error codes returned by a codec's ``decode()`` method, which ImageFile already does
-automatically.
-
 IptcImageFile helper functions
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -206,6 +196,16 @@ Removed features
 Deprecated features are only removed in major releases after an appropriate
 period of deprecation has passed.
 
+ImageFile.raise_oserror
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. deprecated:: 10.2.0
+.. versionremoved:: 12.0.0
+
+``ImageFile.raise_oserror()`` has been removed. The function was undocumented and was
+only useful for translating error codes returned by a codec's ``decode()`` method,
+which ImageFile already did automatically.
+
 BGR;15, BGR 16 and BGR;24
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index bf556a2c690..27b27127e79 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -37,7 +37,6 @@
 from typing import IO, Any, NamedTuple, cast
 
 from . import ExifTags, Image
-from ._deprecate import deprecate
 from ._util import DeferredError, is_path
 
 TYPE_CHECKING = False
@@ -83,16 +82,6 @@ def _get_oserror(error: int, *, encoder: bool) -> OSError:
     return OSError(msg)
 
 
-def raise_oserror(error: int) -> OSError:
-    deprecate(
-        "raise_oserror",
-        12,
-        action="It is only useful for translating error codes returned by a codec's "
-        "decode() method, which ImageFile already does automatically.",
-    )
-    raise _get_oserror(error, encoder=False)
-
-
 def _tilesort(t: _Tile) -> int:
     # sort on offset
     return t[2]

From b72b8dd84d121c919c645963a8675b82c5585dfd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:04:08 +1000
Subject: [PATCH 1837/2374] Removed JpegImageFile.huffman_ac and
 JpegImageFile.huffman_dc

---
 Tests/test_file_jpeg.py    |  8 --------
 docs/deprecations.rst      | 17 +++++++++--------
 src/PIL/JpegImagePlugin.py |  7 -------
 3 files changed, 9 insertions(+), 23 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 5afae041287..08e8798079d 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1115,14 +1115,6 @@ 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:
-            assert isinstance(im, JpegImagePlugin.JpegImageFile)
-            with pytest.warns(DeprecationWarning, match="huffman_ac"):
-                assert im.huffman_ac == {}
-            with pytest.warns(DeprecationWarning, match="huffman_dc"):
-                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 4a208f212db..8e065fa8711 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -122,14 +122,6 @@ 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. They
-have been deprecated, and will be removed in Pillow 12 (2025-10-15).
-
 Specific WebP feature checks
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -223,6 +215,15 @@ Image isImageType()
 ``Image.isImageType(im)`` has been removed. Use ``isinstance(im, Image.Image)``
 instead.
 
+JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+.. versionremoved:: 12.0.0
+
+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).
+
 TiffImagePlugin IFD_LEGACY_API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index defe9f773f9..082f3551a17 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -49,7 +49,6 @@
 from ._binary import i32be as i32
 from ._binary import o8
 from ._binary import o16be as o16
-from ._deprecate import deprecate
 from .JpegPresets import presets
 
 TYPE_CHECKING = False
@@ -393,12 +392,6 @@ 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 __getstate__(self) -> list[Any]:
         return super().__getstate__() + [self.layers, self.layer]
 

From cce39084f5f0116e9c149b359223d72e3cbe9f24 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:09:06 +1000
Subject: [PATCH 1838/2374] Removed specific WebP feature checks

---
 Tests/test_features.py      | 15 ---------------
 checks/check_wheel.py       |  3 ---
 docs/deprecations.rst       | 23 +++++++++++------------
 docs/reference/features.rst |  3 ---
 src/PIL/features.py         |  3 ---
 5 files changed, 11 insertions(+), 36 deletions(-)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index d06fb4d841c..520c25b4645 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -55,21 +55,6 @@ def test(name: str, function: Callable[[str], str | None]) -> None:
             test(feature, features.version_feature)
 
 
-def test_webp_transparency() -> None:
-    with pytest.warns(DeprecationWarning, match="transp_webp"):
-        assert (features.check("transp_webp") or False) == features.check_module("webp")
-
-
-def test_webp_mux() -> None:
-    with pytest.warns(DeprecationWarning, match="webp_mux"):
-        assert (features.check("webp_mux") or False) == features.check_module("webp")
-
-
-def test_webp_anim() -> None:
-    with pytest.warns(DeprecationWarning, match="webp_anim"):
-        assert (features.check("webp_anim") or False) == features.check_module("webp")
-
-
 @skip_unless_feature("libjpeg_turbo")
 def test_libjpeg_turbo_version() -> None:
     version = features.version("libjpeg_turbo")
diff --git a/checks/check_wheel.py b/checks/check_wheel.py
index c89d32ed7aa..3d806eb71e2 100644
--- a/checks/check_wheel.py
+++ b/checks/check_wheel.py
@@ -39,9 +39,6 @@ def test_wheel_codecs() -> None:
 
 def test_wheel_features() -> None:
     expected_features = {
-        "webp_anim",
-        "webp_mux",
-        "transp_webp",
         "raqm",
         "fribidi",
         "harfbuzz",
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 8e065fa8711..78c6f1092ef 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -122,16 +122,6 @@ 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.
 
-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).
-
 Get internal pointers to objects
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -222,14 +212,23 @@ JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
 .. versionremoved:: 12.0.0
 
 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).
+have been removed.
+
+Specific WebP feature checks
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+.. versionremoved:: 12.0.0
+
+``features.check("transp_webp")``, ``features.check("webp_mux")`` and
+``features.check("webp_anim")`` have been removed.
 
 TiffImagePlugin IFD_LEGACY_API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. versionremoved:: 11.0.0
 
-``TiffImagePlugin.IFD_LEGACY_API`` was removed, as it was an unused setting.
+``TiffImagePlugin.IFD_LEGACY_API`` has been removed, as it was an unused setting.
 
 PSFile
 ~~~~~~
diff --git a/docs/reference/features.rst b/docs/reference/features.rst
index 381d7830aac..45067ba3587 100644
--- a/docs/reference/features.rst
+++ b/docs/reference/features.rst
@@ -60,9 +60,6 @@ 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/src/PIL/features.py b/src/PIL/features.py
index 573f1d41256..984f7532c7c 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -121,9 +121,6 @@ def get_supported_codecs() -> list[str]:
 
 
 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),
     "raqm": ("PIL._imagingft", "HAVE_RAQM", "raqm_version"),
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
     "harfbuzz": ("PIL._imagingft", "HAVE_HARFBUZZ", "harfbuzz_version"),

From 88018c1c2d42f4554da4733aeec3b06c3740dde8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:12:19 +1000
Subject: [PATCH 1839/2374] Removed id and unsafe_ptrs

---
 Tests/test_image_getim.py |  9 ---------
 docs/deprecations.rst     | 21 +++++++++++----------
 src/_imaging.c            | 35 -----------------------------------
 3 files changed, 11 insertions(+), 54 deletions(-)

diff --git a/Tests/test_image_getim.py b/Tests/test_image_getim.py
index 7b5f7a5890f..07612e5872e 100644
--- a/Tests/test_image_getim.py
+++ b/Tests/test_image_getim.py
@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-import pytest
-
 from .helper import hopper
 
 
@@ -10,10 +8,3 @@ def test_sanity() -> None:
 
     type_repr = repr(type(im.getim()))
     assert "PyCapsule" in type_repr
-
-    with pytest.warns(DeprecationWarning, match="id property"):
-        assert isinstance(im.im.id, int)
-
-    with pytest.warns(DeprecationWarning, match="unsafe_ptrs property"):
-        ptrs = dict(im.im.unsafe_ptrs)
-    assert ptrs.keys() == {"image8", "image32", "image"}
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 78c6f1092ef..3225b6d5220 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -122,16 +122,6 @@ 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.
 
-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.
-
 ExifTags.IFD.Makernote
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -223,6 +213,17 @@ Specific WebP feature checks
 ``features.check("transp_webp")``, ``features.check("webp_mux")`` and
 ``features.check("webp_anim")`` have been removed.
 
+Get internal pointers to objects
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+.. versionremoved:: 12.0.0
+
+``Image.core.ImagingCore.id`` and ``Image.core.ImagingCore.unsafe_ptrs`` have been
+removed. 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.
+
 TiffImagePlugin IFD_LEGACY_API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/src/_imaging.c b/src/_imaging.c
index 7cc1fb1a4b9..8ba2a290856 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -3724,18 +3724,6 @@ _getattr_bands(ImagingObject *self, void *closure) {
     return PyLong_FromLong(self->image->bands);
 }
 
-static PyObject *
-_getattr_id(ImagingObject *self, void *closure) {
-    if (PyErr_WarnEx(
-            PyExc_DeprecationWarning,
-            "id property is deprecated and will be removed in Pillow 12 (2025-10-15)",
-            1
-        ) < 0) {
-        return NULL;
-    }
-    return PyLong_FromSsize_t((Py_ssize_t)self->image);
-}
-
 static void
 _ptr_destructor(PyObject *capsule) {
     PyObject *self = (PyObject *)PyCapsule_GetContext(capsule);
@@ -3750,27 +3738,6 @@ _getattr_ptr(ImagingObject *self, void *closure) {
     return capsule;
 }
 
-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 "
-            "(2025-10-15)",
-            1
-        ) < 0) {
-        return NULL;
-    }
-    return Py_BuildValue(
-        "(sn)(sn)(sn)",
-        "image8",
-        self->image->image8,
-        "image32",
-        self->image->image32,
-        "image",
-        self->image->image
-    );
-}
-
 static PyObject *
 _getattr_readonly(ImagingObject *self, void *closure) {
     return PyLong_FromLong(self->image->read_only);
@@ -3780,9 +3747,7 @@ static struct PyGetSetDef getsetters[] = {
     {"mode", (getter)_getattr_mode},
     {"size", (getter)_getattr_size},
     {"bands", (getter)_getattr_bands},
-    {"id", (getter)_getattr_id},
     {"ptr", (getter)_getattr_ptr},
-    {"unsafe_ptrs", (getter)_getattr_unsafe_ptrs},
     {"readonly", (getter)_getattr_readonly},
     {NULL}
 };

From a7e00fba8bfd6c254682ebe3c25faddb8459655c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:14:26 +1000
Subject: [PATCH 1840/2374] Removed ImageDraw.getdraw hints parameter

---
 Tests/test_imagedraw.py | 5 -----
 docs/deprecations.rst   | 8 ++++++++
 src/PIL/ImageDraw.py    | 8 +-------
 3 files changed, 9 insertions(+), 12 deletions(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 881f9c85dd2..e1dcbc52c61 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1732,8 +1732,3 @@ 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() -> None:
-    with pytest.warns(DeprecationWarning, match="'hints' parameter"):
-        ImageDraw.getdraw(None, [])
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 3225b6d5220..82530f93cab 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -168,6 +168,14 @@ Removed features
 Deprecated features are only removed in major releases after an appropriate
 period of deprecation has passed.
 
+ImageDraw.getdraw hints parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
+
 ImageFile.raise_oserror
 ~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 6cf1ee62659..e95fa91f8b3 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -38,7 +38,6 @@
 from typing import Any, AnyStr, Callable, Union, cast
 
 from . import Image, ImageColor
-from ._deprecate import deprecate
 from ._typing import Coords
 
 # experimental access to the outline API
@@ -1009,16 +1008,11 @@ def Draw(im: Image.Image, mode: str | None = None) -> ImageDraw:
         return ImageDraw(im, mode)
 
 
-def getdraw(
-    im: Image.Image | None = None, hints: list[str] | None = None
-) -> tuple[ImageDraw2.Draw | None, ModuleType]:
+def getdraw(im: Image.Image | None = None) -> tuple[ImageDraw2.Draw | None, ModuleType]:
     """
     :param im: The image to draw in.
-    :param hints: An optional list of hints. Deprecated.
     :returns: A (drawing context, drawing resource factory) tuple.
     """
-    if hints is not None:
-        deprecate("'hints' parameter", 12)
     from . import ImageDraw2
 
     draw = ImageDraw2.Draw(im) if im is not None else None

From 9c9449af346e6bfcbf2fa6573b7ec96a14ddc8c8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 2 Jul 2025 00:00:16 +1000
Subject: [PATCH 1841/2374] Removed support for LibTIFF < 4

---
 Tests/test_file_libtiff.py  | 31 +++----------------------------
 docs/deprecations.rst       | 17 +++++++++--------
 src/PIL/TiffImagePlugin.py  |  7 -------
 src/_imaging.c              | 10 ----------
 src/libImaging/TiffDecode.c | 10 +---------
 5 files changed, 13 insertions(+), 62 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 1ec39eba588..c245a5a9bcb 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -256,19 +256,7 @@ def test_additional_metadata(
 
             im.save(out, tiffinfo=new_ifd)
 
-    @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,
-        ),
-    )
+    @pytest.mark.parametrize("libtiff", (True, False))
     def test_custom_metadata(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path, libtiff: bool
     ) -> None:
@@ -724,8 +712,7 @@ def test_exif_ifd(self) -> None:
 
         with Image.open(out) as reloaded:
             assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
-            if Image.core.libtiff_support_custom_tags:
-                assert reloaded.tag_v2[34665] == 125456
+            assert reloaded.tag_v2[34665] == 125456
 
     def test_crashing_metadata(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
@@ -777,19 +764,7 @@ def test_read_icc(self, monkeypatch: pytest.MonkeyPatch) -> None:
             assert icc_libtiff is not None
         assert icc == icc_libtiff
 
-    @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,
-        ),
-    )
+    @pytest.mark.parametrize("libtiff", (True, False))
     def test_write_icc(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path, libtiff: bool
     ) -> None:
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 82530f93cab..5973038e373 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -77,14 +77,6 @@ The use in :py:mod:`.ImageCms` of input modes and output modes that are not Pill
 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
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. deprecated:: 10.4.0
-
-Support for LibTIFF earlier than version 4 has been deprecated.
-Upgrade to a newer version of LibTIFF instead.
-
 ImageDraw.getdraw hints parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -194,6 +186,15 @@ BGR;15, BGR 16 and BGR;24
 
 The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
 
+Support for LibTIFF earlier than 4
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+Support for LibTIFF earlier than version 4 has been removed.
+Upgrade to a newer version of LibTIFF instead.
+
 Image isImageType()
 ^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index daf20f2e899..c1850f084c0 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -56,7 +56,6 @@
 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 DeferredError, is_path
 from .TiffTags import TYPES
@@ -284,9 +283,6 @@
     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 version 4", 12)
-
 
 def _accept(prefix: bytes) -> bool:
     return prefix.startswith(tuple(PREFIXES))
@@ -1934,9 +1930,6 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             # Custom items are supported for int, float, unicode, string and byte
             # values. Other types and tuples require a tagtype.
             if tag not in TiffTags.LIBTIFF_CORE:
-                if not getattr(Image.core, "libtiff_support_custom_tags", False):
-                    continue
-
                 if tag in TiffTags.TAGS_V2_GROUPS:
                     types[tag] = TiffTags.LONG8
                 elif tag in ifd.tagtype:
diff --git a/src/_imaging.c b/src/_imaging.c
index 8ba2a290856..fbfc0e41ae2 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4352,16 +4352,6 @@ setup_module(PyObject *m) {
         PyObject *v = PyUnicode_FromString(ImagingTiffVersion());
         PyDict_SetItemString(d, "libtiff_version", v ? v : Py_None);
         Py_XDECREF(v);
-
-        // Test for libtiff 4.0 or later, excluding libtiff 3.9.6 and 3.9.7
-        PyObject *support_custom_tags;
-#if TIFFLIB_VERSION >= 20111221 && TIFFLIB_VERSION != 20120218 && \
-    TIFFLIB_VERSION != 20120922
-        support_custom_tags = Py_True;
-#else
-        support_custom_tags = Py_False;
-#endif
-        PyDict_SetItemString(d, "libtiff_support_custom_tags", support_custom_tags);
     }
 #endif
 
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index e289ce4056e..71516fd1b56 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -884,7 +884,6 @@ ImagingLibTiffMergeFieldInfo(
     // Refer to libtiff docs (http://www.simplesystems.org/libtiff/addingtags.html)
     TIFFSTATE *clientstate = (TIFFSTATE *)state->context;
     uint32_t n;
-    int status = 0;
 
     // custom fields added with ImagingLibTiffMergeFieldInfo are only used for
     // decoding, ignore readcount;
@@ -907,14 +906,7 @@ ImagingLibTiffMergeFieldInfo(
 
     n = sizeof(info) / sizeof(info[0]);
 
-    // Test for libtiff 4.0 or later, excluding libtiff 3.9.6 and 3.9.7
-#if TIFFLIB_VERSION >= 20111221 && TIFFLIB_VERSION != 20120218 && \
-    TIFFLIB_VERSION != 20120922
-    status = TIFFMergeFieldInfo(clientstate->tiff, info, n);
-#else
-    TIFFMergeFieldInfo(clientstate->tiff, info, n);
-#endif
-    return status;
+    return TIFFMergeFieldInfo(clientstate->tiff, info, n);
 }
 
 int

From 0a29d6392afeaf6c7e8354dbfa67a1f9268028df Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:29:45 +1000
Subject: [PATCH 1842/2374] Removed IptcImageFile helper functions

---
 Tests/test_file_iptc.py    | 37 +---------------------
 docs/deprecations.rst      | 64 +++++++++++++++++++-------------------
 src/PIL/IptcImagePlugin.py | 24 --------------
 3 files changed, 33 insertions(+), 92 deletions(-)

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 5dca3da2164..3c4c892c8a0 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -1,9 +1,6 @@
 from __future__ import annotations
 
-import sys
-from io import BytesIO, StringIO
-
-import pytest
+from io import BytesIO
 
 from PIL import Image, IptcImagePlugin, TiffImagePlugin, TiffTags
 
@@ -101,35 +98,3 @@ def test_getiptcinfo_tiff_none() -> None:
 
     # Assert
     assert iptc is None
-
-
-def test_i() -> None:
-    # Arrange
-    c = b"a"
-
-    # Act
-    with pytest.warns(DeprecationWarning, match="IptcImagePlugin.i"):
-        ret = IptcImagePlugin.i(c)
-
-    # Assert
-    assert ret == 97
-
-
-def test_dump(monkeypatch: pytest.MonkeyPatch) -> None:
-    # Arrange
-    c = b"abc"
-    # Temporarily redirect stdout
-    mystdout = StringIO()
-    monkeypatch.setattr(sys, "stdout", mystdout)
-
-    # Act
-    with pytest.warns(DeprecationWarning, match="IptcImagePlugin.dump"):
-        IptcImagePlugin.dump(c)
-
-    # Assert
-    assert mystdout.getvalue() == "61 62 63 \n"
-
-
-def test_pad_deprecation() -> None:
-    with pytest.warns(DeprecationWarning, match="IptcImagePlugin.PAD"):
-        assert IptcImagePlugin.PAD == b"\0\0\0\0"
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 5973038e373..06767c20b1b 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,17 +12,6 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
-IptcImageFile helper functions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. deprecated:: 10.2.0
-
-The functions ``IptcImageFile.dump`` and ``IptcImageFile.i``, and the constant
-``IptcImageFile.PAD`` have been deprecated and will be removed in Pillow
-12.0.0 (2025-10-15). These are undocumented helper functions intended
-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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -160,14 +149,6 @@ Removed features
 Deprecated features are only removed in major releases after an appropriate
 period of deprecation has passed.
 
-ImageDraw.getdraw hints parameter
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. deprecated:: 10.4.0
-.. versionremoved:: 12.0.0
-
-The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
-
 ImageFile.raise_oserror
 ~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -178,22 +159,16 @@ ImageFile.raise_oserror
 only useful for translating error codes returned by a codec's ``decode()`` method,
 which ImageFile already did automatically.
 
-BGR;15, BGR 16 and BGR;24
-^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. deprecated:: 10.4.0
-.. versionremoved:: 12.0.0
-
-The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
-
-Support for LibTIFF earlier than 4
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+IptcImageFile helper functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. deprecated:: 10.4.0
+.. deprecated:: 10.2.0
 .. versionremoved:: 12.0.0
 
-Support for LibTIFF earlier than version 4 has been removed.
-Upgrade to a newer version of LibTIFF instead.
+The functions ``IptcImageFile.dump`` and ``IptcImageFile.i``, and the constant
+``IptcImageFile.PAD`` have been removed. These were undocumented helper functions
+intended for internal use, so there is no replacement. They can each be replaced by a
+single line of code using builtin functions in Python.
 
 Image isImageType()
 ^^^^^^^^^^^^^^^^^^^
@@ -233,6 +208,31 @@ removed. They were used for obtaining raw pointers to ``ImagingCore`` internals.
 interact with C code, you can use ``Image.Image.getim()``, which returns a ``Capsule``
 object.
 
+BGR;15, BGR 16 and BGR;24
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
+
+Support for LibTIFF earlier than 4
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+Support for LibTIFF earlier than version 4 has been removed.
+Upgrade to a newer version of LibTIFF instead.
+
+ImageDraw.getdraw hints parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
+
 TiffImagePlugin IFD_LEGACY_API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index fc024d668f2..b1fbb1bf139 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -16,26 +16,16 @@
 #
 from __future__ import annotations
 
-from collections.abc import Sequence
 from io import BytesIO
 from typing import cast
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
 from ._binary import i32be as i32
-from ._deprecate import deprecate
 
 COMPRESSION = {1: "raw", 5: "jpeg"}
 
 
-def __getattr__(name: str) -> bytes:
-    if name == "PAD":
-        deprecate("IptcImagePlugin.PAD", 12)
-        return b"\0\0\0\0"
-    msg = f"module '{__name__}' has no attribute '{name}'"
-    raise AttributeError(msg)
-
-
 #
 # Helpers
 
@@ -48,20 +38,6 @@ def _i8(c: int | bytes) -> int:
     return c if isinstance(c, int) else c[0]
 
 
-def i(c: bytes) -> int:
-    """.. deprecated:: 10.2.0"""
-    deprecate("IptcImagePlugin.i", 12)
-    return _i(c)
-
-
-def dump(c: Sequence[int | bytes]) -> None:
-    """.. deprecated:: 10.2.0"""
-    deprecate("IptcImagePlugin.dump", 12)
-    for i in c:
-        print(f"{_i8(i):02x}", end=" ")
-    print()
-
-
 ##
 # Image plugin for IPTC/NAA datastreams.  To read IPTC/NAA fields
 # from TIFF and JPEG files, use the <b>getiptcinfo</b> function.

From 4301c1fde63e96a32d27f4b2884131506886a415 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:35:12 +1000
Subject: [PATCH 1843/2374] Removed ImageMath eval and options parameters

---
 Tests/test_imagemath_lambda_eval.py |  7 ----
 Tests/test_imagemath_unsafe_eval.py | 10 -----
 docs/deprecations.rst               | 36 ++++++++--------
 src/PIL/ImageMath.py                | 64 ++---------------------------
 4 files changed, 22 insertions(+), 95 deletions(-)

diff --git a/Tests/test_imagemath_lambda_eval.py b/Tests/test_imagemath_lambda_eval.py
index eec76118af0..26c04b9a07b 100644
--- a/Tests/test_imagemath_lambda_eval.py
+++ b/Tests/test_imagemath_lambda_eval.py
@@ -2,8 +2,6 @@
 
 from typing import Any
 
-import pytest
-
 from PIL import Image, ImageMath
 
 
@@ -55,11 +53,6 @@ def test_sanity() -> None:
     )
 
 
-def test_options_deprecated() -> None:
-    with pytest.warns(DeprecationWarning, match="ImageMath.lambda_eval options"):
-        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"
 
diff --git a/Tests/test_imagemath_unsafe_eval.py b/Tests/test_imagemath_unsafe_eval.py
index 60ad6aafa49..5e141a55b4f 100644
--- a/Tests/test_imagemath_unsafe_eval.py
+++ b/Tests/test_imagemath_unsafe_eval.py
@@ -35,16 +35,6 @@ def test_sanity() -> None:
     assert pixel(ImageMath.unsafe_eval("int(float(A)+B)", **images)) == "I 3"
 
 
-def test_eval_deprecated() -> None:
-    with pytest.warns(DeprecationWarning, match="ImageMath.eval"):
-        assert ImageMath.eval("1") == 1
-
-
-def test_options_deprecated() -> None:
-    with pytest.warns(DeprecationWarning, match="ImageMath.unsafe_eval options"):
-        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"
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 06767c20b1b..9eb9650b2f0 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -49,14 +49,6 @@ 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.
-
 Non-image modes in ImageCms
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -94,15 +86,6 @@ ICNS (width, height, scale) sizes
 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.
-
 ExifTags.IFD.Makernote
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -179,6 +162,16 @@ Image isImageType()
 ``Image.isImageType(im)`` has been removed. Use ``isinstance(im, Image.Image)``
 instead.
 
+ImageMath.lambda_eval and ImageMath.unsafe_eval options parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+.. versionremoved:: 12.0.0
+
+The ``options`` parameter in :py:meth:`~PIL.ImageMath.lambda_eval()` and
+:py:meth:`~PIL.ImageMath.unsafe_eval()` has been removed. One or more keyword
+arguments can be used instead.
+
 JpegImageFile.huffman_ac and JpegImageFile.huffman_dc
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -208,6 +201,15 @@ removed. They were used for obtaining raw pointers to ``ImagingCore`` internals.
 interact with C code, you can use ``Image.Image.getim()``, which returns a ``Capsule``
 object.
 
+ImageMath eval()
+^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.3.0
+.. versionremoved:: 12.0.0
+
+``ImageMath.eval()`` has been removed. Use :py:meth:`~PIL.ImageMath.lambda_eval` or
+:py:meth:`~PIL.ImageMath.unsafe_eval` instead.
+
 BGR;15, BGR 16 and BGR;24
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index c33809ced89..d2504b1ae5a 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -21,7 +21,6 @@
 from typing import Any, Callable
 
 from . import Image, _imagingmath
-from ._deprecate import deprecate
 
 
 class _Operand:
@@ -233,11 +232,7 @@ def imagemath_convert(self: _Operand, mode: str) -> _Operand:
 }
 
 
-def lambda_eval(
-    expression: Callable[[dict[str, Any]], Any],
-    options: dict[str, Any] = {},
-    **kw: Any,
-) -> Any:
+def lambda_eval(expression: Callable[[dict[str, Any]], Any], **kw: Any) -> Any:
     """
     Returns the result of an image function.
 
@@ -246,23 +241,13 @@ 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. 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.
     """
 
-    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)
     for k, v in args.items():
         if isinstance(v, Image.Image):
@@ -275,11 +260,7 @@ def lambda_eval(
         return out
 
 
-def unsafe_eval(
-    expression: str,
-    options: dict[str, Any] = {},
-    **kw: Any,
-) -> Any:
+def unsafe_eval(expression: str, **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
@@ -291,29 +272,19 @@ 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. 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.
     """
 
-    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 [*options, *kw]:
+    for k in kw:
         if "__" in k or hasattr(builtins, k):
             msg = f"'{k}' not allowed"
             raise ValueError(msg)
 
-    args.update(options)
     args.update(kw)
     for k, v in args.items():
         if isinstance(v, Image.Image):
@@ -337,32 +308,3 @@ 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 _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.
-
-    ..  deprecated:: 10.3.0
-    """
-
-    deprecate(
-        "ImageMath.eval",
-        12,
-        "ImageMath.lambda_eval or ImageMath.unsafe_eval",
-    )
-    return unsafe_eval(expression, _dict, **kw)

From b4bc43fed2215418d85c022e6fc4eff31bb33ca7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 21:43:42 +1000
Subject: [PATCH 1844/2374] Removed ImageCms constants and versions()

---
 Tests/test_imagecms.py      |  11 ---
 docs/deprecations.rst       | 143 ++++++++++++++++++------------------
 docs/reference/ImageCms.rst |   1 -
 src/PIL/ImageCms.py         |  27 -------
 4 files changed, 72 insertions(+), 110 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index b6db0ab5c1b..8d463d0eb9d 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -54,10 +54,6 @@ def skip_missing() -> None:
 def test_sanity() -> None:
     # basic smoke test.
     # this mostly follows the cms_test outline.
-    with pytest.warns(DeprecationWarning, match="PIL.ImageCms.versions"):
-        v = ImageCms.versions()  # should return four strings
-    assert v[0] == "1.0.0 pil"
-    assert list(map(type, v)) == [str, str, str, str]
 
     # internal version number
     version = features.version_module("littlecms2")
@@ -703,13 +699,6 @@ def test_cmyk_lab() -> None:
 
 
 def test_deprecation() -> None:
-    with pytest.warns(DeprecationWarning, match="ImageCms.DESCRIPTION"):
-        assert ImageCms.DESCRIPTION.strip().startswith("pyCMS")
-    with pytest.warns(DeprecationWarning, match="ImageCms.VERSION"):
-        assert ImageCms.VERSION == "1.0.0 pil"
-    with pytest.warns(DeprecationWarning, match="ImageCms.FLAGS"):
-        assert isinstance(ImageCms.FLAGS, dict)
-
     profile = ImageCmsProfile(ImageCms.createProfile("sRGB"))
     with pytest.warns(DeprecationWarning, match="RGBA;16B"):
         ImageCms.ImageCmsTransform(profile, profile, "RGBA;16B", "RGB")
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 9eb9650b2f0..183abea092b 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,43 +12,6 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
-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``                      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__``
-============================================  ====================================================
-
 Non-image modes in ImageCms
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -153,6 +116,78 @@ The functions ``IptcImageFile.dump`` and ``IptcImageFile.i``, and the constant
 intended 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
+.. versionremoved:: 12.0.0
+
+A number of constants and a function in :py:mod:`.ImageCms` have been removed. 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__``
+============================================  ====================================================
+
+ImageMath eval()
+^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.3.0
+.. versionremoved:: 12.0.0
+
+``ImageMath.eval()`` has been removed. 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
+.. versionremoved:: 12.0.0
+
+The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
+
+Support for LibTIFF earlier than 4
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+Support for LibTIFF earlier than version 4 has been removed.
+Upgrade to a newer version of LibTIFF instead.
+
+ImageDraw.getdraw hints parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
+
 Image isImageType()
 ^^^^^^^^^^^^^^^^^^^
 
@@ -201,40 +236,6 @@ removed. They were used for obtaining raw pointers to ``ImagingCore`` internals.
 interact with C code, you can use ``Image.Image.getim()``, which returns a ``Capsule``
 object.
 
-ImageMath eval()
-^^^^^^^^^^^^^^^^
-
-.. deprecated:: 10.3.0
-.. versionremoved:: 12.0.0
-
-``ImageMath.eval()`` has been removed. 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
-.. versionremoved:: 12.0.0
-
-The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
-
-Support for LibTIFF earlier than 4
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. deprecated:: 10.4.0
-.. versionremoved:: 12.0.0
-
-Support for LibTIFF earlier than version 4 has been removed.
-Upgrade to a newer version of LibTIFF instead.
-
-ImageDraw.getdraw hints parameter
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. deprecated:: 10.4.0
-.. versionremoved:: 12.0.0
-
-The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
-
 TiffImagePlugin IFD_LEGACY_API
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/docs/reference/ImageCms.rst b/docs/reference/ImageCms.rst
index 238390e75f7..4a21236775f 100644
--- a/docs/reference/ImageCms.rst
+++ b/docs/reference/ImageCms.rst
@@ -56,7 +56,6 @@ Functions
 .. autofunction:: get_display_profile
 .. autofunction:: isIntentSupported
 .. autofunction:: profileToProfile
-.. autofunction:: versions
 
 CmsProfile
 ----------
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index a1584f111d4..a90efaeb68b 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -108,20 +108,6 @@
 _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)
-
-
 # --------------------------------------------------------------------.
 
 
@@ -1108,16 +1094,3 @@ def isIntentSupported(
             return -1
     except (AttributeError, OSError, TypeError, ValueError) as v:
         raise PyCMSError(v) from v
-
-
-def versions() -> tuple[str, str | None, str, str]:
-    """
-    (pyCMS) Fetches versions.
-    """
-
-    deprecate(
-        "PIL.ImageCms.versions()",
-        12,
-        '(PIL.features.version("littlecms2"), sys.version, PIL.__version__)',
-    )
-    return _VERSION, core.littlecms_version, sys.version.split()[0], __version__

From 9fbc255ce56c355573fc81dffc73741411fb2d5a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 20:47:58 +1000
Subject: [PATCH 1845/2374] Removed non-image modes in ImageCms

---
 Tests/test_imagecms.py | 14 --------------
 docs/deprecations.rst  | 19 ++++++++++---------
 src/PIL/ImageCms.py    | 30 ++----------------------------
 3 files changed, 12 insertions(+), 51 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 8d463d0eb9d..55a4a87fb2f 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -673,12 +673,6 @@ 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")
-    with pytest.warns(DeprecationWarning, match="ABCDEFGHI"):
-        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))
@@ -696,11 +690,3 @@ 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:
-    profile = ImageCmsProfile(ImageCms.createProfile("sRGB"))
-    with pytest.warns(DeprecationWarning, match="RGBA;16B"):
-        ImageCms.ImageCmsTransform(profile, profile, "RGBA;16B", "RGB")
-    with pytest.warns(DeprecationWarning, match="RGBA;16B"):
-        ImageCms.ImageCmsTransform(profile, profile, "RGB", "RGBA;16B")
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 183abea092b..772e88147e5 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,15 +12,6 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
-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.
-
 ImageDraw.getdraw hints parameter
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -171,6 +162,16 @@ BGR;15, BGR 16 and BGR;24
 
 The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
 
+Non-image modes in ImageCms
+^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 10.4.0
+.. versionremoved:: 12.0.0
+
+The use in :py:mod:`.ImageCms` of input modes and output modes that are not Pillow
+image modes has been removed. Defaulting to "L" or "1" if the mode cannot be mapped has
+also been removed.
+
 Support for LibTIFF earlier than 4
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index a90efaeb68b..d3555694a51 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,10 +23,9 @@
 import sys
 from enum import IntEnum, IntFlag
 from functools import reduce
-from typing import Any, Literal, SupportsFloat, SupportsInt, Union
+from typing import Literal, SupportsFloat, SupportsInt, Union
 
-from . import Image, __version__
-from ._deprecate import deprecate
+from . import Image
 from ._typing import SupportsRead
 
 try:
@@ -287,31 +286,6 @@ 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

From aaf217cea0888a8f07d3c7ccbbf200114c5c0012 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 21:15:08 +1000
Subject: [PATCH 1846/2374] Removed ICNS (width, height, scale) sizes

---
 Tests/test_file_icns.py    | 12 +-----------
 docs/deprecations.rst      | 16 ++++++++--------
 src/PIL/IcnsImagePlugin.py | 32 +++++++++++---------------------
 3 files changed, 20 insertions(+), 40 deletions(-)

diff --git a/Tests/test_file_icns.py b/Tests/test_file_icns.py
index 8ff59161ff3..b9b81850665 100644
--- a/Tests/test_file_icns.py
+++ b/Tests/test_file_icns.py
@@ -93,21 +93,11 @@ def test_sizes() -> None:
     with Image.open(TEST_FILE) as im:
         assert isinstance(im, IcnsImagePlugin.IcnsImageFile)
         for w, h, r in im.info["sizes"]:
-            wr = w * r
-            hr = h * r
-            with pytest.warns(
-                DeprecationWarning, match=r"Setting size to \(width, height, scale\)"
-            ):
-                im.size = (w, h, r)
-            im.load()
-            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)
+            assert im.size == (w * r, h * r)
 
         # Check that we cannot load an incorrect size
         with pytest.raises(ValueError):
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 772e88147e5..e2c74f2a21a 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -32,14 +32,6 @@ vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 
 .. _2.10.4: https://sourceforge.net/projects/freetype/files/freetype2/2.10.4/
 
-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.
-
 ExifTags.IFD.Makernote
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -189,6 +181,14 @@ ImageDraw.getdraw hints parameter
 
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
 
+ICNS (width, height, scale) sizes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+
+Setting an ICNS image size to ``(width, height, scale)`` before loading has been
+removed. Instead, ``load(scale)`` can be used.
+
 Image isImageType()
 ^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 5a88429e5e4..197ea7a2bb2 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -25,7 +25,6 @@
 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,34 +274,25 @@ def _open(self) -> None:
             self.best_size[1] * self.best_size[2],
         )
 
-    @property  # type: ignore[override]
-    def size(self) -> tuple[int, int] | tuple[int, int, int]:
+    @property
+    def size(self) -> tuple[int, int]:
         return self._size
 
     @size.setter
-    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  # type: ignore[assignment]
+    def size(self, value: tuple[int, int]) -> None:
+        # 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
-        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
+        if scale is not None:
             width, height = self.size[:2]
             self.size = width * scale, height * scale
             self.best_size = width, height, scale

From 92bafe6b88d903d06f0eeba2f1dd26dd0eea52bb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 21:44:33 +1000
Subject: [PATCH 1847/2374] Removed support for FreeType <= 2.9.0

---
 Tests/test_imagefont.py | 39 ---------------------------------------
 docs/deprecations.rst   | 33 +++++++++++++++++----------------
 src/PIL/ImageFont.py    | 17 +----------------
 3 files changed, 18 insertions(+), 71 deletions(-)

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 9334d30e4f6..4565d35bab7 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -11,7 +11,6 @@
 from typing import Any, BinaryIO
 
 import pytest
-from packaging.version import parse as parse_version
 
 from PIL import Image, ImageDraw, ImageFont, features
 from PIL._typing import StrOrBytesPath
@@ -691,16 +690,6 @@ def test_complex_font_settings() -> None:
 
 
 def test_variation_get(font: ImageFont.FreeTypeFont) -> None:
-    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()
-        with pytest.raises(NotImplementedError):
-            font.get_variation_axes()
-        return
-
     with pytest.raises(OSError):
         font.get_variation_names()
     with pytest.raises(OSError):
@@ -763,14 +752,6 @@ def _check_text(font: ImageFont.FreeTypeFont, path: str, epsilon: float) -> None
 
 
 def test_variation_set_by_name(font: ImageFont.FreeTypeFont) -> None:
-    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")
-        return
-
     with pytest.raises(OSError):
         font.set_variation_by_name("Bold")
 
@@ -790,14 +771,6 @@ def test_variation_set_by_name(font: ImageFont.FreeTypeFont) -> None:
 
 
 def test_variation_set_by_axes(font: ImageFont.FreeTypeFont) -> None:
-    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])
-        return
-
     with pytest.raises(OSError):
         font.set_variation_by_axes([500, 50])
 
@@ -1209,15 +1182,3 @@ 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: str) -> str:
-        return "2.9.0"
-
-    monkeypatch.setattr(features, "version_module", fake_version_module)
-
-    # Act / Assert
-    with pytest.warns(DeprecationWarning, match="FreeType 2.9.0"):
-        ImageFont.truetype(FONT_PATH, FONT_SIZE)
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index e2c74f2a21a..2365545656f 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -19,19 +19,6 @@ 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/
-
 ExifTags.IFD.Makernote
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -79,7 +66,7 @@ Deprecated features are only removed in major releases after an appropriate
 period of deprecation has passed.
 
 ImageFile.raise_oserror
-~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 10.2.0
 .. versionremoved:: 12.0.0
@@ -89,7 +76,7 @@ only useful for translating error codes returned by a codec's ``decode()`` metho
 which ImageFile already did automatically.
 
 IptcImageFile helper functions
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 10.2.0
 .. versionremoved:: 12.0.0
@@ -100,7 +87,7 @@ intended for internal use, so there is no replacement. They can each be replaced
 single line of code using builtin functions in Python.
 
 ImageCms constants and versions() function
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 10.3.0
 .. versionremoved:: 12.0.0
@@ -181,6 +168,20 @@ ImageDraw.getdraw hints parameter
 
 The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
 
+FreeType 2.9.0
+^^^^^^^^^^^^^^
+
+.. deprecated:: 11.0.0
+.. versionremoved:: 12.0.0
+
+Support for FreeType 2.9.0 has been removed. FreeType 2.9.1 is the minimum version
+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/
+
 ICNS (width, height, scale) sizes
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 329c463ff86..bf3f471f5e3 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -36,7 +36,7 @@
 from types import ModuleType
 from typing import IO, Any, BinaryIO, TypedDict, cast
 
-from . import Image, features
+from . import Image
 from ._typing import StrOrBytesPath
 from ._util import DeferredError, is_path
 
@@ -236,21 +236,6 @@ 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 0e3aac1ed18e5fa55a9fa7ef1956eccbc4b32ed7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 21:19:30 +1000
Subject: [PATCH 1848/2374] Updated deprecation timeline

---
 Tests/test_deprecate.py | 20 ++++++++++----------
 src/PIL/_deprecate.py   |  2 --
 2 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/Tests/test_deprecate.py b/Tests/test_deprecate.py
index 88479ff0d1d..1e98ecfff37 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -9,9 +9,9 @@
     "version, expected",
     [
         (
-            12,
-            "Old thing is deprecated and will be removed in Pillow 12 "
-            r"\(2025-10-15\)\. Use new thing instead\.",
+            13,
+            "Old thing is deprecated and will be removed in Pillow 13 "
+            r"\(2026-10-15\)\. Use new thing instead\.",
         ),
         (
             None,
@@ -53,18 +53,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 12 \(2025-10-15\)\. "
+        r"Old things are deprecated and will be removed in Pillow 13 \(2026-10-15\)\. "
         r"Use new thing instead\."
     )
     with pytest.warns(DeprecationWarning, match=expected):
-        _deprecate.deprecate("Old things", 12, "new thing", plural=True)
+        _deprecate.deprecate("Old things", 13, "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", 12, replacement="new thing", action="Upgrade to new thing"
+            "Old thing", 13, replacement="new thing", action="Upgrade to new thing"
         )
 
 
@@ -77,16 +77,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 12 \(2025-10-15\)\. "
+        r"Old thing is deprecated and will be removed in Pillow 13 \(2026-10-15\)\. "
         r"Upgrade to new thing\."
     )
     with pytest.warns(DeprecationWarning, match=expected):
-        _deprecate.deprecate("Old thing", 12, action=action)
+        _deprecate.deprecate("Old thing", 13, action=action)
 
 
 def test_no_replacement_or_action() -> None:
     expected = (
-        r"Old thing is deprecated and will be removed in Pillow 12 \(2025-10-15\)"
+        r"Old thing is deprecated and will be removed in Pillow 13 \(2026-10-15\)"
     )
     with pytest.warns(DeprecationWarning, match=expected):
-        _deprecate.deprecate("Old thing", 12)
+        _deprecate.deprecate("Old thing", 13)
diff --git a/src/PIL/_deprecate.py b/src/PIL/_deprecate.py
index 170d4449049..616a9aace9f 100644
--- a/src/PIL/_deprecate.py
+++ b/src/PIL/_deprecate.py
@@ -46,8 +46,6 @@ def deprecate(
     elif when <= int(__version__.split(".")[0]):
         msg = f"{deprecated} {is_} deprecated and should be removed."
         raise RuntimeError(msg)
-    elif when == 12:
-        removed = "Pillow 12 (2025-10-15)"
     elif when == 13:
         removed = "Pillow 13 (2026-10-15)"
     else:

From f2417d8b390b3205a01795491dd45ebacd88800b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 21:42:32 +1000
Subject: [PATCH 1849/2374] Added release notes

---
 docs/releasenotes/12.0.0.rst   | 140 +++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst    |   1 +
 docs/releasenotes/template.rst |   2 +
 3 files changed, 143 insertions(+)
 create mode 100644 docs/releasenotes/12.0.0.rst

diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
new file mode 100644
index 00000000000..68b6644438f
--- /dev/null
+++ b/docs/releasenotes/12.0.0.rst
@@ -0,0 +1,140 @@
+12.0.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards incompatible changes
+==============================
+
+ImageFile.raise_oserror
+^^^^^^^^^^^^^^^^^^^^^^^
+
+``ImageFile.raise_oserror()`` has been removed. The function was undocumented and was
+only useful for translating error codes returned by a codec's ``decode()`` method,
+which ImageFile already did automatically.
+
+IptcImageFile helper functions
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The functions ``IptcImageFile.dump`` and ``IptcImageFile.i``, and the constant
+``IptcImageFile.PAD`` have been removed. These were undocumented helper functions
+intended 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
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+A number of constants and a function in :py:mod:`.ImageCms` have been removed. 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__``
+============================================  ====================================================
+
+ImageMath eval()
+^^^^^^^^^^^^^^^^
+
+``ImageMath.eval()`` has been removed. Use :py:meth:`~PIL.ImageMath.lambda_eval` or
+:py:meth:`~PIL.ImageMath.unsafe_eval` instead.
+
+BGR;15, BGR 16 and BGR;24
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The experimental BGR;15, BGR;16 and BGR;24 modes have been removed.
+
+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 removed. Defaulting to "L" or "1" if the mode cannot be mapped has
+also been removed.
+
+Support for LibTIFF earlier than 4
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Support for LibTIFF earlier than version 4 has been removed.
+Upgrade to a newer version of LibTIFF instead.
+
+ImageDraw.getdraw hints parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been removed.
+
+FreeType 2.9.0
+^^^^^^^^^^^^^^
+
+Support for FreeType 2.9.0 has been removed. FreeType 2.9.1 is the minimum version
+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/
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+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 a85f1e0752e..f66240c8957 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
 
+  12.0.0
   11.3.0
   11.2.1
   11.1.0
diff --git a/docs/releasenotes/template.rst b/docs/releasenotes/template.rst
index a453d2a436d..b603a9938c5 100644
--- a/docs/releasenotes/template.rst
+++ b/docs/releasenotes/template.rst
@@ -20,6 +20,8 @@ Backwards incompatible changes
 TODO
 ^^^^
 
+TODO
+
 Deprecations
 ============
 

From 5554e778bba52f2414d0151642a2906aed254ad2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Jul 2025 13:18:48 +1000
Subject: [PATCH 1850/2374] Removed unnecessary checks

---
 src/libImaging/AlphaComposite.c | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/libImaging/AlphaComposite.c b/src/libImaging/AlphaComposite.c
index 6d728f9088b..e14af0dea1a 100644
--- a/src/libImaging/AlphaComposite.c
+++ b/src/libImaging/AlphaComposite.c
@@ -25,13 +25,11 @@ ImagingAlphaComposite(Imaging imDst, Imaging imSrc) {
     int x, y;
 
     /* Check arguments */
-    if (!imDst || !imSrc || strcmp(imDst->mode, "RGBA") ||
-        imDst->type != IMAGING_TYPE_UINT8 || imDst->bands != 4) {
+    if (!imDst || !imSrc || strcmp(imDst->mode, "RGBA")) {
         return ImagingError_ModeError();
     }
 
-    if (strcmp(imDst->mode, imSrc->mode) || imDst->type != imSrc->type ||
-        imDst->bands != imSrc->bands || imDst->xsize != imSrc->xsize ||
+    if (strcmp(imDst->mode, imSrc->mode) || imDst->xsize != imSrc->xsize ||
         imDst->ysize != imSrc->ysize) {
         return ImagingError_Mismatch();
     }

From 3152da47355ed3f9b342dc94de8a2214798842c4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Jul 2025 13:51:18 +1000
Subject: [PATCH 1851/2374] Allow alpha_composite to use LA images

---
 Tests/test_image.py             | 31 +++++++++++++++++++++++++++++++
 src/PIL/Image.py                |  5 ++---
 src/libImaging/AlphaComposite.c |  3 ++-
 3 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 6b8b6d42b07..e4c25693a85 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -398,6 +398,37 @@ def test_alpha_composite(self) -> None:
         assert img_colors is not None
         assert sorted(img_colors) == expected_colors
 
+    def test_alpha_composite_la(self) -> None:
+        # Arrange
+        expected_colors = sorted(
+            [
+                (3300, (255, 255)),
+                (1156, (170, 192)),
+                (1122, (128, 255)),
+                (1089, (0, 0)),
+                (1122, (255, 128)),
+                (1122, (0, 128)),
+                (1089, (0, 255)),
+            ]
+        )
+
+        dst = Image.new("LA", size=(100, 100), color=(0, 255))
+        draw = ImageDraw.Draw(dst)
+        draw.rectangle((0, 33, 100, 66), fill=(0, 128))
+        draw.rectangle((0, 67, 100, 100), fill=(0, 0))
+        src = Image.new("LA", size=(100, 100), color=(255, 255))
+        draw = ImageDraw.Draw(src)
+        draw.rectangle((33, 0, 66, 100), fill=(255, 128))
+        draw.rectangle((67, 0, 100, 100), fill=(255, 0))
+
+        # Act
+        img = Image.alpha_composite(dst, src)
+
+        # Assert
+        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")
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index d209405c4c5..f4f1eea7914 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3588,9 +3588,8 @@ def alpha_composite(im1: Image, im2: Image) -> Image:
     """
     Alpha composite im2 over im1.
 
-    :param im1: The first image. Must have mode RGBA.
-    :param im2: The second image.  Must have mode RGBA, and the same size as
-       the first image.
+    :param im1: The first image. Must have mode RGBA or LA.
+    :param im2: The second image. Must have the same mode and size as the first image.
     :returns: An :py:class:`~PIL.Image.Image` object.
     """
 
diff --git a/src/libImaging/AlphaComposite.c b/src/libImaging/AlphaComposite.c
index e14af0dea1a..44c45167946 100644
--- a/src/libImaging/AlphaComposite.c
+++ b/src/libImaging/AlphaComposite.c
@@ -25,7 +25,8 @@ ImagingAlphaComposite(Imaging imDst, Imaging imSrc) {
     int x, y;
 
     /* Check arguments */
-    if (!imDst || !imSrc || strcmp(imDst->mode, "RGBA")) {
+    if (!imDst || !imSrc ||
+        (strcmp(imDst->mode, "RGBA") && strcmp(imDst->mode, "LA"))) {
         return ImagingError_ModeError();
     }
 

From 1ee91f22ba4ecf8fabf7b2de4ac9b3eafe5c168e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Jul 2025 22:51:02 +1000
Subject: [PATCH 1852/2374] 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 a56f9431652..c2227f1d29f 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 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13| 11.2.1           |arm           |
+| macOS 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13| 11.3.0           |arm           |
 |                                  +----------------------------+------------------+              |
 |                                  | 3.8                        | 10.4.0           |              |
 +----------------------------------+----------------------------+------------------+--------------+

From a84458ffbd56d59d59e0f6d750ba771e71596b4c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Jul 2025 11:45:02 +1000
Subject: [PATCH 1853/2374] Revert "Work around pyroma test"

This reverts commit d8a0cb5db104cc5d9acc6b4ba1ba871636132f51.
---
 Tests/test_pyroma.py | 10 ++--------
 1 file changed, 2 insertions(+), 8 deletions(-)

diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index 9669f485a6f..a161d3f05c4 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -25,11 +25,5 @@ def test_pyroma() -> None:
         )
 
     else:
-        # Should have a perfect score, but pyroma does not support PEP 639 yet.
-        assert rating == (
-            9,
-            [
-                "Your package does neither have a license field "
-                "nor any license classifiers."
-            ],
-        )
+        # Should have a perfect score
+        assert rating == (10, [])

From 756dd04705be059136a77ba473e1e708a52711fa Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 7 Jul 2025 19:09:39 +1000
Subject: [PATCH 1854/2374] Removed reference to libtiff 3.x

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

diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 8988a92ce36..45cf5295c50 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -44,7 +44,7 @@ Many of Pillow's features require external libraries:
 
 * **libtiff** provides compressed TIFF functionality
 
-  * Pillow has been tested with libtiff versions **3.x** and **4.0-4.7.0**
+  * Pillow has been tested with libtiff versions **4.0-4.7.0**
 
 * **libfreetype** provides type related services
 

From 14b0cebfc1c1acb0de44520c63de7294be1d59a5 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 7 Jul 2025 17:16:48 +0000
Subject: [PATCH 1855/2374] [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.12.0 → v0.12.2](https://github.com/astral-sh/ruff-pre-commit/compare/v0.12.0...v0.12.2)
- [github.com/PyCQA/bandit: 1.8.5 → 1.8.6](https://github.com/PyCQA/bandit/compare/1.8.5...1.8.6)
- [github.com/pre-commit/mirrors-clang-format: v20.1.6 → v20.1.7](https://github.com/pre-commit/mirrors-clang-format/compare/v20.1.6...v20.1.7)
- [github.com/python-jsonschema/check-jsonschema: 0.33.1 → 0.33.2](https://github.com/python-jsonschema/check-jsonschema/compare/0.33.1...0.33.2)
- [github.com/woodruffw/zizmor-pre-commit: v1.9.0 → v1.11.0](https://github.com/woodruffw/zizmor-pre-commit/compare/v1.9.0...v1.11.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 d5fd964f128..75c7d36324e 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.12.0
+    rev: v0.12.2
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
@@ -11,7 +11,7 @@ repos:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.8.5
+    rev: 1.8.6
     hooks:
     - id: bandit
       args: [--severity-level=high]
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$|\.patch$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v20.1.6
+    rev: v20.1.7
     hooks:
       - id: clang-format
         types: [c]
@@ -51,14 +51,14 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.33.1
+    rev: 0.33.2
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/woodruffw/zizmor-pre-commit
-    rev: v1.9.0
+    rev: v1.11.0
     hooks:
       - id: zizmor
 

From 4cfef00574803a64fbab26d2400fe1f39521cbbc Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Jul 2025 16:33:22 +1000
Subject: [PATCH 1856/2374] Added "Colors" to concepts

---
 docs/handbook/concepts.rst     | 22 ++++++++++++++++++++++
 docs/reference/ImageDraw.rst   |  4 +---
 docs/reference/PixelAccess.rst |  2 +-
 src/PIL/Image.py               | 24 +++++++++++++-----------
 4 files changed, 37 insertions(+), 15 deletions(-)

diff --git a/docs/handbook/concepts.rst b/docs/handbook/concepts.rst
index c9d3f5e91cb..46f612be3b2 100644
--- a/docs/handbook/concepts.rst
+++ b/docs/handbook/concepts.rst
@@ -101,6 +101,28 @@ Palette
 The palette mode (``P``) uses a color palette to define the actual color for
 each pixel.
 
+.. _colors:
+
+Colors
+------
+
+To specify colors, you can use tuples with a value for each channel in the image, e.g.
+``Image.new("RGB", (1, 1), (255, 0, 0))``.
+
+If an image has a single channel, you can use a single number instead, e.g.
+``Image.new("L", (1, 1), 255)``. For "F" mode images, floating point values are also
+accepted. In the case of "P" mode images, these will be indexes for the color palette.
+
+If a single value is used for an image with more than one channel, it will still be
+parsed::
+
+    >>> from PIL import Image
+    >>> im = Image.new("RGBA", (1, 1), 0x04030201)
+    >>> im.getpixel((0, 0))
+    (1, 2, 3, 4)
+
+Some methods accept other forms, such as color names. See :ref:`color-names`.
+
 Info
 ----
 
diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 6e73233a1ce..4a2223a40c5 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -45,9 +45,7 @@ Colors
 ^^^^^^
 
 To specify colors, you can use numbers or tuples just as you would use with
-:py:meth:`PIL.Image.new` or :py:meth:`PIL.Image.Image.putpixel`. For “1”,
-“L”, and “I” images, use integers. For “RGB” images, use a 3-tuple containing
-integer values. For “F” images, use integer or floating point values.
+:py:meth:`PIL.Image.new`. See :ref:`colors` for more information.
 
 For palette images (mode “P”), use integers as color indexes. In 1.1.4 and
 later, you can also use RGB 3-tuples or color names (see below). The drawing
diff --git a/docs/reference/PixelAccess.rst b/docs/reference/PixelAccess.rst
index 9d7cf83b640..e4af94b9f18 100644
--- a/docs/reference/PixelAccess.rst
+++ b/docs/reference/PixelAccess.rst
@@ -59,7 +59,7 @@ Access using negative indexes is also possible. ::
 
         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. See :ref:`colors` for more information.
 
         :param xy: The pixel coordinate, given as (x, y).
         :param color: The pixel value according to its mode,
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 59168f5e3d1..262b5478b62 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1730,9 +1730,10 @@ def paste(
         details).
 
         Instead of an image, the source can be a integer or tuple
-        containing pixel values.  The method then fills the region
-        with the given color.  When creating RGB images, you can
-        also use color strings as supported by the ImageColor module.
+        containing pixel values. The method then fills the region
+        with the given color. When creating RGB images, you can
+        also use color strings as supported by the ImageColor module. See
+        :ref:`colors` for more information.
 
         If a mask is given, this method updates only the regions
         indicated by the mask. You can use either "1", "L", "LA", "RGBA"
@@ -1988,7 +1989,8 @@ def putdata(
         sequence ends. The scale and offset values are used to adjust the
         sequence values: **pixel = value*scale + offset**.
 
-        :param data: A flattened sequence object.
+        :param data: A flattened sequence object. See :ref:`colors` for more
+            information about values.
         :param scale: An optional scale value.  The default is 1.0.
         :param offset: An optional offset value.  The default is 0.0.
         """
@@ -2047,7 +2049,7 @@ def putpixel(
         Modifies the pixel at the given position. 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.
+        accepted for P and PA images. See :ref:`colors` for more information.
 
         Note that this method is relatively slow.  For more extensive changes,
         use :py:meth:`~PIL.Image.Image.paste` or the :py:mod:`~PIL.ImageDraw`
@@ -3055,12 +3057,12 @@ def new(
     :param mode: The mode to use for the new image. See:
        :ref:`concept-modes`.
     :param size: A 2-tuple, containing (width, height) in pixels.
-    :param color: What color to use for the image.  Default is black.
-       If given, this should be a single integer or floating point value
-       for single-band modes, and a tuple for multi-band modes (one value
-       per band).  When creating RGB or HSV images, you can also use color
-       strings as supported by the ImageColor module.  If the color is
-       None, the image is not initialised.
+    :param color: What color to use for the image. Default is black. If given,
+       this should be a single integer or floating point value for single-band
+       modes, and a tuple for multi-band modes (one value per band). When
+       creating RGB or HSV images, you can also use color strings as supported
+       by the ImageColor module. See :ref:`colors` for more information. If the
+       color is None, the image is not initialised.
     :returns: An :py:class:`~PIL.Image.Image` object.
     """
 

From e88f3120291cc208d8d1b46e3766fdbc1cfada82 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 5 Jul 2025 12:57:07 +1000
Subject: [PATCH 1857/2374] Fix unclosed file warning

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

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index c245a5a9bcb..958e2749f61 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -873,8 +873,8 @@ def test_lzma(self, capfd: pytest.CaptureFixture[str]) -> None:
                 assert im.mode == "RGB"
                 assert im.size == (128, 128)
                 assert im.format == "TIFF"
-                im2 = hopper()
-                assert_image_similar(im, im2, 5)
+                with hopper() as im2:
+                    assert_image_similar(im, im2, 5)
         except OSError:
             captured = capfd.readouterr()
             if "LZMA compression support is not configured" in captured.err:

From dc7d646db03bb34abd493a79ec2ceb78ec778265 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 1 Jul 2025 22:52:23 +1000
Subject: [PATCH 1858/2374] Use correct bands for 2 band histograms

---
 Tests/test_image_histogram.py |  3 +++
 src/libImaging/Histo.c        | 14 +++++++++-----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/Tests/test_image_histogram.py b/Tests/test_image_histogram.py
index dbd55d4c2d3..436eb78a26e 100644
--- a/Tests/test_image_histogram.py
+++ b/Tests/test_image_histogram.py
@@ -10,9 +10,12 @@ def histogram(mode: str) -> tuple[int, int, int]:
 
     assert histogram("1") == (256, 0, 10994)
     assert histogram("L") == (256, 0, 662)
+    assert histogram("LA") == (512, 0, 16384)
+    assert histogram("La") == (512, 0, 16384)
     assert histogram("I") == (256, 0, 662)
     assert histogram("F") == (256, 0, 662)
     assert histogram("P") == (256, 0, 1551)
+    assert histogram("PA") == (512, 0, 16384)
     assert histogram("RGB") == (768, 4, 675)
     assert histogram("RGBA") == (1024, 0, 16384)
     assert histogram("CMYK") == (1024, 0, 16384)
diff --git a/src/libImaging/Histo.c b/src/libImaging/Histo.c
index c5a547a647b..87c09d3d4ca 100644
--- a/src/libImaging/Histo.c
+++ b/src/libImaging/Histo.c
@@ -132,11 +132,15 @@ ImagingGetHistogram(Imaging im, Imaging imMask, void *minmax) {
                     ImagingSectionEnter(&cookie);
                     for (y = 0; y < im->ysize; y++) {
                         UINT8 *in = (UINT8 *)im->image[y];
-                        for (x = 0; x < im->xsize; x++) {
-                            h->histogram[(*in++)]++;
-                            h->histogram[(*in++) + 256]++;
-                            h->histogram[(*in++) + 512]++;
-                            h->histogram[(*in++) + 768]++;
+                        for (x = 0; x < im->xsize; x++, in += 4) {
+                            h->histogram[*in]++;
+                            if (im->bands == 2) {
+                                h->histogram[*(in + 3) + 256]++;
+                            } else {
+                                h->histogram[*(in + 1) + 256]++;
+                                h->histogram[*(in + 2) + 512]++;
+                                h->histogram[*(in + 3) + 768]++;
+                            }
                         }
                     }
                     ImagingSectionLeave(&cookie);

From 99737228c5a65d5291ecdf4d9718a34a815e8b32 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 8 Jul 2025 06:53:22 +1000
Subject: [PATCH 1859/2374] Only deprecate fromarray mode for changing data
 types

---
 Tests/test_image_array.py | 16 +++++---
 src/PIL/Image.py          | 79 +++++++++++++++++++--------------------
 2 files changed, 49 insertions(+), 46 deletions(-)

diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index ecbce3d6ffa..abb22f94967 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -101,9 +101,8 @@ 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)})
-        with pytest.warns(DeprecationWarning, match="'mode' parameter"):
-            Image.fromarray(wrapped, "L")
+        wrapped = Wrapper({"shape": (1, 1), "strides": (1, 1), "typestr": "|u1"})
+        Image.fromarray(wrapped, "L")
 
 
 def test_fromarray_palette() -> None:
@@ -112,9 +111,16 @@ def test_fromarray_palette() -> None:
     a = numpy.array(i)
 
     # Act
-    with pytest.warns(DeprecationWarning, match="'mode' parameter"):
-        out = Image.fromarray(a, "P")
+    out = Image.fromarray(a, "P")
 
     # Assert that the Python and C palettes match
     assert out.palette is not None
     assert len(out.palette.colors) == len(out.im.getpalette()) / 3
+
+
+def test_deprecation() -> None:
+    a = numpy.array(im.convert("L"))
+    with pytest.warns(
+        DeprecationWarning, match="'mode' parameter for changing data types"
+    ):
+        Image.fromarray(a, "1")
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 59168f5e3d1..e512da9a192 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3251,19 +3251,9 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     transferred. This means that P and PA mode images will lose their palette.
 
     :param obj: Object with array interface
-    :param mode: Optional mode to use when reading ``obj``. Will be determined from
-      type if ``None``. Deprecated.
-
-      This will not be used to convert the data after reading, but will be used to
-      change how the data is read::
-
-        from PIL import Image
-        import numpy as np
-        a = np.full((1, 1), 300)
-        im = Image.fromarray(a, mode="L")
-        im.getpixel((0, 0))  # 44
-        im = Image.fromarray(a, mode="RGB")
-        im.getpixel((0, 0))  # (44, 1, 0)
+    :param mode: Optional mode to use when reading ``obj``. Since pixel values do not
+      contain information about palettes or color spaces, this can be used to place
+      grayscale L mode data within a P mode image, or read RGB data as YCbCr.
 
       See: :ref:`concept-modes` for general information about modes.
     :returns: An image object.
@@ -3274,21 +3264,28 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     shape = arr["shape"]
     ndim = len(shape)
     strides = arr.get("strides", None)
-    if mode is None:
-        try:
-            typekey = (1, 1) + shape[2:], arr["typestr"]
-        except KeyError as e:
+    try:
+        typekey = (1, 1) + shape[2:], arr["typestr"]
+    except KeyError as e:
+        if mode is not None:
+            typekey = None
+            color_modes: list[str] = []
+        else:
             msg = "Cannot handle this data type"
             raise TypeError(msg) from e
+    if typekey is not None:
         try:
-            mode, rawmode = _fromarray_typemap[typekey]
+            typemode, rawmode, color_modes = _fromarray_typemap[typekey]
         except KeyError as e:
             typekey_shape, typestr = typekey
             msg = f"Cannot handle this data type: {typekey_shape}, {typestr}"
             raise TypeError(msg) from e
-    else:
-        deprecate("'mode' parameter", 13)
+    if mode is not None:
+        if mode != typemode and mode not in color_modes:
+            deprecate("'mode' parameter for changing data types", 13)
         rawmode = mode
+    else:
+        mode = typemode
     if mode in ["1", "L", "I", "P", "F"]:
         ndmax = 2
     elif mode == "RGB":
@@ -3385,29 +3382,29 @@ def fromqpixmap(im: ImageQt.QPixmap) -> ImageFile.ImageFile:
 
 
 _fromarray_typemap = {
-    # (shape, typestr) => mode, rawmode
+    # (shape, typestr) => mode, rawmode, color modes
     # first two members of shape are set to one
-    ((1, 1), "|b1"): ("1", "1;8"),
-    ((1, 1), "|u1"): ("L", "L"),
-    ((1, 1), "|i1"): ("I", "I;8"),
-    ((1, 1), "<u2"): ("I", "I;16"),
-    ((1, 1), ">u2"): ("I", "I;16B"),
-    ((1, 1), "<i2"): ("I", "I;16S"),
-    ((1, 1), ">i2"): ("I", "I;16BS"),
-    ((1, 1), "<u4"): ("I", "I;32"),
-    ((1, 1), ">u4"): ("I", "I;32B"),
-    ((1, 1), "<i4"): ("I", "I;32S"),
-    ((1, 1), ">i4"): ("I", "I;32BS"),
-    ((1, 1), "<f4"): ("F", "F;32F"),
-    ((1, 1), ">f4"): ("F", "F;32BF"),
-    ((1, 1), "<f8"): ("F", "F;64F"),
-    ((1, 1), ">f8"): ("F", "F;64BF"),
-    ((1, 1, 2), "|u1"): ("LA", "LA"),
-    ((1, 1, 3), "|u1"): ("RGB", "RGB"),
-    ((1, 1, 4), "|u1"): ("RGBA", "RGBA"),
+    ((1, 1), "|b1"): ("1", "1;8", []),
+    ((1, 1), "|u1"): ("L", "L", ["P"]),
+    ((1, 1), "|i1"): ("I", "I;8", []),
+    ((1, 1), "<u2"): ("I", "I;16", []),
+    ((1, 1), ">u2"): ("I", "I;16B", []),
+    ((1, 1), "<i2"): ("I", "I;16S", []),
+    ((1, 1), ">i2"): ("I", "I;16BS", []),
+    ((1, 1), "<u4"): ("I", "I;32", []),
+    ((1, 1), ">u4"): ("I", "I;32B", []),
+    ((1, 1), "<i4"): ("I", "I;32S", []),
+    ((1, 1), ">i4"): ("I", "I;32BS", []),
+    ((1, 1), "<f4"): ("F", "F;32F", []),
+    ((1, 1), ">f4"): ("F", "F;32BF", []),
+    ((1, 1), "<f8"): ("F", "F;64F", []),
+    ((1, 1), ">f8"): ("F", "F;64BF", []),
+    ((1, 1, 2), "|u1"): ("LA", "LA", ["La", "PA"]),
+    ((1, 1, 3), "|u1"): ("RGB", "RGB", ["YCbCr", "LAB", "HSV"]),
+    ((1, 1, 4), "|u1"): ("RGBA", "RGBA", ["RGBa"]),
     # shortcuts:
-    ((1, 1), f"{_ENDIAN}i4"): ("I", "I"),
-    ((1, 1), f"{_ENDIAN}f4"): ("F", "F"),
+    ((1, 1), f"{_ENDIAN}i4"): ("I", "I", []),
+    ((1, 1), f"{_ENDIAN}f4"): ("F", "F", []),
 }
 
 

From 06f5cd1ddecea64d44f417bba539dc0b30734ea4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 8 Jul 2025 11:31:03 +1000
Subject: [PATCH 1860/2374] Restored manylinux2014 wheels (#9059)

---
 .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 52a3f2cdb2a..5cc4f03552c 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -77,22 +77,22 @@ jobs:
             platform: linux
             os: ubuntu-latest
             cibw_arch: x86_64
+            manylinux: "manylinux2014"
           - name: "manylinux_2_28 x86_64"
             platform: linux
             os: ubuntu-latest
             cibw_arch: x86_64
             build: "*manylinux*"
-            manylinux: "manylinux_2_28"
           - name: "manylinux2014 and musllinux aarch64"
             platform: linux
             os: ubuntu-24.04-arm
             cibw_arch: aarch64
+            manylinux: "manylinux2014"
           - name: "manylinux_2_28 aarch64"
             platform: linux
             os: ubuntu-24.04-arm
             cibw_arch: aarch64
             build: "*manylinux*"
-            manylinux: "manylinux_2_28"
           - name: "iOS arm64 device"
             platform: ios
             os: macos-latest

From 2195faf0dc739f4d46f5d77a4a323b5358f079af Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 8 Jul 2025 13:44:13 +1000
Subject: [PATCH 1861/2374] Update dependency cibuildwheel to v3.0.1 (#9075)

---
 .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 520b6e32084..e1eb52eb8ae 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.0.0
+cibuildwheel==3.0.1

From c9cf688ee7ef50dc1bd4531f19514508ae68a8e5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 8 Jul 2025 21:10:26 +1000
Subject: [PATCH 1862/2374] Removed ImageDraw.getdraw hints deprecation section

---
 docs/deprecations.rst | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 2365545656f..4e65dc8078a 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -12,13 +12,6 @@ Deprecated features
 Below are features which are considered deprecated. Where appropriate,
 a :py:exc:`DeprecationWarning` is issued.
 
-ImageDraw.getdraw hints parameter
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-.. deprecated:: 10.4.0
-
-The ``hints`` parameter in :py:meth:`~PIL.ImageDraw.getdraw()` has been deprecated.
-
 ExifTags.IFD.Makernote
 ^^^^^^^^^^^^^^^^^^^^^^
 
@@ -186,6 +179,7 @@ ICNS (width, height, scale) sizes
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. deprecated:: 11.0.0
+.. versionremoved:: 12.0.0
 
 Setting an ICNS image size to ``(width, height, scale)`` before loading has been
 removed. Instead, ``load(scale)`` can be used.

From cbd47d8609e3306cb4b20ba2b04b32c176c88e43 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 8 Jul 2025 23:07:07 +1000
Subject: [PATCH 1863/2374] Removed handling of deprecated WebP features

---
 src/PIL/features.py | 19 ++-----------------
 1 file changed, 2 insertions(+), 17 deletions(-)

diff --git a/src/PIL/features.py b/src/PIL/features.py
index 984f7532c7c..ff32c251045 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -9,7 +9,6 @@
 import PIL
 
 from . import Image
-from ._deprecate import deprecate
 
 modules = {
     "pil": ("PIL._imaging", "PILLOW_VERSION"),
@@ -120,7 +119,7 @@ def get_supported_codecs() -> list[str]:
     return [f for f in codecs if check_codec(f)]
 
 
-features: dict[str, tuple[str, str | bool, str | None]] = {
+features: dict[str, tuple[str, str, str | None]] = {
     "raqm": ("PIL._imagingft", "HAVE_RAQM", "raqm_version"),
     "fribidi": ("PIL._imagingft", "HAVE_FRIBIDI", "fribidi_version"),
     "harfbuzz": ("PIL._imagingft", "HAVE_HARFBUZZ", "harfbuzz_version"),
@@ -146,12 +145,8 @@ 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):
-            return flag
         return getattr(imported_module, flag)
     except ModuleNotFoundError:
         return None
@@ -181,17 +176,7 @@ def get_supported_features() -> list[str]:
     """
     :returns: A list of all supported features.
     """
-    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
+    return [f for f in features if check_feature(f)]
 
 
 def check(feature: str) -> bool | None:

From 31e6c716ac0141ca03aed750b8b326183a45b0fb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 9 Jul 2025 22:26:25 +1000
Subject: [PATCH 1864/2374] Improved features test coverage

---
 Tests/test_features.py | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/Tests/test_features.py b/Tests/test_features.py
index 520c25b4645..ddca9934498 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -112,6 +112,25 @@ def test_unsupported_module() -> None:
         features.version_module(module)
 
 
+def test_unsupported_feature() -> None:
+    # Arrange
+    feature = "unsupported_feature"
+    # Act / Assert
+    with pytest.raises(ValueError):
+        features.check_feature(feature)
+    with pytest.raises(ValueError):
+        features.version_feature(feature)
+
+
+def test_unsupported_version() -> None:
+    assert features.version("unsupported_version") is None
+
+
+def test_modulenotfound(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(features, "features", {"test": ("PIL._test", "", "")})
+    assert features.check_feature("test") is None
+
+
 @pytest.mark.parametrize("supported_formats", (True, False))
 def test_pilinfo(supported_formats: bool) -> None:
     buf = io.StringIO()

From 2af930b2f72a86f30e79b5abc6f6791362411206 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Thu, 10 Jul 2025 12:07:38 +0800
Subject: [PATCH 1865/2374] Ensure dynamic libjpeg libraries are not linked.

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index d761d93b62c..2c38dc609fb 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -60,7 +60,7 @@ if [[ "$CIBW_PLATFORM" == "ios" ]]; then
     # on using the Xcode builder, which isn't very helpful for most of Pillow's
     # dependencies. Therefore, we lean on the OSX configurations, plus CC, CFLAGS
     # etc. to ensure the right sysroot is selected.
-    HOST_CMAKE_FLAGS="-DCMAKE_SYSTEM_NAME=$CMAKE_SYSTEM_NAME -DCMAKE_SYSTEM_PROCESSOR=$GNU_ARCH -DCMAKE_OSX_DEPLOYMENT_TARGET=$IPHONEOS_DEPLOYMENT_TARGET -DCMAKE_OSX_SYSROOT=$IOS_SDK_PATH -DBUILD_SHARED_LIBS=NO"
+    HOST_CMAKE_FLAGS="-DCMAKE_SYSTEM_NAME=$CMAKE_SYSTEM_NAME -DCMAKE_SYSTEM_PROCESSOR=$GNU_ARCH -DCMAKE_OSX_DEPLOYMENT_TARGET=$IPHONEOS_DEPLOYMENT_TARGET -DCMAKE_OSX_SYSROOT=$IOS_SDK_PATH -DBUILD_SHARED_LIBS=NO -DENABLE_SHARED=NO"
 
     # Meson needs to be pointed at a cross-platform configuration file
     # This will be generated once CC etc. have been evaluated.
@@ -380,6 +380,15 @@ fi
 
 wrap_wheel_builder build
 
+# A safety catch for iOS. iOS can't use dynamic libraries, but clang will prefer
+# to link dynamic libraries to static libraries. The only way to reliably
+# prevent this is to not have dynamic libraries available in the first place.
+# The build process *shouldn't* generate any dylibs... but just in case, purge
+# any dylibs that *have* been installed into the build prefix directory.
+if [[ -n "$IOS_SDK" ]]; then
+    find "$BUILD_PREFIX" -name "*.dylib" -exec rm -rf {} \;
+fi
+
 # Return to the project root to finish the build
 popd > /dev/null
 

From 6c12d188db46ea8cfb19024bd55c352a2aaa3a03 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Jul 2025 22:33:31 +1000
Subject: [PATCH 1866/2374] Updated libwebp to 1.6.0

---
 .github/workflows/wheels-dependencies.sh |  4 +--
 depends/install_webp.sh                  |  2 +-
 patches/iOS/libwebp-1.5.0.tar.gz.patch   | 42 ------------------------
 winbuild/build_prepare.py                |  2 +-
 4 files changed, 4 insertions(+), 46 deletions(-)
 delete mode 100644 patches/iOS/libwebp-1.5.0.tar.gz.patch

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 2c38dc609fb..6d52ca98908 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -103,7 +103,7 @@ TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_VERSION=1.3.1
 ZLIB_NG_VERSION=2.2.4
-LIBWEBP_VERSION=1.5.0  # Patched; next release won't need patching. See patch file.
+LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.1.0  # Patched; next release won't need patching. See patch file.
@@ -282,7 +282,7 @@ function build {
     fi
     CFLAGS="$CFLAGS $webp_cflags" build_simple libwebp $LIBWEBP_VERSION \
         https://storage.googleapis.com/downloads.webmproject.org/releases/webp tar.gz \
-        --enable-libwebpmux --enable-libwebpdemux
+        --enable-libwebpmux --enable-libwebpdemux --disable-libwebpexamples
 
     build_brotli
 
diff --git a/depends/install_webp.sh b/depends/install_webp.sh
index 9d29777159e..d7f3cd2f5d0 100755
--- a/depends/install_webp.sh
+++ b/depends/install_webp.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 # install webp
 
-archive=libwebp-1.5.0
+archive=libwebp-1.6.0
 
 ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
 
diff --git a/patches/iOS/libwebp-1.5.0.tar.gz.patch b/patches/iOS/libwebp-1.5.0.tar.gz.patch
deleted file mode 100644
index fefb72b68d2..00000000000
--- a/patches/iOS/libwebp-1.5.0.tar.gz.patch
+++ /dev/null
@@ -1,42 +0,0 @@
-# libwebp example binaries require dependencies that aren't available for iOS builds.
-# There's also no easy way to invoke the build to *exclude* the example builds.
-# Since we don't need the examples anyway, remove them from the Makefile.
-#
-# As a point of reference, libwebp provides an XCFramework build script that involves
-# 7 separate invocations of make to avoid building the examples. Patching the Makefile
-# to remove the examples is a simpler approach, and one that is more compatible with
-# the existing multibuild infrastructure.
-# 
-# In the next release, it should be possible to pass --disable-libwebpexamples 
-# instead of applying this patch.
-#
-diff -ur libwebp-1.5.0-orig/Makefile.am libwebp-1.5.0/Makefile.am
---- libwebp-1.5.0-orig/Makefile.am	2024-12-20 09:17:50
-+++ libwebp-1.5.0/Makefile.am	2025-01-09 11:24:17
-@@ -5,5 +5,3 @@
- if BUILD_EXTRAS
-   SUBDIRS += extras
- endif
--
--SUBDIRS += examples
-diff -ur libwebp-1.5.0-orig/Makefile.in libwebp-1.5.0/Makefile.in
---- libwebp-1.5.0-orig/Makefile.in	2024-12-20 09:52:53
-+++ libwebp-1.5.0/Makefile.in	2025-01-09 11:24:17
-@@ -156,7 +156,7 @@
-   unique=`for i in $$list; do \
-     if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
-   done | $(am__uniquify_input)`
--DIST_SUBDIRS = sharpyuv src imageio man extras examples
-+DIST_SUBDIRS = sharpyuv src imageio man extras
- am__DIST_COMMON = $(srcdir)/Makefile.in \
- 	$(top_srcdir)/src/webp/config.h.in AUTHORS COPYING ChangeLog \
- 	NEWS README.md ar-lib compile config.guess config.sub \
-@@ -351,7 +351,7 @@
- top_srcdir = @top_srcdir@
- webp_libname_prefix = @webp_libname_prefix@
- ACLOCAL_AMFLAGS = -I m4
--SUBDIRS = sharpyuv src imageio man $(am__append_1) examples
-+SUBDIRS = sharpyuv src imageio man $(am__append_1)
- EXTRA_DIST = COPYING autogen.sh
- all: all-recursive
- 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 187d07b20c2..6b2d41a7e65 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -122,7 +122,7 @@ def cmd_msbuild(
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.3.4",
     "LIBPNG": "1.6.49",
-    "LIBWEBP": "1.5.0",
+    "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.7.0",
     "XZ": "5.8.1",

From 8b695cc0d36363cd853bd7d0cec7be2e31004537 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Jul 2025 22:50:05 +1000
Subject: [PATCH 1867/2374] When deleting EXIF IFD tag, clear IFD data

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

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 83b027aa238..e6f21c9769e 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -922,6 +922,17 @@ def test_exif_ifd(self) -> None:
         reloaded_exif.load(exif.tobytes())
         assert reloaded_exif.get_ifd(0x8769) == exif.get_ifd(0x8769)
 
+    def test_delete_ifd_tag(self) -> None:
+        with Image.open("Tests/images/flower.jpg") as im:
+            exif = im.getexif()
+        exif.get_ifd(0x8769)
+        assert 0x8769 in exif
+        del exif[0x8769]
+
+        reloaded_exif = Image.Exif()
+        reloaded_exif.load(exif.tobytes())
+        assert 0x8769 not in reloaded_exif
+
     def test_exif_load_from_fp(self) -> None:
         with Image.open("Tests/images/flower.jpg") as im:
             data = im.info["exif"]
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 262b5478b62..8901b30341a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -4215,6 +4215,8 @@ def __delitem__(self, tag: int) -> None:
             del self._info[tag]
         else:
             del self._data[tag]
+            if tag in self._ifds:
+                del self._ifds[tag]
 
     def __iter__(self) -> Iterator[int]:
         keys = set(self._data)

From 50dde1c125f0f3c1714c64fa6a049b1123e0a0cd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 10 Jul 2025 23:19:16 +1000
Subject: [PATCH 1868/2374] Remove unused _save_cjpeg

---
 Tests/helper.py               | 10 ----------
 Tests/test_file_jpeg.py       |  9 ---------
 Tests/test_shell_injection.py |  7 +------
 src/PIL/JpegImagePlugin.py    | 10 ----------
 winbuild/build_prepare.py     |  5 ++---
 5 files changed, 3 insertions(+), 38 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 34e4d6e75fb..df99f5f5571 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -291,16 +291,6 @@ def djpeg_available() -> bool:
     return False
 
 
-def cjpeg_available() -> bool:
-    if shutil.which("cjpeg"):
-        try:
-            subprocess.check_call(["cjpeg", "-version"])
-            return True
-        except subprocess.CalledProcessError:  # pragma: no cover
-            return False
-    return False
-
-
 def netpbm_available() -> bool:
     return bool(shutil.which("ppmquant") and shutil.which("ppmtogif"))
 
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 08e8798079d..51d518ae5ed 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -26,7 +26,6 @@
     assert_image_equal_tofile,
     assert_image_similar,
     assert_image_similar_tofile,
-    cjpeg_available,
     djpeg_available,
     hopper,
     is_win32,
@@ -731,14 +730,6 @@ def test_load_djpeg(self) -> None:
             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: Path) -> None:
-        with Image.open(TEST_FILE) as img:
-            tempfile = str(tmp_path / "temp.jpg")
-            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)
-
     def test_no_duplicate_0x1001_tag(self) -> None:
         # Arrange
         tag_ids = {v: k for k, v in ExifTags.TAGS.items()}
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index 03e92b5b913..38d46f312ed 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -9,7 +9,7 @@
 
 from PIL import GifImagePlugin, Image, JpegImagePlugin
 
-from .helper import cjpeg_available, djpeg_available, is_win32, netpbm_available
+from .helper import djpeg_available, is_win32, netpbm_available
 
 TEST_JPG = "Tests/images/hopper.jpg"
 TEST_GIF = "Tests/images/hopper.gif"
@@ -42,11 +42,6 @@ def test_load_djpeg_filename(self, tmp_path: Path) -> None:
                 assert isinstance(im, JpegImagePlugin.JpegImageFile)
                 im.load_djpeg()
 
-    @pytest.mark.skipif(not cjpeg_available(), reason="cjpeg not available")
-    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: Path) -> None:
         with Image.open(TEST_GIF) as im:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 082f3551a17..efe8eff3b29 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -845,16 +845,6 @@ def validate_qtables(
     )
 
 
-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])
-    try:
-        os.unlink(tempfile)
-    except OSError:
-        pass
-
-
 ##
 # Factory for making JPEG and MPO instances
 def jpeg_factory(
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 187d07b20c2..84d103c086d 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -149,18 +149,17 @@ def cmd_msbuild(
         },
         "build": [
             *cmds_cmake(
-                ("jpeg-static", "cjpeg-static", "djpeg-static"),
+                ("jpeg-static", "djpeg-static"),
                 "-DENABLE_SHARED:BOOL=FALSE",
                 "-DWITH_JPEG8:BOOL=TRUE",
                 "-DWITH_CRT_DLL:BOOL=TRUE",
             ),
             cmd_copy("jpeg-static.lib", "libjpeg.lib"),
-            cmd_copy("cjpeg-static.exe", "cjpeg.exe"),
             cmd_copy("djpeg-static.exe", "djpeg.exe"),
         ],
         "headers": ["jconfig.h", r"src\j*.h"],
         "libs": ["libjpeg.lib"],
-        "bins": ["cjpeg.exe", "djpeg.exe"],
+        "bins": ["djpeg.exe"],
     },
     "zlib": {
         "url": f"https://github.com/zlib-ng/zlib-ng/archive/refs/tags/{V['ZLIBNG']}.tar.gz",

From d88986a184ceb32a7eb919e3b21f950c564da35f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 12:53:43 +1000
Subject: [PATCH 1869/2374] Link transitive dependencies

Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
---
 .github/workflows/wheels-dependencies.sh | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 6d52ca98908..4296ba29290 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -280,8 +280,11 @@ function build {
     if [[ -n "$IS_MACOS" ]]; then
         webp_cflags="$webp_cflags -Wl,-headerpad_max_install_names"
     fi
-    CFLAGS="$CFLAGS $webp_cflags" build_simple libwebp $LIBWEBP_VERSION \
-        https://storage.googleapis.com/downloads.webmproject.org/releases/webp tar.gz \
+    webp_ldflags=""
+    if [[ -n "$IOS_SDK" ]]; then
+        webp_ldflags="$webp_ldflags -llzma -lz"
+    fi
+    CFLAGS="$CFLAGS $webp_cflags" LDFLAGS="$LDFLAGS $webp_ldflags" build_simple libwebp $LIBWEBP_VERSION \
         --enable-libwebpmux --enable-libwebpdemux --disable-libwebpexamples
 
     build_brotli

From 722c130b316443be7cc561d716711d1d39d704f7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 13:12:38 +1000
Subject: [PATCH 1870/2374] Restored URL

Co-authored-by: Russell Keith-Magee <russell@keith-magee.com>
---
 .github/workflows/wheels-dependencies.sh | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 4296ba29290..e83012fd62f 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -285,6 +285,7 @@ function build {
         webp_ldflags="$webp_ldflags -llzma -lz"
     fi
     CFLAGS="$CFLAGS $webp_cflags" LDFLAGS="$LDFLAGS $webp_ldflags" build_simple libwebp $LIBWEBP_VERSION \
+        https://storage.googleapis.com/downloads.webmproject.org/releases/webp tar.gz \
         --enable-libwebpmux --enable-libwebpdemux --disable-libwebpexamples
 
     build_brotli

From 985544d55715f2a5dfc539fdd09fb9bb7738694c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 13:28:08 +1000
Subject: [PATCH 1871/2374] Do not disable libwebpexamples

---
 .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 e83012fd62f..6b5aedb697f 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -286,7 +286,7 @@ function build {
     fi
     CFLAGS="$CFLAGS $webp_cflags" LDFLAGS="$LDFLAGS $webp_ldflags" build_simple libwebp $LIBWEBP_VERSION \
         https://storage.googleapis.com/downloads.webmproject.org/releases/webp tar.gz \
-        --enable-libwebpmux --enable-libwebpdemux --disable-libwebpexamples
+        --enable-libwebpmux --enable-libwebpdemux
 
     build_brotli
 

From 74e36e0ee5da824132595c2c13dc1fc8416c743f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 16:48:46 +1000
Subject: [PATCH 1872/2374] Added RGBX and CMYK as alternatives for RGBA array
 data

---
 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 e512da9a192..c98630cc24f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3401,7 +3401,7 @@ def fromqpixmap(im: ImageQt.QPixmap) -> ImageFile.ImageFile:
     ((1, 1), ">f8"): ("F", "F;64BF", []),
     ((1, 1, 2), "|u1"): ("LA", "LA", ["La", "PA"]),
     ((1, 1, 3), "|u1"): ("RGB", "RGB", ["YCbCr", "LAB", "HSV"]),
-    ((1, 1, 4), "|u1"): ("RGBA", "RGBA", ["RGBa"]),
+    ((1, 1, 4), "|u1"): ("RGBA", "RGBA", ["RGBa", "RGBX", "CMYK"]),
     # shortcuts:
     ((1, 1), f"{_ENDIAN}i4"): ("I", "I", []),
     ((1, 1), f"{_ENDIAN}f4"): ("F", "F", []),

From 561ae3760c8a240d825598c0bd3b0365991586cf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 17:18:47 +1000
Subject: [PATCH 1873/2374] Set correct size for rotated images after opening

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

diff --git a/Tests/test_file_pcd.py b/Tests/test_file_pcd.py
index 81a316fc14a..9bf1a75f0f6 100644
--- a/Tests/test_file_pcd.py
+++ b/Tests/test_file_pcd.py
@@ -1,10 +1,15 @@
 from __future__ import annotations
 
+from io import BytesIO
+
+import pytest
+
 from PIL import Image
 
 
 def test_load_raw() -> None:
     with Image.open("Tests/images/hopper.pcd") as im:
+        assert im.size == (768, 512)
         im.load()  # should not segfault.
 
     # Note that this image was created with a resized hopper
@@ -15,3 +20,13 @@ def test_load_raw() -> None:
 
     # target = hopper().resize((768,512))
     # assert_image_similar(im, target, 10)
+
+
+@pytest.mark.parametrize("orientation", (1, 3))
+def test_rotated(orientation: int) -> None:
+    with open("Tests/images/hopper.pcd", "rb") as fp:
+        data = bytearray(fp.read())
+    data[2048 + 1538] = orientation
+    f = BytesIO(data)
+    with Image.open(f) as im:
+        assert im.size == (512, 768)
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index 3aa249988c8..ac53f616e7d 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -46,14 +46,13 @@ def _open(self) -> None:
             self.tile_post_rotate = -90
 
         self._mode = "RGB"
-        self._size = 768, 512  # FIXME: not correct for rotated images!
+        self._size = (512, 768) if orientation in (1, 3) else (768, 512)
         self.tile = [ImageFile._Tile("pcd", (0, 0) + self.size, 96 * 2048)]
 
     def load_end(self) -> None:
         if self.tile_post_rotate:
             # Handle rotated PCDs
             self.im = self.im.rotate(self.tile_post_rotate)
-            self._size = self.im.size
 
 
 #

From 7328cf2e5e9da9bbf2f2b20859c09707de8b1e4d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 17:19:56 +1000
Subject: [PATCH 1874/2374] Reduced number of bytes read

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

diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index ac53f616e7d..7f9ab525c68 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -32,7 +32,7 @@ def _open(self) -> None:
         assert self.fp is not None
 
         self.fp.seek(2048)
-        s = self.fp.read(2048)
+        s = self.fp.read(1539)
 
         if not s.startswith(b"PCD_"):
             msg = "not a PCD file"

From a8bb7579dc3dd5c24dcecc17832dc1ea5b2249a8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 21:06:30 +1000
Subject: [PATCH 1875/2374] Improved ImageMath test coverage

---
 Tests/test_imagemath_lambda_eval.py | 32 ++++++++++++++++++++++++++++-
 1 file changed, 31 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagemath_lambda_eval.py b/Tests/test_imagemath_lambda_eval.py
index 26c04b9a07b..ce2a32ae80e 100644
--- a/Tests/test_imagemath_lambda_eval.py
+++ b/Tests/test_imagemath_lambda_eval.py
@@ -2,7 +2,9 @@
 
 from typing import Any
 
-from PIL import Image, ImageMath
+import pytest
+
+from PIL import Image, ImageMath, _imagingmath
 
 
 def pixel(im: Image.Image | int) -> str | int:
@@ -498,3 +500,31 @@ def test_logical_not_equal() -> None:
         )
         == "I 1"
     )
+
+
+def test_reflected_operands() -> None:
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 + args["A"], **images)) == "I 2"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 - args["A"], **images)) == "I 0"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 * args["A"], **images)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 / args["A"], **images)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 % args["A"], **images)) == "I 0"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 ** args["A"], **images)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 & args["A"], **images)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 | args["A"], **images)) == "I 1"
+    assert pixel(ImageMath.lambda_eval(lambda args: 1 ^ args["A"], **images)) == "I 0"
+
+
+def test_unsupported_mode() -> None:
+    im = Image.new("RGB", (1, 1))
+    with pytest.raises(ValueError, match="unsupported mode: RGB"):
+        ImageMath.lambda_eval(lambda args: args["im"] + 1, im=im)
+
+
+def test_bad_operand_type(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.delattr(_imagingmath, "abs_I")
+    with pytest.raises(TypeError, match="bad operand type for 'abs'"):
+        ImageMath.lambda_eval(lambda args: abs(args["I"]), I=I)
+
+    monkeypatch.delattr(_imagingmath, "max_F")
+    with pytest.raises(TypeError, match="bad operand type for 'max'"):
+        ImageMath.lambda_eval(lambda args: args["max"](args["I"], args["F"]), I=I, F=F)

From bc2519abf10e6a2a095be82d7a268870afaaba71 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 11 Jul 2025 22:45:22 +1000
Subject: [PATCH 1876/2374] Removed helper method _i8, unused since dump() was
 removed

---
 src/PIL/IptcImagePlugin.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index b1fbb1bf139..e5a52aa8f54 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -34,10 +34,6 @@ def _i(c: bytes) -> int:
     return i32((b"\0\0\0\0" + c)[-4:])
 
 
-def _i8(c: int | bytes) -> int:
-    return c if isinstance(c, int) else c[0]
-
-
 ##
 # Image plugin for IPTC/NAA datastreams.  To read IPTC/NAA fields
 # from TIFF and JPEG files, use the <b>getiptcinfo</b> function.

From 68ac3375c68a3798d9f964a2ec704c0465ea4566 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Jul 2025 12:47:54 +1000
Subject: [PATCH 1877/2374] Codec is always "iptc"

---
 src/PIL/IptcImagePlugin.py | 54 ++++++++++++++++++--------------------
 1 file changed, 26 insertions(+), 28 deletions(-)

diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index e5a52aa8f54..85a13fe2cba 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -124,35 +124,33 @@ def _open(self) -> None:
             ]
 
     def load(self) -> Image.core.PixelAccess | None:
-        if len(self.tile) != 1 or self.tile[0][0] != "iptc":
-            return ImageFile.ImageFile.load(self)
-
-        offset, compression = self.tile[0][2:]
-
-        self.fp.seek(offset)
-
-        # Copy image data to temporary file
-        o = BytesIO()
-        if compression == "raw":
-            # To simplify access to the extracted file,
-            # prepend a PPM header
-            o.write(b"P5\n%d %d\n255\n" % self.size)
-        while True:
-            type, size = self.field()
-            if type != (8, 10):
-                break
-            while size > 0:
-                s = self.fp.read(min(size, 8192))
-                if not s:
+        if self.tile:
+            offset, compression = self.tile[0][2:]
+
+            self.fp.seek(offset)
+
+            # Copy image data to temporary file
+            o = BytesIO()
+            if compression == "raw":
+                # To simplify access to the extracted file,
+                # prepend a PPM header
+                o.write(b"P5\n%d %d\n255\n" % self.size)
+            while True:
+                type, size = self.field()
+                if type != (8, 10):
                     break
-                o.write(s)
-                size -= len(s)
-
-        with Image.open(o) as _im:
-            _im.load()
-            self.im = _im.im
-        self.tile = []
-        return Image.Image.load(self)
+                while size > 0:
+                    s = self.fp.read(min(size, 8192))
+                    if not s:
+                        break
+                    o.write(s)
+                    size -= len(s)
+
+            with Image.open(o) as _im:
+                _im.load()
+                self.im = _im.im
+            self.tile = []
+        return ImageFile.ImageFile.load(self)
 
 
 Image.register_open(IptcImageFile.format, IptcImageFile)

From cfa51ad4ada953c1a32d4cf9e1504de1cfec40b8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Jul 2025 15:09:07 +1000
Subject: [PATCH 1878/2374] Populate single band

---
 Tests/test_file_iptc.py    | 69 +++++++++++++++++++++++++++++++++++---
 src/PIL/IptcImagePlugin.py | 33 +++++++++++-------
 2 files changed, 85 insertions(+), 17 deletions(-)

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 3c4c892c8a0..5a8aaa3ef32 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -2,6 +2,8 @@
 
 from io import BytesIO
 
+import pytest
+
 from PIL import Image, IptcImagePlugin, TiffImagePlugin, TiffTags
 
 from .helper import assert_image_equal, hopper
@@ -9,21 +11,78 @@
 TEST_FILE = "Tests/images/iptc.jpg"
 
 
+def create_iptc_image(info: dict[str, int] = {}) -> BytesIO:
+    def field(tag, value):
+        return bytes((0x1C,) + tag + (0, len(value))) + value
+
+    data = field((3, 60), bytes((info.get("layers", 1), info.get("component", 0))))
+    data += field((3, 120), bytes((info.get("compression", 1),)))
+    if "band" in info:
+        data += field((3, 65), bytes((info["band"] + 1,)))
+    data += field((3, 20), b"\x01")  # width
+    data += field((3, 30), b"\x01")  # height
+    data += field(
+        (8, 10),
+        bytes((info.get("data", 0),)),
+    )
+
+    return BytesIO(data)
+
+
 def test_open() -> None:
     expected = Image.new("L", (1, 1))
 
-    f = BytesIO(
-        b"\x1c\x03<\x00\x02\x01\x00\x1c\x03x\x00\x01\x01\x1c\x03\x14\x00\x01\x01"
-        b"\x1c\x03\x1e\x00\x01\x01\x1c\x08\n\x00\x01\x00"
-    )
+    f = create_iptc_image()
     with Image.open(f) as im:
-        assert im.tile == [("iptc", (0, 0, 1, 1), 25, "raw")]
+        assert im.tile == [("iptc", (0, 0, 1, 1), 25, ("raw", None))]
         assert_image_equal(im, expected)
 
     with Image.open(f) as im:
         assert im.load() is not None
 
 
+def test_field_length() -> None:
+    f = create_iptc_image()
+    f.seek(28)
+    f.write(b"\xff")
+    with pytest.raises(OSError, match="illegal field length in IPTC/NAA file"):
+        with Image.open(f):
+            pass
+
+
+@pytest.mark.parametrize("layers, mode", ((3, "RGB"), (4, "CMYK")))
+def test_layers(layers: int, mode: str) -> None:
+    for band in range(-1, layers):
+        info = {"layers": layers, "component": 1, "data": 5}
+        if band != -1:
+            info["band"] = band
+        f = create_iptc_image(info)
+        with Image.open(f) as im:
+            assert im.mode == mode
+
+            data = [0] * layers
+            data[max(band, 0)] = 5
+            assert im.getpixel((0, 0)) == tuple(data)
+
+
+def test_unknown_compression() -> None:
+    f = create_iptc_image({"compression": 2})
+    with pytest.raises(OSError, match="Unknown IPTC image compression"):
+        with Image.open(f):
+            pass
+
+
+def test_getiptcinfo() -> None:
+    f = create_iptc_image()
+    with Image.open(f) as im:
+        assert IptcImagePlugin.getiptcinfo(im) == {
+            (3, 60): b"\x01\x00",
+            (3, 120): b"\x01",
+            (3, 20): b"\x01",
+            (3, 30): b"\x01",
+        }
+
+
 def test_getiptcinfo_jpg_none() -> None:
     # Arrange
     with hopper() as im:
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 85a13fe2cba..c28f4dcc797 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -96,16 +96,18 @@ def _open(self) -> None:
         # mode
         layers = self.info[(3, 60)][0]
         component = self.info[(3, 60)][1]
-        if (3, 65) in self.info:
-            id = self.info[(3, 65)][0] - 1
-        else:
-            id = 0
         if layers == 1 and not component:
             self._mode = "L"
-        elif layers == 3 and component:
-            self._mode = "RGB"[id]
-        elif layers == 4 and component:
-            self._mode = "CMYK"[id]
+            band = None
+        else:
+            if layers == 3 and component:
+                self._mode = "RGB"
+            elif layers == 4 and component:
+                self._mode = "CMYK"
+            if (3, 65) in self.info:
+                band = self.info[(3, 65)][0] - 1
+            else:
+                band = 0
 
         # size
         self._size = self.getint((3, 20)), self.getint((3, 30))
@@ -120,14 +122,16 @@ def _open(self) -> None:
         # tile
         if tag == (8, 10):
             self.tile = [
-                ImageFile._Tile("iptc", (0, 0) + self.size, offset, compression)
+                ImageFile._Tile("iptc", (0, 0) + self.size, offset, (compression, band))
             ]
 
     def load(self) -> Image.core.PixelAccess | None:
         if self.tile:
-            offset, compression = self.tile[0][2:]
+            args = self.tile[0].args
+            assert isinstance(args, tuple)
+            compression, band = args
 
-            self.fp.seek(offset)
+            self.fp.seek(self.tile[0].offset)
 
             # Copy image data to temporary file
             o = BytesIO()
@@ -147,7 +151,12 @@ def load(self) -> Image.core.PixelAccess | None:
                     size -= len(s)
 
             with Image.open(o) as _im:
-                _im.load()
+                if band is not None:
+                    bands = [Image.new("L", _im.size)] * Image.getmodebands(self.mode)
+                    bands[band] = _im
+                    _im = Image.merge(self.mode, bands)
+                else:
+                    _im.load()
                 self.im = _im.im
             self.tile = []
         return ImageFile.ImageFile.load(self)

From 6fdbf5433108454f8085b5d01c803367f97535a7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Jul 2025 19:50:19 +1000
Subject: [PATCH 1879/2374] Width and height are unsigned

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

diff --git a/src/PIL/GbrImagePlugin.py b/src/PIL/GbrImagePlugin.py
index f319d7e846e..d69295363f3 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -54,7 +54,7 @@ def _open(self) -> None:
         width = i32(self.fp.read(4))
         height = i32(self.fp.read(4))
         color_depth = i32(self.fp.read(4))
-        if width <= 0 or height <= 0:
+        if width == 0 or height == 0:
             msg = "not a GIMP brush"
             raise SyntaxError(msg)
         if color_depth not in (1, 4):
@@ -71,7 +71,7 @@ def _open(self) -> None:
                 raise SyntaxError(msg)
             self.info["spacing"] = i32(self.fp.read(4))
 
-        comment = self.fp.read(comment_length)[:-1]
+        self.info["comment"] = self.fp.read(comment_length)[:-1]
 
         if color_depth == 1:
             self._mode = "L"
@@ -80,8 +80,6 @@ def _open(self) -> None:
 
         self._size = width, height
 
-        self.info["comment"] = comment
-
         # Image might not be small
         Image._decompression_bomb_check(self.size)
 

From 4adff39bfd7a04c875b41bd879f513cde09c4604 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 12 Jul 2025 19:55:58 +1000
Subject: [PATCH 1880/2374] Improved test coverage

---
 Tests/test_file_gbr.py | 49 +++++++++++++++++++++++++++++++++++++++---
 1 file changed, 46 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_gbr.py b/Tests/test_file_gbr.py
index 1b834cd3c73..b8851d82beb 100644
--- a/Tests/test_file_gbr.py
+++ b/Tests/test_file_gbr.py
@@ -1,8 +1,10 @@
 from __future__ import annotations
 
+from io import BytesIO
+
 import pytest
 
-from PIL import GbrImagePlugin, Image
+from PIL import GbrImagePlugin, Image, _binary
 
 from .helper import assert_image_equal_tofile
 
@@ -31,8 +33,49 @@ def test_multiple_load_operations() -> None:
         assert_image_equal_tofile(im, "Tests/images/gbr.png")
 
 
+def create_gbr_image(info: dict[str, int] = {}, magic_number=b"") -> BytesIO:
+    return BytesIO(
+        b"".join(
+            _binary.o32be(i)
+            for i in [
+                info.get("header_size", 20),
+                info.get("version", 1),
+                info.get("width", 1),
+                info.get("height", 1),
+                info.get("color_depth", 1),
+            ]
+        )
+        + magic_number
+    )
+
+
 def test_invalid_file() -> None:
-    invalid_file = "Tests/images/flower.jpg"
+    for f in [
+        create_gbr_image({"header_size": 0}),
+        create_gbr_image({"width": 0}),
+        create_gbr_image({"height": 0}),
+    ]:
+        with pytest.raises(SyntaxError, match="not a GIMP brush"):
+            GbrImagePlugin.GbrImageFile(f)
 
-    with pytest.raises(SyntaxError):
+    invalid_file = "Tests/images/flower.jpg"
+    with pytest.raises(SyntaxError, match="Unsupported GIMP brush version"):
         GbrImagePlugin.GbrImageFile(invalid_file)
+
+
+def test_unsupported_gimp_brush() -> None:
+    f = create_gbr_image({"color_depth": 2})
+    with pytest.raises(SyntaxError, match="Unsupported GIMP brush color depth: 2"):
+        GbrImagePlugin.GbrImageFile(f)
+
+
+def test_bad_magic_number() -> None:
+    f = create_gbr_image({"version": 2}, magic_number=b"badm")
+    with pytest.raises(SyntaxError, match="not a GIMP brush, bad magic number"):
+        GbrImagePlugin.GbrImageFile(f)
+
+
+def test_L() -> None:
+    f = create_gbr_image()
+    with Image.open(f) as im:
+        assert im.mode == "L"

From d85fa7a2471b16bc547a46542f18f218b19a1c6b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 13 Jul 2025 16:13:44 +1000
Subject: [PATCH 1881/2374] Improved WmfImagePlugin test coverage

---
 Tests/test_file_wmf.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index dcf5f000ffe..906080d15a5 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -44,6 +44,18 @@ def test_load_zero_inch() -> None:
             pass
 
 
+def test_load_unsupported_wmf() -> None:
+    b = BytesIO(b"\xd7\xcd\xc6\x9a\x00\x00" + b"\x01" * 10)
+    with pytest.raises(SyntaxError, match="Unsupported WMF file format"):
+        WmfImagePlugin.WmfStubImageFile(b)
+
+
+def test_load_unsupported() -> None:
+    b = BytesIO(b"\x01\x00\x00\x00")
+    with pytest.raises(SyntaxError, match="Unsupported file format"):
+        WmfImagePlugin.WmfStubImageFile(b)
+
+
 def test_render() -> None:
     with open("Tests/images/drawing.emf", "rb") as fp:
         data = fp.read()

From 5ce88dbe53a3d46e20d464fbd6ef06031645bfda Mon Sep 17 00:00:00 2001
From: GUO YANKE <hi@yankeguo.com>
Date: Mon, 7 Jul 2025 13:57:11 +0800
Subject: [PATCH 1882/2374] feat(ImageGrab): enhance grab function to support
 window-based screenshot capturing on macOS

---
 src/PIL/ImageGrab.py | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 1eb4507344c..ba2c9b1415c 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -43,7 +43,10 @@ def grab(
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
             args = ["screencapture"]
-            if bbox:
+            if window:
+                args += ["-l", str(window)]
+            # -R is not working with -l
+            if bbox and not window:
                 left, top, right, bottom = bbox
                 args += ["-R", f"{left},{top},{right-left},{bottom-top}"]
             subprocess.call(args + ["-x", filepath])
@@ -51,9 +54,16 @@ def grab(
             im.load()
             os.unlink(filepath)
             if bbox:
-                im_resized = im.resize((right - left, bottom - top))
-                im.close()
-                return im_resized
+                # manual crop for windowed mode
+                if window:
+                    left, top, right, bottom = bbox
+                    im_cropped = im.crop((left, top, right, bottom))
+                    im.close()
+                    return im_cropped
+                else:
+                    im_resized = im.resize((right - left, bottom - top))
+                    im.close()
+                    return im_resized
             return im
         elif sys.platform == "win32":
             if window is not None:

From 1f7e9c3b51db100de0164eab45ca16ec4e24bd78 Mon Sep 17 00:00:00 2001
From: Yan-Ke Guo <hi@yankeguo.com>
Date: Mon, 7 Jul 2025 16:29:38 +0800
Subject: [PATCH 1883/2374] Apply suggestions from code review

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

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index ba2c9b1415c..c188745815d 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -56,8 +56,7 @@ def grab(
             if bbox:
                 # manual crop for windowed mode
                 if window:
-                    left, top, right, bottom = bbox
-                    im_cropped = im.crop((left, top, right, bottom))
+                    im_cropped = im.crop(bbox)
                     im.close()
                     return im_cropped
                 else:

From 7eaac3fcf0cd0fa54ba91784727f1d1a7654b31b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 7 Jul 2025 18:13:07 +1000
Subject: [PATCH 1884/2374] Updated documentation

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index f6a2ec5bc03..25afc99266c 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -42,9 +42,9 @@ or the clipboard to a PIL image memory.
         .. versionadded:: 7.1.0
 
     :param window:
-        HWND, to capture a single window. Windows only.
+        Capture a single window. On Windows, this is a HWND. On macOS, it uses windowid.
 
-        .. versionadded:: 11.2.1
+        .. versionadded:: 11.2.1 (Windows), 12.0.0 (macOS)
     :return: An image
 
 .. py:function:: grabclipboard()

From 79914ec8a57e1beeb2a5c62809044c116828962b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 9 Jul 2025 20:00:20 +1000
Subject: [PATCH 1885/2374] Check for scaling in macOS windows

---
 src/PIL/ImageGrab.py | 27 +++++++++++++++++++++++----
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index c188745815d..b82a2ff3a47 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -45,8 +45,7 @@ def grab(
             args = ["screencapture"]
             if window:
                 args += ["-l", str(window)]
-            # -R is not working with -l
-            if bbox and not window:
+            elif bbox:
                 left, top, right, bottom = bbox
                 args += ["-R", f"{left},{top},{right-left},{bottom-top}"]
             subprocess.call(args + ["-x", filepath])
@@ -54,9 +53,29 @@ def grab(
             im.load()
             os.unlink(filepath)
             if bbox:
-                # manual crop for windowed mode
                 if window:
-                    im_cropped = im.crop(bbox)
+                    # Determine if the window was in retina mode or not
+                    # by capturing it without the shadow,
+                    # and checking how different the width is
+                    fh, filepath = tempfile.mkstemp(".png")
+                    os.close(fh)
+                    subprocess.call(
+                        ["screencapture", "-l", str(window), "-o", "-x", filepath]
+                    )
+                    with Image.open(filepath) as im_no_shadow:
+                        retina = im.width - im_no_shadow.width > 100
+                    os.unlink(filepath)
+
+                    # Since screencapture's -R does not work with -l,
+                    # crop the image manually
+                    if retina:
+                        left, top, right, bottom = bbox
+                        im_cropped = im.resize(
+                            (right - left, bottom - top),
+                            box=tuple(coord * 2 for coord in bbox),
+                        )
+                    else:
+                        im_cropped = im.crop(bbox)
                     im.close()
                     return im_cropped
                 else:

From 7516805121cc1da1d00cd6f0a22f64e0232c3541 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 14 Jul 2025 19:29:27 +1000
Subject: [PATCH 1886/2374] Improved DDS test coverage

---
 Tests/images/unimplemented_pixel_format.dds | Bin 0 -> 132 bytes
 Tests/test_file_dds.py                      |  19 +++++++++++++------
 2 files changed, 13 insertions(+), 6 deletions(-)
 create mode 100644 Tests/images/unimplemented_pixel_format.dds

diff --git a/Tests/images/unimplemented_pixel_format.dds b/Tests/images/unimplemented_pixel_format.dds
new file mode 100644
index 0000000000000000000000000000000000000000..9092df8b1b5acda7e115b9ceaf6241d0f294dd1b
GIT binary patch
literal 132
rcmZ>930A0KU|?Vu;9_841TsJvNWhsOE|EY1sE!4nS^-SSSfCI9+g<`M

literal 0
HcmV?d00001

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 5c7a943b1b7..116dfa59cec 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -380,21 +380,28 @@ def test_palette() -> None:
         assert_image_equal_tofile(im, "Tests/images/transparent.gif")
 
 
+def test_unsupported_header_size() -> None:
+    with pytest.raises(OSError, match="Unsupported header size 0"):
+        with Image.open(BytesIO(b"DDS " + b"\x00" * 4)):
+            pass
+
+
 def test_unsupported_bitcount() -> None:
-    with pytest.raises(OSError):
+    with pytest.raises(OSError, match="Unsupported bitcount 24 for 131072"):
         with Image.open("Tests/images/unsupported_bitcount.dds"):
             pass
 
 
 @pytest.mark.parametrize(
-    "test_file",
+    "test_file, message",
     (
-        "Tests/images/unimplemented_dxgi_format.dds",
-        "Tests/images/unimplemented_pfflags.dds",
+        ("Tests/images/unimplemented_dxgi_format.dds", "Unimplemented DXGI format 93"),
+        ("Tests/images/unimplemented_pixel_format.dds", "Unimplemented pixel format 0"),
+        ("Tests/images/unimplemented_pfflags.dds", "Unknown pixel format flags 8"),
     ),
 )
-def test_not_implemented(test_file: str) -> None:
-    with pytest.raises(NotImplementedError):
+def test_not_implemented(test_file: str, message: str) -> None:
+    with pytest.raises(NotImplementedError, match=message):
         with Image.open(test_file):
             pass
 

From 638eb1b9992804ca21577b5933d476b7bdbeb5d6 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 15 Jul 2025 13:23:40 +1000
Subject: [PATCH 1887/2374] Update dependency mypy to v1.17.0 (#9092)

---
 .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 44b5badabf1..e81f527b86f 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.16.1
+mypy==1.17.0
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 91bbeb5dcb47ce6d3b5b1c9969c982910ebee56b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 16 Jul 2025 13:54:13 +1000
Subject: [PATCH 1888/2374] Revert iOS change until the test runs again

---
 Tests/test_pyroma.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index a161d3f05c4..c2f7fe22ecb 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-from importlib.metadata import metadata
-
 import pytest
 
 from PIL import __version__
@@ -11,7 +9,7 @@
 
 def test_pyroma() -> None:
     # Arrange
-    data = pyroma.projectdata.map_metadata_keys(metadata("Pillow"))
+    data = pyroma.projectdata.get_data(".")
 
     # Act
     rating = pyroma.ratings.rate(data)

From a426eb55afcb9e8a069d6aba21405c0d89f69bec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 16 Jul 2025 13:40:22 +1000
Subject: [PATCH 1889/2374] Remove file after test completion

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

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index b3de5c13d3e..2609b1e342a 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -276,10 +276,11 @@ def test_embeddable(self) -> None:
         except Exception:
             pytest.skip("Compiler could not be initialized")
 
-        with open("embed_pil.c", "w", encoding="utf-8") as fh:
-            home = sys.prefix.replace("\\", "\\\\")
-            fh.write(
-                f"""
+        try:
+            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[])
@@ -301,17 +302,19 @@ def test_embeddable(self) -> None:
     return 0;
 }}
         """
-            )
+                )
 
-        objects = compiler.compile(["embed_pil.c"])
-        compiler.link_executable(objects, "embed_pil")
+            objects = compiler.compile(["embed_pil.c"])
+            compiler.link_executable(objects, "embed_pil")
 
-        env = os.environ.copy()
-        env["PATH"] = sys.prefix + ";" + env["PATH"]
+            env = os.environ.copy()
+            env["PATH"] = sys.prefix + ";" + env["PATH"]
 
-        # Do not display the Windows Error Reporting dialog
-        getattr(ctypes, "windll").kernel32.SetErrorMode(0x0002)
+            # Do not display the Windows Error Reporting dialog
+            getattr(ctypes, "windll").kernel32.SetErrorMode(0x0002)
 
-        process = subprocess.Popen(["embed_pil.exe"], env=env)
-        process.communicate()
-        assert process.returncode == 0
+            process = subprocess.Popen(["embed_pil.exe"], env=env)
+            process.communicate()
+            assert process.returncode == 0
+        finally:
+            os.remove("embed_pil.c")

From a39d14648bdbd6638e7097167c4b8c2964ce3752 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 16 Jul 2025 13:39:19 +1000
Subject: [PATCH 1890/2374] Updated manifest

---
 MANIFEST.in | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/MANIFEST.in b/MANIFEST.in
index 95a6b1b9297..6623f227d60 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -13,6 +13,7 @@ include LICENSE
 include Makefile
 include tox.ini
 graft Tests
+graft Tests/images
 graft checks
 graft patches
 graft src
@@ -28,8 +29,19 @@ exclude .editorconfig
 exclude .readthedocs.yml
 exclude codecov.yml
 exclude renovate.json
+exclude Tests/images/README.md
+exclude Tests/images/crash*.tif
+exclude Tests/images/string_dimension.tiff
 global-exclude .git*
 global-exclude *.pyc
 global-exclude *.so
 prune .ci
 prune wheels
+prune winbuild/build
+prune winbuild/depends
+prune Tests/errors
+prune Tests/images/jpeg2000
+prune Tests/images/msp
+prune Tests/images/picins
+prune Tests/images/sunraster
+prune Tests/test-images

From cd93629a5c23a20c9a7dc13d13236e164bf2909f Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 20 Apr 2024 16:40:43 -0500
Subject: [PATCH 1891/2374] use a struct for mode names instead of just a
 string

---
 setup.py                 |   1 +
 src/libImaging/Imaging.h |  23 ++++----
 src/libImaging/Mode.c    | 115 +++++++++++++++++++++++++++++++++++++++
 src/libImaging/Mode.h    |  60 ++++++++++++++++++++
 4 files changed, 186 insertions(+), 13 deletions(-)
 create mode 100644 src/libImaging/Mode.c
 create mode 100644 src/libImaging/Mode.h

diff --git a/setup.py b/setup.py
index df584f8df63..93b5bcc7812 100644
--- a/setup.py
+++ b/setup.py
@@ -103,6 +103,7 @@ def get_version() -> str:
     "JpegDecode",
     "JpegEncode",
     "Matrix",
+    "Mode",
     "ModeFilter",
     "Negative",
     "Offset",
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index bfe67d46213..1eaabd8e561 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -11,6 +11,7 @@
  */
 
 #include "ImPlatform.h"
+#include "Mode.h"
 
 #if defined(__cplusplus)
 extern "C" {
@@ -71,9 +72,6 @@ typedef struct ImagingPaletteInstance *ImagingPalette;
 #define IMAGING_TYPE_FLOAT32 2
 #define IMAGING_TYPE_SPECIAL 3 /* check mode for details */
 
-#define IMAGING_MODE_LENGTH \
-    6 + 1 /* Band names ("1", "L", "P", "RGB", "RGBA", "CMYK", "YCbCr", "BGR;xy") */
-
 typedef struct {
     char *ptr;
     int size;
@@ -81,12 +79,11 @@ typedef struct {
 
 struct ImagingMemoryInstance {
     /* Format */
-    char mode[IMAGING_MODE_LENGTH]; /* Band names ("1", "L", "P", "RGB", "RGBA", "CMYK",
-                                       "YCbCr", "BGR;xy") */
-    int type;                       /* Data type (IMAGING_TYPE_*) */
-    int depth;                      /* Depth (ignored in this version) */
-    int bands;                      /* Number of bands (1, 2, 3, or 4) */
-    int xsize;                      /* Image dimension. */
+    const Mode *mode; /* Image mode (IMAGING_MODE_*) */
+    int type;  /* Data type (IMAGING_TYPE_*) */
+    int depth; /* Depth (ignored in this version) */
+    int bands; /* Number of bands (1, 2, 3, or 4) */
+    int xsize; /* Image dimension. */
     int ysize;
 
     /* Colour palette (for "P" images only) */
@@ -140,15 +137,15 @@ struct ImagingMemoryInstance {
 #define IMAGING_PIXEL_FLOAT32(im, x, y) (((FLOAT32 *)(im)->image32[y])[x])
 
 struct ImagingAccessInstance {
-    const char *mode;
+    const Mode *mode;
     void (*get_pixel)(Imaging im, int x, int y, void *pixel);
     void (*put_pixel)(Imaging im, int x, int y, const void *pixel);
 };
 
 struct ImagingHistogramInstance {
     /* Format */
-    char mode[IMAGING_MODE_LENGTH]; /* Band names (of corresponding source image) */
-    int bands;                      /* Number of bands (1, 3, or 4) */
+    const Mode *mode; /* Mode of corresponding source image */
+    int bands; /* Number of bands (1, 3, or 4) */
 
     /* Data */
     long *histogram; /* Histogram (bands*256 longs) */
@@ -156,7 +153,7 @@ struct ImagingHistogramInstance {
 
 struct ImagingPaletteInstance {
     /* Format */
-    char mode[IMAGING_MODE_LENGTH]; /* Band names */
+    const Mode *mode;
 
     /* Data */
     int size;
diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
new file mode 100644
index 00000000000..5b9c9dae199
--- /dev/null
+++ b/src/libImaging/Mode.c
@@ -0,0 +1,115 @@
+#include "Mode.h"
+#include <string.h>
+
+
+#define CREATE_MODE(TYPE, NAME, INIT) \
+const TYPE IMAGING_##NAME##_VAL = INIT;\
+const TYPE * const IMAGING_##NAME = &IMAGING_##NAME##_VAL;
+
+
+CREATE_MODE(Mode, MODE_1, {"1"})
+CREATE_MODE(Mode, MODE_CMYK, {"CMYK"})
+CREATE_MODE(Mode, MODE_F, {"F"})
+CREATE_MODE(Mode, MODE_HSV, {"HSV"})
+CREATE_MODE(Mode, MODE_I, {"I"})
+CREATE_MODE(Mode, MODE_L, {"L"})
+CREATE_MODE(Mode, MODE_LA, {"LA"})
+CREATE_MODE(Mode, MODE_LAB, {"LAB"})
+CREATE_MODE(Mode, MODE_La, {"La"})
+CREATE_MODE(Mode, MODE_P, {"P"})
+CREATE_MODE(Mode, MODE_PA, {"PA"})
+CREATE_MODE(Mode, MODE_RGB, {"RGB"})
+CREATE_MODE(Mode, MODE_RGBA, {"RGBA"})
+CREATE_MODE(Mode, MODE_RGBX, {"RGBX"})
+CREATE_MODE(Mode, MODE_RGBa, {"RGBa"})
+CREATE_MODE(Mode, MODE_YCbCr, {"YCbCr"})
+
+const Mode * const MODES[] = {
+    IMAGING_MODE_1,
+    IMAGING_MODE_CMYK,
+    IMAGING_MODE_F,
+    IMAGING_MODE_HSV,
+    IMAGING_MODE_I,
+    IMAGING_MODE_L,
+    IMAGING_MODE_LA,
+    IMAGING_MODE_LAB,
+    IMAGING_MODE_La,
+    IMAGING_MODE_P,
+    IMAGING_MODE_PA,
+    IMAGING_MODE_RGB,
+    IMAGING_MODE_RGBA,
+    IMAGING_MODE_RGBX,
+    IMAGING_MODE_RGBa,
+    IMAGING_MODE_YCbCr,
+    NULL
+};
+
+const Mode * findMode(const char * const name) {
+    int i = 0;
+    const Mode * mode;
+    while ((mode = MODES[i++]) != NULL) {
+        if (!strcmp(mode->name, name)) {
+            return mode;
+        }
+    }
+    return NULL;
+}
+
+
+// Alias all of the modes as rawmodes so that the addresses are the same.
+#define ALIAS_MODE_AS_RAWMODE(NAME) const RawMode * const IMAGING_RAWMODE_##NAME = (const RawMode * const)IMAGING_MODE_##NAME;
+ALIAS_MODE_AS_RAWMODE(1)
+ALIAS_MODE_AS_RAWMODE(CMYK)
+ALIAS_MODE_AS_RAWMODE(F)
+ALIAS_MODE_AS_RAWMODE(HSV)
+ALIAS_MODE_AS_RAWMODE(I)
+ALIAS_MODE_AS_RAWMODE(L)
+ALIAS_MODE_AS_RAWMODE(LA)
+ALIAS_MODE_AS_RAWMODE(LAB)
+ALIAS_MODE_AS_RAWMODE(La)
+ALIAS_MODE_AS_RAWMODE(P)
+ALIAS_MODE_AS_RAWMODE(PA)
+ALIAS_MODE_AS_RAWMODE(RGB)
+ALIAS_MODE_AS_RAWMODE(RGBA)
+ALIAS_MODE_AS_RAWMODE(RGBX)
+ALIAS_MODE_AS_RAWMODE(RGBa)
+ALIAS_MODE_AS_RAWMODE(YCbCr)
+
+CREATE_MODE(RawMode, RAWMODE_BGR_15, {"BGR;15"})
+CREATE_MODE(RawMode, RAWMODE_BGR_16, {"BGR;16"})
+
+const RawMode * const RAWMODES[] = {
+    IMAGING_RAWMODE_1,
+    IMAGING_RAWMODE_CMYK,
+    IMAGING_RAWMODE_F,
+    IMAGING_RAWMODE_HSV,
+    IMAGING_RAWMODE_I,
+    IMAGING_RAWMODE_L,
+    IMAGING_RAWMODE_LA,
+    IMAGING_RAWMODE_LAB,
+    IMAGING_RAWMODE_La,
+    IMAGING_RAWMODE_P,
+    IMAGING_RAWMODE_PA,
+    IMAGING_RAWMODE_RGB,
+    IMAGING_RAWMODE_RGBA,
+    IMAGING_RAWMODE_RGBX,
+    IMAGING_RAWMODE_RGBa,
+    IMAGING_RAWMODE_YCbCr,
+
+    IMAGING_RAWMODE_BGR_15,
+    IMAGING_RAWMODE_BGR_16,
+
+    NULL
+};
+
+const RawMode * findRawMode(const char * const name) {
+    int i = 0;
+    const RawMode * rawmode;
+    while ((rawmode = RAWMODES[i++]) != NULL) {
+        const RawMode * const rawmode = RAWMODES[i];
+        if (!strcmp(rawmode->name, name)) {
+            return rawmode;
+        }
+    }
+    return NULL;
+}
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
new file mode 100644
index 00000000000..2d4d27c3170
--- /dev/null
+++ b/src/libImaging/Mode.h
@@ -0,0 +1,60 @@
+#ifndef __MODE_H__
+#define __MODE_H__
+
+
+// Maximum length (including null terminator) for both mode and rawmode names.
+#define IMAGING_MODE_LENGTH 6+1
+
+
+typedef struct {
+    const char * const name;
+} Mode;
+
+extern const Mode * const IMAGING_MODE_1;
+extern const Mode * const IMAGING_MODE_CMYK;
+extern const Mode * const IMAGING_MODE_F;
+extern const Mode * const IMAGING_MODE_HSV;
+extern const Mode * const IMAGING_MODE_I;
+extern const Mode * const IMAGING_MODE_L;
+extern const Mode * const IMAGING_MODE_LA;
+extern const Mode * const IMAGING_MODE_LAB;
+extern const Mode * const IMAGING_MODE_La;
+extern const Mode * const IMAGING_MODE_P;
+extern const Mode * const IMAGING_MODE_PA;
+extern const Mode * const IMAGING_MODE_RGB;
+extern const Mode * const IMAGING_MODE_RGBA;
+extern const Mode * const IMAGING_MODE_RGBX;
+extern const Mode * const IMAGING_MODE_RGBa;
+extern const Mode * const IMAGING_MODE_YCbCr;
+
+const Mode * findMode(const char * const name);
+
+
+typedef struct {
+    const char * const name;
+} RawMode;
+
+extern const RawMode * const IMAGING_RAWMODE_1;
+extern const RawMode * const IMAGING_RAWMODE_CMYK;
+extern const RawMode * const IMAGING_RAWMODE_F;
+extern const RawMode * const IMAGING_RAWMODE_HSV;
+extern const RawMode * const IMAGING_RAWMODE_I;
+extern const RawMode * const IMAGING_RAWMODE_L;
+extern const RawMode * const IMAGING_RAWMODE_LA;
+extern const RawMode * const IMAGING_RAWMODE_LAB;
+extern const RawMode * const IMAGING_RAWMODE_La;
+extern const RawMode * const IMAGING_RAWMODE_P;
+extern const RawMode * const IMAGING_RAWMODE_PA;
+extern const RawMode * const IMAGING_RAWMODE_RGB;
+extern const RawMode * const IMAGING_RAWMODE_RGBA;
+extern const RawMode * const IMAGING_RAWMODE_RGBX;
+extern const RawMode * const IMAGING_RAWMODE_RGBa;
+extern const RawMode * const IMAGING_RAWMODE_YCbCr;
+
+extern const RawMode * const IMAGING_RAWMODE_BGR_15;
+extern const RawMode * const IMAGING_RAWMODE_BGR_16;
+
+const RawMode * findRawMode(const char * const name);
+
+
+#endif // __MODE_H__

From 63a45ad8d0d876cd2c32c43ff1641a93db7307b5 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 20 Apr 2024 20:11:17 -0500
Subject: [PATCH 1892/2374] add special modes

---
 src/libImaging/Mode.c | 35 +++++++++++++++++++++++++++++++++--
 src/libImaging/Mode.h | 16 ++++++++++++++++
 2 files changed, 49 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 5b9c9dae199..2bd09bda56a 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -24,6 +24,15 @@ CREATE_MODE(Mode, MODE_RGBX, {"RGBX"})
 CREATE_MODE(Mode, MODE_RGBa, {"RGBa"})
 CREATE_MODE(Mode, MODE_YCbCr, {"YCbCr"})
 
+CREATE_MODE(Mode, MODE_BGR_15, {"BGR;15"})
+CREATE_MODE(Mode, MODE_BGR_16, {"BGR;16"})
+CREATE_MODE(Mode, MODE_BGR_24, {"BGR;24"})
+
+CREATE_MODE(Mode, MODE_I_16, {"I;16"})
+CREATE_MODE(Mode, MODE_I_16L, {"I;16L"})
+CREATE_MODE(Mode, MODE_I_16B, {"I;16B"})
+CREATE_MODE(Mode, MODE_I_16N, {"I;16N"})
+
 const Mode * const MODES[] = {
     IMAGING_MODE_1,
     IMAGING_MODE_CMYK,
@@ -41,6 +50,16 @@ const Mode * const MODES[] = {
     IMAGING_MODE_RGBX,
     IMAGING_MODE_RGBa,
     IMAGING_MODE_YCbCr,
+
+    IMAGING_MODE_BGR_15,
+    IMAGING_MODE_BGR_16,
+    IMAGING_MODE_BGR_24,
+
+    IMAGING_MODE_I_16,
+    IMAGING_MODE_I_16L,
+    IMAGING_MODE_I_16B,
+    IMAGING_MODE_I_16N,
+
     NULL
 };
 
@@ -75,8 +94,14 @@ ALIAS_MODE_AS_RAWMODE(RGBX)
 ALIAS_MODE_AS_RAWMODE(RGBa)
 ALIAS_MODE_AS_RAWMODE(YCbCr)
 
-CREATE_MODE(RawMode, RAWMODE_BGR_15, {"BGR;15"})
-CREATE_MODE(RawMode, RAWMODE_BGR_16, {"BGR;16"})
+ALIAS_MODE_AS_RAWMODE(BGR_15)
+ALIAS_MODE_AS_RAWMODE(BGR_16)
+ALIAS_MODE_AS_RAWMODE(BGR_24)
+
+ALIAS_MODE_AS_RAWMODE(I_16)
+ALIAS_MODE_AS_RAWMODE(I_16L)
+ALIAS_MODE_AS_RAWMODE(I_16B)
+ALIAS_MODE_AS_RAWMODE(I_16N)
 
 const RawMode * const RAWMODES[] = {
     IMAGING_RAWMODE_1,
@@ -98,6 +123,12 @@ const RawMode * const RAWMODES[] = {
 
     IMAGING_RAWMODE_BGR_15,
     IMAGING_RAWMODE_BGR_16,
+    IMAGING_RAWMODE_BGR_24,
+
+    IMAGING_RAWMODE_I_16,
+    IMAGING_RAWMODE_I_16L,
+    IMAGING_RAWMODE_I_16B,
+    IMAGING_RAWMODE_I_16N,
 
     NULL
 };
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index 2d4d27c3170..6491beb81b7 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -27,6 +27,15 @@ extern const Mode * const IMAGING_MODE_RGBX;
 extern const Mode * const IMAGING_MODE_RGBa;
 extern const Mode * const IMAGING_MODE_YCbCr;
 
+extern const Mode * const IMAGING_MODE_BGR_15;
+extern const Mode * const IMAGING_MODE_BGR_16;
+extern const Mode * const IMAGING_MODE_BGR_24;
+
+extern const Mode * const IMAGING_MODE_I_16;
+extern const Mode * const IMAGING_MODE_I_16L;
+extern const Mode * const IMAGING_MODE_I_16B;
+extern const Mode * const IMAGING_MODE_I_16N;
+
 const Mode * findMode(const char * const name);
 
 
@@ -53,6 +62,13 @@ extern const RawMode * const IMAGING_RAWMODE_YCbCr;
 
 extern const RawMode * const IMAGING_RAWMODE_BGR_15;
 extern const RawMode * const IMAGING_RAWMODE_BGR_16;
+extern const RawMode * const IMAGING_RAWMODE_BGR_24;
+extern const RawMode * const IMAGING_RAWMODE_BGR_32;
+
+extern const RawMode * const IMAGING_RAWMODE_I_16;
+extern const RawMode * const IMAGING_RAWMODE_I_16L;
+extern const RawMode * const IMAGING_RAWMODE_I_16B;
+extern const RawMode * const IMAGING_RAWMODE_I_16N;
 
 const RawMode * findRawMode(const char * const name);
 

From 12409e4574ef1eb2df52b286a46912268a0e1de5 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 14:44:41 +0200
Subject: [PATCH 1893/2374] use mode structs in _imaging.c

---
 src/_imaging.c           | 178 +++++++++++++++++++++++++++------------
 src/libImaging/Imaging.h |  34 ++++----
 2 files changed, 139 insertions(+), 73 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index fbfc0e41ae2..d0648540aeb 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -368,7 +368,7 @@ ImagingError_ValueError(const char *message) {
 /* -------------------------------------------------------------------- */
 
 static int
-getbands(const char *mode) {
+getbands(const Mode *mode) {
     Imaging im;
     int bands;
 
@@ -662,7 +662,11 @@ getink(PyObject *color, Imaging im, char *ink) {
             memcpy(ink, &ftmp, sizeof(ftmp));
             return ink;
         case IMAGING_TYPE_SPECIAL:
-            if (strncmp(im->mode, "I;16", 4) == 0) {
+            if (im->mode == IMAGING_MODE_I_16
+                || im->mode == IMAGING_MODE_I_16L
+                || im->mode == IMAGING_MODE_I_16B
+                || im->mode == IMAGING_MODE_I_16N
+            ) {
                 ink[0] = (UINT8)r;
                 ink[1] = (UINT8)(r >> 8);
                 ink[2] = ink[3] = 0;
@@ -681,6 +685,30 @@ getink(PyObject *color, Imaging im, char *ink) {
                 } else if (!PyArg_ParseTuple(color, "iiL", &b, &g, &r)) {
                     return NULL;
                 }
+                if (im->mode == IMAGING_MODE_BGR_15) {
+                    UINT16 v = ((((UINT16)r) << 7) & 0x7c00) +
+                               ((((UINT16)g) << 2) & 0x03e0) +
+                               ((((UINT16)b) >> 3) & 0x001f);
+
+                    ink[0] = (UINT8)v;
+                    ink[1] = (UINT8)(v >> 8);
+                    ink[2] = ink[3] = 0;
+                    return ink;
+                } else if (im->mode == IMAGING_MODE_BGR_16) {
+                    UINT16 v = ((((UINT16)r) << 8) & 0xf800) +
+                               ((((UINT16)g) << 3) & 0x07e0) +
+                               ((((UINT16)b) >> 3) & 0x001f);
+                    ink[0] = (UINT8)v;
+                    ink[1] = (UINT8)(v >> 8);
+                    ink[2] = ink[3] = 0;
+                    return ink;
+                } else if (im->mode == IMAGING_MODE_BGR_24) {
+                    ink[0] = (UINT8)b;
+                    ink[1] = (UINT8)g;
+                    ink[2] = (UINT8)r;
+                    ink[3] = 0;
+                    return ink;
+                }
             }
     }
 
@@ -694,7 +722,7 @@ getink(PyObject *color, Imaging im, char *ink) {
 
 static PyObject *
 _fill(PyObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     int xsize, ysize;
     PyObject *color;
     char buffer[4];
@@ -703,10 +731,12 @@ _fill(PyObject *self, PyObject *args) {
     xsize = ysize = 256;
     color = NULL;
 
-    if (!PyArg_ParseTuple(args, "s|(ii)O", &mode, &xsize, &ysize, &color)) {
+    if (!PyArg_ParseTuple(args, "s|(ii)O", &mode_name, &xsize, &ysize, &color)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     im = ImagingNewDirty(mode, xsize, ysize);
     if (!im) {
         return NULL;
@@ -727,47 +757,55 @@ _fill(PyObject *self, PyObject *args) {
 
 static PyObject *
 _new(PyObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     int xsize, ysize;
 
-    if (!PyArg_ParseTuple(args, "s(ii)", &mode, &xsize, &ysize)) {
+    if (!PyArg_ParseTuple(args, "s(ii)", &mode_name, &xsize, &ysize)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     return PyImagingNew(ImagingNew(mode, xsize, ysize));
 }
 
 static PyObject *
 _new_block(PyObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     int xsize, ysize;
 
-    if (!PyArg_ParseTuple(args, "s(ii)", &mode, &xsize, &ysize)) {
+    if (!PyArg_ParseTuple(args, "s(ii)", &mode_name, &xsize, &ysize)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     return PyImagingNew(ImagingNewBlock(mode, xsize, ysize));
 }
 
 static PyObject *
 _linear_gradient(PyObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
 
-    if (!PyArg_ParseTuple(args, "s", &mode)) {
+    if (!PyArg_ParseTuple(args, "s", &mode_name)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     return PyImagingNew(ImagingFillLinearGradient(mode));
 }
 
 static PyObject *
 _radial_gradient(PyObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
 
-    if (!PyArg_ParseTuple(args, "s", &mode)) {
+    if (!PyArg_ParseTuple(args, "s", &mode_name)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     return PyImagingNew(ImagingFillRadialGradient(mode));
 }
 
@@ -907,7 +945,7 @@ _prepare_lut_table(PyObject *table, Py_ssize_t table_size) {
 
 static PyObject *
 _color_lut_3d(ImagingObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     int filter;
     int table_channels;
     int size1D, size2D, size3D;
@@ -919,7 +957,7 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
     if (!PyArg_ParseTuple(
             args,
             "sii(iii)O:color_lut_3d",
-            &mode,
+            &mode_name,
             &filter,
             &table_channels,
             &size1D,
@@ -930,6 +968,8 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     /* actually, it is trilinear */
     if (filter != IMAGING_TRANSFORM_BILINEAR) {
         PyErr_SetString(PyExc_ValueError, "Only LINEAR filter is supported.");
@@ -976,11 +1016,11 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
 
 static PyObject *
 _convert(ImagingObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     int dither = 0;
     ImagingObject *paletteimage = NULL;
 
-    if (!PyArg_ParseTuple(args, "s|iO", &mode, &dither, &paletteimage)) {
+    if (!PyArg_ParseTuple(args, "s|iO", &mode_name, &dither, &paletteimage)) {
         return NULL;
     }
     if (paletteimage != NULL) {
@@ -997,6 +1037,8 @@ _convert(ImagingObject *self, PyObject *args) {
         }
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     return PyImagingNew(ImagingConvert(
         self->image, mode, paletteimage ? paletteimage->image->palette : NULL, dither
     ));
@@ -1021,14 +1063,14 @@ _convert2(ImagingObject *self, PyObject *args) {
 
 static PyObject *
 _convert_matrix(ImagingObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     float m[12];
-    if (!PyArg_ParseTuple(args, "s(ffff)", &mode, m + 0, m + 1, m + 2, m + 3)) {
+    if (!PyArg_ParseTuple(args, "s(ffff)", &mode_name, m + 0, m + 1, m + 2, m + 3)) {
         PyErr_Clear();
         if (!PyArg_ParseTuple(
                 args,
                 "s(ffffffffffff)",
-                &mode,
+                &mode_name,
                 m + 0,
                 m + 1,
                 m + 2,
@@ -1046,18 +1088,22 @@ _convert_matrix(ImagingObject *self, PyObject *args) {
         }
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     return PyImagingNew(ImagingConvertMatrix(self->image, mode, m));
 }
 
 static PyObject *
 _convert_transparent(ImagingObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     int r, g, b;
-    if (PyArg_ParseTuple(args, "s(iii)", &mode, &r, &g, &b)) {
+    if (PyArg_ParseTuple(args, "s(iii)", &mode_name, &r, &g, &b)) {
+        const Mode * const mode = findMode(mode_name);
         return PyImagingNew(ImagingConvertTransparent(self->image, mode, r, g, b));
     }
     PyErr_Clear();
-    if (PyArg_ParseTuple(args, "si", &mode, &r)) {
+    if (PyArg_ParseTuple(args, "si", &mode_name, &r)) {
+        const Mode * const mode = findMode(mode_name);
         return PyImagingNew(ImagingConvertTransparent(self->image, mode, r, 0, 0));
     }
     return NULL;
@@ -1156,9 +1202,9 @@ _getpalette(ImagingObject *self, PyObject *args) {
     int bits;
     ImagingShuffler pack;
 
-    char *mode = "RGB";
-    char *rawmode = "RGB";
-    if (!PyArg_ParseTuple(args, "|ss", &mode, &rawmode)) {
+    char *mode_name = "RGB";
+    char *rawmode_name = "RGB";
+    if (!PyArg_ParseTuple(args, "|ss", &mode_name, &rawmode_name)) {
         return NULL;
     }
 
@@ -1167,6 +1213,9 @@ _getpalette(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     pack = ImagingFindPacker(mode, rawmode, &bits);
     if (!pack) {
         PyErr_SetString(PyExc_ValueError, wrong_raw_mode);
@@ -1193,7 +1242,7 @@ _getpalettemode(ImagingObject *self) {
         return NULL;
     }
 
-    return PyUnicode_FromString(self->image->palette->mode);
+    return PyUnicode_FromString(self->image->palette->mode->name);
 }
 
 static inline int
@@ -1474,12 +1523,14 @@ _point(ImagingObject *self, PyObject *args) {
     Imaging im;
 
     PyObject *list;
-    char *mode;
-    if (!PyArg_ParseTuple(args, "Oz", &list, &mode)) {
+    char *mode_name;
+    if (!PyArg_ParseTuple(args, "Oz", &list, &mode_name)) {
         return NULL;
     }
 
-    if (mode && !strcmp(mode, "F")) {
+    const Mode * const mode = findMode(mode_name);
+
+    if (mode == IMAGING_MODE_F) {
         FLOAT32 *data;
 
         /* map from 8-bit data to floating point */
@@ -1490,8 +1541,7 @@ _point(ImagingObject *self, PyObject *args) {
         }
         im = ImagingPoint(self->image, mode, (void *)data);
         free(data);
-
-    } else if (!strcmp(self->image->mode, "I") && mode && !strcmp(mode, "L")) {
+    } else if (self->image->mode == IMAGING_MODE_I && mode == IMAGING_MODE_L) {
         UINT8 *data;
 
         /* map from 16-bit subset of 32-bit data to 8-bit */
@@ -1503,7 +1553,6 @@ _point(ImagingObject *self, PyObject *args) {
         }
         im = ImagingPoint(self->image, mode, (void *)data);
         free(data);
-
     } else {
         INT32 *data;
         UINT8 lut[1024];
@@ -1524,7 +1573,7 @@ _point(ImagingObject *self, PyObject *args) {
             return NULL;
         }
 
-        if (mode && !strcmp(mode, "I")) {
+        if (mode == IMAGING_MODE_I) {
             im = ImagingPoint(self->image, mode, (void *)data);
         } else if (mode && bands > 1) {
             for (i = 0; i < 256; i++) {
@@ -1629,10 +1678,9 @@ _putdata(ImagingObject *self, PyObject *args) {
             int bigendian = 0;
             if (image->type == IMAGING_TYPE_SPECIAL) {
                 // I;16*
-                if (
-                    strcmp(image->mode, "I;16B") == 0
+                if (image->mode == IMAGING_MODE_I_16B
 #ifdef WORDS_BIGENDIAN
-                    || strcmp(image->mode, "I;16N") == 0
+                    || image->mode == IMAGING_MODE_I_16N
 #endif
                 ) {
                     bigendian = 1;
@@ -1729,7 +1777,7 @@ _quantize(ImagingObject *self, PyObject *args) {
 
     if (!self->image->xsize || !self->image->ysize) {
         /* no content; return an empty image */
-        return PyImagingNew(ImagingNew("P", self->image->xsize, self->image->ysize));
+        return PyImagingNew(ImagingNew(IMAGING_MODE_P, self->image->xsize, self->image->ysize));
     }
 
     return PyImagingNew(ImagingQuantize(self->image, colours, method, kmeans));
@@ -1740,21 +1788,33 @@ _putpalette(ImagingObject *self, PyObject *args) {
     ImagingShuffler unpack;
     int bits;
 
-    char *palette_mode, *rawmode;
+    char *palette_mode_name, *rawmode_name;
     UINT8 *palette;
     Py_ssize_t palettesize;
     if (!PyArg_ParseTuple(
-            args, "ssy#", &palette_mode, &rawmode, &palette, &palettesize
+            args, "ssy#", &palette_mode_name, &rawmode_name, &palette, &palettesize
         )) {
         return NULL;
     }
 
-    if (strcmp(self->image->mode, "L") && strcmp(self->image->mode, "LA") &&
-        strcmp(self->image->mode, "P") && strcmp(self->image->mode, "PA")) {
+    if (self->image->mode != IMAGING_MODE_L && self->image->mode != IMAGING_MODE_LA &&
+        self->image->mode != IMAGING_MODE_P && self->image->mode != IMAGING_MODE_PA) {
         PyErr_SetString(PyExc_ValueError, wrong_mode);
         return NULL;
     }
 
+    const Mode * const palette_mode = findMode(palette_mode_name);
+    if (palette_mode == NULL) {
+        PyErr_SetString(PyExc_ValueError, wrong_mode);
+        return NULL;
+    }
+
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+    if (rawmode == NULL) {
+        PyErr_SetString(PyExc_ValueError, wrong_raw_mode);
+        return NULL;
+    }
+
     unpack = ImagingFindUnpacker(palette_mode, rawmode, &bits);
     if (!unpack) {
         PyErr_SetString(PyExc_ValueError, wrong_raw_mode);
@@ -1768,7 +1828,7 @@ _putpalette(ImagingObject *self, PyObject *args) {
 
     ImagingPaletteDelete(self->image->palette);
 
-    strcpy(self->image->mode, strlen(self->image->mode) == 2 ? "PA" : "P");
+    self->image->mode = strlen(self->image->mode->name) == 2 ? IMAGING_MODE_PA : IMAGING_MODE_P;
 
     self->image->palette = ImagingPaletteNew(palette_mode);
 
@@ -1796,7 +1856,7 @@ _putpalettealpha(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    strcpy(self->image->palette->mode, "RGBA");
+    self->image->palette->mode = IMAGING_MODE_RGBA;
     self->image->palette->palette[index * 4 + 3] = (UINT8)alpha;
 
     Py_RETURN_NONE;
@@ -1821,7 +1881,7 @@ _putpalettealphas(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    strcpy(self->image->palette->mode, "RGBA");
+    self->image->palette->mode = IMAGING_MODE_RGBA;
     for (i = 0; i < length; i++) {
         self->image->palette->palette[i * 4 + 3] = (UINT8)values[i];
     }
@@ -1989,8 +2049,10 @@ _reduce(ImagingObject *self, PyObject *args) {
     return PyImagingNew(imOut);
 }
 
-#define IS_RGB(mode) \
-    (!strcmp(mode, "RGB") || !strcmp(mode, "RGBA") || !strcmp(mode, "RGBX"))
+static int
+isRGB(const Mode * const mode) {
+    return mode == IMAGING_MODE_RGB || mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_RGBX;
+}
 
 static PyObject *
 im_setmode(ImagingObject *self, PyObject *args) {
@@ -1998,23 +2060,25 @@ im_setmode(ImagingObject *self, PyObject *args) {
 
     Imaging im;
 
-    char *mode;
+    char *mode_name;
     Py_ssize_t modelen;
-    if (!PyArg_ParseTuple(args, "s#:setmode", &mode, &modelen)) {
+    if (!PyArg_ParseTuple(args, "s#:setmode", &mode_name, &modelen)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     im = self->image;
 
     /* move all logic in here to the libImaging primitive */
 
-    if (!strcmp(im->mode, mode)) {
+    if (im->mode == mode) {
         ; /* same mode; always succeeds */
-    } else if (IS_RGB(im->mode) && IS_RGB(mode)) {
+    } else if (isRGB(im->mode) && isRGB(mode)) {
         /* color to color */
-        strcpy(im->mode, mode);
+        im->mode = mode;
         im->bands = modelen;
-        if (!strcmp(mode, "RGBA")) {
+        if (mode == IMAGING_MODE_RGBA) {
             (void)ImagingFillBand(im, 3, 255);
         }
     } else {
@@ -2294,7 +2358,7 @@ _getextrema(ImagingObject *self) {
             case IMAGING_TYPE_FLOAT32:
                 return Py_BuildValue("dd", extrema.f[0], extrema.f[1]);
             case IMAGING_TYPE_SPECIAL:
-                if (strcmp(self->image->mode, "I;16") == 0) {
+                if (self->image->mode == IMAGING_MODE_I_16) {
                     return Py_BuildValue("HH", extrema.s[0], extrema.s[1]);
                 }
         }
@@ -2383,7 +2447,7 @@ _putband(ImagingObject *self, PyObject *args) {
 
 static PyObject *
 _merge(PyObject *self, PyObject *args) {
-    char *mode;
+    char *mode_name;
     ImagingObject *band0 = NULL;
     ImagingObject *band1 = NULL;
     ImagingObject *band2 = NULL;
@@ -2393,7 +2457,7 @@ _merge(PyObject *self, PyObject *args) {
     if (!PyArg_ParseTuple(
             args,
             "sO!|O!O!O!",
-            &mode,
+            &mode_name,
             &Imaging_Type,
             &band0,
             &Imaging_Type,
@@ -2406,6 +2470,8 @@ _merge(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     if (band0) {
         bands[0] = band0->image;
     }
@@ -3711,7 +3777,7 @@ static struct PyMethodDef methods[] = {
 
 static PyObject *
 _getattr_mode(ImagingObject *self, void *closure) {
-    return PyUnicode_FromString(self->image->mode);
+    return PyUnicode_FromString(self->image->mode->name);
 }
 
 static PyObject *
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 1eaabd8e561..49f17f0daa0 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -193,16 +193,16 @@ extern void
 ImagingMemorySetBlockAllocator(ImagingMemoryArena arena, int use_block_allocator);
 
 extern Imaging
-ImagingNew(const char *mode, int xsize, int ysize);
+ImagingNew(const Mode *mode, int xsize, int ysize);
 extern Imaging
-ImagingNewDirty(const char *mode, int xsize, int ysize);
+ImagingNewDirty(const Mode *mode, int xsize, int ysize);
 extern Imaging
-ImagingNew2Dirty(const char *mode, Imaging imOut, Imaging imIn);
+ImagingNew2Dirty(const Mode *mode, Imaging imOut, Imaging imIn);
 extern void
 ImagingDelete(Imaging im);
 
 extern Imaging
-ImagingNewBlock(const char *mode, int xsize, int ysize);
+ImagingNewBlock(const Mode *mode, int xsize, int ysize);
 
 extern Imaging
 ImagingNewArrow(
@@ -214,9 +214,9 @@ ImagingNewArrow(
 );
 
 extern Imaging
-ImagingNewPrologue(const char *mode, int xsize, int ysize);
+ImagingNewPrologue(const Mode *mode, int xsize, int ysize);
 extern Imaging
-ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int structure_size);
+ImagingNewPrologueSubtype(const Mode *mode, int xsize, int ysize, int structure_size);
 
 extern void
 ImagingCopyPalette(Imaging destination, Imaging source);
@@ -233,7 +233,7 @@ _ImagingAccessDelete(Imaging im, ImagingAccess access);
 #define ImagingAccessDelete(im, access) /* nop, for now */
 
 extern ImagingPalette
-ImagingPaletteNew(const char *mode);
+ImagingPaletteNew(const Mode *mode);
 extern ImagingPalette
 ImagingPaletteNewBrowser(void);
 extern ImagingPalette
@@ -305,13 +305,13 @@ ImagingBlend(Imaging imIn1, Imaging imIn2, float alpha);
 extern Imaging
 ImagingCopy(Imaging im);
 extern Imaging
-ImagingConvert(Imaging im, const char *mode, ImagingPalette palette, int dither);
+ImagingConvert(Imaging im, const Mode *mode, ImagingPalette palette, int dither);
 extern Imaging
-ImagingConvertInPlace(Imaging im, const char *mode);
+ImagingConvertInPlace(Imaging im, const Mode *mode);
 extern Imaging
-ImagingConvertMatrix(Imaging im, const char *mode, float m[]);
+ImagingConvertMatrix(Imaging im, const Mode *mode, float m[]);
 extern Imaging
-ImagingConvertTransparent(Imaging im, const char *mode, int r, int g, int b);
+ImagingConvertTransparent(Imaging im, const Mode *mode, int r, int g, int b);
 extern Imaging
 ImagingCrop(Imaging im, int x0, int y0, int x1, int y1);
 extern Imaging
@@ -325,9 +325,9 @@ ImagingFill2(
 extern Imaging
 ImagingFillBand(Imaging im, int band, int color);
 extern Imaging
-ImagingFillLinearGradient(const char *mode);
+ImagingFillLinearGradient(const Mode *mode);
 extern Imaging
-ImagingFillRadialGradient(const char *mode);
+ImagingFillRadialGradient(const Mode *mode);
 extern Imaging
 ImagingFilter(Imaging im, int xsize, int ysize, const FLOAT32 *kernel, FLOAT32 offset);
 extern Imaging
@@ -341,7 +341,7 @@ ImagingGaussianBlur(
 extern Imaging
 ImagingGetBand(Imaging im, int band);
 extern Imaging
-ImagingMerge(const char *mode, Imaging bands[4]);
+ImagingMerge(const Mode *mode, Imaging bands[4]);
 extern int
 ImagingSplit(Imaging im, Imaging bands[4]);
 extern int
@@ -368,7 +368,7 @@ ImagingOffset(Imaging im, int xoffset, int yoffset);
 extern int
 ImagingPaste(Imaging into, Imaging im, Imaging mask, int x0, int y0, int x1, int y1);
 extern Imaging
-ImagingPoint(Imaging im, const char *tablemode, const void *table);
+ImagingPoint(Imaging im, const Mode *tablemode, const void *table);
 extern Imaging
 ImagingPointTransform(Imaging imIn, double scale, double offset);
 extern Imaging
@@ -709,9 +709,9 @@ extern void
 ImagingConvertYCbCr2RGB(UINT8 *out, const UINT8 *in, int pixels);
 
 extern ImagingShuffler
-ImagingFindUnpacker(const char *mode, const char *rawmode, int *bits_out);
+ImagingFindUnpacker(const Mode *mode, const RawMode *rawmode, int *bits_out);
 extern ImagingShuffler
-ImagingFindPacker(const char *mode, const char *rawmode, int *bits_out);
+ImagingFindPacker(const Mode *mode, const RawMode *rawmode, int *bits_out);
 
 struct ImagingCodecStateInstance {
     int count;

From a37f53c94974232c3d239ca9194d93296638d3ad Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 00:58:11 -0500
Subject: [PATCH 1894/2374] use mode structs in tkImaging.c

---
 src/Tk/tkImaging.c | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index a36c3e0bdc4..3e35f885f61 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -121,15 +121,18 @@ PyImagingPhotoPut(
 
     /* Mode */
 
-    if (strcmp(im->mode, "1") == 0 || strcmp(im->mode, "L") == 0) {
+    if (im->mode == IMAGING_MODE_1 || im->mode == IMAGING_MODE_L) {
         block.pixelSize = 1;
         block.offset[0] = block.offset[1] = block.offset[2] = block.offset[3] = 0;
-    } else if (strncmp(im->mode, "RGB", 3) == 0) {
+    } else if (
+        im->mode == IMAGING_MODE_RGB || im->mode == IMAGING_MODE_RGBA ||
+        im->mode == IMAGING_MODE_RGBX || im->mode == IMAGING_MODE_RGBa
+    ) {
         block.pixelSize = 4;
         block.offset[0] = 0;
         block.offset[1] = 1;
         block.offset[2] = 2;
-        if (strcmp(im->mode, "RGBA") == 0) {
+        if (im->mode == IMAGING_MODE_RGBA) {
             block.offset[3] = 3; /* alpha (or reserved, under Tk 8.2) */
         } else {
             block.offset[3] = 0; /* no alpha */

From a12dc30dc0f4a9b16c49fef2597a8d2f052983fe Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 14:46:29 +0200
Subject: [PATCH 1895/2374] use mode structs in encode.c and decode.c

---
 src/decode.c          | 105 ++++++++++++++++++++++++++----------------
 src/encode.c          |  94 +++++++++++++++++++++++++------------
 src/libImaging/Jpeg.h |   8 ++--
 src/libImaging/Mode.h |   7 +++
 4 files changed, 140 insertions(+), 74 deletions(-)

diff --git a/src/decode.c b/src/decode.c
index 03db1ce3516..9f4de28a828 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -266,7 +266,7 @@ static PyTypeObject ImagingDecoderType = {
 /* -------------------------------------------------------------------- */
 
 int
-get_unpacker(ImagingDecoderObject *decoder, const char *mode, const char *rawmode) {
+get_unpacker(ImagingDecoderObject *decoder, const Mode *mode, const RawMode *rawmode) {
     int bits;
     ImagingShuffler unpack;
 
@@ -436,12 +436,14 @@ PyObject *
 PyImaging_HexDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
-    if (!PyArg_ParseTuple(args, "ss", &mode, &rawmode)) {
+    char *mode_name, *rawmode_name;
+    if (!PyArg_ParseTuple(args, "ss", &mode_name, &rawmode_name)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
         return NULL;
@@ -469,16 +471,19 @@ PyImaging_HexDecoderNew(PyObject *self, PyObject *args) {
 PyObject *
 PyImaging_LibTiffDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     char *compname;
     int fp;
     uint32_t ifdoffset;
 
-    if (!PyArg_ParseTuple(args, "sssiI", &mode, &rawmode, &compname, &fp, &ifdoffset)) {
+    if (!PyArg_ParseTuple(args, "sssiI", &mode_name, &rawmode_name, &compname, &fp, &ifdoffset)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     TRACE(("new tiff decoder %s\n", compname));
 
     decoder = PyImaging_DecoderNew(sizeof(TIFFSTATE));
@@ -511,12 +516,15 @@ PyObject *
 PyImaging_PackbitsDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
-    if (!PyArg_ParseTuple(args, "ss", &mode, &rawmode)) {
+    char *mode_name;
+    char *rawmode_name;
+    if (!PyArg_ParseTuple(args, "ss", &mode_name, &rawmode_name)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
         return NULL;
@@ -545,7 +553,7 @@ PyImaging_PcdDecoderNew(PyObject *self, PyObject *args) {
     }
 
     /* Unpack from PhotoYCC to RGB */
-    if (get_unpacker(decoder, "RGB", "YCC;P") < 0) {
+    if (get_unpacker(decoder, IMAGING_MODE_RGB, IMAGING_RAWMODE_YCC_P) < 0) {
         return NULL;
     }
 
@@ -562,13 +570,15 @@ PyObject *
 PyImaging_PcxDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name, *rawmode_name;
     int stride;
-    if (!PyArg_ParseTuple(args, "ssi", &mode, &rawmode, &stride)) {
+    if (!PyArg_ParseTuple(args, "ssi", &mode_name, &rawmode_name, &stride)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
         return NULL;
@@ -593,14 +603,16 @@ PyObject *
 PyImaging_RawDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name, *rawmode_name;
     int stride = 0;
     int ystep = 1;
-    if (!PyArg_ParseTuple(args, "ss|ii", &mode, &rawmode, &stride, &ystep)) {
+    if (!PyArg_ParseTuple(args, "ss|ii", &mode_name, &rawmode_name, &stride, &ystep)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(sizeof(RAWSTATE));
     if (decoder == NULL) {
         return NULL;
@@ -627,14 +639,16 @@ PyObject *
 PyImaging_SgiRleDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name, *rawmode_name;
     int ystep = 1;
     int bpc = 1;
-    if (!PyArg_ParseTuple(args, "ss|ii", &mode, &rawmode, &ystep, &bpc)) {
+    if (!PyArg_ParseTuple(args, "ss|ii", &mode_name, &rawmode_name, &ystep, &bpc)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(sizeof(SGISTATE));
     if (decoder == NULL) {
         return NULL;
@@ -661,12 +675,14 @@ PyObject *
 PyImaging_SunRleDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
-    if (!PyArg_ParseTuple(args, "ss", &mode, &rawmode)) {
+    char *mode_name, *rawmode_name;
+    if (!PyArg_ParseTuple(args, "ss", &mode_name, &rawmode_name)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
         return NULL;
@@ -689,14 +705,16 @@ PyObject *
 PyImaging_TgaRleDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name, *rawmode_name;
     int ystep = 1;
     int depth = 8;
-    if (!PyArg_ParseTuple(args, "ss|ii", &mode, &rawmode, &ystep, &depth)) {
+    if (!PyArg_ParseTuple(args, "ss|ii", &mode_name, &rawmode_name, &ystep, &depth)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
         return NULL;
@@ -727,7 +745,7 @@ PyImaging_XbmDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    if (get_unpacker(decoder, "1", "1;R") < 0) {
+    if (get_unpacker(decoder, IMAGING_MODE_1, IMAGING_RAWMODE_1_R) < 0) {
         return NULL;
     }
 
@@ -748,13 +766,15 @@ PyObject *
 PyImaging_ZipDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name, *rawmode_name;
     int interlaced = 0;
-    if (!PyArg_ParseTuple(args, "ss|i", &mode, &rawmode, &interlaced)) {
+    if (!PyArg_ParseTuple(args, "ss|i", &mode_name, &rawmode_name, &interlaced)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     decoder = PyImaging_DecoderNew(sizeof(ZIPSTATE));
     if (decoder == NULL) {
         return NULL;
@@ -798,16 +818,19 @@ PyObject *
 PyImaging_JpegDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *rawmode;  /* what we want from the decoder */
-    char *jpegmode; /* what's in the file */
+    char *mode_name;
+    char *rawmode_name; /* what we want from the decoder */
+    char *jpegmode;     /* what's in the file */
     int scale = 1;
     int draft = 0;
 
-    if (!PyArg_ParseTuple(args, "ssz|ii", &mode, &rawmode, &jpegmode, &scale, &draft)) {
+    if (!PyArg_ParseTuple(args, "ssz|ii", &mode_name, &rawmode_name, &jpegmode, &scale, &draft)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * rawmode = findRawMode(rawmode_name);
+
     if (!jpegmode) {
         jpegmode = "";
     }
@@ -820,8 +843,8 @@ PyImaging_JpegDecoderNew(PyObject *self, PyObject *args) {
     // libjpeg-turbo supports different output formats.
     // We are choosing Pillow's native format (3 color bytes + 1 padding)
     // to avoid extra conversion in Unpack.c.
-    if (ImagingJpegUseJCSExtensions() && strcmp(rawmode, "RGB") == 0) {
-        rawmode = "RGBX";
+    if (ImagingJpegUseJCSExtensions() && rawmode == IMAGING_RAWMODE_RGB) {
+        rawmode = IMAGING_RAWMODE_RGBX;
     }
 
     if (get_unpacker(decoder, mode, rawmode) < 0) {
@@ -831,11 +854,13 @@ PyImaging_JpegDecoderNew(PyObject *self, PyObject *args) {
     decoder->decode = ImagingJpegDecode;
     decoder->cleanup = ImagingJpegDecodeCleanup;
 
-    strncpy(((JPEGSTATE *)decoder->state.context)->rawmode, rawmode, 8);
-    strncpy(((JPEGSTATE *)decoder->state.context)->jpegmode, jpegmode, 8);
+    JPEGSTATE *jpeg_decoder_state_context = (JPEGSTATE *)decoder->state.context;
+
+    jpeg_decoder_state_context->rawmode = rawmode;
+    strncpy(jpeg_decoder_state_context->jpegmode, jpegmode, 8);
 
-    ((JPEGSTATE *)decoder->state.context)->scale = scale;
-    ((JPEGSTATE *)decoder->state.context)->draft = draft;
+    jpeg_decoder_state_context->scale = scale;
+    jpeg_decoder_state_context->draft = draft;
 
     return (PyObject *)decoder;
 }
diff --git a/src/encode.c b/src/encode.c
index e56494036ff..311ffa4eed0 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -334,14 +334,19 @@ static PyTypeObject ImagingEncoderType = {
 /* -------------------------------------------------------------------- */
 
 int
-get_packer(ImagingEncoderObject *encoder, const char *mode, const char *rawmode) {
+get_packer(ImagingEncoderObject *encoder, const Mode *mode, const RawMode *rawmode) {
     int bits;
     ImagingShuffler pack;
 
     pack = ImagingFindPacker(mode, rawmode, &bits);
     if (!pack) {
         Py_DECREF(encoder);
-        PyErr_Format(PyExc_ValueError, "No packer found from %s to %s", mode, rawmode);
+        PyErr_Format(
+            PyExc_ValueError,
+            "No packer found from %s to %s",
+            mode->name,
+            rawmode->name
+        );
         return -1;
     }
 
@@ -402,11 +407,11 @@ PyObject *
 PyImaging_GifEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     Py_ssize_t bits = 8;
     Py_ssize_t interlace = 0;
-    if (!PyArg_ParseTuple(args, "ss|nn", &mode, &rawmode, &bits, &interlace)) {
+    if (!PyArg_ParseTuple(args, "ss|nn", &mode_name, &rawmode_name, &bits, &interlace)) {
         return NULL;
     }
 
@@ -415,6 +420,9 @@ PyImaging_GifEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
     }
@@ -435,11 +443,11 @@ PyObject *
 PyImaging_PcxEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     Py_ssize_t bits = 8;
 
-    if (!PyArg_ParseTuple(args, "ss|n", &mode, &rawmode, &bits)) {
+    if (!PyArg_ParseTuple(args, "ss|n", &mode_name, &rawmode_name, &bits)) {
         return NULL;
     }
 
@@ -448,6 +456,9 @@ PyImaging_PcxEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
     }
@@ -465,12 +476,12 @@ PyObject *
 PyImaging_RawEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     Py_ssize_t stride = 0;
     Py_ssize_t ystep = 1;
 
-    if (!PyArg_ParseTuple(args, "ss|nn", &mode, &rawmode, &stride, &ystep)) {
+    if (!PyArg_ParseTuple(args, "ss|nn", &mode_name, &rawmode_name, &stride, &ystep)) {
         return NULL;
     }
 
@@ -479,6 +490,9 @@ PyImaging_RawEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
     }
@@ -499,11 +513,11 @@ PyObject *
 PyImaging_TgaRleEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     Py_ssize_t ystep = 1;
 
-    if (!PyArg_ParseTuple(args, "ss|n", &mode, &rawmode, &ystep)) {
+    if (!PyArg_ParseTuple(args, "ss|n", &mode_name, &rawmode_name, &ystep)) {
         return NULL;
     }
 
@@ -512,6 +526,9 @@ PyImaging_TgaRleEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
     }
@@ -536,7 +553,7 @@ PyImaging_XbmEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    if (get_packer(encoder, "1", "1;R") < 0) {
+    if (get_packer(encoder, IMAGING_MODE_1, IMAGING_RAWMODE_1_R) < 0) {
         return NULL;
     }
 
@@ -557,8 +574,8 @@ PyObject *
 PyImaging_ZipEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     Py_ssize_t optimize = 0;
     Py_ssize_t compress_level = -1;
     Py_ssize_t compress_type = -1;
@@ -567,8 +584,8 @@ PyImaging_ZipEncoderNew(PyObject *self, PyObject *args) {
     if (!PyArg_ParseTuple(
             args,
             "ss|nnny#",
-            &mode,
-            &rawmode,
+            &mode_name,
+            &rawmode_name,
             &optimize,
             &compress_level,
             &compress_type,
@@ -597,6 +614,9 @@ PyImaging_ZipEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     if (get_packer(encoder, mode, rawmode) < 0) {
         free(dictionary);
         return NULL;
@@ -605,7 +625,7 @@ PyImaging_ZipEncoderNew(PyObject *self, PyObject *args) {
     encoder->encode = ImagingZipEncode;
     encoder->cleanup = ImagingZipEncodeCleanup;
 
-    if (rawmode[0] == 'P') {
+    if (rawmode == IMAGING_RAWMODE_P || rawmode == IMAGING_RAWMODE_PA) {
         /* disable filtering */
         ((ZIPSTATE *)encoder->state.context)->mode = ZIP_PNG_PALETTE;
     }
@@ -634,8 +654,8 @@ PyObject *
 PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     char *compname;
     char *filename;
     Py_ssize_t fp;
@@ -655,7 +675,15 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
     PyObject *item;
 
     if (!PyArg_ParseTuple(
-            args, "sssnsOO", &mode, &rawmode, &compname, &fp, &filename, &tags, &types
+            args,
+            "sssnsOO",
+            &mode_name,
+            &rawmode_name,
+            &compname,
+            &fp,
+            &filename,
+            &tags,
+            &types
         )) {
         return NULL;
     }
@@ -693,6 +721,9 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * const rawmode = findRawMode(rawmode_name);
+
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
     }
@@ -1076,8 +1107,8 @@ PyObject *
 PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
     ImagingEncoderObject *encoder;
 
-    char *mode;
-    char *rawmode;
+    char *mode_name;
+    char *rawmode_name;
     Py_ssize_t quality = 0;
     Py_ssize_t progressive = 0;
     Py_ssize_t smooth = 0;
@@ -1101,8 +1132,8 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
     if (!PyArg_ParseTuple(
             args,
             "ss|nnnnpn(nn)nnnOz#y#y#",
-            &mode,
-            &rawmode,
+            &mode_name,
+            &rawmode_name,
             &quality,
             &progressive,
             &smooth,
@@ -1130,11 +1161,14 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+    const RawMode * rawmode = findRawMode(rawmode_name);
+
     // libjpeg-turbo supports different output formats.
     // We are choosing Pillow's native format (3 color bytes + 1 padding)
     // to avoid extra conversion in Pack.c.
-    if (ImagingJpegUseJCSExtensions() && strcmp(rawmode, "RGB") == 0) {
-        rawmode = "RGBX";
+    if (ImagingJpegUseJCSExtensions() && rawmode == IMAGING_RAWMODE_RGB) {
+        rawmode = IMAGING_RAWMODE_RGBX;
     }
 
     if (get_packer(encoder, mode, rawmode) < 0) {
@@ -1192,7 +1226,7 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
     encoder->encode = ImagingJpegEncode;
 
     JPEGENCODERSTATE *jpeg_encoder_state = (JPEGENCODERSTATE *)encoder->state.context;
-    strncpy(jpeg_encoder_state->rawmode, rawmode, 8);
+    jpeg_encoder_state->rawmode = rawmode;
     jpeg_encoder_state->keep_rgb = keep_rgb;
     jpeg_encoder_state->quality = quality;
     jpeg_encoder_state->qtables = qarrays;
diff --git a/src/libImaging/Jpeg.h b/src/libImaging/Jpeg.h
index 7cdba902281..35df91d7ffa 100644
--- a/src/libImaging/Jpeg.h
+++ b/src/libImaging/Jpeg.h
@@ -31,9 +31,9 @@ typedef struct {
     /* Jpeg file mode (empty if not known) */
     char jpegmode[8 + 1];
 
-    /* Converter output mode (input to the shuffler).  If empty,
-       convert conversions are disabled */
-    char rawmode[8 + 1];
+    /* Converter output mode (input to the shuffler) */
+    /* If NULL, convert conversions are disabled */
+    const RawMode *rawmode;
 
     /* If set, trade quality for speed */
     int draft;
@@ -91,7 +91,7 @@ typedef struct {
     unsigned int restart_marker_rows;
 
     /* Converter input mode (input to the shuffler) */
-    char rawmode[8 + 1];
+    const RawMode *rawmode;
 
     /* Custom quantization tables () */
     unsigned int *qtables;
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index 6491beb81b7..a9910366710 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -43,6 +43,7 @@ typedef struct {
     const char * const name;
 } RawMode;
 
+// Non-rawmode aliases.
 extern const RawMode * const IMAGING_RAWMODE_1;
 extern const RawMode * const IMAGING_RAWMODE_CMYK;
 extern const RawMode * const IMAGING_RAWMODE_F;
@@ -60,16 +61,22 @@ extern const RawMode * const IMAGING_RAWMODE_RGBX;
 extern const RawMode * const IMAGING_RAWMODE_RGBa;
 extern const RawMode * const IMAGING_RAWMODE_YCbCr;
 
+// BGR modes.
 extern const RawMode * const IMAGING_RAWMODE_BGR_15;
 extern const RawMode * const IMAGING_RAWMODE_BGR_16;
 extern const RawMode * const IMAGING_RAWMODE_BGR_24;
 extern const RawMode * const IMAGING_RAWMODE_BGR_32;
 
+// I;16 modes.
 extern const RawMode * const IMAGING_RAWMODE_I_16;
 extern const RawMode * const IMAGING_RAWMODE_I_16L;
 extern const RawMode * const IMAGING_RAWMODE_I_16B;
 extern const RawMode * const IMAGING_RAWMODE_I_16N;
 
+// Rawmodes
+extern const RawMode * const IMAGING_RAWMODE_1_R;
+extern const RawMode * const IMAGING_RAWMODE_YCC_P;
+
 const RawMode * findRawMode(const char * const name);
 
 

From 0df2ed0640b4be12fb7066d39868e1c77adfa52e Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 14:53:22 +0200
Subject: [PATCH 1896/2374] use mode structs in Access.c

---
 src/libImaging/Access.c | 123 ++++++++++++++++++----------------------
 src/libImaging/Mode.c   |   8 +++
 src/libImaging/Mode.h   |   6 +-
 3 files changed, 69 insertions(+), 68 deletions(-)

diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 3db52377e80..850399b1401 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -11,38 +11,9 @@
 
 #include "Imaging.h"
 
-/* use make_hash.py from the pillow-scripts repository to calculate these values */
-#define ACCESS_TABLE_SIZE 35
-#define ACCESS_TABLE_HASH 8940
+#define ACCESS_TABLE_SIZE 24
+static struct ImagingAccessInstance ACCESS_TABLE[ACCESS_TABLE_SIZE];
 
-static struct ImagingAccessInstance access_table[ACCESS_TABLE_SIZE];
-
-static inline UINT32
-hash(const char *mode) {
-    UINT32 i = ACCESS_TABLE_HASH;
-    while (*mode) {
-        i = ((i << 5) + i) ^ (UINT8)*mode++;
-    }
-    return i % ACCESS_TABLE_SIZE;
-}
-
-static ImagingAccess
-add_item(const char *mode) {
-    UINT32 i = hash(mode);
-    /* printf("hash %s => %d\n", mode, i); */
-    if (access_table[i].mode && strcmp(access_table[i].mode, mode) != 0) {
-        fprintf(
-            stderr,
-            "AccessInit: hash collision: %d for both %s and %s\n",
-            i,
-            mode,
-            access_table[i].mode
-        );
-        exit(1);
-    }
-    access_table[i].mode = mode;
-    return &access_table[i];
-}
 
 /* fetch individual pixel */
 
@@ -149,51 +120,69 @@ put_pixel_32(Imaging im, int x, int y, const void *color) {
     memcpy(&im->image32[y][x], color, sizeof(INT32));
 }
 
+
+static void
+set_access_table_item(
+    const int index,
+    const Mode * const mode,
+    void (*get_pixel)(Imaging im, int x, int y, void *pixel),
+    void (*put_pixel)(Imaging im, int x, int y, const void *pixel)
+) {
+    ACCESS_TABLE[index].mode = mode;
+    ACCESS_TABLE[index].get_pixel = get_pixel;
+    ACCESS_TABLE[index].put_pixel = put_pixel;
+}
+
 void
 ImagingAccessInit(void) {
-#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 */
-    ADD("1", get_pixel_8, put_pixel_8);
-    ADD("L", get_pixel_8, put_pixel_8);
-    ADD("LA", get_pixel_32_2bands, put_pixel_32);
-    ADD("La", get_pixel_32_2bands, put_pixel_32);
-    ADD("I", get_pixel_32, put_pixel_32);
-    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);
+    int i = 0;
+    set_access_table_item(i++, IMAGING_MODE_1, get_pixel_8, put_pixel_8);
+    set_access_table_item(i++, IMAGING_MODE_L, get_pixel_8, put_pixel_8);
+    set_access_table_item(i++, IMAGING_MODE_LA, get_pixel_32_2bands, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_La, get_pixel_32_2bands, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_I, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_I_16, get_pixel_16L, put_pixel_16L);
+    set_access_table_item(i++, IMAGING_MODE_I_16L, get_pixel_16L, put_pixel_16L);
+    set_access_table_item(i++, IMAGING_MODE_I_16B, get_pixel_16B, put_pixel_16B);
 #ifdef WORDS_BIGENDIAN
-    ADD("I;16N", get_pixel_16B, put_pixel_16B);
+    set_access_table_item(i++, IMAGING_MODE_I_16N, get_pixel_16B, put_pixel_16B);
 #else
-    ADD("I;16N", get_pixel_16L, put_pixel_16L);
+    set_access_table_item(i++, IMAGING_MODE_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);
-    ADD("P", get_pixel_8, put_pixel_8);
-    ADD("PA", get_pixel_32_2bands, put_pixel_32);
-    ADD("RGB", get_pixel_32, put_pixel_32);
-    ADD("RGBA", get_pixel_32, put_pixel_32);
-    ADD("RGBa", get_pixel_32, put_pixel_32);
-    ADD("RGBX", get_pixel_32, put_pixel_32);
-    ADD("CMYK", get_pixel_32, put_pixel_32);
-    ADD("YCbCr", get_pixel_32, put_pixel_32);
-    ADD("LAB", get_pixel_32, put_pixel_32);
-    ADD("HSV", get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_I_32L, get_pixel_32L, put_pixel_32L);
+    set_access_table_item(i++, IMAGING_MODE_I_32B, get_pixel_32B, put_pixel_32B);
+    set_access_table_item(i++, IMAGING_MODE_F, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_P, get_pixel_8, put_pixel_8);
+    set_access_table_item(i++, IMAGING_MODE_PA, get_pixel_32_2bands, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_RGB, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_RGBA, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_RGBa, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_RGBX, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_CMYK, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_YCbCr, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_LAB, get_pixel_32, put_pixel_32);
+    set_access_table_item(i++, IMAGING_MODE_HSV, get_pixel_32, put_pixel_32);
+
+
+    if (i != ACCESS_TABLE_SIZE) {
+        fprintf(
+            stderr,
+            "AccessInit: incorrect number of items added to ACCESS_TABLE; expected %i but got %i\n",
+            ACCESS_TABLE_SIZE,
+            i);
+        exit(1);
+    }
 }
 
 ImagingAccess
-ImagingAccessNew(Imaging im) {
-    ImagingAccess access = &access_table[hash(im->mode)];
-    if (im->mode[0] != access->mode[0] || strcmp(im->mode, access->mode) != 0) {
-        return NULL;
+ImagingAccessNew(const Imaging im) {
+    int i;
+    for (i = 0; i < ACCESS_TABLE_SIZE; i++) {
+        if (im->mode == ACCESS_TABLE[i].mode) {
+            return &ACCESS_TABLE[i];
+        }
     }
-    return access;
+    return NULL;
 }
 
 void
diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 2bd09bda56a..85ba50e3f52 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -32,6 +32,8 @@ CREATE_MODE(Mode, MODE_I_16, {"I;16"})
 CREATE_MODE(Mode, MODE_I_16L, {"I;16L"})
 CREATE_MODE(Mode, MODE_I_16B, {"I;16B"})
 CREATE_MODE(Mode, MODE_I_16N, {"I;16N"})
+CREATE_MODE(Mode, MODE_I_32L, {"I;32L"})
+CREATE_MODE(Mode, MODE_I_32B, {"I;32B"})
 
 const Mode * const MODES[] = {
     IMAGING_MODE_1,
@@ -59,6 +61,8 @@ const Mode * const MODES[] = {
     IMAGING_MODE_I_16L,
     IMAGING_MODE_I_16B,
     IMAGING_MODE_I_16N,
+    IMAGING_MODE_I_32L,
+    IMAGING_MODE_I_32B,
 
     NULL
 };
@@ -102,6 +106,8 @@ ALIAS_MODE_AS_RAWMODE(I_16)
 ALIAS_MODE_AS_RAWMODE(I_16L)
 ALIAS_MODE_AS_RAWMODE(I_16B)
 ALIAS_MODE_AS_RAWMODE(I_16N)
+ALIAS_MODE_AS_RAWMODE(I_32L)
+ALIAS_MODE_AS_RAWMODE(I_32B)
 
 const RawMode * const RAWMODES[] = {
     IMAGING_RAWMODE_1,
@@ -129,6 +135,8 @@ const RawMode * const RAWMODES[] = {
     IMAGING_RAWMODE_I_16L,
     IMAGING_RAWMODE_I_16B,
     IMAGING_RAWMODE_I_16N,
+    IMAGING_RAWMODE_I_32L,
+    IMAGING_RAWMODE_I_32B,
 
     NULL
 };
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index a9910366710..bd184808d23 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -35,6 +35,8 @@ extern const Mode * const IMAGING_MODE_I_16;
 extern const Mode * const IMAGING_MODE_I_16L;
 extern const Mode * const IMAGING_MODE_I_16B;
 extern const Mode * const IMAGING_MODE_I_16N;
+extern const Mode * const IMAGING_MODE_I_32L;
+extern const Mode * const IMAGING_MODE_I_32B;
 
 const Mode * findMode(const char * const name);
 
@@ -67,11 +69,13 @@ extern const RawMode * const IMAGING_RAWMODE_BGR_16;
 extern const RawMode * const IMAGING_RAWMODE_BGR_24;
 extern const RawMode * const IMAGING_RAWMODE_BGR_32;
 
-// I;16 modes.
+// I;* modes.
 extern const RawMode * const IMAGING_RAWMODE_I_16;
 extern const RawMode * const IMAGING_RAWMODE_I_16L;
 extern const RawMode * const IMAGING_RAWMODE_I_16B;
 extern const RawMode * const IMAGING_RAWMODE_I_16N;
+extern const RawMode * const IMAGING_RAWMODE_I_32L;
+extern const RawMode * const IMAGING_RAWMODE_I_32B;
 
 // Rawmodes
 extern const RawMode * const IMAGING_RAWMODE_1_R;

From 82182ba5489e8406c963a88a2187c622d4ee90f2 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 13:09:47 -0500
Subject: [PATCH 1897/2374] use mode structs in AlphaComposite.c

---
 src/libImaging/AlphaComposite.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/AlphaComposite.c b/src/libImaging/AlphaComposite.c
index 6d728f9088b..8d6ee886210 100644
--- a/src/libImaging/AlphaComposite.c
+++ b/src/libImaging/AlphaComposite.c
@@ -25,12 +25,12 @@ ImagingAlphaComposite(Imaging imDst, Imaging imSrc) {
     int x, y;
 
     /* Check arguments */
-    if (!imDst || !imSrc || strcmp(imDst->mode, "RGBA") ||
+    if (!imDst || !imSrc || imDst->mode != IMAGING_MODE_RGBA ||
         imDst->type != IMAGING_TYPE_UINT8 || imDst->bands != 4) {
         return ImagingError_ModeError();
     }
 
-    if (strcmp(imDst->mode, imSrc->mode) || imDst->type != imSrc->type ||
+    if (imDst->mode != imSrc->mode || imDst->type != imSrc->type ||
         imDst->bands != imSrc->bands || imDst->xsize != imSrc->xsize ||
         imDst->ysize != imSrc->ysize) {
         return ImagingError_Mismatch();

From d0541a73b94f1b8b5ba8a9e42718288e6f02feb1 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 13:10:12 -0500
Subject: [PATCH 1898/2374] use mode structs in Bands.c

---
 src/libImaging/Bands.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/Bands.c b/src/libImaging/Bands.c
index e1b16b34ac0..501b4625fc5 100644
--- a/src/libImaging/Bands.c
+++ b/src/libImaging/Bands.c
@@ -41,7 +41,7 @@ ImagingGetBand(Imaging imIn, int band) {
         band = 3;
     }
 
-    imOut = ImagingNewDirty("L", imIn->xsize, imIn->ysize);
+    imOut = ImagingNewDirty(IMAGING_MODE_L, imIn->xsize, imIn->ysize);
     if (!imOut) {
         return NULL;
     }
@@ -82,7 +82,7 @@ ImagingSplit(Imaging imIn, Imaging bands[4]) {
     }
 
     for (i = 0; i < imIn->bands; i++) {
-        bands[i] = ImagingNewDirty("L", imIn->xsize, imIn->ysize);
+        bands[i] = ImagingNewDirty(IMAGING_MODE_L, imIn->xsize, imIn->ysize);
         if (!bands[i]) {
             for (j = 0; j < i; ++j) {
                 ImagingDelete(bands[j]);
@@ -240,7 +240,7 @@ ImagingFillBand(Imaging imOut, int band, int color) {
 }
 
 Imaging
-ImagingMerge(const char *mode, Imaging bands[4]) {
+ImagingMerge(const Mode *mode, Imaging bands[4]) {
     int i, x, y;
     int bandsCount = 0;
     Imaging imOut;

From 38c75b9449c1bd2fbf5911ac683798f9f3a45fa5 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 13:16:01 -0500
Subject: [PATCH 1899/2374] use mode structs in Blend.c

---
 src/libImaging/Blend.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/Blend.c b/src/libImaging/Blend.c
index a53ae0fad53..df94920f62e 100644
--- a/src/libImaging/Blend.c
+++ b/src/libImaging/Blend.c
@@ -24,8 +24,8 @@ ImagingBlend(Imaging imIn1, Imaging imIn2, float alpha) {
 
     /* Check arguments */
     if (!imIn1 || !imIn2 || imIn1->type != IMAGING_TYPE_UINT8 || imIn1->palette ||
-        strcmp(imIn1->mode, "1") == 0 || imIn2->palette ||
-        strcmp(imIn2->mode, "1") == 0) {
+        imIn1->mode == IMAGING_MODE_1 || imIn2->palette ||
+        imIn2->mode == IMAGING_MODE_1) {
         return ImagingError_ModeError();
     }
 

From 6f6e1f99fc6fb94743e0f9281565b330fbbfaad0 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 14:00:44 -0500
Subject: [PATCH 1900/2374] use mode structs in BoxBlur.c

---
 src/libImaging/BoxBlur.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/libImaging/BoxBlur.c b/src/libImaging/BoxBlur.c
index ed91541fed4..4fea4fe44b8 100644
--- a/src/libImaging/BoxBlur.c
+++ b/src/libImaging/BoxBlur.c
@@ -248,7 +248,7 @@ ImagingBoxBlur(Imaging imOut, Imaging imIn, float xradius, float yradius, int n)
         return ImagingError_ValueError("radius must be >= 0");
     }
 
-    if (strcmp(imIn->mode, imOut->mode) || imIn->type != imOut->type ||
+    if (imIn->mode != imOut->mode || imIn->type != imOut->type ||
         imIn->bands != imOut->bands || imIn->xsize != imOut->xsize ||
         imIn->ysize != imOut->ysize) {
         return ImagingError_Mismatch();
@@ -258,10 +258,10 @@ ImagingBoxBlur(Imaging imOut, Imaging imIn, float xradius, float yradius, int n)
         return ImagingError_ModeError();
     }
 
-    if (!(strcmp(imIn->mode, "RGB") == 0 || strcmp(imIn->mode, "RGBA") == 0 ||
-          strcmp(imIn->mode, "RGBa") == 0 || strcmp(imIn->mode, "RGBX") == 0 ||
-          strcmp(imIn->mode, "CMYK") == 0 || strcmp(imIn->mode, "L") == 0 ||
-          strcmp(imIn->mode, "LA") == 0 || strcmp(imIn->mode, "La") == 0)) {
+    if (imIn->mode != IMAGING_MODE_RGB && imIn->mode != IMAGING_MODE_RGBA &&
+        imIn->mode != IMAGING_MODE_RGBa && imIn->mode != IMAGING_MODE_RGBX &&
+        imIn->mode != IMAGING_MODE_CMYK && imIn->mode != IMAGING_MODE_L &&
+        imIn->mode != IMAGING_MODE_LA && imIn->mode != IMAGING_MODE_La) {
         return ImagingError_ModeError();
     }
 

From ecf1fce82baf2a4ca2deb37b58419e06a927e1eb Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 14:05:13 -0500
Subject: [PATCH 1901/2374] use mode structs in Chops.c

---
 src/libImaging/Chops.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/libImaging/Chops.c b/src/libImaging/Chops.c
index f326d402f2c..66d0b4f9774 100644
--- a/src/libImaging/Chops.c
+++ b/src/libImaging/Chops.c
@@ -60,11 +60,11 @@
     return imOut;
 
 static Imaging
-create(Imaging im1, Imaging im2, char *mode) {
+create(Imaging im1, Imaging im2, const Mode *mode) {
     int xsize, ysize;
 
     if (!im1 || !im2 || im1->type != IMAGING_TYPE_UINT8 ||
-        (mode != NULL && (strcmp(im1->mode, "1") || strcmp(im2->mode, "1")))) {
+        (mode != NULL && (im1->mode != mode || im2->mode != mode))) {
         return (Imaging)ImagingError_ModeError();
     }
     if (im1->type != im2->type || im1->bands != im2->bands) {
@@ -114,17 +114,17 @@ ImagingChopSubtract(Imaging imIn1, Imaging imIn2, float scale, int offset) {
 
 Imaging
 ImagingChopAnd(Imaging imIn1, Imaging imIn2) {
-    CHOP2((in1[x] && in2[x]) ? 255 : 0, "1");
+    CHOP2((in1[x] && in2[x]) ? 255 : 0, IMAGING_MODE_1);
 }
 
 Imaging
 ImagingChopOr(Imaging imIn1, Imaging imIn2) {
-    CHOP2((in1[x] || in2[x]) ? 255 : 0, "1");
+    CHOP2((in1[x] || in2[x]) ? 255 : 0, IMAGING_MODE_1);
 }
 
 Imaging
 ImagingChopXor(Imaging imIn1, Imaging imIn2) {
-    CHOP2(((in1[x] != 0) ^ (in2[x] != 0)) ? 255 : 0, "1");
+    CHOP2(((in1[x] != 0) ^ (in2[x] != 0)) ? 255 : 0, IMAGING_MODE_1);
 }
 
 Imaging

From 9bf3495898169879e75a8783310d4798741d3729 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:12:51 +0200
Subject: [PATCH 1902/2374] use mode structs in Convert.c

---
 src/_imaging.c           |   1 +
 src/libImaging/Access.c  |   3 +
 src/libImaging/Convert.c | 406 +++++++++++++++++++++------------------
 src/libImaging/Imaging.h |  15 +-
 4 files changed, 235 insertions(+), 190 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index d0648540aeb..271a16dbb65 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4322,6 +4322,7 @@ setup_module(PyObject *m) {
     }
 
     ImagingAccessInit();
+    ImagingConvertInit();
 
 #ifdef HAVE_LIBJPEG
     {
diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 850399b1401..6c41fc0915c 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -187,3 +187,6 @@ ImagingAccessNew(const Imaging im) {
 
 void
 _ImagingAccessDelete(Imaging im, ImagingAccess access) {}
+
+void
+ImagingAccessFree() {}
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 9a2c9ff1667..2bc054616aa 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -877,147 +877,12 @@ I16_RGB(UINT8 *out, const UINT8 *in, int xsize) {
     }
 }
 
-static struct {
-    const char *from;
-    const char *to;
-    ImagingShuffler convert;
-} converters[] = {
-
-    {"1", "L", bit2l},
-    {"1", "I", bit2i},
-    {"1", "F", bit2f},
-    {"1", "RGB", bit2rgb},
-    {"1", "RGBA", bit2rgb},
-    {"1", "RGBX", bit2rgb},
-    {"1", "CMYK", bit2cmyk},
-    {"1", "YCbCr", bit2ycbcr},
-    {"1", "HSV", bit2hsv},
-
-    {"L", "1", l2bit},
-    {"L", "LA", l2la},
-    {"L", "I", l2i},
-    {"L", "F", l2f},
-    {"L", "RGB", l2rgb},
-    {"L", "RGBA", l2rgb},
-    {"L", "RGBX", l2rgb},
-    {"L", "CMYK", l2cmyk},
-    {"L", "YCbCr", l2ycbcr},
-    {"L", "HSV", l2hsv},
-
-    {"LA", "L", la2l},
-    {"LA", "La", lA2la},
-    {"LA", "RGB", la2rgb},
-    {"LA", "RGBA", la2rgb},
-    {"LA", "RGBX", la2rgb},
-    {"LA", "CMYK", la2cmyk},
-    {"LA", "YCbCr", la2ycbcr},
-    {"LA", "HSV", la2hsv},
-
-    {"La", "LA", la2lA},
-
-    {"I", "L", i2l},
-    {"I", "F", i2f},
-    {"I", "RGB", i2rgb},
-    {"I", "RGBA", i2rgb},
-    {"I", "RGBX", i2rgb},
-    {"I", "HSV", i2hsv},
-
-    {"F", "L", f2l},
-    {"F", "I", f2i},
-
-    {"RGB", "1", rgb2bit},
-    {"RGB", "L", rgb2l},
-    {"RGB", "LA", rgb2la},
-    {"RGB", "La", rgb2la},
-    {"RGB", "I", rgb2i},
-    {"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", "RGBA", rgb2rgba},
-    {"RGB", "RGBa", rgb2rgba},
-    {"RGB", "RGBX", rgb2rgba},
-    {"RGB", "CMYK", rgb2cmyk},
-    {"RGB", "YCbCr", ImagingConvertRGB2YCbCr},
-    {"RGB", "HSV", rgb2hsv},
-
-    {"RGBA", "1", rgb2bit},
-    {"RGBA", "L", rgb2l},
-    {"RGBA", "LA", rgba2la},
-    {"RGBA", "I", rgb2i},
-    {"RGBA", "F", rgb2f},
-    {"RGBA", "RGB", rgba2rgb},
-    {"RGBA", "RGBa", rgbA2rgba},
-    {"RGBA", "RGBX", rgb2rgba},
-    {"RGBA", "CMYK", rgb2cmyk},
-    {"RGBA", "YCbCr", ImagingConvertRGB2YCbCr},
-    {"RGBA", "HSV", rgb2hsv},
-
-    {"RGBa", "RGBA", rgba2rgbA},
-    {"RGBa", "RGB", rgba2rgb_},
-
-    {"RGBX", "1", rgb2bit},
-    {"RGBX", "L", rgb2l},
-    {"RGBX", "LA", rgb2la},
-    {"RGBX", "I", rgb2i},
-    {"RGBX", "F", rgb2f},
-    {"RGBX", "RGB", rgba2rgb},
-    {"RGBX", "CMYK", rgb2cmyk},
-    {"RGBX", "YCbCr", ImagingConvertRGB2YCbCr},
-    {"RGBX", "HSV", rgb2hsv},
-
-    {"CMYK", "RGB", cmyk2rgb},
-    {"CMYK", "RGBA", cmyk2rgb},
-    {"CMYK", "RGBX", cmyk2rgb},
-    {"CMYK", "HSV", cmyk2hsv},
-
-    {"YCbCr", "L", ycbcr2l},
-    {"YCbCr", "LA", ycbcr2la},
-    {"YCbCr", "RGB", ImagingConvertYCbCr2RGB},
-
-    {"HSV", "RGB", hsv2rgb},
-
-    {"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},
-
-    {"I", "I;16L", I_I16L},
-    {"I;16L", "I", I16L_I},
-    {"I", "I;16B", I_I16B},
-    {"I;16B", "I", I16B_I},
-
-    {"L", "I;16L", L_I16L},
-    {"I;16L", "L", I16L_L},
-    {"L", "I;16B", L_I16B},
-    {"I;16B", "L", I16B_L},
-#ifdef WORDS_BIGENDIAN
-    {"L", "I;16N", L_I16B},
-    {"I;16N", "L", I16B_L},
-#else
-    {"L", "I;16N", L_I16L},
-    {"I;16N", "L", I16L_L},
-#endif
-
-    {"I;16", "F", I16L_F},
-    {"I;16L", "F", I16L_F},
-    {"I;16B", "F", I16B_F},
-
-    {NULL}
-};
-
-/* FIXME: translate indexed versions to pointer versions below this line */
-
 /* ------------------- */
 /* Palette conversions */
 /* ------------------- */
 
+/* FIXME: translate indexed versions to pointer versions below this line */
+
 static void
 p2bit(UINT8 *out, const UINT8 *in, int xsize, ImagingPalette palette) {
     int x;
@@ -1065,13 +930,13 @@ pa2p(UINT8 *out, const UINT8 *in, int xsize, ImagingPalette palette) {
 static void
 p2pa(UINT8 *out, const UINT8 *in, int xsize, ImagingPalette palette) {
     int x;
-    int rgb = strcmp(palette->mode, "RGB");
+    const int rgb = palette->mode == IMAGING_MODE_RGB;
     for (x = 0; x < xsize; x++, in++) {
         const UINT8 *rgba = &palette->palette[in[0] * 4];
         *out++ = in[0];
         *out++ = in[0];
         *out++ = in[0];
-        *out++ = rgb == 0 ? 255 : rgba[3];
+        *out++ = rgb ? 255 : rgba[3];
     }
 }
 
@@ -1225,7 +1090,7 @@ pa2ycbcr(UINT8 *out, const UINT8 *in, int xsize, ImagingPalette palette) {
 }
 
 static Imaging
-frompalette(Imaging imOut, Imaging imIn, const char *mode) {
+frompalette(Imaging imOut, Imaging imIn, const Mode *mode) {
     ImagingSectionCookie cookie;
     int alpha;
     int y;
@@ -1237,31 +1102,31 @@ frompalette(Imaging imOut, Imaging imIn, const char *mode) {
         return (Imaging)ImagingError_ValueError("no palette");
     }
 
-    alpha = !strcmp(imIn->mode, "PA");
+    alpha = imIn->mode == IMAGING_MODE_PA;
 
-    if (strcmp(mode, "1") == 0) {
+    if (mode == IMAGING_MODE_1) {
         convert = alpha ? pa2bit : p2bit;
-    } else if (strcmp(mode, "L") == 0) {
+    } else if (mode == IMAGING_MODE_L) {
         convert = alpha ? pa2l : p2l;
-    } else if (strcmp(mode, "LA") == 0) {
+    } else if (mode == IMAGING_MODE_LA) {
         convert = alpha ? pa2la : p2la;
-    } else if (strcmp(mode, "P") == 0) {
+    } else if (mode == IMAGING_MODE_P) {
         convert = pa2p;
-    } else if (strcmp(mode, "PA") == 0) {
+    } else if (mode == IMAGING_MODE_PA) {
         convert = p2pa;
-    } else if (strcmp(mode, "I") == 0) {
+    } else if (mode == IMAGING_MODE_I) {
         convert = alpha ? pa2i : p2i;
-    } else if (strcmp(mode, "F") == 0) {
+    } else if (mode == IMAGING_MODE_F) {
         convert = alpha ? pa2f : p2f;
-    } else if (strcmp(mode, "RGB") == 0) {
+    } else if (mode == IMAGING_MODE_RGB) {
         convert = alpha ? pa2rgb : p2rgb;
-    } else if (strcmp(mode, "RGBA") == 0 || strcmp(mode, "RGBX") == 0) {
+    } else if (mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_RGBX) {
         convert = alpha ? pa2rgba : p2rgba;
-    } else if (strcmp(mode, "CMYK") == 0) {
+    } else if (mode == IMAGING_MODE_CMYK) {
         convert = alpha ? pa2cmyk : p2cmyk;
-    } else if (strcmp(mode, "YCbCr") == 0) {
+    } else if (mode == IMAGING_MODE_YCbCr) {
         convert = alpha ? pa2ycbcr : p2ycbcr;
-    } else if (strcmp(mode, "HSV") == 0) {
+    } else if (mode == IMAGING_MODE_HSV) {
         convert = alpha ? pa2hsv : p2hsv;
     } else {
         return (Imaging)ImagingError_ValueError("conversion not supported");
@@ -1271,7 +1136,7 @@ frompalette(Imaging imOut, Imaging imIn, const char *mode) {
     if (!imOut) {
         return NULL;
     }
-    if (strcmp(mode, "P") == 0 || strcmp(mode, "PA") == 0) {
+    if (mode == IMAGING_MODE_P || mode == IMAGING_MODE_PA) {
         ImagingPaletteDelete(imOut->palette);
         imOut->palette = ImagingPaletteDuplicate(imIn->palette);
     }
@@ -1295,24 +1160,26 @@ 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 Mode *mode, ImagingPalette inpalette, int dither
 ) {
     ImagingSectionCookie cookie;
     int alpha;
     int x, y;
     ImagingPalette palette = inpalette;
 
-    /* Map L or RGB/RGBX/RGBA to palette image */
-    if (strcmp(imIn->mode, "L") != 0 && strncmp(imIn->mode, "RGB", 3) != 0) {
+    /* Map L or RGB/RGBX/RGBA/RGBa to palette image */
+    if (imIn->mode != IMAGING_MODE_L && imIn->mode != IMAGING_MODE_RGB &&
+        imIn->mode != IMAGING_MODE_RGBX && imIn->mode != IMAGING_MODE_RGBA &&
+        imIn->mode != IMAGING_MODE_RGBa) {
         return (Imaging)ImagingError_ValueError("conversion not supported");
     }
 
-    alpha = !strcmp(mode, "PA");
+    alpha = mode == IMAGING_MODE_PA;
 
     if (palette == NULL) {
         /* FIXME: make user configurable */
         if (imIn->bands == 1) {
-            palette = ImagingPaletteNew("RGB");
+            palette = ImagingPaletteNew(IMAGING_MODE_RGB);
 
             palette->size = 256;
             int i;
@@ -1499,11 +1366,11 @@ tobilevel(Imaging imOut, Imaging imIn) {
     int *errors;
 
     /* Map L or RGB to dithered 1 image */
-    if (strcmp(imIn->mode, "L") != 0 && strcmp(imIn->mode, "RGB") != 0) {
+    if (imIn->mode != IMAGING_MODE_L && imIn->mode != IMAGING_MODE_RGB) {
         return (Imaging)ImagingError_ValueError("conversion not supported");
     }
 
-    imOut = ImagingNew2Dirty("1", imOut, imIn);
+    imOut = ImagingNew2Dirty(IMAGING_MODE_1, imOut, imIn);
     if (!imOut) {
         return NULL;
     }
@@ -1585,9 +1452,19 @@ tobilevel(Imaging imOut, Imaging imIn) {
 #pragma optimize("", on)
 #endif
 
+/* ------------------- */
+/* Conversion handlers */
+/* ------------------- */
+
+static struct Converter {
+    const Mode *from;
+    const Mode *to;
+    ImagingShuffler convert;
+} *converters = NULL;
+
 static Imaging
 convert(
-    Imaging imOut, Imaging imIn, const char *mode, ImagingPalette palette, int dither
+    Imaging imOut, Imaging imIn, const Mode *mode, ImagingPalette palette, int dither
 ) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
@@ -1605,22 +1482,22 @@ convert(
         mode = imIn->palette->mode;
     } else {
         /* Same mode? */
-        if (!strcmp(imIn->mode, mode)) {
+        if (imIn->mode == mode) {
             return ImagingCopy2(imOut, imIn);
         }
     }
 
     /* test for special conversions */
 
-    if (strcmp(imIn->mode, "P") == 0 || strcmp(imIn->mode, "PA") == 0) {
+    if (imIn->mode == IMAGING_MODE_P || imIn->mode == IMAGING_MODE_PA) {
         return frompalette(imOut, imIn, mode);
     }
 
-    if (strcmp(mode, "P") == 0 || strcmp(mode, "PA") == 0) {
+    if (mode == IMAGING_MODE_P || mode == IMAGING_MODE_PA) {
         return topalette(imOut, imIn, mode, palette, dither);
     }
 
-    if (dither && strcmp(mode, "1") == 0) {
+    if (dither && mode == IMAGING_MODE_1) {
         return tobilevel(imOut, imIn);
     }
 
@@ -1629,8 +1506,7 @@ convert(
     convert = NULL;
 
     for (y = 0; converters[y].from; y++) {
-        if (!strcmp(imIn->mode, converters[y].from) &&
-            !strcmp(mode, converters[y].to)) {
+        if (imIn->mode == converters[y].from && mode == converters[y].to) {
             convert = converters[y].convert;
             break;
         }
@@ -1642,7 +1518,7 @@ 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->name, mode->name
         );
         return (Imaging)ImagingError_ValueError(buf);
 #endif
@@ -1663,7 +1539,7 @@ convert(
 }
 
 Imaging
-ImagingConvert(Imaging imIn, const char *mode, ImagingPalette palette, int dither) {
+ImagingConvert(Imaging imIn, const Mode *mode, ImagingPalette palette, int dither) {
     return convert(NULL, imIn, mode, palette, dither);
 }
 
@@ -1673,7 +1549,7 @@ ImagingConvert2(Imaging imOut, Imaging imIn) {
 }
 
 Imaging
-ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
+ImagingConvertTransparent(Imaging imIn, const Mode *mode, int r, int g, int b) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
     Imaging imOut = NULL;
@@ -1687,27 +1563,30 @@ 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 (imIn->mode == IMAGING_MODE_RGB && (mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_RGBa)) {
         convert = rgb2rgba;
-        if (strcmp(mode, "RGBa") == 0) {
+        if (mode == IMAGING_MODE_RGBa) {
             premultiplied = 1;
         }
-    } else if (strcmp(imIn->mode, "RGB") == 0 &&
-               (strcmp(mode, "LA") == 0 || strcmp(mode, "La") == 0)) {
+    } else if (imIn->mode == IMAGING_MODE_RGB && (mode == IMAGING_MODE_LA || mode == IMAGING_MODE_La)) {
         convert = rgb2la;
         source_transparency = 1;
-        if (strcmp(mode, "La") == 0) {
+        if (mode == IMAGING_MODE_La) {
             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)) {
-        if (strcmp(imIn->mode, "1") == 0) {
+    } else if ((imIn->mode == IMAGING_MODE_1 ||
+                imIn->mode == IMAGING_MODE_I ||
+                imIn->mode == IMAGING_MODE_I_16 ||
+                imIn->mode == IMAGING_MODE_L
+               ) && (
+                mode == IMAGING_MODE_RGBA ||
+                mode == IMAGING_MODE_LA
+               )) {
+        if (imIn->mode == IMAGING_MODE_1) {
             convert = bit2rgb;
-        } else if (strcmp(imIn->mode, "I") == 0) {
+        } else if (imIn->mode == IMAGING_MODE_I) {
             convert = i2rgb;
-        } else if (strcmp(imIn->mode, "I;16") == 0) {
+        } else if (imIn->mode == IMAGING_MODE_I_16) {
             convert = I16_RGB;
         } else {
             convert = l2rgb;
@@ -1719,8 +1598,8 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
             buf,
             100,
             "conversion from %.10s to %.10s not supported in convert_transparent",
-            imIn->mode,
-            mode
+            imIn->mode->name,
+            mode->name
         );
         return (Imaging)ImagingError_ValueError(buf);
     }
@@ -1743,15 +1622,15 @@ ImagingConvertTransparent(Imaging imIn, const char *mode, int r, int g, int b) {
 }
 
 Imaging
-ImagingConvertInPlace(Imaging imIn, const char *mode) {
+ImagingConvertInPlace(Imaging imIn, const Mode *mode) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
     int y;
 
     /* limited support for inplace conversion */
-    if (strcmp(imIn->mode, "L") == 0 && strcmp(mode, "1") == 0) {
+    if (imIn->mode == IMAGING_MODE_L && mode == IMAGING_MODE_1) {
         convert = l2bit;
-    } else if (strcmp(imIn->mode, "1") == 0 && strcmp(mode, "L") == 0) {
+    } else if (imIn->mode == IMAGING_MODE_1 && mode == IMAGING_MODE_L) {
         convert = bit2l;
     } else {
         return ImagingError_ModeError();
@@ -1765,3 +1644,154 @@ ImagingConvertInPlace(Imaging imIn, const char *mode) {
 
     return imIn;
 }
+
+/* ------------------ */
+/* Converter mappings */
+/* ------------------ */
+
+void
+ImagingConvertInit() {
+    const struct Converter temp[] = {
+        {IMAGING_MODE_1, IMAGING_MODE_L, bit2l},
+        {IMAGING_MODE_1, IMAGING_MODE_I, bit2i},
+        {IMAGING_MODE_1, IMAGING_MODE_F, bit2f},
+        {IMAGING_MODE_1, IMAGING_MODE_RGB, bit2rgb},
+        {IMAGING_MODE_1, IMAGING_MODE_RGBA, bit2rgb},
+        {IMAGING_MODE_1, IMAGING_MODE_RGBX, bit2rgb},
+        {IMAGING_MODE_1, IMAGING_MODE_CMYK, bit2cmyk},
+        {IMAGING_MODE_1, IMAGING_MODE_YCbCr, bit2ycbcr},
+        {IMAGING_MODE_1, IMAGING_MODE_HSV, bit2hsv},
+
+        {IMAGING_MODE_L, IMAGING_MODE_1, l2bit},
+        {IMAGING_MODE_L, IMAGING_MODE_LA, l2la},
+        {IMAGING_MODE_L, IMAGING_MODE_I, l2i},
+        {IMAGING_MODE_L, IMAGING_MODE_F, l2f},
+        {IMAGING_MODE_L, IMAGING_MODE_RGB, l2rgb},
+        {IMAGING_MODE_L, IMAGING_MODE_RGBA, l2rgb},
+        {IMAGING_MODE_L, IMAGING_MODE_RGBX, l2rgb},
+        {IMAGING_MODE_L, IMAGING_MODE_CMYK, l2cmyk},
+        {IMAGING_MODE_L, IMAGING_MODE_YCbCr, l2ycbcr},
+        {IMAGING_MODE_L, IMAGING_MODE_HSV, l2hsv},
+
+        {IMAGING_MODE_LA, IMAGING_MODE_L, la2l},
+        {IMAGING_MODE_LA, IMAGING_MODE_La, lA2la},
+        {IMAGING_MODE_LA, IMAGING_MODE_RGB, la2rgb},
+        {IMAGING_MODE_LA, IMAGING_MODE_RGBA, la2rgb},
+        {IMAGING_MODE_LA, IMAGING_MODE_RGBX, la2rgb},
+        {IMAGING_MODE_LA, IMAGING_MODE_CMYK, la2cmyk},
+        {IMAGING_MODE_LA, IMAGING_MODE_YCbCr, la2ycbcr},
+        {IMAGING_MODE_LA, IMAGING_MODE_HSV, la2hsv},
+
+        {IMAGING_MODE_La, IMAGING_MODE_LA, la2lA},
+
+        {IMAGING_MODE_I, IMAGING_MODE_L, i2l},
+        {IMAGING_MODE_I, IMAGING_MODE_F, i2f},
+        {IMAGING_MODE_I, IMAGING_MODE_RGB, i2rgb},
+        {IMAGING_MODE_I, IMAGING_MODE_RGBA, i2rgb},
+        {IMAGING_MODE_I, IMAGING_MODE_RGBX, i2rgb},
+        {IMAGING_MODE_I, IMAGING_MODE_HSV, i2hsv},
+
+        {IMAGING_MODE_F, IMAGING_MODE_L, f2l},
+        {IMAGING_MODE_F, IMAGING_MODE_I, f2i},
+
+        {IMAGING_MODE_RGB, IMAGING_MODE_1, rgb2bit},
+        {IMAGING_MODE_RGB, IMAGING_MODE_L, rgb2l},
+        {IMAGING_MODE_RGB, IMAGING_MODE_LA, rgb2la},
+        {IMAGING_MODE_RGB, IMAGING_MODE_La, rgb2la},
+        {IMAGING_MODE_RGB, IMAGING_MODE_I, rgb2i},
+        {IMAGING_MODE_RGB, IMAGING_MODE_I_16, rgb2i16l},
+        {IMAGING_MODE_RGB, IMAGING_MODE_I_16L, rgb2i16l},
+        {IMAGING_MODE_RGB, IMAGING_MODE_I_16B, rgb2i16b},
+#ifdef WORDS_BIGENDIAN
+        {IMAGING_MODE_RGB, IMAGING_MODE_I_16N, rgb2i16b},
+#else
+        {IMAGING_MODE_RGB, IMAGING_MODE_I_16N, rgb2i16l},
+#endif
+        {IMAGING_MODE_RGB, IMAGING_MODE_F, rgb2f},
+        {IMAGING_MODE_RGB, IMAGING_MODE_BGR_15, rgb2bgr15},
+        {IMAGING_MODE_RGB, IMAGING_MODE_BGR_16, rgb2bgr16},
+        {IMAGING_MODE_RGB, IMAGING_MODE_BGR_24, rgb2bgr24},
+        {IMAGING_MODE_RGB, IMAGING_MODE_RGBA, rgb2rgba},
+        {IMAGING_MODE_RGB, IMAGING_MODE_RGBa, rgb2rgba},
+        {IMAGING_MODE_RGB, IMAGING_MODE_RGBX, rgb2rgba},
+        {IMAGING_MODE_RGB, IMAGING_MODE_CMYK, rgb2cmyk},
+        {IMAGING_MODE_RGB, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
+        {IMAGING_MODE_RGB, IMAGING_MODE_HSV, rgb2hsv},
+
+        {IMAGING_MODE_RGBA, IMAGING_MODE_1, rgb2bit},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_L, rgb2l},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_LA, rgba2la},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_I, rgb2i},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_F, rgb2f},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_RGB, rgba2rgb},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_RGBa, rgbA2rgba},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_RGBX, rgb2rgba},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_CMYK, rgb2cmyk},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
+        {IMAGING_MODE_RGBA, IMAGING_MODE_HSV, rgb2hsv},
+
+        {IMAGING_MODE_RGBa, IMAGING_MODE_RGBA, rgba2rgbA},
+        {IMAGING_MODE_RGBa, IMAGING_MODE_RGB, rgba2rgb_},
+
+        {IMAGING_MODE_RGBX, IMAGING_MODE_1, rgb2bit},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_L, rgb2l},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_LA, rgb2la},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_I, rgb2i},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_F, rgb2f},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_RGB, rgba2rgb},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_CMYK, rgb2cmyk},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
+        {IMAGING_MODE_RGBX, IMAGING_MODE_HSV, rgb2hsv},
+
+        {IMAGING_MODE_CMYK, IMAGING_MODE_RGB, cmyk2rgb},
+        {IMAGING_MODE_CMYK, IMAGING_MODE_RGBA, cmyk2rgb},
+        {IMAGING_MODE_CMYK, IMAGING_MODE_RGBX, cmyk2rgb},
+        {IMAGING_MODE_CMYK, IMAGING_MODE_HSV, cmyk2hsv},
+
+        {IMAGING_MODE_YCbCr, IMAGING_MODE_L, ycbcr2l},
+        {IMAGING_MODE_YCbCr, IMAGING_MODE_LA, ycbcr2la},
+        {IMAGING_MODE_YCbCr, IMAGING_MODE_RGB, ImagingConvertYCbCr2RGB},
+
+        {IMAGING_MODE_HSV, IMAGING_MODE_RGB, hsv2rgb},
+
+        {IMAGING_MODE_I, IMAGING_MODE_I_16, I_I16L},
+        {IMAGING_MODE_I_16, IMAGING_MODE_I, I16L_I},
+        {IMAGING_MODE_I_16, IMAGING_MODE_RGB, I16_RGB},
+        {IMAGING_MODE_L, IMAGING_MODE_I_16, L_I16L},
+        {IMAGING_MODE_I_16, IMAGING_MODE_L, I16L_L},
+
+        {IMAGING_MODE_I, IMAGING_MODE_I_16L, I_I16L},
+        {IMAGING_MODE_I_16L, IMAGING_MODE_I, I16L_I},
+        {IMAGING_MODE_I, IMAGING_MODE_I_16B, I_I16B},
+        {IMAGING_MODE_I_16B, IMAGING_MODE_I, I16B_I},
+
+        {IMAGING_MODE_L, IMAGING_MODE_I_16L, L_I16L},
+        {IMAGING_MODE_I_16L, IMAGING_MODE_L, I16L_L},
+        {IMAGING_MODE_L, IMAGING_MODE_I_16B, L_I16B},
+        {IMAGING_MODE_I_16B, IMAGING_MODE_L, I16B_L},
+#ifdef WORDS_BIGENDIAN
+        {IMAGING_MODE_L, IMAGING_MODE_I_16N, L_I16B},
+        {IMAGING_MODE_I_16N, IMAGING_MODE_L, I16B_L},
+#else
+        {IMAGING_MODE_L, IMAGING_MODE_I_16N, L_I16L},
+        {IMAGING_MODE_I_16N, IMAGING_MODE_L, I16L_L},
+#endif
+
+        {IMAGING_MODE_I_16, IMAGING_MODE_F, I16L_F},
+        {IMAGING_MODE_I_16L, IMAGING_MODE_F, I16L_F},
+        {IMAGING_MODE_I_16B, IMAGING_MODE_F, I16B_F},
+
+        {NULL}
+    };
+    converters = malloc(sizeof(temp));
+    if (converters == NULL) {
+        fprintf(stderr, "ConvertInit: failed to allocate memory for converter table\n");
+        exit(1);
+    }
+    memcpy(converters, temp, sizeof(temp));
+}
+
+void
+ImagingConvertFree() {
+    free(converters);
+}
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 49f17f0daa0..c7e06931353 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -181,6 +181,19 @@ typedef struct ImagingMemoryArena {
 #endif
 } *ImagingMemoryArena;
 
+/* Memory Management */
+/* ----------------- */
+
+extern void
+ImagingAccessInit(void);
+extern void
+ImagingAccessFree(void);
+
+extern void
+ImagingConvertInit(void);
+extern void
+ImagingConvertFree(void);
+
 /* Objects */
 /* ------- */
 
@@ -224,8 +237,6 @@ ImagingCopyPalette(Imaging destination, Imaging source);
 extern void
 ImagingHistogramDelete(ImagingHistogram histogram);
 
-extern void
-ImagingAccessInit(void);
 extern ImagingAccess
 ImagingAccessNew(Imaging im);
 extern void

From bcfe5f21729a895388ac1385120dd7a60a6876c4 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:37:03 +0200
Subject: [PATCH 1903/2374] use mode structs in Draw.c

---
 src/libImaging/Draw.c | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index 27cac687e5d..b946304735f 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -68,7 +68,7 @@ typedef void (*hline_handler)(Imaging, int, int, int, int, Imaging);
 static inline void
 point8(Imaging im, int x, int y, int ink) {
     if (x >= 0 && x < im->xsize && y >= 0 && y < im->ysize) {
-        if (strncmp(im->mode, "I;16", 4) == 0) {
+        if (strncmp(im->mode->name, "I;16", 4) == 0) {
 #ifdef WORDS_BIGENDIAN
             im->image8[y][x * 2] = (UINT8)(ink >> 8);
             im->image8[y][x * 2 + 1] = (UINT8)ink;
@@ -117,13 +117,13 @@ hline8(Imaging im, int x0, int y0, int x1, int ink, Imaging mask) {
         }
         if (x0 <= x1) {
             int bigendian = -1;
-            if (strncmp(im->mode, "I;16", 4) == 0) {
+            if (isModeI16(im->mode)) {
                 bigendian =
                     (
 #ifdef WORDS_BIGENDIAN
-                        strcmp(im->mode, "I;16") == 0 || strcmp(im->mode, "I;16L") == 0
+                        im->mode == IMAGING_MODE_I_16 || im->mode == IMAGING_MODE_I_16L
 #else
-                        strcmp(im->mode, "I;16B") == 0
+                        im->mode == IMAGING_MODE_I_16B
 #endif
                     )
                         ? 1
@@ -672,17 +672,17 @@ DRAW draw32rgba = {point32rgba, hline32rgba, line32rgba};
 /* Interface                                                            */
 /* -------------------------------------------------------------------- */
 
-#define DRAWINIT()                               \
-    if (im->image8) {                            \
-        draw = &draw8;                           \
-        if (strncmp(im->mode, "I;16", 4) == 0) { \
-            ink = INK16(ink_);                   \
-        } else {                                 \
-            ink = INK8(ink_);                    \
-        }                                        \
-    } else {                                     \
-        draw = (op) ? &draw32rgba : &draw32;     \
-        memcpy(&ink, ink_, sizeof(ink));         \
+#define DRAWINIT()                                     \
+    if (im->image8) {                                  \
+        draw = &draw8;                                 \
+        if (strncmp(im->mode->name, "I;16", 4) == 0) { \
+            ink = INK16(ink_);                         \
+        } else {                                       \
+            ink = INK8(ink_);                          \
+        }                                              \
+    } else {                                           \
+        draw = (op) ? &draw32rgba : &draw32;           \
+        memcpy(&ink, ink_, sizeof(ink));               \
     }
 
 int

From b5c4b821bca4373cfb60da07d35bfd4f7f4ff4a5 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:22:21 -0500
Subject: [PATCH 1904/2374] use mode structs in Effects.c

---
 src/libImaging/Effects.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/Effects.c b/src/libImaging/Effects.c
index 93e7af0bce9..c05c5764e44 100644
--- a/src/libImaging/Effects.c
+++ b/src/libImaging/Effects.c
@@ -36,7 +36,7 @@ ImagingEffectMandelbrot(int xsize, int ysize, double extent[4], int quality) {
         return (Imaging)ImagingError_ValueError(NULL);
     }
 
-    im = ImagingNewDirty("L", xsize, ysize);
+    im = ImagingNewDirty(IMAGING_MODE_L, xsize, ysize);
     if (!im) {
         return NULL;
     }
@@ -80,7 +80,7 @@ ImagingEffectNoise(int xsize, int ysize, float sigma) {
     int nextok;
     double this, next;
 
-    imOut = ImagingNewDirty("L", xsize, ysize);
+    imOut = ImagingNewDirty(IMAGING_MODE_L, xsize, ysize);
     if (!imOut) {
         return NULL;
     }

From 19c0d1da769f153fc91e5f3da2d23b4cc9cf4fc5 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:25:46 -0500
Subject: [PATCH 1905/2374] use mode structs in File.c

---
 src/libImaging/File.c | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/src/libImaging/File.c b/src/libImaging/File.c
index 901fe83ad27..435dbeca0d4 100644
--- a/src/libImaging/File.c
+++ b/src/libImaging/File.c
@@ -23,14 +23,13 @@ int
 ImagingSaveRaw(Imaging im, FILE *fp) {
     int x, y, i;
 
-    if (strcmp(im->mode, "1") == 0 || strcmp(im->mode, "L") == 0) {
+    if (im->mode == IMAGING_MODE_1 || im->mode == IMAGING_MODE_L) {
         /* @PIL227: FIXME: for mode "1", map != 0 to 255 */
 
         /* PGM "L" */
         for (y = 0; y < im->ysize; y++) {
             fwrite(im->image[y], 1, im->xsize, fp);
         }
-
     } else {
         /* PPM "RGB" or other internal format */
         for (y = 0; y < im->ysize; y++) {
@@ -58,10 +57,10 @@ ImagingSavePPM(Imaging im, const char *outfile) {
         return 0;
     }
 
-    if (strcmp(im->mode, "1") == 0 || strcmp(im->mode, "L") == 0) {
+    if (im->mode == IMAGING_MODE_1 || im->mode == IMAGING_MODE_L) {
         /* Write "PGM" */
         fprintf(fp, "P5\n%d %d\n255\n", im->xsize, im->ysize);
-    } else if (strcmp(im->mode, "RGB") == 0) {
+    } else if (im->mode == IMAGING_MODE_RGB) {
         /* Write "PPM" */
         fprintf(fp, "P6\n%d %d\n255\n", im->xsize, im->ysize);
     } else {

From 6202eefcff942fea2773c02b6605f27d5c4cf87e Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:27:30 -0500
Subject: [PATCH 1906/2374] use mode structs in Fill.c

---
 src/libImaging/Fill.c | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/libImaging/Fill.c b/src/libImaging/Fill.c
index 28f42737053..854cdb9fe93 100644
--- a/src/libImaging/Fill.c
+++ b/src/libImaging/Fill.c
@@ -68,11 +68,14 @@ ImagingFill(Imaging im, const void *colour) {
 }
 
 Imaging
-ImagingFillLinearGradient(const char *mode) {
+ImagingFillLinearGradient(const Mode *mode) {
     Imaging im;
     int y;
 
-    if (strlen(mode) != 1) {
+    if (mode != IMAGING_MODE_1 && mode != IMAGING_MODE_F &&
+        mode != IMAGING_MODE_I && mode != IMAGING_MODE_L &&
+        mode != IMAGING_MODE_P
+    ) {
         return (Imaging)ImagingError_ModeError();
     }
 
@@ -102,12 +105,15 @@ ImagingFillLinearGradient(const char *mode) {
 }
 
 Imaging
-ImagingFillRadialGradient(const char *mode) {
+ImagingFillRadialGradient(const Mode *mode) {
     Imaging im;
     int x, y;
     int d;
 
-    if (strlen(mode) != 1) {
+    if (mode != IMAGING_MODE_1 && mode != IMAGING_MODE_F &&
+        mode != IMAGING_MODE_I && mode != IMAGING_MODE_L &&
+        mode != IMAGING_MODE_P
+    ) {
         return (Imaging)ImagingError_ModeError();
     }
 

From af22363327dd0d9f5684b12834f2558f8a3acdce Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:39:16 +0200
Subject: [PATCH 1907/2374] use mode structs in Filter.c

---
 src/libImaging/Filter.c | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/libImaging/Filter.c b/src/libImaging/Filter.c
index c46dd3cd1cd..48f21080906 100644
--- a/src/libImaging/Filter.c
+++ b/src/libImaging/Filter.c
@@ -155,10 +155,9 @@ ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
         } else {
             int bigendian = 0;
             if (im->type == IMAGING_TYPE_SPECIAL) {
-                if (
-                    strcmp(im->mode, "I;16B") == 0
+                if (im->mode == IMAGING_MODE_I_16B
 #ifdef WORDS_BIGENDIAN
-                    || strcmp(im->mode, "I;16N") == 0
+                    || im->mode == IMAGING_MODE_I_16N
 #endif
                 ) {
                     bigendian = 1;
@@ -309,10 +308,9 @@ ImagingFilter5x5(Imaging imOut, Imaging im, const float *kernel, float offset) {
         } else {
             int bigendian = 0;
             if (im->type == IMAGING_TYPE_SPECIAL) {
-                if (
-                    strcmp(im->mode, "I;16B") == 0
+                if (im->mode == IMAGING_MODE_I_16B
 #ifdef WORDS_BIGENDIAN
-                    || strcmp(im->mode, "I;16N") == 0
+                    || im->mode == IMAGING_MODE_I_16N
 #endif
                 ) {
                     bigendian = 1;

From cfe9155a0b9b7bd4435d9abfbc61b127a4d415b5 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sat, 12 Oct 2024 21:10:41 -0500
Subject: [PATCH 1908/2374] use mode structs in Geometry.c

---
 src/libImaging/Geometry.c | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index 1e2abd7e75c..c141ad2a1a4 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -19,7 +19,7 @@ ImagingFlipLeftRight(Imaging imOut, Imaging imIn) {
     ImagingSectionCookie cookie;
     int x, y, xr;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
     if (imIn->xsize != imOut->xsize || imIn->ysize != imOut->ysize) {
@@ -41,7 +41,7 @@ ImagingFlipLeftRight(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
             FLIP_LEFT_RIGHT(UINT16, image8)
         } else {
             FLIP_LEFT_RIGHT(UINT8, image8)
@@ -62,7 +62,7 @@ ImagingFlipTopBottom(Imaging imOut, Imaging imIn) {
     ImagingSectionCookie cookie;
     int y, yr;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
     if (imIn->xsize != imOut->xsize || imIn->ysize != imOut->ysize) {
@@ -89,7 +89,7 @@ ImagingRotate90(Imaging imOut, Imaging imIn) {
     int x, y, xx, yy, xr, xxsize, yysize;
     int xxx, yyy, xxxsize, yyysize;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
     if (imIn->xsize != imOut->ysize || imIn->ysize != imOut->xsize) {
@@ -127,7 +127,7 @@ ImagingRotate90(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
             ROTATE_90(UINT16, image8);
         } else {
             ROTATE_90(UINT8, image8);
@@ -149,7 +149,7 @@ ImagingTranspose(Imaging imOut, Imaging imIn) {
     int x, y, xx, yy, xxsize, yysize;
     int xxx, yyy, xxxsize, yyysize;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
     if (imIn->xsize != imOut->ysize || imIn->ysize != imOut->xsize) {
@@ -186,7 +186,7 @@ ImagingTranspose(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
             TRANSPOSE(UINT16, image8);
         } else {
             TRANSPOSE(UINT8, image8);
@@ -208,7 +208,7 @@ ImagingTransverse(Imaging imOut, Imaging imIn) {
     int x, y, xr, yr, xx, yy, xxsize, yysize;
     int xxx, yyy, xxxsize, yyysize;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
     if (imIn->xsize != imOut->ysize || imIn->ysize != imOut->xsize) {
@@ -247,7 +247,7 @@ ImagingTransverse(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
             TRANSVERSE(UINT16, image8);
         } else {
             TRANSVERSE(UINT8, image8);
@@ -268,7 +268,7 @@ ImagingRotate180(Imaging imOut, Imaging imIn) {
     ImagingSectionCookie cookie;
     int x, y, xr, yr;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
     if (imIn->xsize != imOut->xsize || imIn->ysize != imOut->ysize) {
@@ -291,7 +291,7 @@ ImagingRotate180(Imaging imOut, Imaging imIn) {
 
     yr = imIn->ysize - 1;
     if (imIn->image8) {
-        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
             ROTATE_180(UINT16, image8)
         } else {
             ROTATE_180(UINT8, image8)
@@ -313,7 +313,7 @@ ImagingRotate270(Imaging imOut, Imaging imIn) {
     int x, y, xx, yy, yr, xxsize, yysize;
     int xxx, yyy, xxxsize, yyysize;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
     if (imIn->xsize != imOut->ysize || imIn->ysize != imOut->xsize) {
@@ -351,7 +351,7 @@ ImagingRotate270(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
             ROTATE_270(UINT16, image8);
         } else {
             ROTATE_270(UINT8, image8);
@@ -791,7 +791,7 @@ ImagingGenericTransform(
     char *out;
     double xx, yy;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
 
@@ -848,7 +848,7 @@ ImagingScaleAffine(
     int xmin, xmax;
     int *xintab;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
 
@@ -1035,7 +1035,7 @@ ImagingTransformAffine(
     double xx, yy;
     double xo, yo;
 
-    if (!imOut || !imIn || strcmp(imIn->mode, imOut->mode) != 0) {
+    if (!imOut || !imIn || imIn->mode != imOut->mode) {
         return (Imaging)ImagingError_ModeError();
     }
 

From 2668338583ed765f5e2843650e9784c32652e271 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:35:06 -0500
Subject: [PATCH 1909/2374] use mode structs in GetBBox.c

---
 src/libImaging/GetBBox.c | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index d430893ddb2..3719a9f1576 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -89,10 +89,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 && (
+            im->mode == IMAGING_MODE_RGBa || im->mode == IMAGING_MODE_RGBA ||
+            im->mode == IMAGING_MODE_La || im->mode == IMAGING_MODE_LA ||
+            im->mode == IMAGING_MODE_PA
+        )) {
 #ifdef WORDS_BIGENDIAN
             mask = 0x000000ff;
 #else
@@ -208,7 +209,7 @@ ImagingGetExtrema(Imaging im, void *extrema) {
             memcpy(((char *)extrema) + sizeof(fmin), &fmax, sizeof(fmax));
             break;
         case IMAGING_TYPE_SPECIAL:
-            if (strcmp(im->mode, "I;16") == 0) {
+            if (im->mode == IMAGING_MODE_I_16) {
                 UINT16 v;
                 UINT8 *pixel = *im->image8;
 #ifdef WORDS_BIGENDIAN

From 27497700ee55e6c42cf4428f3a9dfb34ccdecbe2 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:38:07 -0500
Subject: [PATCH 1910/2374] use mode structs in Histo.c

---
 src/libImaging/Histo.c | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/Histo.c b/src/libImaging/Histo.c
index c5a547a647b..cfbf8333d24 100644
--- a/src/libImaging/Histo.c
+++ b/src/libImaging/Histo.c
@@ -43,10 +43,10 @@ ImagingHistogramNew(Imaging im) {
     if (!h) {
         return (ImagingHistogram)ImagingError_MemoryError();
     }
-    strncpy(h->mode, im->mode, IMAGING_MODE_LENGTH - 1);
-    h->mode[IMAGING_MODE_LENGTH - 1] = 0;
 
+    h->mode = im->mode;
     h->bands = im->bands;
+
     h->histogram = calloc(im->pixelsize, 256 * sizeof(long));
     if (!h->histogram) {
         free(h);
@@ -73,7 +73,7 @@ ImagingGetHistogram(Imaging im, Imaging imMask, void *minmax) {
         if (im->xsize != imMask->xsize || im->ysize != imMask->ysize) {
             return ImagingError_Mismatch();
         }
-        if (strcmp(imMask->mode, "1") != 0 && strcmp(imMask->mode, "L") != 0) {
+        if (imMask->mode != IMAGING_MODE_1 && imMask->mode != IMAGING_MODE_L) {
             return ImagingError_ValueError("bad transparency mask");
         }
     }

From 33272580d020ea7eed6f5b735fcceb5b36b7ec80 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:45:28 -0500
Subject: [PATCH 1911/2374] use mode structs in Jpeg2KDecode.c

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

diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index cc6955ca53d..3cbe2965df9 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -771,7 +771,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
         if (color_space == j2k_unpackers[n].color_space &&
             image->numcomps == j2k_unpackers[n].components &&
             (j2k_unpackers[n].subsampling || (subsampling == -1)) &&
-            strcmp(im->mode, j2k_unpackers[n].mode) == 0) {
+            strcmp(im->mode->name, j2k_unpackers[n].mode) == 0) {
             unpack = j2k_unpackers[n].unpacker;
             break;
         }

From 98a2c63326b3c64ea9aafd1f25ea33bfb37b935d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:52:05 -0500
Subject: [PATCH 1912/2374] use mode structs in Jpeg2KEncode.c

---
 src/libImaging/Jpeg2KEncode.c | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index 61e095ad67d..67290f6748f 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -305,28 +305,28 @@ j2k_encode_entry(Imaging im, ImagingCodecState state) {
 #endif
 
     /* Setup an opj_image */
-    if (strcmp(im->mode, "L") == 0) {
+    if (im->mode == IMAGING_MODE_L) {
         components = 1;
         color_space = OPJ_CLRSPC_GRAY;
         pack = j2k_pack_l;
-    } else if (strcmp(im->mode, "I;16") == 0 || strcmp(im->mode, "I;16B") == 0) {
+    } else if (im->mode == IMAGING_MODE_I_16 || im->mode == IMAGING_MODE_I_16B) {
         components = 1;
         color_space = OPJ_CLRSPC_GRAY;
         pack = j2k_pack_i16;
         prec = 16;
-    } else if (strcmp(im->mode, "LA") == 0) {
+    } else if (im->mode == IMAGING_MODE_LA) {
         components = 2;
         color_space = OPJ_CLRSPC_GRAY;
         pack = j2k_pack_la;
-    } else if (strcmp(im->mode, "RGB") == 0) {
+    } else if (im->mode == IMAGING_MODE_RGB) {
         components = 3;
         color_space = OPJ_CLRSPC_SRGB;
         pack = j2k_pack_rgb;
-    } else if (strcmp(im->mode, "YCbCr") == 0) {
+    } else if (im->mode == IMAGING_MODE_YCbCr) {
         components = 3;
         color_space = OPJ_CLRSPC_SYCC;
         pack = j2k_pack_rgb;
-    } else if (strcmp(im->mode, "RGBA") == 0) {
+    } else if (im->mode == IMAGING_MODE_RGBA) {
         components = 4;
         color_space = OPJ_CLRSPC_SRGB;
         pack = j2k_pack_rgba;
@@ -497,9 +497,9 @@ j2k_encode_entry(Imaging im, ImagingCodecState state) {
         goto quick_exit;
     }
 
-    if (strcmp(im->mode, "RGBA") == 0) {
+    if (im->mode == IMAGING_MODE_RGBA) {
         image->comps[3].alpha = 1;
-    } else if (strcmp(im->mode, "LA") == 0) {
+    } else if (im->mode == IMAGING_MODE_LA) {
         image->comps[1].alpha = 1;
     }
 

From 30d4cd02296eec22d5acb19c74c02597f65991ab Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 19:58:58 -0500
Subject: [PATCH 1913/2374] use mode structs in JpegDecode.c

---
 src/libImaging/JpegDecode.c | 14 +++++++-------
 src/libImaging/Mode.h       |  2 ++
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/src/libImaging/JpegDecode.c b/src/libImaging/JpegDecode.c
index 2970f56d1af..36eb7835a7f 100644
--- a/src/libImaging/JpegDecode.c
+++ b/src/libImaging/JpegDecode.c
@@ -196,22 +196,22 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
 
             /* rawmode indicates what we want from the decoder.  if not
                set, conversions are disabled */
-            if (strcmp(context->rawmode, "L") == 0) {
+            if (context->rawmode == IMAGING_RAWMODE_L) {
                 context->cinfo.out_color_space = JCS_GRAYSCALE;
-            } else if (strcmp(context->rawmode, "RGB") == 0) {
+            } else if (context->rawmode == IMAGING_RAWMODE_RGB) {
                 context->cinfo.out_color_space = JCS_RGB;
             }
 #ifdef JCS_EXTENSIONS
-            else if (strcmp(context->rawmode, "RGBX") == 0) {
+            else if (context->rawmode == IMAGING_RAWMODE_RGBX) {
                 context->cinfo.out_color_space = JCS_EXT_RGBX;
             }
 #endif
-            else if (strcmp(context->rawmode, "CMYK") == 0 ||
-                     strcmp(context->rawmode, "CMYK;I") == 0) {
+            else if (context->rawmode == IMAGING_RAWMODE_CMYK ||
+                     context->rawmode == IMAGING_RAWMODE_CMYK_I) {
                 context->cinfo.out_color_space = JCS_CMYK;
-            } else if (strcmp(context->rawmode, "YCbCr") == 0) {
+            } else if (context->rawmode == IMAGING_RAWMODE_YCbCr) {
                 context->cinfo.out_color_space = JCS_YCbCr;
-            } else if (strcmp(context->rawmode, "YCbCrK") == 0) {
+            } else if (context->rawmode == IMAGING_RAWMODE_YCbCrK) {
                 context->cinfo.out_color_space = JCS_YCCK;
             } else {
                 /* Disable decoder conversions */
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index bd184808d23..36deddd02f5 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -79,7 +79,9 @@ extern const RawMode * const IMAGING_RAWMODE_I_32B;
 
 // Rawmodes
 extern const RawMode * const IMAGING_RAWMODE_1_R;
+extern const RawMode * const IMAGING_RAWMODE_CMYK_I;
 extern const RawMode * const IMAGING_RAWMODE_YCC_P;
+extern const RawMode * const IMAGING_RAWMODE_YCbCrK;
 
 const RawMode * findRawMode(const char * const name);
 

From 0abfdd25b1dddbc0ca4fddf816dff9cbba837d14 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 20:00:42 -0500
Subject: [PATCH 1914/2374] use mode structs in JpegEncode.c

---
 src/libImaging/JpegEncode.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/JpegEncode.c b/src/libImaging/JpegEncode.c
index 972435ee117..098e431fca0 100644
--- a/src/libImaging/JpegEncode.c
+++ b/src/libImaging/JpegEncode.c
@@ -114,7 +114,7 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     break;
                 case 24:
                     context->cinfo.input_components = 3;
-                    if (strcmp(im->mode, "YCbCr") == 0) {
+                    if (im->mode == IMAGING_MODE_YCbCr) {
                         context->cinfo.in_color_space = JCS_YCbCr;
                     } else {
                         context->cinfo.in_color_space = JCS_RGB;
@@ -124,7 +124,7 @@ ImagingJpegEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
                     context->cinfo.input_components = 4;
                     context->cinfo.in_color_space = JCS_CMYK;
 #ifdef JCS_EXTENSIONS
-                    if (strcmp(context->rawmode, "RGBX") == 0) {
+                    if (context->rawmode == IMAGING_RAWMODE_RGBX) {
                         context->cinfo.in_color_space = JCS_EXT_RGBX;
                     }
 #endif

From 378c3bd23d88e713fe5148d1cec35cf7126f6530 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 20:03:46 -0500
Subject: [PATCH 1915/2374] use mode structs in Matrix.c

---
 src/libImaging/Matrix.c | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/src/libImaging/Matrix.c b/src/libImaging/Matrix.c
index ec7f4d93e06..fd558461100 100644
--- a/src/libImaging/Matrix.c
+++ b/src/libImaging/Matrix.c
@@ -18,7 +18,7 @@
 #define CLIPF(v) ((v <= 0.0) ? 0 : (v >= 255.0F) ? 255 : (UINT8)v)
 
 Imaging
-ImagingConvertMatrix(Imaging im, const char *mode, float m[]) {
+ImagingConvertMatrix(Imaging im, const Mode *mode, float m[]) {
     Imaging imOut;
     int x, y;
     ImagingSectionCookie cookie;
@@ -28,8 +28,8 @@ ImagingConvertMatrix(Imaging im, const char *mode, float m[]) {
         return (Imaging)ImagingError_ModeError();
     }
 
-    if (strcmp(mode, "L") == 0) {
-        imOut = ImagingNewDirty("L", im->xsize, im->ysize);
+    if (mode == IMAGING_MODE_L) {
+        imOut = ImagingNewDirty(IMAGING_MODE_L, im->xsize, im->ysize);
         if (!imOut) {
             return NULL;
         }
@@ -46,8 +46,7 @@ ImagingConvertMatrix(Imaging im, const char *mode, float m[]) {
             }
         }
         ImagingSectionLeave(&cookie);
-
-    } else if (strlen(mode) == 3) {
+    } else if (strlen(mode->name) == 3) {
         imOut = ImagingNewDirty(mode, im->xsize, im->ysize);
         if (!imOut) {
             return NULL;

From 49062856196ce78bbf9269aa41f65126b04de706 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:41:13 +0200
Subject: [PATCH 1916/2374] add function isModeI16() to check if a mode is an
 I;16 mode

---
 src/_imaging.c            |  6 +-----
 src/libImaging/Draw.c     | 24 ++++++++++++------------
 src/libImaging/Geometry.c | 12 ++++++------
 src/libImaging/Mode.c     |  7 +++++++
 src/libImaging/Mode.h     |  2 ++
 src/libImaging/Paste.c    |  6 +++---
 src/map.c                 |  2 +-
 7 files changed, 32 insertions(+), 27 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 271a16dbb65..bd7cc2233f6 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -662,11 +662,7 @@ getink(PyObject *color, Imaging im, char *ink) {
             memcpy(ink, &ftmp, sizeof(ftmp));
             return ink;
         case IMAGING_TYPE_SPECIAL:
-            if (im->mode == IMAGING_MODE_I_16
-                || im->mode == IMAGING_MODE_I_16L
-                || im->mode == IMAGING_MODE_I_16B
-                || im->mode == IMAGING_MODE_I_16N
-            ) {
+            if (isModeI16(im->mode)) {
                 ink[0] = (UINT8)r;
                 ink[1] = (UINT8)(r >> 8);
                 ink[2] = ink[3] = 0;
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index b946304735f..d2898043256 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -68,7 +68,7 @@ typedef void (*hline_handler)(Imaging, int, int, int, int, Imaging);
 static inline void
 point8(Imaging im, int x, int y, int ink) {
     if (x >= 0 && x < im->xsize && y >= 0 && y < im->ysize) {
-        if (strncmp(im->mode->name, "I;16", 4) == 0) {
+        if (isModeI16(im->mode)) {
 #ifdef WORDS_BIGENDIAN
             im->image8[y][x * 2] = (UINT8)(ink >> 8);
             im->image8[y][x * 2 + 1] = (UINT8)ink;
@@ -672,17 +672,17 @@ DRAW draw32rgba = {point32rgba, hline32rgba, line32rgba};
 /* Interface                                                            */
 /* -------------------------------------------------------------------- */
 
-#define DRAWINIT()                                     \
-    if (im->image8) {                                  \
-        draw = &draw8;                                 \
-        if (strncmp(im->mode->name, "I;16", 4) == 0) { \
-            ink = INK16(ink_);                         \
-        } else {                                       \
-            ink = INK8(ink_);                          \
-        }                                              \
-    } else {                                           \
-        draw = (op) ? &draw32rgba : &draw32;           \
-        memcpy(&ink, ink_, sizeof(ink));               \
+#define DRAWINIT()                           \
+    if (im->image8) {                        \
+        draw = &draw8;                       \
+        if (isModeI16(im->mode)) {           \
+            ink = INK16(ink_);               \
+        } else {                             \
+            ink = INK8(ink_);                \
+        }                                    \
+    } else {                                 \
+        draw = (op) ? &draw32rgba : &draw32; \
+        memcpy(&ink, ink_, sizeof(ink));     \
     }
 
 int
diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index c141ad2a1a4..80ecd7cb6b3 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -41,7 +41,7 @@ ImagingFlipLeftRight(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
+        if (isModeI16(imIn->mode)) {
             FLIP_LEFT_RIGHT(UINT16, image8)
         } else {
             FLIP_LEFT_RIGHT(UINT8, image8)
@@ -127,7 +127,7 @@ ImagingRotate90(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
+        if (isModeI16(imIn->mode)) {
             ROTATE_90(UINT16, image8);
         } else {
             ROTATE_90(UINT8, image8);
@@ -186,7 +186,7 @@ ImagingTranspose(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
+        if (isModeI16(imIn->mode)) {
             TRANSPOSE(UINT16, image8);
         } else {
             TRANSPOSE(UINT8, image8);
@@ -247,7 +247,7 @@ ImagingTransverse(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
+        if (isModeI16(imIn->mode)) {
             TRANSVERSE(UINT16, image8);
         } else {
             TRANSVERSE(UINT8, image8);
@@ -291,7 +291,7 @@ ImagingRotate180(Imaging imOut, Imaging imIn) {
 
     yr = imIn->ysize - 1;
     if (imIn->image8) {
-        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
+        if (isModeI16(imIn->mode)) {
             ROTATE_180(UINT16, image8)
         } else {
             ROTATE_180(UINT8, image8)
@@ -351,7 +351,7 @@ ImagingRotate270(Imaging imOut, Imaging imIn) {
     ImagingSectionEnter(&cookie);
 
     if (imIn->image8) {
-        if (strncmp(imIn->mode->name, "I;16", 4) == 0) {
+        if (isModeI16(imIn->mode)) {
             ROTATE_270(UINT16, image8);
         } else {
             ROTATE_270(UINT8, image8);
diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 85ba50e3f52..a11b65905e8 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -152,3 +152,10 @@ const RawMode * findRawMode(const char * const name) {
     }
     return NULL;
 }
+
+int isModeI16(const Mode * const mode) {
+    return mode == IMAGING_MODE_I_16
+    || mode == IMAGING_MODE_I_16L
+    || mode == IMAGING_MODE_I_16B
+    || mode == IMAGING_MODE_I_16N;
+}
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index 36deddd02f5..d1035efe8df 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -86,4 +86,6 @@ extern const RawMode * const IMAGING_RAWMODE_YCbCrK;
 const RawMode * findRawMode(const char * const name);
 
 
+int isModeI16(const Mode * const mode);
+
 #endif // __MODE_H__
diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index 86085942a2e..5d745d0c13b 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -67,8 +67,8 @@ 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;
+        int in_i16 = isModeI16(imIn->mode);
+        int out_i16 = isModeI16(imOut->mode);
         for (y = 0; y < ysize; y++) {
             UINT8 *out = imOut->image8[y + dy] + dx;
             if (out_i16) {
@@ -437,7 +437,7 @@ fill_mask_L(
     unsigned int tmp1;
 
     if (imOut->image8) {
-        int i16 = strncmp(imOut->mode, "I;16", 4) == 0;
+        int i16 = isModeI16(imOut->mode);
         for (y = 0; y < ysize; y++) {
             UINT8 *out = imOut->image8[y + dy] + dx;
             if (i16) {
diff --git a/src/map.c b/src/map.c
index 9a3144ab904..f4933e45e93 100644
--- a/src/map.c
+++ b/src/map.c
@@ -85,7 +85,7 @@ PyImaging_MapBuffer(PyObject *self, PyObject *args) {
     if (stride <= 0) {
         if (!strcmp(mode, "L") || !strcmp(mode, "P")) {
             stride = xsize;
-        } else if (!strncmp(mode, "I;16", 4)) {
+        } else if (isModeI16(mode)) {
             stride = xsize * 2;
         } else {
             stride = xsize * 4;

From e5bc5b4ffacb00c7793e65b381f7c5dbfabfb86c Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:47:07 +0200
Subject: [PATCH 1917/2374] use mode structs in Pack.c

---
 src/_imaging.c           |   1 +
 src/libImaging/Imaging.h |   5 ++
 src/libImaging/Mode.h    |  41 ++++++++++
 src/libImaging/Pack.c    | 163 ++++++++++++++++++++++++++++++++++++---
 4 files changed, 201 insertions(+), 9 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index bd7cc2233f6..22276590a89 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4319,6 +4319,7 @@ setup_module(PyObject *m) {
 
     ImagingAccessInit();
     ImagingConvertInit();
+    ImagingPackInit();
 
 #ifdef HAVE_LIBJPEG
     {
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index c7e06931353..c3efb2cda43 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -194,6 +194,11 @@ ImagingConvertInit(void);
 extern void
 ImagingConvertFree(void);
 
+extern void
+ImagingPackInit(void);
+extern void
+ImagingPackFree(void);
+
 /* Objects */
 /* ------- */
 
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index d1035efe8df..cedad1e0322 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -78,10 +78,51 @@ extern const RawMode * const IMAGING_RAWMODE_I_32L;
 extern const RawMode * const IMAGING_RAWMODE_I_32B;
 
 // Rawmodes
+extern const RawMode * const IMAGING_RAWMODE_1_I;
+extern const RawMode * const IMAGING_RAWMODE_1_IR;
 extern const RawMode * const IMAGING_RAWMODE_1_R;
+extern const RawMode * const IMAGING_RAWMODE_A;
+extern const RawMode * const IMAGING_RAWMODE_ABGR;
+extern const RawMode * const IMAGING_RAWMODE_B;
+extern const RawMode * const IMAGING_RAWMODE_BGR;
+extern const RawMode * const IMAGING_RAWMODE_BGRA;
+extern const RawMode * const IMAGING_RAWMODE_BGRX;
+extern const RawMode * const IMAGING_RAWMODE_BGRa;
+extern const RawMode * const IMAGING_RAWMODE_C;
 extern const RawMode * const IMAGING_RAWMODE_CMYK_I;
+extern const RawMode * const IMAGING_RAWMODE_CMYK_L;
+extern const RawMode * const IMAGING_RAWMODE_Cb;
+extern const RawMode * const IMAGING_RAWMODE_Cr;
+extern const RawMode * const IMAGING_RAWMODE_F_32F;
+extern const RawMode * const IMAGING_RAWMODE_F_32NF;
+extern const RawMode * const IMAGING_RAWMODE_G;
+extern const RawMode * const IMAGING_RAWMODE_H;
+extern const RawMode * const IMAGING_RAWMODE_I_32NS;
+extern const RawMode * const IMAGING_RAWMODE_I_32S;
+extern const RawMode * const IMAGING_RAWMODE_K;
+extern const RawMode * const IMAGING_RAWMODE_LA_L;
+extern const RawMode * const IMAGING_RAWMODE_L_16;
+extern const RawMode * const IMAGING_RAWMODE_L_16B;
+extern const RawMode * const IMAGING_RAWMODE_M;
+extern const RawMode * const IMAGING_RAWMODE_PA_L;
+extern const RawMode * const IMAGING_RAWMODE_P_1;
+extern const RawMode * const IMAGING_RAWMODE_P_2;
+extern const RawMode * const IMAGING_RAWMODE_P_4;
+extern const RawMode * const IMAGING_RAWMODE_R;
+extern const RawMode * const IMAGING_RAWMODE_RGBA_L;
+extern const RawMode * const IMAGING_RAWMODE_RGBX_L;
+extern const RawMode * const IMAGING_RAWMODE_RGB_L;
+extern const RawMode * const IMAGING_RAWMODE_S;
+extern const RawMode * const IMAGING_RAWMODE_V;
+extern const RawMode * const IMAGING_RAWMODE_X;
+extern const RawMode * const IMAGING_RAWMODE_XBGR;
+extern const RawMode * const IMAGING_RAWMODE_XRGB;
+extern const RawMode * const IMAGING_RAWMODE_Y;
 extern const RawMode * const IMAGING_RAWMODE_YCC_P;
 extern const RawMode * const IMAGING_RAWMODE_YCbCrK;
+extern const RawMode * const IMAGING_RAWMODE_YCbCrX;
+extern const RawMode * const IMAGING_RAWMODE_YCbCr_L;
+extern const RawMode * const IMAGING_RAWMODE_aBGR;
 
 const RawMode * findRawMode(const char * const name);
 
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index 7f8a50d198e..da714daccd1 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -518,9 +518,9 @@ band3(UINT8 *out, const UINT8 *in, int pixels) {
     }
 }
 
-static struct {
-    const char *mode;
-    const char *rawmode;
+static struct Packer {
+    const Mode *mode;
+    const RawMode *rawmode;
     int bits;
     ImagingShuffler pack;
 } packers[] = {
@@ -656,13 +656,10 @@ static struct {
 };
 
 ImagingShuffler
-ImagingFindPacker(const char *mode, const char *rawmode, int *bits_out) {
+ImagingFindPacker(const Mode *mode, const RawMode *rawmode, int *bits_out) {
     int i;
-
-    /* find a suitable pixel packer */
-    for (i = 0; packers[i].rawmode; i++) {
-        if (strcmp(packers[i].mode, mode) == 0 &&
-            strcmp(packers[i].rawmode, rawmode) == 0) {
+    for (i = 0; packers[i].mode; i++) {
+        if (packers[i].mode == mode && packers[i].rawmode == rawmode) {
             if (bits_out) {
                 *bits_out = packers[i].bits;
             }
@@ -671,3 +668,151 @@ ImagingFindPacker(const char *mode, const char *rawmode, int *bits_out) {
     }
     return NULL;
 }
+
+void
+ImagingPackInit(void) {
+    const struct Packer temp[] = {
+        /* bilevel */
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1, 1, pack1},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1_I, 1, pack1I},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1_R, 1, pack1R},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1_IR, 1, pack1IR},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_L, 8, pack1L},
+
+        /* grayscale */
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L, 8, copy1},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16, 16, packL16},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16B, 16, packL16B},
+
+        /* grayscale w. alpha */
+        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA, 16, packLA},
+        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA_L, 16, packLAL},
+
+        /* grayscale w. alpha premultiplied */
+        {IMAGING_MODE_La, IMAGING_RAWMODE_La, 16, packLA},
+
+        /* palette */
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_1, 1, pack1},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_2, 2, packP2},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_4, 4, packP4},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P, 8, copy1},
+
+        /* palette w. alpha */
+        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA, 16, packLA},
+        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA_L, 16, packLAL},
+
+        /* true colour */
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX, 32, copy4},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA, 32, copy4},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XRGB, 32, ImagingPackXRGB},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGRX, 32, ImagingPackBGRX},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XBGR, 32, ImagingPackXBGR},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_L, 24, packRGBL},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R, 8, band0},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G, 8, band1},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B, 8, band2},
+
+        /* true colour w. alpha */
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA, 32, copy4},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_L, 32, packRGBXL},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA, 32, ImagingPackBGRA},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ABGR, 32, ImagingPackABGR},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRa, 32, ImagingPackBGRa},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R, 8, band0},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G, 8, band1},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B, 8, band2},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A, 8, band3},
+
+        /* true colour w. alpha premultiplied */
+        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_RGBa, 32, copy4},
+        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_BGRa, 32, ImagingPackBGRA},
+        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aBGR, 32, ImagingPackABGR},
+
+        /* true colour w. padding */
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX, 32, copy4},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_L, 32, packRGBXL},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGRX, 32, ImagingPackBGRX},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XBGR, 32, ImagingPackXBGR},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_R, 8, band0},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_G, 8, band1},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_B, 8, band2},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_X, 8, band3},
+
+        /* colour separation */
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK, 32, copy4},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_I, 32, copy4I},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_L, 32, packRGBXL},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C, 8, band0},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M, 8, band1},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y, 8, band2},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K, 8, band3},
+
+        /* video (YCbCr) */
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr, 24, ImagingPackRGB},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr_L, 24, packRGBL},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrX, 32, copy4},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrK, 32, copy4},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Y, 8, band0},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Cb, 8, band1},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Cr, 8, band2},
+
+        /* LAB Color */
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_LAB, 24, ImagingPackLAB},
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_L, 8, band0},
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_A, 8, band1},
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_B, 8, band2},
+
+        /* HSV */
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_HSV, 24, ImagingPackRGB},
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_H, 8, band0},
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_S, 8, band1},
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_V, 8, band2},
+
+        /* integer */
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I, 32, copy4},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16B, 16, packI16B},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32S, 32, packI32S},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32NS, 32, copy4},
+
+        /* floating point */
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F, 32, copy4},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32F, 32, packI32S},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NF, 32, copy4},
+
+        /* storage modes */
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16, 16, copy2},
+#ifdef WORDS_BIGENDIAN
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, packI16N_I16},
+#else
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, packI16N_I16B},
+#endif
+        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
+        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
+        {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16}, // LibTiff native->image endian.
+        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
+        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B},
+        {IMAGING_MODE_BGR_15, IMAGING_RAWMODE_BGR_15, 16, copy2},
+        {IMAGING_MODE_BGR_16, IMAGING_RAWMODE_BGR_16, 16, copy2},
+        {IMAGING_MODE_BGR_24, IMAGING_RAWMODE_BGR_24, 24, copy3},
+
+        {NULL} /* sentinel */
+    };
+    packers = malloc(sizeof(temp));
+    if (packers == NULL) {
+        fprintf(stderr, "PackInit: failed to allocate memory for packers table\n");
+        exit(1);
+    }
+    memcpy(packers, temp, sizeof(temp));
+}
+
+void
+ImagingPackFree(void) {
+    free(packers);
+}

From af3c24e12b2982a4713f80931164422acef0433b Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 22:29:12 -0500
Subject: [PATCH 1918/2374] use mode structs in Palette.c

---
 src/libImaging/Mode.h    | 4 ----
 src/libImaging/Palette.c | 9 ++++-----
 2 files changed, 4 insertions(+), 9 deletions(-)

diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index cedad1e0322..09810b584d6 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -2,10 +2,6 @@
 #define __MODE_H__
 
 
-// Maximum length (including null terminator) for both mode and rawmode names.
-#define IMAGING_MODE_LENGTH 6+1
-
-
 typedef struct {
     const char * const name;
 } Mode;
diff --git a/src/libImaging/Palette.c b/src/libImaging/Palette.c
index 78916bca52b..6b4fea6a5fd 100644
--- a/src/libImaging/Palette.c
+++ b/src/libImaging/Palette.c
@@ -21,13 +21,13 @@
 #include <math.h>
 
 ImagingPalette
-ImagingPaletteNew(const char *mode) {
+ImagingPaletteNew(const Mode *mode) {
     /* Create a palette object */
 
     int i;
     ImagingPalette palette;
 
-    if (strcmp(mode, "RGB") && strcmp(mode, "RGBA")) {
+    if (mode != IMAGING_MODE_RGB && mode != IMAGING_MODE_RGBA) {
         return (ImagingPalette)ImagingError_ModeError();
     }
 
@@ -36,8 +36,7 @@ ImagingPaletteNew(const char *mode) {
         return (ImagingPalette)ImagingError_MemoryError();
     }
 
-    strncpy(palette->mode, mode, IMAGING_MODE_LENGTH - 1);
-    palette->mode[IMAGING_MODE_LENGTH - 1] = 0;
+    palette->mode = mode;
 
     palette->size = 0;
     for (i = 0; i < 256; i++) {
@@ -54,7 +53,7 @@ ImagingPaletteNewBrowser(void) {
     int i, r, g, b;
     ImagingPalette palette;
 
-    palette = ImagingPaletteNew("RGB");
+    palette = ImagingPaletteNew(IMAGING_MODE_RGB);
     if (!palette) {
         return NULL;
     }

From 2a9d712ceb71b7e14dc73782076280aae1dbc362 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 22:32:54 -0500
Subject: [PATCH 1919/2374] use mode structs in Paste.c

---
 src/libImaging/Paste.c | 35 +++++++++++++----------------------
 1 file changed, 13 insertions(+), 22 deletions(-)

diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index 5d745d0c13b..54dd270e6f0 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -307,31 +307,26 @@ ImagingPaste(
         ImagingSectionEnter(&cookie);
         paste(imOut, imIn, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "1") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_1) {
         ImagingSectionEnter(&cookie);
         paste_mask_1(imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "L") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_L) {
         ImagingSectionEnter(&cookie);
         paste_mask_L(imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "LA") == 0 || strcmp(imMask->mode, "RGBA") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_LA || imMask->mode == IMAGING_MODE_RGBA) {
         ImagingSectionEnter(&cookie);
         paste_mask_RGBA(
             imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize
         );
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "RGBa") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_RGBa) {
         ImagingSectionEnter(&cookie);
         paste_mask_RGBa(
             imOut, imIn, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize
         );
         ImagingSectionLeave(&cookie);
-
     } else {
         (void)ImagingError_ValueError("bad transparency mask");
         return -1;
@@ -455,10 +450,11 @@ 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 = imOut->mode == IMAGING_MODE_RGBa ||
+                            imOut->mode == IMAGING_MODE_RGBA ||
+                            imOut->mode == IMAGING_MODE_La ||
+                            imOut->mode == IMAGING_MODE_LA ||
+                            imOut->mode == IMAGING_MODE_PA;
         for (y = 0; y < ysize; y++) {
             UINT8 *out = (UINT8 *)imOut->image[y + dy] + dx * pixelsize;
             UINT8 *mask = (UINT8 *)imMask->image[y + sy] + sx;
@@ -617,27 +613,22 @@ ImagingFill2(
         ImagingSectionEnter(&cookie);
         fill(imOut, ink, dx0, dy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "1") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_1) {
         ImagingSectionEnter(&cookie);
         fill_mask_1(imOut, ink, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "L") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_L) {
         ImagingSectionEnter(&cookie);
         fill_mask_L(imOut, ink, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "RGBA") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_RGBA) {
         ImagingSectionEnter(&cookie);
         fill_mask_RGBA(imOut, ink, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
-    } else if (strcmp(imMask->mode, "RGBa") == 0) {
+    } else if (imMask->mode == IMAGING_MODE_RGBa) {
         ImagingSectionEnter(&cookie);
         fill_mask_RGBa(imOut, ink, imMask, dx0, dy0, sx0, sy0, xsize, ysize, pixelsize);
         ImagingSectionLeave(&cookie);
-
     } else {
         (void)ImagingError_ValueError("bad transparency mask");
         return -1;

From 7e48697f8269d1d9caefd0516951cd52b31a154d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 22:36:23 -0500
Subject: [PATCH 1920/2374] use mode structs in Point.c

---
 src/libImaging/Point.c | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/libImaging/Point.c b/src/libImaging/Point.c
index b11ea62ed85..e33f38508dc 100644
--- a/src/libImaging/Point.c
+++ b/src/libImaging/Point.c
@@ -128,7 +128,7 @@ im_point_32_8(Imaging imOut, Imaging imIn, im_point_context *context) {
 }
 
 Imaging
-ImagingPoint(Imaging imIn, const char *mode, const void *table) {
+ImagingPoint(Imaging imIn, const Mode *mode, const void *table) {
     /* lookup table transform */
 
     ImagingSectionCookie cookie;
@@ -145,10 +145,10 @@ ImagingPoint(Imaging imIn, const char *mode, const void *table) {
     }
 
     if (imIn->type != IMAGING_TYPE_UINT8) {
-        if (imIn->type != IMAGING_TYPE_INT32 || strcmp(mode, "L") != 0) {
+        if (imIn->type != IMAGING_TYPE_INT32 || mode != IMAGING_MODE_L) {
             goto mode_mismatch;
         }
-    } else if (!imIn->image8 && strcmp(imIn->mode, mode) != 0) {
+    } else if (!imIn->image8 && imIn->mode != mode) {
         goto mode_mismatch;
     }
 
@@ -210,8 +210,8 @@ ImagingPointTransform(Imaging imIn, double scale, double offset) {
     Imaging imOut;
     int x, y;
 
-    if (!imIn || (strcmp(imIn->mode, "I") != 0 && strcmp(imIn->mode, "I;16") != 0 &&
-                  strcmp(imIn->mode, "F") != 0)) {
+    if (!imIn || (imIn->mode != IMAGING_MODE_I &&
+        imIn->mode != IMAGING_MODE_I_16 && imIn->mode != IMAGING_MODE_F)) {
         return (Imaging)ImagingError_ModeError();
     }
 
@@ -245,7 +245,7 @@ ImagingPointTransform(Imaging imIn, double scale, double offset) {
             ImagingSectionLeave(&cookie);
             break;
         case IMAGING_TYPE_SPECIAL:
-            if (strcmp(imIn->mode, "I;16") == 0) {
+            if (imIn->mode == IMAGING_MODE_I_16) {
                 ImagingSectionEnter(&cookie);
                 for (y = 0; y < imIn->ysize; y++) {
                     char *in = (char *)imIn->image[y];

From fb73d9003e62d2023176d39c84e0ff3f258debb8 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 22:38:11 -0500
Subject: [PATCH 1921/2374] use mode structs in Quant.c

---
 src/libImaging/Quant.c | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index a489a882db2..b1397c5f054 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -1684,13 +1684,13 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
         return (Imaging)ImagingError_ValueError("bad number of colors");
     }
 
-    if (strcmp(im->mode, "L") != 0 && strcmp(im->mode, "P") != 0 &&
-        strcmp(im->mode, "RGB") != 0 && strcmp(im->mode, "RGBA") != 0) {
+    if (im->mode != IMAGING_MODE_L && im->mode != IMAGING_MODE_P &&
+        im->mode != IMAGING_MODE_RGB && im->mode != IMAGING_MODE_RGBA) {
         return ImagingError_ModeError();
     }
 
     /* only octree and imagequant supports RGBA */
-    if (!strcmp(im->mode, "RGBA") && mode != 2 && mode != 3) {
+    if (im->mode == IMAGING_MODE_RGBA && mode != 2 && mode != 3) {
         return ImagingError_ModeError();
     }
 
@@ -1708,7 +1708,7 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
     /* FIXME: maybe we could load the hash tables directly from the
        image data? */
 
-    if (!strcmp(im->mode, "L")) {
+    if (im->mode == IMAGING_MODE_L) {
         /* grayscale */
 
         /* FIXME: converting a "L" image to "P" with 256 colors
@@ -1721,7 +1721,7 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
             }
         }
 
-    } else if (!strcmp(im->mode, "P")) {
+    } else if (im->mode == IMAGING_MODE_P) {
         /* palette */
 
         pp = im->palette->palette;
@@ -1736,10 +1736,10 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
             }
         }
 
-    } else if (!strcmp(im->mode, "RGB") || !strcmp(im->mode, "RGBA")) {
+    } else if (im->mode == IMAGING_MODE_RGB || im->mode == IMAGING_MODE_RGBA) {
         /* true colour */
 
-        withAlpha = !strcmp(im->mode, "RGBA");
+        withAlpha = im->mode == IMAGING_MODE_RGBA;
         int transparency = 0;
         unsigned char r = 0, g = 0, b = 0;
         for (i = y = 0; y < im->ysize; y++) {
@@ -1830,7 +1830,7 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
     ImagingSectionLeave(&cookie);
 
     if (result > 0) {
-        imOut = ImagingNewDirty("P", im->xsize, im->ysize);
+        imOut = ImagingNewDirty(IMAGING_MODE_P, im->xsize, im->ysize);
         ImagingSectionEnter(&cookie);
 
         for (i = y = 0; y < im->ysize; y++) {
@@ -1855,7 +1855,7 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
         }
 
         if (withAlpha) {
-            strcpy(imOut->palette->mode, "RGBA");
+            imOut->palette->mode = IMAGING_MODE_RGBA;
         }
 
         free(palette);

From c80fba3045893918f1e51c4df3934e314b2c5f8d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 22:40:40 -0500
Subject: [PATCH 1922/2374] use mode structs in Reduce.c

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

diff --git a/src/libImaging/Reduce.c b/src/libImaging/Reduce.c
index 022daa0003f..a4e58ced81b 100644
--- a/src/libImaging/Reduce.c
+++ b/src/libImaging/Reduce.c
@@ -1452,7 +1452,7 @@ ImagingReduce(Imaging imIn, int xscale, int yscale, int box[4]) {
     ImagingSectionCookie cookie;
     Imaging imOut = NULL;
 
-    if (strcmp(imIn->mode, "P") == 0 || strcmp(imIn->mode, "1") == 0) {
+    if (imIn->mode == IMAGING_MODE_P || imIn->mode == IMAGING_MODE_1) {
         return (Imaging)ImagingError_ModeError();
     }
 

From 858b0b38059a6162c3317c2a5081d4ee7b2ff9b1 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:47:47 +0200
Subject: [PATCH 1923/2374] use mode structs in Resample.c

---
 src/libImaging/Resample.c | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/src/libImaging/Resample.c b/src/libImaging/Resample.c
index b114e002330..3ab43a8955a 100644
--- a/src/libImaging/Resample.c
+++ b/src/libImaging/Resample.c
@@ -470,10 +470,9 @@ ImagingResampleHorizontal_16bpc(
     double *k;
 
     int bigendian = 0;
-    if (
-        strcmp(imIn->mode, "I;16N") == 0
+    if (imIn->mode == IMAGING_MODE_I_16N
 #ifdef WORDS_BIGENDIAN
-        || strcmp(imIn->mode, "I;16B") == 0
+        || imIn->mode == IMAGING_MODE_I_16B
 #endif
     ) {
         bigendian = 1;
@@ -510,10 +509,9 @@ ImagingResampleVertical_16bpc(
     double *k;
 
     int bigendian = 0;
-    if (
-        strcmp(imIn->mode, "I;16N") == 0
+    if (imIn->mode == IMAGING_MODE_I_16N
 #ifdef WORDS_BIGENDIAN
-        || strcmp(imIn->mode, "I;16B") == 0
+        || imIn->mode == IMAGING_MODE_I_16B
 #endif
     ) {
         bigendian = 1;
@@ -648,12 +646,12 @@ ImagingResample(Imaging imIn, int xsize, int ysize, int filter, float box[4]) {
     ResampleFunction ResampleHorizontal;
     ResampleFunction ResampleVertical;
 
-    if (strcmp(imIn->mode, "P") == 0 || strcmp(imIn->mode, "1") == 0) {
+    if (imIn->mode == IMAGING_MODE_P || imIn->mode == IMAGING_MODE_1) {
         return (Imaging)ImagingError_ModeError();
     }
 
     if (imIn->type == IMAGING_TYPE_SPECIAL) {
-        if (strncmp(imIn->mode, "I;16", 4) == 0) {
+        if (isModeI16(imIn->mode)) {
             ResampleHorizontal = ImagingResampleHorizontal_16bpc;
             ResampleVertical = ImagingResampleVertical_16bpc;
         } else {

From e75a0a9c39ab16da44482be77c21b2f08fea9923 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:54:11 +0200
Subject: [PATCH 1924/2374] use mode structs in Storage.c

---
 src/libImaging/Storage.c | 59 ++++++++++++++++++++--------------------
 1 file changed, 29 insertions(+), 30 deletions(-)

diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 4640f078a62..38142b7c5e1 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -42,7 +42,7 @@
  */
 
 Imaging
-ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
+ImagingNewPrologueSubtype(const Mode *mode, int xsize, int ysize, int size) {
     Imaging im;
 
     /* linesize overflow check, roughly the current largest space req'd */
@@ -62,37 +62,37 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
     im->type = IMAGING_TYPE_UINT8;
     strcpy(im->arrow_band_format, "C");
 
-    if (strcmp(mode, "1") == 0) {
+    if (mode == IMAGING_MODE_1) {
         /* 1-bit images */
         im->bands = im->pixelsize = 1;
         im->linesize = xsize;
         strcpy(im->band_names[0], "1");
 
-    } else if (strcmp(mode, "P") == 0) {
+    } else if (mode == IMAGING_MODE_P) {
         /* 8-bit palette mapped images */
         im->bands = im->pixelsize = 1;
         im->linesize = xsize;
-        im->palette = ImagingPaletteNew("RGB");
+        im->palette = ImagingPaletteNew(IMAGING_MODE_RGB);
         strcpy(im->band_names[0], "P");
 
-    } else if (strcmp(mode, "PA") == 0) {
+    } else if (mode == IMAGING_MODE_PA) {
         /* 8-bit palette with alpha */
         im->bands = 2;
         im->pixelsize = 4; /* store in image32 memory */
         im->linesize = xsize * 4;
-        im->palette = ImagingPaletteNew("RGB");
+        im->palette = ImagingPaletteNew(IMAGING_MODE_RGB);
         strcpy(im->band_names[0], "P");
         strcpy(im->band_names[1], "X");
         strcpy(im->band_names[2], "X");
         strcpy(im->band_names[3], "A");
 
-    } else if (strcmp(mode, "L") == 0) {
+    } else if (mode == IMAGING_MODE_L) {
         /* 8-bit grayscale (luminance) images */
         im->bands = im->pixelsize = 1;
         im->linesize = xsize;
         strcpy(im->band_names[0], "L");
 
-    } else if (strcmp(mode, "LA") == 0) {
+    } else if (mode == IMAGING_MODE_LA) {
         /* 8-bit grayscale (luminance) with alpha */
         im->bands = 2;
         im->pixelsize = 4; /* store in image32 memory */
@@ -102,7 +102,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "X");
         strcpy(im->band_names[3], "A");
 
-    } else if (strcmp(mode, "La") == 0) {
+    } else if (mode == IMAGING_MODE_La) {
         /* 8-bit grayscale (luminance) with premultiplied alpha */
         im->bands = 2;
         im->pixelsize = 4; /* store in image32 memory */
@@ -112,7 +112,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "X");
         strcpy(im->band_names[3], "a");
 
-    } else if (strcmp(mode, "F") == 0) {
+    } else if (mode == IMAGING_MODE_F) {
         /* 32-bit floating point images */
         im->bands = 1;
         im->pixelsize = 4;
@@ -121,7 +121,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->arrow_band_format, "f");
         strcpy(im->band_names[0], "F");
 
-    } else if (strcmp(mode, "I") == 0) {
+    } else if (mode == IMAGING_MODE_I) {
         /* 32-bit integer images */
         im->bands = 1;
         im->pixelsize = 4;
@@ -130,8 +130,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->arrow_band_format, "i");
         strcpy(im->band_names[0], "I");
 
-    } else if (strcmp(mode, "I;16") == 0 || strcmp(mode, "I;16L") == 0 ||
-               strcmp(mode, "I;16B") == 0 || strcmp(mode, "I;16N") == 0) {
+    } else if (isModeI16(mode)) {
         /* EXPERIMENTAL */
         /* 16-bit raw integer images */
         im->bands = 1;
@@ -141,7 +140,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->arrow_band_format, "s");
         strcpy(im->band_names[0], "I");
 
-    } else if (strcmp(mode, "RGB") == 0) {
+    } else if (mode == IMAGING_MODE_RGB) {
         /* 24-bit true colour images */
         im->bands = 3;
         im->pixelsize = 4;
@@ -151,7 +150,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "B");
         strcpy(im->band_names[3], "X");
 
-    } else if (strcmp(mode, "RGBX") == 0) {
+    } else if (mode == IMAGING_MODE_RGBX) {
         /* 32-bit true colour images with padding */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
@@ -160,7 +159,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "B");
         strcpy(im->band_names[3], "X");
 
-    } else if (strcmp(mode, "RGBA") == 0) {
+    } else if (mode == IMAGING_MODE_RGBA) {
         /* 32-bit true colour images with alpha */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
@@ -169,7 +168,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "B");
         strcpy(im->band_names[3], "A");
 
-    } else if (strcmp(mode, "RGBa") == 0) {
+    } else if (mode == IMAGING_MODE_RGBa) {
         /* 32-bit true colour images with premultiplied alpha */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
@@ -178,7 +177,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "B");
         strcpy(im->band_names[3], "a");
 
-    } else if (strcmp(mode, "CMYK") == 0) {
+    } else if (mode == IMAGING_MODE_CMYK) {
         /* 32-bit colour separation */
         im->bands = im->pixelsize = 4;
         im->linesize = xsize * 4;
@@ -187,7 +186,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "Y");
         strcpy(im->band_names[3], "K");
 
-    } else if (strcmp(mode, "YCbCr") == 0) {
+    } else if (mode == IMAGING_MODE_YCbCr) {
         /* 24-bit video format */
         im->bands = 3;
         im->pixelsize = 4;
@@ -197,7 +196,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "Cr");
         strcpy(im->band_names[3], "X");
 
-    } else if (strcmp(mode, "LAB") == 0) {
+    } else if (mode == IMAGING_MODE_LAB) {
         /* 24-bit color, luminance, + 2 color channels */
         /* L is uint8, a,b are int8 */
         im->bands = 3;
@@ -208,7 +207,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
         strcpy(im->band_names[2], "b");
         strcpy(im->band_names[3], "X");
 
-    } else if (strcmp(mode, "HSV") == 0) {
+    } else if (mode == IMAGING_MODE_HSV) {
         /* 24-bit color, luminance, + 2 color channels */
         /* L is uint8, a,b are int8 */
         im->bands = 3;
@@ -225,7 +224,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
     }
 
     /* Setup image descriptor */
-    strcpy(im->mode, mode);
+    im->mode = mode;
 
     /* Pointer array (allocate at least one line, to avoid MemoryError
        exceptions on platforms where calloc(0, x) returns NULL) */
@@ -257,7 +256,7 @@ ImagingNewPrologueSubtype(const char *mode, int xsize, int ysize, int size) {
 }
 
 Imaging
-ImagingNewPrologue(const char *mode, int xsize, int ysize) {
+ImagingNewPrologue(const Mode *mode, int xsize, int ysize) {
     return ImagingNewPrologueSubtype(
         mode, xsize, ysize, sizeof(struct ImagingMemoryInstance)
     );
@@ -594,7 +593,7 @@ ImagingBorrowArrow(
  */
 
 Imaging
-ImagingNewInternal(const char *mode, int xsize, int ysize, int dirty) {
+ImagingNewInternal(const Mode *mode, int xsize, int ysize, int dirty) {
     Imaging im;
 
     if (xsize < 0 || ysize < 0) {
@@ -630,7 +629,7 @@ ImagingNewInternal(const char *mode, int xsize, int ysize, int dirty) {
 }
 
 Imaging
-ImagingNew(const char *mode, int xsize, int ysize) {
+ImagingNew(const Mode *mode, int xsize, int ysize) {
     if (ImagingDefaultArena.use_block_allocator) {
         return ImagingNewBlock(mode, xsize, ysize);
     }
@@ -638,7 +637,7 @@ ImagingNew(const char *mode, int xsize, int ysize) {
 }
 
 Imaging
-ImagingNewDirty(const char *mode, int xsize, int ysize) {
+ImagingNewDirty(const Mode *mode, int xsize, int ysize) {
     if (ImagingDefaultArena.use_block_allocator) {
         return ImagingNewBlock(mode, xsize, ysize);
     }
@@ -646,7 +645,7 @@ ImagingNewDirty(const char *mode, int xsize, int ysize) {
 }
 
 Imaging
-ImagingNewBlock(const char *mode, int xsize, int ysize) {
+ImagingNewBlock(const Mode *mode, int xsize, int ysize) {
     Imaging im;
 
     if (xsize < 0 || ysize < 0) {
@@ -668,7 +667,7 @@ ImagingNewBlock(const char *mode, int xsize, int ysize) {
 
 Imaging
 ImagingNewArrow(
-    const char *mode,
+    const Mode *mode,
     int xsize,
     int ysize,
     PyObject *schema_capsule,
@@ -741,12 +740,12 @@ ImagingNewArrow(
 }
 
 Imaging
-ImagingNew2Dirty(const char *mode, Imaging imOut, Imaging imIn) {
+ImagingNew2Dirty(const Mode *mode, Imaging imOut, Imaging imIn) {
     /* allocate or validate output image */
 
     if (imOut) {
         /* make sure images match */
-        if (strcmp(imOut->mode, mode) != 0 || imOut->xsize != imIn->xsize ||
+        if (imOut->mode != mode || imOut->xsize != imIn->xsize ||
             imOut->ysize != imIn->ysize) {
             return ImagingError_Mismatch();
         }

From 141c95df9a56ed177b07fb82acfa6087d338d4be Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Sun, 21 Apr 2024 22:54:58 -0500
Subject: [PATCH 1925/2374] use mode structs in TiffDecode.c

---
 src/libImaging/Mode.h       |  4 ++++
 src/libImaging/TiffDecode.c | 20 ++++++++------------
 2 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index 09810b584d6..f953d586f7c 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -79,11 +79,13 @@ extern const RawMode * const IMAGING_RAWMODE_1_IR;
 extern const RawMode * const IMAGING_RAWMODE_1_R;
 extern const RawMode * const IMAGING_RAWMODE_A;
 extern const RawMode * const IMAGING_RAWMODE_ABGR;
+extern const RawMode * const IMAGING_RAWMODE_A_16N;
 extern const RawMode * const IMAGING_RAWMODE_B;
 extern const RawMode * const IMAGING_RAWMODE_BGR;
 extern const RawMode * const IMAGING_RAWMODE_BGRA;
 extern const RawMode * const IMAGING_RAWMODE_BGRX;
 extern const RawMode * const IMAGING_RAWMODE_BGRa;
+extern const RawMode * const IMAGING_RAWMODE_B_16N;
 extern const RawMode * const IMAGING_RAWMODE_C;
 extern const RawMode * const IMAGING_RAWMODE_CMYK_I;
 extern const RawMode * const IMAGING_RAWMODE_CMYK_L;
@@ -92,6 +94,7 @@ extern const RawMode * const IMAGING_RAWMODE_Cr;
 extern const RawMode * const IMAGING_RAWMODE_F_32F;
 extern const RawMode * const IMAGING_RAWMODE_F_32NF;
 extern const RawMode * const IMAGING_RAWMODE_G;
+extern const RawMode * const IMAGING_RAWMODE_G_16N;
 extern const RawMode * const IMAGING_RAWMODE_H;
 extern const RawMode * const IMAGING_RAWMODE_I_32NS;
 extern const RawMode * const IMAGING_RAWMODE_I_32S;
@@ -108,6 +111,7 @@ extern const RawMode * const IMAGING_RAWMODE_R;
 extern const RawMode * const IMAGING_RAWMODE_RGBA_L;
 extern const RawMode * const IMAGING_RAWMODE_RGBX_L;
 extern const RawMode * const IMAGING_RAWMODE_RGB_L;
+extern const RawMode * const IMAGING_RAWMODE_R_16N;
 extern const RawMode * const IMAGING_RAWMODE_S;
 extern const RawMode * const IMAGING_RAWMODE_V;
 extern const RawMode * const IMAGING_RAWMODE_X;
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 71516fd1b56..40e8fba505f 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -246,14 +246,10 @@ _pickUnpackers(
         // 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(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_R_16N : IMAGING_RAWMODE_R, NULL);
+        unpackers[1] = ImagingFindUnpacker(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_G_16N : IMAGING_RAWMODE_G, NULL);
+        unpackers[2] = ImagingFindUnpacker(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_B_16N : IMAGING_RAWMODE_B, NULL);
+        unpackers[3] = ImagingFindUnpacker(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_A_16N : IMAGING_RAWMODE_A, NULL);
 
         return im->bands;
     } else {
@@ -644,7 +640,7 @@ ImagingLibTiffDecode(
     );
     TRACE(
         ("Image: mode %s, type %d, bands: %d, xsize %d, ysize %d \n",
-         im->mode,
+         im->mode->name,
          im->type,
          im->bands,
          im->xsize,
@@ -755,7 +751,7 @@ ImagingLibTiffDecode(
         if (!state->errcode) {
             // Check if raw mode was RGBa and it was stored on separate planes
             // so we have to convert it to RGBA
-            if (planes > 3 && strcmp(im->mode, "RGBA") == 0) {
+            if (planes > 3 && im->mode == IMAGING_MODE_RGBA) {
                 uint16_t extrasamples;
                 uint16_t *sampleinfo;
                 ImagingShuffler shuffle;
@@ -767,7 +763,7 @@ ImagingLibTiffDecode(
 
                 if (extrasamples >= 1 && (sampleinfo[0] == EXTRASAMPLE_UNSPECIFIED ||
                                           sampleinfo[0] == EXTRASAMPLE_ASSOCALPHA)) {
-                    shuffle = ImagingFindUnpacker("RGBA", "RGBa", NULL);
+                    shuffle = ImagingFindUnpacker(IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa, NULL);
 
                     for (y = state->yoff; y < state->ysize; y++) {
                         UINT8 *ptr = (UINT8 *)im->image[y + state->yoff] +
@@ -991,7 +987,7 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
     );
     TRACE(
         ("Image: mode %s, type %d, bands: %d, xsize %d, ysize %d \n",
-         im->mode,
+         im->mode->name,
          im->type,
          im->bands,
          im->xsize,

From 39d434b39dc736287604673720532b89c70eb260 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 12:47:51 -0500
Subject: [PATCH 1926/2374] use (void) for empty function parameters

---
 src/libImaging/Access.c  | 2 +-
 src/libImaging/Convert.c | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 6c41fc0915c..95586d7edb7 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -189,4 +189,4 @@ void
 _ImagingAccessDelete(Imaging im, ImagingAccess access) {}
 
 void
-ImagingAccessFree() {}
+ImagingAccessFree(void) {}
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 2bc054616aa..48259dcdce2 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -1650,7 +1650,7 @@ ImagingConvertInPlace(Imaging imIn, const Mode *mode) {
 /* ------------------ */
 
 void
-ImagingConvertInit() {
+ImagingConvertInit(void) {
     const struct Converter temp[] = {
         {IMAGING_MODE_1, IMAGING_MODE_L, bit2l},
         {IMAGING_MODE_1, IMAGING_MODE_I, bit2i},
@@ -1792,6 +1792,6 @@ ImagingConvertInit() {
 }
 
 void
-ImagingConvertFree() {
+ImagingConvertFree(void) {
     free(converters);
 }

From 31118b0019ddd553dfd0b841b6b42c4b33ab1ef9 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 12:48:26 -0500
Subject: [PATCH 1927/2374] set pointer to NULL after free

---
 src/libImaging/Convert.c | 1 +
 src/libImaging/Pack.c    | 1 +
 2 files changed, 2 insertions(+)

diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 48259dcdce2..8f580c294b7 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -1794,4 +1794,5 @@ ImagingConvertInit(void) {
 void
 ImagingConvertFree(void) {
     free(converters);
+    converters = NULL;
 }
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index da714daccd1..aaa074c9249 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -815,4 +815,5 @@ ImagingPackInit(void) {
 void
 ImagingPackFree(void) {
     free(packers);
+    packers = NULL;
 }

From d11819ca6bdebc50c94d84aad17514cf4a42365f Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 15:55:44 +0200
Subject: [PATCH 1928/2374] use mode structs in Unpack.c

---
 src/_imaging.c           |   1 +
 src/libImaging/Imaging.h |   5 +
 src/libImaging/Mode.h    |  96 ++++++++++++
 src/libImaging/Unpack.c  | 325 ++++++++++++++++++++++++++++++++++++++-
 4 files changed, 421 insertions(+), 6 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 22276590a89..6c98c42eacf 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4320,6 +4320,7 @@ setup_module(PyObject *m) {
     ImagingAccessInit();
     ImagingConvertInit();
     ImagingPackInit();
+    ImagingUnpackInit();
 
 #ifdef HAVE_LIBJPEG
     {
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index c3efb2cda43..9f450dd3ad2 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -199,6 +199,11 @@ ImagingPackInit(void);
 extern void
 ImagingPackFree(void);
 
+extern void
+ImagingUnpackInit(void);
+extern void
+ImagingUnpackFree(void);
+
 /* Objects */
 /* ------- */
 
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index f953d586f7c..663f2f4681f 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -74,43 +74,136 @@ extern const RawMode * const IMAGING_RAWMODE_I_32L;
 extern const RawMode * const IMAGING_RAWMODE_I_32B;
 
 // Rawmodes
+extern const RawMode * const IMAGING_RAWMODE_1_8;
 extern const RawMode * const IMAGING_RAWMODE_1_I;
 extern const RawMode * const IMAGING_RAWMODE_1_IR;
 extern const RawMode * const IMAGING_RAWMODE_1_R;
 extern const RawMode * const IMAGING_RAWMODE_A;
 extern const RawMode * const IMAGING_RAWMODE_ABGR;
+extern const RawMode * const IMAGING_RAWMODE_ARGB;
+extern const RawMode * const IMAGING_RAWMODE_A_16B;
+extern const RawMode * const IMAGING_RAWMODE_A_16L;
 extern const RawMode * const IMAGING_RAWMODE_A_16N;
 extern const RawMode * const IMAGING_RAWMODE_B;
+extern const RawMode * const IMAGING_RAWMODE_BGAR;
 extern const RawMode * const IMAGING_RAWMODE_BGR;
 extern const RawMode * const IMAGING_RAWMODE_BGRA;
+extern const RawMode * const IMAGING_RAWMODE_BGRA_15;
+extern const RawMode * const IMAGING_RAWMODE_BGRA_15Z;
+extern const RawMode * const IMAGING_RAWMODE_BGRA_16B;
+extern const RawMode * const IMAGING_RAWMODE_BGRA_16L;
 extern const RawMode * const IMAGING_RAWMODE_BGRX;
+extern const RawMode * const IMAGING_RAWMODE_BGR_5;
 extern const RawMode * const IMAGING_RAWMODE_BGRa;
+extern const RawMode * const IMAGING_RAWMODE_BGXR;
+extern const RawMode * const IMAGING_RAWMODE_B_16B;
+extern const RawMode * const IMAGING_RAWMODE_B_16L;
 extern const RawMode * const IMAGING_RAWMODE_B_16N;
 extern const RawMode * const IMAGING_RAWMODE_C;
+extern const RawMode * const IMAGING_RAWMODE_CMYKX;
+extern const RawMode * const IMAGING_RAWMODE_CMYKXX;
+extern const RawMode * const IMAGING_RAWMODE_CMYK_16B;
+extern const RawMode * const IMAGING_RAWMODE_CMYK_16L;
+extern const RawMode * const IMAGING_RAWMODE_CMYK_16N;
 extern const RawMode * const IMAGING_RAWMODE_CMYK_I;
 extern const RawMode * const IMAGING_RAWMODE_CMYK_L;
+extern const RawMode * const IMAGING_RAWMODE_C_I;
 extern const RawMode * const IMAGING_RAWMODE_Cb;
 extern const RawMode * const IMAGING_RAWMODE_Cr;
+extern const RawMode * const IMAGING_RAWMODE_F_16;
+extern const RawMode * const IMAGING_RAWMODE_F_16B;
+extern const RawMode * const IMAGING_RAWMODE_F_16BS;
+extern const RawMode * const IMAGING_RAWMODE_F_16N;
+extern const RawMode * const IMAGING_RAWMODE_F_16NS;
+extern const RawMode * const IMAGING_RAWMODE_F_16S;
+extern const RawMode * const IMAGING_RAWMODE_F_32;
+extern const RawMode * const IMAGING_RAWMODE_F_32B;
+extern const RawMode * const IMAGING_RAWMODE_F_32BF;
+extern const RawMode * const IMAGING_RAWMODE_F_32BS;
 extern const RawMode * const IMAGING_RAWMODE_F_32F;
+extern const RawMode * const IMAGING_RAWMODE_F_32N;
 extern const RawMode * const IMAGING_RAWMODE_F_32NF;
+extern const RawMode * const IMAGING_RAWMODE_F_32NS;
+extern const RawMode * const IMAGING_RAWMODE_F_32S;
+extern const RawMode * const IMAGING_RAWMODE_F_64BF;
+extern const RawMode * const IMAGING_RAWMODE_F_64F;
+extern const RawMode * const IMAGING_RAWMODE_F_64NF;
+extern const RawMode * const IMAGING_RAWMODE_F_8;
+extern const RawMode * const IMAGING_RAWMODE_F_8S;
 extern const RawMode * const IMAGING_RAWMODE_G;
+extern const RawMode * const IMAGING_RAWMODE_G_16B;
+extern const RawMode * const IMAGING_RAWMODE_G_16L;
 extern const RawMode * const IMAGING_RAWMODE_G_16N;
 extern const RawMode * const IMAGING_RAWMODE_H;
+extern const RawMode * const IMAGING_RAWMODE_I_12;
+extern const RawMode * const IMAGING_RAWMODE_I_16BS;
+extern const RawMode * const IMAGING_RAWMODE_I_16NS;
+extern const RawMode * const IMAGING_RAWMODE_I_16R;
+extern const RawMode * const IMAGING_RAWMODE_I_16S;
+extern const RawMode * const IMAGING_RAWMODE_I_32;
+extern const RawMode * const IMAGING_RAWMODE_I_32BS;
+extern const RawMode * const IMAGING_RAWMODE_I_32N;
 extern const RawMode * const IMAGING_RAWMODE_I_32NS;
 extern const RawMode * const IMAGING_RAWMODE_I_32S;
+extern const RawMode * const IMAGING_RAWMODE_I_8;
+extern const RawMode * const IMAGING_RAWMODE_I_8S;
 extern const RawMode * const IMAGING_RAWMODE_K;
+extern const RawMode * const IMAGING_RAWMODE_K_I;
+extern const RawMode * const IMAGING_RAWMODE_LA_16B;
 extern const RawMode * const IMAGING_RAWMODE_LA_L;
 extern const RawMode * const IMAGING_RAWMODE_L_16;
 extern const RawMode * const IMAGING_RAWMODE_L_16B;
+extern const RawMode * const IMAGING_RAWMODE_L_2;
+extern const RawMode * const IMAGING_RAWMODE_L_2I;
+extern const RawMode * const IMAGING_RAWMODE_L_2IR;
+extern const RawMode * const IMAGING_RAWMODE_L_2R;
+extern const RawMode * const IMAGING_RAWMODE_L_4;
+extern const RawMode * const IMAGING_RAWMODE_L_4I;
+extern const RawMode * const IMAGING_RAWMODE_L_4IR;
+extern const RawMode * const IMAGING_RAWMODE_L_4R;
+extern const RawMode * const IMAGING_RAWMODE_L_I;
+extern const RawMode * const IMAGING_RAWMODE_L_R;
 extern const RawMode * const IMAGING_RAWMODE_M;
+extern const RawMode * const IMAGING_RAWMODE_M_I;
 extern const RawMode * const IMAGING_RAWMODE_PA_L;
+extern const RawMode * const IMAGING_RAWMODE_PX;
 extern const RawMode * const IMAGING_RAWMODE_P_1;
 extern const RawMode * const IMAGING_RAWMODE_P_2;
+extern const RawMode * const IMAGING_RAWMODE_P_2L;
 extern const RawMode * const IMAGING_RAWMODE_P_4;
+extern const RawMode * const IMAGING_RAWMODE_P_4L;
+extern const RawMode * const IMAGING_RAWMODE_P_R;
 extern const RawMode * const IMAGING_RAWMODE_R;
+extern const RawMode * const IMAGING_RAWMODE_RGBAX;
+extern const RawMode * const IMAGING_RAWMODE_RGBAXX;
+extern const RawMode * const IMAGING_RAWMODE_RGBA_15;
+extern const RawMode * const IMAGING_RAWMODE_RGBA_16B;
+extern const RawMode * const IMAGING_RAWMODE_RGBA_16L;
+extern const RawMode * const IMAGING_RAWMODE_RGBA_16N;
+extern const RawMode * const IMAGING_RAWMODE_RGBA_4B;
+extern const RawMode * const IMAGING_RAWMODE_RGBA_I;
 extern const RawMode * const IMAGING_RAWMODE_RGBA_L;
+extern const RawMode * const IMAGING_RAWMODE_RGBXX;
+extern const RawMode * const IMAGING_RAWMODE_RGBXXX;
+extern const RawMode * const IMAGING_RAWMODE_RGBX_16B;
+extern const RawMode * const IMAGING_RAWMODE_RGBX_16L;
+extern const RawMode * const IMAGING_RAWMODE_RGBX_16N;
 extern const RawMode * const IMAGING_RAWMODE_RGBX_L;
+extern const RawMode * const IMAGING_RAWMODE_RGB_15;
+extern const RawMode * const IMAGING_RAWMODE_RGB_16;
+extern const RawMode * const IMAGING_RAWMODE_RGB_16B;
+extern const RawMode * const IMAGING_RAWMODE_RGB_16L;
+extern const RawMode * const IMAGING_RAWMODE_RGB_16N;
+extern const RawMode * const IMAGING_RAWMODE_RGB_4B;
 extern const RawMode * const IMAGING_RAWMODE_RGB_L;
+extern const RawMode * const IMAGING_RAWMODE_RGB_R;
+extern const RawMode * const IMAGING_RAWMODE_RGBaX;
+extern const RawMode * const IMAGING_RAWMODE_RGBaXX;
+extern const RawMode * const IMAGING_RAWMODE_RGBa_16B;
+extern const RawMode * const IMAGING_RAWMODE_RGBa_16L;
+extern const RawMode * const IMAGING_RAWMODE_RGBa_16N;
+extern const RawMode * const IMAGING_RAWMODE_R_16B;
+extern const RawMode * const IMAGING_RAWMODE_R_16L;
 extern const RawMode * const IMAGING_RAWMODE_R_16N;
 extern const RawMode * const IMAGING_RAWMODE_S;
 extern const RawMode * const IMAGING_RAWMODE_V;
@@ -118,11 +211,14 @@ extern const RawMode * const IMAGING_RAWMODE_X;
 extern const RawMode * const IMAGING_RAWMODE_XBGR;
 extern const RawMode * const IMAGING_RAWMODE_XRGB;
 extern const RawMode * const IMAGING_RAWMODE_Y;
+extern const RawMode * const IMAGING_RAWMODE_YCCA_P;
 extern const RawMode * const IMAGING_RAWMODE_YCC_P;
 extern const RawMode * const IMAGING_RAWMODE_YCbCrK;
 extern const RawMode * const IMAGING_RAWMODE_YCbCrX;
 extern const RawMode * const IMAGING_RAWMODE_YCbCr_L;
+extern const RawMode * const IMAGING_RAWMODE_Y_I;
 extern const RawMode * const IMAGING_RAWMODE_aBGR;
+extern const RawMode * const IMAGING_RAWMODE_aRGB;
 
 const RawMode * findRawMode(const char * const name);
 
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 976baa72673..78760215189 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1541,9 +1541,9 @@ band316L(UINT8 *out, const UINT8 *in, int pixels) {
     }
 }
 
-static struct {
-    const char *mode;
-    const char *rawmode;
+static struct Unpacker {
+    const Mode *mode;
+    const RawMode *rawmode;
     int bits;
     ImagingShuffler unpack;
 } unpackers[] = {
@@ -1846,13 +1846,12 @@ static struct {
 };
 
 ImagingShuffler
-ImagingFindUnpacker(const char *mode, const char *rawmode, int *bits_out) {
+ImagingFindUnpacker(const Mode *mode, const RawMode *rawmode, int *bits_out) {
     int i;
 
     /* find a suitable pixel unpacker */
     for (i = 0; unpackers[i].rawmode; i++) {
-        if (strcmp(unpackers[i].mode, mode) == 0 &&
-            strcmp(unpackers[i].rawmode, rawmode) == 0) {
+        if (unpackers[i].mode == mode && unpackers[i].rawmode == rawmode) {
             if (bits_out) {
                 *bits_out = unpackers[i].bits;
             }
@@ -1864,3 +1863,317 @@ ImagingFindUnpacker(const char *mode, const char *rawmode, int *bits_out) {
 
     return NULL;
 }
+
+void
+ImagingUnpackInit(void) {
+    const struct Unpacker temp[] = {
+        /* raw mode syntax is "<mode>;<bits><flags>" where "bits" defaults
+           depending on mode (1 for "1", 8 for "P" and "L", etc), and
+           "flags" should be given in alphabetical order.  if both bits
+           and flags have their default values, the ; should be left out */
+
+        /* 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, "Z" inverted alpha */
+
+        /* exception: rawmodes "I" and "F" are always native endian byte order */
+
+        /* bilevel */
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1, 1, unpack1},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1_I, 1, unpack1I},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1_R, 1, unpack1R},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1_IR, 1, unpack1IR},
+        {IMAGING_MODE_1, IMAGING_RAWMODE_1_8, 8, unpack18},
+
+        /* grayscale */
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2, 2, unpackL2},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2I, 2, unpackL2I},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2R, 2, unpackL2R},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2IR, 2, unpackL2IR},
+
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4, 4, unpackL4},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4I, 4, unpackL4I},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4R, 4, unpackL4R},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4IR, 4, unpackL4IR},
+
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L, 8, copy1},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_I, 8, unpackLI},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_R, 8, unpackLR},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16, 16, unpackL16},
+        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16B, 16, unpackL16B},
+
+        /* grayscale w. alpha */
+        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA, 16, unpackLA},
+        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA_L, 16, unpackLAL},
+
+        /* grayscale w. alpha premultiplied */
+        {IMAGING_MODE_La, IMAGING_RAWMODE_La, 16, unpackLA},
+
+        /* palette */
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_1, 1, unpackP1},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_2, 2, unpackP2},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_2L, 2, unpackP2L},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_4, 4, unpackP4},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_4L, 4, unpackP4L},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P, 8, copy1},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_P_R, 8, unpackLR},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_L, 8, copy1},
+        {IMAGING_MODE_P, IMAGING_RAWMODE_PX, 16, unpackL16B},
+
+        /* palette w. alpha */
+        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA, 16, unpackLA},
+        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA_L, 16, unpackLAL},
+        {IMAGING_MODE_PA, IMAGING_RAWMODE_LA, 16, unpackLA},
+
+        /* true colour */
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB, 24, ImagingUnpackRGB},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_L, 24, unpackRGBL},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_R, 24, unpackRGBR},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16L, 48, unpackRGB16L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16B, 48, unpackRGB16B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR, 24, ImagingUnpackBGR},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_15, 16, ImagingUnpackRGB15},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_15, 16, ImagingUnpackBGR15},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16, 16, ImagingUnpackRGB16},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_16, 16, ImagingUnpackBGR16},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16L, 64, unpackRGBA16L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16B, 64, unpackRGBA16B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_4B, 16, ImagingUnpackRGB4B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_5, 16, ImagingUnpackBGR15}, /* compat */
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX, 32, copy4},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_L, 32, unpackRGBAL},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBXX, 40, copy4skip1},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBXXX, 48, copy4skip2},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA_L, 32, unpackRGBAL},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA_15, 16, ImagingUnpackRGBA15},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGRX, 32, ImagingUnpackBGRX},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGXR, 32, ImagingUnpackBGXR},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XRGB, 32, ImagingUnpackXRGB},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XBGR, 32, ImagingUnpackXBGR},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_YCC_P, 24, ImagingUnpackYCC},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R, 8, band0},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G, 8, band1},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B, 8, band2},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16L, 16, band016L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16L, 16, band116L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16L, 16, band216L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16B, 16, band016B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16B, 16, band116B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16B, 16, band216B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_CMYK, 32, cmyk2rgb},
+
+        {IMAGING_MODE_BGR_15, IMAGING_RAWMODE_BGR_15, 16, copy2},
+        {IMAGING_MODE_BGR_16, IMAGING_RAWMODE_BGR_16, 16, copy2},
+        {IMAGING_MODE_BGR_24, IMAGING_RAWMODE_BGR_24, 24, copy3},
+
+        /* true colour w. alpha */
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_LA, 16, unpackRGBALA},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_LA_16B, 32, unpackRGBALA16B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA, 32, copy4},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBAX, 40, copy4skip1},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBAXX, 48, copy4skip2},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa, 32, unpackRGBa},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBaX, 40, unpackRGBaskip1},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBaXX, 48, unpackRGBaskip2},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16L, 64, unpackRGBa16L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16B, 64, unpackRGBa16B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRa, 32, unpackBGRa},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_I, 32, unpackRGBAI},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_L, 32, unpackRGBAL},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_15, 16, ImagingUnpackRGBA15},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_15, 16, ImagingUnpackBGRA15},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_15Z, 16, ImagingUnpackBGRA15Z},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_4B, 16, ImagingUnpackRGBA4B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16L, 64, unpackRGBA16L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16B, 64, unpackRGBA16B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA, 32, unpackBGRA},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_16L, 64, unpackBGRA16L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_16B, 64, unpackBGRA16B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGAR, 32, unpackBGAR},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ARGB, 32, unpackARGB},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ABGR, 32, unpackABGR},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_YCCA_P, 32, ImagingUnpackYCCA},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R, 8, band0},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G, 8, band1},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B, 8, band2},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A, 8, band3},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16L, 16, band016L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16L, 16, band116L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16L, 16, band216L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16L, 16, band316L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16B, 16, band016B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16B, 16, band116B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16B, 16, band216B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16B, 16, band316B},
+
+#ifdef WORDS_BIGENDIAN
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16N, 48, unpackRGB16B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16N, 64, unpackRGBa16B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16N, 64, unpackRGBA16B},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16N, 16, band016B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16N, 16, band116B},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16N, 16, band216B},
+
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16N, 16, band016B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16N, 16, band116B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16N, 16, band216B},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16N, 16, band316B},
+#else
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16N, 48, unpackRGB16L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16N, 64, unpackRGBa16L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16N, 64, unpackRGBA16L},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16N, 16, band016L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16N, 16, band116L},
+        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16N, 16, band216L},
+
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16N, 16, band016L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16N, 16, band116L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16N, 16, band216L},
+        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16N, 16, band316L},
+#endif
+
+        /* true colour w. alpha premultiplied */
+        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_RGBa, 32, copy4},
+        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_BGRa, 32, unpackBGRA},
+        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aRGB, 32, unpackARGB},
+        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aBGR, 32, unpackABGR},
+
+        /* true colour w. padding */
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB, 24, ImagingUnpackRGB},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_L, 24, unpackRGBL},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_16B, 48, unpackRGB16B},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR, 24, ImagingUnpackBGR},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_15, 16, ImagingUnpackRGB15},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR_15, 16, ImagingUnpackBGR15},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_4B, 16, ImagingUnpackRGB4B},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR_5, 16, ImagingUnpackBGR15}, /* compat */
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX, 32, copy4},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBXX, 40, copy4skip1},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBXXX, 48, copy4skip2},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_L, 32, unpackRGBAL},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16L, 64, unpackRGBA16L},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16B, 64, unpackRGBA16B},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGRX, 32, ImagingUnpackBGRX},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XRGB, 32, ImagingUnpackXRGB},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XBGR, 32, ImagingUnpackXBGR},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_YCC_P, 24, ImagingUnpackYCC},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_R, 8, band0},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_G, 8, band1},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_B, 8, band2},
+        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_X, 8, band3},
+
+        /* colour separation */
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK, 32, copy4},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYKX, 40, copy4skip1},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYKXX, 48, copy4skip2},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_I, 32, unpackCMYKI},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_L, 32, unpackRGBAL},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16L, 64, unpackRGBA16L},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16B, 64, unpackRGBA16B},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C, 8, band0},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M, 8, band1},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y, 8, band2},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K, 8, band3},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C_I, 8, band0I},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M_I, 8, band1I},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y_I, 8, band2I},
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K_I, 8, band3I},
+
+#ifdef WORDS_BIGENDIAN
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16N, 64, unpackRGBA16B},
+#else
+        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16N, 64, unpackRGBA16L},
+#endif
+
+        /* video (YCbCr) */
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr, 24, ImagingUnpackRGB},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr_L, 24, unpackRGBL},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrX, 32, copy4},
+        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrK, 32, copy4},
+
+        /* LAB Color */
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_LAB, 24, ImagingUnpackLAB},
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_L, 8, band0},
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_A, 8, band1},
+        {IMAGING_MODE_LAB, IMAGING_RAWMODE_B, 8, band2},
+
+        /* HSV Color */
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_HSV, 24, ImagingUnpackRGB},
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_H, 8, band0},
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_S, 8, band1},
+        {IMAGING_MODE_HSV, IMAGING_RAWMODE_V, 8, band2},
+
+        /* integer variations */
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I, 32, copy4},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_8, 8, unpackI8},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_8S, 8, unpackI8S},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16, 16, unpackI16},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16S, 16, unpackI16S},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16B, 16, unpackI16B},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16BS, 16, unpackI16BS},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16N, 16, unpackI16N},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16NS, 16, unpackI16NS},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32, 32, unpackI32},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32S, 32, unpackI32S},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32B, 32, unpackI32B},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32BS, 32, unpackI32BS},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32N, 32, unpackI32N},
+        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32NS, 32, unpackI32NS},
+
+        /* floating point variations */
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F, 32, copy4},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_8, 8, unpackF8},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_8S, 8, unpackF8S},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16, 16, unpackF16},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16S, 16, unpackF16S},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16B, 16, unpackF16B},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16BS, 16, unpackF16BS},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16N, 16, unpackF16N},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16NS, 16, unpackF16NS},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32, 32, unpackF32},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32S, 32, unpackF32S},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32B, 32, unpackF32B},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32BS, 32, unpackF32BS},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32N, 32, unpackF32N},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NS, 32, unpackF32NS},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32F, 32, unpackF32F},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32BF, 32, unpackF32BF},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NF, 32, unpackF32NF},
+#ifdef FLOAT64
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_64F, 64, unpackF64F},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_64BF, 64, unpackF64BF},
+        {IMAGING_MODE_F, IMAGING_RAWMODE_F_64NF, 64, unpackF64NF},
+#endif
+
+        /* storage modes */
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16, 16, copy2},
+        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
+        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
+        {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
+
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, unpackI16B_I16},
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16}, // LibTiff native->image endian.
+        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16}, // LibTiff native->image endian.
+        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16B},
+
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16R, 16, unpackI16R_I16},
+
+        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_12, 12, unpackI12_I16}, // 12 bit Tiffs stored in 16bits.
+
+        {NULL} /* sentinel */
+    };
+    unpackers = malloc(sizeof(temp));
+    if (unpackers == NULL) {
+        fprintf(stderr, "UnpackInit: failed to allocate memory for unpackers table\n");
+        exit(1);
+    }
+    memcpy(unpackers, temp, sizeof(temp));
+}
+
+void
+ImagingUnpackFree(void) {
+    free(unpackers);
+    unpackers = NULL;
+}

From feb7e6ef2d269bf481ee070ceebb0a00f7f9123d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 12:59:17 -0500
Subject: [PATCH 1929/2374] use mode structs in map.c

---
 src/map.c | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/map.c b/src/map.c
index f4933e45e93..451cca58973 100644
--- a/src/map.c
+++ b/src/map.c
@@ -55,7 +55,7 @@ PyImaging_MapBuffer(PyObject *self, PyObject *args) {
 
     PyObject *target;
     Py_buffer view;
-    char *mode;
+    char *mode_name;
     char *codec;
     Py_ssize_t offset;
     int xsize, ysize;
@@ -70,7 +70,7 @@ PyImaging_MapBuffer(PyObject *self, PyObject *args) {
             &ysize,
             &codec,
             &offset,
-            &mode,
+            &mode_name,
             &stride,
             &ystep
         )) {
@@ -82,8 +82,10 @@ PyImaging_MapBuffer(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
+
     if (stride <= 0) {
-        if (!strcmp(mode, "L") || !strcmp(mode, "P")) {
+        if (mode == IMAGING_MODE_L || mode == IMAGING_MODE_P) {
             stride = xsize;
         } else if (isModeI16(mode)) {
             stride = xsize * 2;

From c9c50ac678ca88da18c8b2695380065fdd637533 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 16:00:26 +0200
Subject: [PATCH 1930/2374] initialize accessors similar to
 converters/packers/unpackers

---
 src/libImaging/Access.c | 90 +++++++++++++++++------------------------
 1 file changed, 38 insertions(+), 52 deletions(-)

diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 95586d7edb7..59a776fe04e 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -11,10 +11,6 @@
 
 #include "Imaging.h"
 
-#define ACCESS_TABLE_SIZE 24
-static struct ImagingAccessInstance ACCESS_TABLE[ACCESS_TABLE_SIZE];
-
-
 /* fetch individual pixel */
 
 static void
@@ -120,66 +116,53 @@ put_pixel_32(Imaging im, int x, int y, const void *color) {
     memcpy(&im->image32[y][x], color, sizeof(INT32));
 }
 
-
-static void
-set_access_table_item(
-    const int index,
-    const Mode * const mode,
-    void (*get_pixel)(Imaging im, int x, int y, void *pixel),
-    void (*put_pixel)(Imaging im, int x, int y, const void *pixel)
-) {
-    ACCESS_TABLE[index].mode = mode;
-    ACCESS_TABLE[index].get_pixel = get_pixel;
-    ACCESS_TABLE[index].put_pixel = put_pixel;
-}
+static struct ImagingAccessInstance *accessors = NULL;
 
 void
 ImagingAccessInit(void) {
-    int i = 0;
-    set_access_table_item(i++, IMAGING_MODE_1, get_pixel_8, put_pixel_8);
-    set_access_table_item(i++, IMAGING_MODE_L, get_pixel_8, put_pixel_8);
-    set_access_table_item(i++, IMAGING_MODE_LA, get_pixel_32_2bands, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_La, get_pixel_32_2bands, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_I, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_I_16, get_pixel_16L, put_pixel_16L);
-    set_access_table_item(i++, IMAGING_MODE_I_16L, get_pixel_16L, put_pixel_16L);
-    set_access_table_item(i++, IMAGING_MODE_I_16B, get_pixel_16B, put_pixel_16B);
+    const struct ImagingAccessInstance temp[] = {
+        {IMAGING_MODE_1, get_pixel_8, put_pixel_8},
+        {IMAGING_MODE_L, get_pixel_8, put_pixel_8},
+        {IMAGING_MODE_LA, get_pixel_32_2bands, put_pixel_32},
+        {IMAGING_MODE_La, get_pixel_32_2bands, put_pixel_32},
+        {IMAGING_MODE_I, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_I_16, get_pixel_16L, put_pixel_16L},
+        {IMAGING_MODE_I_16L, get_pixel_16L, put_pixel_16L},
+        {IMAGING_MODE_I_16B, get_pixel_16B, put_pixel_16B},
 #ifdef WORDS_BIGENDIAN
-    set_access_table_item(i++, IMAGING_MODE_I_16N, get_pixel_16B, put_pixel_16B);
+        {IMAGING_MODE_I_16N, get_pixel_16B, put_pixel_16B},
 #else
-    set_access_table_item(i++, IMAGING_MODE_I_16N, get_pixel_16L, put_pixel_16L);
+        {IMAGING_MODE_I_16N, get_pixel_16L, put_pixel_16L},
 #endif
-    set_access_table_item(i++, IMAGING_MODE_I_32L, get_pixel_32L, put_pixel_32L);
-    set_access_table_item(i++, IMAGING_MODE_I_32B, get_pixel_32B, put_pixel_32B);
-    set_access_table_item(i++, IMAGING_MODE_F, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_P, get_pixel_8, put_pixel_8);
-    set_access_table_item(i++, IMAGING_MODE_PA, get_pixel_32_2bands, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_RGB, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_RGBA, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_RGBa, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_RGBX, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_CMYK, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_YCbCr, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_LAB, get_pixel_32, put_pixel_32);
-    set_access_table_item(i++, IMAGING_MODE_HSV, get_pixel_32, put_pixel_32);
-
-
-    if (i != ACCESS_TABLE_SIZE) {
-        fprintf(
-            stderr,
-            "AccessInit: incorrect number of items added to ACCESS_TABLE; expected %i but got %i\n",
-            ACCESS_TABLE_SIZE,
-            i);
+        {IMAGING_MODE_I_32L, get_pixel_32L, put_pixel_32L},
+        {IMAGING_MODE_I_32B, get_pixel_32B, put_pixel_32B},
+        {IMAGING_MODE_F, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_P, get_pixel_8, put_pixel_8},
+        {IMAGING_MODE_PA, get_pixel_32_2bands, put_pixel_32},
+        {IMAGING_MODE_RGB, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_RGBA, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_RGBa, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_RGBX, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_CMYK, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_YCbCr, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_LAB, get_pixel_32, put_pixel_32},
+        {IMAGING_MODE_HSV, get_pixel_32, put_pixel_32},
+        {NULL}
+    };
+    accessors = malloc(sizeof(temp));
+    if (accessors == NULL) {
+        fprintf(stderr, "AccessInit: failed to allocate memory for accessors table\n");
         exit(1);
     }
+    memcpy(accessors, temp, sizeof(temp));
 }
 
 ImagingAccess
 ImagingAccessNew(const Imaging im) {
     int i;
-    for (i = 0; i < ACCESS_TABLE_SIZE; i++) {
-        if (im->mode == ACCESS_TABLE[i].mode) {
-            return &ACCESS_TABLE[i];
+    for (i = 0; accessors[i].mode; i++) {
+        if (im->mode == accessors[i].mode) {
+            return &accessors[i];
         }
     }
     return NULL;
@@ -189,4 +172,7 @@ void
 _ImagingAccessDelete(Imaging im, ImagingAccess access) {}
 
 void
-ImagingAccessFree(void) {}
+ImagingAccessFree(void) {
+    free(accessors);
+    accessors = NULL;
+}

From cacb8b3ce70e73dd0b0f338410510cfbbd22709d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 14:01:53 -0500
Subject: [PATCH 1931/2374] define rawmodes

---
 src/libImaging/Mode.c | 292 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 292 insertions(+)

diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index a11b65905e8..8d651b06dba 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -109,6 +109,152 @@ ALIAS_MODE_AS_RAWMODE(I_16N)
 ALIAS_MODE_AS_RAWMODE(I_32L)
 ALIAS_MODE_AS_RAWMODE(I_32B)
 
+CREATE_MODE(RawMode, RAWMODE_1_8, {"1;8"})
+CREATE_MODE(RawMode, RAWMODE_1_I, {"1;I"})
+CREATE_MODE(RawMode, RAWMODE_1_IR, {"1;IR"})
+CREATE_MODE(RawMode, RAWMODE_1_R, {"1;R"})
+CREATE_MODE(RawMode, RAWMODE_A, {"A"})
+CREATE_MODE(RawMode, RAWMODE_ABGR, {"ABGR"})
+CREATE_MODE(RawMode, RAWMODE_ARGB, {"ARGB"})
+CREATE_MODE(RawMode, RAWMODE_A_16B, {"A;16B"})
+CREATE_MODE(RawMode, RAWMODE_A_16L, {"A;16L"})
+CREATE_MODE(RawMode, RAWMODE_A_16N, {"A;16N"})
+CREATE_MODE(RawMode, RAWMODE_B, {"B"})
+CREATE_MODE(RawMode, RAWMODE_BGAR, {"BGAR"})
+CREATE_MODE(RawMode, RAWMODE_BGR, {"BGR"})
+CREATE_MODE(RawMode, RAWMODE_BGRA, {"BGRA"})
+CREATE_MODE(RawMode, RAWMODE_BGRA_15, {"BGRA;15"})
+CREATE_MODE(RawMode, RAWMODE_BGRA_15Z, {"BGRA;15Z"})
+CREATE_MODE(RawMode, RAWMODE_BGRA_16B, {"BGRA;16B"})
+CREATE_MODE(RawMode, RAWMODE_BGRA_16L, {"BGRA;16L"})
+CREATE_MODE(RawMode, RAWMODE_BGRX, {"BGRX"})
+CREATE_MODE(RawMode, RAWMODE_BGR_5, {"BGR;5"})
+CREATE_MODE(RawMode, RAWMODE_BGRa, {"BGRa"})
+CREATE_MODE(RawMode, RAWMODE_BGXR, {"BGXR"})
+CREATE_MODE(RawMode, RAWMODE_B_16B, {"B;16B"})
+CREATE_MODE(RawMode, RAWMODE_B_16L, {"B;16L"})
+CREATE_MODE(RawMode, RAWMODE_B_16N, {"B;16N"})
+CREATE_MODE(RawMode, RAWMODE_C, {"C"})
+CREATE_MODE(RawMode, RAWMODE_CMYKX, {"CMYKX"})
+CREATE_MODE(RawMode, RAWMODE_CMYKXX, {"CMYKXX"})
+CREATE_MODE(RawMode, RAWMODE_CMYK_16B, {"CMYK;16B"})
+CREATE_MODE(RawMode, RAWMODE_CMYK_16L, {"CMYK;16L"})
+CREATE_MODE(RawMode, RAWMODE_CMYK_16N, {"CMYK;16N"})
+CREATE_MODE(RawMode, RAWMODE_CMYK_I, {"CMYK;I"})
+CREATE_MODE(RawMode, RAWMODE_CMYK_L, {"CMYK;L"})
+CREATE_MODE(RawMode, RAWMODE_C_I, {"C;I"})
+CREATE_MODE(RawMode, RAWMODE_Cb, {"Cb"})
+CREATE_MODE(RawMode, RAWMODE_Cr, {"Cr"})
+CREATE_MODE(RawMode, RAWMODE_F_16, {"F;16"})
+CREATE_MODE(RawMode, RAWMODE_F_16B, {"F;16B"})
+CREATE_MODE(RawMode, RAWMODE_F_16BS, {"F;16BS"})
+CREATE_MODE(RawMode, RAWMODE_F_16N, {"F;16N"})
+CREATE_MODE(RawMode, RAWMODE_F_16NS, {"F;16NS"})
+CREATE_MODE(RawMode, RAWMODE_F_16S, {"F;16S"})
+CREATE_MODE(RawMode, RAWMODE_F_32, {"F;32"})
+CREATE_MODE(RawMode, RAWMODE_F_32B, {"F;32B"})
+CREATE_MODE(RawMode, RAWMODE_F_32BF, {"F;32BF"})
+CREATE_MODE(RawMode, RAWMODE_F_32BS, {"F;32BS"})
+CREATE_MODE(RawMode, RAWMODE_F_32F, {"F;32F"})
+CREATE_MODE(RawMode, RAWMODE_F_32N, {"F;32N"})
+CREATE_MODE(RawMode, RAWMODE_F_32NF, {"F;32NF"})
+CREATE_MODE(RawMode, RAWMODE_F_32NS, {"F;32NS"})
+CREATE_MODE(RawMode, RAWMODE_F_32S, {"F;32S"})
+CREATE_MODE(RawMode, RAWMODE_F_64BF, {"F;64BF"})
+CREATE_MODE(RawMode, RAWMODE_F_64F, {"F;64F"})
+CREATE_MODE(RawMode, RAWMODE_F_64NF, {"F;64NF"})
+CREATE_MODE(RawMode, RAWMODE_F_8, {"F;8"})
+CREATE_MODE(RawMode, RAWMODE_F_8S, {"F;8S"})
+CREATE_MODE(RawMode, RAWMODE_G, {"G"})
+CREATE_MODE(RawMode, RAWMODE_G_16B, {"G;16B"})
+CREATE_MODE(RawMode, RAWMODE_G_16L, {"G;16L"})
+CREATE_MODE(RawMode, RAWMODE_G_16N, {"G;16N"})
+CREATE_MODE(RawMode, RAWMODE_H, {"H"})
+CREATE_MODE(RawMode, RAWMODE_I_12, {"I;12"})
+CREATE_MODE(RawMode, RAWMODE_I_16BS, {"I;16BS"})
+CREATE_MODE(RawMode, RAWMODE_I_16NS, {"I;16NS"})
+CREATE_MODE(RawMode, RAWMODE_I_16R, {"I;16R"})
+CREATE_MODE(RawMode, RAWMODE_I_16S, {"I;16S"})
+CREATE_MODE(RawMode, RAWMODE_I_32, {"I;32"})
+CREATE_MODE(RawMode, RAWMODE_I_32BS, {"I;32BS"})
+CREATE_MODE(RawMode, RAWMODE_I_32N, {"I;32N"})
+CREATE_MODE(RawMode, RAWMODE_I_32NS, {"I;32NS"})
+CREATE_MODE(RawMode, RAWMODE_I_32S, {"I;32S"})
+CREATE_MODE(RawMode, RAWMODE_I_8, {"I;8"})
+CREATE_MODE(RawMode, RAWMODE_I_8S, {"I;8S"})
+CREATE_MODE(RawMode, RAWMODE_K, {"K"})
+CREATE_MODE(RawMode, RAWMODE_K_I, {"K;I"})
+CREATE_MODE(RawMode, RAWMODE_LA_16B, {"LA;16B"})
+CREATE_MODE(RawMode, RAWMODE_LA_L, {"LA;L"})
+CREATE_MODE(RawMode, RAWMODE_L_16, {"L;16"})
+CREATE_MODE(RawMode, RAWMODE_L_16B, {"L;16B"})
+CREATE_MODE(RawMode, RAWMODE_L_2, {"L;2"})
+CREATE_MODE(RawMode, RAWMODE_L_2I, {"L;2I"})
+CREATE_MODE(RawMode, RAWMODE_L_2IR, {"L;2IR"})
+CREATE_MODE(RawMode, RAWMODE_L_2R, {"L;2R"})
+CREATE_MODE(RawMode, RAWMODE_L_4, {"L;4"})
+CREATE_MODE(RawMode, RAWMODE_L_4I, {"L;4I"})
+CREATE_MODE(RawMode, RAWMODE_L_4IR, {"L;4IR"})
+CREATE_MODE(RawMode, RAWMODE_L_4R, {"L;4R"})
+CREATE_MODE(RawMode, RAWMODE_L_I, {"L;I"})
+CREATE_MODE(RawMode, RAWMODE_L_R, {"L;R"})
+CREATE_MODE(RawMode, RAWMODE_M, {"M"})
+CREATE_MODE(RawMode, RAWMODE_M_I, {"M;I"})
+CREATE_MODE(RawMode, RAWMODE_PA_L, {"PA;L"})
+CREATE_MODE(RawMode, RAWMODE_PX, {"PX"})
+CREATE_MODE(RawMode, RAWMODE_P_1, {"P;1"})
+CREATE_MODE(RawMode, RAWMODE_P_2, {"P;2"})
+CREATE_MODE(RawMode, RAWMODE_P_2L, {"P;2L"})
+CREATE_MODE(RawMode, RAWMODE_P_4, {"P;4"})
+CREATE_MODE(RawMode, RAWMODE_P_4L, {"P;4L"})
+CREATE_MODE(RawMode, RAWMODE_P_R, {"P;R"})
+CREATE_MODE(RawMode, RAWMODE_R, {"R"})
+CREATE_MODE(RawMode, RAWMODE_RGBAX, {"RGBAX"})
+CREATE_MODE(RawMode, RAWMODE_RGBAXX, {"RGBAXX"})
+CREATE_MODE(RawMode, RAWMODE_RGBA_15, {"RGBA;15"})
+CREATE_MODE(RawMode, RAWMODE_RGBA_16B, {"RGBA;16B"})
+CREATE_MODE(RawMode, RAWMODE_RGBA_16L, {"RGBA;16L"})
+CREATE_MODE(RawMode, RAWMODE_RGBA_16N, {"RGBA;16N"})
+CREATE_MODE(RawMode, RAWMODE_RGBA_4B, {"RGBA;4B"})
+CREATE_MODE(RawMode, RAWMODE_RGBA_I, {"RGBA;I"})
+CREATE_MODE(RawMode, RAWMODE_RGBA_L, {"RGBA;L"})
+CREATE_MODE(RawMode, RAWMODE_RGBXX, {"RGBXX"})
+CREATE_MODE(RawMode, RAWMODE_RGBXXX, {"RGBXXX"})
+CREATE_MODE(RawMode, RAWMODE_RGBX_16B, {"RGBX;16B"})
+CREATE_MODE(RawMode, RAWMODE_RGBX_16L, {"RGBX;16L"})
+CREATE_MODE(RawMode, RAWMODE_RGBX_16N, {"RGBX;16N"})
+CREATE_MODE(RawMode, RAWMODE_RGBX_L, {"RGBX;L"})
+CREATE_MODE(RawMode, RAWMODE_RGB_15, {"RGB;15"})
+CREATE_MODE(RawMode, RAWMODE_RGB_16, {"RGB;16"})
+CREATE_MODE(RawMode, RAWMODE_RGB_16B, {"RGB;16B"})
+CREATE_MODE(RawMode, RAWMODE_RGB_16L, {"RGB;16L"})
+CREATE_MODE(RawMode, RAWMODE_RGB_16N, {"RGB;16N"})
+CREATE_MODE(RawMode, RAWMODE_RGB_4B, {"RGB;4B"})
+CREATE_MODE(RawMode, RAWMODE_RGB_L, {"RGB;L"})
+CREATE_MODE(RawMode, RAWMODE_RGB_R, {"RGB;R"})
+CREATE_MODE(RawMode, RAWMODE_RGBaX, {"RGBaX"})
+CREATE_MODE(RawMode, RAWMODE_RGBaXX, {"RGBaXX"})
+CREATE_MODE(RawMode, RAWMODE_RGBa_16B, {"RGBa;16B"})
+CREATE_MODE(RawMode, RAWMODE_RGBa_16L, {"RGBa;16L"})
+CREATE_MODE(RawMode, RAWMODE_RGBa_16N, {"RGBa;16N"})
+CREATE_MODE(RawMode, RAWMODE_R_16B, {"R;16B"})
+CREATE_MODE(RawMode, RAWMODE_R_16L, {"R;16L"})
+CREATE_MODE(RawMode, RAWMODE_R_16N, {"R;16N"})
+CREATE_MODE(RawMode, RAWMODE_S, {"S"})
+CREATE_MODE(RawMode, RAWMODE_V, {"V"})
+CREATE_MODE(RawMode, RAWMODE_X, {"X"})
+CREATE_MODE(RawMode, RAWMODE_XBGR, {"XBGR"})
+CREATE_MODE(RawMode, RAWMODE_XRGB, {"XRGB"})
+CREATE_MODE(RawMode, RAWMODE_Y, {"Y"})
+CREATE_MODE(RawMode, RAWMODE_YCCA_P, {"YCCA;P"})
+CREATE_MODE(RawMode, RAWMODE_YCC_P, {"YCC;P"})
+CREATE_MODE(RawMode, RAWMODE_YCbCrK, {"YCbCrK"})
+CREATE_MODE(RawMode, RAWMODE_YCbCrX, {"YCbCrX"})
+CREATE_MODE(RawMode, RAWMODE_YCbCr_L, {"YCbCr;L"})
+CREATE_MODE(RawMode, RAWMODE_Y_I, {"Y;I"})
+CREATE_MODE(RawMode, RAWMODE_aBGR, {"aBGR"})
+CREATE_MODE(RawMode, RAWMODE_aRGB, {"aRGB"})
+
 const RawMode * const RAWMODES[] = {
     IMAGING_RAWMODE_1,
     IMAGING_RAWMODE_CMYK,
@@ -138,6 +284,152 @@ const RawMode * const RAWMODES[] = {
     IMAGING_RAWMODE_I_32L,
     IMAGING_RAWMODE_I_32B,
 
+    IMAGING_RAWMODE_1_8,
+    IMAGING_RAWMODE_1_I,
+    IMAGING_RAWMODE_1_IR,
+    IMAGING_RAWMODE_1_R,
+    IMAGING_RAWMODE_A,
+    IMAGING_RAWMODE_ABGR,
+    IMAGING_RAWMODE_ARGB,
+    IMAGING_RAWMODE_A_16B,
+    IMAGING_RAWMODE_A_16L,
+    IMAGING_RAWMODE_A_16N,
+    IMAGING_RAWMODE_B,
+    IMAGING_RAWMODE_BGAR,
+    IMAGING_RAWMODE_BGR,
+    IMAGING_RAWMODE_BGRA,
+    IMAGING_RAWMODE_BGRA_15,
+    IMAGING_RAWMODE_BGRA_15Z,
+    IMAGING_RAWMODE_BGRA_16B,
+    IMAGING_RAWMODE_BGRA_16L,
+    IMAGING_RAWMODE_BGRX,
+    IMAGING_RAWMODE_BGR_5,
+    IMAGING_RAWMODE_BGRa,
+    IMAGING_RAWMODE_BGXR,
+    IMAGING_RAWMODE_B_16B,
+    IMAGING_RAWMODE_B_16L,
+    IMAGING_RAWMODE_B_16N,
+    IMAGING_RAWMODE_C,
+    IMAGING_RAWMODE_CMYKX,
+    IMAGING_RAWMODE_CMYKXX,
+    IMAGING_RAWMODE_CMYK_16B,
+    IMAGING_RAWMODE_CMYK_16L,
+    IMAGING_RAWMODE_CMYK_16N,
+    IMAGING_RAWMODE_CMYK_I,
+    IMAGING_RAWMODE_CMYK_L,
+    IMAGING_RAWMODE_C_I,
+    IMAGING_RAWMODE_Cb,
+    IMAGING_RAWMODE_Cr,
+    IMAGING_RAWMODE_F_16,
+    IMAGING_RAWMODE_F_16B,
+    IMAGING_RAWMODE_F_16BS,
+    IMAGING_RAWMODE_F_16N,
+    IMAGING_RAWMODE_F_16NS,
+    IMAGING_RAWMODE_F_16S,
+    IMAGING_RAWMODE_F_32,
+    IMAGING_RAWMODE_F_32B,
+    IMAGING_RAWMODE_F_32BF,
+    IMAGING_RAWMODE_F_32BS,
+    IMAGING_RAWMODE_F_32F,
+    IMAGING_RAWMODE_F_32N,
+    IMAGING_RAWMODE_F_32NF,
+    IMAGING_RAWMODE_F_32NS,
+    IMAGING_RAWMODE_F_32S,
+    IMAGING_RAWMODE_F_64BF,
+    IMAGING_RAWMODE_F_64F,
+    IMAGING_RAWMODE_F_64NF,
+    IMAGING_RAWMODE_F_8,
+    IMAGING_RAWMODE_F_8S,
+    IMAGING_RAWMODE_G,
+    IMAGING_RAWMODE_G_16B,
+    IMAGING_RAWMODE_G_16L,
+    IMAGING_RAWMODE_G_16N,
+    IMAGING_RAWMODE_H,
+    IMAGING_RAWMODE_I_12,
+    IMAGING_RAWMODE_I_16BS,
+    IMAGING_RAWMODE_I_16NS,
+    IMAGING_RAWMODE_I_16R,
+    IMAGING_RAWMODE_I_16S,
+    IMAGING_RAWMODE_I_32,
+    IMAGING_RAWMODE_I_32BS,
+    IMAGING_RAWMODE_I_32N,
+    IMAGING_RAWMODE_I_32NS,
+    IMAGING_RAWMODE_I_32S,
+    IMAGING_RAWMODE_I_8,
+    IMAGING_RAWMODE_I_8S,
+    IMAGING_RAWMODE_K,
+    IMAGING_RAWMODE_K_I,
+    IMAGING_RAWMODE_LA_16B,
+    IMAGING_RAWMODE_LA_L,
+    IMAGING_RAWMODE_L_16,
+    IMAGING_RAWMODE_L_16B,
+    IMAGING_RAWMODE_L_2,
+    IMAGING_RAWMODE_L_2I,
+    IMAGING_RAWMODE_L_2IR,
+    IMAGING_RAWMODE_L_2R,
+    IMAGING_RAWMODE_L_4,
+    IMAGING_RAWMODE_L_4I,
+    IMAGING_RAWMODE_L_4IR,
+    IMAGING_RAWMODE_L_4R,
+    IMAGING_RAWMODE_L_I,
+    IMAGING_RAWMODE_L_R,
+    IMAGING_RAWMODE_M,
+    IMAGING_RAWMODE_M_I,
+    IMAGING_RAWMODE_PA_L,
+    IMAGING_RAWMODE_PX,
+    IMAGING_RAWMODE_P_1,
+    IMAGING_RAWMODE_P_2,
+    IMAGING_RAWMODE_P_2L,
+    IMAGING_RAWMODE_P_4,
+    IMAGING_RAWMODE_P_4L,
+    IMAGING_RAWMODE_P_R,
+    IMAGING_RAWMODE_R,
+    IMAGING_RAWMODE_RGBAX,
+    IMAGING_RAWMODE_RGBAXX,
+    IMAGING_RAWMODE_RGBA_15,
+    IMAGING_RAWMODE_RGBA_16B,
+    IMAGING_RAWMODE_RGBA_16L,
+    IMAGING_RAWMODE_RGBA_16N,
+    IMAGING_RAWMODE_RGBA_4B,
+    IMAGING_RAWMODE_RGBA_I,
+    IMAGING_RAWMODE_RGBA_L,
+    IMAGING_RAWMODE_RGBXX,
+    IMAGING_RAWMODE_RGBXXX,
+    IMAGING_RAWMODE_RGBX_16B,
+    IMAGING_RAWMODE_RGBX_16L,
+    IMAGING_RAWMODE_RGBX_16N,
+    IMAGING_RAWMODE_RGBX_L,
+    IMAGING_RAWMODE_RGB_15,
+    IMAGING_RAWMODE_RGB_16,
+    IMAGING_RAWMODE_RGB_16B,
+    IMAGING_RAWMODE_RGB_16L,
+    IMAGING_RAWMODE_RGB_16N,
+    IMAGING_RAWMODE_RGB_4B,
+    IMAGING_RAWMODE_RGB_L,
+    IMAGING_RAWMODE_RGB_R,
+    IMAGING_RAWMODE_RGBaX,
+    IMAGING_RAWMODE_RGBaXX,
+    IMAGING_RAWMODE_RGBa_16B,
+    IMAGING_RAWMODE_RGBa_16L,
+    IMAGING_RAWMODE_RGBa_16N,
+    IMAGING_RAWMODE_R_16B,
+    IMAGING_RAWMODE_R_16L,
+    IMAGING_RAWMODE_R_16N,
+    IMAGING_RAWMODE_S,
+    IMAGING_RAWMODE_V,
+    IMAGING_RAWMODE_X,
+    IMAGING_RAWMODE_XBGR,
+    IMAGING_RAWMODE_XRGB,
+    IMAGING_RAWMODE_Y,
+    IMAGING_RAWMODE_YCCA_P,
+    IMAGING_RAWMODE_YCC_P,
+    IMAGING_RAWMODE_YCbCrK,
+    IMAGING_RAWMODE_YCbCrX,
+    IMAGING_RAWMODE_YCbCr_L,
+    IMAGING_RAWMODE_Y_I,
+    IMAGING_RAWMODE_aBGR,
+    IMAGING_RAWMODE_aRGB,
+
     NULL
 };
 

From 20a5aeac84ea29a41699337f3e16acd1a667e85f Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 15:25:40 -0500
Subject: [PATCH 1932/2374] fix findRawMode() and change findMode() to match

---
 src/libImaging/Mode.c | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 8d651b06dba..04e843d3277 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -68,10 +68,9 @@ const Mode * const MODES[] = {
 };
 
 const Mode * findMode(const char * const name) {
-    int i = 0;
     const Mode * mode;
-    while ((mode = MODES[i++]) != NULL) {
-        if (!strcmp(mode->name, name)) {
+    for (int i = 0; (mode = MODES[i]); i++) {
+        if (strcmp(mode->name, name) == 0) {
             return mode;
         }
     }
@@ -434,11 +433,9 @@ const RawMode * const RAWMODES[] = {
 };
 
 const RawMode * findRawMode(const char * const name) {
-    int i = 0;
     const RawMode * rawmode;
-    while ((rawmode = RAWMODES[i++]) != NULL) {
-        const RawMode * const rawmode = RAWMODES[i];
-        if (!strcmp(rawmode->name, name)) {
+    for (int i = 0; (rawmode = RAWMODES[i]); i++) {
+        if (strcmp(rawmode->name, name) == 0) {
             return rawmode;
         }
     }

From 579c55ea86680f7bc22a0a9852146eeccafe4189 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 17:16:56 -0500
Subject: [PATCH 1933/2374] check for null input in findMode() and
 findRawMode()

---
 src/libImaging/Mode.c | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 04e843d3277..01b2b55015a 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -68,6 +68,9 @@ const Mode * const MODES[] = {
 };
 
 const Mode * findMode(const char * const name) {
+    if (name == NULL) {
+        return NULL;
+    }
     const Mode * mode;
     for (int i = 0; (mode = MODES[i]); i++) {
         if (strcmp(mode->name, name) == 0) {
@@ -433,6 +436,9 @@ const RawMode * const RAWMODES[] = {
 };
 
 const RawMode * findRawMode(const char * const name) {
+    if (name == NULL) {
+        return NULL;
+    }
     const RawMode * rawmode;
     for (int i = 0; (rawmode = RAWMODES[i]); i++) {
         if (strcmp(rawmode->name, name) == 0) {

From 422eb1ebc4384c44eef5e1c3f084abbeaf6cb010 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 19:47:58 -0500
Subject: [PATCH 1934/2374] replace some string function usage with imaging
 mode checks

---
 src/_imaging.c          | 8 +++++++-
 src/libImaging/Matrix.c | 6 +++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 6c98c42eacf..f2d39614029 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1824,7 +1824,13 @@ _putpalette(ImagingObject *self, PyObject *args) {
 
     ImagingPaletteDelete(self->image->palette);
 
-    self->image->mode = strlen(self->image->mode->name) == 2 ? IMAGING_MODE_PA : IMAGING_MODE_P;
+    if (self->image->mode == IMAGING_MODE_LA) {
+        self->image->mode = IMAGING_MODE_PA;
+    } else if (self->image->mode == IMAGING_MODE_L) {
+        self->image->mode = IMAGING_MODE_P;
+    } else {
+        // The image already has a palette mode so we don't need to change it.
+    }
 
     self->image->palette = ImagingPaletteNew(palette_mode);
 
diff --git a/src/libImaging/Matrix.c b/src/libImaging/Matrix.c
index fd558461100..f848b870d05 100644
--- a/src/libImaging/Matrix.c
+++ b/src/libImaging/Matrix.c
@@ -46,7 +46,11 @@ ImagingConvertMatrix(Imaging im, const Mode *mode, float m[]) {
             }
         }
         ImagingSectionLeave(&cookie);
-    } else if (strlen(mode->name) == 3) {
+    } else if (
+        mode == IMAGING_MODE_HSV ||
+        mode == IMAGING_MODE_LAB ||
+        mode == IMAGING_MODE_RGB
+    ) {
         imOut = ImagingNewDirty(mode, im->xsize, im->ysize);
         if (!imOut) {
             return NULL;

From 16fc61ee657f4a5df67993a6845940cd1f35612d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 20:16:28 -0500
Subject: [PATCH 1935/2374] use RawMode struct for jpegmode

---
 src/decode.c                | 11 ++++-------
 src/libImaging/Jpeg.h       |  4 ++--
 src/libImaging/JpegDecode.c | 10 +++++-----
 3 files changed, 11 insertions(+), 14 deletions(-)

diff --git a/src/decode.c b/src/decode.c
index 9f4de28a828..e48dbbc3da8 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -820,20 +820,17 @@ PyImaging_JpegDecoderNew(PyObject *self, PyObject *args) {
 
     char *mode_name;
     char *rawmode_name; /* what we want from the decoder */
-    char *jpegmode;     /* what's in the file */
+    char *jpegmode_name; /* what's in the file */
     int scale = 1;
     int draft = 0;
 
-    if (!PyArg_ParseTuple(args, "ssz|ii", &mode_name, &rawmode_name, &jpegmode, &scale, &draft)) {
+    if (!PyArg_ParseTuple(args, "ssz|ii", &mode_name, &rawmode_name, &jpegmode_name, &scale, &draft)) {
         return NULL;
     }
 
     const Mode * const mode = findMode(mode_name);
     const RawMode * rawmode = findRawMode(rawmode_name);
-
-    if (!jpegmode) {
-        jpegmode = "";
-    }
+    const RawMode * const jpegmode = findRawMode(jpegmode_name);
 
     decoder = PyImaging_DecoderNew(sizeof(JPEGSTATE));
     if (decoder == NULL) {
@@ -857,7 +854,7 @@ PyImaging_JpegDecoderNew(PyObject *self, PyObject *args) {
     JPEGSTATE *jpeg_decoder_state_context = (JPEGSTATE *)decoder->state.context;
 
     jpeg_decoder_state_context->rawmode = rawmode;
-    strncpy(jpeg_decoder_state_context->jpegmode, jpegmode, 8);
+    jpeg_decoder_state_context->jpegmode = jpegmode;
 
     jpeg_decoder_state_context->scale = scale;
     jpeg_decoder_state_context->draft = draft;
diff --git a/src/libImaging/Jpeg.h b/src/libImaging/Jpeg.h
index 35df91d7ffa..48c6c618411 100644
--- a/src/libImaging/Jpeg.h
+++ b/src/libImaging/Jpeg.h
@@ -28,8 +28,8 @@ typedef struct {
 typedef struct {
     /* CONFIGURATION */
 
-    /* Jpeg file mode (empty if not known) */
-    char jpegmode[8 + 1];
+    /* Jpeg file mode (NULL if not known) */
+    const RawMode *jpegmode;
 
     /* Converter output mode (input to the shuffler) */
     /* If NULL, convert conversions are disabled */
diff --git a/src/libImaging/JpegDecode.c b/src/libImaging/JpegDecode.c
index 36eb7835a7f..49d4fcb2f8a 100644
--- a/src/libImaging/JpegDecode.c
+++ b/src/libImaging/JpegDecode.c
@@ -182,15 +182,15 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
 
             /* jpegmode indicates what's in the file; if not set, we'll
                trust the decoder */
-            if (strcmp(context->jpegmode, "L") == 0) {
+            if (context->jpegmode == IMAGING_RAWMODE_L) {
                 context->cinfo.jpeg_color_space = JCS_GRAYSCALE;
-            } else if (strcmp(context->jpegmode, "RGB") == 0) {
+            } else if (context->jpegmode == IMAGING_RAWMODE_RGB) {
                 context->cinfo.jpeg_color_space = JCS_RGB;
-            } else if (strcmp(context->jpegmode, "CMYK") == 0) {
+            } else if (context->jpegmode == IMAGING_RAWMODE_CMYK) {
                 context->cinfo.jpeg_color_space = JCS_CMYK;
-            } else if (strcmp(context->jpegmode, "YCbCr") == 0) {
+            } else if (context->jpegmode == IMAGING_RAWMODE_YCbCr) {
                 context->cinfo.jpeg_color_space = JCS_YCbCr;
-            } else if (strcmp(context->jpegmode, "YCbCrK") == 0) {
+            } else if (context->jpegmode == IMAGING_RAWMODE_YCbCrK) {
                 context->cinfo.jpeg_color_space = JCS_YCCK;
             }
 

From 4b07ed52fd22e5a3407f98fc999d0a8d6ef4546e Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Mon, 22 Apr 2024 20:43:49 -0500
Subject: [PATCH 1936/2374] use Mode struct for windows display code

---
 src/display.c          | 16 +++++++---------
 src/libImaging/Dib.c   | 34 ++++++++++++++++------------------
 src/libImaging/ImDib.h |  6 +++---
 3 files changed, 26 insertions(+), 30 deletions(-)

diff --git a/src/display.c b/src/display.c
index 3215f6691ee..0650b886640 100644
--- a/src/display.c
+++ b/src/display.c
@@ -47,7 +47,7 @@ typedef struct {
 static PyTypeObject ImagingDisplayType;
 
 static ImagingDisplayObject *
-_new(const char *mode, int xsize, int ysize) {
+_new(const Mode * const mode, int xsize, int ysize) {
     ImagingDisplayObject *display;
 
     if (PyType_Ready(&ImagingDisplayType) < 0) {
@@ -235,7 +235,7 @@ static struct PyMethodDef methods[] = {
 
 static PyObject *
 _getattr_mode(ImagingDisplayObject *self, void *closure) {
-    return Py_BuildValue("s", self->dib->mode);
+    return Py_BuildValue("s", self->dib->mode->name);
 }
 
 static PyObject *
@@ -258,13 +258,14 @@ static PyTypeObject ImagingDisplayType = {
 PyObject *
 PyImaging_DisplayWin32(PyObject *self, PyObject *args) {
     ImagingDisplayObject *display;
-    char *mode;
+    char *mode_name;
     int xsize, ysize;
 
-    if (!PyArg_ParseTuple(args, "s(ii)", &mode, &xsize, &ysize)) {
+    if (!PyArg_ParseTuple(args, "s(ii)", &mode_name, &xsize, &ysize)) {
         return NULL;
     }
 
+    const Mode * const mode = findMode(mode_name);
     display = _new(mode, xsize, ysize);
     if (display == NULL) {
         return NULL;
@@ -275,12 +276,9 @@ PyImaging_DisplayWin32(PyObject *self, PyObject *args) {
 
 PyObject *
 PyImaging_DisplayModeWin32(PyObject *self, PyObject *args) {
-    char *mode;
     int size[2];
-
-    mode = ImagingGetModeDIB(size);
-
-    return Py_BuildValue("s(ii)", mode, size[0], size[1]);
+    const Mode * const mode = ImagingGetModeDIB(size);
+    return Py_BuildValue("s(ii)", mode->name, size[0], size[1]);
 }
 
 /* -------------------------------------------------------------------- */
diff --git a/src/libImaging/Dib.c b/src/libImaging/Dib.c
index c69e9e552ae..154c610ec22 100644
--- a/src/libImaging/Dib.c
+++ b/src/libImaging/Dib.c
@@ -25,20 +25,17 @@
 
 #include "ImDib.h"
 
-char *
+const Mode *
 ImagingGetModeDIB(int size_out[2]) {
     /* Get device characteristics */
 
-    HDC dc;
-    char *mode;
+    const HDC dc = CreateCompatibleDC(NULL);
 
-    dc = CreateCompatibleDC(NULL);
-
-    mode = "P";
+    const Mode *mode = IMAGING_MODE_P;
     if (!(GetDeviceCaps(dc, RASTERCAPS) & RC_PALETTE)) {
-        mode = "RGB";
+        mode = IMAGING_MODE_RGB;
         if (GetDeviceCaps(dc, BITSPIXEL) == 1) {
-            mode = "1";
+            mode = IMAGING_MODE_1;
         }
     }
 
@@ -53,7 +50,7 @@ ImagingGetModeDIB(int size_out[2]) {
 }
 
 ImagingDIB
-ImagingNewDIB(const char *mode, int xsize, int ysize) {
+ImagingNewDIB(const Mode * const mode, int xsize, int ysize) {
     /* Create a Windows bitmap */
 
     ImagingDIB dib;
@@ -61,10 +58,12 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
     int i;
 
     /* Check mode */
-    if (strcmp(mode, "1") != 0 && strcmp(mode, "L") != 0 && strcmp(mode, "RGB") != 0) {
+    if (mode != IMAGING_MODE_1 && mode != IMAGING_MODE_L && mode != IMAGING_MODE_RGB) {
         return (ImagingDIB)ImagingError_ModeError();
     }
 
+    const int pixelsize = mode == IMAGING_MODE_RGB ? 3 : 1;
+
     /* Create DIB context and info header */
     /* malloc check ok, small constant allocation */
     dib = (ImagingDIB)malloc(sizeof(*dib));
@@ -83,7 +82,7 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
     dib->info->bmiHeader.biWidth = xsize;
     dib->info->bmiHeader.biHeight = ysize;
     dib->info->bmiHeader.biPlanes = 1;
-    dib->info->bmiHeader.biBitCount = strlen(mode) * 8;
+    dib->info->bmiHeader.biBitCount = pixelsize * 8;
     dib->info->bmiHeader.biCompression = BI_RGB;
 
     /* Create DIB */
@@ -103,12 +102,12 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
         return (ImagingDIB)ImagingError_MemoryError();
     }
 
-    strcpy(dib->mode, mode);
+    dib->mode = mode;
     dib->xsize = xsize;
     dib->ysize = ysize;
 
-    dib->pixelsize = strlen(mode);
-    dib->linesize = (xsize * dib->pixelsize + 3) & -4;
+    dib->pixelsize = pixelsize;
+    dib->linesize = (xsize * pixelsize + 3) & -4;
 
     if (dib->pixelsize == 1) {
         dib->pack = dib->unpack = (ImagingShuffler)memcpy;
@@ -132,7 +131,7 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
     }
 
     /* Create an associated palette (for 8-bit displays only) */
-    if (strcmp(ImagingGetModeDIB(NULL), "P") == 0) {
+    if (ImagingGetModeDIB(NULL) == IMAGING_MODE_P) {
         char palbuf[sizeof(LOGPALETTE) + 256 * sizeof(PALETTEENTRY)];
         LPLOGPALETTE pal = (LPLOGPALETTE)palbuf;
         int i, r, g, b;
@@ -142,7 +141,7 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
         pal->palNumEntries = 256;
         GetSystemPaletteEntries(dib->dc, 0, 256, pal->palPalEntry);
 
-        if (strcmp(mode, "L") == 0) {
+        if (mode == IMAGING_MODE_L) {
             /* Grayscale DIB.  Fill all 236 slots with a grayscale ramp
              * (this is usually overkill on Windows since VGA only offers
              * 6 bits grayscale resolution).  Ignore the slots already
@@ -156,8 +155,7 @@ ImagingNewDIB(const char *mode, int xsize, int ysize) {
             }
 
             dib->palette = CreatePalette(pal);
-
-        } else if (strcmp(mode, "RGB") == 0) {
+        } else if (mode == IMAGING_MODE_RGB) {
 #ifdef CUBE216
 
             /* Colour DIB.  Create a 6x6x6 colour cube (216 entries) and
diff --git a/src/libImaging/ImDib.h b/src/libImaging/ImDib.h
index 91ff3f322ff..6d8f420cb5c 100644
--- a/src/libImaging/ImDib.h
+++ b/src/libImaging/ImDib.h
@@ -27,7 +27,7 @@ struct ImagingDIBInstance {
     UINT8 *bits;
     HPALETTE palette;
     /* Used by cut and paste */
-    char mode[4];
+    const Mode *mode;
     int xsize, ysize;
     int pixelsize;
     int linesize;
@@ -37,11 +37,11 @@ struct ImagingDIBInstance {
 
 typedef struct ImagingDIBInstance *ImagingDIB;
 
-extern char *
+extern const Mode *
 ImagingGetModeDIB(int size_out[2]);
 
 extern ImagingDIB
-ImagingNewDIB(const char *mode, int xsize, int ysize);
+ImagingNewDIB(const Mode * const mode, int xsize, int ysize);
 
 extern void
 ImagingDeleteDIB(ImagingDIB im);

From 9527ce7f8c925e30e8b5535e8b115366743495e4 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 16:54:32 +0200
Subject: [PATCH 1937/2374] change mode structs to enums Structs have better
 type safety, but they make allocation more difficult, especially when we have
 multiple Python modules trying to share the same code.

---
 src/_imaging.c                |  51 +--
 src/decode.c                  |  44 +-
 src/display.c                 |  10 +-
 src/encode.c                  |  34 +-
 src/libImaging/Access.c       |  71 ++-
 src/libImaging/Bands.c        |   2 +-
 src/libImaging/Chops.c        |  58 +--
 src/libImaging/Convert.c      | 325 +++++++-------
 src/libImaging/Dib.c          |   6 +-
 src/libImaging/Fill.c         |   4 +-
 src/libImaging/ImDib.h        |   6 +-
 src/libImaging/Imaging.h      |  77 ++--
 src/libImaging/Jpeg.h         |  10 +-
 src/libImaging/Jpeg2KDecode.c |   2 +-
 src/libImaging/JpegDecode.c   |  10 +-
 src/libImaging/Matrix.c       |   2 +-
 src/libImaging/Mode.c         | 649 ++++++++++-----------------
 src/libImaging/Mode.h         | 444 ++++++++++---------
 src/libImaging/Pack.c         | 340 ++++----------
 src/libImaging/Palette.c      |   2 +-
 src/libImaging/Point.c        |   4 +-
 src/libImaging/Storage.c      |  16 +-
 src/libImaging/TiffDecode.c   |   4 +-
 src/libImaging/Unpack.c       | 804 ++++++++++------------------------
 src/map.c                     |   2 +-
 25 files changed, 1127 insertions(+), 1850 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index f2d39614029..a940bb97448 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -368,7 +368,7 @@ ImagingError_ValueError(const char *message) {
 /* -------------------------------------------------------------------- */
 
 static int
-getbands(const Mode *mode) {
+getbands(const ModeID mode) {
     Imaging im;
     int bands;
 
@@ -731,7 +731,7 @@ _fill(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     im = ImagingNewDirty(mode, xsize, ysize);
     if (!im) {
@@ -760,7 +760,7 @@ _new(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     return PyImagingNew(ImagingNew(mode, xsize, ysize));
 }
@@ -774,7 +774,7 @@ _new_block(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     return PyImagingNew(ImagingNewBlock(mode, xsize, ysize));
 }
@@ -787,7 +787,7 @@ _linear_gradient(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     return PyImagingNew(ImagingFillLinearGradient(mode));
 }
@@ -800,7 +800,7 @@ _radial_gradient(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     return PyImagingNew(ImagingFillRadialGradient(mode));
 }
@@ -964,7 +964,7 @@ _color_lut_3d(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     /* actually, it is trilinear */
     if (filter != IMAGING_TRANSFORM_BILINEAR) {
@@ -1033,7 +1033,7 @@ _convert(ImagingObject *self, PyObject *args) {
         }
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     return PyImagingNew(ImagingConvert(
         self->image, mode, paletteimage ? paletteimage->image->palette : NULL, dither
@@ -1084,7 +1084,7 @@ _convert_matrix(ImagingObject *self, PyObject *args) {
         }
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     return PyImagingNew(ImagingConvertMatrix(self->image, mode, m));
 }
@@ -1094,12 +1094,12 @@ _convert_transparent(ImagingObject *self, PyObject *args) {
     char *mode_name;
     int r, g, b;
     if (PyArg_ParseTuple(args, "s(iii)", &mode_name, &r, &g, &b)) {
-        const Mode * const mode = findMode(mode_name);
+        const ModeID mode = findModeID(mode_name);
         return PyImagingNew(ImagingConvertTransparent(self->image, mode, r, g, b));
     }
     PyErr_Clear();
     if (PyArg_ParseTuple(args, "si", &mode_name, &r)) {
-        const Mode * const mode = findMode(mode_name);
+        const ModeID mode = findModeID(mode_name);
         return PyImagingNew(ImagingConvertTransparent(self->image, mode, r, 0, 0));
     }
     return NULL;
@@ -1209,8 +1209,8 @@ _getpalette(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     pack = ImagingFindPacker(mode, rawmode, &bits);
     if (!pack) {
@@ -1238,7 +1238,7 @@ _getpalettemode(ImagingObject *self) {
         return NULL;
     }
 
-    return PyUnicode_FromString(self->image->palette->mode->name);
+    return PyUnicode_FromString(getModeData(self->image->palette->mode)->name);
 }
 
 static inline int
@@ -1524,7 +1524,7 @@ _point(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     if (mode == IMAGING_MODE_F) {
         FLOAT32 *data;
@@ -1799,14 +1799,14 @@ _putpalette(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const palette_mode = findMode(palette_mode_name);
-    if (palette_mode == NULL) {
+    const ModeID palette_mode = findModeID(palette_mode_name);
+    if (palette_mode == IMAGING_MODE_UNKNOWN) {
         PyErr_SetString(PyExc_ValueError, wrong_mode);
         return NULL;
     }
 
-    const RawMode * const rawmode = findRawMode(rawmode_name);
-    if (rawmode == NULL) {
+    const RawModeID rawmode = findRawModeID(rawmode_name);
+    if (rawmode == IMAGING_RAWMODE_UNKNOWN) {
         PyErr_SetString(PyExc_ValueError, wrong_raw_mode);
         return NULL;
     }
@@ -2052,7 +2052,7 @@ _reduce(ImagingObject *self, PyObject *args) {
 }
 
 static int
-isRGB(const Mode * const mode) {
+isRGB(const ModeID mode) {
     return mode == IMAGING_MODE_RGB || mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_RGBX;
 }
 
@@ -2068,7 +2068,7 @@ im_setmode(ImagingObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     im = self->image;
 
@@ -2472,7 +2472,7 @@ _merge(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     if (band0) {
         bands[0] = band0->image;
@@ -3779,7 +3779,7 @@ static struct PyMethodDef methods[] = {
 
 static PyObject *
 _getattr_mode(ImagingObject *self, void *closure) {
-    return PyUnicode_FromString(self->image->mode->name);
+    return PyUnicode_FromString(getModeData(self->image->mode)->name);
 }
 
 static PyObject *
@@ -4323,11 +4323,6 @@ setup_module(PyObject *m) {
         return -1;
     }
 
-    ImagingAccessInit();
-    ImagingConvertInit();
-    ImagingPackInit();
-    ImagingUnpackInit();
-
 #ifdef HAVE_LIBJPEG
     {
         extern const char *ImagingJpegVersion(void);
diff --git a/src/decode.c b/src/decode.c
index e48dbbc3da8..41b2f6f3167 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -266,7 +266,7 @@ static PyTypeObject ImagingDecoderType = {
 /* -------------------------------------------------------------------- */
 
 int
-get_unpacker(ImagingDecoderObject *decoder, const Mode *mode, const RawMode *rawmode) {
+get_unpacker(ImagingDecoderObject *decoder, const ModeID mode, const RawModeID rawmode) {
     int bits;
     ImagingShuffler unpack;
 
@@ -441,8 +441,8 @@ PyImaging_HexDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
@@ -481,8 +481,8 @@ PyImaging_LibTiffDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     TRACE(("new tiff decoder %s\n", compname));
 
@@ -522,8 +522,8 @@ PyImaging_PackbitsDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
@@ -576,8 +576,8 @@ PyImaging_PcxDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
@@ -610,8 +610,8 @@ PyImaging_RawDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(sizeof(RAWSTATE));
     if (decoder == NULL) {
@@ -646,8 +646,8 @@ PyImaging_SgiRleDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(sizeof(SGISTATE));
     if (decoder == NULL) {
@@ -680,8 +680,8 @@ PyImaging_SunRleDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
@@ -712,8 +712,8 @@ PyImaging_TgaRleDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(0);
     if (decoder == NULL) {
@@ -772,8 +772,8 @@ PyImaging_ZipDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     decoder = PyImaging_DecoderNew(sizeof(ZIPSTATE));
     if (decoder == NULL) {
@@ -828,9 +828,9 @@ PyImaging_JpegDecoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * rawmode = findRawMode(rawmode_name);
-    const RawMode * const jpegmode = findRawMode(jpegmode_name);
+    const ModeID mode = findModeID(mode_name);
+    RawModeID rawmode = findRawModeID(rawmode_name);
+    const RawModeID jpegmode = findRawModeID(jpegmode_name);
 
     decoder = PyImaging_DecoderNew(sizeof(JPEGSTATE));
     if (decoder == NULL) {
diff --git a/src/display.c b/src/display.c
index 0650b886640..5b5853a3cb8 100644
--- a/src/display.c
+++ b/src/display.c
@@ -47,7 +47,7 @@ typedef struct {
 static PyTypeObject ImagingDisplayType;
 
 static ImagingDisplayObject *
-_new(const Mode * const mode, int xsize, int ysize) {
+_new(const ModeID mode, int xsize, int ysize) {
     ImagingDisplayObject *display;
 
     if (PyType_Ready(&ImagingDisplayType) < 0) {
@@ -235,7 +235,7 @@ static struct PyMethodDef methods[] = {
 
 static PyObject *
 _getattr_mode(ImagingDisplayObject *self, void *closure) {
-    return Py_BuildValue("s", self->dib->mode->name);
+    return Py_BuildValue("s", getModeData(self->dib->mode)->name);
 }
 
 static PyObject *
@@ -265,7 +265,7 @@ PyImaging_DisplayWin32(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
     display = _new(mode, xsize, ysize);
     if (display == NULL) {
         return NULL;
@@ -277,8 +277,8 @@ PyImaging_DisplayWin32(PyObject *self, PyObject *args) {
 PyObject *
 PyImaging_DisplayModeWin32(PyObject *self, PyObject *args) {
     int size[2];
-    const Mode * const mode = ImagingGetModeDIB(size);
-    return Py_BuildValue("s(ii)", mode->name, size[0], size[1]);
+    const ModeID mode = ImagingGetModeDIB(size);
+    return Py_BuildValue("s(ii)", getModeData(mode)->name, size[0], size[1]);
 }
 
 /* -------------------------------------------------------------------- */
diff --git a/src/encode.c b/src/encode.c
index 311ffa4eed0..3a6b6d6d0a2 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -334,7 +334,7 @@ static PyTypeObject ImagingEncoderType = {
 /* -------------------------------------------------------------------- */
 
 int
-get_packer(ImagingEncoderObject *encoder, const Mode *mode, const RawMode *rawmode) {
+get_packer(ImagingEncoderObject *encoder, const ModeID mode, const RawModeID rawmode) {
     int bits;
     ImagingShuffler pack;
 
@@ -344,8 +344,8 @@ get_packer(ImagingEncoderObject *encoder, const Mode *mode, const RawMode *rawmo
         PyErr_Format(
             PyExc_ValueError,
             "No packer found from %s to %s",
-            mode->name,
-            rawmode->name
+            getModeData(mode)->name,
+            getRawModeData(rawmode)->name
         );
         return -1;
     }
@@ -420,8 +420,8 @@ PyImaging_GifEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
@@ -456,8 +456,8 @@ PyImaging_PcxEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
@@ -490,8 +490,8 @@ PyImaging_RawEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
@@ -526,8 +526,8 @@ PyImaging_TgaRleEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
@@ -614,8 +614,8 @@ PyImaging_ZipEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     if (get_packer(encoder, mode, rawmode) < 0) {
         free(dictionary);
@@ -721,8 +721,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * const rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    const RawModeID rawmode = findRawModeID(rawmode_name);
 
     if (get_packer(encoder, mode, rawmode) < 0) {
         return NULL;
@@ -1161,8 +1161,8 @@ PyImaging_JpegEncoderNew(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
-    const RawMode * rawmode = findRawMode(rawmode_name);
+    const ModeID mode = findModeID(mode_name);
+    RawModeID rawmode = findRawModeID(rawmode_name);
 
     // libjpeg-turbo supports different output formats.
     // We are choosing Pillow's native format (3 color bytes + 1 padding)
diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 59a776fe04e..6360e914761 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -116,51 +116,38 @@ put_pixel_32(Imaging im, int x, int y, const void *color) {
     memcpy(&im->image32[y][x], color, sizeof(INT32));
 }
 
-static struct ImagingAccessInstance *accessors = NULL;
-
-void
-ImagingAccessInit(void) {
-    const struct ImagingAccessInstance temp[] = {
-        {IMAGING_MODE_1, get_pixel_8, put_pixel_8},
-        {IMAGING_MODE_L, get_pixel_8, put_pixel_8},
-        {IMAGING_MODE_LA, get_pixel_32_2bands, put_pixel_32},
-        {IMAGING_MODE_La, get_pixel_32_2bands, put_pixel_32},
-        {IMAGING_MODE_I, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_I_16, get_pixel_16L, put_pixel_16L},
-        {IMAGING_MODE_I_16L, get_pixel_16L, put_pixel_16L},
-        {IMAGING_MODE_I_16B, get_pixel_16B, put_pixel_16B},
+static struct ImagingAccessInstance accessors[] = {
+    {IMAGING_MODE_1, get_pixel_8, put_pixel_8},
+    {IMAGING_MODE_L, get_pixel_8, put_pixel_8},
+    {IMAGING_MODE_LA, get_pixel_32_2bands, put_pixel_32},
+    {IMAGING_MODE_La, get_pixel_32_2bands, put_pixel_32},
+    {IMAGING_MODE_I, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_I_16, get_pixel_16L, put_pixel_16L},
+    {IMAGING_MODE_I_16L, get_pixel_16L, put_pixel_16L},
+    {IMAGING_MODE_I_16B, get_pixel_16B, put_pixel_16B},
 #ifdef WORDS_BIGENDIAN
-        {IMAGING_MODE_I_16N, get_pixel_16B, put_pixel_16B},
+    {IMAGING_MODE_I_16N, get_pixel_16B, put_pixel_16B},
 #else
-        {IMAGING_MODE_I_16N, get_pixel_16L, put_pixel_16L},
+    {IMAGING_MODE_I_16N, get_pixel_16L, put_pixel_16L},
 #endif
-        {IMAGING_MODE_I_32L, get_pixel_32L, put_pixel_32L},
-        {IMAGING_MODE_I_32B, get_pixel_32B, put_pixel_32B},
-        {IMAGING_MODE_F, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_P, get_pixel_8, put_pixel_8},
-        {IMAGING_MODE_PA, get_pixel_32_2bands, put_pixel_32},
-        {IMAGING_MODE_RGB, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_RGBA, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_RGBa, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_RGBX, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_CMYK, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_YCbCr, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_LAB, get_pixel_32, put_pixel_32},
-        {IMAGING_MODE_HSV, get_pixel_32, put_pixel_32},
-        {NULL}
-    };
-    accessors = malloc(sizeof(temp));
-    if (accessors == NULL) {
-        fprintf(stderr, "AccessInit: failed to allocate memory for accessors table\n");
-        exit(1);
-    }
-    memcpy(accessors, temp, sizeof(temp));
-}
+    {IMAGING_MODE_I_32L, get_pixel_32L, put_pixel_32L},
+    {IMAGING_MODE_I_32B, get_pixel_32B, put_pixel_32B},
+    {IMAGING_MODE_F, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_P, get_pixel_8, put_pixel_8},
+    {IMAGING_MODE_PA, get_pixel_32_2bands, put_pixel_32},
+    {IMAGING_MODE_RGB, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_RGBA, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_RGBa, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_RGBX, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_CMYK, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_YCbCr, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_LAB, get_pixel_32, put_pixel_32},
+    {IMAGING_MODE_HSV, get_pixel_32, put_pixel_32},
+};
 
 ImagingAccess
 ImagingAccessNew(const Imaging im) {
-    int i;
-    for (i = 0; accessors[i].mode; i++) {
+    for (size_t i = 0; i < sizeof(accessors) / sizeof(*accessors); i++) {
         if (im->mode == accessors[i].mode) {
             return &accessors[i];
         }
@@ -170,9 +157,3 @@ ImagingAccessNew(const Imaging im) {
 
 void
 _ImagingAccessDelete(Imaging im, ImagingAccess access) {}
-
-void
-ImagingAccessFree(void) {
-    free(accessors);
-    accessors = NULL;
-}
diff --git a/src/libImaging/Bands.c b/src/libImaging/Bands.c
index 501b4625fc5..d1b0ebc4ed8 100644
--- a/src/libImaging/Bands.c
+++ b/src/libImaging/Bands.c
@@ -240,7 +240,7 @@ ImagingFillBand(Imaging imOut, int band, int color) {
 }
 
 Imaging
-ImagingMerge(const Mode *mode, Imaging bands[4]) {
+ImagingMerge(const ModeID mode, Imaging bands[4]) {
     int i, x, y;
     int bandsCount = 0;
     Imaging imOut;
diff --git a/src/libImaging/Chops.c b/src/libImaging/Chops.c
index 66d0b4f9774..331f2dfe64c 100644
--- a/src/libImaging/Chops.c
+++ b/src/libImaging/Chops.c
@@ -18,28 +18,28 @@
 
 #include "Imaging.h"
 
-#define CHOP(operation)                         \
-    int x, y;                                   \
-    Imaging imOut;                              \
-    imOut = create(imIn1, imIn2, NULL);         \
-    if (!imOut) {                               \
-        return NULL;                            \
-    }                                           \
-    for (y = 0; y < imOut->ysize; y++) {        \
-        UINT8 *out = (UINT8 *)imOut->image[y];  \
-        UINT8 *in1 = (UINT8 *)imIn1->image[y];  \
-        UINT8 *in2 = (UINT8 *)imIn2->image[y];  \
-        for (x = 0; x < imOut->linesize; x++) { \
-            int temp = operation;               \
-            if (temp <= 0) {                    \
-                out[x] = 0;                     \
-            } else if (temp >= 255) {           \
-                out[x] = 255;                   \
-            } else {                            \
-                out[x] = temp;                  \
-            }                                   \
-        }                                       \
-    }                                           \
+#define CHOP(operation)                                 \
+    int x, y;                                           \
+    Imaging imOut;                                      \
+    imOut = create(imIn1, imIn2, IMAGING_MODE_UNKNOWN); \
+    if (!imOut) {                                       \
+        return NULL;                                    \
+    }                                                   \
+    for (y = 0; y < imOut->ysize; y++) {                \
+        UINT8 *out = (UINT8 *)imOut->image[y];          \
+        UINT8 *in1 = (UINT8 *)imIn1->image[y];          \
+        UINT8 *in2 = (UINT8 *)imIn2->image[y];          \
+        for (x = 0; x < imOut->linesize; x++) {         \
+            int temp = operation;                       \
+            if (temp <= 0) {                            \
+                out[x] = 0;                             \
+            } else if (temp >= 255) {                   \
+                out[x] = 255;                           \
+            } else {                                    \
+                out[x] = temp;                          \
+            }                                           \
+        }                                               \
+    }                                                   \
     return imOut;
 
 #define CHOP2(operation, mode)                  \
@@ -60,11 +60,11 @@
     return imOut;
 
 static Imaging
-create(Imaging im1, Imaging im2, const Mode *mode) {
+create(Imaging im1, Imaging im2, const ModeID mode) {
     int xsize, ysize;
 
     if (!im1 || !im2 || im1->type != IMAGING_TYPE_UINT8 ||
-        (mode != NULL && (im1->mode != mode || im2->mode != mode))) {
+        (mode != IMAGING_MODE_UNKNOWN && (im1->mode != mode || im2->mode != mode))) {
         return (Imaging)ImagingError_ModeError();
     }
     if (im1->type != im2->type || im1->bands != im2->bands) {
@@ -129,12 +129,12 @@ ImagingChopXor(Imaging imIn1, Imaging imIn2) {
 
 Imaging
 ImagingChopAddModulo(Imaging imIn1, Imaging imIn2) {
-    CHOP2(in1[x] + in2[x], NULL);
+    CHOP2(in1[x] + in2[x], IMAGING_MODE_UNKNOWN);
 }
 
 Imaging
 ImagingChopSubtractModulo(Imaging imIn1, Imaging imIn2) {
-    CHOP2(in1[x] - in2[x], NULL);
+    CHOP2(in1[x] - in2[x], IMAGING_MODE_UNKNOWN);
 }
 
 Imaging
@@ -142,7 +142,7 @@ 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
+        IMAGING_MODE_UNKNOWN
     );
 }
 
@@ -151,7 +151,7 @@ ImagingChopHardLight(Imaging imIn1, Imaging imIn2) {
     CHOP2(
         (in2[x] < 128) ? ((in1[x] * in2[x]) / 127)
                        : 255 - (((255 - in2[x]) * (255 - in1[x])) / 127),
-        NULL
+        IMAGING_MODE_UNKNOWN
     );
 }
 
@@ -160,6 +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
+        IMAGING_MODE_UNKNOWN
     );
 }
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 8f580c294b7..862f228e5a5 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -1090,7 +1090,7 @@ pa2ycbcr(UINT8 *out, const UINT8 *in, int xsize, ImagingPalette palette) {
 }
 
 static Imaging
-frompalette(Imaging imOut, Imaging imIn, const Mode *mode) {
+frompalette(Imaging imOut, Imaging imIn, const ModeID mode) {
     ImagingSectionCookie cookie;
     int alpha;
     int y;
@@ -1160,7 +1160,7 @@ frompalette(Imaging imOut, Imaging imIn, const Mode *mode) {
 #endif
 static Imaging
 topalette(
-    Imaging imOut, Imaging imIn, const Mode *mode, ImagingPalette inpalette, int dither
+    Imaging imOut, Imaging imIn, const ModeID mode, ImagingPalette inpalette, int dither
 ) {
     ImagingSectionCookie cookie;
     int alpha;
@@ -1456,25 +1456,151 @@ tobilevel(Imaging imOut, Imaging imIn) {
 /* Conversion handlers */
 /* ------------------- */
 
-static struct Converter {
-    const Mode *from;
-    const Mode *to;
+static struct {
+    const ModeID from;
+    const ModeID to;
     ImagingShuffler convert;
-} *converters = NULL;
+} converters[] = {
+    {IMAGING_MODE_1, IMAGING_MODE_L, bit2l},
+    {IMAGING_MODE_1, IMAGING_MODE_I, bit2i},
+    {IMAGING_MODE_1, IMAGING_MODE_F, bit2f},
+    {IMAGING_MODE_1, IMAGING_MODE_RGB, bit2rgb},
+    {IMAGING_MODE_1, IMAGING_MODE_RGBA, bit2rgb},
+    {IMAGING_MODE_1, IMAGING_MODE_RGBX, bit2rgb},
+    {IMAGING_MODE_1, IMAGING_MODE_CMYK, bit2cmyk},
+    {IMAGING_MODE_1, IMAGING_MODE_YCbCr, bit2ycbcr},
+    {IMAGING_MODE_1, IMAGING_MODE_HSV, bit2hsv},
+
+    {IMAGING_MODE_L, IMAGING_MODE_1, l2bit},
+    {IMAGING_MODE_L, IMAGING_MODE_LA, l2la},
+    {IMAGING_MODE_L, IMAGING_MODE_I, l2i},
+    {IMAGING_MODE_L, IMAGING_MODE_F, l2f},
+    {IMAGING_MODE_L, IMAGING_MODE_RGB, l2rgb},
+    {IMAGING_MODE_L, IMAGING_MODE_RGBA, l2rgb},
+    {IMAGING_MODE_L, IMAGING_MODE_RGBX, l2rgb},
+    {IMAGING_MODE_L, IMAGING_MODE_CMYK, l2cmyk},
+    {IMAGING_MODE_L, IMAGING_MODE_YCbCr, l2ycbcr},
+    {IMAGING_MODE_L, IMAGING_MODE_HSV, l2hsv},
+
+    {IMAGING_MODE_LA, IMAGING_MODE_L, la2l},
+    {IMAGING_MODE_LA, IMAGING_MODE_La, lA2la},
+    {IMAGING_MODE_LA, IMAGING_MODE_RGB, la2rgb},
+    {IMAGING_MODE_LA, IMAGING_MODE_RGBA, la2rgb},
+    {IMAGING_MODE_LA, IMAGING_MODE_RGBX, la2rgb},
+    {IMAGING_MODE_LA, IMAGING_MODE_CMYK, la2cmyk},
+    {IMAGING_MODE_LA, IMAGING_MODE_YCbCr, la2ycbcr},
+    {IMAGING_MODE_LA, IMAGING_MODE_HSV, la2hsv},
+
+    {IMAGING_MODE_La, IMAGING_MODE_LA, la2lA},
+
+    {IMAGING_MODE_I, IMAGING_MODE_L, i2l},
+    {IMAGING_MODE_I, IMAGING_MODE_F, i2f},
+    {IMAGING_MODE_I, IMAGING_MODE_RGB, i2rgb},
+    {IMAGING_MODE_I, IMAGING_MODE_RGBA, i2rgb},
+    {IMAGING_MODE_I, IMAGING_MODE_RGBX, i2rgb},
+    {IMAGING_MODE_I, IMAGING_MODE_HSV, i2hsv},
+
+    {IMAGING_MODE_F, IMAGING_MODE_L, f2l},
+    {IMAGING_MODE_F, IMAGING_MODE_I, f2i},
+
+    {IMAGING_MODE_RGB, IMAGING_MODE_1, rgb2bit},
+    {IMAGING_MODE_RGB, IMAGING_MODE_L, rgb2l},
+    {IMAGING_MODE_RGB, IMAGING_MODE_LA, rgb2la},
+    {IMAGING_MODE_RGB, IMAGING_MODE_La, rgb2la},
+    {IMAGING_MODE_RGB, IMAGING_MODE_I, rgb2i},
+    {IMAGING_MODE_RGB, IMAGING_MODE_I_16, rgb2i16l},
+    {IMAGING_MODE_RGB, IMAGING_MODE_I_16L, rgb2i16l},
+    {IMAGING_MODE_RGB, IMAGING_MODE_I_16B, rgb2i16b},
+#ifdef WORDS_BIGENDIAN
+    {IMAGING_MODE_RGB, IMAGING_MODE_I_16N, rgb2i16b},
+#else
+    {IMAGING_MODE_RGB, IMAGING_MODE_I_16N, rgb2i16l},
+#endif
+    {IMAGING_MODE_RGB, IMAGING_MODE_F, rgb2f},
+    {IMAGING_MODE_RGB, IMAGING_MODE_BGR_15, rgb2bgr15},
+    {IMAGING_MODE_RGB, IMAGING_MODE_BGR_16, rgb2bgr16},
+    {IMAGING_MODE_RGB, IMAGING_MODE_BGR_24, rgb2bgr24},
+    {IMAGING_MODE_RGB, IMAGING_MODE_RGBA, rgb2rgba},
+    {IMAGING_MODE_RGB, IMAGING_MODE_RGBa, rgb2rgba},
+    {IMAGING_MODE_RGB, IMAGING_MODE_RGBX, rgb2rgba},
+    {IMAGING_MODE_RGB, IMAGING_MODE_CMYK, rgb2cmyk},
+    {IMAGING_MODE_RGB, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
+    {IMAGING_MODE_RGB, IMAGING_MODE_HSV, rgb2hsv},
+
+    {IMAGING_MODE_RGBA, IMAGING_MODE_1, rgb2bit},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_L, rgb2l},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_LA, rgba2la},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_I, rgb2i},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_F, rgb2f},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_RGB, rgba2rgb},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_RGBa, rgbA2rgba},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_RGBX, rgb2rgba},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_CMYK, rgb2cmyk},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
+    {IMAGING_MODE_RGBA, IMAGING_MODE_HSV, rgb2hsv},
+
+    {IMAGING_MODE_RGBa, IMAGING_MODE_RGBA, rgba2rgbA},
+    {IMAGING_MODE_RGBa, IMAGING_MODE_RGB, rgba2rgb_},
+
+    {IMAGING_MODE_RGBX, IMAGING_MODE_1, rgb2bit},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_L, rgb2l},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_LA, rgb2la},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_I, rgb2i},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_F, rgb2f},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_RGB, rgba2rgb},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_CMYK, rgb2cmyk},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
+    {IMAGING_MODE_RGBX, IMAGING_MODE_HSV, rgb2hsv},
+
+    {IMAGING_MODE_CMYK, IMAGING_MODE_RGB, cmyk2rgb},
+    {IMAGING_MODE_CMYK, IMAGING_MODE_RGBA, cmyk2rgb},
+    {IMAGING_MODE_CMYK, IMAGING_MODE_RGBX, cmyk2rgb},
+    {IMAGING_MODE_CMYK, IMAGING_MODE_HSV, cmyk2hsv},
+
+    {IMAGING_MODE_YCbCr, IMAGING_MODE_L, ycbcr2l},
+    {IMAGING_MODE_YCbCr, IMAGING_MODE_LA, ycbcr2la},
+    {IMAGING_MODE_YCbCr, IMAGING_MODE_RGB, ImagingConvertYCbCr2RGB},
+
+    {IMAGING_MODE_HSV, IMAGING_MODE_RGB, hsv2rgb},
+
+    {IMAGING_MODE_I, IMAGING_MODE_I_16, I_I16L},
+    {IMAGING_MODE_I_16, IMAGING_MODE_I, I16L_I},
+    {IMAGING_MODE_I_16, IMAGING_MODE_RGB, I16_RGB},
+    {IMAGING_MODE_L, IMAGING_MODE_I_16, L_I16L},
+    {IMAGING_MODE_I_16, IMAGING_MODE_L, I16L_L},
+
+    {IMAGING_MODE_I, IMAGING_MODE_I_16L, I_I16L},
+    {IMAGING_MODE_I_16L, IMAGING_MODE_I, I16L_I},
+    {IMAGING_MODE_I, IMAGING_MODE_I_16B, I_I16B},
+    {IMAGING_MODE_I_16B, IMAGING_MODE_I, I16B_I},
+
+    {IMAGING_MODE_L, IMAGING_MODE_I_16L, L_I16L},
+    {IMAGING_MODE_I_16L, IMAGING_MODE_L, I16L_L},
+    {IMAGING_MODE_L, IMAGING_MODE_I_16B, L_I16B},
+    {IMAGING_MODE_I_16B, IMAGING_MODE_L, I16B_L},
+#ifdef WORDS_BIGENDIAN
+    {IMAGING_MODE_L, IMAGING_MODE_I_16N, L_I16B},
+    {IMAGING_MODE_I_16N, IMAGING_MODE_L, I16B_L},
+#else
+    {IMAGING_MODE_L, IMAGING_MODE_I_16N, L_I16L},
+    {IMAGING_MODE_I_16N, IMAGING_MODE_L, I16L_L},
+#endif
+
+    {IMAGING_MODE_I_16, IMAGING_MODE_F, I16L_F},
+    {IMAGING_MODE_I_16L, IMAGING_MODE_F, I16L_F},
+    {IMAGING_MODE_I_16B, IMAGING_MODE_F, I16B_F}
+};
 
 static Imaging
-convert(
-    Imaging imOut, Imaging imIn, const Mode *mode, ImagingPalette palette, int dither
-) {
+convert(Imaging imOut, Imaging imIn, ModeID mode, ImagingPalette palette, int dither) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
-    int y;
 
     if (!imIn) {
         return (Imaging)ImagingError_ModeError();
     }
 
-    if (!mode) {
+    if (mode == IMAGING_MODE_UNKNOWN) {
         /* Map palette image to full depth */
         if (!imIn->palette) {
             return (Imaging)ImagingError_ModeError();
@@ -1504,10 +1630,9 @@ convert(
     /* standard conversion machinery */
 
     convert = NULL;
-
-    for (y = 0; converters[y].from; y++) {
-        if (imIn->mode == converters[y].from && mode == converters[y].to) {
-            convert = converters[y].convert;
+    for (size_t i = 0; i < sizeof(converters) / sizeof(*converters); i++) {
+        if (imIn->mode == converters[i].from && mode == converters[i].to) {
+            convert = converters[i].convert;
             break;
         }
     }
@@ -1518,7 +1643,11 @@ convert(
 #else
         static char buf[100];
         snprintf(
-            buf, 100, "conversion from %.10s to %.10s not supported", imIn->mode->name, mode->name
+            buf,
+            100,
+            "conversion from %.10s to %.10s not supported",
+            getModeData(imIn->mode)->name,
+            getModeData(mode)->name
         );
         return (Imaging)ImagingError_ValueError(buf);
 #endif
@@ -1530,7 +1659,7 @@ convert(
     }
 
     ImagingSectionEnter(&cookie);
-    for (y = 0; y < imIn->ysize; y++) {
+    for (int y = 0; y < imIn->ysize; y++) {
         (*convert)((UINT8 *)imOut->image[y], (UINT8 *)imIn->image[y], imIn->xsize);
     }
     ImagingSectionLeave(&cookie);
@@ -1539,7 +1668,7 @@ convert(
 }
 
 Imaging
-ImagingConvert(Imaging imIn, const Mode *mode, ImagingPalette palette, int dither) {
+ImagingConvert(Imaging imIn, const ModeID mode, ImagingPalette palette, int dither) {
     return convert(NULL, imIn, mode, palette, dither);
 }
 
@@ -1549,7 +1678,7 @@ ImagingConvert2(Imaging imOut, Imaging imIn) {
 }
 
 Imaging
-ImagingConvertTransparent(Imaging imIn, const Mode *mode, int r, int g, int b) {
+ImagingConvertTransparent(Imaging imIn, const ModeID mode, int r, int g, int b) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
     Imaging imOut = NULL;
@@ -1598,8 +1727,8 @@ ImagingConvertTransparent(Imaging imIn, const Mode *mode, int r, int g, int b) {
             buf,
             100,
             "conversion from %.10s to %.10s not supported in convert_transparent",
-            imIn->mode->name,
-            mode->name
+            getModeData(imIn->mode)->name,
+            getModeData(mode)->name
         );
         return (Imaging)ImagingError_ValueError(buf);
     }
@@ -1622,7 +1751,7 @@ ImagingConvertTransparent(Imaging imIn, const Mode *mode, int r, int g, int b) {
 }
 
 Imaging
-ImagingConvertInPlace(Imaging imIn, const Mode *mode) {
+ImagingConvertInPlace(Imaging imIn, const ModeID mode) {
     ImagingSectionCookie cookie;
     ImagingShuffler convert;
     int y;
@@ -1644,155 +1773,3 @@ ImagingConvertInPlace(Imaging imIn, const Mode *mode) {
 
     return imIn;
 }
-
-/* ------------------ */
-/* Converter mappings */
-/* ------------------ */
-
-void
-ImagingConvertInit(void) {
-    const struct Converter temp[] = {
-        {IMAGING_MODE_1, IMAGING_MODE_L, bit2l},
-        {IMAGING_MODE_1, IMAGING_MODE_I, bit2i},
-        {IMAGING_MODE_1, IMAGING_MODE_F, bit2f},
-        {IMAGING_MODE_1, IMAGING_MODE_RGB, bit2rgb},
-        {IMAGING_MODE_1, IMAGING_MODE_RGBA, bit2rgb},
-        {IMAGING_MODE_1, IMAGING_MODE_RGBX, bit2rgb},
-        {IMAGING_MODE_1, IMAGING_MODE_CMYK, bit2cmyk},
-        {IMAGING_MODE_1, IMAGING_MODE_YCbCr, bit2ycbcr},
-        {IMAGING_MODE_1, IMAGING_MODE_HSV, bit2hsv},
-
-        {IMAGING_MODE_L, IMAGING_MODE_1, l2bit},
-        {IMAGING_MODE_L, IMAGING_MODE_LA, l2la},
-        {IMAGING_MODE_L, IMAGING_MODE_I, l2i},
-        {IMAGING_MODE_L, IMAGING_MODE_F, l2f},
-        {IMAGING_MODE_L, IMAGING_MODE_RGB, l2rgb},
-        {IMAGING_MODE_L, IMAGING_MODE_RGBA, l2rgb},
-        {IMAGING_MODE_L, IMAGING_MODE_RGBX, l2rgb},
-        {IMAGING_MODE_L, IMAGING_MODE_CMYK, l2cmyk},
-        {IMAGING_MODE_L, IMAGING_MODE_YCbCr, l2ycbcr},
-        {IMAGING_MODE_L, IMAGING_MODE_HSV, l2hsv},
-
-        {IMAGING_MODE_LA, IMAGING_MODE_L, la2l},
-        {IMAGING_MODE_LA, IMAGING_MODE_La, lA2la},
-        {IMAGING_MODE_LA, IMAGING_MODE_RGB, la2rgb},
-        {IMAGING_MODE_LA, IMAGING_MODE_RGBA, la2rgb},
-        {IMAGING_MODE_LA, IMAGING_MODE_RGBX, la2rgb},
-        {IMAGING_MODE_LA, IMAGING_MODE_CMYK, la2cmyk},
-        {IMAGING_MODE_LA, IMAGING_MODE_YCbCr, la2ycbcr},
-        {IMAGING_MODE_LA, IMAGING_MODE_HSV, la2hsv},
-
-        {IMAGING_MODE_La, IMAGING_MODE_LA, la2lA},
-
-        {IMAGING_MODE_I, IMAGING_MODE_L, i2l},
-        {IMAGING_MODE_I, IMAGING_MODE_F, i2f},
-        {IMAGING_MODE_I, IMAGING_MODE_RGB, i2rgb},
-        {IMAGING_MODE_I, IMAGING_MODE_RGBA, i2rgb},
-        {IMAGING_MODE_I, IMAGING_MODE_RGBX, i2rgb},
-        {IMAGING_MODE_I, IMAGING_MODE_HSV, i2hsv},
-
-        {IMAGING_MODE_F, IMAGING_MODE_L, f2l},
-        {IMAGING_MODE_F, IMAGING_MODE_I, f2i},
-
-        {IMAGING_MODE_RGB, IMAGING_MODE_1, rgb2bit},
-        {IMAGING_MODE_RGB, IMAGING_MODE_L, rgb2l},
-        {IMAGING_MODE_RGB, IMAGING_MODE_LA, rgb2la},
-        {IMAGING_MODE_RGB, IMAGING_MODE_La, rgb2la},
-        {IMAGING_MODE_RGB, IMAGING_MODE_I, rgb2i},
-        {IMAGING_MODE_RGB, IMAGING_MODE_I_16, rgb2i16l},
-        {IMAGING_MODE_RGB, IMAGING_MODE_I_16L, rgb2i16l},
-        {IMAGING_MODE_RGB, IMAGING_MODE_I_16B, rgb2i16b},
-#ifdef WORDS_BIGENDIAN
-        {IMAGING_MODE_RGB, IMAGING_MODE_I_16N, rgb2i16b},
-#else
-        {IMAGING_MODE_RGB, IMAGING_MODE_I_16N, rgb2i16l},
-#endif
-        {IMAGING_MODE_RGB, IMAGING_MODE_F, rgb2f},
-        {IMAGING_MODE_RGB, IMAGING_MODE_BGR_15, rgb2bgr15},
-        {IMAGING_MODE_RGB, IMAGING_MODE_BGR_16, rgb2bgr16},
-        {IMAGING_MODE_RGB, IMAGING_MODE_BGR_24, rgb2bgr24},
-        {IMAGING_MODE_RGB, IMAGING_MODE_RGBA, rgb2rgba},
-        {IMAGING_MODE_RGB, IMAGING_MODE_RGBa, rgb2rgba},
-        {IMAGING_MODE_RGB, IMAGING_MODE_RGBX, rgb2rgba},
-        {IMAGING_MODE_RGB, IMAGING_MODE_CMYK, rgb2cmyk},
-        {IMAGING_MODE_RGB, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
-        {IMAGING_MODE_RGB, IMAGING_MODE_HSV, rgb2hsv},
-
-        {IMAGING_MODE_RGBA, IMAGING_MODE_1, rgb2bit},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_L, rgb2l},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_LA, rgba2la},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_I, rgb2i},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_F, rgb2f},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_RGB, rgba2rgb},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_RGBa, rgbA2rgba},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_RGBX, rgb2rgba},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_CMYK, rgb2cmyk},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
-        {IMAGING_MODE_RGBA, IMAGING_MODE_HSV, rgb2hsv},
-
-        {IMAGING_MODE_RGBa, IMAGING_MODE_RGBA, rgba2rgbA},
-        {IMAGING_MODE_RGBa, IMAGING_MODE_RGB, rgba2rgb_},
-
-        {IMAGING_MODE_RGBX, IMAGING_MODE_1, rgb2bit},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_L, rgb2l},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_LA, rgb2la},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_I, rgb2i},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_F, rgb2f},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_RGB, rgba2rgb},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_CMYK, rgb2cmyk},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_YCbCr, ImagingConvertRGB2YCbCr},
-        {IMAGING_MODE_RGBX, IMAGING_MODE_HSV, rgb2hsv},
-
-        {IMAGING_MODE_CMYK, IMAGING_MODE_RGB, cmyk2rgb},
-        {IMAGING_MODE_CMYK, IMAGING_MODE_RGBA, cmyk2rgb},
-        {IMAGING_MODE_CMYK, IMAGING_MODE_RGBX, cmyk2rgb},
-        {IMAGING_MODE_CMYK, IMAGING_MODE_HSV, cmyk2hsv},
-
-        {IMAGING_MODE_YCbCr, IMAGING_MODE_L, ycbcr2l},
-        {IMAGING_MODE_YCbCr, IMAGING_MODE_LA, ycbcr2la},
-        {IMAGING_MODE_YCbCr, IMAGING_MODE_RGB, ImagingConvertYCbCr2RGB},
-
-        {IMAGING_MODE_HSV, IMAGING_MODE_RGB, hsv2rgb},
-
-        {IMAGING_MODE_I, IMAGING_MODE_I_16, I_I16L},
-        {IMAGING_MODE_I_16, IMAGING_MODE_I, I16L_I},
-        {IMAGING_MODE_I_16, IMAGING_MODE_RGB, I16_RGB},
-        {IMAGING_MODE_L, IMAGING_MODE_I_16, L_I16L},
-        {IMAGING_MODE_I_16, IMAGING_MODE_L, I16L_L},
-
-        {IMAGING_MODE_I, IMAGING_MODE_I_16L, I_I16L},
-        {IMAGING_MODE_I_16L, IMAGING_MODE_I, I16L_I},
-        {IMAGING_MODE_I, IMAGING_MODE_I_16B, I_I16B},
-        {IMAGING_MODE_I_16B, IMAGING_MODE_I, I16B_I},
-
-        {IMAGING_MODE_L, IMAGING_MODE_I_16L, L_I16L},
-        {IMAGING_MODE_I_16L, IMAGING_MODE_L, I16L_L},
-        {IMAGING_MODE_L, IMAGING_MODE_I_16B, L_I16B},
-        {IMAGING_MODE_I_16B, IMAGING_MODE_L, I16B_L},
-#ifdef WORDS_BIGENDIAN
-        {IMAGING_MODE_L, IMAGING_MODE_I_16N, L_I16B},
-        {IMAGING_MODE_I_16N, IMAGING_MODE_L, I16B_L},
-#else
-        {IMAGING_MODE_L, IMAGING_MODE_I_16N, L_I16L},
-        {IMAGING_MODE_I_16N, IMAGING_MODE_L, I16L_L},
-#endif
-
-        {IMAGING_MODE_I_16, IMAGING_MODE_F, I16L_F},
-        {IMAGING_MODE_I_16L, IMAGING_MODE_F, I16L_F},
-        {IMAGING_MODE_I_16B, IMAGING_MODE_F, I16B_F},
-
-        {NULL}
-    };
-    converters = malloc(sizeof(temp));
-    if (converters == NULL) {
-        fprintf(stderr, "ConvertInit: failed to allocate memory for converter table\n");
-        exit(1);
-    }
-    memcpy(converters, temp, sizeof(temp));
-}
-
-void
-ImagingConvertFree(void) {
-    free(converters);
-    converters = NULL;
-}
diff --git a/src/libImaging/Dib.c b/src/libImaging/Dib.c
index 154c610ec22..2afe71d4ac9 100644
--- a/src/libImaging/Dib.c
+++ b/src/libImaging/Dib.c
@@ -25,13 +25,13 @@
 
 #include "ImDib.h"
 
-const Mode *
+ModeID
 ImagingGetModeDIB(int size_out[2]) {
     /* Get device characteristics */
 
     const HDC dc = CreateCompatibleDC(NULL);
 
-    const Mode *mode = IMAGING_MODE_P;
+    ModeID mode = IMAGING_MODE_P;
     if (!(GetDeviceCaps(dc, RASTERCAPS) & RC_PALETTE)) {
         mode = IMAGING_MODE_RGB;
         if (GetDeviceCaps(dc, BITSPIXEL) == 1) {
@@ -50,7 +50,7 @@ ImagingGetModeDIB(int size_out[2]) {
 }
 
 ImagingDIB
-ImagingNewDIB(const Mode * const mode, int xsize, int ysize) {
+ImagingNewDIB(const ModeID mode, int xsize, int ysize) {
     /* Create a Windows bitmap */
 
     ImagingDIB dib;
diff --git a/src/libImaging/Fill.c b/src/libImaging/Fill.c
index 854cdb9fe93..0224d1ba95e 100644
--- a/src/libImaging/Fill.c
+++ b/src/libImaging/Fill.c
@@ -68,7 +68,7 @@ ImagingFill(Imaging im, const void *colour) {
 }
 
 Imaging
-ImagingFillLinearGradient(const Mode *mode) {
+ImagingFillLinearGradient(const ModeID mode) {
     Imaging im;
     int y;
 
@@ -105,7 +105,7 @@ ImagingFillLinearGradient(const Mode *mode) {
 }
 
 Imaging
-ImagingFillRadialGradient(const Mode *mode) {
+ImagingFillRadialGradient(const ModeID mode) {
     Imaging im;
     int x, y;
     int d;
diff --git a/src/libImaging/ImDib.h b/src/libImaging/ImDib.h
index 6d8f420cb5c..65f090f928a 100644
--- a/src/libImaging/ImDib.h
+++ b/src/libImaging/ImDib.h
@@ -27,7 +27,7 @@ struct ImagingDIBInstance {
     UINT8 *bits;
     HPALETTE palette;
     /* Used by cut and paste */
-    const Mode *mode;
+    ModeID mode;
     int xsize, ysize;
     int pixelsize;
     int linesize;
@@ -37,11 +37,11 @@ struct ImagingDIBInstance {
 
 typedef struct ImagingDIBInstance *ImagingDIB;
 
-extern const Mode *
+extern ModeID
 ImagingGetModeDIB(int size_out[2]);
 
 extern ImagingDIB
-ImagingNewDIB(const Mode * const mode, int xsize, int ysize);
+ImagingNewDIB(ModeID mode, int xsize, int ysize);
 
 extern void
 ImagingDeleteDIB(ImagingDIB im);
diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index 9f450dd3ad2..290a76c8e7d 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -79,11 +79,11 @@ typedef struct {
 
 struct ImagingMemoryInstance {
     /* Format */
-    const Mode *mode; /* Image mode (IMAGING_MODE_*) */
-    int type;  /* Data type (IMAGING_TYPE_*) */
-    int depth; /* Depth (ignored in this version) */
-    int bands; /* Number of bands (1, 2, 3, or 4) */
-    int xsize; /* Image dimension. */
+    ModeID mode; /* Image mode (IMAGING_MODE_*) */
+    int type;    /* Data type (IMAGING_TYPE_*) */
+    int depth;   /* Depth (ignored in this version) */
+    int bands;   /* Number of bands (1, 2, 3, or 4) */
+    int xsize;   /* Image dimension. */
     int ysize;
 
     /* Colour palette (for "P" images only) */
@@ -137,15 +137,15 @@ struct ImagingMemoryInstance {
 #define IMAGING_PIXEL_FLOAT32(im, x, y) (((FLOAT32 *)(im)->image32[y])[x])
 
 struct ImagingAccessInstance {
-    const Mode *mode;
+    ModeID mode;
     void (*get_pixel)(Imaging im, int x, int y, void *pixel);
     void (*put_pixel)(Imaging im, int x, int y, const void *pixel);
 };
 
 struct ImagingHistogramInstance {
     /* Format */
-    const Mode *mode; /* Mode of corresponding source image */
-    int bands; /* Number of bands (1, 3, or 4) */
+    ModeID mode; /* Mode ID of corresponding source image */
+    int bands;   /* Number of bands (1, 3, or 4) */
 
     /* Data */
     long *histogram; /* Histogram (bands*256 longs) */
@@ -153,7 +153,7 @@ struct ImagingHistogramInstance {
 
 struct ImagingPaletteInstance {
     /* Format */
-    const Mode *mode;
+    ModeID mode;
 
     /* Data */
     int size;
@@ -181,29 +181,6 @@ typedef struct ImagingMemoryArena {
 #endif
 } *ImagingMemoryArena;
 
-/* Memory Management */
-/* ----------------- */
-
-extern void
-ImagingAccessInit(void);
-extern void
-ImagingAccessFree(void);
-
-extern void
-ImagingConvertInit(void);
-extern void
-ImagingConvertFree(void);
-
-extern void
-ImagingPackInit(void);
-extern void
-ImagingPackFree(void);
-
-extern void
-ImagingUnpackInit(void);
-extern void
-ImagingUnpackFree(void);
-
 /* Objects */
 /* ------- */
 
@@ -216,20 +193,20 @@ extern void
 ImagingMemorySetBlockAllocator(ImagingMemoryArena arena, int use_block_allocator);
 
 extern Imaging
-ImagingNew(const Mode *mode, int xsize, int ysize);
+ImagingNew(ModeID mode, int xsize, int ysize);
 extern Imaging
-ImagingNewDirty(const Mode *mode, int xsize, int ysize);
+ImagingNewDirty(ModeID mode, int xsize, int ysize);
 extern Imaging
-ImagingNew2Dirty(const Mode *mode, Imaging imOut, Imaging imIn);
+ImagingNew2Dirty(ModeID mode, Imaging imOut, Imaging imIn);
 extern void
 ImagingDelete(Imaging im);
 
 extern Imaging
-ImagingNewBlock(const Mode *mode, int xsize, int ysize);
+ImagingNewBlock(ModeID mode, int xsize, int ysize);
 
 extern Imaging
 ImagingNewArrow(
-    const char *mode,
+    const ModeID mode,
     int xsize,
     int ysize,
     PyObject *schema_capsule,
@@ -237,9 +214,9 @@ ImagingNewArrow(
 );
 
 extern Imaging
-ImagingNewPrologue(const Mode *mode, int xsize, int ysize);
+ImagingNewPrologue(ModeID mode, int xsize, int ysize);
 extern Imaging
-ImagingNewPrologueSubtype(const Mode *mode, int xsize, int ysize, int structure_size);
+ImagingNewPrologueSubtype(ModeID mode, int xsize, int ysize, int structure_size);
 
 extern void
 ImagingCopyPalette(Imaging destination, Imaging source);
@@ -254,7 +231,7 @@ _ImagingAccessDelete(Imaging im, ImagingAccess access);
 #define ImagingAccessDelete(im, access) /* nop, for now */
 
 extern ImagingPalette
-ImagingPaletteNew(const Mode *mode);
+ImagingPaletteNew(ModeID mode);
 extern ImagingPalette
 ImagingPaletteNewBrowser(void);
 extern ImagingPalette
@@ -326,13 +303,13 @@ ImagingBlend(Imaging imIn1, Imaging imIn2, float alpha);
 extern Imaging
 ImagingCopy(Imaging im);
 extern Imaging
-ImagingConvert(Imaging im, const Mode *mode, ImagingPalette palette, int dither);
+ImagingConvert(Imaging im, ModeID mode, ImagingPalette palette, int dither);
 extern Imaging
-ImagingConvertInPlace(Imaging im, const Mode *mode);
+ImagingConvertInPlace(Imaging im, ModeID mode);
 extern Imaging
-ImagingConvertMatrix(Imaging im, const Mode *mode, float m[]);
+ImagingConvertMatrix(Imaging im, ModeID mode, float m[]);
 extern Imaging
-ImagingConvertTransparent(Imaging im, const Mode *mode, int r, int g, int b);
+ImagingConvertTransparent(Imaging im, ModeID mode, int r, int g, int b);
 extern Imaging
 ImagingCrop(Imaging im, int x0, int y0, int x1, int y1);
 extern Imaging
@@ -346,9 +323,9 @@ ImagingFill2(
 extern Imaging
 ImagingFillBand(Imaging im, int band, int color);
 extern Imaging
-ImagingFillLinearGradient(const Mode *mode);
+ImagingFillLinearGradient(ModeID mode);
 extern Imaging
-ImagingFillRadialGradient(const Mode *mode);
+ImagingFillRadialGradient(ModeID mode);
 extern Imaging
 ImagingFilter(Imaging im, int xsize, int ysize, const FLOAT32 *kernel, FLOAT32 offset);
 extern Imaging
@@ -362,7 +339,7 @@ ImagingGaussianBlur(
 extern Imaging
 ImagingGetBand(Imaging im, int band);
 extern Imaging
-ImagingMerge(const Mode *mode, Imaging bands[4]);
+ImagingMerge(ModeID mode, Imaging bands[4]);
 extern int
 ImagingSplit(Imaging im, Imaging bands[4]);
 extern int
@@ -389,7 +366,7 @@ ImagingOffset(Imaging im, int xoffset, int yoffset);
 extern int
 ImagingPaste(Imaging into, Imaging im, Imaging mask, int x0, int y0, int x1, int y1);
 extern Imaging
-ImagingPoint(Imaging im, const Mode *tablemode, const void *table);
+ImagingPoint(Imaging im, ModeID tablemode, const void *table);
 extern Imaging
 ImagingPointTransform(Imaging imIn, double scale, double offset);
 extern Imaging
@@ -730,9 +707,9 @@ extern void
 ImagingConvertYCbCr2RGB(UINT8 *out, const UINT8 *in, int pixels);
 
 extern ImagingShuffler
-ImagingFindUnpacker(const Mode *mode, const RawMode *rawmode, int *bits_out);
+ImagingFindUnpacker(ModeID mode, RawModeID rawmode, int *bits_out);
 extern ImagingShuffler
-ImagingFindPacker(const Mode *mode, const RawMode *rawmode, int *bits_out);
+ImagingFindPacker(ModeID mode, RawModeID rawmode, int *bits_out);
 
 struct ImagingCodecStateInstance {
     int count;
diff --git a/src/libImaging/Jpeg.h b/src/libImaging/Jpeg.h
index 48c6c618411..e07904fc70c 100644
--- a/src/libImaging/Jpeg.h
+++ b/src/libImaging/Jpeg.h
@@ -28,12 +28,12 @@ typedef struct {
 typedef struct {
     /* CONFIGURATION */
 
-    /* Jpeg file mode (NULL if not known) */
-    const RawMode *jpegmode;
+    /* Jpeg file mode */
+    RawModeID jpegmode;
 
     /* Converter output mode (input to the shuffler) */
-    /* If NULL, convert conversions are disabled */
-    const RawMode *rawmode;
+    /* If not a valid mode, convert conversions are disabled */
+    RawModeID rawmode;
 
     /* If set, trade quality for speed */
     int draft;
@@ -91,7 +91,7 @@ typedef struct {
     unsigned int restart_marker_rows;
 
     /* Converter input mode (input to the shuffler) */
-    const RawMode *rawmode;
+    RawModeID rawmode;
 
     /* Custom quantization tables () */
     unsigned int *qtables;
diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index 3cbe2965df9..67f705ddd59 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -771,7 +771,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
         if (color_space == j2k_unpackers[n].color_space &&
             image->numcomps == j2k_unpackers[n].components &&
             (j2k_unpackers[n].subsampling || (subsampling == -1)) &&
-            strcmp(im->mode->name, j2k_unpackers[n].mode) == 0) {
+            strcmp(getModeData(im->mode)->name, j2k_unpackers[n].mode) == 0) {
             unpack = j2k_unpackers[n].unpacker;
             break;
         }
diff --git a/src/libImaging/JpegDecode.c b/src/libImaging/JpegDecode.c
index 49d4fcb2f8a..ae3274456d3 100644
--- a/src/libImaging/JpegDecode.c
+++ b/src/libImaging/JpegDecode.c
@@ -180,8 +180,8 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
 
             /* Decoder settings */
 
-            /* jpegmode indicates what's in the file; if not set, we'll
-               trust the decoder */
+            /* jpegmode indicates what's in the file. */
+            /* If not valid, we'll trust the decoder. */
             if (context->jpegmode == IMAGING_RAWMODE_L) {
                 context->cinfo.jpeg_color_space = JCS_GRAYSCALE;
             } else if (context->jpegmode == IMAGING_RAWMODE_RGB) {
@@ -194,8 +194,8 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
                 context->cinfo.jpeg_color_space = JCS_YCCK;
             }
 
-            /* rawmode indicates what we want from the decoder.  if not
-               set, conversions are disabled */
+            /* rawmode indicates what we want from the decoder. */
+            /* If not valid, conversions are disabled. */
             if (context->rawmode == IMAGING_RAWMODE_L) {
                 context->cinfo.out_color_space = JCS_GRAYSCALE;
             } else if (context->rawmode == IMAGING_RAWMODE_RGB) {
@@ -214,7 +214,7 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
             } else if (context->rawmode == IMAGING_RAWMODE_YCbCrK) {
                 context->cinfo.out_color_space = JCS_YCCK;
             } else {
-                /* Disable decoder conversions */
+                /* Disable decoder conversions. */
                 context->cinfo.jpeg_color_space = JCS_UNKNOWN;
                 context->cinfo.out_color_space = JCS_UNKNOWN;
             }
diff --git a/src/libImaging/Matrix.c b/src/libImaging/Matrix.c
index f848b870d05..6bc9fbc1de2 100644
--- a/src/libImaging/Matrix.c
+++ b/src/libImaging/Matrix.c
@@ -18,7 +18,7 @@
 #define CLIPF(v) ((v <= 0.0) ? 0 : (v >= 255.0F) ? 255 : (UINT8)v)
 
 Imaging
-ImagingConvertMatrix(Imaging im, const Mode *mode, float m[]) {
+ImagingConvertMatrix(Imaging im, const ModeID mode, float m[]) {
     Imaging imOut;
     int x, y;
     ImagingSectionCookie cookie;
diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 01b2b55015a..659e7aada49 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -2,453 +2,258 @@
 #include <string.h>
 
 
-#define CREATE_MODE(TYPE, NAME, INIT) \
-const TYPE IMAGING_##NAME##_VAL = INIT;\
-const TYPE * const IMAGING_##NAME = &IMAGING_##NAME##_VAL;
+const ModeData MODES[] = {
+    [IMAGING_MODE_UNKNOWN] = {""},
 
+    [IMAGING_MODE_1] = {"1"},
+    [IMAGING_MODE_CMYK] = {"CMYK"},
+    [IMAGING_MODE_F] = {"F"},
+    [IMAGING_MODE_HSV] = {"HSV"},
+    [IMAGING_MODE_I] = {"I"},
+    [IMAGING_MODE_L] = {"L"},
+    [IMAGING_MODE_LA] = {"LA"},
+    [IMAGING_MODE_LAB] = {"LAB"},
+    [IMAGING_MODE_La] = {"La"},
+    [IMAGING_MODE_P] = {"P"},
+    [IMAGING_MODE_PA] = {"PA"},
+    [IMAGING_MODE_RGB] = {"RGB"},
+    [IMAGING_MODE_RGBA] = {"RGBA"},
+    [IMAGING_MODE_RGBX] = {"RGBX"},
+    [IMAGING_MODE_RGBa] = {"RGBa"},
+    [IMAGING_MODE_YCbCr] = {"YCbCr"},
 
-CREATE_MODE(Mode, MODE_1, {"1"})
-CREATE_MODE(Mode, MODE_CMYK, {"CMYK"})
-CREATE_MODE(Mode, MODE_F, {"F"})
-CREATE_MODE(Mode, MODE_HSV, {"HSV"})
-CREATE_MODE(Mode, MODE_I, {"I"})
-CREATE_MODE(Mode, MODE_L, {"L"})
-CREATE_MODE(Mode, MODE_LA, {"LA"})
-CREATE_MODE(Mode, MODE_LAB, {"LAB"})
-CREATE_MODE(Mode, MODE_La, {"La"})
-CREATE_MODE(Mode, MODE_P, {"P"})
-CREATE_MODE(Mode, MODE_PA, {"PA"})
-CREATE_MODE(Mode, MODE_RGB, {"RGB"})
-CREATE_MODE(Mode, MODE_RGBA, {"RGBA"})
-CREATE_MODE(Mode, MODE_RGBX, {"RGBX"})
-CREATE_MODE(Mode, MODE_RGBa, {"RGBa"})
-CREATE_MODE(Mode, MODE_YCbCr, {"YCbCr"})
+    [IMAGING_MODE_BGR_15] = {"BGR;15"},
+    [IMAGING_MODE_BGR_16] = {"BGR;16"},
+    [IMAGING_MODE_BGR_24] = {"BGR;24"},
 
-CREATE_MODE(Mode, MODE_BGR_15, {"BGR;15"})
-CREATE_MODE(Mode, MODE_BGR_16, {"BGR;16"})
-CREATE_MODE(Mode, MODE_BGR_24, {"BGR;24"})
-
-CREATE_MODE(Mode, MODE_I_16, {"I;16"})
-CREATE_MODE(Mode, MODE_I_16L, {"I;16L"})
-CREATE_MODE(Mode, MODE_I_16B, {"I;16B"})
-CREATE_MODE(Mode, MODE_I_16N, {"I;16N"})
-CREATE_MODE(Mode, MODE_I_32L, {"I;32L"})
-CREATE_MODE(Mode, MODE_I_32B, {"I;32B"})
-
-const Mode * const MODES[] = {
-    IMAGING_MODE_1,
-    IMAGING_MODE_CMYK,
-    IMAGING_MODE_F,
-    IMAGING_MODE_HSV,
-    IMAGING_MODE_I,
-    IMAGING_MODE_L,
-    IMAGING_MODE_LA,
-    IMAGING_MODE_LAB,
-    IMAGING_MODE_La,
-    IMAGING_MODE_P,
-    IMAGING_MODE_PA,
-    IMAGING_MODE_RGB,
-    IMAGING_MODE_RGBA,
-    IMAGING_MODE_RGBX,
-    IMAGING_MODE_RGBa,
-    IMAGING_MODE_YCbCr,
-
-    IMAGING_MODE_BGR_15,
-    IMAGING_MODE_BGR_16,
-    IMAGING_MODE_BGR_24,
-
-    IMAGING_MODE_I_16,
-    IMAGING_MODE_I_16L,
-    IMAGING_MODE_I_16B,
-    IMAGING_MODE_I_16N,
-    IMAGING_MODE_I_32L,
-    IMAGING_MODE_I_32B,
-
-    NULL
+    [IMAGING_MODE_I_16] = {"I;16"},
+    [IMAGING_MODE_I_16L] = {"I;16L"},
+    [IMAGING_MODE_I_16B] = {"I;16B"},
+    [IMAGING_MODE_I_16N] = {"I;16N"},
+    [IMAGING_MODE_I_32L] = {"I;32L"},
+    [IMAGING_MODE_I_32B] = {"I;32B"},
 };
 
-const Mode * findMode(const char * const name) {
+const ModeID findModeID(const char * const name) {
     if (name == NULL) {
-        return NULL;
+        return IMAGING_MODE_UNKNOWN;
     }
-    const Mode * mode;
-    for (int i = 0; (mode = MODES[i]); i++) {
-        if (strcmp(mode->name, name) == 0) {
-            return mode;
+    for (size_t i = 0; i < sizeof(MODES) / sizeof(*MODES); i++) {
+        if (strcmp(MODES[i].name, name) == 0) {
+            return (ModeID)i;
         }
     }
-    return NULL;
+    return IMAGING_MODE_UNKNOWN;
 }
 
+const ModeData * const getModeData(const ModeID id) {
+    if (id < 0 || id > sizeof(MODES) / sizeof(*MODES)) {
+        return &MODES[IMAGING_MODE_UNKNOWN];
+    }
+    return &MODES[id];
+}
 
-// Alias all of the modes as rawmodes so that the addresses are the same.
-#define ALIAS_MODE_AS_RAWMODE(NAME) const RawMode * const IMAGING_RAWMODE_##NAME = (const RawMode * const)IMAGING_MODE_##NAME;
-ALIAS_MODE_AS_RAWMODE(1)
-ALIAS_MODE_AS_RAWMODE(CMYK)
-ALIAS_MODE_AS_RAWMODE(F)
-ALIAS_MODE_AS_RAWMODE(HSV)
-ALIAS_MODE_AS_RAWMODE(I)
-ALIAS_MODE_AS_RAWMODE(L)
-ALIAS_MODE_AS_RAWMODE(LA)
-ALIAS_MODE_AS_RAWMODE(LAB)
-ALIAS_MODE_AS_RAWMODE(La)
-ALIAS_MODE_AS_RAWMODE(P)
-ALIAS_MODE_AS_RAWMODE(PA)
-ALIAS_MODE_AS_RAWMODE(RGB)
-ALIAS_MODE_AS_RAWMODE(RGBA)
-ALIAS_MODE_AS_RAWMODE(RGBX)
-ALIAS_MODE_AS_RAWMODE(RGBa)
-ALIAS_MODE_AS_RAWMODE(YCbCr)
-
-ALIAS_MODE_AS_RAWMODE(BGR_15)
-ALIAS_MODE_AS_RAWMODE(BGR_16)
-ALIAS_MODE_AS_RAWMODE(BGR_24)
-
-ALIAS_MODE_AS_RAWMODE(I_16)
-ALIAS_MODE_AS_RAWMODE(I_16L)
-ALIAS_MODE_AS_RAWMODE(I_16B)
-ALIAS_MODE_AS_RAWMODE(I_16N)
-ALIAS_MODE_AS_RAWMODE(I_32L)
-ALIAS_MODE_AS_RAWMODE(I_32B)
-
-CREATE_MODE(RawMode, RAWMODE_1_8, {"1;8"})
-CREATE_MODE(RawMode, RAWMODE_1_I, {"1;I"})
-CREATE_MODE(RawMode, RAWMODE_1_IR, {"1;IR"})
-CREATE_MODE(RawMode, RAWMODE_1_R, {"1;R"})
-CREATE_MODE(RawMode, RAWMODE_A, {"A"})
-CREATE_MODE(RawMode, RAWMODE_ABGR, {"ABGR"})
-CREATE_MODE(RawMode, RAWMODE_ARGB, {"ARGB"})
-CREATE_MODE(RawMode, RAWMODE_A_16B, {"A;16B"})
-CREATE_MODE(RawMode, RAWMODE_A_16L, {"A;16L"})
-CREATE_MODE(RawMode, RAWMODE_A_16N, {"A;16N"})
-CREATE_MODE(RawMode, RAWMODE_B, {"B"})
-CREATE_MODE(RawMode, RAWMODE_BGAR, {"BGAR"})
-CREATE_MODE(RawMode, RAWMODE_BGR, {"BGR"})
-CREATE_MODE(RawMode, RAWMODE_BGRA, {"BGRA"})
-CREATE_MODE(RawMode, RAWMODE_BGRA_15, {"BGRA;15"})
-CREATE_MODE(RawMode, RAWMODE_BGRA_15Z, {"BGRA;15Z"})
-CREATE_MODE(RawMode, RAWMODE_BGRA_16B, {"BGRA;16B"})
-CREATE_MODE(RawMode, RAWMODE_BGRA_16L, {"BGRA;16L"})
-CREATE_MODE(RawMode, RAWMODE_BGRX, {"BGRX"})
-CREATE_MODE(RawMode, RAWMODE_BGR_5, {"BGR;5"})
-CREATE_MODE(RawMode, RAWMODE_BGRa, {"BGRa"})
-CREATE_MODE(RawMode, RAWMODE_BGXR, {"BGXR"})
-CREATE_MODE(RawMode, RAWMODE_B_16B, {"B;16B"})
-CREATE_MODE(RawMode, RAWMODE_B_16L, {"B;16L"})
-CREATE_MODE(RawMode, RAWMODE_B_16N, {"B;16N"})
-CREATE_MODE(RawMode, RAWMODE_C, {"C"})
-CREATE_MODE(RawMode, RAWMODE_CMYKX, {"CMYKX"})
-CREATE_MODE(RawMode, RAWMODE_CMYKXX, {"CMYKXX"})
-CREATE_MODE(RawMode, RAWMODE_CMYK_16B, {"CMYK;16B"})
-CREATE_MODE(RawMode, RAWMODE_CMYK_16L, {"CMYK;16L"})
-CREATE_MODE(RawMode, RAWMODE_CMYK_16N, {"CMYK;16N"})
-CREATE_MODE(RawMode, RAWMODE_CMYK_I, {"CMYK;I"})
-CREATE_MODE(RawMode, RAWMODE_CMYK_L, {"CMYK;L"})
-CREATE_MODE(RawMode, RAWMODE_C_I, {"C;I"})
-CREATE_MODE(RawMode, RAWMODE_Cb, {"Cb"})
-CREATE_MODE(RawMode, RAWMODE_Cr, {"Cr"})
-CREATE_MODE(RawMode, RAWMODE_F_16, {"F;16"})
-CREATE_MODE(RawMode, RAWMODE_F_16B, {"F;16B"})
-CREATE_MODE(RawMode, RAWMODE_F_16BS, {"F;16BS"})
-CREATE_MODE(RawMode, RAWMODE_F_16N, {"F;16N"})
-CREATE_MODE(RawMode, RAWMODE_F_16NS, {"F;16NS"})
-CREATE_MODE(RawMode, RAWMODE_F_16S, {"F;16S"})
-CREATE_MODE(RawMode, RAWMODE_F_32, {"F;32"})
-CREATE_MODE(RawMode, RAWMODE_F_32B, {"F;32B"})
-CREATE_MODE(RawMode, RAWMODE_F_32BF, {"F;32BF"})
-CREATE_MODE(RawMode, RAWMODE_F_32BS, {"F;32BS"})
-CREATE_MODE(RawMode, RAWMODE_F_32F, {"F;32F"})
-CREATE_MODE(RawMode, RAWMODE_F_32N, {"F;32N"})
-CREATE_MODE(RawMode, RAWMODE_F_32NF, {"F;32NF"})
-CREATE_MODE(RawMode, RAWMODE_F_32NS, {"F;32NS"})
-CREATE_MODE(RawMode, RAWMODE_F_32S, {"F;32S"})
-CREATE_MODE(RawMode, RAWMODE_F_64BF, {"F;64BF"})
-CREATE_MODE(RawMode, RAWMODE_F_64F, {"F;64F"})
-CREATE_MODE(RawMode, RAWMODE_F_64NF, {"F;64NF"})
-CREATE_MODE(RawMode, RAWMODE_F_8, {"F;8"})
-CREATE_MODE(RawMode, RAWMODE_F_8S, {"F;8S"})
-CREATE_MODE(RawMode, RAWMODE_G, {"G"})
-CREATE_MODE(RawMode, RAWMODE_G_16B, {"G;16B"})
-CREATE_MODE(RawMode, RAWMODE_G_16L, {"G;16L"})
-CREATE_MODE(RawMode, RAWMODE_G_16N, {"G;16N"})
-CREATE_MODE(RawMode, RAWMODE_H, {"H"})
-CREATE_MODE(RawMode, RAWMODE_I_12, {"I;12"})
-CREATE_MODE(RawMode, RAWMODE_I_16BS, {"I;16BS"})
-CREATE_MODE(RawMode, RAWMODE_I_16NS, {"I;16NS"})
-CREATE_MODE(RawMode, RAWMODE_I_16R, {"I;16R"})
-CREATE_MODE(RawMode, RAWMODE_I_16S, {"I;16S"})
-CREATE_MODE(RawMode, RAWMODE_I_32, {"I;32"})
-CREATE_MODE(RawMode, RAWMODE_I_32BS, {"I;32BS"})
-CREATE_MODE(RawMode, RAWMODE_I_32N, {"I;32N"})
-CREATE_MODE(RawMode, RAWMODE_I_32NS, {"I;32NS"})
-CREATE_MODE(RawMode, RAWMODE_I_32S, {"I;32S"})
-CREATE_MODE(RawMode, RAWMODE_I_8, {"I;8"})
-CREATE_MODE(RawMode, RAWMODE_I_8S, {"I;8S"})
-CREATE_MODE(RawMode, RAWMODE_K, {"K"})
-CREATE_MODE(RawMode, RAWMODE_K_I, {"K;I"})
-CREATE_MODE(RawMode, RAWMODE_LA_16B, {"LA;16B"})
-CREATE_MODE(RawMode, RAWMODE_LA_L, {"LA;L"})
-CREATE_MODE(RawMode, RAWMODE_L_16, {"L;16"})
-CREATE_MODE(RawMode, RAWMODE_L_16B, {"L;16B"})
-CREATE_MODE(RawMode, RAWMODE_L_2, {"L;2"})
-CREATE_MODE(RawMode, RAWMODE_L_2I, {"L;2I"})
-CREATE_MODE(RawMode, RAWMODE_L_2IR, {"L;2IR"})
-CREATE_MODE(RawMode, RAWMODE_L_2R, {"L;2R"})
-CREATE_MODE(RawMode, RAWMODE_L_4, {"L;4"})
-CREATE_MODE(RawMode, RAWMODE_L_4I, {"L;4I"})
-CREATE_MODE(RawMode, RAWMODE_L_4IR, {"L;4IR"})
-CREATE_MODE(RawMode, RAWMODE_L_4R, {"L;4R"})
-CREATE_MODE(RawMode, RAWMODE_L_I, {"L;I"})
-CREATE_MODE(RawMode, RAWMODE_L_R, {"L;R"})
-CREATE_MODE(RawMode, RAWMODE_M, {"M"})
-CREATE_MODE(RawMode, RAWMODE_M_I, {"M;I"})
-CREATE_MODE(RawMode, RAWMODE_PA_L, {"PA;L"})
-CREATE_MODE(RawMode, RAWMODE_PX, {"PX"})
-CREATE_MODE(RawMode, RAWMODE_P_1, {"P;1"})
-CREATE_MODE(RawMode, RAWMODE_P_2, {"P;2"})
-CREATE_MODE(RawMode, RAWMODE_P_2L, {"P;2L"})
-CREATE_MODE(RawMode, RAWMODE_P_4, {"P;4"})
-CREATE_MODE(RawMode, RAWMODE_P_4L, {"P;4L"})
-CREATE_MODE(RawMode, RAWMODE_P_R, {"P;R"})
-CREATE_MODE(RawMode, RAWMODE_R, {"R"})
-CREATE_MODE(RawMode, RAWMODE_RGBAX, {"RGBAX"})
-CREATE_MODE(RawMode, RAWMODE_RGBAXX, {"RGBAXX"})
-CREATE_MODE(RawMode, RAWMODE_RGBA_15, {"RGBA;15"})
-CREATE_MODE(RawMode, RAWMODE_RGBA_16B, {"RGBA;16B"})
-CREATE_MODE(RawMode, RAWMODE_RGBA_16L, {"RGBA;16L"})
-CREATE_MODE(RawMode, RAWMODE_RGBA_16N, {"RGBA;16N"})
-CREATE_MODE(RawMode, RAWMODE_RGBA_4B, {"RGBA;4B"})
-CREATE_MODE(RawMode, RAWMODE_RGBA_I, {"RGBA;I"})
-CREATE_MODE(RawMode, RAWMODE_RGBA_L, {"RGBA;L"})
-CREATE_MODE(RawMode, RAWMODE_RGBXX, {"RGBXX"})
-CREATE_MODE(RawMode, RAWMODE_RGBXXX, {"RGBXXX"})
-CREATE_MODE(RawMode, RAWMODE_RGBX_16B, {"RGBX;16B"})
-CREATE_MODE(RawMode, RAWMODE_RGBX_16L, {"RGBX;16L"})
-CREATE_MODE(RawMode, RAWMODE_RGBX_16N, {"RGBX;16N"})
-CREATE_MODE(RawMode, RAWMODE_RGBX_L, {"RGBX;L"})
-CREATE_MODE(RawMode, RAWMODE_RGB_15, {"RGB;15"})
-CREATE_MODE(RawMode, RAWMODE_RGB_16, {"RGB;16"})
-CREATE_MODE(RawMode, RAWMODE_RGB_16B, {"RGB;16B"})
-CREATE_MODE(RawMode, RAWMODE_RGB_16L, {"RGB;16L"})
-CREATE_MODE(RawMode, RAWMODE_RGB_16N, {"RGB;16N"})
-CREATE_MODE(RawMode, RAWMODE_RGB_4B, {"RGB;4B"})
-CREATE_MODE(RawMode, RAWMODE_RGB_L, {"RGB;L"})
-CREATE_MODE(RawMode, RAWMODE_RGB_R, {"RGB;R"})
-CREATE_MODE(RawMode, RAWMODE_RGBaX, {"RGBaX"})
-CREATE_MODE(RawMode, RAWMODE_RGBaXX, {"RGBaXX"})
-CREATE_MODE(RawMode, RAWMODE_RGBa_16B, {"RGBa;16B"})
-CREATE_MODE(RawMode, RAWMODE_RGBa_16L, {"RGBa;16L"})
-CREATE_MODE(RawMode, RAWMODE_RGBa_16N, {"RGBa;16N"})
-CREATE_MODE(RawMode, RAWMODE_R_16B, {"R;16B"})
-CREATE_MODE(RawMode, RAWMODE_R_16L, {"R;16L"})
-CREATE_MODE(RawMode, RAWMODE_R_16N, {"R;16N"})
-CREATE_MODE(RawMode, RAWMODE_S, {"S"})
-CREATE_MODE(RawMode, RAWMODE_V, {"V"})
-CREATE_MODE(RawMode, RAWMODE_X, {"X"})
-CREATE_MODE(RawMode, RAWMODE_XBGR, {"XBGR"})
-CREATE_MODE(RawMode, RAWMODE_XRGB, {"XRGB"})
-CREATE_MODE(RawMode, RAWMODE_Y, {"Y"})
-CREATE_MODE(RawMode, RAWMODE_YCCA_P, {"YCCA;P"})
-CREATE_MODE(RawMode, RAWMODE_YCC_P, {"YCC;P"})
-CREATE_MODE(RawMode, RAWMODE_YCbCrK, {"YCbCrK"})
-CREATE_MODE(RawMode, RAWMODE_YCbCrX, {"YCbCrX"})
-CREATE_MODE(RawMode, RAWMODE_YCbCr_L, {"YCbCr;L"})
-CREATE_MODE(RawMode, RAWMODE_Y_I, {"Y;I"})
-CREATE_MODE(RawMode, RAWMODE_aBGR, {"aBGR"})
-CREATE_MODE(RawMode, RAWMODE_aRGB, {"aRGB"})
 
-const RawMode * const RAWMODES[] = {
-    IMAGING_RAWMODE_1,
-    IMAGING_RAWMODE_CMYK,
-    IMAGING_RAWMODE_F,
-    IMAGING_RAWMODE_HSV,
-    IMAGING_RAWMODE_I,
-    IMAGING_RAWMODE_L,
-    IMAGING_RAWMODE_LA,
-    IMAGING_RAWMODE_LAB,
-    IMAGING_RAWMODE_La,
-    IMAGING_RAWMODE_P,
-    IMAGING_RAWMODE_PA,
-    IMAGING_RAWMODE_RGB,
-    IMAGING_RAWMODE_RGBA,
-    IMAGING_RAWMODE_RGBX,
-    IMAGING_RAWMODE_RGBa,
-    IMAGING_RAWMODE_YCbCr,
+const RawModeData RAWMODES[] = {
+    [IMAGING_RAWMODE_UNKNOWN] = {""},
 
-    IMAGING_RAWMODE_BGR_15,
-    IMAGING_RAWMODE_BGR_16,
-    IMAGING_RAWMODE_BGR_24,
+    [IMAGING_RAWMODE_1] = {"1"},
+    [IMAGING_RAWMODE_CMYK] = {"CMYK"},
+    [IMAGING_RAWMODE_F] = {"F"},
+    [IMAGING_RAWMODE_HSV] = {"HSV"},
+    [IMAGING_RAWMODE_I] = {"I"},
+    [IMAGING_RAWMODE_L] = {"L"},
+    [IMAGING_RAWMODE_LA] = {"LA"},
+    [IMAGING_RAWMODE_LAB] = {"LAB"},
+    [IMAGING_RAWMODE_La] = {"La"},
+    [IMAGING_RAWMODE_P] = {"P"},
+    [IMAGING_RAWMODE_PA] = {"PA"},
+    [IMAGING_RAWMODE_RGB] = {"RGB"},
+    [IMAGING_RAWMODE_RGBA] = {"RGBA"},
+    [IMAGING_RAWMODE_RGBX] = {"RGBX"},
+    [IMAGING_RAWMODE_RGBa] = {"RGBa"},
+    [IMAGING_RAWMODE_YCbCr] = {"YCbCr"},
 
-    IMAGING_RAWMODE_I_16,
-    IMAGING_RAWMODE_I_16L,
-    IMAGING_RAWMODE_I_16B,
-    IMAGING_RAWMODE_I_16N,
-    IMAGING_RAWMODE_I_32L,
-    IMAGING_RAWMODE_I_32B,
+    [IMAGING_RAWMODE_BGR_15] = {"BGR;15"},
+    [IMAGING_RAWMODE_BGR_16] = {"BGR;16"},
+    [IMAGING_RAWMODE_BGR_24] = {"BGR;24"},
+    [IMAGING_RAWMODE_BGR_32] = {"BGR;32"},
 
-    IMAGING_RAWMODE_1_8,
-    IMAGING_RAWMODE_1_I,
-    IMAGING_RAWMODE_1_IR,
-    IMAGING_RAWMODE_1_R,
-    IMAGING_RAWMODE_A,
-    IMAGING_RAWMODE_ABGR,
-    IMAGING_RAWMODE_ARGB,
-    IMAGING_RAWMODE_A_16B,
-    IMAGING_RAWMODE_A_16L,
-    IMAGING_RAWMODE_A_16N,
-    IMAGING_RAWMODE_B,
-    IMAGING_RAWMODE_BGAR,
-    IMAGING_RAWMODE_BGR,
-    IMAGING_RAWMODE_BGRA,
-    IMAGING_RAWMODE_BGRA_15,
-    IMAGING_RAWMODE_BGRA_15Z,
-    IMAGING_RAWMODE_BGRA_16B,
-    IMAGING_RAWMODE_BGRA_16L,
-    IMAGING_RAWMODE_BGRX,
-    IMAGING_RAWMODE_BGR_5,
-    IMAGING_RAWMODE_BGRa,
-    IMAGING_RAWMODE_BGXR,
-    IMAGING_RAWMODE_B_16B,
-    IMAGING_RAWMODE_B_16L,
-    IMAGING_RAWMODE_B_16N,
-    IMAGING_RAWMODE_C,
-    IMAGING_RAWMODE_CMYKX,
-    IMAGING_RAWMODE_CMYKXX,
-    IMAGING_RAWMODE_CMYK_16B,
-    IMAGING_RAWMODE_CMYK_16L,
-    IMAGING_RAWMODE_CMYK_16N,
-    IMAGING_RAWMODE_CMYK_I,
-    IMAGING_RAWMODE_CMYK_L,
-    IMAGING_RAWMODE_C_I,
-    IMAGING_RAWMODE_Cb,
-    IMAGING_RAWMODE_Cr,
-    IMAGING_RAWMODE_F_16,
-    IMAGING_RAWMODE_F_16B,
-    IMAGING_RAWMODE_F_16BS,
-    IMAGING_RAWMODE_F_16N,
-    IMAGING_RAWMODE_F_16NS,
-    IMAGING_RAWMODE_F_16S,
-    IMAGING_RAWMODE_F_32,
-    IMAGING_RAWMODE_F_32B,
-    IMAGING_RAWMODE_F_32BF,
-    IMAGING_RAWMODE_F_32BS,
-    IMAGING_RAWMODE_F_32F,
-    IMAGING_RAWMODE_F_32N,
-    IMAGING_RAWMODE_F_32NF,
-    IMAGING_RAWMODE_F_32NS,
-    IMAGING_RAWMODE_F_32S,
-    IMAGING_RAWMODE_F_64BF,
-    IMAGING_RAWMODE_F_64F,
-    IMAGING_RAWMODE_F_64NF,
-    IMAGING_RAWMODE_F_8,
-    IMAGING_RAWMODE_F_8S,
-    IMAGING_RAWMODE_G,
-    IMAGING_RAWMODE_G_16B,
-    IMAGING_RAWMODE_G_16L,
-    IMAGING_RAWMODE_G_16N,
-    IMAGING_RAWMODE_H,
-    IMAGING_RAWMODE_I_12,
-    IMAGING_RAWMODE_I_16BS,
-    IMAGING_RAWMODE_I_16NS,
-    IMAGING_RAWMODE_I_16R,
-    IMAGING_RAWMODE_I_16S,
-    IMAGING_RAWMODE_I_32,
-    IMAGING_RAWMODE_I_32BS,
-    IMAGING_RAWMODE_I_32N,
-    IMAGING_RAWMODE_I_32NS,
-    IMAGING_RAWMODE_I_32S,
-    IMAGING_RAWMODE_I_8,
-    IMAGING_RAWMODE_I_8S,
-    IMAGING_RAWMODE_K,
-    IMAGING_RAWMODE_K_I,
-    IMAGING_RAWMODE_LA_16B,
-    IMAGING_RAWMODE_LA_L,
-    IMAGING_RAWMODE_L_16,
-    IMAGING_RAWMODE_L_16B,
-    IMAGING_RAWMODE_L_2,
-    IMAGING_RAWMODE_L_2I,
-    IMAGING_RAWMODE_L_2IR,
-    IMAGING_RAWMODE_L_2R,
-    IMAGING_RAWMODE_L_4,
-    IMAGING_RAWMODE_L_4I,
-    IMAGING_RAWMODE_L_4IR,
-    IMAGING_RAWMODE_L_4R,
-    IMAGING_RAWMODE_L_I,
-    IMAGING_RAWMODE_L_R,
-    IMAGING_RAWMODE_M,
-    IMAGING_RAWMODE_M_I,
-    IMAGING_RAWMODE_PA_L,
-    IMAGING_RAWMODE_PX,
-    IMAGING_RAWMODE_P_1,
-    IMAGING_RAWMODE_P_2,
-    IMAGING_RAWMODE_P_2L,
-    IMAGING_RAWMODE_P_4,
-    IMAGING_RAWMODE_P_4L,
-    IMAGING_RAWMODE_P_R,
-    IMAGING_RAWMODE_R,
-    IMAGING_RAWMODE_RGBAX,
-    IMAGING_RAWMODE_RGBAXX,
-    IMAGING_RAWMODE_RGBA_15,
-    IMAGING_RAWMODE_RGBA_16B,
-    IMAGING_RAWMODE_RGBA_16L,
-    IMAGING_RAWMODE_RGBA_16N,
-    IMAGING_RAWMODE_RGBA_4B,
-    IMAGING_RAWMODE_RGBA_I,
-    IMAGING_RAWMODE_RGBA_L,
-    IMAGING_RAWMODE_RGBXX,
-    IMAGING_RAWMODE_RGBXXX,
-    IMAGING_RAWMODE_RGBX_16B,
-    IMAGING_RAWMODE_RGBX_16L,
-    IMAGING_RAWMODE_RGBX_16N,
-    IMAGING_RAWMODE_RGBX_L,
-    IMAGING_RAWMODE_RGB_15,
-    IMAGING_RAWMODE_RGB_16,
-    IMAGING_RAWMODE_RGB_16B,
-    IMAGING_RAWMODE_RGB_16L,
-    IMAGING_RAWMODE_RGB_16N,
-    IMAGING_RAWMODE_RGB_4B,
-    IMAGING_RAWMODE_RGB_L,
-    IMAGING_RAWMODE_RGB_R,
-    IMAGING_RAWMODE_RGBaX,
-    IMAGING_RAWMODE_RGBaXX,
-    IMAGING_RAWMODE_RGBa_16B,
-    IMAGING_RAWMODE_RGBa_16L,
-    IMAGING_RAWMODE_RGBa_16N,
-    IMAGING_RAWMODE_R_16B,
-    IMAGING_RAWMODE_R_16L,
-    IMAGING_RAWMODE_R_16N,
-    IMAGING_RAWMODE_S,
-    IMAGING_RAWMODE_V,
-    IMAGING_RAWMODE_X,
-    IMAGING_RAWMODE_XBGR,
-    IMAGING_RAWMODE_XRGB,
-    IMAGING_RAWMODE_Y,
-    IMAGING_RAWMODE_YCCA_P,
-    IMAGING_RAWMODE_YCC_P,
-    IMAGING_RAWMODE_YCbCrK,
-    IMAGING_RAWMODE_YCbCrX,
-    IMAGING_RAWMODE_YCbCr_L,
-    IMAGING_RAWMODE_Y_I,
-    IMAGING_RAWMODE_aBGR,
-    IMAGING_RAWMODE_aRGB,
+    [IMAGING_RAWMODE_I_16] = {"I;16"},
+    [IMAGING_RAWMODE_I_16L] = {"I;16L"},
+    [IMAGING_RAWMODE_I_16B] = {"I;16B"},
+    [IMAGING_RAWMODE_I_16N] = {"I;16N"},
+    [IMAGING_RAWMODE_I_32L] = {"I;32L"},
+    [IMAGING_RAWMODE_I_32B] = {"I;32B"},
 
-    NULL
+    [IMAGING_RAWMODE_1_8] = {"1;8"},
+    [IMAGING_RAWMODE_1_I] = {"1;I"},
+    [IMAGING_RAWMODE_1_IR] = {"1;IR"},
+    [IMAGING_RAWMODE_1_R] = {"1;R"},
+    [IMAGING_RAWMODE_A] = {"A"},
+    [IMAGING_RAWMODE_ABGR] = {"ABGR"},
+    [IMAGING_RAWMODE_ARGB] = {"ARGB"},
+    [IMAGING_RAWMODE_A_16B] = {"A;16B"},
+    [IMAGING_RAWMODE_A_16L] = {"A;16L"},
+    [IMAGING_RAWMODE_A_16N] = {"A;16N"},
+    [IMAGING_RAWMODE_B] = {"B"},
+    [IMAGING_RAWMODE_BGAR] = {"BGAR"},
+    [IMAGING_RAWMODE_BGR] = {"BGR"},
+    [IMAGING_RAWMODE_BGRA] = {"BGRA"},
+    [IMAGING_RAWMODE_BGRA_15] = {"BGRA;15"},
+    [IMAGING_RAWMODE_BGRA_15Z] = {"BGRA;15Z"},
+    [IMAGING_RAWMODE_BGRA_16B] = {"BGRA;16B"},
+    [IMAGING_RAWMODE_BGRA_16L] = {"BGRA;16L"},
+    [IMAGING_RAWMODE_BGRX] = {"BGRX"},
+    [IMAGING_RAWMODE_BGR_5] = {"BGR;5"},
+    [IMAGING_RAWMODE_BGRa] = {"BGRa"},
+    [IMAGING_RAWMODE_BGXR] = {"BGXR"},
+    [IMAGING_RAWMODE_B_16B] = {"B;16B"},
+    [IMAGING_RAWMODE_B_16L] = {"B;16L"},
+    [IMAGING_RAWMODE_B_16N] = {"B;16N"},
+    [IMAGING_RAWMODE_C] = {"C"},
+    [IMAGING_RAWMODE_CMYKX] = {"CMYKX"},
+    [IMAGING_RAWMODE_CMYKXX] = {"CMYKXX"},
+    [IMAGING_RAWMODE_CMYK_16B] = {"CMYK;16B"},
+    [IMAGING_RAWMODE_CMYK_16L] = {"CMYK;16L"},
+    [IMAGING_RAWMODE_CMYK_16N] = {"CMYK;16N"},
+    [IMAGING_RAWMODE_CMYK_I] = {"CMYK;I"},
+    [IMAGING_RAWMODE_CMYK_L] = {"CMYK;L"},
+    [IMAGING_RAWMODE_C_I] = {"C;I"},
+    [IMAGING_RAWMODE_Cb] = {"Cb"},
+    [IMAGING_RAWMODE_Cr] = {"Cr"},
+    [IMAGING_RAWMODE_F_16] = {"F;16"},
+    [IMAGING_RAWMODE_F_16B] = {"F;16B"},
+    [IMAGING_RAWMODE_F_16BS] = {"F;16BS"},
+    [IMAGING_RAWMODE_F_16N] = {"F;16N"},
+    [IMAGING_RAWMODE_F_16NS] = {"F;16NS"},
+    [IMAGING_RAWMODE_F_16S] = {"F;16S"},
+    [IMAGING_RAWMODE_F_32] = {"F;32"},
+    [IMAGING_RAWMODE_F_32B] = {"F;32B"},
+    [IMAGING_RAWMODE_F_32BF] = {"F;32BF"},
+    [IMAGING_RAWMODE_F_32BS] = {"F;32BS"},
+    [IMAGING_RAWMODE_F_32F] = {"F;32F"},
+    [IMAGING_RAWMODE_F_32N] = {"F;32N"},
+    [IMAGING_RAWMODE_F_32NF] = {"F;32NF"},
+    [IMAGING_RAWMODE_F_32NS] = {"F;32NS"},
+    [IMAGING_RAWMODE_F_32S] = {"F;32S"},
+    [IMAGING_RAWMODE_F_64BF] = {"F;64BF"},
+    [IMAGING_RAWMODE_F_64F] = {"F;64F"},
+    [IMAGING_RAWMODE_F_64NF] = {"F;64NF"},
+    [IMAGING_RAWMODE_F_8] = {"F;8"},
+    [IMAGING_RAWMODE_F_8S] = {"F;8S"},
+    [IMAGING_RAWMODE_G] = {"G"},
+    [IMAGING_RAWMODE_G_16B] = {"G;16B"},
+    [IMAGING_RAWMODE_G_16L] = {"G;16L"},
+    [IMAGING_RAWMODE_G_16N] = {"G;16N"},
+    [IMAGING_RAWMODE_H] = {"H"},
+    [IMAGING_RAWMODE_I_12] = {"I;12"},
+    [IMAGING_RAWMODE_I_16BS] = {"I;16BS"},
+    [IMAGING_RAWMODE_I_16NS] = {"I;16NS"},
+    [IMAGING_RAWMODE_I_16R] = {"I;16R"},
+    [IMAGING_RAWMODE_I_16S] = {"I;16S"},
+    [IMAGING_RAWMODE_I_32] = {"I;32"},
+    [IMAGING_RAWMODE_I_32BS] = {"I;32BS"},
+    [IMAGING_RAWMODE_I_32N] = {"I;32N"},
+    [IMAGING_RAWMODE_I_32NS] = {"I;32NS"},
+    [IMAGING_RAWMODE_I_32S] = {"I;32S"},
+    [IMAGING_RAWMODE_I_8] = {"I;8"},
+    [IMAGING_RAWMODE_I_8S] = {"I;8S"},
+    [IMAGING_RAWMODE_K] = {"K"},
+    [IMAGING_RAWMODE_K_I] = {"K;I"},
+    [IMAGING_RAWMODE_LA_16B] = {"LA;16B"},
+    [IMAGING_RAWMODE_LA_L] = {"LA;L"},
+    [IMAGING_RAWMODE_L_16] = {"L;16"},
+    [IMAGING_RAWMODE_L_16B] = {"L;16B"},
+    [IMAGING_RAWMODE_L_2] = {"L;2"},
+    [IMAGING_RAWMODE_L_2I] = {"L;2I"},
+    [IMAGING_RAWMODE_L_2IR] = {"L;2IR"},
+    [IMAGING_RAWMODE_L_2R] = {"L;2R"},
+    [IMAGING_RAWMODE_L_4] = {"L;4"},
+    [IMAGING_RAWMODE_L_4I] = {"L;4I"},
+    [IMAGING_RAWMODE_L_4IR] = {"L;4IR"},
+    [IMAGING_RAWMODE_L_4R] = {"L;4R"},
+    [IMAGING_RAWMODE_L_I] = {"L;I"},
+    [IMAGING_RAWMODE_L_R] = {"L;R"},
+    [IMAGING_RAWMODE_M] = {"M"},
+    [IMAGING_RAWMODE_M_I] = {"M;I"},
+    [IMAGING_RAWMODE_PA_L] = {"PA;L"},
+    [IMAGING_RAWMODE_PX] = {"PX"},
+    [IMAGING_RAWMODE_P_1] = {"P;1"},
+    [IMAGING_RAWMODE_P_2] = {"P;2"},
+    [IMAGING_RAWMODE_P_2L] = {"P;2L"},
+    [IMAGING_RAWMODE_P_4] = {"P;4"},
+    [IMAGING_RAWMODE_P_4L] = {"P;4L"},
+    [IMAGING_RAWMODE_P_R] = {"P;R"},
+    [IMAGING_RAWMODE_R] = {"R"},
+    [IMAGING_RAWMODE_RGBAX] = {"RGBAX"},
+    [IMAGING_RAWMODE_RGBAXX] = {"RGBAXX"},
+    [IMAGING_RAWMODE_RGBA_15] = {"RGBA;15"},
+    [IMAGING_RAWMODE_RGBA_16B] = {"RGBA;16B"},
+    [IMAGING_RAWMODE_RGBA_16L] = {"RGBA;16L"},
+    [IMAGING_RAWMODE_RGBA_16N] = {"RGBA;16N"},
+    [IMAGING_RAWMODE_RGBA_4B] = {"RGBA;4B"},
+    [IMAGING_RAWMODE_RGBA_I] = {"RGBA;I"},
+    [IMAGING_RAWMODE_RGBA_L] = {"RGBA;L"},
+    [IMAGING_RAWMODE_RGBXX] = {"RGBXX"},
+    [IMAGING_RAWMODE_RGBXXX] = {"RGBXXX"},
+    [IMAGING_RAWMODE_RGBX_16B] = {"RGBX;16B"},
+    [IMAGING_RAWMODE_RGBX_16L] = {"RGBX;16L"},
+    [IMAGING_RAWMODE_RGBX_16N] = {"RGBX;16N"},
+    [IMAGING_RAWMODE_RGBX_L] = {"RGBX;L"},
+    [IMAGING_RAWMODE_RGB_15] = {"RGB;15"},
+    [IMAGING_RAWMODE_RGB_16] = {"RGB;16"},
+    [IMAGING_RAWMODE_RGB_16B] = {"RGB;16B"},
+    [IMAGING_RAWMODE_RGB_16L] = {"RGB;16L"},
+    [IMAGING_RAWMODE_RGB_16N] = {"RGB;16N"},
+    [IMAGING_RAWMODE_RGB_4B] = {"RGB;4B"},
+    [IMAGING_RAWMODE_RGB_L] = {"RGB;L"},
+    [IMAGING_RAWMODE_RGB_R] = {"RGB;R"},
+    [IMAGING_RAWMODE_RGBaX] = {"RGBaX"},
+    [IMAGING_RAWMODE_RGBaXX] = {"RGBaXX"},
+    [IMAGING_RAWMODE_RGBa_16B] = {"RGBa;16B"},
+    [IMAGING_RAWMODE_RGBa_16L] = {"RGBa;16L"},
+    [IMAGING_RAWMODE_RGBa_16N] = {"RGBa;16N"},
+    [IMAGING_RAWMODE_R_16B] = {"R;16B"},
+    [IMAGING_RAWMODE_R_16L] = {"R;16L"},
+    [IMAGING_RAWMODE_R_16N] = {"R;16N"},
+    [IMAGING_RAWMODE_S] = {"S"},
+    [IMAGING_RAWMODE_V] = {"V"},
+    [IMAGING_RAWMODE_X] = {"X"},
+    [IMAGING_RAWMODE_XBGR] = {"XBGR"},
+    [IMAGING_RAWMODE_XRGB] = {"XRGB"},
+    [IMAGING_RAWMODE_Y] = {"Y"},
+    [IMAGING_RAWMODE_YCCA_P] = {"YCCA;P"},
+    [IMAGING_RAWMODE_YCC_P] = {"YCC;P"},
+    [IMAGING_RAWMODE_YCbCrK] = {"YCbCrK"},
+    [IMAGING_RAWMODE_YCbCrX] = {"YCbCrX"},
+    [IMAGING_RAWMODE_YCbCr_L] = {"YCbCr;L"},
+    [IMAGING_RAWMODE_Y_I] = {"Y;I"},
+    [IMAGING_RAWMODE_aBGR] = {"aBGR"},
+    [IMAGING_RAWMODE_aRGB] = {"aRGB"},
 };
 
-const RawMode * findRawMode(const char * const name) {
+const RawModeID findRawModeID(const char * const name) {
     if (name == NULL) {
-        return NULL;
+        return IMAGING_RAWMODE_UNKNOWN;
     }
-    const RawMode * rawmode;
-    for (int i = 0; (rawmode = RAWMODES[i]); i++) {
-        if (strcmp(rawmode->name, name) == 0) {
-            return rawmode;
+    for (size_t i = 0; i < sizeof(RAWMODES) / sizeof(*RAWMODES); i++) {
+        if (strcmp(RAWMODES[i].name, name) == 0) {
+            return (RawModeID)i;
         }
     }
-    return NULL;
+    return IMAGING_RAWMODE_UNKNOWN;
 }
 
-int isModeI16(const Mode * const mode) {
+const RawModeData * const getRawModeData(const RawModeID id) {
+    if (id < 0 || id > sizeof(RAWMODES) / sizeof(*RAWMODES)) {
+        return &RAWMODES[IMAGING_RAWMODE_UNKNOWN];
+    }
+    return &RAWMODES[id];
+}
+
+
+int isModeI16(const ModeID mode) {
     return mode == IMAGING_MODE_I_16
     || mode == IMAGING_MODE_I_16L
     || mode == IMAGING_MODE_I_16B
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index 663f2f4681f..e21ad941a26 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -2,227 +2,237 @@
 #define __MODE_H__
 
 
+typedef enum {
+    IMAGING_MODE_UNKNOWN,
+
+    IMAGING_MODE_1,
+    IMAGING_MODE_CMYK,
+    IMAGING_MODE_F,
+    IMAGING_MODE_HSV,
+    IMAGING_MODE_I,
+    IMAGING_MODE_L,
+    IMAGING_MODE_LA,
+    IMAGING_MODE_LAB,
+    IMAGING_MODE_La,
+    IMAGING_MODE_P,
+    IMAGING_MODE_PA,
+    IMAGING_MODE_RGB,
+    IMAGING_MODE_RGBA,
+    IMAGING_MODE_RGBX,
+    IMAGING_MODE_RGBa,
+    IMAGING_MODE_YCbCr,
+
+    IMAGING_MODE_BGR_15,
+    IMAGING_MODE_BGR_16,
+    IMAGING_MODE_BGR_24,
+
+    IMAGING_MODE_I_16,
+    IMAGING_MODE_I_16L,
+    IMAGING_MODE_I_16B,
+    IMAGING_MODE_I_16N,
+    IMAGING_MODE_I_32L,
+    IMAGING_MODE_I_32B,
+} ModeID;
+
 typedef struct {
     const char * const name;
-} Mode;
-
-extern const Mode * const IMAGING_MODE_1;
-extern const Mode * const IMAGING_MODE_CMYK;
-extern const Mode * const IMAGING_MODE_F;
-extern const Mode * const IMAGING_MODE_HSV;
-extern const Mode * const IMAGING_MODE_I;
-extern const Mode * const IMAGING_MODE_L;
-extern const Mode * const IMAGING_MODE_LA;
-extern const Mode * const IMAGING_MODE_LAB;
-extern const Mode * const IMAGING_MODE_La;
-extern const Mode * const IMAGING_MODE_P;
-extern const Mode * const IMAGING_MODE_PA;
-extern const Mode * const IMAGING_MODE_RGB;
-extern const Mode * const IMAGING_MODE_RGBA;
-extern const Mode * const IMAGING_MODE_RGBX;
-extern const Mode * const IMAGING_MODE_RGBa;
-extern const Mode * const IMAGING_MODE_YCbCr;
-
-extern const Mode * const IMAGING_MODE_BGR_15;
-extern const Mode * const IMAGING_MODE_BGR_16;
-extern const Mode * const IMAGING_MODE_BGR_24;
-
-extern const Mode * const IMAGING_MODE_I_16;
-extern const Mode * const IMAGING_MODE_I_16L;
-extern const Mode * const IMAGING_MODE_I_16B;
-extern const Mode * const IMAGING_MODE_I_16N;
-extern const Mode * const IMAGING_MODE_I_32L;
-extern const Mode * const IMAGING_MODE_I_32B;
-
-const Mode * findMode(const char * const name);
-
+} ModeData;
+
+const ModeID findModeID(const char * const name);
+const ModeData * const getModeData(const ModeID id);
+
+
+typedef enum {
+    IMAGING_RAWMODE_UNKNOWN,
+
+    // Non-rawmode aliases.
+    IMAGING_RAWMODE_1,
+    IMAGING_RAWMODE_CMYK,
+    IMAGING_RAWMODE_F,
+    IMAGING_RAWMODE_HSV,
+    IMAGING_RAWMODE_I,
+    IMAGING_RAWMODE_L,
+    IMAGING_RAWMODE_LA,
+    IMAGING_RAWMODE_LAB,
+    IMAGING_RAWMODE_La,
+    IMAGING_RAWMODE_P,
+    IMAGING_RAWMODE_PA,
+    IMAGING_RAWMODE_RGB,
+    IMAGING_RAWMODE_RGBA,
+    IMAGING_RAWMODE_RGBX,
+    IMAGING_RAWMODE_RGBa,
+    IMAGING_RAWMODE_YCbCr,
+
+    // BGR modes.
+    IMAGING_RAWMODE_BGR_15,
+    IMAGING_RAWMODE_BGR_16,
+    IMAGING_RAWMODE_BGR_24,
+    IMAGING_RAWMODE_BGR_32,
+
+    // I;* modes.
+    IMAGING_RAWMODE_I_16,
+    IMAGING_RAWMODE_I_16L,
+    IMAGING_RAWMODE_I_16B,
+    IMAGING_RAWMODE_I_16N,
+    IMAGING_RAWMODE_I_32L,
+    IMAGING_RAWMODE_I_32B,
+
+    // Rawmodes
+    IMAGING_RAWMODE_1_8,
+    IMAGING_RAWMODE_1_I,
+    IMAGING_RAWMODE_1_IR,
+    IMAGING_RAWMODE_1_R,
+    IMAGING_RAWMODE_A,
+    IMAGING_RAWMODE_ABGR,
+    IMAGING_RAWMODE_ARGB,
+    IMAGING_RAWMODE_A_16B,
+    IMAGING_RAWMODE_A_16L,
+    IMAGING_RAWMODE_A_16N,
+    IMAGING_RAWMODE_B,
+    IMAGING_RAWMODE_BGAR,
+    IMAGING_RAWMODE_BGR,
+    IMAGING_RAWMODE_BGRA,
+    IMAGING_RAWMODE_BGRA_15,
+    IMAGING_RAWMODE_BGRA_15Z,
+    IMAGING_RAWMODE_BGRA_16B,
+    IMAGING_RAWMODE_BGRA_16L,
+    IMAGING_RAWMODE_BGRX,
+    IMAGING_RAWMODE_BGR_5,
+    IMAGING_RAWMODE_BGRa,
+    IMAGING_RAWMODE_BGXR,
+    IMAGING_RAWMODE_B_16B,
+    IMAGING_RAWMODE_B_16L,
+    IMAGING_RAWMODE_B_16N,
+    IMAGING_RAWMODE_C,
+    IMAGING_RAWMODE_CMYKX,
+    IMAGING_RAWMODE_CMYKXX,
+    IMAGING_RAWMODE_CMYK_16B,
+    IMAGING_RAWMODE_CMYK_16L,
+    IMAGING_RAWMODE_CMYK_16N,
+    IMAGING_RAWMODE_CMYK_I,
+    IMAGING_RAWMODE_CMYK_L,
+    IMAGING_RAWMODE_C_I,
+    IMAGING_RAWMODE_Cb,
+    IMAGING_RAWMODE_Cr,
+    IMAGING_RAWMODE_F_16,
+    IMAGING_RAWMODE_F_16B,
+    IMAGING_RAWMODE_F_16BS,
+    IMAGING_RAWMODE_F_16N,
+    IMAGING_RAWMODE_F_16NS,
+    IMAGING_RAWMODE_F_16S,
+    IMAGING_RAWMODE_F_32,
+    IMAGING_RAWMODE_F_32B,
+    IMAGING_RAWMODE_F_32BF,
+    IMAGING_RAWMODE_F_32BS,
+    IMAGING_RAWMODE_F_32F,
+    IMAGING_RAWMODE_F_32N,
+    IMAGING_RAWMODE_F_32NF,
+    IMAGING_RAWMODE_F_32NS,
+    IMAGING_RAWMODE_F_32S,
+    IMAGING_RAWMODE_F_64BF,
+    IMAGING_RAWMODE_F_64F,
+    IMAGING_RAWMODE_F_64NF,
+    IMAGING_RAWMODE_F_8,
+    IMAGING_RAWMODE_F_8S,
+    IMAGING_RAWMODE_G,
+    IMAGING_RAWMODE_G_16B,
+    IMAGING_RAWMODE_G_16L,
+    IMAGING_RAWMODE_G_16N,
+    IMAGING_RAWMODE_H,
+    IMAGING_RAWMODE_I_12,
+    IMAGING_RAWMODE_I_16BS,
+    IMAGING_RAWMODE_I_16NS,
+    IMAGING_RAWMODE_I_16R,
+    IMAGING_RAWMODE_I_16S,
+    IMAGING_RAWMODE_I_32,
+    IMAGING_RAWMODE_I_32BS,
+    IMAGING_RAWMODE_I_32N,
+    IMAGING_RAWMODE_I_32NS,
+    IMAGING_RAWMODE_I_32S,
+    IMAGING_RAWMODE_I_8,
+    IMAGING_RAWMODE_I_8S,
+    IMAGING_RAWMODE_K,
+    IMAGING_RAWMODE_K_I,
+    IMAGING_RAWMODE_LA_16B,
+    IMAGING_RAWMODE_LA_L,
+    IMAGING_RAWMODE_L_16,
+    IMAGING_RAWMODE_L_16B,
+    IMAGING_RAWMODE_L_2,
+    IMAGING_RAWMODE_L_2I,
+    IMAGING_RAWMODE_L_2IR,
+    IMAGING_RAWMODE_L_2R,
+    IMAGING_RAWMODE_L_4,
+    IMAGING_RAWMODE_L_4I,
+    IMAGING_RAWMODE_L_4IR,
+    IMAGING_RAWMODE_L_4R,
+    IMAGING_RAWMODE_L_I,
+    IMAGING_RAWMODE_L_R,
+    IMAGING_RAWMODE_M,
+    IMAGING_RAWMODE_M_I,
+    IMAGING_RAWMODE_PA_L,
+    IMAGING_RAWMODE_PX,
+    IMAGING_RAWMODE_P_1,
+    IMAGING_RAWMODE_P_2,
+    IMAGING_RAWMODE_P_2L,
+    IMAGING_RAWMODE_P_4,
+    IMAGING_RAWMODE_P_4L,
+    IMAGING_RAWMODE_P_R,
+    IMAGING_RAWMODE_R,
+    IMAGING_RAWMODE_RGBAX,
+    IMAGING_RAWMODE_RGBAXX,
+    IMAGING_RAWMODE_RGBA_15,
+    IMAGING_RAWMODE_RGBA_16B,
+    IMAGING_RAWMODE_RGBA_16L,
+    IMAGING_RAWMODE_RGBA_16N,
+    IMAGING_RAWMODE_RGBA_4B,
+    IMAGING_RAWMODE_RGBA_I,
+    IMAGING_RAWMODE_RGBA_L,
+    IMAGING_RAWMODE_RGBXX,
+    IMAGING_RAWMODE_RGBXXX,
+    IMAGING_RAWMODE_RGBX_16B,
+    IMAGING_RAWMODE_RGBX_16L,
+    IMAGING_RAWMODE_RGBX_16N,
+    IMAGING_RAWMODE_RGBX_L,
+    IMAGING_RAWMODE_RGB_15,
+    IMAGING_RAWMODE_RGB_16,
+    IMAGING_RAWMODE_RGB_16B,
+    IMAGING_RAWMODE_RGB_16L,
+    IMAGING_RAWMODE_RGB_16N,
+    IMAGING_RAWMODE_RGB_4B,
+    IMAGING_RAWMODE_RGB_L,
+    IMAGING_RAWMODE_RGB_R,
+    IMAGING_RAWMODE_RGBaX,
+    IMAGING_RAWMODE_RGBaXX,
+    IMAGING_RAWMODE_RGBa_16B,
+    IMAGING_RAWMODE_RGBa_16L,
+    IMAGING_RAWMODE_RGBa_16N,
+    IMAGING_RAWMODE_R_16B,
+    IMAGING_RAWMODE_R_16L,
+    IMAGING_RAWMODE_R_16N,
+    IMAGING_RAWMODE_S,
+    IMAGING_RAWMODE_V,
+    IMAGING_RAWMODE_X,
+    IMAGING_RAWMODE_XBGR,
+    IMAGING_RAWMODE_XRGB,
+    IMAGING_RAWMODE_Y,
+    IMAGING_RAWMODE_YCCA_P,
+    IMAGING_RAWMODE_YCC_P,
+    IMAGING_RAWMODE_YCbCrK,
+    IMAGING_RAWMODE_YCbCrX,
+    IMAGING_RAWMODE_YCbCr_L,
+    IMAGING_RAWMODE_Y_I,
+    IMAGING_RAWMODE_aBGR,
+    IMAGING_RAWMODE_aRGB,
+} RawModeID;
 
 typedef struct {
     const char * const name;
-} RawMode;
-
-// Non-rawmode aliases.
-extern const RawMode * const IMAGING_RAWMODE_1;
-extern const RawMode * const IMAGING_RAWMODE_CMYK;
-extern const RawMode * const IMAGING_RAWMODE_F;
-extern const RawMode * const IMAGING_RAWMODE_HSV;
-extern const RawMode * const IMAGING_RAWMODE_I;
-extern const RawMode * const IMAGING_RAWMODE_L;
-extern const RawMode * const IMAGING_RAWMODE_LA;
-extern const RawMode * const IMAGING_RAWMODE_LAB;
-extern const RawMode * const IMAGING_RAWMODE_La;
-extern const RawMode * const IMAGING_RAWMODE_P;
-extern const RawMode * const IMAGING_RAWMODE_PA;
-extern const RawMode * const IMAGING_RAWMODE_RGB;
-extern const RawMode * const IMAGING_RAWMODE_RGBA;
-extern const RawMode * const IMAGING_RAWMODE_RGBX;
-extern const RawMode * const IMAGING_RAWMODE_RGBa;
-extern const RawMode * const IMAGING_RAWMODE_YCbCr;
-
-// BGR modes.
-extern const RawMode * const IMAGING_RAWMODE_BGR_15;
-extern const RawMode * const IMAGING_RAWMODE_BGR_16;
-extern const RawMode * const IMAGING_RAWMODE_BGR_24;
-extern const RawMode * const IMAGING_RAWMODE_BGR_32;
-
-// I;* modes.
-extern const RawMode * const IMAGING_RAWMODE_I_16;
-extern const RawMode * const IMAGING_RAWMODE_I_16L;
-extern const RawMode * const IMAGING_RAWMODE_I_16B;
-extern const RawMode * const IMAGING_RAWMODE_I_16N;
-extern const RawMode * const IMAGING_RAWMODE_I_32L;
-extern const RawMode * const IMAGING_RAWMODE_I_32B;
-
-// Rawmodes
-extern const RawMode * const IMAGING_RAWMODE_1_8;
-extern const RawMode * const IMAGING_RAWMODE_1_I;
-extern const RawMode * const IMAGING_RAWMODE_1_IR;
-extern const RawMode * const IMAGING_RAWMODE_1_R;
-extern const RawMode * const IMAGING_RAWMODE_A;
-extern const RawMode * const IMAGING_RAWMODE_ABGR;
-extern const RawMode * const IMAGING_RAWMODE_ARGB;
-extern const RawMode * const IMAGING_RAWMODE_A_16B;
-extern const RawMode * const IMAGING_RAWMODE_A_16L;
-extern const RawMode * const IMAGING_RAWMODE_A_16N;
-extern const RawMode * const IMAGING_RAWMODE_B;
-extern const RawMode * const IMAGING_RAWMODE_BGAR;
-extern const RawMode * const IMAGING_RAWMODE_BGR;
-extern const RawMode * const IMAGING_RAWMODE_BGRA;
-extern const RawMode * const IMAGING_RAWMODE_BGRA_15;
-extern const RawMode * const IMAGING_RAWMODE_BGRA_15Z;
-extern const RawMode * const IMAGING_RAWMODE_BGRA_16B;
-extern const RawMode * const IMAGING_RAWMODE_BGRA_16L;
-extern const RawMode * const IMAGING_RAWMODE_BGRX;
-extern const RawMode * const IMAGING_RAWMODE_BGR_5;
-extern const RawMode * const IMAGING_RAWMODE_BGRa;
-extern const RawMode * const IMAGING_RAWMODE_BGXR;
-extern const RawMode * const IMAGING_RAWMODE_B_16B;
-extern const RawMode * const IMAGING_RAWMODE_B_16L;
-extern const RawMode * const IMAGING_RAWMODE_B_16N;
-extern const RawMode * const IMAGING_RAWMODE_C;
-extern const RawMode * const IMAGING_RAWMODE_CMYKX;
-extern const RawMode * const IMAGING_RAWMODE_CMYKXX;
-extern const RawMode * const IMAGING_RAWMODE_CMYK_16B;
-extern const RawMode * const IMAGING_RAWMODE_CMYK_16L;
-extern const RawMode * const IMAGING_RAWMODE_CMYK_16N;
-extern const RawMode * const IMAGING_RAWMODE_CMYK_I;
-extern const RawMode * const IMAGING_RAWMODE_CMYK_L;
-extern const RawMode * const IMAGING_RAWMODE_C_I;
-extern const RawMode * const IMAGING_RAWMODE_Cb;
-extern const RawMode * const IMAGING_RAWMODE_Cr;
-extern const RawMode * const IMAGING_RAWMODE_F_16;
-extern const RawMode * const IMAGING_RAWMODE_F_16B;
-extern const RawMode * const IMAGING_RAWMODE_F_16BS;
-extern const RawMode * const IMAGING_RAWMODE_F_16N;
-extern const RawMode * const IMAGING_RAWMODE_F_16NS;
-extern const RawMode * const IMAGING_RAWMODE_F_16S;
-extern const RawMode * const IMAGING_RAWMODE_F_32;
-extern const RawMode * const IMAGING_RAWMODE_F_32B;
-extern const RawMode * const IMAGING_RAWMODE_F_32BF;
-extern const RawMode * const IMAGING_RAWMODE_F_32BS;
-extern const RawMode * const IMAGING_RAWMODE_F_32F;
-extern const RawMode * const IMAGING_RAWMODE_F_32N;
-extern const RawMode * const IMAGING_RAWMODE_F_32NF;
-extern const RawMode * const IMAGING_RAWMODE_F_32NS;
-extern const RawMode * const IMAGING_RAWMODE_F_32S;
-extern const RawMode * const IMAGING_RAWMODE_F_64BF;
-extern const RawMode * const IMAGING_RAWMODE_F_64F;
-extern const RawMode * const IMAGING_RAWMODE_F_64NF;
-extern const RawMode * const IMAGING_RAWMODE_F_8;
-extern const RawMode * const IMAGING_RAWMODE_F_8S;
-extern const RawMode * const IMAGING_RAWMODE_G;
-extern const RawMode * const IMAGING_RAWMODE_G_16B;
-extern const RawMode * const IMAGING_RAWMODE_G_16L;
-extern const RawMode * const IMAGING_RAWMODE_G_16N;
-extern const RawMode * const IMAGING_RAWMODE_H;
-extern const RawMode * const IMAGING_RAWMODE_I_12;
-extern const RawMode * const IMAGING_RAWMODE_I_16BS;
-extern const RawMode * const IMAGING_RAWMODE_I_16NS;
-extern const RawMode * const IMAGING_RAWMODE_I_16R;
-extern const RawMode * const IMAGING_RAWMODE_I_16S;
-extern const RawMode * const IMAGING_RAWMODE_I_32;
-extern const RawMode * const IMAGING_RAWMODE_I_32BS;
-extern const RawMode * const IMAGING_RAWMODE_I_32N;
-extern const RawMode * const IMAGING_RAWMODE_I_32NS;
-extern const RawMode * const IMAGING_RAWMODE_I_32S;
-extern const RawMode * const IMAGING_RAWMODE_I_8;
-extern const RawMode * const IMAGING_RAWMODE_I_8S;
-extern const RawMode * const IMAGING_RAWMODE_K;
-extern const RawMode * const IMAGING_RAWMODE_K_I;
-extern const RawMode * const IMAGING_RAWMODE_LA_16B;
-extern const RawMode * const IMAGING_RAWMODE_LA_L;
-extern const RawMode * const IMAGING_RAWMODE_L_16;
-extern const RawMode * const IMAGING_RAWMODE_L_16B;
-extern const RawMode * const IMAGING_RAWMODE_L_2;
-extern const RawMode * const IMAGING_RAWMODE_L_2I;
-extern const RawMode * const IMAGING_RAWMODE_L_2IR;
-extern const RawMode * const IMAGING_RAWMODE_L_2R;
-extern const RawMode * const IMAGING_RAWMODE_L_4;
-extern const RawMode * const IMAGING_RAWMODE_L_4I;
-extern const RawMode * const IMAGING_RAWMODE_L_4IR;
-extern const RawMode * const IMAGING_RAWMODE_L_4R;
-extern const RawMode * const IMAGING_RAWMODE_L_I;
-extern const RawMode * const IMAGING_RAWMODE_L_R;
-extern const RawMode * const IMAGING_RAWMODE_M;
-extern const RawMode * const IMAGING_RAWMODE_M_I;
-extern const RawMode * const IMAGING_RAWMODE_PA_L;
-extern const RawMode * const IMAGING_RAWMODE_PX;
-extern const RawMode * const IMAGING_RAWMODE_P_1;
-extern const RawMode * const IMAGING_RAWMODE_P_2;
-extern const RawMode * const IMAGING_RAWMODE_P_2L;
-extern const RawMode * const IMAGING_RAWMODE_P_4;
-extern const RawMode * const IMAGING_RAWMODE_P_4L;
-extern const RawMode * const IMAGING_RAWMODE_P_R;
-extern const RawMode * const IMAGING_RAWMODE_R;
-extern const RawMode * const IMAGING_RAWMODE_RGBAX;
-extern const RawMode * const IMAGING_RAWMODE_RGBAXX;
-extern const RawMode * const IMAGING_RAWMODE_RGBA_15;
-extern const RawMode * const IMAGING_RAWMODE_RGBA_16B;
-extern const RawMode * const IMAGING_RAWMODE_RGBA_16L;
-extern const RawMode * const IMAGING_RAWMODE_RGBA_16N;
-extern const RawMode * const IMAGING_RAWMODE_RGBA_4B;
-extern const RawMode * const IMAGING_RAWMODE_RGBA_I;
-extern const RawMode * const IMAGING_RAWMODE_RGBA_L;
-extern const RawMode * const IMAGING_RAWMODE_RGBXX;
-extern const RawMode * const IMAGING_RAWMODE_RGBXXX;
-extern const RawMode * const IMAGING_RAWMODE_RGBX_16B;
-extern const RawMode * const IMAGING_RAWMODE_RGBX_16L;
-extern const RawMode * const IMAGING_RAWMODE_RGBX_16N;
-extern const RawMode * const IMAGING_RAWMODE_RGBX_L;
-extern const RawMode * const IMAGING_RAWMODE_RGB_15;
-extern const RawMode * const IMAGING_RAWMODE_RGB_16;
-extern const RawMode * const IMAGING_RAWMODE_RGB_16B;
-extern const RawMode * const IMAGING_RAWMODE_RGB_16L;
-extern const RawMode * const IMAGING_RAWMODE_RGB_16N;
-extern const RawMode * const IMAGING_RAWMODE_RGB_4B;
-extern const RawMode * const IMAGING_RAWMODE_RGB_L;
-extern const RawMode * const IMAGING_RAWMODE_RGB_R;
-extern const RawMode * const IMAGING_RAWMODE_RGBaX;
-extern const RawMode * const IMAGING_RAWMODE_RGBaXX;
-extern const RawMode * const IMAGING_RAWMODE_RGBa_16B;
-extern const RawMode * const IMAGING_RAWMODE_RGBa_16L;
-extern const RawMode * const IMAGING_RAWMODE_RGBa_16N;
-extern const RawMode * const IMAGING_RAWMODE_R_16B;
-extern const RawMode * const IMAGING_RAWMODE_R_16L;
-extern const RawMode * const IMAGING_RAWMODE_R_16N;
-extern const RawMode * const IMAGING_RAWMODE_S;
-extern const RawMode * const IMAGING_RAWMODE_V;
-extern const RawMode * const IMAGING_RAWMODE_X;
-extern const RawMode * const IMAGING_RAWMODE_XBGR;
-extern const RawMode * const IMAGING_RAWMODE_XRGB;
-extern const RawMode * const IMAGING_RAWMODE_Y;
-extern const RawMode * const IMAGING_RAWMODE_YCCA_P;
-extern const RawMode * const IMAGING_RAWMODE_YCC_P;
-extern const RawMode * const IMAGING_RAWMODE_YCbCrK;
-extern const RawMode * const IMAGING_RAWMODE_YCbCrX;
-extern const RawMode * const IMAGING_RAWMODE_YCbCr_L;
-extern const RawMode * const IMAGING_RAWMODE_Y_I;
-extern const RawMode * const IMAGING_RAWMODE_aBGR;
-extern const RawMode * const IMAGING_RAWMODE_aRGB;
-
-const RawMode * findRawMode(const char * const name);
-
-
-int isModeI16(const Mode * const mode);
+} RawModeData;
+
+const RawModeID findRawModeID(const char * const name);
+const RawModeData * const getRawModeData(const RawModeID id);
+
+
+int isModeI16(const ModeID mode);
 
 #endif // __MODE_H__
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index aaa074c9249..63bbc8acb35 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -518,147 +518,146 @@ band3(UINT8 *out, const UINT8 *in, int pixels) {
     }
 }
 
-static struct Packer {
-    const Mode *mode;
-    const RawMode *rawmode;
+static struct {
+    const ModeID mode;
+    const RawModeID rawmode;
     int bits;
     ImagingShuffler pack;
 } packers[] = {
 
     /* bilevel */
-    {"1", "1", 1, pack1},
-    {"1", "1;I", 1, pack1I},
-    {"1", "1;R", 1, pack1R},
-    {"1", "1;IR", 1, pack1IR},
-    {"1", "L", 8, pack1L},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1, 1, pack1},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1_I, 1, pack1I},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1_R, 1, pack1R},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1_IR, 1, pack1IR},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_L, 8, pack1L},
 
     /* grayscale */
-    {"L", "L", 8, copy1},
-    {"L", "L;16", 16, packL16},
-    {"L", "L;16B", 16, packL16B},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L, 8, copy1},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_16, 16, packL16},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_16B, 16, packL16B},
 
     /* grayscale w. alpha */
-    {"LA", "LA", 16, packLA},
-    {"LA", "LA;L", 16, packLAL},
+    {IMAGING_MODE_LA, IMAGING_RAWMODE_LA, 16, packLA},
+    {IMAGING_MODE_LA, IMAGING_RAWMODE_LA_L, 16, packLAL},
 
     /* grayscale w. alpha premultiplied */
-    {"La", "La", 16, packLA},
+    {IMAGING_MODE_La, IMAGING_RAWMODE_La, 16, packLA},
 
     /* palette */
-    {"P", "P;1", 1, pack1},
-    {"P", "P;2", 2, packP2},
-    {"P", "P;4", 4, packP4},
-    {"P", "P", 8, copy1},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_1, 1, pack1},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_2, 2, packP2},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_4, 4, packP4},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P, 8, copy1},
 
     /* palette w. alpha */
-    {"PA", "PA", 16, packLA},
-    {"PA", "PA;L", 16, packLAL},
+    {IMAGING_MODE_PA, IMAGING_RAWMODE_PA, 16, packLA},
+    {IMAGING_MODE_PA, IMAGING_RAWMODE_PA_L, 16, packLAL},
 
     /* true colour */
-    {"RGB", "RGB", 24, ImagingPackRGB},
-    {"RGB", "RGBX", 32, copy4},
-    {"RGB", "RGBA", 32, copy4},
-    {"RGB", "XRGB", 32, ImagingPackXRGB},
-    {"RGB", "BGR", 24, ImagingPackBGR},
-    {"RGB", "BGRX", 32, ImagingPackBGRX},
-    {"RGB", "XBGR", 32, ImagingPackXBGR},
-    {"RGB", "RGB;L", 24, packRGBL},
-    {"RGB", "R", 8, band0},
-    {"RGB", "G", 8, band1},
-    {"RGB", "B", 8, band2},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX, 32, copy4},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA, 32, copy4},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_XRGB, 32, ImagingPackXRGB},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGRX, 32, ImagingPackBGRX},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_XBGR, 32, ImagingPackXBGR},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_L, 24, packRGBL},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_R, 8, band0},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_G, 8, band1},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_B, 8, band2},
 
     /* true colour w. alpha */
-    {"RGBA", "RGBA", 32, copy4},
-    {"RGBA", "RGBA;L", 32, packRGBXL},
-    {"RGBA", "RGB", 24, ImagingPackRGB},
-    {"RGBA", "BGR", 24, ImagingPackBGR},
-    {"RGBA", "BGRA", 32, ImagingPackBGRA},
-    {"RGBA", "ABGR", 32, ImagingPackABGR},
-    {"RGBA", "BGRa", 32, ImagingPackBGRa},
-    {"RGBA", "R", 8, band0},
-    {"RGBA", "G", 8, band1},
-    {"RGBA", "B", 8, band2},
-    {"RGBA", "A", 8, band3},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA, 32, copy4},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_L, 32, packRGBXL},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA, 32, ImagingPackBGRA},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ABGR, 32, ImagingPackABGR},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRa, 32, ImagingPackBGRa},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R, 8, band0},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G, 8, band1},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B, 8, band2},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A, 8, band3},
 
     /* true colour w. alpha premultiplied */
-    {"RGBa", "RGBa", 32, copy4},
-    {"RGBa", "BGRa", 32, ImagingPackBGRA},
-    {"RGBa", "aBGR", 32, ImagingPackABGR},
+    {IMAGING_MODE_RGBa, IMAGING_RAWMODE_RGBa, 32, copy4},
+    {IMAGING_MODE_RGBa, IMAGING_RAWMODE_BGRa, 32, ImagingPackBGRA},
+    {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aBGR, 32, ImagingPackABGR},
 
     /* true colour w. padding */
-    {"RGBX", "RGBX", 32, copy4},
-    {"RGBX", "RGBX;L", 32, packRGBXL},
-    {"RGBX", "RGB", 24, ImagingPackRGB},
-    {"RGBX", "BGR", 24, ImagingPackBGR},
-    {"RGBX", "BGRX", 32, ImagingPackBGRX},
-    {"RGBX", "XBGR", 32, ImagingPackXBGR},
-    {"RGBX", "R", 8, band0},
-    {"RGBX", "G", 8, band1},
-    {"RGBX", "B", 8, band2},
-    {"RGBX", "X", 8, band3},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX, 32, copy4},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_L, 32, packRGBXL},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGRX, 32, ImagingPackBGRX},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XBGR, 32, ImagingPackXBGR},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_R, 8, band0},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_G, 8, band1},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_B, 8, band2},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_X, 8, band3},
 
     /* colour separation */
-    {"CMYK", "CMYK", 32, copy4},
-    {"CMYK", "CMYK;I", 32, copy4I},
-    {"CMYK", "CMYK;L", 32, packRGBXL},
-    {"CMYK", "C", 8, band0},
-    {"CMYK", "M", 8, band1},
-    {"CMYK", "Y", 8, band2},
-    {"CMYK", "K", 8, band3},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK, 32, copy4},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_I, 32, copy4I},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_L, 32, packRGBXL},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C, 8, band0},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M, 8, band1},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y, 8, band2},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K, 8, band3},
 
     /* video (YCbCr) */
-    {"YCbCr", "YCbCr", 24, ImagingPackRGB},
-    {"YCbCr", "YCbCr;L", 24, packRGBL},
-    {"YCbCr", "YCbCrX", 32, copy4},
-    {"YCbCr", "YCbCrK", 32, copy4},
-    {"YCbCr", "Y", 8, band0},
-    {"YCbCr", "Cb", 8, band1},
-    {"YCbCr", "Cr", 8, band2},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr, 24, ImagingPackRGB},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr_L, 24, packRGBL},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrX, 32, copy4},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrK, 32, copy4},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Y, 8, band0},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Cb, 8, band1},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Cr, 8, band2},
 
     /* LAB Color */
-    {"LAB", "LAB", 24, ImagingPackLAB},
-    {"LAB", "L", 8, band0},
-    {"LAB", "A", 8, band1},
-    {"LAB", "B", 8, band2},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_LAB, 24, ImagingPackLAB},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_L, 8, band0},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_A, 8, band1},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_B, 8, band2},
 
     /* HSV */
-    {"HSV", "HSV", 24, ImagingPackRGB},
-    {"HSV", "H", 8, band0},
-    {"HSV", "S", 8, band1},
-    {"HSV", "V", 8, band2},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_HSV, 24, ImagingPackRGB},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_H, 8, band0},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_S, 8, band1},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_V, 8, band2},
 
     /* integer */
-    {"I", "I", 32, copy4},
-    {"I", "I;16B", 16, packI16B},
-    {"I", "I;32S", 32, packI32S},
-    {"I", "I;32NS", 32, copy4},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I, 32, copy4},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_16B, 16, packI16B},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32S, 32, packI32S},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32NS, 32, copy4},
 
     /* floating point */
-    {"F", "F", 32, copy4},
-    {"F", "F;32F", 32, packI32S},
-    {"F", "F;32NF", 32, copy4},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F, 32, copy4},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32F, 32, packI32S},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NF, 32, copy4},
 
     /* storage modes */
-    {"I;16", "I;16", 16, copy2},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16, 16, copy2},
 #ifdef WORDS_BIGENDIAN
-    {"I;16", "I;16B", 16, packI16N_I16},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, packI16N_I16},
 #else
-    {"I;16", "I;16B", 16, packI16N_I16B},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, packI16N_I16B},
 #endif
-    {"I;16B", "I;16B", 16, copy2},
-    {"I;16L", "I;16L", 16, copy2},
-    {"I;16N", "I;16N", 16, copy2},
-    {"I;16", "I;16N", 16, packI16N_I16},  // LibTiff native->image endian.
-    {"I;16L", "I;16N", 16, packI16N_I16},
-    {"I;16B", "I;16N", 16, packI16N_I16B},
+    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
+    {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
+    {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16}, // LibTiff native->image endian.
+    {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
+    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B},
 
     {NULL} /* sentinel */
 };
 
 ImagingShuffler
-ImagingFindPacker(const Mode *mode, const RawMode *rawmode, int *bits_out) {
-    int i;
-    for (i = 0; packers[i].mode; i++) {
+ImagingFindPacker(const ModeID mode, const RawModeID rawmode, int *bits_out) {
+    for (size_t i = 0; i < sizeof(packers) / sizeof(*packers); i++) {
         if (packers[i].mode == mode && packers[i].rawmode == rawmode) {
             if (bits_out) {
                 *bits_out = packers[i].bits;
@@ -668,152 +667,3 @@ ImagingFindPacker(const Mode *mode, const RawMode *rawmode, int *bits_out) {
     }
     return NULL;
 }
-
-void
-ImagingPackInit(void) {
-    const struct Packer temp[] = {
-        /* bilevel */
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1, 1, pack1},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1_I, 1, pack1I},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1_R, 1, pack1R},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1_IR, 1, pack1IR},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_L, 8, pack1L},
-
-        /* grayscale */
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L, 8, copy1},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16, 16, packL16},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16B, 16, packL16B},
-
-        /* grayscale w. alpha */
-        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA, 16, packLA},
-        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA_L, 16, packLAL},
-
-        /* grayscale w. alpha premultiplied */
-        {IMAGING_MODE_La, IMAGING_RAWMODE_La, 16, packLA},
-
-        /* palette */
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_1, 1, pack1},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_2, 2, packP2},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_4, 4, packP4},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P, 8, copy1},
-
-        /* palette w. alpha */
-        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA, 16, packLA},
-        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA_L, 16, packLAL},
-
-        /* true colour */
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX, 32, copy4},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA, 32, copy4},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XRGB, 32, ImagingPackXRGB},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGRX, 32, ImagingPackBGRX},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XBGR, 32, ImagingPackXBGR},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_L, 24, packRGBL},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R, 8, band0},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G, 8, band1},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B, 8, band2},
-
-        /* true colour w. alpha */
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA, 32, copy4},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_L, 32, packRGBXL},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA, 32, ImagingPackBGRA},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ABGR, 32, ImagingPackABGR},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRa, 32, ImagingPackBGRa},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R, 8, band0},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G, 8, band1},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B, 8, band2},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A, 8, band3},
-
-        /* true colour w. alpha premultiplied */
-        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_RGBa, 32, copy4},
-        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_BGRa, 32, ImagingPackBGRA},
-        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aBGR, 32, ImagingPackABGR},
-
-        /* true colour w. padding */
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX, 32, copy4},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_L, 32, packRGBXL},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB, 24, ImagingPackRGB},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR, 24, ImagingPackBGR},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGRX, 32, ImagingPackBGRX},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XBGR, 32, ImagingPackXBGR},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_R, 8, band0},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_G, 8, band1},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_B, 8, band2},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_X, 8, band3},
-
-        /* colour separation */
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK, 32, copy4},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_I, 32, copy4I},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_L, 32, packRGBXL},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C, 8, band0},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M, 8, band1},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y, 8, band2},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K, 8, band3},
-
-        /* video (YCbCr) */
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr, 24, ImagingPackRGB},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr_L, 24, packRGBL},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrX, 32, copy4},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrK, 32, copy4},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Y, 8, band0},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Cb, 8, band1},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_Cr, 8, band2},
-
-        /* LAB Color */
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_LAB, 24, ImagingPackLAB},
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_L, 8, band0},
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_A, 8, band1},
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_B, 8, band2},
-
-        /* HSV */
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_HSV, 24, ImagingPackRGB},
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_H, 8, band0},
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_S, 8, band1},
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_V, 8, band2},
-
-        /* integer */
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I, 32, copy4},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16B, 16, packI16B},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32S, 32, packI32S},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32NS, 32, copy4},
-
-        /* floating point */
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F, 32, copy4},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32F, 32, packI32S},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NF, 32, copy4},
-
-        /* storage modes */
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16, 16, copy2},
-#ifdef WORDS_BIGENDIAN
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, packI16N_I16},
-#else
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, packI16N_I16B},
-#endif
-        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
-        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
-        {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16}, // LibTiff native->image endian.
-        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
-        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B},
-        {IMAGING_MODE_BGR_15, IMAGING_RAWMODE_BGR_15, 16, copy2},
-        {IMAGING_MODE_BGR_16, IMAGING_RAWMODE_BGR_16, 16, copy2},
-        {IMAGING_MODE_BGR_24, IMAGING_RAWMODE_BGR_24, 24, copy3},
-
-        {NULL} /* sentinel */
-    };
-    packers = malloc(sizeof(temp));
-    if (packers == NULL) {
-        fprintf(stderr, "PackInit: failed to allocate memory for packers table\n");
-        exit(1);
-    }
-    memcpy(packers, temp, sizeof(temp));
-}
-
-void
-ImagingPackFree(void) {
-    free(packers);
-    packers = NULL;
-}
diff --git a/src/libImaging/Palette.c b/src/libImaging/Palette.c
index 6b4fea6a5fd..2bbdb69ef65 100644
--- a/src/libImaging/Palette.c
+++ b/src/libImaging/Palette.c
@@ -21,7 +21,7 @@
 #include <math.h>
 
 ImagingPalette
-ImagingPaletteNew(const Mode *mode) {
+ImagingPaletteNew(const ModeID mode) {
     /* Create a palette object */
 
     int i;
diff --git a/src/libImaging/Point.c b/src/libImaging/Point.c
index e33f38508dc..fa0b1027cd0 100644
--- a/src/libImaging/Point.c
+++ b/src/libImaging/Point.c
@@ -128,7 +128,7 @@ im_point_32_8(Imaging imOut, Imaging imIn, im_point_context *context) {
 }
 
 Imaging
-ImagingPoint(Imaging imIn, const Mode *mode, const void *table) {
+ImagingPoint(Imaging imIn, ModeID mode, const void *table) {
     /* lookup table transform */
 
     ImagingSectionCookie cookie;
@@ -140,7 +140,7 @@ ImagingPoint(Imaging imIn, const Mode *mode, const void *table) {
         return (Imaging)ImagingError_ModeError();
     }
 
-    if (!mode) {
+    if (mode == IMAGING_MODE_UNKNOWN) {
         mode = imIn->mode;
     }
 
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index 38142b7c5e1..c09062c92e5 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -42,7 +42,7 @@
  */
 
 Imaging
-ImagingNewPrologueSubtype(const Mode *mode, int xsize, int ysize, int size) {
+ImagingNewPrologueSubtype(const ModeID mode, int xsize, int ysize, int size) {
     Imaging im;
 
     /* linesize overflow check, roughly the current largest space req'd */
@@ -256,7 +256,7 @@ ImagingNewPrologueSubtype(const Mode *mode, int xsize, int ysize, int size) {
 }
 
 Imaging
-ImagingNewPrologue(const Mode *mode, int xsize, int ysize) {
+ImagingNewPrologue(const ModeID mode, int xsize, int ysize) {
     return ImagingNewPrologueSubtype(
         mode, xsize, ysize, sizeof(struct ImagingMemoryInstance)
     );
@@ -593,7 +593,7 @@ ImagingBorrowArrow(
  */
 
 Imaging
-ImagingNewInternal(const Mode *mode, int xsize, int ysize, int dirty) {
+ImagingNewInternal(const ModeID mode, int xsize, int ysize, int dirty) {
     Imaging im;
 
     if (xsize < 0 || ysize < 0) {
@@ -629,7 +629,7 @@ ImagingNewInternal(const Mode *mode, int xsize, int ysize, int dirty) {
 }
 
 Imaging
-ImagingNew(const Mode *mode, int xsize, int ysize) {
+ImagingNew(const ModeID mode, int xsize, int ysize) {
     if (ImagingDefaultArena.use_block_allocator) {
         return ImagingNewBlock(mode, xsize, ysize);
     }
@@ -637,7 +637,7 @@ ImagingNew(const Mode *mode, int xsize, int ysize) {
 }
 
 Imaging
-ImagingNewDirty(const Mode *mode, int xsize, int ysize) {
+ImagingNewDirty(const ModeID mode, int xsize, int ysize) {
     if (ImagingDefaultArena.use_block_allocator) {
         return ImagingNewBlock(mode, xsize, ysize);
     }
@@ -645,7 +645,7 @@ ImagingNewDirty(const Mode *mode, int xsize, int ysize) {
 }
 
 Imaging
-ImagingNewBlock(const Mode *mode, int xsize, int ysize) {
+ImagingNewBlock(const ModeID mode, int xsize, int ysize) {
     Imaging im;
 
     if (xsize < 0 || ysize < 0) {
@@ -667,7 +667,7 @@ ImagingNewBlock(const Mode *mode, int xsize, int ysize) {
 
 Imaging
 ImagingNewArrow(
-    const Mode *mode,
+    const ModeID mode,
     int xsize,
     int ysize,
     PyObject *schema_capsule,
@@ -740,7 +740,7 @@ ImagingNewArrow(
 }
 
 Imaging
-ImagingNew2Dirty(const Mode *mode, Imaging imOut, Imaging imIn) {
+ImagingNew2Dirty(const ModeID mode, Imaging imOut, Imaging imIn) {
     /* allocate or validate output image */
 
     if (imOut) {
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index 40e8fba505f..f987c608f8a 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -640,7 +640,7 @@ ImagingLibTiffDecode(
     );
     TRACE(
         ("Image: mode %s, type %d, bands: %d, xsize %d, ysize %d \n",
-         im->mode->name,
+         getModeData(im->mode)->name,
          im->type,
          im->bands,
          im->xsize,
@@ -987,7 +987,7 @@ ImagingLibTiffEncode(Imaging im, ImagingCodecState state, UINT8 *buffer, int byt
     );
     TRACE(
         ("Image: mode %s, type %d, bands: %d, xsize %d, ysize %d \n",
-         im->mode->name,
+         getModeData(im->mode)->name,
          im->type,
          im->bands,
          im->xsize,
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 78760215189..8d4bb86190a 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1313,7 +1313,7 @@ copy4skip2(UINT8 *_out, const UINT8 *in, int pixels) {
 /* Unpack to "I" and "F" images */
 
 #define UNPACK_RAW(NAME, GET, INTYPE, OUTTYPE)                   \
-    static void NAME(UINT8 *out_, const UINT8 *in, int pixels) { \
+    static void NAME(UINT8 *out, const UINT8 *in, int pixels) { \
         int i;                                                   \
         OUTTYPE *out = (OUTTYPE *)out_;                          \
         for (i = 0; i < pixels; i++, in += sizeof(INTYPE)) {     \
@@ -1322,7 +1322,7 @@ copy4skip2(UINT8 *_out, const UINT8 *in, int pixels) {
     }
 
 #define UNPACK(NAME, COPY, INTYPE, OUTTYPE)                      \
-    static void NAME(UINT8 *out_, const UINT8 *in, int pixels) { \
+    static void NAME(UINT8 *out, const UINT8 *in, int pixels) { \
         int i;                                                   \
         OUTTYPE *out = (OUTTYPE *)out_;                          \
         INTYPE tmp_;                                             \
@@ -1541,13 +1541,12 @@ band316L(UINT8 *out, const UINT8 *in, int pixels) {
     }
 }
 
-static struct Unpacker {
-    const Mode *mode;
-    const RawMode *rawmode;
+static struct {
+    const ModeID mode;
+    const RawModeID rawmode;
     int bits;
     ImagingShuffler unpack;
 } unpackers[] = {
-
     /* raw mode syntax is "<mode>;<bits><flags>" where "bits" defaults
        depending on mode (1 for "1", 8 for "P" and "L", etc), and
        "flags" should be given in alphabetical order.  if both bits
@@ -1560,297 +1559,294 @@ static struct Unpacker {
     /* exception: rawmodes "I" and "F" are always native endian byte order */
 
     /* bilevel */
-    {"1", "1", 1, unpack1},
-    {"1", "1;I", 1, unpack1I},
-    {"1", "1;R", 1, unpack1R},
-    {"1", "1;IR", 1, unpack1IR},
-    {"1", "1;8", 8, unpack18},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1, 1, unpack1},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1_I, 1, unpack1I},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1_R, 1, unpack1R},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1_IR, 1, unpack1IR},
+    {IMAGING_MODE_1, IMAGING_RAWMODE_1_8, 8, unpack18},
 
     /* grayscale */
-    {"L", "L;2", 2, unpackL2},
-    {"L", "L;2I", 2, unpackL2I},
-    {"L", "L;2R", 2, unpackL2R},
-    {"L", "L;2IR", 2, unpackL2IR},
-
-    {"L", "L;4", 4, unpackL4},
-    {"L", "L;4I", 4, unpackL4I},
-    {"L", "L;4R", 4, unpackL4R},
-    {"L", "L;4IR", 4, unpackL4IR},
-
-    {"L", "L", 8, copy1},
-    {"L", "L;I", 8, unpackLI},
-    {"L", "L;R", 8, unpackLR},
-    {"L", "L;16", 16, unpackL16},
-    {"L", "L;16B", 16, unpackL16B},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_2, 2, unpackL2},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_2I, 2, unpackL2I},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_2R, 2, unpackL2R},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_2IR, 2, unpackL2IR},
+
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_4, 4, unpackL4},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_4I, 4, unpackL4I},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_4R, 4, unpackL4R},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_4IR, 4, unpackL4IR},
+
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L, 8, copy1},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_I, 8, unpackLI},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_R, 8, unpackLR},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_16, 16, unpackL16},
+    {IMAGING_MODE_L, IMAGING_RAWMODE_L_16B, 16, unpackL16B},
 
     /* grayscale w. alpha */
-    {"LA", "LA", 16, unpackLA},
-    {"LA", "LA;L", 16, unpackLAL},
+    {IMAGING_MODE_LA, IMAGING_RAWMODE_LA, 16, unpackLA},
+    {IMAGING_MODE_LA, IMAGING_RAWMODE_LA_L, 16, unpackLAL},
 
     /* grayscale w. alpha premultiplied */
-    {"La", "La", 16, unpackLA},
+    {IMAGING_MODE_La, IMAGING_RAWMODE_La, 16, unpackLA},
 
     /* palette */
-    {"P", "P;1", 1, unpackP1},
-    {"P", "P;2", 2, unpackP2},
-    {"P", "P;2L", 2, unpackP2L},
-    {"P", "P;4", 4, unpackP4},
-    {"P", "P;4L", 4, unpackP4L},
-    {"P", "P", 8, copy1},
-    {"P", "P;R", 8, unpackLR},
-    {"P", "L", 8, copy1},
-    {"P", "PX", 16, unpackL16B},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_1, 1, unpackP1},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_2, 2, unpackP2},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_2L, 2, unpackP2L},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_4, 4, unpackP4},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_4L, 4, unpackP4L},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P, 8, copy1},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_P_R, 8, unpackLR},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_L, 8, copy1},
+    {IMAGING_MODE_P, IMAGING_RAWMODE_PX, 16, unpackL16B},
 
     /* palette w. alpha */
-    {"PA", "PA", 16, unpackLA},
-    {"PA", "PA;L", 16, unpackLAL},
-    {"PA", "LA", 16, unpackLA},
+    {IMAGING_MODE_PA, IMAGING_RAWMODE_PA, 16, unpackLA},
+    {IMAGING_MODE_PA, IMAGING_RAWMODE_PA_L, 16, unpackLAL},
+    {IMAGING_MODE_PA, IMAGING_RAWMODE_LA, 16, unpackLA},
 
     /* true colour */
-    {"RGB", "RGB", 24, ImagingUnpackRGB},
-    {"RGB", "RGB;L", 24, unpackRGBL},
-    {"RGB", "RGB;R", 24, unpackRGBR},
-    {"RGB", "RGB;16L", 48, unpackRGB16L},
-    {"RGB", "RGB;16B", 48, unpackRGB16B},
-    {"RGB", "BGR", 24, ImagingUnpackBGR},
-    {"RGB", "RGB;15", 16, ImagingUnpackRGB15},
-    {"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},
-    {"RGB", "BGXR", 32, ImagingUnpackBGXR},
-    {"RGB", "XRGB", 32, ImagingUnpackXRGB},
-    {"RGB", "XBGR", 32, ImagingUnpackXBGR},
-    {"RGB", "YCC;P", 24, ImagingUnpackYCC},
-    {"RGB", "R", 8, band0},
-    {"RGB", "G", 8, band1},
-    {"RGB", "B", 8, band2},
-    {"RGB", "R;16L", 16, band016L},
-    {"RGB", "G;16L", 16, band116L},
-    {"RGB", "B;16L", 16, band216L},
-    {"RGB", "R;16B", 16, band016B},
-    {"RGB", "G;16B", 16, band116B},
-    {"RGB", "B;16B", 16, band216B},
-    {"RGB", "CMYK", 32, cmyk2rgb},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB, 24, ImagingUnpackRGB},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_L, 24, unpackRGBL},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_R, 24, unpackRGBR},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16L, 48, unpackRGB16L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16B, 48, unpackRGB16B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR, 24, ImagingUnpackBGR},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_15, 16, ImagingUnpackRGB15},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_15, 16, ImagingUnpackBGR15},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16, 16, ImagingUnpackRGB16},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_16, 16, ImagingUnpackBGR16},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16L, 64, unpackRGBA16L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16B, 64, unpackRGBA16B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_4B, 16, ImagingUnpackRGB4B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_5, 16, ImagingUnpackBGR15}, /* compat */
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX, 32, copy4},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_L, 32, unpackRGBAL},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBXX, 40, copy4skip1},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBXXX, 48, copy4skip2},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA_L, 32, unpackRGBAL},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA_15, 16, ImagingUnpackRGBA15},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGRX, 32, ImagingUnpackBGRX},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGXR, 32, ImagingUnpackBGXR},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_XRGB, 32, ImagingUnpackXRGB},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_XBGR, 32, ImagingUnpackXBGR},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_YCC_P, 24, ImagingUnpackYCC},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_R, 8, band0},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_G, 8, band1},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_B, 8, band2},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16L, 16, band016L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16L, 16, band116L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16L, 16, band216L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16B, 16, band016B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16B, 16, band116B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16B, 16, band216B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_CMYK, 32, cmyk2rgb},
 
     /* true colour w. alpha */
-    {"RGBA", "LA", 16, unpackRGBALA},
-    {"RGBA", "LA;16B", 32, unpackRGBALA16B},
-    {"RGBA", "RGBA", 32, copy4},
-    {"RGBA", "RGBAX", 40, copy4skip1},
-    {"RGBA", "RGBAXX", 48, copy4skip2},
-    {"RGBA", "RGBa", 32, unpackRGBa},
-    {"RGBA", "RGBaX", 40, unpackRGBaskip1},
-    {"RGBA", "RGBaXX", 48, unpackRGBaskip2},
-    {"RGBA", "RGBa;16L", 64, unpackRGBa16L},
-    {"RGBA", "RGBa;16B", 64, unpackRGBa16B},
-    {"RGBA", "BGR", 24, ImagingUnpackBGR},
-    {"RGBA", "BGRa", 32, unpackBGRa},
-    {"RGBA", "RGBA;I", 32, unpackRGBAI},
-    {"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},
-    {"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},
-    {"RGBA", "R", 8, band0},
-    {"RGBA", "G", 8, band1},
-    {"RGBA", "B", 8, band2},
-    {"RGBA", "A", 8, band3},
-    {"RGBA", "R;16L", 16, band016L},
-    {"RGBA", "G;16L", 16, band116L},
-    {"RGBA", "B;16L", 16, band216L},
-    {"RGBA", "A;16L", 16, band316L},
-    {"RGBA", "R;16B", 16, band016B},
-    {"RGBA", "G;16B", 16, band116B},
-    {"RGBA", "B;16B", 16, band216B},
-    {"RGBA", "A;16B", 16, band316B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_LA, 16, unpackRGBALA},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_LA_16B, 32, unpackRGBALA16B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA, 32, copy4},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBAX, 40, copy4skip1},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBAXX, 48, copy4skip2},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa, 32, unpackRGBa},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBaX, 40, unpackRGBaskip1},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBaXX, 48, unpackRGBaskip2},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16L, 64, unpackRGBa16L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16B, 64, unpackRGBa16B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGR, 24, ImagingUnpackBGR},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRa, 32, unpackBGRa},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_I, 32, unpackRGBAI},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_L, 32, unpackRGBAL},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_15, 16, ImagingUnpackRGBA15},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_15, 16, ImagingUnpackBGRA15},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_15Z, 16, ImagingUnpackBGRA15Z},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_4B, 16, ImagingUnpackRGBA4B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16L, 64, unpackRGBA16L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16B, 64, unpackRGBA16B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA, 32, unpackBGRA},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_16L, 64, unpackBGRA16L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_16B, 64, unpackBGRA16B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGAR, 32, unpackBGAR},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ARGB, 32, unpackARGB},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ABGR, 32, unpackABGR},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_YCCA_P, 32, ImagingUnpackYCCA},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R, 8, band0},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G, 8, band1},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B, 8, band2},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A, 8, band3},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16L, 16, band016L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16L, 16, band116L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16L, 16, band216L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16L, 16, band316L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16B, 16, band016B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16B, 16, band116B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16B, 16, band216B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16B, 16, band316B},
 
 #ifdef WORDS_BIGENDIAN
-    {"RGB", "RGB;16N", 48, unpackRGB16B},
-    {"RGB", "RGBX;16N", 64, unpackRGBA16B},
-    {"RGBA", "RGBa;16N", 64, unpackRGBa16B},
-    {"RGBA", "RGBA;16N", 64, unpackRGBA16B},
-    {"RGBX", "RGBX;16N", 64, unpackRGBA16B},
-    {"RGB", "R;16N", 16, band016B},
-    {"RGB", "G;16N", 16, band116B},
-    {"RGB", "B;16N", 16, band216B},
-
-    {"RGBA", "R;16N", 16, band016B},
-    {"RGBA", "G;16N", 16, band116B},
-    {"RGBA", "B;16N", 16, band216B},
-    {"RGBA", "A;16N", 16, band316B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16N, 48, unpackRGB16B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16N, 64, unpackRGBa16B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16N, 64, unpackRGBA16B},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16N, 16, band016B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16N, 16, band116B},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16N, 16, band216B},
+
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16N, 16, band016B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16N, 16, band116B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16N, 16, band216B},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16N, 16, band316B},
 #else
-    {"RGB", "RGB;16N", 48, unpackRGB16L},
-    {"RGB", "RGBX;16N", 64, unpackRGBA16L},
-    {"RGBA", "RGBa;16N", 64, unpackRGBa16L},
-    {"RGBA", "RGBA;16N", 64, unpackRGBA16L},
-    {"RGBX", "RGBX;16N", 64, unpackRGBA16L},
-    {"RGB", "R;16N", 16, band016L},
-    {"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},
-    {"RGBA", "A;16N", 16, band316L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16N, 48, unpackRGB16L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16N, 64, unpackRGBa16L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16N, 64, unpackRGBA16L},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16N, 16, band016L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16N, 16, band116L},
+    {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16N, 16, band216L},
+
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16N, 16, band016L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16N, 16, band116L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16N, 16, band216L},
+    {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16N, 16, band316L},
 #endif
 
     /* true colour w. alpha premultiplied */
-    {"RGBa", "RGBa", 32, copy4},
-    {"RGBa", "BGRa", 32, unpackBGRA},
-    {"RGBa", "aRGB", 32, unpackARGB},
-    {"RGBa", "aBGR", 32, unpackABGR},
+    {IMAGING_MODE_RGBa, IMAGING_RAWMODE_RGBa, 32, copy4},
+    {IMAGING_MODE_RGBa, IMAGING_RAWMODE_BGRa, 32, unpackBGRA},
+    {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aRGB, 32, unpackARGB},
+    {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aBGR, 32, unpackABGR},
 
     /* true colour w. padding */
-    {"RGBX", "RGB", 24, ImagingUnpackRGB},
-    {"RGBX", "RGB;L", 24, unpackRGBL},
-    {"RGBX", "RGB;16B", 48, unpackRGB16B},
-    {"RGBX", "BGR", 24, ImagingUnpackBGR},
-    {"RGBX", "RGB;15", 16, ImagingUnpackRGB15},
-    {"RGBX", "BGR;15", 16, ImagingUnpackBGR15},
-    {"RGBX", "RGB;4B", 16, ImagingUnpackRGB4B},
-    {"RGBX", "BGR;5", 16, ImagingUnpackBGR15}, /* compat */
-    {"RGBX", "RGBX", 32, copy4},
-    {"RGBX", "RGBXX", 40, copy4skip1},
-    {"RGBX", "RGBXXX", 48, copy4skip2},
-    {"RGBX", "RGBX;L", 32, unpackRGBAL},
-    {"RGBX", "RGBX;16L", 64, unpackRGBA16L},
-    {"RGBX", "RGBX;16B", 64, unpackRGBA16B},
-    {"RGBX", "BGRX", 32, ImagingUnpackBGRX},
-    {"RGBX", "XRGB", 32, ImagingUnpackXRGB},
-    {"RGBX", "XBGR", 32, ImagingUnpackXBGR},
-    {"RGBX", "YCC;P", 24, ImagingUnpackYCC},
-    {"RGBX", "R", 8, band0},
-    {"RGBX", "G", 8, band1},
-    {"RGBX", "B", 8, band2},
-    {"RGBX", "X", 8, band3},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB, 24, ImagingUnpackRGB},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_L, 24, unpackRGBL},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_16B, 48, unpackRGB16B},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR, 24, ImagingUnpackBGR},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_15, 16, ImagingUnpackRGB15},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR_15, 16, ImagingUnpackBGR15},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_4B, 16, ImagingUnpackRGB4B},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR_5, 16, ImagingUnpackBGR15}, /* compat */
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX, 32, copy4},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBXX, 40, copy4skip1},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBXXX, 48, copy4skip2},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_L, 32, unpackRGBAL},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16L, 64, unpackRGBA16L},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16B, 64, unpackRGBA16B},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGRX, 32, ImagingUnpackBGRX},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XRGB, 32, ImagingUnpackXRGB},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XBGR, 32, ImagingUnpackXBGR},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_YCC_P, 24, ImagingUnpackYCC},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_R, 8, band0},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_G, 8, band1},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_B, 8, band2},
+    {IMAGING_MODE_RGBX, IMAGING_RAWMODE_X, 8, band3},
 
     /* colour separation */
-    {"CMYK", "CMYK", 32, copy4},
-    {"CMYK", "CMYKX", 40, copy4skip1},
-    {"CMYK", "CMYKXX", 48, copy4skip2},
-    {"CMYK", "CMYK;I", 32, unpackCMYKI},
-    {"CMYK", "CMYK;L", 32, unpackRGBAL},
-    {"CMYK", "CMYK;16L", 64, unpackRGBA16L},
-    {"CMYK", "CMYK;16B", 64, unpackRGBA16B},
-    {"CMYK", "C", 8, band0},
-    {"CMYK", "M", 8, band1},
-    {"CMYK", "Y", 8, band2},
-    {"CMYK", "K", 8, band3},
-    {"CMYK", "C;I", 8, band0I},
-    {"CMYK", "M;I", 8, band1I},
-    {"CMYK", "Y;I", 8, band2I},
-    {"CMYK", "K;I", 8, band3I},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK, 32, copy4},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYKX, 40, copy4skip1},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYKXX, 48, copy4skip2},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_I, 32, unpackCMYKI},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_L, 32, unpackRGBAL},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16L, 64, unpackRGBA16L},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16B, 64, unpackRGBA16B},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C, 8, band0},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M, 8, band1},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y, 8, band2},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K, 8, band3},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C_I, 8, band0I},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M_I, 8, band1I},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y_I, 8, band2I},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K_I, 8, band3I},
 
 #ifdef WORDS_BIGENDIAN
-    {"CMYK", "CMYK;16N", 64, unpackRGBA16B},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16N, 64, unpackRGBA16B},
 #else
-    {"CMYK", "CMYK;16N", 64, unpackRGBA16L},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16N, 64, unpackRGBA16L},
 #endif
 
     /* video (YCbCr) */
-    {"YCbCr", "YCbCr", 24, ImagingUnpackRGB},
-    {"YCbCr", "YCbCr;L", 24, unpackRGBL},
-    {"YCbCr", "YCbCrX", 32, copy4},
-    {"YCbCr", "YCbCrK", 32, copy4},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr, 24, ImagingUnpackRGB},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr_L, 24, unpackRGBL},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrX, 32, copy4},
+    {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrK, 32, copy4},
 
     /* LAB Color */
-    {"LAB", "LAB", 24, ImagingUnpackLAB},
-    {"LAB", "L", 8, band0},
-    {"LAB", "A", 8, band1},
-    {"LAB", "B", 8, band2},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_LAB, 24, ImagingUnpackLAB},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_L, 8, band0},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_A, 8, band1},
+    {IMAGING_MODE_LAB, IMAGING_RAWMODE_B, 8, band2},
 
     /* HSV Color */
-    {"HSV", "HSV", 24, ImagingUnpackRGB},
-    {"HSV", "H", 8, band0},
-    {"HSV", "S", 8, band1},
-    {"HSV", "V", 8, band2},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_HSV, 24, ImagingUnpackRGB},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_H, 8, band0},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_S, 8, band1},
+    {IMAGING_MODE_HSV, IMAGING_RAWMODE_V, 8, band2},
 
     /* integer variations */
-    {"I", "I", 32, copy4},
-    {"I", "I;8", 8, unpackI8},
-    {"I", "I;8S", 8, unpackI8S},
-    {"I", "I;16", 16, unpackI16},
-    {"I", "I;16S", 16, unpackI16S},
-    {"I", "I;16B", 16, unpackI16B},
-    {"I", "I;16BS", 16, unpackI16BS},
-    {"I", "I;16N", 16, unpackI16N},
-    {"I", "I;16NS", 16, unpackI16NS},
-    {"I", "I;32", 32, unpackI32},
-    {"I", "I;32S", 32, unpackI32S},
-    {"I", "I;32B", 32, unpackI32B},
-    {"I", "I;32BS", 32, unpackI32BS},
-    {"I", "I;32N", 32, unpackI32N},
-    {"I", "I;32NS", 32, unpackI32NS},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I, 32, copy4},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_8, 8, unpackI8},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_8S, 8, unpackI8S},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_16, 16, unpackI16},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_16S, 16, unpackI16S},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_16B, 16, unpackI16B},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_16BS, 16, unpackI16BS},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_16N, 16, unpackI16N},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_16NS, 16, unpackI16NS},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32, 32, unpackI32},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32S, 32, unpackI32S},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32B, 32, unpackI32B},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32BS, 32, unpackI32BS},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32N, 32, unpackI32N},
+    {IMAGING_MODE_I, IMAGING_RAWMODE_I_32NS, 32, unpackI32NS},
 
     /* floating point variations */
-    {"F", "F", 32, copy4},
-    {"F", "F;8", 8, unpackF8},
-    {"F", "F;8S", 8, unpackF8S},
-    {"F", "F;16", 16, unpackF16},
-    {"F", "F;16S", 16, unpackF16S},
-    {"F", "F;16B", 16, unpackF16B},
-    {"F", "F;16BS", 16, unpackF16BS},
-    {"F", "F;16N", 16, unpackF16N},
-    {"F", "F;16NS", 16, unpackF16NS},
-    {"F", "F;32", 32, unpackF32},
-    {"F", "F;32S", 32, unpackF32S},
-    {"F", "F;32B", 32, unpackF32B},
-    {"F", "F;32BS", 32, unpackF32BS},
-    {"F", "F;32N", 32, unpackF32N},
-    {"F", "F;32NS", 32, unpackF32NS},
-    {"F", "F;32F", 32, unpackF32F},
-    {"F", "F;32BF", 32, unpackF32BF},
-    {"F", "F;32NF", 32, unpackF32NF},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F, 32, copy4},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_8, 8, unpackF8},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_8S, 8, unpackF8S},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_16, 16, unpackF16},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_16S, 16, unpackF16S},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_16B, 16, unpackF16B},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_16BS, 16, unpackF16BS},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_16N, 16, unpackF16N},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_16NS, 16, unpackF16NS},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32, 32, unpackF32},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32S, 32, unpackF32S},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32B, 32, unpackF32B},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32BS, 32, unpackF32BS},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32N, 32, unpackF32N},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NS, 32, unpackF32NS},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32F, 32, unpackF32F},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32BF, 32, unpackF32BF},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NF, 32, unpackF32NF},
 #ifdef FLOAT64
-    {"F", "F;64F", 64, unpackF64F},
-    {"F", "F;64BF", 64, unpackF64BF},
-    {"F", "F;64NF", 64, unpackF64NF},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_64F, 64, unpackF64F},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_64BF, 64, unpackF64BF},
+    {IMAGING_MODE_F, IMAGING_RAWMODE_F_64NF, 64, unpackF64NF},
 #endif
 
     /* storage modes */
-    {"I;16", "I;16", 16, copy2},
-    {"I;16B", "I;16B", 16, copy2},
-    {"I;16L", "I;16L", 16, copy2},
-    {"I;16N", "I;16N", 16, copy2},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16, 16, copy2},
+    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
+    {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
+    {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
 
-    {"I;16", "I;16B", 16, unpackI16B_I16},
-    {"I;16", "I;16N", 16, unpackI16N_I16},   // LibTiff native->image endian.
-    {"I;16L", "I;16N", 16, unpackI16N_I16},  // LibTiff native->image endian.
-    {"I;16B", "I;16N", 16, unpackI16N_I16B},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, unpackI16B_I16},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16},   // LibTiff native->image endian.
+    {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16},  // LibTiff native->image endian.
+    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16B},
 
-    {"I;16", "I;16R", 16, unpackI16R_I16},
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16R, 16, unpackI16R_I16},
 
-    {"I;16", "I;12", 12, unpackI12_I16},  // 12 bit Tiffs stored in 16bits.
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_12, 12, unpackI12_I16},  // 12 bit Tiffs stored in 16bits.
 
     {NULL} /* sentinel */
 };
 
 ImagingShuffler
-ImagingFindUnpacker(const Mode *mode, const RawMode *rawmode, int *bits_out) {
-    int i;
-
-    /* find a suitable pixel unpacker */
-    for (i = 0; unpackers[i].rawmode; i++) {
+ImagingFindUnpacker(const ModeID mode, const RawModeID rawmode, int *bits_out) {
+    for (size_t i = 0; i < sizeof(unpackers) / sizeof(*unpackers); i++) {
         if (unpackers[i].mode == mode && unpackers[i].rawmode == rawmode) {
             if (bits_out) {
                 *bits_out = unpackers[i].bits;
@@ -1863,317 +1859,3 @@ ImagingFindUnpacker(const Mode *mode, const RawMode *rawmode, int *bits_out) {
 
     return NULL;
 }
-
-void
-ImagingUnpackInit(void) {
-    const struct Unpacker temp[] = {
-        /* raw mode syntax is "<mode>;<bits><flags>" where "bits" defaults
-           depending on mode (1 for "1", 8 for "P" and "L", etc), and
-           "flags" should be given in alphabetical order.  if both bits
-           and flags have their default values, the ; should be left out */
-
-        /* 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, "Z" inverted alpha */
-
-        /* exception: rawmodes "I" and "F" are always native endian byte order */
-
-        /* bilevel */
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1, 1, unpack1},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1_I, 1, unpack1I},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1_R, 1, unpack1R},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1_IR, 1, unpack1IR},
-        {IMAGING_MODE_1, IMAGING_RAWMODE_1_8, 8, unpack18},
-
-        /* grayscale */
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2, 2, unpackL2},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2I, 2, unpackL2I},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2R, 2, unpackL2R},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_2IR, 2, unpackL2IR},
-
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4, 4, unpackL4},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4I, 4, unpackL4I},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4R, 4, unpackL4R},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_4IR, 4, unpackL4IR},
-
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L, 8, copy1},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_I, 8, unpackLI},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_R, 8, unpackLR},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16, 16, unpackL16},
-        {IMAGING_MODE_L, IMAGING_RAWMODE_L_16B, 16, unpackL16B},
-
-        /* grayscale w. alpha */
-        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA, 16, unpackLA},
-        {IMAGING_MODE_LA, IMAGING_RAWMODE_LA_L, 16, unpackLAL},
-
-        /* grayscale w. alpha premultiplied */
-        {IMAGING_MODE_La, IMAGING_RAWMODE_La, 16, unpackLA},
-
-        /* palette */
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_1, 1, unpackP1},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_2, 2, unpackP2},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_2L, 2, unpackP2L},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_4, 4, unpackP4},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_4L, 4, unpackP4L},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P, 8, copy1},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_P_R, 8, unpackLR},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_L, 8, copy1},
-        {IMAGING_MODE_P, IMAGING_RAWMODE_PX, 16, unpackL16B},
-
-        /* palette w. alpha */
-        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA, 16, unpackLA},
-        {IMAGING_MODE_PA, IMAGING_RAWMODE_PA_L, 16, unpackLAL},
-        {IMAGING_MODE_PA, IMAGING_RAWMODE_LA, 16, unpackLA},
-
-        /* true colour */
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB, 24, ImagingUnpackRGB},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_L, 24, unpackRGBL},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_R, 24, unpackRGBR},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16L, 48, unpackRGB16L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16B, 48, unpackRGB16B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR, 24, ImagingUnpackBGR},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_15, 16, ImagingUnpackRGB15},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_15, 16, ImagingUnpackBGR15},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16, 16, ImagingUnpackRGB16},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_16, 16, ImagingUnpackBGR16},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16L, 64, unpackRGBA16L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_16B, 64, unpackRGBA16B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_4B, 16, ImagingUnpackRGB4B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGR_5, 16, ImagingUnpackBGR15}, /* compat */
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX, 32, copy4},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBX_L, 32, unpackRGBAL},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBXX, 40, copy4skip1},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBXXX, 48, copy4skip2},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA_L, 32, unpackRGBAL},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGBA_15, 16, ImagingUnpackRGBA15},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGRX, 32, ImagingUnpackBGRX},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_BGXR, 32, ImagingUnpackBGXR},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XRGB, 32, ImagingUnpackXRGB},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_XBGR, 32, ImagingUnpackXBGR},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_YCC_P, 24, ImagingUnpackYCC},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R, 8, band0},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G, 8, band1},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B, 8, band2},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16L, 16, band016L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16L, 16, band116L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16L, 16, band216L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16B, 16, band016B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16B, 16, band116B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16B, 16, band216B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_CMYK, 32, cmyk2rgb},
-
-        {IMAGING_MODE_BGR_15, IMAGING_RAWMODE_BGR_15, 16, copy2},
-        {IMAGING_MODE_BGR_16, IMAGING_RAWMODE_BGR_16, 16, copy2},
-        {IMAGING_MODE_BGR_24, IMAGING_RAWMODE_BGR_24, 24, copy3},
-
-        /* true colour w. alpha */
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_LA, 16, unpackRGBALA},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_LA_16B, 32, unpackRGBALA16B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA, 32, copy4},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBAX, 40, copy4skip1},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBAXX, 48, copy4skip2},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa, 32, unpackRGBa},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBaX, 40, unpackRGBaskip1},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBaXX, 48, unpackRGBaskip2},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16L, 64, unpackRGBa16L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16B, 64, unpackRGBa16B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRa, 32, unpackBGRa},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_I, 32, unpackRGBAI},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_L, 32, unpackRGBAL},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_15, 16, ImagingUnpackRGBA15},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_15, 16, ImagingUnpackBGRA15},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_15Z, 16, ImagingUnpackBGRA15Z},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_4B, 16, ImagingUnpackRGBA4B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16L, 64, unpackRGBA16L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16B, 64, unpackRGBA16B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA, 32, unpackBGRA},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_16L, 64, unpackBGRA16L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGRA_16B, 64, unpackBGRA16B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_BGAR, 32, unpackBGAR},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ARGB, 32, unpackARGB},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_ABGR, 32, unpackABGR},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_YCCA_P, 32, ImagingUnpackYCCA},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R, 8, band0},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G, 8, band1},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B, 8, band2},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A, 8, band3},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16L, 16, band016L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16L, 16, band116L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16L, 16, band216L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16L, 16, band316L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16B, 16, band016B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16B, 16, band116B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16B, 16, band216B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16B, 16, band316B},
-
-#ifdef WORDS_BIGENDIAN
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16N, 48, unpackRGB16B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16N, 64, unpackRGBa16B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16N, 64, unpackRGBA16B},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16N, 16, band016B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16N, 16, band116B},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16N, 16, band216B},
-
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16N, 16, band016B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16N, 16, band116B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16N, 16, band216B},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16N, 16, band316B},
-#else
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_RGB_16N, 48, unpackRGB16L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa_16N, 64, unpackRGBa16L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBA_16N, 64, unpackRGBA16L},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16N, 64, unpackRGBA16L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_R_16N, 16, band016L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_G_16N, 16, band116L},
-        {IMAGING_MODE_RGB, IMAGING_RAWMODE_B_16N, 16, band216L},
-
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_R_16N, 16, band016L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_G_16N, 16, band116L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_B_16N, 16, band216L},
-        {IMAGING_MODE_RGBA, IMAGING_RAWMODE_A_16N, 16, band316L},
-#endif
-
-        /* true colour w. alpha premultiplied */
-        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_RGBa, 32, copy4},
-        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_BGRa, 32, unpackBGRA},
-        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aRGB, 32, unpackARGB},
-        {IMAGING_MODE_RGBa, IMAGING_RAWMODE_aBGR, 32, unpackABGR},
-
-        /* true colour w. padding */
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB, 24, ImagingUnpackRGB},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_L, 24, unpackRGBL},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_16B, 48, unpackRGB16B},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR, 24, ImagingUnpackBGR},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_15, 16, ImagingUnpackRGB15},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR_15, 16, ImagingUnpackBGR15},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGB_4B, 16, ImagingUnpackRGB4B},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGR_5, 16, ImagingUnpackBGR15}, /* compat */
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX, 32, copy4},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBXX, 40, copy4skip1},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBXXX, 48, copy4skip2},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_L, 32, unpackRGBAL},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16L, 64, unpackRGBA16L},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_RGBX_16B, 64, unpackRGBA16B},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_BGRX, 32, ImagingUnpackBGRX},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XRGB, 32, ImagingUnpackXRGB},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_XBGR, 32, ImagingUnpackXBGR},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_YCC_P, 24, ImagingUnpackYCC},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_R, 8, band0},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_G, 8, band1},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_B, 8, band2},
-        {IMAGING_MODE_RGBX, IMAGING_RAWMODE_X, 8, band3},
-
-        /* colour separation */
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK, 32, copy4},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYKX, 40, copy4skip1},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYKXX, 48, copy4skip2},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_I, 32, unpackCMYKI},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_L, 32, unpackRGBAL},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16L, 64, unpackRGBA16L},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16B, 64, unpackRGBA16B},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C, 8, band0},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M, 8, band1},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y, 8, band2},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K, 8, band3},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_C_I, 8, band0I},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M_I, 8, band1I},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y_I, 8, band2I},
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K_I, 8, band3I},
-
-#ifdef WORDS_BIGENDIAN
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16N, 64, unpackRGBA16B},
-#else
-        {IMAGING_MODE_CMYK, IMAGING_RAWMODE_CMYK_16N, 64, unpackRGBA16L},
-#endif
-
-        /* video (YCbCr) */
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr, 24, ImagingUnpackRGB},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr_L, 24, unpackRGBL},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrX, 32, copy4},
-        {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCrK, 32, copy4},
-
-        /* LAB Color */
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_LAB, 24, ImagingUnpackLAB},
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_L, 8, band0},
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_A, 8, band1},
-        {IMAGING_MODE_LAB, IMAGING_RAWMODE_B, 8, band2},
-
-        /* HSV Color */
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_HSV, 24, ImagingUnpackRGB},
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_H, 8, band0},
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_S, 8, band1},
-        {IMAGING_MODE_HSV, IMAGING_RAWMODE_V, 8, band2},
-
-        /* integer variations */
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I, 32, copy4},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_8, 8, unpackI8},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_8S, 8, unpackI8S},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16, 16, unpackI16},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16S, 16, unpackI16S},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16B, 16, unpackI16B},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16BS, 16, unpackI16BS},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16N, 16, unpackI16N},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_16NS, 16, unpackI16NS},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32, 32, unpackI32},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32S, 32, unpackI32S},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32B, 32, unpackI32B},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32BS, 32, unpackI32BS},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32N, 32, unpackI32N},
-        {IMAGING_MODE_I, IMAGING_RAWMODE_I_32NS, 32, unpackI32NS},
-
-        /* floating point variations */
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F, 32, copy4},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_8, 8, unpackF8},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_8S, 8, unpackF8S},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16, 16, unpackF16},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16S, 16, unpackF16S},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16B, 16, unpackF16B},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16BS, 16, unpackF16BS},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16N, 16, unpackF16N},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_16NS, 16, unpackF16NS},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32, 32, unpackF32},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32S, 32, unpackF32S},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32B, 32, unpackF32B},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32BS, 32, unpackF32BS},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32N, 32, unpackF32N},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NS, 32, unpackF32NS},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32F, 32, unpackF32F},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32BF, 32, unpackF32BF},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_32NF, 32, unpackF32NF},
-#ifdef FLOAT64
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_64F, 64, unpackF64F},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_64BF, 64, unpackF64BF},
-        {IMAGING_MODE_F, IMAGING_RAWMODE_F_64NF, 64, unpackF64NF},
-#endif
-
-        /* storage modes */
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16, 16, copy2},
-        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
-        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
-        {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
-
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, unpackI16B_I16},
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16}, // LibTiff native->image endian.
-        {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16}, // LibTiff native->image endian.
-        {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16B},
-
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16R, 16, unpackI16R_I16},
-
-        {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_12, 12, unpackI12_I16}, // 12 bit Tiffs stored in 16bits.
-
-        {NULL} /* sentinel */
-    };
-    unpackers = malloc(sizeof(temp));
-    if (unpackers == NULL) {
-        fprintf(stderr, "UnpackInit: failed to allocate memory for unpackers table\n");
-        exit(1);
-    }
-    memcpy(unpackers, temp, sizeof(temp));
-}
-
-void
-ImagingUnpackFree(void) {
-    free(unpackers);
-    unpackers = NULL;
-}
diff --git a/src/map.c b/src/map.c
index 451cca58973..6f66b0cc57b 100644
--- a/src/map.c
+++ b/src/map.c
@@ -82,7 +82,7 @@ PyImaging_MapBuffer(PyObject *self, PyObject *args) {
         return NULL;
     }
 
-    const Mode * const mode = findMode(mode_name);
+    const ModeID mode = findModeID(mode_name);
 
     if (stride <= 0) {
         if (mode == IMAGING_MODE_L || mode == IMAGING_MODE_P) {

From 4d721bc5913986b31f451decb03f094c9f21a908 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Tue, 23 Apr 2024 12:41:49 -0500
Subject: [PATCH 1938/2374] use mode enums in _webp.c

---
 src/_webp.c | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/_webp.c b/src/_webp.c
index e84e786edfe..d065e329c6b 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -89,8 +89,8 @@ HandleMuxError(WebPMuxError err, char *chunk) {
 
 static int
 import_frame_libwebp(WebPPicture *frame, Imaging im) {
-    if (strcmp(im->mode, "RGBA") && strcmp(im->mode, "RGB") &&
-        strcmp(im->mode, "RGBX")) {
+    if (im->mode != IMAGING_MODE_RGBA && im->mode != IMAGING_MODE_RGB &&
+        im->mode != IMAGING_MODE_RGBX) {
         PyErr_SetString(PyExc_ValueError, "unsupported image mode");
         return -1;
     }
@@ -104,7 +104,7 @@ import_frame_libwebp(WebPPicture *frame, Imaging im) {
         return -2;
     }
 
-    int ignore_fourth_channel = strcmp(im->mode, "RGBA");
+    int ignore_fourth_channel = im->mode != IMAGING_MODE_RGBA;
     for (int y = 0; y < im->ysize; ++y) {
         UINT8 *src = (UINT8 *)im->image32[y];
         UINT32 *dst = frame->argb + frame->argb_stride * y;
@@ -143,7 +143,7 @@ typedef struct {
     PyObject_HEAD WebPAnimDecoder *dec;
     WebPAnimInfo info;
     WebPData data;
-    char *mode;
+    ModeID mode;
 } WebPAnimDecoderObject;
 
 static PyTypeObject WebPAnimDecoder_Type;
@@ -396,7 +396,7 @@ _anim_decoder_new(PyObject *self, PyObject *args) {
     const uint8_t *webp;
     Py_ssize_t size;
     WebPData webp_src;
-    char *mode;
+    ModeID mode;
     WebPDecoderConfig config;
     WebPAnimDecoderObject *decp = NULL;
     WebPAnimDecoder *dec = NULL;
@@ -409,10 +409,10 @@ _anim_decoder_new(PyObject *self, PyObject *args) {
     webp_src.size = size;
 
     // Sniff the mode, since the decoder API doesn't tell us
-    mode = "RGBA";
+    mode = IMAGING_MODE_RGBA;
     if (WebPGetFeatures(webp, size, &config.input) == VP8_STATUS_OK) {
         if (!config.input.has_alpha) {
-            mode = "RGBX";
+            mode = IMAGING_MODE_RGBX;
         }
     }
 
@@ -455,7 +455,7 @@ _anim_decoder_get_info(PyObject *self) {
         info->loop_count,
         info->bgcolor,
         info->frame_count,
-        decp->mode
+        getModeData(decp->mode)->name
     );
 }
 

From 85212dbbb6400255a0522a99ce7fa18a40ea3f81 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Sat, 19 Jul 2025 16:55:52 +0200
Subject: [PATCH 1939/2374] Add image band metadata for the 4 channel images

---
 Tests/test_pyarrow.py  | 27 +++++++++++++
 src/libImaging/Arrow.c | 86 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 112 insertions(+), 1 deletion(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index 8dad94fe035..a69504e78a0 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import json
 from typing import Any, NamedTuple
 
 import pytest
@@ -244,3 +245,29 @@ def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None)
     img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
 
     _test_img_equals_int32_pyarray(img, arr, mask, elts_per_pixel)
+
+
+@pytest.mark.parametrize(
+    "mode, metadata",
+    (
+        ("LA", ["L", "X", "X", "A"]),
+        ("RGB", ["R", "G", "B", "X"]),
+        ("RGBX", ["R", "G", "B", "X"]),
+        ("RGBA", ["R", "G", "B", "A"]),
+        ("CMYK", ["C", "M", "Y", "K"]),
+        ("YCbCr", ["Y", "Cb", "Cr", "X"]),
+        ("HSV", ["H", "S", "V", "X"]),
+    ),
+)
+def test_image_metadata(mode: str, metadata: list[str]) -> None:
+    img = hopper(mode)
+
+    arr = pyarrow.array(img)  # type: ignore[call-overload]
+
+    assert arr.type.field(0).metadata
+    assert arr.type.field(0).metadata[b"image"]
+
+    parsed_metadata = json.loads(arr.type.field(0).metadata[b"image"].decode("utf8"))
+
+    assert "bands" in parsed_metadata
+    assert parsed_metadata["bands"] == metadata
diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index ccafe33b97b..2ecec9b29bb 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -55,6 +55,77 @@ ReleaseExportedSchema(struct ArrowSchema *array) {
     // Mark array released
     array->release = NULL;
 }
+char *
+image_band_json(Imaging im) {
+    char *format = "{\"bands\": [\"%s\", \"%s\", \"%s\", \"%s\"]}";
+    char *json;
+    // Bands can be 4 bands * 2 characters each
+    int len = strlen(format) + 8 + 1;
+    int err;
+
+    json = calloc(1, len);
+
+    if (!json) {
+        return NULL;
+    }
+
+    err = PyOS_snprintf(
+        json,
+        len,
+        format,
+        im->band_names[0],
+        im->band_names[1],
+        im->band_names[2],
+        im->band_names[3]
+    );
+    if (err < 0) {
+        return NULL;
+    }
+    return json;
+}
+
+char *
+assemble_metadata(const char *band_json) {
+    /* format is
+       int32: number of key/value pairs (noted N below)
+       int32: byte length of key 0
+       key 0 (not null-terminated)
+       int32: byte length of value 0
+       value 0 (not null-terminated)
+       ...
+       int32: byte length of key N - 1
+       key N - 1 (not null-terminated)
+       int32: byte length of value N - 1
+       value N - 1 (not null-terminated)
+    */
+    const char *key = "image";
+    INT32 key_len = strlen(key);
+    INT32 band_json_len = strlen(band_json);
+
+    char *buf;
+    INT32 *dest_int;
+    char *dest;
+
+    buf = calloc(1, key_len + band_json_len + 4 + 1 * 8);
+    if (!buf) {
+        return NULL;
+    }
+
+    dest_int = (void *)buf;
+
+    dest_int[0] = 1;
+    dest_int[1] = key_len;
+    dest_int += 2;
+    dest = (void *)dest_int;
+    memcpy(dest, key, key_len);
+    dest += key_len;
+    dest_int = (void *)dest;
+    dest_int[0] = band_json_len;
+    dest_int += 1;
+    memcpy(dest_int, band_json, band_json_len);
+
+    return buf;
+}
 
 int
 export_named_type(struct ArrowSchema *schema, char *format, char *name) {
@@ -95,6 +166,8 @@ export_named_type(struct ArrowSchema *schema, char *format, char *name) {
 int
 export_imaging_schema(Imaging im, struct ArrowSchema *schema) {
     int retval = 0;
+    char *metadata;
+    char *band_json;
 
     if (strcmp(im->arrow_band_format, "") == 0) {
         return IMAGING_ARROW_INCOMPATIBLE_MODE;
@@ -117,13 +190,24 @@ export_imaging_schema(Imaging im, struct ArrowSchema *schema) {
     schema->n_children = 1;
     schema->children = calloc(1, sizeof(struct ArrowSchema *));
     schema->children[0] = (struct ArrowSchema *)calloc(1, sizeof(struct ArrowSchema));
-    retval = export_named_type(schema->children[0], im->arrow_band_format, "pixel");
+    retval = export_named_type(schema->children[0], im->arrow_band_format, im->mode);
     if (retval != 0) {
         free(schema->children[0]);
         free(schema->children);
         schema->release(schema);
         return retval;
     }
+
+    // band related metadata
+    band_json = image_band_json(im);
+    if (band_json) {
+        // adding the metadata to the child array.
+        // Accessible in pyarrow via pa.array(img).type.field(0).metadata
+        // adding it to the top level is not accessible.
+        schema->children[0]->metadata = assemble_metadata(band_json);
+        free(band_json);
+    }
+
     return 0;
 }
 

From aa39e84f7a465c91035d5ea0a3d522faf9f9159d Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 16:58:08 +0200
Subject: [PATCH 1940/2374] use mode enums in Jpeg2KDecode.c

---
 src/libImaging/Jpeg2KDecode.c | 44 +++++++++++++++++------------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index 67f705ddd59..1b496f45ec0 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -71,7 +71,7 @@ typedef void (*j2k_unpacker_t)(
 );
 
 struct j2k_decode_unpacker {
-    const char *mode;
+    const ModeID mode;
     OPJ_COLOR_SPACE color_space;
     unsigned components;
     /* bool indicating if unpacker supports subsampling */
@@ -599,26 +599,26 @@ 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},
-    {"RGB", OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_rgb},
-    {"RGB", OPJ_CLRSPC_GRAY, 2, 0, j2ku_gray_rgb},
-    {"RGB", OPJ_CLRSPC_SRGB, 3, 1, j2ku_srgb_rgb},
-    {"RGB", OPJ_CLRSPC_SYCC, 3, 1, j2ku_sycc_rgb},
-    {"RGB", OPJ_CLRSPC_SRGB, 4, 1, j2ku_srgb_rgb},
-    {"RGB", OPJ_CLRSPC_SYCC, 4, 1, j2ku_sycc_rgb},
-    {"RGBA", OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_rgb},
-    {"RGBA", OPJ_CLRSPC_GRAY, 2, 0, j2ku_graya_la},
-    {"RGBA", OPJ_CLRSPC_SRGB, 3, 1, j2ku_srgb_rgb},
-    {"RGBA", OPJ_CLRSPC_SYCC, 3, 1, j2ku_sycc_rgb},
-    {"RGBA", OPJ_CLRSPC_GRAY, 4, 1, j2ku_srgba_rgba},
-    {"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},
+    {IMAGING_MODE_L, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_l},
+    {IMAGING_MODE_P, OPJ_CLRSPC_SRGB, 1, 0, j2ku_gray_l},
+    {IMAGING_MODE_PA, OPJ_CLRSPC_SRGB, 2, 0, j2ku_graya_la},
+    {IMAGING_MODE_I_16, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_i},
+    {IMAGING_MODE_I_16B, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_i},
+    {IMAGING_MODE_LA, OPJ_CLRSPC_GRAY, 2, 0, j2ku_graya_la},
+    {IMAGING_MODE_RGB, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_rgb},
+    {IMAGING_MODE_RGB, OPJ_CLRSPC_GRAY, 2, 0, j2ku_gray_rgb},
+    {IMAGING_MODE_RGB, OPJ_CLRSPC_SRGB, 3, 1, j2ku_srgb_rgb},
+    {IMAGING_MODE_RGB, OPJ_CLRSPC_SYCC, 3, 1, j2ku_sycc_rgb},
+    {IMAGING_MODE_RGB, OPJ_CLRSPC_SRGB, 4, 1, j2ku_srgb_rgb},
+    {IMAGING_MODE_RGB, OPJ_CLRSPC_SYCC, 4, 1, j2ku_sycc_rgb},
+    {IMAGING_MODE_RGBA, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_rgb},
+    {IMAGING_MODE_RGBA, OPJ_CLRSPC_GRAY, 2, 0, j2ku_graya_la},
+    {IMAGING_MODE_RGBA, OPJ_CLRSPC_SRGB, 3, 1, j2ku_srgb_rgb},
+    {IMAGING_MODE_RGBA, OPJ_CLRSPC_SYCC, 3, 1, j2ku_sycc_rgb},
+    {IMAGING_MODE_RGBA, OPJ_CLRSPC_GRAY, 4, 1, j2ku_srgba_rgba},
+    {IMAGING_MODE_RGBA, OPJ_CLRSPC_SRGB, 4, 1, j2ku_srgba_rgba},
+    {IMAGING_MODE_RGBA, OPJ_CLRSPC_SYCC, 4, 1, j2ku_sycca_rgba},
+    {IMAGING_MODE_CMYK, OPJ_CLRSPC_CMYK, 4, 1, j2ku_srgba_rgba},
 };
 
 /* -------------------------------------------------------------------- */
@@ -771,7 +771,7 @@ j2k_decode_entry(Imaging im, ImagingCodecState state) {
         if (color_space == j2k_unpackers[n].color_space &&
             image->numcomps == j2k_unpackers[n].components &&
             (j2k_unpackers[n].subsampling || (subsampling == -1)) &&
-            strcmp(getModeData(im->mode)->name, j2k_unpackers[n].mode) == 0) {
+            im->mode == j2k_unpackers[n].mode) {
             unpack = j2k_unpackers[n].unpacker;
             break;
         }

From a53f83f023d3a4a166cc1107cb16aa5f0cc0f2c9 Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Tue, 23 Apr 2024 13:13:19 -0500
Subject: [PATCH 1941/2374] use mode enums in _imagingft.c

---
 src/_imagingft.c | 34 ++++++++++++++++++++++------------
 1 file changed, 22 insertions(+), 12 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 29d8e9e7112..a38ea507a33 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -525,7 +525,7 @@ font_getlength(FontObject *self, PyObject *args) {
     int horizontal_dir;           /* is primary axis horizontal? */
     int mask = 0;                 /* is FT_LOAD_TARGET_MONO enabled? */
     int color = 0;                /* is FT_LOAD_COLOR enabled? */
-    const char *mode = NULL;
+    const char *mode_name = NULL;
     const char *dir = NULL;
     const char *lang = NULL;
     PyObject *features = Py_None;
@@ -534,15 +534,16 @@ 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_name, &dir, &features, &lang
         )) {
         return NULL;
     }
 
     horizontal_dir = dir && strcmp(dir, "ttb") == 0 ? 0 : 1;
 
-    mask = mode && strcmp(mode, "1") == 0;
-    color = mode && strcmp(mode, "RGBA") == 0;
+    const ModeID mode = findModeID(mode_name);
+    mask = mode == IMAGING_MODE_1;
+    color = mode == IMAGING_MODE_RGBA;
 
     count = text_layout(string, self, dir, features, lang, &glyph_info, mask, color);
     if (PyErr_Occurred()) {
@@ -754,7 +755,7 @@ font_getsize(FontObject *self, PyObject *args) {
     int horizontal_dir;           /* is primary axis horizontal? */
     int mask = 0;                 /* is FT_LOAD_TARGET_MONO enabled? */
     int color = 0;                /* is FT_LOAD_COLOR enabled? */
-    const char *mode = NULL;
+    const char *mode_name = NULL;
     const char *dir = NULL;
     const char *lang = NULL;
     const char *anchor = NULL;
@@ -764,15 +765,23 @@ 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_name,
+            &dir,
+            &features,
+            &lang,
+            &anchor
         )) {
         return NULL;
     }
 
     horizontal_dir = dir && strcmp(dir, "ttb") == 0 ? 0 : 1;
 
-    mask = mode && strcmp(mode, "1") == 0;
-    color = mode && strcmp(mode, "RGBA") == 0;
+    const ModeID mode = findModeID(mode_name);
+    mask = mode == IMAGING_MODE_1;
+    color = mode == IMAGING_MODE_RGBA;
 
     count = text_layout(string, self, dir, features, lang, &glyph_info, mask, color);
     if (PyErr_Occurred()) {
@@ -839,7 +848,7 @@ font_render(FontObject *self, PyObject *args) {
     int stroke_filled = 0;
     PY_LONG_LONG foreground_ink_long = 0;
     unsigned int foreground_ink;
-    const char *mode = NULL;
+    const char *mode_name = NULL;
     const char *dir = NULL;
     const char *lang = NULL;
     const char *anchor = NULL;
@@ -859,7 +868,7 @@ font_render(FontObject *self, PyObject *args) {
             "OO|zzOzfpzL(ff):render",
             &string,
             &fill,
-            &mode,
+            &mode_name,
             &dir,
             &features,
             &lang,
@@ -873,8 +882,9 @@ font_render(FontObject *self, PyObject *args) {
         return NULL;
     }
 
-    mask = mode && strcmp(mode, "1") == 0;
-    color = mode && strcmp(mode, "RGBA") == 0;
+    const ModeID mode = findModeID(mode_name);
+    mask = mode == IMAGING_MODE_1;
+    color = mode == IMAGING_MODE_RGBA;
 
     foreground_ink = foreground_ink_long;
 

From f8bfa2fe4e78fc5ea32844a0bd2ded59d2ef398d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Tue, 23 Apr 2024 13:19:49 -0500
Subject: [PATCH 1942/2374] use more mode enums in decode.c

---
 src/decode.c | 30 +++++++++++++++++-------------
 1 file changed, 17 insertions(+), 13 deletions(-)

diff --git a/src/decode.c b/src/decode.c
index 41b2f6f3167..f95637fa619 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -291,17 +291,18 @@ PyObject *
 PyImaging_BitDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
+    const char *mode_name;
     int bits = 8;
     int pad = 8;
     int fill = 0;
     int sign = 0;
     int ystep = 1;
-    if (!PyArg_ParseTuple(args, "s|iiiii", &mode, &bits, &pad, &fill, &sign, &ystep)) {
+    if (!PyArg_ParseTuple(args, "s|iiiii", &mode_name, &bits, &pad, &fill, &sign, &ystep)) {
         return NULL;
     }
 
-    if (strcmp(mode, "F") != 0) {
+    const ModeID mode = findModeID(mode_name);
+    if (mode != IMAGING_MODE_F) {
         PyErr_SetString(PyExc_ValueError, "bad image mode");
         return NULL;
     }
@@ -331,34 +332,36 @@ PyObject *
 PyImaging_BcnDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
-    char *actual;
+    char *mode_name;
     int n = 0;
     char *pixel_format = "";
-    if (!PyArg_ParseTuple(args, "si|s", &mode, &n, &pixel_format)) {
+    if (!PyArg_ParseTuple(args, "si|s", &mode_name, &n, &pixel_format)) {
         return NULL;
     }
 
+    const ModeID mode = findModeID(mode_name);
+    ModeID actual;
+
     switch (n) {
         case 1: /* BC1: 565 color, 1-bit alpha */
         case 2: /* BC2: 565 color, 4-bit alpha */
         case 3: /* BC3: 565 color, 2-endpoint 8-bit interpolated alpha */
         case 7: /* BC7: 4-channel 8-bit via everything */
-            actual = "RGBA";
+            actual = IMAGING_MODE_RGBA;
             break;
         case 4: /* BC4: 1-channel 8-bit via 1 BC3 alpha block */
-            actual = "L";
+            actual = IMAGING_MODE_L;
             break;
         case 5: /* BC5: 2-channel 8-bit via 2 BC3 alpha blocks */
         case 6: /* BC6: 3-channel 16-bit float */
-            actual = "RGB";
+            actual = IMAGING_MODE_RGB;
             break;
         default:
             PyErr_SetString(PyExc_ValueError, "block compression type unknown");
             return NULL;
     }
 
-    if (strcmp(mode, actual) != 0) {
+    if (mode != actual) {
         PyErr_SetString(PyExc_ValueError, "bad image mode");
         return NULL;
     }
@@ -401,15 +404,16 @@ PyObject *
 PyImaging_GifDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
-    char *mode;
+    const char *mode_name;
     int bits = 8;
     int interlace = 0;
     int transparency = -1;
-    if (!PyArg_ParseTuple(args, "s|iii", &mode, &bits, &interlace, &transparency)) {
+    if (!PyArg_ParseTuple(args, "s|iii", &mode_name, &bits, &interlace, &transparency)) {
         return NULL;
     }
 
-    if (strcmp(mode, "L") != 0 && strcmp(mode, "P") != 0) {
+    const ModeID mode = findModeID(mode_name);
+    if (mode != IMAGING_MODE_L && mode != IMAGING_MODE_P) {
         PyErr_SetString(PyExc_ValueError, "bad image mode");
         return NULL;
     }

From 47503477d49922c085d6062035f2a7da68b3fd2d Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 17:00:35 +0200
Subject: [PATCH 1943/2374] add Mode.c as a dependency for _imagingft.c and
 _webp.c

---
 setup.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/setup.py b/setup.py
index 93b5bcc7812..b5769b19157 100644
--- a/setup.py
+++ b/setup.py
@@ -1080,9 +1080,9 @@ def debug_build() -> bool:
     files.append(os.path.join("src/libImaging", src_file + ".c"))
 ext_modules = [
     Extension("PIL._imaging", files),
-    Extension("PIL._imagingft", ["src/_imagingft.c"]),
+    Extension("PIL._imagingft", ["src/_imagingft.c", "src/libImaging/Mode.c"]),
     Extension("PIL._imagingcms", ["src/_imagingcms.c"]),
-    Extension("PIL._webp", ["src/_webp.c"]),
+    Extension("PIL._webp", ["src/_webp.c", "src/libImaging/Mode.c"]),
     Extension("PIL._avif", ["src/_avif.c"]),
     Extension("PIL._imagingtk", ["src/_imagingtk.c", "src/Tk/tkImaging.c"]),
     Extension("PIL._imagingmath", ["src/_imagingmath.c"]),

From e483a976d218ceb1120f00b624a4d0f30c0cd71e Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Wed, 24 Apr 2024 17:33:09 -0500
Subject: [PATCH 1944/2374] use a different temp build dir for each module

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

diff --git a/setup.py b/setup.py
index b5769b19157..2dca5e3805b 100644
--- a/setup.py
+++ b/setup.py
@@ -1008,6 +1008,17 @@ def build_extensions(self) -> None:
 
         self.summary_report(feature)
 
+    def build_extension(self, ext):
+        # Append the extension name (not including "PIL.") to the temp build directory
+        # so that each module builds to its own directory. We need to make a (shallow)
+        # copy of 'self' here so that we don't overwrite this value when running in
+        # parallel.
+        import copy
+
+        self_copy = copy.copy(self)
+        self_copy.build_temp = os.path.join(self.build_temp, ext.name[4:])
+        build_ext.build_extension(self_copy, ext)
+
     def summary_report(self, feature: ext_feature) -> None:
         print("-" * 68)
         print("PIL SETUP SUMMARY")

From 28adda9299daac9cd4ee349474d7618c16152d2d Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 17:02:00 +0200
Subject: [PATCH 1945/2374] build Mode.c as a common library

---
 setup.py | 23 ++++++++---------------
 1 file changed, 8 insertions(+), 15 deletions(-)

diff --git a/setup.py b/setup.py
index 2dca5e3805b..3098a9ec61d 100644
--- a/setup.py
+++ b/setup.py
@@ -103,7 +103,6 @@ def get_version() -> str:
     "JpegDecode",
     "JpegEncode",
     "Matrix",
-    "Mode",
     "ModeFilter",
     "Negative",
     "Offset",
@@ -1008,17 +1007,6 @@ def build_extensions(self) -> None:
 
         self.summary_report(feature)
 
-    def build_extension(self, ext):
-        # Append the extension name (not including "PIL.") to the temp build directory
-        # so that each module builds to its own directory. We need to make a (shallow)
-        # copy of 'self' here so that we don't overwrite this value when running in
-        # parallel.
-        import copy
-
-        self_copy = copy.copy(self)
-        self_copy.build_temp = os.path.join(self.build_temp, ext.name[4:])
-        build_ext.build_extension(self_copy, ext)
-
     def summary_report(self, feature: ext_feature) -> None:
         print("-" * 68)
         print("PIL SETUP SUMMARY")
@@ -1084,16 +1072,20 @@ def debug_build() -> bool:
     return hasattr(sys, "gettotalrefcount") or FUZZING_BUILD
 
 
+libraries = [
+    ("pil_imaging_mode", {"sources": ["src/libImaging/Mode.c"]}),
+]
+
 files: list[str | os.PathLike[str]] = ["src/_imaging.c"]
 for src_file in _IMAGING:
     files.append("src/" + src_file + ".c")
 for src_file in _LIB_IMAGING:
     files.append(os.path.join("src/libImaging", src_file + ".c"))
 ext_modules = [
-    Extension("PIL._imaging", files),
-    Extension("PIL._imagingft", ["src/_imagingft.c", "src/libImaging/Mode.c"]),
+    Extension("PIL._imaging", files, libraries=["pil_imaging_mode"]),
+    Extension("PIL._imagingft", ["src/_imagingft.c"], libraries=["pil_imaging_mode"]),
     Extension("PIL._imagingcms", ["src/_imagingcms.c"]),
-    Extension("PIL._webp", ["src/_webp.c", "src/libImaging/Mode.c"]),
+    Extension("PIL._webp", ["src/_webp.c"], libraries=["pil_imaging_mode"]),
     Extension("PIL._avif", ["src/_avif.c"]),
     Extension("PIL._imagingtk", ["src/_imagingtk.c", "src/Tk/tkImaging.c"]),
     Extension("PIL._imagingmath", ["src/_imagingmath.c"]),
@@ -1105,6 +1097,7 @@ def debug_build() -> bool:
     setup(
         cmdclass={"build_ext": pil_build_ext},
         ext_modules=ext_modules,
+        libraries=libraries,
         zip_safe=not (debug_build() or PLATFORM_MINGW),
     )
 except RequiredDependencyException as err:

From 0567f064e4616a7e816a2fda493fc00c4a6ae23d Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Thu, 25 Apr 2024 19:29:02 -0500
Subject: [PATCH 1946/2374] add debug check that all modes and rawmodes are
 defined

---
 src/libImaging/Mode.c | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 659e7aada49..1ec24aae839 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -1,6 +1,10 @@
 #include "Mode.h"
 #include <string.h>
 
+#ifdef NDEBUG
+#include <stdio.h>
+#include <stdlib.h>
+#endif
 
 const ModeData MODES[] = {
     [IMAGING_MODE_UNKNOWN] = {""},
@@ -39,6 +43,11 @@ const ModeID findModeID(const char * const name) {
         return IMAGING_MODE_UNKNOWN;
     }
     for (size_t i = 0; i < sizeof(MODES) / sizeof(*MODES); i++) {
+#ifdef NDEBUG
+        if (MODES[i].name == NULL) {
+            fprintf(stderr, "Mode ID %zu is not defined.\n", (size_t)i);
+        } else
+#endif
         if (strcmp(MODES[i].name, name) == 0) {
             return (ModeID)i;
         }
@@ -238,6 +247,11 @@ const RawModeID findRawModeID(const char * const name) {
         return IMAGING_RAWMODE_UNKNOWN;
     }
     for (size_t i = 0; i < sizeof(RAWMODES) / sizeof(*RAWMODES); i++) {
+#ifdef NDEBUG
+        if (RAWMODES[i].name == NULL) {
+            fprintf(stderr, "Rawmode ID %zu is not defined.\n", (size_t)i);
+        } else
+#endif
         if (strcmp(RAWMODES[i].name, name) == 0) {
             return (RawModeID)i;
         }

From 2f169fa121dcb9e1319c8741075396e55aea378c Mon Sep 17 00:00:00 2001
From: Yay295 <Yay295@gmail.com>
Date: Thu, 25 Apr 2024 19:54:47 -0500
Subject: [PATCH 1947/2374] use mode enums in _imagingcms.c

---
 setup.py          |  2 +-
 src/_imagingcms.c | 46 +++++++++++++++++++++++++++++-----------------
 2 files changed, 30 insertions(+), 18 deletions(-)

diff --git a/setup.py b/setup.py
index 3098a9ec61d..82986f14044 100644
--- a/setup.py
+++ b/setup.py
@@ -1084,7 +1084,7 @@ def debug_build() -> bool:
 ext_modules = [
     Extension("PIL._imaging", files, libraries=["pil_imaging_mode"]),
     Extension("PIL._imagingft", ["src/_imagingft.c"], libraries=["pil_imaging_mode"]),
-    Extension("PIL._imagingcms", ["src/_imagingcms.c"]),
+    Extension("PIL._imagingcms", ["src/_imagingcms.c"], libraries=["pil_imaging_mode"]),
     Extension("PIL._webp", ["src/_webp.c"], libraries=["pil_imaging_mode"]),
     Extension("PIL._avif", ["src/_avif.c"]),
     Extension("PIL._imagingtk", ["src/_imagingtk.c", "src/Tk/tkImaging.c"]),
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index e2f29d1b708..ad3b27896fb 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -212,32 +212,44 @@ cms_transform_dealloc(CmsTransformObject *self) {
 /* internal functions */
 
 static cmsUInt32Number
-findLCMStype(char *PILmode) {
-    if (strcmp(PILmode, "RGB") == 0 || strcmp(PILmode, "RGBA") == 0 ||
-        strcmp(PILmode, "RGBX") == 0) {
-        return TYPE_RGBA_8;
+findLCMStype(const char *const mode_name) {
+    const ModeID mode = findModeID(mode_name);
+    switch (mode) {
+        case IMAGING_MODE_RGB:
+        case IMAGING_MODE_RGBA:
+        case IMAGING_MODE_RGBX:
+            return TYPE_RGBA_8;
+        case IMAGING_MODE_CMYK:
+            return TYPE_CMYK_8;
+        case IMAGING_MODE_I_16:
+        case IMAGING_MODE_I_16L:
+            return TYPE_GRAY_16;
+        case IMAGING_MODE_I_16B:
+            return TYPE_GRAY_16_SE;
+        case IMAGING_MODE_YCbCr:
+            return TYPE_YCbCr_8;
+        case IMAGING_MODE_LAB:
+            // 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)
+            );
+        default:
+            // This function only accepts a subset of the imaging modes Pillow has.
+            break;
     }
-    if (strcmp(PILmode, "RGBA;16B") == 0) {
+    // The following modes are not valid PIL Image modes.
+    if (strcmp(mode_name, "RGBA;16B") == 0) {
         return TYPE_RGBA_16;
     }
-    if (strcmp(PILmode, "CMYK") == 0) {
-        return TYPE_CMYK_8;
-    }
-    if (strcmp(PILmode, "I;16") == 0 || strcmp(PILmode, "I;16L") == 0 ||
-        strcmp(PILmode, "L;16") == 0) {
+    if (strcmp(mode_name, "L;16") == 0) {
         return TYPE_GRAY_16;
     }
-    if (strcmp(PILmode, "I;16B") == 0 || strcmp(PILmode, "L;16B") == 0) {
+    if (strcmp(mode_name, "L;16B") == 0) {
         return TYPE_GRAY_16_SE;
     }
-    if (strcmp(PILmode, "YCbCr") == 0 || strcmp(PILmode, "YCCA") == 0 ||
-        strcmp(PILmode, "YCC") == 0) {
+    if (strcmp(mode_name, "YCCA") == 0 || strcmp(mode_name, "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 "1" or "L" by default */
     return TYPE_GRAY_8;
 }

From d82576ff3801b6e9bd87ebaf93b357768dfc08b6 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 17:03:31 +0200
Subject: [PATCH 1948/2374] require types-setuptools>=75.2.0 this is necessary
 to have https://github.com/python/typeshed/pull/12791

---
 .ci/requirements-mypy.txt | 2 +-
 setup.py                  | 6 +++++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 99eac602796..3519707f14c 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -11,4 +11,4 @@ sphinx
 types-atheris
 types-defusedxml
 types-olefile
-types-setuptools
+types-setuptools>=75.2.0
diff --git a/setup.py b/setup.py
index 82986f14044..dcc07eaf691 100644
--- a/setup.py
+++ b/setup.py
@@ -16,11 +16,15 @@
 import sys
 import warnings
 from collections.abc import Iterator
+from typing import TYPE_CHECKING, Any
 
 from pybind11.setup_helpers import ParallelCompile
 from setuptools import Extension, setup
 from setuptools.command.build_ext import build_ext
 
+if TYPE_CHECKING:
+    from setuptools import _BuildInfo
+
 configuration: dict[str, list[str]] = {}
 
 # parse configuration from _custom_build/backend.py
@@ -1072,7 +1076,7 @@ def debug_build() -> bool:
     return hasattr(sys, "gettotalrefcount") or FUZZING_BUILD
 
 
-libraries = [
+libraries: list[tuple[str, _BuildInfo]] = [
     ("pil_imaging_mode", {"sources": ["src/libImaging/Mode.c"]}),
 ]
 

From 84aa4372fd38069edbc792c235169422c0a799d6 Mon Sep 17 00:00:00 2001
From: eyedav <88885346+eyedav@users.noreply.github.com>
Date: Sat, 19 Jul 2025 17:06:44 +0200
Subject: [PATCH 1949/2374] linter changes

---
 src/Tk/tkImaging.c          |  6 ++--
 src/_imaging.c              |  7 +++--
 src/decode.c                | 22 +++++++++----
 src/encode.c                |  4 ++-
 src/libImaging/Convert.c    | 17 +++++-----
 src/libImaging/Fill.c       | 12 +++----
 src/libImaging/GetBBox.c    |  9 +++---
 src/libImaging/Matrix.c     |  7 ++---
 src/libImaging/Mode.c       | 63 +++++++++++++++----------------------
 src/libImaging/Mode.h       | 24 +++++++-------
 src/libImaging/Pack.c       |  3 +-
 src/libImaging/Paste.c      |  9 +++---
 src/libImaging/Point.c      |  4 +--
 src/libImaging/TiffDecode.c | 28 ++++++++++++++---
 14 files changed, 113 insertions(+), 102 deletions(-)

diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index 3e35f885f61..834634bd7fa 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -124,10 +124,8 @@ PyImagingPhotoPut(
     if (im->mode == IMAGING_MODE_1 || im->mode == IMAGING_MODE_L) {
         block.pixelSize = 1;
         block.offset[0] = block.offset[1] = block.offset[2] = block.offset[3] = 0;
-    } else if (
-        im->mode == IMAGING_MODE_RGB || im->mode == IMAGING_MODE_RGBA ||
-        im->mode == IMAGING_MODE_RGBX || im->mode == IMAGING_MODE_RGBa
-    ) {
+    } else if (im->mode == IMAGING_MODE_RGB || im->mode == IMAGING_MODE_RGBA ||
+               im->mode == IMAGING_MODE_RGBX || im->mode == IMAGING_MODE_RGBa) {
         block.pixelSize = 4;
         block.offset[0] = 0;
         block.offset[1] = 1;
diff --git a/src/_imaging.c b/src/_imaging.c
index a940bb97448..4264cdb8748 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1773,7 +1773,9 @@ _quantize(ImagingObject *self, PyObject *args) {
 
     if (!self->image->xsize || !self->image->ysize) {
         /* no content; return an empty image */
-        return PyImagingNew(ImagingNew(IMAGING_MODE_P, self->image->xsize, self->image->ysize));
+        return PyImagingNew(
+            ImagingNew(IMAGING_MODE_P, self->image->xsize, self->image->ysize)
+        );
     }
 
     return PyImagingNew(ImagingQuantize(self->image, colours, method, kmeans));
@@ -2053,7 +2055,8 @@ _reduce(ImagingObject *self, PyObject *args) {
 
 static int
 isRGB(const ModeID mode) {
-    return mode == IMAGING_MODE_RGB || mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_RGBX;
+    return mode == IMAGING_MODE_RGB || mode == IMAGING_MODE_RGBA ||
+           mode == IMAGING_MODE_RGBX;
 }
 
 static PyObject *
diff --git a/src/decode.c b/src/decode.c
index f95637fa619..b7deee22854 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -266,7 +266,9 @@ static PyTypeObject ImagingDecoderType = {
 /* -------------------------------------------------------------------- */
 
 int
-get_unpacker(ImagingDecoderObject *decoder, const ModeID mode, const RawModeID rawmode) {
+get_unpacker(
+    ImagingDecoderObject *decoder, const ModeID mode, const RawModeID rawmode
+) {
     int bits;
     ImagingShuffler unpack;
 
@@ -297,7 +299,9 @@ PyImaging_BitDecoderNew(PyObject *self, PyObject *args) {
     int fill = 0;
     int sign = 0;
     int ystep = 1;
-    if (!PyArg_ParseTuple(args, "s|iiiii", &mode_name, &bits, &pad, &fill, &sign, &ystep)) {
+    if (!PyArg_ParseTuple(
+            args, "s|iiiii", &mode_name, &bits, &pad, &fill, &sign, &ystep
+        )) {
         return NULL;
     }
 
@@ -408,7 +412,9 @@ PyImaging_GifDecoderNew(PyObject *self, PyObject *args) {
     int bits = 8;
     int interlace = 0;
     int transparency = -1;
-    if (!PyArg_ParseTuple(args, "s|iii", &mode_name, &bits, &interlace, &transparency)) {
+    if (!PyArg_ParseTuple(
+            args, "s|iii", &mode_name, &bits, &interlace, &transparency
+        )) {
         return NULL;
     }
 
@@ -481,7 +487,9 @@ PyImaging_LibTiffDecoderNew(PyObject *self, PyObject *args) {
     int fp;
     uint32_t ifdoffset;
 
-    if (!PyArg_ParseTuple(args, "sssiI", &mode_name, &rawmode_name, &compname, &fp, &ifdoffset)) {
+    if (!PyArg_ParseTuple(
+            args, "sssiI", &mode_name, &rawmode_name, &compname, &fp, &ifdoffset
+        )) {
         return NULL;
     }
 
@@ -823,12 +831,14 @@ PyImaging_JpegDecoderNew(PyObject *self, PyObject *args) {
     ImagingDecoderObject *decoder;
 
     char *mode_name;
-    char *rawmode_name; /* what we want from the decoder */
+    char *rawmode_name;  /* what we want from the decoder */
     char *jpegmode_name; /* what's in the file */
     int scale = 1;
     int draft = 0;
 
-    if (!PyArg_ParseTuple(args, "ssz|ii", &mode_name, &rawmode_name, &jpegmode_name, &scale, &draft)) {
+    if (!PyArg_ParseTuple(
+            args, "ssz|ii", &mode_name, &rawmode_name, &jpegmode_name, &scale, &draft
+        )) {
         return NULL;
     }
 
diff --git a/src/encode.c b/src/encode.c
index 3a6b6d6d0a2..6a75a2fcc7e 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -411,7 +411,9 @@ PyImaging_GifEncoderNew(PyObject *self, PyObject *args) {
     char *rawmode_name;
     Py_ssize_t bits = 8;
     Py_ssize_t interlace = 0;
-    if (!PyArg_ParseTuple(args, "ss|nn", &mode_name, &rawmode_name, &bits, &interlace)) {
+    if (!PyArg_ParseTuple(
+            args, "ss|nn", &mode_name, &rawmode_name, &bits, &interlace
+        )) {
         return NULL;
     }
 
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 862f228e5a5..0c36b84494c 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -1692,25 +1692,22 @@ ImagingConvertTransparent(Imaging imIn, const ModeID mode, int r, int g, int b)
         return (Imaging)ImagingError_ModeError();
     }
 
-    if (imIn->mode == IMAGING_MODE_RGB && (mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_RGBa)) {
+    if (imIn->mode == IMAGING_MODE_RGB &&
+        (mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_RGBa)) {
         convert = rgb2rgba;
         if (mode == IMAGING_MODE_RGBa) {
             premultiplied = 1;
         }
-    } else if (imIn->mode == IMAGING_MODE_RGB && (mode == IMAGING_MODE_LA || mode == IMAGING_MODE_La)) {
+    } else if (imIn->mode == IMAGING_MODE_RGB &&
+               (mode == IMAGING_MODE_LA || mode == IMAGING_MODE_La)) {
         convert = rgb2la;
         source_transparency = 1;
         if (mode == IMAGING_MODE_La) {
             premultiplied = 1;
         }
-    } else if ((imIn->mode == IMAGING_MODE_1 ||
-                imIn->mode == IMAGING_MODE_I ||
-                imIn->mode == IMAGING_MODE_I_16 ||
-                imIn->mode == IMAGING_MODE_L
-               ) && (
-                mode == IMAGING_MODE_RGBA ||
-                mode == IMAGING_MODE_LA
-               )) {
+    } else if ((imIn->mode == IMAGING_MODE_1 || imIn->mode == IMAGING_MODE_I ||
+                imIn->mode == IMAGING_MODE_I_16 || imIn->mode == IMAGING_MODE_L) &&
+               (mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_LA)) {
         if (imIn->mode == IMAGING_MODE_1) {
             convert = bit2rgb;
         } else if (imIn->mode == IMAGING_MODE_I) {
diff --git a/src/libImaging/Fill.c b/src/libImaging/Fill.c
index 0224d1ba95e..cbd303204d5 100644
--- a/src/libImaging/Fill.c
+++ b/src/libImaging/Fill.c
@@ -72,10 +72,8 @@ ImagingFillLinearGradient(const ModeID mode) {
     Imaging im;
     int y;
 
-    if (mode != IMAGING_MODE_1 && mode != IMAGING_MODE_F &&
-        mode != IMAGING_MODE_I && mode != IMAGING_MODE_L &&
-        mode != IMAGING_MODE_P
-    ) {
+    if (mode != IMAGING_MODE_1 && mode != IMAGING_MODE_F && mode != IMAGING_MODE_I &&
+        mode != IMAGING_MODE_L && mode != IMAGING_MODE_P) {
         return (Imaging)ImagingError_ModeError();
     }
 
@@ -110,10 +108,8 @@ ImagingFillRadialGradient(const ModeID mode) {
     int x, y;
     int d;
 
-    if (mode != IMAGING_MODE_1 && mode != IMAGING_MODE_F &&
-        mode != IMAGING_MODE_I && mode != IMAGING_MODE_L &&
-        mode != IMAGING_MODE_P
-    ) {
+    if (mode != IMAGING_MODE_1 && mode != IMAGING_MODE_F && mode != IMAGING_MODE_I &&
+        mode != IMAGING_MODE_L && mode != IMAGING_MODE_P) {
         return (Imaging)ImagingError_ModeError();
     }
 
diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index 3719a9f1576..f94cf2a0e5f 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -89,11 +89,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 && (
-            im->mode == IMAGING_MODE_RGBa || im->mode == IMAGING_MODE_RGBA ||
-            im->mode == IMAGING_MODE_La || im->mode == IMAGING_MODE_LA ||
-            im->mode == IMAGING_MODE_PA
-        )) {
+        } else if (alpha_only &&
+                   (im->mode == IMAGING_MODE_RGBa || im->mode == IMAGING_MODE_RGBA ||
+                    im->mode == IMAGING_MODE_La || im->mode == IMAGING_MODE_LA ||
+                    im->mode == IMAGING_MODE_PA)) {
 #ifdef WORDS_BIGENDIAN
             mask = 0x000000ff;
 #else
diff --git a/src/libImaging/Matrix.c b/src/libImaging/Matrix.c
index 6bc9fbc1de2..d28e04edfaa 100644
--- a/src/libImaging/Matrix.c
+++ b/src/libImaging/Matrix.c
@@ -46,11 +46,8 @@ ImagingConvertMatrix(Imaging im, const ModeID mode, float m[]) {
             }
         }
         ImagingSectionLeave(&cookie);
-    } else if (
-        mode == IMAGING_MODE_HSV ||
-        mode == IMAGING_MODE_LAB ||
-        mode == IMAGING_MODE_RGB
-    ) {
+    } else if (mode == IMAGING_MODE_HSV || mode == IMAGING_MODE_LAB ||
+               mode == IMAGING_MODE_RGB) {
         imOut = ImagingNewDirty(mode, im->xsize, im->ysize);
         if (!imOut) {
             return NULL;
diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 1ec24aae839..8222c585b68 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -9,36 +9,25 @@
 const ModeData MODES[] = {
     [IMAGING_MODE_UNKNOWN] = {""},
 
-    [IMAGING_MODE_1] = {"1"},
-    [IMAGING_MODE_CMYK] = {"CMYK"},
-    [IMAGING_MODE_F] = {"F"},
-    [IMAGING_MODE_HSV] = {"HSV"},
-    [IMAGING_MODE_I] = {"I"},
-    [IMAGING_MODE_L] = {"L"},
-    [IMAGING_MODE_LA] = {"LA"},
-    [IMAGING_MODE_LAB] = {"LAB"},
-    [IMAGING_MODE_La] = {"La"},
-    [IMAGING_MODE_P] = {"P"},
-    [IMAGING_MODE_PA] = {"PA"},
-    [IMAGING_MODE_RGB] = {"RGB"},
-    [IMAGING_MODE_RGBA] = {"RGBA"},
-    [IMAGING_MODE_RGBX] = {"RGBX"},
-    [IMAGING_MODE_RGBa] = {"RGBa"},
-    [IMAGING_MODE_YCbCr] = {"YCbCr"},
+    [IMAGING_MODE_1] = {"1"},           [IMAGING_MODE_CMYK] = {"CMYK"},
+    [IMAGING_MODE_F] = {"F"},           [IMAGING_MODE_HSV] = {"HSV"},
+    [IMAGING_MODE_I] = {"I"},           [IMAGING_MODE_L] = {"L"},
+    [IMAGING_MODE_LA] = {"LA"},         [IMAGING_MODE_LAB] = {"LAB"},
+    [IMAGING_MODE_La] = {"La"},         [IMAGING_MODE_P] = {"P"},
+    [IMAGING_MODE_PA] = {"PA"},         [IMAGING_MODE_RGB] = {"RGB"},
+    [IMAGING_MODE_RGBA] = {"RGBA"},     [IMAGING_MODE_RGBX] = {"RGBX"},
+    [IMAGING_MODE_RGBa] = {"RGBa"},     [IMAGING_MODE_YCbCr] = {"YCbCr"},
 
-    [IMAGING_MODE_BGR_15] = {"BGR;15"},
-    [IMAGING_MODE_BGR_16] = {"BGR;16"},
+    [IMAGING_MODE_BGR_15] = {"BGR;15"}, [IMAGING_MODE_BGR_16] = {"BGR;16"},
     [IMAGING_MODE_BGR_24] = {"BGR;24"},
 
-    [IMAGING_MODE_I_16] = {"I;16"},
-    [IMAGING_MODE_I_16L] = {"I;16L"},
-    [IMAGING_MODE_I_16B] = {"I;16B"},
-    [IMAGING_MODE_I_16N] = {"I;16N"},
-    [IMAGING_MODE_I_32L] = {"I;32L"},
-    [IMAGING_MODE_I_32B] = {"I;32B"},
+    [IMAGING_MODE_I_16] = {"I;16"},     [IMAGING_MODE_I_16L] = {"I;16L"},
+    [IMAGING_MODE_I_16B] = {"I;16B"},   [IMAGING_MODE_I_16N] = {"I;16N"},
+    [IMAGING_MODE_I_32L] = {"I;32L"},   [IMAGING_MODE_I_32B] = {"I;32B"},
 };
 
-const ModeID findModeID(const char * const name) {
+const ModeID
+findModeID(const char *const name) {
     if (name == NULL) {
         return IMAGING_MODE_UNKNOWN;
     }
@@ -48,21 +37,21 @@ const ModeID findModeID(const char * const name) {
             fprintf(stderr, "Mode ID %zu is not defined.\n", (size_t)i);
         } else
 #endif
-        if (strcmp(MODES[i].name, name) == 0) {
+            if (strcmp(MODES[i].name, name) == 0) {
             return (ModeID)i;
         }
     }
     return IMAGING_MODE_UNKNOWN;
 }
 
-const ModeData * const getModeData(const ModeID id) {
+const ModeData *const
+getModeData(const ModeID id) {
     if (id < 0 || id > sizeof(MODES) / sizeof(*MODES)) {
         return &MODES[IMAGING_MODE_UNKNOWN];
     }
     return &MODES[id];
 }
 
-
 const RawModeData RAWMODES[] = {
     [IMAGING_RAWMODE_UNKNOWN] = {""},
 
@@ -242,7 +231,8 @@ const RawModeData RAWMODES[] = {
     [IMAGING_RAWMODE_aRGB] = {"aRGB"},
 };
 
-const RawModeID findRawModeID(const char * const name) {
+const RawModeID
+findRawModeID(const char *const name) {
     if (name == NULL) {
         return IMAGING_RAWMODE_UNKNOWN;
     }
@@ -252,24 +242,23 @@ const RawModeID findRawModeID(const char * const name) {
             fprintf(stderr, "Rawmode ID %zu is not defined.\n", (size_t)i);
         } else
 #endif
-        if (strcmp(RAWMODES[i].name, name) == 0) {
+            if (strcmp(RAWMODES[i].name, name) == 0) {
             return (RawModeID)i;
         }
     }
     return IMAGING_RAWMODE_UNKNOWN;
 }
 
-const RawModeData * const getRawModeData(const RawModeID id) {
+const RawModeData *const
+getRawModeData(const RawModeID id) {
     if (id < 0 || id > sizeof(RAWMODES) / sizeof(*RAWMODES)) {
         return &RAWMODES[IMAGING_RAWMODE_UNKNOWN];
     }
     return &RAWMODES[id];
 }
 
-
-int isModeI16(const ModeID mode) {
-    return mode == IMAGING_MODE_I_16
-    || mode == IMAGING_MODE_I_16L
-    || mode == IMAGING_MODE_I_16B
-    || mode == IMAGING_MODE_I_16N;
+int
+isModeI16(const ModeID mode) {
+    return mode == IMAGING_MODE_I_16 || mode == IMAGING_MODE_I_16L ||
+           mode == IMAGING_MODE_I_16B || mode == IMAGING_MODE_I_16N;
 }
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index e21ad941a26..a20ad0cb68d 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -1,7 +1,6 @@
 #ifndef __MODE_H__
 #define __MODE_H__
 
-
 typedef enum {
     IMAGING_MODE_UNKNOWN,
 
@@ -35,12 +34,13 @@ typedef enum {
 } ModeID;
 
 typedef struct {
-    const char * const name;
+    const char *const name;
 } ModeData;
 
-const ModeID findModeID(const char * const name);
-const ModeData * const getModeData(const ModeID id);
-
+const ModeID
+findModeID(const char *const name);
+const ModeData *const
+getModeData(const ModeID id);
 
 typedef enum {
     IMAGING_RAWMODE_UNKNOWN,
@@ -226,13 +226,15 @@ typedef enum {
 } RawModeID;
 
 typedef struct {
-    const char * const name;
+    const char *const name;
 } RawModeData;
 
-const RawModeID findRawModeID(const char * const name);
-const RawModeData * const getRawModeData(const RawModeID id);
-
+const RawModeID
+findRawModeID(const char *const name);
+const RawModeData *const
+getRawModeData(const RawModeID id);
 
-int isModeI16(const ModeID mode);
+int
+isModeI16(const ModeID mode);
 
-#endif // __MODE_H__
+#endif  // __MODE_H__
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index 63bbc8acb35..a0652e0cafc 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -648,7 +648,8 @@ static struct {
     {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
     {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
     {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
-    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16}, // LibTiff native->image endian.
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16
+    },  // LibTiff native->image endian.
     {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
     {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B},
 
diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index 54dd270e6f0..d4b973abc4d 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -450,11 +450,10 @@ fill_mask_L(
         }
 
     } else {
-        int alpha_channel = imOut->mode == IMAGING_MODE_RGBa ||
-                            imOut->mode == IMAGING_MODE_RGBA ||
-                            imOut->mode == IMAGING_MODE_La ||
-                            imOut->mode == IMAGING_MODE_LA ||
-                            imOut->mode == IMAGING_MODE_PA;
+        int alpha_channel =
+            imOut->mode == IMAGING_MODE_RGBa || imOut->mode == IMAGING_MODE_RGBA ||
+            imOut->mode == IMAGING_MODE_La || imOut->mode == IMAGING_MODE_LA ||
+            imOut->mode == IMAGING_MODE_PA;
         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 fa0b1027cd0..8f6d47c770f 100644
--- a/src/libImaging/Point.c
+++ b/src/libImaging/Point.c
@@ -210,8 +210,8 @@ ImagingPointTransform(Imaging imIn, double scale, double offset) {
     Imaging imOut;
     int x, y;
 
-    if (!imIn || (imIn->mode != IMAGING_MODE_I &&
-        imIn->mode != IMAGING_MODE_I_16 && imIn->mode != IMAGING_MODE_F)) {
+    if (!imIn || (imIn->mode != IMAGING_MODE_I && imIn->mode != IMAGING_MODE_I_16 &&
+                  imIn->mode != IMAGING_MODE_F)) {
         return (Imaging)ImagingError_ModeError();
     }
 
diff --git a/src/libImaging/TiffDecode.c b/src/libImaging/TiffDecode.c
index f987c608f8a..72e0d7b309a 100644
--- a/src/libImaging/TiffDecode.c
+++ b/src/libImaging/TiffDecode.c
@@ -246,10 +246,26 @@ _pickUnpackers(
         // 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(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_R_16N : IMAGING_RAWMODE_R, NULL);
-        unpackers[1] = ImagingFindUnpacker(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_G_16N : IMAGING_RAWMODE_G, NULL);
-        unpackers[2] = ImagingFindUnpacker(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_B_16N : IMAGING_RAWMODE_B, NULL);
-        unpackers[3] = ImagingFindUnpacker(IMAGING_MODE_RGBA, bits_per_sample == 16 ? IMAGING_RAWMODE_A_16N : IMAGING_RAWMODE_A, NULL);
+        unpackers[0] = ImagingFindUnpacker(
+            IMAGING_MODE_RGBA,
+            bits_per_sample == 16 ? IMAGING_RAWMODE_R_16N : IMAGING_RAWMODE_R,
+            NULL
+        );
+        unpackers[1] = ImagingFindUnpacker(
+            IMAGING_MODE_RGBA,
+            bits_per_sample == 16 ? IMAGING_RAWMODE_G_16N : IMAGING_RAWMODE_G,
+            NULL
+        );
+        unpackers[2] = ImagingFindUnpacker(
+            IMAGING_MODE_RGBA,
+            bits_per_sample == 16 ? IMAGING_RAWMODE_B_16N : IMAGING_RAWMODE_B,
+            NULL
+        );
+        unpackers[3] = ImagingFindUnpacker(
+            IMAGING_MODE_RGBA,
+            bits_per_sample == 16 ? IMAGING_RAWMODE_A_16N : IMAGING_RAWMODE_A,
+            NULL
+        );
 
         return im->bands;
     } else {
@@ -763,7 +779,9 @@ ImagingLibTiffDecode(
 
                 if (extrasamples >= 1 && (sampleinfo[0] == EXTRASAMPLE_UNSPECIFIED ||
                                           sampleinfo[0] == EXTRASAMPLE_ASSOCALPHA)) {
-                    shuffle = ImagingFindUnpacker(IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa, NULL);
+                    shuffle = ImagingFindUnpacker(
+                        IMAGING_MODE_RGBA, IMAGING_RAWMODE_RGBa, NULL
+                    );
 
                     for (y = state->yoff; y < state->ysize; y++) {
                         UINT8 *ptr = (UINT8 *)im->image[y + state->yoff] +

From 64556405e29d076d95d284d3d146cecff7476b7d Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Sat, 19 Jul 2025 17:34:39 +0200
Subject: [PATCH 1950/2374] WIP - Not working in pyarrow

---
 src/libImaging/Arrow.c | 39 ++++++++++++++++++++++++++++++++++++++-
 1 file changed, 38 insertions(+), 1 deletion(-)

diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index 2ecec9b29bb..ff98dfb5134 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -84,6 +84,33 @@ image_band_json(Imaging im) {
     return json;
 }
 
+char *
+single_band_json(Imaging im) {
+    char *format = "{\"bands\": [\"%s\"]}";
+    char *json;
+    // Bands can be 1 band * (maybe but probably not) 2 characters each
+    int len = strlen(format) + 2 + 1;
+    int err;
+
+    json = calloc(1, len);
+
+    if (!json) {
+        return NULL;
+    }
+
+    err = PyOS_snprintf(
+        json,
+        len,
+        format,
+        im->band_names[0]
+    );
+    if (err < 0) {
+        return NULL;
+    }
+    return json;
+}
+
+
 char *
 assemble_metadata(const char *band_json) {
     /* format is
@@ -179,7 +206,17 @@ export_imaging_schema(Imaging im, struct ArrowSchema *schema) {
     }
 
     if (im->bands == 1) {
-        return export_named_type(schema, im->arrow_band_format, im->band_names[0]);
+        retval = export_named_type(schema, im->arrow_band_format, im->band_names[0]);
+        if (retval != 0) {
+            return retval;
+        }
+        // band related metadata
+        band_json = single_band_json(im);
+        if (band_json) {
+            schema->metadata = assemble_metadata(band_json);
+            free(band_json);
+        }
+        return retval;
     }
 
     retval = export_named_type(schema, "+w:4", "");

From adfb66f1d6b61494f0c111ffb21a38dbfc720b4c Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Sun, 20 Jul 2025 10:18:59 +0200
Subject: [PATCH 1951/2374] Fix Compliation errors from rebase

---
 src/_imaging.c                | 5 ++++-
 src/libImaging/BcnEncode.c    | 2 +-
 src/libImaging/Convert.c      | 3 ---
 src/libImaging/Jpeg2KEncode.c | 2 +-
 src/libImaging/Pack.c         | 4 +---
 src/libImaging/Unpack.c       | 8 +++-----
 6 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 4264cdb8748..7823745f0d6 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -297,6 +297,7 @@ ExportArrowArrayPyCapsule(ImagingObject *self) {
 static PyObject *
 _new_arrow(PyObject *self, PyObject *args) {
     char *mode;
+    ModeID mode_id;
     int xsize, ysize;
     PyObject *schema_capsule, *array_capsule;
     PyObject *ret;
@@ -307,9 +308,11 @@ _new_arrow(PyObject *self, PyObject *args) {
         return NULL;
     }
 
+    mode_id = findModeID(mode);
+
     // ImagingBorrowArrow is responsible for retaining the array_capsule
     ret = PyImagingNew(
-        ImagingNewArrow(mode, xsize, ysize, schema_capsule, array_capsule)
+        ImagingNewArrow(mode_id, xsize, ysize, schema_capsule, array_capsule)
     );
     if (!ret) {
         return ImagingError_ValueError("Invalid Arrow array mode or size mismatch");
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 7a5072ddee6..2101383fd42 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -253,7 +253,7 @@ int
 ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
     int n = state->state;
     int has_alpha_channel =
-        strcmp(im->mode, "RGBA") == 0 || strcmp(im->mode, "LA") == 0;
+        im->mode == IMAGING_MODE_RGBA || im->mode == IMAGING_MODE_LA;
 
     UINT8 *dst = buf;
 
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 0c36b84494c..330e5325c33 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -1517,9 +1517,6 @@ static struct {
     {IMAGING_MODE_RGB, IMAGING_MODE_I_16N, rgb2i16l},
 #endif
     {IMAGING_MODE_RGB, IMAGING_MODE_F, rgb2f},
-    {IMAGING_MODE_RGB, IMAGING_MODE_BGR_15, rgb2bgr15},
-    {IMAGING_MODE_RGB, IMAGING_MODE_BGR_16, rgb2bgr16},
-    {IMAGING_MODE_RGB, IMAGING_MODE_BGR_24, rgb2bgr24},
     {IMAGING_MODE_RGB, IMAGING_MODE_RGBA, rgb2rgba},
     {IMAGING_MODE_RGB, IMAGING_MODE_RGBa, rgb2rgba},
     {IMAGING_MODE_RGB, IMAGING_MODE_RGBX, rgb2rgba},
diff --git a/src/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index 67290f6748f..fdfbde2d76b 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -332,7 +332,7 @@ j2k_encode_entry(Imaging im, ImagingCodecState state) {
         pack = j2k_pack_rgba;
 #if ((OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR == 5 && OPJ_VERSION_BUILD >= 3) || \
      (OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR > 5) || OPJ_VERSION_MAJOR > 2)
-    } else if (strcmp(im->mode, "CMYK") == 0) {
+    } else if (im->mode == IMAGING_MODE_CMYK) {
         components = 4;
         color_space = OPJ_CLRSPC_CMYK;
         pack = j2k_pack_rgba;
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index a0652e0cafc..0a97c4872f9 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -651,9 +651,7 @@ static struct {
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16
     },  // LibTiff native->image endian.
     {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
-    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B},
-
-    {NULL} /* sentinel */
+    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B}
 };
 
 ImagingShuffler
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 8d4bb86190a..075ec5b950b 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1313,7 +1313,7 @@ copy4skip2(UINT8 *_out, const UINT8 *in, int pixels) {
 /* Unpack to "I" and "F" images */
 
 #define UNPACK_RAW(NAME, GET, INTYPE, OUTTYPE)                   \
-    static void NAME(UINT8 *out, const UINT8 *in, int pixels) { \
+    static void NAME(UINT8 *out_, const UINT8 *in, int pixels) { \
         int i;                                                   \
         OUTTYPE *out = (OUTTYPE *)out_;                          \
         for (i = 0; i < pixels; i++, in += sizeof(INTYPE)) {     \
@@ -1322,7 +1322,7 @@ copy4skip2(UINT8 *_out, const UINT8 *in, int pixels) {
     }
 
 #define UNPACK(NAME, COPY, INTYPE, OUTTYPE)                      \
-    static void NAME(UINT8 *out, const UINT8 *in, int pixels) { \
+    static void NAME(UINT8 *out_, const UINT8 *in, int pixels) { \
         int i;                                                   \
         OUTTYPE *out = (OUTTYPE *)out_;                          \
         INTYPE tmp_;                                             \
@@ -1839,9 +1839,7 @@ static struct {
 
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16R, 16, unpackI16R_I16},
 
-    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_12, 12, unpackI12_I16},  // 12 bit Tiffs stored in 16bits.
-
-    {NULL} /* sentinel */
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_12, 12, unpackI12_I16}  // 12 bit Tiffs stored in 16bits.
 };
 
 ImagingShuffler

From 1159e65b4f60013f93c5b043743c407dbcf74777 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Sun, 20 Jul 2025 12:58:54 +0200
Subject: [PATCH 1952/2374] Added integration tests for Arro3, comparable to
 PyArrow tests

---
 Tests/test_arro3.py | 276 ++++++++++++++++++++++++++++++++++++++++++++
 pyproject.toml      |   2 +
 2 files changed, 278 insertions(+)
 create mode 100644 Tests/test_arro3.py

diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
new file mode 100644
index 00000000000..ddc7ecd0a90
--- /dev/null
+++ b/Tests/test_arro3.py
@@ -0,0 +1,276 @@
+from __future__ import annotations
+
+import json
+from typing import Any, NamedTuple
+from itertools import repeat, chain
+
+import pytest
+
+from PIL import Image
+
+from .helper import (
+    assert_deep_equal,
+    assert_image_equal,
+    hopper,
+    is_big_endian,
+)
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from arro3.core import Array, DataType, Field, fixed_size_list_array
+    from arro3 import compute
+else:
+    arro3 = pytest.importorskip("arro3", reason="Arro3 not installed")
+    from arro3.core import Array, DataType, Field, fixed_size_list_array
+    from arro3 import compute
+
+TEST_IMAGE_SIZE = (10, 10)
+
+
+def _test_img_equals_pyarray(
+    img: Image.Image, arr: Any, mask: list[int] | None, elts_per_pixel: int = 1
+) -> None:
+    assert img.height * img.width * elts_per_pixel == len(arr)
+    px = img.load()
+    assert px is not None
+    if elts_per_pixel > 1 and mask is None:
+        # have to do element-wise comparison when we're comparing
+        # flattened r,g,b,a to a pixel.
+        mask = list(range(elts_per_pixel))
+    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)):
+            if mask:
+                pixel = px[x, y]
+                assert isinstance(pixel, tuple)
+                for ix, elt in enumerate(mask):
+                    if elts_per_pixel == 1:
+                        assert pixel[ix] == arr[y * img.width + x].as_py()[elt]
+                    else:
+                        assert (
+                            pixel[ix]
+                            == arr[(y * img.width + x) * elts_per_pixel + elt].as_py()
+                        )
+            else:
+                assert_deep_equal(px[x, y], arr[y * img.width + x].as_py())
+
+
+def _test_img_equals_int32_pyarray(
+    img: Image.Image, arr: Any, mask: list[int] | None, elts_per_pixel: int = 1
+) -> None:
+    assert img.height * img.width * elts_per_pixel == len(arr)
+    px = img.load()
+    assert px is not None
+    if mask is None:
+        # have to do element-wise comparison when we're comparing
+        # flattened rgba in an uint32 to a pixel.
+        mask = list(range(elts_per_pixel))
+    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)):
+            pixel = px[x, y]
+            assert isinstance(pixel, tuple)
+            arr_pixel_int = arr[y * img.width + x].as_py()
+            arr_pixel_tuple = (
+                arr_pixel_int % 256,
+                (arr_pixel_int // 256) % 256,
+                (arr_pixel_int // 256**2) % 256,
+                (arr_pixel_int // 256**3),
+            )
+            if is_big_endian():
+                arr_pixel_tuple = arr_pixel_tuple[::-1]
+
+            for ix, elt in enumerate(mask):
+                assert pixel[ix] == arr_pixel_tuple[elt]
+
+fl_uint8_4_type = DataType.list(Field("_", DataType.uint8()).with_nullable(False), 4)
+
+@pytest.mark.parametrize(
+    "mode, dtype, mask",
+    (
+        ("L", DataType.uint8(), None),
+        ("I", DataType.int32(), None),
+        ("F", DataType.float32(), None),
+        ("LA", fl_uint8_4_type, [0, 3]),
+        ("RGB", fl_uint8_4_type, [0, 1, 2]),
+        ("RGBA", fl_uint8_4_type, None),
+        ("RGBX", fl_uint8_4_type, None),
+        ("CMYK", fl_uint8_4_type, None),
+        ("YCbCr", fl_uint8_4_type, [0, 1, 2]),
+        ("HSV", fl_uint8_4_type, [0, 1, 2]),
+    ),
+)
+def test_to_array(mode: str, dtype: DataType, mask: list[int] | None) -> None:
+    img = hopper(mode)
+
+    # Resize to non-square
+    img = img.crop((3, 0, 124, 127))
+    assert img.size == (121, 127)
+
+    arr = Array(img)  # type: ignore[call-overload]
+    _test_img_equals_pyarray(img, arr, mask)
+    assert arr.type == dtype
+
+    reloaded = Image.fromarrow(arr, mode, img.size)
+
+    assert reloaded
+
+    assert_image_equal(img, reloaded)
+
+
+def test_lifetime() -> None:
+    # valgrind shouldn't error out here.
+    # arrays should be accessible after the image is deleted.
+
+    img = hopper("L")
+
+    arr_1 = Array(img)  # type: ignore[call-overload]
+    arr_2 = Array(img)  # type: ignore[call-overload]
+
+    del img
+
+    assert compute.sum(arr_1).as_py() > 0
+    del arr_1
+
+    assert compute.sum(arr_2).as_py() > 0
+    del arr_2
+
+
+def test_lifetime2() -> None:
+    # valgrind shouldn't error out here.
+    # img should remain after the arrays are collected.
+
+    img = hopper("L")
+
+    arr_1 = Array(img)  # type: ignore[call-overload]
+    arr_2 = Array(img)  # type: ignore[call-overload]
+
+    assert compute.sum(arr_1).as_py() > 0
+    del arr_1
+
+    assert compute.sum(arr_2).as_py() > 0
+    del arr_2
+
+    img2 = img.copy()
+    px = img2.load()
+    assert px  # make mypy happy
+    assert isinstance(px[0, 0], int)
+
+
+class DataShape(NamedTuple):
+    dtype: DataType
+    # Strictly speaking, elt should be a pixel or pixel component, so
+    # list[uint8][4], float, int, uint32, uint8, etc.  But more
+    # correctly, it should be exactly the dtype from the line above.
+    elt: Any
+    elts_per_pixel: int
+
+
+UINT_ARR = DataShape(
+    dtype=fl_uint8_4_type,
+    elt=[1, 2, 3, 4],  # array of 4 uint8 per pixel
+    elts_per_pixel=1,  # only one array per pixel
+)
+
+UINT = DataShape(
+    dtype=DataType.uint8(),
+    elt=3,  # one uint8,
+    elts_per_pixel=4,  # but repeated 4x per pixel
+)
+
+UINT32 = DataShape(
+    dtype=DataType.uint32(),
+    elt=0xABCDEF45,  # one packed int, doesn't fit in a int32 > 0x80000000
+    elts_per_pixel=1,  # one per pixel
+)
+
+INT32 = DataShape(
+    dtype=DataType.uint32(),
+    elt=0x12CDEF45,  # one packed int
+    elts_per_pixel=1,  # one per pixel
+)
+
+
+@pytest.mark.parametrize(
+    "mode, data_tp, mask",
+    (
+        ("L", DataShape(DataType.uint8(), 3, 1), None),
+        ("I", DataShape(DataType.int32(), 1 << 24, 1), None),
+        ("F", DataShape(DataType.float32(), 3.14159, 1), None),
+        ("LA", UINT_ARR, [0, 3]),
+        ("LA", UINT, [0, 3]),
+        ("RGB", UINT_ARR, [0, 1, 2]),
+        ("RGBA", UINT_ARR, None),
+        ("CMYK", UINT_ARR, None),
+        ("YCbCr", UINT_ARR, [0, 1, 2]),
+        ("HSV", UINT_ARR, [0, 1, 2]),
+        ("RGB", UINT, [0, 1, 2]),
+        ("RGBA", UINT, None),
+        ("CMYK", UINT, None),
+        ("YCbCr", UINT, [0, 1, 2]),
+        ("HSV", UINT, [0, 1, 2]),
+    ),
+)
+def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
+    (dtype, elt, elts_per_pixel) = data_tp
+
+    ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
+    if dtype == fl_uint8_4_type:
+        tmp_arr = Array(elt * (ct_pixels * elts_per_pixel), type=DataType.uint8())
+        arr = fixed_size_list_array(tmp_arr, 4)
+    else:
+        arr = Array([elt] * (ct_pixels * elts_per_pixel), type=dtype)
+    img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
+
+    _test_img_equals_pyarray(img, arr, mask, elts_per_pixel)
+
+
+@pytest.mark.parametrize(
+    "mode, data_tp, mask",
+    (
+        ("LA", UINT32, [0, 3]),
+        ("RGB", UINT32, [0, 1, 2]),
+        ("RGBA", UINT32, None),
+        ("CMYK", UINT32, None),
+        ("YCbCr", UINT32, [0, 1, 2]),
+        ("HSV", UINT32, [0, 1, 2]),
+        ("LA", INT32, [0, 3]),
+        ("RGB", INT32, [0, 1, 2]),
+        ("RGBA", INT32, None),
+        ("CMYK", INT32, None),
+        ("YCbCr", INT32, [0, 1, 2]),
+        ("HSV", INT32, [0, 1, 2]),
+    ),
+)
+def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
+    (dtype, elt, elts_per_pixel) = data_tp
+
+    ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
+    arr = Array([elt] * (ct_pixels * elts_per_pixel), type=dtype)
+    img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
+
+    _test_img_equals_int32_pyarray(img, arr, mask, elts_per_pixel)
+
+
+@pytest.mark.parametrize(
+    "mode, metadata",
+    (
+        ("LA", ["L", "X", "X", "A"]),
+        ("RGB", ["R", "G", "B", "X"]),
+        ("RGBX", ["R", "G", "B", "X"]),
+        ("RGBA", ["R", "G", "B", "A"]),
+        ("CMYK", ["C", "M", "Y", "K"]),
+        ("YCbCr", ["Y", "Cb", "Cr", "X"]),
+        ("HSV", ["H", "S", "V", "X"]),
+    ),
+)
+def test_image_metadata(mode: str, metadata: list[str]) -> None:
+    img = hopper(mode)
+
+    arr = Array(img)  # type: ignore[call-overload]
+
+    assert arr.type.value_field.metadata
+    assert arr.type.value_field.metadata[b"image"]
+
+    parsed_metadata = json.loads(arr.type.value_field.metadata[b"image"].decode("utf8"))
+
+    assert "bands" in parsed_metadata
+    assert parsed_metadata["bands"] == metadata
diff --git a/pyproject.toml b/pyproject.toml
index 4e8623118ba..b1765e82cfc 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -58,6 +58,8 @@ optional-dependencies.mic = [
 ]
 optional-dependencies.test-arrow = [
   "pyarrow",
+  "arro3-core",
+  "arro3-compute",
 ]
 
 optional-dependencies.tests = [

From 1a02d4ed5a1672218249ed129f43d4109b32e183 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Sun, 20 Jul 2025 13:01:39 +0200
Subject: [PATCH 1953/2374] lint fixes

---
 Tests/test_arro3.py    | 7 ++++---
 pyproject.toml         | 4 ++--
 src/libImaging/Arrow.c | 8 +-------
 3 files changed, 7 insertions(+), 12 deletions(-)

diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
index ddc7ecd0a90..a7c755fc2b6 100644
--- a/Tests/test_arro3.py
+++ b/Tests/test_arro3.py
@@ -2,7 +2,6 @@
 
 import json
 from typing import Any, NamedTuple
-from itertools import repeat, chain
 
 import pytest
 
@@ -17,12 +16,12 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from arro3.core import Array, DataType, Field, fixed_size_list_array
     from arro3 import compute
+    from arro3.core import Array, DataType, Field, fixed_size_list_array
 else:
     arro3 = pytest.importorskip("arro3", reason="Arro3 not installed")
-    from arro3.core import Array, DataType, Field, fixed_size_list_array
     from arro3 import compute
+    from arro3.core import Array, DataType, Field, fixed_size_list_array
 
 TEST_IMAGE_SIZE = (10, 10)
 
@@ -81,8 +80,10 @@ def _test_img_equals_int32_pyarray(
             for ix, elt in enumerate(mask):
                 assert pixel[ix] == arr_pixel_tuple[elt]
 
+
 fl_uint8_4_type = DataType.list(Field("_", DataType.uint8()).with_nullable(False), 4)
 
+
 @pytest.mark.parametrize(
     "mode, dtype, mask",
     (
diff --git a/pyproject.toml b/pyproject.toml
index b1765e82cfc..899e833e35f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -57,9 +57,9 @@ optional-dependencies.mic = [
   "olefile",
 ]
 optional-dependencies.test-arrow = [
-  "pyarrow",
-  "arro3-core",
   "arro3-compute",
+  "arro3-core",
+  "pyarrow",
 ]
 
 optional-dependencies.tests = [
diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index ff98dfb5134..4519243ae4d 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -98,19 +98,13 @@ single_band_json(Imaging im) {
         return NULL;
     }
 
-    err = PyOS_snprintf(
-        json,
-        len,
-        format,
-        im->band_names[0]
-    );
+    err = PyOS_snprintf(json, len, format, im->band_names[0]);
     if (err < 0) {
         return NULL;
     }
     return json;
 }
 
-
 char *
 assemble_metadata(const char *band_json) {
     /* format is

From 28c7645d8bab0a746f60e37cbfde1c79b8f69ca9 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Jul 2025 11:19:45 +0200
Subject: [PATCH 1954/2374] Added tests for integration with nanoarrow

---
 Tests/test_nanoarrow.py | 281 ++++++++++++++++++++++++++++++++++++++++
 pyproject.toml          |   1 +
 2 files changed, 282 insertions(+)
 create mode 100644 Tests/test_nanoarrow.py

diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
new file mode 100644
index 00000000000..e0ae11baae1
--- /dev/null
+++ b/Tests/test_nanoarrow.py
@@ -0,0 +1,281 @@
+from __future__ import annotations
+
+import json
+from typing import Any, NamedTuple
+
+import pytest
+
+from PIL import Image
+
+from .helper import (
+    assert_deep_equal,
+    assert_image_equal,
+    hopper,
+    is_big_endian,
+)
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    import nanoarrow
+else:
+    nanoarrow = pytest.importorskip("nanoarrow", reason="Nanoarrow not installed")
+
+TEST_IMAGE_SIZE = (10, 10)
+
+
+def _test_img_equals_pyarray(
+    img: Image.Image, arr: Any, mask: list[int] | None, elts_per_pixel: int = 1
+) -> None:
+    assert img.height * img.width * elts_per_pixel == len(arr)
+    px = img.load()
+    assert px is not None
+    if elts_per_pixel > 1 and mask is None:
+        # have to do element-wise comparison when we're comparing
+        # flattened r,g,b,a to a pixel.
+        mask = list(range(elts_per_pixel))
+    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)):
+            if mask:
+                pixel = px[x, y]
+                assert isinstance(pixel, tuple)
+                for ix, elt in enumerate(mask):
+                    if elts_per_pixel == 1:
+                        assert pixel[ix] == arr[y * img.width + x].as_py()[elt]
+                    else:
+                        assert (
+                            pixel[ix]
+                            == arr[(y * img.width + x) * elts_per_pixel + elt].as_py()
+                        )
+            else:
+                assert_deep_equal(px[x, y], arr[y * img.width + x].as_py())
+
+
+def _test_img_equals_int32_pyarray(
+    img: Image.Image, arr: Any, mask: list[int] | None, elts_per_pixel: int = 1
+) -> None:
+    assert img.height * img.width * elts_per_pixel == len(arr)
+    px = img.load()
+    assert px is not None
+    if mask is None:
+        # have to do element-wise comparison when we're comparing
+        # flattened rgba in an uint32 to a pixel.
+        mask = list(range(elts_per_pixel))
+    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)):
+            pixel = px[x, y]
+            assert isinstance(pixel, tuple)
+            arr_pixel_int = arr[y * img.width + x].as_py()
+            arr_pixel_tuple = (
+                arr_pixel_int % 256,
+                (arr_pixel_int // 256) % 256,
+                (arr_pixel_int // 256**2) % 256,
+                (arr_pixel_int // 256**3),
+            )
+            if is_big_endian():
+                arr_pixel_tuple = arr_pixel_tuple[::-1]
+
+            for ix, elt in enumerate(mask):
+                assert pixel[ix] == arr_pixel_tuple[elt]
+
+
+fl_uint8_4_type = nanoarrow.fixed_size_list(value_type=nanoarrow.uint8(nullable=False),
+                                            list_size=4,
+                                            nullable=False)
+
+
+@pytest.mark.parametrize(
+    "mode, dtype, mask",
+    (
+        ("L", nanoarrow.uint8(nullable=False), None),
+        ("I", nanoarrow.int32(nullable=False), None),
+        ("F", nanoarrow.float32(nullable=False), None),
+        ("LA", fl_uint8_4_type, [0, 3]),
+        ("RGB", fl_uint8_4_type, [0, 1, 2]),
+        ("RGBA", fl_uint8_4_type, None),
+        ("RGBX", fl_uint8_4_type, None),
+        ("CMYK", fl_uint8_4_type, None),
+        ("YCbCr", fl_uint8_4_type, [0, 1, 2]),
+        ("HSV", fl_uint8_4_type, [0, 1, 2]),
+    ),
+)
+def test_to_array(mode: str, dtype: nanoarrow, mask: list[int] | None) -> None:
+    img = hopper(mode)
+
+    # Resize to non-square
+    img = img.crop((3, 0, 124, 127))
+    assert img.size == (121, 127)
+
+    arr = nanoarrow.Array(img)  # type: ignore[call-overload]
+    _test_img_equals_pyarray(img, arr, mask)
+    assert arr.schema.type == dtype.type
+    assert arr.schema.nullable == dtype.nullable
+
+    reloaded = Image.fromarrow(arr, mode, img.size)
+
+    assert reloaded
+
+    assert_image_equal(img, reloaded)
+
+
+def test_lifetime() -> None:
+    # valgrind shouldn't error out here.
+    # arrays should be accessible after the image is deleted.
+
+    img = hopper("L")
+
+    arr_1 = nanoarrow.Array(img)  # type: ignore[call-overload]
+    arr_2 = nanoarrow.Array(img)  # type: ignore[call-overload]
+
+    del img
+
+    assert sum(arr_1.iter_py()) > 0
+    del arr_1
+
+    assert sum(arr_2.iter_py()) > 0
+    del arr_2
+
+
+def test_lifetime2() -> None:
+    # valgrind shouldn't error out here.
+    # img should remain after the arrays are collected.
+
+    img = hopper("L")
+
+    arr_1 = nanoarrow.Array(img)  # type: ignore[call-overload]
+    arr_2 = nanoarrow.Array(img)  # type: ignore[call-overload]
+
+    assert sum(arr_1.iter_py()) > 0
+    del arr_1
+
+    assert sum(arr_2.iter_py()) > 0
+    del arr_2
+
+    img2 = img.copy()
+    px = img2.load()
+    assert px  # make mypy happy
+    assert isinstance(px[0, 0], int)
+
+
+class DataShape(NamedTuple):
+    dtype: nanoarrow
+    # Strictly speaking, elt should be a pixel or pixel component, so
+    # list[uint8][4], float, int, uint32, uint8, etc.  But more
+    # correctly, it should be exactly the dtype from the line above.
+    elt: Any
+    elts_per_pixel: int
+
+
+UINT_ARR = DataShape(
+    dtype=fl_uint8_4_type,
+    elt=[1, 2, 3, 4],  # array of 4 uint8 per pixel
+    elts_per_pixel=1,  # only one array per pixel
+)
+
+UINT = DataShape(
+    dtype=nanoarrow.uint8(),
+    elt=3,  # one uint8,
+    elts_per_pixel=4,  # but repeated 4x per pixel
+)
+
+UINT32 = DataShape(
+    dtype=nanoarrow.uint32(),
+    elt=0xABCDEF45,  # one packed int, doesn't fit in a int32 > 0x80000000
+    elts_per_pixel=1,  # one per pixel
+)
+
+INT32 = DataShape(
+    dtype=nanoarrow.uint32(),
+    elt=0x12CDEF45,  # one packed int
+    elts_per_pixel=1,  # one per pixel
+)
+
+
+@pytest.mark.xfail(reason="Support for nested array creation is not available in nanoarrow/python")
+@pytest.mark.parametrize(
+    "mode, data_tp, mask",
+    (
+        ("L", DataShape(nanoarrow.uint8(), 3, 1), None),
+        ("I", DataShape(nanoarrow.int32(), 1 << 24, 1), None),
+        ("F", DataShape(nanoarrow.float32(), 3.14159, 1), None),
+        ("LA", UINT_ARR, [0, 3]),
+        ("LA", UINT, [0, 3]),
+        ("RGB", UINT_ARR, [0, 1, 2]),
+        ("RGBA", UINT_ARR, None),
+        ("CMYK", UINT_ARR, None),
+        ("YCbCr", UINT_ARR, [0, 1, 2]),
+        ("HSV", UINT_ARR, [0, 1, 2]),
+        ("RGB", UINT, [0, 1, 2]),
+        ("RGBA", UINT, None),
+        ("CMYK", UINT, None),
+        ("YCbCr", UINT, [0, 1, 2]),
+        ("HSV", UINT, [0, 1, 2]),
+    ),
+)
+def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
+    (dtype, elt, elts_per_pixel) = data_tp
+
+    ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
+    if dtype == fl_uint8_4_type:
+        # Apparently there's no good way to create this array from python using nanoarrow
+        # https://github.com/apache/arrow-nanoarrow/issues/620
+        # the following lines will fail.
+        tmp_arr = nanoarrow.c_array(elt * (ct_pixels * elts_per_pixel), schema=nanoarrow.uint8())
+        arr = nanoarrow.Array(tmp_arr, schema=dtype)
+    else:
+        arr = nanoarrow.Array(nanoarrow.c_array([elt] * (ct_pixels * elts_per_pixel), schema=dtype))
+    img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
+
+    _test_img_equals_pyarray(img, arr, mask, elts_per_pixel)
+
+
+@pytest.mark.parametrize(
+    "mode, data_tp, mask",
+    (
+        ("LA", UINT32, [0, 3]),
+        ("RGB", UINT32, [0, 1, 2]),
+        ("RGBA", UINT32, None),
+        ("CMYK", UINT32, None),
+        ("YCbCr", UINT32, [0, 1, 2]),
+        ("HSV", UINT32, [0, 1, 2]),
+        ("LA", INT32, [0, 3]),
+        ("RGB", INT32, [0, 1, 2]),
+        ("RGBA", INT32, None),
+        ("CMYK", INT32, None),
+        ("YCbCr", INT32, [0, 1, 2]),
+        ("HSV", INT32, [0, 1, 2]),
+    ),
+)
+def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
+    (dtype, elt, elts_per_pixel) = data_tp
+
+    ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
+    arr = nanoarrow.Array(nanoarrow.c_array([elt] * (ct_pixels * elts_per_pixel), schema=dtype))
+    img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
+
+    _test_img_equals_int32_pyarray(img, arr, mask, elts_per_pixel)
+
+
+@pytest.mark.parametrize(
+    "mode, metadata",
+    (
+        ("LA", ["L", "X", "X", "A"]),
+        ("RGB", ["R", "G", "B", "X"]),
+        ("RGBX", ["R", "G", "B", "X"]),
+        ("RGBA", ["R", "G", "B", "A"]),
+        ("CMYK", ["C", "M", "Y", "K"]),
+        ("YCbCr", ["Y", "Cb", "Cr", "X"]),
+        ("HSV", ["H", "S", "V", "X"]),
+    ),
+)
+def test_image_nested_metadata(mode: str, metadata: list[str]) -> None:
+    img = hopper(mode)
+
+    arr = nanoarrow.Array(img)  # type: ignore[call-overload]
+
+    assert arr.schema.value_type.metadata
+    assert arr.schema.value_type.metadata[b"image"]
+
+    parsed_metadata = json.loads(arr.schema.value_type.metadata[b"image"].decode("utf8"))
+
+    assert "bands" in parsed_metadata
+    assert parsed_metadata["bands"] == metadata
diff --git a/pyproject.toml b/pyproject.toml
index 899e833e35f..5a4f752b319 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -60,6 +60,7 @@ optional-dependencies.test-arrow = [
   "arro3-compute",
   "arro3-core",
   "pyarrow",
+  "nanoarrow",
 ]
 
 optional-dependencies.tests = [

From 7d2abbdcf91f01fd2bc83dace639f5eb5f7a562c Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Jul 2025 11:22:45 +0200
Subject: [PATCH 1955/2374] lint.

---
 Tests/test_nanoarrow.py | 26 ++++++++++++++++++--------
 pyproject.toml          |  2 +-
 2 files changed, 19 insertions(+), 9 deletions(-)

diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index e0ae11baae1..3dc540043a8 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -78,9 +78,9 @@ def _test_img_equals_int32_pyarray(
                 assert pixel[ix] == arr_pixel_tuple[elt]
 
 
-fl_uint8_4_type = nanoarrow.fixed_size_list(value_type=nanoarrow.uint8(nullable=False),
-                                            list_size=4,
-                                            nullable=False)
+fl_uint8_4_type = nanoarrow.fixed_size_list(
+    value_type=nanoarrow.uint8(nullable=False), list_size=4, nullable=False
+)
 
 
 @pytest.mark.parametrize(
@@ -190,7 +190,9 @@ class DataShape(NamedTuple):
 )
 
 
-@pytest.mark.xfail(reason="Support for nested array creation is not available in nanoarrow/python")
+@pytest.mark.xfail(
+    reason="Support for nested array creation is not available in nanoarrow/python"
+)
 @pytest.mark.parametrize(
     "mode, data_tp, mask",
     (
@@ -219,10 +221,14 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
         # Apparently there's no good way to create this array from python using nanoarrow
         # https://github.com/apache/arrow-nanoarrow/issues/620
         # the following lines will fail.
-        tmp_arr = nanoarrow.c_array(elt * (ct_pixels * elts_per_pixel), schema=nanoarrow.uint8())
+        tmp_arr = nanoarrow.c_array(
+            elt * (ct_pixels * elts_per_pixel), schema=nanoarrow.uint8()
+        )
         arr = nanoarrow.Array(tmp_arr, schema=dtype)
     else:
-        arr = nanoarrow.Array(nanoarrow.c_array([elt] * (ct_pixels * elts_per_pixel), schema=dtype))
+        arr = nanoarrow.Array(
+            nanoarrow.c_array([elt] * (ct_pixels * elts_per_pixel), schema=dtype)
+        )
     img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
 
     _test_img_equals_pyarray(img, arr, mask, elts_per_pixel)
@@ -249,7 +255,9 @@ def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None)
     (dtype, elt, elts_per_pixel) = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
-    arr = nanoarrow.Array(nanoarrow.c_array([elt] * (ct_pixels * elts_per_pixel), schema=dtype))
+    arr = nanoarrow.Array(
+        nanoarrow.c_array([elt] * (ct_pixels * elts_per_pixel), schema=dtype)
+    )
     img = Image.fromarrow(arr, mode, TEST_IMAGE_SIZE)
 
     _test_img_equals_int32_pyarray(img, arr, mask, elts_per_pixel)
@@ -275,7 +283,9 @@ def test_image_nested_metadata(mode: str, metadata: list[str]) -> None:
     assert arr.schema.value_type.metadata
     assert arr.schema.value_type.metadata[b"image"]
 
-    parsed_metadata = json.loads(arr.schema.value_type.metadata[b"image"].decode("utf8"))
+    parsed_metadata = json.loads(
+        arr.schema.value_type.metadata[b"image"].decode("utf8")
+    )
 
     assert "bands" in parsed_metadata
     assert parsed_metadata["bands"] == metadata
diff --git a/pyproject.toml b/pyproject.toml
index 5a4f752b319..c450e427432 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -59,8 +59,8 @@ optional-dependencies.mic = [
 optional-dependencies.test-arrow = [
   "arro3-compute",
   "arro3-core",
-  "pyarrow",
   "nanoarrow",
+  "pyarrow",
 ]
 
 optional-dependencies.tests = [

From c07fe6e94313bf4172c670a8d6c4c3e7c78ac469 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Jul 2025 11:33:14 +0200
Subject: [PATCH 1956/2374] Added flat image metadata tests

This metadata is available in nanoarrow, but not pyarrow or arro3
---
 Tests/test_nanoarrow.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index 3dc540043a8..f0d60954521 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -289,3 +289,26 @@ def test_image_nested_metadata(mode: str, metadata: list[str]) -> None:
 
     assert "bands" in parsed_metadata
     assert parsed_metadata["bands"] == metadata
+
+@pytest.mark.parametrize(
+    "mode, metadata",
+    (
+        ("L", ["L"]),
+        ("I", ["I"]),
+        ("F", ["F"]),
+    ),
+)
+def test_image_flat_metadata(mode: str, metadata: list[str]) -> None:
+    img = hopper(mode)
+
+    arr = nanoarrow.Array(img)  # type: ignore[call-overload]
+
+    assert arr.schema.metadata
+    assert arr.schema.metadata[b"image"]
+
+    parsed_metadata = json.loads(
+        arr.schema.metadata[b"image"].decode("utf8")
+    )
+
+    assert "bands" in parsed_metadata
+    assert parsed_metadata["bands"] == metadata

From 9e415c787639d50fcfbd9a519174a60e3eb6c1e9 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Mon, 21 Jul 2025 17:24:52 +0200
Subject: [PATCH 1957/2374] A way to make nested arrays in nano arrow but
 detouring through a buffer

---
 Tests/test_nanoarrow.py | 18 +++++++-----------
 1 file changed, 7 insertions(+), 11 deletions(-)

diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index f0d60954521..b08333ae97b 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -190,9 +190,6 @@ class DataShape(NamedTuple):
 )
 
 
-@pytest.mark.xfail(
-    reason="Support for nested array creation is not available in nanoarrow/python"
-)
 @pytest.mark.parametrize(
     "mode, data_tp, mask",
     (
@@ -218,13 +215,13 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
     if dtype == fl_uint8_4_type:
-        # Apparently there's no good way to create this array from python using nanoarrow
-        # https://github.com/apache/arrow-nanoarrow/issues/620
-        # the following lines will fail.
-        tmp_arr = nanoarrow.c_array(
+        tmp_arr = nanoarrow.Array(
             elt * (ct_pixels * elts_per_pixel), schema=nanoarrow.uint8()
         )
-        arr = nanoarrow.Array(tmp_arr, schema=dtype)
+        c_array = nanoarrow.c_array_from_buffers(
+            dtype, ct_pixels, buffers=[], children=[tmp_arr]
+        )
+        arr = nanoarrow.Array(c_array)
     else:
         arr = nanoarrow.Array(
             nanoarrow.c_array([elt] * (ct_pixels * elts_per_pixel), schema=dtype)
@@ -290,6 +287,7 @@ def test_image_nested_metadata(mode: str, metadata: list[str]) -> None:
     assert "bands" in parsed_metadata
     assert parsed_metadata["bands"] == metadata
 
+
 @pytest.mark.parametrize(
     "mode, metadata",
     (
@@ -306,9 +304,7 @@ def test_image_flat_metadata(mode: str, metadata: list[str]) -> None:
     assert arr.schema.metadata
     assert arr.schema.metadata[b"image"]
 
-    parsed_metadata = json.loads(
-        arr.schema.metadata[b"image"].decode("utf8")
-    )
+    parsed_metadata = json.loads(arr.schema.metadata[b"image"].decode("utf8"))
 
     assert "bands" in parsed_metadata
     assert parsed_metadata["bands"] == metadata

From f4d86e4f44dfe799b0a2d6484fa53945ab89220e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 24 Jul 2025 07:27:39 +1000
Subject: [PATCH 1958/2374] Use teardown_method

---
 Tests/test_image_access.py | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 2609b1e342a..a847264d27e 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -276,11 +276,10 @@ def test_embeddable(self) -> None:
         except Exception:
             pytest.skip("Compiler could not be initialized")
 
-        try:
-            with open("embed_pil.c", "w", encoding="utf-8") as fh:
-                home = sys.prefix.replace("\\", "\\\\")
-                fh.write(
-                    f"""
+        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[])
@@ -302,19 +301,20 @@ def test_embeddable(self) -> None:
     return 0;
 }}
         """
-                )
+            )
+
+        objects = compiler.compile(["embed_pil.c"])
+        compiler.link_executable(objects, "embed_pil")
 
-            objects = compiler.compile(["embed_pil.c"])
-            compiler.link_executable(objects, "embed_pil")
+        env = os.environ.copy()
+        env["PATH"] = sys.prefix + ";" + env["PATH"]
 
-            env = os.environ.copy()
-            env["PATH"] = sys.prefix + ";" + env["PATH"]
+        # Do not display the Windows Error Reporting dialog
+        getattr(ctypes, "windll").kernel32.SetErrorMode(0x0002)
 
-            # Do not display the Windows Error Reporting dialog
-            getattr(ctypes, "windll").kernel32.SetErrorMode(0x0002)
+        process = subprocess.Popen(["embed_pil.exe"], env=env)
+        process.communicate()
+        assert process.returncode == 0
 
-            process = subprocess.Popen(["embed_pil.exe"], env=env)
-            process.communicate()
-            assert process.returncode == 0
-        finally:
-            os.remove("embed_pil.c")
+    def teardown_method(self) -> None:
+        os.remove("embed_pil.c")

From 103a5a0b5913ab403eeaaf0b589278bc8e2b067b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 23 Jul 2025 18:22:10 +1000
Subject: [PATCH 1959/2374] Fixed ZeroDivisionError

---
 Tests/test_imagestat.py | 10 ++++++++++
 src/PIL/ImageStat.py    | 13 ++++++++++---
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/Tests/test_imagestat.py b/Tests/test_imagestat.py
index 0dfbc5a2abb..0baab7ce21e 100644
--- a/Tests/test_imagestat.py
+++ b/Tests/test_imagestat.py
@@ -57,3 +57,13 @@ def test_constant() -> None:
     assert st.rms[0] == 128
     assert st.var[0] == 0
     assert st.stddev[0] == 0
+
+
+def test_zero_count() -> None:
+    im = Image.new("L", (0, 0))
+
+    st = ImageStat.Stat(im)
+
+    assert st.mean == [0]
+    assert st.rms == [0]
+    assert st.var == [0]
diff --git a/src/PIL/ImageStat.py b/src/PIL/ImageStat.py
index 8bc504526f0..3a1044ba449 100644
--- a/src/PIL/ImageStat.py
+++ b/src/PIL/ImageStat.py
@@ -120,7 +120,7 @@ def sum2(self) -> list[float]:
     @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]
+        return [self.sum[i] / self.count[i] if self.count[i] else 0 for i in self.bands]
 
     @cached_property
     def median(self) -> list[int]:
@@ -141,13 +141,20 @@ def median(self) -> list[int]:
     @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]
+        return [
+            math.sqrt(self.sum2[i] / self.count[i]) if self.count[i] else 0
+            for i in self.bands
+        ]
 
     @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]
+            (
+                (self.sum2[i] - (self.sum[i] ** 2.0) / self.count[i]) / self.count[i]
+                if self.count[i]
+                else 0
+            )
             for i in self.bands
         ]
 

From 24681a39270ee09dc869711d39b9ae183e981ae7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 21 Jul 2025 17:09:26 +1000
Subject: [PATCH 1960/2374] Added ImageText

---
 Tests/test_imagetext.py      |  41 ++++
 docs/reference/ImageText.rst |  30 +++
 docs/reference/index.rst     |   1 +
 src/PIL/ImageDraw.py         | 390 +++++++++--------------------------
 src/PIL/ImageText.py         | 318 ++++++++++++++++++++++++++++
 src/PIL/_typing.py           |   2 +
 6 files changed, 490 insertions(+), 292 deletions(-)
 create mode 100644 Tests/test_imagetext.py
 create mode 100644 docs/reference/ImageText.rst
 create mode 100644 src/PIL/ImageText.py

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
new file mode 100644
index 00000000000..3a3a58975d1
--- /dev/null
+++ b/Tests/test_imagetext.py
@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+import pytest
+
+from PIL import ImageFont, ImageText
+
+from .helper import skip_unless_feature
+
+FONT_PATH = "Tests/fonts/FreeMono.ttf"
+
+
+@pytest.fixture(
+    scope="module",
+    params=[
+        pytest.param(ImageFont.Layout.BASIC),
+        pytest.param(ImageFont.Layout.RAQM, marks=skip_unless_feature("raqm")),
+    ],
+)
+def layout_engine(request: pytest.FixtureRequest) -> ImageFont.Layout:
+    return request.param
+
+
+@pytest.fixture(scope="module")
+def font(layout_engine: ImageFont.Layout) -> ImageFont.FreeTypeFont:
+    return ImageFont.truetype(FONT_PATH, 20, layout_engine=layout_engine)
+
+
+def test_get_length(font: ImageFont.FreeTypeFont) -> None:
+    assert ImageText.ImageText("A", font).get_length() == 12
+    assert ImageText.ImageText("AB", font).get_length() == 24
+    assert ImageText.ImageText("M", font).get_length() == 12
+    assert ImageText.ImageText("y", font).get_length() == 12
+    assert ImageText.ImageText("a", font).get_length() == 12
+
+
+def test_get_bbox(font: ImageFont.FreeTypeFont) -> None:
+    assert ImageText.ImageText("A", font).get_bbox() == (0, 4, 12, 16)
+    assert ImageText.ImageText("AB", font).get_bbox() == (0, 4, 24, 16)
+    assert ImageText.ImageText("M", font).get_bbox() == (0, 4, 12, 16)
+    assert ImageText.ImageText("y", font).get_bbox() == (0, 7, 12, 20)
+    assert ImageText.ImageText("a", font).get_bbox() == (0, 7, 12, 16)
diff --git a/docs/reference/ImageText.rst b/docs/reference/ImageText.rst
new file mode 100644
index 00000000000..ad5439751f9
--- /dev/null
+++ b/docs/reference/ImageText.rst
@@ -0,0 +1,30 @@
+.. py:module:: PIL.ImageText
+.. py:currentmodule:: PIL.ImageText
+
+:py:mod:`~PIL.ImageText` module
+===============================
+
+The :py:mod:`~PIL.ImageText` module defines a class with the same name. Instances of
+this class provide a way to use fonts with text strings or bytes. The result is a
+simple API to apply styling to pieces of text and measure them.
+
+Example
+-------
+
+::
+
+    from PIL import Image, ImageDraw, ImageFont, ImageText
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 24)
+
+    text = ImageText.ImageText("Hello world", font)
+    text.embed_color()
+    text.stroke(2, "#0f0")
+
+    print(text.get_length())  # 154.0
+    print(text.get_bbox())  # (-2, 3, 156, 22)
+
+Methods
+-------
+
+.. autoclass:: PIL.ImageText.ImageText
+    :members:
diff --git a/docs/reference/index.rst b/docs/reference/index.rst
index effcd3c46a1..1ce26c909e8 100644
--- a/docs/reference/index.rst
+++ b/docs/reference/index.rst
@@ -24,6 +24,7 @@ Reference
    ImageSequence
    ImageShow
    ImageStat
+   ImageText
    ImageTk
    ImageTransform
    ImageWin
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index e95fa91f8b3..35ecbfb78b4 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -35,10 +35,10 @@
 import struct
 from collections.abc import Sequence
 from types import ModuleType
-from typing import Any, AnyStr, Callable, Union, cast
+from typing import Any, AnyStr, Callable, cast
 
-from . import Image, ImageColor
-from ._typing import Coords
+from . import Image, ImageColor, ImageText
+from ._typing import Coords, _Ink
 
 # experimental access to the outline API
 Outline: Callable[[], Image.core._Outline] = Image.core.outline
@@ -47,8 +47,6 @@
 if TYPE_CHECKING:
     from . import ImageDraw2, ImageFont
 
-_Ink = Union[float, tuple[int, ...], str]
-
 """
 A simple 2D drawing interface for PIL images.
 <p>
@@ -536,11 +534,6 @@ def draw_corners(pieslice: bool) -> None:
                     right[3] -= r + 1
                 self.draw.draw_rectangle(right, ink, 1)
 
-    def _multiline_check(self, text: AnyStr) -> bool:
-        split_character = "\n" if isinstance(text, str) else b"\n"
-
-        return split_character in text
-
     def text(
         self,
         xy: tuple[float, float],
@@ -565,29 +558,15 @@ def text(
         **kwargs: Any,
     ) -> None:
         """Draw text."""
-        if embedded_color and self.mode not in ("RGB", "RGBA"):
-            msg = "Embedded color supported only in RGB and RGBA modes"
-            raise ValueError(msg)
-
         if font is None:
             font = self._getfont(kwargs.get("font_size"))
-
-        if self._multiline_check(text):
-            return self.multiline_text(
-                xy,
-                text,
-                fill,
-                font,
-                anchor,
-                spacing,
-                align,
-                direction,
-                features,
-                language,
-                stroke_width,
-                stroke_fill,
-                embedded_color,
-            )
+        imagetext = ImageText.ImageText(
+            text, font, self.mode, spacing, direction, features, language
+        )
+        if embedded_color:
+            imagetext.embed_color()
+        if stroke_width:
+            imagetext.stroke(stroke_width, stroke_fill)
 
         def getink(fill: _Ink | None) -> int:
             ink, fill_ink = self._getink(fill)
@@ -596,70 +575,79 @@ def getink(fill: _Ink | None) -> int:
                 return fill_ink
             return ink
 
-        def draw_text(ink: int, stroke_width: float = 0) -> None:
-            mode = self.fontmode
-            if stroke_width == 0 and embedded_color:
-                mode = "RGBA"
-            coord = []
-            for i in range(2):
-                coord.append(int(xy[i]))
-            start = (math.modf(xy[0])[0], math.modf(xy[1])[0])
-            try:
-                mask, offset = font.getmask2(  # type: ignore[union-attr,misc]
-                    text,
-                    mode,
-                    direction=direction,
-                    features=features,
-                    language=language,
-                    stroke_width=stroke_width,
-                    stroke_filled=True,
-                    anchor=anchor,
-                    ink=ink,
-                    start=start,
-                    *args,
-                    **kwargs,
-                )
-                coord = [coord[0] + offset[0], coord[1] + offset[1]]
-            except AttributeError:
+        ink = getink(fill)
+        if ink is None:
+            return
+
+        stroke_ink = None
+        if imagetext.stroke_width:
+            stroke_ink = (
+                getink(imagetext.stroke_fill)
+                if imagetext.stroke_fill is not None
+                else ink
+            )
+
+        for xy, anchor, line in imagetext._split(xy, anchor, align):
+
+            def draw_text(ink: int, stroke_width: float = 0) -> None:
+                mode = self.fontmode
+                if stroke_width == 0 and embedded_color:
+                    mode = "RGBA"
+                coord = []
+                for i in range(2):
+                    coord.append(int(xy[i]))
+                start = (math.modf(xy[0])[0], math.modf(xy[1])[0])
                 try:
-                    mask = font.getmask(  # type: ignore[misc]
-                        text,
+                    mask, offset = imagetext.font.getmask2(  # type: ignore[union-attr,misc]
+                        line,
                         mode,
-                        direction,
-                        features,
-                        language,
-                        stroke_width,
-                        anchor,
-                        ink,
+                        direction=direction,
+                        features=features,
+                        language=language,
+                        stroke_width=stroke_width,
+                        stroke_filled=True,
+                        anchor=anchor,
+                        ink=ink,
                         start=start,
                         *args,
                         **kwargs,
                     )
-                except TypeError:
-                    mask = font.getmask(text)
-            if mode == "RGBA":
-                # font.getmask2(mode="RGBA") returns color in RGB bands and mask in A
-                # extract mask and set text alpha
-                color, mask = mask, mask.getband(3)
-                ink_alpha = struct.pack("i", ink)[3]
-                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
-                    )
-            else:
-                self.draw.draw_bitmap(coord, mask, ink)
-
-        ink = getink(fill)
-        if ink is not None:
-            stroke_ink = None
-            if stroke_width:
-                stroke_ink = getink(stroke_fill) if stroke_fill is not None else ink
+                    coord = [coord[0] + offset[0], coord[1] + offset[1]]
+                except AttributeError:
+                    try:
+                        mask = imagetext.font.getmask(  # type: ignore[misc]
+                            line,
+                            mode,
+                            direction,
+                            features,
+                            language,
+                            stroke_width,
+                            anchor,
+                            ink,
+                            start=start,
+                            *args,
+                            **kwargs,
+                        )
+                    except TypeError:
+                        mask = imagetext.font.getmask(line)
+                if mode == "RGBA":
+                    # imagetext.font.getmask2(mode="RGBA")
+                    # returns color in RGB bands and mask in A
+                    # extract mask and set text alpha
+                    color, mask = mask, mask.getband(3)
+                    ink_alpha = struct.pack("i", ink)[3]
+                    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
+                        )
+                else:
+                    self.draw.draw_bitmap(coord, mask, ink)
 
             if stroke_ink is not None:
                 # Draw stroked text
-                draw_text(stroke_ink, stroke_width)
+                draw_text(stroke_ink, imagetext.stroke_width)
 
                 # Draw normal text
                 if ink != stroke_ink:
@@ -668,132 +656,6 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                 # Only draw normal text
                 draw_text(ink)
 
-    def _prepare_multiline_text(
-        self,
-        xy: tuple[float, float],
-        text: AnyStr,
-        font: (
-            ImageFont.ImageFont
-            | ImageFont.FreeTypeFont
-            | ImageFont.TransposedFont
-            | None
-        ),
-        anchor: str | None,
-        spacing: float,
-        align: str,
-        direction: str | None,
-        features: list[str] | None,
-        language: str | None,
-        stroke_width: float,
-        embedded_color: bool,
-        font_size: float | None,
-    ) -> tuple[
-        ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont,
-        list[tuple[tuple[float, float], str, AnyStr]],
-    ]:
-        if anchor is None:
-            anchor = "lt" if direction == "ttb" else "la"
-        elif len(anchor) != 2:
-            msg = "anchor must be a 2 character string"
-            raise ValueError(msg)
-        elif anchor[1] in "tb" and direction != "ttb":
-            msg = "anchor not supported for multiline text"
-            raise ValueError(msg)
-
-        if font is None:
-            font = self._getfont(font_size)
-
-        lines = text.split("\n" if isinstance(text, str) else b"\n")
-        line_spacing = (
-            self.textbbox((0, 0), "A", font, stroke_width=stroke_width)[3]
-            + stroke_width
-            + spacing
-        )
-
-        top = xy[1]
-        parts = []
-        if direction == "ttb":
-            left = xy[0]
-            for line in lines:
-                parts.append(((left, top), anchor, line))
-                left += line_spacing
-        else:
-            widths = []
-            max_width: float = 0
-            for line in lines:
-                line_width = self.textlength(
-                    line,
-                    font,
-                    direction=direction,
-                    features=features,
-                    language=language,
-                    embedded_color=embedded_color,
-                )
-                widths.append(line_width)
-                max_width = max(max_width, line_width)
-
-            if anchor[1] == "m":
-                top -= (len(lines) - 1) * line_spacing / 2.0
-            elif anchor[1] == "d":
-                top -= (len(lines) - 1) * line_spacing
-
-            for idx, line in enumerate(lines):
-                left = xy[0]
-                width_difference = max_width - widths[idx]
-
-                # align by align parameter
-                if align in ("left", "justify"):
-                    pass
-                elif align == "center":
-                    left += width_difference / 2.0
-                elif align == "right":
-                    left += width_difference
-                else:
-                    msg = 'align must be "left", "center", "right" or "justify"'
-                    raise ValueError(msg)
-
-                if (
-                    align == "justify"
-                    and width_difference != 0
-                    and idx != len(lines) - 1
-                ):
-                    words = line.split(" " if isinstance(text, str) else b" ")
-                    if len(words) > 1:
-                        # align left by anchor
-                        if anchor[0] == "m":
-                            left -= max_width / 2.0
-                        elif anchor[0] == "r":
-                            left -= max_width
-
-                        word_widths = [
-                            self.textlength(
-                                word,
-                                font,
-                                direction=direction,
-                                features=features,
-                                language=language,
-                                embedded_color=embedded_color,
-                            )
-                            for word in words
-                        ]
-                        word_anchor = "l" + anchor[1]
-                        width_difference = max_width - sum(word_widths)
-                        for i, word in enumerate(words):
-                            parts.append(((left, top), word_anchor, word))
-                            left += word_widths[i] + width_difference / (len(words) - 1)
-                        top += line_spacing
-                        continue
-
-                # align left by anchor
-                if anchor[0] == "m":
-                    left -= width_difference / 2.0
-                elif anchor[0] == "r":
-                    left -= width_difference
-                parts.append(((left, top), anchor, line))
-                top += line_spacing
-
-        return font, parts
-
     def multiline_text(
         self,
         xy: tuple[float, float],
@@ -817,9 +679,10 @@ def multiline_text(
         *,
         font_size: float | None = None,
     ) -> None:
-        font, lines = self._prepare_multiline_text(
+        return self.text(
             xy,
             text,
+            fill,
             font,
             anchor,
             spacing,
@@ -828,25 +691,11 @@ def multiline_text(
             features,
             language,
             stroke_width,
+            stroke_fill,
             embedded_color,
-            font_size,
+            font_size=font_size,
         )
 
-        for xy, anchor, line in lines:
-            self.text(
-                xy,
-                line,
-                fill,
-                font,
-                anchor,
-                direction=direction,
-                features=features,
-                language=language,
-                stroke_width=stroke_width,
-                stroke_fill=stroke_fill,
-                embedded_color=embedded_color,
-            )
-
     def textlength(
         self,
         text: AnyStr,
@@ -864,17 +713,19 @@ def textlength(
         font_size: float | None = 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"
-            raise ValueError(msg)
-        if embedded_color and self.mode not in ("RGB", "RGBA"):
-            msg = "Embedded color supported only in RGB and RGBA modes"
-            raise ValueError(msg)
-
         if font is None:
             font = self._getfont(font_size)
-        mode = "RGBA" if embedded_color else self.fontmode
-        return font.getlength(text, mode, direction, features, language)
+        imagetext = ImageText.ImageText(
+            text,
+            font,
+            self.mode,
+            direction=direction,
+            features=features,
+            language=language,
+        )
+        if embedded_color:
+            imagetext.embed_color()
+        return imagetext.get_length()
 
     def textbbox(
         self,
@@ -898,33 +749,16 @@ def textbbox(
         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"
-            raise ValueError(msg)
-
         if font is None:
             font = self._getfont(font_size)
-
-        if self._multiline_check(text):
-            return self.multiline_textbbox(
-                xy,
-                text,
-                font,
-                anchor,
-                spacing,
-                align,
-                direction,
-                features,
-                language,
-                stroke_width,
-                embedded_color,
-            )
-
-        mode = "RGBA" if embedded_color else self.fontmode
-        bbox = font.getbbox(
-            text, mode, direction, features, language, stroke_width, anchor
+        imagetext = ImageText.ImageText(
+            text, font, self.mode, spacing, direction, features, language
         )
-        return bbox[0] + xy[0], bbox[1] + xy[1], bbox[2] + xy[0], bbox[3] + xy[1]
+        if embedded_color:
+            imagetext.embed_color()
+        if stroke_width:
+            imagetext.stroke(stroke_width)
+        return imagetext.get_bbox(xy, anchor, align)
 
     def multiline_textbbox(
         self,
@@ -947,7 +781,7 @@ def multiline_textbbox(
         *,
         font_size: float | None = None,
     ) -> tuple[float, float, float, float]:
-        font, lines = self._prepare_multiline_text(
+        return self.textbbox(
             xy,
             text,
             font,
@@ -959,37 +793,9 @@ def multiline_textbbox(
             language,
             stroke_width,
             embedded_color,
-            font_size,
+            font_size=font_size,
         )
 
-        bbox: tuple[float, float, float, float] | None = None
-
-        for xy, anchor, line in lines:
-            bbox_line = self.textbbox(
-                xy,
-                line,
-                font,
-                anchor,
-                direction=direction,
-                features=features,
-                language=language,
-                stroke_width=stroke_width,
-                embedded_color=embedded_color,
-            )
-            if bbox is None:
-                bbox = bbox_line
-            else:
-                bbox = (
-                    min(bbox[0], bbox_line[0]),
-                    min(bbox[1], bbox_line[1]),
-                    max(bbox[2], bbox_line[2]),
-                    max(bbox[3], bbox_line[3]),
-                )
-
-        if bbox is None:
-            return xy[0], xy[1], xy[0], xy[1]
-        return bbox
-
 
 def Draw(im: Image.Image, mode: str | None = None) -> ImageDraw:
     """
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
new file mode 100644
index 00000000000..9bb31a1c8c0
--- /dev/null
+++ b/src/PIL/ImageText.py
@@ -0,0 +1,318 @@
+from __future__ import annotations
+
+from . import ImageFont
+from ._typing import _Ink
+
+
+class ImageText:
+    def __init__(
+        self,
+        text: str | bytes,
+        font: (
+            ImageFont.ImageFont
+            | ImageFont.FreeTypeFont
+            | ImageFont.TransposedFont
+            | None
+        ) = None,
+        mode: str = "RGB",
+        spacing: float = 4,
+        direction: str | None = None,
+        features: list[str] | None = None,
+        language: str | None = None,
+    ) -> None:
+        """
+        :param text: String to be drawn.
+        :param font: Either an :py:class:`~PIL.ImageFont.ImageFont` instance,
+                     :py:class:`~PIL.ImageFont.FreeTypeFont` instance,
+                     :py:class:`~PIL.ImageFont.TransposedFont` instance or ``None``. If
+                     ``None``, the default font from :py:meth:`.ImageFont.load_default`
+                     will be used.
+        :param mode: The image mode this will be used with.
+        :param spacing: The number of pixels between lines.
+        :param direction: Direction of the text. It can be ``"rtl"`` (right to left),
+                          ``"ltr"`` (left to right) or ``"ttb"`` (top to bottom).
+                          Requires libraqm.
+        :param features: A list of OpenType font features to be used during text
+                         layout. This is usually used to turn on optional font features
+                         that are not enabled by default, for example ``"dlig"`` or
+                         ``"ss01"``, but can be also used to turn off default font
+                         features, for example ``"-liga"`` to disable ligatures or
+                         ``"-kern"`` to disable kerning.  To get all supported
+                         features, see `OpenType docs`_.
+                         Requires libraqm.
+        :param language: Language of the text. Different languages may use
+                         different glyph shapes or ligatures. This parameter tells
+                         the font which language the text is in, and to apply the
+                         correct substitutions as appropriate, if available.
+                         It should be a `BCP 47 language code`_.
+                         Requires libraqm.
+        """
+        self.text = text
+        self.font = font or ImageFont.load_default()
+
+        self.mode = mode
+        self.spacing = spacing
+        self.direction = direction
+        self.features = features
+        self.language = language
+
+        self.embedded_color = False
+
+        self.stroke_width: float = 0
+        self.stroke_fill: _Ink | None = None
+
+    def embed_color(self) -> None:
+        """
+        Use embedded color glyphs (COLR, CBDT, SBIX).
+        """
+        if self.mode not in ("RGB", "RGBA"):
+            msg = "Embedded color supported only in RGB and RGBA modes"
+            raise ValueError(msg)
+        self.embedded_color = True
+
+    def stroke(self, width: float = 0, fill: _Ink | None = None) -> None:
+        """
+        :param width: The width of the text stroke.
+        :param fill: Color to use for the text stroke when drawing. If not given, will
+                     default to the ``fill`` parameter from
+                     :py:meth:`.ImageDraw.ImageDraw.text`.
+        """
+        self.stroke_width = width
+        self.stroke_fill = fill
+
+    def _get_fontmode(self) -> str:
+        if self.mode in ("1", "P", "I", "F"):
+            return "1"
+        elif self.embedded_color:
+            return "RGBA"
+        else:
+            return "L"
+
+    def get_length(self):
+        """
+        Returns length (in pixels with 1/64 precision) of text.
+
+        This is the amount by which following text should be offset.
+        Text bounding box may extend past the length in some fonts,
+        e.g. when using italics or accents.
+
+        The result is returned as a float; it is a whole number if using basic layout.
+
+        Note that the sum of two lengths may not equal the length of a concatenated
+        string due to kerning. If you need to adjust for kerning, include the following
+        character and subtract its length.
+
+        For example, instead of::
+
+            hello = ImageText.ImageText("Hello", font).get_length()
+            world = ImageText.ImageText("World", font).get_length()
+            helloworld = ImageText.ImageText("HelloWorld", font).get_length()
+            assert hello + world == helloworld
+
+        use::
+
+            hello = (
+                ImageText.ImageText("HelloW", font).get_length() -
+                ImageText.ImageText("W", font).get_length()
+            )  # adjusted for kerning
+            world = ImageText.ImageText("World", font).get_length()
+            helloworld = ImageText.ImageText("HelloWorld", font).get_length()
+            assert hello + world == helloworld
+
+        or disable kerning with (requires libraqm)::
+
+            hello = ImageText.ImageText("Hello", font, features=["-kern"]).get_length()
+            world = ImageText.ImageText("World", font, features=["-kern"]).get_length()
+            helloworld = ImageText.ImageText(
+                "HelloWorld", font, features=["-kern"]
+            ).get_length()
+            assert hello + world == helloworld
+
+        :return: Either width for horizontal text, or height for vertical text.
+        """
+        split_character = "\n" if isinstance(self.text, str) else b"\n"
+        if split_character in self.text:
+            msg = "can't measure length of multiline text"
+            raise ValueError(msg)
+        return self.font.getlength(
+            self.text,
+            self._get_fontmode(),
+            self.direction,
+            self.features,
+            self.language,
+        )
+
+    def _split(
+        self, xy: tuple[float, float], anchor: str | None, align: str
+    ) -> list[tuple[tuple[float, float], str, str | bytes]]:
+        if anchor is None:
+            anchor = "lt" if self.direction == "ttb" else "la"
+        elif len(anchor) != 2:
+            msg = "anchor must be a 2 character string"
+            raise ValueError(msg)
+
+        lines = (
+            self.text.split("\n")
+            if isinstance(self.text, str)
+            else self.text.split(b"\n")
+        )
+        if len(lines) == 1:
+            return [(xy, anchor, self.text)]
+
+        if anchor[1] in "tb" and self.direction != "ttb":
+            msg = "anchor not supported for multiline text"
+            raise ValueError(msg)
+
+        fontmode = self._get_fontmode()
+        line_spacing = (
+            self.font.getbbox(
+                "A",
+                fontmode,
+                None,
+                self.features,
+                self.language,
+                self.stroke_width,
+            )[3]
+            + self.stroke_width
+            + self.spacing
+        )
+
+        top = xy[1]
+        parts = []
+        if self.direction == "ttb":
+            left = xy[0]
+            for line in lines:
+                parts.append(((left, top), anchor, line))
+                left += line_spacing
+        else:
+            widths = []
+            max_width: float = 0
+            for line in lines:
+                line_width = self.font.getlength(
+                    line, fontmode, self.direction, self.features, self.language
+                )
+                widths.append(line_width)
+                max_width = max(max_width, line_width)
+
+            if anchor[1] == "m":
+                top -= (len(lines) - 1) * line_spacing / 2.0
+            elif anchor[1] == "d":
+                top -= (len(lines) - 1) * line_spacing
+
+            idx = -1
+            for line in lines:
+                left = xy[0]
+                idx += 1
+                width_difference = max_width - widths[idx]
+
+                # align by align parameter
+                if align in ("left", "justify"):
+                    pass
+                elif align == "center":
+                    left += width_difference / 2.0
+                elif align == "right":
+                    left += width_difference
+                else:
+                    msg = 'align must be "left", "center", "right" or "justify"'
+                    raise ValueError(msg)
+
+                if (
+                    align == "justify"
+                    and width_difference != 0
+                    and idx != len(lines) - 1
+                ):
+                    words = (
+                        line.split(" ") if isinstance(line, str) else line.split(b" ")
+                    )
+                    if len(words) > 1:
+                        # align left by anchor
+                        if anchor[0] == "m":
+                            left -= max_width / 2.0
+                        elif anchor[0] == "r":
+                            left -= max_width
+
+                        word_widths = [
+                            self.font.getlength(
+                                word,
+                                fontmode,
+                                self.direction,
+                                self.features,
+                                self.language,
+                            )
+                            for word in words
+                        ]
+                        word_anchor = "l" + anchor[1]
+                        width_difference = max_width - sum(word_widths)
+                        i = 0
+                        for word in words:
+                            parts.append(((left, top), word_anchor, word))
+                            left += word_widths[i] + width_difference / (len(words) - 1)
+                            i += 1
+                        top += line_spacing
+                        continue
+
+                # align left by anchor
+                if anchor[0] == "m":
+                    left -= width_difference / 2.0
+                elif anchor[0] == "r":
+                    left -= width_difference
+                parts.append(((left, top), anchor, line))
+                top += line_spacing
+
+        return parts
+
+    def get_bbox(
+        self,
+        xy: tuple[float, float] = (0, 0),
+        anchor: str | None = None,
+        align: str = "left",
+    ) -> tuple[float, float, float, float]:
+        """
+        Returns bounding box (in pixels) of text.
+
+        Use :py:meth:`get_length` to get the offset of following text with 1/64 pixel
+        precision. The bounding box includes extra margins for some fonts, e.g. italics
+        or accents.
+
+        :param xy: The anchor coordinates of the text.
+        :param anchor: The text anchor alignment. Determines the relative location of
+                       the anchor to the text. The default alignment is top left,
+                       specifically ``la`` for horizontal text and ``lt`` for
+                       vertical text. See :ref:`text-anchors` for details.
+        :param align: For multiline text, ``"left"``, ``"center"``, ``"right"`` or
+                      ``"justify"`` determines the relative alignment of lines. Use the
+                      ``anchor`` parameter to specify the alignment to ``xy``.
+
+        :return: ``(left, top, right, bottom)`` bounding box
+        """
+        bbox: tuple[float, float, float, float] | None = None
+        fontmode = self._get_fontmode()
+        for xy, anchor, line in self._split(xy, anchor, align):
+            bbox_line = self.font.getbbox(
+                line,
+                fontmode,
+                self.direction,
+                self.features,
+                self.language,
+                self.stroke_width,
+                anchor,
+            )
+            bbox_line = (
+                bbox_line[0] + xy[0],
+                bbox_line[1] + xy[1],
+                bbox_line[2] + xy[0],
+                bbox_line[3] + xy[1],
+            )
+            if bbox is None:
+                bbox = bbox_line
+            else:
+                bbox = (
+                    min(bbox[0], bbox_line[0]),
+                    min(bbox[1], bbox_line[1]),
+                    max(bbox[2], bbox_line[2]),
+                    max(bbox[3], bbox_line[3]),
+                )
+
+        if bbox is None:
+            return xy[0], xy[1], xy[0], xy[1]
+        return bbox
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index 373938e71e0..685c425d5e8 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -38,6 +38,8 @@ def __class_getitem__(cls, item: Any) -> type[bool]:
                 return bool
 
 
+_Ink = Union[float, tuple[int, ...], str]
+
 Coords = Union[Sequence[float], Sequence[Sequence[float]]]
 
 

From 969e4687497d447581e950ed26043a988f50e21b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 21 Jul 2025 13:07:38 +1000
Subject: [PATCH 1961/2374] Allow ImageDraw text() to use ImageText

---
 Tests/test_imagetext.py      | 35 +++++++++++++++++++++++++++++++++--
 docs/reference/ImageText.rst |  6 +++++-
 src/PIL/ImageDraw.py         | 23 +++++++++++++----------
 3 files changed, 51 insertions(+), 13 deletions(-)

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
index 3a3a58975d1..b58d048b5df 100644
--- a/Tests/test_imagetext.py
+++ b/Tests/test_imagetext.py
@@ -2,9 +2,9 @@
 
 import pytest
 
-from PIL import ImageFont, ImageText
+from PIL import Image, ImageDraw, ImageFont, ImageText
 
-from .helper import skip_unless_feature
+from .helper import assert_image_similar_tofile, skip_unless_feature
 
 FONT_PATH = "Tests/fonts/FreeMono.ttf"
 
@@ -39,3 +39,34 @@ def test_get_bbox(font: ImageFont.FreeTypeFont) -> None:
     assert ImageText.ImageText("M", font).get_bbox() == (0, 4, 12, 16)
     assert ImageText.ImageText("y", font).get_bbox() == (0, 7, 12, 20)
     assert ImageText.ImageText("a", font).get_bbox() == (0, 7, 12, 16)
+
+
+def test_standard_embedded_color(layout_engine: ImageFont.Layout) -> None:
+    font = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
+    text = ImageText.ImageText("Hello World!", font)
+    text.embed_color()
+
+    im = Image.new("RGB", (300, 64), "white")
+    draw = ImageDraw.Draw(im)
+    draw.text((10, 10), text, "#fa6")
+
+    assert_image_similar_tofile(im, "Tests/images/standard_embedded.png", 3.1)
+
+
+@skip_unless_feature("freetype2")
+def test_stroke() -> None:
+    for suffix, stroke_fill in {"same": None, "different": "#0f0"}.items():
+        # Arrange
+        im = Image.new("RGB", (120, 130))
+        draw = ImageDraw.Draw(im)
+        font = ImageFont.truetype(FONT_PATH, 120)
+        text = ImageText.ImageText("A", font)
+        text.stroke(2, stroke_fill)
+
+        # Act
+        draw.text((12, 12), text, "#f00")
+
+        # Assert
+        assert_image_similar_tofile(
+            im, "Tests/images/imagedraw_stroke_" + suffix + ".png", 3.1
+        )
diff --git a/docs/reference/ImageText.rst b/docs/reference/ImageText.rst
index ad5439751f9..fa55b4f306e 100644
--- a/docs/reference/ImageText.rst
+++ b/docs/reference/ImageText.rst
@@ -6,7 +6,7 @@
 
 The :py:mod:`~PIL.ImageText` module defines a class with the same name. Instances of
 this class provide a way to use fonts with text strings or bytes. The result is a
-simple API to apply styling to pieces of text and measure them.
+simple API to apply styling to pieces of text and measure or draw them.
 
 Example
 -------
@@ -23,6 +23,10 @@ Example
     print(text.get_length())  # 154.0
     print(text.get_bbox())  # (-2, 3, 156, 22)
 
+    im = Image.new("RGB", text.get_bbox()[2:])
+    d = ImageDraw.Draw(im)
+    d.text((0, 0), text, "#f00")
+
 Methods
 -------
 
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 35ecbfb78b4..852e0269849 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -537,7 +537,7 @@ def draw_corners(pieslice: bool) -> None:
     def text(
         self,
         xy: tuple[float, float],
-        text: AnyStr,
+        text: AnyStr | ImageText.ImageText,
         fill: _Ink | None = None,
         font: (
             ImageFont.ImageFont
@@ -558,15 +558,18 @@ def text(
         **kwargs: Any,
     ) -> None:
         """Draw text."""
-        if font is None:
-            font = self._getfont(kwargs.get("font_size"))
-        imagetext = ImageText.ImageText(
-            text, font, self.mode, spacing, direction, features, language
-        )
-        if embedded_color:
-            imagetext.embed_color()
-        if stroke_width:
-            imagetext.stroke(stroke_width, stroke_fill)
+        if isinstance(text, ImageText.ImageText):
+            imagetext = text
+        else:
+            if font is None:
+                font = self._getfont(kwargs.get("font_size"))
+            imagetext = ImageText.ImageText(
+                text, font, self.mode, spacing, direction, features, language
+            )
+            if embedded_color:
+                imagetext.embed_color()
+            if stroke_width:
+                imagetext.stroke(stroke_width, stroke_fill)
 
         def getink(fill: _Ink | None) -> int:
             ink, fill_ink = self._getink(fill)

From 63163d065d632cb75466d554fb1d6ea27cc43577 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 17 Jul 2025 19:59:47 +1000
Subject: [PATCH 1962/2374] Removed WebP feature handling

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

diff --git a/Tests/test_features.py b/Tests/test_features.py
index 520c25b4645..7af3fffeafe 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -18,11 +18,7 @@ def test_check() -> None:
     for codec in features.codecs:
         assert features.check_codec(codec) == features.check(codec)
     for feature in features.features:
-        if "webp" in feature:
-            with pytest.warns(DeprecationWarning, match="webp"):
-                assert features.check_feature(feature) == features.check(feature)
-        else:
-            assert features.check_feature(feature) == features.check(feature)
+        assert features.check_feature(feature) == features.check(feature)
 
 
 def test_version() -> None:
@@ -48,11 +44,7 @@ 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:
-        if "webp" in feature:
-            with pytest.warns(DeprecationWarning, match="webp"):
-                test(feature, features.version_feature)
-        else:
-            test(feature, features.version_feature)
+        test(feature, features.version_feature)
 
 
 @skip_unless_feature("libjpeg_turbo")

From ec6d5efe4d02dc6d68e569abfd7523e21a89539f Mon Sep 17 00:00:00 2001
From: Luke Granger-Brown <lukegb@google.com>
Date: Sat, 26 Jul 2025 08:33:11 +0100
Subject: [PATCH 1963/2374] Deprecate ImageCmsProfile product_name and
 product_info (#8995)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_imagecms.py       | 14 ++++++++++++++
 docs/deprecations.rst        |  9 +++++++++
 docs/releasenotes/12.0.0.rst |  8 +++++---
 src/PIL/ImageCms.py          | 14 ++++++++++----
 4 files changed, 38 insertions(+), 7 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 55a4a87fb2f..8b5d88ac883 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -690,3 +690,17 @@ 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:
+    profile = ImageCmsProfile(ImageCms.createProfile("sRGB"))
+    with pytest.warns(
+        DeprecationWarning, match="ImageCms.ImageCmsProfile.product_name"
+    ):
+        profile.product_name
+    with pytest.warns(
+        DeprecationWarning, match="ImageCms.ImageCmsProfile.product_info"
+    ):
+        profile.product_info
+    with pytest.raises(AttributeError):
+        profile.this_attribute_does_not_exist
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 4e65dc8078a..3f95cf7f545 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -52,6 +52,15 @@ another mode before saving::
     im = Image.new("I", (1, 1))
     im.convert("I;16").save("out.png")
 
+ImageCms.ImageCmsProfile.product_name and .product_info
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. deprecated:: 12.0.0
+
+``ImageCms.ImageCmsProfile.product_name`` and the corresponding
+``.product_info`` attributes have been deprecated, and will be removed in
+Pillow 13 (2026-10-15). They have been set to ``None`` since Pillow 2.3.0.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index 68b6644438f..6c0cd4dba01 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -110,10 +110,12 @@ vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 Deprecations
 ============
 
-TODO
-^^^^
+ImageCms.ImageCmsProfile.product_name and .product_info
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+``ImageCms.ImageCmsProfile.product_name`` and the corresponding
+``.product_info`` attributes have been deprecated, and will be removed in
+Pillow 13 (2026-10-15). They have been set to ``None`` since Pillow 2.3.0.
 
 API changes
 ===========
diff --git a/src/PIL/ImageCms.py b/src/PIL/ImageCms.py
index d3555694a51..513e28acf33 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,9 +23,10 @@
 import sys
 from enum import IntEnum, IntFlag
 from functools import reduce
-from typing import Literal, SupportsFloat, SupportsInt, Union
+from typing import Any, Literal, SupportsFloat, SupportsInt, Union
 
 from . import Image
+from ._deprecate import deprecate
 from ._typing import SupportsRead
 
 try:
@@ -233,9 +234,7 @@ def __init__(self, profile: str | SupportsRead[bytes] | core.CmsProfile) -> None
             low-level profile object
 
         """
-        self.filename = None
-        self.product_name = None  # profile.product_name
-        self.product_info = None  # profile.product_info
+        self.filename: str | None = None
 
         if isinstance(profile, str):
             if sys.platform == "win32":
@@ -256,6 +255,13 @@ def __init__(self, profile: str | SupportsRead[bytes] | core.CmsProfile) -> None
             msg = "Invalid type for Profile"  # type: ignore[unreachable]
             raise TypeError(msg)
 
+    def __getattr__(self, name: str) -> Any:
+        if name in ("product_name", "product_info"):
+            deprecate(f"ImageCms.ImageCmsProfile.{name}", 13)
+            return None
+        msg = f"'{self.__class__.__name__}' object has no attribute '{name}'"
+        raise AttributeError(msg)
+
     def tobytes(self) -> bytes:
         """
         Returns the profile in a format suitable for embedding in

From 7afbafd1e2ae9a3fe822b422cebe94092ad68b9c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Jul 2025 19:21:50 +1000
Subject: [PATCH 1964/2374] Support saving variable length rational TIFF tags

---
 Tests/test_file_libtiff.py | 12 ++++++++++++
 src/encode.c               | 12 ++++++++++++
 2 files changed, 24 insertions(+)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 958e2749f61..d4d50e5b4a2 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -355,6 +355,18 @@ def test_subifd(self, tmp_path: Path) -> None:
             # Should not segfault
             im.save(outfile)
 
+    def test_whitepoint_tag(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
+
+        out = tmp_path / "temp.tif"
+        hopper().save(out, tiffinfo={318: (0.3127, 0.3289)})
+
+        with Image.open(out) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
+            assert reloaded.tag_v2[318] == pytest.approx((0.3127, 0.3289))
+
     def test_xmlpacket_tag(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
     ) -> None:
diff --git a/src/encode.c b/src/encode.c
index e56494036ff..a8da323188f 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -922,6 +922,18 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                     );
                     free(av);
                 }
+            } else if (type == TIFF_RATIONAL) {
+                FLOAT32 *av;
+                /* malloc check ok, calloc checks for overflow */
+                av = calloc(len, sizeof(FLOAT32));
+                if (av) {
+                    for (i = 0; i < len; i++) {
+                        av[i] = (FLOAT32)PyFloat_AsDouble(PyTuple_GetItem(value, i));
+                    }
+                    status =
+                        ImagingLibTiffSetField(&encoder->state, (ttag_t)key_int, av);
+                    free(av);
+                }
             }
         } else {
             if (type == TIFF_SHORT) {

From 7dbcb32cbe524a8ec4c12f21c762cd7153b2b03b Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 26 Jul 2025 19:32:57 +1000
Subject: [PATCH 1965/2374] Update cygwin/cygwin-install-action action to v6
 (#9108)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/test-cygwin.yml | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
index abfeaa77f9c..581cd63704b 100644
--- a/.github/workflows/test-cygwin.yml
+++ b/.github/workflows/test-cygwin.yml
@@ -52,7 +52,7 @@ jobs:
           persist-credentials: false
 
       - name: Install Cygwin
-        uses: cygwin/cygwin-install-action@v5
+        uses: cygwin/cygwin-install-action@v6
         with:
           packages: >
             gcc-g++
@@ -89,10 +89,6 @@ jobs:
         with:
           dirs: 'C:\cygwin\bin;C:\cygwin\lib\lapack'
 
-      - name: Select Python version
-        run: |
-          ln -sf c:/cygwin/bin/python3.${{ matrix.python-minor-version }} c:/cygwin/bin/python3
-
       - name: pip cache
         uses: actions/cache@v4
         with:

From 53b6d57b730a68ea58680483f8628c5e25301a1e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Jul 2025 19:39:54 +1000
Subject: [PATCH 1966/2374] Drop support for PyPy3.10

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 6d8acc44f25..766c506e761 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.11", "pypy3.10", "3.10", "3.11", "3.12", ">=3.13.5", "3.14"]
+        python-version: ["pypy3.11", "3.10", "3.11", "3.12", ">=3.13.5", "3.14"]
         architecture: ["x64"]
         include:
             # Test the oldest Python on 32-bit
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index b4b5162281c..d18023dbc97 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -42,7 +42,6 @@ jobs:
         ]
         python-version: [
           "pypy3.11",
-          "pypy3.10",
           "3.14t",
           "3.14",
           "3.13t",

From a6acc67660f4d2a157341c05d11e47e36c79802d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Jul 2025 21:00:26 +1000
Subject: [PATCH 1967/2374] Always check XMLPacket value

---
 Tests/test_file_libtiff.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 958e2749f61..f61f79f1704 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -365,8 +365,7 @@ def test_xmlpacket_tag(
 
         with Image.open(out) as reloaded:
             assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
-            if 700 in reloaded.tag_v2:
-                assert reloaded.tag_v2[700] == b"xmlpacket tag"
+            assert reloaded.tag_v2[700] == b"xmlpacket tag"
 
     def test_int_dpi(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
         # issue #1765

From 283dcfc024113f6d0d8bcbb216d1735cb05a16e6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Jul 2025 23:39:11 +1000
Subject: [PATCH 1968/2374] Removed unused code

---
 src/decode.c | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/decode.c b/src/decode.c
index 03db1ce3516..e7a6e632370 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -870,8 +870,6 @@ PyImaging_Jpeg2KDecoderNew(PyObject *self, PyObject *args) {
 
     if (strcmp(format, "j2k") == 0) {
         codec_format = OPJ_CODEC_J2K;
-    } else if (strcmp(format, "jpt") == 0) {
-        codec_format = OPJ_CODEC_JPT;
     } else if (strcmp(format, "jp2") == 0) {
         codec_format = OPJ_CODEC_JP2;
     } else {

From 98d38a3bffe572459939cbb6ab730229b4a5a833 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 28 Jul 2025 18:52:06 +1000
Subject: [PATCH 1969/2374] Updated libpng to 1.6.50 (#9058)

---
 .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 6b5aedb697f..4519271b9d3 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -95,7 +95,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # you change those versions, ensure the patch is also updated.
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=11.2.1
-LIBPNG_VERSION=1.6.49
+LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.1
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.8.1
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 2307fc8b294..fbff0daf2b2 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.3.4",
-    "LIBPNG": "1.6.49",
+    "LIBPNG": "1.6.50",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.3",
     "TIFF": "4.7.0",

From e8b3c17ebc90f36c8ec326e765246814c21f1f48 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 29 Jul 2025 07:28:03 +1000
Subject: [PATCH 1970/2374] Updated documentation

---
 docs/deprecations.rst        |  7 +++++--
 docs/releasenotes/11.3.0.rst |  7 +++++++
 docs/releasenotes/12.0.0.rst | 10 +++++++---
 src/PIL/Image.py             |  3 ++-
 4 files changed, 21 insertions(+), 6 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 2365545656f..851f3e8d811 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -42,8 +42,11 @@ Image.fromarray mode parameter
 
 .. deprecated:: 11.3.0
 
-The ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` has been deprecated. The
-mode can be automatically determined from the object's shape and type instead.
+Using the ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` to change data types
+has been deprecated. Since pixel values do not contain information about palettes or
+color spaces, the parameter can still be used to place grayscale L mode data within a
+P mode image, or read RGB data as YCbCr for example. If omitted, the mode will be
+automatically determined from the object's shape and type.
 
 Saving I mode images as PNG
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/docs/releasenotes/11.3.0.rst b/docs/releasenotes/11.3.0.rst
index 409d50295dd..5c04a037316 100644
--- a/docs/releasenotes/11.3.0.rst
+++ b/docs/releasenotes/11.3.0.rst
@@ -29,6 +29,13 @@ Image.fromarray mode parameter
 The ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` has been deprecated. The
 mode can be automatically determined from the object's shape and type instead.
 
+.. note::
+
+    Since pixel values do not contain information about palettes or color spaces, part
+    of this functionality was restored in Pillow 12.0.0. The parameter can be used to
+    place grayscale L mode data within a P mode image, or read RGB data as YCbCr for
+    example.
+
 Saving I mode images as PNG
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index 68b6644438f..19508b08a8a 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -134,7 +134,11 @@ TODO
 Other changes
 =============
 
-TODO
-^^^^
+Image.fromarray mode parameter
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+In Pillow 11.3.0, the ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` was
+deprecated. Part of this functionality has been restored in Pillow 12.0.0. Since pixel
+values do not contain information about palettes or color spaces, the parameter can be
+used to place grayscale L mode data within a P mode image, or read RGB data as YCbCr
+for example.
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index c98630cc24f..20917b1a414 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3253,7 +3253,8 @@ def fromarray(obj: SupportsArrayInterface, mode: str | None = None) -> Image:
     :param obj: Object with array interface
     :param mode: Optional mode to use when reading ``obj``. Since pixel values do not
       contain information about palettes or color spaces, this can be used to place
-      grayscale L mode data within a P mode image, or read RGB data as YCbCr.
+      grayscale L mode data within a P mode image, or read RGB data as YCbCr for
+      example.
 
       See: :ref:`concept-modes` for general information about modes.
     :returns: An image object.

From bae97e1a2b75a1e3c01efc168d10b8d7ecdf3392 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 30 Jul 2025 21:50:45 +1000
Subject: [PATCH 1971/2374] Update dependency cibuildwheel to v3.1.2 (#9118)

---
 .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 e1eb52eb8ae..823671828f7 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.0.1
+cibuildwheel==3.1.2

From ba5f81fb6b4bd143b2ceba6875b33870eaa366ce Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 30 Jul 2025 15:23:39 +0300
Subject: [PATCH 1972/2374] Add support for Python 3.14 (#9120)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 docs/installation/newer-versions.csv | 19 ++++++++++---------
 docs/releasenotes/12.0.0.rst         | 10 +++++++---
 pyproject.toml                       |  3 ++-
 3 files changed, 19 insertions(+), 13 deletions(-)

diff --git a/docs/installation/newer-versions.csv b/docs/installation/newer-versions.csv
index 19816af58da..e948dd5400e 100644
--- a/docs/installation/newer-versions.csv
+++ b/docs/installation/newer-versions.csv
@@ -1,9 +1,10 @@
-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,,,,
-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,,
-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.14,3.13,3.12,3.11,3.10,3.9,3.8,3.7,3.6,3.5
+Pillow 12,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,,
+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/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index 6c0cd4dba01..46cf64cf1f7 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -136,7 +136,11 @@ TODO
 Other changes
 =============
 
-TODO
-^^^^
+Python 3.14
+^^^^^^^^^^^
 
-TODO
+Pillow 11.3.0 had wheels built against Python 3.14 beta, available as a preview to help
+others prepare for 3.14, and to ensure Pillow could be used immediately at the release
+of 3.14.0 final (2025-10-07, :pep:`745`).
+
+Pillow 12.0.0 now officially supports Python 3.14.
diff --git a/pyproject.toml b/pyproject.toml
index 4e8623118ba..3693ddb8da0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -29,6 +29,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Python :: Implementation :: CPython",
   "Programming Language :: Python :: Implementation :: PyPy",
   "Topic :: Multimedia :: Graphics",
@@ -206,7 +207,7 @@ lint.isort.required-imports = [
 ]
 
 [tool.pyproject-fmt]
-max_supported_python = "3.13"
+max_supported_python = "3.14"
 
 [tool.pytest.ini_options]
 addopts = "-ra --color=auto"

From 98d6c3bf8818849e2414ef4de8c9e02b03de3886 Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Fri, 1 Aug 2025 08:22:28 +0800
Subject: [PATCH 1973/2374] Restore pyroma test for iOS (#9116)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_image_access.py |  6 +++++-
 Tests/test_pyroma.py       | 25 ++++++++++++++++++++++++-
 pyproject.toml             |  2 +-
 3 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index a847264d27e..07c12594a8c 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -317,4 +317,8 @@ def test_embeddable(self) -> None:
         assert process.returncode == 0
 
     def teardown_method(self) -> None:
-        os.remove("embed_pil.c")
+        try:
+            os.remove("embed_pil.c")
+        except FileNotFoundError:
+            # If the test was skipped or failed, the file won't exist
+            pass
diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index c2f7fe22ecb..35f3fd076da 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from importlib.metadata import metadata
+
 import pytest
 
 from PIL import __version__
@@ -7,9 +9,30 @@
 pyroma = pytest.importorskip("pyroma", reason="Pyroma not installed")
 
 
+def map_metadata_keys(metadata):
+    # Convert installed wheel metadata into canonical Core Metadata 2.4 format.
+    # This was a utility method in pyroma 4.3.3; it was removed in 5.0.
+    # This implementation is constructed from the relevant logic from
+    # Pyroma 5.0's `build_metadata()` implementation. This has been submitted
+    # upstream to Pyroma as https://github.com/regebro/pyroma/pull/116,
+    # so it may be possible to simplify this test in future.
+    data = {}
+    for key in set(metadata.keys()):
+        value = metadata.get_all(key)
+        key = pyroma.projectdata.normalize(key)
+
+        if len(value) == 1:
+            value = value[0]
+            if value.strip() == "UNKNOWN":
+                continue
+
+        data[key] = value
+    return data
+
+
 def test_pyroma() -> None:
     # Arrange
-    data = pyroma.projectdata.get_data(".")
+    data = map_metadata_keys(metadata("Pillow"))
 
     # Act
     rating = pyroma.ratings.rate(data)
diff --git a/pyproject.toml b/pyproject.toml
index 3693ddb8da0..4980a9cb880 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -68,7 +68,7 @@ optional-dependencies.tests = [
   "markdown2",
   "olefile",
   "packaging",
-  "pyroma",
+  "pyroma>=5",
   "pytest",
   "pytest-cov",
   "pytest-timeout",

From 19829c3d95e9ee581d5ecd3f46e6c0af878482f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 28 Jul 2025 18:55:45 +1000
Subject: [PATCH 1974/2374] Updated harfbuzz to 11.3.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 4519271b9d3..f2b9a7f40cb 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -94,7 +94,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # annotations have a source code patch that is required for some platforms. If
 # you change those versions, ensure the patch is also updated.
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=11.2.1
+HARFBUZZ_VERSION=11.3.3
 LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.1
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index fbff0daf2b2..7067fc3c432 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "11.2.1",
+    "HARFBUZZ": "11.3.3",
     "JPEGTURBO": "3.1.1",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",

From 27a7582b3541ad92df9900c2a9edcfe91c44a313 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Aug 2025 11:40:35 +1000
Subject: [PATCH 1975/2374] Moved imports into TYPE_CHECKING

---
 Tests/test_imagecms.py       |  5 ++++-
 src/PIL/GimpPaletteFile.py   |  5 ++++-
 src/PIL/Image.py             | 11 ++++++++---
 src/PIL/Jpeg2KImagePlugin.py |  8 ++++++--
 src/PIL/JpegImagePlugin.py   |  3 ++-
 src/PIL/PngImagePlugin.py    |  6 ++++--
 src/PIL/WebPImagePlugin.py   |  4 +++-
 7 files changed, 31 insertions(+), 11 deletions(-)

diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 8b5d88ac883..46c1baa2d13 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, Literal, cast
+from typing import Literal, cast
 
 import pytest
 
@@ -31,6 +31,9 @@
     # Skipped via setup_module()
     pass
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Any
 
 SRGB = "Tests/icc/sRGB_IEC61966-2-1_black_scaled.icc"
 HAVE_PROFILE = os.path.exists(SRGB)
diff --git a/src/PIL/GimpPaletteFile.py b/src/PIL/GimpPaletteFile.py
index 379ffd73918..016257d3dd2 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -17,7 +17,10 @@
 
 import re
 from io import BytesIO
-from typing import IO
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import IO
 
 
 class GimpPaletteFile:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 262b5478b62..b7c185e0d6e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -38,10 +38,9 @@
 import sys
 import tempfile
 import warnings
-from collections.abc import Callable, Iterator, MutableMapping, Sequence
+from collections.abc import MutableMapping
 from enum import IntEnum
-from types import ModuleType
-from typing import IO, Any, Literal, Protocol, cast
+from typing import IO, Protocol, cast
 
 # VERSION was removed in Pillow 6.0.0.
 # PILLOW_VERSION was removed in Pillow 9.0.0.
@@ -64,6 +63,12 @@
 except ImportError:
     ElementTree = None
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable, Iterator, Sequence
+    from types import ModuleType
+    from typing import Any, Literal
+
 logger = logging.getLogger(__name__)
 
 
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index e0f4ecae595..4c85dd4e281 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,11 +18,15 @@
 import io
 import os
 import struct
-from collections.abc import Callable
-from typing import IO, cast
+from typing import cast
 
 from . import Image, ImageFile, ImagePalette, _binary
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+    from typing import IO
+
 
 class BoxReader:
     """
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index efe8eff3b29..0d110035e1a 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -42,7 +42,6 @@
 import sys
 import tempfile
 import warnings
-from typing import IO, Any
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -53,6 +52,8 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
+    from typing import IO, Any
+
     from .MpoImagePlugin import MpoImageFile
 
 #
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 1b9a89aef0d..d0f22f812e5 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -38,9 +38,8 @@
 import struct
 import warnings
 import zlib
-from collections.abc import Callable
 from enum import IntEnum
-from typing import IO, Any, NamedTuple, NoReturn, cast
+from typing import IO, NamedTuple, cast
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
 from ._binary import i16be as i16
@@ -53,6 +52,9 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
+    from collections.abc import Callable
+    from typing import Any, NoReturn
+
     from . import _imaging
 
 logger = logging.getLogger(__name__)
diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 1716a18ccda..2847fed20a0 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 from io import BytesIO
-from typing import IO, Any
 
 from . import Image, ImageFile
 
@@ -12,6 +11,9 @@
 except ImportError:
     SUPPORTED = False
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import IO, Any
 
 _VP8_MODES_BY_IDENTIFIER = {
     b"VP8 ": "RGB",

From 0620daf860d4d7a5cff6e29079ff1f9773423dc4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Aug 2025 13:10:18 +1000
Subject: [PATCH 1976/2374] Renamed variable to not shadow import

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

diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index 35f3fd076da..5871a72134a 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -9,7 +9,7 @@
 pyroma = pytest.importorskip("pyroma", reason="Pyroma not installed")
 
 
-def map_metadata_keys(metadata):
+def map_metadata_keys(md):
     # Convert installed wheel metadata into canonical Core Metadata 2.4 format.
     # This was a utility method in pyroma 4.3.3; it was removed in 5.0.
     # This implementation is constructed from the relevant logic from
@@ -17,8 +17,8 @@ def map_metadata_keys(metadata):
     # upstream to Pyroma as https://github.com/regebro/pyroma/pull/116,
     # so it may be possible to simplify this test in future.
     data = {}
-    for key in set(metadata.keys()):
-        value = metadata.get_all(key)
+    for key in set(md.keys()):
+        value = md.get_all(key)
         key = pyroma.projectdata.normalize(key)
 
         if len(value) == 1:

From ae6bb29b8207023c704490405c254808b04643dd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 2 Aug 2025 18:35:16 +1000
Subject: [PATCH 1977/2374] Removed support for NumPy 1.20 when type checking

---
 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 373938e71e0..e940452600f 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -12,8 +12,8 @@
     try:
         import numpy.typing as npt
 
-        NumpyArray = npt.NDArray[Any]  # requires numpy>=1.21
-    except (ImportError, AttributeError):
+        NumpyArray = npt.NDArray[Any]
+    except ImportError:
         pass
 
 if sys.version_info >= (3, 13):

From 2ab301dcc95bee3b655aa0a2299907271b7a435a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 2 Aug 2025 15:02:20 +0300
Subject: [PATCH 1978/2374] Drop support for Python 3.9 (#9119)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .ci/install.sh                         |  59 ++++------
 .github/mergify.yml                    |   1 -
 .github/workflows/test-cygwin.yml      | 150 -------------------------
 .github/workflows/test-windows.yml     |   4 +-
 .github/workflows/test.yml             |  11 +-
 README.md                              |   3 -
 Tests/helper.py                        |   9 +-
 Tests/test_features.py                 |   5 +-
 Tests/test_format_hsv.py               |   5 +-
 Tests/test_image_transform.py          |   5 +-
 Tests/test_imagechops.py               |   6 +-
 Tests/test_imagecms.py                 |   7 +-
 Tests/test_imagedraw.py                |   9 +-
 Tests/test_qt_image_qapplication.py    |  46 ++++----
 Tests/test_qt_image_toqimage.py        |   8 +-
 Tests/test_shell_injection.py          |   8 +-
 checks/check_imaging_leaks.py          |   3 +-
 docs/index.rst                         |   4 -
 docs/installation/platform-support.rst |  24 ++--
 docs/reference/internal_modules.rst    |   5 -
 docs/releasenotes/12.0.0.rst           |   6 +
 pyproject.toml                         |  10 +-
 src/PIL/GifImagePlugin.py              |   6 +-
 src/PIL/GimpGradientFile.py            |   6 +-
 src/PIL/ImageDraw.py                   |  17 +--
 src/PIL/ImageFilter.py                 |   7 +-
 src/PIL/ImageMath.py                   |   8 +-
 src/PIL/ImageQt.py                     |  21 ++--
 src/PIL/ImageSequence.py               |   6 +-
 src/PIL/PcfFontFile.py                 |   6 +-
 src/PIL/PdfParser.py                   |  17 +--
 src/PIL/TiffImagePlugin.py             |  10 +-
 src/PIL/_imagingcms.pyi                |   8 +-
 src/PIL/_imagingft.pyi                 |   3 +-
 src/PIL/_typing.py                     |  19 +---
 src/PIL/_util.py                       |   7 +-
 tox.ini                                |   4 +-
 37 files changed, 193 insertions(+), 340 deletions(-)
 delete mode 100644 .github/workflows/test-cygwin.yml

diff --git a/.ci/install.sh b/.ci/install.sh
index acb84f046d1..2178c664626 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -13,24 +13,21 @@ aptget_update()
         return 1
     fi
 }
-if [[ $(uname) != CYGWIN* ]]; then
-    aptget_update || aptget_update retry || aptget_update retry
-fi
+aptget_update || aptget_update retry || aptget_update retry
 
 set -e
 
-if [[ $(uname) != CYGWIN* ]]; then
-    sudo apt-get -qq install libfreetype6-dev liblcms2-dev libtiff-dev python3-tk\
-                             ghostscript libjpeg-turbo8-dev libopenjp2-7-dev\
-                             cmake meson imagemagick libharfbuzz-dev libfribidi-dev\
-                             sway wl-clipboard libopenblas-dev nasm
-fi
+sudo apt-get -qq install libfreetype6-dev liblcms2-dev libtiff-dev python3-tk\
+                         ghostscript libjpeg-turbo8-dev libopenjp2-7-dev\
+                         cmake meson imagemagick libharfbuzz-dev libfribidi-dev\
+                         sway wl-clipboard libopenblas-dev nasm
 
 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 numpy
 python3 -m pip install olefile
 python3 -m pip install -U pytest
 python3 -m pip install -U pytest-cov
@@ -40,36 +37,24 @@ python3 -m pip install pyroma
 # fails on beta 3.14 and PyPy
 python3 -m pip install --only-binary=:all: pyarrow || true
 
-if [[ $(uname) != CYGWIN* ]]; then
-    python3 -m pip install numpy
-
-    # 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
-        # TODO Update condition when pyqt6 supports free-threading
-        if ! [[ "$PYTHON_GIL" == "0" ]]; then python3 -m pip install pyqt6 ; fi
-    fi
-
-    # Pyroma uses non-isolated build and fails with old setuptools
-    if [[ $GHA_PYTHON_VERSION == 3.9 ]]; then
-        # To match pyproject.toml
-        python3 -m pip install "setuptools>=77"
-    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
+    # TODO Update condition when pyqt6 supports free-threading
+    if ! [[ "$PYTHON_GIL" == "0" ]]; then python3 -m pip install pyqt6 ; fi
+fi
 
-    # webp
-    pushd depends && ./install_webp.sh && popd
+# webp
+pushd depends && ./install_webp.sh && popd
 
-    # libimagequant
-    pushd depends && ./install_imagequant.sh && popd
+# libimagequant
+pushd depends && ./install_imagequant.sh && popd
 
-    # raqm
-    pushd depends && ./install_raqm.sh && popd
+# raqm
+pushd depends && ./install_raqm.sh && popd
 
-    # libavif
-    pushd depends && ./install_libavif.sh && popd
+# libavif
+pushd depends && ./install_libavif.sh && popd
 
-    # extra test images
-    pushd depends && ./install_extra_test_images.sh && popd
-else
-    cd depends && ./install_extra_test_images.sh && cd ..
-fi
+# extra test images
+pushd depends && ./install_extra_test_images.sh && popd
diff --git a/.github/mergify.yml b/.github/mergify.yml
index 9bb089615be..14222db1094 100644
--- a/.github/mergify.yml
+++ b/.github/mergify.yml
@@ -8,7 +8,6 @@ pull_request_rules:
       - status-success=Docker Test Successful
       - status-success=Windows Test Successful
       - status-success=MinGW
-      - status-success=Cygwin Test Successful
     actions:
       merge:
         method: merge
diff --git a/.github/workflows/test-cygwin.yml b/.github/workflows/test-cygwin.yml
deleted file mode 100644
index 581cd63704b..00000000000
--- a/.github/workflows/test-cygwin.yml
+++ /dev/null
@@ -1,150 +0,0 @@
-name: Test Cygwin
-
-on:
-  push:
-    branches:
-      - "**"
-    paths-ignore:
-      - ".github/workflows/docs.yml"
-      - ".github/workflows/wheels*"
-      - ".gitmodules"
-      - "docs/**"
-      - "wheels/**"
-  pull_request:
-    paths-ignore:
-      - ".github/workflows/docs.yml"
-      - ".github/workflows/wheels*"
-      - ".gitmodules"
-      - "docs/**"
-      - "wheels/**"
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-env:
-  COVERAGE_CORE: sysmon
-
-jobs:
-  build:
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-minor-version: [9]
-
-    timeout-minutes: 40
-
-    name: Python 3.${{ matrix.python-minor-version }}
-
-    steps:
-      - name: Fix line endings
-        run: |
-          git config --global core.autocrlf input
-
-      - name: Checkout Pillow
-        uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-
-      - name: Install Cygwin
-        uses: cygwin/cygwin-install-action@v6
-        with:
-          packages: >
-            gcc-g++
-            ghostscript
-            git
-            ImageMagick
-            jpeg
-            libfreetype-devel
-            libimagequant-devel
-            libjpeg-devel
-            liblapack-devel
-            liblcms2-devel
-            libopenjp2-devel
-            libraqm-devel
-            libtiff-devel
-            libwebp-devel
-            libxcb-devel
-            libxcb-xinerama0
-            make
-            netpbm
-            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
-            wget
-            xorg-server-extra
-            zlib-devel
-
-      - name: Add Lapack to PATH
-        uses: egor-tensin/cleanup-path@v4
-        with:
-          dirs: 'C:\cygwin\bin;C:\cygwin\lib\lapack'
-
-      - name: pip cache
-        uses: actions/cache@v4
-        with:
-          path: 'C:\cygwin\home\runneradmin\.cache\pip'
-          key: ${{ runner.os }}-cygwin-pip3.${{ matrix.python-minor-version }}-${{ hashFiles('.ci/install.sh') }}
-          restore-keys: |
-            ${{ runner.os }}-cygwin-pip3.${{ matrix.python-minor-version }}-
-
-      - name: Build system information
-        run: |
-          dash.exe -c "python3 .github/workflows/system-info.py"
-
-      - name: Install dependencies
-        run: |
-          bash.exe .ci/install.sh
-
-      - name: Build
-        shell: bash.exe -eo pipefail -o igncr "{0}"
-        run: |
-          .ci/build.sh
-
-      - name: Test
-        run: |
-          bash.exe xvfb-run -s '-screen 0 1024x768x24' .ci/test.sh
-
-      - name: Prepare to upload errors
-        if: failure()
-        run: |
-          dash.exe -c "mkdir -p Tests/errors"
-
-      - name: Upload errors
-        uses: actions/upload-artifact@v4
-        if: failure()
-        with:
-          name: errors
-          path: Tests/errors
-
-      - name: After success
-        run: |
-          bash.exe .ci/after_success.sh
-          rm C:\cygwin\bin\bash.EXE
-
-      - name: Upload coverage
-        uses: codecov/codecov-action@v5
-        with:
-          files: ./coverage.xml
-          flags: GHA_Cygwin
-          name: Cygwin Python 3.${{ matrix.python-minor-version }}
-          token: ${{ secrets.CODECOV_ORG_TOKEN }}
-
-  success:
-    permissions:
-      contents: none
-    needs: build
-    runs-on: ubuntu-latest
-    name: Cygwin Test Successful
-    steps:
-      - name: Success
-        run: echo Cygwin Test Successful
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 766c506e761..c80bb6eb602 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -35,11 +35,11 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["pypy3.11", "3.10", "3.11", "3.12", ">=3.13.5", "3.14"]
+        python-version: ["pypy3.11", "3.11", "3.12", "3.13", "3.14"]
         architecture: ["x64"]
         include:
             # Test the oldest Python on 32-bit
-            - { python-version: "3.9", architecture: "x86" }
+            - { python-version: "3.10", architecture: "x86" }
 
     timeout-minutes: 45
 
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index d18023dbc97..c075f04d7cc 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -49,18 +49,17 @@ jobs:
           "3.12",
           "3.11",
           "3.10",
-          "3.9",
         ]
         include:
-        - { python-version: "3.11", PYTHONOPTIMIZE: 1, REVERSE: "--reverse" }
-        - { python-version: "3.10", PYTHONOPTIMIZE: 2 }
+        - { python-version: "3.12", PYTHONOPTIMIZE: 1, REVERSE: "--reverse" }
+        - { python-version: "3.11", PYTHONOPTIMIZE: 2 }
         # Free-threaded
         - { python-version: "3.14t", disable-gil: true }
         - { python-version: "3.13t", disable-gil: true }
-        # M1 only available for 3.10+
-        - { os: "macos-13", python-version: "3.9" }
+        # Intel
+        - { os: "macos-13", python-version: "3.10" }
         exclude:
-        - { os: "macos-latest", python-version: "3.9" }
+        - { os: "macos-latest", python-version: "3.10" }
 
     runs-on: ${{ matrix.os }}
     name: ${{ matrix.os }} Python ${{ matrix.python-version }}
diff --git a/README.md b/README.md
index 365d356a00c..8585ef6cbd4 100644
--- a/README.md
+++ b/README.md
@@ -36,9 +36,6 @@ As of 2019, Pillow development is
             <a href="https://github.com/python-pillow/Pillow/actions/workflows/test-mingw.yml"><img
                 alt="GitHub Actions build status (Test MinGW)"
                 src="https://github.com/python-pillow/Pillow/workflows/Test%20MinGW/badge.svg"></a>
-            <a href="https://github.com/python-pillow/Pillow/actions/workflows/test-cygwin.yml"><img
-                alt="GitHub Actions build status (Test Cygwin)"
-                src="https://github.com/python-pillow/Pillow/workflows/Test%20Cygwin/badge.svg"></a>
             <a href="https://github.com/python-pillow/Pillow/actions/workflows/test-docker.yml"><img
                 alt="GitHub Actions build status (Test Docker)"
                 src="https://github.com/python-pillow/Pillow/workflows/Test%20Docker/badge.svg"></a>
diff --git a/Tests/helper.py b/Tests/helper.py
index df99f5f5571..e0dc8a9d4aa 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -10,17 +10,20 @@
 import subprocess
 import sys
 import tempfile
-from collections.abc import Sequence
 from functools import lru_cache
 from io import BytesIO
-from pathlib import Path
-from typing import Any, Callable
 
 import pytest
 from packaging.version import parse as parse_version
 
 from PIL import Image, ImageFile, ImageMath, features
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable, Sequence
+    from pathlib import Path
+    from typing import Any
+
 logger = logging.getLogger(__name__)
 
 uploader = None
diff --git a/Tests/test_features.py b/Tests/test_features.py
index d9212daee97..93d803fc133 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -2,7 +2,6 @@
 
 import io
 import re
-from typing import Callable
 
 import pytest
 
@@ -10,6 +9,10 @@
 
 from .helper import skip_unless_feature
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 
 def test_check() -> None:
     # Check the correctness of the convenience function
diff --git a/Tests/test_format_hsv.py b/Tests/test_format_hsv.py
index 9cbf18566ca..861eccc1170 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -2,12 +2,15 @@
 
 import colorsys
 import itertools
-from typing import Callable
 
 from PIL import Image
 
 from .helper import assert_image_similar, hopper
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 
 def int_to_float(i: int) -> float:
     return i / 255
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 0429eb99d83..7cf52ddbabe 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 import math
-from typing import Callable
 
 import pytest
 
@@ -9,6 +8,10 @@
 
 from .helper import assert_image_equal, assert_image_similar, hopper
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 
 class TestImageTransform:
     def test_sanity(self) -> None:
diff --git a/Tests/test_imagechops.py b/Tests/test_imagechops.py
index 4309214f5cc..61812ca7dc9 100644
--- a/Tests/test_imagechops.py
+++ b/Tests/test_imagechops.py
@@ -1,11 +1,13 @@
 from __future__ import annotations
 
-from typing import Callable
-
 from PIL import Image, ImageChops
 
 from .helper import assert_image_equal, hopper
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 BLACK = (0, 0, 0)
 BROWN = (127, 64, 0)
 CYAN = (0, 255, 255)
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 46c1baa2d13..5fd7caa7cc7 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -211,9 +211,10 @@ def test_exceptions() -> 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"):
+    with pytest.raises(
+        ImageCms.PyCMSError,
+        match="'NoneType' object cannot be interpreted as an integer",
+    ):
         ImageCms.isIntentSupported(SRGB, None, None)  # type: ignore[arg-type]
 
 
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index e1dcbc52c61..406d965b4e5 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1,13 +1,10 @@
 from __future__ import annotations
 
 import os.path
-from collections.abc import Sequence
-from typing import Callable
 
 import pytest
 
 from PIL import Image, ImageColor, ImageDraw, ImageFont, features
-from PIL._typing import Coords
 
 from .helper import (
     assert_image_equal,
@@ -17,6 +14,12 @@
     skip_unless_feature,
 )
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable, Sequence
+
+    from PIL._typing import Coords
+
 BLACK = (0, 0, 0)
 WHITE = (255, 255, 255)
 GRAY = (190, 190, 190)
diff --git a/Tests/test_qt_image_qapplication.py b/Tests/test_qt_image_qapplication.py
index 82a3e074120..b31e2a4ef25 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -1,8 +1,5 @@
 from __future__ import annotations
 
-from pathlib import Path
-from typing import Union
-
 import pytest
 
 from PIL import Image, ImageQt
@@ -11,18 +8,8 @@
 
 TYPE_CHECKING = False
 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]
+    from pathlib import Path
+
 
 if ImageQt.qt_is_installed:
     from PIL.ImageQt import QPixmap
@@ -32,11 +19,16 @@
         from PyQt6.QtGui import QImage, QPainter, QRegion
         from PyQt6.QtWidgets import QApplication, QHBoxLayout, QLabel, QWidget
     elif ImageQt.qt_version == "side6":
-        from PySide6.QtCore import QPoint
-        from PySide6.QtGui import QImage, QPainter, QRegion
-        from PySide6.QtWidgets import QApplication, QHBoxLayout, QLabel, QWidget
-
-    class Example(QWidget):  # type: ignore[misc]
+        from PySide6.QtCore import QPoint  # type: ignore[assignment]
+        from PySide6.QtGui import QImage, QPainter, QRegion  # type: ignore[assignment]
+        from PySide6.QtWidgets import (  # type: ignore[assignment]
+            QApplication,
+            QHBoxLayout,
+            QLabel,
+            QWidget,
+        )
+
+    class Example(QWidget):
         def __init__(self) -> None:
             super().__init__()
 
@@ -47,9 +39,9 @@ def __init__(self) -> None:
             pixmap1 = getattr(ImageQt.QPixmap, "fromImage")(qimage)
 
             # hbox
-            QHBoxLayout(self)  # type: ignore[operator]
+            QHBoxLayout(self)
 
-            lbl = QLabel(self)  # type: ignore[operator]
+            lbl = QLabel(self)
             # Segfault in the problem
             lbl.setPixmap(pixmap1.copy())
 
@@ -63,7 +55,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([])  # type: ignore[operator]
+    app: QApplication | None = QApplication([])
     ex = Example()
     assert app  # Silence warning
     assert ex  # Silence warning
@@ -84,11 +76,11 @@ def test_sanity(tmp_path: Path) -> None:
         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]
+        qimage = QImage(128, 128, getattr(qt_format, "Format_ARGB32"))
+        painter = QPainter(qimage)
+        image_label = QLabel()
         image_label.setPixmap(data)
-        image_label.render(painter, QPoint(0, 0), QRegion(0, 0, 128, 128))  # type: ignore[operator]
+        image_label.render(painter, QPoint(0, 0), QRegion(0, 0, 128, 128))
         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 8cb7ffb9b40..0004b552153 100644
--- a/Tests/test_qt_image_toqimage.py
+++ b/Tests/test_qt_image_toqimage.py
@@ -1,13 +1,15 @@
 from __future__ import annotations
 
-from pathlib import Path
-
 import pytest
 
 from PIL import ImageQt
 
 from .helper import assert_image_equal, assert_image_equal_tofile, hopper
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
 pytestmark = pytest.mark.skipif(
     not ImageQt.qt_is_installed, reason="Qt bindings are not installed"
 )
@@ -21,7 +23,7 @@ def test_sanity(mode: str, tmp_path: Path) -> None:
     src = hopper(mode)
     data = ImageQt.toqimage(src)
 
-    assert isinstance(data, QImage)  # type: ignore[arg-type, misc]
+    assert isinstance(data, QImage)
     assert not data.isNull()
 
     # reload directly from the qimage
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index 38d46f312ed..465517bb699 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -2,8 +2,6 @@
 
 import shutil
 from io import BytesIO
-from pathlib import Path
-from typing import IO, Callable
 
 import pytest
 
@@ -11,6 +9,12 @@
 
 from .helper import djpeg_available, is_win32, netpbm_available
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+    from pathlib import Path
+    from typing import IO
+
 TEST_JPG = "Tests/images/hopper.jpg"
 TEST_GIF = "Tests/images/hopper.gif"
 
diff --git a/checks/check_imaging_leaks.py b/checks/check_imaging_leaks.py
index 231789ca0a0..a1d59ed9c8b 100755
--- a/checks/check_imaging_leaks.py
+++ b/checks/check_imaging_leaks.py
@@ -1,7 +1,8 @@
 #!/usr/bin/env python3
 from __future__ import annotations
 
-from typing import Any, Callable
+from collections.abc import Callable
+from typing import Any
 
 import pytest
 
diff --git a/docs/index.rst b/docs/index.rst
index 689088d48ce..ee51621ac7a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -29,10 +29,6 @@ Pillow for enterprise is available via the Tidelift Subscription. `Learn more <h
    :target: https://github.com/python-pillow/Pillow/actions/workflows/test-mingw.yml
    :alt: GitHub Actions build status (Test MinGW)
 
-.. image:: https://github.com/python-pillow/Pillow/workflows/Test%20Cygwin/badge.svg
-   :target: https://github.com/python-pillow/Pillow/actions/workflows/test-cygwin.yml
-   :alt: GitHub Actions build status (Test Cygwin)
-
 .. image:: https://github.com/python-pillow/Pillow/workflows/Wheels/badge.svg
    :target: https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml
    :alt: GitHub Actions build status (Wheels)
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index c2227f1d29f..5cf0276d188 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -19,13 +19,13 @@ These platforms are built and tested for every change.
 +==================================+============================+=====================+
 | Alpine                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Amazon Linux 2                   | 3.9                        | x86-64              |
+| Amazon Linux 2                   | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Amazon Linux 2023                | 3.9                        | x86-64              |
+| Amazon Linux 2023                | 3.11                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Arch                             | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| CentOS Stream 9                  | 3.9                        | x86-64              |
+| CentOS Stream 9                  | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | CentOS Stream 10                 | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
@@ -37,27 +37,25 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 13 Ventura                 | 3.9                        | x86-64              |
+| macOS 13 Ventura                 | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 14 Sonoma                  | 3.10, 3.11, 3.12, 3.13,    | arm64               |
-|                                  | 3.14, PyPy3                |                     |
+| macOS 14 Sonoma                  | 3.11, 3.12, 3.13, 3.14     | arm64               |
+|                                  | PyPy3                      |                     |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Ubuntu Linux 24.04 LTS (Noble)   | 3.9, 3.10, 3.11,           | x86-64              |
-|                                  | 3.12, 3.13, 3.14, PyPy3    |                     |
+| Ubuntu Linux 24.04 LTS (Noble)   | 3.10, 3.11, 3.12, 3.13,    | x86-64              |
+|                                  | 3.14, PyPy3                |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12                       | arm64v8, ppc64le,   |
 |                                  |                            | s390x               |
 +----------------------------------+----------------------------+---------------------+
-| Windows Server 2022              | 3.9                        | x86                 |
+| Windows Server 2022              | 3.10                       | x86                 |
 |                                  +----------------------------+---------------------+
-|                                  | 3.10, 3.11, 3.12, 3.13,    | x86-64              |
-|                                  | 3.14, PyPy3                |                     |
+|                                  | 3.11, 3.12, 3.13, 3.14,    | x86-64              |
+|                                  | PyPy3                      |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12 (MinGW)               | x86-64              |
-|                                  +----------------------------+---------------------+
-|                                  | 3.9 (Cygwin)               | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 
 
diff --git a/docs/reference/internal_modules.rst b/docs/reference/internal_modules.rst
index 19f78864d1d..41a8837b30a 100644
--- a/docs/reference/internal_modules.rst
+++ b/docs/reference/internal_modules.rst
@@ -53,11 +53,6 @@ on some Python versions.
 
     An object that supports the read method.
 
-.. py:data:: TypeGuard
-    :value: typing.TypeGuard
-
-    See :py:obj:`typing.TypeGuard`.
-
 :mod:`~PIL._util` module
 ------------------------
 
diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index 46cf64cf1f7..e21c243ea55 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -17,6 +17,12 @@ TODO
 Backwards incompatible changes
 ==============================
 
+Python 3.9
+^^^^^^^^^^
+
+Pillow has dropped support for Python 3.9,
+which reached end-of-life in October 2025.
+
 ImageFile.raise_oserror
 ^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/pyproject.toml b/pyproject.toml
index 4980a9cb880..137726a1c04 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -20,11 +20,10 @@ license-files = [ "LICENSE" ]
 authors = [
   { name = "Jeffrey A. Clark", email = "aclark@aclark.net" },
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 classifiers = [
   "Development Status :: 6 - Mature",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
@@ -76,9 +75,6 @@ optional-dependencies.tests = [
   "trove-classifiers>=2024.10.12",
 ]
 
-optional-dependencies.typing = [
-  "typing-extensions; python_version<'3.10'",
-]
 optional-dependencies.xmp = [
   "defusedxml",
 ]
@@ -189,8 +185,8 @@ lint.ignore = [
   "PT011",  # pytest-raises-too-broad
   "PT012",  # pytest-raises-with-multiple-statements
   "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
+  "UP038",  # pyupgrade: deprecated rule
 ]
 lint.per-file-ignores."Tests/oss-fuzz/fuzz_font.py" = [
   "I002",
@@ -216,7 +212,7 @@ testpaths = [
 ]
 
 [tool.mypy]
-python_version = "3.9"
+python_version = "3.10"
 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 b03aa7f1505..58c460ef3db 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -31,7 +31,7 @@
 import subprocess
 from enum import IntEnum
 from functools import cached_property
-from typing import IO, Any, Literal, NamedTuple, Union, cast
+from typing import Any, NamedTuple, cast
 
 from . import (
     Image,
@@ -49,6 +49,8 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
+    from typing import IO, Literal
+
     from . import _imaging
     from ._typing import Buffer
 
@@ -535,7 +537,7 @@ def _normalize_mode(im: Image.Image) -> Image.Image:
     return im.convert("L")
 
 
-_Palette = Union[bytes, bytearray, list[int], ImagePalette.ImagePalette]
+_Palette = bytes | bytearray | list[int] | ImagePalette.ImagePalette
 
 
 def _normalize_palette(
diff --git a/src/PIL/GimpGradientFile.py b/src/PIL/GimpGradientFile.py
index ec62f8e4ebc..5f2691882c4 100644
--- a/src/PIL/GimpGradientFile.py
+++ b/src/PIL/GimpGradientFile.py
@@ -21,10 +21,14 @@
 from __future__ import annotations
 
 from math import log, pi, sin, sqrt
-from typing import IO, Callable
 
 from ._binary import o8
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+    from typing import IO
+
 EPSILON = 1e-10
 """"""  # Enable auto-doc for data member
 
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index e95fa91f8b3..ed46899b455 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,20 +34,23 @@
 import math
 import struct
 from collections.abc import Sequence
-from types import ModuleType
-from typing import Any, AnyStr, Callable, Union, cast
+from typing import cast
 
 from . import Image, ImageColor
-from ._typing import Coords
-
-# experimental access to the outline API
-Outline: Callable[[], Image.core._Outline] = Image.core.outline
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
+    from collections.abc import Callable
+    from types import ModuleType
+    from typing import Any, AnyStr
+
     from . import ImageDraw2, ImageFont
+    from ._typing import Coords
+
+# experimental access to the outline API
+Outline: Callable[[], Image.core._Outline] = Image.core.outline
 
-_Ink = Union[float, tuple[int, ...], str]
+_Ink = float | tuple[int, ...] | str
 
 """
 A simple 2D drawing interface for PIL images.
diff --git a/src/PIL/ImageFilter.py b/src/PIL/ImageFilter.py
index b9ed54ab20a..9326eeeda9d 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -19,11 +19,14 @@
 import abc
 import functools
 from collections.abc import Sequence
-from types import ModuleType
-from typing import Any, Callable, cast
+from typing import cast
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
+    from collections.abc import Callable
+    from types import ModuleType
+    from typing import Any
+
     from . import _imaging
     from ._typing import NumpyArray
 
diff --git a/src/PIL/ImageMath.py b/src/PIL/ImageMath.py
index d2504b1ae5a..dfdc50c0552 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -17,11 +17,15 @@
 from __future__ import annotations
 
 import builtins
-from types import CodeType
-from typing import Any, Callable
 
 from . import Image, _imagingmath
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+    from types import CodeType
+    from typing import Any
+
 
 class _Operand:
     """Wraps an image operand, providing standard operators"""
diff --git a/src/PIL/ImageQt.py b/src/PIL/ImageQt.py
index df7a57b652c..af4d0742d6b 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -19,23 +19,18 @@
 
 import sys
 from io import BytesIO
-from typing import Any, Callable, Union
 
 from . import Image
 from ._util import is_path
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    import PyQt6
-    import PySide6
+    from collections.abc import Callable
+    from typing import Any
 
     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 = [
@@ -49,11 +44,15 @@
     try:
         qRgba: Callable[[int, int, int, int], int]
         if qt_module == "PyQt6":
-            from PyQt6.QtCore import QBuffer, QIODevice
+            from PyQt6.QtCore import QBuffer, QByteArray, QIODevice
             from PyQt6.QtGui import QImage, QPixmap, qRgba
         elif qt_module == "PySide6":
-            from PySide6.QtCore import QBuffer, QIODevice
-            from PySide6.QtGui import QImage, QPixmap, qRgba
+            from PySide6.QtCore import (  # type: ignore[assignment]
+                QBuffer,
+                QByteArray,
+                QIODevice,
+            )
+            from PySide6.QtGui import QImage, QPixmap, qRgba  # type: ignore[assignment]
     except (ImportError, RuntimeError):
         continue
     qt_is_installed = True
@@ -183,7 +182,7 @@ def _toqclass_helper(im: Image.Image | str | QByteArray) -> dict[str, Any]:
 
 if qt_is_installed:
 
-    class ImageQt(QImage):  # type: ignore[misc]
+    class ImageQt(QImage):
         def __init__(self, im: Image.Image | str | QByteArray) -> None:
             """
             An PIL image wrapper for Qt.  This is a subclass of PyQt's QImage
diff --git a/src/PIL/ImageSequence.py b/src/PIL/ImageSequence.py
index a6fc340d55f..361be48971e 100644
--- a/src/PIL/ImageSequence.py
+++ b/src/PIL/ImageSequence.py
@@ -16,10 +16,12 @@
 ##
 from __future__ import annotations
 
-from typing import Callable
-
 from . import Image
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 
 class Iterator:
     """
diff --git a/src/PIL/PcfFontFile.py b/src/PIL/PcfFontFile.py
index 0d1968b140a..a00e9b91984 100644
--- a/src/PIL/PcfFontFile.py
+++ b/src/PIL/PcfFontFile.py
@@ -18,7 +18,6 @@
 from __future__ import annotations
 
 import io
-from typing import BinaryIO, Callable
 
 from . import FontFile, Image
 from ._binary import i8
@@ -27,6 +26,11 @@
 from ._binary import i32be as b32
 from ._binary import i32le as l32
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+    from typing import BinaryIO
+
 # --------------------------------------------------------------------
 # declarations
 
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 73d8c21c023..2c9031469ad 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,15 @@
 import re
 import time
 import zlib
-from typing import IO, Any, NamedTuple, Union
+from typing import Any, NamedTuple
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import IO
+
+    _DictBase = collections.UserDict[str | bytes, Any]
+else:
+    _DictBase = collections.UserDict
 
 
 # see 7.9.2.2 Text String Type on page 86 and D.3 PDFDocEncoding Character Set
@@ -251,13 +259,6 @@ def __bytes__(self) -> bytes:
         return b"[ " + b" ".join(pdf_repr(x) for x in self) + b" ]"
 
 
-TYPE_CHECKING = False
-if TYPE_CHECKING:
-    _DictBase = collections.UserDict[Union[str, bytes], Any]
-else:
-    _DictBase = collections.UserDict
-
-
 class PdfDict(_DictBase):
     def __setattr__(self, key: str, value: Any) -> None:
         if key == "data":
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index c1850f084c0..c1741284b9f 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -47,22 +47,24 @@
 import os
 import struct
 import warnings
-from collections.abc import Iterator, MutableMapping
+from collections.abc import Callable, MutableMapping
 from fractions import Fraction
 from numbers import Number, Rational
-from typing import IO, Any, Callable, NoReturn, cast
+from typing import IO, Any, 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 ._typing import StrOrBytesPath
 from ._util import DeferredError, is_path
 from .TiffTags import TYPES
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from ._typing import Buffer, IntegralLike
+    from collections.abc import Iterator
+    from typing import NoReturn
+
+    from ._typing import Buffer, IntegralLike, StrOrBytesPath
 
 logger = logging.getLogger(__name__)
 
diff --git a/src/PIL/_imagingcms.pyi b/src/PIL/_imagingcms.pyi
index ddcf93ab1eb..4fc0d60ab79 100644
--- a/src/PIL/_imagingcms.pyi
+++ b/src/PIL/_imagingcms.pyi
@@ -1,14 +1,14 @@
 import datetime
 import sys
-from typing import Literal, SupportsFloat, TypedDict
+from typing import Literal, SupportsFloat, TypeAlias, TypedDict
 
 from ._typing import CapsuleType
 
 littlecms_version: str | None
 
-_Tuple3f = tuple[float, float, float]
-_Tuple2x3f = tuple[_Tuple3f, _Tuple3f]
-_Tuple3x3f = tuple[_Tuple3f, _Tuple3f, _Tuple3f]
+_Tuple3f: TypeAlias = tuple[float, float, float]
+_Tuple2x3f: TypeAlias = tuple[_Tuple3f, _Tuple3f]
+_Tuple3x3f: TypeAlias = tuple[_Tuple3f, _Tuple3f, _Tuple3f]
 
 class _IccMeasurementCondition(TypedDict):
     observer: int
diff --git a/src/PIL/_imagingft.pyi b/src/PIL/_imagingft.pyi
index 1cb1429d6cf..2136810ba6a 100644
--- a/src/PIL/_imagingft.pyi
+++ b/src/PIL/_imagingft.pyi
@@ -1,4 +1,5 @@
-from typing import Any, Callable
+from collections.abc import Callable
+from typing import Any
 
 from . import ImageFont, _imaging
 
diff --git a/src/PIL/_typing.py b/src/PIL/_typing.py
index e940452600f..979147e0c2b 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -3,7 +3,7 @@
 import os
 import sys
 from collections.abc import Sequence
-from typing import Any, Protocol, TypeVar, Union
+from typing import Any, Protocol, TypeVar
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
@@ -26,19 +26,8 @@
 else:
     Buffer = Any
 
-if sys.version_info >= (3, 10):
-    from typing import TypeGuard
-else:
-    try:
-        from typing_extensions import TypeGuard
-    except ImportError:
-
-        class TypeGuard:  # type: ignore[no-redef]
-            def __class_getitem__(cls, item: Any) -> type[bool]:
-                return bool
-
 
-Coords = Union[Sequence[float], Sequence[Sequence[float]]]
+Coords = Sequence[float] | Sequence[Sequence[float]]
 
 
 _T_co = TypeVar("_T_co", covariant=True)
@@ -48,7 +37,7 @@ class SupportsRead(Protocol[_T_co]):
     def read(self, length: int = ..., /) -> _T_co: ...
 
 
-StrOrBytesPath = Union[str, bytes, os.PathLike[str], os.PathLike[bytes]]
+StrOrBytesPath = str | bytes | os.PathLike[str] | os.PathLike[bytes]
 
 
-__all__ = ["Buffer", "IntegralLike", "StrOrBytesPath", "SupportsRead", "TypeGuard"]
+__all__ = ["Buffer", "IntegralLike", "StrOrBytesPath", "SupportsRead"]
diff --git a/src/PIL/_util.py b/src/PIL/_util.py
index 8ef0d36f754..b1fa6a0f39e 100644
--- a/src/PIL/_util.py
+++ b/src/PIL/_util.py
@@ -1,9 +1,12 @@
 from __future__ import annotations
 
 import os
-from typing import Any, NoReturn
 
-from ._typing import StrOrBytesPath, TypeGuard
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Any, NoReturn, TypeGuard
+
+    from ._typing import StrOrBytesPath
 
 
 def is_path(f: Any) -> TypeGuard[StrOrBytesPath]:
diff --git a/tox.ini b/tox.ini
index 967d4b53768..8933945b1af 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ requires =
     tox>=4.2
 env_list =
     lint
-    py{py3, 314, 313, 312, 311, 310, 39}
+    py{py3, 314, 313, 312, 311, 310}
 
 [testenv]
 deps =
@@ -29,7 +29,5 @@ commands =
 skip_install = true
 deps =
     -r .ci/requirements-mypy.txt
-extras =
-    typing
 commands =
     mypy conftest.py selftest.py setup.py docs src winbuild Tests {posargs}

From 148e1ac914c411925df2de1972d88f7a01ccde9e Mon Sep 17 00:00:00 2001
From: Russell Keith-Magee <russell@keith-magee.com>
Date: Sat, 2 Aug 2025 20:10:55 +0800
Subject: [PATCH 1979/2374] Add libavif support for iOS (#9117)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/wheels-dependencies.sh | 39 +++++++++++++++++-------
 checks/check_wheel.py                    |  3 +-
 2 files changed, 29 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 4519271b9d3..d58c6512669 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -186,30 +186,43 @@ function build_libavif {
 
     python3 -m pip install meson ninja
 
-    if [[ "$PLAT" == "x86_64" ]] || [ -n "$SANITIZER" ]; then
+    if ([[ "$PLAT" == "x86_64" ]] && [[ -z "$IOS_SDK" ]]) || [ -n "$SANITIZER" ]; then
         build_simple nasm 2.16.03 https://www.nasm.us/pub/nasm/releasebuilds/2.16.03
     fi
 
     local build_type=MinSizeRel
+    local build_shared=ON
     local lto=ON
 
     local libavif_cmake_flags
 
-    if [ -n "$IS_MACOS" ]; then
+    if [[ -n "$IS_MACOS" ]]; then
         lto=OFF
         libavif_cmake_flags=(
             -DCMAKE_C_FLAGS_MINSIZEREL="-Oz -DNDEBUG -flto" \
             -DCMAKE_CXX_FLAGS_MINSIZEREL="-Oz -DNDEBUG -flto" \
             -DCMAKE_SHARED_LINKER_FLAGS_INIT="-Wl,-S,-x,-dead_strip_dylibs" \
         )
+        if [[ -n "$IOS_SDK" ]]; then
+            build_shared=OFF
+        fi
     else
         if [[ "$MB_ML_VER" == 2014 ]] && [[ "$PLAT" == "x86_64" ]]; then
             build_type=Release
         fi
         libavif_cmake_flags=(-DCMAKE_SHARED_LINKER_FLAGS_INIT="-Wl,--strip-all,-z,relro,-z,now")
     fi
+    if [[ -n "$IOS_SDK" ]] && [[ "$PLAT" == "x86_64" ]]; then
+        libavif_cmake_flags+=(-DAOM_TARGET_CPU=generic)
+    else
+        libavif_cmake_flags+=(
+            -DAVIF_CODEC_AOM_DECODE=OFF \
+            -DAVIF_CODEC_DAV1D=LOCAL
+        )
+    fi
 
     local out_dir=$(fetch_unpack https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$LIBAVIF_VERSION.tar.gz libavif-$LIBAVIF_VERSION.tar.gz)
+
     # CONFIG_AV1_HIGHBITDEPTH=0 is a flag for libaom (included as a subproject
     # of libavif) that disables support for encoding high bit depth images.
     (cd $out_dir \
@@ -217,20 +230,27 @@ function build_libavif {
             -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX \
             -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib \
             -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib \
-            -DBUILD_SHARED_LIBS=ON \
+            -DBUILD_SHARED_LIBS=$build_shared \
             -DAVIF_LIBSHARPYUV=LOCAL \
             -DAVIF_LIBYUV=LOCAL \
             -DAVIF_CODEC_AOM=LOCAL \
             -DCONFIG_AV1_HIGHBITDEPTH=0 \
-            -DAVIF_CODEC_AOM_DECODE=OFF \
-            -DAVIF_CODEC_DAV1D=LOCAL \
             -DCMAKE_INTERPROCEDURAL_OPTIMIZATION=$lto \
             -DCMAKE_C_VISIBILITY_PRESET=hidden \
             -DCMAKE_CXX_VISIBILITY_PRESET=hidden \
             -DCMAKE_BUILD_TYPE=$build_type \
             "${libavif_cmake_flags[@]}" \
-            . \
-        && make install)
+            $HOST_CMAKE_FLAGS . )
+
+    if [[ -n "$IOS_SDK" ]]; then
+        # libavif's CMake configuration generates a meson cross file... but it
+        # doesn't work for iOS cross-compilation. Copy in Pillow-generated
+        # meson-cross config to replace the cmake-generated version.
+        cp $WORKDIR/meson-cross.txt $out_dir/crossfile-apple.meson
+    fi
+
+    (cd $out_dir && make install)
+
     touch libavif-stamp
 }
 
@@ -268,10 +288,7 @@ function build {
         build_tiff
     fi
 
-    if [[ -z "$IOS_SDK" ]]; then
-        # Short term workaround; don't build libavif on iOS
-        build_libavif
-    fi
+    build_libavif
     build_libpng
     build_lcms2
     build_openjpeg
diff --git a/checks/check_wheel.py b/checks/check_wheel.py
index 3d806eb71e2..937722c4bab 100644
--- a/checks/check_wheel.py
+++ b/checks/check_wheel.py
@@ -25,8 +25,7 @@ def test_wheel_modules() -> None:
 
     elif sys.platform == "ios":
         # tkinter is not available on iOS
-        # libavif is not available on iOS (for now)
-        expected_modules -= {"tkinter", "avif"}
+        expected_modules.remove("tkinter")
 
     assert set(features.get_supported_modules()) == expected_modules
 

From 77247b62833afc78d561ce16ec8c34aae35f58c9 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 3 Aug 2025 12:48:47 +1000
Subject: [PATCH 1980/2374] Update dependency cibuildwheel to v3.1.3 (#9129)

---
 .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 823671828f7..9f91365576e 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.1.2
+cibuildwheel==3.1.3

From 4677cf3b1600dae5687efe651c2814f6f0f48541 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 3 Aug 2025 13:58:41 +1000
Subject: [PATCH 1981/2374] Update dependency mypy to v1.17.1 (#9130)

---
 .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 99eac602796..bd95638008d 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.17.0
+mypy==1.17.1
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 2973f69a756283fef2609ff473495827591b4551 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 4 Aug 2025 21:36:17 +1000
Subject: [PATCH 1982/2374] Updated libimagequant to 4.4.0 (#9074)

---
 depends/install_imagequant.sh              | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 winbuild/build_prepare.py                  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 88756f8f9b9..357214f1fd6 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -2,7 +2,7 @@
 # install libimagequant
 
 archive_name=libimagequant
-archive_version=4.3.4
+archive_version=4.4.0
 
 archive=$archive_name-$archive_version
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 59c595742fe..fc7ef7646c5 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -64,7 +64,7 @@ Many of Pillow's features require external libraries:
 
 * **libimagequant** provides improved color quantization
 
-  * Pillow has been tested with libimagequant **2.6-4.3.4**
+  * Pillow has been tested with libimagequant **2.6-4.4.0**
   * Libimagequant is licensed GPLv3, which is more restrictive than
     the Pillow license, therefore we will not be distributing binaries
     with libimagequant support enabled.
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index fbff0daf2b2..4fab5f4c4b5 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -120,7 +120,7 @@ def cmd_msbuild(
     "JPEGTURBO": "3.1.1",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
-    "LIBIMAGEQUANT": "4.3.4",
+    "LIBIMAGEQUANT": "4.4.0",
     "LIBPNG": "1.6.50",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.3",

From cee238bcb8ca6a49e21064dd5c40440bed838503 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 5 Aug 2025 06:57:50 +1000
Subject: [PATCH 1983/2374] [pre-commit.ci] pre-commit autoupdate (#9131)

---
 .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 75c7d36324e..cff17cd361a 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.12.2
+    rev: v0.12.7
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$|\.patch$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v20.1.7
+    rev: v20.1.8
     hooks:
       - id: clang-format
         types: [c]
@@ -79,7 +79,7 @@ repos:
         additional_dependencies: [trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.5.0
+    rev: 1.6.0
     hooks:
       - id: tox-ini-fmt
 

From 0465627f0c43eb6a9a9b971d0ca0406e5b82cc8b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Aug 2025 13:00:33 +1000
Subject: [PATCH 1984/2374] Fill alpha channel when quantizing RGB images

---
 Tests/test_image_quantize.py |  9 +++++++++
 src/libImaging/Quant.c       | 28 ++++++++++++++++------------
 2 files changed, 25 insertions(+), 12 deletions(-)

diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 6d313cb8cb3..4a0732269f0 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -116,6 +116,15 @@ def test_quantize_kmeans(method: Image.Quantize) -> None:
         im.quantize(kmeans=-1, method=method)
 
 
+@skip_unless_feature("libimagequant")
+def test_resize() -> None:
+    im = hopper().resize((100, 100))
+    converted = im.quantize(100, Image.Quantize.LIBIMAGEQUANT)
+    colors = converted.getcolors()
+    assert colors is not None
+    assert len(colors) == 100
+
+
 def test_colors() -> None:
     im = hopper()
     colors = 2
diff --git a/src/libImaging/Quant.c b/src/libImaging/Quant.c
index a489a882db2..2ad9902275d 100644
--- a/src/libImaging/Quant.c
+++ b/src/libImaging/Quant.c
@@ -1745,19 +1745,23 @@ ImagingQuantize(Imaging im, int colors, int mode, int kmeans) {
         for (i = y = 0; y < im->ysize; y++) {
             for (x = 0; x < im->xsize; x++, i++) {
                 p[i].v = im->image32[y][x];
-                if (withAlpha && p[i].c.a == 0) {
-                    if (transparency == 0) {
-                        transparency = 1;
-                        r = p[i].c.r;
-                        g = p[i].c.g;
-                        b = p[i].c.b;
-                    } else {
-                        /* Set all subsequent transparent pixels
-                        to the same colour as the first */
-                        p[i].c.r = r;
-                        p[i].c.g = g;
-                        p[i].c.b = b;
+                if (withAlpha) {
+                    if (p[i].c.a == 0) {
+                        if (transparency == 0) {
+                            transparency = 1;
+                            r = p[i].c.r;
+                            g = p[i].c.g;
+                            b = p[i].c.b;
+                        } else {
+                            /* Set all subsequent transparent pixels
+                            to the same colour as the first */
+                            p[i].c.r = r;
+                            p[i].c.g = g;
+                            p[i].c.b = b;
+                        }
                     }
+                } else {
+                    p[i].c.a = 255;
                 }
             }
         }

From d3fa549ec941997dfa48e59ecf0aa3cdeb007070 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 5 Aug 2025 18:03:47 +1000
Subject: [PATCH 1985/2374] Use Python 3.14 for gcc problem matching

---
 .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 c075f04d7cc..0fad22a03c4 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -111,7 +111,7 @@ jobs:
         GHA_PYTHON_VERSION: ${{ matrix.python-version }}
 
     - name: Register gcc problem matcher
-      if: "matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'"
+      if: "matrix.os == 'ubuntu-latest' && matrix.python-version == '3.14'"
       run: echo "::add-matcher::.github/problem-matchers/gcc.json"
 
     - name: Build

From b07dbc167c3040f076ad679c5459979cb2ca71d7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 6 Aug 2025 08:17:09 +1000
Subject: [PATCH 1986/2374] Fixed typo

---
 docs/handbook/third-party-plugins.rst | 2 +-
 src/PIL/WmfImagePlugin.py             | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst
index a189a5773c7..1c7dfb5e95b 100644
--- a/docs/handbook/third-party-plugins.rst
+++ b/docs/handbook/third-party-plugins.rst
@@ -11,7 +11,7 @@ Here is a list of PyPI projects that offer additional plugins:
 * :pypi:`heif-image-plugin`: Simple HEIF/HEIC images plugin, based on the pyheif library.
 * :pypi:`jxlpy`: Introduces reading and writing support for JPEG XL.
 * :pypi:`pillow-heif`: Python bindings to libheif for working with HEIF images.
-* :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implemetation. Python bindings implemented using pybind11.
+* :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implementation. Python bindings implemented using pybind11.
 * :pypi:`pillow-jxl-plugin`: Plugin for JPEG-XL, using Rust for bindings.
 * :pypi:`pillow-mbm`: Adds support for KSP's proprietary MBM texture format.
 * :pypi:`pillow-svg`: Implements basic SVG read support. Supports basic paths, shapes, and text.
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index d569cb4b819..de714d33794 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -80,7 +80,7 @@ class WmfStubImageFile(ImageFile.StubImageFile):
     format_description = "Windows Metafile"
 
     def _open(self) -> None:
-        # check placable header
+        # check placeable header
         s = self.fp.read(44)
 
         if s.startswith(b"\xd7\xcd\xc6\x9a\x00\x00"):

From 4f8ac76407f6dbaf0563b55700731955850170cf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 6 Aug 2025 09:00:36 +1000
Subject: [PATCH 1987/2374] Updated raqm to 0.10.3

---
 depends/install_raqm.sh            |  2 +-
 src/thirdparty/raqm/COPYING        |  2 +-
 src/thirdparty/raqm/NEWS           | 16 ++++++
 src/thirdparty/raqm/raqm-version.h |  4 +-
 src/thirdparty/raqm/raqm.c         | 84 ++++++++++++++++--------------
 5 files changed, 65 insertions(+), 43 deletions(-)

diff --git a/depends/install_raqm.sh b/depends/install_raqm.sh
index 5d862403ee0..b5a05100ba2 100755
--- a/depends/install_raqm.sh
+++ b/depends/install_raqm.sh
@@ -2,7 +2,7 @@
 # install raqm
 
 
-archive=libraqm-0.10.2
+archive=libraqm-0.10.3
 
 ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
 
diff --git a/src/thirdparty/raqm/COPYING b/src/thirdparty/raqm/COPYING
index 97e2489b779..964318a8ae7 100644
--- a/src/thirdparty/raqm/COPYING
+++ b/src/thirdparty/raqm/COPYING
@@ -1,7 +1,7 @@
 The MIT License (MIT)
 
 Copyright © 2015 Information Technology Authority (ITA) <foss@ita.gov.om>
-Copyright © 2016-2023 Khaled Hosny <khaled@aliftype.com>
+Copyright © 2016-2025 Khaled Hosny <khaled@aliftype.com>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/src/thirdparty/raqm/NEWS b/src/thirdparty/raqm/NEWS
index e8bf32e0bbb..fb432cffb0e 100644
--- a/src/thirdparty/raqm/NEWS
+++ b/src/thirdparty/raqm/NEWS
@@ -1,3 +1,19 @@
+Overview of changes leading to 0.10.3
+Tuesday, August 5, 2025
+====================================
+
+Fix raqm_set_text_utf8/utf16 reading beyond len for multibyte.
+
+Support building against SheenBidi 2.9.
+
+Fix deprecation warning with latest HarfBuzz.
+
+Overview of changes leading to 0.10.2
+Sunday, September 22, 2024
+====================================
+
+Fix Unicode codepoint conversion from UTF-16.
+
 Overview of changes leading to 0.10.1
 Wednesday, April 12, 2023
 ====================================
diff --git a/src/thirdparty/raqm/raqm-version.h b/src/thirdparty/raqm/raqm-version.h
index 62d2d206459..f2dd61cf6a1 100644
--- a/src/thirdparty/raqm/raqm-version.h
+++ b/src/thirdparty/raqm/raqm-version.h
@@ -33,9 +33,9 @@
 
 #define RAQM_VERSION_MAJOR 0
 #define RAQM_VERSION_MINOR 10
-#define RAQM_VERSION_MICRO 1
+#define RAQM_VERSION_MICRO 3
 
-#define RAQM_VERSION_STRING "0.10.1"
+#define RAQM_VERSION_STRING "0.10.3"
 
 #define RAQM_VERSION_ATLEAST(major,minor,micro) \
     ((major)*10000+(minor)*100+(micro) <= \
diff --git a/src/thirdparty/raqm/raqm.c b/src/thirdparty/raqm/raqm.c
index 2b331e1afb0..9ecc5cac8cf 100644
--- a/src/thirdparty/raqm/raqm.c
+++ b/src/thirdparty/raqm/raqm.c
@@ -30,7 +30,11 @@
 #include <string.h>
 
 #ifdef RAQM_SHEENBIDI
+#ifdef RAQM_SHEENBIDI_GT_2_9
+#include <SheenBidi/SheenBidi.h>
+#else
 #include <SheenBidi.h>
+#endif
 #else
 #ifdef HAVE_FRIBIDI_SYSTEM
 #include <fribidi.h>
@@ -546,34 +550,32 @@ raqm_set_text (raqm_t         *rq,
   return true;
 }
 
-static void *
-_raqm_get_utf8_codepoint (const void *str,
+static const char *
+_raqm_get_utf8_codepoint (const char *str,
                           uint32_t *out_codepoint)
 {
-  const char *s = (const char *)str;
-
-  if (0xf0 == (0xf8 & s[0]))
+  if (0xf0 == (0xf8 & str[0]))
   {
-    *out_codepoint = ((0x07 & s[0]) << 18) | ((0x3f & s[1]) << 12) | ((0x3f & s[2]) << 6) | (0x3f & s[3]);
-    s += 4;
+    *out_codepoint = ((0x07 & str[0]) << 18) | ((0x3f & str[1]) << 12) | ((0x3f & str[2]) << 6) | (0x3f & str[3]);
+    str += 4;
   }
-  else if (0xe0 == (0xf0 & s[0]))
+  else if (0xe0 == (0xf0 & str[0]))
   {
-    *out_codepoint = ((0x0f & s[0]) << 12) | ((0x3f & s[1]) << 6) | (0x3f & s[2]);
-    s += 3;
+    *out_codepoint = ((0x0f & str[0]) << 12) | ((0x3f & str[1]) << 6) | (0x3f & str[2]);
+    str += 3;
   }
-  else if (0xc0 == (0xe0 & s[0]))
+  else if (0xc0 == (0xe0 & str[0]))
   {
-    *out_codepoint = ((0x1f & s[0]) << 6) | (0x3f & s[1]);
-    s += 2;
+    *out_codepoint = ((0x1f & str[0]) << 6) | (0x3f & str[1]);
+    str += 2;
   }
   else
   {
-    *out_codepoint = s[0];
-    s += 1;
+    *out_codepoint = str[0];
+    str += 1;
   }
 
-  return (void *)s;
+  return str;
 }
 
 static size_t
@@ -585,42 +587,41 @@ _raqm_u8_to_u32 (const char *text, size_t len, uint32_t *unicode)
 
   while ((*in_utf8 != '\0') && (in_len < len))
   {
-    in_utf8 = _raqm_get_utf8_codepoint (in_utf8, out_utf32);
+    const char *out_utf8 = _raqm_get_utf8_codepoint (in_utf8, out_utf32);
+    in_len += out_utf8 - in_utf8;
+    in_utf8 = out_utf8;
     ++out_utf32;
-    ++in_len;
   }
 
   return (out_utf32 - unicode);
 }
 
-static void *
-_raqm_get_utf16_codepoint (const void *str,
-                          uint32_t *out_codepoint)
+static const uint16_t *
+_raqm_get_utf16_codepoint (const uint16_t *str,
+                           uint32_t *out_codepoint)
 {
-  const uint16_t *s = (const uint16_t *)str;
-
-  if (s[0] > 0xD800 && s[0] < 0xDBFF)
+  if (str[0] >= 0xD800 && str[0] <= 0xDBFF)
   {
-    if (s[1] > 0xDC00 && s[1] < 0xDFFF)
+    if (str[1] >= 0xDC00 && str[1] <= 0xDFFF)
     {
-      uint32_t X = ((s[0] & ((1 << 6) -1)) << 10) | (s[1] & ((1 << 10) -1));
-      uint32_t W = (s[0] >> 6) & ((1 << 5) - 1);
+      uint32_t X = ((str[0] & ((1 << 6) -1)) << 10) | (str[1] & ((1 << 10) -1));
+      uint32_t W = (str[0] >> 6) & ((1 << 5) - 1);
       *out_codepoint = (W+1) << 16 | X;
-      s += 2;
+      str += 2;
     }
     else
     {
       /* A single high surrogate, this is an error. */
-      *out_codepoint = s[0];
-      s += 1;
+      *out_codepoint = str[0];
+      str += 1;
     }
   }
   else
   {
-      *out_codepoint = s[0];
-      s += 1;
+      *out_codepoint = str[0];
+      str += 1;
   }
-  return (void *)s;
+  return str;
 }
 
 static size_t
@@ -632,9 +633,10 @@ _raqm_u16_to_u32 (const uint16_t *text, size_t len, uint32_t *unicode)
 
   while ((*in_utf16 != '\0') && (in_len < len))
   {
-    in_utf16 = _raqm_get_utf16_codepoint (in_utf16, out_utf32);
+    const uint16_t *out_utf16 = _raqm_get_utf16_codepoint (in_utf16, out_utf32);
+    in_len += (out_utf16 - in_utf16);
+    in_utf16 = out_utf16;
     ++out_utf32;
-    ++in_len;
   }
 
   return (out_utf32 - unicode);
@@ -1114,12 +1116,12 @@ _raqm_set_spacing (raqm_t *rq,
       {
         if (_raqm_allowed_grapheme_boundary (rq->text[i], rq->text[i+1]))
         {
-          /* CSS word seperators, word spacing is only applied on these.*/
+          /* CSS word separators, word spacing is only applied on these.*/
           if (rq->text[i] == 0x0020  || /* Space */
               rq->text[i] == 0x00A0  || /* No Break Space */
               rq->text[i] == 0x1361  || /* Ethiopic Word Space */
-              rq->text[i] == 0x10100 || /* Aegean Word Seperator Line */
-              rq->text[i] == 0x10101 || /* Aegean Word Seperator Dot */
+              rq->text[i] == 0x10100 || /* Aegean Word Separator Line */
+              rq->text[i] == 0x10101 || /* Aegean Word Separator Dot */
               rq->text[i] == 0x1039F || /* Ugaric Word Divider */
               rq->text[i] == 0x1091F)   /* Phoenician Word Separator */
           {
@@ -2167,6 +2169,10 @@ _raqm_ft_transform (int      *x,
   *y = vector.y;
 }
 
+#if !HB_VERSION_ATLEAST (10, 4, 0)
+# define hb_ft_font_get_ft_face hb_ft_font_get_face
+#endif
+
 static bool
 _raqm_shape (raqm_t *rq)
 {
@@ -2199,7 +2205,7 @@ _raqm_shape (raqm_t *rq)
       hb_glyph_position_t *pos;
       unsigned int len;
 
-      FT_Get_Transform (hb_ft_font_get_face (run->font), &matrix, NULL);
+      FT_Get_Transform (hb_ft_font_get_ft_face (run->font), &matrix, NULL);
       pos = hb_buffer_get_glyph_positions (run->buffer, &len);
       info = hb_buffer_get_glyph_infos (run->buffer, &len);
 

From 35c92308ad84b28cb8956b9b19cf6f769a9250e6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 6 Aug 2025 11:41:26 +1000
Subject: [PATCH 1988/2374] Allow RGBA palettes to work with expand()

---
 Tests/test_imageops.py | 15 +++++++++++++++
 src/PIL/ImageOps.py    |  5 +++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 9f2fd5ba257..27ac6f308fc 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -186,6 +186,21 @@ def test_palette(mode: str) -> None:
     )
 
 
+def test_rgba_palette() -> None:
+    im = Image.new("P", (1, 1))
+
+    red = (255, 0, 0, 255)
+    translucent_black = (0, 0, 0, 127)
+    im.putpalette(red + translucent_black, "RGBA")
+
+    expanded_im = ImageOps.expand(im, 1, 1)
+
+    palette = expanded_im.palette
+    assert palette is not None
+    assert palette.mode == "RGBA"
+    assert expanded_im.convert("RGBA").getpixel((0, 0)) == translucent_black
+
+
 def test_pil163() -> None:
     # Division by zero in equalize if < 255 pixels in image (@PIL163)
 
diff --git a/src/PIL/ImageOps.py b/src/PIL/ImageOps.py
index da28854b574..42b10bd7bc8 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -499,14 +499,15 @@ def expand(
     height = top + image.size[1] + bottom
     color = _color(fill, image.mode)
     if image.palette:
-        palette = ImagePalette.ImagePalette(palette=image.getpalette())
+        mode = image.palette.mode
+        palette = ImagePalette.ImagePalette(mode, image.getpalette(mode))
         if isinstance(color, tuple) and (len(color) == 3 or len(color) == 4):
             color = palette.getcolor(color)
     else:
         palette = None
     out = Image.new(image.mode, (width, height), color)
     if palette:
-        out.putpalette(palette.palette)
+        out.putpalette(palette.palette, mode)
     out.paste(image, (left, top))
     return out
 

From d975e312e288630cd25973497afdf92ffdc6ba2e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 8 Aug 2025 05:46:10 +1000
Subject: [PATCH 1989/2374] Updated zlib-ng to 2.2.5

---
 .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 fb86b6c7dbb..920dd1cc6ff 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -102,7 +102,7 @@ XZ_VERSION=5.8.1
 TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_VERSION=1.3.1
-ZLIB_NG_VERSION=2.2.4
+ZLIB_NG_VERSION=2.2.5
 LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 5633519ddb9..86485868c7f 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -126,7 +126,7 @@ def cmd_msbuild(
     "OPENJPEG": "2.5.3",
     "TIFF": "4.7.0",
     "XZ": "5.8.1",
-    "ZLIBNG": "2.2.4",
+    "ZLIBNG": "2.2.5",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
 

From b8ffea2c56808661e460ecb4bca71b8c0a81265b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 8 Aug 2025 06:05:30 +1000
Subject: [PATCH 1990/2374] Revert "Revert to zlib on macOS < 10.15"

This reverts commit 6c7917d7a6031ae22e1d9eaccc2e536123ea25c2.
---
 .github/workflows/wheels-dependencies.sh | 7 +------
 checks/check_wheel.py                    | 3 ---
 2 files changed, 1 insertion(+), 9 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 920dd1cc6ff..c37ef79967b 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -101,7 +101,6 @@ OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.8.1
 TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
-ZLIB_VERSION=1.3.1
 ZLIB_NG_VERSION=2.2.5
 LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
@@ -259,11 +258,7 @@ function build {
     if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
         yum remove -y zlib-devel
     fi
-    if [[ -n "$IS_MACOS" ]] && [[ "$MACOSX_DEPLOYMENT_TARGET" == "10.10" || "$MACOSX_DEPLOYMENT_TARGET" == "10.13" ]]; then
-        build_new_zlib
-    else
-        build_zlib_ng
-    fi
+    build_zlib_ng
 
     build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
     if [[ -n "$IS_MACOS" ]]; then
diff --git a/checks/check_wheel.py b/checks/check_wheel.py
index 937722c4bab..f716c8498bb 100644
--- a/checks/check_wheel.py
+++ b/checks/check_wheel.py
@@ -4,7 +4,6 @@
 import sys
 
 from PIL import features
-from Tests.helper import is_pypy
 
 
 def test_wheel_modules() -> None:
@@ -48,8 +47,6 @@ def test_wheel_features() -> None:
 
     if sys.platform == "win32":
         expected_features.remove("xcb")
-    elif sys.platform == "darwin" and not is_pypy() and platform.processor() != "arm":
-        expected_features.remove("zlib_ng")
     elif sys.platform == "ios":
         # Can't distribute raqm due to licensing, and there's no system version;
         # fribidi and harfbuzz won't be available if raqm isn't available.

From b1cfa7769ba64c0546a25c06fc7b3289a8b041c0 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 9 Aug 2025 07:13:41 +1000
Subject: [PATCH 1991/2374] Update actions/download-artifact action to v5
 (#9141)

---
 .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 5cc4f03552c..d217d929215 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -256,7 +256,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v5
         with:
           pattern: dist-*
           path: dist
@@ -278,7 +278,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v5
         with:
           pattern: dist-*
           path: dist

From ee8fbc0ac9510551f3dea5d24938af8be3b196de Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Aug 2025 14:58:31 +1000
Subject: [PATCH 1992/2374] Make in parallel when building brotli and libavif

---
 .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 fb86b6c7dbb..c79cd2f17d1 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -165,7 +165,7 @@ function build_brotli {
     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_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib $HOST_CMAKE_FLAGS . \
-        && make install)
+        && make -j4 install)
     touch brotli-stamp
 }
 
@@ -249,7 +249,7 @@ function build_libavif {
         cp $WORKDIR/meson-cross.txt $out_dir/crossfile-apple.meson
     fi
 
-    (cd $out_dir && make install)
+    (cd $out_dir && make -j4 install)
 
     touch libavif-stamp
 }

From 5a90fb81cb75c9b33f5505659a9c5aa4f9d7881a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Aug 2025 18:37:17 +1000
Subject: [PATCH 1993/2374] Added checks directory to mypy

---
 tox.ini | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 8933945b1af..d58fd67b613 100644
--- a/tox.ini
+++ b/tox.ini
@@ -30,4 +30,4 @@ skip_install = true
 deps =
     -r .ci/requirements-mypy.txt
 commands =
-    mypy conftest.py selftest.py setup.py docs src winbuild Tests {posargs}
+    mypy conftest.py selftest.py setup.py checks docs src winbuild Tests {posargs}

From f69c221376aebb7a2db019ae46c53814234e9a1e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Aug 2025 18:56:55 +1000
Subject: [PATCH 1994/2374] Do not import from Tests directory

---
 checks/check_imaging_leaks.py |  7 ++++---
 checks/check_j2k_leaks.py     | 11 ++++++-----
 checks/check_jpeg_leaks.py    | 32 +++++++++++++++++---------------
 3 files changed, 27 insertions(+), 23 deletions(-)

diff --git a/checks/check_imaging_leaks.py b/checks/check_imaging_leaks.py
index a1d59ed9c8b..e9f202f3d3b 100755
--- a/checks/check_imaging_leaks.py
+++ b/checks/check_imaging_leaks.py
@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 from __future__ import annotations
 
+import sys
 from collections.abc import Callable
 from typing import Any
 
@@ -8,12 +9,12 @@
 
 from PIL import Image
 
-from .helper import is_win32
-
 min_iterations = 100
 max_iterations = 10000
 
-pytestmark = pytest.mark.skipif(is_win32(), reason="requires Unix or macOS")
+pytestmark = pytest.mark.skipif(
+    sys.platform.startswith("win32"), reason="requires Unix or macOS"
+)
 
 
 def _get_mem_usage() -> float:
diff --git a/checks/check_j2k_leaks.py b/checks/check_j2k_leaks.py
index bbe35b591fc..7103d502e40 100644
--- a/checks/check_j2k_leaks.py
+++ b/checks/check_j2k_leaks.py
@@ -1,12 +1,11 @@
 from __future__ import annotations
 
+import sys
 from io import BytesIO
 
 import pytest
 
-from PIL import Image
-
-from .helper import is_win32, skip_unless_feature
+from PIL import Image, features
 
 # Limits for testing the leak
 mem_limit = 1024 * 1048576
@@ -15,8 +14,10 @@
 test_file = "Tests/images/rgb_trns_ycbc.jp2"
 
 pytestmark = [
-    pytest.mark.skipif(is_win32(), reason="requires Unix or macOS"),
-    skip_unless_feature("jpg_2000"),
+    pytest.mark.skipif(
+        sys.platform.startswith("win32"), reason="requires Unix or macOS"
+    ),
+    pytest.mark.skipif(not features.check("jpg_2000"), reason="jpg_2000 not available"),
 ]
 
 
diff --git a/checks/check_jpeg_leaks.py b/checks/check_jpeg_leaks.py
index 2f42ad734a8..2c27ce1d5af 100644
--- a/checks/check_jpeg_leaks.py
+++ b/checks/check_jpeg_leaks.py
@@ -1,10 +1,11 @@
 from __future__ import annotations
 
+import sys
 from io import BytesIO
 
 import pytest
 
-from .helper import hopper, is_win32
+from PIL import Image
 
 iterations = 5000
 
@@ -18,7 +19,9 @@
 """
 
 
-pytestmark = pytest.mark.skipif(is_win32(), reason="requires Unix or macOS")
+pytestmark = pytest.mark.skipif(
+    sys.platform.startswith("win32"), reason="requires Unix or macOS"
+)
 
 """
 pre patch:
@@ -112,10 +115,10 @@
     ),
 )
 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)
+    with Image.open("Tests/images/hopper.ppm") as im:
+        for _ in range(iterations):
+            test_output = BytesIO()
+            im.save(test_output, "JPEG", qtables=qtables)
 
 
 def test_exif_leak() -> None:
@@ -173,12 +176,12 @@ def test_exif_leak() -> None:
        0 +----------------------------------------------------------------------->Gi
          0                                                                   11.33
     """
-    im = hopper("RGB")
     exif = b"12345678" * 4096
 
-    for _ in range(iterations):
-        test_output = BytesIO()
-        im.save(test_output, "JPEG", exif=exif)
+    with Image.open("Tests/images/hopper.ppm") as im:
+        for _ in range(iterations):
+            test_output = BytesIO()
+            im.save(test_output, "JPEG", exif=exif)
 
 
 def test_base_save() -> None:
@@ -207,8 +210,7 @@ def test_base_save() -> None:
          | :@ @@ @ # : : :: :: @:: :::: :::: :::: : : : : : : :::::::::::: :::@:::
        0 +----------------------------------------------------------------------->Gi
          0                                                                   7.882"""
-    im = hopper("RGB")
-
-    for _ in range(iterations):
-        test_output = BytesIO()
-        im.save(test_output, "JPEG")
+    with Image.open("Tests/images/hopper.ppm") as im:
+        for _ in range(iterations):
+            test_output = BytesIO()
+            im.save(test_output, "JPEG")

From 1a5acabd32fcb505350c84e35dc78319c3f63899 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 9 Aug 2025 19:53:05 +1000
Subject: [PATCH 1995/2374] Make in parallel when building libjpeg-turbo and
 openjpeg

---
 wheels/multibuild | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/wheels/multibuild b/wheels/multibuild
index 42d761728d1..64739327166 160000
--- a/wheels/multibuild
+++ b/wheels/multibuild
@@ -1 +1 @@
-Subproject commit 42d761728d141d8462cd9943f4329f12fe62b155
+Subproject commit 64739327166fcad1fa41ad9b23fa910fa244c84f

From 5e7f1312874dfd01a7b03af26b5f836bf0aa65ac Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 11 Aug 2025 10:40:32 +0300
Subject: [PATCH 1996/2374] Add Debian 13 Trixie (#9147)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 .github/workflows/test-docker.yml      | 2 ++
 docs/installation/platform-support.rst | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 0b90732eba7..47f2d3f0ae7 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -47,6 +47,8 @@ jobs:
           centos-stream-10-amd64,
           debian-12-bookworm-x86,
           debian-12-bookworm-amd64,
+          debian-13-trixie-x86,
+          debian-13-trixie-amd64,
           fedora-41-amd64,
           fedora-42-amd64,
           gentoo,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 5cf0276d188..d97895c8644 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -31,6 +31,8 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Debian 12 Bookworm               | 3.11                       | x86, x86-64         |
 +----------------------------------+----------------------------+---------------------+
+| Debian 13 Trixie                 | 3.13                       | x86, x86-64         |
++----------------------------------+----------------------------+---------------------+
 | Fedora 41                        | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Fedora 42                        | 3.13                       | x86-64              |

From a72c6318771ca8e385a5dcd5a72a721df403dc21 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 12 Aug 2025 12:36:33 +1000
Subject: [PATCH 1997/2374] Updated URLs

---
 .github/zizmor.yml      | 2 +-
 .pre-commit-config.yaml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/zizmor.yml b/.github/zizmor.yml
index 5bdc48c301b..b567097811a 100644
--- a/.github/zizmor.yml
+++ b/.github/zizmor.yml
@@ -1,5 +1,5 @@
 # Configuration for the zizmor static analysis tool, run via pre-commit in CI
-# https://woodruffw.github.io/zizmor/configuration/
+# https://docs.zizmor.sh/configuration/
 rules:
   unpinned-uses:
     config:
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index cff17cd361a..2be509d54de 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -57,7 +57,7 @@ repos:
       - id: check-readthedocs
       - id: check-renovate
 
-  - repo: https://github.com/woodruffw/zizmor-pre-commit
+  - repo: https://github.com/zizmorcore/zizmor-pre-commit
     rev: v1.11.0
     hooks:
       - id: zizmor

From 6d974b61d6144fab9e65aff1b84bedd377737db8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 15 Aug 2025 14:37:31 +1000
Subject: [PATCH 1998/2374] Load image palette into Python after converting to
 PA

---
 Tests/test_image_convert.py | 8 ++++++++
 src/PIL/Image.py            | 2 +-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 33f8444378d..7ba3fb55536 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -107,6 +107,14 @@ def test_rgba_p() -> None:
     assert_image_similar(im, comparable, 20)
 
 
+def test_pa() -> None:
+    im = hopper().convert("PA")
+
+    palette = im.palette
+    assert palette is not None
+    assert palette.colors != {}
+
+
 def test_rgba() -> None:
     with Image.open("Tests/images/transparent.png") as im:
         assert im.mode == "RGBA"
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b7c185e0d6e..b435b17ece1 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1143,7 +1143,7 @@ def convert_transparency(
                 raise ValueError(msg) from e
 
         new_im = self._new(im)
-        if mode == "P" and palette != Palette.ADAPTIVE:
+        if mode in ("P", "PA") and palette != Palette.ADAPTIVE:
             from . import ImagePalette
 
             new_im.palette = ImagePalette.ImagePalette("RGB", im.getpalette("RGB"))

From 0ae2611b4438c847054d43d54ff21366eb1456bd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 15 Aug 2025 15:56:56 +1000
Subject: [PATCH 1999/2374] Copy C palette when merging

---
 Tests/test_image.py | 6 ++++++
 src/_imaging.c      | 7 ++++++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index 83b027aa238..4b8ef02cd10 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1076,6 +1076,12 @@ def test_apply_transparency(self) -> None:
             assert im.palette is not None
             assert im.palette.colors[(27, 35, 6, 214)] == 24
 
+    def test_merge_pa(self) -> None:
+        p = hopper("P")
+        a = Image.new("L", p.size)
+        pa = Image.merge("PA", (p, a))
+        assert p.getpalette() == pa.getpalette()
+
     def test_constants(self) -> None:
         for enum in (
             Image.Transpose,
diff --git a/src/_imaging.c b/src/_imaging.c
index fbfc0e41ae2..6ab8e010d8c 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -2419,7 +2419,12 @@ _merge(PyObject *self, PyObject *args) {
         bands[3] = band3->image;
     }
 
-    return PyImagingNew(ImagingMerge(mode, bands));
+    Imaging imOut = ImagingMerge(mode, bands);
+    if (!imOut) {
+        return NULL;
+    }
+    ImagingCopyPalette(imOut, bands[0]);
+    return PyImagingNew(imOut);
 }
 
 static PyObject *

From ba66fec3d242fc1a8b287ba00baaed766b60786a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 15 Aug 2025 23:39:33 +1000
Subject: [PATCH 2000/2374] When converting RGBA to PA, use RGB to P
 quantization

---
 Tests/test_image_convert.py |  7 +++++++
 src/PIL/Image.py            | 10 ++++++++--
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 33f8444378d..6c7026d47eb 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -107,6 +107,13 @@ def test_rgba_p() -> None:
     assert_image_similar(im, comparable, 20)
 
 
+def test_rgba_pa() -> None:
+    im = hopper("RGBA").convert("PA").convert("RGB")
+    expected = hopper("RGB")
+
+    assert_image_similar(im, expected, 9.3)
+
+
 def test_rgba() -> None:
     with Image.open("Tests/images/transparent.png") as im:
         assert im.mode == "RGBA"
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b7c185e0d6e..55309adbc07 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1010,8 +1010,14 @@ def convert_transparency(
                 new_im.info["transparency"] = transparency
             return new_im
 
-        if mode == "P" and self.mode == "RGBA":
-            return self.quantize(colors)
+        if self.mode == "RGBA":
+            if mode == "P":
+                return self.quantize(colors)
+            elif mode == "PA":
+                r, g, b, a = self.split()
+                rgb = merge("RGB", (r, g, b))
+                p = rgb.quantize(colors)
+                return merge("PA", (p, a))
 
         trns = None
         delete_trns = False

From 425a3a1af07c262f39e6f0d4fd5fa47e7f711859 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 16 Aug 2025 11:33:02 +1000
Subject: [PATCH 2001/2374] Updated macOS version in CI targets

---
 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 d97895c8644..3c5e4cd519f 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -41,7 +41,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | macOS 13 Ventura                 | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 14 Sonoma                  | 3.11, 3.12, 3.13, 3.14     | arm64               |
+| macOS 15 Sequoia                 | 3.11, 3.12, 3.13, 3.14     | arm64               |
 |                                  | PyPy3                      |                     |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.10                       | x86-64              |

From 62546924b5c890c4b7eebb163afc11fd8a71f0d7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 18 Aug 2025 08:07:12 +1000
Subject: [PATCH 2002/2374] Remove support for FreeType <= 2.9.0

---
 src/PIL/ImageFont.py | 18 +++---------------
 src/_imagingft.c     |  6 ------
 2 files changed, 3 insertions(+), 21 deletions(-)

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index bf3f471f5e3..a2bf9ccf92b 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -671,11 +671,7 @@ 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.
         """
-        try:
-            names = self.font.getvarnames()
-        except AttributeError as e:
-            msg = "FreeType 2.9.1 or greater is required"
-            raise NotImplementedError(msg) from e
+        names = self.font.getvarnames()
         return [name.replace(b"\x00", b"") for name in names]
 
     def set_variation_by_name(self, name: str | bytes) -> None:
@@ -702,11 +698,7 @@ 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.
         """
-        try:
-            axes = self.font.getvaraxes()
-        except AttributeError as e:
-            msg = "FreeType 2.9.1 or greater is required"
-            raise NotImplementedError(msg) from e
+        axes = self.font.getvaraxes()
         for axis in axes:
             if axis["name"]:
                 axis["name"] = axis["name"].replace(b"\x00", b"")
@@ -717,11 +709,7 @@ 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.
         """
-        try:
-            self.font.setvaraxes(axes)
-        except AttributeError as e:
-            msg = "FreeType 2.9.1 or greater is required"
-            raise NotImplementedError(msg) from e
+        self.font.setvaraxes(axes)
 
 
 class TransposedFont:
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 29d8e9e7112..c9938fd3eac 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1221,8 +1221,6 @@ font_render(FontObject *self, PyObject *args) {
     return NULL;
 }
 
-#if FREETYPE_MAJOR > 2 || (FREETYPE_MAJOR == 2 && FREETYPE_MINOR > 9) || \
-    (FREETYPE_MAJOR == 2 && FREETYPE_MINOR == 9 && FREETYPE_PATCH == 1)
 static PyObject *
 font_getvarnames(FontObject *self) {
     int error;
@@ -1432,7 +1430,6 @@ font_setvaraxes(FontObject *self, PyObject *args) {
 
     Py_RETURN_NONE;
 }
-#endif
 
 static void
 font_dealloc(FontObject *self) {
@@ -1451,13 +1448,10 @@ static PyMethodDef font_methods[] = {
     {"render", (PyCFunction)font_render, METH_VARARGS},
     {"getsize", (PyCFunction)font_getsize, METH_VARARGS},
     {"getlength", (PyCFunction)font_getlength, METH_VARARGS},
-#if FREETYPE_MAJOR > 2 || (FREETYPE_MAJOR == 2 && FREETYPE_MINOR > 9) || \
-    (FREETYPE_MAJOR == 2 && FREETYPE_MINOR == 9 && FREETYPE_PATCH == 1)
     {"getvarnames", (PyCFunction)font_getvarnames, METH_NOARGS},
     {"getvaraxes", (PyCFunction)font_getvaraxes, METH_NOARGS},
     {"setvarname", (PyCFunction)font_setvarname, METH_VARARGS},
     {"setvaraxes", (PyCFunction)font_setvaraxes, METH_VARARGS},
-#endif
     {NULL, NULL}
 };
 

From c214ad8c8d40c785c8aca6226b5033085f24cb3d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 19 Aug 2025 06:43:07 +1000
Subject: [PATCH 2003/2374] Use macos-14 for iOS arm64 simulator (#9161)

---
 .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 d217d929215..d5aacb162fd 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -99,7 +99,7 @@ jobs:
             cibw_arch: arm64_iphoneos
           - name: "iOS arm64 simulator"
             platform: ios
-            os: macos-latest
+            os: macos-14
             cibw_arch: arm64_iphonesimulator
           - name: "iOS x86_64 simulator"
             platform: ios

From 1435339290f8112999dfa85a07718cdac2ce2cfc Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 19 Aug 2025 10:13:56 +1000
Subject: [PATCH 2004/2374] Update actions/checkout action to v5 (#9156)

---
 .github/workflows/docs.yml                 | 2 +-
 .github/workflows/lint.yml                 | 2 +-
 .github/workflows/test-docker.yml          | 2 +-
 .github/workflows/test-mingw.yml           | 2 +-
 .github/workflows/test-valgrind-memory.yml | 2 +-
 .github/workflows/test-valgrind.yml        | 2 +-
 .github/workflows/test-windows.yml         | 6 +++---
 .github/workflows/test.yml                 | 2 +-
 .github/workflows/wheels.yml               | 8 ++++----
 9 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 626824f3830..761dc112520 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -32,7 +32,7 @@ jobs:
     name: Docs
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 8e789a73489..9827ef1cd7e 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -20,7 +20,7 @@ jobs:
     name: Lint
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 47f2d3f0ae7..30e5c494db9 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -68,7 +68,7 @@ jobs:
     name: ${{ matrix.docker }}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index 5a83c16c329..6c4206083c5 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -45,7 +45,7 @@ jobs:
 
     steps:
       - name: Checkout Pillow
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           persist-credentials: false
 
diff --git a/.github/workflows/test-valgrind-memory.yml b/.github/workflows/test-valgrind-memory.yml
index e6a5f6e779f..0f36fe30dc2 100644
--- a/.github/workflows/test-valgrind-memory.yml
+++ b/.github/workflows/test-valgrind-memory.yml
@@ -41,7 +41,7 @@ jobs:
     name: ${{ matrix.docker }}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-valgrind.yml b/.github/workflows/test-valgrind.yml
index 8818b3b2357..30caa0d4e51 100644
--- a/.github/workflows/test-valgrind.yml
+++ b/.github/workflows/test-valgrind.yml
@@ -39,7 +39,7 @@ jobs:
     name: ${{ matrix.docker }}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index c80bb6eb602..d55a8e5f51f 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -47,19 +47,19 @@ jobs:
 
     steps:
     - name: Checkout Pillow
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
       with:
         persist-credentials: false
 
     - name: Checkout cached dependencies
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
       with:
         persist-credentials: false
         repository: python-pillow/pillow-depends
         path: winbuild\depends
 
     - name: Checkout extra test images
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
       with:
         persist-credentials: false
         repository: python-pillow/test-images
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 0fad22a03c4..b17d08892a1 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -65,7 +65,7 @@ jobs:
     name: ${{ matrix.os }} Python ${{ matrix.python-version }}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index d5aacb162fd..24e78f965c5 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -106,7 +106,7 @@ jobs:
             os: macos-13
             cibw_arch: x86_64_iphonesimulator
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           persist-credentials: false
           submodules: true
@@ -153,12 +153,12 @@ jobs:
           - cibw_arch: ARM64
             os: windows-11-arm
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           persist-credentials: false
 
       - name: Checkout extra test images
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           persist-credentials: false
           repository: python-pillow/test-images
@@ -234,7 +234,7 @@ jobs:
     if: github.event_name != 'schedule'
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v5
       with:
         persist-credentials: false
 

From c826b932c07522272eb1297a595c8c90726970db Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 19 Aug 2025 15:45:42 +1000
Subject: [PATCH 2005/2374] Document MAXBLOCK

---
 docs/reference/ImageFile.rst |  1 +
 src/PIL/ImageFile.py         | 12 ++++++++++++
 2 files changed, 13 insertions(+)

diff --git a/docs/reference/ImageFile.rst b/docs/reference/ImageFile.rst
index 043559352ab..4c34ff8128b 100644
--- a/docs/reference/ImageFile.rst
+++ b/docs/reference/ImageFile.rst
@@ -74,5 +74,6 @@ Constants
 ---------
 
 .. autodata:: PIL.ImageFile.LOAD_TRUNCATED_IMAGES
+.. autodata:: PIL.ImageFile.MAXBLOCK
 .. autodata:: PIL.ImageFile.ERRORS
     :annotation:
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 27b27127e79..e33b846d416 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -46,6 +46,18 @@
 logger = logging.getLogger(__name__)
 
 MAXBLOCK = 65536
+"""
+By default, Pillow processes image data in blocks. This helps to prevent excessive use
+of resources. Codecs may disable this behaviour with ``_pulls_fd`` or ``_pushes_fd``.
+
+When reading an image, this is the number of bytes to read at once.
+
+When writing an image, this is the number of bytes to write at once.
+If the image width times 4 is greater, then that will be used instead.
+Plugins may also set a greater number.
+
+User code may set this to another number.
+"""
 
 SAFEBLOCK = 1024 * 1024
 

From 34c651deb8390ef752425a31e1473af4d6c9db3d Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 20 Aug 2025 08:48:38 +1000
Subject: [PATCH 2006/2374] Update dependency cibuildwheel to v3.1.4 (#9164)

---
 .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 9f91365576e..d87d7956f75 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.1.3
+cibuildwheel==3.1.4

From 6a3bde05a46a8326fe02fb53fcab5a6f915d7193 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 20 Aug 2025 15:32:12 +1000
Subject: [PATCH 2007/2374] Do not set core to DeferredError

---
 src/PIL/Image.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b7c185e0d6e..683c807622d 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -103,7 +103,6 @@ class DecompressionBombError(Exception):
         raise ImportError(msg)
 
 except ImportError as v:
-    core = DeferredError.new(ImportError("The _imaging C module is not installed."))
     # Explanations for ways that we know we might have an import error
     if str(v).startswith("Module use of python"):
         # The _imaging C module is present, but not compiled for

From 009444f9c51d2d008fd0256769c93a7c2acb670a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 21 Aug 2025 21:56:03 +1000
Subject: [PATCH 2008/2374] Improved _accept length check

---
 src/PIL/FliImagePlugin.py      | 2 +-
 src/PIL/GribStubImagePlugin.py | 2 +-
 src/PIL/PcxImagePlugin.py      | 2 +-
 src/PIL/PpmImagePlugin.py      | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index 7c5bfeefa1b..ccb8a5953d6 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -30,7 +30,7 @@
 
 def _accept(prefix: bytes) -> bool:
     return (
-        len(prefix) >= 6
+        len(prefix) >= 16
         and i16(prefix, 4) in [0xAF11, 0xAF12]
         and i16(prefix, 14) in [0, 3]  # flags
     )
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index 439fc5a3eda..dfa798893cb 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -33,7 +33,7 @@ def register_handler(handler: ImageFile.StubHandler | None) -> None:
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix.startswith(b"GRIB") and prefix[7] == 1
+    return len(prefix) >= 8 and prefix.startswith(b"GRIB") and prefix[7] == 1
 
 
 class GribStubImageFile(ImageFile.StubImageFile):
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 458d586c463..6b16d538537 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -39,7 +39,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix[0] == 10 and prefix[1] in [0, 2, 3, 5]
+    return len(prefix) >= 2 and prefix[0] == 10 and prefix[1] in [0, 2, 3, 5]
 
 
 ##
diff --git a/src/PIL/PpmImagePlugin.py b/src/PIL/PpmImagePlugin.py
index db34d107a4f..307bc97ff65 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -47,7 +47,7 @@
 
 
 def _accept(prefix: bytes) -> bool:
-    return prefix.startswith(b"P") and prefix[1] in b"0123456fy"
+    return len(prefix) >= 2 and prefix.startswith(b"P") and prefix[1] in b"0123456fy"
 
 
 ##

From 84122a20c70589ee4d68986507b9b54c91a19620 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Aug 2025 18:29:25 +1000
Subject: [PATCH 2009/2374] Replaced print with assert

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

diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index ef54deeeb2b..f6acb3affb6 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -28,15 +28,13 @@ def to_image(dtype: npt.DTypeLike, bands: int = 1, boolean: int = 0) -> Image.Im
             a = numpy.array(data, dtype=dtype)
             a.shape = TEST_IMAGE_SIZE
             i = Image.fromarray(a)
-            if list(i.getdata()) != data:
-                print("data mismatch for", dtype)
+            assert list(i.getdata()) == data
         else:
             data = list(range(100))
             a = numpy.array([[x] * bands for x in data], dtype=dtype)
             a.shape = TEST_IMAGE_SIZE[0], TEST_IMAGE_SIZE[1], bands
             i = Image.fromarray(a)
-            if list(i.getchannel(0).getdata()) != list(range(100)):
-                print("data mismatch for", dtype)
+            assert list(i.getchannel(0).getdata()) == list(range(100))
         return i
 
     # Check supported 1-bit integer formats

From 54f4a346ef89e33eec0f889569a6d280eca70656 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Aug 2025 19:06:19 +1000
Subject: [PATCH 2010/2374] Added has_feature_version

---
 Tests/helper.py                  |  8 ++++++++
 Tests/test_file_webp_animated.py | 18 ++++++------------
 Tests/test_image_quantize.py     | 18 ++++++++++--------
 3 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index e0dc8a9d4aa..dbdd30b426a 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -175,6 +175,14 @@ def skip_unless_feature(feature: str) -> pytest.MarkDecorator:
     return pytest.mark.skipif(not features.check(feature), reason=reason)
 
 
+def has_feature_version(feature: str, required: str) -> bool:
+    version = features.version(feature)
+    assert version is not None
+    version_required = parse_version(required)
+    version_available = parse_version(version)
+    return version_available >= version_required
+
+
 def skip_unless_feature_version(
     feature: str, required: str, reason: str | None = None
 ) -> pytest.MarkDecorator:
diff --git a/Tests/test_file_webp_animated.py b/Tests/test_file_webp_animated.py
index 5037613742b..600448fb9e1 100644
--- a/Tests/test_file_webp_animated.py
+++ b/Tests/test_file_webp_animated.py
@@ -4,13 +4,13 @@
 from pathlib import Path
 
 import pytest
-from packaging.version import parse as parse_version
 
-from PIL import GifImagePlugin, Image, WebPImagePlugin, features
+from PIL import GifImagePlugin, Image, WebPImagePlugin
 
 from .helper import (
     assert_image_equal,
     assert_image_similar,
+    has_feature_version,
     is_big_endian,
     skip_unless_feature,
 )
@@ -53,11 +53,8 @@ def test_write_animation_L(tmp_path: Path) -> None:
             im.load()
             assert_image_similar(im, orig.convert("RGBA"), 32.9)
 
-            if is_big_endian():
-                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")
+            if is_big_endian() and not has_feature_version("webp", "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)
             orig.load()
@@ -81,11 +78,8 @@ def check(temp_file: Path) -> None:
             assert_image_equal(im, frame1.convert("RGBA"))
 
             # Compare second frame to original
-            if is_big_endian():
-                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")
+            if is_big_endian() and not has_feature_version("webp", "1.2.2"):
+                pytest.skip("Fails with libwebp earlier than 1.2.2")
             im.seek(1)
             im.load()
             assert_image_equal(im, frame2.convert("RGBA"))
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index 6d313cb8cb3..d847c74403e 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -1,11 +1,16 @@
 from __future__ import annotations
 
 import pytest
-from packaging.version import parse as parse_version
 
-from PIL import Image, features
+from PIL import Image
 
-from .helper import assert_image_similar, hopper, is_ppc64le, skip_unless_feature
+from .helper import (
+    assert_image_similar,
+    has_feature_version,
+    hopper,
+    is_ppc64le,
+    skip_unless_feature,
+)
 
 
 def test_sanity() -> None:
@@ -23,11 +28,8 @@ def test_sanity() -> None:
 @skip_unless_feature("libimagequant")
 def test_libimagequant_quantize() -> None:
     image = hopper()
-    if is_ppc64le():
-        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")
+    if is_ppc64le() and not has_feature_version("libimagequant", "4"):
+        pytest.skip("Fails with libimagequant earlier than 4.0.0 on ppc64le")
     converted = image.quantize(100, Image.Quantize.LIBIMAGEQUANT)
     assert converted.mode == "P"
     assert_image_similar(converted.convert("RGB"), image, 15)

From f80ac8d6b8915a7150d6179798e284f6002b8bd9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 22 Aug 2025 19:16:38 +1000
Subject: [PATCH 2011/2374] Check version independently

---
 Tests/test_imagefontctl.py | 81 ++++++++++++++++----------------------
 1 file changed, 33 insertions(+), 48 deletions(-)

diff --git a/Tests/test_imagefontctl.py b/Tests/test_imagefontctl.py
index 5954de87429..95af3fda8c4 100644
--- a/Tests/test_imagefontctl.py
+++ b/Tests/test_imagefontctl.py
@@ -7,6 +7,7 @@
 from .helper import (
     assert_image_equal_tofile,
     assert_image_similar_tofile,
+    has_feature_version,
     skip_unless_feature,
 )
 
@@ -104,11 +105,9 @@ def test_text_direction_ttb() -> None:
 
     im = Image.new(mode="RGB", size=(100, 300))
     draw = ImageDraw.Draw(im)
-    try:
-        draw.text((0, 0), "English あい", font=ttf, fill=500, direction="ttb")
-    except ValueError as ex:
-        if str(ex) == "libraqm 0.7 or greater required for 'ttb' direction":
-            pytest.skip("libraqm 0.7 or greater not available")
+    if not has_feature_version("raqm", "0.7"):
+        pytest.skip("libraqm 0.7 or greater not available")
+    draw.text((0, 0), "English あい", font=ttf, fill=500, direction="ttb")
 
     target = "Tests/images/test_direction_ttb.png"
     assert_image_similar_tofile(im, target, 2.8)
@@ -119,19 +118,17 @@ def test_text_direction_ttb_stroke() -> None:
 
     im = Image.new(mode="RGB", size=(100, 300))
     draw = ImageDraw.Draw(im)
-    try:
-        draw.text(
-            (27, 27),
-            "あい",
-            font=ttf,
-            fill=500,
-            direction="ttb",
-            stroke_width=2,
-            stroke_fill="#0f0",
-        )
-    except ValueError as ex:
-        if str(ex) == "libraqm 0.7 or greater required for 'ttb' direction":
-            pytest.skip("libraqm 0.7 or greater not available")
+    if not has_feature_version("raqm", "0.7"):
+        pytest.skip("libraqm 0.7 or greater not available")
+    draw.text(
+        (27, 27),
+        "あい",
+        font=ttf,
+        fill=500,
+        direction="ttb",
+        stroke_width=2,
+        stroke_fill="#0f0",
+    )
 
     target = "Tests/images/test_direction_ttb_stroke.png"
     assert_image_similar_tofile(im, target, 19.4)
@@ -219,14 +216,9 @@ def test_getlength(
     im = Image.new(mode, (1, 1), 0)
     d = ImageDraw.Draw(im)
 
-    try:
-        assert d.textlength(text, ttf, direction) == expected
-    except ValueError as ex:
-        if (
-            direction == "ttb"
-            and str(ex) == "libraqm 0.7 or greater required for 'ttb' direction"
-        ):
-            pytest.skip("libraqm 0.7 or greater not available")
+    if direction == "ttb" and not has_feature_version("raqm", "0.7"):
+        pytest.skip("libraqm 0.7 or greater not available")
+    assert d.textlength(text, ttf, direction) == expected
 
 
 @pytest.mark.parametrize("mode", ("L", "1"))
@@ -242,17 +234,12 @@ def test_getlength_combine(mode: str, direction: str, text: str) -> None:
 
     ttf = ImageFont.truetype("Tests/fonts/NotoSans-Regular.ttf", 48)
 
-    try:
-        target = ttf.getlength("ii", mode, direction)
-        actual = ttf.getlength(text, mode, direction)
+    if direction == "ttb" and not has_feature_version("raqm", "0.7"):
+        pytest.skip("libraqm 0.7 or greater not available")
+    target = ttf.getlength("ii", mode, direction)
+    actual = ttf.getlength(text, mode, direction)
 
-        assert actual == target
-    except ValueError as ex:
-        if (
-            direction == "ttb"
-            and str(ex) == "libraqm 0.7 or greater required for 'ttb' direction"
-        ):
-            pytest.skip("libraqm 0.7 or greater not available")
+    assert actual == target
 
 
 @pytest.mark.parametrize("anchor", ("lt", "mm", "rb", "sm"))
@@ -265,11 +252,9 @@ def test_anchor_ttb(anchor: str) -> None:
     d = ImageDraw.Draw(im)
     d.line(((0, 200), (200, 200)), "gray")
     d.line(((100, 0), (100, 400)), "gray")
-    try:
-        d.text((100, 200), text, fill="black", anchor=anchor, direction="ttb", font=f)
-    except ValueError as ex:
-        if str(ex) == "libraqm 0.7 or greater required for 'ttb' direction":
-            pytest.skip("libraqm 0.7 or greater not available")
+    if not has_feature_version("raqm", "0.7"):
+        pytest.skip("libraqm 0.7 or greater not available")
+    d.text((100, 200), text, fill="black", anchor=anchor, direction="ttb", font=f)
 
     assert_image_similar_tofile(im, path, 1)  # fails at 5
 
@@ -310,10 +295,12 @@ def test_anchor_ttb(anchor: str) -> None:
 
 # this tests various combining characters for anchor alignment and clipping
 @pytest.mark.parametrize(
-    "name, text, anchor, dir, epsilon", combine_tests, ids=[r[0] for r in combine_tests]
+    "name, text, anchor, direction, epsilon",
+    combine_tests,
+    ids=[r[0] for r in combine_tests],
 )
 def test_combine(
-    name: str, text: str, dir: str | None, anchor: str | None, epsilon: float
+    name: str, text: str, direction: 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)
@@ -322,11 +309,9 @@ def test_combine(
     d = ImageDraw.Draw(im)
     d.line(((0, 200), (400, 200)), "gray")
     d.line(((200, 0), (200, 400)), "gray")
-    try:
-        d.text((200, 200), text, fill="black", anchor=anchor, direction=dir, font=f)
-    except ValueError as ex:
-        if str(ex) == "libraqm 0.7 or greater required for 'ttb' direction":
-            pytest.skip("libraqm 0.7 or greater not available")
+    if direction == "ttb" and not has_feature_version("raqm", "0.7"):
+        pytest.skip("libraqm 0.7 or greater not available")
+    d.text((200, 200), text, fill="black", anchor=anchor, direction=direction, font=f)
 
     assert_image_similar_tofile(im, path, epsilon)
 

From 0d72707d4f1da4f72ee6b5ece10d13080f877796 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 26 Aug 2025 08:55:11 +1000
Subject: [PATCH 2012/2374] Removed version from PDF comment

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

diff --git a/src/PIL/PdfImagePlugin.py b/src/PIL/PdfImagePlugin.py
index e9c20ddc159..5594c7e0f2b 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -27,7 +27,7 @@
 import time
 from typing import IO, Any
 
-from . import Image, ImageFile, ImageSequence, PdfParser, __version__, features
+from . import Image, ImageFile, ImageSequence, PdfParser, features
 
 #
 # --------------------------------------------------------------------
@@ -221,7 +221,7 @@ def _save(
 
     existing_pdf.start_writing()
     existing_pdf.write_header()
-    existing_pdf.write_comment(f"created by Pillow {__version__} PDF driver")
+    existing_pdf.write_comment("created by Pillow PDF driver")
 
     #
     # pages

From 59d6f313d6e70f78e41a6e8c3c8848553a0e37c7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 26 Aug 2025 21:07:32 +1000
Subject: [PATCH 2013/2374] Removed setuptools version requirement

---
 .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 3519707f14c..99eac602796 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -11,4 +11,4 @@ sphinx
 types-atheris
 types-defusedxml
 types-olefile
-types-setuptools>=75.2.0
+types-setuptools

From ed164d1bfab8a59d411aadab7d56d1ec116f572a Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 26 Aug 2025 22:13:45 +1000
Subject: [PATCH 2014/2374] pre-commit fixes

---
 setup.py                  |  2 +-
 src/_imaging.c            |  3 ++-
 src/libImaging/Filter.c   |  6 ++++--
 src/libImaging/Pack.c     |  6 ++++--
 src/libImaging/Resample.c |  6 ++++--
 src/libImaging/Unpack.c   | 14 +++++++++++---
 6 files changed, 26 insertions(+), 11 deletions(-)

diff --git a/setup.py b/setup.py
index dcc07eaf691..b9f5cfe0610 100644
--- a/setup.py
+++ b/setup.py
@@ -16,7 +16,7 @@
 import sys
 import warnings
 from collections.abc import Iterator
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING
 
 from pybind11.setup_helpers import ParallelCompile
 from setuptools import Extension, setup
diff --git a/src/_imaging.c b/src/_imaging.c
index 7823745f0d6..8412124c191 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1677,7 +1677,8 @@ _putdata(ImagingObject *self, PyObject *args) {
             int bigendian = 0;
             if (image->type == IMAGING_TYPE_SPECIAL) {
                 // I;16*
-                if (image->mode == IMAGING_MODE_I_16B
+                if (
+                    image->mode == IMAGING_MODE_I_16B
 #ifdef WORDS_BIGENDIAN
                     || image->mode == IMAGING_MODE_I_16N
 #endif
diff --git a/src/libImaging/Filter.c b/src/libImaging/Filter.c
index 48f21080906..cefb8fcdc36 100644
--- a/src/libImaging/Filter.c
+++ b/src/libImaging/Filter.c
@@ -155,7 +155,8 @@ ImagingFilter3x3(Imaging imOut, Imaging im, const float *kernel, float offset) {
         } else {
             int bigendian = 0;
             if (im->type == IMAGING_TYPE_SPECIAL) {
-                if (im->mode == IMAGING_MODE_I_16B
+                if (
+                    im->mode == IMAGING_MODE_I_16B
 #ifdef WORDS_BIGENDIAN
                     || im->mode == IMAGING_MODE_I_16N
 #endif
@@ -308,7 +309,8 @@ ImagingFilter5x5(Imaging imOut, Imaging im, const float *kernel, float offset) {
         } else {
             int bigendian = 0;
             if (im->type == IMAGING_TYPE_SPECIAL) {
-                if (im->mode == IMAGING_MODE_I_16B
+                if (
+                    im->mode == IMAGING_MODE_I_16B
 #ifdef WORDS_BIGENDIAN
                     || im->mode == IMAGING_MODE_I_16N
 #endif
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index 0a97c4872f9..4afeb15b7f6 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -648,8 +648,10 @@ static struct {
     {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
     {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
     {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
-    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16
-    },  // LibTiff native->image endian.
+    {IMAGING_MODE_I_16,
+     IMAGING_RAWMODE_I_16N,
+     16,
+     packI16N_I16},  // LibTiff native->image endian.
     {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
     {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B}
 };
diff --git a/src/libImaging/Resample.c b/src/libImaging/Resample.c
index 3ab43a8955a..cbd18d0c116 100644
--- a/src/libImaging/Resample.c
+++ b/src/libImaging/Resample.c
@@ -470,7 +470,8 @@ ImagingResampleHorizontal_16bpc(
     double *k;
 
     int bigendian = 0;
-    if (imIn->mode == IMAGING_MODE_I_16N
+    if (
+        imIn->mode == IMAGING_MODE_I_16N
 #ifdef WORDS_BIGENDIAN
         || imIn->mode == IMAGING_MODE_I_16B
 #endif
@@ -509,7 +510,8 @@ ImagingResampleVertical_16bpc(
     double *k;
 
     int bigendian = 0;
-    if (imIn->mode == IMAGING_MODE_I_16N
+    if (
+        imIn->mode == IMAGING_MODE_I_16N
 #ifdef WORDS_BIGENDIAN
         || imIn->mode == IMAGING_MODE_I_16B
 #endif
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 075ec5b950b..27ac7c46730 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1833,13 +1833,21 @@ static struct {
     {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
 
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, unpackI16B_I16},
-    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16},   // LibTiff native->image endian.
-    {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16},  // LibTiff native->image endian.
+    {IMAGING_MODE_I_16,
+     IMAGING_RAWMODE_I_16N,
+     16,
+     unpackI16N_I16},  // LibTiff native->image endian.
+    {
+        IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16
+    },  // LibTiff native->image endian.
     {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16B},
 
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16R, 16, unpackI16R_I16},
 
-    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_12, 12, unpackI12_I16}  // 12 bit Tiffs stored in 16bits.
+    {IMAGING_MODE_I_16,
+     IMAGING_RAWMODE_I_12,
+     12,
+     unpackI12_I16}  // 12 bit Tiffs stored in 16bits.
 };
 
 ImagingShuffler

From 178b3a70ccafd2fb81438cad2ebe8bb2a16ef67d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 27 Aug 2025 06:58:51 +1000
Subject: [PATCH 2015/2374] Updated formatting

---
 src/libImaging/Pack.c   |  6 ++----
 src/libImaging/Unpack.c | 19 ++++++-------------
 2 files changed, 8 insertions(+), 17 deletions(-)

diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index 4afeb15b7f6..fdf5a72aa9e 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -648,10 +648,8 @@ static struct {
     {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16B, 16, copy2},
     {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16L, 16, copy2},
     {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
-    {IMAGING_MODE_I_16,
-     IMAGING_RAWMODE_I_16N,
-     16,
-     packI16N_I16},  // LibTiff native->image endian.
+    // LibTiff native->image endian.
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
     {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, packI16N_I16},
     {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, packI16N_I16B}
 };
diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index 27ac7c46730..ab5f2c158fa 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1833,21 +1833,14 @@ static struct {
     {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
 
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, unpackI16B_I16},
-    {IMAGING_MODE_I_16,
-     IMAGING_RAWMODE_I_16N,
-     16,
-     unpackI16N_I16},  // LibTiff native->image endian.
-    {
-        IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16
-    },  // LibTiff native->image endian.
-    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16B},
-
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16R, 16, unpackI16R_I16},
 
-    {IMAGING_MODE_I_16,
-     IMAGING_RAWMODE_I_12,
-     12,
-     unpackI12_I16}  // 12 bit Tiffs stored in 16bits.
+    // LibTiff native->image endian.
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16},
+    {IMAGING_MODE_I_16L, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16},
+
+    // 12 bit Tiffs stored in 16bits.
+    {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_12, 12, unpackI12_I16}
 };
 
 ImagingShuffler

From 84e89bf5c3c798ac55e726e3624c4bca5bacc90f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 27 Aug 2025 07:07:13 +1000
Subject: [PATCH 2016/2374] Restored unpacker

---
 src/libImaging/Unpack.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/libImaging/Unpack.c b/src/libImaging/Unpack.c
index ab5f2c158fa..203bcac2ca9 100644
--- a/src/libImaging/Unpack.c
+++ b/src/libImaging/Unpack.c
@@ -1833,6 +1833,7 @@ static struct {
     {IMAGING_MODE_I_16N, IMAGING_RAWMODE_I_16N, 16, copy2},
 
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16B, 16, unpackI16B_I16},
+    {IMAGING_MODE_I_16B, IMAGING_RAWMODE_I_16N, 16, unpackI16N_I16B},
     {IMAGING_MODE_I_16, IMAGING_RAWMODE_I_16R, 16, unpackI16R_I16},
 
     // LibTiff native->image endian.

From a59ce257e9ccc966d0a4a2b57a1ef2f05134f9b7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 28 Aug 2025 19:37:26 +1000
Subject: [PATCH 2017/2374] Install zstd for libtiff on Linux

---
 .github/workflows/wheels-dependencies.sh | 10 ++++++++
 wheels/dependency_licenses/ZSTD.txt      | 30 ++++++++++++++++++++++++
 2 files changed, 40 insertions(+)
 create mode 100644 wheels/dependency_licenses/ZSTD.txt

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index c79cd2f17d1..72934a9b983 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -99,6 +99,7 @@ LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.1
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.8.1
+ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.0
 LCMS2_VERSION=2.17
 ZLIB_VERSION=1.3.1
@@ -254,6 +255,14 @@ function build_libavif {
     touch libavif-stamp
 }
 
+function build_zstd {
+    if [ -e zstd-stamp ]; then return; fi
+    local out_dir=$(fetch_unpack https://github.com/facebook/zstd/releases/download/v$ZSTD_VERSION/zstd-$ZSTD_VERSION.tar.gz)
+    (cd $out_dir \
+        && make -j4 install)
+    touch zstd-stamp
+}
+
 function build {
     build_xz
     if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
@@ -285,6 +294,7 @@ function build {
             --with-jpeg-include-dir=$BUILD_PREFIX/include --with-jpeg-lib-dir=$BUILD_PREFIX/lib \
             --disable-webp --disable-libdeflate --disable-zstd
     else
+        build_zstd
         build_tiff
     fi
 
diff --git a/wheels/dependency_licenses/ZSTD.txt b/wheels/dependency_licenses/ZSTD.txt
new file mode 100644
index 00000000000..75800288cc2
--- /dev/null
+++ b/wheels/dependency_licenses/ZSTD.txt
@@ -0,0 +1,30 @@
+BSD License
+
+For Zstandard software
+
+Copyright (c) Meta Platforms, Inc. and affiliates. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name Facebook, nor Meta, nor the names of its contributors may
+   be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

From 05a601031142ecf0ca21c521a6c312c66c4e48b6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 29 Aug 2025 07:35:18 +1000
Subject: [PATCH 2018/2374] Fixed loading rotated PCD images

---
 Tests/test_file_pcd.py    | 7 +++++++
 src/PIL/PcdImagePlugin.py | 9 +++++++--
 2 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_pcd.py b/Tests/test_file_pcd.py
index 9bf1a75f0f6..a2d07ff5180 100644
--- a/Tests/test_file_pcd.py
+++ b/Tests/test_file_pcd.py
@@ -6,6 +6,8 @@
 
 from PIL import Image
 
+from .helper import assert_image_equal
+
 
 def test_load_raw() -> None:
     with Image.open("Tests/images/hopper.pcd") as im:
@@ -30,3 +32,8 @@ def test_rotated(orientation: int) -> None:
     f = BytesIO(data)
     with Image.open(f) as im:
         assert im.size == (512, 768)
+
+        with Image.open("Tests/images/hopper.pcd") as expected:
+            assert_image_equal(
+                im, expected.rotate(90 if orientation == 1 else -90, expand=True)
+            )
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index 7f9ab525c68..00864a4bf90 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -47,12 +47,17 @@ def _open(self) -> None:
 
         self._mode = "RGB"
         self._size = (512, 768) if orientation in (1, 3) else (768, 512)
-        self.tile = [ImageFile._Tile("pcd", (0, 0) + self.size, 96 * 2048)]
+        self.tile = [ImageFile._Tile("pcd", (0, 0, 768, 512), 96 * 2048)]
+
+    def load_prepare(self) -> None:
+        if self._im is None and self.tile_post_rotate:
+            self.im = Image.core.new(self.mode, (768, 512))
+        ImageFile.ImageFile.load_prepare(self)
 
     def load_end(self) -> None:
         if self.tile_post_rotate:
             # Handle rotated PCDs
-            self.im = self.im.rotate(self.tile_post_rotate)
+            self.im = self.rotate(self.tile_post_rotate, expand=True).im
 
 
 #

From c6915f717f3b9bb694421f4d711808ba2c464d40 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 29 Aug 2025 07:43:51 +1000
Subject: [PATCH 2019/2374] rotate() will use "angle % 360"

---
 Tests/test_file_pcd.py    | 2 +-
 src/PIL/PcdImagePlugin.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_pcd.py b/Tests/test_file_pcd.py
index a2d07ff5180..15dd7f116db 100644
--- a/Tests/test_file_pcd.py
+++ b/Tests/test_file_pcd.py
@@ -35,5 +35,5 @@ def test_rotated(orientation: int) -> None:
 
         with Image.open("Tests/images/hopper.pcd") as expected:
             assert_image_equal(
-                im, expected.rotate(90 if orientation == 1 else -90, expand=True)
+                im, expected.rotate(90 if orientation == 1 else 270, expand=True)
             )
diff --git a/src/PIL/PcdImagePlugin.py b/src/PIL/PcdImagePlugin.py
index 00864a4bf90..296f3775b0d 100644
--- a/src/PIL/PcdImagePlugin.py
+++ b/src/PIL/PcdImagePlugin.py
@@ -43,7 +43,7 @@ def _open(self) -> None:
         if orientation == 1:
             self.tile_post_rotate = 90
         elif orientation == 3:
-            self.tile_post_rotate = -90
+            self.tile_post_rotate = 270
 
         self._mode = "RGB"
         self._size = (512, 768) if orientation in (1, 3) else (768, 512)

From c7a268e5a5d026d17374309a0fde23cbcc0f8bf0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 1 Sep 2025 08:23:30 +1000
Subject: [PATCH 2020/2374] ImageMorph operations must have length 1 (#9102)

---
 Tests/test_imagemorph.py     | 14 ++++++++------
 docs/releasenotes/12.0.0.rst |  7 +++++++
 src/PIL/ImageMorph.py        |  2 +-
 3 files changed, 16 insertions(+), 7 deletions(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 515e29cead9..ca192a809c4 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -7,7 +7,7 @@
 
 from PIL import Image, ImageMorph, _imagingmorph
 
-from .helper import assert_image_equal_tofile, hopper
+from .helper import assert_image_equal_tofile, hopper, timeout_unless_slower_valgrind
 
 
 def string_to_img(image_string: str) -> Image.Image:
@@ -266,16 +266,18 @@ def test_unknown_pattern() -> None:
         ImageMorph.LutBuilder(op_name="unknown")
 
 
-def test_pattern_syntax_error() -> None:
+@pytest.mark.parametrize(
+    "pattern", ("a pattern with a syntax error", "4:(" + "X" * 30000)
+)
+@timeout_unless_slower_valgrind(1)
+def test_pattern_syntax_error(pattern: str) -> None:
     # Arrange
     lb = ImageMorph.LutBuilder(op_name="corner")
-    new_patterns = ["a pattern with a syntax error"]
+    new_patterns = [pattern]
     lb.add_patterns(new_patterns)
 
     # Act / Assert
-    with pytest.raises(
-        Exception, match='Syntax error in pattern "a pattern with a syntax error"'
-    ):
+    with pytest.raises(Exception, match='Syntax error in pattern "'):
         lb.build_lut()
 
 
diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index e21c243ea55..41edea31844 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -150,3 +150,10 @@ others prepare for 3.14, and to ensure Pillow could be used immediately at the r
 of 3.14.0 final (2025-10-07, :pep:`745`).
 
 Pillow 12.0.0 now officially supports Python 3.14.
+
+ImageMorph operations must have length 1
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Valid ImageMorph operations are 4, N, 1 and M. By limiting the length to 1 character
+within Pillow, long execution times can be avoided if a user provided long pattern
+strings. Reported by Jang Choi.
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index f0a066b5bd8..bd70aff7b48 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -150,7 +150,7 @@ def build_lut(self) -> bytearray:
 
         # Parse and create symmetries of the patterns strings
         for p in self.patterns:
-            m = re.search(r"(\w*):?\s*\((.+?)\)\s*->\s*(\d)", p.replace("\n", ""))
+            m = re.search(r"(\w):?\s*\((.+?)\)\s*->\s*(\d)", p.replace("\n", ""))
             if not m:
                 msg = 'Syntax error in pattern "' + p + '"'
                 raise Exception(msg)

From 31eee6e5f706cd0a41ac26c45694adef1eca72a3 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Tue, 2 Sep 2025 07:57:54 +1000
Subject: [PATCH 2021/2374] [pre-commit.ci] pre-commit autoupdate (#9180)

---
 .pre-commit-config.yaml  | 10 +++++-----
 src/libImaging/Palette.c |  2 +-
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 2be509d54de..23bda1ec76b 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.12.7
+    rev: v0.12.11
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$|\.patch$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v20.1.8
+    rev: v21.1.0
     hooks:
       - id: clang-format
         types: [c]
@@ -36,7 +36,7 @@ repos:
       - id: rst-backticks
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: check-executables-have-shebangs
       - id: check-shebang-scripts-are-executable
@@ -51,14 +51,14 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.33.2
+    rev: 0.33.3
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.11.0
+    rev: v1.12.1
     hooks:
       - id: zizmor
 
diff --git a/src/libImaging/Palette.c b/src/libImaging/Palette.c
index 78916bca52b..da1d8050476 100644
--- a/src/libImaging/Palette.c
+++ b/src/libImaging/Palette.c
@@ -148,7 +148,7 @@ ImagingPaletteDelete(ImagingPalette palette) {
 
 #define BOX 8
 
-#define BOXVOLUME BOX *BOX *BOX
+#define BOXVOLUME BOX * BOX * BOX
 
 void
 ImagingPaletteCacheUpdate(ImagingPalette palette, int r, int g, int b) {

From 57a5f76e6d78f280fa7cd666bff32fe3452f140b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Sep 2025 21:09:07 +1000
Subject: [PATCH 2022/2374] Removed unused split

---
 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 a2bf9ccf92b..446160c2f22 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -129,7 +129,7 @@ def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
         if file.readline() != b"PILfont\n":
             msg = "Not a PILfont file"
             raise SyntaxError(msg)
-        file.readline().split(b";")
+        file.readline()
         self.info = []  # FIXME: should be a dictionary
         while True:
             s = file.readline()

From 485d9884cf7a3cd2ceedc91df9c8625454b6d8f5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Sep 2025 21:24:57 +1000
Subject: [PATCH 2023/2374] Limit length of read operation

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

diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 4565d35bab7..08034ad0de5 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -492,6 +492,11 @@ def test_stroke_mask() -> None:
     assert mask.getpixel((42, 5)) == 255
 
 
+def test_load_invalid_file() -> None:
+    with pytest.raises(SyntaxError, match="Not a PILfont file"):
+        ImageFont.load("Tests/images/1_trns.png")
+
+
 def test_load_when_image_not_found() -> None:
     with tempfile.NamedTemporaryFile(delete=False) as tmp:
         pass
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 446160c2f22..df2f00882eb 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -126,7 +126,7 @@ def _load_pilfont(self, filename: str) -> None:
 
     def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
         # read PILfont header
-        if file.readline() != b"PILfont\n":
+        if file.read(8) != b"PILfont\n":
             msg = "Not a PILfont file"
             raise SyntaxError(msg)
         file.readline()

From caacd38e1be189ed5a9d9ba892e595cbdfaa551b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Sep 2025 21:32:13 +1000
Subject: [PATCH 2024/2374] Raise mode error before reading

---
 Tests/test_imagefontpil.py |  8 ++++++++
 src/PIL/ImageFont.py       | 10 +++++-----
 2 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index 3eb98d3797d..8c1cb3f5860 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -30,6 +30,14 @@ def test_default_font(font: ImageFont.ImageFont) -> None:
     assert_image_equal_tofile(im, "Tests/images/default_font.png")
 
 
+def test_invalid_mode() -> None:
+    font = ImageFont.ImageFont()
+    fp = BytesIO()
+    with Image.open("Tests/images/hopper.png") as im:
+        with pytest.raises(TypeError, match="invalid font image mode"):
+            font._load_pilfont_data(fp, im)
+
+
 def test_without_freetype() -> None:
     original_core = ImageFont.core
     if features.check_module("freetype2"):
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index df2f00882eb..92eb763a51e 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -125,6 +125,11 @@ def _load_pilfont(self, filename: str) -> None:
             image.close()
 
     def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
+        # check image
+        if image.mode not in ("1", "L"):
+            msg = "invalid font image mode"
+            raise TypeError(msg)
+
         # read PILfont header
         if file.read(8) != b"PILfont\n":
             msg = "Not a PILfont file"
@@ -140,11 +145,6 @@ def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
         # read PILfont metrics
         data = file.read(256 * 20)
 
-        # check image
-        if image.mode not in ("1", "L"):
-            msg = "invalid font image mode"
-            raise TypeError(msg)
-
         image.load()
 
         self.font = Image.core.font(image.im, data)

From 0e22b0ca6c9577fcd5be0013ce6d10e0ee28999a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Sep 2025 18:33:52 +1000
Subject: [PATCH 2025/2374] Removed unused code

---
 Tests/test_font_crash.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/Tests/test_font_crash.py b/Tests/test_font_crash.py
index b82340ef70b..fb5026ee0ef 100644
--- a/Tests/test_font_crash.py
+++ b/Tests/test_font_crash.py
@@ -2,7 +2,7 @@
 
 import pytest
 
-from PIL import Image, ImageDraw, ImageFont
+from PIL import ImageFont
 
 from .helper import skip_unless_feature
 
@@ -12,10 +12,6 @@ def _fuzz_font(self, font: ImageFont.FreeTypeFont) -> None:
         # from fuzzers.fuzz_font
         font.getbbox("ABC")
         font.getmask("test text")
-        with Image.new(mode="RGBA", size=(200, 200)) as im:
-            draw = ImageDraw.Draw(im)
-            draw.multiline_textbbox((10, 10), "ABC\nAaaa", font, stroke_width=2)
-            draw.text((10, 10), "Test Text", font=font, fill="#000")
 
     @skip_unless_feature("freetype2")
     def test_segfault(self) -> None:

From 72c067af2969517fde1979a4749c5076be96894a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Sep 2025 19:23:26 +1000
Subject: [PATCH 2026/2374] Check all reserved bytes in header

---
 Tests/images/crash-5762152299364352.fli       | Bin 8731 -> 8731 bytes
 ...39147ce93e20eb14088fe238e541443ffd64b3.fli | Bin 200 -> 200 bytes
 ...f0a9dc7243a8e6ede2408d2ffa6a9964698b87.fli | Bin 159 -> 159 bytes
 src/PIL/FliImagePlugin.py                     |   7 ++++++-
 4 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/Tests/images/crash-5762152299364352.fli b/Tests/images/crash-5762152299364352.fli
index 944fe0b56c73b016c7599beb5b8e47cd33f0432f..d7588eea88f4a37d000e6c12949a13e219298092 100644
GIT binary patch
delta 21
dcmbR3GTUW>)?^7rwTS^jlNA`{Ha5&w1OQM22K@j4

delta 28
kcmbR3GTUW>)@CbaM#jksjBb<bgbgN7V2s)Pmr+gu0Ef#7C;$Ke

diff --git a/Tests/images/timeout-9139147ce93e20eb14088fe238e541443ffd64b3.fli b/Tests/images/timeout-9139147ce93e20eb14088fe238e541443ffd64b3.fli
index ce4607d2dd083a923db2d6326e5b6cb34edd0702..73da81dcb6220ab90c9d9ffa336727353de5dafd 100644
GIT binary patch
literal 200
zcmccrk72RkdM*Y=0bk+&3^3sGi1Yo=yXXHu{?G9L4a5Hi1}=tgFgXJB|Nmcs<{*qB
zq#UU9*T?_gr~YHtgem0(F-}5xbwI;@05QzOb3nlK{lC<|{|OBH|FZmN14{h;KN|o>
CO)#eb

delta 86
zcmWm2u?;{#07l{8MIq5BbeD+Q1_~Rf%wPsBBT(B1!)Qe$?w<3SmwZQbM03?bgYhQ`
nYbFW3g#Foq(fNm1&IqpHm^-(gUO4dtaIkM>y-n1w(q-sA4znvm

diff --git a/Tests/images/timeout-bff0a9dc7243a8e6ede2408d2ffa6a9964698b87.fli b/Tests/images/timeout-bff0a9dc7243a8e6ede2408d2ffa6a9964698b87.fli
index 77a94b87a3ade935e707f3d89c9fbff801a1e976..abe642e6a9d665941b34501c6c0879370cac87b0 100644
GIT binary patch
literal 159
zcmccrk72RkdM*Y=0S1Bp3^3sGi1Yo=yXXHu{?G9L4a5Hi1}=tgFgXJB|Nmcs<{*qB
Zq#UU9*GH!Ykh1?k0HS$81PJ_}4FLDPAGiPj

delta 86
zcmbQwIG=HXme2qH9RHdAy#bQ51sE6@{xkgf52QdqTJHb<zyCh|XJPou#PI+BSD^TR
mrtc!s|Nf^i{Qt}F|0hu3?|;7I#}q7&HT<{y!@xbUOcMa?xhfg}

diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index ccb8a5953d6..c8e38f6be07 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -49,7 +49,12 @@ class FliImageFile(ImageFile.ImageFile):
     def _open(self) -> None:
         # HEAD
         s = self.fp.read(128)
-        if not (_accept(s) and s[20:22] == b"\x00\x00"):
+        if not (
+            _accept(s)
+            and s[20:22] == b"\x00" * 2
+            and s[42:80] == b"\x00" * 38
+            and s[88:] == b"\x00" * 40
+        ):
             msg = "not an FLI/FLC file"
             raise SyntaxError(msg)
 

From e73b5ff4cd0c2ba4587c49bf310bb1421b47e725 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Sep 2025 19:35:01 +1000
Subject: [PATCH 2027/2374] Do not unnecessarily update __offset

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

diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index ccb8a5953d6..679a9edd9ac 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -77,8 +77,7 @@ def _open(self) -> None:
 
         if i16(s, 4) == 0xF100:
             # prefix chunk; ignore it
-            self.__offset = self.__offset + i32(s)
-            self.fp.seek(self.__offset)
+            self.fp.seek(self.__offset + i32(s))
             s = self.fp.read(16)
 
         if i16(s, 4) == 0xF1FA:

From caede14465b664c542eff9365afb128d0b19a729 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Sep 2025 21:46:54 +1000
Subject: [PATCH 2028/2374] Revert "Removed unused code"

This reverts commit 0e22b0ca6c9577fcd5be0013ce6d10e0ee28999a.
---
 Tests/test_font_crash.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Tests/test_font_crash.py b/Tests/test_font_crash.py
index fb5026ee0ef..b82340ef70b 100644
--- a/Tests/test_font_crash.py
+++ b/Tests/test_font_crash.py
@@ -2,7 +2,7 @@
 
 import pytest
 
-from PIL import ImageFont
+from PIL import Image, ImageDraw, ImageFont
 
 from .helper import skip_unless_feature
 
@@ -12,6 +12,10 @@ def _fuzz_font(self, font: ImageFont.FreeTypeFont) -> None:
         # from fuzzers.fuzz_font
         font.getbbox("ABC")
         font.getmask("test text")
+        with Image.new(mode="RGBA", size=(200, 200)) as im:
+            draw = ImageDraw.Draw(im)
+            draw.multiline_textbbox((10, 10), "ABC\nAaaa", font, stroke_width=2)
+            draw.text((10, 10), "Test Text", font=font, fill="#000")
 
     @skip_unless_feature("freetype2")
     def test_segfault(self) -> None:

From abf088fae57ff5fb8476652531c84755fd7d2bdd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Sep 2025 21:52:27 +1000
Subject: [PATCH 2029/2374] Updated comment

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

diff --git a/Tests/test_font_crash.py b/Tests/test_font_crash.py
index b82340ef70b..54bd2d183ca 100644
--- a/Tests/test_font_crash.py
+++ b/Tests/test_font_crash.py
@@ -9,7 +9,8 @@
 
 class TestFontCrash:
     def _fuzz_font(self, font: ImageFont.FreeTypeFont) -> None:
-        # from fuzzers.fuzz_font
+        # Copy of the code from fuzz_font() in Tests/oss-fuzz/fuzzers.py
+        # that triggered a problem when fuzzing
         font.getbbox("ABC")
         font.getmask("test text")
         with Image.new(mode="RGBA", size=(200, 200)) as im:

From 877707379bda7923de612a4ed4116fd1ec3b6017 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Sep 2025 22:38:37 +1000
Subject: [PATCH 2030/2374] Deprecate Image._show

---
 Tests/test_image.py          | 8 ++++++++
 docs/deprecations.rst        | 8 ++++++++
 docs/releasenotes/12.0.0.rst | 6 ++++++
 src/PIL/Image.py             | 5 ++++-
 4 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index be7ca6a6f11..eb3882ddcea 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -19,6 +19,7 @@
     ImageDraw,
     ImageFile,
     ImagePalette,
+    ImageShow,
     UnidentifiedImageError,
     features,
 )
@@ -1047,6 +1048,13 @@ def test_get_child_images(self) -> None:
         with pytest.warns(DeprecationWarning, match="Image.Image.get_child_images"):
             assert im.get_child_images() == []
 
+    def test_show(self, monkeypatch: pytest.MonkeyPatch) -> None:
+        monkeypatch.setattr(ImageShow, "_viewers", [])
+
+        im = Image.new("RGB", (1, 1))
+        with pytest.warns(DeprecationWarning, match="Image._show"):
+            Image._show(im)
+
     @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/deprecations.rst b/docs/deprecations.rst
index 3f95cf7f545..e31d3c31c91 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -61,6 +61,14 @@ ImageCms.ImageCmsProfile.product_name and .product_info
 ``.product_info`` attributes have been deprecated, and will be removed in
 Pillow 13 (2026-10-15). They have been set to ``None`` since Pillow 2.3.0.
 
+Image._show
+~~~~~~~~~~~
+
+.. deprecated:: 12.0.0
+
+``Image._show`` has been deprecated, and will be removed in Pillow 13 (2026-10-15).
+Use :py:meth:`~PIL.ImageShow.show` instead.
+
 Removed features
 ----------------
 
diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index 41edea31844..12bf760e28a 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -116,6 +116,12 @@ vulnerability introduced in FreeType 2.6 (:cve:`2020-15999`).
 Deprecations
 ============
 
+Image._show
+^^^^^^^^^^^
+
+``Image._show`` has been deprecated, and will be removed in Pillow 13 (2026-10-15).
+Use :py:meth:`~PIL.ImageShow.show` instead.
+
 ImageCms.ImageCmsProfile.product_name and .product_info
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 354118a87ae..5a457803b62 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2632,7 +2632,9 @@ def show(self, title: str | None = None) -> None:
         :param title: Optional title to use for the image window, where possible.
         """
 
-        _show(self, title=title)
+        from . import ImageShow
+
+        ImageShow.show(self, title)
 
     def split(self) -> tuple[Image, ...]:
         """
@@ -3797,6 +3799,7 @@ def register_encoder(name: str, encoder: type[ImageFile.PyEncoder]) -> None:
 def _show(image: Image, **options: Any) -> None:
     from . import ImageShow
 
+    deprecate("Image._show", 13, "ImageShow.show")
     ImageShow.show(image, **options)
 
 

From f0bbab94a6da39b0366d0f55c9f033c6ab335d28 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Sep 2025 07:23:15 +1000
Subject: [PATCH 2031/2374] Updated libjpeg-turbo to 3.1.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 c79cd2f17d1..b4309e8d976 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -96,7 +96,7 @@ ARCHIVE_SDIR=pillow-depends-main
 FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=11.3.3
 LIBPNG_VERSION=1.6.50
-JPEGTURBO_VERSION=3.1.1
+JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.3
 XZ_VERSION=5.8.1
 TIFF_VERSION=4.7.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 5633519ddb9..7539cff82f1 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ def cmd_msbuild(
     "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "11.3.3",
-    "JPEGTURBO": "3.1.1",
+    "JPEGTURBO": "3.1.2",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.4.0",

From e0da1a62ec120cba1ae32a38880dd7c749051bda Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Sep 2025 08:10:31 +1000
Subject: [PATCH 2032/2374] Use walrus operator

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

diff --git a/src/PIL/WalImageFile.py b/src/PIL/WalImageFile.py
index 87e32878b19..5494f62e892 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -49,8 +49,7 @@ def _open(self) -> None:
 
         # strings are null-terminated
         self.info["name"] = header[:32].split(b"\0", 1)[0]
-        next_name = header[56 : 56 + 32].split(b"\0", 1)[0]
-        if next_name:
+        if next_name := header[56 : 56 + 32].split(b"\0", 1)[0]:
             self.info["next_name"] = next_name
 
     def load(self) -> Image.core.PixelAccess | None:

From cfca02a75970cc2816ce341eae5099e1465c6ac9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Sep 2025 08:27:52 +1000
Subject: [PATCH 2033/2374] Improved WAL test coverage

---
 Tests/test_file_wal.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/Tests/test_file_wal.py b/Tests/test_file_wal.py
index b15d79d61e0..549d47054e7 100644
--- a/Tests/test_file_wal.py
+++ b/Tests/test_file_wal.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from io import BytesIO
+
 from PIL import WalImageFile
 
 from .helper import assert_image_equal_tofile
@@ -13,12 +15,22 @@ def test_open() -> None:
         assert im.format_description == "Quake2 Texture"
         assert im.mode == "P"
         assert im.size == (128, 128)
+        assert "next_name" not in im.info
 
         assert isinstance(im, WalImageFile.WalImageFile)
 
         assert_image_equal_tofile(im, "Tests/images/hopper_wal.png")
 
 
+def test_next_name() -> None:
+    with open(TEST_FILE, "rb") as fp:
+        data = bytearray(fp.read())
+    data[56:60] = b"Test"
+    f = BytesIO(data)
+    with WalImageFile.open(f) as im:
+        assert im.info["next_name"] == b"Test"
+
+
 def test_load() -> None:
     with WalImageFile.open(TEST_FILE) as im:
         px = im.load()

From 73490e10ad7dd7821aed94ee088cef82659a9fa1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Sep 2025 21:00:13 +1000
Subject: [PATCH 2034/2374] Mention Pillow 11.3.0 behaviour

---
 docs/deprecations.rst | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index 8f7800ba5f9..a3c2c55db99 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -35,11 +35,12 @@ Image.fromarray mode parameter
 
 .. deprecated:: 11.3.0
 
-Using the ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` to change data types
-has been deprecated. Since pixel values do not contain information about palettes or
-color spaces, the parameter can still be used to place grayscale L mode data within a
-P mode image, or read RGB data as YCbCr for example. If omitted, the mode will be
-automatically determined from the object's shape and type.
+Using the ``mode`` parameter in :py:meth:`~PIL.Image.fromarray()` was deprecated in
+Pillow 11.3.0. In Pillow 12.0.0, this was partially reverted, and it is now only
+deprecated when changing data types. Since pixel values do not contain information
+about palettes or color spaces, the parameter can still be used to place grayscale L
+mode data within a P mode image, or read RGB data as YCbCr for example. If omitted, the
+mode will be automatically determined from the object's shape and type.
 
 Saving I mode images as PNG
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^

From 5de27c6258f9c4c7a3686d6e2ae9ce07c4ec1138 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 4 Sep 2025 21:09:00 +1000
Subject: [PATCH 2035/2374] Split versionadded info

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index f6a2ec5bc03..5c3a73fada1 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -20,7 +20,9 @@ or the clipboard to a PIL image memory.
     used as a fallback if they are installed. To disable this behaviour, pass
     ``xdisplay=""`` instead.
 
-    .. versionadded:: 1.1.3 (Windows), 3.0.0 (macOS), 7.1.0 (Linux)
+    .. versionadded:: 1.1.3 Windows support
+    .. versionadded:: 3.0.0 macOS support
+    .. versionadded:: 7.1.0 Linux support
 
     :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
@@ -53,7 +55,9 @@ or the clipboard to a PIL image memory.
 
     On Linux, ``wl-paste`` or ``xclip`` is required.
 
-    .. versionadded:: 1.1.4 (Windows), 3.3.0 (macOS), 9.4.0 (Linux)
+    .. versionadded:: 1.1.4 Windows support
+    .. versionadded:: 3.3.0 macOS support
+    .. versionadded:: 9.4.0 Linux support
 
     :return: On Windows, an image, a list of filenames,
              or None if the clipboard does not contain image data or filenames.

From 54d329f98f214bbaf6ee23df0aec91da7f03f035 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 4 Sep 2025 23:26:47 +1000
Subject: [PATCH 2036/2374] Updated harfbuzz to 11.4.5 (#9150)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .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 cbd8534aa4c..1fa63409626 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -94,7 +94,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # annotations have a source code patch that is required for some platforms. If
 # you change those versions, ensure the patch is also updated.
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=11.3.3
+HARFBUZZ_VERSION=11.4.5
 LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 4ba68380142..ba69878bcfd 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.13.3",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "11.3.3",
+    "HARFBUZZ": "11.4.5",
     "JPEGTURBO": "3.1.2",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",

From 476b122ae45f1f6efd48f07f609114b4987c74c0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Sep 2025 20:00:04 +1000
Subject: [PATCH 2037/2374] Simplified code

---
 src/PIL/CurImagePlugin.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/PIL/CurImagePlugin.py b/src/PIL/CurImagePlugin.py
index b817dbc87b8..868ff50b535 100644
--- a/src/PIL/CurImagePlugin.py
+++ b/src/PIL/CurImagePlugin.py
@@ -17,7 +17,7 @@
 #
 from __future__ import annotations
 
-from . import BmpImagePlugin, Image, ImageFile
+from . import BmpImagePlugin, Image
 from ._binary import i16le as i16
 from ._binary import i32le as i32
 
@@ -63,8 +63,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] = ImageFile._Tile(d, (0, 0) + self.size, o, a)
+        self.tile = [self.tile[0]._replace(extents=(0, 0) + self.size)]
 
 
 #

From a52979785756bd2cd68aa3910945dce5ed96138f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Sep 2025 20:04:50 +1000
Subject: [PATCH 2038/2374] Assert fp is not None

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

diff --git a/src/PIL/FliImagePlugin.py b/src/PIL/FliImagePlugin.py
index 679a9edd9ac..b9cc8ad6c01 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -48,6 +48,7 @@ class FliImageFile(ImageFile.ImageFile):
 
     def _open(self) -> None:
         # HEAD
+        assert self.fp is not None
         s = self.fp.read(128)
         if not (_accept(s) and s[20:22] == b"\x00\x00"):
             msg = "not an FLI/FLC file"
@@ -110,6 +111,7 @@ def _palette(self, palette: list[tuple[int, int, int]], shift: int) -> None:
         # load palette
 
         i = 0
+        assert self.fp is not None
         for e in range(i16(self.fp.read(2))):
             s = self.fp.read(2)
             i = i + s[0]

From bf18e5fe8bf837ba6756bef0384eae82504c7883 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Sep 2025 20:03:31 +1000
Subject: [PATCH 2039/2374] Assert fp is not None

---
 Tests/test_file_cur.py    | 1 +
 src/PIL/CurImagePlugin.py | 1 +
 2 files changed, 2 insertions(+)

diff --git a/Tests/test_file_cur.py b/Tests/test_file_cur.py
index dbf1b866d7f..ff82e2983eb 100644
--- a/Tests/test_file_cur.py
+++ b/Tests/test_file_cur.py
@@ -26,6 +26,7 @@ def test_invalid_file() -> None:
     no_cursors_file = "Tests/images/no_cursors.cur"
 
     cur = CurImagePlugin.CurImageFile(TEST_FILE)
+    assert cur.fp is not None
     cur.fp.close()
     with open(no_cursors_file, "rb") as cur.fp:
         with pytest.raises(TypeError):
diff --git a/src/PIL/CurImagePlugin.py b/src/PIL/CurImagePlugin.py
index 868ff50b535..9c188e08446 100644
--- a/src/PIL/CurImagePlugin.py
+++ b/src/PIL/CurImagePlugin.py
@@ -38,6 +38,7 @@ class CurImageFile(BmpImagePlugin.BmpImageFile):
     format_description = "Windows Cursor"
 
     def _open(self) -> None:
+        assert self.fp is not None
         offset = self.fp.tell()
 
         # check magic

From 067569790ba47e4149114cb3cd5df8561c8c0b52 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Sep 2025 20:11:02 +1000
Subject: [PATCH 2040/2374] Test largest cursor

---
 Tests/test_file_cur.py | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/Tests/test_file_cur.py b/Tests/test_file_cur.py
index ff82e2983eb..4b3e3afcb43 100644
--- a/Tests/test_file_cur.py
+++ b/Tests/test_file_cur.py
@@ -1,8 +1,13 @@
 from __future__ import annotations
 
+from io import BytesIO
+
 import pytest
 
 from PIL import CurImagePlugin, Image
+from PIL._binary import o8
+from PIL._binary import o16le as o16
+from PIL._binary import o32le as o32
 
 TEST_FILE = "Tests/images/deerstalker.cur"
 
@@ -17,6 +22,24 @@ def test_sanity() -> None:
         assert im.getpixel((16, 16)) == (84, 87, 86, 255)
 
 
+def test_largest_cursor() -> None:
+    magic = b"\x00\x00\x02\x00"
+    sizes = ((1, 1), (8, 8), (4, 4))
+    data = magic + o16(len(sizes))
+    for w, h in sizes:
+        image_offset = 6 + len(sizes) * 16 if (w, h) == max(sizes) else 0
+        data += o8(w) + o8(h) + o8(0) * 10 + o32(image_offset)
+    data += (
+        o32(12)  # header size
+        + o16(8)  # width
+        + o16(16)  # height
+        + o16(0)  # planes
+        + o16(1)  # bits
+    )
+    with Image.open(BytesIO(data)) as im:
+        assert im.size == (8, 8)
+
+
 def test_invalid_file() -> None:
     invalid_file = "Tests/images/flower.jpg"
 

From d4ed512bec3258d38a9debd62cdd08fe86f4c27c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Sep 2025 23:14:52 +1000
Subject: [PATCH 2041/2374] Use monkeypatch

---
 Tests/test_imageshow.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/Tests/test_imageshow.py b/Tests/test_imageshow.py
index 7a2f5876757..8d6731acc91 100644
--- a/Tests/test_imageshow.py
+++ b/Tests/test_imageshow.py
@@ -59,15 +59,12 @@ def test_show(mode: str) -> None:
     assert ImageShow.show(im)
 
 
-def test_show_without_viewers() -> None:
-    viewers = ImageShow._viewers
-    ImageShow._viewers = []
+def test_show_without_viewers(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr(ImageShow, "_viewers", [])
 
     with hopper() as im:
         assert not ImageShow.show(im)
 
-    ImageShow._viewers = viewers
-
 
 @pytest.mark.parametrize(
     "viewer",

From 2bf482230d61d785e17d74bd69dcb2fa2a71b1d1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Sep 2025 23:43:47 +1000
Subject: [PATCH 2042/2374] Test unsupported BMP bitfields layout

---
 Tests/test_file_bmp.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 746b2e18061..c1c430aa5b5 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -6,6 +6,8 @@
 import pytest
 
 from PIL import BmpImagePlugin, Image, _binary
+from PIL._binary import o16le as o16
+from PIL._binary import o32le as o32
 
 from .helper import (
     assert_image_equal,
@@ -114,7 +116,7 @@ def test_save_float_dpi(tmp_path: Path) -> None:
 
 
 def test_load_dib() -> None:
-    # test for #1293, Imagegrab returning Unsupported Bitfields Format
+    # test for #1293, ImageGrab returning Unsupported Bitfields Format
     with Image.open("Tests/images/clipboard.dib") as im:
         assert im.format == "DIB"
         assert im.get_format_mimetype() == "image/bmp"
@@ -219,6 +221,18 @@ def test_rle8_eof(file_name: str, length: int) -> None:
             im.load()
 
 
+def test_unsupported_bmp_bitfields_layout() -> None:
+    fp = io.BytesIO(
+        o32(40)  # header size
+        + b"\x00" * 10
+        + o16(1)  # bits
+        + o32(3)  # BITFIELDS compression
+        + b"\x00" * 32
+    )
+    with pytest.raises(OSError, match="Unsupported BMP bitfields layout"):
+        Image.open(fp)
+
+
 def test_offset() -> None:
     # This image has been hexedited
     # to exclude the palette size from the pixel data offset

From 4469ee0fc0206326cd6cf016d31ce204342e35db Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Sep 2025 12:25:56 +1000
Subject: [PATCH 2043/2374] Test saving P4 images

---
 Tests/test_file_ppm.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 68f2f946855..ca5347f0fa9 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -92,6 +92,13 @@ def test_16bit_pgm() -> None:
         assert_image_equal_tofile(im, "Tests/images/16_bit_binary_pgm.tiff")
 
 
+def test_p4_save(tmp_path: Path) -> None:
+    with Image.open("Tests/images/hopper_1bit.pbm") as im:
+        filename = tmp_path / "temp.pbm"
+        im.save(filename)
+        assert_image_equal_tofile(im, filename)
+
+
 def test_16bit_pgm_write(tmp_path: Path) -> None:
     with Image.open("Tests/images/16_bit_binary.pgm") as im:
         filename = tmp_path / "temp.pgm"

From 7d379842c12f33c9cf972ee7fda1e16d207fbbe6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Sep 2025 12:28:20 +1000
Subject: [PATCH 2044/2374] Test saving unsupported mode

---
 Tests/test_file_ppm.py | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index ca5347f0fa9..598e9a445b6 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -141,6 +141,12 @@ def test_pfm_big_endian(tmp_path: Path) -> None:
         assert_image_equal_tofile(im, filename)
 
 
+def test_save_unsupported_mode(tmp_path: Path) -> None:
+    im = hopper("P")
+    with pytest.raises(OSError, match="cannot write mode P as PPM"):
+        im.save(tmp_path / "out.ppm")
+
+
 @pytest.mark.parametrize(
     "data",
     [

From b90fe802ced1318a9b1b76dc78e53c458d75340b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 7 Sep 2025 12:49:10 +1000
Subject: [PATCH 2045/2374] Test transparency

---
 Tests/test_file_gd.py | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/Tests/test_file_gd.py b/Tests/test_file_gd.py
index 806532c17ec..8a49fd4fa53 100644
--- a/Tests/test_file_gd.py
+++ b/Tests/test_file_gd.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from io import BytesIO
+
 import pytest
 
 from PIL import GdImageFile, UnidentifiedImageError
@@ -16,6 +18,14 @@ def test_sanity() -> None:
         assert_image_similar_tofile(im.convert("RGB"), "Tests/images/hopper.jpg", 14)
 
 
+def test_transparency() -> None:
+    with open(TEST_GD_FILE, "rb") as fp:
+        data = bytearray(fp.read())
+    data[7:11] = b"\x00\x00\x00\x05"
+    with GdImageFile.open(BytesIO(data)) as im:
+        assert im.info["transparency"] == 5
+
+
 def test_bad_mode() -> None:
     with pytest.raises(ValueError):
         GdImageFile.open(TEST_GD_FILE, "bad mode")

From a58fc562f08ece7763824fea1e5ee02ed3000024 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 7 Sep 2025 13:55:35 +1000
Subject: [PATCH 2046/2374] Update github-actions (#9194)

---
 .github/workflows/docs.yml         | 2 +-
 .github/workflows/lint.yml         | 2 +-
 .github/workflows/stale.yml        | 2 +-
 .github/workflows/test-windows.yml | 2 +-
 .github/workflows/test.yml         | 2 +-
 .github/workflows/wheels.yml       | 6 +++---
 6 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 761dc112520..cf917407c6c 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -37,7 +37,7 @@ jobs:
         persist-credentials: false
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.x"
         cache: pip
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 9827ef1cd7e..2addbaf674d 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -33,7 +33,7 @@ jobs:
           lint-pre-commit-
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.x"
         cache: pip
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index 61ccf58e2ea..1b0c3c654e7 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -22,7 +22,7 @@ jobs:
 
     steps:
     - name: "Check issues"
-      uses: actions/stale@v9
+      uses: actions/stale@v10
       with:
         repo-token: ${{ secrets.GITHUB_TOKEN }}
         only-labels: "Awaiting OP Action"
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index d55a8e5f51f..e12a5b1f7d1 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -67,7 +67,7 @@ jobs:
 
     # sets env: pythonLocation
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index b17d08892a1..8504e5c1e2e 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -70,7 +70,7 @@ jobs:
         persist-credentials: false
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: ${{ matrix.python-version }}
         allow-prereleases: true
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 24e78f965c5..81a68813526 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -111,7 +111,7 @@ jobs:
           persist-credentials: false
           submodules: true
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.x"
 
@@ -164,7 +164,7 @@ jobs:
           repository: python-pillow/test-images
           path: Tests\test-images
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.x"
 
@@ -239,7 +239,7 @@ jobs:
         persist-credentials: false
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: "3.x"
 

From 2d8244c45adeab9fecdf7e1fa3adc9af175a67d8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 8 Sep 2025 23:39:04 +1000
Subject: [PATCH 2047/2374] Added GitHub profile link

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

diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index b166f51b365..0a03b982fc7 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -171,4 +171,4 @@ ImageMorph operations must have length 1
 
 Valid ImageMorph operations are 4, N, 1 and M. By limiting the length to 1 character
 within Pillow, long execution times can be avoided if a user provided long pattern
-strings. Reported by Jang Choi.
+strings. Reported by Jang Choi (https://github.com/uko3211).

From 4b8bcb6f379e8073519b3afff745156542f78258 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 9 Sep 2025 00:04:01 +1000
Subject: [PATCH 2048/2374] Use link

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

diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index 0a03b982fc7..de9d6dffd3b 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -171,4 +171,4 @@ ImageMorph operations must have length 1
 
 Valid ImageMorph operations are 4, N, 1 and M. By limiting the length to 1 character
 within Pillow, long execution times can be avoided if a user provided long pattern
-strings. Reported by Jang Choi (https://github.com/uko3211).
+strings. Reported by `Jang Choi <https://github.com/uko3211>`__.

From 3a580e0f79bfb5bd491f24e604960e4823c4f58f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Sep 2025 21:04:16 +1000
Subject: [PATCH 2049/2374] Use _ensure_mutable

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b17fd131d2c..95bf2da3f2f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2070,9 +2070,7 @@ def putpixel(
         :param value: The pixel value.
         """
 
-        if self.readonly:
-            self._copy()
-        self.load()
+        self._ensure_mutable()
 
         if (
             self.mode in ("P", "PA")
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index ed46899b455..1384f11696e 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -76,9 +76,7 @@ def __init__(self, im: Image.Image, mode: str | None = None) -> None:
            must be the same as the image mode.  If omitted, the mode
            defaults to the mode of the image.
         """
-        im.load()
-        if im.readonly:
-            im._copy()  # make it writeable
+        im._ensure_mutable()
         blend = 0
         if mode is None:
             mode = im.mode

From 410fb60f65f21d6b1ee968b3d9d278d0ef97e355 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 9 Sep 2025 22:01:07 +1000
Subject: [PATCH 2050/2374] Added alpha channel examples

---
 docs/reference/ImageDraw.rst | 37 ++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 4a2223a40c5..6768a04c600 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -57,6 +57,43 @@ Color names
 
 See :ref:`color-names` for the color names supported by Pillow.
 
+Alpha channel
+^^^^^^^^^^^^^
+
+By default, when drawing onto an existing image, the image's pixel values are simply
+replaced by the new color::
+
+    im = Image.new("RGBA", (1, 1), (255, 0, 0))
+    d = ImageDraw.Draw(im)
+    d.rectangle((0, 0, 1, 1), (0, 255, 0, 127))
+    assert im.getpixel((0, 0)) == (0, 255, 0, 127)
+
+    # Alpha channel values have no effect when drawing with RGB mode
+    im = Image.new("RGB", (1, 1), (255, 0, 0))
+    d = ImageDraw.Draw(im)
+    d.rectangle((0, 0, 1, 1), (0, 255, 0, 127))
+    assert im.getpixel((0, 0)) == (0, 255, 0)
+
+If you would like to combine translucent color with an RGB image, then initialize the
+ImageDraw instance with the RGBA mode::
+
+    from PIL import Image, ImageDraw
+    im = Image.new("RGB", (1, 1), (255, 0, 0))
+    d = ImageDraw.Draw(im, "RGBA")
+    d.rectangle((0, 0, 1, 1), (0, 255, 0, 127))
+    assert im.getpixel((0, 0)) == (128, 127, 0)
+
+If you would like to combine translucent color with an RGBA image underneath, you will
+need to combine multiple images::
+
+    from PIL import Image, ImageDraw
+    im = Image.new("RGBA", (1, 1), (255, 0, 0, 255))
+    im2 = Image.new("RGBA", (1, 1))
+    d = ImageDraw.Draw(im2)
+    d.rectangle((0, 0, 1, 1), (0, 255, 0, 127))
+    im.paste(im2.convert("RGB"), mask=im2)
+    assert im.getpixel((0, 0)) == (128, 127, 0, 255)
+
 Fonts
 ^^^^^
 

From 5df7f98a591e494cd2b0516c3f49d37eb8ee2dd9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 10 Sep 2025 13:16:12 +1000
Subject: [PATCH 2051/2374] Updated Ghostscript to 10.6.0

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index e12a5b1f7d1..f6a7dd46b04 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -97,8 +97,8 @@ jobs:
         choco install nasm --no-progress
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
-        choco install ghostscript --version=10.5.1 --no-progress
-        echo "C:\Program Files\gs\gs10.05.1\bin" >> $env:GITHUB_PATH
+        choco install ghostscript --version=10.6.0 --no-progress
+        echo "C:\Program Files\gs\gs10.06.0\bin" >> $env:GITHUB_PATH
 
         # Install extra test images
         xcopy /S /Y Tests\test-images\* Tests\images

From d70cba37627586b243a9b3aeac7899f5389d3ba8 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 14 Sep 2025 15:55:50 +1000
Subject: [PATCH 2052/2374] Update dependency mypy to v1.18.1 (#9207)

---
 .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 bd95638008d..68d69c18333 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.17.1
+mypy==1.18.1
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 53302c2281a9576acabf5815f3eda1f48f253cf0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 16 Sep 2025 19:43:03 +1000
Subject: [PATCH 2053/2374] Split versionadded info

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index 25afc99266c..00d7f8e3c45 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -44,7 +44,8 @@ or the clipboard to a PIL image memory.
     :param window:
         Capture a single window. On Windows, this is a HWND. On macOS, it uses windowid.
 
-        .. versionadded:: 11.2.1 (Windows), 12.0.0 (macOS)
+        .. versionadded:: 11.2.1 Windows support
+        .. versionadded:: 12.0.0 macOS support
     :return: An image
 
 .. py:function:: grabclipboard()

From ca3528f46eacb005d3875410655b6ae9dc91c45c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 16 Sep 2025 21:43:24 +1000
Subject: [PATCH 2054/2374] Document that macOS window value is a CGWindowID

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index c6671ca7107..e7dd41de1b7 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -44,7 +44,8 @@ or the clipboard to a PIL image memory.
         .. versionadded:: 7.1.0
 
     :param window:
-        Capture a single window. On Windows, this is a HWND. On macOS, it uses windowid.
+        Capture a single window. On Windows, this is a HWND. On macOS, this is a
+        CGWindowID.
 
         .. versionadded:: 11.2.1 Windows support
         .. versionadded:: 12.0.0 macOS support

From c8b4a24e75d894a2fa7233c4acaf75ed061d08f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 17 Sep 2025 19:51:50 +1000
Subject: [PATCH 2055/2374] 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 3c5e4cd519f..186d9b96da5 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 26 Tahoe                   | 3.9, 3.10, 3.11, 3.12, 3.13| 11.3.0           |arm           |
++----------------------------------+----------------------------+------------------+--------------+
 | macOS 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13| 11.3.0           |arm           |
 |                                  +----------------------------+------------------+              |
 |                                  | 3.8                        | 10.4.0           |              |

From 9e4256e8aa9d7adad4271069732c48d129d5b38f Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Fri, 19 Sep 2025 22:22:30 +1000
Subject: [PATCH 2056/2374] Update dependency mypy to v1.18.2 (#9213)

---
 .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 68d69c18333..447856433b4 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.18.1
+mypy==1.18.2
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython

From 92e671d7970b8f96c50424c0c47efd0a1c95bc51 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Sep 2025 20:15:20 +1000
Subject: [PATCH 2057/2374] Updated tests for FreeType 2.14.1

---
 Tests/images/colr_bungee.png       | Bin 4545 -> 4350 bytes
 Tests/images/colr_bungee_mask.png  | Bin 2789 -> 2534 bytes
 Tests/images/colr_bungee_older.png | Bin 0 -> 4545 bytes
 Tests/test_imagedraw.py            |   8 ++++++--
 Tests/test_imagefont.py            |  10 +++++++---
 Tests/test_imagefontctl.py         |   2 +-
 6 files changed, 14 insertions(+), 6 deletions(-)
 create mode 100644 Tests/images/colr_bungee_older.png

diff --git a/Tests/images/colr_bungee.png b/Tests/images/colr_bungee.png
index b10a60be057c4654ebcf36de28870e6bd6ee8010..9ec6b11823b429c1b7280b1539ce3bb2c4511e37 100644
GIT binary patch
literal 4350
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

literal 4545
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
E0H8dyQ2+n{

diff --git a/Tests/images/colr_bungee_mask.png b/Tests/images/colr_bungee_mask.png
index f13e176774988ef539f85b797ab3f787e73f2ca8..79106b63949edf3fde8112fad1e2fb1d370636c0 100644
GIT binary patch
literal 2534
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

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

diff --git a/Tests/images/colr_bungee_older.png b/Tests/images/colr_bungee_older.png
new file mode 100644
index 0000000000000000000000000000000000000000..b10a60be057c4654ebcf36de28870e6bd6ee8010
GIT binary patch
literal 4545
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
E0H8dyQ2+n{

literal 0
HcmV?d00001

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 406d965b4e5..790acee2a46 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1494,7 +1494,9 @@ def check(func: Callable[[], None]) -> None:
 
     def draw_text() -> None:
         draw.text((0, 0), text, font_size=16)
-        assert_image_equal_tofile(im, "Tests/images/imagedraw_default_font_size.png")
+        assert_image_similar_tofile(
+            im, "Tests/images/imagedraw_default_font_size.png", 1
+        )
 
     check(draw_text)
 
@@ -1513,7 +1515,9 @@ def draw_textbbox() -> None:
 
     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")
+        assert_image_similar_tofile(
+            im, "Tests/images/imagedraw_default_font_size.png", 1
+        )
 
     check(draw_multiline_text)
 
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 4565d35bab7..4b8a61eb3c1 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -19,6 +19,7 @@
     assert_image_equal,
     assert_image_equal_tofile,
     assert_image_similar_tofile,
+    has_feature_version,
     is_win32,
     skip_unless_feature,
     skip_unless_feature_version,
@@ -549,7 +550,7 @@ def test_default_font() -> None:
     draw.text((10, 60), txt, font=larger_default_font)
 
     # Assert
-    assert_image_equal_tofile(im, "Tests/images/default_font_freetype.png")
+    assert_image_similar_tofile(im, "Tests/images/default_font_freetype.png", 0.13)
 
 
 @pytest.mark.parametrize("mode", ("", "1", "RGBA"))
@@ -1055,7 +1056,10 @@ def test_colr(layout_engine: ImageFont.Layout) -> None:
 
     d.text((15, 5), "Bungee", font=font, embedded_color=True)
 
-    assert_image_similar_tofile(im, "Tests/images/colr_bungee.png", 21)
+    if has_feature_version("freetype2", "2.14.0"):
+        assert_image_similar_tofile(im, "Tests/images/colr_bungee.png", 6.1)
+    else:
+        assert_image_similar_tofile(im, "Tests/images/colr_bungee_older.png", 21)
 
 
 @skip_unless_feature_version("freetype2", "2.10.0")
@@ -1071,7 +1075,7 @@ def test_colr_mask(layout_engine: ImageFont.Layout) -> None:
 
     d.text((15, 5), "Bungee", "black", font=font)
 
-    assert_image_similar_tofile(im, "Tests/images/colr_bungee_mask.png", 22)
+    assert_image_similar_tofile(im, "Tests/images/colr_bungee_mask.png", 14.1)
 
 
 def test_woff2(layout_engine: ImageFont.Layout) -> None:
diff --git a/Tests/test_imagefontctl.py b/Tests/test_imagefontctl.py
index 95af3fda8c4..633f6756b0c 100644
--- a/Tests/test_imagefontctl.py
+++ b/Tests/test_imagefontctl.py
@@ -183,7 +183,7 @@ def test_x_max_and_y_offset() -> None:
     draw.text((0, 0), "لح", font=ttf, fill=500)
 
     target = "Tests/images/test_x_max_and_y_offset.png"
-    assert_image_similar_tofile(im, target, 0.5)
+    assert_image_similar_tofile(im, target, 3.8)
 
 
 def test_language() -> None:

From 6916a73b579df0f78ee9734b83f58c2acbb8b17e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Sep 2025 20:16:50 +1000
Subject: [PATCH 2058/2374] Build FreeType 2.14.1 on macOS 13, instead of using
 2.14.0 from brew

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

diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index 94e3d5d085e..8060e0850e6 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -4,11 +4,19 @@ set -e
 
 if [[ "$ImageOS" == "macos13" ]]; then
     brew uninstall gradle maven
+
+    wget https://raw.githubusercontent.com/python-pillow/pillow-depends/main/freetype-2.14.1.tar.gz
+    tar -xvzf freetype-2.14.1.tar.gz
+    (cd freetype-2.14.1 \
+        && ./configure \
+        && make -j4 \
+        && make install)
+else
+    brew install freetype
 fi
 brew install \
     aom \
     dav1d \
-    freetype \
     ghostscript \
     jpeg-turbo \
     libimagequant \

From 04177eb6ba6af0aaea8d959e99d4cff7cd22c798 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 20 Sep 2025 20:17:10 +1000
Subject: [PATCH 2059/2374] Updated FreeType to 2.14.1 on Windows

---
 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 ba69878bcfd..5c638829e18 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -114,7 +114,7 @@ def cmd_msbuild(
 
 V = {
     "BROTLI": "1.1.0",
-    "FREETYPE": "2.13.3",
+    "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "11.4.5",
     "JPEGTURBO": "3.1.2",

From d64f56f53bde0f262250068471d3713c9d6ed3e9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 21 Sep 2025 07:38:17 +1000
Subject: [PATCH 2060/2374] Updated openjpeg to 2.5.4

---
 .github/workflows/wheels-dependencies.sh   | 2 +-
 depends/install_openjpeg.sh                | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 winbuild/build_prepare.py                  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 1fa63409626..f400994d7f0 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -97,7 +97,7 @@ FREETYPE_VERSION=2.13.3
 HARFBUZZ_VERSION=11.4.5
 LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.2
-OPENJPEG_VERSION=2.5.3
+OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.1
 ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.0
diff --git a/depends/install_openjpeg.sh b/depends/install_openjpeg.sh
index 1f8d781931b..bc7c7c634ed 100755
--- a/depends/install_openjpeg.sh
+++ b/depends/install_openjpeg.sh
@@ -1,7 +1,7 @@
 #!/bin/bash
 # install openjpeg
 
-archive=openjpeg-2.5.3
+archive=openjpeg-2.5.4
 
 ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index fc7ef7646c5..656d54325d4 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -58,7 +58,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**, **2.5.0**, **2.5.2** and **2.5.3**.
+    **2.4.0**, **2.5.0**, **2.5.2**, **2.5.3** and **2.5.4**.
   * 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 5c638829e18..30f7a123c8a 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -123,7 +123,7 @@ def cmd_msbuild(
     "LIBIMAGEQUANT": "4.4.0",
     "LIBPNG": "1.6.50",
     "LIBWEBP": "1.6.0",
-    "OPENJPEG": "2.5.3",
+    "OPENJPEG": "2.5.4",
     "TIFF": "4.7.0",
     "XZ": "5.8.1",
     "ZLIBNG": "2.2.5",

From 222933df542d9a0c956bad2b8a4429ed7c973145 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 18 Sep 2025 21:48:01 +1000
Subject: [PATCH 2061/2374] Seek past BeginBinary data when parsing metadata

---
 Tests/test_file_eps.py    | 8 ++++++++
 src/PIL/EpsImagePlugin.py | 3 +++
 2 files changed, 11 insertions(+)

diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index d94de728709..b50915f28c3 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -197,6 +197,14 @@ def test_load_long_binary_data(prefix: bytes) -> None:
         assert img.format == "EPS"
 
 
+def test_begin_binary() -> None:
+    with open("Tests/images/eps/binary_preview_map.eps", "rb") as fp:
+        data = bytearray(fp.read())
+    data[76875 : 76875 + 11] = b"%" * 11
+    with Image.open(io.BytesIO(data)) as img:
+        assert img.size == (399, 480)
+
+
 @mark_if_feature_version(
     pytest.mark.valgrind_known_error, "libjpeg_turbo", "2.0", reason="Known Failing"
 )
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 5e2ddad99e9..69f3062b4d4 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -354,6 +354,9 @@ def read_comment(s: str) -> bool:
                 read_comment(s)
             elif bytes_mv[:9] == b"%%Trailer":
                 trailer_reached = True
+            elif bytes_mv[:14] == b"%%BeginBinary:":
+                bytecount = int(byte_arr[14:bytes_read])
+                self.fp.seek(bytecount, os.SEEK_CUR)
             bytes_read = 0
 
         # A "BoundingBox" is always required,

From 9ba1029d515c5113bd0b1ea4f99fb5d3f1a9659b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Sep 2025 22:28:30 +1000
Subject: [PATCH 2062/2374] Clear C image when MPO frame image size changes

---
 Tests/test_file_mpo.py     | 2 ++
 src/PIL/JpegImagePlugin.py | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 9262e6ca781..ba05bbe4365 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -108,9 +108,11 @@ def test_frame_size() -> None:
     # in the SOF marker of the second frame
     with Image.open("Tests/images/sugarshack_frame_size.mpo") as im:
         assert im.size == (640, 480)
+        im.load()
 
         im.seek(1)
         assert im.size == (680, 480)
+        im.load()
 
         im.seek(0)
         assert im.size == (640, 480)
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 0d110035e1a..755ca648e55 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -193,6 +193,8 @@ def SOF(self: JpegImageFile, marker: int) -> None:
     n = i16(self.fp.read(2)) - 2
     s = ImageFile._safe_read(self.fp, n)
     self._size = i16(s, 3), i16(s, 1)
+    if self._im is not None and self.size != self.im.size:
+        self._im = None
 
     self.bits = s[0]
     if self.bits != 8:

From ce8d05484b71737a352eb6a52332cb7856b597c6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 15 Sep 2025 22:31:15 +1000
Subject: [PATCH 2063/2374] Use naturally created image

---
 Tests/images/frame_size.mpo            | Bin 0 -> 14574 bytes
 Tests/images/sugarshack_frame_size.mpo | Bin 120198 -> 0 bytes
 Tests/test_file_mpo.py                 |  10 ++++------
 3 files changed, 4 insertions(+), 6 deletions(-)
 create mode 100644 Tests/images/frame_size.mpo
 delete mode 100644 Tests/images/sugarshack_frame_size.mpo

diff --git a/Tests/images/frame_size.mpo b/Tests/images/frame_size.mpo
new file mode 100644
index 0000000000000000000000000000000000000000..ee5c6cdf7a926901d490becc6892cc18dfc075f5
GIT binary patch
literal 14574
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
C<4O_$

literal 0
HcmV?d00001

diff --git a/Tests/images/sugarshack_frame_size.mpo b/Tests/images/sugarshack_frame_size.mpo
deleted file mode 100644
index abff98ea57d051dcae4a7853dc9c367dbdf57f51..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

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

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index ba05bbe4365..ddb5897366b 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -104,18 +104,16 @@ def test_exif(test_file: str) -> None:
 
 
 def test_frame_size() -> None:
-    # This image has been hexedited to contain a different size
-    # in the SOF marker of the second frame
-    with Image.open("Tests/images/sugarshack_frame_size.mpo") as im:
-        assert im.size == (640, 480)
+    with Image.open("Tests/images/frame_size.mpo") as im:
+        assert im.size == (56, 70)
         im.load()
 
         im.seek(1)
-        assert im.size == (680, 480)
+        assert im.size == (349, 434)
         im.load()
 
         im.seek(0)
-        assert im.size == (640, 480)
+        assert im.size == (56, 70)
 
 
 def test_ignore_frame_size() -> None:

From 913a6d8390b57dde5f1dcfbd4a0fa8887d992e8a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 13 Sep 2025 09:12:01 +1000
Subject: [PATCH 2064/2374] Updated harfbuzz to 11.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 1fa63409626..3d016b5e259 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -94,7 +94,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # annotations have a source code patch that is required for some platforms. If
 # you change those versions, ensure the patch is also updated.
 FREETYPE_VERSION=2.13.3
-HARFBUZZ_VERSION=11.4.5
+HARFBUZZ_VERSION=11.5.0
 LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 5c638829e18..d21b549b6b0 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "11.4.5",
+    "HARFBUZZ": "11.5.0",
     "JPEGTURBO": "3.1.2",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",

From d42e537efeb1bd11cd9df1db1c7d7a6dc529d9e2 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 23 Sep 2025 12:17:40 +1000
Subject: [PATCH 2065/2374] Update dependency cibuildwheel to v3.2.0 (#9219)

---
 .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 d87d7956f75..8ec7262c090 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.1.4
+cibuildwheel==3.2.0

From 2c438830736a5cb17cd9aea8c8aacb67a11dd86c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Sep 2025 21:01:16 +1000
Subject: [PATCH 2066/2374] Updated libtiff to 4.7.1

---
 .github/workflows/wheels-dependencies.sh   | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 winbuild/build_prepare.py                  | 8 +-------
 3 files changed, 3 insertions(+), 9 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index cbeee8f9dc9..8a398576389 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -100,7 +100,7 @@ JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.1
 ZSTD_VERSION=1.5.7
-TIFF_VERSION=4.7.0
+TIFF_VERSION=4.7.1
 LCMS2_VERSION=2.17
 ZLIB_NG_VERSION=2.2.5
 LIBWEBP_VERSION=1.6.0
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 656d54325d4..6080d29afa3 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -44,7 +44,7 @@ Many of Pillow's features require external libraries:
 
 * **libtiff** provides compressed TIFF functionality
 
-  * Pillow has been tested with libtiff versions **4.0-4.7.0**
+  * Pillow has been tested with libtiff versions **4.0-4.7.1**
 
 * **libfreetype** provides type related services
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b28aa8caa8b..e00f6185d0c 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -124,7 +124,7 @@ def cmd_msbuild(
     "LIBPNG": "1.6.50",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
-    "TIFF": "4.7.0",
+    "TIFF": "4.7.1",
     "XZ": "5.8.1",
     "ZLIBNG": "2.2.5",
 }
@@ -228,12 +228,6 @@ def cmd_msbuild(
                 # link against libwebp.lib
                 "#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)": "",
-                "target_sources(test_write_read_tags PRIVATE test_write_read_tags.c)": "",  # noqa: E501
-                "target_link_libraries(test_write_read_tags PRIVATE tiff)": "",
-                "list(APPEND simple_tests test_write_read_tags)": "",
-            },
         },
         "build": [
             *cmds_cmake(

From 637f25dc2c7f1593bc7fca0ce3654feaff752b59 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 25 Sep 2025 21:01:33 +1000
Subject: [PATCH 2067/2374] Revert "Allow cmake<4 when building libtiff"

This reverts commit 81412212016a70eb160460e26dc552a0f8a8c153.
---
 winbuild/build_prepare.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index e00f6185d0c..76f05bdcb19 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -235,7 +235,6 @@ def cmd_msbuild(
                 "-DBUILD_SHARED_LIBS:BOOL=OFF",
                 "-DWebP_LIBRARY=libwebp",
                 '-DCMAKE_C_FLAGS="-nologo -DLZMA_API_STATIC"',
-                "-DCMAKE_POLICY_VERSION_MINIMUM=3.5",
             )
         ],
         "headers": [r"libtiff\tiff*.h"],

From e2a8e217dad1445caff35092695264eefbbf8ae7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 29 Sep 2025 23:18:47 +1000
Subject: [PATCH 2068/2374] Removed _expand()

---
 Tests/test_image.py | 27 ---------------------------
 src/PIL/Image.py    |  6 ------
 2 files changed, 33 deletions(-)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index eb3882ddcea..17864436527 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -284,33 +284,6 @@ def test_comparison_with_other_type(self) -> None:
         assert item is not None
         assert item != num
 
-    def test_expand_x(self) -> None:
-        # Arrange
-        im = hopper()
-        orig_size = im.size
-        xmargin = 5
-
-        # Act
-        im = im._expand(xmargin)
-
-        # Assert
-        assert im.size[0] == orig_size[0] + 2 * xmargin
-        assert im.size[1] == orig_size[1] + 2 * xmargin
-
-    def test_expand_xy(self) -> None:
-        # Arrange
-        im = hopper()
-        orig_size = im.size
-        xmargin = 5
-        ymargin = 3
-
-        # Act
-        im = im._expand(xmargin, ymargin)
-
-        # Assert
-        assert im.size[0] == orig_size[0] + 2 * xmargin
-        assert im.size[1] == orig_size[1] + 2 * ymargin
-
     def test_getbands(self) -> None:
         # Assert
         assert hopper("RGB").getbands() == ("R", "G", "B")
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b17fd131d2c..708e8589910 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1336,12 +1336,6 @@ def draft(
         """
         pass
 
-    def _expand(self, xmargin: int, ymargin: int | None = None) -> Image:
-        if ymargin is None:
-            ymargin = xmargin
-        self.load()
-        return self._new(self.im.expand(xmargin, ymargin))
-
     def filter(self, filter: ImageFilter.Filter | type[ImageFilter.Filter]) -> Image:
         """
         Filters this image using the given filter.  For a list of

From a953d86b4db252d614312e2684c0c1f459d6a796 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 1 Oct 2025 23:11:53 +1000
Subject: [PATCH 2069/2374] Python 3.9 wheels are no longer needed (#9214)

---
 .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 81a68813526..68a446f7922 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -54,7 +54,7 @@ jobs:
             platform: macos
             os: macos-13
             cibw_arch: x86_64
-            build: "cp3{9,10,11}*"
+            build: "cp3{10,11}*"
             macosx_deployment_target: "10.10"
           - name: "macOS 10.13 x86_64"
             platform: macos

From 0bcfd3b55c350269c7275067bc10bc095d0df27c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 2 Oct 2025 21:35:26 +1000
Subject: [PATCH 2070/2374] Updated Python version

---
 winbuild/README.md | 2 +-
 winbuild/build.rst | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/winbuild/README.md b/winbuild/README.md
index 62345af60bc..db71f094e0e 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -16,7 +16,7 @@ For more extensive info, see the [Windows build instructions](build.rst).
 Here's an example script to build on Windows:
 
 ```
-set PYTHON=C:\Python39\bin
+set PYTHON=C:\Python310\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 aa4677ad595..23b26c42252 100644
--- a/winbuild/build.rst
+++ b/winbuild/build.rst
@@ -115,7 +115,7 @@ Example
 
 Here's an example script to build on Windows::
 
-    set PYTHON=C:\Python39\bin
+    set PYTHON=C:\Python310\bin
     cd /D C:\Pillow\winbuild
     %PYTHON%\python.exe build_prepare.py -v --depends C:\pillow-depends
     build\build_dep_all.cmd

From 7cb518031ad64d9566f8d20d51c5da784023d49f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 2 Oct 2025 22:21:16 +1000
Subject: [PATCH 2071/2374] Updated FreeType to 2.14.1 on macOS and Linux

---
 .github/workflows/wheels-dependencies.sh | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index cbeee8f9dc9..bc490a38a26 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -93,7 +93,11 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds. Version numbers with "Patched"
 # annotations have a source code patch that is required for some platforms. If
 # you change those versions, ensure the patch is also updated.
-FREETYPE_VERSION=2.13.3
+if [[ -n "$IOS_SDK" ]]; then
+  FREETYPE_VERSION=2.13.3
+else
+  FREETYPE_VERSION=2.14.1
+fi
 HARFBUZZ_VERSION=11.5.0
 LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.2
@@ -314,6 +318,10 @@ function build {
 
     if [[ -n "$IS_MACOS" ]]; then
         # Custom freetype build
+        if [[ -z "$IOS_SDK" ]]; then
+          build_simple sed 4.9 https://mirrors.middlendian.com/gnu/sed
+        fi
+
         build_simple freetype $FREETYPE_VERSION https://download.savannah.gnu.org/releases/freetype tar.gz --with-harfbuzz=no
     else
         build_freetype

From 0c0ff7c38f91182b30b979a81423efd84deb3805 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 3 Oct 2025 20:27:42 +1000
Subject: [PATCH 2072/2374] Removed use of sudo from libavif and raqm install
 scripts

---
 .ci/install.sh             | 4 ++--
 depends/install_libavif.sh | 2 +-
 depends/install_raqm.sh    | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index 2178c664626..52b8214170c 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -51,10 +51,10 @@ pushd depends && ./install_webp.sh && popd
 pushd depends && ./install_imagequant.sh && popd
 
 # raqm
-pushd depends && ./install_raqm.sh && popd
+pushd depends && sudo ./install_raqm.sh && popd
 
 # libavif
-pushd depends && ./install_libavif.sh && popd
+pushd depends && sudo ./install_libavif.sh && popd
 
 # extra test images
 pushd depends && ./install_extra_test_images.sh && popd
diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
index 26af8a36ce7..50ba0175567 100755
--- a/depends/install_libavif.sh
+++ b/depends/install_libavif.sh
@@ -59,6 +59,6 @@ cmake \
     "${LIBAVIF_CMAKE_FLAGS[@]}" \
     .
 
-sudo make install
+make install
 
 popd
diff --git a/depends/install_raqm.sh b/depends/install_raqm.sh
index b5a05100ba2..33bb2d0a77f 100755
--- a/depends/install_raqm.sh
+++ b/depends/install_raqm.sh
@@ -8,6 +8,6 @@ archive=libraqm-0.10.3
 
 pushd $archive
 
-meson build --prefix=/usr && sudo ninja -C build install
+meson build --prefix=/usr && ninja -C build install
 
 popd

From b3d1836907796e6d6f3c590c9a1860f6ecb04246 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 4 Oct 2025 19:49:09 +1000
Subject: [PATCH 2073/2374] Update harfbuzz to 12.1.0 (#9218)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .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 68c2eea30e6..69c867b4dba 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -98,7 +98,7 @@ if [[ -n "$IOS_SDK" ]]; then
 else
   FREETYPE_VERSION=2.14.1
 fi
-HARFBUZZ_VERSION=11.5.0
+HARFBUZZ_VERSION=12.1.0
 LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.4
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 76f05bdcb19..186a80cca5e 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "11.5.0",
+    "HARFBUZZ": "12.1.0",
     "JPEGTURBO": "3.1.2",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",

From 09e571780ec33df260c0dccfb7efdf59cdea0d8d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 6 Oct 2025 17:29:41 +0000
Subject: [PATCH 2074/2374] [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.12.11 → v0.13.3](https://github.com/astral-sh/ruff-pre-commit/compare/v0.12.11...v0.13.3)
- [github.com/psf/black-pre-commit-mirror: 25.1.0 → 25.9.0](https://github.com/psf/black-pre-commit-mirror/compare/25.1.0...25.9.0)
- [github.com/pre-commit/mirrors-clang-format: v21.1.0 → v21.1.2](https://github.com/pre-commit/mirrors-clang-format/compare/v21.1.0...v21.1.2)
- [github.com/python-jsonschema/check-jsonschema: 0.33.3 → 0.34.0](https://github.com/python-jsonschema/check-jsonschema/compare/0.33.3...0.34.0)
- [github.com/zizmorcore/zizmor-pre-commit: v1.12.1 → v1.14.2](https://github.com/zizmorcore/zizmor-pre-commit/compare/v1.12.1...v1.14.2)
- [github.com/tox-dev/pyproject-fmt: v2.6.0 → v2.7.0](https://github.com/tox-dev/pyproject-fmt/compare/v2.6.0...v2.7.0)
---
 .pre-commit-config.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 23bda1ec76b..ab0153687d2 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.12.11
+    rev: v0.13.3
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.1.0
+    rev: 25.9.0
     hooks:
       - id: black
 
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$|\.patch$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v21.1.0
+    rev: v21.1.2
     hooks:
       - id: clang-format
         types: [c]
@@ -51,14 +51,14 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.33.3
+    rev: 0.34.0
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.12.1
+    rev: v1.14.2
     hooks:
       - id: zizmor
 
@@ -68,7 +68,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.6.0
+    rev: v2.7.0
     hooks:
       - id: pyproject-fmt
 

From 7259685ba4d05a77ae802920bf54c02a84b6db79 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 7 Oct 2025 09:05:53 +1100
Subject: [PATCH 2075/2374] Build Python 3.14 on macOS 10.15

---
 .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 68a446f7922..f1c851bc7c8 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -60,13 +60,13 @@ jobs:
             platform: macos
             os: macos-13
             cibw_arch: x86_64
-            build: "cp3{12,13,14}*"
+            build: "cp3{12,13}*"
             macosx_deployment_target: "10.13"
           - name: "macOS 10.15 x86_64"
             platform: macos
             os: macos-13
             cibw_arch: x86_64
-            build: "pp3*"
+            build: "{cp314,pp3}*"
             macosx_deployment_target: "10.15"
           - name: "macOS arm64"
             platform: macos

From 6d19b8adeff16674e62bd1e0aed95f29ff1932fb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 26 Jul 2025 21:58:41 +1000
Subject: [PATCH 2076/2374] Do not allow negative offset with memory mapping

---
 Tests/test_imagefile.py | 5 +++++
 src/PIL/ImageFile.py    | 3 +++
 2 files changed, 8 insertions(+)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index d4dfb1b6d59..7dfb3abf986 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -164,6 +164,11 @@ def test_negative_stride(self) -> None:
         with pytest.raises(OSError):
             p.close()
 
+    def test_negative_offset(self) -> None:
+        with Image.open("Tests/images/raw_negative_stride.bin") as im:
+            with pytest.raises(ValueError, match="Tile offset cannot be negative"):
+                im.load()
+
     def test_no_format(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index e33b846d416..a1d98bd5103 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -313,6 +313,9 @@ def load(self) -> Image.core.PixelAccess | None:
                 and args[0] == self.mode
                 and args[0] in Image._MAPMODES
             ):
+                if offset < 0:
+                    msg = "Tile offset cannot be negative"
+                    raise ValueError(msg)
                 try:
                     # use mmap, if possible
                     import mmap

From 1d4cda65cf31d012690c1637ed1046a5de1448b7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 12 Sep 2025 16:27:38 +1000
Subject: [PATCH 2077/2374] Cast to UINT32 before shifting bits

---
 src/libImaging/SgiRleDecode.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/libImaging/SgiRleDecode.c b/src/libImaging/SgiRleDecode.c
index e604689908c..a562f582cb0 100644
--- a/src/libImaging/SgiRleDecode.c
+++ b/src/libImaging/SgiRleDecode.c
@@ -22,7 +22,8 @@
 
 static void
 read4B(UINT32 *dest, UINT8 *buf) {
-    *dest = (UINT32)((buf[0] << 24) | (buf[1] << 16) | (buf[2] << 8) | buf[3]);
+    *dest = ((UINT32)buf[0] << 24) | ((UINT32)buf[1] << 16) | ((UINT32)buf[2] << 8) |
+            buf[3];
 }
 
 /*

From a2ef220b320b82cc6a42ef65fba4dbddd360107a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 9 Oct 2025 21:01:42 +1100
Subject: [PATCH 2078/2374] Cast before additional shifting

---
 src/libImaging/Access.c    | 10 ++++++----
 src/libImaging/BcnEncode.c | 10 +++++-----
 src/libImaging/FliDecode.c |  6 ++++--
 src/libImaging/GetBBox.c   |  4 ++--
 4 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 3db52377e80..65c832cbeff 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -64,7 +64,7 @@ static void
 get_pixel_16L(Imaging im, int x, int y, void *color) {
     UINT8 *in = (UINT8 *)&im->image[y][x + x];
 #ifdef WORDS_BIGENDIAN
-    UINT16 out = in[0] + (in[1] << 8);
+    UINT16 out = in[0] + ((UINT16)in[1] << 8);
     memcpy(color, &out, sizeof(out));
 #else
     memcpy(color, in, sizeof(UINT16));
@@ -77,7 +77,7 @@ get_pixel_16B(Imaging im, int x, int y, void *color) {
 #ifdef WORDS_BIGENDIAN
     memcpy(color, in, sizeof(UINT16));
 #else
-    UINT16 out = in[1] + (in[0] << 8);
+    UINT16 out = in[1] + ((UINT16)in[0] << 8);
     memcpy(color, &out, sizeof(out));
 #endif
 }
@@ -91,7 +91,8 @@ static void
 get_pixel_32L(Imaging im, int x, int y, void *color) {
     UINT8 *in = (UINT8 *)&im->image[y][x * 4];
 #ifdef WORDS_BIGENDIAN
-    INT32 out = in[0] + (in[1] << 8) + (in[2] << 16) + (in[3] << 24);
+    INT32 out =
+        in[0] + ((INT32)in[1] << 8) + ((INT32)in[2] << 16) + ((INT32)in[3] << 24);
     memcpy(color, &out, sizeof(out));
 #else
     memcpy(color, in, sizeof(INT32));
@@ -104,7 +105,8 @@ get_pixel_32B(Imaging im, int x, int y, void *color) {
 #ifdef WORDS_BIGENDIAN
     memcpy(color, in, sizeof(INT32));
 #else
-    INT32 out = in[3] + (in[2] << 8) + (in[1] << 16) + (in[0] << 24);
+    INT32 out =
+        in[3] + ((INT32)in[2] << 8) + ((INT32)in[1] << 16) + ((INT32)in[0] << 24);
     memcpy(color, &out, sizeof(out));
 #endif
 }
diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 7a5072ddee6..861ae1c261c 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -36,10 +36,9 @@ decode_565(UINT16 x) {
 
 static UINT16
 encode_565(rgba item) {
-    UINT8 r, g, b;
-    r = item.color[0] >> (8 - 5);
-    g = item.color[1] >> (8 - 6);
-    b = item.color[2] >> (8 - 5);
+    UINT16 r = item.color[0] >> (8 - 5);
+    UINT8 g = item.color[1] >> (8 - 6);
+    UINT8 b = item.color[2] >> (8 - 5);
     return (r << (5 + 6)) | (g << 5) | b;
 }
 
@@ -157,7 +156,8 @@ encode_bc1_color(Imaging im, ImagingCodecState state, UINT8 *dst, int separate_a
 static void
 encode_bc2_block(Imaging im, ImagingCodecState state, UINT8 *dst) {
     int i, j;
-    UINT8 block[16], current_alpha;
+    UINT8 block[16];
+    UINT32 current_alpha;
     for (i = 0; i < 4; i++) {
         for (j = 0; j < 4; j++) {
             int x = state->x + i * im->pixelsize;
diff --git a/src/libImaging/FliDecode.c b/src/libImaging/FliDecode.c
index 130ecb7f75d..44994823e5d 100644
--- a/src/libImaging/FliDecode.c
+++ b/src/libImaging/FliDecode.c
@@ -16,9 +16,11 @@
 
 #include "Imaging.h"
 
-#define I16(ptr) ((ptr)[0] + ((ptr)[1] << 8))
+#define I16(ptr) ((ptr)[0] + ((int)(ptr)[1] << 8))
 
-#define I32(ptr) ((ptr)[0] + ((ptr)[1] << 8) + ((ptr)[2] << 16) + ((ptr)[3] << 24))
+#define I32(ptr)                                                   \
+    ((ptr)[0] + ((INT32)(ptr)[1] << 8) + ((INT32)(ptr)[2] << 16) + \
+     ((INT32)(ptr)[3] << 24))
 
 #define ERR_IF_DATA_OOB(offset)                 \
     if ((data + (offset)) > ptr + bytes) {      \
diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index d430893ddb2..e50bd7140b9 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -212,7 +212,7 @@ ImagingGetExtrema(Imaging im, void *extrema) {
                 UINT16 v;
                 UINT8 *pixel = *im->image8;
 #ifdef WORDS_BIGENDIAN
-                v = pixel[0] + (pixel[1] << 8);
+                v = pixel[0] + ((UINT16)pixel[1] << 8);
 #else
                 memcpy(&v, pixel, sizeof(v));
 #endif
@@ -221,7 +221,7 @@ ImagingGetExtrema(Imaging im, void *extrema) {
                     for (x = 0; x < im->xsize; x++) {
                         pixel = (UINT8 *)im->image[y] + x * sizeof(v);
 #ifdef WORDS_BIGENDIAN
-                        v = pixel[0] + (pixel[1] << 8);
+                        v = pixel[0] + ((UINT16)pixel[1] << 8);
 #else
                         memcpy(&v, pixel, sizeof(v));
 #endif

From 2b4c7c011eef28401828f979f1005ad80bbf8709 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 10 Oct 2025 11:55:45 +0100
Subject: [PATCH 2079/2374] Typing import suggestion

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

diff --git a/setup.py b/setup.py
index b9f5cfe0610..3a72a0742c1 100644
--- a/setup.py
+++ b/setup.py
@@ -16,12 +16,12 @@
 import sys
 import warnings
 from collections.abc import Iterator
-from typing import TYPE_CHECKING
 
 from pybind11.setup_helpers import ParallelCompile
 from setuptools import Extension, setup
 from setuptools.command.build_ext import build_ext
 
+TYPE_CHECKING = False
 if TYPE_CHECKING:
     from setuptools import _BuildInfo
 

From bd6e70fccdf14f9a2d0ff4201c4c82b3cb84572f Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 10 Oct 2025 12:31:15 +0100
Subject: [PATCH 2080/2374] Check against mode 1 instead of input mode for
 Chops.c

---
 src/libImaging/Chops.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/libImaging/Chops.c b/src/libImaging/Chops.c
index 331f2dfe64c..3ce8a0903e0 100644
--- a/src/libImaging/Chops.c
+++ b/src/libImaging/Chops.c
@@ -64,7 +64,8 @@ create(Imaging im1, Imaging im2, const ModeID mode) {
     int xsize, ysize;
 
     if (!im1 || !im2 || im1->type != IMAGING_TYPE_UINT8 ||
-        (mode != IMAGING_MODE_UNKNOWN && (im1->mode != mode || im2->mode != mode))) {
+        (mode != IMAGING_MODE_UNKNOWN &&
+         (im1->mode != IMAGING_MODE_1 || im2->mode != IMAGING_MODE_1))) {
         return (Imaging)ImagingError_ModeError();
     }
     if (im1->type != im2->type || im1->bands != im2->bands) {

From 5d3086b01ff356c123bd2d9ea929a0bee030c08c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 10 Oct 2025 22:44:09 +1100
Subject: [PATCH 2081/2374] Removed unused access for I;32L and I;32B

---
 src/libImaging/Access.c | 45 ++---------------------------------------
 1 file changed, 2 insertions(+), 43 deletions(-)

diff --git a/src/libImaging/Access.c b/src/libImaging/Access.c
index 65c832cbeff..00aaaa405c6 100644
--- a/src/libImaging/Access.c
+++ b/src/libImaging/Access.c
@@ -12,8 +12,8 @@
 #include "Imaging.h"
 
 /* use make_hash.py from the pillow-scripts repository to calculate these values */
-#define ACCESS_TABLE_SIZE 35
-#define ACCESS_TABLE_HASH 8940
+#define ACCESS_TABLE_SIZE 23
+#define ACCESS_TABLE_HASH 28677
 
 static struct ImagingAccessInstance access_table[ACCESS_TABLE_SIZE];
 
@@ -87,30 +87,6 @@ get_pixel_32(Imaging im, int x, int y, void *color) {
     memcpy(color, &im->image32[y][x], sizeof(INT32));
 }
 
-static void
-get_pixel_32L(Imaging im, int x, int y, void *color) {
-    UINT8 *in = (UINT8 *)&im->image[y][x * 4];
-#ifdef WORDS_BIGENDIAN
-    INT32 out =
-        in[0] + ((INT32)in[1] << 8) + ((INT32)in[2] << 16) + ((INT32)in[3] << 24);
-    memcpy(color, &out, sizeof(out));
-#else
-    memcpy(color, in, sizeof(INT32));
-#endif
-}
-
-static void
-get_pixel_32B(Imaging im, int x, int y, void *color) {
-    UINT8 *in = (UINT8 *)&im->image[y][x * 4];
-#ifdef WORDS_BIGENDIAN
-    memcpy(color, in, sizeof(INT32));
-#else
-    INT32 out =
-        in[3] + ((INT32)in[2] << 8) + ((INT32)in[1] << 16) + ((INT32)in[0] << 24);
-    memcpy(color, &out, sizeof(out));
-#endif
-}
-
 /* store individual pixel */
 
 static void
@@ -131,21 +107,6 @@ put_pixel_16B(Imaging im, int x, int y, const void *color) {
     out[1] = in[0];
 }
 
-static void
-put_pixel_32L(Imaging im, int x, int y, const void *color) {
-    memcpy(&im->image8[y][x * 4], color, 4);
-}
-
-static void
-put_pixel_32B(Imaging im, int x, int y, const void *color) {
-    const char *in = color;
-    UINT8 *out = (UINT8 *)&im->image8[y][x * 4];
-    out[0] = in[3];
-    out[1] = in[2];
-    out[2] = in[1];
-    out[3] = in[0];
-}
-
 static void
 put_pixel_32(Imaging im, int x, int y, const void *color) {
     memcpy(&im->image32[y][x], color, sizeof(INT32));
@@ -174,8 +135,6 @@ ImagingAccessInit(void) {
 #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);
     ADD("P", get_pixel_8, put_pixel_8);
     ADD("PA", get_pixel_32_2bands, put_pixel_32);

From 324258ca7a1836e0fb42fa84038619a4f3f8abd8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 22 Jul 2025 22:59:15 +1000
Subject: [PATCH 2082/2374] Split parametrization

---
 Tests/test_arro3.py     | 23 +++++++++--------------
 Tests/test_nanoarrow.py | 23 +++++++++--------------
 2 files changed, 18 insertions(+), 28 deletions(-)

diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
index a7c755fc2b6..92493d9b056 100644
--- a/Tests/test_arro3.py
+++ b/Tests/test_arro3.py
@@ -225,23 +225,18 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
 
 
 @pytest.mark.parametrize(
-    "mode, data_tp, mask",
+    "mode, mask",
     (
-        ("LA", UINT32, [0, 3]),
-        ("RGB", UINT32, [0, 1, 2]),
-        ("RGBA", UINT32, None),
-        ("CMYK", UINT32, None),
-        ("YCbCr", UINT32, [0, 1, 2]),
-        ("HSV", UINT32, [0, 1, 2]),
-        ("LA", INT32, [0, 3]),
-        ("RGB", INT32, [0, 1, 2]),
-        ("RGBA", INT32, None),
-        ("CMYK", INT32, None),
-        ("YCbCr", INT32, [0, 1, 2]),
-        ("HSV", INT32, [0, 1, 2]),
+        ("LA", [0, 3]),
+        ("RGB", [0, 1, 2]),
+        ("RGBA", None),
+        ("CMYK", None),
+        ("YCbCr", [0, 1, 2]),
+        ("HSV", [0, 1, 2]),
     ),
 )
-def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
+@pytest.mark.parametrize("data_tp", (UINT32, INT32))
+def test_from_int32array(mode: str, mask: list[int] | None, data_tp: DataShape) -> None:
     (dtype, elt, elts_per_pixel) = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index b08333ae97b..3a839a01569 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -232,23 +232,18 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
 
 
 @pytest.mark.parametrize(
-    "mode, data_tp, mask",
+    "mode, mask",
     (
-        ("LA", UINT32, [0, 3]),
-        ("RGB", UINT32, [0, 1, 2]),
-        ("RGBA", UINT32, None),
-        ("CMYK", UINT32, None),
-        ("YCbCr", UINT32, [0, 1, 2]),
-        ("HSV", UINT32, [0, 1, 2]),
-        ("LA", INT32, [0, 3]),
-        ("RGB", INT32, [0, 1, 2]),
-        ("RGBA", INT32, None),
-        ("CMYK", INT32, None),
-        ("YCbCr", INT32, [0, 1, 2]),
-        ("HSV", INT32, [0, 1, 2]),
+        ("LA", [0, 3]),
+        ("RGB", [0, 1, 2]),
+        ("RGBA", None),
+        ("CMYK", None),
+        ("YCbCr", [0, 1, 2]),
+        ("HSV", [0, 1, 2]),
     ),
 )
-def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
+@pytest.mark.parametrize("data_tp", (UINT32, INT32))
+def test_from_int32array(mode: str, mask: list[int] | None, data_tp: DataShape) -> None:
     (dtype, elt, elts_per_pixel) = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]

From 13e4e587e65fe652a1392244e746715f8da740d7 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 10 Oct 2025 15:34:11 +0100
Subject: [PATCH 2083/2374] added import-not-found ignores, removed
 call-overload ignores

---
 Tests/test_arro3.py     | 17 ++++++++++-------
 Tests/test_nanoarrow.py | 16 ++++++++--------
 2 files changed, 18 insertions(+), 15 deletions(-)

diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
index 92493d9b056..a161a7a9667 100644
--- a/Tests/test_arro3.py
+++ b/Tests/test_arro3.py
@@ -16,7 +16,9 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from arro3 import compute
+    from arro3 import compute  #  type: ignore [import-not-found]
+
+    #  type: ignore [import-not-found]
     from arro3.core import Array, DataType, Field, fixed_size_list_array
 else:
     arro3 = pytest.importorskip("arro3", reason="Arro3 not installed")
@@ -106,7 +108,7 @@ def test_to_array(mode: str, dtype: DataType, mask: list[int] | None) -> None:
     img = img.crop((3, 0, 124, 127))
     assert img.size == (121, 127)
 
-    arr = Array(img)  # type: ignore[call-overload]
+    arr = Array(img)
     _test_img_equals_pyarray(img, arr, mask)
     assert arr.type == dtype
 
@@ -123,8 +125,8 @@ def test_lifetime() -> None:
 
     img = hopper("L")
 
-    arr_1 = Array(img)  # type: ignore[call-overload]
-    arr_2 = Array(img)  # type: ignore[call-overload]
+    arr_1 = Array(img)
+    arr_2 = Array(img)
 
     del img
 
@@ -141,8 +143,8 @@ def test_lifetime2() -> None:
 
     img = hopper("L")
 
-    arr_1 = Array(img)  # type: ignore[call-overload]
-    arr_2 = Array(img)  # type: ignore[call-overload]
+    arr_1 = Array(img)
+    arr_2 = Array(img)
 
     assert compute.sum(arr_1).as_py() > 0
     del arr_1
@@ -261,8 +263,9 @@ def test_from_int32array(mode: str, mask: list[int] | None, data_tp: DataShape)
 def test_image_metadata(mode: str, metadata: list[str]) -> None:
     img = hopper(mode)
 
-    arr = Array(img)  # type: ignore[call-overload]
+    arr = Array(img)
 
+    assert arr.type.value_field
     assert arr.type.value_field.metadata
     assert arr.type.value_field.metadata[b"image"]
 
diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index 3a839a01569..fe7505134af 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -16,7 +16,7 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    import nanoarrow
+    import nanoarrow  # type: ignore [import-untyped]
 else:
     nanoarrow = pytest.importorskip("nanoarrow", reason="Nanoarrow not installed")
 
@@ -105,7 +105,7 @@ def test_to_array(mode: str, dtype: nanoarrow, mask: list[int] | None) -> None:
     img = img.crop((3, 0, 124, 127))
     assert img.size == (121, 127)
 
-    arr = nanoarrow.Array(img)  # type: ignore[call-overload]
+    arr = nanoarrow.Array(img)
     _test_img_equals_pyarray(img, arr, mask)
     assert arr.schema.type == dtype.type
     assert arr.schema.nullable == dtype.nullable
@@ -123,8 +123,8 @@ def test_lifetime() -> None:
 
     img = hopper("L")
 
-    arr_1 = nanoarrow.Array(img)  # type: ignore[call-overload]
-    arr_2 = nanoarrow.Array(img)  # type: ignore[call-overload]
+    arr_1 = nanoarrow.Array(img)
+    arr_2 = nanoarrow.Array(img)
 
     del img
 
@@ -141,8 +141,8 @@ def test_lifetime2() -> None:
 
     img = hopper("L")
 
-    arr_1 = nanoarrow.Array(img)  # type: ignore[call-overload]
-    arr_2 = nanoarrow.Array(img)  # type: ignore[call-overload]
+    arr_1 = nanoarrow.Array(img)
+    arr_2 = nanoarrow.Array(img)
 
     assert sum(arr_1.iter_py()) > 0
     del arr_1
@@ -270,7 +270,7 @@ def test_from_int32array(mode: str, mask: list[int] | None, data_tp: DataShape)
 def test_image_nested_metadata(mode: str, metadata: list[str]) -> None:
     img = hopper(mode)
 
-    arr = nanoarrow.Array(img)  # type: ignore[call-overload]
+    arr = nanoarrow.Array(img)
 
     assert arr.schema.value_type.metadata
     assert arr.schema.value_type.metadata[b"image"]
@@ -294,7 +294,7 @@ def test_image_nested_metadata(mode: str, metadata: list[str]) -> None:
 def test_image_flat_metadata(mode: str, metadata: list[str]) -> None:
     img = hopper(mode)
 
-    arr = nanoarrow.Array(img)  # type: ignore[call-overload]
+    arr = nanoarrow.Array(img)
 
     assert arr.schema.metadata
     assert arr.schema.metadata[b"image"]

From b4fe17cecf0f5c6bce2e8c637a7e3c40601ec665 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 10 Oct 2025 15:39:47 +0100
Subject: [PATCH 2084/2374] More typey lint

---
 Tests/test_arro3.py     | 9 ++++++---
 Tests/test_nanoarrow.py | 2 +-
 2 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
index a161a7a9667..9c70daf5a95 100644
--- a/Tests/test_arro3.py
+++ b/Tests/test_arro3.py
@@ -17,9 +17,12 @@
 TYPE_CHECKING = False
 if TYPE_CHECKING:
     from arro3 import compute  #  type: ignore [import-not-found]
-
-    #  type: ignore [import-not-found]
-    from arro3.core import Array, DataType, Field, fixed_size_list_array
+    from arro3.core import (  #  type: ignore [import-not-found]
+        Array,
+        DataType,
+        Field,
+        fixed_size_list_array,
+    )
 else:
     arro3 = pytest.importorskip("arro3", reason="Arro3 not installed")
     from arro3 import compute
diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index fe7505134af..90293130e38 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -16,7 +16,7 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    import nanoarrow  # type: ignore [import-untyped]
+    import nanoarrow  # type: ignore [import-not-found]
 else:
     nanoarrow = pytest.importorskip("nanoarrow", reason="Nanoarrow not installed")
 

From 76ab80f10b50dd9abc5ef4fc4a0e537dfb1f8505 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 14:08:15 +1000
Subject: [PATCH 2085/2374] Assert getpixel returns tuple

---
 Tests/test_file_avif.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index 505d2e59639..727191153a1 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -221,6 +221,7 @@ def test_file_pointer_could_be_reused(self) -> None:
     def test_background_from_gif(self, tmp_path: Path) -> None:
         with Image.open("Tests/images/chi.gif") as im:
             original_value = im.convert("RGB").getpixel((1, 1))
+            assert isinstance(original_value, tuple)
 
             # Save as AVIF
             out_avif = tmp_path / "temp.avif"
@@ -233,6 +234,7 @@ def test_background_from_gif(self, tmp_path: Path) -> None:
 
         with Image.open(out_gif) as reread:
             reread_value = reread.convert("RGB").getpixel((1, 1))
+        assert isinstance(reread_value, tuple)
         difference = sum([abs(original_value[i] - reread_value[i]) for i in range(3)])
         assert difference <= 6
 

From 755ebb8307f887a69a75c0fe024eaed963c411bf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 14:19:27 +1000
Subject: [PATCH 2086/2374] Assert getcolors does not return None

---
 Tests/test_file_png.py | 24 ++++++++++++++++++------
 Tests/test_file_tga.py |  8 ++++++--
 2 files changed, 24 insertions(+), 8 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index ce655235410..dc1077fedab 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -229,7 +229,9 @@ def test_load_transparent_p(self) -> None:
         assert_image(im, "RGBA", (162, 150))
 
         # image has 124 unique alpha values
-        assert len(im.getchannel("A").getcolors()) == 124
+        colors = im.getchannel("A").getcolors()
+        assert colors is not None
+        assert len(colors) == 124
 
     def test_load_transparent_rgb(self) -> None:
         test_file = "Tests/images/rgb_trns.png"
@@ -241,7 +243,9 @@ def test_load_transparent_rgb(self) -> None:
         assert_image(im, "RGBA", (64, 64))
 
         # image has 876 transparent pixels
-        assert im.getchannel("A").getcolors()[0][0] == 876
+        colors = im.getchannel("A").getcolors()
+        assert colors is not None
+        assert colors[0][0] == 876
 
     def test_save_p_transparent_palette(self, tmp_path: Path) -> None:
         in_file = "Tests/images/pil123p.png"
@@ -262,7 +266,9 @@ def test_save_p_transparent_palette(self, tmp_path: Path) -> None:
         assert_image(im, "RGBA", (162, 150))
 
         # image has 124 unique alpha values
-        assert len(im.getchannel("A").getcolors()) == 124
+        colors = im.getchannel("A").getcolors()
+        assert colors is not None
+        assert len(colors) == 124
 
     def test_save_p_single_transparency(self, tmp_path: Path) -> None:
         in_file = "Tests/images/p_trns_single.png"
@@ -285,7 +291,9 @@ def test_save_p_single_transparency(self, tmp_path: Path) -> None:
         assert im.getpixel((31, 31)) == (0, 255, 52, 0)
 
         # image has 876 transparent pixels
-        assert im.getchannel("A").getcolors()[0][0] == 876
+        colors = im.getchannel("A").getcolors()
+        assert colors is not None
+        assert colors[0][0] == 876
 
     def test_save_p_transparent_black(self, tmp_path: Path) -> None:
         # check if solid black image with full transparency
@@ -313,7 +321,9 @@ def test_save_grayscale_transparency(self, tmp_path: Path) -> None:
                 assert im.info["transparency"] == 255
 
                 im_rgba = im.convert("RGBA")
-            assert im_rgba.getchannel("A").getcolors()[0][0] == num_transparent
+            colors = im_rgba.getchannel("A").getcolors()
+            assert colors is not None
+            assert colors[0][0] == num_transparent
 
             test_file = tmp_path / "temp.png"
             im.save(test_file)
@@ -324,7 +334,9 @@ def test_save_grayscale_transparency(self, tmp_path: Path) -> None:
                 assert_image_equal(im, test_im)
 
             test_im_rgba = test_im.convert("RGBA")
-            assert test_im_rgba.getchannel("A").getcolors()[0][0] == num_transparent
+            colors = test_im_rgba.getchannel("A").getcolors()
+            assert colors is not None
+            assert colors[0][0] == num_transparent
 
     def test_save_rgb_single_transparency(self, tmp_path: Path) -> None:
         in_file = "Tests/images/caption_6_33_22.png"
diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index bd39de2e12e..bb8d3eefcc6 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -274,13 +274,17 @@ def test_save_l_transparency(tmp_path: Path) -> None:
     in_file = "Tests/images/la.tga"
     with Image.open(in_file) as im:
         assert im.mode == "LA"
-        assert im.getchannel("A").getcolors()[0][0] == num_transparent
+        colors = im.getchannel("A").getcolors()
+        assert colors is not None
+        assert colors[0][0] == num_transparent
 
         out = tmp_path / "temp.tga"
         im.save(out)
 
     with Image.open(out) as test_im:
         assert test_im.mode == "LA"
-        assert test_im.getchannel("A").getcolors()[0][0] == num_transparent
+        colors = test_im.getchannel("A").getcolors()
+        assert colors is not None
+        assert colors[0][0] == num_transparent
 
         assert_image_equal(im, test_im)

From a66d0d1f05a7a07904961623037ffe4de11fa4f2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 11 Oct 2025 14:48:13 +1100
Subject: [PATCH 2087/2374] Assert getpalette does not return None

---
 Tests/test_image_putpalette.py | 1 +
 Tests/test_imagesequence.py    | 9 +++++++--
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image_putpalette.py b/Tests/test_image_putpalette.py
index f2c447f711c..661764b608a 100644
--- a/Tests/test_image_putpalette.py
+++ b/Tests/test_image_putpalette.py
@@ -62,6 +62,7 @@ def test_putpalette_with_alpha_values() -> None:
         expected = im.convert("RGBA")
 
         palette = im.getpalette()
+        assert palette is not None
         transparency = im.info.pop("transparency")
 
         palette_with_alpha_values = []
diff --git a/Tests/test_imagesequence.py b/Tests/test_imagesequence.py
index 7b9ac80bc5d..32da22e043f 100644
--- a/Tests/test_imagesequence.py
+++ b/Tests/test_imagesequence.py
@@ -76,9 +76,14 @@ def test_consecutive() -> None:
 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]
+        palette = im.getpalette()
+        assert palette is not None
+        color1 = palette[:3]
         im.seek(0)
-        color2 = im.getpalette()[:3]
+
+        palette = im.getpalette()
+        assert palette is not None
+        color2 = palette[:3]
         assert color1 == color2
 
 

From 52413cf0dce42c5eab96209a0a271e125c6cce8c Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Sat, 11 Oct 2025 08:25:07 +0100
Subject: [PATCH 2088/2374] Update Tests/test_arro3.py

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

diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
index 9c70daf5a95..60955cfdb40 100644
--- a/Tests/test_arro3.py
+++ b/Tests/test_arro3.py
@@ -116,9 +116,6 @@ def test_to_array(mode: str, dtype: DataType, mask: list[int] | None) -> None:
     assert arr.type == dtype
 
     reloaded = Image.fromarrow(arr, mode, img.size)
-
-    assert reloaded
-
     assert_image_equal(img, reloaded)
 
 

From fbdf607c7f85731cc66db42938f1cee580303023 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 11 Oct 2025 17:13:22 +0300
Subject: [PATCH 2089/2374] Wheels CI: Check number of expected dists (#9239)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/wheels.yml | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index f1c851bc7c8..9de8a440fc4 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -39,6 +39,7 @@ concurrency:
   cancel-in-progress: true
 
 env:
+  EXPECTED_DISTS: 91
   FORCE_COLOR: 1
 
 jobs:
@@ -250,9 +251,27 @@ jobs:
         name: dist-sdist
         path: dist/*.tar.gz
 
+  count-dists:
+    needs: [build-native-wheels, windows, sdist]
+    runs-on: ubuntu-latest
+    name: Count dists
+    steps:
+      - uses: actions/download-artifact@v5
+        with:
+          pattern: dist-*
+          path: dist
+          merge-multiple: true
+      - name: "What did we get?"
+        run: |
+          ls -alR
+          echo "Number of dists, should be $EXPECTED_DISTS:"
+          files=$(ls dist 2>/dev/null | wc -l)
+          echo $files
+          [ "$files" -eq $EXPECTED_DISTS ] || exit 1
+
   scientific-python-nightly-wheels-publish:
     if: github.repository_owner == 'python-pillow' && (github.event_name == 'schedule' || github.event_name == 'workflow_dispatch')
-    needs: [build-native-wheels, windows]
+    needs: count-dists
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
     steps:
@@ -269,7 +288,7 @@ jobs:
 
   pypi-publish:
     if: github.repository_owner == 'python-pillow' && github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
-    needs: [build-native-wheels, windows, sdist]
+    needs: count-dists
     runs-on: ubuntu-latest
     name: Upload release to PyPI
     environment:

From c874256132f67543e6928be9e97ad3c4bb806d3f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 12 Oct 2025 07:08:52 +1100
Subject: [PATCH 2090/2374] Support saving variable length rational TIFF tags
 by default

---
 Tests/test_file_libtiff.py |  9 +++++++++
 src/PIL/TiffImagePlugin.py | 10 +++++++---
 2 files changed, 16 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 18bcfaa2088..4908496cff3 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -367,6 +367,15 @@ def test_whitepoint_tag(
             assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             assert reloaded.tag_v2[318] == pytest.approx((0.3127, 0.3289))
 
+        # Save tag by default
+        out = tmp_path / "temp2.tif"
+        with Image.open("Tests/images/rdf.tif") as im:
+            im.save(out)
+
+        with Image.open(out) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
+            assert reloaded.tag_v2[318] == pytest.approx((0.3127, 0.3289999))
+
     def test_xmlpacket_tag(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
     ) -> None:
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index c1741284b9f..de2ce066ebf 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -252,6 +252,7 @@
     (II, 3, (1,), 1, (8,), ()): ("P", "P"),
     (MM, 3, (1,), 1, (8,), ()): ("P", "P"),
     (II, 3, (1,), 1, (8, 8), (0,)): ("P", "PX"),
+    (MM, 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"),
@@ -1177,6 +1178,7 @@ def _open(self) -> None:
         """Open the first image in a TIFF file"""
 
         # Header
+        assert self.fp is not None
         ifh = self.fp.read(8)
         if ifh[2] == 43:
             ifh += self.fp.read(8)
@@ -1343,6 +1345,7 @@ def _load_libtiff(self) -> Image.core.PixelAccess | None:
         # To be nice on memory footprint, if there's a
         # file descriptor, use that instead of reading
         # into a string in python.
+        assert self.fp is not None
         try:
             fp = hasattr(self.fp, "fileno") and self.fp.fileno()
             # flush the file descriptor, prevents error on pypy 2.4+
@@ -1936,9 +1939,10 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                     types[tag] = TiffTags.LONG8
                 elif tag in ifd.tagtype:
                     types[tag] = ifd.tagtype[tag]
-                elif not (isinstance(value, (int, float, str, bytes))):
-                    continue
-                else:
+                elif isinstance(value, (int, float, str, bytes)) or (
+                    isinstance(value, tuple)
+                    and all(isinstance(v, (int, float, IFDRational)) for v in value)
+                ):
                     type = TiffTags.lookup(tag).type
                     if type:
                         types[tag] = type

From e36bf768c5ae17a64e86433f7fb2bd0d67fb1a91 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 12 Oct 2025 15:58:22 +1100
Subject: [PATCH 2091/2374] Added four private SGI tags

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

diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index 86adaa45857..761aa3f6b08 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -203,6 +203,11 @@ def lookup(tag: int, group: int | None = None) -> TagInfo:
     531: ("YCbCrPositioning", SHORT, 1),
     532: ("ReferenceBlackWhite", RATIONAL, 6),
     700: ("XMP", BYTE, 0),
+    # Four private SGI tags
+    32995: ("Matteing", SHORT, 1),
+    32996: ("DataType", SHORT, 0),
+    32997: ("ImageDepth", LONG, 1),
+    32998: ("TileDepth", LONG, 1),
     33432: ("Copyright", ASCII, 1),
     33723: ("IptcNaaInfo", UNDEFINED, 1),
     34377: ("PhotoshopInfo", BYTE, 0),

From 1b2121c7a1c17d998af52687cdc13153e8f3622f Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sun, 12 Oct 2025 09:35:05 +0000
Subject: [PATCH 2092/2374] Update dependency cibuildwheel to v3.2.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 8ec7262c090..56517374f5b 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.2.0
+cibuildwheel==3.2.1

From 416fb810742c597280d627323d0e558e8a7f713c Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 12 Oct 2025 21:19:34 +1100
Subject: [PATCH 2093/2374] Removed shebang lines and executable flags (#9179)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/createfontdatachunk.py   | 1 -
 checks/32bit_segfault_check.py | 1 -
 checks/check_imaging_leaks.py  | 1 -
 3 files changed, 3 deletions(-)
 mode change 100755 => 100644 Tests/createfontdatachunk.py
 mode change 100755 => 100644 checks/32bit_segfault_check.py
 mode change 100755 => 100644 checks/check_imaging_leaks.py

diff --git a/Tests/createfontdatachunk.py b/Tests/createfontdatachunk.py
old mode 100755
new mode 100644
index 41c76f87eac..0a3fdb809ed
--- a/Tests/createfontdatachunk.py
+++ b/Tests/createfontdatachunk.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 from __future__ import annotations
 
 import base64
diff --git a/checks/32bit_segfault_check.py b/checks/32bit_segfault_check.py
old mode 100755
new mode 100644
index 06ed2ed2f60..e277bc10af9
--- a/checks/32bit_segfault_check.py
+++ b/checks/32bit_segfault_check.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 from __future__ import annotations
 
 import sys
diff --git a/checks/check_imaging_leaks.py b/checks/check_imaging_leaks.py
old mode 100755
new mode 100644
index e9f202f3d3b..65090b6b6ae
--- a/checks/check_imaging_leaks.py
+++ b/checks/check_imaging_leaks.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 from __future__ import annotations
 
 import sys

From 48922449080e9d9fa7ddcb030bd7d0f242a6bd49 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 13 Oct 2025 00:31:32 +0300
Subject: [PATCH 2094/2374] Update 12.0.0 release notes (#9247)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 docs/releasenotes/12.0.0.rst | 27 +++------------------------
 1 file changed, 3 insertions(+), 24 deletions(-)

diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index de9d6dffd3b..fb5733944f8 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -1,19 +1,6 @@
 12.0.0
 ------
 
-Security
-========
-
-TODO
-^^^^
-
-TODO
-
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
-
 Backwards incompatible changes
 ==============================
 
@@ -132,18 +119,10 @@ Pillow 13 (2026-10-15). They have been set to ``None`` since Pillow 2.3.0.
 API changes
 ===========
 
-TODO
-^^^^
-
-TODO
-
-API additions
-=============
-
-TODO
-^^^^
+Image.alpha_composite: LA images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+:py:meth:`~PIL.Image.alpha_composite` can now use LA images as well as RGBA.
 
 Other changes
 =============

From c60b36d0a738fcfe0fc16ada872564426b5b0748 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 13 Oct 2025 23:24:04 +1100
Subject: [PATCH 2095/2374] Run sdist when scheduled, but do not upload to
 scientific-python-nightly-wheels index (#9248)

---
 .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 9de8a440fc4..3017e36a7cb 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -232,7 +232,7 @@ jobs:
           path: winbuild\build\bin\fribidi*
 
   sdist:
-    if: github.event_name != 'schedule'
+    if: github.event_name != 'schedule' || github.repository_owner == 'python-pillow'
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v5
@@ -277,7 +277,7 @@ jobs:
     steps:
       - uses: actions/download-artifact@v5
         with:
-          pattern: dist-*
+          pattern: dist-*.whl
           path: dist
           merge-multiple: true
       - name: Upload wheels to scientific-python-nightly-wheels

From 014f4212214025bdc417e168a7bb415bbdf0f669 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Oct 2025 08:48:22 +1100
Subject: [PATCH 2096/2374] Removed assert

---
 Tests/test_nanoarrow.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index 90293130e38..69980e71909 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -111,9 +111,6 @@ def test_to_array(mode: str, dtype: nanoarrow, mask: list[int] | None) -> None:
     assert arr.schema.nullable == dtype.nullable
 
     reloaded = Image.fromarrow(arr, mode, img.size)
-
-    assert reloaded
-
     assert_image_equal(img, reloaded)
 
 

From 55f3e63b2251c0ba06b238c8c6bb540ff1c22d46 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Oct 2025 18:25:56 +1100
Subject: [PATCH 2097/2374] Revert "Use macos-14 for iOS arm64 simulator
 (#9161)"

This reverts commit c214ad8c8d40c785c8aca6226b5033085f24cb3d.
---
 .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 3017e36a7cb..8f717a627c4 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -100,7 +100,7 @@ jobs:
             cibw_arch: arm64_iphoneos
           - name: "iOS arm64 simulator"
             platform: ios
-            os: macos-14
+            os: macos-latest
             cibw_arch: arm64_iphonesimulator
           - name: "iOS x86_64 simulator"
             platform: ios

From 2caa504991a2713ddee2a161e6b9f8416b7225ec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Oct 2025 18:57:26 +1100
Subject: [PATCH 2098/2374] ImagingHistogramInstance can use two bands

---
 src/libImaging/Imaging.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/libImaging/Imaging.h b/src/libImaging/Imaging.h
index bfe67d46213..5d85ea73e4d 100644
--- a/src/libImaging/Imaging.h
+++ b/src/libImaging/Imaging.h
@@ -148,7 +148,7 @@ struct ImagingAccessInstance {
 struct ImagingHistogramInstance {
     /* Format */
     char mode[IMAGING_MODE_LENGTH]; /* Band names (of corresponding source image) */
-    int bands;                      /* Number of bands (1, 3, or 4) */
+    int bands;                      /* Number of bands (1, 2, 3, or 4) */
 
     /* Data */
     long *histogram; /* Histogram (bands*256 longs) */

From a59100005548a8dd3df6b201acfd112dcf19bb22 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Oct 2025 20:31:42 +1100
Subject: [PATCH 2099/2374] Removed BGR;24 and BGR;32

---
 src/_imaging.c        | 6 ------
 src/libImaging/Mode.c | 3 ---
 src/libImaging/Mode.h | 3 ---
 3 files changed, 12 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 8412124c191..999b8a30d5a 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -701,12 +701,6 @@ getink(PyObject *color, Imaging im, char *ink) {
                     ink[1] = (UINT8)(v >> 8);
                     ink[2] = ink[3] = 0;
                     return ink;
-                } else if (im->mode == IMAGING_MODE_BGR_24) {
-                    ink[0] = (UINT8)b;
-                    ink[1] = (UINT8)g;
-                    ink[2] = (UINT8)r;
-                    ink[3] = 0;
-                    return ink;
                 }
             }
     }
diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 8222c585b68..78ea5aa7026 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -19,7 +19,6 @@ const ModeData MODES[] = {
     [IMAGING_MODE_RGBa] = {"RGBa"},     [IMAGING_MODE_YCbCr] = {"YCbCr"},
 
     [IMAGING_MODE_BGR_15] = {"BGR;15"}, [IMAGING_MODE_BGR_16] = {"BGR;16"},
-    [IMAGING_MODE_BGR_24] = {"BGR;24"},
 
     [IMAGING_MODE_I_16] = {"I;16"},     [IMAGING_MODE_I_16L] = {"I;16L"},
     [IMAGING_MODE_I_16B] = {"I;16B"},   [IMAGING_MODE_I_16N] = {"I;16N"},
@@ -74,8 +73,6 @@ const RawModeData RAWMODES[] = {
 
     [IMAGING_RAWMODE_BGR_15] = {"BGR;15"},
     [IMAGING_RAWMODE_BGR_16] = {"BGR;16"},
-    [IMAGING_RAWMODE_BGR_24] = {"BGR;24"},
-    [IMAGING_RAWMODE_BGR_32] = {"BGR;32"},
 
     [IMAGING_RAWMODE_I_16] = {"I;16"},
     [IMAGING_RAWMODE_I_16L] = {"I;16L"},
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index a20ad0cb68d..b824becf65f 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -23,7 +23,6 @@ typedef enum {
 
     IMAGING_MODE_BGR_15,
     IMAGING_MODE_BGR_16,
-    IMAGING_MODE_BGR_24,
 
     IMAGING_MODE_I_16,
     IMAGING_MODE_I_16L,
@@ -66,8 +65,6 @@ typedef enum {
     // BGR modes.
     IMAGING_RAWMODE_BGR_15,
     IMAGING_RAWMODE_BGR_16,
-    IMAGING_RAWMODE_BGR_24,
-    IMAGING_RAWMODE_BGR_32,
 
     // I;* modes.
     IMAGING_RAWMODE_I_16,

From 55a4901bba47ebeed65476e8637cf47cfe07a995 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Oct 2025 20:34:03 +1100
Subject: [PATCH 2100/2374] Removed BGR;15 and BGR;16 modes

---
 src/_imaging.c        | 18 ------------------
 src/libImaging/Mode.c |  2 --
 src/libImaging/Mode.h |  9 ++-------
 3 files changed, 2 insertions(+), 27 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 999b8a30d5a..9867fe5710c 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -684,24 +684,6 @@ getink(PyObject *color, Imaging im, char *ink) {
                 } else if (!PyArg_ParseTuple(color, "iiL", &b, &g, &r)) {
                     return NULL;
                 }
-                if (im->mode == IMAGING_MODE_BGR_15) {
-                    UINT16 v = ((((UINT16)r) << 7) & 0x7c00) +
-                               ((((UINT16)g) << 2) & 0x03e0) +
-                               ((((UINT16)b) >> 3) & 0x001f);
-
-                    ink[0] = (UINT8)v;
-                    ink[1] = (UINT8)(v >> 8);
-                    ink[2] = ink[3] = 0;
-                    return ink;
-                } else if (im->mode == IMAGING_MODE_BGR_16) {
-                    UINT16 v = ((((UINT16)r) << 8) & 0xf800) +
-                               ((((UINT16)g) << 3) & 0x07e0) +
-                               ((((UINT16)b) >> 3) & 0x001f);
-                    ink[0] = (UINT8)v;
-                    ink[1] = (UINT8)(v >> 8);
-                    ink[2] = ink[3] = 0;
-                    return ink;
-                }
             }
     }
 
diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 78ea5aa7026..9a855817965 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -18,8 +18,6 @@ const ModeData MODES[] = {
     [IMAGING_MODE_RGBA] = {"RGBA"},     [IMAGING_MODE_RGBX] = {"RGBX"},
     [IMAGING_MODE_RGBa] = {"RGBa"},     [IMAGING_MODE_YCbCr] = {"YCbCr"},
 
-    [IMAGING_MODE_BGR_15] = {"BGR;15"}, [IMAGING_MODE_BGR_16] = {"BGR;16"},
-
     [IMAGING_MODE_I_16] = {"I;16"},     [IMAGING_MODE_I_16L] = {"I;16L"},
     [IMAGING_MODE_I_16B] = {"I;16B"},   [IMAGING_MODE_I_16N] = {"I;16N"},
     [IMAGING_MODE_I_32L] = {"I;32L"},   [IMAGING_MODE_I_32B] = {"I;32B"},
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index b824becf65f..a3eb3d86da5 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -21,9 +21,6 @@ typedef enum {
     IMAGING_MODE_RGBa,
     IMAGING_MODE_YCbCr,
 
-    IMAGING_MODE_BGR_15,
-    IMAGING_MODE_BGR_16,
-
     IMAGING_MODE_I_16,
     IMAGING_MODE_I_16L,
     IMAGING_MODE_I_16B,
@@ -62,10 +59,6 @@ typedef enum {
     IMAGING_RAWMODE_RGBa,
     IMAGING_RAWMODE_YCbCr,
 
-    // BGR modes.
-    IMAGING_RAWMODE_BGR_15,
-    IMAGING_RAWMODE_BGR_16,
-
     // I;* modes.
     IMAGING_RAWMODE_I_16,
     IMAGING_RAWMODE_I_16L,
@@ -95,6 +88,8 @@ typedef enum {
     IMAGING_RAWMODE_BGRA_16L,
     IMAGING_RAWMODE_BGRX,
     IMAGING_RAWMODE_BGR_5,
+    IMAGING_RAWMODE_BGR_15,
+    IMAGING_RAWMODE_BGR_16,
     IMAGING_RAWMODE_BGRa,
     IMAGING_RAWMODE_BGXR,
     IMAGING_RAWMODE_B_16B,

From 8de7e7763e0d7b117c25ae31ef2e19404bf35c17 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Oct 2025 21:47:56 +1100
Subject: [PATCH 2101/2374] Corrected scientific-python-nightly-wheels pattern

---
 .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 3017e36a7cb..eef70f89417 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -277,7 +277,7 @@ jobs:
     steps:
       - uses: actions/download-artifact@v5
         with:
-          pattern: dist-*.whl
+          pattern: dist-!(sdist)*
           path: dist
           merge-multiple: true
       - name: Upload wheels to scientific-python-nightly-wheels

From 9cb36a91d026115734a5dd46f408983035e6c3c4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 15 Oct 2025 18:53:49 +1100
Subject: [PATCH 2102/2374] Upgrade from macos-13 (#9212)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/macos-install.sh       | 13 +------------
 .github/workflows/test.yml               |  2 +-
 .github/workflows/wheels-dependencies.sh |  6 +++++-
 .github/workflows/wheels.yml             |  8 ++++----
 docs/installation/platform-support.rst   |  6 +++---
 5 files changed, 14 insertions(+), 21 deletions(-)

diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index 8060e0850e6..b114d4a23f8 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -2,21 +2,10 @@
 
 set -e
 
-if [[ "$ImageOS" == "macos13" ]]; then
-    brew uninstall gradle maven
-
-    wget https://raw.githubusercontent.com/python-pillow/pillow-depends/main/freetype-2.14.1.tar.gz
-    tar -xvzf freetype-2.14.1.tar.gz
-    (cd freetype-2.14.1 \
-        && ./configure \
-        && make -j4 \
-        && make install)
-else
-    brew install freetype
-fi
 brew install \
     aom \
     dav1d \
+    freetype \
     ghostscript \
     jpeg-turbo \
     libimagequant \
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 8504e5c1e2e..b52000a2766 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -57,7 +57,7 @@ jobs:
         - { python-version: "3.14t", disable-gil: true }
         - { python-version: "3.13t", disable-gil: true }
         # Intel
-        - { os: "macos-13", python-version: "3.10" }
+        - { os: "macos-15-intel", python-version: "3.10" }
         exclude:
         - { os: "macos-latest", python-version: "3.10" }
 
diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 69c867b4dba..7d6eb8681a4 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -271,7 +271,11 @@ function build {
     if [ -z "$IS_ALPINE" ] && [ -z "$SANITIZER" ] && [ -z "$IS_MACOS" ]; then
         yum remove -y zlib-devel
     fi
-    build_zlib_ng
+    if [[ -n "$IS_MACOS" ]]; then
+        CFLAGS="$CFLAGS -headerpad_max_install_names" build_zlib_ng
+    else
+        build_zlib_ng
+    fi
 
     build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
     if [[ -n "$IS_MACOS" ]]; then
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index eef70f89417..6dc8db7e9c8 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -53,19 +53,19 @@ jobs:
         include:
           - name: "macOS 10.10 x86_64"
             platform: macos
-            os: macos-13
+            os: macos-15-intel
             cibw_arch: x86_64
             build: "cp3{10,11}*"
             macosx_deployment_target: "10.10"
           - name: "macOS 10.13 x86_64"
             platform: macos
-            os: macos-13
+            os: macos-15-intel
             cibw_arch: x86_64
             build: "cp3{12,13}*"
             macosx_deployment_target: "10.13"
           - name: "macOS 10.15 x86_64"
             platform: macos
-            os: macos-13
+            os: macos-15-intel
             cibw_arch: x86_64
             build: "{cp314,pp3}*"
             macosx_deployment_target: "10.15"
@@ -104,7 +104,7 @@ jobs:
             cibw_arch: arm64_iphonesimulator
           - name: "iOS x86_64 simulator"
             platform: ios
-            os: macos-13
+            os: macos-15-intel
             cibw_arch: x86_64_iphonesimulator
     steps:
       - uses: actions/checkout@v5
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 186d9b96da5..7999504fbe7 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -39,9 +39,9 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 13 Ventura                 | 3.10                       | x86-64              |
-+----------------------------------+----------------------------+---------------------+
-| macOS 15 Sequoia                 | 3.11, 3.12, 3.13, 3.14     | arm64               |
+| macOS 15 Sequoia                 | 3.10                       | x86-64              |
+|                                  +----------------------------+---------------------+
+|                                  | 3.11, 3.12, 3.13, 3.14,    | arm64               |
 |                                  | PyPy3                      |                     |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.10                       | x86-64              |

From ef323ab7d71ab8ed02704e34e19d51091a976118 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 15 Oct 2025 18:58:55 +1100
Subject: [PATCH 2103/2374] Install dependencies when type checking

---
 .ci/requirements-mypy.txt | 2 ++
 Tests/test_arro3.py       | 4 ++--
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 447856433b4..6ca35d28642 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,6 @@
 mypy==1.18.2
+arro3-compute
+arro3-core
 IceSpringPySideStubs-PyQt6
 IceSpringPySideStubs-PySide6
 ipython
diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
index 60955cfdb40..672eedc9ba4 100644
--- a/Tests/test_arro3.py
+++ b/Tests/test_arro3.py
@@ -16,8 +16,8 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from arro3 import compute  #  type: ignore [import-not-found]
-    from arro3.core import (  #  type: ignore [import-not-found]
+    from arro3 import compute
+    from arro3.core import (
         Array,
         DataType,
         Field,

From 78b0e06dbbe8f7cdeee1fd9234c13b6d4d997876 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 14 Oct 2025 23:41:50 +1100
Subject: [PATCH 2104/2374] Shift bits before making value negative

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

diff --git a/src/libImaging/BcnDecode.c b/src/libImaging/BcnDecode.c
index 7b3d8f908e3..ac81ed6df3d 100644
--- a/src/libImaging/BcnDecode.c
+++ b/src/libImaging/BcnDecode.c
@@ -603,7 +603,7 @@ static void
 bc6_sign_extend(UINT16 *v, int prec) {
     int x = *v;
     if (x & (1 << (prec - 1))) {
-        x |= -1 << prec;
+        x |= -(1 << prec);
     }
     *v = (UINT16)x;
 }

From 4889863139473270b69e5583007760401198cd4c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 15 Oct 2025 19:38:25 +1100
Subject: [PATCH 2105/2374] Renamed ImageText class to Text

---
 Tests/test_imagetext.py      | 24 ++++++++++++------------
 docs/reference/ImageText.rst |  4 ++--
 src/PIL/ImageDraw.py         | 10 +++++-----
 src/PIL/ImageText.py         | 22 +++++++++++-----------
 4 files changed, 30 insertions(+), 30 deletions(-)

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
index b58d048b5df..7db22989786 100644
--- a/Tests/test_imagetext.py
+++ b/Tests/test_imagetext.py
@@ -26,24 +26,24 @@ def font(layout_engine: ImageFont.Layout) -> ImageFont.FreeTypeFont:
 
 
 def test_get_length(font: ImageFont.FreeTypeFont) -> None:
-    assert ImageText.ImageText("A", font).get_length() == 12
-    assert ImageText.ImageText("AB", font).get_length() == 24
-    assert ImageText.ImageText("M", font).get_length() == 12
-    assert ImageText.ImageText("y", font).get_length() == 12
-    assert ImageText.ImageText("a", font).get_length() == 12
+    assert ImageText.Text("A", font).get_length() == 12
+    assert ImageText.Text("AB", font).get_length() == 24
+    assert ImageText.Text("M", font).get_length() == 12
+    assert ImageText.Text("y", font).get_length() == 12
+    assert ImageText.Text("a", font).get_length() == 12
 
 
 def test_get_bbox(font: ImageFont.FreeTypeFont) -> None:
-    assert ImageText.ImageText("A", font).get_bbox() == (0, 4, 12, 16)
-    assert ImageText.ImageText("AB", font).get_bbox() == (0, 4, 24, 16)
-    assert ImageText.ImageText("M", font).get_bbox() == (0, 4, 12, 16)
-    assert ImageText.ImageText("y", font).get_bbox() == (0, 7, 12, 20)
-    assert ImageText.ImageText("a", font).get_bbox() == (0, 7, 12, 16)
+    assert ImageText.Text("A", font).get_bbox() == (0, 4, 12, 16)
+    assert ImageText.Text("AB", font).get_bbox() == (0, 4, 24, 16)
+    assert ImageText.Text("M", font).get_bbox() == (0, 4, 12, 16)
+    assert ImageText.Text("y", font).get_bbox() == (0, 7, 12, 20)
+    assert ImageText.Text("a", font).get_bbox() == (0, 7, 12, 16)
 
 
 def test_standard_embedded_color(layout_engine: ImageFont.Layout) -> None:
     font = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
-    text = ImageText.ImageText("Hello World!", font)
+    text = ImageText.Text("Hello World!", font)
     text.embed_color()
 
     im = Image.new("RGB", (300, 64), "white")
@@ -60,7 +60,7 @@ def test_stroke() -> None:
         im = Image.new("RGB", (120, 130))
         draw = ImageDraw.Draw(im)
         font = ImageFont.truetype(FONT_PATH, 120)
-        text = ImageText.ImageText("A", font)
+        text = ImageText.Text("A", font)
         text.stroke(2, stroke_fill)
 
         # Act
diff --git a/docs/reference/ImageText.rst b/docs/reference/ImageText.rst
index fa55b4f306e..299561acec6 100644
--- a/docs/reference/ImageText.rst
+++ b/docs/reference/ImageText.rst
@@ -16,7 +16,7 @@ Example
     from PIL import Image, ImageDraw, ImageFont, ImageText
     font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 24)
 
-    text = ImageText.ImageText("Hello world", font)
+    text = ImageText.Text("Hello world", font)
     text.embed_color()
     text.stroke(2, "#0f0")
 
@@ -30,5 +30,5 @@ Example
 Methods
 -------
 
-.. autoclass:: PIL.ImageText.ImageText
+.. autoclass:: PIL.ImageText.Text
     :members:
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index f1b5dd4f3f4..0256efd62ad 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -540,7 +540,7 @@ def draw_corners(pieslice: bool) -> None:
     def text(
         self,
         xy: tuple[float, float],
-        text: AnyStr | ImageText.ImageText,
+        text: AnyStr | ImageText.Text,
         fill: _Ink | None = None,
         font: (
             ImageFont.ImageFont
@@ -561,12 +561,12 @@ def text(
         **kwargs: Any,
     ) -> None:
         """Draw text."""
-        if isinstance(text, ImageText.ImageText):
+        if isinstance(text, ImageText.Text):
             imagetext = text
         else:
             if font is None:
                 font = self._getfont(kwargs.get("font_size"))
-            imagetext = ImageText.ImageText(
+            imagetext = ImageText.Text(
                 text, font, self.mode, spacing, direction, features, language
             )
             if embedded_color:
@@ -721,7 +721,7 @@ def textlength(
         """Get the length of a given string, in pixels with 1/64 precision."""
         if font is None:
             font = self._getfont(font_size)
-        imagetext = ImageText.ImageText(
+        imagetext = ImageText.Text(
             text,
             font,
             self.mode,
@@ -757,7 +757,7 @@ def textbbox(
         """Get the bounding box of a given string, in pixels."""
         if font is None:
             font = self._getfont(font_size)
-        imagetext = ImageText.ImageText(
+        imagetext = ImageText.Text(
             text, font, self.mode, spacing, direction, features, language
         )
         if embedded_color:
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index 9bb31a1c8c0..c74570e6939 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -4,7 +4,7 @@
 from ._typing import _Ink
 
 
-class ImageText:
+class Text:
     def __init__(
         self,
         text: str | bytes,
@@ -104,26 +104,26 @@ def get_length(self):
 
         For example, instead of::
 
-            hello = ImageText.ImageText("Hello", font).get_length()
-            world = ImageText.ImageText("World", font).get_length()
-            helloworld = ImageText.ImageText("HelloWorld", font).get_length()
+            hello = ImageText.Text("Hello", font).get_length()
+            world = ImageText.Text("World", font).get_length()
+            helloworld = ImageText.Text("HelloWorld", font).get_length()
             assert hello + world == helloworld
 
         use::
 
             hello = (
-                ImageText.ImageText("HelloW", font).get_length() -
-                ImageText.ImageText("W", font).get_length()
+                ImageText.Text("HelloW", font).get_length() -
+                ImageText.Text("W", font).get_length()
             )  # adjusted for kerning
-            world = ImageText.ImageText("World", font).get_length()
-            helloworld = ImageText.ImageText("HelloWorld", font).get_length()
+            world = ImageText.Text("World", font).get_length()
+            helloworld = ImageText.Text("HelloWorld", font).get_length()
             assert hello + world == helloworld
 
         or disable kerning with (requires libraqm)::
 
-            hello = ImageText.ImageText("Hello", font, features=["-kern"]).get_length()
-            world = ImageText.ImageText("World", font, features=["-kern"]).get_length()
-            helloworld = ImageText.ImageText(
+            hello = ImageText.Text("Hello", font, features=["-kern"]).get_length()
+            world = ImageText.Text("World", font, features=["-kern"]).get_length()
+            helloworld = ImageText.Text(
                 "HelloWorld", font, features=["-kern"]
             ).get_length()
             assert hello + world == helloworld

From 95a85dc6693ca221643906214b0e1f4590986c0f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 15 Oct 2025 19:36:10 +1100
Subject: [PATCH 2106/2374] Use snake case

---
 src/PIL/ImageDraw.py | 40 ++++++++++++++++++++--------------------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 0256efd62ad..a720ad40a1c 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -562,17 +562,17 @@ def text(
     ) -> None:
         """Draw text."""
         if isinstance(text, ImageText.Text):
-            imagetext = text
+            image_text = text
         else:
             if font is None:
                 font = self._getfont(kwargs.get("font_size"))
-            imagetext = ImageText.Text(
+            image_text = ImageText.Text(
                 text, font, self.mode, spacing, direction, features, language
             )
             if embedded_color:
-                imagetext.embed_color()
+                image_text.embed_color()
             if stroke_width:
-                imagetext.stroke(stroke_width, stroke_fill)
+                image_text.stroke(stroke_width, stroke_fill)
 
         def getink(fill: _Ink | None) -> int:
             ink, fill_ink = self._getink(fill)
@@ -586,14 +586,14 @@ def getink(fill: _Ink | None) -> int:
             return
 
         stroke_ink = None
-        if imagetext.stroke_width:
+        if image_text.stroke_width:
             stroke_ink = (
-                getink(imagetext.stroke_fill)
-                if imagetext.stroke_fill is not None
+                getink(image_text.stroke_fill)
+                if image_text.stroke_fill is not None
                 else ink
             )
 
-        for xy, anchor, line in imagetext._split(xy, anchor, align):
+        for xy, anchor, line in image_text._split(xy, anchor, align):
 
             def draw_text(ink: int, stroke_width: float = 0) -> None:
                 mode = self.fontmode
@@ -604,7 +604,7 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                     coord.append(int(xy[i]))
                 start = (math.modf(xy[0])[0], math.modf(xy[1])[0])
                 try:
-                    mask, offset = imagetext.font.getmask2(  # type: ignore[union-attr,misc]
+                    mask, offset = image_text.font.getmask2(  # type: ignore[union-attr,misc]
                         line,
                         mode,
                         direction=direction,
@@ -621,7 +621,7 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                     coord = [coord[0] + offset[0], coord[1] + offset[1]]
                 except AttributeError:
                     try:
-                        mask = imagetext.font.getmask(  # type: ignore[misc]
+                        mask = image_text.font.getmask(  # type: ignore[misc]
                             line,
                             mode,
                             direction,
@@ -635,9 +635,9 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                             **kwargs,
                         )
                     except TypeError:
-                        mask = imagetext.font.getmask(line)
+                        mask = image_text.font.getmask(line)
                 if mode == "RGBA":
-                    # imagetext.font.getmask2(mode="RGBA")
+                    # image_text.font.getmask2(mode="RGBA")
                     # returns color in RGB bands and mask in A
                     # extract mask and set text alpha
                     color, mask = mask, mask.getband(3)
@@ -653,7 +653,7 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
 
             if stroke_ink is not None:
                 # Draw stroked text
-                draw_text(stroke_ink, imagetext.stroke_width)
+                draw_text(stroke_ink, image_text.stroke_width)
 
                 # Draw normal text
                 if ink != stroke_ink:
@@ -721,7 +721,7 @@ def textlength(
         """Get the length of a given string, in pixels with 1/64 precision."""
         if font is None:
             font = self._getfont(font_size)
-        imagetext = ImageText.Text(
+        image_text = ImageText.Text(
             text,
             font,
             self.mode,
@@ -730,8 +730,8 @@ def textlength(
             language=language,
         )
         if embedded_color:
-            imagetext.embed_color()
-        return imagetext.get_length()
+            image_text.embed_color()
+        return image_text.get_length()
 
     def textbbox(
         self,
@@ -757,14 +757,14 @@ def textbbox(
         """Get the bounding box of a given string, in pixels."""
         if font is None:
             font = self._getfont(font_size)
-        imagetext = ImageText.Text(
+        image_text = ImageText.Text(
             text, font, self.mode, spacing, direction, features, language
         )
         if embedded_color:
-            imagetext.embed_color()
+            image_text.embed_color()
         if stroke_width:
-            imagetext.stroke(stroke_width)
-        return imagetext.get_bbox(xy, anchor, align)
+            image_text.stroke(stroke_width)
+        return image_text.get_bbox(xy, anchor, align)
 
     def multiline_textbbox(
         self,

From d5e1601b32ea43b45ce8f820e4b349e9b5e2dd6c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 15 Oct 2025 20:02:12 +1100
Subject: [PATCH 2107/2374] Improved documentation

---
 docs/reference/ImageDraw.rst |  4 ++++
 docs/reference/ImageText.rst | 33 ++++++++++++++++++++++++++++++---
 docs/releasenotes/12.0.0.rst | 33 +++++++++++++++++++++++++++++++++
 3 files changed, 67 insertions(+), 3 deletions(-)

diff --git a/docs/reference/ImageDraw.rst b/docs/reference/ImageDraw.rst
index 6768a04c600..4c956759334 100644
--- a/docs/reference/ImageDraw.rst
+++ b/docs/reference/ImageDraw.rst
@@ -582,6 +582,8 @@ Methods
         hello_world = hello + world  # kerning is disabled, no need to adjust
         assert hello_world == draw.textlength("HelloWorld", font, features=["-kern"])  # True
 
+    .. seealso:: :py:meth:`PIL.ImageText.Text.get_length`
+
     .. versionadded:: 8.0.0
 
     :param text: Text to be measured. May not contain any newline characters.
@@ -683,6 +685,8 @@ Methods
     1/64 pixel precision. The bounding box includes extra margins for
     some fonts, e.g. italics or accents.
 
+    .. seealso:: :py:meth:`PIL.ImageText.Text.get_bbox`
+
     .. versionadded:: 8.0.0
 
     :param xy: The anchor coordinates of the text.
diff --git a/docs/reference/ImageText.rst b/docs/reference/ImageText.rst
index 299561acec6..8744ad36825 100644
--- a/docs/reference/ImageText.rst
+++ b/docs/reference/ImageText.rst
@@ -4,9 +4,9 @@
 :py:mod:`~PIL.ImageText` module
 ===============================
 
-The :py:mod:`~PIL.ImageText` module defines a class with the same name. Instances of
-this class provide a way to use fonts with text strings or bytes. The result is a
-simple API to apply styling to pieces of text and measure or draw them.
+The :py:mod:`~PIL.ImageText` module defines a :py:class:`~PIL.ImageText.Text` class.
+Instances of this class provide a way to use fonts with text strings or bytes. The
+result is a simple API to apply styling to pieces of text and measure or draw them.
 
 Example
 -------
@@ -27,6 +27,33 @@ Example
     d = ImageDraw.Draw(im)
     d.text((0, 0), text, "#f00")
 
+Comparison
+----------
+
+Without ``ImageText.Text``::
+
+  from PIL import Image, ImageDraw
+  im = Image.new(mode, size)
+  d = ImageDraw.Draw(im)
+
+  d.textlength(text, font, direction, features, language, embedded_color)
+  d.multiline_textbbox(xy, text, font, anchor, spacing, align, direction, features, language, stroke_width, embedded_color)
+  d.text(xy, text, fill, font, anchor, spacing, align, direction, features, language, stroke_width, stroke_fill, embedded_color)
+
+With ``ImageText.Text``::
+
+  from PIL import ImageText
+  text = ImageText.Text(text, font, mode, spacing, direction, features, language)
+  text.embed_color()
+  text.stroke(stroke_width, stroke_fill)
+
+  text.get_length()
+  text.get_bbox(xy, anchor, align)
+
+  im = Image.new(mode, size)
+  d = ImageDraw.Draw(im)
+  d.text(xy, text, fill, anchor=anchor, align=align)
+
 Methods
 -------
 
diff --git a/docs/releasenotes/12.0.0.rst b/docs/releasenotes/12.0.0.rst
index fb5733944f8..4c00d8c4cc1 100644
--- a/docs/releasenotes/12.0.0.rst
+++ b/docs/releasenotes/12.0.0.rst
@@ -124,6 +124,39 @@ Image.alpha_composite: LA images
 
 :py:meth:`~PIL.Image.alpha_composite` can now use LA images as well as RGBA.
 
+API additions
+=============
+
+Added ImageText.Text
+^^^^^^^^^^^^^^^^^^^^
+
+:py:class:`PIL.ImageText.Text` has been added, as a simpler way to use fonts with text
+strings or bytes.
+
+Without ``ImageText.Text``::
+
+  from PIL import Image, ImageDraw
+  im = Image.new(mode, size)
+  d = ImageDraw.Draw(im)
+
+  d.textlength(text, font, direction, features, language, embedded_color)
+  d.multiline_textbbox(xy, text, font, anchor, spacing, align, direction, features, language, stroke_width, embedded_color)
+  d.text(xy, text, fill, font, anchor, spacing, align, direction, features, language, stroke_width, stroke_fill, embedded_color)
+
+With ``ImageText.Text``::
+
+  from PIL import ImageText
+  text = ImageText.Text(text, font, mode, spacing, direction, features, language)
+  text.embed_color()
+  text.stroke(stroke_width, stroke_fill)
+
+  text.get_length()
+  text.get_bbox(xy, anchor, align)
+
+  im = Image.new(mode, size)
+  d = ImageDraw.Draw(im)
+  d.text(xy, text, fill, anchor=anchor, align=align)
+
 Other changes
 =============
 

From 3eecafd62c760cf2715f4bcc4c995ead35680e0e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 15 Oct 2025 22:19:38 +1100
Subject: [PATCH 2108/2374] Fixed warning

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

diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index e353ab2e9c0..d2ed10f0a6e 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -149,7 +149,7 @@ assemble_metadata(const char *band_json) {
 }
 
 int
-export_named_type(struct ArrowSchema *schema, char *format, char *name) {
+export_named_type(struct ArrowSchema *schema, char *format, const char *name) {
     char *formatp;
     char *namep;
     size_t format_len = strlen(format) + 1;

From 7d89946688a44e302b5480e8c02c37fe97369c6b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 15 Oct 2025 22:21:51 +1100
Subject: [PATCH 2109/2374] Removed duplicate library

---
 setup.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/setup.py b/setup.py
index 3a72a0742c1..032c1c6d263 100644
--- a/setup.py
+++ b/setup.py
@@ -1086,10 +1086,10 @@ def debug_build() -> bool:
 for src_file in _LIB_IMAGING:
     files.append(os.path.join("src/libImaging", src_file + ".c"))
 ext_modules = [
-    Extension("PIL._imaging", files, libraries=["pil_imaging_mode"]),
-    Extension("PIL._imagingft", ["src/_imagingft.c"], libraries=["pil_imaging_mode"]),
-    Extension("PIL._imagingcms", ["src/_imagingcms.c"], libraries=["pil_imaging_mode"]),
-    Extension("PIL._webp", ["src/_webp.c"], libraries=["pil_imaging_mode"]),
+    Extension("PIL._imaging", files),
+    Extension("PIL._imagingft", ["src/_imagingft.c"]),
+    Extension("PIL._imagingcms", ["src/_imagingcms.c"]),
+    Extension("PIL._webp", ["src/_webp.c"]),
     Extension("PIL._avif", ["src/_avif.c"]),
     Extension("PIL._imagingtk", ["src/_imagingtk.c", "src/Tk/tkImaging.c"]),
     Extension("PIL._imagingmath", ["src/_imagingmath.c"]),

From 592b2f820aa1f75f8ae8bf4f30e1b4bc62023535 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 15 Oct 2025 19:00:54 +0300
Subject: [PATCH 2110/2374] Revert "Use macos-latest for iOS arm64 simulator"

---
 .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 21ea79553ef..6dc8db7e9c8 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -100,7 +100,7 @@ jobs:
             cibw_arch: arm64_iphoneos
           - name: "iOS arm64 simulator"
             platform: ios
-            os: macos-latest
+            os: macos-14
             cibw_arch: arm64_iphonesimulator
           - name: "iOS x86_64 simulator"
             platform: ios

From 693df7b42c666f88c719f9973be0ad71607328e0 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 15 Oct 2025 20:06:44 +0300
Subject: [PATCH 2111/2374] 12.0.0 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 6a3c01f2607..79ce194c334 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "12.0.0.dev0"
+__version__ = "12.0.0"

From 3620d48459da4e8f30278b0abc8d6c3d51565447 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 15 Oct 2025 21:28:16 +0300
Subject: [PATCH 2112/2374] 12.1.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 79ce194c334..41cb17a3697 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "12.0.0"
+__version__ = "12.1.0.dev0"

From 933df2450d9b415eeed656525d4d69c347fa1c7e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 16 Oct 2025 07:21:15 +1100
Subject: [PATCH 2113/2374] Reapply "Use macos-latest for iOS arm64 simulator"

This reverts commit 592b2f820aa1f75f8ae8bf4f30e1b4bc62023535.
---
 .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 6dc8db7e9c8..21ea79553ef 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -100,7 +100,7 @@ jobs:
             cibw_arch: arm64_iphoneos
           - name: "iOS arm64 simulator"
             platform: ios
-            os: macos-14
+            os: macos-latest
             cibw_arch: arm64_iphonesimulator
           - name: "iOS x86_64 simulator"
             platform: ios

From ae7d28eddbdc24bfadb13ed27f01ef8256b29480 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 16 Oct 2025 12:03:13 +1100
Subject: [PATCH 2114/2374] Removed Fedora 41

---
 .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 30e5c494db9..581e1f52bf4 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -49,7 +49,6 @@ jobs:
           debian-12-bookworm-amd64,
           debian-13-trixie-x86,
           debian-13-trixie-amd64,
-          fedora-41-amd64,
           fedora-42-amd64,
           gentoo,
           ubuntu-22.04-jammy-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 7999504fbe7..471bc1eb30e 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -33,8 +33,6 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Debian 13 Trixie                 | 3.13                       | x86, x86-64         |
 +----------------------------------+----------------------------+---------------------+
-| Fedora 41                        | 3.13                       | x86-64              |
-+----------------------------------+----------------------------+---------------------+
 | Fedora 42                        | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |

From ae43b36030a3d8dca20bb908bf158dcadc2cf35f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 16 Oct 2025 20:55:56 +1100
Subject: [PATCH 2115/2374] Simplified code now that I;16* modes are the only
 IMAGING_TYPE_SPECIAL

---
 src/_imaging.c            | 31 +++++--------------------------
 src/libImaging/Geometry.c |  9 +--------
 2 files changed, 6 insertions(+), 34 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index 41af72568f2..f6be4a90124 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -543,12 +543,7 @@ getpixel(Imaging im, ImagingAccess access, int x, int y) {
         case IMAGING_TYPE_FLOAT32:
             return PyFloat_FromDouble(pixel.f);
         case IMAGING_TYPE_SPECIAL:
-            if (im->bands == 1) {
-                return PyLong_FromLong(pixel.h);
-            } else {
-                return Py_BuildValue("BBB", pixel.b[0], pixel.b[1], pixel.b[2]);
-            }
-            break;
+            return PyLong_FromLong(pixel.h);
     }
 
     /* unknown type */
@@ -665,26 +660,10 @@ getink(PyObject *color, Imaging im, char *ink) {
             memcpy(ink, &ftmp, sizeof(ftmp));
             return ink;
         case IMAGING_TYPE_SPECIAL:
-            if (isModeI16(im->mode)) {
-                ink[0] = (UINT8)r;
-                ink[1] = (UINT8)(r >> 8);
-                ink[2] = ink[3] = 0;
-                return ink;
-            } else {
-                if (rIsInt) {
-                    b = (UINT8)(r >> 16);
-                    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"
-                    );
-                    return NULL;
-                } else if (!PyArg_ParseTuple(color, "iiL", &b, &g, &r)) {
-                    return NULL;
-                }
-            }
+            ink[0] = (UINT8)r;
+            ink[1] = (UINT8)(r >> 8);
+            ink[2] = ink[3] = 0;
+            return ink;
     }
 
     PyErr_SetString(PyExc_ValueError, wrong_mode);
diff --git a/src/libImaging/Geometry.c b/src/libImaging/Geometry.c
index 80ecd7cb6b3..2186f95f8e5 100644
--- a/src/libImaging/Geometry.c
+++ b/src/libImaging/Geometry.c
@@ -714,14 +714,7 @@ getfilter(Imaging im, int filterid) {
                     case IMAGING_TYPE_UINT8:
                         return nearest_filter8;
                     case IMAGING_TYPE_SPECIAL:
-                        switch (im->pixelsize) {
-                            case 1:
-                                return nearest_filter8;
-                            case 2:
-                                return nearest_filter16;
-                            case 4:
-                                return nearest_filter32;
-                        }
+                        return nearest_filter16;
                 }
             } else {
                 return nearest_filter32;

From e969fa7aeac1cfc46ef1e6a8e77699f71a9effe8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 Oct 2025 06:14:02 +1100
Subject: [PATCH 2116/2374] Correct __getitem__ return type

---
 Tests/test_image_getdata.py | 2 +-
 src/PIL/_imaging.pyi        | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_image_getdata.py b/Tests/test_image_getdata.py
index dd3d70b3450..c8b213d841b 100644
--- a/Tests/test_image_getdata.py
+++ b/Tests/test_image_getdata.py
@@ -15,7 +15,7 @@ def test_sanity() -> None:
 
 
 def test_mode() -> None:
-    def getdata(mode: str) -> tuple[float | tuple[int, ...], int, int]:
+    def getdata(mode: str) -> tuple[float | tuple[int, ...] | None, 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/src/PIL/_imaging.pyi b/src/PIL/_imaging.pyi
index 998bc52eb8a..81028a5960a 100644
--- a/src/PIL/_imaging.pyi
+++ b/src/PIL/_imaging.pyi
@@ -1,7 +1,7 @@
 from typing import Any
 
 class ImagingCore:
-    def __getitem__(self, index: int) -> float: ...
+    def __getitem__(self, index: int) -> float | tuple[int, ...] | None: ...
     def __getattr__(self, name: str) -> Any: ...
 
 class ImagingFont:

From 03d48f4011d4c35099341ae76fc5bf1f34ea3e9e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 17 Oct 2025 23:05:33 +1100
Subject: [PATCH 2117/2374] Updated macOS tested Pillow versions

---
 docs/installation/platform-support.rst | 196 +++++++++++++------------
 1 file changed, 99 insertions(+), 97 deletions(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 471bc1eb30e..e0c4a8eec3d 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -69,100 +69,102 @@ These platforms have been reported to work at the versions mentioned.
     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 26 Tahoe                   | 3.9, 3.10, 3.11, 3.12, 3.13| 11.3.0           |arm           |
-+----------------------------------+----------------------------+------------------+--------------+
-| macOS 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13| 11.3.0           |arm           |
-|                                  +----------------------------+------------------+              |
-|                                  | 3.8                        | 10.4.0           |              |
-+----------------------------------+----------------------------+------------------+--------------+
-| 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           |
-|                                  +----------------------------+------------------+              |
-|                                  | 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 23H2                  | 3.9, 3.10, 3.11, 3.12, 3.13| 11.0.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        |
-+----------------------------------+----------------------------+------------------+--------------+
++----------------------------------+-----------------------------+------------------+--------------+
+| Operating system                 | | Tested Python             | | Latest tested  | | Tested     |
+|                                  | | versions                  | | Pillow version | | processors |
++==================================+=============================+==================+==============+
+| macOS 26 Tahoe                   | 3.10, 3.11, 3.12, 3.13, 3.14| 12.0.0           |arm           |
+|                                  +-----------------------------+------------------+              |
+|                                  | 3.9                         | 11.3.0           |              |
++----------------------------------+-----------------------------+------------------+--------------+
+| macOS 15 Sequoia                 | 3.9, 3.10, 3.11, 3.12, 3.13 | 11.3.0           |arm           |
+|                                  +-----------------------------+------------------+              |
+|                                  | 3.8                         | 10.4.0           |              |
++----------------------------------+-----------------------------+------------------+--------------+
+| 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           |
+|                                  +-----------------------------+------------------+              |
+|                                  | 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 23H2                  | 3.9, 3.10, 3.11, 3.12, 3.13 | 11.0.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        |
++----------------------------------+-----------------------------+------------------+--------------+

From 51e3fe45bf34fb4c344eaaaadf3434a079c5b6dd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 20 Oct 2025 19:17:38 +1100
Subject: [PATCH 2118/2374] Use different variables for Image and ImageFile
 instances

---
 Tests/test_file_mic.py           |  4 ++--
 Tests/test_file_mpo.py           |  8 ++++----
 Tests/test_file_sun.py           |  4 ++--
 Tests/test_file_tiff.py          |  6 +++---
 Tests/test_file_tiff_metadata.py |  6 +++---
 Tests/test_image.py              | 26 +++++++++++++-------------
 Tests/test_image_convert.py      |  4 ++--
 Tests/test_image_crop.py         |  8 ++++----
 Tests/test_image_quantize.py     | 18 +++++++++---------
 Tests/test_image_resize.py       |  4 ++--
 Tests/test_image_rotate.py       | 16 ++++++++--------
 Tests/test_image_thumbnail.py    |  4 ++--
 Tests/test_imagedraw.py          |  4 ++--
 Tests/test_imageops.py           | 12 ++++++------
 Tests/test_pickle.py             | 10 +++++-----
 Tests/test_shell_injection.py    | 10 ++++++----
 16 files changed, 73 insertions(+), 71 deletions(-)

diff --git a/Tests/test_file_mic.py b/Tests/test_file_mic.py
index 9aeb306e439..0706af4c07d 100644
--- a/Tests/test_file_mic.py
+++ b/Tests/test_file_mic.py
@@ -22,10 +22,10 @@ def test_sanity() -> None:
 
         # Adjust for the gamma of 2.2 encoded into the file
         lut = ImagePalette.make_gamma_lut(1 / 2.2)
-        im = Image.merge("RGBA", [chan.point(lut) for chan in im.split()])
+        im1 = Image.merge("RGBA", [chan.point(lut) for chan in im.split()])
 
         im2 = hopper("RGBA")
-        assert_image_similar(im, im2, 10)
+        assert_image_similar(im1, im2, 10)
 
 
 def test_n_frames() -> None:
diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index f947d141929..4db62bd6d0a 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -300,12 +300,12 @@ def test_save_all() -> None:
             im_reloaded.seek(1)
             assert_image_similar(im, im_reloaded, 30)
 
-    im = Image.new("RGB", (1, 1))
+    im_rgb = Image.new("RGB", (1, 1))
     for colors in (("#f00",), ("#f00", "#0f0")):
         append_images = [Image.new("RGB", (1, 1), color) for color in colors]
-        im_reloaded = roundtrip(im, save_all=True, append_images=append_images)
+        im_reloaded = roundtrip(im_rgb, save_all=True, append_images=append_images)
 
-        assert_image_equal(im, im_reloaded)
+        assert_image_equal(im_rgb, im_reloaded)
         assert isinstance(im_reloaded, MpoImagePlugin.MpoImageFile)
         assert im_reloaded.mpinfo is not None
         assert im_reloaded.mpinfo[45056] == b"0100"
@@ -315,7 +315,7 @@ def test_save_all() -> None:
             assert_image_similar(im_reloaded, im_expected, 1)
 
     # Test that a single frame image will not be saved as an MPO
-    jpg = roundtrip(im, save_all=True)
+    jpg = roundtrip(im_rgb, save_all=True)
     assert "mp" not in jpg.info
 
 
diff --git a/Tests/test_file_sun.py b/Tests/test_file_sun.py
index c2f162cf9b4..78534e15411 100644
--- a/Tests/test_file_sun.py
+++ b/Tests/test_file_sun.py
@@ -84,8 +84,8 @@ def test_rgbx() -> None:
 
     with Image.open(io.BytesIO(data)) as im:
         r, g, b = im.split()
-        im = Image.merge("RGB", (b, g, r))
-        assert_image_equal_tofile(im, os.path.join(EXTRA_DIR, "32bpp.png"))
+        im_rgb = Image.merge("RGB", (b, g, r))
+        assert_image_equal_tofile(im_rgb, os.path.join(EXTRA_DIR, "32bpp.png"))
 
 
 @pytest.mark.skipif(
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index bd364377b74..556c886476e 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -764,9 +764,9 @@ def test_tiff_save_all(self) -> None:
 
         # Test appending images
         mp = BytesIO()
-        im = Image.new("RGB", (100, 100), "#f00")
+        im_rgb = Image.new("RGB", (100, 100), "#f00")
         ims = [Image.new("RGB", (100, 100), color) for color in ["#0f0", "#00f"]]
-        im.copy().save(mp, format="TIFF", save_all=True, append_images=ims)
+        im_rgb.copy().save(mp, format="TIFF", save_all=True, append_images=ims)
 
         mp.seek(0, os.SEEK_SET)
         with Image.open(mp) as reread:
@@ -778,7 +778,7 @@ def im_generator(ims: list[Image.Image]) -> Generator[Image.Image, None, None]:
             yield from ims
 
         mp = BytesIO()
-        im.save(mp, format="TIFF", save_all=True, append_images=im_generator(ims))
+        im_rgb.save(mp, format="TIFF", save_all=True, append_images=im_generator(ims))
 
         mp.seek(0, os.SEEK_SET)
         with Image.open(mp) as reread:
diff --git a/Tests/test_file_tiff_metadata.py b/Tests/test_file_tiff_metadata.py
index 36ad8cee93b..322ef5abcc5 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -175,13 +175,13 @@ def test_change_stripbytecounts_tag_type(tmp_path: Path) -> None:
         del info[278]
 
         # Resize the image so that STRIPBYTECOUNTS will be larger than a SHORT
-        im = im.resize((500, 500))
-        info[TiffImagePlugin.IMAGEWIDTH] = im.width
+        im_resized = im.resize((500, 500))
+        info[TiffImagePlugin.IMAGEWIDTH] = im_resized.width
 
         # STRIPBYTECOUNTS can be a SHORT or a LONG
         info.tagtype[TiffImagePlugin.STRIPBYTECOUNTS] = TiffTags.SHORT
 
-        im.save(out, tiffinfo=info)
+        im_resized.save(out, tiffinfo=info)
 
     with Image.open(out) as reloaded:
         assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
diff --git a/Tests/test_image.py b/Tests/test_image.py
index ac30f785c5e..88f55638ee9 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -613,8 +613,8 @@ def test_linear_gradient(self, mode: str) -> None:
         assert im.getpixel((0, 0)) == 0
         assert im.getpixel((255, 255)) == 255
         with Image.open(target_file) as target:
-            target = target.convert(mode)
-        assert_image_equal(im, target)
+            im_target = target.convert(mode)
+        assert_image_equal(im, im_target)
 
     def test_radial_gradient_wrong_mode(self) -> None:
         # Arrange
@@ -638,8 +638,8 @@ def test_radial_gradient(self, mode: str) -> None:
         assert im.getpixel((0, 0)) == 255
         assert im.getpixel((128, 128)) == 0
         with Image.open(target_file) as target:
-            target = target.convert(mode)
-        assert_image_equal(im, target)
+            im_target = target.convert(mode)
+        assert_image_equal(im, im_target)
 
     def test_register_extensions(self) -> None:
         test_format = "a"
@@ -663,20 +663,20 @@ def test_remap_palette(self) -> None:
             assert_image_equal(im, im.remap_palette(list(range(256))))
 
         # Test identity transform with an RGBA palette
-        im = Image.new("P", (256, 1))
+        im_p = Image.new("P", (256, 1))
         for x in range(256):
-            im.putpixel((x, 0), x)
-        im.putpalette(list(range(256)) * 4, "RGBA")
-        im_remapped = im.remap_palette(list(range(256)))
-        assert_image_equal(im, im_remapped)
-        assert im.palette is not None
+            im_p.putpixel((x, 0), x)
+        im_p.putpalette(list(range(256)) * 4, "RGBA")
+        im_remapped = im_p.remap_palette(list(range(256)))
+        assert_image_equal(im_p, im_remapped)
+        assert im_p.palette is not None
         assert im_remapped.palette is not None
-        assert im.palette.palette == im_remapped.palette.palette
+        assert im_p.palette.palette == im_remapped.palette.palette
 
         # Test illegal image mode
-        with hopper() as im:
+        with hopper() as im_hopper:
             with pytest.raises(ValueError):
-                im.remap_palette([])
+                im_hopper.remap_palette([])
 
     def test_remap_palette_transparency(self) -> None:
         im = Image.new("P", (1, 2), (0, 0, 0))
diff --git a/Tests/test_image_convert.py b/Tests/test_image_convert.py
index 8d0ef4b221d..547a6c2c678 100644
--- a/Tests/test_image_convert.py
+++ b/Tests/test_image_convert.py
@@ -80,8 +80,8 @@ def test_16bit() -> None:
         _test_float_conversion(im)
 
     for color in (65535, 65536):
-        im = Image.new("I", (1, 1), color)
-        im_i16 = im.convert("I;16")
+        im_i = Image.new("I", (1, 1), color)
+        im_i16 = im_i.convert("I;16")
         assert im_i16.getpixel((0, 0)) == 65535
 
 
diff --git a/Tests/test_image_crop.py b/Tests/test_image_crop.py
index 07fec2e64af..b90ce84bc02 100644
--- a/Tests/test_image_crop.py
+++ b/Tests/test_image_crop.py
@@ -78,13 +78,13 @@ def test_crop_crash() -> None:
     extents = (1, 1, 10, 10)
     # works prepatch
     with Image.open(test_img) as img:
-        img2 = img.crop(extents)
-    img2.load()
+        img1 = img.crop(extents)
+    img1.load()
 
     # fail prepatch
     with Image.open(test_img) as img:
-        img = img.crop(extents)
-    img.load()
+        img2 = img.crop(extents)
+    img2.load()
 
 
 def test_crop_zero() -> None:
diff --git a/Tests/test_image_quantize.py b/Tests/test_image_quantize.py
index e8b783ff316..8876285605a 100644
--- a/Tests/test_image_quantize.py
+++ b/Tests/test_image_quantize.py
@@ -58,8 +58,8 @@ def test_rgba_quantize() -> None:
 
 def test_quantize() -> None:
     with Image.open("Tests/images/caption_6_33_22.png") as image:
-        image = image.convert("RGB")
-    converted = image.quantize()
+        converted = image.convert("RGB")
+    converted = converted.quantize()
     assert converted.mode == "P"
     assert_image_similar(converted.convert("RGB"), image, 1)
 
@@ -67,13 +67,13 @@ def test_quantize() -> None:
 def test_quantize_no_dither() -> None:
     image = hopper()
     with Image.open("Tests/images/caption_6_33_22.png") as palette:
-        palette = palette.convert("P")
+        palette_p = palette.convert("P")
 
-    converted = image.quantize(dither=Image.Dither.NONE, palette=palette)
+    converted = image.quantize(dither=Image.Dither.NONE, palette=palette_p)
     assert converted.mode == "P"
     assert converted.palette is not None
-    assert palette.palette is not None
-    assert converted.palette.palette == palette.palette.palette
+    assert palette_p.palette is not None
+    assert converted.palette.palette == palette_p.palette.palette
 
 
 def test_quantize_no_dither2() -> None:
@@ -97,10 +97,10 @@ def test_quantize_no_dither2() -> None:
 def test_quantize_dither_diff() -> None:
     image = hopper()
     with Image.open("Tests/images/caption_6_33_22.png") as palette:
-        palette = palette.convert("P")
+        palette_p = palette.convert("P")
 
-    dither = image.quantize(dither=Image.Dither.FLOYDSTEINBERG, palette=palette)
-    nodither = image.quantize(dither=Image.Dither.NONE, palette=palette)
+    dither = image.quantize(dither=Image.Dither.FLOYDSTEINBERG, palette=palette_p)
+    nodither = image.quantize(dither=Image.Dither.NONE, palette=palette_p)
 
     assert dither.tobytes() != nodither.tobytes()
 
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 270500a44b4..323d31f51fd 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -314,8 +314,8 @@ def resize(mode: str, size: tuple[int, int] | list[int]) -> None:
     @skip_unless_feature("libtiff")
     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)
+            im_resized = im.resize((64, 64))
+            assert im_resized.size == (64, 64)
 
     @pytest.mark.parametrize(
         "mode", ("L", "RGB", "I", "I;16", "I;16L", "I;16B", "I;16N", "F")
diff --git a/Tests/test_image_rotate.py b/Tests/test_image_rotate.py
index 252a15db742..c3ff52f5767 100644
--- a/Tests/test_image_rotate.py
+++ b/Tests/test_image_rotate.py
@@ -43,8 +43,8 @@ def test_angle(angle: int) -> None:
     with Image.open("Tests/images/test-card.png") as im:
         rotate(im, im.mode, angle)
 
-    im = hopper()
-    assert_image_equal(im.rotate(angle), im.rotate(angle, expand=1))
+    im_hopper = hopper()
+    assert_image_equal(im_hopper.rotate(angle), im_hopper.rotate(angle, expand=1))
 
 
 @pytest.mark.parametrize("angle", (0, 45, 90, 180, 270))
@@ -76,9 +76,9 @@ def test_center_0() -> None:
 
     with Image.open("Tests/images/hopper_45.png") as target:
         target_origin = target.size[1] / 2
-        target = target.crop((0, target_origin, 128, target_origin + 128))
+        im_target = target.crop((0, target_origin, 128, target_origin + 128))
 
-    assert_image_similar(im, target, 15)
+    assert_image_similar(im, im_target, 15)
 
 
 def test_center_14() -> None:
@@ -87,22 +87,22 @@ def test_center_14() -> None:
 
     with Image.open("Tests/images/hopper_45.png") as target:
         target_origin = target.size[1] / 2 - 14
-        target = target.crop((6, target_origin, 128 + 6, target_origin + 128))
+        im_target = target.crop((6, target_origin, 128 + 6, target_origin + 128))
 
-        assert_image_similar(im, target, 10)
+        assert_image_similar(im, im_target, 10)
 
 
 def test_translate() -> None:
     im = hopper()
     with Image.open("Tests/images/hopper_45.png") as target:
         target_origin = (target.size[1] / 2 - 64) - 5
-        target = target.crop(
+        im_target = target.crop(
             (target_origin, target_origin, target_origin + 128, target_origin + 128)
         )
 
     im = im.rotate(45, translate=(5, 5), resample=Image.Resampling.BICUBIC)
 
-    assert_image_similar(im, target, 1)
+    assert_image_similar(im, im_target, 1)
 
 
 def test_fastpath_center() -> None:
diff --git a/Tests/test_image_thumbnail.py b/Tests/test_image_thumbnail.py
index 1181f6fcaca..2ae230f3df1 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -159,9 +159,9 @@ 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))
-        ref = ref.resize((18, 18), Image.Resampling.BICUBIC)
+        im_ref = ref.resize((18, 18), Image.Resampling.BICUBIC)
 
         with Image.open("Tests/images/hopper.jpg") as im:
             im.thumbnail((18, 18), Image.Resampling.BICUBIC, reducing_gap=3.0)
 
-            assert_image_similar(ref, im, 1.4)
+            assert_image_similar(im_ref, im, 1.4)
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 790acee2a46..49765cd68d0 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -198,10 +198,10 @@ def test_bitmap() -> None:
     im = Image.new("RGB", (W, H))
     draw = ImageDraw.Draw(im)
     with Image.open("Tests/images/pil123rgba.png") as small:
-        small = small.resize((50, 50), Image.Resampling.NEAREST)
+        small_resized = small.resize((50, 50), Image.Resampling.NEAREST)
 
         # Act
-        draw.bitmap((10, 10), small)
+        draw.bitmap((10, 10), small_resized)
 
     # Assert
     assert_image_equal_tofile(im, "Tests/images/imagedraw_bitmap.png")
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 27ac6f308fc..63cd0e4d4a9 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -261,10 +261,10 @@ def test_colorize_2color() -> None:
 
     # Open test image (256px by 10px, black to white)
     with Image.open("Tests/images/bw_gradient.png") as im:
-        im = im.convert("L")
+        im_l = im.convert("L")
 
     # Create image with original 2-color functionality
-    im_test = ImageOps.colorize(im, "red", "green")
+    im_test = ImageOps.colorize(im_l, "red", "green")
 
     # Test output image (2-color)
     left = (0, 1)
@@ -301,11 +301,11 @@ def test_colorize_2color_offset() -> None:
 
     # Open test image (256px by 10px, black to white)
     with Image.open("Tests/images/bw_gradient.png") as im:
-        im = im.convert("L")
+        im_l = im.convert("L")
 
     # Create image with original 2-color functionality with offsets
     im_test = ImageOps.colorize(
-        im, black="red", white="green", blackpoint=50, whitepoint=100
+        im_l, black="red", white="green", blackpoint=50, whitepoint=100
     )
 
     # Test output image (2-color) with offsets
@@ -343,11 +343,11 @@ def test_colorize_3color_offset() -> None:
 
     # Open test image (256px by 10px, black to white)
     with Image.open("Tests/images/bw_gradient.png") as im:
-        im = im.convert("L")
+        im_l = im.convert("L")
 
     # Create image with new three color functionality with offsets
     im_test = ImageOps.colorize(
-        im,
+        im_l,
         black="red",
         white="green",
         mid="blue",
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index 54cef00ad38..fc76f81e945 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -90,18 +90,18 @@ def test_pickle_la_mode_with_palette(tmp_path: Path) -> None:
     # Arrange
     filename = tmp_path / "temp.pkl"
     with Image.open("Tests/images/hopper.jpg") as im:
-        im = im.convert("PA")
+        im_pa = im.convert("PA")
 
     # Act / Assert
     for protocol in range(pickle.HIGHEST_PROTOCOL + 1):
-        im._mode = "LA"
+        im_pa._mode = "LA"
         with open(filename, "wb") as f:
-            pickle.dump(im, f, protocol)
+            pickle.dump(im_pa, f, protocol)
         with open(filename, "rb") as f:
             loaded_im = pickle.load(f)
 
-        im._mode = "PA"
-        assert im == loaded_im
+        im_pa._mode = "PA"
+        assert im_pa == loaded_im
 
 
 @skip_unless_feature("webp")
diff --git a/Tests/test_shell_injection.py b/Tests/test_shell_injection.py
index 465517bb699..a7e95ed83c8 100644
--- a/Tests/test_shell_injection.py
+++ b/Tests/test_shell_injection.py
@@ -49,11 +49,13 @@ def test_load_djpeg_filename(self, tmp_path: Path) -> None:
     @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
     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)
+            im_rgb = im.convert("RGB")
+            self.assert_save_filename_check(
+                tmp_path, im_rgb, GifImagePlugin._save_netpbm
+            )
 
     @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
     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)
+            im_l = im.convert("L")
+            self.assert_save_filename_check(tmp_path, im_l, GifImagePlugin._save_netpbm)

From 4b90888a7db8953f3f56bf166672661b93343f5a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 20 Oct 2025 19:38:29 +1100
Subject: [PATCH 2119/2374] Added type hints

---
 Tests/test_file_gbr.py  | 2 +-
 Tests/test_file_iptc.py | 2 +-
 src/PIL/ImageText.py    | 5 ++---
 3 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/Tests/test_file_gbr.py b/Tests/test_file_gbr.py
index b8851d82beb..d89ef0583ec 100644
--- a/Tests/test_file_gbr.py
+++ b/Tests/test_file_gbr.py
@@ -33,7 +33,7 @@ def test_multiple_load_operations() -> None:
         assert_image_equal_tofile(im, "Tests/images/gbr.png")
 
 
-def create_gbr_image(info: dict[str, int] = {}, magic_number=b"") -> BytesIO:
+def create_gbr_image(info: dict[str, int] = {}, magic_number: bytes = b"") -> BytesIO:
     return BytesIO(
         b"".join(
             _binary.o32be(i)
diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 5a8aaa3ef32..0376b99977b 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -12,7 +12,7 @@
 
 
 def create_iptc_image(info: dict[str, int] = {}) -> BytesIO:
-    def field(tag, value):
+    def field(tag: tuple[int, int], value: bytes) -> bytes:
         return bytes((0x1C,) + tag + (0, len(value))) + value
 
     data = field((3, 60), bytes((info.get("layers", 1), info.get("component", 0))))
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index c74570e6939..6c5a8a8a3ef 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -88,7 +88,7 @@ def _get_fontmode(self) -> str:
         else:
             return "L"
 
-    def get_length(self):
+    def get_length(self) -> float:
         """
         Returns length (in pixels with 1/64 precision) of text.
 
@@ -130,8 +130,7 @@ def get_length(self):
 
         :return: Either width for horizontal text, or height for vertical text.
         """
-        split_character = "\n" if isinstance(self.text, str) else b"\n"
-        if split_character in self.text:
+        if "\n" in self.text if isinstance(self.text, str) else b"\n" in self.text:
             msg = "can't measure length of multiline text"
             raise ValueError(msg)
         return self.font.getlength(

From e90bb1559cfd0ab18c2af653a1a8b1305bb0b2ca Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 20 Oct 2025 21:00:29 +1100
Subject: [PATCH 2120/2374] Rearranged code

---
 src/PIL/ImageText.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index 6c5a8a8a3ef..8bfd8988443 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -130,7 +130,11 @@ def get_length(self) -> float:
 
         :return: Either width for horizontal text, or height for vertical text.
         """
-        if "\n" in self.text if isinstance(self.text, str) else b"\n" in self.text:
+        if isinstance(self.text, str):
+            multiline = "\n" in self.text
+        else:
+            multiline = b"\n" in self.text
+        if multiline:
             msg = "can't measure length of multiline text"
             raise ValueError(msg)
         return self.font.getlength(

From e1f4352ce9b3b92912f7a678666c9f5bca09101e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 21 Oct 2025 23:11:18 +1100
Subject: [PATCH 2121/2374] Fixed ZeroDivisionError

---
 Tests/images/zero_mask_totals.dds | Bin 0 -> 131 bytes
 Tests/test_file_dds.py            |   5 +++++
 src/PIL/DdsImagePlugin.py         |   3 +++
 3 files changed, 8 insertions(+)
 create mode 100644 Tests/images/zero_mask_totals.dds

diff --git a/Tests/images/zero_mask_totals.dds b/Tests/images/zero_mask_totals.dds
new file mode 100644
index 0000000000000000000000000000000000000000..31e329e4f266b8c8407531b77e65fbd9c46b41a4
GIT binary patch
literal 131
pcmZ>930A0KU|`@EU|?Vb(jd$X#N+@4pe6^XMhPg5LILf-0s!Yi0we$c

literal 0
HcmV?d00001

diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 116dfa59cec..60d0c09bce1 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -380,6 +380,11 @@ def test_palette() -> None:
         assert_image_equal_tofile(im, "Tests/images/transparent.gif")
 
 
+def test_zero_mask_totals() -> None:
+    with Image.open("Tests/images/zero_mask_totals.dds") as im:
+        im.load()
+
+
 def test_unsupported_header_size() -> None:
     with pytest.raises(OSError, match="Unsupported header size 0"):
         with Image.open(BytesIO(b"DDS " + b"\x00" * 4)):
diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index f9ade18f9a1..37e16d52725 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -333,6 +333,7 @@ class DdsImageFile(ImageFile.ImageFile):
     format_description = "DirectDraw Surface"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(4)):
             msg = "not a DDS file"
             raise SyntaxError(msg)
@@ -516,6 +517,8 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
                 # Remove the zero padding, and scale it to 8 bits
                 data += o8(
                     int(((masked_value >> mask_offsets[i]) / mask_totals[i]) * 255)
+                    if mask_totals[i]
+                    else 0
                 )
         self.set_as_raw(data)
         return -1, 0

From 7d6f2ce90b688ef4dfd485cd5336ea52cdf48c77 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 21 Oct 2025 23:35:17 +1100
Subject: [PATCH 2122/2374] Removed BytesIO

---
 src/PIL/DdsImagePlugin.py | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/src/PIL/DdsImagePlugin.py b/src/PIL/DdsImagePlugin.py
index f9ade18f9a1..19a210275da 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -12,7 +12,6 @@
 
 from __future__ import annotations
 
-import io
 import struct
 import sys
 from enum import IntEnum, IntFlag
@@ -340,21 +339,20 @@ def _open(self) -> None:
         if header_size != 124:
             msg = f"Unsupported header size {repr(header_size)}"
             raise OSError(msg)
-        header_bytes = self.fp.read(header_size - 4)
-        if len(header_bytes) != 120:
-            msg = f"Incomplete header: {len(header_bytes)} bytes"
+        header = self.fp.read(header_size - 4)
+        if len(header) != 120:
+            msg = f"Incomplete header: {len(header)} bytes"
             raise OSError(msg)
-        header = io.BytesIO(header_bytes)
 
-        flags, height, width = struct.unpack("<3I", header.read(12))
+        flags, height, width = struct.unpack("<3I", header[:12])
         self._size = (width, height)
         extents = (0, 0) + self.size
 
-        pitch, depth, mipmaps = struct.unpack("<3I", header.read(12))
-        struct.unpack("<11I", header.read(44))  # reserved
+        pitch, depth, mipmaps = struct.unpack("<3I", header[12:24])
+        struct.unpack("<11I", header[24:68])  # reserved
 
         # pixel format
-        pfsize, pfflags, fourcc, bitcount = struct.unpack("<4I", header.read(16))
+        pfsize, pfflags, fourcc, bitcount = struct.unpack("<4I", header[68:84])
         n = 0
         rawmode = None
         if pfflags & DDPF.RGB:
@@ -366,7 +364,7 @@ def _open(self) -> None:
                 self._mode = "RGB"
                 mask_count = 3
 
-            masks = struct.unpack(f"<{mask_count}I", header.read(mask_count * 4))
+            masks = struct.unpack(f"<{mask_count}I", header[84 : 84 + mask_count * 4])
             self.tile = [ImageFile._Tile("dds_rgb", extents, 0, (bitcount, masks))]
             return
         elif pfflags & DDPF.LUMINANCE:

From b1e2f2e6528f92c0b763c86374ef782210a625fe Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 22 Oct 2025 20:08:22 +1100
Subject: [PATCH 2123/2374] Improved coverage

---
 Tests/test_imagetext.py | 11 +++++++++++
 src/PIL/ImageText.py    |  3 +--
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
index 7db22989786..46afea0645a 100644
--- a/Tests/test_imagetext.py
+++ b/Tests/test_imagetext.py
@@ -32,6 +32,10 @@ def test_get_length(font: ImageFont.FreeTypeFont) -> None:
     assert ImageText.Text("y", font).get_length() == 12
     assert ImageText.Text("a", font).get_length() == 12
 
+    text = ImageText.Text("\n", font)
+    with pytest.raises(ValueError, match="can't measure length of multiline text"):
+        text.get_length()
+
 
 def test_get_bbox(font: ImageFont.FreeTypeFont) -> None:
     assert ImageText.Text("A", font).get_bbox() == (0, 4, 12, 16)
@@ -45,6 +49,7 @@ def test_standard_embedded_color(layout_engine: ImageFont.Layout) -> None:
     font = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
     text = ImageText.Text("Hello World!", font)
     text.embed_color()
+    assert text.get_length() == 288
 
     im = Image.new("RGB", (300, 64), "white")
     draw = ImageDraw.Draw(im)
@@ -52,6 +57,12 @@ def test_standard_embedded_color(layout_engine: ImageFont.Layout) -> None:
 
     assert_image_similar_tofile(im, "Tests/images/standard_embedded.png", 3.1)
 
+    text = ImageText.Text("", mode="1")
+    with pytest.raises(
+        ValueError, match="Embedded color supported only in RGB and RGBA modes"
+    ):
+        text.embed_color()
+
 
 @skip_unless_feature("freetype2")
 def test_stroke() -> None:
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index 8bfd8988443..e6ccd824332 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -316,6 +316,5 @@ def get_bbox(
                     max(bbox[3], bbox_line[3]),
                 )
 
-        if bbox is None:
-            return xy[0], xy[1], xy[0], xy[1]
+        assert bbox is not None
         return bbox

From 208bbe95f9ccaf5659d5b246e18ce76bcefeea84 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 22 Oct 2025 22:22:00 +1100
Subject: [PATCH 2124/2374] Remove I;32L and I;32B modes

---
 src/libImaging/Mode.c | 1 -
 src/libImaging/Mode.h | 6 ++----
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index 7521f4cdae4..d6ee261317b 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -20,7 +20,6 @@ const ModeData MODES[] = {
 
     [IMAGING_MODE_I_16] = {"I;16"},   [IMAGING_MODE_I_16L] = {"I;16L"},
     [IMAGING_MODE_I_16B] = {"I;16B"}, [IMAGING_MODE_I_16N] = {"I;16N"},
-    [IMAGING_MODE_I_32L] = {"I;32L"}, [IMAGING_MODE_I_32B] = {"I;32B"},
 };
 
 const ModeID
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index a3eb3d86da5..8cb96c984c4 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -25,8 +25,6 @@ typedef enum {
     IMAGING_MODE_I_16L,
     IMAGING_MODE_I_16B,
     IMAGING_MODE_I_16N,
-    IMAGING_MODE_I_32L,
-    IMAGING_MODE_I_32B,
 } ModeID;
 
 typedef struct {
@@ -64,8 +62,6 @@ typedef enum {
     IMAGING_RAWMODE_I_16L,
     IMAGING_RAWMODE_I_16B,
     IMAGING_RAWMODE_I_16N,
-    IMAGING_RAWMODE_I_32L,
-    IMAGING_RAWMODE_I_32B,
 
     // Rawmodes
     IMAGING_RAWMODE_1_8,
@@ -106,6 +102,8 @@ typedef enum {
     IMAGING_RAWMODE_C_I,
     IMAGING_RAWMODE_Cb,
     IMAGING_RAWMODE_Cr,
+    IMAGING_RAWMODE_I_32B,
+    IMAGING_RAWMODE_I_32L,
     IMAGING_RAWMODE_F_16,
     IMAGING_RAWMODE_F_16B,
     IMAGING_RAWMODE_F_16BS,

From 109ee1569ddc3156229dfc4b683d252409afe51f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 22 Oct 2025 22:24:15 +1100
Subject: [PATCH 2125/2374] Removed I;32L rawmode

---
 src/libImaging/Mode.c | 1 -
 src/libImaging/Mode.h | 1 -
 2 files changed, 2 deletions(-)

diff --git a/src/libImaging/Mode.c b/src/libImaging/Mode.c
index d6ee261317b..2e459c48fb4 100644
--- a/src/libImaging/Mode.c
+++ b/src/libImaging/Mode.c
@@ -75,7 +75,6 @@ const RawModeData RAWMODES[] = {
     [IMAGING_RAWMODE_I_16L] = {"I;16L"},
     [IMAGING_RAWMODE_I_16B] = {"I;16B"},
     [IMAGING_RAWMODE_I_16N] = {"I;16N"},
-    [IMAGING_RAWMODE_I_32L] = {"I;32L"},
     [IMAGING_RAWMODE_I_32B] = {"I;32B"},
 
     [IMAGING_RAWMODE_1_8] = {"1;8"},
diff --git a/src/libImaging/Mode.h b/src/libImaging/Mode.h
index 8cb96c984c4..39c0eb91994 100644
--- a/src/libImaging/Mode.h
+++ b/src/libImaging/Mode.h
@@ -103,7 +103,6 @@ typedef enum {
     IMAGING_RAWMODE_Cb,
     IMAGING_RAWMODE_Cr,
     IMAGING_RAWMODE_I_32B,
-    IMAGING_RAWMODE_I_32L,
     IMAGING_RAWMODE_F_16,
     IMAGING_RAWMODE_F_16B,
     IMAGING_RAWMODE_F_16BS,

From b04d8792f5779b24c3c723dd368a4d43d7609276 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 23 Oct 2025 08:53:00 +1100
Subject: [PATCH 2126/2374] Support writing InkNames

---
 Tests/test_file_libtiff.py | 12 ++++++++++++
 src/PIL/TiffTags.py        |  1 -
 src/encode.c               | 11 ++++++-----
 3 files changed, 18 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 4908496cff3..e53832db3b8 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -355,6 +355,18 @@ def test_subifd(self, tmp_path: Path) -> None:
             # Should not segfault
             im.save(outfile)
 
+    def test_inknames_tag(
+        self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
+
+        out = tmp_path / "temp.tif"
+        hopper("L").save(out, tiffinfo={333: "name\x00"})
+
+        with Image.open(out) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
+            assert reloaded.tag_v2[333] in ("name", "name\x00")
+
     def test_whitepoint_tag(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
     ) -> None:
diff --git a/src/PIL/TiffTags.py b/src/PIL/TiffTags.py
index 761aa3f6b08..613a3b7def7 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -558,7 +558,6 @@ def _populate() -> None:
 LIBTIFF_CORE.remove(255)  # We don't have support for subfiletypes
 LIBTIFF_CORE.remove(322)  # We don't have support for writing tiled images with libtiff
 LIBTIFF_CORE.remove(323)  # Tiled images
-LIBTIFF_CORE.remove(333)  # Ink Names either
 
 # Note to advanced users: There may be combinations of these
 # parameters and values that when added properly, will work and
diff --git a/src/encode.c b/src/encode.c
index b1d0181e0b7..f0e204bc6eb 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -668,10 +668,10 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
     int key_int, status, is_core_tag, is_var_length, num_core_tags, i;
     TIFFDataType type = TIFF_NOTYPE;
     // This list also exists in TiffTags.py
-    const int core_tags[] = {256,   257, 258,   259, 262, 263, 266,   269,   274,
-                             277,   278, 280,   281, 340, 341, 282,   283,   284,
-                             286,   287, 296,   297, 320, 321, 338,   32995, 32998,
-                             32996, 339, 32997, 330, 531, 530, 65537, 301,   532};
+    const int core_tags[] = {256, 257, 258,   259,   262,   263,   266,  269, 274, 277,
+                             278, 280, 281,   282,   283,   284,   286,  287, 296, 297,
+                             301, 320, 321,   330,   333,   338,   339,  340, 341, 530,
+                             531, 532, 32995, 32996, 32997, 32998, 65537};
 
     Py_ssize_t tags_size;
     PyObject *item;
@@ -821,7 +821,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
             }
         }
 
-        if (type == TIFF_BYTE || type == TIFF_UNDEFINED) {
+        if (type == TIFF_BYTE || type == TIFF_UNDEFINED ||
+            key_int == TIFFTAG_INKNAMES) {
             status = ImagingLibTiffSetField(
                 &encoder->state,
                 (ttag_t)key_int,

From ddd4f007209a3af7f8976322c13c97f205cc4f06 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 23 Oct 2025 20:03:14 +1100
Subject: [PATCH 2127/2374] Support writing IFD tag types

---
 Tests/test_file_libtiff.py | 14 ++++++++++++++
 src/encode.c               |  2 +-
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index e53832db3b8..38e4111a1d6 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -355,6 +355,20 @@ def test_subifd(self, tmp_path: Path) -> None:
             # Should not segfault
             im.save(outfile)
 
+    def test_ifd(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
+        monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
+
+        ifd = TiffImagePlugin.ImageFileDirectory_v2()
+        ifd[37000] = 100
+        ifd.tagtype[37000] = TiffTags.IFD
+
+        out = tmp_path / "temp.tif"
+        im = Image.new("L", (1, 1))
+        im.save(out, tiffinfo=ifd)
+
+        with Image.open(out) as reloaded:
+            assert reloaded.tag_v2[37000] == 100
+
     def test_inknames_tag(
         self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
     ) -> None:
diff --git a/src/encode.c b/src/encode.c
index f0e204bc6eb..2e9ef843d74 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -974,7 +974,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, (UINT16)PyLong_AsLong(value)
                 );
-            } else if (type == TIFF_LONG) {
+            } else if (type == TIFF_LONG || type == TIFF_IFD) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, (UINT32)PyLong_AsLong(value)
                 );

From 82cdaa456c88139a2d8d6d23cac8b9dacf4dc75f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 24 Oct 2025 03:55:45 +1100
Subject: [PATCH 2128/2374] Support writing SIGNED_RATIONAL tag types

---
 Tests/test_file_libtiff.py | 7 +++++--
 src/encode.c               | 7 ++-----
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 38e4111a1d6..7cb3ea8e40b 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -355,12 +355,15 @@ def test_subifd(self, tmp_path: Path) -> None:
             # Should not segfault
             im.save(outfile)
 
-    def test_ifd(self, monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
+    @pytest.mark.parametrize("tagtype", (TiffTags.SIGNED_RATIONAL, TiffTags.IFD))
+    def test_tag_type(
+        self, tagtype: int, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+    ) -> None:
         monkeypatch.setattr(TiffImagePlugin, "WRITE_LIBTIFF", True)
 
         ifd = TiffImagePlugin.ImageFileDirectory_v2()
         ifd[37000] = 100
-        ifd.tagtype[37000] = TiffTags.IFD
+        ifd.tagtype[37000] = tagtype
 
         out = tmp_path / "temp.tif"
         im = Image.new("L", (1, 1))
diff --git a/src/encode.c b/src/encode.c
index 2e9ef843d74..513309c8d7d 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -990,10 +990,6 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 status = ImagingLibTiffSetField(
                     &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)
-                );
             } else if (type == TIFF_SBYTE) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, (INT8)PyLong_AsLong(value)
@@ -1002,7 +998,8 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, PyBytes_AsString(value)
                 );
-            } else if (type == TIFF_RATIONAL) {
+            } else if (type == TIFF_DOUBLE || type == TIFF_SRATIONAL ||
+                       type == TIFF_RATIONAL) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, (FLOAT64)PyFloat_AsDouble(value)
                 );

From 29c5ffe7451bc981925a9c4f8cb294d69e086d32 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 27 Oct 2025 02:48:10 +0000
Subject: [PATCH 2129/2374] Update github-actions

---
 .github/workflows/cifuzz.yml       |  4 ++--
 .github/workflows/test-windows.yml |  2 +-
 .github/workflows/test.yml         |  2 +-
 .github/workflows/wheels.yml       | 14 +++++++-------
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/cifuzz.yml b/.github/workflows/cifuzz.yml
index 0456bbaba3c..6a86b8aeb3b 100644
--- a/.github/workflows/cifuzz.yml
+++ b/.github/workflows/cifuzz.yml
@@ -44,13 +44,13 @@ jobs:
         language: python
         dry-run: false
     - name: Upload New Crash
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       if: failure() && steps.build.outcome == 'success'
       with:
         name: artifacts
         path: ./out/artifacts
     - name: Upload Legacy Crash
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       if: steps.run.outcome == 'success'
       with:
         name: crash
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index f6a7dd46b04..02d4da999bf 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -216,7 +216,7 @@ jobs:
       shell: bash
 
     - name: Upload errors
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       if: failure()
       with:
         name: errors
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index b52000a2766..ef7b34b8d10 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -140,7 +140,7 @@ jobs:
         mkdir -p Tests/errors
 
     - name: Upload errors
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       if: failure()
       with:
         name: errors
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 6dc8db7e9c8..4bc48bec975 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -134,7 +134,7 @@ jobs:
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v5
         with:
           name: dist-${{ matrix.name }}
           path: ./wheelhouse/*.whl
@@ -220,13 +220,13 @@ jobs:
         shell: cmd
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: dist-windows-${{ matrix.cibw_arch }}
           path: ./wheelhouse/*.whl
 
       - name: Upload fribidi.dll
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v5
         with:
           name: fribidi-windows-${{ matrix.cibw_arch }}
           path: winbuild\build\bin\fribidi*
@@ -246,7 +246,7 @@ jobs:
 
     - run: make sdist
 
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v5
       with:
         name: dist-sdist
         path: dist/*.tar.gz
@@ -256,7 +256,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Count dists
     steps:
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v6
         with:
           pattern: dist-*
           path: dist
@@ -275,7 +275,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
     steps:
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v6
         with:
           pattern: dist-!(sdist)*
           path: dist
@@ -297,7 +297,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v5
+      - uses: actions/download-artifact@v6
         with:
           pattern: dist-*
           path: dist

From dfd24ba6150ea3803099d445ce1a486fb7e87c13 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 30 Oct 2025 22:03:39 +1100
Subject: [PATCH 2130/2374] Read all non-zero transparency from mode 1 images
 in the same way

---
 Tests/test_file_png.py    | 9 +++++++++
 src/PIL/PngImagePlugin.py | 4 +++-
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index dc1077fedab..9875fe09676 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -338,6 +338,15 @@ def test_save_grayscale_transparency(self, tmp_path: Path) -> None:
             assert colors is not None
             assert colors[0][0] == num_transparent
 
+    def test_save_1_transparency(self, tmp_path: Path) -> None:
+        out = tmp_path / "temp.png"
+
+        im = Image.new("1", (1, 1), 1)
+        im.save(out, transparency=1)
+
+        with Image.open(out) as reloaded:
+            assert reloaded.info["transparency"] == 255
+
     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:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index d0f22f812e5..11a48e55c39 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -509,7 +509,9 @@ def chunk_tRNS(self, pos: int, length: int) -> bytes:
                 # 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;16"):
+        elif self.im_mode == "1":
+            self.im_info["transparency"] = 255 if i16(s) else 0
+        elif self.im_mode in ("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)

From 1a27f958d7d51e9fef68493d68a29c423e5f6e38 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 31 Oct 2025 18:19:05 +1100
Subject: [PATCH 2131/2374] Updated brotli to 1.2.0

---
 .github/workflows/wheels-dependencies.sh |  9 ++---
 .pre-commit-config.yaml                  |  6 ++--
 MANIFEST.in                              |  1 -
 patches/README.md                        | 14 --------
 patches/iOS/brotli-1.1.0.tar.gz.patch    | 46 ------------------------
 winbuild/build_prepare.py                |  2 +-
 6 files changed, 7 insertions(+), 71 deletions(-)
 delete mode 100644 patches/README.md
 delete mode 100644 patches/iOS/brotli-1.1.0.tar.gz.patch

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 7d6eb8681a4..cdc1faf15ac 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -32,7 +32,6 @@ if [[ "$CIBW_PLATFORM" == "ios" ]]; then
     # or `build/deps/iphonesimulator`
     WORKDIR=$(pwd)/build/$IOS_SDK
     BUILD_PREFIX=$(pwd)/build/deps/$IOS_SDK
-    PATCH_DIR=$(pwd)/patches/iOS
 
     # GNU tooling insists on using aarch64 rather than arm64
     if [[ $PLAT == "arm64" ]]; then
@@ -90,9 +89,7 @@ fi
 
 ARCHIVE_SDIR=pillow-depends-main
 
-# Package versions for fresh source builds. Version numbers with "Patched"
-# annotations have a source code patch that is required for some platforms. If
-# you change those versions, ensure the patch is also updated.
+# Package versions for fresh source builds.
 if [[ -n "$IOS_SDK" ]]; then
   FREETYPE_VERSION=2.13.3
 else
@@ -110,7 +107,7 @@ ZLIB_NG_VERSION=2.2.5
 LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
-BROTLI_VERSION=1.1.0  # Patched; next release won't need patching. See patch file.
+BROTLI_VERSION=1.2.0
 LIBAVIF_VERSION=1.3.0
 
 function build_pkg_config {
@@ -168,7 +165,7 @@ function build_brotli {
     if [ -e brotli-stamp ]; then return; fi
     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_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib $HOST_CMAKE_FLAGS . \
+        && cmake -DCMAKE_INSTALL_PREFIX=$BUILD_PREFIX -DCMAKE_INSTALL_LIBDIR=$BUILD_PREFIX/lib -DCMAKE_INSTALL_NAME_DIR=$BUILD_PREFIX/lib -DCMAKE_MACOSX_BUNDLE=OFF $HOST_CMAKE_FLAGS . \
         && make -j4 install)
     touch brotli-stamp
 }
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index ab0153687d2..b9f7e599b89 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -21,7 +21,7 @@ repos:
     rev: v1.5.5
     hooks:
       - id: remove-tabs
-        exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$|\.patch$)
+        exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
     rev: v21.1.2
@@ -46,9 +46,9 @@ repos:
       - id: check-yaml
         args: [--allow-multiple-documents]
       - id: end-of-file-fixer
-        exclude: ^Tests/images/|\.patch$
+        exclude: ^Tests/images/
       - id: trailing-whitespace
-        exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
+        exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
     rev: 0.34.0
diff --git a/MANIFEST.in b/MANIFEST.in
index 6623f227d60..d4623a4a8e5 100644
--- a/MANIFEST.in
+++ b/MANIFEST.in
@@ -15,7 +15,6 @@ include tox.ini
 graft Tests
 graft Tests/images
 graft checks
-graft patches
 graft src
 graft depends
 graft winbuild
diff --git a/patches/README.md b/patches/README.md
deleted file mode 100644
index ff4a8f0994f..00000000000
--- a/patches/README.md
+++ /dev/null
@@ -1,14 +0,0 @@
-Although we try to use official sources for dependencies, sometimes the official
-sources don't support a platform (especially mobile platforms), or there's a bug
-fix/feature that is required to support Pillow's usage.
-
-This folder contains patches that must be applied to official sources, organized
-by the platforms that need those patches.
-
-Each patch is against the root of the unpacked official tarball, and is named by
-appending `.patch` to the end of the tarball that is to be patched. This
-includes the full version number; so if the version is bumped, the patch will
-at a minimum require a filename change.
-
-Wherever possible, these patches should be contributed upstream, in the hope that
-future Pillow versions won't need to maintain these patches.
diff --git a/patches/iOS/brotli-1.1.0.tar.gz.patch b/patches/iOS/brotli-1.1.0.tar.gz.patch
deleted file mode 100644
index f165a9ac12f..00000000000
--- a/patches/iOS/brotli-1.1.0.tar.gz.patch
+++ /dev/null
@@ -1,46 +0,0 @@
-# Brotli 1.1.0 doesn't have explicit support for iOS as a CMAKE_SYSTEM_NAME.
-# That release was from 2023; there have been subsequent changes that allow
-# Brotli to build on iOS without any patches, as long as -DBROTLI_BUILD_TOOLS=NO
-# is specified on the command line.
-#
-diff -ru brotli-1.1.0-orig/CMakeLists.txt brotli-1.1.0/CMakeLists.txt
---- brotli-1.1.0-orig/CMakeLists.txt	2023-08-29 19:00:29
-+++ brotli-1.1.0/CMakeLists.txt	2024-11-07 10:46:26
-@@ -114,6 +114,8 @@
-   add_definitions(-DOS_MACOSX)
-   set(CMAKE_MACOS_RPATH TRUE)
-   set(CMAKE_INSTALL_NAME_DIR "${CMAKE_INSTALL_PREFIX}/lib")
-+elseif(${CMAKE_SYSTEM_NAME} MATCHES "iOS")
-+  add_definitions(-DOS_IOS)
- endif()
- 
- if(BROTLI_EMSCRIPTEN)
-@@ -174,10 +176,12 @@
- 
- # Installation
- if(NOT BROTLI_BUNDLED_MODE)
--  install(
--    TARGETS brotli
--    RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}"
--  )
-+  if(NOT ${CMAKE_SYSTEM_NAME} MATCHES "iOS")
-+    install(
-+      TARGETS brotli
-+      RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}"
-+    )
-+  endif()
- 
-   install(
-     TARGETS ${BROTLI_LIBRARIES_CORE}
-diff -ru brotli-1.1.0-orig/c/common/platform.h brotli-1.1.0/c/common/platform.h
---- brotli-1.1.0-orig/c/common/platform.h	2023-08-29 19:00:29
-+++ brotli-1.1.0/c/common/platform.h	2024-11-07 10:47:28
-@@ -33,7 +33,7 @@
- #include <endian.h>
- #elif defined(OS_FREEBSD)
- #include <machine/endian.h>
--#elif defined(OS_MACOSX)
-+#elif defined(OS_MACOSX) || defined(OS_IOS)
- #include <machine/endian.h>
- /* Let's try and follow the Linux convention */
- #define BROTLI_X_BYTE_ORDER BYTE_ORDER
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 186a80cca5e..1277e404fca 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ def cmd_msbuild(
 }
 
 V = {
-    "BROTLI": "1.1.0",
+    "BROTLI": "1.2.0",
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "12.1.0",

From b3d9bd9950d9806ef904566896228d37df824821 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 3 Nov 2025 23:07:15 +1100
Subject: [PATCH 2132/2374] Test ImageFont.ImageFont, in case freetype2 is not
 supported

---
 Tests/test_imagetext.py | 79 +++++++++++++++++++++++++++--------------
 1 file changed, 53 insertions(+), 26 deletions(-)

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
index 46afea0645a..2b424629dfd 100644
--- a/Tests/test_imagetext.py
+++ b/Tests/test_imagetext.py
@@ -2,7 +2,7 @@
 
 import pytest
 
-from PIL import Image, ImageDraw, ImageFont, ImageText
+from PIL import Image, ImageDraw, ImageFont, ImageText, features
 
 from .helper import assert_image_similar_tofile, skip_unless_feature
 
@@ -20,42 +20,69 @@ def layout_engine(request: pytest.FixtureRequest) -> ImageFont.Layout:
     return request.param
 
 
-@pytest.fixture(scope="module")
-def font(layout_engine: ImageFont.Layout) -> ImageFont.FreeTypeFont:
-    return ImageFont.truetype(FONT_PATH, 20, layout_engine=layout_engine)
-
-
-def test_get_length(font: ImageFont.FreeTypeFont) -> None:
-    assert ImageText.Text("A", font).get_length() == 12
-    assert ImageText.Text("AB", font).get_length() == 24
-    assert ImageText.Text("M", font).get_length() == 12
-    assert ImageText.Text("y", font).get_length() == 12
-    assert ImageText.Text("a", font).get_length() == 12
+@pytest.fixture(
+    scope="module",
+    params=[
+        None,
+        pytest.param(ImageFont.Layout.BASIC, marks=skip_unless_feature("freetype2")),
+        pytest.param(ImageFont.Layout.RAQM, marks=skip_unless_feature("raqm")),
+    ],
+)
+def font(
+    request: pytest.FixtureRequest,
+) -> ImageFont.ImageFont | ImageFont.FreeTypeFont:
+    layout_engine = request.param
+    if layout_engine is None:
+        return ImageFont.load_default_imagefont()
+    else:
+        return ImageFont.truetype(FONT_PATH, 20, layout_engine=layout_engine)
+
+
+def test_get_length(font: ImageFont.ImageFont | ImageFont.FreeTypeFont) -> None:
+    factor = 1 if isinstance(font, ImageFont.ImageFont) else 2
+    assert ImageText.Text("A", font).get_length() == 6 * factor
+    assert ImageText.Text("AB", font).get_length() == 12 * factor
+    assert ImageText.Text("M", font).get_length() == 6 * factor
+    assert ImageText.Text("y", font).get_length() == 6 * factor
+    assert ImageText.Text("a", font).get_length() == 6 * factor
 
     text = ImageText.Text("\n", font)
     with pytest.raises(ValueError, match="can't measure length of multiline text"):
         text.get_length()
 
 
-def test_get_bbox(font: ImageFont.FreeTypeFont) -> None:
-    assert ImageText.Text("A", font).get_bbox() == (0, 4, 12, 16)
-    assert ImageText.Text("AB", font).get_bbox() == (0, 4, 24, 16)
-    assert ImageText.Text("M", font).get_bbox() == (0, 4, 12, 16)
-    assert ImageText.Text("y", font).get_bbox() == (0, 7, 12, 20)
-    assert ImageText.Text("a", font).get_bbox() == (0, 7, 12, 16)
+@pytest.mark.parametrize(
+    "text, expected",
+    (
+        ("A", (0, 4, 12, 16)),
+        ("AB", (0, 4, 24, 16)),
+        ("M", (0, 4, 12, 16)),
+        ("y", (0, 7, 12, 20)),
+        ("a", (0, 7, 12, 16)),
+    ),
+)
+def test_get_bbox(
+    font: ImageFont.ImageFont | ImageFont.FreeTypeFont,
+    text: str,
+    expected: tuple[int, int, int, int],
+) -> None:
+    if isinstance(font, ImageFont.ImageFont):
+        expected = (0, 0, expected[2] // 2, 11)
+    assert ImageText.Text(text, font).get_bbox() == expected
 
 
 def test_standard_embedded_color(layout_engine: ImageFont.Layout) -> None:
-    font = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
-    text = ImageText.Text("Hello World!", font)
-    text.embed_color()
-    assert text.get_length() == 288
+    if features.check_module("freetype2"):
+        font = ImageFont.truetype(FONT_PATH, 40, layout_engine=layout_engine)
+        text = ImageText.Text("Hello World!", font)
+        text.embed_color()
+        assert text.get_length() == 288
 
-    im = Image.new("RGB", (300, 64), "white")
-    draw = ImageDraw.Draw(im)
-    draw.text((10, 10), text, "#fa6")
+        im = Image.new("RGB", (300, 64), "white")
+        draw = ImageDraw.Draw(im)
+        draw.text((10, 10), text, "#fa6")
 
-    assert_image_similar_tofile(im, "Tests/images/standard_embedded.png", 3.1)
+        assert_image_similar_tofile(im, "Tests/images/standard_embedded.png", 3.1)
 
     text = ImageText.Text("", mode="1")
     with pytest.raises(

From 85d783fb52cd93584da76018baec888cbf680f6d Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 3 Nov 2025 17:20:17 +0000
Subject: [PATCH 2133/2374] [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.13.3 → v0.14.3](https://github.com/astral-sh/ruff-pre-commit/compare/v0.13.3...v0.14.3)
- [github.com/python-jsonschema/check-jsonschema: 0.34.0 → 0.34.1](https://github.com/python-jsonschema/check-jsonschema/compare/0.34.0...0.34.1)
- [github.com/zizmorcore/zizmor-pre-commit: v1.14.2 → v1.16.2](https://github.com/zizmorcore/zizmor-pre-commit/compare/v1.14.2...v1.16.2)
- [github.com/sphinx-contrib/sphinx-lint: v1.0.0 → v1.0.1](https://github.com/sphinx-contrib/sphinx-lint/compare/v1.0.0...v1.0.1)
- [github.com/tox-dev/pyproject-fmt: v2.7.0 → v2.11.0](https://github.com/tox-dev/pyproject-fmt/compare/v2.7.0...v2.11.0)
- [github.com/tox-dev/tox-ini-fmt: 1.6.0 → 1.7.0](https://github.com/tox-dev/tox-ini-fmt/compare/1.6.0...1.7.0)
---
 .pre-commit-config.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index ab0153687d2..beef225fd77 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.13.3
+    rev: v0.14.3
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
@@ -51,24 +51,24 @@ repos:
         exclude: ^.github/.*TEMPLATE|^Tests/(fonts|images)/|\.patch$
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.34.0
+    rev: 0.34.1
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.14.2
+    rev: v1.16.2
     hooks:
       - id: zizmor
 
   - repo: https://github.com/sphinx-contrib/sphinx-lint
-    rev: v1.0.0
+    rev: v1.0.1
     hooks:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.7.0
+    rev: v2.11.0
     hooks:
       - id: pyproject-fmt
 
@@ -79,7 +79,7 @@ repos:
         additional_dependencies: [trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.6.0
+    rev: 1.7.0
     hooks:
       - id: tox-ini-fmt
 

From 666dd5247819ceec8b772758f2d0d2d1e9ec0572 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 3 Nov 2025 19:56:21 +0200
Subject: [PATCH 2134/2374] Drop removed rule

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

diff --git a/pyproject.toml b/pyproject.toml
index 0006ccd1297..f4514925d1c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -189,7 +189,6 @@ lint.ignore = [
   "PT012",  # pytest-raises-with-multiple-statements
   "PT017",  # pytest-assert-in-except
   "PYI034", # flake8-pyi: typing.Self added in Python 3.11
-  "UP038",  # pyupgrade: deprecated rule
 ]
 lint.per-file-ignores."Tests/oss-fuzz/fuzz_font.py" = [
   "I002",

From e44ce2f00e6c1fd8fffa30b812aa522e5c16fbdb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Nov 2025 19:09:49 +1100
Subject: [PATCH 2135/2374] Updated harfbuzz to 12.2.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 7d6eb8681a4..226fcdb6af7 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -98,7 +98,7 @@ if [[ -n "$IOS_SDK" ]]; then
 else
   FREETYPE_VERSION=2.14.1
 fi
-HARFBUZZ_VERSION=12.1.0
+HARFBUZZ_VERSION=12.2.0
 LIBPNG_VERSION=1.6.50
 JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.4
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 186a80cca5e..2401dd4ecd6 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.1.0",
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "12.1.0",
+    "HARFBUZZ": "12.2.0",
     "JPEGTURBO": "3.1.2",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",

From 18c7f87fe3180e494c9397d63f917aa9f05d870c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Nov 2025 23:21:46 +1100
Subject: [PATCH 2136/2374] Added Fedora 43

---
 .github/workflows/test-docker.yml      | 1 +
 docs/installation/platform-support.rst | 2 ++
 2 files changed, 3 insertions(+)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 581e1f52bf4..213062ee2b8 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -50,6 +50,7 @@ jobs:
           debian-13-trixie-x86,
           debian-13-trixie-amd64,
           fedora-42-amd64,
+          fedora-43-amd64,
           gentoo,
           ubuntu-22.04-jammy-amd64,
           ubuntu-24.04-noble-amd64,
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index e0c4a8eec3d..17e38719a93 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -35,6 +35,8 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Fedora 42                        | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
+| Fedora 43                        | 3.14                       | x86-64              |
++----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 15 Sequoia                 | 3.10                       | x86-64              |

From 921a470506bdf7cc82d78d6ff4915b6aa5420b7b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 6 Nov 2025 18:24:10 +1100
Subject: [PATCH 2137/2374] Simplified code

---
 src/_imaging.c | 9 +++------
 1 file changed, 3 insertions(+), 6 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index f6be4a90124..d2a195887fa 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -2459,7 +2459,6 @@ _merge(PyObject *self, PyObject *args) {
 
 static PyObject *
 _split(ImagingObject *self) {
-    int fails = 0;
     Py_ssize_t i;
     PyObject *list;
     PyObject *imaging_object;
@@ -2473,14 +2472,12 @@ _split(ImagingObject *self) {
     for (i = 0; i < self->image->bands; i++) {
         imaging_object = PyImagingNew(bands[i]);
         if (!imaging_object) {
-            fails += 1;
+            Py_DECREF(list);
+            list = NULL;
+            break;
         }
         PyTuple_SET_ITEM(list, i, imaging_object);
     }
-    if (fails) {
-        Py_DECREF(list);
-        list = NULL;
-    }
     return list;
 }
 

From 142c1320b23fa645dd115e8b979407518e3cd696 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 14 Nov 2025 20:08:49 +1100
Subject: [PATCH 2138/2374] Apply encoder options when saving multiple PNG
 frames

---
 Tests/test_file_apng.py   | 20 ++++++++++++++++++++
 src/PIL/PngImagePlugin.py | 25 ++++++++++++++-----------
 2 files changed, 34 insertions(+), 11 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 12204b5b78c..d918a24a799 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from io import BytesIO
 from pathlib import Path
 
 import pytest
@@ -718,6 +719,25 @@ def test_apng_save_size(tmp_path: Path) -> None:
         assert reloaded.size == (200, 200)
 
 
+def test_compress_level() -> None:
+    compress_level_sizes = {}
+    for compress_level in (0, 9):
+        out = BytesIO()
+
+        im = Image.new("L", (100, 100))
+        im.save(
+            out,
+            "PNG",
+            save_all=True,
+            append_images=[Image.new("L", (200, 200))],
+            compress_level=compress_level,
+        )
+
+        compress_level_sizes[compress_level] = len(out.getvalue())
+
+    assert compress_level_sizes[0] > compress_level_sizes[9]
+
+
 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 d0f22f812e5..b89c10da3c1 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1152,6 +1152,15 @@ def write(self, data: bytes) -> None:
         self.seq_num += 1
 
 
+def _apply_encoderinfo(im: Image.Image, encoderinfo: dict[str, Any]) -> None:
+    im.encoderconfig = (
+        encoderinfo.get("optimize", False),
+        encoderinfo.get("compress_level", -1),
+        encoderinfo.get("compress_type", -1),
+        encoderinfo.get("dictionary", b""),
+    )
+
+
 class _Frame(NamedTuple):
     im: Image.Image
     bbox: tuple[int, int, int, int] | None
@@ -1245,10 +1254,10 @@ def _write_multiple_frames(
 
     # default image IDAT (if it exists)
     if default_image:
-        if im.mode != mode:
-            im = im.convert(mode)
+        default_im = im if im.mode == mode else im.convert(mode)
+        _apply_encoderinfo(default_im, im.encoderinfo)
         ImageFile._save(
-            im,
+            default_im,
             cast(IO[bytes], _idat(fp, chunk)),
             [ImageFile._Tile("zip", (0, 0) + im.size, 0, rawmode)],
         )
@@ -1282,6 +1291,7 @@ def _write_multiple_frames(
         )
         seq_num += 1
         # frame data
+        _apply_encoderinfo(im_frame, im.encoderinfo)
         if frame == 0 and not default_image:
             # first frame must be in IDAT chunks for backwards compatibility
             ImageFile._save(
@@ -1357,14 +1367,6 @@ def _save(
                 bits = 4
             outmode += f";{bits}"
 
-    # encoder options
-    im.encoderconfig = (
-        im.encoderinfo.get("optimize", False),
-        im.encoderinfo.get("compress_level", -1),
-        im.encoderinfo.get("compress_type", -1),
-        im.encoderinfo.get("dictionary", b""),
-    )
-
     # get the corresponding PNG mode
     try:
         rawmode, bit_depth, color_type = _OUTMODES[outmode]
@@ -1494,6 +1496,7 @@ def _save(
             im, fp, chunk, mode, rawmode, default_image, append_images
         )
     if single_im:
+        _apply_encoderinfo(single_im, im.encoderinfo)
         ImageFile._save(
             single_im,
             cast(IO[bytes], _idat(fp, chunk)),

From bc1237ef3d22f7407fbeb3de19c1c867ed5dfd0a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 14 Nov 2025 21:22:58 +1100
Subject: [PATCH 2139/2374] Update dependency cibuildwheel to v3.3.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 56517374f5b..485866de67c 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.2.1
+cibuildwheel==3.3.0

From 6107b9e82d93b29ca86a4261eec832de48ee45f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 15 Nov 2025 07:41:59 +1100
Subject: [PATCH 2140/2374] Update libimagequant to 4.4.1

---
 depends/install_imagequant.sh              | 2 +-
 docs/installation/building-from-source.rst | 2 +-
 winbuild/build_prepare.py                  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/depends/install_imagequant.sh b/depends/install_imagequant.sh
index 357214f1fd6..de63abdecc7 100755
--- a/depends/install_imagequant.sh
+++ b/depends/install_imagequant.sh
@@ -2,7 +2,7 @@
 # install libimagequant
 
 archive_name=libimagequant
-archive_version=4.4.0
+archive_version=4.4.1
 
 archive=$archive_name-$archive_version
 
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 6080d29afa3..4349f980498 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -64,7 +64,7 @@ Many of Pillow's features require external libraries:
 
 * **libimagequant** provides improved color quantization
 
-  * Pillow has been tested with libimagequant **2.6-4.4.0**
+  * Pillow has been tested with libimagequant **2.6-4.4.1**
   * Libimagequant is licensed GPLv3, which is more restrictive than
     the Pillow license, therefore we will not be distributing binaries
     with libimagequant support enabled.
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 186a80cca5e..6cbc5c1e113 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -120,7 +120,7 @@ def cmd_msbuild(
     "JPEGTURBO": "3.1.2",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
-    "LIBIMAGEQUANT": "4.4.0",
+    "LIBIMAGEQUANT": "4.4.1",
     "LIBPNG": "1.6.50",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",

From 88247a9ef38d8eba9610393ddfe34616e108257d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 19 Nov 2025 21:31:27 +1100
Subject: [PATCH 2141/2374] Updated version

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

diff --git a/docs/reference/ImageGrab.rst b/docs/reference/ImageGrab.rst
index e7dd41de1b7..4138667850b 100644
--- a/docs/reference/ImageGrab.rst
+++ b/docs/reference/ImageGrab.rst
@@ -48,7 +48,7 @@ or the clipboard to a PIL image memory.
         CGWindowID.
 
         .. versionadded:: 11.2.1 Windows support
-        .. versionadded:: 12.0.0 macOS support
+        .. versionadded:: 12.1.0 macOS support
     :return: An image
 
 .. py:function:: grabclipboard()

From cce73b1e892a14d8d48146ac6ad3500be4d40d44 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 19 Nov 2025 21:52:21 +1100
Subject: [PATCH 2142/2374] Close image on ImageFont exception

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

diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 92eb763a51e..2e8ace98dda 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -127,11 +127,15 @@ def _load_pilfont(self, filename: str) -> None:
     def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
         # check image
         if image.mode not in ("1", "L"):
+            image.close()
+
             msg = "invalid font image mode"
             raise TypeError(msg)
 
         # read PILfont header
         if file.read(8) != b"PILfont\n":
+            image.close()
+
             msg = "Not a PILfont file"
             raise SyntaxError(msg)
         file.readline()

From 7055937eb15a66209ebf8f5e275e58cbd56ca629 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 22 Nov 2025 17:47:09 +1100
Subject: [PATCH 2143/2374] Updated Ubuntu version

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

diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index 6080d29afa3..40e2a1938ae 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -116,7 +116,7 @@ Many of Pillow's features require external libraries:
 
     .. 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::
+    Prerequisites for **Ubuntu 16.04 LTS - 24.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 \

From 6a9960e8c1960879fe3fb1c3afc143d0899213f5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 25 Nov 2025 23:40:34 +1100
Subject: [PATCH 2144/2374] Only update Python palette if rawmode was different
 to the mode

---
 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 9d50812eb3e..dc51860a040 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -897,7 +897,9 @@ def load(self) -> core.PixelAccess | None:
                 else:
                     self.im.putpalettealphas(self.info["transparency"])
                 self.palette.mode = "RGBA"
-            else:
+            elif self.palette.mode != mode:
+                # If the palette rawmode is different to the mode,
+                # then update the Python palette data
                 self.palette.palette = self.im.getpalette(
                     self.palette.mode, self.palette.mode
                 )

From d06c8b3591ed7eee91f2bca4711369e59cfc8645 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 27 Nov 2025 13:12:42 +1100
Subject: [PATCH 2145/2374] Test drawing a new color onto a dirty palette

---
 Tests/test_imagedraw.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 790acee2a46..1e0dedef3cf 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -68,10 +68,20 @@ def test_sanity() -> None:
     draw.rectangle(list(range(4)))
 
 
-def test_valueerror() -> None:
+def test_new_color() -> None:
     with Image.open("Tests/images/chi.gif") as im:
         draw = ImageDraw.Draw(im)
+        assert len(im.palette.colors) == 249
+
+        # Test drawing a new color onto the palette
         draw.line((0, 0), fill=(0, 0, 0))
+        assert len(im.palette.colors) == 250
+        assert im.palette.dirty
+
+        # Test drawing another new color, now that the palette is dirty
+        draw.point((0, 0), fill=(1, 0, 0))
+        assert len(im.palette.colors) == 251
+        assert im.convert("RGB").getpixel((0, 0)) == (1, 0, 0)
 
 
 def test_mode_mismatch() -> None:

From 8814d42fd96ea8c86e5aa3bc4970066ade5de489 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 29 Nov 2025 14:24:43 +1100
Subject: [PATCH 2146/2374] Update zlib-ng to 2.3.1, except on manylinux2014
 aarch64

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 226fcdb6af7..194c51a944f 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -106,7 +106,11 @@ XZ_VERSION=5.8.1
 ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.1
 LCMS2_VERSION=2.17
-ZLIB_NG_VERSION=2.2.5
+if [[ "$MB_ML_VER" == 2014 ]] && [[ "$PLAT" == "aarch64" ]]; then
+  ZLIB_NG_VERSION=2.2.5
+else
+  ZLIB_NG_VERSION=2.3.1
+fi
 LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
@@ -149,18 +153,13 @@ function build_zlib_ng {
     ORIGINAL_HOST_CONFIGURE_FLAGS=$HOST_CONFIGURE_FLAGS
     unset HOST_CONFIGURE_FLAGS
 
-    build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --zlib-compat
+    if [[ "$ZLIB_NG_VERSION" == 2.2.5 ]]; then
+        build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --zlib-compat
+    else
+        build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --installnamedir=$BUILD_PREFIX/lib --zlib-compat
+    fi
 
     HOST_CONFIGURE_FLAGS=$ORIGINAL_HOST_CONFIGURE_FLAGS
-
-    if [[ -n "$IS_MACOS" ]] && [[ -z "$IOS_SDK" ]]; then
-        # Ensure that on macOS, the library name is an absolute path, not an
-        # @rpath, so that delocate picks up the right library (and doesn't need
-        # DYLD_LIBRARY_PATH to be set). The default Makefile doesn't have an
-        # option to control the install_name. This isn't needed on iOS, as iOS
-        # only builds the static library.
-        install_name_tool -id $BUILD_PREFIX/lib/libz.1.dylib $BUILD_PREFIX/lib/libz.1.dylib
-    fi
     touch zlib-stamp
 }
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 2401dd4ecd6..65d0af48170 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -126,7 +126,7 @@ def cmd_msbuild(
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",
     "XZ": "5.8.1",
-    "ZLIBNG": "2.2.5",
+    "ZLIBNG": "2.3.1",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
 
@@ -167,12 +167,12 @@ def cmd_msbuild(
         "license": "LICENSE.md",
         "patch": {
             r"CMakeLists.txt": {
-                "set_target_properties(zlib PROPERTIES OUTPUT_NAME zlibstatic${{SUFFIX}})": "set_target_properties(zlib PROPERTIES OUTPUT_NAME zlib)",  # noqa: E501
+                "set_target_properties(zlib-ng PROPERTIES OUTPUT_NAME zlibstatic${{SUFFIX}})": "set_target_properties(zlib-ng PROPERTIES OUTPUT_NAME zlib)",  # noqa: E501
             },
         },
         "build": [
             *cmds_cmake(
-                "zlib", "-DBUILD_SHARED_LIBS:BOOL=OFF", "-DZLIB_COMPAT:BOOL=ON"
+                "zlib-ng", "-DBUILD_SHARED_LIBS:BOOL=OFF", "-DZLIB_COMPAT:BOOL=ON"
             ),
         ],
         "headers": [r"z*.h"],

From 37da2ba381ecb47fb7a06af88fe6ed9dc64349f7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 29 Nov 2025 17:22:44 +1100
Subject: [PATCH 2147/2374] Corrected allocating new color to RGBA palette

---
 Tests/test_imagepalette.py | 6 ++++++
 src/PIL/ImagePalette.py    | 9 +++++----
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 782022f5171..6ad21502f9f 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -49,6 +49,12 @@ def test_getcolor() -> None:
         palette.getcolor("unknown")  # type: ignore[arg-type]
 
 
+def test_getcolor_rgba() -> None:
+    palette = ImagePalette.ImagePalette("RGBA", (1, 2, 3, 4))
+    palette.getcolor((5, 6, 7, 8))
+    assert palette.palette == b"\x01\x02\x03\x04\x05\x06\x07\x08"
+
+
 def test_getcolor_rgba_color_rgb_palette() -> None:
     palette = ImagePalette.ImagePalette("RGB")
 
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 103697117b9..eae7aea8fc3 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -118,7 +118,7 @@ def _new_color_index(
     ) -> int:
         if not isinstance(self.palette, bytearray):
             self._palette = bytearray(self.palette)
-        index = len(self.palette) // 3
+        index = len(self.palette) // len(self.mode)
         special_colors: tuple[int | tuple[int, ...] | None, ...] = ()
         if image:
             special_colors = (
@@ -168,11 +168,12 @@ def getcolor(
                 index = self._new_color_index(image, e)
                 assert isinstance(self._palette, bytearray)
                 self.colors[color] = index
-                if index * 3 < len(self.palette):
+                mode_len = len(self.mode)
+                if index * mode_len < len(self.palette):
                     self._palette = (
-                        self._palette[: index * 3]
+                        self._palette[: index * mode_len]
                         + bytes(color)
-                        + self._palette[index * 3 + 3 :]
+                        + self._palette[index * mode_len + mode_len :]
                     )
                 else:
                     self._palette += bytes(color)

From 65c32ecca4019984862aa9caa916fb2196e1cb2d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 30 Nov 2025 21:55:59 +0200
Subject: [PATCH 2148/2374] retina -> Retina

---
 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 b82a2ff3a47..4228078b11b 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -54,7 +54,7 @@ def grab(
             os.unlink(filepath)
             if bbox:
                 if window:
-                    # Determine if the window was in retina mode or not
+                    # Determine if the window was in Retina mode or not
                     # by capturing it without the shadow,
                     # and checking how different the width is
                     fh, filepath = tempfile.mkstemp(".png")

From 370da461cf5e1226376d7ea591265a84dc5a5b06 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 1 Dec 2025 10:02:09 +1100
Subject: [PATCH 2149/2374] Updated libpng to 1.6.51 (#9305)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 .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 e033b69a97e..07ea75a75c5 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -96,7 +96,7 @@ else
   FREETYPE_VERSION=2.14.1
 fi
 HARFBUZZ_VERSION=12.2.0
-LIBPNG_VERSION=1.6.50
+LIBPNG_VERSION=1.6.51
 JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.1
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 99421ebe25d..cd2ef13c11f 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.4.1",
-    "LIBPNG": "1.6.50",
+    "LIBPNG": "1.6.51",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",

From ce3e08575164756e5dcbcc07d49105cd9e8d5c55 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 1 Dec 2025 17:26:21 +0000
Subject: [PATCH 2150/2374] [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.14.3 → v0.14.7](https://github.com/astral-sh/ruff-pre-commit/compare/v0.14.3...v0.14.7)
- [github.com/psf/black-pre-commit-mirror: 25.9.0 → 25.11.0](https://github.com/psf/black-pre-commit-mirror/compare/25.9.0...25.11.0)
- [github.com/PyCQA/bandit: 1.8.6 → 1.9.2](https://github.com/PyCQA/bandit/compare/1.8.6...1.9.2)
- [github.com/pre-commit/mirrors-clang-format: v21.1.2 → v21.1.6](https://github.com/pre-commit/mirrors-clang-format/compare/v21.1.2...v21.1.6)
- [github.com/python-jsonschema/check-jsonschema: 0.34.1 → 0.35.0](https://github.com/python-jsonschema/check-jsonschema/compare/0.34.1...0.35.0)
- [github.com/zizmorcore/zizmor-pre-commit: v1.16.2 → v1.18.0](https://github.com/zizmorcore/zizmor-pre-commit/compare/v1.16.2...v1.18.0)
- [github.com/sphinx-contrib/sphinx-lint: v1.0.1 → v1.0.2](https://github.com/sphinx-contrib/sphinx-lint/compare/v1.0.1...v1.0.2)
- [github.com/tox-dev/pyproject-fmt: v2.11.0 → v2.11.1](https://github.com/tox-dev/pyproject-fmt/compare/v2.11.0...v2.11.1)
---
 .pre-commit-config.yaml | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 564206ce170..8477729e636 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.14.3
+    rev: v0.14.7
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.9.0
+    rev: 25.11.0
     hooks:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.8.6
+    rev: 1.9.2
     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: v21.1.2
+    rev: v21.1.6
     hooks:
       - id: clang-format
         types: [c]
@@ -51,24 +51,24 @@ repos:
         exclude: ^\.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.34.1
+    rev: 0.35.0
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.16.2
+    rev: v1.18.0
     hooks:
       - id: zizmor
 
   - repo: https://github.com/sphinx-contrib/sphinx-lint
-    rev: v1.0.1
+    rev: v1.0.2
     hooks:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.11.0
+    rev: v2.11.1
     hooks:
       - id: pyproject-fmt
 

From 9342e209b2176bde761b321a74846857257ea78c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Dec 2025 10:21:55 +1100
Subject: [PATCH 2151/2374] Disable https://docs.zizmor.sh/audits/#obfuscation

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

diff --git a/.github/zizmor.yml b/.github/zizmor.yml
index b567097811a..e60c79441ca 100644
--- a/.github/zizmor.yml
+++ b/.github/zizmor.yml
@@ -1,6 +1,8 @@
 # Configuration for the zizmor static analysis tool, run via pre-commit in CI
 # https://docs.zizmor.sh/configuration/
 rules:
+  obfuscation:
+    disable: true
   unpinned-uses:
     config:
       policies:

From 47c6aae0cae6b5c4e956d4e56da7f189575ada9a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Dec 2025 10:40:43 +1100
Subject: [PATCH 2152/2374] Fixed testing good P mode BMP images

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

diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 82cab39c613..3cd0fbb2d2e 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -72,7 +72,7 @@ def test_good() -> None:
         "pal8-0.bmp": "pal8.png",
         "pal8rle.bmp": "pal8.png",
         "pal8topdown.bmp": "pal8.png",
-        "pal8nonsquare.bmp": "pal8nonsquare-v.png",
+        "pal8nonsquare.bmp": "pal8nonsquare-e.png",
         "pal8os2.bmp": "pal8.png",
         "pal8os2sp.bmp": "pal8.png",
         "pal8os2v2.bmp": "pal8.png",
@@ -103,7 +103,7 @@ def get_compare(f: str) -> str:
                         # with paletized image, since the palette might
                         # be differently ordered for an equivalent image.
                         im = im.convert("RGBA")
-                        compare = im.convert("RGBA")
+                        compare = compare.convert("RGBA")
                     assert_image_similar(im, compare, 5)
 
         except Exception as msg:

From b3d9ba8e886147201acbd94c5c5f2cc4b3513311 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Dec 2025 10:42:14 +1100
Subject: [PATCH 2153/2374] Removed unused files

---
 Tests/images/bmp/html/bkgd.png            | Bin 126 -> 0 bytes
 Tests/images/bmp/html/bmpsuite.html       | 578 ----------------------
 Tests/images/bmp/html/fakealpha.png       | Bin 1181 -> 0 bytes
 Tests/images/bmp/html/pal1p1.png          | Bin 124 -> 0 bytes
 Tests/images/bmp/html/pal2.png            | Bin 961 -> 0 bytes
 Tests/images/bmp/html/pal4rletrns-0.png   | Bin 1441 -> 0 bytes
 Tests/images/bmp/html/pal4rletrns-b.png   | Bin 1362 -> 0 bytes
 Tests/images/bmp/html/pal4rletrns.png     | Bin 1465 -> 0 bytes
 Tests/images/bmp/html/pal8nonsquare-v.png | Bin 11576 -> 0 bytes
 Tests/images/bmp/html/pal8rletrns-0.png   | Bin 3776 -> 0 bytes
 Tests/images/bmp/html/pal8rletrns-b.png   | Bin 3715 -> 0 bytes
 Tests/images/bmp/html/pal8rletrns.png     | Bin 3793 -> 0 bytes
 Tests/images/bmp/html/rgb16-231.png       | Bin 2643 -> 0 bytes
 Tests/images/bmp/html/rgb24.jpg           | Bin 2319 -> 0 bytes
 Tests/images/bmp/html/rgba16-4444.png     | Bin 1093 -> 0 bytes
 Tests/images/bmp/html/rgba32.png          | Bin 1229 -> 0 bytes
 16 files changed, 578 deletions(-)
 delete mode 100644 Tests/images/bmp/html/bkgd.png
 delete mode 100644 Tests/images/bmp/html/bmpsuite.html
 delete mode 100644 Tests/images/bmp/html/fakealpha.png
 delete mode 100644 Tests/images/bmp/html/pal1p1.png
 delete mode 100644 Tests/images/bmp/html/pal2.png
 delete mode 100644 Tests/images/bmp/html/pal4rletrns-0.png
 delete mode 100644 Tests/images/bmp/html/pal4rletrns-b.png
 delete mode 100644 Tests/images/bmp/html/pal4rletrns.png
 delete mode 100644 Tests/images/bmp/html/pal8nonsquare-v.png
 delete mode 100644 Tests/images/bmp/html/pal8rletrns-0.png
 delete mode 100644 Tests/images/bmp/html/pal8rletrns-b.png
 delete mode 100644 Tests/images/bmp/html/pal8rletrns.png
 delete mode 100644 Tests/images/bmp/html/rgb16-231.png
 delete mode 100644 Tests/images/bmp/html/rgb24.jpg
 delete mode 100644 Tests/images/bmp/html/rgba16-4444.png
 delete mode 100644 Tests/images/bmp/html/rgba32.png

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

literal 126
zcmeAS@N?(olHy`uVBq!ia0vp^0wB!D3?x-;bCrM;V{wqX6T`Z5GB1G~wg8_H*9GU#
zPoMr@$gd<0D8gCb5n0T@z%2~Ij105pNB{)|JzX3_IIbuEIDeo)G*SF7KSSMq{*SLd
S3ttCHGI+ZBxvX<aXaWGFpCG;f

diff --git a/Tests/images/bmp/html/bmpsuite.html b/Tests/images/bmp/html/bmpsuite.html
deleted file mode 100644
index b8e327ed927..00000000000
--- a/Tests/images/bmp/html/bmpsuite.html
+++ /dev/null
@@ -1,578 +0,0 @@
-<!DOCTYPE html>
-<html>
-
-<head>
-
-<title>BMP Suite Image List</title>
-
-<style>
- .b { background:url(bkgd.png); }
- .q { background-color:#fff0e0; }
- .bad { background-color:#ffa0a0; }
-</style>
-
-</head>
-
-<body>
-
-<h1>BMP Suite Image List</h1>
-
-<p><i>For <a href="http://entropymine.com/jason/bmpsuite/">BMP Suite</a>
-version 2.3</i></p>
-
-<p>This document describes the images in <i>BMP Suite</i>, and shows what
-I allege to be the correct way to interpret them. PNG and JPEG images are
-used for reference.
-</p>
-
-<p>It also shows how your web browser displays the BMP images,
-but that&rsquo;s not its main purpose.
-BMP is poor image format to use on web pages, so a web browser&rsquo;s
-level of support for it is arguably not important.</p>
-
-<table border=1 cellpadding=8>
-
- <tr>
-  <th>File</th>
-  <th>Ver.</th>
-  <th>Correct display</th>
-  <th>In your browser</th>
-  <th>Notes</th>
- </tr>
-
- <tr>
-  <td>g/pal1.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal1.png"></td>
-  <td class=b><img src="../g/pal1.bmp"></td>
-  <td>1 bit/pixel paletted image, in which black is the first color in
-   the palette.</td>
- </tr>
-
- <tr>
-  <td>g/pal1wb.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal1.png"></td>
-  <td class=b><img src="../g/pal1wb.bmp"></td>
-  <td>1 bit/pixel paletted image, in which white is the first color in
-   the palette.</td>
- </tr>
-
- <tr>
-  <td>g/pal1bg.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal1bg.png"></td>
-  <td class=b><img src="../g/pal1bg.bmp"></td>
-  <td>1 bit/pixel paletted image, with colors other than black and white.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal1p1.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal1p1.png"></td>
-  <td class=b><img src="../q/pal1p1.bmp"></td>
-  <td>1 bit/pixel paletted image, with only one color in the palette.
-   The documentation says that 1-bpp images have a palette size of 2
-   (not &ldquo;up to 2&rdquo;), but it would be silly for a viewer not to
-   support a size of 1.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal2.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal2.png"></td>
-  <td class=b><img src="../q/pal2.bmp"></td>
-  <td>A paletted image with 2 bits/pixel. Usually only 1, 4,
-   and 8 are allowed, but 2 is legal on Windows CE.</td>
- </tr>
-
- <tr>
-  <td>g/pal4.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal4.png"></td>
-  <td class=b><img src="../g/pal4.bmp"></td>
-  <td>Paletted image with 12 palette colors, and 4 bits/pixel.</td>
- </tr>
-
- <tr>
-  <td>g/pal4rle.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal4.png"></td>
-  <td class=b><img src="../g/pal4rle.bmp"></td>
-  <td>4-bit image that uses RLE compression.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal4rletrns.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal4rletrns.png"><br>
-     or<br><img src="pal4rletrns-0.png"><br>
-     or<br><img src="pal4rletrns-b.png"></td>
-  <td class=b><img src="../q/pal4rletrns.bmp"></td>
-  <td>An RLE-compressed image that used &ldquo;delta&rdquo;
-  codes to skip over some pixels, leaving them undefined. Some viewers
-  make undefined pixels transparent, others make them black, and
-  others assign them palette color 0 (purple, in this case).</td>
- </tr>
-
- <tr>
-  <td>g/pal8.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../g/pal8.bmp"></td>
-  <td>Our standard paletted image, with 252 palette colors, and 8
-   bits/pixel.</td>
- </tr>
-
- <tr>
-  <td>g/pal8-0.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../g/pal8-0.bmp"></td>
-  <td>Every field that can be set to 0 is set to 0: pixels/meter=0;
-   colors used=0 (meaning the default 256); size-of-image=0.</td>
- </tr>
-
- <tr>
-  <td>g/pal8rle.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../g/pal8rle.bmp"></td>
-  <td>8-bit image that uses RLE compression.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal8rletrns.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8rletrns.png"><br>
-     or<br><img src="pal8rletrns-0.png"><br>
-     or<br><img src="pal8rletrns-b.png"></td>
-  <td class=b><img src="../q/pal8rletrns.bmp"></td>
-  <td>8-bit version of q/pal4rletrns.bmp.</td>
- </tr>
-
- <tr>
-  <td>g/pal8w126.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8w126.png"></td>
-  <td class=b><img src="../g/pal8w126.bmp"></td>
-  <td rowspan=3>Images with different widths and heights.
-   In BMP format, rows are padded to a multiple of four bytes, so we
-   test all four possibilities.</td>
- </tr>
-
- <tr>
-  <td>g/pal8w125.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8w125.png"></td>
-  <td class=b><img src="../g/pal8w125.bmp"></td>
- </tr>
-
- <tr>
-  <td>g/pal8w124.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8w124.png"></td>
-  <td class=b><img src="../g/pal8w124.bmp"></td>
- </tr>
-
- <tr>
-  <td>g/pal8topdown.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../g/pal8topdown.bmp"></td>
-  <td>BMP images are normally stored from the bottom up, but
-   there is a way to store them from the top down.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal8offs.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../q/pal8offs.bmp"></td>
-  <td>A file with some unused bytes between the palette and the
-   image. This is probably valid, but I&rsquo;m not 100% sure.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal8oversizepal.bmp</td>
-  <td>3</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../q/pal8oversizepal.bmp"></td>
-  <td>An 8-bit image with 300 palette colors. This may be invalid,
-   because the documentation could
-   be interpreted to imply that 8-bit images aren&rsquo;t allowed
-   to have more than 256 colors.</td>
- </tr>
-
- <tr>
-  <td>g/pal8nonsquare.bmp</td>
-  <td>3</td>
-  <td class=b>
-   <img src="pal8nonsquare-v.png"><br>
-   or<br>
-   <img src="pal8nonsquare-e.png">
-  </td>
-  <td class=b><img src="../g/pal8nonsquare.bmp"></td>
-  <td>An image with non-square pixels: the X pixels/meter is twice
-   the Y pixels/meter. Image <i>editors</i> can be expected to
-   leave the image &ldquo;squashed&rdquo;; image <i>viewers</i> should
-   consider stretching it to its correct proportions.</td>
- </tr>
-
- <tr>
-  <td>g/pal8os2.bmp</td>
-  <td>OS/2v1</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../g/pal8os2.bmp"></td>
-  <td>An OS/2-style bitmap.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal8os2sp.bmp</td>
-  <td>OS/2v1</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../q/pal8os2sp.bmp"></td>
-  <td>An OS/2v1 with a less-than-full-sized palette.
-   Probably not valid, but such files have been seen in the wild.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal8os2v2.bmp</td>
-  <td>OS/2v2</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../q/pal8os2v2.bmp"></td>
-  <td>My attempt to make an OS/2v2 bitmap.</td>
- </tr>
-
- <tr>
-  <td class=q>q/pal8os2v2-16.bmp</td>
-  <td>OS/2v2</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../q/pal8os2v2-16.bmp"></td>
-  <td>An OS/2v2 bitmap whose header has only 16 bytes, instead of the full 64.</td>
- </tr>
-
- <tr>
-  <td>g/pal8v4.bmp</td>
-  <td>4</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../g/pal8v4.bmp"></td>
-  <td>A v4 bitmap. I&rsquo;m not sure that the gamma and chromaticity values in
-   this file are sensible, because I can&rsquo;t find any detailed documentation
-   of them.</td>
- </tr>
-
- <tr>
-  <td>g/pal8v5.bmp</td>
-  <td>5</td>
-  <td class=b><img src="pal8.png"></td>
-  <td class=b><img src="../g/pal8v5.bmp"></td>
-  <td>A v5 bitmap. Version 5 has additional colorspace options over v4, so it
-   is easier to create, and ought to be more portable.</td>
- </tr>
-
- <tr>
-  <td>g/rgb16.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb16.png"></td>
-  <td class=b><img src="../g/rgb16.bmp"></td>
-  <td>A 16-bit image with the default color format: 5 bits each for red,
-   green, and blue, and 1 unused bit.
-   The whitest colors should (I assume) be displayed as pure white:
-   <span style="background-color:rgb(255,255,255)">(255,255,255)</span>, not
-   <span style="background-color:rgb(248,248,248)">(248,248,248)</span>.</td>
- </tr>
-
- <tr>
-  <td>g/rgb16-565.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb16-565.png"></td>
-  <td class=b><img src="../g/rgb16-565.bmp"></td>
-  <td>A 16-bit image with a BITFIELDS segment indicating 5 red, 6 green,
-   and 5 blue bits. This is a standard 16-bit format, even supported by
-   old versions of Windows that don&rsquo;t support any other non-default 16-bit
-   formats.
-   The whitest colors should be displayed as pure white:
-   <span style="background-color:rgb(255,255,255)">(255,255,255)</span>, not
-   <span style="background-color:rgb(248,252,248)">(248,252,248)</span>.</td>
- </tr>
-
- <tr>
-  <td>g/rgb16-565pal.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb16-565.png"></td>
-  <td class=b><img src="../g/rgb16-565pal.bmp"></td>
-  <td>A 16-bit image with both a BITFIELDS segment and a palette.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb16-231.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb16-231.png"></td>
-  <td class=b><img src="../q/rgb16-231.bmp"></td>
-  <td>An unusual and silly 16-bit image, with 2 red bits, 3 green bits, and 1
-  blue bit. Most viewers do support this image, but the colors may be darkened
-  with a yellow-green shadow. That&rsquo;s because they&rsquo;re doing simple
-  bit-shifting (possibly including one round of bit replication), instead of
-  proper scaling.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgba16-4444.bmp</td>
-  <td>5</td>
-  <td class=b><img src="rgba16-4444.png"></td>
-  <td class=b><img src="../q/rgba16-4444.bmp"></td>
-  <td>A 16-bit image with an alpha channel. There are 4 bits for each color
-   channel, and 4 bits for the alpha channel.
-   It&rsquo;s not clear if this is valid, but I can&rsquo;t find anything that
-   suggests it isn&rsquo;t.
-   </td>
- </tr>
-
- <tr>
-  <td>g/rgb24.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../g/rgb24.bmp"></td>
-  <td>A perfectly ordinary 24-bit (truecolor) image.</td>
- </tr>
-
- <tr>
-  <td>g/rgb24pal.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../g/rgb24pal.bmp"></td>
-  <td>A 24-bit image, with a palette containing 256 colors. There is little if
-   any reason for a truecolor image to contain a palette, but it is legal.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb24largepal.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../q/rgb24largepal.bmp"></td>
-  <td>A 24-bit image, with a palette containing 300 colors.
-   The fact that the palette has more than 256 colors may cause some viewers
-   to complain, but the documentation does not mention a size limit.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb24prof.bmp</td>
-  <td>5</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../q/rgb24prof.bmp"></td>
-  <td>My attempt to make a BMP file with an embedded color profile.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb24lprof.bmp</td>
-  <td>5</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../q/rgb24lprof.bmp"></td>
-  <td>My attempt to make a BMP file with a linked color profile.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb24jpeg.bmp</td>
-  <td>5</td>
-  <td class=b><img src="rgb24.jpg"></td>
-  <td class=b><img src="../q/rgb24jpeg.bmp"></td>
-  <td rowspan=2>My attempt to make BMP files with embedded JPEG and PNG images.
-   These are not likely to be supported by much of anything (they&rsquo;re
-   intended for printers).</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb24png.bmp</td>
-  <td>5</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../q/rgb24png.bmp"></td>
- </tr>
-
- <tr>
-  <td>g/rgb32.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../g/rgb32.bmp"></td>
-  <td>A 32-bit image using the default color format for 32-bit images (no
-   BITFIELDS segment). There are 8 bits per color channel, and 8 unused
-   bits. The unused bits are set to 0.</td>
- </tr>
-
- <tr>
-  <td>g/rgb32bf.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../g/rgb32bf.bmp"></td>
-  <td>A 32-bit image with a BITFIELDS segment. As usual, there are 8 bits per
-   color channel, and 8 unused bits. But the color channels are in an unusual
-   order, so the viewer must read the BITFIELDS, and not just guess.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb32fakealpha.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb24.png"><br>
-    or<br>
-    <img class=b src="fakealpha.png">
-</td>
-  <td class=b><img src="../q/rgb32fakealpha.bmp"></td>
-  <td>Same as g/rgb32.bmp, except that the unused bits are set to something
-   other than 0.
-   If the image becomes transparent toward the bottom, it probably means
-   the viewer uses heuristics to guess whether the undefined
-   data represents transparency.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgb32-111110.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgb24.png"></td>
-  <td class=b><img src="../q/rgb32-111110.bmp"></td>
-  <td>A 32 bits/pixel image, with all 32 bits used: 11 each for red and
-   green, and 10 for blue. As far as I know, this is perfectly valid, but it
-   is unusual.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgba32.bmp</td>
-  <td>5</td>
-  <td class=b><img src="rgba32.png"></td>
-  <td class=b><img src="../q/rgba32.bmp"></td>
-  <td>A BMP with an alpha channel. Transparency is barely documented,
-   so it&rsquo;s <i>possible</i> that this file is not correctly formed.
-   The color channels are in an unusual order, to prevent viewers from
-   passing this test by making a lucky guess.</td>
- </tr>
-
- <tr>
-  <td class=q>q/rgba32abf.bmp</td>
-  <td>3</td>
-  <td class=b><img src="rgba32.png"></td>
-  <td class=b><img src="../q/rgba32abf.bmp"></td>
-  <td>An image of type BI_ALHPABITFIELDS. Supposedly, this was used on
-   Windows CE. I don&rsquo;t know whether it is constructed correctly.</td>
- </tr>
-
-
- <tr>
-  <td class=bad>b/badbitcount.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badbitcount.bmp"></td>
-  <td>Header indicates an absurdly large number of bits/pixel.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/badbitssize.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badbitssize.bmp"></td>
-  <td>Header incorrectly indicates that the bitmap is several GB in size.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/baddens1.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/baddens1.bmp"></td>
-  <td rowspan=2>Density (pixels per meter) suggests the image is <i>much</i>
-      larger in one dimension than the other.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/baddens2.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/baddens2.bmp"></td>
- </tr>
-
- <tr>
-  <td class=bad>b/badfilesize.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badfilesize.bmp"></td>
-  <td>Header incorrectly indicates that the file is several GB in size.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/badheadersize.bmp</td>
-  <td>?</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badheadersize.bmp"></td>
-  <td>Header size is 66 bytes, which is not a valid size for any known BMP
-   version.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/badpalettesize.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badpalettesize.bmp"></td>
-  <td>Header incorrectly indicates that the palette contains an absurdly large
-   number of colors.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/badplanes.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badplanes.bmp"></td>
-  <td>The &ldquo;planes&rdquo; setting, which is required to be 1, is not 1.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/badrle.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badrle.bmp"></td>
-  <td>An invalid RLE-compressed image that tries to cause buffer overruns.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/badwidth.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/badwidth.bmp"></td>
-  <td>The image claims to be a negative number of pixels in width.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/pal8badindex.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/pal8badindex.bmp"></td>
-  <td>Many of the palette indices used in the image are not present in the
-   palette.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/reallybig.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/reallybig.bmp"></td>
-  <td>An image with a very large reported width and height.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/rletopdown.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/rletopdown.bmp"></td>
-  <td>An RLE-compressed image that tries to use top-down orientation,
-   which isn&rsquo;t allowed.</td>
- </tr>
-
- <tr>
-  <td class=bad>b/shortfile.bmp</td>
-  <td>3</td>
-  <td class=b>N/A</td>
-  <td class=b><img src="../b/shortfile.bmp"></td>
-  <td>A file that has been truncated in the middle of the bitmap.</td>
- </tr>
-
-</table>
-
-</body>
-
-</html>
diff --git a/Tests/images/bmp/html/fakealpha.png b/Tests/images/bmp/html/fakealpha.png
deleted file mode 100644
index 89292bcbb4804bf7ab9f0a46b48c3664235b96ee..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1181
zcmeAS@N?(olHy`uVBq!ia0vp^^+4>v!3HFaC$7i_QjEnx?oJHr&dIz4aySb-B8wRq
zxP?KOkzv*x2?hohCr=m0kcwMx=h*uQ2g)4Zf8HYIvC`t4O$XIhFBTS>9ih~$#xtX2
zLPpL~l>%L<7l}#=Zi|^!+Gbc(F?W_;x)^A7BcWN)%;VRj=Z6y4@7;Yb_I-cu{`a3I
zWxxM^Z}0ctd+t~7|GxWM3zLWm?*$Wu$p@eAyqs=t#CV#6BSYMsZRY9X<>%{Cnx+Xd
zWtPd`zI~g)MeFA(7L`jrFYnoYWz$$1wA=ilupM^vo#~HNfdAI-U$;EGp80c2%^`IR
z#6Mxv;>Gi>pV#jTp7U!}ep>pmueTPzQD!*seeU~-hs@9FFg*D9c<$-<Jj&85=UuyI
z_Up_i=Oz6&`xzMSUWrXTw)ydo%zr&Bb!(@2r!1Q>SC@eyEd0LeqT|{^6AGVm_j)c3
zQMtM5{0T{+v+jrgzI*a+OI-fM?|J{$$6H3v{r39fm(?Lva*=c6ECYW8K6P`Qs(!lf
zgYL}Rleaq`{{Odn)6+V?50775zZ3I^Sz&5sJjcb2%}b{I3hytOF6xx<<)Oy6eQ#K2
zeJd|t9wTEkGh+XvGPd1$XT_biXt`EthjKJdTq!71WA}lzzP|pJ^G~CVbze>X_%5Ar
z|I_#7y;1wbZl!N#J8<EPK%ZH^4Y$19v)dZ`_U_tOd;81Z<-CfYR^~DX$9`5-_$#;5
z-}3v{OGh6vE3^u1`&wdP|6<oOdHLtLo5F6E@y*}fQ*Op{_%i#8ou>EGoQ+m>-SS^~
zjmO|a3Pbw)^Es{l{_}6HIa~X8+FbJ!%S*q1*&@%fFVe*NQt4-g6E>$E_J%U3oIBrb
zchH@Ge~jLD^*@hVCpEkLn8g@+Kcx2if=Y&tMFnfO3vUn>KDv(MZ`suC_jx?xFV=3a
z%TMK3=2q5aKCtrM!-t}8-s`LU(mB9c;(zG<l3=j~;@<jATVt5mz1bzAWH#|OJgdsT
z7n8*taV%?Pud)A|53m0p^w)4+T4nKb@hL&J>Fl|`v%DXg=Y`aS$jsj*b#Q-8=9gtp
z+k0C~{jR@0{rbZ5uL0IglYa{H?2+5B_3^K-Kl|qH^i!(o%`7amoanwccIz|q_1BMO
zGhYody;AmJO-b9CEH;J(nM)b6D{Ee@3W;MB=(K(8FIwlQnIlr`_QNczk9onKsAExy
zx+2D*0RqylEM;=H+<tKFQ?8kM$~0oVr{}MB+1SnJ&)c3o_$T4mhOg5Sqvm={X#bG>
z-0{bM+nVCjDu3dd_KPYVa{p2L>g{f=?hm`!>#j^RIP_llbUs^rZGh^ZyaxGDmNQ<z
zYQM8v>wf3r+`sj#(G(tC`$Z<j`D{{KI+BdH{E4`HW4`@5#dY%K&HF2Eu09%nd>@<6
z<C=%p)*2q4u3>)a^{*MpU-~{QHd!K<$AFQ=>Uci<Wb@nCIC+}?j~1-x{?QLJe_8xx
Z{iGXicBw<`0<ef-@O1TaS?83{1OTmdK!yMS

diff --git a/Tests/images/bmp/html/pal1p1.png b/Tests/images/bmp/html/pal1p1.png
deleted file mode 100644
index 92fc0f945b01407ef832a1594a0e75cc4acec5af..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 124
zcmeAS@N?(olHy`uVBq!ia0vp^^+4>v$P6So<E=D+6k~CayA#8@b22Z19OeL@5LX9>
z|6H>LCV`X`ctjR6FmMZlFeAgPITAoYAx{^_5R22v2@<S}6GVELJ~1$`I5043_C5>+
P$})Jm`njxgN@xNAt6>@<

diff --git a/Tests/images/bmp/html/pal2.png b/Tests/images/bmp/html/pal2.png
deleted file mode 100644
index 1bbfe175fc351d825b92a04467a466c71f12a682..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 961
zcmV;y13vtTP)<h;3K|Lk000e1NJLTq004gg002M&00000TuSd200001b5ch_0Itp)
z=>Px#32;bRa{vGf6951U69E94oEQKA17=A?K~zY`g_OZ=+CUJ7hXkR5Dj5z`O7FdJ
zi24AQYAMb=k-S#8^?<F)Pf>{%=pmM{Pd!8^ED{fZ4-j}84#xMOx-+wDV?&~hkzmaF
z-_QTdEJPSGP4krFU+##IZtQ0&p272cDP@u;7_YB+E`;zYmnxot6&C4UDWv;bF^po&
zBaV0iuImS^Fh_|ME4YD7R&|B+7`A4>+p~xmgy&C5VTpkh`TYkBseM~zh$bLh+)~bI
z&pBeO`phstQP|<5yBb4!R1ki-Cs81SNBMLr>3U)X+B03e#~@r^GmxW6ug?rC8Q?_>
zVW=2(6r^B_Q-<n$FOwcJ1kAwk1jC_Xz<(DDW<Z5HgYbirLCy<?K*cX+pgm_ZDGA~|
zhD0kYdk9fu5cojMPsFj5r9zDX_xueQ1KE+X(Z6#jx$r515ePP7P4^n|VuuRWgc7)_
zF^qGJwFD`<J#c<ta%lOAfqF2KTUwBP{d|oI-zT&nZ`2sZw8vp!bY!EOIVL8?h9O3v
z=3q+;%qwHFvv0BqEx3F+Du}5ZZ+-8lIWRKWHBe!Y<d-kL#|l(`RM_BRR4}h?GkY)x
z>3;lDXV|*#2o;PDWTY@(-4qNqS;-22P~mcOvqpwNnwAXrYy`hW<{OaV$5D_T1u>8U
zEx>1tPo@dTK(ARS^b`YG)AEguk)aQ4)P<`VxO(hlJ2KkiwUx1xhjyWGUohaC8=b$P
zorG@%gG~p5f<%Q$(^3qLq93pa1^FPvo%sc80ib+vacD7|f?*SekLW{NT9)#m?5J*!
z8BoD7`$kJL1J=UxN(LIn@rJfQg_s!zm7Z+$N+*?qW)LcvA=LeFK!xax0h9u_T#Z5C
zRbk+!9iqY+12jm1=b|B?72vl6RR+tx4fR~~Lm&p2z&V3Vs3!Pps`6#76-Ln1hmy@j
zi6YKrjR6k?QlO$>Yfw(-LzO{9F-^7Y(3mPFWC;19IaLf@Dhi&NDo^rKp~App`X&P&
zQVABN{|<v4(m`q2T$KphoX@CG#UuH{48Yy#X$E;@0L{?UMu27*p8CK)G=qP_z&==(
zVkmrggMp0j&V7KUW@vI}M4S@?Ml_5b6hpuaG^YNU4?sS|yA-SseE=@TxeuBF3I^?i
j7z)C8sQ3USL)C}>aAntk8T#0f00000NkvXXu0mjf1fZdS

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

literal 1441
zcmV;S1z!4zP)<h;3K|Lk000e1NJLTq004gg002M)0{{R3!N0Xw00001b5ch_0Itp)
z=>Px#Cs0gOMF0Q*0Du4h0RR6000930fB^phfdBu10RI600RR90{{a7h|NsC0iKN@w
z00009a7bBm000XU000XU0RWnu7ytkT6G=otR9M5sl(9=AO&Et~6^)W+7GxLQErP|>
z0gI~zON%t=R}0}VMI=SwOko*Fb14Hhwjsr=f+r+J1`b8tKk9z(?Cj3Wn%sAH-v{6O
zI+{3}nP;E*ZP?LK@93fT(0lp*g37WJ)DLP^S$24Met3U=fByXVjLI^ZIxW}{>htG*
z|GIyDy%^*RP@SHfo@S@Cz~SMiPZt-L7nhfdPL@T!)j`CuK(p6-=zjnHB0(Urz%dYx
zvAd*!1sdn)_sQeqvjl<6B(}B2QW0o`0RT#Z93dyr2ps@q*x1Jif+(N?f@ZJz&;>#Y
z1ev`8;P?l%q|V*}(6~>4kODzwZ)+X&D-KR74lY(X@Zq4@Y<5v8-4W{bI4`N|z0qhS
zsAB%j1+X3TuLpyLOW-)Txa@Q=4+BBos)(T56kX9(Qst{6kkmN<2$F_KM3T?Ht#q&n
zfDk!|;NbRTFYnX6(>RN>1@_+nK!6-Xa4=i#KvW#aiUZ*|NUcExn{ZHrf)F{l&Gw3l
z_u_c50Ko<vY(qhS9L&f8S@5+5;~@P92kBY|n{ZI;hp-SW;_P<MAjAtG0AK?E0W8q`
zET9;g@fSHr9ScjgNmZ+bVHm}6=hh)02OCt|+Z6mb9?WLGuPx+R_z!Y`{TTrKD2#$m
zd^_3m^N#&ET11OE_GbW~XFnXov#EX<i}4pZa7!2mQ5bVpl!t9t6wT*z<$!HFQ&tw-
z94wi+OiCKs0TYQeRdIl>d7%#rL9*4>)ndNS*c=EOYy%$(xIGn^c5|>SuWDm^*7CH2
zEtUv-%5h*2f|zf$G-kWy`K-<0fB^6rcgkeJ&B3y~YOCd?bm{w?0NQY1Pgzkk4kG2C
zwX4>~Rdo;$0s*wiL8~4P4rWtYATUvMbFicZjxoEWZCD$>L9o?olLIn>9MB8bfjSwF
zmfYtB0bY0!ZXF0r{UHb5!NGJor5C<mTBzgz3mgMMY6o;D0ARTTPdy846@jPL3<6`S
zO*v?@^2g`4M1Oq_TILXl05?qk${m<vT<yRQ_D$TFuL$OJ0y+m)kbG0h0fPgM9E?p8
z8CL`;ZJZE_9c9d=NinQLupH1K5J5CAj2H(RKxcsn7;=C`<=9Fh_RI+cYtTDx9C(%Q
zgOxd8ItTPD6b^I_e78Wr;D7_+j2yIfIZ6<)AdIJ{M&Y34-O0PRY07c$R#$Vd>w9P-
z@bJ0%d}JKd!mkH5fzAOT@U8-o-!uVd1%Y@n4m?Q+B6Yf&11oMsFdB`FgWAEt*Izi0
zxq~upzi>bn_y-4h4ouwY%E4&3-hs-3azNV805JY$#Z9;lx<mkksYnxH4>t$acehu^
z@6m9i-(u=_a$pwV%CB~S7qozJz}Mv9%l>5Iv7+lcqn+GAJ|BK?;Hw;9H`LkLSk;8*
zC3HRM`KzltRZ~$ZCkOjqCKGcPJ3BkW;n2*7>vF(xhY4~p9?S8B2*?QzK->Ue*iiFb
zF0a%fOv#t(L=86w<e=Oi1jC(S=^!)?JZt2}0bn_xTxbAslRN0z4#-bZ4krfyFb))g
z<skG|=YSyxNfE{I>x9!iQ{PZOVSxmXs{n!oz?*TP42X|8uus8uQ0BmMntjND{`8Hm
zVKoPO<Ffxa2QGlOA_o-*YjdEp@aH*L=^&{%xT!ek+78MPRvi3h4zR6f4F!N46bShO
vHzfisz}44wj!<#H|DPOi!T(hb++sfg=LO2gw?C=900000NkvXXu0mjf3igJW

diff --git a/Tests/images/bmp/html/pal4rletrns-b.png b/Tests/images/bmp/html/pal4rletrns-b.png
deleted file mode 100644
index 9befa575fa40bc5c4e2052ff40dd3f7d23c9674f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1362
zcmV-Y1+DstP)<h;3K|Lk000e1NJLTq004gg002M)0{{R3!N0Xw00001b5ch_0Itp)
z=>Px#Bv4FLMF0Q*0Du4h0RR60009300D%AhfB^ph{{a90|Nj90fdBvh|Fz$n$^ZZW
z32;bRa{vGf6951U69E94oEQKA1jk84K~z}7#g)HHBTX2`XCo$JH4E9r>^4ETJ|J8l
zuuHQF!eN?~K;TT1E|BWd1*|MXnpwpYlE#5k)cxn~`^@Z*nN8xo-uuG)JWMn`do!Q?
z>^C`faxyr%AKVXKe!ig6^c3}rT2-1JAD<uJo!^~5KRlz-R3=snc7po)bvV2pUSF?A
zdIPH7X|I>|XoKV9FJCS$E-x-G*ZnjNT%)~!V}s6Ma3BBt`659eu|XFIU7RjyVT1Ph
z`Catz@GL<fQ;B1Z^`r<ggb@G=0*#;vGK4+=QXK4Jd0ybr0zqfcxsQR6070g&0O<ar
zmelDx0NQsE5E3BB^lhhuVa35|#lgik2QD0RI-MAm&>f*(ySijn@9lOwLgn)}8^Clh
zydI6#Hi6~f;<Dez90okys)!)&h*-o*s(e)hl3D|RAZm+9M0)<V)xjPBeB>a2gPYT)
z?q0JOreV6q`85D|$Uy)H%k2(C#eu9i5SD|)SVXV~2X!d$k%ODGnOE2h!}S^jH8|LZ
z0uMP@k^{2fW)?~Z$sZgfJ00x7L4D}MLa+|gn`Vg+u7Lo68UQ?4p!w3H7?$fVa*$XS
zp4c8$z3%&d5QhC5i+~)|sP^|M_+dC&E?qaXptJBF<N)V00Jwo4c>VBZ-gI?`ZWyeC
z^$O=R0MKXOABD?B_F>G|U*y0pQ920xkh8oT9K(WOwOT0$Y~LCgS+H~P#LCO0q?I{f
zA~Hr52k5%vyRhIHS25RRYz2fGtKpr;&5>8Oodbga$14owfU!uJBg;XF;DzQf4hR?=
zC;;ZzqcRJ24lII%Ufx#<z;XbvGK!^xKsz{4d*iA@dST>%WeyJgQER!N4ZJdnb`G9s
zgD$2|+5uicKtIWWqjDfN9H{FY+VY6!1o*`X)MS-iK!0hq7K;Th9c<0PK^F)zcK~h$
zpd2{rv%t0yIBHLCBL~L2%2W7r4sZ$`oWK1j2L*z6#7zLVG_WHF+7<v99B|}dW)N^i
zpbk(uFgL&~iSlJU1j~UF5J9lo;=nP#n2CTP2iR23tRxCeAeed#Tx>P4GY2fo0eu!K
zIdJU)0fPe$gfr#ffTPqM)869ov0XTDZsqOUBH_4qqpLYMa2;2D5FLkNw3?O<>i+kZ
zNs#4$5O}Nr<d2L%8B+w}v2@@_LJ*17J9D53rqgNZpx$bI|G<GfvvTl}1G2z398_|^
z4wZxHWVZvA1?7OWp8;U@!vwG$#6$pug-9Y{u4)cS1&8EdGW~20ioA=D9Pk}E_;xg(
zJ1p<R#<Zaw=()e)z;*Ti7xd)M&St9ST$jk|F`Hjq-KtuMN?AEL`Zk}JchP7xCX-1y
z_jl!h;|?R_U^bJpIT4T(JOD8Uz@)9_F_%~BAuPz3>PRg+2jrkQ9|V)eq;TMu4jf}?
z;{Y%mP%bh6G1d-Z(*gO3ie=>h0Hp(kU^wvI?Kxn`L6k>v_B!Wu&(ve;#|eEW#+YAS
zNdUZ+4wM10nFI4Fm=1~@I99Wb9Ay7`oYkb7gY4j<Kb->`z}b?6ii4dw$g=SH9Bg$E
zRUC{f4r0?m5yFatf0zRt>ljM`AO|^u-e6oH&<0$6ZEJ*z1OETyfD8Vwa$pzx4f$Cf
UzIreXm;e9(07*qoM6N<$f*WyV$^ZZW

diff --git a/Tests/images/bmp/html/pal4rletrns.png b/Tests/images/bmp/html/pal4rletrns.png
deleted file mode 100644
index 9b0c044364123ce0c527082f3460f62380b96ec5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1465
zcmV;q1xEUbP)<h;3K|Lk000e1NJLTq004gg002M)0{{R3!N0Xw00001b5ch_0Itp)
z=>Px#Cs0gOMF0Q*00000fB*mh|Nj600RI30fdBu10RI600RR90{{a7h|NsC0&Xr&|
z00001bW%=J06^y0W&i*H32;bRa{vGf6951U69E94oEQKA1s+L6K~z}7#gxxW<4hRG
z)Bm6o#UFUt8EAq{E=AaTLD;+C&BI1PSnQ=D2x~9i3O#La1y3GJ51S~i&>q%-Rn+`Z
z`+X*p&P;6g-QD+v_jw#mon+>dPrj+QyL+~Kdv<&F^z8|i=liH1)T;7)XXj|==IG|=
z@$M0o=Q4BptGA2#@ZtRY;{4)b)+-jEI@mur$PZ|Not^jZkB?7|Pfli?JdcFcLG%s_
zw9n3NyWhS&Nf1aZum^-a>@I0wf!5K{O>%elC_x}|iEXX%T@h%69suS91wuif5jp_K
zv9Z7if+(N?g7#VawhM#|2r_>Lz}^pPNu9p}pmmb~Ap?TUUzR#JuQ=GRI5=M9K)^w}
z-R`0?x+B!{UQtrlYpc~tQ04rK3t&4qzv%U5E`j6V_@vXpJPZUyt0IDKJME@jB~?Bv
z0!du}fFNn5NtzV%FAE*40w6>VA~?9(ZxnsdIEeE&pJD$M00hWE1P7DF4$_JPS#gj$
z4l-*H!73cALqUifT;+|j;zk_LW*}IBgEc4!kb?<1APYiUFb=YRaF8u^unGt3=OHXa
zvpBzM7=(BR1OTi6Ab<s$p9B;`GyWn6nPcI*w@S6X9)@8Q$DJ#OfE=t)t*ue;<G44O
z2%#+$S@;iffc+T&L=;9rC%zgrMA5N`qggbYVt)nzdiTR#JQ?eku^fMq1Gl~!2T>Sv
zR+f)#SQJgCQ{{lIIa5{^+#EbGbDESiv;&qV)>Op-g9ASlun;75Pgjiz!PpcCD{KW9
z1>BwrOuIRFn4jfgdsg$cgE~u6d&+UZ<_JN|>otw()qKG`1_uOyYuqW51vdu|^RwzT
zKciD$rv%`^fjwnK(Kv{dgW9HA8)t2SfDj14BL}suu-BZ7X@S5*(apgFEwG2#2ik^t
z_zi-3%_9e71UaAs*MWL6J}tS;O9CAD5pEp_O#LATezQ3qkLf^&xrIs&u)rP=q;^1e
z0svMx@YTD(77_Sr%^)zQJj#K`=0Ael62<Zy)XYO50^BhDt8ic*<6;LQ*fw!vLJ>^q
z3FsVHK@z5v0|o~iIT)HGGOh?R+BhK;JIa{L5<Nb8<{?-P=phh6G%bx72O2<Ufe09K
zfJNodN+R|w2vXLfPuw{0E8hnTbHH>C=v^os=o|>QK)~RD1L2Sy)HXRPCE%1W?(bWr
zgPMOWuV2O)$Gw~WSk1wv@X<uz<GQWsz&KbBKR0axodX60-c<ndizeW#BuMX#178wC
znmJv~ffY9*7z_r+!Fsd#`4<jk;b0!OUpOEO{EdSm2PSS?%E6$&+=0r1azNS-0Wkbx
z#VvImbcp~6<1|ZBYgBSzeRum?_&w+k^hZqnP7cfh90aU%fCE~<IN(ci@M(KA@>$ti
z8-tC)K`|e`aUfI<up8>|aHwj;i%NCf>-p2uYgOaaEjI_-pGG5d7aJQJ{eIufhs$!n
zafb<VFdWL^hzQ6D9zc2tfPPEOcey-O4`EEcR3~b<IUon~{Xx**=+7O5#({5*df_0k
z9Z)VbKzdm?=-Lj*Pf`vy2LLb*6oTa-6pM4fkb|U*;_!LI>7J=Csqe8sg4Z<#f&{>e
zaX<!a2cqJDRUFK7;5%J^lLLMArLKN82gSzo{_`BT0RDm;R2(eLL1E$DpXXqqgQVi%
zvf`j?J19d~b?}=xz_z|Mh=3ypB|@>l<s5+);Oc9;K&Uw2|4$Bh%Kudk+^YWsrOP19
T^p<(700000NkvXXu0mjfl&*rp

diff --git a/Tests/images/bmp/html/pal8nonsquare-v.png b/Tests/images/bmp/html/pal8nonsquare-v.png
deleted file mode 100644
index a1cd1ab180de5b50c6a08448cba48425a4ce75fd..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

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

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

literal 3776
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
C+Q0+=

diff --git a/Tests/images/bmp/html/pal8rletrns-b.png b/Tests/images/bmp/html/pal8rletrns-b.png
deleted file mode 100644
index 1ede504d4e57bb6874733944294f2e65ca78c1ed..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3715
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
ARsaA1

diff --git a/Tests/images/bmp/html/pal8rletrns.png b/Tests/images/bmp/html/pal8rletrns.png
deleted file mode 100644
index 2d8e957f1f5db00e817c85a5af9562c8e228fce4..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 3793
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
TO%d#03lth0vF!Ge?MMC}W~ANJ

diff --git a/Tests/images/bmp/html/rgb16-231.png b/Tests/images/bmp/html/rgb16-231.png
deleted file mode 100644
index 76efe526e5aba012c98601486a9c8488cd87ad40..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 2643
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
DL8_22

diff --git a/Tests/images/bmp/html/rgb24.jpg b/Tests/images/bmp/html/rgb24.jpg
deleted file mode 100644
index c43698c9b15c34365e85abd4c6b86a3e52ad6310..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

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

diff --git a/Tests/images/bmp/html/rgba16-4444.png b/Tests/images/bmp/html/rgba16-4444.png
deleted file mode 100644
index bfeda6faedbe075d795d2c315533d0bda7d657ea..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1093
zcmV-L1iJf)P)<h;3K|Lk000e1NJLTq004gg002M;1^@s6Gm)rk00001b5ch_0Itp)
z=>Px#32;bRa{vGf6951U69E94oEQKA1L{dcK~#9!?Op$IvoH*O{;ms<5t0#_5z-N0
z1Q@{{0Y(TTzzEF<?Fi`zVFZ7F(59pb#KyluEZybO_Ka-lJxR7gD3gE$03-=Qyfd)=
zS0q8+8AC|(QP(woC4sr9>-Yzf2a?XK4gx=70=#t3VC%9MFtVn^xeki_h%*3zA29(4
z{D=uaHUA-NzMnk+MSjE?fWVKK00e%-1fZI~h??(a4?vM0aRwmpBPIZWA29)_<_BIt
z*ZJw=Q{+c<h9~fe00ce}AYjeUwp)cIcNgzdk~jJITv-MHcyHdVI;(Aay?Nf8|5jC*
zRX>$w316S(FE;Y)tVWeplVjepH*5194w)Cbgb)xyc*_93!Dp6UedKu{fFkf#?eax{
zrPlmkM`dDi%r@K3p5*g0yPD6NT^<M!3Vdns(g9>P0cHa4z^-S$nPVPtn1+8C0J+IF
zIPQ;1j`{j3CV=n!*=5+oxu@eLB#L_}QPgT*+Bg&k({w5~#RjMSX>#B+@M_XDd*v@}
zFjiRI!RzQ)OwCXCsYyhg!CV!qao2QLz)RP5^~bv~eSlb+Ja-8Y0{GC4prAFs)3Bu#
zt*Jlc;7BD|!5~ZdeX-C0zOxEYzpHoC#JQ&<Xw4Ul4VI$Z;ky7xFKzxIfMBC~O(e^N
zr_eDYz|zwG1wg#y$`>BX<INIqOYeGJhP2IF3HTQf#JL?XZQ$<^z$Wm<-97!xv*epO
zeC>O_$DjBKt7`T4TrK<K7gtd1)MIDhIWN(5I>tTt%^VU)WWUN;U9j)#R{&5|mFiqq
za^k0<vj@QI>9J)O{&e{`FFizq|FoZ&>{1wTLhtB}0s$uHl6;t5x#^mX>>7eT5BPZm
zcnJXhud!015{ezZ>hME=qXf1R*fQWlR08E~husB3atT%mtu?ERX&SEF;k!KP`Msad
zcg<hVJ?E!+ineZV>KW0oRtt(wYt19$*YhJVadL)N(GfKA9qU=*TwV#V81M&C9|8D&
z2oMzfdR~Vw67by<z<13zc9I0@D?OdUT=Q#wqA)(u)T!YTcLWF$`4VVNbub`({>XPr
z0N>!RZ75;D>(9?+S~{IeQP0}F>+BQ2EBHguYzR-e^SM;?*tW|T0fK&{J6G~FKR18k
z6MF>kvf<l(e2liZ4sSCaygae!X4l-jPItri`ntQd+>7y???%k(7C`{|uHK?EfSC~Z
z5fgyGkC*`TWDa^V2g&jYNKfV<0ucB_0IK=RSb&o={L?;}gED{}9Rz;F1R(GuCIHp^
zhkxp}yFCC!e#9Aoz>k;!1b)N>pqjt9|FmIm4?vM0aRwmpBPPIqRIs-A+O?K500000
LNkvXXu0mjfovQ&k

diff --git a/Tests/images/bmp/html/rgba32.png b/Tests/images/bmp/html/rgba32.png
deleted file mode 100644
index 25e542a6551acf16d58489d2d7fde3a5d423b477..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 1229
zcmZ{kdr%T~0LOm>wZyqpG<$h=(?#XV>nULkBNeSCkJ>eSMa%4^DB_ESLSA5HnQTK*
zS!$=VBJq_{ouXl)9)x8R^N~OoK_zM-f{8fy=Wg5G=llKM_wM`m_X;5r=K@~?2LQN4
zgolt8leMVe<;xa*2k-Xz#emRBI4lsW*1cOSPATDJIsndyzXbuM!c_pkQX@k4AI%yz
z2{DO?2oHJtp4bNUt_neJTGbMCKeu3Wo~nO!?9~IeKyO!QUj5_no($ACW5P72V#H;C
zcc)M!u`$$->3Q_B`=embM+8FQR$l$I7}XSYdLcd|Q|+HDZ3r8-sFY=l_Uz<@n}Z^l
z>yIlb<ls9nE6NyCb6AOn!`0d&*xr3#p$9i1Bn6}%y6xrYD6As2S2M$-qu+YF@<!tk
z-|7CF95*eiH`?0W3cb&a`uE83;BnnyJT4BiiaAqXGcaaXGmXt6z6h`l(S6rtnL;?w
z%CB#+291bU4ZL{&et27x9rli<-v%o5_pyo?ag5yAz;Uy+#ije*e69K&4JfDdbv)z8
zG6w}kPQY)sOzRekjy3yoV(-TF8)MQg76*tRf%$mBbK0&l$@;HL48+breoSbyVfcj1
z11ObG{kRLCEkb;p+?TE&Z7Z91DJ&lGg2GAEp!uH0?epfHEek^h`WcP1Z6$DoOOn%K
z$N|f`X(}(DLI>|4-#n-~Y3MCjY0sP#=dt_JRMzXFXH$crgpp@+FT(27hnf<OfcW>H
zJu(I}ef?QBLO!TNjt@1Zn=nZme^4Z?6?_oZHH@XwEtBWc4(Mc0oav3bSECIqyAc{d
z<IE~TPLH(s>bz(wA8vWJFl?{?xjnOrh;huQ&)rr@<`HNsHP7;e=c!kmj5(S%$OTy|
z&ZDyXpSr)nL!Na%-hTkm%CMO-=CWkT8~J{+K-ld$TwqZpBN+@3DouYtF6a+-D&h4#
z^qi}vLJ)lZVfB{83yh!?7uP>09?})1X2$Ld_FH|ko0G0-XI`7KK2Jh}@`D6X0`xe9
zJG_scKs;Si+Vz0hkgI%^Gtr0N@cr>$_!`srPpM}=O-ZAGcKTgGSZB#OWp(y~H1=Cb
zKros8iBi~Lu5fGuS@qNFNdjC^Uo=Z<9TFu%*a+mr(%o;)BOhI>QUW%IQ_XuagEP$_
zNh;5B7|OqcytGxqk~~k!u*7?>G3L;Hs`>7qqp_4Y!Nhi&@B%_)jd?BD)u^%IT-wL?
z-N~oaR<71Xf5>iwj5((e+4=CSfw;3Lo25Tj-CLhP^19tDCz`X!&>RLzc5JX<DjltP
zsJKDIyyS`W-9v_BtXdi4%^7m~we4u{aLQ~#?p{ud-NQ}V$Q3KN+U^#nEbvRsP|EW5
za4O4}eCY<YeR)xNim&}r5k@|>^yR@3?vl-yFmfuUD~I*=1I=2q^_2tFVa4v?MPXX7
zmhoTtuG03t`H)j*X1V?L73O+Mm*WJoQjgq-w^2*8%^P+;u}oS&9&cS&JyO$zKdE+-
zrs!me+C#s!>7#3hI*i`BvYk~+GTBp3<^Kc&wK1VcO-F<R$&~#cJ~-O~q_|9dFOqq2
Q#o{G_h|tIoF_x117Yvzc5C8xG


From dbc5a4fc906edf8892eee3c3d84f15f74118246e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Dec 2025 22:26:23 +1100
Subject: [PATCH 2154/2374] Added release notes for #9070

---
 docs/releasenotes/12.1.0.rst | 59 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 2 files changed, 60 insertions(+)
 create mode 100644 docs/releasenotes/12.1.0.rst

diff --git a/docs/releasenotes/12.1.0.rst b/docs/releasenotes/12.1.0.rst
new file mode 100644
index 00000000000..b6e1810c60a
--- /dev/null
+++ b/docs/releasenotes/12.1.0.rst
@@ -0,0 +1,59 @@
+12.1.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards incompatible changes
+==============================
+
+TODO
+^^^^
+
+TODO
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+API changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API additions
+=============
+
+Specify window in ImageGrab on macOS
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When using :py:meth:`~PIL.ImageGrab.grab`, a specific window can now be selected on
+macOS in addition to Windows. On macOS, this is a CGWindowID::
+
+    from PIL import ImageGrab
+    ImageGrab.grab(window=cgwindowid)
+
+Other changes
+=============
+
+TODO
+^^^^
+
+TODO
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index f66240c8957..b097770a3f8 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
 
+  12.1.0
   12.0.0
   11.3.0
   11.2.1

From 04ee0cc3b1f3d5908efbe460097f133f3d73f2ec Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Dec 2025 23:06:18 +1100
Subject: [PATCH 2155/2374] Raise error if subprocess gives non-zero returncode

---
 Tests/test_imagegrab.py | 18 +++++++++++++-----
 src/PIL/ImageGrab.py    | 21 ++++++++++++++-------
 2 files changed, 27 insertions(+), 12 deletions(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 01fa090dc3a..2f46d7c925e 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -60,12 +60,20 @@ def test_grab_invalid_xdisplay(self) -> None:
             ImageGrab.grab(xdisplay="error.test:0.0")
         assert str(e.value).startswith("X connection failed")
 
-    @pytest.mark.skipif(sys.platform != "win32", reason="Windows only")
+    @pytest.mark.skipif(
+        sys.platform not in ("darwin", "win32"), reason="macOS and Windows only"
+    )
     def test_grab_invalid_handle(self) -> None:
-        with pytest.raises(OSError, match="unable to get device context for handle"):
-            ImageGrab.grab(window=-1)
-        with pytest.raises(OSError, match="screen grab failed"):
-            ImageGrab.grab(window=0)
+        if sys.platform == "darwin":
+            with pytest.raises(subprocess.CalledProcessError):
+                ImageGrab.grab(window=-1)
+        else:
+            with pytest.raises(
+                OSError, match="unable to get device context for handle"
+            ):
+                ImageGrab.grab(window=-1)
+            with pytest.raises(OSError, match="screen grab failed"):
+                ImageGrab.grab(window=0)
 
     def test_grabclipboard(self) -> None:
         if sys.platform == "darwin":
diff --git a/src/PIL/ImageGrab.py b/src/PIL/ImageGrab.py
index 4228078b11b..66ee6dd33a3 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -43,25 +43,29 @@ def grab(
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
             args = ["screencapture"]
-            if window:
+            if window is not None:
                 args += ["-l", str(window)]
             elif bbox:
                 left, top, right, bottom = bbox
                 args += ["-R", f"{left},{top},{right-left},{bottom-top}"]
-            subprocess.call(args + ["-x", filepath])
+            args += ["-x", filepath]
+            retcode = subprocess.call(args)
+            if retcode:
+                raise subprocess.CalledProcessError(retcode, args)
             im = Image.open(filepath)
             im.load()
             os.unlink(filepath)
             if bbox:
-                if window:
+                if window is not None:
                     # Determine if the window was in Retina mode or not
                     # by capturing it without the shadow,
                     # and checking how different the width is
                     fh, filepath = tempfile.mkstemp(".png")
                     os.close(fh)
-                    subprocess.call(
-                        ["screencapture", "-l", str(window), "-o", "-x", filepath]
-                    )
+                    args = ["screencapture", "-l", str(window), "-o", "-x", filepath]
+                    retcode = subprocess.call(args)
+                    if retcode:
+                        raise subprocess.CalledProcessError(retcode, args)
                     with Image.open(filepath) as im_no_shadow:
                         retina = im.width - im_no_shadow.width > 100
                     os.unlink(filepath)
@@ -125,7 +129,10 @@ def grab(
                 raise
             fh, filepath = tempfile.mkstemp(".png")
             os.close(fh)
-            subprocess.call(args + [filepath])
+            args.append(filepath)
+            retcode = subprocess.call(args)
+            if retcode:
+                raise subprocess.CalledProcessError(retcode, args)
             im = Image.open(filepath)
             im.load()
             os.unlink(filepath)

From b428f7209f81e7010ac419307f600a3995305043 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 2 Dec 2025 23:53:45 +1100
Subject: [PATCH 2156/2374] Open a macOS window on CI

---
 Tests/test_imagegrab.py | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagegrab.py b/Tests/test_imagegrab.py
index 2f46d7c925e..07cb69719d9 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -9,7 +9,7 @@
 
 from PIL import Image, ImageGrab
 
-from .helper import assert_image_equal_tofile, skip_unless_feature
+from .helper import assert_image_equal_tofile, on_ci, skip_unless_feature
 
 
 class TestImageGrab:
@@ -60,6 +60,30 @@ def test_grab_invalid_xdisplay(self) -> None:
             ImageGrab.grab(xdisplay="error.test:0.0")
         assert str(e.value).startswith("X connection failed")
 
+    @pytest.mark.skipif(
+        sys.platform != "darwin" or not on_ci(), reason="Only runs on macOS CI"
+    )
+    def test_grab_handle(self) -> None:
+        p = subprocess.Popen(
+            [
+                "osascript",
+                "-e",
+                'tell application "Finder"\n'
+                'open ("/" as POSIX file)\n'
+                "get id of front window\n"
+                "end tell",
+            ],
+            stdout=subprocess.PIPE,
+        )
+        stdout = p.stdout
+        assert stdout is not None
+        window = int(stdout.read())
+
+        ImageGrab.grab(window=window)
+
+        im = ImageGrab.grab((0, 0, 10, 10), window=window)
+        assert im.size == (10, 10)
+
     @pytest.mark.skipif(
         sys.platform not in ("darwin", "win32"), reason="macOS and Windows only"
     )

From 7adecb792c07023cc6c7b410323bb4eabe5d2a23 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 3 Dec 2025 07:14:12 +0000
Subject: [PATCH 2157/2374] Update dependency mypy to v1.19.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 6ca35d28642..5b0e2eaf8d7 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.18.2
+mypy==1.19.0
 arro3-compute
 arro3-core
 IceSpringPySideStubs-PyQt6

From b633f49b9c58079975628f2a7eb5acf7118483a5 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Wed, 3 Dec 2025 07:14:19 +0000
Subject: [PATCH 2158/2374] Update actions/checkout action to v6

---
 .github/workflows/docs.yml                 | 2 +-
 .github/workflows/lint.yml                 | 2 +-
 .github/workflows/test-docker.yml          | 2 +-
 .github/workflows/test-mingw.yml           | 2 +-
 .github/workflows/test-valgrind-memory.yml | 2 +-
 .github/workflows/test-valgrind.yml        | 2 +-
 .github/workflows/test-windows.yml         | 6 +++---
 .github/workflows/test.yml                 | 2 +-
 .github/workflows/wheels.yml               | 8 ++++----
 9 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index cf917407c6c..e88abf16fbc 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -32,7 +32,7 @@ jobs:
     name: Docs
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 2addbaf674d..77d1d1caa40 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -20,7 +20,7 @@ jobs:
     name: Lint
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 213062ee2b8..091edb22264 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -68,7 +68,7 @@ jobs:
     name: ${{ matrix.docker }}
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index 6c4206083c5..e247414c8fc 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -45,7 +45,7 @@ jobs:
 
     steps:
       - name: Checkout Pillow
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           persist-credentials: false
 
diff --git a/.github/workflows/test-valgrind-memory.yml b/.github/workflows/test-valgrind-memory.yml
index 0f36fe30dc2..bd244aa5a57 100644
--- a/.github/workflows/test-valgrind-memory.yml
+++ b/.github/workflows/test-valgrind-memory.yml
@@ -41,7 +41,7 @@ jobs:
     name: ${{ matrix.docker }}
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-valgrind.yml b/.github/workflows/test-valgrind.yml
index 30caa0d4e51..81cfb84566c 100644
--- a/.github/workflows/test-valgrind.yml
+++ b/.github/workflows/test-valgrind.yml
@@ -39,7 +39,7 @@ jobs:
     name: ${{ matrix.docker }}
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 02d4da999bf..c4d0fa04605 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -47,19 +47,19 @@ jobs:
 
     steps:
     - name: Checkout Pillow
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
       with:
         persist-credentials: false
 
     - name: Checkout cached dependencies
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
       with:
         persist-credentials: false
         repository: python-pillow/pillow-depends
         path: winbuild\depends
 
     - name: Checkout extra test images
-      uses: actions/checkout@v5
+      uses: actions/checkout@v6
       with:
         persist-credentials: false
         repository: python-pillow/test-images
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index ef7b34b8d10..167faa23930 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -65,7 +65,7 @@ jobs:
     name: ${{ matrix.os }} Python ${{ matrix.python-version }}
 
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
 
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index e33d74a81fe..fb71ead37b5 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -107,7 +107,7 @@ jobs:
             os: macos-15-intel
             cibw_arch: x86_64_iphonesimulator
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
           submodules: true
@@ -154,12 +154,12 @@ jobs:
           - cibw_arch: ARM64
             os: windows-11-arm
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           persist-credentials: false
 
       - name: Checkout extra test images
-        uses: actions/checkout@v5
+        uses: actions/checkout@v6
         with:
           persist-credentials: false
           repository: python-pillow/test-images
@@ -235,7 +235,7 @@ jobs:
     if: github.event_name != 'schedule' || github.repository_owner == 'python-pillow'
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@v6
       with:
         persist-credentials: false
 

From fd3d44d2efb40df8066802c545bbecff687ac8be Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 3 Dec 2025 22:38:32 +1100
Subject: [PATCH 2159/2374] Updated zlib-ng to 2.3.2

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 07ea75a75c5..12b5ea6c74a 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -103,11 +103,7 @@ XZ_VERSION=5.8.1
 ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.1
 LCMS2_VERSION=2.17
-if [[ "$MB_ML_VER" == 2014 ]] && [[ "$PLAT" == "aarch64" ]]; then
-  ZLIB_NG_VERSION=2.2.5
-else
-  ZLIB_NG_VERSION=2.3.1
-fi
+ZLIB_NG_VERSION=2.3.2
 LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
@@ -150,11 +146,7 @@ function build_zlib_ng {
     ORIGINAL_HOST_CONFIGURE_FLAGS=$HOST_CONFIGURE_FLAGS
     unset HOST_CONFIGURE_FLAGS
 
-    if [[ "$ZLIB_NG_VERSION" == 2.2.5 ]]; then
-        build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --zlib-compat
-    else
-        build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --installnamedir=$BUILD_PREFIX/lib --zlib-compat
-    fi
+    build_github zlib-ng/zlib-ng $ZLIB_NG_VERSION --installnamedir=$BUILD_PREFIX/lib --zlib-compat
 
     HOST_CONFIGURE_FLAGS=$ORIGINAL_HOST_CONFIGURE_FLAGS
     touch zlib-stamp
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index cd2ef13c11f..4fbb7e82043 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -126,7 +126,7 @@ def cmd_msbuild(
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",
     "XZ": "5.8.1",
-    "ZLIBNG": "2.3.1",
+    "ZLIBNG": "2.3.2",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
 

From 4d511d86edf5b78ec3778061c41c5b7ed8653339 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Dec 2025 19:31:40 +1100
Subject: [PATCH 2160/2374] Changed argument type to match use

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

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 7cb3ea8e40b..cf7676ab1dd 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -11,7 +11,15 @@
 
 import pytest
 
-from PIL import Image, ImageFilter, ImageOps, TiffImagePlugin, TiffTags, features
+from PIL import (
+    Image,
+    ImageFile,
+    ImageFilter,
+    ImageOps,
+    TiffImagePlugin,
+    TiffTags,
+    features,
+)
 from PIL.TiffImagePlugin import OSUBFILETYPE, SAMPLEFORMAT, STRIPOFFSETS, SUBIFD
 
 from .helper import (
@@ -27,7 +35,7 @@
 
 @skip_unless_feature("libtiff")
 class LibTiffTestCase:
-    def _assert_noerr(self, tmp_path: Path, im: TiffImagePlugin.TiffImageFile) -> None:
+    def _assert_noerr(self, tmp_path: Path, im: ImageFile.ImageFile) -> None:
         """Helper tests that assert basic sanity about the g4 tiff reading"""
         # 1 bit
         assert im.mode == "1"

From 4024f0287d4e8a1467da8ce4ac86ea087e53af1c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Dec 2025 19:25:47 +1100
Subject: [PATCH 2161/2374] Assert image type

---
 Tests/test_file_iptc.py    | 1 +
 Tests/test_file_libtiff.py | 1 +
 Tests/test_file_png.py     | 2 ++
 src/PIL/Image.py           | 3 +++
 4 files changed, 7 insertions(+)

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 0376b99977b..9e2d8c06da1 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -143,6 +143,7 @@ def test_getiptcinfo_tiff() -> None:
 
     # Test with LONG tag type
     with Image.open("Tests/images/hopper.Lab.tif") as im:
+        assert isinstance(im, TiffImagePlugin.TiffImageFile)
         im.tag_v2.tagtype[TiffImagePlugin.IPTC_NAA_CHUNK] = TiffTags.LONG
         iptc = IptcImagePlugin.getiptcinfo(im)
 
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index cf7676ab1dd..77e0b4bc9cb 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -378,6 +378,7 @@ def test_tag_type(
         im.save(out, tiffinfo=ifd)
 
         with Image.open(out) as reloaded:
+            assert isinstance(reloaded, TiffImagePlugin.TiffImageFile)
             assert reloaded.tag_v2[37000] == 100
 
     def test_inknames_tag(
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 9875fe09676..7f163a4d6d6 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -787,7 +787,9 @@ def test_exif_from_jpg(self, tmp_path: Path) -> None:
             im.save(test_file, exif=im.getexif())
 
         with Image.open(test_file) as reloaded:
+            assert isinstance(reloaded, PngImagePlugin.PngImageFile)
             exif = reloaded._getexif()
+        assert exif is not None
         assert exif[305] == "Adobe Photoshop CS Macintosh"
 
     def test_exif_argument(self, tmp_path: Path) -> None:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9d50812eb3e..b71395c6234 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1519,6 +1519,9 @@ def getexif(self) -> Exif:
                     "".join(self.info["Raw profile type exif"].split("\n")[3:])
                 )
             elif hasattr(self, "tag_v2"):
+                from . import TiffImagePlugin
+
+                assert isinstance(self, TiffImagePlugin.TiffImageFile)
                 self._exif.bigtiff = self.tag_v2._bigtiff
                 self._exif.endian = self.tag_v2._endian
                 self._exif.load_from_fp(self.fp, self.tag_v2._offset)

From 46ac30aa80e592fb3f58e8094c03547c57e04cd5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Dec 2025 18:42:58 +1100
Subject: [PATCH 2162/2374] Use different variables for Image and ImageFile
 instances

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

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 77e0b4bc9cb..e36b5f39e3c 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1155,9 +1155,9 @@ 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:
-                    im = ImageOps.exif_transpose(im)
+                    im_transposed = ImageOps.exif_transpose(im)
 
-                    assert_image_similar(base_im, im, 0.7)
+                assert_image_similar(base_im, im_transposed, 0.7)
 
     @pytest.mark.parametrize(
         "test_file",

From 61b1c3c841341cc6f22ab2caa321b7303f61bd35 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Dec 2025 23:51:00 +1100
Subject: [PATCH 2163/2374] Do not change variable type

---
 src/PIL/GifImagePlugin.py     | 4 ++--
 src/PIL/XVThumbImagePlugin.py | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 58c460ef3db..b00953a9df3 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -116,8 +116,8 @@ def _open(self) -> None:
             # check if palette contains colour indices
             p = self.fp.read(3 << bits)
             if self._is_palette_needed(p):
-                p = ImagePalette.raw("RGB", p)
-                self.global_palette = self.palette = p
+                palette = ImagePalette.raw("RGB", p)
+                self.global_palette = self.palette = palette
 
         self._fp = self.fp  # FIXME: hack
         self.__rewind = self.fp.tell()
diff --git a/src/PIL/XVThumbImagePlugin.py b/src/PIL/XVThumbImagePlugin.py
index cde28388ff0..192c041d94e 100644
--- a/src/PIL/XVThumbImagePlugin.py
+++ b/src/PIL/XVThumbImagePlugin.py
@@ -66,10 +66,10 @@ def _open(self) -> None:
                 break
 
         # parse header line (already read)
-        s = s.strip().split()
+        w, h = s.strip().split(maxsplit=2)[:2]
 
         self._mode = "P"
-        self._size = int(s[0]), int(s[1])
+        self._size = int(w), int(h)
 
         self.palette = ImagePalette.raw("RGB", PALETTE)
 

From 7c3ece07c9871ca992bd497961e023228a8ebd14 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Dec 2025 19:06:02 +1100
Subject: [PATCH 2164/2374] Changed type so that im has fp attribute

---
 Tests/test_file_gribstub.py | 2 +-
 Tests/test_file_hdf5stub.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index 960e5f4be1f..4dbed6b3190 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -59,7 +59,7 @@ class TestHandler(ImageFile.StubHandler):
         def open(self, im: Image.Image) -> None:
             self.opened = True
 
-        def load(self, im: Image.Image) -> Image.Image:
+        def load(self, im: ImageFile.ImageFile) -> Image.Image:
             self.loaded = True
             im.fp.close()
             return Image.new("RGB", (1, 1))
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index e4f09a09c52..1e48597d366 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -61,7 +61,7 @@ class TestHandler(ImageFile.StubHandler):
         def open(self, im: Image.Image) -> None:
             self.opened = True
 
-        def load(self, im: Image.Image) -> Image.Image:
+        def load(self, im: ImageFile.ImageFile) -> Image.Image:
             self.loaded = True
             im.fp.close()
             return Image.new("RGB", (1, 1))

From fd1ddd6d56457c2611b5b947af9a2c1d5a9479b2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 1 Dec 2025 19:12:58 +1100
Subject: [PATCH 2165/2374] Use consistent type

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

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index b00953a9df3..0560a5a7dc8 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -256,7 +256,7 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
                         info["comment"] += b"\n" + comment
                     else:
                         info["comment"] = comment
-                    s = None
+                    s = b""
                     continue
                 elif s[0] == 255 and frame == 0 and block is not None:
                     #
@@ -299,7 +299,7 @@ def _seek(self, frame: int, update_image: bool = True) -> None:
                 bits = self.fp.read(1)[0]
                 self.__offset = self.fp.tell()
                 break
-            s = None
+            s = b""
 
         if interlace is None:
             msg = "image not found in GIF frame"

From db7a994ad65f2e25c0e5c5c35ea72210062a4f2c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 6 Dec 2025 10:15:33 +1100
Subject: [PATCH 2166/2374] Updated libpng to 1.6.53

---
 .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 07ea75a75c5..4201c335f35 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -96,7 +96,7 @@ else
   FREETYPE_VERSION=2.14.1
 fi
 HARFBUZZ_VERSION=12.2.0
-LIBPNG_VERSION=1.6.51
+LIBPNG_VERSION=1.6.53
 JPEGTURBO_VERSION=3.1.2
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.1
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index cd2ef13c11f..87cfef7d087 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.4.1",
-    "LIBPNG": "1.6.51",
+    "LIBPNG": "1.6.53",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",

From a01fa7d08eacf0d64c47cd95c8846e34281edf1f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 7 Dec 2025 11:12:38 +0200
Subject: [PATCH 2167/2374] Test Python 3.15 pre-release

---
 .ci/install.sh                     | 5 ++---
 .github/workflows/macos-install.sh | 5 ++---
 .github/workflows/test-windows.yml | 2 +-
 .github/workflows/test.yml         | 3 +++
 tox.ini                            | 2 +-
 5 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index 52b8214170c..aeb5e65145d 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -27,14 +27,13 @@ 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 numpy
 python3 -m pip install olefile
 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
-# optional test dependency, only install if there's a binary package.
-# fails on beta 3.14 and PyPy
+# optional test dependencies, only install if there's a binary package.
+python3 -m pip install --only-binary=:all: numpy || true
 python3 -m pip install --only-binary=:all: pyarrow || true
 
 # PyQt6 doesn't support PyPy3
diff --git a/.github/workflows/macos-install.sh b/.github/workflows/macos-install.sh
index b114d4a23f8..7c768af483e 100755
--- a/.github/workflows/macos-install.sh
+++ b/.github/workflows/macos-install.sh
@@ -26,9 +26,8 @@ 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
-python3 -m pip install numpy
-# optional test dependency, only install if there's a binary package.
-# fails on beta 3.14 and PyPy
+# optional test dependencies, only install if there's a binary package.
+python3 -m pip install --only-binary=:all: numpy || true
 python3 -m pip install --only-binary=:all: pyarrow || true
 
 # libavif
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index c4d0fa04605..3450de35556 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.11", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["pypy3.11", "3.11", "3.12", "3.13", "3.14", "3.15"]
         architecture: ["x64"]
         include:
             # Test the oldest Python on 32-bit
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 167faa23930..da3eea06641 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -42,6 +42,8 @@ jobs:
         ]
         python-version: [
           "pypy3.11",
+          "3.15t",
+          "3.15",
           "3.14t",
           "3.14",
           "3.13t",
@@ -54,6 +56,7 @@ jobs:
         - { python-version: "3.12", PYTHONOPTIMIZE: 1, REVERSE: "--reverse" }
         - { python-version: "3.11", PYTHONOPTIMIZE: 2 }
         # Free-threaded
+        - { python-version: "3.15t", disable-gil: true }
         - { python-version: "3.14t", disable-gil: true }
         - { python-version: "3.13t", disable-gil: true }
         # Intel
diff --git a/tox.ini b/tox.ini
index d58fd67b613..7f116c6e75f 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,7 +3,7 @@ requires =
     tox>=4.2
 env_list =
     lint
-    py{py3, 314, 313, 312, 311, 310}
+    py{py3, 315, 314, 313, 312, 311, 310}
 
 [testenv]
 deps =

From 76532808f4b350741669e776598f338e4d2e5a96 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 10 Dec 2025 15:26:14 +0200
Subject: [PATCH 2168/2374] Fix ResourceWarning in selftest.py

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

diff --git a/selftest.py b/selftest.py
index e9b5689a0d4..c484d4e2d42 100755
--- a/selftest.py
+++ b/selftest.py
@@ -40,12 +40,14 @@ def testimage() -> None:
     >>> with Image.open("Tests/images/hopper.gif") as im:
     ...     _info(im)
     ('GIF', 'P', (128, 128))
-    >>> _info(Image.open("Tests/images/hopper.ppm"))
+    >>> with Image.open("Tests/images/hopper.ppm") as im:
+    ...     _info(im)
     ('PPM', 'RGB', (128, 128))
     >>> try:
-    ...  _info(Image.open("Tests/images/hopper.jpg"))
+    ...     with Image.open("Tests/images/hopper.jpg") as im:
+    ...         _info(im)
     ... except OSError as v:
-    ...  print(v)
+    ...     print(v)
     ('JPEG', 'RGB', (128, 128))
 
     PIL doesn't actually load the image data until it's needed,

From 9ac4edc54ba0ef720e91f28ba91b93c4f89ad4b8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 24 Oct 2025 07:29:51 +1100
Subject: [PATCH 2169/2374] Added wrap()

---
 Tests/test_imagetext.py | 17 +++++++++++
 src/PIL/ImageText.py    | 66 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 83 insertions(+)

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
index 2b424629dfd..e9d6d788631 100644
--- a/Tests/test_imagetext.py
+++ b/Tests/test_imagetext.py
@@ -108,3 +108,20 @@ def test_stroke() -> None:
         assert_image_similar_tofile(
             im, "Tests/images/imagedraw_stroke_" + suffix + ".png", 3.1
         )
+
+
+def test_wrap() -> None:
+    # No wrap required
+    text = ImageText.Text("Hello World!")
+    text.wrap(100)
+    assert text.text == "Hello World!"
+
+    # Wrap word to a new line
+    text = ImageText.Text("Hello World!")
+    text.wrap(50)
+    assert text.text == "Hello\nWorld!"
+
+    # Split word across lines
+    text = ImageText.Text("Hello World!")
+    text.wrap(25)
+    assert text.text == "Hello\nWorl\nd!"
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index e6ccd824332..34c0336c8be 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+from typing import cast
+
 from . import ImageFont
 from ._typing import _Ink
 
@@ -88,6 +90,70 @@ def _get_fontmode(self) -> str:
         else:
             return "L"
 
+    def wrap(self, width: int) -> None:
+        str_type = isinstance(self.text, str)
+        wrapped_lines = []
+        emptystring = "" if str_type else b""
+        fontmode = self._get_fontmode()
+        for line in self.text.splitlines():
+            wrapped_line = emptystring
+            words = line.split()
+            while words:
+                word = words[0]
+
+                new_wrapped_line: str | bytes
+                if wrapped_line:
+                    if str_type:
+                        new_wrapped_line = (
+                            cast(str, wrapped_line) + " " + cast(str, word)
+                        )
+                    else:
+                        new_wrapped_line = (
+                            cast(bytes, wrapped_line) + b" " + cast(bytes, word)
+                        )
+                else:
+                    new_wrapped_line = word
+
+                def get_width(text) -> float:
+                    left, _, right, _ = self.font.getbbox(
+                        text,
+                        fontmode,
+                        self.direction,
+                        self.features,
+                        self.language,
+                        self.stroke_width,
+                    )
+                    return right - left
+
+                if get_width(new_wrapped_line) > width:
+                    if wrapped_line:
+                        wrapped_lines.append(wrapped_line)
+                        wrapped_line = emptystring
+                    else:
+                        # This word is too long for a single line, so split the word
+                        characters = word
+                        i = len(characters)
+                        while i > 1 and get_width(characters[:i]) > width:
+                            i -= 1
+                        wrapped_line = characters[:i]
+                        if str_type:
+                            cast(list[str], words)[0] = cast(str, characters[i:])
+                        else:
+                            cast(list[bytes], words)[0] = cast(bytes, characters[i:])
+                else:
+                    words.pop(0)
+                    wrapped_line = new_wrapped_line
+            if wrapped_line:
+                wrapped_lines.append(wrapped_line)
+        if str_type:
+            self.text = "\n".join(
+                [line for line in wrapped_lines if isinstance(line, str)]
+            )
+        else:
+            self.text = b"\n".join(
+                [line for line in wrapped_lines if isinstance(line, bytes)]
+            )
+
     def get_length(self) -> float:
         """
         Returns length (in pixels with 1/64 precision) of text.

From 16691657cc6795889fa9712f48c1e36784d0c70e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 1 Nov 2025 00:00:50 +1100
Subject: [PATCH 2170/2374] Added height argument to wrap()

---
 Tests/test_imagetext.py |  40 ++++---
 src/PIL/ImageDraw.py    |  25 ++---
 src/PIL/ImageText.py    | 235 +++++++++++++++++++++++++++-------------
 3 files changed, 196 insertions(+), 104 deletions(-)

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
index e9d6d788631..9b3c711f4a1 100644
--- a/Tests/test_imagetext.py
+++ b/Tests/test_imagetext.py
@@ -110,18 +110,28 @@ def test_stroke() -> None:
         )
 
 
-def test_wrap() -> None:
-    # No wrap required
-    text = ImageText.Text("Hello World!")
-    text.wrap(100)
-    assert text.text == "Hello World!"
-
-    # Wrap word to a new line
-    text = ImageText.Text("Hello World!")
-    text.wrap(50)
-    assert text.text == "Hello\nWorld!"
-
-    # Split word across lines
-    text = ImageText.Text("Hello World!")
-    text.wrap(25)
-    assert text.text == "Hello\nWorl\nd!"
+@pytest.mark.parametrize(
+    "text, width, expected",
+    (
+        ("Hello World!", 100, "Hello World!"),  # No wrap required
+        ("Hello World!", 50, "Hello\nWorld!"),  # Wrap word to a new line
+        ("Hello World!", 25, "Hello\nWorl\nd!"),  # Split word across lines
+        # Keep multiple spaces within a line
+        ("Keep  multiple spaces", 75, "Keep  multiple\nspaces"),
+    ),
+)
+@pytest.mark.parametrize("string", (True, False))
+def test_wrap(text: str, width: int, expected: str, string: bool) -> None:
+    text = ImageText.Text(text if string else text.encode())
+    assert text.wrap(width) is None
+    assert text.text == expected if string else expected.encode()
+
+
+def test_wrap_height() -> None:
+    text = ImageText.Text("Text does not fit within height")
+    assert text.wrap(50, 25).text == " within height"
+    assert text.text == "Text does\nnot fit"
+
+    text = ImageText.Text("Text does not fit singlelongword")
+    assert text.wrap(50, 25).text == " singlelongword"
+    assert text.text == "Text does\nnot fit"
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 8bcf2d8ee06..dfdbb622d04 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -591,49 +591,49 @@ def getink(fill: _Ink | None) -> int:
                 else ink
             )
 
-        for xy, anchor, line in image_text._split(xy, anchor, align):
+        for line in image_text._split(xy, anchor, align):
 
             def draw_text(ink: int, stroke_width: float = 0) -> None:
                 mode = self.fontmode
                 if stroke_width == 0 and embedded_color:
                     mode = "RGBA"
-                coord = []
-                for i in range(2):
-                    coord.append(int(xy[i]))
-                start = (math.modf(xy[0])[0], math.modf(xy[1])[0])
+                x = int(line.x)
+                y = int(line.y)
+                start = (math.modf(line.x)[0], math.modf(line.y)[0])
                 try:
                     mask, offset = image_text.font.getmask2(  # type: ignore[union-attr,misc]
-                        line,
+                        line.text,
                         mode,
                         direction=direction,
                         features=features,
                         language=language,
                         stroke_width=stroke_width,
                         stroke_filled=True,
-                        anchor=anchor,
+                        anchor=line.anchor,
                         ink=ink,
                         start=start,
                         *args,
                         **kwargs,
                     )
-                    coord = [coord[0] + offset[0], coord[1] + offset[1]]
+                    x += offset[0]
+                    y += offset[1]
                 except AttributeError:
                     try:
                         mask = image_text.font.getmask(  # type: ignore[misc]
-                            line,
+                            line.text,
                             mode,
                             direction,
                             features,
                             language,
                             stroke_width,
-                            anchor,
+                            line.anchor,
                             ink,
                             start=start,
                             *args,
                             **kwargs,
                         )
                     except TypeError:
-                        mask = image_text.font.getmask(line)
+                        mask = image_text.font.getmask(line.text)
                 if mode == "RGBA":
                     # image_text.font.getmask2(mode="RGBA")
                     # returns color in RGB bands and mask in A
@@ -641,13 +641,12 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                     color, mask = mask, mask.getband(3)
                     ink_alpha = struct.pack("i", ink)[3]
                     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
                         )
                 else:
-                    self.draw.draw_bitmap(coord, mask, ink)
+                    self.draw.draw_bitmap((x, y), mask, ink)
 
             if stroke_ink is not None:
                 # Draw stroked text
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index 34c0336c8be..7cd5f957e75 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -1,11 +1,18 @@
 from __future__ import annotations
 
-from typing import cast
+from typing import NamedTuple, cast
 
 from . import ImageFont
 from ._typing import _Ink
 
 
+class _Line(NamedTuple):
+    x: float
+    y: float
+    anchor: str
+    text: str | bytes
+
+
 class Text:
     def __init__(
         self,
@@ -90,69 +97,140 @@ def _get_fontmode(self) -> str:
         else:
             return "L"
 
-    def wrap(self, width: int) -> None:
-        str_type = isinstance(self.text, str)
-        wrapped_lines = []
-        emptystring = "" if str_type else b""
+    def wrap(
+        self,
+        width: int,
+        height: int | None = None,
+    ) -> Text | None:
+        wrapped_lines: list[str] | list[bytes] = []
+        emptystring = "" if isinstance(self.text, str) else b""
+        newline = "\n" if isinstance(self.text, str) else b"\n"
         fontmode = self._get_fontmode()
-        for line in self.text.splitlines():
-            wrapped_line = emptystring
-            words = line.split()
-            while words:
-                word = words[0]
-
-                new_wrapped_line: str | bytes
-                if wrapped_line:
-                    if str_type:
-                        new_wrapped_line = (
-                            cast(str, wrapped_line) + " " + cast(str, word)
-                        )
-                    else:
-                        new_wrapped_line = (
-                            cast(bytes, wrapped_line) + b" " + cast(bytes, word)
-                        )
-                else:
-                    new_wrapped_line = word
-
-                def get_width(text) -> float:
-                    left, _, right, _ = self.font.getbbox(
-                        text,
-                        fontmode,
-                        self.direction,
-                        self.features,
-                        self.language,
-                        self.stroke_width,
-                    )
-                    return right - left
 
-                if get_width(new_wrapped_line) > width:
-                    if wrapped_line:
-                        wrapped_lines.append(wrapped_line)
-                        wrapped_line = emptystring
-                    else:
-                        # This word is too long for a single line, so split the word
-                        characters = word
-                        i = len(characters)
-                        while i > 1 and get_width(characters[:i]) > width:
-                            i -= 1
-                        wrapped_line = characters[:i]
-                        if str_type:
-                            cast(list[str], words)[0] = cast(str, characters[i:])
-                        else:
-                            cast(list[bytes], words)[0] = cast(bytes, characters[i:])
+        def getbbox(text) -> tuple[float, float]:
+            _, _, right, bottom = self.font.getbbox(
+                text,
+                fontmode,
+                self.direction,
+                self.features,
+                self.language,
+                self.stroke_width,
+            )
+            return right, bottom
+
+        wrapped_line = emptystring
+        word = emptystring
+        reached_end = False
+        remaining_position = 0
+
+        def join_text(a: str | bytes, b: str | bytes) -> str | bytes:
+            if isinstance(a, str):
+                return a + cast(str, b)
+            else:
+                return a + cast(bytes, b)
+
+        for i in range(len(self.text)):
+            last_character = i == len(self.text) - 1
+
+            def add_line() -> bool:
+                nonlocal wrapped_lines, remaining_position
+                lines = cast(
+                    list[str] | list[bytes], wrapped_lines + [wrapped_line.rstrip()]
+                )
+                if height is not None:
+                    last_line_y = self._split(lines=lines)[-1].y
+                    last_line_height = getbbox(wrapped_line)[1]
+                    if last_line_y + last_line_height > height:
+                        return False
+
+                wrapped_lines = lines
+                remaining_position = i - len(word)
+                if last_character:
+                    remaining_position += 1
+                return True
+
+            character = self.text[i : i + 1]
+            if last_character:
+                word = join_text(word, character)
+                character = newline
+            if character.isspace():
+                if not word or word.isspace():
+                    # Do not use whitespace until a non-whitespace character is reached
+                    # Trimming whitespace from the end of the line
+                    word = join_text(word, character)
                 else:
-                    words.pop(0)
-                    wrapped_line = new_wrapped_line
-            if wrapped_line:
-                wrapped_lines.append(wrapped_line)
-        if str_type:
-            self.text = "\n".join(
-                [line for line in wrapped_lines if isinstance(line, str)]
+                    # Append the word to the current line
+                    if not wrapped_line:
+                        word = word.lstrip()
+                    new_wrapped_line = join_text(wrapped_line, word)
+                    if getbbox(new_wrapped_line)[0] > width:
+
+                        def split_word():
+                            nonlocal wrapped_line, word, reached_end
+                            # This word is too long for a single line, so split the word
+                            j = len(word)
+                            while j > 1 and getbbox(word[:j])[0] > width:
+                                j -= 1
+                            wrapped_line = word[:j]
+                            if not add_line():
+                                reached_end = True
+                                return
+                            word = word[j:]
+                            wrapped_line = word
+                            if getbbox(wrapped_line)[0] > width:
+                                split_word()
+
+                        if wrapped_line:
+                            # This word does not fit on the line
+                            if not add_line():
+                                reached_end = True
+                                break
+                            word = word.lstrip()
+                            if getbbox(word)[0] > width:
+                                split_word()
+                            else:
+                                wrapped_line = word
+                        else:
+                            split_word()
+                        if reached_end:
+                            break
+                    else:
+                        # This word fits on the line
+                        wrapped_line = new_wrapped_line
+                        word = emptystring
+
+                    word = emptystring if character == newline else character
+
+            if character == newline:
+                if not add_line():
+                    break
+                wrapped_line = emptystring
+            elif not character.isspace():
+                # Word is not finished yet
+                word = join_text(word, character)
+
+        remaining_text = self.text[remaining_position:]
+        if remaining_text:
+            text = Text(
+                text=remaining_text,
+                font=self.font,
+                mode=self.mode,
+                spacing=self.spacing,
+                direction=self.direction,
+                features=self.features,
+                language=self.language,
             )
+            text.embedded_color = self.embedded_color
+            text.stroke_width = self.stroke_width
+            text.stroke_fill = self.stroke_fill
         else:
-            self.text = b"\n".join(
-                [line for line in wrapped_lines if isinstance(line, bytes)]
-            )
+            text = None
+
+        if isinstance(self.text, str):
+            self.text = "\n".join(cast(list[str], wrapped_lines))
+        else:
+            self.text = b"\n".join(cast(list[bytes], wrapped_lines))
+        return text
 
     def get_length(self) -> float:
         """
@@ -212,21 +290,26 @@ def get_length(self) -> float:
         )
 
     def _split(
-        self, xy: tuple[float, float], anchor: str | None, align: str
-    ) -> list[tuple[tuple[float, float], str, str | bytes]]:
+        self,
+        xy: tuple[float, float] = (0, 0),
+        anchor: str | None = None,
+        align: str = "left",
+        lines: list[str] | list[bytes] | None = None,
+    ) -> list[_Line]:
         if anchor is None:
             anchor = "lt" if self.direction == "ttb" else "la"
         elif len(anchor) != 2:
             msg = "anchor must be a 2 character string"
             raise ValueError(msg)
 
-        lines = (
-            self.text.split("\n")
-            if isinstance(self.text, str)
-            else self.text.split(b"\n")
-        )
+        if lines is None:
+            lines = (
+                self.text.split("\n")
+                if isinstance(self.text, str)
+                else self.text.split(b"\n")
+            )
         if len(lines) == 1:
-            return [(xy, anchor, self.text)]
+            return [_Line(xy[0], xy[1], anchor, lines[0])]
 
         if anchor[1] in "tb" and self.direction != "ttb":
             msg = "anchor not supported for multiline text"
@@ -251,7 +334,7 @@ def _split(
         if self.direction == "ttb":
             left = xy[0]
             for line in lines:
-                parts.append(((left, top), anchor, line))
+                parts.append(_Line(left, top, anchor, line))
                 left += line_spacing
         else:
             widths = []
@@ -314,7 +397,7 @@ def _split(
                         width_difference = max_width - sum(word_widths)
                         i = 0
                         for word in words:
-                            parts.append(((left, top), word_anchor, word))
+                            parts.append(_Line(left, top, word_anchor, word))
                             left += word_widths[i] + width_difference / (len(words) - 1)
                             i += 1
                         top += line_spacing
@@ -325,7 +408,7 @@ def _split(
                     left -= width_difference / 2.0
                 elif anchor[0] == "r":
                     left -= width_difference
-                parts.append(((left, top), anchor, line))
+                parts.append(_Line(left, top, anchor, line))
                 top += line_spacing
 
         return parts
@@ -356,9 +439,9 @@ def get_bbox(
         """
         bbox: tuple[float, float, float, float] | None = None
         fontmode = self._get_fontmode()
-        for xy, anchor, line in self._split(xy, anchor, align):
+        for x, y, anchor, text in self._split(xy, anchor, align):
             bbox_line = self.font.getbbox(
-                line,
+                text,
                 fontmode,
                 self.direction,
                 self.features,
@@ -367,10 +450,10 @@ def get_bbox(
                 anchor,
             )
             bbox_line = (
-                bbox_line[0] + xy[0],
-                bbox_line[1] + xy[1],
-                bbox_line[2] + xy[0],
-                bbox_line[3] + xy[1],
+                bbox_line[0] + x,
+                bbox_line[1] + y,
+                bbox_line[2] + x,
+                bbox_line[3] + y,
             )
             if bbox is None:
                 bbox = bbox_line

From 4b2d4811e18516469793210e41080d21bf5d33c6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 5 Nov 2025 20:30:16 +1100
Subject: [PATCH 2171/2374] Added scaling argument to wrap()

---
 Tests/test_imagetext.py | 113 ++++++++++++++--
 src/PIL/ImageDraw.py    |   2 +-
 src/PIL/ImageText.py    | 290 ++++++++++++++++++++++------------------
 3 files changed, 262 insertions(+), 143 deletions(-)

diff --git a/Tests/test_imagetext.py b/Tests/test_imagetext.py
index 9b3c711f4a1..507d8240918 100644
--- a/Tests/test_imagetext.py
+++ b/Tests/test_imagetext.py
@@ -111,27 +111,120 @@ def test_stroke() -> None:
 
 
 @pytest.mark.parametrize(
-    "text, width, expected",
+    "data, width, expected",
     (
         ("Hello World!", 100, "Hello World!"),  # No wrap required
         ("Hello World!", 50, "Hello\nWorld!"),  # Wrap word to a new line
-        ("Hello World!", 25, "Hello\nWorl\nd!"),  # Split word across lines
         # Keep multiple spaces within a line
-        ("Keep  multiple spaces", 75, "Keep  multiple\nspaces"),
+        ("Keep  multiple spaces", 90, "Keep  multiple\nspaces"),
+        (" Keep\n leading space", 100, " Keep\n leading space"),
     ),
 )
 @pytest.mark.parametrize("string", (True, False))
-def test_wrap(text: str, width: int, expected: str, string: bool) -> None:
-    text = ImageText.Text(text if string else text.encode())
-    assert text.wrap(width) is None
-    assert text.text == expected if string else expected.encode()
+def test_wrap(data: str, width: int, expected: str, string: bool) -> None:
+    if string:
+        text = ImageText.Text(data)
+        assert text.wrap(width) is None
+        assert text.text == expected
+    else:
+        text_bytes = ImageText.Text(data.encode())
+        assert text_bytes.wrap(width) is None
+        assert text_bytes.text == expected.encode()
+
+
+def test_wrap_long_word() -> None:
+    text = ImageText.Text("Hello World!")
+    with pytest.raises(ValueError, match="Word does not fit within line"):
+        text.wrap(25)
+
+
+def test_wrap_unsupported(font: ImageFont.FreeTypeFont) -> None:
+    transposed_font = ImageFont.TransposedFont(font)
+    text = ImageText.Text("Hello World!", transposed_font)
+    with pytest.raises(ValueError, match="TransposedFont not supported"):
+        text.wrap(50)
+
+    text = ImageText.Text("Hello World!", direction="ttb")
+    with pytest.raises(ValueError, match="Only ltr direction supported"):
+        text.wrap(50)
 
 
 def test_wrap_height() -> None:
+    width = 50 if features.check_module("freetype2") else 60
     text = ImageText.Text("Text does not fit within height")
-    assert text.wrap(50, 25).text == " within height"
+    wrapped = text.wrap(width, 25 if features.check_module("freetype2") else 40)
+    assert wrapped is not None
+    assert wrapped.text == " within height"
     assert text.text == "Text does\nnot fit"
 
-    text = ImageText.Text("Text does not fit singlelongword")
-    assert text.wrap(50, 25).text == " singlelongword"
+    text = ImageText.Text("Text does not fit\nwithin height")
+    wrapped = text.wrap(width, 20)
+    assert wrapped is not None
+    assert wrapped.text == " not fit\nwithin height"
+    assert text.text == "Text does"
+
+    text = ImageText.Text("Text does not fit\n\nwithin height")
+    wrapped = text.wrap(width, 25 if features.check_module("freetype2") else 40)
+    assert wrapped is not None
+    assert wrapped.text == "\nwithin height"
     assert text.text == "Text does\nnot fit"
+
+
+def test_wrap_scaling_unsupported() -> None:
+    font = ImageFont.load_default_imagefont()
+    text = ImageText.Text("Hello World!", font)
+    with pytest.raises(ValueError, match="'scaling' only supports FreeTypeFont"):
+        text.wrap(50, scaling="shrink")
+
+    if features.check_module("freetype2"):
+        text = ImageText.Text("Hello World!")
+        with pytest.raises(ValueError, match="'scaling' requires 'height'"):
+            text.wrap(50, scaling="shrink")
+
+
+@skip_unless_feature("freetype2")
+def test_wrap_shrink() -> None:
+    # No scaling required
+    text = ImageText.Text("Hello World!")
+    assert isinstance(text.font, ImageFont.FreeTypeFont)
+    assert text.font.size == 10
+    assert text.wrap(50, 50, "shrink") is None
+    assert isinstance(text.font, ImageFont.FreeTypeFont)
+    assert text.font.size == 10
+
+    with pytest.raises(ValueError, match="Text could not be scaled"):
+        text.wrap(50, 15, ("shrink", 9))
+
+    assert text.wrap(50, 15, "shrink") is None
+    assert text.font.size == 8
+
+    text = ImageText.Text("Hello World!")
+    assert text.wrap(50, 15, ("shrink", 7)) is None
+    assert isinstance(text.font, ImageFont.FreeTypeFont)
+    assert text.font.size == 8
+
+
+@skip_unless_feature("freetype2")
+def test_wrap_grow() -> None:
+    # No scaling required
+    text = ImageText.Text("Hello World!")
+    assert isinstance(text.font, ImageFont.FreeTypeFont)
+    assert text.font.size == 10
+    assert text.wrap(58, 10, "grow") is None
+    assert isinstance(text.font, ImageFont.FreeTypeFont)
+    assert text.font.size == 10
+
+    with pytest.raises(ValueError, match="Text could not be scaled"):
+        text.wrap(50, 50, ("grow", 12))
+
+    assert text.wrap(50, 50, "grow") is None
+    assert text.font.size == 16
+
+    text = ImageText.Text("A\nB")
+    with pytest.raises(ValueError, match="Text could not be scaled"):
+        text.wrap(50, 10, "grow")
+
+    text = ImageText.Text("Hello World!")
+    assert text.wrap(50, 50, ("grow", 18)) is None
+    assert isinstance(text.font, ImageFont.FreeTypeFont)
+    assert text.font.size == 16
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index dfdbb622d04..07fa43b0687 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -538,7 +538,7 @@ def draw_corners(pieslice: bool) -> None:
     def text(
         self,
         xy: tuple[float, float],
-        text: AnyStr | ImageText.Text,
+        text: AnyStr | ImageText.Text[AnyStr],
         fill: _Ink | None = None,
         font: (
             ImageFont.ImageFont
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index 7cd5f957e75..723ab9f8c1c 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -1,10 +1,14 @@
 from __future__ import annotations
 
-from typing import NamedTuple, cast
+import math
+import re
+from typing import AnyStr, Generic, NamedTuple
 
 from . import ImageFont
 from ._typing import _Ink
 
+Font = ImageFont.ImageFont | ImageFont.FreeTypeFont | ImageFont.TransposedFont
+
 
 class _Line(NamedTuple):
     x: float
@@ -13,16 +17,87 @@ class _Line(NamedTuple):
     text: str | bytes
 
 
-class Text:
+class _Wrap(Generic[AnyStr]):
+    lines: list[AnyStr] = []
+    position = 0
+    offset = 0
+
     def __init__(
         self,
-        text: str | bytes,
-        font: (
-            ImageFont.ImageFont
-            | ImageFont.FreeTypeFont
-            | ImageFont.TransposedFont
-            | None
-        ) = None,
+        text: Text[AnyStr],
+        width: int,
+        height: int | None = None,
+        font: Font | None = None,
+    ) -> None:
+        self.text: Text[AnyStr] = text
+        self.width = width
+        self.height = height
+        self.font = font
+
+        input_text = self.text.text
+        emptystring = "" if isinstance(input_text, str) else b""
+        line = emptystring
+
+        for word in re.findall(
+            r"\s*\S+" if isinstance(input_text, str) else rb"\s*\S+", input_text
+        ):
+            newlines = re.findall(
+                r"[^\S\n]*\n" if isinstance(input_text, str) else rb"[^\S\n]*\n", word
+            )
+            if newlines:
+                if not self.add_line(line):
+                    break
+                for i, line in enumerate(newlines):
+                    if i != 0 and not self.add_line(emptystring):
+                        break
+                    self.position += len(line)
+                    word = word[len(line) :]
+                line = emptystring
+
+            new_line = line + word
+            if self.text._get_bbox(new_line, self.font)[2] <= width:
+                # This word fits on the line
+                line = new_line
+                continue
+
+            # This word does not fit on the line
+            if line and not self.add_line(line):
+                break
+
+            original_length = len(word)
+            word = word.lstrip()
+            self.offset = original_length - len(word)
+
+            if self.text._get_bbox(word, self.font)[2] > width:
+                if font is None:
+                    msg = "Word does not fit within line"
+                    raise ValueError(msg)
+                break
+            line = word
+        else:
+            if line:
+                self.add_line(line)
+        self.remaining_text: AnyStr = input_text[self.position :]
+
+    def add_line(self, line: AnyStr) -> bool:
+        lines = self.lines + [line]
+        if self.height is not None:
+            last_line_y = self.text._split(lines=lines)[-1].y
+            last_line_height = self.text._get_bbox(line, self.font)[3]
+            if last_line_y + last_line_height > self.height:
+                return False
+
+        self.lines = lines
+        self.position += len(line) + self.offset
+        self.offset = 0
+        return True
+
+
+class Text(Generic[AnyStr]):
+    def __init__(
+        self,
+        text: AnyStr,
+        font: Font | None = None,
         mode: str = "RGB",
         spacing: float = 4,
         direction: str | None = None,
@@ -56,7 +131,7 @@ def __init__(
                          It should be a `BCP 47 language code`_.
                          Requires libraqm.
         """
-        self.text = text
+        self.text: AnyStr = text
         self.font = font or ImageFont.load_default()
 
         self.mode = mode
@@ -101,118 +176,67 @@ def wrap(
         self,
         width: int,
         height: int | None = None,
-    ) -> Text | None:
-        wrapped_lines: list[str] | list[bytes] = []
-        emptystring = "" if isinstance(self.text, str) else b""
-        newline = "\n" if isinstance(self.text, str) else b"\n"
-        fontmode = self._get_fontmode()
-
-        def getbbox(text) -> tuple[float, float]:
-            _, _, right, bottom = self.font.getbbox(
-                text,
-                fontmode,
-                self.direction,
-                self.features,
-                self.language,
-                self.stroke_width,
-            )
-            return right, bottom
-
-        wrapped_line = emptystring
-        word = emptystring
-        reached_end = False
-        remaining_position = 0
+        scaling: str | tuple[str, int] | None = None,
+    ) -> Text[AnyStr] | None:
+        if isinstance(self.font, ImageFont.TransposedFont):
+            msg = "TransposedFont not supported"
+            raise ValueError(msg)
+        if self.direction not in (None, "ltr"):
+            msg = "Only ltr direction supported"
+            raise ValueError(msg)
 
-        def join_text(a: str | bytes, b: str | bytes) -> str | bytes:
-            if isinstance(a, str):
-                return a + cast(str, b)
+        if scaling is None:
+            wrap = _Wrap(self, width, height)
+        else:
+            if not isinstance(self.font, ImageFont.FreeTypeFont):
+                msg = "'scaling' only supports FreeTypeFont"
+                raise ValueError(msg)
+            if height is None:
+                msg = "'scaling' requires 'height'"
+                raise ValueError(msg)
+
+            if isinstance(scaling, str):
+                limit = 1
             else:
-                return a + cast(bytes, b)
-
-        for i in range(len(self.text)):
-            last_character = i == len(self.text) - 1
-
-            def add_line() -> bool:
-                nonlocal wrapped_lines, remaining_position
-                lines = cast(
-                    list[str] | list[bytes], wrapped_lines + [wrapped_line.rstrip()]
-                )
-                if height is not None:
-                    last_line_y = self._split(lines=lines)[-1].y
-                    last_line_height = getbbox(wrapped_line)[1]
-                    if last_line_y + last_line_height > height:
-                        return False
-
-                wrapped_lines = lines
-                remaining_position = i - len(word)
-                if last_character:
-                    remaining_position += 1
-                return True
-
-            character = self.text[i : i + 1]
-            if last_character:
-                word = join_text(word, character)
-                character = newline
-            if character.isspace():
-                if not word or word.isspace():
-                    # Do not use whitespace until a non-whitespace character is reached
-                    # Trimming whitespace from the end of the line
-                    word = join_text(word, character)
-                else:
-                    # Append the word to the current line
-                    if not wrapped_line:
-                        word = word.lstrip()
-                    new_wrapped_line = join_text(wrapped_line, word)
-                    if getbbox(new_wrapped_line)[0] > width:
-
-                        def split_word():
-                            nonlocal wrapped_line, word, reached_end
-                            # This word is too long for a single line, so split the word
-                            j = len(word)
-                            while j > 1 and getbbox(word[:j])[0] > width:
-                                j -= 1
-                            wrapped_line = word[:j]
-                            if not add_line():
-                                reached_end = True
-                                return
-                            word = word[j:]
-                            wrapped_line = word
-                            if getbbox(wrapped_line)[0] > width:
-                                split_word()
-
-                        if wrapped_line:
-                            # This word does not fit on the line
-                            if not add_line():
-                                reached_end = True
-                                break
-                            word = word.lstrip()
-                            if getbbox(word)[0] > width:
-                                split_word()
-                            else:
-                                wrapped_line = word
-                        else:
-                            split_word()
-                        if reached_end:
-                            break
-                    else:
-                        # This word fits on the line
-                        wrapped_line = new_wrapped_line
-                        word = emptystring
-
-                    word = emptystring if character == newline else character
-
-            if character == newline:
-                if not add_line():
-                    break
-                wrapped_line = emptystring
-            elif not character.isspace():
-                # Word is not finished yet
-                word = join_text(word, character)
+                scaling, limit = scaling
+
+            font = self.font
+            wrap = _Wrap(self, width, height, font)
+            if scaling == "shrink":
+                if not wrap.remaining_text:
+                    return None
+
+                size = math.ceil(font.size)
+                while wrap.remaining_text:
+                    if size == max(limit, 1):
+                        msg = "Text could not be scaled"
+                        raise ValueError(msg)
+                    size -= 1
+                    font = self.font.font_variant(size=size)
+                    wrap = _Wrap(self, width, height, font)
+                self.font = font
+            else:
+                if wrap.remaining_text:
+                    msg = "Text could not be scaled"
+                    raise ValueError(msg)
 
-        remaining_text = self.text[remaining_position:]
-        if remaining_text:
+                size = math.floor(font.size)
+                while not wrap.remaining_text:
+                    if size == limit:
+                        msg = "Text could not be scaled"
+                        raise ValueError(msg)
+                    size += 1
+                    font = self.font.font_variant(size=size)
+                    last_wrap = wrap
+                    wrap = _Wrap(self, width, height, font)
+                size -= 1
+                if size != self.font.size:
+                    self.font = self.font.font_variant(size=size)
+                wrap = last_wrap
+
+        if wrap.remaining_text:
             text = Text(
-                text=remaining_text,
+                text=wrap.remaining_text,
                 font=self.font,
                 mode=self.mode,
                 spacing=self.spacing,
@@ -226,10 +250,8 @@ def split_word():
         else:
             text = None
 
-        if isinstance(self.text, str):
-            self.text = "\n".join(cast(list[str], wrapped_lines))
-        else:
-            self.text = b"\n".join(cast(list[bytes], wrapped_lines))
+        newline = "\n" if isinstance(self.text, str) else b"\n"
+        self.text = newline.join(wrap.lines)
         return text
 
     def get_length(self) -> float:
@@ -413,6 +435,19 @@ def _split(
 
         return parts
 
+    def _get_bbox(
+        self, text: str | bytes, font: Font | None = None, anchor: str | None = None
+    ) -> tuple[float, float, float, float]:
+        return (font or self.font).getbbox(
+            text,
+            self._get_fontmode(),
+            self.direction,
+            self.features,
+            self.language,
+            self.stroke_width,
+            anchor,
+        )
+
     def get_bbox(
         self,
         xy: tuple[float, float] = (0, 0),
@@ -438,17 +473,8 @@ def get_bbox(
         :return: ``(left, top, right, bottom)`` bounding box
         """
         bbox: tuple[float, float, float, float] | None = None
-        fontmode = self._get_fontmode()
         for x, y, anchor, text in self._split(xy, anchor, align):
-            bbox_line = self.font.getbbox(
-                text,
-                fontmode,
-                self.direction,
-                self.features,
-                self.language,
-                self.stroke_width,
-                anchor,
-            )
+            bbox_line = self._get_bbox(text, anchor=anchor)
             bbox_line = (
                 bbox_line[0] + x,
                 bbox_line[1] + y,

From b3da65df94ba1902502b59e9b70b15d535ccd902 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 11 Dec 2025 10:53:04 +1100
Subject: [PATCH 2172/2374] Updated libjpeg-turbo to 3.1.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 b246d925511..b4d7ca45fa7 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -97,7 +97,7 @@ else
 fi
 HARFBUZZ_VERSION=12.2.0
 LIBPNG_VERSION=1.6.53
-JPEGTURBO_VERSION=3.1.2
+JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.1
 ZSTD_VERSION=1.5.7
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index c42a1fcf518..12960330d48 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ def cmd_msbuild(
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "12.2.0",
-    "JPEGTURBO": "3.1.2",
+    "JPEGTURBO": "3.1.3",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.4.1",

From 11d599c798da46a84669a3f7e5b25dc3ebafb45e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 11 Dec 2025 18:20:58 +1100
Subject: [PATCH 2173/2374] Added documentation

---
 docs/releasenotes/12.1.0.rst | 25 +++++++++++++++++++++++++
 src/PIL/ImageText.py         | 13 +++++++++++++
 2 files changed, 38 insertions(+)

diff --git a/docs/releasenotes/12.1.0.rst b/docs/releasenotes/12.1.0.rst
index b6e1810c60a..5c363e2397c 100644
--- a/docs/releasenotes/12.1.0.rst
+++ b/docs/releasenotes/12.1.0.rst
@@ -41,6 +41,31 @@ TODO
 API additions
 =============
 
+ImageText.Text.wrap
+^^^^^^^^^^^^^^^^^^^
+
+:py:meth:`.ImageText.Text.wrap` has been added, to wrap text to fit within a given
+width::
+
+    from PIL import ImageText
+    text = ImageText.Text("Hello World!")
+    text.wrap(50)
+    print(text.text)  # "Hello\nWorld!"
+
+or within a certain width and height, returning a new :py:class:`.ImageText.Text`
+instance if the text does not fit::
+
+    text = ImageText.Text("Text does not fit within height")
+    print(text.wrap(50, 25).text == " within height")
+    print(text.text)  # "Text does\nnot fit"
+
+or scaling, optionally with a font size limit::
+
+    text.wrap(50, 15, "shrink")
+    text.wrap(50, 15, ("shrink", 7))
+    text.wrap(58, 10, "grow")
+    text.wrap(50, 50, ("grow", 12))
+
 Specify window in ImageGrab on macOS
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/ImageText.py b/src/PIL/ImageText.py
index 723ab9f8c1c..008d20d38e1 100644
--- a/src/PIL/ImageText.py
+++ b/src/PIL/ImageText.py
@@ -178,6 +178,19 @@ def wrap(
         height: int | None = None,
         scaling: str | tuple[str, int] | None = None,
     ) -> Text[AnyStr] | None:
+        """
+        Wrap text to fit within a given width.
+
+        :param width: The width to fit within.
+        :param height: An optional height limit. Any text that does not fit within this
+                       will be returned as a new :py:class:`.Text` object.
+        :param scaling: An optional directive to scale the text, either "grow" as much
+                        as possible within the given dimensions, or "shrink" until it
+                        fits. It can also be a tuple of (direction, limit), with an
+                        integer limit to stop scaling at.
+
+        :returns: An :py:class:`.Text` object, or None.
+        """
         if isinstance(self.font, ImageFont.TransposedFont):
             msg = "TransposedFont not supported"
             raise ValueError(msg)

From 79ae888d4574333ca666696453870dcc2bb7a8c3 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 11 Dec 2025 09:29:54 +0200
Subject: [PATCH 2174/2374] Docs: update major bump cadence

---
 docs/releasenotes/index.rst      | 2 +-
 docs/releasenotes/versioning.rst | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index b097770a3f8..4b25bb6a2d1 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
 
+  versioning
   12.1.0
   12.0.0
   11.3.0
@@ -80,4 +81,3 @@ expected to be backported to earlier versions.
   2.5.2
   2.3.2
   2.3.1
-  versioning
diff --git a/docs/releasenotes/versioning.rst b/docs/releasenotes/versioning.rst
index 2a0af9e59ec..884102d16f7 100644
--- a/docs/releasenotes/versioning.rst
+++ b/docs/releasenotes/versioning.rst
@@ -17,8 +17,8 @@ prior three months.
 
 A quarterly release bumps the MAJOR version when incompatible API changes are
 made, such as removing deprecated APIs or dropping an EOL Python version. In practice,
-these occur every 12-18 months, guided by
-`Python's EOL schedule <https://devguide.python.org/#status-of-python-branches>`_, and
+these occur every October, guided by
+`Python's EOL schedule <https://devguide.python.org/versions/>`__, and
 any APIs that have been deprecated for at least a year are removed at the same time.
 
 PATCH versions ("`Point Release <https://github.com/python-pillow/Pillow/blob/main/RELEASING.md#user-content-point-release>`_"

From 6a769da21bc6e58e09f849e647920c51a5a82cd7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 11 Dec 2025 23:27:29 +1100
Subject: [PATCH 2175/2374] Corrected variable type

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

diff --git a/Tests/test_file_iptc.py b/Tests/test_file_iptc.py
index 9e2d8c06da1..3eb5cde8e50 100644
--- a/Tests/test_file_iptc.py
+++ b/Tests/test_file_iptc.py
@@ -6,7 +6,7 @@
 
 from PIL import Image, IptcImagePlugin, TiffImagePlugin, TiffTags
 
-from .helper import assert_image_equal, hopper
+from .helper import assert_image_equal
 
 TEST_FILE = "Tests/images/iptc.jpg"
 
@@ -85,7 +85,7 @@ def test_getiptcinfo() -> None:
 
 def test_getiptcinfo_jpg_none() -> None:
     # Arrange
-    with hopper() as im:
+    with Image.open("Tests/images/hopper.jpg") as im:
         # Act
         iptc = IptcImagePlugin.getiptcinfo(im)
 

From 6bf4313a68cd4d4e6ba4b4cf87c8d4e97e6ac278 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 18 Dec 2025 07:44:40 +1100
Subject: [PATCH 2176/2374] Updated xz to 5.8.2

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index b4d7ca45fa7..e1477634d35 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -99,7 +99,7 @@ HARFBUZZ_VERSION=12.2.0
 LIBPNG_VERSION=1.6.53
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
-XZ_VERSION=5.8.1
+XZ_VERSION=5.8.2
 ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.1
 LCMS2_VERSION=2.17
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 12960330d48..30fe26d1415 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -125,7 +125,7 @@ def cmd_msbuild(
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",
-    "XZ": "5.8.1",
+    "XZ": "5.8.2",
     "ZLIBNG": "2.3.2",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
@@ -183,11 +183,7 @@ def cmd_msbuild(
         "filename": f"xz-{V['XZ']}.tar.gz",
         "license": "COPYING",
         "build": [
-            *cmds_cmake(
-                "liblzma",
-                "-DBUILD_SHARED_LIBS:BOOL=OFF"
-                + (" -DXZ_CLMUL_CRC:BOOL=OFF" if struct.calcsize("P") == 4 else ""),
-            ),
+            *cmds_cmake("liblzma", "-DBUILD_SHARED_LIBS:BOOL=OFF"),
             cmd_mkdir(r"{inc_dir}\lzma"),
             cmd_copy(r"src\liblzma\api\lzma\*.h", r"{inc_dir}\lzma"),
         ],

From 6df6cd448069ac09bafc360b6f7a470773c74707 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 20 Dec 2025 23:51:05 +1100
Subject: [PATCH 2177/2374] Pin docutils to 0.21 (#9344)

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

diff --git a/pyproject.toml b/pyproject.toml
index f4514925d1c..f2262080598 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -42,6 +42,7 @@ dynamic = [
   "version",
 ]
 optional-dependencies.docs = [
+  "docutils==0.21",      # Pending https://github.com/pradyunsg/sphinx-inline-tabs/pull/51
   "furo",
   "olefile",
   "sphinx>=8.2",

From 9d3555c37e888a419105ec177ebb6d8aaebf306f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 21 Dec 2025 22:39:19 +1100
Subject: [PATCH 2178/2374] Test Windows Server 2022

---
 .github/workflows/test-windows.yml     | 5 +++--
 docs/installation/platform-support.rst | 4 ++--
 winbuild/README.md                     | 3 ++-
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 3450de35556..7afafe07c91 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -31,15 +31,16 @@ env:
 
 jobs:
   build:
-    runs-on: windows-latest
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         python-version: ["pypy3.11", "3.11", "3.12", "3.13", "3.14", "3.15"]
         architecture: ["x64"]
+        os: ["windows-latest"]
         include:
             # Test the oldest Python on 32-bit
-            - { python-version: "3.10", architecture: "x86" }
+            - { python-version: "3.10", architecture: "x86", os: "windows-2022" }
 
     timeout-minutes: 45
 
diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 17e38719a93..ee70d84019a 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -53,8 +53,8 @@ These platforms are built and tested for every change.
 |                                  |                            | s390x               |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2022              | 3.10                       | x86                 |
-|                                  +----------------------------+---------------------+
-|                                  | 3.11, 3.12, 3.13, 3.14,    | x86-64              |
++----------------------------------+----------------------------+---------------------+
+| Windows Server 2025              | 3.11, 3.12, 3.13, 3.14,    | x86-64              |
 |                                  | PyPy3                      |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12 (MinGW)               | x86-64              |
diff --git a/winbuild/README.md b/winbuild/README.md
index db71f094e0e..b1c9262c2e4 100644
--- a/winbuild/README.md
+++ b/winbuild/README.md
@@ -11,7 +11,8 @@ 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 2022 with Visual Studio 2022 Enterprise (GitHub Actions).
+* Tested on Windows Server 2025 and 2022 with Visual Studio 2022 Enterprise (GitHub
+  Actions).
 
 Here's an example script to build on Windows:
 

From 9dd756f9fe574ab2b3c97585f299600582551310 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 22 Dec 2025 09:33:28 +1100
Subject: [PATCH 2179/2374] Revert "Pin docutils to 0.21 (#9344)"

This reverts commit 6df6cd448069ac09bafc360b6f7a470773c74707.
---
 pyproject.toml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index f2262080598..f4514925d1c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -42,7 +42,6 @@ dynamic = [
   "version",
 ]
 optional-dependencies.docs = [
-  "docutils==0.21",      # Pending https://github.com/pradyunsg/sphinx-inline-tabs/pull/51
   "furo",
   "olefile",
   "sphinx>=8.2",

From ca21683316a96b348197a6f5ca97ea9c6c142bb0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 22 Dec 2025 18:12:10 +1100
Subject: [PATCH 2180/2374] Cast to UINT32 before shifting bits (#9347)

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

diff --git a/src/libImaging/BcnDecode.c b/src/libImaging/BcnDecode.c
index ac81ed6df3d..d99b0e28e8a 100644
--- a/src/libImaging/BcnDecode.c
+++ b/src/libImaging/BcnDecode.c
@@ -663,7 +663,7 @@ half_to_float(UINT16 h) {
     if (o.f >= m.f) {
         o.u |= 255 << 23;
     }
-    o.u |= (h & 0x8000) << 16;
+    o.u |= (UINT32)(h & 0x8000) << 16;
     return o.f;
 }
 

From 9b7200d2b439a4a41411e074e0d6cc453a8e3e57 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 23 Dec 2025 12:50:26 +1100
Subject: [PATCH 2181/2374] Allow 1 mode images in MorphOp get_on_pixels()

---
 Tests/test_imagemorph.py | 9 +++++----
 src/PIL/ImageMorph.py    | 6 +++---
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index ca192a809c4..59d1b0645ef 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -188,9 +188,10 @@ def test_corner() -> None:
     assert len(coords) == 4
     assert tuple(coords) == ((2, 2), (4, 2), (2, 4), (4, 4))
 
-    coords = mop.get_on_pixels(Aout)
-    assert len(coords) == 4
-    assert tuple(coords) == ((2, 2), (4, 2), (2, 4), (4, 4))
+    for image in (Aout, Aout.convert("1")):
+        coords = mop.get_on_pixels(image)
+        assert len(coords) == 4
+        assert tuple(coords) == ((2, 2), (4, 2), (2, 4), (4, 4))
 
 
 def test_mirroring() -> None:
@@ -239,7 +240,7 @@ def test_incorrect_mode() -> None:
         mop.apply(im)
     with pytest.raises(ValueError, match="Image mode must be L"):
         mop.match(im)
-    with pytest.raises(ValueError, match="Image mode must be L"):
+    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
         mop.get_on_pixels(im)
 
 
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index bd70aff7b48..d6d0f829658 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -232,13 +232,13 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         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
+        """Get a list of all turned on pixels in a 1 or L mode image.
 
         Returns a list of tuples of (x,y) coordinates
         of all matching pixels. See :ref:`coordinate-system`."""
 
-        if image.mode != "L":
-            msg = "Image mode must be L"
+        if image.mode not in ("1", "L"):
+            msg = "Image mode must be 1 or L"
             raise ValueError(msg)
         return _imagingmorph.get_on_pixels(image.getim())
 

From a7047114040f38314a970d271d967cc17004c5e1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 23 Dec 2025 14:13:51 +1100
Subject: [PATCH 2182/2374] Allow 1 mode images in apply() and match()

---
 Tests/images/morph_a.png | Bin 83 -> 79 bytes
 Tests/test_imagemorph.py |  38 ++++++++++++++++++--------------------
 src/PIL/ImageMorph.py    |   8 ++++----
 3 files changed, 22 insertions(+), 24 deletions(-)

diff --git a/Tests/images/morph_a.png b/Tests/images/morph_a.png
index 19f6b777ffe17d924b984ba4ae4679257f01d31f..035fbc4bb84d6b67ee99cd6bbb5e8996059dd142 100644
GIT binary patch
delta 60
zcmWIcpCDn*$N&UyG_&e}l$fWBV@SoE<OCqtkdOp~K)}Gjq{LurZ+Ns5q|(#X&t;uc
GLK6Vv!Vq)-

delta 64
zcmeYdo*-e(!2kpgEjjpsl$587V@SoE<OB!S9v&Vb`Y$<SL5&*Q8wLiY%ZzOATJ&5%
Osy$u(T-G@yGywqoVi6Sp

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index 59d1b0645ef..edfb52acae2 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -15,13 +15,10 @@ def string_to_img(image_string: str) -> Image.Image:
     rows = [s for s in image_string.replace(" ", "").split("\n") if len(s)]
     height = len(rows)
     width = len(rows[0])
-    im = Image.new("L", (width, height))
-    for i in range(width):
-        for j in range(height):
-            c = rows[j][i]
-            v = c in "X1"
-            im.putpixel((i, j), v)
-
+    im = Image.new("1", (width, height))
+    for x in range(width):
+        for y in range(height):
+            im.putpixel((x, y), rows[y][x] in "X1")
     return im
 
 
@@ -42,10 +39,10 @@ def img_to_string(im: Image.Image) -> str:
     """Turn a (small) binary image into a string representation"""
     chars = ".1"
     result = []
-    for r in range(im.height):
+    for y in range(im.height):
         line = ""
-        for c in range(im.width):
-            value = im.getpixel((c, r))
+        for x in range(im.width):
+            value = im.getpixel((x, y))
             assert not isinstance(value, tuple)
             assert value is not None
             line += chars[value > 0]
@@ -165,10 +162,12 @@ def test_edge() -> None:
     )
 
 
-def test_corner() -> None:
+@pytest.mark.parametrize("mode", ("1", "L"))
+def test_corner(mode: str) -> None:
     # Create a corner detector pattern
     mop = ImageMorph.MorphOp(patterns=["1:(... ... ...)->0", "4:(00. 01. ...)->1"])
-    count, Aout = mop.apply(A)
+    image = A.convert(mode) if mode == "L" else A
+    count, Aout = mop.apply(image)
     assert count == 5
     assert_img_equal_img_string(
         Aout,
@@ -184,14 +183,13 @@ def test_corner() -> None:
     )
 
     # Test the coordinate counting with the same operator
-    coords = mop.match(A)
+    coords = mop.match(image)
     assert len(coords) == 4
     assert tuple(coords) == ((2, 2), (4, 2), (2, 4), (4, 4))
 
-    for image in (Aout, Aout.convert("1")):
-        coords = mop.get_on_pixels(image)
-        assert len(coords) == 4
-        assert tuple(coords) == ((2, 2), (4, 2), (2, 4), (4, 4))
+    coords = mop.get_on_pixels(Aout)
+    assert len(coords) == 4
+    assert tuple(coords) == ((2, 2), (4, 2), (2, 4), (4, 4))
 
 
 def test_mirroring() -> None:
@@ -233,12 +231,12 @@ def test_negate() -> None:
 
 
 def test_incorrect_mode() -> None:
-    im = hopper("RGB")
+    im = hopper()
     mop = ImageMorph.MorphOp(op_name="erosion8")
 
-    with pytest.raises(ValueError, match="Image mode must be L"):
+    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
         mop.apply(im)
-    with pytest.raises(ValueError, match="Image mode must be L"):
+    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
         mop.match(im)
     with pytest.raises(ValueError, match="Image mode must be 1 or L"):
         mop.get_on_pixels(im)
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index d6d0f829658..69b0d170061 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -209,8 +209,8 @@ def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
             msg = "No operator loaded"
             raise Exception(msg)
 
-        if image.mode != "L":
-            msg = "Image mode must be L"
+        if image.mode not in ("1", "L"):
+            msg = "Image mode must be 1 or L"
             raise ValueError(msg)
         outimage = Image.new(image.mode, image.size, None)
         count = _imagingmorph.apply(bytes(self.lut), image.getim(), outimage.getim())
@@ -226,8 +226,8 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
             msg = "No operator loaded"
             raise Exception(msg)
 
-        if image.mode != "L":
-            msg = "Image mode must be L"
+        if image.mode not in ("1", "L"):
+            msg = "Image mode must be 1 or L"
             raise ValueError(msg)
         return _imagingmorph.match(bytes(self.lut), image.getim())
 

From e85700fe483f014ffcbaf91e81456a78f6303337 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 28 Dec 2025 00:54:10 +1100
Subject: [PATCH 2183/2374] Test PyQt6 on Python 3.14 on Windows (#9353)

---
 .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 7afafe07c91..e864763da21 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -84,7 +84,7 @@ jobs:
         python3 -m pip install --upgrade pip
 
     - name: Install CPython dependencies
-      if: "!contains(matrix.python-version, 'pypy') && !contains(matrix.python-version, '3.14') && matrix.architecture != 'x86'"
+      if: "!contains(matrix.python-version, 'pypy') && matrix.architecture != 'x86'"
       run: |
         python3 -m pip install PyQt6
 

From 4be5b8a2fb0aad9777dc00db9ae353605e745129 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sun, 28 Dec 2025 07:34:57 +1100
Subject: [PATCH 2184/2374] Use unsigned long for DWORD (#9352)

---
 src/libImaging/FliDecode.c | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/libImaging/FliDecode.c b/src/libImaging/FliDecode.c
index 44994823e5d..9b494dfa2ca 100644
--- a/src/libImaging/FliDecode.c
+++ b/src/libImaging/FliDecode.c
@@ -18,9 +18,9 @@
 
 #define I16(ptr) ((ptr)[0] + ((int)(ptr)[1] << 8))
 
-#define I32(ptr)                                                   \
-    ((ptr)[0] + ((INT32)(ptr)[1] << 8) + ((INT32)(ptr)[2] << 16) + \
-     ((INT32)(ptr)[3] << 24))
+#define I32(ptr)                                                                   \
+    ((ptr)[0] + ((unsigned long)(ptr)[1] << 8) + ((unsigned long)(ptr)[2] << 16) + \
+     ((unsigned long)(ptr)[3] << 24))
 
 #define ERR_IF_DATA_OOB(offset)                 \
     if ((data + (offset)) > ptr + bytes) {      \
@@ -31,8 +31,8 @@
 int
 ImagingFliDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t bytes) {
     UINT8 *ptr;
-    int framesize;
-    int c, chunks, advance;
+    unsigned long framesize, advance;
+    int c, chunks;
     int l, lines;
     int i, j, x = 0, y, ymax;
 

From 66e3d65a72e100e0919b757460099c916d79b5d3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 29 Dec 2025 02:04:44 +1100
Subject: [PATCH 2185/2374] Update harfbuzz to 12.3.0 (#9355)

---
 .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 e1477634d35..e1586b7c5a3 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -95,7 +95,7 @@ if [[ -n "$IOS_SDK" ]]; then
 else
   FREETYPE_VERSION=2.14.1
 fi
-HARFBUZZ_VERSION=12.2.0
+HARFBUZZ_VERSION=12.3.0
 LIBPNG_VERSION=1.6.53
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 30fe26d1415..3377d952c0d 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.2.0",
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "12.2.0",
+    "HARFBUZZ": "12.3.0",
     "JPEGTURBO": "3.1.3",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",

From faa843e9c2ba5be8ddf42bede72f63c93ac75158 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 29 Dec 2025 08:01:23 +1100
Subject: [PATCH 2186/2374] Simplify WebP code (#9329)

---
 src/PIL/WebPImagePlugin.py | 41 +++++++++++++++++---------------------
 1 file changed, 18 insertions(+), 23 deletions(-)

diff --git a/src/PIL/WebPImagePlugin.py b/src/PIL/WebPImagePlugin.py
index 2847fed20a0..e20e40d913f 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -45,33 +45,30 @@ class WebPImageFile(ImageFile.ImageFile):
     def _open(self) -> None:
         # Use the newer AnimDecoder API to parse the (possibly) animated file,
         # and access muxed chunks like ICC/EXIF/XMP.
+        assert self.fp is not None
         self._decoder = _webp.WebPAnimDecoder(self.fp.read())
 
         # Get info from decoder
-        self._size, loop_count, bgcolor, frame_count, mode = self._decoder.get_info()
-        self.info["loop"] = loop_count
-        bg_a, bg_r, bg_g, bg_b = (
-            (bgcolor >> 24) & 0xFF,
-            (bgcolor >> 16) & 0xFF,
-            (bgcolor >> 8) & 0xFF,
-            bgcolor & 0xFF,
+        self._size, self.info["loop"], bgcolor, self.n_frames, self.rawmode = (
+            self._decoder.get_info()
+        )
+        self.info["background"] = (
+            (bgcolor >> 16) & 0xFF,  # R
+            (bgcolor >> 8) & 0xFF,  # G
+            bgcolor & 0xFF,  # B
+            (bgcolor >> 24) & 0xFF,  # A
         )
-        self.info["background"] = (bg_r, bg_g, bg_b, bg_a)
-        self.n_frames = frame_count
         self.is_animated = self.n_frames > 1
-        self._mode = "RGB" if mode == "RGBX" else mode
-        self.rawmode = mode
+        self._mode = "RGB" if self.rawmode == "RGBX" else self.rawmode
 
         # Attempt to read ICC / EXIF / XMP chunks from file
-        icc_profile = self._decoder.get_chunk("ICCP")
-        exif = self._decoder.get_chunk("EXIF")
-        xmp = self._decoder.get_chunk("XMP ")
-        if icc_profile:
-            self.info["icc_profile"] = icc_profile
-        if exif:
-            self.info["exif"] = exif
-        if xmp:
-            self.info["xmp"] = xmp
+        for key, chunk_name in {
+            "icc_profile": "ICCP",
+            "exif": "EXIF",
+            "xmp": "XMP ",
+        }.items():
+            if value := self._decoder.get_chunk(chunk_name):
+                self.info[key] = value
 
         # Initialize seek state
         self._reset(reset=False)
@@ -129,9 +126,7 @@ def load(self) -> Image.core.PixelAccess | None:
             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
+            data, self.info["timestamp"], self.info["duration"] = self._get_next()
             self.__loaded = self.__logical_frame
 
             # Set tile

From a04c9806b12723b8882536325b69b4a1f96733aa Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 29 Dec 2025 08:03:47 +1100
Subject: [PATCH 2187/2374] Return LUT from LutBuilder build_default_lut()
 (#9350)

---
 Tests/test_imagemorph.py | 5 +++++
 src/PIL/ImageMorph.py    | 3 ++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index ca192a809c4..12423ebf627 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -281,6 +281,11 @@ def test_pattern_syntax_error(pattern: str) -> None:
         lb.build_lut()
 
 
+def test_build_default_lut() -> None:
+    lb = ImageMorph.LutBuilder(op_name="corner")
+    assert lb.build_default_lut() == lb.lut
+
+
 def test_load_invalid_mrl() -> None:
     # Arrange
     invalid_mrl = "Tests/images/hopper.png"
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index bd70aff7b48..4d9517d02ce 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -92,10 +92,11 @@ def __init__(
     def add_patterns(self, patterns: list[str]) -> None:
         self.patterns += patterns
 
-    def build_default_lut(self) -> None:
+    def build_default_lut(self) -> bytearray:
         symbols = [0, 1]
         m = 1 << 4  # pos of current pixel
         self.lut = bytearray(symbols[(i & m) > 0] for i in range(LUT_SIZE))
+        return self.lut
 
     def get_lut(self) -> bytearray | None:
         return self.lut

From 2ebb3e9964bcfb46e2b8dcaec1917caf67730a7d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 29 Dec 2025 08:09:46 +1100
Subject: [PATCH 2188/2374] Use different variables for Image and ImageFile
 instances (#9316)

---
 Tests/helper.py              |  7 ++--
 Tests/test_bmp_reference.py  | 18 +++++-----
 Tests/test_file_apng.py      | 18 +++++-----
 Tests/test_file_bmp.py       |  4 +--
 Tests/test_file_dds.py       |  8 ++---
 Tests/test_file_eps.py       | 32 ++++++++---------
 Tests/test_file_gif.py       | 68 ++++++++++++++++++------------------
 Tests/test_file_libtiff.py   | 14 ++++----
 Tests/test_file_png.py       | 37 ++++++++++----------
 Tests/test_imageops.py       |  6 ++--
 Tests/test_pickle.py         | 14 ++++----
 src/PIL/IptcImagePlugin.py   |  7 ++--
 src/PIL/SpiderImagePlugin.py |  4 +--
 13 files changed, 118 insertions(+), 119 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index dbdd30b426a..b93828f5832 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -104,10 +104,9 @@ def assert_image_equal_tofile(
     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)
+    with Image.open(filename) as im:
+        converted_im = im.convert(mode) if mode else im
+        assert_image_equal(a, converted_im, msg)
 
 
 def assert_image_similar(
diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 3cd0fbb2d2e..8fbd737484d 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -95,16 +95,16 @@ def get_compare(f: str) -> str:
     for f in get_files("g"):
         try:
             with Image.open(f) as im:
-                im.load()
                 with Image.open(get_compare(f)) as compare:
-                    compare.load()
-                    if im.mode == "P":
-                        # assert image similar doesn't really work
-                        # with paletized image, since the palette might
-                        # be differently ordered for an equivalent image.
-                        im = im.convert("RGBA")
-                        compare = compare.convert("RGBA")
-                    assert_image_similar(im, compare, 5)
+                    # assert image similar doesn't really work
+                    # with paletized image, since the palette might
+                    # be differently ordered for an equivalent image.
+                    im_converted = im.convert("RGBA") if im.mode == "P" else im
+                    compare_converted = (
+                        compare.convert("RGBA") if im.mode == "P" else compare
+                    )
+
+                    assert_image_similar(im_converted, compare_converted, 5)
 
         except Exception as msg:
             # there are three here that are unsupported:
diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index d918a24a799..644b7807a66 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -278,25 +278,25 @@ def test_apng_mode() -> None:
         assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "P"
         im.seek(im.n_frames - 1)
-        im = im.convert("RGB")
-        assert im.getpixel((0, 0)) == (0, 255, 0)
-        assert im.getpixel((64, 32)) == (0, 255, 0)
+        im_rgb = im.convert("RGB")
+    assert im_rgb.getpixel((0, 0)) == (0, 255, 0)
+    assert im_rgb.getpixel((64, 32)) == (0, 255, 0)
 
     with Image.open("Tests/images/apng/mode_palette_alpha.png") as im:
         assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "P"
         im.seek(im.n_frames - 1)
-        im = im.convert("RGBA")
-        assert im.getpixel((0, 0)) == (0, 255, 0, 255)
-        assert im.getpixel((64, 32)) == (0, 255, 0, 255)
+        im_rgba = im.convert("RGBA")
+    assert im_rgba.getpixel((0, 0)) == (0, 255, 0, 255)
+    assert im_rgba.getpixel((64, 32)) == (0, 255, 0, 255)
 
     with Image.open("Tests/images/apng/mode_palette_1bit_alpha.png") as im:
         assert isinstance(im, PngImagePlugin.PngImageFile)
         assert im.mode == "P"
         im.seek(im.n_frames - 1)
-        im = im.convert("RGBA")
-        assert im.getpixel((0, 0)) == (0, 0, 255, 128)
-        assert im.getpixel((64, 32)) == (0, 0, 255, 128)
+        im_rgba = im.convert("RGBA")
+    assert im_rgba.getpixel((0, 0)) == (0, 0, 255, 128)
+    assert im_rgba.getpixel((64, 32)) == (0, 0, 255, 128)
 
 
 def test_apng_chunk_errors() -> None:
diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index c1c430aa5b5..28e863459a6 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -165,9 +165,9 @@ def test_rgba_bitfields() -> None:
     with Image.open("Tests/images/rgb32bf-rgba.bmp") as im:
         # So before the comparing the image, swap the channels
         b, g, r = im.split()[1:]
-        im = Image.merge("RGB", (r, g, b))
+        im_rgb = Image.merge("RGB", (r, g, b))
 
-    assert_image_equal_tofile(im, "Tests/images/bmp/q/rgb32bf-xbgr.bmp")
+    assert_image_equal_tofile(im_rgb, "Tests/images/bmp/q/rgb32bf-xbgr.bmp")
 
     # This test image has been manually hexedited
     # to change the bitfield compression in the header from XBGR to ABGR
diff --git a/Tests/test_file_dds.py b/Tests/test_file_dds.py
index 60d0c09bce1..931ff02f1fb 100644
--- a/Tests/test_file_dds.py
+++ b/Tests/test_file_dds.py
@@ -57,7 +57,7 @@
 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")
+        target_rgba = target.convert("RGBA")
     with Image.open(image_path) as im:
         im.load()
 
@@ -65,7 +65,7 @@ def test_sanity_dxt1_bc1(image_path: str) -> None:
         assert im.mode == "RGBA"
         assert im.size == (256, 256)
 
-        assert_image_equal(im, target)
+        assert_image_equal(im, target_rgba)
 
 
 def test_sanity_dxt3() -> None:
@@ -520,9 +520,9 @@ def test_save_dx10_bc5(tmp_path: Path) -> None:
         im.save(out, pixel_format="BC5")
     assert_image_similar_tofile(im, out, 9.56)
 
-    im = hopper("L")
+    im_l = hopper("L")
     with pytest.raises(OSError, match="only RGB mode can be written as BC5"):
-        im.save(out, pixel_format="BC5")
+        im_l.save(out, pixel_format="BC5")
 
 
 @pytest.mark.parametrize(
diff --git a/Tests/test_file_eps.py b/Tests/test_file_eps.py
index b50915f28c3..d4e8db4f43c 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -265,9 +265,9 @@ def test_bytesio_object() -> None:
         img.load()
 
         with Image.open(FILE1_COMPARE) as image1_scale1_compare:
-            image1_scale1_compare = image1_scale1_compare.convert("RGB")
-        image1_scale1_compare.load()
-        assert_image_similar(img, image1_scale1_compare, 5)
+            image1_scale1_compare_rgb = image1_scale1_compare.convert("RGB")
+        image1_scale1_compare_rgb.load()
+        assert_image_similar(img, image1_scale1_compare_rgb, 5)
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
@@ -301,17 +301,17 @@ def test_render_scale1() -> None:
     with Image.open(FILE1) as image1_scale1:
         image1_scale1.load()
         with Image.open(FILE1_COMPARE) as image1_scale1_compare:
-            image1_scale1_compare = image1_scale1_compare.convert("RGB")
-        image1_scale1_compare.load()
-        assert_image_similar(image1_scale1, image1_scale1_compare, 5)
+            image1_scale1_compare_rgb = image1_scale1_compare.convert("RGB")
+        image1_scale1_compare_rgb.load()
+        assert_image_similar(image1_scale1, image1_scale1_compare_rgb, 5)
 
     # Non-zero bounding box
     with Image.open(FILE2) as image2_scale1:
         image2_scale1.load()
         with Image.open(FILE2_COMPARE) as image2_scale1_compare:
-            image2_scale1_compare = image2_scale1_compare.convert("RGB")
-        image2_scale1_compare.load()
-        assert_image_similar(image2_scale1, image2_scale1_compare, 10)
+            image2_scale1_compare_rgb = image2_scale1_compare.convert("RGB")
+        image2_scale1_compare_rgb.load()
+        assert_image_similar(image2_scale1, image2_scale1_compare_rgb, 10)
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
@@ -324,18 +324,16 @@ def test_render_scale2() -> None:
         assert isinstance(image1_scale2, EpsImagePlugin.EpsImageFile)
         image1_scale2.load(scale=2)
         with Image.open(FILE1_COMPARE_SCALE2) as image1_scale2_compare:
-            image1_scale2_compare = image1_scale2_compare.convert("RGB")
-        image1_scale2_compare.load()
-        assert_image_similar(image1_scale2, image1_scale2_compare, 5)
+            image1_scale2_compare_rgb = image1_scale2_compare.convert("RGB")
+        assert_image_similar(image1_scale2, image1_scale2_compare_rgb, 5)
 
     # Non-zero bounding box
     with Image.open(FILE2) as image2_scale2:
         assert isinstance(image2_scale2, EpsImagePlugin.EpsImageFile)
         image2_scale2.load(scale=2)
         with Image.open(FILE2_COMPARE_SCALE2) as image2_scale2_compare:
-            image2_scale2_compare = image2_scale2_compare.convert("RGB")
-        image2_scale2_compare.load()
-        assert_image_similar(image2_scale2, image2_scale2_compare, 10)
+            image2_scale2_compare_rgb = image2_scale2_compare.convert("RGB")
+        assert_image_similar(image2_scale2, image2_scale2_compare_rgb, 10)
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
@@ -345,8 +343,8 @@ def test_render_scale2() -> None:
 def test_resize(filename: str) -> None:
     with Image.open(filename) as im:
         new_size = (100, 100)
-        im = im.resize(new_size)
-        assert im.size == new_size
+        im_resized = im.resize(new_size)
+        assert im_resized.size == new_size
 
 
 @pytest.mark.skipif(not HAS_GHOSTSCRIPT, reason="Ghostscript not available")
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index acf79374e9a..2615f5a6028 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -327,14 +327,13 @@ def test_loading_multiple_palettes(path: str, mode: str) -> None:
 
         im.seek(1)
         assert im.mode == mode
-        if mode == "RGBA":
-            im = im.convert("RGB")
+        im_rgb = im.convert("RGB") if mode == "RGBA" else im
 
         # Check a color only from the old palette
-        assert im.getpixel((0, 0)) == original_color
+        assert im_rgb.getpixel((0, 0)) == original_color
 
         # Check a color from the new palette
-        assert im.getpixel((24, 24)) not in first_frame_colors
+        assert im_rgb.getpixel((24, 24)) not in first_frame_colors
 
 
 def test_headers_saving_for_animated_gifs(tmp_path: Path) -> None:
@@ -354,16 +353,16 @@ def test_palette_handling(tmp_path: Path) -> None:
     # see https://github.com/python-pillow/Pillow/issues/513
 
     with Image.open(TEST_GIF) as im:
-        im = im.convert("RGB")
+        im_rgb = im.convert("RGB")
 
-        im = im.resize((100, 100), Image.Resampling.LANCZOS)
-        im2 = im.convert("P", palette=Image.Palette.ADAPTIVE, colors=256)
+    im_rgb = im_rgb.resize((100, 100), Image.Resampling.LANCZOS)
+    im_p = im_rgb.convert("P", palette=Image.Palette.ADAPTIVE, colors=256)
 
-        f = tmp_path / "temp.gif"
-        im2.save(f, optimize=True)
+    f = tmp_path / "temp.gif"
+    im_p.save(f, optimize=True)
 
     with Image.open(f) as reloaded:
-        assert_image_similar(im, reloaded.convert("RGB"), 10)
+        assert_image_similar(im_rgb, reloaded.convert("RGB"), 10)
 
 
 def test_palette_434(tmp_path: Path) -> None:
@@ -383,35 +382,36 @@ def roundtrip(im: Image.Image, **kwargs: bool) -> Image.Image:
         with roundtrip(im, optimize=True) as reloaded:
             assert_image_similar(im, reloaded, 1)
 
-        im = im.convert("RGB")
-        # check automatic P conversion
-        with roundtrip(im) as reloaded:
-            reloaded = reloaded.convert("RGB")
-            assert_image_equal(im, reloaded)
+        im_rgb = im.convert("RGB")
+
+    # check automatic P conversion
+    with roundtrip(im_rgb) as reloaded:
+        reloaded = reloaded.convert("RGB")
+        assert_image_equal(im_rgb, reloaded)
 
 
 @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
 def test_save_netpbm_bmp_mode(tmp_path: Path) -> None:
     with Image.open(TEST_GIF) as img:
-        img = img.convert("RGB")
+        img_rgb = img.convert("RGB")
 
-        tempfile = str(tmp_path / "temp.gif")
-        b = BytesIO()
-        GifImagePlugin._save_netpbm(img, b, tempfile)
-        with Image.open(tempfile) as reloaded:
-            assert_image_similar(img, reloaded.convert("RGB"), 0)
+    tempfile = str(tmp_path / "temp.gif")
+    b = BytesIO()
+    GifImagePlugin._save_netpbm(img_rgb, b, tempfile)
+    with Image.open(tempfile) as reloaded:
+        assert_image_similar(img_rgb, reloaded.convert("RGB"), 0)
 
 
 @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
 def test_save_netpbm_l_mode(tmp_path: Path) -> None:
     with Image.open(TEST_GIF) as img:
-        img = img.convert("L")
+        img_l = img.convert("L")
 
         tempfile = str(tmp_path / "temp.gif")
         b = BytesIO()
-        GifImagePlugin._save_netpbm(img, b, tempfile)
+        GifImagePlugin._save_netpbm(img_l, b, tempfile)
         with Image.open(tempfile) as reloaded:
-            assert_image_similar(img, reloaded.convert("L"), 0)
+            assert_image_similar(img_l, reloaded.convert("L"), 0)
 
 
 def test_seek() -> None:
@@ -1038,9 +1038,9 @@ def test_webp_background(tmp_path: Path) -> None:
             im.save(out)
 
     # Test non-opaque WebP background
-    im = Image.new("L", (100, 100), "#000")
-    im.info["background"] = (0, 0, 0, 0)
-    im.save(out)
+    im2 = Image.new("L", (100, 100), "#000")
+    im2.info["background"] = (0, 0, 0, 0)
+    im2.save(out)
 
 
 def test_comment(tmp_path: Path) -> None:
@@ -1048,16 +1048,16 @@ def test_comment(tmp_path: Path) -> None:
         assert im.info["comment"] == b"File written by Adobe Photoshop\xa8 4.0"
 
     out = tmp_path / "temp.gif"
-    im = Image.new("L", (100, 100), "#000")
-    im.info["comment"] = b"Test comment text"
-    im.save(out)
+    im2 = Image.new("L", (100, 100), "#000")
+    im2.info["comment"] = b"Test comment text"
+    im2.save(out)
     with Image.open(out) as reread:
-        assert reread.info["comment"] == im.info["comment"]
+        assert reread.info["comment"] == im2.info["comment"]
 
-    im.info["comment"] = "Test comment text"
-    im.save(out)
+    im2.info["comment"] = "Test comment text"
+    im2.save(out)
     with Image.open(out) as reread:
-        assert reread.info["comment"] == im.info["comment"].encode()
+        assert reread.info["comment"] == im2.info["comment"].encode()
 
         # Test that GIF89a is used for comments
         assert reread.info["version"] == b"GIF89a"
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index e36b5f39e3c..e05563c6aa4 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -516,12 +516,12 @@ def test_blur(self, tmp_path: Path) -> None:
         # and save to compressed tif.
         out = tmp_path / "temp.tif"
         with Image.open("Tests/images/pport_g4.tif") as im:
-            im = im.convert("L")
+            im_l = im.convert("L")
 
-        im = im.filter(ImageFilter.GaussianBlur(4))
-        im.save(out, compression="tiff_adobe_deflate")
+        im_l = im_l.filter(ImageFilter.GaussianBlur(4))
+        im_l.save(out, compression="tiff_adobe_deflate")
 
-        assert_image_equal_tofile(im, out)
+        assert_image_equal_tofile(im_l, out)
 
     def test_compressions(self, tmp_path: Path) -> None:
         # Test various tiff compressions and assert similar image content but reduced
@@ -1087,8 +1087,10 @@ def test_old_style_jpeg_orientation(self) -> None:
         data = data[:102] + b"\x02" + data[103:]
 
         with Image.open(io.BytesIO(data)) as im:
-            im = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
-        assert_image_equal_tofile(im, "Tests/images/old-style-jpeg-compression.png")
+            im_transposed = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
+        assert_image_equal_tofile(
+            im_transposed, "Tests/images/old-style-jpeg-compression.png"
+        )
 
     def test_open_missing_samplesperpixel(self) -> None:
         with Image.open(
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 7f163a4d6d6..e9830cd3dad 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -101,12 +101,13 @@ def test_sanity(self, tmp_path: Path) -> None:
             assert im.get_format_mimetype() == "image/png"
 
         for mode in ["1", "L", "P", "RGB", "I;16", "I;16B"]:
-            im = hopper(mode)
-            im.save(test_file)
+            im1 = hopper(mode)
+            im1.save(test_file)
             with Image.open(test_file) as reloaded:
-                if mode == "I;16B":
-                    reloaded = reloaded.convert(mode)
-                assert_image_equal(reloaded, im)
+                converted_reloaded = (
+                    reloaded.convert(mode) if mode == "I;16B" else reloaded
+                )
+                assert_image_equal(converted_reloaded, im1)
 
     def test_invalid_file(self) -> None:
         invalid_file = "Tests/images/flower.jpg"
@@ -225,11 +226,11 @@ 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))
-            im = im.convert("RGBA")
-        assert_image(im, "RGBA", (162, 150))
+            im_rgba = im.convert("RGBA")
+        assert_image(im_rgba, "RGBA", (162, 150))
 
         # image has 124 unique alpha values
-        colors = im.getchannel("A").getcolors()
+        colors = im_rgba.getchannel("A").getcolors()
         assert colors is not None
         assert len(colors) == 124
 
@@ -239,11 +240,11 @@ def test_load_transparent_rgb(self) -> None:
             assert im.info["transparency"] == (0, 255, 52)
 
             assert_image(im, "RGB", (64, 64))
-            im = im.convert("RGBA")
-        assert_image(im, "RGBA", (64, 64))
+            im_rgba = im.convert("RGBA")
+        assert_image(im_rgba, "RGBA", (64, 64))
 
         # image has 876 transparent pixels
-        colors = im.getchannel("A").getcolors()
+        colors = im_rgba.getchannel("A").getcolors()
         assert colors is not None
         assert colors[0][0] == 876
 
@@ -262,11 +263,11 @@ def test_save_p_transparent_palette(self, tmp_path: Path) -> None:
             assert len(im.info["transparency"]) == 256
 
             assert_image(im, "P", (162, 150))
-            im = im.convert("RGBA")
-        assert_image(im, "RGBA", (162, 150))
+            im_rgba = im.convert("RGBA")
+        assert_image(im_rgba, "RGBA", (162, 150))
 
         # image has 124 unique alpha values
-        colors = im.getchannel("A").getcolors()
+        colors = im_rgba.getchannel("A").getcolors()
         assert colors is not None
         assert len(colors) == 124
 
@@ -285,13 +286,13 @@ def test_save_p_single_transparency(self, tmp_path: Path) -> None:
             assert im.info["transparency"] == 164
             assert im.getpixel((31, 31)) == 164
             assert_image(im, "P", (64, 64))
-            im = im.convert("RGBA")
-        assert_image(im, "RGBA", (64, 64))
+            im_rgba = im.convert("RGBA")
+        assert_image(im_rgba, "RGBA", (64, 64))
 
-        assert im.getpixel((31, 31)) == (0, 255, 52, 0)
+        assert im_rgba.getpixel((31, 31)) == (0, 255, 52, 0)
 
         # image has 876 transparent pixels
-        colors = im.getchannel("A").getcolors()
+        colors = im_rgba.getchannel("A").getcolors()
         assert colors is not None
         assert colors[0][0] == 876
 
diff --git a/Tests/test_imageops.py b/Tests/test_imageops.py
index 63cd0e4d4a9..35fe3bb8a57 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -457,9 +457,9 @@ def check(orientation_im: Image.Image) -> 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)
+    im1 = hopper()
+    im1.getexif()[0x0112] = 3
+    transposed_im = ImageOps.exif_transpose(im1)
     assert 0x0112 not in transposed_im.getexif()
 
 
diff --git a/Tests/test_pickle.py b/Tests/test_pickle.py
index fc76f81e945..2447ae67ad7 100644
--- a/Tests/test_pickle.py
+++ b/Tests/test_pickle.py
@@ -19,30 +19,28 @@ def helper_pickle_file(
     # Arrange
     with Image.open(test_file) as im:
         filename = tmp_path / "temp.pkl"
-        if mode:
-            im = im.convert(mode)
+        converted_im = im.convert(mode) if mode else im
 
         # Act
         with open(filename, "wb") as f:
-            pickle.dump(im, f, protocol)
+            pickle.dump(converted_im, f, protocol)
         with open(filename, "rb") as f:
             loaded_im = pickle.load(f)
 
         # Assert
-        assert im == loaded_im
+        assert converted_im == loaded_im
 
 
 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)
+        converted_im = im.convert(mode) if mode else im
 
         # Act
-        dumped_string = pickle.dumps(im, protocol)
+        dumped_string = pickle.dumps(converted_im, protocol)
         loaded_im = pickle.loads(dumped_string)
 
         # Assert
-        assert im == loaded_im
+        assert converted_im == loaded_im
 
 
 @pytest.mark.parametrize(
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index c28f4dcc797..cf7067daa79 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -154,10 +154,11 @@ def load(self) -> Image.core.PixelAccess | None:
                 if band is not None:
                     bands = [Image.new("L", _im.size)] * Image.getmodebands(self.mode)
                     bands[band] = _im
-                    _im = Image.merge(self.mode, bands)
+                    im = Image.merge(self.mode, bands)
                 else:
-                    _im.load()
-                self.im = _im.im
+                    im = _im
+                    im.load()
+                self.im = im.im
             self.tile = []
         return ImageFile.ImageFile.load(self)
 
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 868019e80a8..7c3e84d7495 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -323,9 +323,9 @@ def _save_spider(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
             outfile = sys.argv[2]
 
             # perform some image operation
-            im = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
+            transposed_im = im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
             print(
                 f"saving a flipped version of {os.path.basename(filename)} "
                 f"as {outfile} "
             )
-            im.save(outfile, SpiderImageFile.format)
+            transposed_im.save(outfile, SpiderImageFile.format)

From 080afe1bf7757208ba2c7995d1ca2754e3f78c2f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 28 Dec 2025 23:46:02 +0200
Subject: [PATCH 2189/2374] Replace pre-commit with prek

---
 .github/workflows/lint.yml | 17 ++++++++---------
 .github/zizmor.yml         |  1 -
 tox.ini                    |  7 ++++---
 3 files changed, 12 insertions(+), 13 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 77d1d1caa40..5f72550c09c 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -2,18 +2,17 @@ name: Lint
 
 on: [push, pull_request, workflow_dispatch]
 
+permissions: {}
+
 env:
   FORCE_COLOR: 1
 
-permissions:
-  contents: read
-
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
-  build:
+  lint:
 
     runs-on: ubuntu-latest
 
@@ -24,13 +23,13 @@ jobs:
       with:
         persist-credentials: false
 
-    - name: pre-commit cache
+    - name: prek cache
       uses: actions/cache@v4
       with:
-        path: ~/.cache/pre-commit
-        key: lint-pre-commit-${{ hashFiles('**/.pre-commit-config.yaml') }}
+        path: ~/.cache/prek
+        key: lint-prek-${{ hashFiles('**/.pre-commit-config.yaml') }}
         restore-keys: |
-          lint-pre-commit-
+          lint-prek-
 
     - name: Set up Python
       uses: actions/setup-python@v6
@@ -50,7 +49,7 @@ jobs:
     - name: Lint
       run: tox -e lint
       env:
-        PRE_COMMIT_COLOR: always
+        PREK_COLOR: always
 
     - name: Mypy
       run: tox -e mypy
diff --git a/.github/zizmor.yml b/.github/zizmor.yml
index e60c79441ca..f4949c30c43 100644
--- a/.github/zizmor.yml
+++ b/.github/zizmor.yml
@@ -1,4 +1,3 @@
-# Configuration for the zizmor static analysis tool, run via pre-commit in CI
 # https://docs.zizmor.sh/configuration/
 rules:
   obfuscation:
diff --git a/tox.ini b/tox.ini
index 7f116c6e75f..de18946efa7 100644
--- a/tox.ini
+++ b/tox.ini
@@ -3,6 +3,7 @@ requires =
     tox>=4.2
 env_list =
     lint
+    mypy
     py{py3, 315, 314, 313, 312, 311, 310}
 
 [testenv]
@@ -18,11 +19,11 @@ commands =
 skip_install = true
 deps =
     check-manifest
-    pre-commit
+    prek
 pass_env =
-    PRE_COMMIT_COLOR
+    PREK_COLOR
 commands =
-    pre-commit run --all-files --show-diff-on-failure
+    prek run --all-files --show-diff-on-failure
     check-manifest
 
 [testenv:mypy]

From 3abb62ed2935592c5046621da304e4aa1f171c7a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 11 Dec 2025 08:19:24 +1100
Subject: [PATCH 2190/2374] Do not use cmd shell

---
 .github/workflows/test-windows.yml | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index e864763da21..913d6a23cb9 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -188,8 +188,9 @@ jobs:
     # trim ~150MB for each job
     - name: Optimize build cache
       if: steps.build-cache.outputs.cache-hit != 'true'
-      run: rmdir /S /Q winbuild\build\src
-      shell: cmd
+      run: |
+        rm -rf winbuild\build\src
+      shell: bash
 
     - name: Build Pillow
       run: |
@@ -206,9 +207,7 @@ jobs:
 
     - name: Test Pillow
       run: |
-        path %GITHUB_WORKSPACE%\winbuild\build\bin;%PATH%
         .ci\test.cmd
-      shell: cmd
 
     - name: Prepare to upload errors
       if: failure()

From 79357a271866050776ac587b1871c6841e2505d2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 5 Dec 2025 22:24:33 +1100
Subject: [PATCH 2191/2374] Revert "Disable
 https://docs.zizmor.sh/audits/#obfuscation"

This reverts commit 9342e209b2176bde761b321a74846857257ea78c.
---
 .github/zizmor.yml | 2 --
 1 file changed, 2 deletions(-)

diff --git a/.github/zizmor.yml b/.github/zizmor.yml
index e60c79441ca..b567097811a 100644
--- a/.github/zizmor.yml
+++ b/.github/zizmor.yml
@@ -1,8 +1,6 @@
 # Configuration for the zizmor static analysis tool, run via pre-commit in CI
 # https://docs.zizmor.sh/configuration/
 rules:
-  obfuscation:
-    disable: true
   unpinned-uses:
     config:
       policies:

From 72931475f2ba773d42b550b17ac10c19ae4a505c Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 29 Dec 2025 14:44:32 +0200
Subject: [PATCH 2192/2374] Replace shell: cmd with shell: bash

---
 .github/workflows/wheels.yml | 32 +++++++++++++-------------------
 1 file changed, 13 insertions(+), 19 deletions(-)

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index fb71ead37b5..c9a738db3f2 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -186,24 +186,18 @@ jobs:
 
       - name: Build wheels
         run: |
-          setlocal EnableDelayedExpansion
-          for %%f in (winbuild\build\license\*) do (
-            set x=%%~nf
-            rem Skip FriBiDi license, it is not included in the wheel.
-            set fribidi=!x:~0,7!
-            if NOT !fribidi!==fribidi (
-              rem Skip imagequant license, it is not included in the wheel.
-              set libimagequant=!x:~0,13!
-              if NOT !libimagequant!==libimagequant (
-                echo. >> LICENSE
-                echo ===== %%~nf ===== >> LICENSE
-                echo. >> LICENSE
-                type %%f >> LICENSE
-              )
-            )
-          )
-          call winbuild\\build\\build_env.cmd
-          %pythonLocation%\python.exe -m cibuildwheel . --output-dir wheelhouse
+          for f in winbuild/build/license/*; do
+            name=$(basename "${f%.*}")
+            # Skip FriBiDi license, it is not included in the wheel.
+            [[ $name == fribidi* ]] && continue
+            # Skip imagequant license, it is not included in the wheel.
+            [[ $name == libimagequant* ]] && continue
+            echo "" >> LICENSE
+            echo "===== $name =====" >> LICENSE
+            echo "" >> LICENSE
+            cat "$f" >> LICENSE
+          done
+          cmd //c "winbuild\\build\\build_env.cmd && $pythonLocation\\python.exe -m cibuildwheel . --output-dir wheelhouse"
         env:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
@@ -217,7 +211,7 @@ jobs:
             -e CI -e GITHUB_ACTIONS
             mcr.microsoft.com/windows/servercore:ltsc2022
             powershell C:\pillow\.github\workflows\wheels-test.ps1 %CD%\..\venv-test'
-        shell: cmd
+        shell: bash
 
       - name: Upload wheels
         uses: actions/upload-artifact@v5

From 81e80f7a50e2e884d67d09ed7c735ee87f0f0f0a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 29 Dec 2025 19:35:41 +0200
Subject: [PATCH 2193/2374] Install and run tox/lint/mypy via uv

---
 .github/workflows/lint.yml | 51 +++++++++++---------------------------
 1 file changed, 14 insertions(+), 37 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 5f72550c09c..e2f8bf47ac4 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -6,6 +6,8 @@ permissions: {}
 
 env:
   FORCE_COLOR: 1
+  PREK_COLOR: always
+  RUFF_OUTPUT_FORMAT: github
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -13,43 +15,18 @@ concurrency:
 
 jobs:
   lint:
-
     runs-on: ubuntu-latest
-
     name: Lint
-
     steps:
-    - uses: actions/checkout@v6
-      with:
-        persist-credentials: false
-
-    - name: prek cache
-      uses: actions/cache@v4
-      with:
-        path: ~/.cache/prek
-        key: lint-prek-${{ hashFiles('**/.pre-commit-config.yaml') }}
-        restore-keys: |
-          lint-prek-
-
-    - name: Set up Python
-      uses: actions/setup-python@v6
-      with:
-        python-version: "3.x"
-        cache: pip
-        cache-dependency-path: "setup.py"
-
-    - name: Build system information
-      run: python3 .github/workflows/system-info.py
-
-    - name: Install dependencies
-      run: |
-        python3 -m pip install -U pip
-        python3 -m pip install -U tox
-
-    - name: Lint
-      run: tox -e lint
-      env:
-        PREK_COLOR: always
-
-    - name: Mypy
-      run: tox -e mypy
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+      - name: Lint
+        run: uvx --with tox-uv tox -e lint
+      - name: Mypy
+        run: uvx --with tox-uv tox -e mypy

From 0a9a47fb9b9780fed4cf859da12cfa5fc867a71e Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 31 Dec 2025 23:02:31 +1100
Subject: [PATCH 2194/2374] Update ImageMorph documentation (#9349)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/reference/ImageMorph.rst |  46 ++++++++++++++-
 src/PIL/ImageMorph.py         | 108 +++++++++++++++++++++++++---------
 2 files changed, 122 insertions(+), 32 deletions(-)

diff --git a/docs/reference/ImageMorph.rst b/docs/reference/ImageMorph.rst
index 30b89a54df5..77b96058a7d 100644
--- a/docs/reference/ImageMorph.rst
+++ b/docs/reference/ImageMorph.rst
@@ -4,10 +4,50 @@
 :py:mod:`~PIL.ImageMorph` module
 ================================
 
-The :py:mod:`~PIL.ImageMorph` module provides morphology operations on images.
+The :py:mod:`~PIL.ImageMorph` module allows `morphology`_ operators ("MorphOp") to be
+applied to L mode images::
 
-.. automodule:: PIL.ImageMorph
+  from PIL import Image, ImageMorph
+  img = Image.open("Tests/images/hopper.bw")
+  mop = ImageMorph.MorphOp(op_name="erosion4")
+  count, imgOut = mop.apply(img)
+  imgOut.show()
+
+.. _morphology: https://en.wikipedia.org/wiki/Mathematical_morphology
+
+In addition to applying operators, you can also analyse images.
+
+You can inspect an image in isolation to determine which pixels are non-empty::
+
+  print(mop.get_on_pixels(img))  # [(0, 0), (1, 0), (2, 0), ...]
+
+Or you can retrieve a list of pixels that match the operator. This is the number of
+pixels that will be non-empty after the operator is applied::
+
+  coords = mop.match(img)
+  print(coords)  # [(17, 1), (18, 1), (34, 1), ...]
+  print(len(coords))  # 550
+
+  imgOut = mop.apply(img)[1]
+  print(len(mop.get_on_pixels(imgOut)))  # 550
+
+If you would like more customized operators, you can pass patterns to the MorphOp
+class::
+
+  mop = ImageMorph.MorphOp(patterns=["1:(... ... ...)->0", "4:(00. 01. ...)->1"])
+
+Or you can pass lookup table ("LUT") data directly. This LUT data can be constructed
+with the :py:class:`~PIL.ImageMorph.LutBuilder`::
+
+  builder = ImageMorph.LutBuilder()
+  mop = ImageMorph.MorphOp(lut=builder.build_lut())
+
+.. autoclass:: LutBuilder
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+.. autoclass:: MorphOp
     :members:
     :undoc-members:
     :show-inheritance:
-    :noindex:
diff --git a/src/PIL/ImageMorph.py b/src/PIL/ImageMorph.py
index 4d9517d02ce..90e19911758 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -65,10 +65,12 @@ class LutBuilder:
     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 = []
+        """
+        :param patterns: A list of input patterns, or None.
+        :param op_name: The name of a known pattern. One of "corner", "dilation4",
+           "dilation8", "erosion4", "erosion8" or "edge".
+        :exception Exception: If the op_name is not recognized.
+        """
         self.lut: bytearray | None = None
         if op_name is not None:
             known_patterns = {
@@ -88,21 +90,38 @@ def __init__(
                 raise Exception(msg)
 
             self.patterns = known_patterns[op_name]
+        elif patterns is not None:
+            self.patterns = patterns
+        else:
+            self.patterns = []
 
     def add_patterns(self, patterns: list[str]) -> None:
+        """
+        Append to list of patterns.
+
+        :param patterns: Additional patterns.
+        """
         self.patterns += patterns
 
     def build_default_lut(self) -> bytearray:
+        """
+        Set the current LUT, and return it.
+
+        This is the default LUT that patterns will be applied against when building.
+        """
         symbols = [0, 1]
         m = 1 << 4  # pos of current pixel
         self.lut = bytearray(symbols[(i & m) > 0] for i in range(LUT_SIZE))
         return self.lut
 
     def get_lut(self) -> bytearray | None:
+        """
+        Returns the current LUT
+        """
         return self.lut
 
     def _string_permute(self, pattern: str, permutation: list[int]) -> str:
-        """string_permute takes a pattern and a permutation and returns the
+        """Takes a pattern and a permutation and returns the
         string permuted according to the permutation list.
         """
         assert len(permutation) == 9
@@ -111,7 +130,7 @@ def _string_permute(self, pattern: str, permutation: list[int]) -> str:
     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
+        """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."""
         patterns = [(basic_pattern, basic_result)]
@@ -141,10 +160,9 @@ def _pattern_permute(
         return patterns
 
     def build_lut(self) -> bytearray:
-        """Compile all patterns into a morphology lut.
+        """Compile all patterns into a morphology LUT, and return it.
 
-        TBD :Build based on (file) morphlut:modify_lut
-        """
+        This is the data to be passed into MorphOp."""
         self.build_default_lut()
         assert self.lut is not None
         patterns = []
@@ -164,15 +182,14 @@ def build_lut(self) -> bytearray:
 
             patterns += self._pattern_permute(pattern, options, result)
 
-        # compile the patterns into regular expressions for speed
+        # Compile the patterns into regular expressions for speed
         compiled_patterns = []
         for pattern in patterns:
             p = pattern[0].replace(".", "X").replace("X", "[01]")
             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
-        # caught overrides
+        # Note that all the patterns are searched. The last one found takes priority
         for i in range(LUT_SIZE):
             # Build the bit pattern
             bitpattern = bin(i)[2:]
@@ -194,18 +211,30 @@ def __init__(
         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:
-            self.lut = LutBuilder(op_name=op_name).build_lut()
-        elif patterns is not None:
-            self.lut = LutBuilder(patterns=patterns).build_lut()
+        """Create a binary morphological operator.
+
+        If the LUT is not provided, then it is built using LutBuilder from the op_name
+        or the patterns.
+
+        :param lut: The LUT data.
+        :param patterns: A list of input patterns, or None.
+        :param op_name: The name of a known pattern. One of "corner", "dilation4",
+        "dilation8", "erosion4", "erosion8", "edge".
+        :exception Exception: If the op_name is not recognized.
+        """
+        if patterns is None and op_name is None:
+            self.lut = lut
+        else:
+            self.lut = LutBuilder(patterns, op_name).build_lut()
 
     def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
-        """Run a single morphological operation on an image
+        """Run a single morphological operation on an image.
 
         Returns a tuple of the number of changed pixels and the
-        morphed image"""
+        morphed image.
+
+        :exception Exception: If the current operator is None.
+        :exception ValueError: If the image is not L mode."""
         if self.lut is None:
             msg = "No operator loaded"
             raise Exception(msg)
@@ -213,7 +242,7 @@ def apply(self, image: Image.Image) -> tuple[int, Image.Image]:
         if image.mode != "L":
             msg = "Image mode must be L"
             raise ValueError(msg)
-        outimage = Image.new(image.mode, image.size, None)
+        outimage = Image.new(image.mode, image.size)
         count = _imagingmorph.apply(bytes(self.lut), image.getim(), outimage.getim())
         return count, outimage
 
@@ -221,8 +250,12 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         """Get a list of coordinates matching the morphological operation on
         an image.
 
-        Returns a list of tuples of (x,y) coordinates
-        of all matching pixels. See :ref:`coordinate-system`."""
+        Returns a list of tuples of (x,y) coordinates of all matching pixels. See
+        :ref:`coordinate-system`.
+
+        :param image: An L-mode image.
+        :exception Exception: If the current operator is None.
+        :exception ValueError: If the image is not L mode."""
         if self.lut is None:
             msg = "No operator loaded"
             raise Exception(msg)
@@ -233,10 +266,13 @@ def match(self, image: Image.Image) -> list[tuple[int, int]]:
         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
+        """Get a list of all turned on pixels in a grayscale image
+
+        Returns a list of tuples of (x,y) coordinates of all non-empty pixels. See
+        :ref:`coordinate-system`.
 
-        Returns a list of tuples of (x,y) coordinates
-        of all matching pixels. See :ref:`coordinate-system`."""
+        :param image: An L-mode image.
+        :exception ValueError: If the image is not L mode."""
 
         if image.mode != "L":
             msg = "Image mode must be L"
@@ -244,7 +280,12 @@ def get_on_pixels(self, image: Image.Image) -> list[tuple[int, int]]:
         return _imagingmorph.get_on_pixels(image.getim())
 
     def load_lut(self, filename: str) -> None:
-        """Load an operator from an mrl file"""
+        """
+        Load an operator from an mrl file
+
+        :param filename: The file to read from.
+        :exception Exception: If the length of the file data is not 512.
+        """
         with open(filename, "rb") as f:
             self.lut = bytearray(f.read())
 
@@ -254,7 +295,12 @@ def load_lut(self, filename: str) -> None:
             raise Exception(msg)
 
     def save_lut(self, filename: str) -> None:
-        """Save an operator to an mrl file"""
+        """
+        Save an operator to an mrl file.
+
+        :param filename: The destination file.
+        :exception Exception: If the current operator is None.
+        """
         if self.lut is None:
             msg = "No operator loaded"
             raise Exception(msg)
@@ -262,5 +308,9 @@ def save_lut(self, filename: str) -> None:
             f.write(self.lut)
 
     def set_lut(self, lut: bytearray | None) -> None:
-        """Set the lut from an external source"""
+        """
+        Set the LUT from an external source
+
+        :param lut: A new LUT.
+        """
         self.lut = lut

From 19910ed03ecf6a845a2ad1dbe05f060959c595d9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 31 Dec 2025 23:47:33 +1100
Subject: [PATCH 2195/2374] Call parent verify method (#9357)

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

diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 967308221ad..e3588735f20 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -855,9 +855,7 @@ def verify(self) -> None:
         self.png.verify()
         self.png.close()
 
-        if self._exclusive_fp:
-            self.fp.close()
-        self.fp = None
+        super().verify()
 
     def seek(self, frame: int) -> None:
         if not self._seek_check(frame):

From 2ebfe30ae39d6d016b5239321ada65c85644e99e Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 31 Dec 2025 23:47:50 +1100
Subject: [PATCH 2196/2374] Added return type to ImageFile _close_fp() (#9356)

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

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index a1d98bd5103..ecb51b193e8 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -131,6 +131,7 @@ def __init__(
         self.decoderconfig: tuple[Any, ...] = ()
         self.decodermaxblock = MAXBLOCK
 
+        self._fp: IO[bytes] | DeferredError
         if is_path(fp):
             # filename
             self.fp = open(fp, "rb")
@@ -167,7 +168,7 @@ def __init__(
     def _open(self) -> None:
         pass
 
-    def _close_fp(self):
+    def _close_fp(self) -> None:
         if getattr(self, "_fp", False) and not isinstance(self._fp, DeferredError):
             if self._fp != self.fp:
                 self._fp.close()

From d62955031b593b6f993c655eb1e4332c15818df7 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 1 Jan 2026 08:53:04 +1100
Subject: [PATCH 2197/2374] Allow for duplicate font variation styles (#9362)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 Tests/fonts/AdobeVFPrototypeDuplicates.ttf | Bin 0 -> 6696 bytes
 Tests/fonts/LICENSE.txt                    |   2 +-
 Tests/test_imagefont.py                    |  17 ++++++++++++++++-
 src/PIL/ImageFont.py                       |   8 ++++++--
 src/_imagingft.c                           |   1 -
 5 files changed, 23 insertions(+), 5 deletions(-)
 create mode 100644 Tests/fonts/AdobeVFPrototypeDuplicates.ttf

diff --git a/Tests/fonts/AdobeVFPrototypeDuplicates.ttf b/Tests/fonts/AdobeVFPrototypeDuplicates.ttf
new file mode 100644
index 0000000000000000000000000000000000000000..acf0bc156c8bec3c79de96968766795951b3a8fb
GIT binary patch
literal 6696
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

literal 0
HcmV?d00001

diff --git a/Tests/fonts/LICENSE.txt b/Tests/fonts/LICENSE.txt
index 3c8a23197e9..94989af9035 100644
--- a/Tests/fonts/LICENSE.txt
+++ b/Tests/fonts/LICENSE.txt
@@ -2,7 +2,7 @@
 NotoNastaliqUrdu-Regular.ttf and NotoSansSymbols-Regular.ttf, from https://github.com/googlei18n/noto-fonts
 NotoSans-Regular.ttf, from https://www.google.com/get/noto/
 NotoSansJP-Thin.otf, from https://www.google.com/get/noto/help/cjk/
-AdobeVFPrototype.ttf, from https://github.com/adobe-fonts/adobe-variable-font-prototype
+AdobeVFPrototype.ttf, from https://github.com/adobe-fonts/adobe-variable-font-prototype. AdobeVFPrototypeDuplicates.ttf is a modified version of this
 TINY5x3GX.ttf, from http://velvetyne.fr/fonts/tiny
 ArefRuqaa-Regular.ttf, from https://github.com/google/fonts/tree/master/ofl/arefruqaa
 ter-x20b.pcf, from http://terminus-font.sourceforge.net/
diff --git a/Tests/test_imagefont.py b/Tests/test_imagefont.py
index 39ee9b9c92e..d0b458d6b77 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -702,7 +702,7 @@ def test_variation_get(font: ImageFont.FreeTypeFont) -> None:
         font.get_variation_axes()
 
     font = ImageFont.truetype("Tests/fonts/AdobeVFPrototype.ttf")
-    assert font.get_variation_names(), [
+    assert font.get_variation_names() == [
         b"ExtraLight",
         b"Light",
         b"Regular",
@@ -742,6 +742,21 @@ def test_variation_get(font: ImageFont.FreeTypeFont) -> None:
     ]
 
 
+def test_variation_duplicates() -> None:
+    font = ImageFont.truetype("Tests/fonts/AdobeVFPrototypeDuplicates.ttf")
+    assert font.get_variation_names() == [
+        b"ExtraLight",
+        b"Light",
+        b"Regular",
+        b"Semibold",
+        b"Bold",
+        b"Black",
+        b"Black Medium Contrast",
+        b"Black High Contrast",
+        b"Default",
+    ]
+
+
 def _check_text(font: ImageFont.FreeTypeFont, path: str, epsilon: float) -> None:
     im = Image.new("RGB", (100, 75), "white")
     d = ImageDraw.Draw(im)
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index 2e8ace98dda..d11f7bf01ad 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -675,8 +675,12 @@ 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.
         """
-        names = self.font.getvarnames()
-        return [name.replace(b"\x00", b"") for name in names]
+        names = []
+        for name in self.font.getvarnames():
+            name = name.replace(b"\x00", b"")
+            if name not in names:
+                names.append(name)
+        return names
 
     def set_variation_by_name(self, name: str | bytes) -> None:
         """
diff --git a/src/_imagingft.c b/src/_imagingft.c
index d0af25b30e3..a371173d61c 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1287,7 +1287,6 @@ font_getvarnames(FontObject *self) {
                 }
                 PyList_SetItem(list_names, j, list_name);
                 list_names_filled[j] = 1;
-                break;
             }
         }
     }

From 900636e7dbc8ead2caaae0e387096fa8bf6474d5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 1 Jan 2026 17:31:36 +1100
Subject: [PATCH 2198/2374] Use minimum supported Python version for Lint
 (#9364)

---
 .github/workflows/lint.yml | 2 +-
 .pre-commit-config.yaml    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index e2f8bf47ac4..4f67be6f705 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -23,7 +23,7 @@ jobs:
           persist-credentials: false
       - uses: actions/setup-python@v6
         with:
-          python-version: "3.x"
+          python-version: "3.10"
       - name: Install uv
         uses: astral-sh/setup-uv@v7
       - name: Lint
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 8477729e636..10343f91ae3 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -76,7 +76,7 @@ repos:
     rev: v0.24.1
     hooks:
       - id: validate-pyproject
-        additional_dependencies: [trove-classifiers>=2024.10.12]
+        additional_dependencies: [tomli, trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
     rev: 1.7.0

From 91f219fdcff8bc3eaafa2a0c2269286ebff0cca1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 1 Jan 2026 13:02:21 +1100
Subject: [PATCH 2199/2374] Support saving float durations

---
 Tests/test_file_apng.py              | 18 ++++++++++++++++++
 docs/handbook/image-file-formats.rst |  5 ++---
 src/PIL/PngImagePlugin.py            | 11 ++++++++---
 3 files changed, 28 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_apng.py b/Tests/test_file_apng.py
index 644b7807a66..b57a1d1ad8c 100644
--- a/Tests/test_file_apng.py
+++ b/Tests/test_file_apng.py
@@ -518,6 +518,24 @@ def test_apng_save_duration_loop(tmp_path: Path) -> None:
         assert im.info["duration"] == 600
 
 
+def test_apng_save_duration_float(tmp_path: Path) -> None:
+    test_file = tmp_path / "temp.png"
+    im = Image.new("1", (1, 1))
+    im2 = Image.new("1", (1, 1), 1)
+    im.save(test_file, save_all=True, append_images=[im2], duration=0.5)
+
+    with Image.open(test_file) as reloaded:
+        assert reloaded.info["duration"] == 0.5
+
+
+def test_apng_save_large_duration(tmp_path: Path) -> None:
+    test_file = tmp_path / "temp.png"
+    im = Image.new("1", (1, 1))
+    im2 = Image.new("1", (1, 1), 1)
+    with pytest.raises(ValueError, match="cannot write duration"):
+        im.save(test_file, save_all=True, append_images=[im2], duration=65536000)
+
+
 def test_apng_save_disposal(tmp_path: Path) -> None:
     test_file = tmp_path / "temp.png"
     size = (128, 64)
diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 03ee96c0f00..d26c0fbae5c 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1041,9 +1041,8 @@ following parameters can also be set:
     Defaults to 0.
 
 **duration**
-    Integer (or list or tuple of integers) length of time to display this APNG frame
-    (in milliseconds).
-    Defaults to 0.
+    The length of time (or list or tuple of lengths of time) to display this APNG frame
+    (in milliseconds). Defaults to 0.
 
 **disposal**
     An integer (or list or tuple of integers) specifying the APNG disposal
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index e3588735f20..5f536035a2d 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,6 +39,7 @@
 import warnings
 import zlib
 from enum import IntEnum
+from fractions import Fraction
 from typing import IO, NamedTuple, cast
 
 from . import Image, ImageChops, ImageFile, ImagePalette, ImageSequence
@@ -1272,7 +1273,11 @@ def _write_multiple_frames(
             im_frame = im_frame.crop(bbox)
         size = im_frame.size
         encoderinfo = frame_data.encoderinfo
-        frame_duration = int(round(encoderinfo.get("duration", 0)))
+        frame_duration = encoderinfo.get("duration", 0)
+        delay = Fraction(frame_duration / 1000).limit_denominator(65535)
+        if delay.numerator > 65535:
+            msg = "cannot write duration"
+            raise ValueError(msg)
         frame_disposal = encoderinfo.get("disposal", disposal)
         frame_blend = encoderinfo.get("blend", blend)
         # frame control
@@ -1284,8 +1289,8 @@ def _write_multiple_frames(
             o32(size[1]),  # height
             o32(bbox[0]),  # x_offset
             o32(bbox[1]),  # y_offset
-            o16(frame_duration),  # delay_numerator
-            o16(1000),  # delay_denominator
+            o16(delay.numerator),  # delay_numerator
+            o16(delay.denominator),  # delay_denominator
             o8(frame_disposal),  # dispose_op
             o8(frame_blend),  # blend_op
         )

From 43f8efad7988bee378408d8acafeaab6f0f70b85 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 1 Jan 2026 18:41:34 +1100
Subject: [PATCH 2200/2374] Added release notes for #9350 (#9366)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/releasenotes/12.1.0.rst | 44 ++++--------------------------------
 1 file changed, 4 insertions(+), 40 deletions(-)

diff --git a/docs/releasenotes/12.1.0.rst b/docs/releasenotes/12.1.0.rst
index b6e1810c60a..0541f882feb 100644
--- a/docs/releasenotes/12.1.0.rst
+++ b/docs/releasenotes/12.1.0.rst
@@ -1,42 +1,14 @@
 12.1.0
 ------
 
-Security
-========
-
-TODO
-^^^^
-
-TODO
-
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
-
-Backwards incompatible changes
-==============================
-
-TODO
-^^^^
-
-TODO
-
-Deprecations
-============
-
-TODO
-^^^^
-
-TODO
-
 API changes
 ===========
 
-TODO
-^^^^
+ImageMorph build_default_lut()
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+To match the behaviour of :py:meth:`~PIL.ImageMorph.LutBuilder.build_lut`,
+:py:meth:`~PIL.ImageMorph.LutBuilder.build_default_lut()` now returns the new LUT.
 
 API additions
 =============
@@ -49,11 +21,3 @@ macOS in addition to Windows. On macOS, this is a CGWindowID::
 
     from PIL import ImageGrab
     ImageGrab.grab(window=cgwindowid)
-
-Other changes
-=============
-
-TODO
-^^^^
-
-TODO

From a868c29eb196a082536e9a0895c4972f18c443ad Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 1 Jan 2026 20:01:38 +1100
Subject: [PATCH 2201/2374] Assert fp is not None (#8617)

---
 Tests/test_file_bufrstub.py    | 1 +
 Tests/test_file_gribstub.py    | 1 +
 Tests/test_file_hdf5stub.py    | 1 +
 Tests/test_file_jpeg.py        | 3 ++-
 Tests/test_file_libtiff.py     | 3 ++-
 Tests/test_file_tiff.py        | 5 ++++-
 Tests/test_image_load.py       | 1 +
 docs/example/DdsImagePlugin.py | 1 +
 src/PIL/AvifImagePlugin.py     | 2 ++
 src/PIL/BlpImagePlugin.py      | 1 +
 src/PIL/BmpImagePlugin.py      | 2 ++
 src/PIL/BufrStubImagePlugin.py | 1 +
 src/PIL/DcxImagePlugin.py      | 1 +
 src/PIL/EpsImagePlugin.py      | 2 ++
 src/PIL/FpxImagePlugin.py      | 2 ++
 src/PIL/FtexImagePlugin.py     | 1 +
 src/PIL/GbrImagePlugin.py      | 2 ++
 src/PIL/GifImagePlugin.py      | 2 ++
 src/PIL/GribStubImagePlugin.py | 1 +
 src/PIL/Hdf5StubImagePlugin.py | 1 +
 src/PIL/IcnsImagePlugin.py     | 1 +
 src/PIL/IcoImagePlugin.py      | 1 +
 src/PIL/ImImagePlugin.py       | 1 +
 src/PIL/Image.py               | 2 ++
 src/PIL/ImageFile.py           | 1 +
 src/PIL/IptcImagePlugin.py     | 3 +++
 src/PIL/Jpeg2KImagePlugin.py   | 2 ++
 src/PIL/JpegImagePlugin.py     | 7 +++++++
 src/PIL/MicImagePlugin.py      | 1 +
 src/PIL/MpoImagePlugin.py      | 2 ++
 src/PIL/PngImagePlugin.py      | 3 +++
 src/PIL/PsdImagePlugin.py      | 1 +
 src/PIL/QoiImagePlugin.py      | 1 +
 src/PIL/SpiderImagePlugin.py   | 1 +
 src/PIL/WalImageFile.py        | 2 ++
 src/PIL/WmfImagePlugin.py      | 2 ++
 36 files changed, 62 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_bufrstub.py b/Tests/test_file_bufrstub.py
index 362578c56ef..8c6bb1a69f7 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -61,6 +61,7 @@ def open(self, im: ImageFile.StubImageFile) -> None:
 
         def load(self, im: ImageFile.StubImageFile) -> Image.Image:
             self.loaded = True
+            assert im.fp is not None
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
diff --git a/Tests/test_file_gribstub.py b/Tests/test_file_gribstub.py
index 4dbed6b3190..05925d50202 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -61,6 +61,7 @@ def open(self, im: Image.Image) -> None:
 
         def load(self, im: ImageFile.ImageFile) -> Image.Image:
             self.loaded = True
+            assert im.fp is not None
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
diff --git a/Tests/test_file_hdf5stub.py b/Tests/test_file_hdf5stub.py
index 1e48597d366..e1a56309b90 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -63,6 +63,7 @@ def open(self, im: Image.Image) -> None:
 
         def load(self, im: ImageFile.ImageFile) -> Image.Image:
             self.loaded = True
+            assert im.fp is not None
             im.fp.close()
             return Image.new("RGB", (1, 1))
 
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index 96e7f4239b8..f818927f6a3 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1133,8 +1133,9 @@ def test_fd_leak(self, tmp_path: Path) -> None:
             im.save(tmpfile)
 
         im = Image.open(tmpfile)
+        assert im.fp is not None
+        assert not im.fp.closed
         fp = im.fp
-        assert not fp.closed
         with pytest.raises(OSError):
             os.remove(tmpfile)
         im.load()
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index e05563c6aa4..90ca2cf1216 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -610,8 +610,9 @@ 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.Image | None = Image.open("Tests/images/hopper_g4_500.tif")
+        im: ImageFile.ImageFile | None = Image.open("Tests/images/hopper_g4_500.tif")
         assert im is not None
+        assert im.fp is not None
         fn = im.fp.fileno()
 
         os.fstat(fn)
diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index 556c886476e..c6c8467d629 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -971,6 +971,7 @@ def test_close_on_load_exclusive(self, tmp_path: Path) -> None:
 
         im = Image.open(tmpfile)
         fp = im.fp
+        assert fp is not None
         assert not fp.closed
         im.load()
         assert fp.closed
@@ -984,6 +985,7 @@ def test_close_on_load_nonexclusive(self, tmp_path: Path) -> None:
         with open(tmpfile, "rb") as f:
             im = Image.open(f)
             fp = im.fp
+            assert fp is not None
             assert not fp.closed
             im.load()
             assert not fp.closed
@@ -1034,8 +1036,9 @@ def test_fd_leak(self, tmp_path: Path) -> None:
             im.save(tmpfile)
 
         im = Image.open(tmpfile)
+        assert im.fp is not None
+        assert not im.fp.closed
         fp = im.fp
-        assert not fp.closed
         with pytest.raises(OSError):
             os.remove(tmpfile)
         im.load()
diff --git a/Tests/test_image_load.py b/Tests/test_image_load.py
index 4f1d63b8f43..1d5f0d17cd6 100644
--- a/Tests/test_image_load.py
+++ b/Tests/test_image_load.py
@@ -38,6 +38,7 @@ def test_close_after_load(caplog: pytest.LogCaptureFixture) -> None:
 def test_contextmanager() -> None:
     fn = None
     with Image.open("Tests/images/hopper.gif") as im:
+        assert im.fp is not None
         fn = im.fp.fileno()
         os.fstat(fn)
 
diff --git a/docs/example/DdsImagePlugin.py b/docs/example/DdsImagePlugin.py
index e4b6b9c01b6..e0557976c28 100644
--- a/docs/example/DdsImagePlugin.py
+++ b/docs/example/DdsImagePlugin.py
@@ -213,6 +213,7 @@ class DdsImageFile(ImageFile.ImageFile):
     format_description = "DirectDraw Surface"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(4)):
             msg = "not a DDS file"
             raise SyntaxError(msg)
diff --git a/src/PIL/AvifImagePlugin.py b/src/PIL/AvifImagePlugin.py
index 366e0c864bf..43c39a9fbe7 100644
--- a/src/PIL/AvifImagePlugin.py
+++ b/src/PIL/AvifImagePlugin.py
@@ -77,6 +77,8 @@ def _open(self) -> None:
         ):
             msg = "Invalid opening codec"
             raise ValueError(msg)
+
+        assert self.fp is not None
         self._decoder = _avif.AvifDecoder(
             self.fp.read(),
             DECODE_CODEC_CHOICE,
diff --git a/src/PIL/BlpImagePlugin.py b/src/PIL/BlpImagePlugin.py
index f7be7746d84..6bb92edf891 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -258,6 +258,7 @@ class BlpImageFile(ImageFile.ImageFile):
     format_description = "Blizzard Mipmap Format"
 
     def _open(self) -> None:
+        assert self.fp is not None
         self.magic = self.fp.read(4)
         if not _accept(self.magic):
             msg = f"Bad BLP magic {repr(self.magic)}"
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 54fc69ab454..a1227137017 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -76,6 +76,7 @@ class BmpImageFile(ImageFile.ImageFile):
 
     def _bitmap(self, header: int = 0, offset: int = 0) -> None:
         """Read relevant info about the BMP"""
+        assert self.fp is not None
         read, seek = self.fp.read, self.fp.seek
         if header:
             seek(header)
@@ -311,6 +312,7 @@ def _bitmap(self, header: int = 0, offset: int = 0) -> None:
     def _open(self) -> None:
         """Open file, check magic number and read header"""
         # read 14 bytes: magic number, filesize, reserved, header final offset
+        assert self.fp is not None
         head_data = self.fp.read(14)
         # choke if the file does not have the required magic bytes
         if not _accept(head_data):
diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 8c5da14f5f6..264564d2bbb 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -41,6 +41,7 @@ class BufrStubImageFile(ImageFile.StubImageFile):
     format_description = "BUFR"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(4)):
             msg = "Not a BUFR file"
             raise SyntaxError(msg)
diff --git a/src/PIL/DcxImagePlugin.py b/src/PIL/DcxImagePlugin.py
index aea661b9cb6..d3f456ddcc4 100644
--- a/src/PIL/DcxImagePlugin.py
+++ b/src/PIL/DcxImagePlugin.py
@@ -45,6 +45,7 @@ class DcxImageFile(PcxImageFile):
 
     def _open(self) -> None:
         # Header
+        assert self.fp is not None
         s = self.fp.read(4)
         if not _accept(s):
             msg = "not a DCX file"
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 69f3062b4d4..2effb816cfb 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -189,6 +189,7 @@ class EpsImageFile(ImageFile.ImageFile):
     mode_map = {1: "L", 2: "LAB", 3: "RGB", 4: "CMYK"}
 
     def _open(self) -> None:
+        assert self.fp is not None
         (length, offset) = self._find_offset(self.fp)
 
         # go to offset - start of "%!PS"
@@ -403,6 +404,7 @@ def load(
     ) -> Image.core.PixelAccess | None:
         # Load EPS via Ghostscript
         if self.tile:
+            assert self.fp is not None
             self.im = Ghostscript(self.tile, self.size, self.fp, scale, transparency)
             self._mode = self.im.mode
             self._size = self.im.size
diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index fd992cd9e20..297971234d8 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -58,6 +58,7 @@ def _open(self) -> None:
         # read the OLE directory and see if this is a likely
         # to be a FlashPix file
 
+        assert self.fp is not None
         try:
             self.ole = olefile.OleFileIO(self.fp)
         except OSError as e:
@@ -229,6 +230,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
                 if y >= ysize:
                     break  # isn't really required
 
+        assert self.fp is not None
         self.stream = stream
         self._fp = self.fp
         self.fp = None
diff --git a/src/PIL/FtexImagePlugin.py b/src/PIL/FtexImagePlugin.py
index d60e75bb60b..e4d836cbdb2 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -72,6 +72,7 @@ class FtexImageFile(ImageFile.ImageFile):
     format_description = "Texture File Format (IW2:EOC)"
 
     def _open(self) -> None:
+        assert self.fp is not 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 d69295363f3..ec666c81c2c 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -42,6 +42,7 @@ class GbrImageFile(ImageFile.ImageFile):
     format_description = "GIMP brush file"
 
     def _open(self) -> None:
+        assert self.fp is not None
         header_size = i32(self.fp.read(4))
         if header_size < 20:
             msg = "not a GIMP brush"
@@ -88,6 +89,7 @@ def _open(self) -> None:
 
     def load(self) -> Image.core.PixelAccess | None:
         if self._im is None:
+            assert self.fp is not 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 0560a5a7dc8..b8755422d05 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -87,6 +87,7 @@ class GifImageFile(ImageFile.ImageFile):
     global_palette = None
 
     def data(self) -> bytes | None:
+        assert self.fp is not None
         s = self.fp.read(1)
         if s and s[0]:
             return self.fp.read(s[0])
@@ -100,6 +101,7 @@ def _is_palette_needed(self, p: bytes) -> bool:
 
     def _open(self) -> None:
         # Screen
+        assert self.fp is not None
         s = self.fp.read(13)
         if not _accept(s):
             msg = "not a GIF file"
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index dfa798893cb..146a6fa0df0 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -41,6 +41,7 @@ class GribStubImageFile(ImageFile.StubImageFile):
     format_description = "GRIB"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(8)):
             msg = "Not a GRIB file"
             raise SyntaxError(msg)
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index 76e640f15ab..1523e95d58c 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -41,6 +41,7 @@ class HDF5StubImageFile(ImageFile.StubImageFile):
     format_description = "HDF5"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(8)):
             msg = "Not an HDF file"
             raise SyntaxError(msg)
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 197ea7a2bb2..058861d67e5 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -265,6 +265,7 @@ class IcnsImageFile(ImageFile.ImageFile):
     format_description = "Mac OS icns resource"
 
     def _open(self) -> None:
+        assert self.fp is not 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 d5da07d470c..8dd57ff858a 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -340,6 +340,7 @@ class IcoImageFile(ImageFile.ImageFile):
     format_description = "Windows Icon"
 
     def _open(self) -> None:
+        assert self.fp is not 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 71b9996780c..ef54f16e97e 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -125,6 +125,7 @@ def _open(self) -> None:
         # Quick rejection: if there's not an LF among the first
         # 100 bytes, this is (probably) not a text header.
 
+        assert self.fp is not None
         if b"\n" not in self.fp.read(100):
             msg = "not an IM file"
             raise SyntaxError(msg)
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b71395c6234..4e61900f6fd 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1524,6 +1524,8 @@ def getexif(self) -> Exif:
                 assert isinstance(self, TiffImagePlugin.TiffImageFile)
                 self._exif.bigtiff = self.tag_v2._bigtiff
                 self._exif.endian = self.tag_v2._endian
+
+                assert self.fp is not None
                 self._exif.load_from_fp(self.fp, self.tag_v2._offset)
         if exif_info is not None:
             self._exif.load(exif_info)
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index ecb51b193e8..f609c7d13c2 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -286,6 +286,7 @@ def load(self) -> Image.core.PixelAccess | None:
         self.map: mmap.mmap | None = None
         use_mmap = self.filename and len(self.tile) == 1
 
+        assert self.fp is not None
         readonly = 0
 
         # look for read/seek overrides
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index cf7067daa79..6fc824e4caa 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -49,6 +49,7 @@ def getint(self, key: tuple[int, int]) -> int:
     def field(self) -> tuple[tuple[int, int] | None, int]:
         #
         # get a IPTC field header
+        assert self.fp is not None
         s = self.fp.read(5)
         if not s.strip(b"\x00"):
             return None, 0
@@ -76,6 +77,7 @@ def field(self) -> tuple[tuple[int, int] | None, int]:
 
     def _open(self) -> None:
         # load descriptive fields
+        assert self.fp is not None
         while True:
             offset = self.fp.tell()
             tag, size = self.field()
@@ -131,6 +133,7 @@ def load(self) -> Image.core.PixelAccess | None:
             assert isinstance(args, tuple)
             compression, band = args
 
+            assert self.fp is not None
             self.fp.seek(self.tile[0].offset)
 
             # Copy image data to temporary file
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index 4c85dd4e281..d6ec38d4310 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -252,6 +252,7 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
     format_description = "JPEG 2000 (ISO 15444)"
 
     def _open(self) -> None:
+        assert self.fp is not None
         sig = self.fp.read(4)
         if sig == b"\xff\x4f\xff\x51":
             self.codec = "j2k"
@@ -304,6 +305,7 @@ def _open(self) -> None:
         ]
 
     def _parse_comment(self) -> None:
+        assert self.fp is not None
         while True:
             marker = self.fp.read(2)
             if not marker:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 755ca648e55..894c1547d7b 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -61,6 +61,7 @@
 
 
 def Skip(self: JpegImageFile, marker: int) -> None:
+    assert self.fp is not None
     n = i16(self.fp.read(2)) - 2
     ImageFile._safe_read(self.fp, n)
 
@@ -70,6 +71,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
     # Application marker.  Store these in the APP dictionary.
     # Also look for well-known application markers.
 
+    assert self.fp is not None
     n = i16(self.fp.read(2)) - 2
     s = ImageFile._safe_read(self.fp, n)
 
@@ -174,6 +176,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
 def COM(self: JpegImageFile, marker: int) -> None:
     #
     # Comment marker.  Store these in the APP dictionary.
+    assert self.fp is not None
     n = i16(self.fp.read(2)) - 2
     s = ImageFile._safe_read(self.fp, n)
 
@@ -190,6 +193,7 @@ def SOF(self: JpegImageFile, marker: int) -> None:
     # mode.  Note that this could be made a bit brighter, by
     # looking for JFIF and Adobe APP markers.
 
+    assert self.fp is not None
     n = i16(self.fp.read(2)) - 2
     s = ImageFile._safe_read(self.fp, n)
     self._size = i16(s, 3), i16(s, 1)
@@ -240,6 +244,7 @@ def DQT(self: JpegImageFile, marker: int) -> None:
     # FIXME: The quantization tables can be used to estimate the
     # compression quality.
 
+    assert self.fp is not None
     n = i16(self.fp.read(2)) - 2
     s = ImageFile._safe_read(self.fp, n)
     while len(s):
@@ -340,6 +345,7 @@ class JpegImageFile(ImageFile.ImageFile):
     format_description = "JPEG (ISO 10918)"
 
     def _open(self) -> None:
+        assert self.fp is not None
         s = self.fp.read(3)
 
         if not _accept(s):
@@ -408,6 +414,7 @@ def load_read(self, read_bytes: int) -> bytes:
         For premature EOF and LOAD_TRUNCATED_IMAGES adds EOI marker
         so libjpeg can finish decoding
         """
+        assert self.fp is not None
         s = self.fp.read(read_bytes)
 
         if not s and ImageFile.LOAD_TRUNCATED_IMAGES and not hasattr(self, "_ended"):
diff --git a/src/PIL/MicImagePlugin.py b/src/PIL/MicImagePlugin.py
index 9ce38c427b6..99a07bae02c 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -67,6 +67,7 @@ def _open(self) -> None:
         self._n_frames = len(self.images)
         self.is_animated = self._n_frames > 1
 
+        assert self.fp is not None
         self.__fp = self.fp
         self.seek(0)
 
diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index b1ae07873ac..9360061ba18 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -106,6 +106,7 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
     _close_exclusive_fp_after_loading = False
 
     def _open(self) -> None:
+        assert self.fp is not None
         self.fp.seek(0)  # prep the fp in order to pass the JPEG test
         JpegImagePlugin.JpegImageFile._open(self)
         self._after_jpeg_open()
@@ -125,6 +126,7 @@ def _after_jpeg_open(self, mpheader: dict[int, Any] | None = None) -> None:
         assert self.n_frames == len(self.__mpoffsets)
         del self.info["mpoffset"]  # no longer needed
         self.is_animated = self.n_frames > 1
+        assert self.fp is not None
         self._fp = self.fp  # FIXME: hack
         self._fp.seek(self.__mpoffsets[0])  # get ready to read first frame
         self.__frame = 0
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index e3588735f20..2508f856644 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -759,6 +759,7 @@ class PngImageFile(ImageFile.ImageFile):
     format_description = "Portable network graphics"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(8)):
             msg = "not a PNG file"
             raise SyntaxError(msg)
@@ -988,6 +989,7 @@ def load_read(self, read_bytes: int) -> bytes:
         """internal: read more image data"""
 
         assert self.png is not None
+        assert self.fp is not None
         while self.__idat == 0:
             # end of chunk, skip forward to next one
 
@@ -1021,6 +1023,7 @@ def load_read(self, read_bytes: int) -> bytes:
     def load_end(self) -> None:
         """internal: finished reading image data"""
         assert self.png is not None
+        assert self.fp is not None
         if self.__idat != 0:
             self.fp.read(self.__idat)
         while True:
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index f49aaeeb1f5..69a8703dd8b 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -61,6 +61,7 @@ class PsdImageFile(ImageFile.ImageFile):
     _close_exclusive_fp_after_loading = False
 
     def _open(self) -> None:
+        assert self.fp is not None
         read = self.fp.read
 
         #
diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index dba5d809fef..d0709b1198a 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -25,6 +25,7 @@ class QoiImageFile(ImageFile.ImageFile):
     format_description = "Quite OK Image"
 
     def _open(self) -> None:
+        assert self.fp is not None
         if not _accept(self.fp.read(4)):
             msg = "not a QOI file"
             raise SyntaxError(msg)
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 7c3e84d7495..8662922437e 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -104,6 +104,7 @@ class SpiderImageFile(ImageFile.ImageFile):
     def _open(self) -> None:
         # check header
         n = 27 * 4  # read 27 float values
+        assert self.fp is not None
         f = self.fp.read(n)
 
         try:
diff --git a/src/PIL/WalImageFile.py b/src/PIL/WalImageFile.py
index 5494f62e892..fb3e1c06a32 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -39,6 +39,7 @@ def _open(self) -> None:
         self._mode = "P"
 
         # read header fields
+        assert self.fp is not None
         header = self.fp.read(32 + 24 + 32 + 12)
         self._size = i32(header, 32), i32(header, 36)
         Image._decompression_bomb_check(self.size)
@@ -54,6 +55,7 @@ def _open(self) -> None:
 
     def load(self) -> Image.core.PixelAccess | None:
         if self._im is None:
+            assert self.fp is not None
             self.im = Image.core.new(self.mode, self.size)
             self.frombytes(self.fp.read(self.size[0] * self.size[1]))
             self.putpalette(quake2palette)
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index de714d33794..3ae86242a8b 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -49,6 +49,7 @@ def open(self, im: ImageFile.StubImageFile) -> None:
             self.bbox = im.info["wmf_bbox"]
 
         def load(self, im: ImageFile.StubImageFile) -> Image.Image:
+            assert im.fp is not None
             im.fp.seek(0)  # rewind
             return Image.frombytes(
                 "RGB",
@@ -81,6 +82,7 @@ class WmfStubImageFile(ImageFile.StubImageFile):
 
     def _open(self) -> None:
         # check placeable header
+        assert self.fp is not None
         s = self.fp.read(44)
 
         if s.startswith(b"\xd7\xcd\xc6\x9a\x00\x00"):

From 51b35d17e1429a7a1fda48e61832fb9dd9bc2adf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 1 Jan 2026 20:15:05 +1100
Subject: [PATCH 2202/2374] Added fp type hint

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

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index f609c7d13c2..1df1d33a149 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -131,6 +131,7 @@ def __init__(
         self.decoderconfig: tuple[Any, ...] = ()
         self.decodermaxblock = MAXBLOCK
 
+        self.fp: IO[bytes] | None
         self._fp: IO[bytes] | DeferredError
         if is_path(fp):
             # filename
@@ -268,7 +269,7 @@ def verify(self) -> None:
 
         # raise exception if something's wrong.  must be called
         # directly after open, and closes file when finished.
-        if self._exclusive_fp:
+        if self._exclusive_fp and self.fp:
             self.fp.close()
         self.fp = None
 

From ce11a0c4993c284791b3100227cbd0338937074d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 1 Jan 2026 20:27:48 +1100
Subject: [PATCH 2203/2374] Added ImageFile context manager

---
 Tests/test_file_jpeg2k.py     |  2 +-
 Tests/test_file_png.py        |  2 +-
 Tests/test_file_ppm.py        |  2 +-
 Tests/test_image_transform.py |  4 ++--
 src/PIL/Image.py              | 11 +++--------
 src/PIL/ImageFile.py          |  9 +++++++++
 6 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index a5365a90d44..575d911def5 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -164,7 +164,7 @@ def test_reduce() -> None:
     with Image.open("Tests/images/test-card-lossless.jp2") as im:
         assert callable(im.reduce)
 
-        im.reduce = 2
+        im.reduce = 2  # type: ignore[assignment, method-assign]
         assert im.reduce == 2
 
         im.load()
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index e9830cd3dad..ed3a91285db 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -823,7 +823,7 @@ class MyStdOut:
         monkeypatch.setattr(sys, "stdout", mystdout)
 
         with Image.open(TEST_PNG_FILE) as im:
-            im.save(sys.stdout, "PNG")
+            im.save(sys.stdout, "PNG")  # type: ignore[arg-type]
 
         if isinstance(mystdout, MyStdOut):
             mystdout = mystdout.buffer
diff --git a/Tests/test_file_ppm.py b/Tests/test_file_ppm.py
index 598e9a445b6..fbca46be513 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -389,7 +389,7 @@ class MyStdOut:
     monkeypatch.setattr(sys, "stdout", mystdout)
 
     with Image.open(TEST_FILE) as im:
-        im.save(sys.stdout, "PPM")
+        im.save(sys.stdout, "PPM")  # type: ignore[arg-type]
 
     if isinstance(mystdout, MyStdOut):
         mystdout = mystdout.buffer
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 7cf52ddbabe..3e2b9fee8ed 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -250,14 +250,14 @@ def test_blank_fill(self) -> None:
     def test_missing_method_data(self) -> None:
         with hopper() as im:
             with pytest.raises(ValueError):
-                im.transform((100, 100), None)
+                im.transform((100, 100), None)  # type: ignore[arg-type]
 
     @pytest.mark.parametrize("resample", (Image.Resampling.BOX, "unknown"))
     def test_unknown_resampling_filter(self, resample: Image.Resampling | str) -> None:
         with hopper() as im:
             (w, h) = im.size
             with pytest.raises(ValueError):
-                im.transform((100, 100), Image.Transform.EXTENT, (0, 0, w, h), resample)
+                im.transform((100, 100), Image.Transform.EXTENT, (0, 0, w, h), resample)  # type: ignore[arg-type]
 
 
 class TestImageTransformAffine:
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 4e61900f6fd..b4de099be53 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -590,16 +590,11 @@ def _new(self, im: core.ImagingCore) -> Image:
         return new
 
     # Context manager support
-    def __enter__(self):
+    def __enter__(self) -> Image:
         return self
 
-    def __exit__(self, *args):
-        from . import ImageFile
-
-        if isinstance(self, ImageFile.ImageFile):
-            if getattr(self, "_exclusive_fp", False):
-                self._close_fp()
-            self.fp = None
+    def __exit__(self, *args: object) -> None:
+        pass
 
     def close(self) -> None:
         """
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 1df1d33a149..3390dfa97dd 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -169,6 +169,10 @@ def __init__(
     def _open(self) -> None:
         pass
 
+    # Context manager support
+    def __enter__(self) -> ImageFile:
+        return self
+
     def _close_fp(self) -> None:
         if getattr(self, "_fp", False) and not isinstance(self._fp, DeferredError):
             if self._fp != self.fp:
@@ -177,6 +181,11 @@ def _close_fp(self) -> None:
         if self.fp:
             self.fp.close()
 
+    def __exit__(self, *args: object) -> None:
+        if getattr(self, "_exclusive_fp", False):
+            self._close_fp()
+        self.fp = None
+
     def close(self) -> None:
         """
         Closes the file pointer, if possible.

From 2d589107fb3a4aba8389932a65ff771bf9b4deb1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Jan 2026 03:49:56 +1100
Subject: [PATCH 2204/2374] Specify APNG duration type when opening

---
 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 d26c0fbae5c..35ec99ece45 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -999,7 +999,7 @@ where applicable:
     The number of times to loop this APNG, 0 indicates infinite looping.
 
 **duration**
-    The time to display this APNG frame (in milliseconds).
+    The time to display this APNG frame (in milliseconds), given as a float.
 
 .. note::
 

From 432707ea810ae619e2a9e4a9737c169cacaa8eda Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Jan 2026 04:18:15 +1100
Subject: [PATCH 2205/2374] Added release notes for #9348

---
 docs/releasenotes/12.1.0.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/releasenotes/12.1.0.rst b/docs/releasenotes/12.1.0.rst
index 0541f882feb..5aaa52c905d 100644
--- a/docs/releasenotes/12.1.0.rst
+++ b/docs/releasenotes/12.1.0.rst
@@ -21,3 +21,11 @@ macOS in addition to Windows. On macOS, this is a CGWindowID::
 
     from PIL import ImageGrab
     ImageGrab.grab(window=cgwindowid)
+
+Other changes
+=============
+
+Added MorphOp support for 1 mode images
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+:py:class:`~PIL.ImageMorph.MorphOp` now supports both 1 mode and L mode images.

From 3baedf264804d199bc19458d11bcff02ce7598eb Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 2 Jan 2026 10:59:56 +1100
Subject: [PATCH 2206/2374] Deprecate getdata(), in favour of new
 get_flattened_data() (#9292)

---
 Tests/helper.py                  |  4 ++--
 Tests/test_box_blur.py           |  8 +++++--
 Tests/test_file_avif.py          |  2 --
 Tests/test_file_libtiff.py       |  1 -
 Tests/test_file_webp.py          |  2 --
 Tests/test_file_webp_alpha.py    |  4 ----
 Tests/test_file_webp_lossless.py |  1 -
 Tests/test_format_lab.py         | 12 +++++-----
 Tests/test_image.py              |  4 ++--
 Tests/test_image_array.py        |  2 +-
 Tests/test_image_crop.py         |  4 ++--
 Tests/test_image_getdata.py      | 20 ++++++++++++----
 Tests/test_image_putdata.py      | 39 ++++++++++++++++----------------
 Tests/test_image_resize.py       |  2 +-
 Tests/test_imagecms.py           | 12 +++++-----
 Tests/test_numpy.py              | 14 +++++-------
 docs/deprecations.rst            | 10 ++++++++
 docs/reference/Image.rst         |  1 +
 docs/releasenotes/12.1.0.rst     | 18 +++++++++++++++
 src/PIL/GifImagePlugin.py        |  2 +-
 src/PIL/Image.py                 | 19 ++++++++++++++++
 src/PIL/_deprecate.py            |  2 ++
 22 files changed, 117 insertions(+), 66 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index b93828f5832..d77b4b807ec 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -55,8 +55,8 @@ def convert_to_comparable(
     if a.mode == "P":
         new_a = Image.new("L", a.size)
         new_b = Image.new("L", b.size)
-        new_a.putdata(a.getdata())
-        new_b.putdata(b.getdata())
+        new_a.putdata(a.get_flattened_data())
+        new_b.putdata(b.get_flattened_data())
     elif a.mode == "I;16":
         new_a = a.convert("I")
         new_b = b.convert("I")
diff --git a/Tests/test_box_blur.py b/Tests/test_box_blur.py
index cb267b2048f..07e62db8ced 100644
--- a/Tests/test_box_blur.py
+++ b/Tests/test_box_blur.py
@@ -28,9 +28,13 @@ def box_blur(image: Image.Image, radius: float = 1, n: int = 1) -> Image.Image:
 
 
 def assert_image(im: Image.Image, data: list[list[int]], delta: int = 0) -> None:
-    it = iter(im.getdata())
+    it = iter(im.get_flattened_data())
     for data_row in data:
-        im_row = [next(it) for _ in range(im.size[0])]
+        im_row = []
+        for _ in range(im.width):
+            im_v = next(it)
+            assert isinstance(im_v, (int, float))
+            im_row.append(im_v)
         if any(abs(data_v - im_v) > delta for data_v, im_v in zip(data_row, im_row)):
             assert im_row == data_row
     with pytest.raises(StopIteration):
diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index 727191153a1..ffc4ce0210d 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -121,7 +121,6 @@ def test_read(self) -> None:
             assert image.size == (128, 128)
             assert image.format == "AVIF"
             assert image.get_format_mimetype() == "image/avif"
-            image.getdata()
 
             # generated with:
             # avifdec hopper.avif hopper_avif_write.png
@@ -143,7 +142,6 @@ def test_write_rgb(self, tmp_path: Path) -> None:
             assert reloaded.mode == "RGB"
             assert reloaded.size == (128, 128)
             assert reloaded.format == "AVIF"
-            reloaded.getdata()
 
             # avifdec hopper.avif avif/hopper_avif_write.png
             assert_image_similar_tofile(
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 90ca2cf1216..c2336c05856 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -42,7 +42,6 @@ def _assert_noerr(self, tmp_path: Path, im: ImageFile.ImageFile) -> None:
 
         # Does the data actually load
         im.load()
-        im.getdata()
 
         assert isinstance(im, TiffImagePlugin.TiffImageFile)
         assert im._compression == "group4"
diff --git a/Tests/test_file_webp.py b/Tests/test_file_webp.py
index 5456adf59d2..f996cce675c 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -60,7 +60,6 @@ def test_read_rgb(self) -> None:
             assert image.size == (128, 128)
             assert image.format == "WEBP"
             image.load()
-            image.getdata()
 
             # generated with:
             # dwebp -ppm ../../Tests/images/hopper.webp -o hopper_webp_bits.ppm
@@ -77,7 +76,6 @@ def _roundtrip(
             assert image.size == (128, 128)
             assert image.format == "WEBP"
             image.load()
-            image.getdata()
 
             if mode == self.rgb_mode:
                 # generated with: dwebp -ppm temp.webp -o hopper_webp_write.ppm
diff --git a/Tests/test_file_webp_alpha.py b/Tests/test_file_webp_alpha.py
index c573390c403..b1aa45f6b52 100644
--- a/Tests/test_file_webp_alpha.py
+++ b/Tests/test_file_webp_alpha.py
@@ -29,7 +29,6 @@ def test_read_rgba() -> None:
         assert image.size == (200, 150)
         assert image.format == "WEBP"
         image.load()
-        image.getdata()
 
         image.tobytes()
 
@@ -60,7 +59,6 @@ def test_write_lossless_rgb(tmp_path: Path) -> None:
         assert image.size == pil_image.size
         assert image.format == "WEBP"
         image.load()
-        image.getdata()
 
         assert_image_equal(image, pil_image)
 
@@ -83,7 +81,6 @@ def test_write_rgba(tmp_path: Path) -> None:
         assert image.size == (10, 10)
         assert image.format == "WEBP"
         image.load()
-        image.getdata()
 
         assert_image_similar(image, pil_image, 1.0)
 
@@ -133,7 +130,6 @@ def test_write_unsupported_mode_PA(tmp_path: Path) -> None:
         assert image.format == "WEBP"
 
         image.load()
-        image.getdata()
         with Image.open(file_path) as im:
             target = im.convert("RGBA")
 
diff --git a/Tests/test_file_webp_lossless.py b/Tests/test_file_webp_lossless.py
index 5eaa4f59906..b4c0448ac75 100644
--- a/Tests/test_file_webp_lossless.py
+++ b/Tests/test_file_webp_lossless.py
@@ -24,6 +24,5 @@ def test_write_lossless_rgb(tmp_path: Path) -> None:
         assert image.size == (128, 128)
         assert image.format == "WEBP"
         image.load()
-        image.getdata()
 
         assert_image_equal(image, hopper(RGB_MODE))
diff --git a/Tests/test_format_lab.py b/Tests/test_format_lab.py
index 4fcc37e88cc..5f4a704f213 100644
--- a/Tests/test_format_lab.py
+++ b/Tests/test_format_lab.py
@@ -13,15 +13,15 @@ def test_white() -> None:
 
         k = i.getpixel((0, 0))
 
-        L = i.getdata(0)
-        a = i.getdata(1)
-        b = i.getdata(2)
+        L = i.get_flattened_data(0)
+        a = i.get_flattened_data(1)
+        b = i.get_flattened_data(2)
 
     assert k == (255, 128, 128)
 
-    assert list(L) == [255] * 100
-    assert list(a) == [128] * 100
-    assert list(b) == [128] * 100
+    assert L == (255,) * 100
+    assert a == (128,) * 100
+    assert b == (128,) * 100
 
 
 def test_green() -> None:
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 88f55638ee9..afc6e8e166b 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1181,10 +1181,10 @@ def test_roundtrip_bytes_method(self, mode: str) -> None:
         assert reloaded.tobytes() == source_bytes
 
     @pytest.mark.parametrize("mode", Image.MODES)
-    def test_getdata_putdata(self, mode: str) -> None:
+    def test_get_flattened_data_putdata(self, mode: str) -> None:
         im = hopper(mode)
         reloaded = Image.new(mode, im.size)
-        reloaded.putdata(im.getdata())
+        reloaded.putdata(im.get_flattened_data())
         assert_image_equal(im, reloaded)
 
 
diff --git a/Tests/test_image_array.py b/Tests/test_image_array.py
index abb22f94967..220e128d168 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -78,7 +78,7 @@ def test(mode: str) -> tuple[str, tuple[int, int], bool]:
             },
         )
         out = Image.fromarray(wrapped)
-        return out.mode, out.size, list(i.getdata()) == list(out.getdata())
+        return out.mode, out.size, i.get_flattened_data() == out.get_flattened_data()
 
     # assert test("1") == ("1", (128, 100), True)
     assert test("L") == ("L", (128, 100), True)
diff --git a/Tests/test_image_crop.py b/Tests/test_image_crop.py
index b90ce84bc02..9df8883a4f0 100644
--- a/Tests/test_image_crop.py
+++ b/Tests/test_image_crop.py
@@ -95,10 +95,10 @@ def test_crop_zero() -> None:
 
     cropped = im.crop((10, 10, 20, 20))
     assert cropped.size == (10, 10)
-    assert cropped.getdata()[0] == (0, 0, 0)
+    assert cropped.getpixel((0, 0)) == (0, 0, 0)
 
     im = Image.new("RGB", (0, 0))
 
     cropped = im.crop((10, 10, 20, 20))
     assert cropped.size == (10, 10)
-    assert cropped.getdata()[2] == (0, 0, 0)
+    assert cropped.getpixel((2, 0)) == (0, 0, 0)
diff --git a/Tests/test_image_getdata.py b/Tests/test_image_getdata.py
index c8b213d841b..94d6cbaa2e7 100644
--- a/Tests/test_image_getdata.py
+++ b/Tests/test_image_getdata.py
@@ -1,23 +1,23 @@
 from __future__ import annotations
 
+import pytest
+
 from PIL import Image
 
 from .helper import hopper
 
 
 def test_sanity() -> None:
-    data = hopper().getdata()
-
-    len(data)
-    list(data)
+    data = hopper().get_flattened_data()
 
+    assert len(data) == 128 * 128
     assert data[0] == (20, 20, 70)
 
 
 def test_mode() -> None:
     def getdata(mode: str) -> tuple[float | tuple[int, ...] | None, int, int]:
         im = hopper(mode).resize((32, 30), Image.Resampling.NEAREST)
-        data = im.getdata()
+        data = im.get_flattened_data()
         return data[0], len(data), len(list(data))
 
     assert getdata("1") == (0, 960, 960)
@@ -28,3 +28,13 @@ def getdata(mode: str) -> tuple[float | tuple[int, ...] | None, int, int]:
     assert getdata("RGBA") == ((11, 13, 52, 255), 960, 960)
     assert getdata("CMYK") == ((244, 242, 203, 0), 960, 960)
     assert getdata("YCbCr") == ((16, 147, 123), 960, 960)
+
+
+def test_deprecation() -> None:
+    im = hopper()
+    with pytest.warns(DeprecationWarning, match="getdata"):
+        data = im.getdata()
+
+    assert len(data) == 128 * 128
+    assert data[0] == (20, 20, 70)
+    assert list(data)[0] == (20, 20, 70)
diff --git a/Tests/test_image_putdata.py b/Tests/test_image_putdata.py
index bf8e89b53ce..226cb4c14d8 100644
--- a/Tests/test_image_putdata.py
+++ b/Tests/test_image_putdata.py
@@ -2,6 +2,7 @@
 
 import sys
 from array import array
+from typing import cast
 
 import pytest
 
@@ -12,21 +13,19 @@
 
 def test_sanity() -> None:
     im1 = hopper()
+    for data in (im1.get_flattened_data(), im1.im):
+        im2 = Image.new(im1.mode, im1.size, 0)
+        im2.putdata(data)
 
-    data = list(im1.getdata())
+        assert_image_equal(im1, im2)
 
-    im2 = Image.new(im1.mode, im1.size, 0)
-    im2.putdata(data)
+        # readonly
+        im2 = Image.new(im1.mode, im2.size, 0)
+        im2.readonly = 1
+        im2.putdata(data)
 
-    assert_image_equal(im1, im2)
-
-    # readonly
-    im2 = Image.new(im1.mode, im2.size, 0)
-    im2.readonly = 1
-    im2.putdata(data)
-
-    assert not im2.readonly
-    assert_image_equal(im1, im2)
+        assert not im2.readonly
+        assert_image_equal(im1, im2)
 
 
 def test_long_integers() -> None:
@@ -60,22 +59,22 @@ def test_mode_with_L_with_float() -> None:
 @pytest.mark.parametrize("mode", ("I", "I;16", "I;16L", "I;16B"))
 def test_mode_i(mode: str) -> None:
     src = hopper("L")
-    data = list(src.getdata())
+    data = src.get_flattened_data()
     im = Image.new(mode, src.size, 0)
     im.putdata(data, 2, 256)
 
-    target = [2 * elt + 256 for elt in data]
-    assert list(im.getdata()) == target
+    target = tuple(2 * elt + 256 for elt in cast(tuple[int, ...], data))
+    assert im.get_flattened_data() == target
 
 
 def test_mode_F() -> None:
     src = hopper("L")
-    data = list(src.getdata())
+    data = src.get_flattened_data()
     im = Image.new("F", src.size, 0)
     im.putdata(data, 2.0, 256.0)
 
-    target = [2.0 * float(elt) + 256.0 for elt in data]
-    assert list(im.getdata()) == target
+    target = tuple(2.0 * float(elt) + 256.0 for elt in cast(tuple[int, ...], data))
+    assert im.get_flattened_data() == target
 
 
 def test_array_B() -> None:
@@ -86,7 +85,7 @@ def test_array_B() -> None:
     im = Image.new("L", (150, 100))
     im.putdata(arr)
 
-    assert len(im.getdata()) == len(arr)
+    assert len(im.get_flattened_data()) == len(arr)
 
 
 def test_array_F() -> None:
@@ -97,7 +96,7 @@ def test_array_F() -> None:
     arr = array("f", [0.0]) * 15000
     im.putdata(arr)
 
-    assert len(im.getdata()) == len(arr)
+    assert len(im.get_flattened_data()) == len(arr)
 
 
 def test_not_flattened() -> None:
diff --git a/Tests/test_image_resize.py b/Tests/test_image_resize.py
index 323d31f51fd..3e8979a5b11 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -160,7 +160,7 @@ 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)
+        assert r.getpixel((0, 0)) == (0, 0, 0)
 
     def test_unknown_filter(self) -> None:
         with pytest.raises(ValueError):
diff --git a/Tests/test_imagecms.py b/Tests/test_imagecms.py
index 5fd7caa7cc7..a30fb18b80a 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -274,13 +274,13 @@ def test_simple_lab() -> None:
     # not a linear luminance map. so L != 128:
     assert k == (137, 128, 128)
 
-    l_data = i_lab.getdata(0)
-    a_data = i_lab.getdata(1)
-    b_data = i_lab.getdata(2)
+    l_data = i_lab.get_flattened_data(0)
+    a_data = i_lab.get_flattened_data(1)
+    b_data = i_lab.get_flattened_data(2)
 
-    assert list(l_data) == [137] * 100
-    assert list(a_data) == [128] * 100
-    assert list(b_data) == [128] * 100
+    assert l_data == (137,) * 100
+    assert a_data == (128,) * 100
+    assert b_data == (128,) * 100
 
 
 def test_lab_color() -> None:
diff --git a/Tests/test_numpy.py b/Tests/test_numpy.py
index f6acb3affb6..113d3075532 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -20,21 +20,19 @@
 
 def test_numpy_to_image() -> None:
     def to_image(dtype: npt.DTypeLike, bands: int = 1, boolean: int = 0) -> Image.Image:
+        data = tuple(range(100))
         if bands == 1:
             if boolean:
-                data = [0, 255] * 50
-            else:
-                data = list(range(100))
+                data = (0, 255) * 50
             a = numpy.array(data, dtype=dtype)
             a.shape = TEST_IMAGE_SIZE
             i = Image.fromarray(a)
-            assert list(i.getdata()) == data
+            assert i.get_flattened_data() == data
         else:
-            data = list(range(100))
             a = numpy.array([[x] * bands for x in data], dtype=dtype)
             a.shape = TEST_IMAGE_SIZE[0], TEST_IMAGE_SIZE[1], bands
             i = Image.fromarray(a)
-            assert list(i.getchannel(0).getdata()) == list(range(100))
+            assert i.get_flattened_data(0) == tuple(range(100))
         return i
 
     # Check supported 1-bit integer formats
@@ -191,7 +189,7 @@ def test_putdata() -> None:
     arr = numpy.zeros((15000,), numpy.float32)
     im.putdata(arr)
 
-    assert len(im.getdata()) == len(arr)
+    assert len(im.get_flattened_data()) == len(arr)
 
 
 def test_resize() -> None:
@@ -248,7 +246,7 @@ def test_bool() -> None:
     a[0][0] = True
 
     im2 = Image.fromarray(a)
-    assert im2.getdata()[0] == 255
+    assert im2.getpixel((0, 0)) == 255
 
 
 def test_no_resource_warning_for_numpy_array() -> None:
diff --git a/docs/deprecations.rst b/docs/deprecations.rst
index cc5ac283fbf..b6a7af0a824 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -73,6 +73,16 @@ Image._show
 ``Image._show`` has been deprecated, and will be removed in Pillow 13 (2026-10-15).
 Use :py:meth:`~PIL.ImageShow.show` instead.
 
+Image getdata()
+~~~~~~~~~~~~~~~
+
+.. deprecated:: 12.1.0
+
+:py:meth:`~PIL.Image.Image.getdata` has been deprecated.
+:py:meth:`~PIL.Image.Image.get_flattened_data` can be used instead. This new method is
+identical, except that it returns a tuple of pixel values, instead of an internal
+Pillow data type.
+
 Removed features
 ----------------
 
diff --git a/docs/reference/Image.rst b/docs/reference/Image.rst
index e687229000b..adee49228d2 100644
--- a/docs/reference/Image.rst
+++ b/docs/reference/Image.rst
@@ -191,6 +191,7 @@ This helps to get the bounding box coordinates of the input image::
 .. automethod:: PIL.Image.Image.getchannel
 .. automethod:: PIL.Image.Image.getcolors
 .. automethod:: PIL.Image.Image.getdata
+.. automethod:: PIL.Image.Image.get_flattened_data
 .. automethod:: PIL.Image.Image.getexif
 .. automethod:: PIL.Image.Image.getextrema
 .. automethod:: PIL.Image.Image.getpalette
diff --git a/docs/releasenotes/12.1.0.rst b/docs/releasenotes/12.1.0.rst
index 5aaa52c905d..9740b700842 100644
--- a/docs/releasenotes/12.1.0.rst
+++ b/docs/releasenotes/12.1.0.rst
@@ -1,6 +1,17 @@
 12.1.0
 ------
 
+Deprecations
+============
+
+Image getdata()
+^^^^^^^^^^^^^^^
+
+:py:meth:`~PIL.Image.Image.getdata` has been deprecated.
+:py:meth:`~PIL.Image.Image.get_flattened_data` can be used instead. This new method is
+identical, except that it returns a tuple of pixel values, instead of an internal
+Pillow data type.
+
 API changes
 ===========
 
@@ -13,6 +24,13 @@ To match the behaviour of :py:meth:`~PIL.ImageMorph.LutBuilder.build_lut`,
 API additions
 =============
 
+Image get_flattened_data()
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+:py:meth:`~PIL.Image.Image.get_flattened_data` is identical to the deprecated
+:py:meth:`~PIL.Image.Image.getdata`, except that the new method returns a tuple of
+pixel values, instead of an internal Pillow data type.
+
 Specify window in ImageGrab on macOS
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index b8755422d05..76a0d4ab99f 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -753,7 +753,7 @@ def _write_multiple_frames(
                             if delta.mode == "P":
                                 # Convert to L without considering palette
                                 delta_l = Image.new("L", delta.size)
-                                delta_l.putdata(delta.getdata())
+                                delta_l.putdata(delta.get_flattened_data())
                                 delta = delta_l
                             mask = ImageMath.lambda_eval(
                                 lambda args: args["convert"](args["im"] * 255, "1"),
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index b4de099be53..57ebea68964 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1435,12 +1435,31 @@ def getdata(self, band: int | None = None) -> core.ImagingCore:
            value (e.g. 0 to get the "R" band from an "RGB" image).
         :returns: A sequence-like object.
         """
+        deprecate("Image.Image.getdata", 14, "get_flattened_data")
 
         self.load()
         if band is not None:
             return self.im.getband(band)
         return self.im  # could be abused
 
+    def get_flattened_data(
+        self, band: int | None = None
+    ) -> tuple[tuple[int, ...], ...] | tuple[float, ...]:
+        """
+        Returns the contents of this image as a tuple containing pixel values.
+        The sequence object is flattened, so that values for line one follow
+        directly after the values of line zero, and so on.
+
+        :param band: What band to return.  The default is to return
+           all bands.  To return a single band, pass in the index
+           value (e.g. 0 to get the "R" band from an "RGB" image).
+        :returns: A tuple containing pixel values.
+        """
+        self.load()
+        if band is not None:
+            return tuple(self.im.getband(band))
+        return tuple(self.im)
+
     def getextrema(self) -> tuple[float, float] | tuple[tuple[int, int], ...]:
         """
         Gets the minimum and maximum pixel values for each band in
diff --git a/src/PIL/_deprecate.py b/src/PIL/_deprecate.py
index 616a9aace9f..711c62ab2b1 100644
--- a/src/PIL/_deprecate.py
+++ b/src/PIL/_deprecate.py
@@ -48,6 +48,8 @@ def deprecate(
         raise RuntimeError(msg)
     elif when == 13:
         removed = "Pillow 13 (2026-10-15)"
+    elif when == 14:
+        removed = "Pillow 14 (2027-10-15)"
     else:
         msg = f"Unknown removal version: {when}. Update {__name__}?"
         raise ValueError(msg)

From 46f45f674d47b5d8bc54230dda8fe9e214598b87 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Jan 2026 17:03:05 +1100
Subject: [PATCH 2207/2374] 12.1.0 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 41cb17a3697..b32ff446a9e 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "12.1.0.dev0"
+__version__ = "12.1.0"

From 4337139f0caa7d858131ce8f36e2ded54c60fd60 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Jan 2026 20:16:49 +1100
Subject: [PATCH 2208/2374] 12.2.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 b32ff446a9e..96363e9f154 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "12.1.0"
+__version__ = "12.2.0.dev0"

From 5b677ca1c69b3b06b4a97ae5f22103dae12e8d6d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Jan 2026 20:31:47 +1100
Subject: [PATCH 2209/2374] Assert palette is not None

---
 Tests/test_imagedraw.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 44aec4a9e15..3c61833fe04 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -71,10 +71,12 @@ def test_sanity() -> None:
 def test_new_color() -> None:
     with Image.open("Tests/images/chi.gif") as im:
         draw = ImageDraw.Draw(im)
+        assert im.palette is not None
         assert len(im.palette.colors) == 249
 
         # Test drawing a new color onto the palette
         draw.line((0, 0), fill=(0, 0, 0))
+        assert im.palette is not None
         assert len(im.palette.colors) == 250
         assert im.palette.dirty
 

From 499b796556a67bf3a44434ee45a8bd3deed7e645 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 2 Jan 2026 12:30:14 +0200
Subject: [PATCH 2210/2374] Remove Sphinx dependency from mypy

---
 .ci/requirements-mypy.txt | 1 -
 docs/dater.py             | 6 +++---
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/.ci/requirements-mypy.txt b/.ci/requirements-mypy.txt
index 5b0e2eaf8d7..375b8fc5d40 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -9,7 +9,6 @@ packaging
 pyarrow-stubs
 pybind11
 pytest
-sphinx
 types-atheris
 types-defusedxml
 types-olefile
diff --git a/docs/dater.py b/docs/dater.py
index c0302b55c35..87dacbd5a12 100644
--- a/docs/dater.py
+++ b/docs/dater.py
@@ -11,7 +11,7 @@
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from sphinx.application import Sphinx
+    from typing import Any
 
 DOC_NAME_REGEX = re.compile(r"releasenotes/\d+\.\d+\.\d+")
 VERSION_TITLE_REGEX = re.compile(r"^(\d+\.\d+\.\d+)\n-+\n")
@@ -28,7 +28,7 @@ def get_date_for(git_version: str) -> str | None:
     return out.split()[0]
 
 
-def add_date(app: Sphinx, doc_name: str, source: list[str]) -> None:
+def add_date(app: Any, 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)
 
@@ -43,6 +43,6 @@ def add_date(app: Sphinx, doc_name: str, source: list[str]) -> None:
         source[0] = result
 
 
-def setup(app: Sphinx) -> dict[str, bool]:
+def setup(app: Any) -> dict[str, bool]:
     app.connect("source-read", add_date)
     return {"parallel_read_safe": True}

From 2360d0df1757747af4150253f170672cfafece91 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 2 Jan 2026 12:31:22 +0200
Subject: [PATCH 2211/2374] Revert "Use minimum supported Python version for
 Lint (#9364)"

This reverts commit 900636e7dbc8ead2caaae0e387096fa8bf6474d5.
---
 .github/workflows/lint.yml | 2 +-
 .pre-commit-config.yaml    | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 4f67be6f705..e2f8bf47ac4 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -23,7 +23,7 @@ jobs:
           persist-credentials: false
       - uses: actions/setup-python@v6
         with:
-          python-version: "3.10"
+          python-version: "3.x"
       - name: Install uv
         uses: astral-sh/setup-uv@v7
       - name: Lint
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 10343f91ae3..8477729e636 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -76,7 +76,7 @@ repos:
     rev: v0.24.1
     hooks:
       - id: validate-pyproject
-        additional_dependencies: [tomli, trove-classifiers>=2024.10.12]
+        additional_dependencies: [trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
     rev: 1.7.0

From e924cfd181258f3201a91f276283ab83939a6744 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 2 Jan 2026 21:32:22 +1100
Subject: [PATCH 2212/2374] Fix unclosed file warning

---
 Tests/test_imagemorph.py | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index daba3001557..aa8356b0b33 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -231,15 +231,15 @@ def test_negate() -> None:
 
 
 def test_incorrect_mode() -> None:
-    im = hopper()
     mop = ImageMorph.MorphOp(op_name="erosion8")
 
-    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
-        mop.apply(im)
-    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
-        mop.match(im)
-    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
-        mop.get_on_pixels(im)
+    with hopper() as im:
+        with pytest.raises(ValueError, match="Image mode must be 1 or L"):
+            mop.apply(im)
+        with pytest.raises(ValueError, match="Image mode must be 1 or L"):
+            mop.match(im)
+        with pytest.raises(ValueError, match="Image mode must be 1 or L"):
+            mop.get_on_pixels(im)
 
 
 def test_add_patterns() -> None:

From 555fb8371c9ea1c1492e7790f64e73ffb18cbfd8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 3 Jan 2026 08:16:37 +1100
Subject: [PATCH 2213/2374] Move from deprecated getdata to get_flattened_data

---
 selftest.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/selftest.py b/selftest.py
index c484d4e2d42..64898fc920d 100755
--- a/selftest.py
+++ b/selftest.py
@@ -76,7 +76,7 @@ def testimage() -> None:
     ('R', 'G', 'B')
     >>> im.getbbox()
     (0, 0, 128, 128)
-    >>> len(im.getdata())
+    >>> len(im.get_flattened_data())
     16384
     >>> im.getextrema()
     ((0, 255), (0, 255), (0, 255))

From 844b10f894569b95e195075c2927cec5ecdfcd95 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 3 Jan 2026 13:55:50 +1100
Subject: [PATCH 2214/2374] Update github-actions (#9375)

---
 .github/workflows/cifuzz.yml       |  4 ++--
 .github/workflows/docs.yml         |  2 +-
 .github/workflows/test-windows.yml |  4 ++--
 .github/workflows/test.yml         |  4 ++--
 .github/workflows/wheels.yml       | 16 ++++++++--------
 5 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/.github/workflows/cifuzz.yml b/.github/workflows/cifuzz.yml
index 6a86b8aeb3b..7e771f1b7d1 100644
--- a/.github/workflows/cifuzz.yml
+++ b/.github/workflows/cifuzz.yml
@@ -44,13 +44,13 @@ jobs:
         language: python
         dry-run: false
     - name: Upload New Crash
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@v6
       if: failure() && steps.build.outcome == 'success'
       with:
         name: artifacts
         path: ./out/artifacts
     - name: Upload Legacy Crash
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@v6
       if: steps.run.outcome == 'success'
       with:
         name: crash
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index e88abf16fbc..44af3e3dfdb 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -49,7 +49,7 @@ jobs:
       run: python3 .github/workflows/system-info.py
 
     - name: Cache libimagequant
-      uses: actions/cache@v4
+      uses: actions/cache@v5
       id: cache-libimagequant
       with:
         path: ~/cache-libimagequant
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index e864763da21..f123a4f22d8 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -112,7 +112,7 @@ jobs:
 
     - name: Cache build
       id: build-cache
-      uses: actions/cache@v4
+      uses: actions/cache@v5
       with:
         path: winbuild\build
         key:
@@ -217,7 +217,7 @@ jobs:
       shell: bash
 
     - name: Upload errors
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@v6
       if: failure()
       with:
         name: errors
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index da3eea06641..103d915c047 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -92,7 +92,7 @@ jobs:
 
     - name: Cache libimagequant
       if: startsWith(matrix.os, 'ubuntu')
-      uses: actions/cache@v4
+      uses: actions/cache@v5
       id: cache-libimagequant
       with:
         path: ~/cache-libimagequant
@@ -143,7 +143,7 @@ jobs:
         mkdir -p Tests/errors
 
     - name: Upload errors
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@v6
       if: failure()
       with:
         name: errors
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index fb71ead37b5..82f1b5e903f 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -134,7 +134,7 @@ jobs:
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
-      - uses: actions/upload-artifact@v5
+      - uses: actions/upload-artifact@v6
         with:
           name: dist-${{ matrix.name }}
           path: ./wheelhouse/*.whl
@@ -220,13 +220,13 @@ jobs:
         shell: cmd
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: dist-windows-${{ matrix.cibw_arch }}
           path: ./wheelhouse/*.whl
 
       - name: Upload fribidi.dll
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: fribidi-windows-${{ matrix.cibw_arch }}
           path: winbuild\build\bin\fribidi*
@@ -246,7 +246,7 @@ jobs:
 
     - run: make sdist
 
-    - uses: actions/upload-artifact@v5
+    - uses: actions/upload-artifact@v6
       with:
         name: dist-sdist
         path: dist/*.tar.gz
@@ -256,7 +256,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Count dists
     steps:
-      - uses: actions/download-artifact@v6
+      - uses: actions/download-artifact@v7
         with:
           pattern: dist-*
           path: dist
@@ -275,13 +275,13 @@ jobs:
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
     steps:
-      - uses: actions/download-artifact@v6
+      - uses: actions/download-artifact@v7
         with:
           pattern: dist-!(sdist)*
           path: dist
           merge-multiple: true
       - name: Upload wheels to scientific-python-nightly-wheels
-        uses: scientific-python/upload-nightly-action@b36e8c0c10dbcfd2e05bf95f17ef8c14fd708dbf # 0.6.2
+        uses: scientific-python/upload-nightly-action@5748273c71e2d8d3a61f3a11a16421c8954f9ecf # 0.6.3
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
@@ -297,7 +297,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v6
+      - uses: actions/download-artifact@v7
         with:
           pattern: dist-*
           path: dist

From 525842215f422589efcd78b01721e444fe60611a Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Sat, 3 Jan 2026 13:59:38 +1100
Subject: [PATCH 2215/2374] Update dependency mypy to v1.19.1 (#9374)

---
 .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 375b8fc5d40..c64343a7347 100644
--- a/.ci/requirements-mypy.txt
+++ b/.ci/requirements-mypy.txt
@@ -1,4 +1,4 @@
-mypy==1.19.0
+mypy==1.19.1
 arro3-compute
 arro3-core
 IceSpringPySideStubs-PyQt6

From 36cf82ae76f5e3a728b9752308513aaceb2250f8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 3 Jan 2026 16:25:37 +1100
Subject: [PATCH 2216/2374] Updated xorgproto to 2025.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 e1586b7c5a3..1485f074a99 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -267,7 +267,7 @@ function build {
 
     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 xorgproto 2025.1 https://www.x.org/pub/individual/proto
         build_simple libXau 1.0.12 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
     else

From b8351fde412985f6f03dda40ae97019ab2e63401 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 3 Jan 2026 17:08:17 +1100
Subject: [PATCH 2217/2374] Added type hints to map_metadata_keys() (#9337)

---
 Tests/test_pyroma.py | 21 +++++++++++++--------
 pyproject.toml       |  1 +
 2 files changed, 14 insertions(+), 8 deletions(-)

diff --git a/Tests/test_pyroma.py b/Tests/test_pyroma.py
index 5871a72134a..915dbe7b685 100644
--- a/Tests/test_pyroma.py
+++ b/Tests/test_pyroma.py
@@ -6,10 +6,15 @@
 
 from PIL import __version__
 
+TYPE_CHECKING = False
+
+if TYPE_CHECKING:
+    from importlib.metadata import PackageMetadata
+
 pyroma = pytest.importorskip("pyroma", reason="Pyroma not installed")
 
 
-def map_metadata_keys(md):
+def map_metadata_keys(md: PackageMetadata) -> dict[str, str | list[str] | None]:
     # Convert installed wheel metadata into canonical Core Metadata 2.4 format.
     # This was a utility method in pyroma 4.3.3; it was removed in 5.0.
     # This implementation is constructed from the relevant logic from
@@ -17,16 +22,16 @@ def map_metadata_keys(md):
     # upstream to Pyroma as https://github.com/regebro/pyroma/pull/116,
     # so it may be possible to simplify this test in future.
     data = {}
-    for key in set(md.keys()):
+    for key in set(md):
         value = md.get_all(key)
         key = pyroma.projectdata.normalize(key)
 
-        if len(value) == 1:
-            value = value[0]
-            if value.strip() == "UNKNOWN":
-                continue
-
-        data[key] = value
+        if value is not None and len(value) == 1:
+            first_value = value[0]
+            if first_value.strip() != "UNKNOWN":
+                data[key] = first_value
+        else:
+            data[key] = value
     return data
 
 
diff --git a/pyproject.toml b/pyproject.toml
index f4514925d1c..cc616bc547c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -217,6 +217,7 @@ testpaths = [
 python_version = "3.10"
 pretty = true
 disallow_any_generics = true
+disallow_untyped_defs = true
 enable_error_code = "ignore-without-code"
 extra_checks = true
 follow_imports = "silent"

From bc0e2c0e61a548dbf566a25a53812b969b616b6d Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 3 Jan 2026 20:18:57 +1100
Subject: [PATCH 2218/2374] Remove add-imaging-libs option from setup.py
 (#9378)

Co-authored-by: Alexander Karpinsky <homm86@gmail.com>
---
 setup.py | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/setup.py b/setup.py
index 032c1c6d263..35bea6fa44e 100644
--- a/setup.py
+++ b/setup.py
@@ -363,7 +363,6 @@ def __iter__(self) -> Iterator[str]:
             ("disable-platform-guessing", None, "Disable platform guessing"),
             ("debug", None, "Debug logging"),
         ]
-        + [("add-imaging-libs=", None, "Add libs to _imaging build")]
     )
 
     @staticmethod
@@ -374,7 +373,6 @@ def initialize_options(self) -> 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}", self.check_configuration(x, "disable"))
@@ -901,7 +899,6 @@ def build_extensions(self) -> None:
         # core library
 
         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"))

From fe236d77a55c648538149665fcd8dc76093afdad Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 3 Jan 2026 11:32:19 +0200
Subject: [PATCH 2219/2374] Add seven-day cooldown to Renovate

---
 .github/renovate.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/renovate.json b/.github/renovate.json
index 91fa0426f9e..8187fc15b95 100644
--- a/.github/renovate.json
+++ b/.github/renovate.json
@@ -6,6 +6,7 @@
     "labels": [
         "Dependency"
     ],
+    "minimumReleaseAge": "7 days",
     "packageRules": [
         {
             "groupName": "github-actions",

From 2210714a436f1f9c5b70cd8912c99d67c48e6105 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 5 Jan 2026 17:20:09 +0000
Subject: [PATCH 2220/2374] [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.14.7 → v0.14.10](https://github.com/astral-sh/ruff-pre-commit/compare/v0.14.7...v0.14.10)
- [github.com/psf/black-pre-commit-mirror: 25.11.0 → 25.12.0](https://github.com/psf/black-pre-commit-mirror/compare/25.11.0...25.12.0)
- [github.com/pre-commit/mirrors-clang-format: v21.1.6 → v21.1.8](https://github.com/pre-commit/mirrors-clang-format/compare/v21.1.6...v21.1.8)
- [github.com/python-jsonschema/check-jsonschema: 0.35.0 → 0.36.0](https://github.com/python-jsonschema/check-jsonschema/compare/0.35.0...0.36.0)
- [github.com/zizmorcore/zizmor-pre-commit: v1.18.0 → v1.19.0](https://github.com/zizmorcore/zizmor-pre-commit/compare/v1.18.0...v1.19.0)
- [github.com/tox-dev/tox-ini-fmt: 1.7.0 → 1.7.1](https://github.com/tox-dev/tox-ini-fmt/compare/1.7.0...1.7.1)
---
 .pre-commit-config.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 8477729e636..12b3d4b4a3d 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.14.7
+    rev: v0.14.10
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.11.0
+    rev: 25.12.0
     hooks:
       - id: black
 
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v21.1.6
+    rev: v21.1.8
     hooks:
       - id: clang-format
         types: [c]
@@ -51,14 +51,14 @@ repos:
         exclude: ^\.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.35.0
+    rev: 0.36.0
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.18.0
+    rev: v1.19.0
     hooks:
       - id: zizmor
 
@@ -79,7 +79,7 @@ repos:
         additional_dependencies: [trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.7.0
+    rev: 1.7.1
     hooks:
       - id: tox-ini-fmt
 

From dcd52ebf652399d4f900cbc5579e97902ed1ff4d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 6 Jan 2026 09:56:56 +1100
Subject: [PATCH 2221/2374] Simplified code

---
 Tests/test_file_psd.py | 28 +++++++++++++---------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 38a88cd17a8..8f2ca58a662 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -100,7 +100,7 @@ def test_seek_tell() -> None:
 
         im.seek(2)
         layer_number = im.tell()
-        assert layer_number == 2
+    assert layer_number == 2
 
 
 def test_seek_eoferror() -> None:
@@ -138,7 +138,7 @@ def test_icc_profile() -> None:
         assert "icc_profile" in im.info
 
         icc_profile = im.info["icc_profile"]
-        assert len(icc_profile) == 3144
+    assert len(icc_profile) == 3144
 
 
 def test_no_icc_profile() -> None:
@@ -158,17 +158,16 @@ def test_combined_larger_than_size() -> None:
 
 
 @pytest.mark.parametrize(
-    "test_file,raises",
+    "test_file",
     [
-        ("Tests/images/timeout-c8efc3fded6426986ba867a399791bae544f59bc.psd", OSError),
-        ("Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd", OSError),
+        "Tests/images/timeout-c8efc3fded6426986ba867a399791bae544f59bc.psd",
+        "Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd",
     ],
 )
-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):
-                pass
+def test_crashes(test_file: str) -> None:
+    with pytest.raises(OSError):
+        with Image.open(test_file):
+            pass
 
 
 @pytest.mark.parametrize(
@@ -179,8 +178,7 @@ def test_crashes(test_file: str, raises: type[Exception]) -> None:
     ],
 )
 def test_layer_crashes(test_file: str) -> None:
-    with open(test_file, "rb") as f:
-        with Image.open(f) as im:
-            assert isinstance(im, PsdImagePlugin.PsdImageFile)
-            with pytest.raises(SyntaxError):
-                im.layers
+    with Image.open(test_file) as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
+        with pytest.raises(SyntaxError):
+            im.layers

From 426ad8307dd6220a1158a7f895bdc371c5343356 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 8 Jan 2026 19:27:19 +1100
Subject: [PATCH 2222/2374] Fix joining rounded rectangle corners

---
 .../images/imagedraw_rounded_rectangle_radius.png | Bin 0 -> 456 bytes
 Tests/test_imagedraw.py                           |  12 ++++++++++++
 src/PIL/ImageDraw.py                              |   2 +-
 3 files changed, 13 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/imagedraw_rounded_rectangle_radius.png

diff --git a/Tests/images/imagedraw_rounded_rectangle_radius.png b/Tests/images/imagedraw_rounded_rectangle_radius.png
new file mode 100644
index 0000000000000000000000000000000000000000..e2acf7be1b16f947afabda958c9ff8c7644fa15c
GIT binary patch
literal 456
zcmeAS@N?(olHy`uVBq!ia0vp^DIm<j1SJ1AFflVQF!p=8IEGZrd3*a}ShImZ%fl<`
z_s!RbS81pmYdmvd-sk#qrgvt^3%0gg18RYR|KE1}X8p6`H2aUcQej8yKhBzcXw`Pj
zMIG&-`SAsBw6CwKWP7&4a>A@g)0_Y2$bOh1E8w9k6vq4A$JpwZw&~tk*KS4c<7F>U
zTDCSZ<@zbVSyI{C|9S71xEyA`sq}049PuBoa-wHk*>LNUSoFp6!&^OnX7$}TwCXS0
z{S{VIZTH$FUaf2X{eJ#Q?Lw)vb5k6|og=pHd*Zou$GqA!Rs93+;#MDCb@c1HRa1}d
zG1j(R%Otz`zEzFIAt4>!)p2#F<~RS{ch&lZNZPc94J<9H3ObC5oE+W`5ln}K1VBQ^
z>dT*fpJ4l~c6Ip$%`+g`J&8}xyJWlX3lqEHfB4ChqVJEwW+)Ukp7&YjF#W>Y>hB&_
zUwLJVxt(h&QzvCTJRjM&XHvex%cD8j$Hn4)9-kGobmhix>!sc$ZY}cn{kEC!-vYZ;
tZy5U*b5v;g9QfSEG%tk}7Oo5o2hHWSct?B*OYZ@RdAj<!taD0e0sslN&k6tl

literal 0
HcmV?d00001

diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 3c61833fe04..1eae053837e 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -895,6 +895,18 @@ def test_rounded_rectangle_joined_x_different_corners() -> None:
     )
 
 
+def test_rounded_rectangle_radius() -> None:
+    # Arrange
+    im = Image.new("RGB", (W, H))
+    draw = ImageDraw.Draw(im, "RGB")
+
+    # Act
+    draw.rounded_rectangle((25, 25, 75, 75), 24, fill="red", outline="green", width=5)
+
+    # Assert
+    assert_image_equal_tofile(im, "Tests/images/imagedraw_rounded_rectangle_radius.png")
+
+
 @pytest.mark.parametrize(
     "xy, radius, type",
     [
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index 8bcf2d8ee06..eb108ac41ca 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -487,7 +487,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)
-            elif x1 - r - 1 > x0 + r + 1:
+            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 d7dfeeb7adb365fb7416865d54daec344e17d427 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Jan 2026 06:46:04 +1100
Subject: [PATCH 2223/2374] Updated lcms2 to 2.18

---
 .github/workflows/wheels-dependencies.sh   | 2 +-
 docs/installation/building-from-source.rst | 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 1485f074a99..f62bdec3d5d 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -102,7 +102,7 @@ OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.2
 ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.1
-LCMS2_VERSION=2.17
+LCMS2_VERSION=2.18
 ZLIB_NG_VERSION=2.3.2
 LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
diff --git a/docs/installation/building-from-source.rst b/docs/installation/building-from-source.rst
index c86ebe896a7..1655b8f6015 100644
--- a/docs/installation/building-from-source.rst
+++ b/docs/installation/building-from-source.rst
@@ -51,7 +51,7 @@ Many of Pillow's features require external libraries:
 * **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.17**.
+    above uses liblcms2. Tested with **1.19** and **2.7-2.18**.
 
 * **libwebp** provides the WebP format.
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 3377d952c0d..1cbb0695d09 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -118,7 +118,7 @@ def cmd_msbuild(
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "12.3.0",
     "JPEGTURBO": "3.1.3",
-    "LCMS2": "2.17",
+    "LCMS2": "2.18",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.4.1",
     "LIBPNG": "1.6.53",

From 400ffbc18d43ea41b5d47c3dad3a2d7a4510ad56 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 10 Jan 2026 14:37:18 +1100
Subject: [PATCH 2224/2374] Raise EOFError when seeking too far

---
 Tests/test_file_psd.py    | 5 +++++
 src/PIL/PsdImagePlugin.py | 3 +++
 2 files changed, 8 insertions(+)

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 8f2ca58a662..da572ae6338 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -85,6 +85,11 @@ def test_eoferror() -> None:
         # Test that seeking to the last frame does not raise an error
         im.seek(n_frames - 1)
 
+    # Test seeking past the last frame without calling n_frames first
+    with Image.open(test_file) as im:
+        with pytest.raises(EOFError):
+            im.seek(3)
+
 
 def test_seek_tell() -> None:
     with Image.open(test_file) as im:
diff --git a/src/PIL/PsdImagePlugin.py b/src/PIL/PsdImagePlugin.py
index 69a8703dd8b..dd3d5ab95fd 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -175,6 +175,9 @@ def seek(self, layer: int) -> None:
             raise self._fp.ex
 
         # seek to given layer (1..max)
+        if layer > len(self.layers):
+            msg = "no more images in PSD file"
+            raise EOFError(msg)
         _, mode, _, tile = self.layers[layer - 1]
         self._mode = mode
         self.tile = tile

From 0f4becea731185977f4724e1cd05bd4558daeb82 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 12 Jan 2026 19:01:09 +1100
Subject: [PATCH 2225/2374] Link to m from _imagingmath, except on Windows

---
 setup.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 35bea6fa44e..3d975950b6c 100644
--- a/setup.py
+++ b/setup.py
@@ -1089,7 +1089,11 @@ def debug_build() -> bool:
     Extension("PIL._webp", ["src/_webp.c"]),
     Extension("PIL._avif", ["src/_avif.c"]),
     Extension("PIL._imagingtk", ["src/_imagingtk.c", "src/Tk/tkImaging.c"]),
-    Extension("PIL._imagingmath", ["src/_imagingmath.c"]),
+    Extension(
+        "PIL._imagingmath",
+        ["src/_imagingmath.c"],
+        libraries=None if sys.platform == "win32" else ["m"],
+    ),
     Extension("PIL._imagingmorph", ["src/_imagingmorph.c"]),
 ]
 

From 7e208ccf9d1cae412c6d9d3e335b903e4e595fa6 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 13 Jan 2026 23:49:10 +1100
Subject: [PATCH 2226/2374] Change to ValueError when encoding an empty image

---
 Tests/test_file_jpeg.py    | 2 +-
 Tests/test_file_libtiff.py | 2 +-
 src/PIL/JpegImagePlugin.py | 4 ----
 src/encode.c               | 4 ++++
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index f818927f6a3..d78ed0401e2 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -85,7 +85,7 @@ def test_sanity(self) -> None:
     def test_zero(self, size: tuple[int, int], tmp_path: Path) -> None:
         f = tmp_path / "temp.jpg"
         im = Image.new("RGB", size)
-        with pytest.raises(ValueError):
+        with pytest.raises(ValueError, match="cannot write empty image"):
             im.save(f)
 
     def test_app(self) -> None:
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index c2336c05856..2ff5de4496b 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1244,7 +1244,7 @@ def test_save_single_strip(
     def test_save_zero(self, compression: str | None, tmp_path: Path) -> None:
         im = Image.new("RGB", (0, 0))
         out = tmp_path / "temp.tif"
-        with pytest.raises(SystemError):
+        with pytest.raises(ValueError, match="cannot write empty image"):
             im.save(out, compression=compression)
 
     def test_save_many_compressed(self, tmp_path: Path) -> None:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 894c1547d7b..2f11cbfe313 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -661,10 +661,6 @@ def get_sampling(im: Image.Image) -> int:
 
 
 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)
-
     try:
         rawmode = RAWMODE[im.mode]
     except KeyError as e:
diff --git a/src/encode.c b/src/encode.c
index 513309c8d7d..7afe36cb3a0 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -239,6 +239,10 @@ _setimage(ImagingEncoderObject *encoder, PyObject *args) {
     if (!im) {
         return NULL;
     }
+    if (im->xsize == 0 || im->ysize == 0) {
+        PyErr_SetString(PyExc_ValueError, "cannot write empty image");
+        return NULL;
+    }
 
     encoder->im = im;
 

From 2e9d54887b71467e0494eec06d7c242c6d6e1575 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 14 Jan 2026 19:42:18 +1100
Subject: [PATCH 2227/2374] Improved coverage

---
 Tests/test_imagepalette.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 6ad21502f9f..10b89a2c0c2 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -1,10 +1,11 @@
 from __future__ import annotations
 
+from io import BytesIO
 from pathlib import Path
 
 import pytest
 
-from PIL import Image, ImagePalette
+from PIL import Image, ImagePalette, PaletteFile
 
 from .helper import assert_image_equal, assert_image_equal_tofile
 
@@ -202,6 +203,19 @@ def test_2bit_palette(tmp_path: Path) -> None:
     assert_image_equal_tofile(img, outfile)
 
 
+def test_getpalette() -> None:
+    b = BytesIO(b"0 1\n1 2 3 4")
+    p = PaletteFile.PaletteFile(b)
+
+    palette, rawmode = p.getpalette()
+    assert palette[:6] == b"\x01\x01\x01\x02\x03\x04"
+    assert rawmode == "RGB"
+
+
 def test_invalid_palette() -> None:
     with pytest.raises(OSError):
         ImagePalette.load("Tests/images/hopper.jpg")
+
+    b = BytesIO(b"1" * 101)
+    with pytest.raises(SyntaxError, match="bad palette file"):
+        PaletteFile.PaletteFile(b)

From ef8ff756fa5973f7fc08c573ba97d5a411bc0751 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 15 Jan 2026 12:10:01 +1100
Subject: [PATCH 2228/2374] Updated libpng to 1.6.54

---
 .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 1485f074a99..7c00f4b8028 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -96,7 +96,7 @@ else
   FREETYPE_VERSION=2.14.1
 fi
 HARFBUZZ_VERSION=12.3.0
-LIBPNG_VERSION=1.6.53
+LIBPNG_VERSION=1.6.54
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.2
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 3377d952c0d..6ebc1669067 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.4.1",
-    "LIBPNG": "1.6.53",
+    "LIBPNG": "1.6.54",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",

From 6b9de40533cf4ec60fcbb6c7351eed417dd2b042 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sun, 18 Jan 2026 22:59:28 +0200
Subject: [PATCH 2229/2374] Lazy import only required plugin

---
 src/PIL/Image.py | 126 ++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 115 insertions(+), 11 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index eb561611718..cd1abb9353b 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -323,6 +323,99 @@ def getmodebands(mode: str) -> int:
 
 _initialized = 0
 
+# Mapping from file extension to plugin module name for lazy loading
+_EXTENSION_PLUGIN: dict[str, str] = {
+    # Common formats (preinit)
+    ".bmp": "BmpImagePlugin",
+    ".dib": "BmpImagePlugin",
+    ".gif": "GifImagePlugin",
+    ".jfif": "JpegImagePlugin",
+    ".jpe": "JpegImagePlugin",
+    ".jpg": "JpegImagePlugin",
+    ".jpeg": "JpegImagePlugin",
+    ".pbm": "PpmImagePlugin",
+    ".pgm": "PpmImagePlugin",
+    ".pnm": "PpmImagePlugin",
+    ".ppm": "PpmImagePlugin",
+    ".pfm": "PpmImagePlugin",
+    ".png": "PngImagePlugin",
+    ".apng": "PngImagePlugin",
+    # Less common formats (init)
+    ".avif": "AvifImagePlugin",
+    ".avifs": "AvifImagePlugin",
+    ".blp": "BlpImagePlugin",
+    ".bufr": "BufrStubImagePlugin",
+    ".cur": "CurImagePlugin",
+    ".dcx": "DcxImagePlugin",
+    ".dds": "DdsImagePlugin",
+    ".ps": "EpsImagePlugin",
+    ".eps": "EpsImagePlugin",
+    ".fit": "FitsImagePlugin",
+    ".fits": "FitsImagePlugin",
+    ".fli": "FliImagePlugin",
+    ".flc": "FliImagePlugin",
+    ".fpx": "FpxImagePlugin",
+    ".ftc": "FtexImagePlugin",
+    ".ftu": "FtexImagePlugin",
+    ".gbr": "GbrImagePlugin",
+    ".grib": "GribStubImagePlugin",
+    ".h5": "Hdf5StubImagePlugin",
+    ".hdf": "Hdf5StubImagePlugin",
+    ".icns": "IcnsImagePlugin",
+    ".ico": "IcoImagePlugin",
+    ".im": "ImImagePlugin",
+    ".iim": "IptcImagePlugin",
+    ".jp2": "Jpeg2KImagePlugin",
+    ".j2k": "Jpeg2KImagePlugin",
+    ".jpc": "Jpeg2KImagePlugin",
+    ".jpf": "Jpeg2KImagePlugin",
+    ".jpx": "Jpeg2KImagePlugin",
+    ".j2c": "Jpeg2KImagePlugin",
+    ".mic": "MicImagePlugin",
+    ".mpg": "MpegImagePlugin",
+    ".mpeg": "MpegImagePlugin",
+    ".mpo": "MpoImagePlugin",
+    ".msp": "MspImagePlugin",
+    ".palm": "PalmImagePlugin",
+    ".pcd": "PcdImagePlugin",
+    ".pcx": "PcxImagePlugin",
+    ".pdf": "PdfImagePlugin",
+    ".pxr": "PixarImagePlugin",
+    ".psd": "PsdImagePlugin",
+    ".qoi": "QoiImagePlugin",
+    ".bw": "SgiImagePlugin",
+    ".rgb": "SgiImagePlugin",
+    ".rgba": "SgiImagePlugin",
+    ".sgi": "SgiImagePlugin",
+    ".ras": "SunImagePlugin",
+    ".tga": "TgaImagePlugin",
+    ".icb": "TgaImagePlugin",
+    ".vda": "TgaImagePlugin",
+    ".vst": "TgaImagePlugin",
+    ".tif": "TiffImagePlugin",
+    ".tiff": "TiffImagePlugin",
+    ".webp": "WebPImagePlugin",
+    ".wmf": "WmfImagePlugin",
+    ".emf": "WmfImagePlugin",
+    ".xbm": "XbmImagePlugin",
+    ".xpm": "XpmImagePlugin",
+}
+
+
+def _load_plugin_for_extension(ext: str | bytes) -> bool:
+    """Load only the plugin needed for a specific file extension."""
+    if isinstance(ext, bytes):
+        ext = ext.decode()
+    plugin = _EXTENSION_PLUGIN.get(ext.lower())
+    if plugin is None:
+        return False
+
+    try:
+        __import__(f"PIL.{plugin}", globals(), locals(), [])
+        return True
+    except ImportError:
+        return False
+
 
 def preinit() -> None:
     """
@@ -2535,11 +2628,13 @@ def save(
             # only set the name for metadata purposes
             filename = os.fspath(fp.name)
 
-        preinit()
-
         filename_ext = os.path.splitext(filename)[1].lower()
         ext = filename_ext.decode() if isinstance(filename_ext, bytes) else filename_ext
 
+        # Try loading only the plugin for this extension first
+        if not _load_plugin_for_extension(ext):
+            preinit()
+
         if not format:
             if ext not in EXTENSION:
                 init()
@@ -3524,7 +3619,11 @@ def open(
 
     prefix = fp.read(16)
 
-    preinit()
+    # Try to load just the plugin needed for this file extension
+    # before falling back to preinit() which loads common plugins
+    ext = os.path.splitext(filename)[1] if filename else ""
+    if not (ext and _load_plugin_for_extension(ext)):
+        preinit()
 
     warning_messages: list[str] = []
 
@@ -3560,14 +3659,19 @@ def _open_core(
     im = _open_core(fp, filename, prefix, formats)
 
     if im is None and formats is ID:
-        checked_formats = ID.copy()
-        if init():
-            im = _open_core(
-                fp,
-                filename,
-                prefix,
-                tuple(format for format in formats if format not in checked_formats),
-            )
+        # Try preinit (few common plugins) then init (all plugins)
+        for loader in (preinit, init):
+            checked_formats = ID.copy()
+            loader()
+            if formats != checked_formats:
+                im = _open_core(
+                    fp,
+                    filename,
+                    prefix,
+                    tuple(f for f in formats if f not in checked_formats),
+                )
+                if im is not None:
+                    break
 
     if im:
         im._exclusive_fp = exclusive_fp

From 1baf141146fdc46262460d8ca8617f1e46d29969 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Jan 2026 17:13:43 +1100
Subject: [PATCH 2230/2374] Check that _EXTENSION_PLUGIN contains all
 registered extensions

---
 Tests/test_image.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/Tests/test_image.py b/Tests/test_image.py
index afc6e8e166b..c064939e81a 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -466,6 +466,9 @@ def test_registered_extensions_uninitialized(self) -> None:
         # Assert
         assert Image._initialized == 2
 
+        for extension in Image.EXTENSION:
+            assert extension in Image._EXTENSION_PLUGIN
+
     def test_registered_extensions(self) -> None:
         # Arrange
         # Open an image to trigger plugin registration

From 9c8059fdea6d4272b9eacc2eeb05dc32efe40d4f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Jan 2026 17:18:30 +1100
Subject: [PATCH 2231/2374] Cleanup .spider extension registered by test code
 during save

---
 Tests/test_file_spider.py | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 3b3c3b4a518..03494523b61 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -14,6 +14,10 @@
 TEST_FILE = "Tests/images/hopper.spider"
 
 
+def teardown_module() -> None:
+    del Image.EXTENSION[".spider"]
+
+
 def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         im.load()

From b06118c2b3287d8061162c3bb90f2b672a5713e3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 19 Jan 2026 17:24:28 +1100
Subject: [PATCH 2232/2374] Do not register empty extension

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

diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 8662922437e..848dccda577 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -290,9 +290,9 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 
 def _save_spider(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
     # get the filename extension and register it with Image
-    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)
+    if 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)
 
 

From 096c479cfb2f71fecbb38a9b2dc12e5a49518ed8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 19 Jan 2026 11:28:42 +0200
Subject: [PATCH 2233/2374] If plugin has already been imported and registered
 the extension, return early

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index cd1abb9353b..dfd64ef1922 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -406,6 +406,9 @@ def _load_plugin_for_extension(ext: str | bytes) -> bool:
     """Load only the plugin needed for a specific file extension."""
     if isinstance(ext, bytes):
         ext = ext.decode()
+    if ext in EXTENSION:
+        return True
+
     plugin = _EXTENSION_PLUGIN.get(ext.lower())
     if plugin is None:
         return False

From 5ea2d3a05619aff38e194f3b1c6a9c906755db9f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 20 Jan 2026 18:16:34 +1100
Subject: [PATCH 2234/2374] Updated MinGW Python version

---
 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 ee70d84019a..0789b02b75a 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -57,7 +57,7 @@ These platforms are built and tested for every change.
 | Windows Server 2025              | 3.11, 3.12, 3.13, 3.14,    | x86-64              |
 |                                  | PyPy3                      |                     |
 |                                  +----------------------------+---------------------+
-|                                  | 3.12 (MinGW)               | x86-64              |
+|                                  | 3.13 (MinGW)               | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 
 

From a6a701c4dbecde4392465a1bc5ffe8a82445a52f Mon Sep 17 00:00:00 2001
From: Steve Dougherty <steve@asksteved.com>
Date: Wed, 21 Jan 2026 06:01:00 -0500
Subject: [PATCH 2235/2374] Match PSDraw text() encoding to the latin-1
 specification in setfont()
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Without this, characters that are in latin-1 but reflected differently in UTF-8 will not be properly rendered. For example,"ó" becomes "ó".
---
 src/PIL/PSDraw.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/PIL/PSDraw.py b/src/PIL/PSDraw.py
index 7fd4c5c94cf..e6b74a91888 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -100,7 +100,8 @@ 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 = bytes(text, "UTF-8")
+        # The font is loaded as ISOLatin1Encoding, so use latin-1 here.
+        text_bytes = bytes(text, "latin-1")
         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,)))

From a0f51493ca8ce7e90169a41d96d037ef413b659f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Jan 2026 00:23:58 +1100
Subject: [PATCH 2236/2374] Refer to lazy importing, as lazy loading of images
 is separate

---
 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 dfd64ef1922..88f79a79295 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -323,7 +323,7 @@ def getmodebands(mode: str) -> int:
 
 _initialized = 0
 
-# Mapping from file extension to plugin module name for lazy loading
+# Mapping from file extension to plugin module name for lazy importing
 _EXTENSION_PLUGIN: dict[str, str] = {
     # Common formats (preinit)
     ".bmp": "BmpImagePlugin",
@@ -402,8 +402,8 @@ def getmodebands(mode: str) -> int:
 }
 
 
-def _load_plugin_for_extension(ext: str | bytes) -> bool:
-    """Load only the plugin needed for a specific file extension."""
+def _import_plugin_for_extension(ext: str | bytes) -> bool:
+    """Import only the plugin needed for a specific file extension."""
     if isinstance(ext, bytes):
         ext = ext.decode()
     if ext in EXTENSION:
@@ -2634,8 +2634,8 @@ def save(
         filename_ext = os.path.splitext(filename)[1].lower()
         ext = filename_ext.decode() if isinstance(filename_ext, bytes) else filename_ext
 
-        # Try loading only the plugin for this extension first
-        if not _load_plugin_for_extension(ext):
+        # Try importing only the plugin for this extension first
+        if not _import_plugin_for_extension(ext):
             preinit()
 
         if not format:
@@ -3625,7 +3625,7 @@ def open(
     # Try to load just the plugin needed for this file extension
     # before falling back to preinit() which loads common plugins
     ext = os.path.splitext(filename)[1] if filename else ""
-    if not (ext and _load_plugin_for_extension(ext)):
+    if not (ext and _import_plugin_for_extension(ext)):
         preinit()
 
     warning_messages: list[str] = []

From a6b36f0b6bd91a899b6a4038b7f875ce5382776b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Jan 2026 00:28:26 +1100
Subject: [PATCH 2237/2374] format overrides file extension when saving

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 88f79a79295..e7357cc27d5 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2631,14 +2631,20 @@ def save(
             # only set the name for metadata purposes
             filename = os.fspath(fp.name)
 
-        filename_ext = os.path.splitext(filename)[1].lower()
-        ext = filename_ext.decode() if isinstance(filename_ext, bytes) else filename_ext
-
-        # Try importing only the plugin for this extension first
-        if not _import_plugin_for_extension(ext):
+        if format:
             preinit()
+        else:
+            filename_ext = os.path.splitext(filename)[1].lower()
+            ext = (
+                filename_ext.decode()
+                if isinstance(filename_ext, bytes)
+                else filename_ext
+            )
+
+            # Try importing only the plugin for this extension first
+            if not _import_plugin_for_extension(ext):
+                preinit()
 
-        if not format:
             if ext not in EXTENSION:
                 init()
             try:

From 76d3116ef030e9abb960f6544a272d3060ed2353 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 22 Jan 2026 18:48:38 +1100
Subject: [PATCH 2238/2374] Added logger messages to match init()

---
 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 e7357cc27d5..7d007718df3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -414,9 +414,11 @@ def _import_plugin_for_extension(ext: str | bytes) -> bool:
         return False
 
     try:
+        logger.debug("Importing %s", plugin)
         __import__(f"PIL.{plugin}", globals(), locals(), [])
         return True
-    except ImportError:
+    except ImportError as e:
+        logger.debug("Image: failed to import %s: %s", plugin, e)
         return False
 
 

From 34814d8d2fbcace1f31ad5857e1d61d540100812 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 24 Jan 2026 12:52:49 +0200
Subject: [PATCH 2239/2374] Improve wording

Co-authored-by: Andrew Murray <3112309+radarhere@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 7d007718df3..9ed251496c3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3630,8 +3630,8 @@ def open(
 
     prefix = fp.read(16)
 
-    # Try to load just the plugin needed for this file extension
-    # before falling back to preinit() which loads common plugins
+    # Try to import just the plugin needed for this file extension
+    # before falling back to preinit() which imports common plugins
     ext = os.path.splitext(filename)[1] if filename else ""
     if not (ext and _import_plugin_for_extension(ext)):
         preinit()

From d737687fc3365eca286573a6cb10f08ed394bdaf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 25 Jan 2026 06:45:13 +1100
Subject: [PATCH 2240/2374] Updated harfbuzz to 12.3.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 7c00f4b8028..5ca65aca3b5 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -95,7 +95,7 @@ if [[ -n "$IOS_SDK" ]]; then
 else
   FREETYPE_VERSION=2.14.1
 fi
-HARFBUZZ_VERSION=12.3.0
+HARFBUZZ_VERSION=12.3.2
 LIBPNG_VERSION=1.6.54
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 6ebc1669067..54fc905e3dc 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.2.0",
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "12.3.0",
+    "HARFBUZZ": "12.3.2",
     "JPEGTURBO": "3.1.3",
     "LCMS2": "2.17",
     "LIBAVIF": "1.3.0",

From c03618551492c55e98425254496112a3bee501b1 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 24 Jan 2026 22:48:41 +0200
Subject: [PATCH 2241/2374] Ensure lower before checking if ext in EXTENSION

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 9ed251496c3..743632e1fb7 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -406,10 +406,11 @@ def _import_plugin_for_extension(ext: str | bytes) -> bool:
     """Import only the plugin needed for a specific file extension."""
     if isinstance(ext, bytes):
         ext = ext.decode()
+    ext = ext.lower()
     if ext in EXTENSION:
         return True
 
-    plugin = _EXTENSION_PLUGIN.get(ext.lower())
+    plugin = _EXTENSION_PLUGIN.get(ext)
     if plugin is None:
         return False
 

From 2b186fceb8b3da3104e1ad7635b522aca481663f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Sat, 24 Jan 2026 23:02:39 +0200
Subject: [PATCH 2242/2374] Use __spec__.parent instead of calculating each
 time

---
 src/PIL/Image.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 743632e1fb7..3e37754e14a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -416,7 +416,7 @@ def _import_plugin_for_extension(ext: str | bytes) -> bool:
 
     try:
         logger.debug("Importing %s", plugin)
-        __import__(f"PIL.{plugin}", globals(), locals(), [])
+        __import__(f"{__spec__.parent}.{plugin}", globals(), locals(), [])
         return True
     except ImportError as e:
         logger.debug("Image: failed to import %s: %s", plugin, e)
@@ -481,11 +481,10 @@ def init() -> bool:
     if _initialized >= 2:
         return False
 
-    parent_name = __name__.rpartition(".")[0]
     for plugin in _plugins:
         try:
             logger.debug("Importing %s", plugin)
-            __import__(f"{parent_name}.{plugin}", globals(), locals(), [])
+            __import__(f"{__spec__.parent}.{plugin}", globals(), locals(), [])
         except ImportError as e:
             logger.debug("Image: failed to import %s: %s", plugin, e)
 

From d08d7ee99e4f5f986f37709ab7308dcbc8c4a1d8 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 25 Jan 2026 22:55:19 +1100
Subject: [PATCH 2243/2374] Check ext is not empty during save

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

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 3e37754e14a..8a28b56bd3c 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -404,6 +404,9 @@ def getmodebands(mode: str) -> int:
 
 def _import_plugin_for_extension(ext: str | bytes) -> bool:
     """Import only the plugin needed for a specific file extension."""
+    if not ext:
+        return False
+
     if isinstance(ext, bytes):
         ext = ext.decode()
     ext = ext.lower()
@@ -3633,7 +3636,7 @@ def open(
     # Try to import just the plugin needed for this file extension
     # before falling back to preinit() which imports common plugins
     ext = os.path.splitext(filename)[1] if filename else ""
-    if not (ext and _import_plugin_for_extension(ext)):
+    if not _import_plugin_for_extension(ext):
         preinit()
 
     warning_messages: list[str] = []

From b6178303a1ea210f2a535543f5f7369a511e4201 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 26 Jan 2026 08:01:02 +1100
Subject: [PATCH 2244/2374] Improve error message (#9392)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 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 3390dfa97dd..78abe3c77be 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -814,7 +814,7 @@ def setimage(
             self.state.ysize = y1 - y0
 
         if self.state.xsize <= 0 or self.state.ysize <= 0:
-            msg = "Size cannot be negative"
+            msg = "Size must be positive"
             raise ValueError(msg)
 
         if (

From a293273b31a23f2245116baf425f30c64485ced4 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 26 Jan 2026 16:10:37 +0200
Subject: [PATCH 2245/2374] Fix docstring typo

---
 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 eb561611718..f150365d3b6 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -326,7 +326,7 @@ def getmodebands(mode: str) -> int:
 
 def preinit() -> None:
     """
-    Explicitly loads BMP, GIF, JPEG, PPM and PPM file format drivers.
+    Explicitly loads BMP, GIF, JPEG, PPM and PNG file format drivers.
 
     It is called when opening or saving images.
     """

From 29ff5fcb5527ff38b15a724cdb03a115eea43be9 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 28 Jan 2026 08:43:14 +1100
Subject: [PATCH 2246/2374] Use monkeypatch (#9406)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_pcx.py     | 38 +++++++++++++++++++-------------------
 Tests/test_file_png.py     | 10 +++-------
 Tests/test_font_leaks.py   | 30 +++++++++++++++++-------------
 Tests/test_image.py        |  6 ++++--
 Tests/test_imagedraw.py    | 18 ++++++------------
 Tests/test_imagefile.py    | 20 +++++++-------------
 Tests/test_imagefontpil.py | 20 +++++++++-----------
 Tests/test_psdraw.py       | 11 ++++-------
 8 files changed, 69 insertions(+), 84 deletions(-)

diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index 2e999eff6e1..90740ab5761 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -119,36 +119,36 @@ def test_large_count(tmp_path: Path) -> None:
     _roundtrip(tmp_path, im)
 
 
-def _test_buffer_overflow(tmp_path: Path, im: Image.Image, size: int = 1024) -> None:
-    _last = ImageFile.MAXBLOCK
-    ImageFile.MAXBLOCK = size
-    try:
-        _roundtrip(tmp_path, im)
-    finally:
-        ImageFile.MAXBLOCK = _last
+def _test_buffer_overflow(
+    tmp_path: Path, im: Image.Image, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    monkeypatch.setattr(ImageFile, "MAXBLOCK", 1024)
+    _roundtrip(tmp_path, im)
 
 
-def test_break_in_count_overflow(tmp_path: Path) -> None:
+def test_break_in_count_overflow(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+) -> 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
-    _test_buffer_overflow(tmp_path, im)
+    _test_buffer_overflow(tmp_path, im, monkeypatch)
 
 
-def test_break_one_in_loop(tmp_path: Path) -> None:
+def test_break_one_in_loop(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> 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
-    _test_buffer_overflow(tmp_path, im)
+    _test_buffer_overflow(tmp_path, im, monkeypatch)
 
 
-def test_break_many_in_loop(tmp_path: Path) -> None:
+def test_break_many_in_loop(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     assert px is not None
@@ -157,10 +157,10 @@ def test_break_many_in_loop(tmp_path: Path) -> None:
             px[x, y] = x % 128
     for x in range(8):
         px[x, 4] = 16
-    _test_buffer_overflow(tmp_path, im)
+    _test_buffer_overflow(tmp_path, im, monkeypatch)
 
 
-def test_break_one_at_end(tmp_path: Path) -> None:
+def test_break_one_at_end(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     assert px is not None
@@ -168,10 +168,10 @@ def test_break_one_at_end(tmp_path: Path) -> None:
         for x in range(256):
             px[x, y] = x % 128
     px[0, 3] = 128 + 64
-    _test_buffer_overflow(tmp_path, im)
+    _test_buffer_overflow(tmp_path, im, monkeypatch)
 
 
-def test_break_many_at_end(tmp_path: Path) -> None:
+def test_break_many_at_end(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
     im = Image.new("L", (256, 5))
     px = im.load()
     assert px is not None
@@ -181,10 +181,10 @@ def test_break_many_at_end(tmp_path: Path) -> None:
     for x in range(4):
         px[x * 2, 3] = 128 + 64
         px[x + 256 - 4, 3] = 0
-    _test_buffer_overflow(tmp_path, im)
+    _test_buffer_overflow(tmp_path, im, monkeypatch)
 
 
-def test_break_padding(tmp_path: Path) -> None:
+def test_break_padding(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
     im = Image.new("L", (257, 5))
     px = im.load()
     assert px is not None
@@ -193,4 +193,4 @@ def test_break_padding(tmp_path: Path) -> None:
             px[x, y] = x % 128
     for x in range(5):
         px[x, 3] = 0
-    _test_buffer_overflow(tmp_path, im)
+    _test_buffer_overflow(tmp_path, im, monkeypatch)
diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index ed3a91285db..2e0af504183 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -654,21 +654,17 @@ 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:
+    def test_padded_idat(self, monkeypatch: pytest.MonkeyPatch) -> 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
         # so that the decoder finishes reading before the chunk ends
-        MAXBLOCK = ImageFile.MAXBLOCK
-        ImageFile.MAXBLOCK = 45
-        ImageFile.LOAD_TRUNCATED_IMAGES = True
+        monkeypatch.setattr(ImageFile, "MAXBLOCK", 45)
+        monkeypatch.setattr(ImageFile, "LOAD_TRUNCATED_IMAGES", True)
 
         with Image.open("Tests/images/padded_idat.png") as im:
             im.load()
 
-            ImageFile.MAXBLOCK = MAXBLOCK
-            ImageFile.LOAD_TRUNCATED_IMAGES = False
-
             assert_image_equal_tofile(im, "Tests/images/bw_gradient.png")
 
     @pytest.mark.parametrize(
diff --git a/Tests/test_font_leaks.py b/Tests/test_font_leaks.py
index ab8a7f9ecca..a5da76faa0b 100644
--- a/Tests/test_font_leaks.py
+++ b/Tests/test_font_leaks.py
@@ -1,5 +1,7 @@
 from __future__ import annotations
 
+import pytest
+
 from PIL import Image, ImageDraw, ImageFont, _util
 
 from .helper import PillowLeakTestCase, features, skip_unless_feature
@@ -7,11 +9,7 @@
 original_core = ImageFont.core
 
 
-class TestTTypeFontLeak(PillowLeakTestCase):
-    # fails at iteration 3 in main
-    iterations = 10
-    mem_limit = 4096  # k
-
+class TestFontLeak(PillowLeakTestCase):
     def _test_font(self, font: ImageFont.FreeTypeFont | ImageFont.ImageFont) -> None:
         im = Image.new("RGB", (255, 255), "white")
         draw = ImageDraw.ImageDraw(im)
@@ -21,23 +19,29 @@ def _test_font(self, font: ImageFont.FreeTypeFont | ImageFont.ImageFont) -> None
             )
         )
 
+
+class TestTTypeFontLeak(TestFontLeak):
+    # fails at iteration 3 in main
+    iterations = 10
+    mem_limit = 4096  # k
+
     @skip_unless_feature("freetype2")
     def test_leak(self) -> None:
         ttype = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 20)
         self._test_font(ttype)
 
 
-class TestDefaultFontLeak(TestTTypeFontLeak):
+class TestDefaultFontLeak(TestFontLeak):
     # fails at iteration 37 in main
     iterations = 100
     mem_limit = 1024  # k
 
-    def test_leak(self) -> None:
+    def test_leak(self, monkeypatch: pytest.MonkeyPatch) -> None:
         if features.check_module("freetype2"):
-            ImageFont.core = _util.DeferredError(ImportError("Disabled for testing"))
-        try:
-            default_font = ImageFont.load_default()
-        finally:
-            ImageFont.core = original_core
-
+            monkeypatch.setattr(
+                ImageFont,
+                "core",
+                _util.DeferredError(ImportError("Disabled for testing")),
+            )
+        default_font = ImageFont.load_default()
         self._test_font(default_font)
diff --git a/Tests/test_image.py b/Tests/test_image.py
index c064939e81a..32c79919595 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -456,9 +456,11 @@ def test_register_open_duplicates(self) -> None:
         # Assert
         assert len(Image.ID) == id_length
 
-    def test_registered_extensions_uninitialized(self) -> None:
+    def test_registered_extensions_uninitialized(
+        self, monkeypatch: pytest.MonkeyPatch
+    ) -> None:
         # Arrange
-        Image._initialized = 0
+        monkeypatch.setattr(Image, "_initialized", 0)
 
         # Act
         Image.registered_extensions()
diff --git a/Tests/test_imagedraw.py b/Tests/test_imagedraw.py
index 1eae053837e..3bcb7b90178 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -1485,21 +1485,15 @@ def test_stroke_multiline() -> None:
 
 
 @skip_unless_feature("freetype2")
-def test_setting_default_font() -> None:
-    # Arrange
+def test_setting_default_font(monkeypatch: pytest.MonkeyPatch) -> None:
     im = Image.new("RGB", (100, 250))
     draw = ImageDraw.Draw(im)
-    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 120)
-
-    # Act
-    ImageDraw.ImageDraw.font = font
+    assert isinstance(draw.getfont(), ImageFont.load_default().__class__)
 
-    # Assert
-    try:
-        assert draw.getfont() == font
-    finally:
-        ImageDraw.ImageDraw.font = None
-        assert isinstance(draw.getfont(), ImageFont.load_default().__class__)
+    draw = ImageDraw.Draw(im)
+    font = ImageFont.truetype("Tests/fonts/FreeMono.ttf", 120)
+    monkeypatch.setattr(ImageDraw.ImageDraw, "font", font)
+    assert draw.getfont() == font
 
 
 def test_default_font_size() -> None:
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 7dfb3abf986..8a0abbd39b1 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -31,7 +31,7 @@
 
 
 class TestImageFile:
-    def test_parser(self) -> None:
+    def test_parser(self, monkeypatch: pytest.MonkeyPatch) -> None:
         def roundtrip(format: str) -> tuple[Image.Image, Image.Image]:
             im = hopper("L").resize((1000, 1000), Image.Resampling.NEAREST)
             if format in ("MSP", "XBM"):
@@ -55,12 +55,9 @@ def roundtrip(format: str) -> tuple[Image.Image, Image.Image]:
         assert_image_equal(*roundtrip("IM"))
         assert_image_equal(*roundtrip("MSP"))
         if features.check("zlib"):
-            try:
-                # force multiple blocks in PNG driver
-                ImageFile.MAXBLOCK = 8192
-                assert_image_equal(*roundtrip("PNG"))
-            finally:
-                ImageFile.MAXBLOCK = MAXBLOCK
+            # force multiple blocks in PNG driver
+            monkeypatch.setattr(ImageFile, "MAXBLOCK", 8192)
+            assert_image_equal(*roundtrip("PNG"))
         assert_image_equal(*roundtrip("PPM"))
         assert_image_equal(*roundtrip("TIFF"))
         assert_image_equal(*roundtrip("XBM"))
@@ -120,14 +117,11 @@ def test_incremental_webp(self) -> None:
             assert (128, 128) == p.image.size
 
     @skip_unless_feature("zlib")
-    def test_safeblock(self) -> None:
+    def test_safeblock(self, monkeypatch: pytest.MonkeyPatch) -> None:
         im1 = hopper()
 
-        try:
-            ImageFile.SAFEBLOCK = 1
-            im2 = fromstring(tostring(im1, "PNG"))
-        finally:
-            ImageFile.SAFEBLOCK = SAFEBLOCK
+        monkeypatch.setattr(ImageFile, "SAFEBLOCK", 1)
+        im2 = fromstring(tostring(im1, "PNG"))
 
         assert_image_equal(im1, im2)
 
diff --git a/Tests/test_imagefontpil.py b/Tests/test_imagefontpil.py
index 8c1cb3f5860..883df051d1e 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -38,20 +38,18 @@ def test_invalid_mode() -> None:
             font._load_pilfont_data(fp, im)
 
 
-def test_without_freetype() -> None:
-    original_core = ImageFont.core
+def test_without_freetype(monkeypatch: pytest.MonkeyPatch) -> None:
     if features.check_module("freetype2"):
-        ImageFont.core = _util.DeferredError(ImportError("Disabled for testing"))
-    try:
-        with pytest.raises(ImportError):
-            ImageFont.truetype("Tests/fonts/FreeMono.ttf")
+        monkeypatch.setattr(
+            ImageFont, "core", _util.DeferredError(ImportError("Disabled for testing"))
+        )
+    with pytest.raises(ImportError):
+        ImageFont.truetype("Tests/fonts/FreeMono.ttf")
 
-        assert isinstance(ImageFont.load_default(), ImageFont.ImageFont)
+    assert isinstance(ImageFont.load_default(), ImageFont.ImageFont)
 
-        with pytest.raises(ImportError):
-            ImageFont.load_default(size=14)
-    finally:
-        ImageFont.core = original_core
+    with pytest.raises(ImportError):
+        ImageFont.load_default(size=14)
 
 
 @pytest.mark.parametrize("font", fonts)
diff --git a/Tests/test_psdraw.py b/Tests/test_psdraw.py
index 78f5632c5d8..e5c6f7d85cc 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -5,6 +5,8 @@
 from io import BytesIO
 from pathlib import Path
 
+import pytest
+
 from PIL import Image, PSDraw
 
 
@@ -47,21 +49,16 @@ def test_draw_postscript(tmp_path: Path) -> None:
     assert os.path.getsize(tempfile) > 0
 
 
-def test_stdout() -> None:
+def test_stdout(monkeypatch: pytest.MonkeyPatch) -> None:
     # Temporarily redirect stdout
-    old_stdout = sys.stdout
-
     class MyStdOut:
         buffer = BytesIO()
 
     mystdout = MyStdOut()
 
-    sys.stdout = mystdout
+    monkeypatch.setattr(sys, "stdout", mystdout)
 
     ps = PSDraw.PSDraw()
     _create_document(ps)
 
-    # Reset stdout
-    sys.stdout = old_stdout
-
     assert mystdout.buffer.getvalue() != b""

From f86ad8b36d75417f872723eba1c3a2ffc19c9c70 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 29 Jan 2026 23:26:20 +0100
Subject: [PATCH 2247/2374] Patch libavif for svt-av1 4.0 compatibility

---
 depends/install_libavif.sh |  4 ++++
 depends/libavif-svt4.patch | 14 ++++++++++++++
 2 files changed, 18 insertions(+)
 create mode 100644 depends/libavif-svt4.patch

diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
index 50ba0175567..a6686f3ef3a 100755
--- a/depends/install_libavif.sh
+++ b/depends/install_libavif.sh
@@ -7,6 +7,10 @@ version=1.3.0
 
 pushd libavif-$version
 
+# Apply patch for SVT-AV1 4.0 compatibility
+# Pending release of https://github.com/AOMediaCodec/libavif/pull/2971
+patch -p1 < ../libavif-svt4.patch
+
 if [ $(uname) == "Darwin" ] && [ -x "$(command -v brew)" ]; then
     PREFIX=$(brew --prefix)
 else
diff --git a/depends/libavif-svt4.patch b/depends/libavif-svt4.patch
new file mode 100644
index 00000000000..7abfc529970
--- /dev/null
+++ b/depends/libavif-svt4.patch
@@ -0,0 +1,14 @@
+--- a/src/codec_svt.c
++++ b/src/codec_svt.c
+@@ -162,7 +162,11 @@ static avifResult svtCodecEncodeImage(avifEncoder * encoder,
+ #else
+         svt_config->logical_processors = encoder->maxThreads;
+ #endif
++#if SVT_AV1_CHECK_VERSION(4, 0, 0)
++        svt_config->aq_mode = 2;
++#else
+         svt_config->enable_adaptive_quantization = 2;
++#endif
+         // disable 2-pass
+ #if SVT_AV1_CHECK_VERSION(0, 9, 0)
+         svt_config->rc_stats_buffer = (SvtAv1FixedBuf) { NULL, 0 };

From 799564dd52a306bbe3f90aa080825e5f5ffe9fc0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 29 Jan 2026 20:22:29 +1100
Subject: [PATCH 2248/2374] Always call StubHandler open() when opening
 StubImageFile

---
 src/PIL/BufrStubImagePlugin.py | 4 ----
 src/PIL/GribStubImagePlugin.py | 4 ----
 src/PIL/Hdf5StubImagePlugin.py | 4 ----
 src/PIL/ImageFile.py           | 4 ++++
 src/PIL/WmfImagePlugin.py      | 4 ----
 5 files changed, 4 insertions(+), 16 deletions(-)

diff --git a/src/PIL/BufrStubImagePlugin.py b/src/PIL/BufrStubImagePlugin.py
index 264564d2bbb..d82c4c746c3 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -52,10 +52,6 @@ def _open(self) -> None:
         self._mode = "F"
         self._size = 1, 1
 
-        loader = self._load()
-        if loader:
-            loader.open(self)
-
     def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
diff --git a/src/PIL/GribStubImagePlugin.py b/src/PIL/GribStubImagePlugin.py
index 146a6fa0df0..3784ef2f134 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -52,10 +52,6 @@ def _open(self) -> None:
         self._mode = "F"
         self._size = 1, 1
 
-        loader = self._load()
-        if loader:
-            loader.open(self)
-
     def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
diff --git a/src/PIL/Hdf5StubImagePlugin.py b/src/PIL/Hdf5StubImagePlugin.py
index 1523e95d58c..1a56660f7bd 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -52,10 +52,6 @@ def _open(self) -> None:
         self._mode = "F"
         self._size = 1, 1
 
-        loader = self._load()
-        if loader:
-            loader.open(self)
-
     def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 78abe3c77be..45df3be0363 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -148,6 +148,10 @@ def __init__(
         try:
             try:
                 self._open()
+
+                if isinstance(self, StubImageFile):
+                    if loader := self._load():
+                        loader.open(self)
             except (
                 IndexError,  # end of data
                 TypeError,  # end of data (ord)
diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 3ae86242a8b..79d54df4ed7 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -148,10 +148,6 @@ def _open(self) -> None:
         self._mode = "RGB"
         self._size = size
 
-        loader = self._load()
-        if loader:
-            loader.open(self)
-
     def _load(self) -> ImageFile.StubHandler | None:
         return _handler
 

From fc4dbc3810f4791d59dd9ea5c4d3e3a26de58c2f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 31 Jan 2026 02:41:44 +1100
Subject: [PATCH 2249/2374] Remove unnecessary code in `WmfHandler` (#9411)

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

diff --git a/src/PIL/WmfImagePlugin.py b/src/PIL/WmfImagePlugin.py
index 3ae86242a8b..a85c62a9342 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -45,7 +45,6 @@ def register_handler(handler: ImageFile.StubHandler | None) -> None:
 
     class WmfHandler(ImageFile.StubHandler):
         def open(self, im: ImageFile.StubImageFile) -> None:
-            im._mode = "RGB"
             self.bbox = im.info["wmf_bbox"]
 
         def load(self, im: ImageFile.StubImageFile) -> Image.Image:

From 27924be4fd326246f44d7d7f2100455f9954c501 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 2 Feb 2026 17:17:12 +0000
Subject: [PATCH 2250/2374] [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.14.10 → v0.14.14](https://github.com/astral-sh/ruff-pre-commit/compare/v0.14.10...v0.14.14)
- [github.com/psf/black-pre-commit-mirror: 25.12.0 → 26.1.0](https://github.com/psf/black-pre-commit-mirror/compare/25.12.0...26.1.0)
- [github.com/PyCQA/bandit: 1.9.2 → 1.9.3](https://github.com/PyCQA/bandit/compare/1.9.2...1.9.3)
- [github.com/Lucas-C/pre-commit-hooks: v1.5.5 → v1.5.6](https://github.com/Lucas-C/pre-commit-hooks/compare/v1.5.5...v1.5.6)
- [github.com/python-jsonschema/check-jsonschema: 0.36.0 → 0.36.1](https://github.com/python-jsonschema/check-jsonschema/compare/0.36.0...0.36.1)
- [github.com/zizmorcore/zizmor-pre-commit: v1.19.0 → v1.22.0](https://github.com/zizmorcore/zizmor-pre-commit/compare/v1.19.0...v1.22.0)
- [github.com/tox-dev/pyproject-fmt: v2.11.1 → v2.12.1](https://github.com/tox-dev/pyproject-fmt/compare/v2.11.1...v2.12.1)
---
 .pre-commit-config.yaml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 12b3d4b4a3d..7eb69d1642c 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.14.10
+    rev: v0.14.14
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.12.0
+    rev: 26.1.0
     hooks:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.9.2
+    rev: 1.9.3
     hooks:
     - id: bandit
       args: [--severity-level=high]
       files: ^src/
 
   - repo: https://github.com/Lucas-C/pre-commit-hooks
-    rev: v1.5.5
+    rev: v1.5.6
     hooks:
       - id: remove-tabs
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
@@ -51,14 +51,14 @@ repos:
         exclude: ^\.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.36.0
+    rev: 0.36.1
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.19.0
+    rev: v1.22.0
     hooks:
       - id: zizmor
 
@@ -68,7 +68,7 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.11.1
+    rev: v2.12.1
     hooks:
       - id: pyproject-fmt
 

From 7cbe8c4924f34fb3d17be8955ddc384cbb68ab16 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 2 Feb 2026 17:17:52 +0000
Subject: [PATCH 2251/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 Tests/test_arro3.py             |  4 ++--
 Tests/test_arrow.py             |  8 ++++----
 Tests/test_file_gif.py          |  2 +-
 Tests/test_file_jpeg.py         | 18 ++++--------------
 Tests/test_font_pcf.py          |  2 +-
 Tests/test_font_pcf_charsets.py |  2 +-
 Tests/test_format_hsv.py        |  4 ++--
 Tests/test_image_access.py      |  6 ++----
 Tests/test_image_transform.py   | 14 +++++++-------
 Tests/test_imagemorph.py        |  6 ++----
 Tests/test_imagewin_pointers.py |  2 +-
 Tests/test_nanoarrow.py         |  4 ++--
 Tests/test_pyarrow.py           |  4 ++--
 pyproject.toml                  | 16 ++++++++--------
 src/PIL/BdfFontFile.py          |  1 +
 src/PIL/EpsImagePlugin.py       |  2 +-
 src/PIL/ExifTags.py             |  1 +
 src/PIL/GdImageFile.py          |  1 +
 src/PIL/GimpGradientFile.py     |  1 +
 src/PIL/IcnsImagePlugin.py      |  6 +++---
 src/PIL/Image.py                |  4 ++--
 src/PIL/ImageDraw2.py           |  3 ++-
 src/PIL/ImageFile.py            |  4 ++--
 src/PIL/ImageFont.py            | 26 ++++++--------------------
 src/PIL/MspImagePlugin.py       |  2 +-
 src/PIL/WalImageFile.py         |  1 +
 src/PIL/_binary.py              |  1 +
 27 files changed, 62 insertions(+), 83 deletions(-)

diff --git a/Tests/test_arro3.py b/Tests/test_arro3.py
index 672eedc9ba4..42d032f7660 100644
--- a/Tests/test_arro3.py
+++ b/Tests/test_arro3.py
@@ -213,7 +213,7 @@ class DataShape(NamedTuple):
     ),
 )
 def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
-    (dtype, elt, elts_per_pixel) = data_tp
+    dtype, elt, elts_per_pixel = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
     if dtype == fl_uint8_4_type:
@@ -239,7 +239,7 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
 )
 @pytest.mark.parametrize("data_tp", (UINT32, INT32))
 def test_from_int32array(mode: str, mask: list[int] | None, data_tp: DataShape) -> None:
-    (dtype, elt, elts_per_pixel) = data_tp
+    dtype, elt, elts_per_pixel = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
     arr = Array([elt] * (ct_pixels * elts_per_pixel), type=dtype)
diff --git a/Tests/test_arrow.py b/Tests/test_arrow.py
index b86c77b9aa8..9f84a75a472 100644
--- a/Tests/test_arrow.py
+++ b/Tests/test_arrow.py
@@ -68,7 +68,7 @@ def test_multiblock_l_image() -> None:
     img = Image.new("L", size, 128)
 
     with pytest.raises(ValueError):
-        (schema, arr) = img.__arrow_c_array__()
+        schema, arr = img.__arrow_c_array__()
 
 
 def test_multiblock_rgba_image() -> None:
@@ -79,7 +79,7 @@ def test_multiblock_rgba_image() -> None:
     img = Image.new("RGBA", size, (128, 127, 126, 125))
 
     with pytest.raises(ValueError):
-        (schema, arr) = img.__arrow_c_array__()
+        schema, arr = img.__arrow_c_array__()
 
 
 def test_multiblock_l_schema() -> None:
@@ -114,7 +114,7 @@ def test_singleblock_l_image() -> None:
     img = Image.new("L", size, 128)
     assert img.im.isblock()
 
-    (schema, arr) = img.__arrow_c_array__()
+    schema, arr = img.__arrow_c_array__()
     assert schema
     assert arr
 
@@ -130,7 +130,7 @@ def test_singleblock_rgba_image() -> None:
     img = Image.new("RGBA", size, (128, 127, 126, 125))
     assert img.im.isblock()
 
-    (schema, arr) = img.__arrow_c_array__()
+    schema, arr = img.__arrow_c_array__()
     assert schema
     assert arr
     Image.core.set_use_block_allocator(0)
diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 2615f5a6028..7924af99f74 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1433,7 +1433,7 @@ def test_getdata(monkeypatch: pytest.MonkeyPatch) -> None:
     # with open('Tests/images/gif_header_data.pkl', 'wb') as f:
     #    pickle.dump((h, d), f, 1)
     with open("Tests/images/gif_header_data.pkl", "rb") as f:
-        (h_target, d_target) = pickle.load(f)
+        h_target, d_target = pickle.load(f)
 
     assert h == h_target
     assert d == d_target
diff --git a/Tests/test_file_jpeg.py b/Tests/test_file_jpeg.py
index f818927f6a3..f4c8318a926 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -590,9 +590,7 @@ def _n_qtables_helper(n: int, test_file: str) -> None:
             assert im2.quantization == {0: bounds_qtable}
 
             # values from wizard.txt in jpeg9-a src package.
-            standard_l_qtable = [
-                int(s)
-                for s in """
+            standard_l_qtable = [int(s) for s in """
                 16  11  10  16  24  40  51  61
                 12  12  14  19  26  58  60  55
                 14  13  16  24  40  57  69  56
@@ -601,14 +599,9 @@ def _n_qtables_helper(n: int, test_file: str) -> None:
                 24  35  55  64  81 104 113  92
                 49  64  78  87 103 121 120 101
                 72  92  95  98 112 100 103  99
-                """.split(
-                    None
-                )
-            ]
+                """.split(None)]
 
-            standard_chrominance_qtable = [
-                int(s)
-                for s in """
+            standard_chrominance_qtable = [int(s) for s in """
                 17  18  24  47  99  99  99  99
                 18  21  26  66  99  99  99  99
                 24  26  56  99  99  99  99  99
@@ -617,10 +610,7 @@ def _n_qtables_helper(n: int, test_file: str) -> None:
                 99  99  99  99  99  99  99  99
                 99  99  99  99  99  99  99  99
                 99  99  99  99  99  99  99  99
-                """.split(
-                    None
-                )
-            ]
+                """.split(None)]
 
             for quality in range(101):
                 qtable_from_qtable_quality = self.roundtrip(
diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 567ddaf13a0..1be7a4d1e39 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -80,7 +80,7 @@ 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):
-        (ox, oy, dx, dy) = font.getbbox(chr(i))
+        ox, oy, dx, dy = font.getbbox(chr(i))
         assert ox == 0
         assert oy == 0
         assert dy == 20
diff --git a/Tests/test_font_pcf_charsets.py b/Tests/test_font_pcf_charsets.py
index 895458d9d82..f1ade907b0e 100644
--- a/Tests/test_font_pcf_charsets.py
+++ b/Tests/test_font_pcf_charsets.py
@@ -95,7 +95,7 @@ def test_textsize(
     tempname = save_font(request, tmp_path, encoding)
     font = ImageFont.load(tempname)
     for i in range(255):
-        (ox, oy, dx, dy) = font.getbbox(bytearray([i]))
+        ox, oy, dx, dy = font.getbbox(bytearray([i]))
         assert ox == 0
         assert oy == 0
         assert dy == 20
diff --git a/Tests/test_format_hsv.py b/Tests/test_format_hsv.py
index 861eccc1170..2aeff5c34c3 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -29,7 +29,7 @@ def linear_gradient() -> Image.Image:
     im = Image.linear_gradient(mode="L")
     im90 = im.rotate(90)
 
-    (px, h) = im.size
+    px, h = im.size
 
     r = Image.new("L", (px * 3, h))
     g = r.copy()
@@ -54,7 +54,7 @@ def to_xxx_colorsys(
 ) -> Image.Image:
     # convert the hard way using the library colorsys routines.
 
-    (r, g, b) = im.split()
+    r, g, b = im.split()
 
     conv_func = int_to_float
 
diff --git a/Tests/test_image_access.py b/Tests/test_image_access.py
index 07c12594a8c..6470ac9fc6f 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -278,8 +278,7 @@ def test_embeddable(self) -> None:
 
         with open("embed_pil.c", "w", encoding="utf-8") as fh:
             home = sys.prefix.replace("\\", "\\\\")
-            fh.write(
-                f"""
+            fh.write(f"""
 #include "Python.h"
 
 int main(int argc, char* argv[])
@@ -300,8 +299,7 @@ def test_embeddable(self) -> None:
 
     return 0;
 }}
-        """
-            )
+        """)
 
         objects = compiler.compile(["embed_pil.c"])
         compiler.link_executable(objects, "embed_pil")
diff --git a/Tests/test_image_transform.py b/Tests/test_image_transform.py
index 3e2b9fee8ed..12a05ec18b1 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -56,7 +56,7 @@ def test_palette(self) -> None:
 
     def test_extent(self) -> None:
         im = hopper("RGB")
-        (w, h) = im.size
+        w, h = im.size
         transformed = im.transform(
             im.size,
             Image.Transform.EXTENT,
@@ -72,7 +72,7 @@ def test_extent(self) -> None:
     def test_quad(self) -> None:
         # one simple quad transform, equivalent to scale & crop upper left quad
         im = hopper("RGB")
-        (w, h) = im.size
+        w, h = im.size
         transformed = im.transform(
             im.size,
             Image.Transform.QUAD,
@@ -99,7 +99,7 @@ def test_quad(self) -> None:
     )
     def test_fill(self, mode: str, expected_pixel: tuple[int, ...]) -> None:
         im = hopper(mode)
-        (w, h) = im.size
+        w, h = im.size
         transformed = im.transform(
             im.size,
             Image.Transform.EXTENT,
@@ -112,7 +112,7 @@ def test_fill(self, mode: str, expected_pixel: tuple[int, ...]) -> None:
     def test_mesh(self) -> None:
         # this should be a checkerboard of halfsized hoppers in ul, lr
         im = hopper("RGBA")
-        (w, h) = im.size
+        w, h = im.size
         transformed = im.transform(
             im.size,
             Image.Transform.MESH,
@@ -174,7 +174,7 @@ def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
 
     def test_alpha_premult_transform(self) -> None:
         def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
-            (w, h) = im.size
+            w, h = im.size
             return im.transform(
                 sz, Image.Transform.EXTENT, (0, 0, w, h), Image.Resampling.BILINEAR
             )
@@ -216,7 +216,7 @@ def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
     @pytest.mark.parametrize("mode", ("RGBA", "LA"))
     def test_nearest_transform(self, mode: str) -> None:
         def op(im: Image.Image, sz: tuple[int, int]) -> Image.Image:
-            (w, h) = im.size
+            w, h = im.size
             return im.transform(
                 sz, Image.Transform.EXTENT, (0, 0, w, h), Image.Resampling.NEAREST
             )
@@ -255,7 +255,7 @@ def test_missing_method_data(self) -> None:
     @pytest.mark.parametrize("resample", (Image.Resampling.BOX, "unknown"))
     def test_unknown_resampling_filter(self, resample: Image.Resampling | str) -> None:
         with hopper() as im:
-            (w, h) = im.size
+            w, h = im.size
             with pytest.raises(ValueError):
                 im.transform((100, 100), Image.Transform.EXTENT, (0, 0, w, h), resample)  # type: ignore[arg-type]
 
diff --git a/Tests/test_imagemorph.py b/Tests/test_imagemorph.py
index aa8356b0b33..1d2fae1a6fa 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -22,8 +22,7 @@ def string_to_img(image_string: str) -> Image.Image:
     return im
 
 
-A = string_to_img(
-    """
+A = string_to_img("""
     .......
     .......
     ..111..
@@ -31,8 +30,7 @@ def string_to_img(image_string: str) -> Image.Image:
     ..111..
     .......
     .......
-    """
-)
+    """)
 
 
 def img_to_string(im: Image.Image) -> str:
diff --git a/Tests/test_imagewin_pointers.py b/Tests/test_imagewin_pointers.py
index e8468e59f54..b7421051384 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -87,7 +87,7 @@ def serialize_dib(bi: BITMAPINFOHEADER, pixels: ctypes.c_void_p) -> bytearray:
 
     def test_pointer(tmp_path: Path) -> None:
         im = hopper()
-        (width, height) = im.size
+        width, height = im.size
         opath = tmp_path / "temp.png"
         imdib = ImageWin.Dib(im)
 
diff --git a/Tests/test_nanoarrow.py b/Tests/test_nanoarrow.py
index 69980e71909..047be16c5f5 100644
--- a/Tests/test_nanoarrow.py
+++ b/Tests/test_nanoarrow.py
@@ -208,7 +208,7 @@ class DataShape(NamedTuple):
     ),
 )
 def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
-    (dtype, elt, elts_per_pixel) = data_tp
+    dtype, elt, elts_per_pixel = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
     if dtype == fl_uint8_4_type:
@@ -241,7 +241,7 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
 )
 @pytest.mark.parametrize("data_tp", (UINT32, INT32))
 def test_from_int32array(mode: str, mask: list[int] | None, data_tp: DataShape) -> None:
-    (dtype, elt, elts_per_pixel) = data_tp
+    dtype, elt, elts_per_pixel = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
     arr = nanoarrow.Array(
diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index a69504e78a0..7a161f2ac12 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -211,7 +211,7 @@ class DataShape(NamedTuple):
     ),
 )
 def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
-    (dtype, elt, elts_per_pixel) = data_tp
+    dtype, elt, elts_per_pixel = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
     arr = pyarrow.array([elt] * (ct_pixels * elts_per_pixel), type=dtype)
@@ -238,7 +238,7 @@ def test_fromarray(mode: str, data_tp: DataShape, mask: list[int] | None) -> Non
     ),
 )
 def test_from_int32array(mode: str, data_tp: DataShape, mask: list[int] | None) -> None:
-    (dtype, elt, elts_per_pixel) = data_tp
+    dtype, elt, elts_per_pixel = data_tp
 
     ct_pixels = TEST_IMAGE_SIZE[0] * TEST_IMAGE_SIZE[1]
     arr = pyarrow.array([elt] * (ct_pixels * elts_per_pixel), type=dtype)
diff --git a/pyproject.toml b/pyproject.toml
index cc616bc547c..91f4750e46a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -112,14 +112,6 @@ test-requires = [
 ]
 xbuild-tools = [  ]
 
-[tool.cibuildwheel.macos]
-# Disable platform guessing on macOS to avoid picking up Homebrew etc.
-config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable platform-guessing=disable"
-
-[tool.cibuildwheel.macos.environment]
-# Isolate macOS build environment from Homebrew etc.
-PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
-
 [tool.cibuildwheel.ios]
 # Disable platform guessing on iOS, and disable raqm (since there won't be a
 # vendor version, and we can't distribute it due to licensing)
@@ -139,6 +131,14 @@ test-command = [
 # There's no numpy wheel for iOS (yet...)
 test-requires = [  ]
 
+[tool.cibuildwheel.macos]
+# Disable platform guessing on macOS to avoid picking up Homebrew etc.
+config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable platform-guessing=disable"
+
+[tool.cibuildwheel.macos.environment]
+# Isolate macOS build environment from Homebrew etc.
+PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
+
 [[tool.cibuildwheel.overrides]]
 # iOS environment is isolated by cibuildwheel, but needs the dependencies
 select = "*_iphoneos"
diff --git a/src/PIL/BdfFontFile.py b/src/PIL/BdfFontFile.py
index f175e2f4f80..1c8c28ff038 100644
--- a/src/PIL/BdfFontFile.py
+++ b/src/PIL/BdfFontFile.py
@@ -20,6 +20,7 @@
 """
 Parse X Bitmap Distribution Format (BDF)
 """
+
 from __future__ import annotations
 
 from typing import BinaryIO
diff --git a/src/PIL/EpsImagePlugin.py b/src/PIL/EpsImagePlugin.py
index 2effb816cfb..aeb7b0c93b3 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -190,7 +190,7 @@ class EpsImageFile(ImageFile.ImageFile):
 
     def _open(self) -> None:
         assert self.fp is not None
-        (length, offset) = self._find_offset(self.fp)
+        length, offset = self._find_offset(self.fp)
 
         # go to offset - start of "%!PS"
         self.fp.seek(offset)
diff --git a/src/PIL/ExifTags.py b/src/PIL/ExifTags.py
index 2280d5ce84b..c1c05cdba71 100644
--- a/src/PIL/ExifTags.py
+++ b/src/PIL/ExifTags.py
@@ -13,6 +13,7 @@
 This module provides constants and clear-text names for various
 well-known EXIF tags.
 """
+
 from __future__ import annotations
 
 from enum import IntEnum
diff --git a/src/PIL/GdImageFile.py b/src/PIL/GdImageFile.py
index 891225ce2fd..d73bc1982f8 100644
--- a/src/PIL/GdImageFile.py
+++ b/src/PIL/GdImageFile.py
@@ -25,6 +25,7 @@ class is not registered for use with :py:func:`PIL.Image.open()`.  To open a
     implementation is provided for convenience and demonstrational
     purposes only.
 """
+
 from __future__ import annotations
 
 from typing import IO
diff --git a/src/PIL/GimpGradientFile.py b/src/PIL/GimpGradientFile.py
index 5f2691882c4..fb958721882 100644
--- a/src/PIL/GimpGradientFile.py
+++ b/src/PIL/GimpGradientFile.py
@@ -18,6 +18,7 @@
 the corresponding code in GIMP, written by Federico Mena Quintero.
 See the GIMP distribution for more information.)
 """
+
 from __future__ import annotations
 
 from math import log, pi, sin, sqrt
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 058861d67e5..023835fb71e 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -42,7 +42,7 @@ 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
+    start, length = start_length
     fobj.seek(start)
     sig = fobj.read(4)
     if sig != b"\x00\x00\x00\x00":
@@ -58,7 +58,7 @@ def read_32(
     Read a 32bit RGB icon resource.  Seems to be either uncompressed or
     an RLE packbits-like scheme.
     """
-    (start, length) = start_length
+    start, length = start_length
     fobj.seek(start)
     pixel_size = (size[0] * size[2], size[1] * size[2])
     sizesq = pixel_size[0] * pixel_size[1]
@@ -111,7 +111,7 @@ def read_mk(
 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
+    start, length = start_length
     fobj.seek(start)
     sig = fobj.read(12)
 
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index fdcc680b900..cc431a86a5d 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2546,7 +2546,7 @@ def rotate(
         ]
 
         def transform(x: float, y: float, matrix: list[float]) -> tuple[float, float]:
-            (a, b, c, d, e, f) = matrix
+            a, b, c, d, e, f = matrix
             return a * x + b * y + c, d * x + e * y + f
 
         matrix[2], matrix[5] = transform(
@@ -3489,7 +3489,7 @@ def fromarrow(
         msg = "arrow_c_array interface not found"
         raise ValueError(msg)
 
-    (schema_capsule, array_capsule) = obj.__arrow_c_array__()
+    schema_capsule, array_capsule = obj.__arrow_c_array__()
     _im = core.new_arrow(mode, size, schema_capsule, array_capsule)
     if _im:
         return Image()._new(_im)
diff --git a/src/PIL/ImageDraw2.py b/src/PIL/ImageDraw2.py
index 3d68658ed5b..2c9e39b2c41 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -22,6 +22,7 @@
 
 .. seealso:: :py:mod:`PIL.ImageDraw`
 """
+
 from __future__ import annotations
 
 from typing import Any, AnyStr, BinaryIO
@@ -117,7 +118,7 @@ def render(
 
     def settransform(self, offset: tuple[float, float]) -> None:
         """Sets a transformation offset."""
-        (xoffset, yoffset) = offset
+        xoffset, yoffset = offset
         self.transform = (1, 0, xoffset, 0, 1, yoffset)
 
     def arc(
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 78abe3c77be..34143543733 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -801,9 +801,9 @@ def setimage(
         self.im = im
 
         if extents:
-            (x0, y0, x1, y1) = extents
+            x0, y0, x1, y1 = extents
         else:
-            (x0, y0, x1, y1) = (0, 0, 0, 0)
+            x0, y0, x1, y1 = (0, 0, 0, 0)
 
         if x0 == 0 and x1 == 0:
             self.state.xsize, self.state.ysize = self.im.size
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index d11f7bf01ad..ae003d139c9 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -940,9 +940,7 @@ def load_default_imagefont() -> ImageFont:
     f = ImageFont()
     f._load_pilfont_data(
         # courB08
-        BytesIO(
-            base64.b64decode(
-                b"""
+        BytesIO(base64.b64decode(b"""
 UElMZm9udAo7Ozs7OzsxMDsKREFUQQoAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
 AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
@@ -1034,13 +1032,8 @@ def load_default_imagefont() -> ImageFont:
 pQAKAKwAEgAGAAD////4AAYAAACsAAoAswASAAYAAP////gABgAAALMACgC6ABIABgAA////+QAG
 AAAAugAKAMEAEQAGAAD////4AAYAAgDBAAoAyAAUAAYAAP////kABQACAMgACgDOABMABgAA////
 +QAGAAIAzgAKANUAEw==
-"""
-            )
-        ),
-        Image.open(
-            BytesIO(
-                base64.b64decode(
-                    b"""
+""")),
+        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
@@ -1064,10 +1057,7 @@ def load_default_imagefont() -> ImageFont:
 AAD//2Ji2FrkY3iYpYC5qDeGgeEMAwPDvwQBBoYvcTwOVLMEAAAA//9isDBgkP///0EOg9z35v//
 Gc/eeW7BwPj5+QGZhANUswMAAAD//2JgqGBgYGBgqEMXlvhMPUsAAAAA//8iYDd1AAAAAP//AwDR
 w7IkEbzhVQAAAABJRU5ErkJggg==
-"""
-                )
-            )
-        ),
+"""))),
     )
     return f
 
@@ -1088,9 +1078,7 @@ def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
     """
     if isinstance(core, ModuleType) or size is not None:
         return truetype(
-            BytesIO(
-                base64.b64decode(
-                    b"""
+            BytesIO(base64.b64decode(b"""
 AAEAAAAPAIAAAwBwRkZUTYwDlUAAADFoAAAAHEdERUYAqADnAAAo8AAAACRHUE9ThhmITwAAKfgAA
 AduR1NVQnHxefoAACkUAAAA4k9TLzJovoHLAAABeAAAAGBjbWFw5lFQMQAAA6gAAAGqZ2FzcP//AA
 MAACjoAAAACGdseWYmRXoPAAAGQAAAHfhoZWFkE18ayQAAAPwAAAA2aGhlYQboArEAAAE0AAAAJGh
@@ -1311,9 +1299,7 @@ def load_default(size: float | None = None) -> FreeTypeFont | ImageFont:
 gAWAAAAEQADAAoAFAAMAA0ABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASAAAAEgAGAAEAHgAkAC
 YAJwApACoALQAuAC8AMgAzADcAOAA5ADoAPAA9AEUASABOAE8AUgBTAFUAVwBZAFoAWwBcAF0AcwA
 AAAAAAQAAAADa3tfFAAAAANAan9kAAAAA4QodoQ==
-"""
-                )
-            ),
+""")),
             10 if size is None else size,
             layout_engine=Layout.BASIC,
         )
diff --git a/src/PIL/MspImagePlugin.py b/src/PIL/MspImagePlugin.py
index 277087a8677..fa0f52fe8db 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -140,7 +140,7 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
                     runtype = row[idx]
                     idx += 1
                     if runtype == 0:
-                        (runcount, runval) = struct.unpack_from("Bc", row, idx)
+                        runcount, runval = struct.unpack_from("Bc", row, idx)
                         img.write(runval * runcount)
                         idx += 2
                     else:
diff --git a/src/PIL/WalImageFile.py b/src/PIL/WalImageFile.py
index fb3e1c06a32..07bbf747155 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -22,6 +22,7 @@
     is not registered for use with :py:func:`PIL.Image.open()`.
     To open a WAL file, use the :py:func:`PIL.WalImageFile.open()` function instead.
 """
+
 from __future__ import annotations
 
 from typing import IO
diff --git a/src/PIL/_binary.py b/src/PIL/_binary.py
index 4594ccce361..d3236c17abb 100644
--- a/src/PIL/_binary.py
+++ b/src/PIL/_binary.py
@@ -13,6 +13,7 @@
 
 
 """Binary input/output support routines."""
+
 from __future__ import annotations
 
 from struct import pack, unpack_from

From 508e9c998429cf1a6989fc7af913d98e92c3d2a9 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 3 Feb 2026 01:32:07 +0000
Subject: [PATCH 2252/2374] Update dependency cibuildwheel to v3.3.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 485866de67c..6e869a5c2e9 100644
--- a/.ci/requirements-cibw.txt
+++ b/.ci/requirements-cibw.txt
@@ -1 +1 @@
-cibuildwheel==3.3.0
+cibuildwheel==3.3.1

From 1ac7691fe597f4a1bc8ffe088d40c3a136d87831 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 4 Feb 2026 20:39:31 +1100
Subject: [PATCH 2253/2374] Updated zlib-ng to 2.3.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 c17bb7765be..6dadeb775d6 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -103,7 +103,7 @@ XZ_VERSION=5.8.2
 ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.1
 LCMS2_VERSION=2.18
-ZLIB_NG_VERSION=2.3.2
+ZLIB_NG_VERSION=2.3.3
 LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b9bfc0c6e17..e62a94cc40b 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -126,7 +126,7 @@ def cmd_msbuild(
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",
     "XZ": "5.8.2",
-    "ZLIBNG": "2.3.2",
+    "ZLIBNG": "2.3.3",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])
 

From a90075a66803b30cd02c0607d47c0d912913b6aa Mon Sep 17 00:00:00 2001
From: Frank Henigman <fjhenigman@gmail.com>
Date: Wed, 4 Feb 2026 20:52:52 -0500
Subject: [PATCH 2254/2374] Add FontFile.to_imagefont().

---
 Tests/test_font_pcf.py | 10 ++++++++++
 src/PIL/FontFile.py    | 42 ++++++++++++++++++++++++++++++++----------
 2 files changed, 42 insertions(+), 10 deletions(-)

diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 1be7a4d1e39..5b8832977db 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -76,6 +76,16 @@ def test_draw(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     assert_image_similar_tofile(im, "Tests/images/test_draw_pbm_target.png", 0)
 
 
+def test_to_imagefont(request: pytest.FixtureRequest, tmp_path: Path) -> None:
+    with open(fontname, "rb") as test_file:
+        pcffont = PcfFontFile.PcfFontFile(test_file)
+    imgfont = pcffont.to_imagefont()
+    im = Image.new("L", (130, 30), "white")
+    draw = ImageDraw.Draw(im)
+    draw.text((0, 0), message, "black", font=imgfont)
+    assert_image_similar_tofile(im, "Tests/images/test_draw_pbm_target.png", 0)
+
+
 def test_textsize(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     tempname = save_font(request, tmp_path)
     font = ImageFont.load(tempname)
diff --git a/src/PIL/FontFile.py b/src/PIL/FontFile.py
index 1e0c1c166b5..b50385daac6 100644
--- a/src/PIL/FontFile.py
+++ b/src/PIL/FontFile.py
@@ -15,10 +15,11 @@
 #
 from __future__ import annotations
 
+import io
 import os
 from typing import BinaryIO
 
-from . import Image, _binary
+from . import Image, ImageFont, _binary
 
 WIDTH = 800
 
@@ -123,12 +124,33 @@ def save(self, filename: str) -> None:
 
         # font metrics
         with open(os.path.splitext(filename)[0] + ".pil", "wb") as fp:
-            fp.write(b"PILfont\n")
-            fp.write(f";;;;;;{self.ysize};\n".encode("ascii"))  # HACK!!!
-            fp.write(b"DATA\n")
-            for id in range(256):
-                m = self.metrics[id]
-                if not m:
-                    puti16(fp, (0,) * 10)
-                else:
-                    puti16(fp, m[0] + m[1] + m[2])
+            self.save_metrics(fp)
+
+    def save_metrics(self, fp: BinaryIO) -> None:
+        """Save font metrics to a file-like object"""
+        fp.write(b"PILfont\n")
+        fp.write(f";;;;;;{self.ysize};\n".encode("ascii"))  # HACK!!!
+        fp.write(b"DATA\n")
+        for id in range(256):
+            m = self.metrics[id]
+            if not m:
+                puti16(fp, (0,) * 10)
+            else:
+                puti16(fp, m[0] + m[1] + m[2])
+
+    def to_imagefont(self) -> ImageFont.ImageFont:
+        """Convert to ImageFont"""
+
+        self.compile()
+
+        # font data
+        if not self.bitmap:
+            msg = "No bitmap created"
+            raise ValueError(msg)
+
+        buf = io.BytesIO()
+        self.save_metrics(buf)
+        buf.seek(0)
+        imgfont = ImageFont.ImageFont()
+        imgfont._load_pilfont_data(buf, self.bitmap)
+        return imgfont

From 18cab114370184efee9dde50c19d71263d7c7ec5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Feb 2026 08:34:13 +1100
Subject: [PATCH 2255/2374] Use assert_image_equal* when similarity is zero

---
 Tests/test_file_gif.py          | 4 ++--
 Tests/test_file_libtiff.py      | 2 +-
 Tests/test_file_wmf.py          | 2 +-
 Tests/test_font_pcf.py          | 5 ++---
 Tests/test_font_pcf_charsets.py | 3 +--
 Tests/test_uploader.py          | 4 ++--
 6 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 7924af99f74..e3fcec49084 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -399,7 +399,7 @@ def test_save_netpbm_bmp_mode(tmp_path: Path) -> None:
     b = BytesIO()
     GifImagePlugin._save_netpbm(img_rgb, b, tempfile)
     with Image.open(tempfile) as reloaded:
-        assert_image_similar(img_rgb, reloaded.convert("RGB"), 0)
+        assert_image_equal(img_rgb, reloaded.convert("RGB"))
 
 
 @pytest.mark.skipif(not netpbm_available(), reason="Netpbm not available")
@@ -411,7 +411,7 @@ def test_save_netpbm_l_mode(tmp_path: Path) -> None:
         b = BytesIO()
         GifImagePlugin._save_netpbm(img_l, b, tempfile)
         with Image.open(tempfile) as reloaded:
-            assert_image_similar(img_l, reloaded.convert("L"), 0)
+            assert_image_equal(img_l, reloaded.convert("L"))
 
 
 def test_seek() -> None:
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index c2336c05856..a71c65cac2c 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -738,7 +738,7 @@ def save_bytesio(compression: str | None = None) -> None:
             buffer_io.seek(0)
 
             with Image.open(buffer_io) as saved_im:
-                assert_image_similar(pilim, saved_im, 0)
+                assert_image_equal(pilim, saved_im)
 
         save_bytesio()
         save_bytesio("raw")
diff --git a/Tests/test_file_wmf.py b/Tests/test_file_wmf.py
index 906080d15a5..56901f46b07 100644
--- a/Tests/test_file_wmf.py
+++ b/Tests/test_file_wmf.py
@@ -18,7 +18,7 @@ def test_load_raw() -> None:
             # Currently, support for WMF/EMF is Windows-only
             im.load()
             # Compare to reference rendering
-            assert_image_similar_tofile(im, "Tests/images/drawing_emf_ref.png", 0)
+            assert_image_equal_tofile(im, "Tests/images/drawing_emf_ref.png")
 
     # Test basic WMF open and rendering
     with Image.open("Tests/images/drawing.wmf") as im:
diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 1be7a4d1e39..569c2e85bb4 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -10,7 +10,6 @@
 
 from .helper import (
     assert_image_equal_tofile,
-    assert_image_similar_tofile,
     skip_unless_feature,
 )
 
@@ -73,7 +72,7 @@ def test_draw(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     im = Image.new("L", (130, 30), "white")
     draw = ImageDraw.Draw(im)
     draw.text((0, 0), message, "black", font=font)
-    assert_image_similar_tofile(im, "Tests/images/test_draw_pbm_target.png", 0)
+    assert_image_equal_tofile(im, "Tests/images/test_draw_pbm_target.png")
 
 
 def test_textsize(request: pytest.FixtureRequest, tmp_path: Path) -> None:
@@ -100,7 +99,7 @@ def _test_high_characters(
     im = Image.new("L", (750, 30), "white")
     draw = ImageDraw.Draw(im)
     draw.text((0, 0), message, "black", font=font)
-    assert_image_similar_tofile(im, "Tests/images/high_ascii_chars.png", 0)
+    assert_image_equal_tofile(im, "Tests/images/high_ascii_chars.png")
 
 
 def test_high_characters(request: pytest.FixtureRequest, tmp_path: Path) -> None:
diff --git a/Tests/test_font_pcf_charsets.py b/Tests/test_font_pcf_charsets.py
index f1ade907b0e..6ebaa35ffa8 100644
--- a/Tests/test_font_pcf_charsets.py
+++ b/Tests/test_font_pcf_charsets.py
@@ -10,7 +10,6 @@
 
 from .helper import (
     assert_image_equal_tofile,
-    assert_image_similar_tofile,
     skip_unless_feature,
 )
 
@@ -85,7 +84,7 @@ def test_draw(request: pytest.FixtureRequest, tmp_path: Path, encoding: str) ->
     draw = ImageDraw.Draw(im)
     message = charsets[encoding]["message"].encode(encoding)
     draw.text((0, 0), message, "black", font=font)
-    assert_image_similar_tofile(im, charsets[encoding]["image1"], 0)
+    assert_image_equal_tofile(im, charsets[encoding]["image1"])
 
 
 @pytest.mark.parametrize("encoding", ("iso8859-1", "iso8859-2", "cp1250"))
diff --git a/Tests/test_uploader.py b/Tests/test_uploader.py
index d55ceb4be17..0491a22a11c 100644
--- a/Tests/test_uploader.py
+++ b/Tests/test_uploader.py
@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from .helper import assert_image_equal, assert_image_similar, hopper
+from .helper import assert_image_equal, hopper
 
 
 def check_upload_equal() -> None:
@@ -12,4 +12,4 @@ def check_upload_equal() -> None:
 def check_upload_similar() -> None:
     result = hopper("P").convert("RGB")
     target = hopper("RGB")
-    assert_image_similar(result, target, 0)
+    assert_image_equal(result, target)

From fd8fa7df798423eaeae07d8b29727b7de328c548 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 7 Feb 2026 11:19:18 +1100
Subject: [PATCH 2256/2374] Simplified code

---
 src/PIL/FpxImagePlugin.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/src/PIL/FpxImagePlugin.py b/src/PIL/FpxImagePlugin.py
index 297971234d8..0b06aac965f 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -141,7 +141,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
 
         size = i32(s, 4), i32(s, 8)
         # tilecount = i32(s, 12)
-        tilesize = i32(s, 16), i32(s, 20)
+        xtile, ytile = i32(s, 16), i32(s, 20)
         # channels = i32(s, 24)
         offset = i32(s, 28)
         length = i32(s, 32)
@@ -156,7 +156,6 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
 
         x = y = 0
         xsize, ysize = size
-        xtile, ytile = tilesize
         self.tile = []
 
         for i in range(0, len(s), length):
@@ -224,7 +223,7 @@ def _open_subimage(self, index: int = 1, subimage: int = 0) -> None:
                 msg = "unknown/invalid compression"
                 raise OSError(msg)
 
-            x = x + xtile
+            x += xtile
             if x >= xsize:
                 x, y = 0, y + ytile
                 if y >= ysize:

From 657d6ea4b6247f0b23d428fc523a12b07a934f84 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 9 Feb 2026 11:07:07 +0200
Subject: [PATCH 2257/2374] CI: Disable pip upgrade warning

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

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 103d915c047..3a206e26945 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -29,6 +29,7 @@ concurrency:
 env:
   COVERAGE_CORE: sysmon
   FORCE_COLOR: 1
+  PIP_DISABLE_PIP_VERSION_CHECK: 1
 
 jobs:
   build:

From 3e14bea593449d76c2b3e6e63aafa26e3c0aedcb Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 9 Feb 2026 22:18:01 +1100
Subject: [PATCH 2258/2374] Use `assert_image_equal_tofile` when similarity is
 zero

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

diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index ce5b36413cf..01d56dfd3e5 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -82,7 +82,7 @@ def test_to_imagefont(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     im = Image.new("L", (130, 30), "white")
     draw = ImageDraw.Draw(im)
     draw.text((0, 0), message, "black", font=imgfont)
-    assert_image_similar_tofile(im, "Tests/images/test_draw_pbm_target.png", 0)
+    assert_image_equal_tofile(im, "Tests/images/test_draw_pbm_target.png")
 
 
 def test_textsize(request: pytest.FixtureRequest, tmp_path: Path) -> None:

From 0604d6a2c9cd6ac0c86baeda436abed06638d374 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Feb 2026 21:12:31 +1100
Subject: [PATCH 2259/2374] Remove unused argument

---
 Tests/test_font_pcf.py | 6 +++---
 src/PIL/FontFile.py    | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 01d56dfd3e5..8ac63ea61ae 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -75,13 +75,13 @@ def test_draw(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     assert_image_equal_tofile(im, "Tests/images/test_draw_pbm_target.png")
 
 
-def test_to_imagefont(request: pytest.FixtureRequest, tmp_path: Path) -> None:
+def test_to_imagefont(tmp_path: Path) -> None:
     with open(fontname, "rb") as test_file:
         pcffont = PcfFontFile.PcfFontFile(test_file)
-    imgfont = pcffont.to_imagefont()
+    imagefont = pcffont.to_imagefont()
     im = Image.new("L", (130, 30), "white")
     draw = ImageDraw.Draw(im)
-    draw.text((0, 0), message, "black", font=imgfont)
+    draw.text((0, 0), message, "black", font=imagefont)
     assert_image_equal_tofile(im, "Tests/images/test_draw_pbm_target.png")
 
 
diff --git a/src/PIL/FontFile.py b/src/PIL/FontFile.py
index b50385daac6..71a08b05e71 100644
--- a/src/PIL/FontFile.py
+++ b/src/PIL/FontFile.py
@@ -151,6 +151,6 @@ def to_imagefont(self) -> ImageFont.ImageFont:
         buf = io.BytesIO()
         self.save_metrics(buf)
         buf.seek(0)
-        imgfont = ImageFont.ImageFont()
-        imgfont._load_pilfont_data(buf, self.bitmap)
-        return imgfont
+        imagefont = ImageFont.ImageFont()
+        imagefont._load_pilfont_data(buf, self.bitmap)
+        return imagefont

From 612e3c24a4f38837a6d915fe8eac15a7d1eeca17 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Feb 2026 21:39:39 +1100
Subject: [PATCH 2260/2374] Remove temporary buffer

---
 src/PIL/FontFile.py  | 39 +++++++++++++++++++++------------------
 src/PIL/ImageFont.py |  3 +++
 2 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/src/PIL/FontFile.py b/src/PIL/FontFile.py
index 71a08b05e71..c0c64fe6842 100644
--- a/src/PIL/FontFile.py
+++ b/src/PIL/FontFile.py
@@ -15,7 +15,6 @@
 #
 from __future__ import annotations
 
-import io
 import os
 from typing import BinaryIO
 
@@ -111,6 +110,22 @@ def compile(self) -> None:
                 self.bitmap.paste(im.crop(src), s)
                 self.metrics[i] = d, dst, s
 
+    def _encode_metrics(self) -> bytes:
+        values: tuple[int, ...] = ()
+        for id in range(256):
+            m = self.metrics[id]
+            if m:
+                values += m[0] + m[1] + m[2]
+            else:
+                values += (0,) * 10
+
+        metrics = b""
+        for v in values:
+            if v < 0:
+                v += 65536
+            metrics += _binary.o16be(v)
+        return metrics
+
     def save(self, filename: str) -> None:
         """Save font"""
 
@@ -124,19 +139,10 @@ def save(self, filename: str) -> None:
 
         # font metrics
         with open(os.path.splitext(filename)[0] + ".pil", "wb") as fp:
-            self.save_metrics(fp)
-
-    def save_metrics(self, fp: BinaryIO) -> None:
-        """Save font metrics to a file-like object"""
-        fp.write(b"PILfont\n")
-        fp.write(f";;;;;;{self.ysize};\n".encode("ascii"))  # HACK!!!
-        fp.write(b"DATA\n")
-        for id in range(256):
-            m = self.metrics[id]
-            if not m:
-                puti16(fp, (0,) * 10)
-            else:
-                puti16(fp, m[0] + m[1] + m[2])
+            fp.write(b"PILfont\n")
+            fp.write(f";;;;;;{self.ysize};\n".encode("ascii"))  # HACK!!!
+            fp.write(b"DATA\n")
+            fp.write(self._encode_metrics())
 
     def to_imagefont(self) -> ImageFont.ImageFont:
         """Convert to ImageFont"""
@@ -148,9 +154,6 @@ def to_imagefont(self) -> ImageFont.ImageFont:
             msg = "No bitmap created"
             raise ValueError(msg)
 
-        buf = io.BytesIO()
-        self.save_metrics(buf)
-        buf.seek(0)
         imagefont = ImageFont.ImageFont()
-        imagefont._load_pilfont_data(buf, self.bitmap)
+        imagefont._load(self.bitmap, self._encode_metrics())
         return imagefont
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index ae003d139c9..ea7f4dc5477 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -149,6 +149,9 @@ def _load_pilfont_data(self, file: IO[bytes], image: Image.Image) -> None:
         # read PILfont metrics
         data = file.read(256 * 20)
 
+        self._load(image, data)
+
+    def _load(self, image: Image.Image, data: bytes) -> None:
         image.load()
 
         self.font = Image.core.font(image.im, data)

From 723e7648267b5205b349d3d5a482202e0372fed5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 6 Feb 2026 21:27:22 +1100
Subject: [PATCH 2261/2374] Improved coverage

---
 Tests/test_fontfile.py | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/Tests/test_fontfile.py b/Tests/test_fontfile.py
index 575dada86cb..1a9069fd892 100644
--- a/Tests/test_fontfile.py
+++ b/Tests/test_fontfile.py
@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from io import BytesIO
 from pathlib import Path
 
 import pytest
@@ -7,6 +8,15 @@
 from PIL import FontFile, Image
 
 
+def test_puti16() -> None:
+    fp = BytesIO()
+    FontFile.puti16(fp, (0, 1, 2, 3, 4, 5, 6, 7, 8, 9))
+    assert fp.getvalue() == (
+        b"\x00\x00\x00\x01\x00\x02\x00\x03\x00\x04"
+        b"\x00\x05\x00\x06\x00\x07\x00\x08\x00\t"
+    )
+
+
 def test_compile() -> None:
     font = FontFile.FontFile()
     font.glyph[0] = ((0, 0), (0, 0, 0, 0), (0, 0, 0, 1), Image.new("L", (0, 0)))
@@ -24,5 +34,11 @@ def test_save(tmp_path: Path) -> None:
     tempname = str(tmp_path / "temp.pil")
 
     font = FontFile.FontFile()
-    with pytest.raises(ValueError):
+    with pytest.raises(ValueError, match="No bitmap created"):
         font.save(tempname)
+
+
+def test_to_imagefont() -> None:
+    font = FontFile.FontFile()
+    with pytest.raises(ValueError, match="No bitmap created"):
+        font.to_imagefont()

From 54ba4db542ad3c7b918812a4e2d69c27735a3199 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 11 Feb 2026 10:24:50 +1100
Subject: [PATCH 2262/2374] Fix OOB Write with invalid tile extents (#9427)

Co-authored-by: Eric Soroos <eric-github@soroos.net>
---
 Tests/images/psd-oob-write-x.psd | Bin 0 -> 1126 bytes
 Tests/images/psd-oob-write-y.psd | Bin 0 -> 1126 bytes
 Tests/images/psd-oob-write.psd   | Bin 0 -> 37212 bytes
 Tests/test_file_psd.py           |  17 +++++++++++++++++
 Tests/test_imagefile.py          |   7 +++++++
 docs/releasenotes/12.1.1.rst     |  24 ++++++++++++++++++++++++
 docs/releasenotes/index.rst      |   1 +
 src/decode.c                     |   3 ++-
 src/encode.c                     |   3 ++-
 9 files changed, 53 insertions(+), 2 deletions(-)
 create mode 100644 Tests/images/psd-oob-write-x.psd
 create mode 100644 Tests/images/psd-oob-write-y.psd
 create mode 100644 Tests/images/psd-oob-write.psd
 create mode 100644 docs/releasenotes/12.1.1.rst

diff --git a/Tests/images/psd-oob-write-x.psd b/Tests/images/psd-oob-write-x.psd
new file mode 100644
index 0000000000000000000000000000000000000000..86359f4cb7e826a69a8e69a4b85947498ec18923
GIT binary patch
literal 1126
zcma)5J!lkB5dL=WC-F>3z$=1SY;juU8Wp`VZp09|z;cO@XbSh|ZgXUJ@7TRX4pIuX
z0SkW`qZT&S+FIBOg5VE`wTL!~HWJqFz0GA0$%PEez3<J;H#cu)wx%1)P>@QFhrkNP
zAuvV#TGJPoazEr{TAAgkKpC9EmzOT6P~@#DuSJ<hm6j=CQFnxTwjbr^06*x3jRjp>
zUAwN0ePiq~9H(A1?WlXnFzSMFu>5&1Gvi%V<T^NJq;=A1Mm8UyF=Ec{hCSk&#20S$
zx&q%PF54TXL;Re0He`XsABEjY@ppk;iB&?B!<EK7-&Q8p+#zfYVS6L=8FQX76~_;l
zUtLYHBk-2Mz8AALDPjf_&EVQH&kFSv7O;pV7|>uLMjIY_sPYVGiO`^5AHhE<`36}Q
zS#8*4Tt){zOv#6s0b?jxZ==?^v(ltY=s@91lKeUijNJuxx0B@W<0RRA0^~jeuY!!<
z*#T<5Y2VIll}EtTZQ#Z0%x2vKUfuy_K6TB|l>Z~PO>MP+pU;5FHQ>ZspmZbc8-2o$
zryqb7_Nx8{c<>N7<1+X9h<A^Zu-~^sWA^&TIbWq-;U;II5Gs4$Lb}sM=`V`S4mzQq
zq_OJ*N=Y~EO*ibs9I}Y<;-F3647CKEJ-4w57a=DQb9#=9>9@HB$WwFjZhIlIc)`9T
z6kgJL@)8%N^RTLn0liQ+`%UH?s%V<N0_v=&k0$F$eOV>)+x7mhM3JvQ>aRNJ<v*Wo
Br)B^E

literal 0
HcmV?d00001

diff --git a/Tests/images/psd-oob-write-y.psd b/Tests/images/psd-oob-write-y.psd
new file mode 100644
index 0000000000000000000000000000000000000000..73498266a7d732ad70be649718229fa5f07997b7
GIT binary patch
literal 1126
zcma)5O=uHQ5dL=a(;8b^Foz-@_7FWa7ZuI1ZpBhbVM!~r+JpO(Y(sZ9VK++&coe)A
zJot05>cNX=y?XE}2!cN#o<;Pc=tau<y|;-Qq$v(e-uGtao6MV;t?9-p6r_^lA+Ul;
z2ux8w*YxF;+&6idRpxmrP==@Q<)sTM6nU%4Yf<J=rDaA~)IFh|?ML|qzz=$1V@cQ6
zH?C?EUl@A?N2%vcJL+CAjJjYPEWh5$%y?53xeksQYn^tQk<ABaj99R{VUPGa@wuH|
zSKzzEWqZqXh@TSAhb)lzy|7y;{wlC5u}X+?xYk(Y+see6JA$ndY;T1=W6m<B;`jmc
ztLrIt1im4#@5QW5ikQJvGq|$KvqC+AB`jkF1~gcR(T0Z}syqW)A~fjN$MBC!zCo5n
zRvR`M7tw(aQ}Q8Zz!*x_+o*Nsv@|JGI#BqOBtK396Ssl=-6Z+_FiG|w0lAOBiy-57
z_JG<?+IKTs<pD5r6L|JAvsrh5=eK~l4_z}f<^PCnQ(G<I`x9V#132~?C|yhYMxXHG
z@jGCRy{f+g?%fAYxy-#e=G~Jd{O#MJF@yeb&X=i|xXGC)gv#JsNO!s@{YA0aK_~Q+
zG<I`HDe0!Y?S`G0Ll!Y!9JJ}1qn4nv=Qg(CBIE>OPS24s{WiA%d1_AHZ7(DiFOZT@
z1~9EBFYiTZJFF^Wz(S#J_M6N(Qqe4Z1=LwlA5GSi`m##ox9j~=340;B^S{69u$O-T
DuU)5R

literal 0
HcmV?d00001

diff --git a/Tests/images/psd-oob-write.psd b/Tests/images/psd-oob-write.psd
new file mode 100644
index 0000000000000000000000000000000000000000..65a4472cf263a94277952c06903709afb0c8213f
GIT binary patch
literal 37212
zcmeI!I|{-;5CG8e2f;Js6jo_XXCVk)LDH$<2|S2L%6V+#=3`?OM1sW|nCvc@*<D_>
zMR_>JEc#fa;nZao?R<!Q8IecK-|IB4yX<SKuD|O3S4FwoU#_=vGZZ&X^GNwj%T3Bv
zzi(EzJ?WeF%<9jci0uU7lnIa>L4W`O0t5&U7$GptyKKZoln@|5fB*pk1ildPmiYor
z3jqQI2oNCfHv$oNL4W`O0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N
z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+
t009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+0D&I~yZ}A8uQLDu

literal 0
HcmV?d00001

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 8f2ca58a662..8a2636dfe22 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -182,3 +182,20 @@ def test_layer_crashes(test_file: str) -> None:
         assert isinstance(im, PsdImagePlugin.PsdImageFile)
         with pytest.raises(SyntaxError):
             im.layers
+
+
+@pytest.mark.parametrize(
+    "test_file",
+    [
+        "Tests/images/psd-oob-write.psd",
+        "Tests/images/psd-oob-write-x.psd",
+        "Tests/images/psd-oob-write-y.psd",
+    ],
+)
+def test_bounds_crash(test_file: str) -> None:
+    with Image.open(test_file) as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
+        im.seek(im.n_frames)
+
+        with pytest.raises(ValueError):
+            im.load()
diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 8a0abbd39b1..6656ee506ca 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -163,6 +163,13 @@ def test_negative_offset(self) -> None:
             with pytest.raises(ValueError, match="Tile offset cannot be negative"):
                 im.load()
 
+    @pytest.mark.parametrize("xy", ((-1, 0), (0, -1)))
+    def test_negative_tile_extents(self, xy: tuple[int, int]) -> None:
+        im = Image.new("1", (1, 1))
+        fp = BytesIO()
+        with pytest.raises(SystemError, match="tile cannot extend outside image"):
+            ImageFile._save(im, fp, [ImageFile._Tile("raw", xy + (1, 1), 0, "1")])
+
     def test_no_format(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
diff --git a/docs/releasenotes/12.1.1.rst b/docs/releasenotes/12.1.1.rst
new file mode 100644
index 00000000000..9c119ceb8b4
--- /dev/null
+++ b/docs/releasenotes/12.1.1.rst
@@ -0,0 +1,24 @@
+12.1.1
+------
+
+Security
+========
+
+:cve:`2021-25289`: Fix OOB write with invalid tile extents
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Check that tile extents do not use negative x or y offsets when decoding or encoding,
+and raise an error if they do, rather than allowing an OOB write.
+
+An out-of-bounds write may be triggered when opening a specially crafted PSD image.
+This only affects Pillow >= 10.3.0. Reported by
+`Yarden Porat <https://github.com/yardenporat353>`__.
+
+Other changes
+=============
+
+Patch libavif for svt-av1 4.0 compatibility
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+A patch has been added to ``depends/install_libavif.sh``, to allow libavif 1.3.0 to be
+compatible with the recently released svt-av1 4.0.0.
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 4b25bb6a2d1..690be20729e 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -15,6 +15,7 @@ expected to be backported to earlier versions.
   :maxdepth: 2
 
   versioning
+  12.1.1
   12.1.0
   12.0.0
   11.3.0
diff --git a/src/decode.c b/src/decode.c
index 051623ed448..7ec461c0e2c 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -186,7 +186,8 @@ _setimage(ImagingDecoderObject *decoder, PyObject *args) {
         state->ysize = y1 - y0;
     }
 
-    if (state->xsize <= 0 || state->xsize + state->xoff > (int)im->xsize ||
+    if (state->xoff < 0 || state->xsize <= 0 ||
+        state->xsize + state->xoff > (int)im->xsize || state->yoff < 0 ||
         state->ysize <= 0 || state->ysize + state->yoff > (int)im->ysize) {
         PyErr_SetString(PyExc_ValueError, "tile cannot extend outside image");
         return NULL;
diff --git a/src/encode.c b/src/encode.c
index 513309c8d7d..06e4a089380 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -254,7 +254,8 @@ _setimage(ImagingEncoderObject *encoder, PyObject *args) {
         state->ysize = y1 - y0;
     }
 
-    if (state->xsize <= 0 || state->xsize + state->xoff > im->xsize ||
+    if (state->xoff < 0 || state->xsize <= 0 ||
+        state->xsize + state->xoff > im->xsize || state->yoff < 0 ||
         state->ysize <= 0 || state->ysize + state->yoff > im->ysize) {
         PyErr_SetString(PyExc_SystemError, "tile cannot extend outside image");
         return NULL;

From a15f9c6121b236e1463b798131c07bd1ab08ffc6 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 11 Feb 2026 13:48:11 +0200
Subject: [PATCH 2263/2374] Fix CVE number (#9430)

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

diff --git a/docs/releasenotes/12.1.1.rst b/docs/releasenotes/12.1.1.rst
index 9c119ceb8b4..86083b4ad08 100644
--- a/docs/releasenotes/12.1.1.rst
+++ b/docs/releasenotes/12.1.1.rst
@@ -4,7 +4,7 @@
 Security
 ========
 
-:cve:`2021-25289`: Fix OOB write with invalid tile extents
+:cve:`2026-25990`: Fix OOB write with invalid tile extents
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Check that tile extents do not use negative x or y offsets when decoding or encoding,

From 27765189c8d7edb7a17ea0dbefcc258e5ee7e427 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 11 Feb 2026 23:51:33 +1100
Subject: [PATCH 2264/2374] 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 0789b02b75a..7a8707b9a30 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 26 Tahoe                   | 3.10, 3.11, 3.12, 3.13, 3.14| 12.0.0           |arm           |
+| macOS 26 Tahoe                   | 3.10, 3.11, 3.12, 3.13, 3.14| 12.1.1           |arm           |
 |                                  +-----------------------------+------------------+              |
 |                                  | 3.9                         | 11.3.0           |              |
 +----------------------------------+-----------------------------+------------------+--------------+

From 3795a1b916b690d1f23d9230c65718a75b9dfa26 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Feb 2026 19:58:36 +1100
Subject: [PATCH 2265/2374] Use uppercase format id

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

diff --git a/src/PIL/PalmImagePlugin.py b/src/PIL/PalmImagePlugin.py
index 15f71290816..232adf3d3bb 100644
--- a/src/PIL/PalmImagePlugin.py
+++ b/src/PIL/PalmImagePlugin.py
@@ -210,8 +210,8 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
 #
 # --------------------------------------------------------------------
 
-Image.register_save("Palm", _save)
+Image.register_save("PALM", _save)
 
-Image.register_extension("Palm", ".palm")
+Image.register_extension("PALM", ".palm")
 
-Image.register_mime("Palm", "image/palm")
+Image.register_mime("PALM", "image/palm")

From 657d0414f07d37ec8abecc02879154834bf7a009 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 12 Feb 2026 21:51:01 +1100
Subject: [PATCH 2266/2374] Merge PFM into PPM

---
 docs/handbook/image-file-formats.rst | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index 35ec99ece45..add42a3a0ef 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -828,16 +828,6 @@ 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) Portable FloatMap (PFM) files
-containing ``F`` data.
-
-Color (PF format) PFM files are not supported.
-
 Opening
 ~~~~~~~
 
@@ -1081,13 +1071,18 @@ following parameters can also be set:
 PPM
 ^^^
 
-Pillow reads and writes PBM, PGM, PPM and PNM files containing ``1``, ``L``, ``I`` or
-``RGB`` data.
+Pillow reads and writes PBM, PGM, PPM, PNM and PFM files containing ``1``, ``L``, ``I``,
+``RGB`` or ``F`` data.
 
 "Raw" (P4 to P6) formats can be read, and are used when writing.
 
 Since Pillow 9.2.0, "plain" (P1 to P3) formats can be read as well.
 
+Since Pillow 10.3.0, grayscale (Pf format) Portable FloatMap (PFM) files containing
+``F`` data can be read and used when writing as well.
+
+Color (PF format) PFM files are not supported.
+
 QOI
 ^^^
 

From 0ce21f98e7aab659e858475e728bb1cf98587f8a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Feb 2026 18:06:29 +1100
Subject: [PATCH 2267/2374] Updated documentation

---
 docs/reference/ImageFont.rst | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/reference/ImageFont.rst b/docs/reference/ImageFont.rst
index aac55fe6b05..d4d66988b0c 100644
--- a/docs/reference/ImageFont.rst
+++ b/docs/reference/ImageFont.rst
@@ -8,10 +8,14 @@ The :py:mod:`~PIL.ImageFont` module defines a class with the same name. Instance
 this class store bitmap fonts, and are used with the
 :py:meth:`PIL.ImageDraw.ImageDraw.text` method.
 
-PIL uses its own font file format to store bitmap fonts, limited to 256 characters. You can use
-`pilfont.py <https://github.com/python-pillow/pillow-scripts/blob/main/Scripts/pilfont.py>`_
-from :pypi:`pillow-scripts` to convert BDF and
-PCF font descriptors (X window font formats) to this format.
+PIL uses its own font file format to store bitmap fonts, limited to 256 characters. You
+can use :py:meth:`~PIL.FontFile.FontFile.to_imagefont` to convert BDF and PCF font
+descriptors (X window font formats) to this format::
+
+    from PIL import PcfFontFile
+    with open("Tests/fonts/10x20-ISO8859-1.pcf", "rb") as fp:
+        font = PcfFontFile.PcfFontFile(fp)
+        imagefont = font.to_imagefont()
 
 Starting with version 1.1.4, PIL can be configured to support TrueType and
 OpenType fonts (as well as other font formats supported by the FreeType

From f71d74eec2300c42578632f6cb83d3bf3e9dbebb Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 13 Feb 2026 18:29:41 +1100
Subject: [PATCH 2268/2374] Use versionadded

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/handbook/image-file-formats.rst | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/docs/handbook/image-file-formats.rst b/docs/handbook/image-file-formats.rst
index add42a3a0ef..a9fd764e613 100644
--- a/docs/handbook/image-file-formats.rst
+++ b/docs/handbook/image-file-formats.rst
@@ -1076,10 +1076,12 @@ Pillow reads and writes PBM, PGM, PPM, PNM and PFM files containing ``1``, ``L``
 
 "Raw" (P4 to P6) formats can be read, and are used when writing.
 
-Since Pillow 9.2.0, "plain" (P1 to P3) formats can be read as well.
+.. versionadded:: 9.2.0
+   "Plain" (P1 to P3) formats can be read.
 
-Since Pillow 10.3.0, grayscale (Pf format) Portable FloatMap (PFM) files containing
-``F`` data can be read and used when writing as well.
+.. versionadded:: 10.3.0
+   Grayscale (Pf format) Portable FloatMap (PFM) files containing
+   ``F`` data can be read and used when writing.
 
 Color (PF format) PFM files are not supported.
 

From 2c00c6f80e0b268f1ecc4287553e4d96084d996a Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 16 Feb 2026 12:29:42 +0200
Subject: [PATCH 2269/2374] GHA: Cache libavif and webp builds for Ubuntu
 (#9437)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .ci/install.sh             |   2 +-
 .github/workflows/docs.yml |  16 +++++
 .github/workflows/test.yml |  18 +++++
 depends/install_libavif.sh | 134 +++++++++++++++++++++----------------
 depends/install_webp.sh    |  28 ++++++--
 5 files changed, 137 insertions(+), 61 deletions(-)

diff --git a/.ci/install.sh b/.ci/install.sh
index aeb5e65145d..9553eb8f442 100755
--- a/.ci/install.sh
+++ b/.ci/install.sh
@@ -53,7 +53,7 @@ pushd depends && ./install_imagequant.sh && popd
 pushd depends && sudo ./install_raqm.sh && popd
 
 # libavif
-pushd depends && sudo ./install_libavif.sh && popd
+pushd depends && ./install_libavif.sh && popd
 
 # extra test images
 pushd depends && ./install_extra_test_images.sh && popd
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 44af3e3dfdb..857881c0102 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -48,6 +48,13 @@ jobs:
     - name: Build system information
       run: python3 .github/workflows/system-info.py
 
+    - name: Cache libavif
+      uses: actions/cache@v5
+      id: cache-libavif
+      with:
+        path: ~/cache-libavif
+        key: ${{ runner.os }}-libavif-${{ hashFiles('depends/install_libavif.sh', 'depends/libavif-svt4.patch') }}
+
     - name: Cache libimagequant
       uses: actions/cache@v5
       id: cache-libimagequant
@@ -55,12 +62,21 @@ jobs:
         path: ~/cache-libimagequant
         key: ${{ runner.os }}-libimagequant-${{ hashFiles('depends/install_imagequant.sh') }}
 
+    - name: Cache libwebp
+      uses: actions/cache@v5
+      id: cache-libwebp
+      with:
+        path: ~/cache-libwebp
+        key: ${{ runner.os }}-libwebp-${{ hashFiles('depends/install_webp.sh') }}
+
     - name: Install Linux dependencies
       run: |
         .ci/install.sh
       env:
         GHA_PYTHON_VERSION: "3.x"
+        GHA_LIBAVIF_CACHE_HIT: ${{ steps.cache-libavif.outputs.cache-hit }}
         GHA_LIBIMAGEQUANT_CACHE_HIT: ${{ steps.cache-libimagequant.outputs.cache-hit }}
+        GHA_LIBWEBP_CACHE_HIT: ${{ steps.cache-libwebp.outputs.cache-hit }}
 
     - name: Build
       run: |
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 3a206e26945..471cab90e3d 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -91,6 +91,14 @@ jobs:
     - name: Build system information
       run: python3 .github/workflows/system-info.py
 
+    - name: Cache libavif
+      if: startsWith(matrix.os, 'ubuntu')
+      uses: actions/cache@v5
+      id: cache-libavif
+      with:
+        path: ~/cache-libavif
+        key: ${{ runner.os }}-libavif-${{ hashFiles('depends/install_libavif.sh', 'depends/libavif-svt4.patch') }}
+
     - name: Cache libimagequant
       if: startsWith(matrix.os, 'ubuntu')
       uses: actions/cache@v5
@@ -99,13 +107,23 @@ jobs:
         path: ~/cache-libimagequant
         key: ${{ runner.os }}-libimagequant-${{ hashFiles('depends/install_imagequant.sh') }}
 
+    - name: Cache libwebp
+      if: startsWith(matrix.os, 'ubuntu')
+      uses: actions/cache@v5
+      id: cache-libwebp
+      with:
+        path: ~/cache-libwebp
+        key: ${{ runner.os }}-libwebp-${{ hashFiles('depends/install_webp.sh') }}
+
     - name: Install Linux dependencies
       if: startsWith(matrix.os, 'ubuntu')
       run: |
         .ci/install.sh
       env:
         GHA_PYTHON_VERSION: ${{ matrix.python-version }}
+        GHA_LIBAVIF_CACHE_HIT: ${{ steps.cache-libavif.outputs.cache-hit }}
         GHA_LIBIMAGEQUANT_CACHE_HIT: ${{ steps.cache-libimagequant.outputs.cache-hit }}
+        GHA_LIBWEBP_CACHE_HIT: ${{ steps.cache-libwebp.outputs.cache-hit }}
 
     - name: Install macOS dependencies
       if: startsWith(matrix.os, 'macOS')
diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
index a6686f3ef3a..0089bf2b5fd 100755
--- a/depends/install_libavif.sh
+++ b/depends/install_libavif.sh
@@ -3,66 +3,88 @@ set -eo pipefail
 
 version=1.3.0
 
-./download-and-extract.sh libavif-$version https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$version.tar.gz
+if [[ "$GHA_LIBAVIF_CACHE_HIT" == "true" ]]; then
 
-pushd libavif-$version
+    LIBDIR=/usr/lib/x86_64-linux-gnu
 
-# Apply patch for SVT-AV1 4.0 compatibility
-# Pending release of https://github.com/AOMediaCodec/libavif/pull/2971
-patch -p1 < ../libavif-svt4.patch
+    # Copy cached files into place
+    sudo cp ~/cache-libavif/lib/* $LIBDIR/
+    sudo cp -r ~/cache-libavif/include/avif /usr/include/
 
-if [ $(uname) == "Darwin" ] && [ -x "$(command -v brew)" ]; then
-    PREFIX=$(brew --prefix)
 else
-    PREFIX=/usr
-fi
-
-PKGCONFIG=${PKGCONFIG:-pkg-config}
-
-LIBAVIF_CMAKE_FLAGS=()
-HAS_DECODER=0
-HAS_ENCODER=0
-
-if $PKGCONFIG --exists aom; then
-    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_AOM=SYSTEM)
-    HAS_ENCODER=1
-    HAS_DECODER=1
-fi
-
-if $PKGCONFIG --exists dav1d; then
-    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_DAV1D=SYSTEM)
-    HAS_DECODER=1
-fi
 
-if $PKGCONFIG --exists libgav1; then
-    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_LIBGAV1=SYSTEM)
-    HAS_DECODER=1
-fi
+    ./download-and-extract.sh libavif-$version https://github.com/AOMediaCodec/libavif/archive/refs/tags/v$version.tar.gz
+
+    pushd libavif-$version
+
+    # Apply patch for SVT-AV1 4.0 compatibility
+    # Pending release of https://github.com/AOMediaCodec/libavif/pull/2971
+    patch -p1 < ../libavif-svt4.patch
+
+    if [ $(uname) == "Darwin" ] && [ -x "$(command -v brew)" ]; then
+        PREFIX=$(brew --prefix)
+    else
+        PREFIX=/usr
+    fi
+
+    PKGCONFIG=${PKGCONFIG:-pkg-config}
+
+    LIBAVIF_CMAKE_FLAGS=()
+    HAS_DECODER=0
+    HAS_ENCODER=0
+
+    if $PKGCONFIG --exists aom; then
+        LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_AOM=SYSTEM)
+        HAS_ENCODER=1
+        HAS_DECODER=1
+    fi
+
+    if $PKGCONFIG --exists dav1d; then
+        LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_DAV1D=SYSTEM)
+        HAS_DECODER=1
+    fi
+
+    if $PKGCONFIG --exists libgav1; then
+        LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_LIBGAV1=SYSTEM)
+        HAS_DECODER=1
+    fi
+
+    if $PKGCONFIG --exists rav1e; then
+        LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_RAV1E=SYSTEM)
+        HAS_ENCODER=1
+    fi
+
+    if $PKGCONFIG --exists SvtAv1Enc; then
+        LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_SVT=SYSTEM)
+        HAS_ENCODER=1
+    fi
+
+    if [ "$HAS_ENCODER" != 1 ] || [ "$HAS_DECODER" != 1 ]; then
+        LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_AOM=LOCAL)
+    fi
+
+    cmake \
+        -DCMAKE_INSTALL_PREFIX=$PREFIX \
+        -DCMAKE_INSTALL_NAME_DIR=$PREFIX/lib \
+        -DCMAKE_BUILD_TYPE=Release \
+        -DCMAKE_MACOSX_RPATH=OFF \
+        -DAVIF_LIBSHARPYUV=LOCAL \
+        -DAVIF_LIBYUV=LOCAL \
+        "${LIBAVIF_CMAKE_FLAGS[@]}" \
+        .
+
+    sudo make install
+
+    if [ -n "$GITHUB_ACTIONS" ] && [ "$(uname)" != "Darwin" ]; then
+        # Copy to cache
+        LIBDIR=/usr/lib/x86_64-linux-gnu
+        rm -rf ~/cache-libavif
+        mkdir -p ~/cache-libavif/lib
+        mkdir -p ~/cache-libavif/include
+        cp $LIBDIR/libavif.so* ~/cache-libavif/lib/
+        cp -r /usr/include/avif ~/cache-libavif/include/
+    fi
+
+    popd
 
-if $PKGCONFIG --exists rav1e; then
-    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_RAV1E=SYSTEM)
-    HAS_ENCODER=1
 fi
-
-if $PKGCONFIG --exists SvtAv1Enc; then
-    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_SVT=SYSTEM)
-    HAS_ENCODER=1
-fi
-
-if [ "$HAS_ENCODER" != 1 ] || [ "$HAS_DECODER" != 1 ]; then
-    LIBAVIF_CMAKE_FLAGS+=(-DAVIF_CODEC_AOM=LOCAL)
-fi
-
-cmake \
-    -DCMAKE_INSTALL_PREFIX=$PREFIX \
-    -DCMAKE_INSTALL_NAME_DIR=$PREFIX/lib \
-    -DCMAKE_BUILD_TYPE=Release \
-    -DCMAKE_MACOSX_RPATH=OFF \
-    -DAVIF_LIBSHARPYUV=LOCAL \
-    -DAVIF_LIBYUV=LOCAL \
-    "${LIBAVIF_CMAKE_FLAGS[@]}" \
-    .
-
-make install
-
-popd
diff --git a/depends/install_webp.sh b/depends/install_webp.sh
index d7f3cd2f5d0..c328fe2c86a 100755
--- a/depends/install_webp.sh
+++ b/depends/install_webp.sh
@@ -3,10 +3,30 @@
 
 archive=libwebp-1.6.0
 
-./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
+if [[ "$GHA_LIBWEBP_CACHE_HIT" == "true" ]]; then
 
-pushd $archive
+    # Copy cached files into place
+    sudo cp ~/cache-libwebp/lib/* /usr/lib/
+    sudo cp -r ~/cache-libwebp/include/webp /usr/include/
 
-./configure --prefix=/usr --enable-libwebpmux --enable-libwebpdemux && make -j4 && sudo make -j4 install
+else
 
-popd
+    ./download-and-extract.sh $archive https://raw.githubusercontent.com/python-pillow/pillow-depends/main/$archive.tar.gz
+
+    pushd $archive
+
+    ./configure --prefix=/usr --enable-libwebpmux --enable-libwebpdemux && make -j4 && sudo make -j4 install
+
+    if [ -n "$GITHUB_ACTIONS" ]; then
+        # Copy to cache
+        rm -rf ~/cache-libwebp
+        mkdir -p ~/cache-libwebp/lib
+        mkdir -p ~/cache-libwebp/include
+        cp /usr/lib/libwebp*.so* /usr/lib/libwebp*.a ~/cache-libwebp/lib/
+        cp /usr/lib/libsharpyuv.so* /usr/lib/libsharpyuv.a ~/cache-libwebp/lib/
+        cp -r /usr/include/webp ~/cache-libwebp/include/
+    fi
+
+    popd
+
+fi

From a5c9eba30a4d2463cc0e9de67ae886b318af1fd2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 16 Feb 2026 21:57:27 +1100
Subject: [PATCH 2270/2374] Fix unexpected error when saving zero dimension
 images (#9391)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_file_gif.py       | 8 ++++++++
 Tests/test_file_pcx.py       | 8 ++++++++
 Tests/test_file_spider.py    | 8 ++++++++
 src/PIL/GifImagePlugin.py    | 8 +++++++-
 src/PIL/PcxImagePlugin.py    | 4 ++++
 src/PIL/SpiderImagePlugin.py | 2 +-
 6 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index e3fcec49084..b52816fdc1a 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -310,6 +310,14 @@ def test_roundtrip_save_all_1(tmp_path: Path) -> None:
         assert reloaded.getpixel((0, 0)) == 255
 
 
+@pytest.mark.parametrize("size", ((0, 1), (1, 0), (0, 0)))
+def test_save_zero(size: tuple[int, int]) -> None:
+    b = BytesIO()
+    im = Image.new("RGB", size)
+    with pytest.raises(SystemError):
+        im.save(b, "GIF")
+
+
 @pytest.mark.parametrize(
     "path, mode",
     (
diff --git a/Tests/test_file_pcx.py b/Tests/test_file_pcx.py
index 90740ab5761..509d93469e6 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -37,6 +37,14 @@ def test_sanity(tmp_path: Path) -> None:
         im.save(f)
 
 
+@pytest.mark.parametrize("size", ((0, 1), (1, 0), (0, 0)))
+def test_save_zero(size: tuple[int, int]) -> None:
+    b = io.BytesIO()
+    im = Image.new("1", size)
+    with pytest.raises(ValueError):
+        im.save(b, "PCX")
+
+
 def test_p_4_planes() -> None:
     with Image.open("Tests/images/p_4_planes.pcx") as im:
         assert im.getpixel((0, 0)) == 3
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 03494523b61..903632cffb0 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -68,6 +68,14 @@ def test_save(tmp_path: Path) -> None:
         assert im2.format == "SPIDER"
 
 
+@pytest.mark.parametrize("size", ((0, 1), (1, 0), (0, 0)))
+def test_save_zero(size: tuple[int, int]) -> None:
+    b = BytesIO()
+    im = Image.new("1", size)
+    with pytest.raises(SystemError):
+        im.save(b, "SPIDER")
+
+
 def test_tempfile() -> None:
     # Arrange
     im = hopper()
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 76a0d4ab99f..390b3b374ab 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -937,7 +937,13 @@ def _get_optimize(im: Image.Image, info: dict[str, Any]) -> list[int] | None:
     :param info: encoderinfo
     :returns: list of indexes of palette entries in use, or None
     """
-    if im.mode in ("P", "L") and info and info.get("optimize"):
+    if (
+        im.mode in ("P", "L")
+        and info
+        and info.get("optimize")
+        and im.width != 0
+        and im.height != 0
+    ):
         # Potentially expensive operation.
 
         # The palette saves 3 bytes per color not used, but palette
diff --git a/src/PIL/PcxImagePlugin.py b/src/PIL/PcxImagePlugin.py
index 6b16d538537..3e34e3c63ba 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -146,6 +146,10 @@ def _open(self) -> None:
 
 
 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 PCX"
+        raise ValueError(msg)
+
     try:
         version, bits, planes, rawmode = SAVE[im.mode]
     except KeyError as e:
diff --git a/src/PIL/SpiderImagePlugin.py b/src/PIL/SpiderImagePlugin.py
index 848dccda577..11d90699d10 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -244,7 +244,7 @@ def loadImageSeries(filelist: list[str] | None = None) -> list[Image.Image] | No
 
 def makeSpiderHeader(im: Image.Image) -> list[bytes]:
     nsam, nrow = im.size
-    lenbyt = nsam * 4  # There are labrec records in the header
+    lenbyt = max(1, nsam) * 4  # There are labrec records in the header
     labrec = int(1024 / lenbyt)
     if 1024 % lenbyt != 0:
         labrec += 1

From 3cd69cb12f10d18a58c94dc01b54c70deba19289 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 17 Feb 2026 18:57:29 +1100
Subject: [PATCH 2271/2374] Specify platform when pulling docker image (#9440)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 .github/workflows/test-docker.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 091edb22264..8f24bef3d6a 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -83,7 +83,7 @@ jobs:
 
     - name: Docker pull
       run: |
-        docker pull pythonpillow/${{ matrix.docker }}:${{ matrix.dockerTag }}
+        docker pull ${{ matrix.qemu-arch && format('--platform=linux/{0}', matrix.qemu-arch)}} pythonpillow/${{ matrix.docker }}:${{ matrix.dockerTag }}
 
     - name: Docker build
       run: |

From 02764a0077d0c267fafd41e63c31beee1e5b6a7e Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Thu, 19 Feb 2026 23:09:59 +1100
Subject: [PATCH 2272/2374] Correct error check when encoding AVIF images
 (#9442)

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

diff --git a/src/_avif.c b/src/_avif.c
index 3585297fe87..5e8b9fe8e93 100644
--- a/src/_avif.c
+++ b/src/_avif.c
@@ -485,7 +485,7 @@ _encoder_add(AvifEncoderObject *self, PyObject *args) {
         frame = image;
     } else {
         frame = avifImageCreateEmpty();
-        if (image == NULL) {
+        if (frame == NULL) {
             PyErr_SetString(PyExc_ValueError, "Image creation failed");
             return NULL;
         }

From 4777a0b31820f184c01d550fa526400dc9b53eaf Mon Sep 17 00:00:00 2001
From: Kadir Can Ozden <101993364+bysiber@users.noreply.github.com>
Date: Sat, 21 Feb 2026 15:21:48 +0300
Subject: [PATCH 2273/2374] Fix BMP RLE delta escape reading from wrong file
 position (#9443)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/images/pal8rletrns.png | Bin 0 -> 4089 bytes
 Tests/test_file_bmp.py       |   5 +++++
 src/PIL/BmpImagePlugin.py    |   2 +-
 3 files changed, 6 insertions(+), 1 deletion(-)
 create mode 100644 Tests/images/pal8rletrns.png

diff --git a/Tests/images/pal8rletrns.png b/Tests/images/pal8rletrns.png
new file mode 100644
index 0000000000000000000000000000000000000000..2362266ef0287fd543aaae2b3769cbdf49386ce5
GIT binary patch
literal 4089
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
I2Cqo{A2mRU6951J

literal 0
HcmV?d00001

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 28e863459a6..2e0394b3b2a 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -221,6 +221,11 @@ def test_rle8_eof(file_name: str, length: int) -> None:
             im.load()
 
 
+def test_rle_delta() -> None:
+    with Image.open("Tests/images/bmp/q/pal8rletrns.bmp") as im:
+        assert_image_equal_tofile(im, "Tests/images/pal8rletrns.png")
+
+
 def test_unsupported_bmp_bitfields_layout() -> None:
     fp = io.BytesIO(
         o32(40)  # header size
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index a1227137017..5ee61b35b17 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -369,7 +369,7 @@ def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int
                     bytes_read = self.fd.read(2)
                     if len(bytes_read) < 2:
                         break
-                    right, up = self.fd.read(2)
+                    right, up = bytes_read
                     data += b"\x00" * (right + up * self.state.xsize)
                     x = len(data) % self.state.xsize
                 else:

From 43c12af7301a77c461f23df3a1dcda25857bea5c Mon Sep 17 00:00:00 2001
From: Kadir Can Ozden <101993364+bysiber@users.noreply.github.com>
Date: Sat, 21 Feb 2026 15:23:38 +0300
Subject: [PATCH 2274/2374] Fix `self.decode` typo (#9445)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 src/PIL/ImageFile.py | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 34143543733..50e0075a29d 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -579,10 +579,7 @@ def feed(self, data: bytes) -> None:
                 pass  # not enough data
             else:
                 flag = hasattr(im, "load_seek") or hasattr(im, "load_read")
-                if flag or len(im.tile) != 1:
-                    # custom load code, or multiple tiles
-                    self.decode = None
-                else:
+                if not flag and len(im.tile) == 1:
                     # initialize decoder
                     im.load_prepare()
                     d, e, o, a = im.tile[0]

From 81e0cf2bc4023a054f80a1b6de0e8634db5d19e5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 23 Feb 2026 00:17:59 +1100
Subject: [PATCH 2275/2374] Add check-case-conflict hook (#9446)

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

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7eb69d1642c..19be90c1610 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -38,6 +38,7 @@ repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
     hooks:
+      - id: check-case-conflict
       - id: check-executables-have-shebangs
       - id: check-shebang-scripts-are-executable
       - id: check-merge-conflict

From 2fe7c421486a1f10e1bae1d7abe08b873d5be098 Mon Sep 17 00:00:00 2001
From: Kadir Can Ozden <101993364+bysiber@users.noreply.github.com>
Date: Tue, 24 Feb 2026 10:01:24 +0300
Subject: [PATCH 2276/2374] Only close file handle in ImagePalette.save() if it
 was opened internally (#9444)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
---
 Tests/test_imagepalette.py | 13 ++++++++++---
 src/PIL/ImagePalette.py    | 27 ++++++++++++++++-----------
 2 files changed, 26 insertions(+), 14 deletions(-)

diff --git a/Tests/test_imagepalette.py b/Tests/test_imagepalette.py
index 10b89a2c0c2..526beb656e8 100644
--- a/Tests/test_imagepalette.py
+++ b/Tests/test_imagepalette.py
@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from io import BytesIO
+import io
 from pathlib import Path
 
 import pytest
@@ -23,6 +23,13 @@ def test_reload() -> None:
         assert_image_equal(im.convert("RGB"), original.convert("RGB"))
 
 
+def test_save_fp() -> None:
+    palette = ImagePalette.ImagePalette()
+    with io.StringIO() as fp:
+        palette.save(fp)
+        assert not fp.closed
+
+
 def test_getcolor() -> None:
     palette = ImagePalette.ImagePalette()
     assert len(palette.palette) == 0
@@ -204,7 +211,7 @@ def test_2bit_palette(tmp_path: Path) -> None:
 
 
 def test_getpalette() -> None:
-    b = BytesIO(b"0 1\n1 2 3 4")
+    b = io.BytesIO(b"0 1\n1 2 3 4")
     p = PaletteFile.PaletteFile(b)
 
     palette, rawmode = p.getpalette()
@@ -216,6 +223,6 @@ def test_invalid_palette() -> None:
     with pytest.raises(OSError):
         ImagePalette.load("Tests/images/hopper.jpg")
 
-    b = BytesIO(b"1" * 101)
+    b = io.BytesIO(b"1" * 101)
     with pytest.raises(SyntaxError, match="bad palette file"):
         PaletteFile.PaletteFile(b)
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index eae7aea8fc3..99ad2771b4b 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -191,19 +191,24 @@ def save(self, fp: str | IO[str]) -> None:
         if self.rawmode:
             msg = "palette contains raw palette data"
             raise ValueError(msg)
+        open_fp = False
         if isinstance(fp, str):
             fp = open(fp, "w")
-        fp.write("# Palette\n")
-        fp.write(f"# Mode: {self.mode}\n")
-        for i in range(256):
-            fp.write(f"{i}")
-            for j in range(i * len(self.mode), (i + 1) * len(self.mode)):
-                try:
-                    fp.write(f" {self.palette[j]}")
-                except IndexError:
-                    fp.write(" 0")
-            fp.write("\n")
-        fp.close()
+            open_fp = True
+        try:
+            fp.write("# Palette\n")
+            fp.write(f"# Mode: {self.mode}\n")
+            for i in range(256):
+                fp.write(f"{i}")
+                for j in range(i * len(self.mode), (i + 1) * len(self.mode)):
+                    try:
+                        fp.write(f" {self.palette[j]}")
+                    except IndexError:
+                        fp.write(" 0")
+                fp.write("\n")
+        finally:
+            if open_fp:
+                fp.close()
 
 
 # --------------------------------------------------------------------

From e96c5a5a5321a7a5541811b41940b89bd1a59f9e Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 24 Feb 2026 21:17:12 +1100
Subject: [PATCH 2277/2374] Updated libpng to 1.6.55 (#9425)

---
 .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 a9b779e818c..0057f62d6b4 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -96,7 +96,7 @@ else
   FREETYPE_VERSION=2.14.1
 fi
 HARFBUZZ_VERSION=12.3.2
-LIBPNG_VERSION=1.6.54
+LIBPNG_VERSION=1.6.55
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.2
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index bd9bd06b6fa..43c58d15fdf 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "LCMS2": "2.18",
     "LIBAVIF": "1.3.0",
     "LIBIMAGEQUANT": "4.4.1",
-    "LIBPNG": "1.6.54",
+    "LIBPNG": "1.6.55",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",

From 26c70950e9a5880dab8b510acf35f9faff5cbfba Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Feb 2026 08:13:18 +1100
Subject: [PATCH 2278/2374] Use walrus operator

---
 src/PIL/MpoImagePlugin.py |  9 ++++-----
 src/PIL/PngImagePlugin.py | 12 ++++--------
 2 files changed, 8 insertions(+), 13 deletions(-)

diff --git a/src/PIL/MpoImagePlugin.py b/src/PIL/MpoImagePlugin.py
index 9360061ba18..bee0a56f9ac 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -59,11 +59,10 @@ def _save_all(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                     + b"MPF\0"
                     + b" " * ifd_length
                 )
-                exif = im_frame.encoderinfo.get("exif")
-                if isinstance(exif, Image.Exif):
-                    exif = exif.tobytes()
-                    im_frame.encoderinfo["exif"] = exif
-                if exif:
+                if exif := im_frame.encoderinfo.get("exif"):
+                    if isinstance(exif, Image.Exif):
+                        exif = exif.tobytes()
+                        im_frame.encoderinfo["exif"] = exif
                     mpf_offset += 4 + len(exif)
 
                 JpegImagePlugin._save(im_frame, fp, filename)
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 9826a4cd148..572762e6c83 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1403,8 +1403,7 @@ def _save(
 
     chunks = [b"cHRM", b"cICP", b"gAMA", b"sBIT", b"sRGB", b"tIME"]
 
-    icc = im.encoderinfo.get("icc_profile", im.info.get("icc_profile"))
-    if icc:
+    if icc := im.encoderinfo.get("icc_profile", im.info.get("icc_profile")):
         # ICC profile
         # according to PNG spec, the iCCP chunk contains:
         # Profile name  1-79 bytes (character string)
@@ -1419,8 +1418,7 @@ def _save(
         # Disallow sRGB chunks when an iCCP-chunk has been emitted.
         chunks.remove(b"sRGB")
 
-    info = im.encoderinfo.get("pnginfo")
-    if info:
+    if info := im.encoderinfo.get("pnginfo"):
         chunks_multiple_allowed = [b"sPLT", b"iTXt", b"tEXt", b"zTXt"]
         for info_chunk in info.chunks:
             cid, data = info_chunk[:2]
@@ -1472,8 +1470,7 @@ def _save(
             alpha_bytes = colors
             chunk(fp, b"tRNS", alpha[:alpha_bytes])
 
-    dpi = im.encoderinfo.get("dpi")
-    if dpi:
+    if dpi := im.encoderinfo.get("dpi"):
         chunk(
             fp,
             b"pHYs",
@@ -1490,8 +1487,7 @@ def _save(
                 chunks.remove(cid)
                 chunk(fp, cid, data)
 
-    exif = im.encoderinfo.get("exif")
-    if exif:
+    if exif := im.encoderinfo.get("exif"):
         if isinstance(exif, Image.Exif):
             exif = exif.tobytes(8)
         if exif.startswith(b"Exif\x00\x00"):

From f273619682634fe6437d0cdb7858c18745ea31bc Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Mon, 2 Mar 2026 15:43:06 +0200
Subject: [PATCH 2279/2374] Test on macos-26-intel

---
 .github/workflows/test.yml   | 2 +-
 .github/workflows/wheels.yml | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 471cab90e3d..80bbfb45f67 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -61,7 +61,7 @@ jobs:
         - { python-version: "3.14t", disable-gil: true }
         - { python-version: "3.13t", disable-gil: true }
         # Intel
-        - { os: "macos-15-intel", python-version: "3.10" }
+        - { os: "macos-26-intel", python-version: "3.10" }
         exclude:
         - { os: "macos-latest", python-version: "3.10" }
 
diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 20379c75370..910c7202b91 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -53,19 +53,19 @@ jobs:
         include:
           - name: "macOS 10.10 x86_64"
             platform: macos
-            os: macos-15-intel
+            os: macos-26-intel
             cibw_arch: x86_64
             build: "cp3{10,11}*"
             macosx_deployment_target: "10.10"
           - name: "macOS 10.13 x86_64"
             platform: macos
-            os: macos-15-intel
+            os: macos-26-intel
             cibw_arch: x86_64
             build: "cp3{12,13}*"
             macosx_deployment_target: "10.13"
           - name: "macOS 10.15 x86_64"
             platform: macos
-            os: macos-15-intel
+            os: macos-26-intel
             cibw_arch: x86_64
             build: "{cp314,pp3}*"
             macosx_deployment_target: "10.15"
@@ -104,7 +104,7 @@ jobs:
             cibw_arch: arm64_iphonesimulator
           - name: "iOS x86_64 simulator"
             platform: ios
-            os: macos-15-intel
+            os: macos-26-intel
             cibw_arch: x86_64_iphonesimulator
     steps:
       - uses: actions/checkout@v6

From 0c2dc2047edcd69a29445b7c91a75dfe0b85f3eb Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 2 Mar 2026 17:25:35 +0000
Subject: [PATCH 2280/2374] [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.14.14 → v0.15.4](https://github.com/astral-sh/ruff-pre-commit/compare/v0.14.14...v0.15.4)
- [github.com/PyCQA/bandit: 1.9.3 → 1.9.4](https://github.com/PyCQA/bandit/compare/1.9.3...1.9.4)
- [github.com/pre-commit/mirrors-clang-format: v21.1.8 → v22.1.0](https://github.com/pre-commit/mirrors-clang-format/compare/v21.1.8...v22.1.0)
- [github.com/python-jsonschema/check-jsonschema: 0.36.1 → 0.37.0](https://github.com/python-jsonschema/check-jsonschema/compare/0.36.1...0.37.0)
- [github.com/tox-dev/pyproject-fmt: v2.12.1 → v2.16.2](https://github.com/tox-dev/pyproject-fmt/compare/v2.12.1...v2.16.2)
- [github.com/abravalheri/validate-pyproject: v0.24.1 → v0.25](https://github.com/abravalheri/validate-pyproject/compare/v0.24.1...v0.25)
---
 .pre-commit-config.yaml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 19be90c1610..53fd0a3ca59 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.14.14
+    rev: v0.15.4
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
@@ -11,7 +11,7 @@ repos:
       - id: black
 
   - repo: https://github.com/PyCQA/bandit
-    rev: 1.9.3
+    rev: 1.9.4
     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: v21.1.8
+    rev: v22.1.0
     hooks:
       - id: clang-format
         types: [c]
@@ -52,7 +52,7 @@ repos:
         exclude: ^\.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.36.1
+    rev: 0.37.0
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
@@ -69,12 +69,12 @@ repos:
       - id: sphinx-lint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: v2.12.1
+    rev: v2.16.2
     hooks:
       - id: pyproject-fmt
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.24.1
+    rev: v0.25
     hooks:
       - id: validate-pyproject
         additional_dependencies: [trove-classifiers>=2024.10.12]

From 7fc49a5cf413833d14c857d5829cd908d09ec7b6 Mon Sep 17 00:00:00 2001
From: "pre-commit-ci[bot]"
 <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Date: Mon, 2 Mar 2026 17:27:42 +0000
Subject: [PATCH 2281/2374] [pre-commit.ci] auto fixes from pre-commit.com
 hooks

for more information, see https://pre-commit.ci
---
 pyproject.toml                | 60 ++++++++---------------
 src/Tk/tkImaging.c            |  6 ++-
 src/encode.c                  |  5 +-
 src/libImaging/Arrow.c        | 90 ++++++++++++++++++-----------------
 src/libImaging/Convert.c      | 14 ++++--
 src/libImaging/Draw.c         | 11 +++--
 src/libImaging/GetBBox.c      | 10 ++--
 src/libImaging/Jpeg2KEncode.c |  6 ++-
 src/libImaging/JpegDecode.c   |  6 ++-
 src/libImaging/Matrix.c       |  5 +-
 10 files changed, 106 insertions(+), 107 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 91f4750e46a..4b969dbc426 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -62,7 +62,6 @@ optional-dependencies.test-arrow = [
   "nanoarrow",
   "pyarrow",
 ]
-
 optional-dependencies.tests = [
   "check-manifest",
   "coverage>=7.4.2",
@@ -77,16 +76,15 @@ optional-dependencies.tests = [
   "pytest-xdist",
   "trove-classifiers>=2024.10.12",
 ]
-
 optional-dependencies.xmp = [
   "defusedxml",
 ]
+urls."Release notes" = "https://pillow.readthedocs.io/en/stable/releasenotes/index.html"
 urls.Changelog = "https://github.com/python-pillow/Pillow/releases"
 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.github.io"
 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]
@@ -95,70 +93,50 @@ packages = [
 ]
 include-package-data = true
 package-dir = { "" = "src" }
-
-[tool.setuptools.dynamic]
-version = { attr = "PIL.__version__" }
+dynamic.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"
-
 test-command = "cd {project} && .github/workflows/wheels-test.sh"
 test-extras = "tests"
 test-requires = [
   "numpy",
 ]
-xbuild-tools = [  ]
-
-[tool.cibuildwheel.ios]
+xbuild-tools = []
 # Disable platform guessing on iOS, and disable raqm (since there won't be a
 # vendor version, and we can't distribute it due to licensing)
-config-settings = "raqm=disable imagequant=disable platform-guessing=disable"
-
+ios.config-settings = "raqm=disable imagequant=disable platform-guessing=disable"
 # iOS needs to be given a specific pytest invocation and list of test sources.
-test-sources = [
+ios.test-sources = [
   "checks",
   "Tests",
   "selftest.py",
 ]
-test-command = [
+ios.test-command = [
   "python -m selftest",
   "python -m pytest -vv -x -W always checks/check_wheel.py Tests",
 ]
-
 # There's no numpy wheel for iOS (yet...)
-test-requires = [  ]
-
-[tool.cibuildwheel.macos]
+ios.test-requires = []
 # Disable platform guessing on macOS to avoid picking up Homebrew etc.
-config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable platform-guessing=disable"
-
-[tool.cibuildwheel.macos.environment]
+macos.config-settings = "raqm=enable raqm=vendor fribidi=vendor imagequant=disable platform-guessing=disable"
 # Isolate macOS build environment from Homebrew etc.
-PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
-
-[[tool.cibuildwheel.overrides]]
-# iOS environment is isolated by cibuildwheel, but needs the dependencies
-select = "*_iphoneos"
-environment.PATH = "$(pwd)/build/deps/iphoneos/bin:$PATH"
-
-[[tool.cibuildwheel.overrides]]
-# iOS simulator environment is isolated by cibuildwheel, but needs the dependencies
-select = "*_iphonesimulator"
-environment.PATH = "$(pwd)/build/deps/iphonesimulator/bin:$PATH"
-
-[[tool.cibuildwheel.overrides]]
-select = "*-win32"
-test-requires = [  ]
+macos.environment.PATH = "$(pwd)/build/deps/darwin/bin:$(dirname $(which python3)):/usr/bin:/bin:/usr/sbin:/sbin:/Library/Apple/usr/bin"
+overrides = [
+  # iOS environment is isolated by cibuildwheel, but needs the dependencies
+  { select = "*_iphoneos", environment.PATH = "$(pwd)/build/deps/iphoneos/bin:$PATH" },
+  # iOS simulator environment is isolated by cibuildwheel, but needs the dependencies
+  { select = "*_iphonesimulator", environment.PATH = "$(pwd)/build/deps/iphonesimulator/bin:$PATH" },
+  { select = "*-win32", test-requires = [] },
+]
 
 [tool.black]
 exclude = "wheels/multibuild"
 
 [tool.ruff]
 exclude = [ "wheels/multibuild" ]
-
 fix = true
 lint.select = [
   "C4",     # flake8-comprehensions
@@ -207,9 +185,9 @@ lint.isort.required-imports = [
 [tool.pyproject-fmt]
 max_supported_python = "3.14"
 
-[tool.pytest.ini_options]
-addopts = "-ra --color=auto"
-testpaths = [
+[tool.pytest]
+ini_options.addopts = "-ra --color=auto"
+ini_options.testpaths = [
   "Tests",
 ]
 
diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index 834634bd7fa..3e35f885f61 100644
--- a/src/Tk/tkImaging.c
+++ b/src/Tk/tkImaging.c
@@ -124,8 +124,10 @@ PyImagingPhotoPut(
     if (im->mode == IMAGING_MODE_1 || im->mode == IMAGING_MODE_L) {
         block.pixelSize = 1;
         block.offset[0] = block.offset[1] = block.offset[2] = block.offset[3] = 0;
-    } else if (im->mode == IMAGING_MODE_RGB || im->mode == IMAGING_MODE_RGBA ||
-               im->mode == IMAGING_MODE_RGBX || im->mode == IMAGING_MODE_RGBa) {
+    } else if (
+        im->mode == IMAGING_MODE_RGB || im->mode == IMAGING_MODE_RGBA ||
+        im->mode == IMAGING_MODE_RGBX || im->mode == IMAGING_MODE_RGBa
+    ) {
         block.pixelSize = 4;
         block.offset[0] = 0;
         block.offset[1] = 1;
diff --git a/src/encode.c b/src/encode.c
index 06e4a089380..ea57615bec8 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -999,8 +999,9 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, PyBytes_AsString(value)
                 );
-            } else if (type == TIFF_DOUBLE || type == TIFF_SRATIONAL ||
-                       type == TIFF_RATIONAL) {
+            } else if (
+                type == TIFF_DOUBLE || type == TIFF_SRATIONAL || type == TIFF_RATIONAL
+            ) {
                 status = ImagingLibTiffSetField(
                     &encoder->state, (ttag_t)key_int, (FLOAT64)PyFloat_AsDouble(value)
                 );
diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index d2ed10f0a6e..de4d3568eda 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -170,16 +170,17 @@ export_named_type(struct ArrowSchema *schema, char *format, const char *name) {
     strncpy(formatp, format, format_len);
     strncpy(namep, name, name_len);
 
-    *schema = (struct ArrowSchema){// Type description
-                                   .format = formatp,
-                                   .name = namep,
-                                   .metadata = NULL,
-                                   .flags = 0,
-                                   .n_children = 0,
-                                   .children = NULL,
-                                   .dictionary = NULL,
-                                   // Bookkeeping
-                                   .release = &ReleaseExportedSchema
+    *schema = (struct ArrowSchema){
+        // Type description
+        .format = formatp,
+        .name = namep,
+        .metadata = NULL,
+        .flags = 0,
+        .n_children = 0,
+        .children = NULL,
+        .dictionary = NULL,
+        // Bookkeeping
+        .release = &ReleaseExportedSchema
     };
     return 0;
 }
@@ -287,17 +288,18 @@ export_single_channel_array(Imaging im, struct ArrowArray *array) {
     im->refcount++;
     MUTEX_UNLOCK(&im->mutex);
     // Initialize primitive fields
-    *array = (struct ArrowArray){// Data description
-                                 .length = length,
-                                 .offset = 0,
-                                 .null_count = 0,
-                                 .n_buffers = 2,
-                                 .n_children = 0,
-                                 .children = NULL,
-                                 .dictionary = NULL,
-                                 // Bookkeeping
-                                 .release = &release_const_array,
-                                 .private_data = im
+    *array = (struct ArrowArray){
+        // Data description
+        .length = length,
+        .offset = 0,
+        .null_count = 0,
+        .n_buffers = 2,
+        .n_children = 0,
+        .children = NULL,
+        .dictionary = NULL,
+        // Bookkeeping
+        .release = &release_const_array,
+        .private_data = im
     };
 
     // Allocate list of buffers
@@ -332,17 +334,18 @@ export_fixed_pixel_array(Imaging im, struct ArrowArray *array) {
     // Initialize primitive fields
     // Fixed length arrays are 1 buffer of validity, and the length in pixels.
     // Data is in a child array.
-    *array = (struct ArrowArray){// Data description
-                                 .length = length,
-                                 .offset = 0,
-                                 .null_count = 0,
-                                 .n_buffers = 1,
-                                 .n_children = 1,
-                                 .children = NULL,
-                                 .dictionary = NULL,
-                                 // Bookkeeping
-                                 .release = &release_const_array,
-                                 .private_data = im
+    *array = (struct ArrowArray){
+        // Data description
+        .length = length,
+        .offset = 0,
+        .null_count = 0,
+        .n_buffers = 1,
+        .n_children = 1,
+        .children = NULL,
+        .dictionary = NULL,
+        // Bookkeeping
+        .release = &release_const_array,
+        .private_data = im
     };
 
     // Allocate list of buffers
@@ -367,17 +370,18 @@ export_fixed_pixel_array(Imaging im, struct ArrowArray *array) {
     MUTEX_LOCK(&im->mutex);
     im->refcount++;
     MUTEX_UNLOCK(&im->mutex);
-    *array->children[0] = (struct ArrowArray){// Data description
-                                              .length = length * 4,
-                                              .offset = 0,
-                                              .null_count = 0,
-                                              .n_buffers = 2,
-                                              .n_children = 0,
-                                              .children = NULL,
-                                              .dictionary = NULL,
-                                              // Bookkeeping
-                                              .release = &release_const_array,
-                                              .private_data = im
+    *array->children[0] = (struct ArrowArray){
+        // Data description
+        .length = length * 4,
+        .offset = 0,
+        .null_count = 0,
+        .n_buffers = 2,
+        .n_children = 0,
+        .children = NULL,
+        .dictionary = NULL,
+        // Bookkeeping
+        .release = &release_const_array,
+        .private_data = im
     };
 
     array->children[0]->buffers =
diff --git a/src/libImaging/Convert.c b/src/libImaging/Convert.c
index 330e5325c33..002497c3264 100644
--- a/src/libImaging/Convert.c
+++ b/src/libImaging/Convert.c
@@ -1695,16 +1695,20 @@ ImagingConvertTransparent(Imaging imIn, const ModeID mode, int r, int g, int b)
         if (mode == IMAGING_MODE_RGBa) {
             premultiplied = 1;
         }
-    } else if (imIn->mode == IMAGING_MODE_RGB &&
-               (mode == IMAGING_MODE_LA || mode == IMAGING_MODE_La)) {
+    } else if (
+        imIn->mode == IMAGING_MODE_RGB &&
+        (mode == IMAGING_MODE_LA || mode == IMAGING_MODE_La)
+    ) {
         convert = rgb2la;
         source_transparency = 1;
         if (mode == IMAGING_MODE_La) {
             premultiplied = 1;
         }
-    } else if ((imIn->mode == IMAGING_MODE_1 || imIn->mode == IMAGING_MODE_I ||
-                imIn->mode == IMAGING_MODE_I_16 || imIn->mode == IMAGING_MODE_L) &&
-               (mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_LA)) {
+    } else if (
+        (imIn->mode == IMAGING_MODE_1 || imIn->mode == IMAGING_MODE_I ||
+         imIn->mode == IMAGING_MODE_I_16 || imIn->mode == IMAGING_MODE_L) &&
+        (mode == IMAGING_MODE_RGBA || mode == IMAGING_MODE_LA)
+    ) {
         if (imIn->mode == IMAGING_MODE_1) {
             convert = bit2rgb;
         } else if (imIn->mode == IMAGING_MODE_I) {
diff --git a/src/libImaging/Draw.c b/src/libImaging/Draw.c
index d2898043256..0d28069f000 100644
--- a/src/libImaging/Draw.c
+++ b/src/libImaging/Draw.c
@@ -537,8 +537,9 @@ polygon_generic(
                     // Needed to draw consistent polygons
                     xx[j] = xx[j - 1];
                     j++;
-                } else if ((ymin == current->ymin || ymin == current->ymax) &&
-                           current->dx != 0) {
+                } else if (
+                    (ymin == current->ymin || ymin == current->ymax) && current->dx != 0
+                ) {
                     // Connect discontiguous corners
                     for (k = 0; k < i; k++) {
                         Edge *other_edge = edge_table[k];
@@ -570,8 +571,10 @@ polygon_generic(
                                             adjacent_line_x, adjacent_line_x_other_edge
                                         )) +
                                         1;
-                                } else if (xx[j - 1] < adjacent_line_x - 1 &&
-                                           xx[j - 1] < adjacent_line_x_other_edge - 1) {
+                                } else if (
+                                    xx[j - 1] < adjacent_line_x - 1 &&
+                                    xx[j - 1] < adjacent_line_x_other_edge - 1
+                                ) {
                                     xx[j - 1] =
                                         roundf(fmin(
                                             adjacent_line_x, adjacent_line_x_other_edge
diff --git a/src/libImaging/GetBBox.c b/src/libImaging/GetBBox.c
index d336121d5cc..7a57f6894a0 100644
--- a/src/libImaging/GetBBox.c
+++ b/src/libImaging/GetBBox.c
@@ -89,10 +89,12 @@ ImagingGetBBox(Imaging im, int bbox[4], int alpha_only) {
         INT32 mask = 0xffffffff;
         if (im->bands == 3) {
             ((UINT8 *)&mask)[3] = 0;
-        } else if (alpha_only &&
-                   (im->mode == IMAGING_MODE_RGBa || im->mode == IMAGING_MODE_RGBA ||
-                    im->mode == IMAGING_MODE_La || im->mode == IMAGING_MODE_LA ||
-                    im->mode == IMAGING_MODE_PA)) {
+        } else if (
+            alpha_only &&
+            (im->mode == IMAGING_MODE_RGBa || im->mode == IMAGING_MODE_RGBA ||
+             im->mode == IMAGING_MODE_La || im->mode == IMAGING_MODE_LA ||
+             im->mode == IMAGING_MODE_PA)
+        ) {
 #ifdef WORDS_BIGENDIAN
             mask = 0x000000ff;
 #else
diff --git a/src/libImaging/Jpeg2KEncode.c b/src/libImaging/Jpeg2KEncode.c
index fdfbde2d76b..3012783a2e4 100644
--- a/src/libImaging/Jpeg2KEncode.c
+++ b/src/libImaging/Jpeg2KEncode.c
@@ -330,8 +330,10 @@ j2k_encode_entry(Imaging im, ImagingCodecState state) {
         components = 4;
         color_space = OPJ_CLRSPC_SRGB;
         pack = j2k_pack_rgba;
-#if ((OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR == 5 && OPJ_VERSION_BUILD >= 3) || \
-     (OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR > 5) || OPJ_VERSION_MAJOR > 2)
+#if (                                                                               \
+    (OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR == 5 && OPJ_VERSION_BUILD >= 3) || \
+    (OPJ_VERSION_MAJOR == 2 && OPJ_VERSION_MINOR > 5) || OPJ_VERSION_MAJOR > 2      \
+)
     } else if (im->mode == IMAGING_MODE_CMYK) {
         components = 4;
         color_space = OPJ_CLRSPC_CMYK;
diff --git a/src/libImaging/JpegDecode.c b/src/libImaging/JpegDecode.c
index ae3274456d3..05cb37554b3 100644
--- a/src/libImaging/JpegDecode.c
+++ b/src/libImaging/JpegDecode.c
@@ -206,8 +206,10 @@ ImagingJpegDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t by
                 context->cinfo.out_color_space = JCS_EXT_RGBX;
             }
 #endif
-            else if (context->rawmode == IMAGING_RAWMODE_CMYK ||
-                     context->rawmode == IMAGING_RAWMODE_CMYK_I) {
+            else if (
+                context->rawmode == IMAGING_RAWMODE_CMYK ||
+                context->rawmode == IMAGING_RAWMODE_CMYK_I
+            ) {
                 context->cinfo.out_color_space = JCS_CMYK;
             } else if (context->rawmode == IMAGING_RAWMODE_YCbCr) {
                 context->cinfo.out_color_space = JCS_YCbCr;
diff --git a/src/libImaging/Matrix.c b/src/libImaging/Matrix.c
index d28e04edfaa..acd59ba7f39 100644
--- a/src/libImaging/Matrix.c
+++ b/src/libImaging/Matrix.c
@@ -46,8 +46,9 @@ ImagingConvertMatrix(Imaging im, const ModeID mode, float m[]) {
             }
         }
         ImagingSectionLeave(&cookie);
-    } else if (mode == IMAGING_MODE_HSV || mode == IMAGING_MODE_LAB ||
-               mode == IMAGING_MODE_RGB) {
+    } else if (
+        mode == IMAGING_MODE_HSV || mode == IMAGING_MODE_LAB || mode == IMAGING_MODE_RGB
+    ) {
         imOut = ImagingNewDirty(mode, im->xsize, im->ysize);
         if (!imOut) {
             return NULL;

From 0fae74731d4b15f8496c263879d6de3895f9e7e1 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Tue, 3 Mar 2026 16:36:24 +1100
Subject: [PATCH 2282/2374] Update actions/download-artifact action to v8
 (#9451)

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

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 20379c75370..a697ff47760 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -250,7 +250,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Count dists
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v8
         with:
           pattern: dist-*
           path: dist
@@ -269,7 +269,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v8
         with:
           pattern: dist-!(sdist)*
           path: dist
@@ -291,7 +291,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v8
         with:
           pattern: dist-*
           path: dist

From a8cf13010b7c76203b26dcd5c7534363a351b5ed Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 3 Mar 2026 18:02:49 +1100
Subject: [PATCH 2283/2374] Use native configuration

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

diff --git a/pyproject.toml b/pyproject.toml
index 4b969dbc426..6d9910ca140 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -186,8 +186,8 @@ lint.isort.required-imports = [
 max_supported_python = "3.14"
 
 [tool.pytest]
-ini_options.addopts = "-ra --color=auto"
-ini_options.testpaths = [
+addopts = [ "-ra", "--color=auto" ]
+testpaths = [
   "Tests",
 ]
 

From 04470d5151069736f136210d3170bdab402baa47 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 3 Mar 2026 22:51:41 +1100
Subject: [PATCH 2284/2374] Removed unused argument

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

diff --git a/Tests/test_font_pcf.py b/Tests/test_font_pcf.py
index 8ac63ea61ae..321dd85603a 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -75,7 +75,7 @@ def test_draw(request: pytest.FixtureRequest, tmp_path: Path) -> None:
     assert_image_equal_tofile(im, "Tests/images/test_draw_pbm_target.png")
 
 
-def test_to_imagefont(tmp_path: Path) -> None:
+def test_to_imagefont() -> None:
     with open(fontname, "rb") as test_file:
         pcffont = PcfFontFile.PcfFontFile(test_file)
     imagefont = pcffont.to_imagefont()

From f7ee26575ec7915c5d5d6b4b76bf1b3186383e1f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 3 Mar 2026 22:57:34 +1100
Subject: [PATCH 2285/2374] Avoid shadowing built-in

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

diff --git a/src/PIL/FontFile.py b/src/PIL/FontFile.py
index c0c64fe6842..9e12a8bfede 100644
--- a/src/PIL/FontFile.py
+++ b/src/PIL/FontFile.py
@@ -112,8 +112,8 @@ def compile(self) -> None:
 
     def _encode_metrics(self) -> bytes:
         values: tuple[int, ...] = ()
-        for id in range(256):
-            m = self.metrics[id]
+        for i in range(256):
+            m = self.metrics[i]
             if m:
                 values += m[0] + m[1] + m[2]
             else:

From f7582b8d5828a52a4276c22dc05ab8a4823d1748 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 3 Mar 2026 23:04:00 +1100
Subject: [PATCH 2286/2374] Updated documentation terms

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

diff --git a/docs/reference/ImageFont.rst b/docs/reference/ImageFont.rst
index d4d66988b0c..920a05e65e9 100644
--- a/docs/reference/ImageFont.rst
+++ b/docs/reference/ImageFont.rst
@@ -8,9 +8,9 @@ The :py:mod:`~PIL.ImageFont` module defines a class with the same name. Instance
 this class store bitmap fonts, and are used with the
 :py:meth:`PIL.ImageDraw.ImageDraw.text` method.
 
-PIL uses its own font file format to store bitmap fonts, limited to 256 characters. You
+Pillow uses its own font file format to store bitmap fonts, limited to 256 characters. You
 can use :py:meth:`~PIL.FontFile.FontFile.to_imagefont` to convert BDF and PCF font
-descriptors (X window font formats) to this format::
+descriptors (X Window font formats) to this format::
 
     from PIL import PcfFontFile
     with open("Tests/fonts/10x20-ISO8859-1.pcf", "rb") as fp:

From 55b0cbc27364b8b0ea01d7532ab509bdc6e65d32 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 5 Mar 2026 10:01:13 +0200
Subject: [PATCH 2287/2374] Update CI targets docs

---
 docs/installation/platform-support.rst | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/installation/platform-support.rst b/docs/installation/platform-support.rst
index 7a8707b9a30..74c63fb062f 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -39,15 +39,15 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Gentoo                           | 3.12                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| macOS 15 Sequoia                 | 3.10                       | x86-64              |
-|                                  +----------------------------+---------------------+
-|                                  | 3.11, 3.12, 3.13, 3.14,    | arm64               |
-|                                  | PyPy3                      |                     |
+| macOS 15 Sequoia                 | 3.11, 3.12, 3.13, 3.14,    | arm64               |
+|                                  | 3.15, PyPy3                |                     |
++----------------------------------+----------------------------+---------------------+
+| macOS 26 Tahoe                   | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 22.04 LTS (Jammy)   | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | Ubuntu Linux 24.04 LTS (Noble)   | 3.10, 3.11, 3.12, 3.13,    | x86-64              |
-|                                  | 3.14, PyPy3                |                     |
+|                                  | 3.14, 3.15, PyPy3          |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.12                       | arm64v8, ppc64le,   |
 |                                  |                            | s390x               |
@@ -55,7 +55,7 @@ These platforms are built and tested for every change.
 | Windows Server 2022              | 3.10                       | x86                 |
 +----------------------------------+----------------------------+---------------------+
 | Windows Server 2025              | 3.11, 3.12, 3.13, 3.14,    | x86-64              |
-|                                  | PyPy3                      |                     |
+|                                  | 3.15, PyPy3                |                     |
 |                                  +----------------------------+---------------------+
 |                                  | 3.13 (MinGW)               | x86-64              |
 +----------------------------------+----------------------------+---------------------+

From abbd515e9bf0f96c1f220d98742b581ce4a7d8d6 Mon Sep 17 00:00:00 2001
From: Frank Henigman <fjhenigman@gmail.com>
Date: Fri, 6 Mar 2026 22:20:21 -0500
Subject: [PATCH 2288/2374] Improve efficiency of FontFile._encode_metrics()

Build up mutable sequences instead of recreating mutable ones.
---
 src/PIL/FontFile.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/PIL/FontFile.py b/src/PIL/FontFile.py
index 9e12a8bfede..341431d3f45 100644
--- a/src/PIL/FontFile.py
+++ b/src/PIL/FontFile.py
@@ -111,20 +111,20 @@ def compile(self) -> None:
                 self.metrics[i] = d, dst, s
 
     def _encode_metrics(self) -> bytes:
-        values: tuple[int, ...] = ()
+        values: list[int] = []
         for i in range(256):
             m = self.metrics[i]
             if m:
-                values += m[0] + m[1] + m[2]
+                values.extend(m[0] + m[1] + m[2])
             else:
-                values += (0,) * 10
+                values.extend((0,) * 10)
 
-        metrics = b""
+        data = bytearray()
         for v in values:
             if v < 0:
                 v += 65536
-            metrics += _binary.o16be(v)
-        return metrics
+            data += _binary.o16be(v)
+        return bytes(data)
 
     def save(self, filename: str) -> None:
         """Save font"""

From 5450f9d08a70bf770e20ba6b416f76d77d1e2146 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 8 Mar 2026 07:12:10 +1100
Subject: [PATCH 2289/2374] Updated harfbuzz to 13.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 0057f62d6b4..211d08fdd8b 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -95,7 +95,7 @@ if [[ -n "$IOS_SDK" ]]; then
 else
   FREETYPE_VERSION=2.14.1
 fi
-HARFBUZZ_VERSION=12.3.2
+HARFBUZZ_VERSION=13.0.1
 LIBPNG_VERSION=1.6.55
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 43c58d15fdf..9e00772de14 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.2.0",
     "FREETYPE": "2.14.1",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "12.3.2",
+    "HARFBUZZ": "13.0.1",
     "JPEGTURBO": "3.1.3",
     "LCMS2": "2.18",
     "LIBAVIF": "1.3.0",

From 28524f2069582750cdc9e295cf46b22a2ce8be56 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 9 Mar 2026 22:39:27 +1100
Subject: [PATCH 2290/2374] Update freetype to 2.14.2 (#9449)

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

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index 0057f62d6b4..bbc52352c18 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -90,11 +90,7 @@ fi
 ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds.
-if [[ -n "$IOS_SDK" ]]; then
-  FREETYPE_VERSION=2.13.3
-else
-  FREETYPE_VERSION=2.14.1
-fi
+FREETYPE_VERSION=2.14.2
 HARFBUZZ_VERSION=12.3.2
 LIBPNG_VERSION=1.6.55
 JPEGTURBO_VERSION=3.1.3
@@ -310,10 +306,6 @@ function build {
 
     if [[ -n "$IS_MACOS" ]]; then
         # Custom freetype build
-        if [[ -z "$IOS_SDK" ]]; then
-          build_simple sed 4.9 https://mirrors.middlendian.com/gnu/sed
-        fi
-
         build_simple freetype $FREETYPE_VERSION https://download.savannah.gnu.org/releases/freetype tar.gz --with-harfbuzz=no
     else
         build_freetype
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 43c58d15fdf..34f3065484c 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -114,7 +114,7 @@ def cmd_msbuild(
 
 V = {
     "BROTLI": "1.2.0",
-    "FREETYPE": "2.14.1",
+    "FREETYPE": "2.14.2",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "12.3.2",
     "JPEGTURBO": "3.1.3",

From de2845b19a8c2d475a68df77b137119de95975c0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 5 Mar 2026 10:59:57 +1100
Subject: [PATCH 2291/2374] Revert "Patch libavif for svt-av1 4.0
 compatibility"

This reverts commit f86ad8b36d75417f872723eba1c3a2ffc19c9c70.
---
 depends/install_libavif.sh |  4 ----
 depends/libavif-svt4.patch | 14 --------------
 2 files changed, 18 deletions(-)
 delete mode 100644 depends/libavif-svt4.patch

diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
index 0089bf2b5fd..2ee47903580 100755
--- a/depends/install_libavif.sh
+++ b/depends/install_libavif.sh
@@ -17,10 +17,6 @@ else
 
     pushd libavif-$version
 
-    # Apply patch for SVT-AV1 4.0 compatibility
-    # Pending release of https://github.com/AOMediaCodec/libavif/pull/2971
-    patch -p1 < ../libavif-svt4.patch
-
     if [ $(uname) == "Darwin" ] && [ -x "$(command -v brew)" ]; then
         PREFIX=$(brew --prefix)
     else
diff --git a/depends/libavif-svt4.patch b/depends/libavif-svt4.patch
deleted file mode 100644
index 7abfc529970..00000000000
--- a/depends/libavif-svt4.patch
+++ /dev/null
@@ -1,14 +0,0 @@
---- a/src/codec_svt.c
-+++ b/src/codec_svt.c
-@@ -162,7 +162,11 @@ static avifResult svtCodecEncodeImage(avifEncoder * encoder,
- #else
-         svt_config->logical_processors = encoder->maxThreads;
- #endif
-+#if SVT_AV1_CHECK_VERSION(4, 0, 0)
-+        svt_config->aq_mode = 2;
-+#else
-         svt_config->enable_adaptive_quantization = 2;
-+#endif
-         // disable 2-pass
- #if SVT_AV1_CHECK_VERSION(0, 9, 0)
-         svt_config->rc_stats_buffer = (SvtAv1FixedBuf) { NULL, 0 };

From 686174b5cc34fc8a13d1e1d38bc32302b13ebd08 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 10 Mar 2026 20:26:31 +1100
Subject: [PATCH 2292/2374] Updated libavif to 1.4.0

---
 .github/workflows/wheels-dependencies.sh |  2 +-
 Tests/test_file_avif.py                  | 13 +++++--------
 depends/install_libavif.sh               |  2 +-
 winbuild/build_prepare.py                |  2 +-
 4 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/wheels-dependencies.sh b/.github/workflows/wheels-dependencies.sh
index bbc52352c18..32492d20ff7 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -104,7 +104,7 @@ LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.2.0
-LIBAVIF_VERSION=1.3.0
+LIBAVIF_VERSION=1.4.0
 
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
diff --git a/Tests/test_file_avif.py b/Tests/test_file_avif.py
index ffc4ce0210d..a25f7717797 100644
--- a/Tests/test_file_avif.py
+++ b/Tests/test_file_avif.py
@@ -145,14 +145,14 @@ def test_write_rgb(self, tmp_path: Path) -> None:
 
             # avifdec hopper.avif avif/hopper_avif_write.png
             assert_image_similar_tofile(
-                reloaded, "Tests/images/avif/hopper_avif_write.png", 6.02
+                reloaded, "Tests/images/avif/hopper_avif_write.png", 6.88
             )
 
             # This test asserts that the images are similar. If the average pixel
             # difference between the two images is less than the epsilon value,
             # then we're going to accept that it's a reasonable lossy version of
             # the image.
-            assert_image_similar(reloaded, im, 8.62)
+            assert_image_similar(reloaded, im, 9.28)
 
     def test_AvifEncoder_with_invalid_args(self) -> None:
         """
@@ -461,12 +461,9 @@ def test_decoder_codec_cannot_encode(self, tmp_path: Path) -> None:
     @pytest.mark.parametrize(
         "advanced",
         [
-            {
-                "aq-mode": "1",
-                "enable-chroma-deltaq": "1",
-            },
-            (("aq-mode", "1"), ("enable-chroma-deltaq", "1")),
-            [("aq-mode", "1"), ("enable-chroma-deltaq", "1")],
+            {"tune": "psnr"},
+            (("tune", "psnr"),),
+            [("tune", "psnr")],
         ],
     )
     def test_encoder_advanced_codec_options(
diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
index 2ee47903580..5c5c6f3f7c2 100755
--- a/depends/install_libavif.sh
+++ b/depends/install_libavif.sh
@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -eo pipefail
 
-version=1.3.0
+version=1.4.0
 
 if [[ "$GHA_LIBAVIF_CACHE_HIT" == "true" ]]; then
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 34f3065484c..f240cb02ad8 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -119,7 +119,7 @@ def cmd_msbuild(
     "HARFBUZZ": "12.3.2",
     "JPEGTURBO": "3.1.3",
     "LCMS2": "2.18",
-    "LIBAVIF": "1.3.0",
+    "LIBAVIF": "1.4.0",
     "LIBIMAGEQUANT": "4.4.1",
     "LIBPNG": "1.6.55",
     "LIBWEBP": "1.6.0",

From dd042da9c2bc7aff503a8894def9e9f7681f3dc5 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 13 Mar 2026 06:32:15 +1100
Subject: [PATCH 2293/2374] Update tests to change for ValueError when encoding
 an empty image

---
 Tests/test_file_gif.py    | 2 +-
 Tests/test_file_spider.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index b52816fdc1a..7b504233d56 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -314,7 +314,7 @@ def test_roundtrip_save_all_1(tmp_path: Path) -> None:
 def test_save_zero(size: tuple[int, int]) -> None:
     b = BytesIO()
     im = Image.new("RGB", size)
-    with pytest.raises(SystemError):
+    with pytest.raises(ValueError, match="cannot write empty image"):
         im.save(b, "GIF")
 
 
diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index 903632cffb0..3b1953aac5d 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -72,7 +72,7 @@ def test_save(tmp_path: Path) -> None:
 def test_save_zero(size: tuple[int, int]) -> None:
     b = BytesIO()
     im = Image.new("1", size)
-    with pytest.raises(SystemError):
+    with pytest.raises(ValueError, match="cannot write empty image"):
         im.save(b, "SPIDER")
 
 

From 3a44ba1c75d72e7f375be9c6b7c71e2aef5e35e7 Mon Sep 17 00:00:00 2001
From: Gareth Davidson <gaz@bitplane.net>
Date: Fri, 13 Mar 2026 22:42:15 +0000
Subject: [PATCH 2294/2374] Add Amiga Workbench .info loader to 3rd party
 plugins list (#9459)

---
 docs/handbook/third-party-plugins.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst
index 1c7dfb5e95b..20086649906 100644
--- a/docs/handbook/third-party-plugins.rst
+++ b/docs/handbook/third-party-plugins.rst
@@ -7,6 +7,7 @@ itself.
 
 Here is a list of PyPI projects that offer additional plugins:
 
+* :pypi:`amigainfo`: Adds support for Amiga Workbench .info icon files.
 * :pypi:`DjvuRleImagePlugin`: Plugin for the DjVu RLE image format as defined in the DjVuLibre docs.
 * :pypi:`heif-image-plugin`: Simple HEIF/HEIC images plugin, based on the pyheif library.
 * :pypi:`jxlpy`: Introduces reading and writing support for JPEG XL.

From d5d0734169ac4c593caac4f5769e60a01574fa09 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Mar 2026 20:48:25 +1100
Subject: [PATCH 2295/2374] Add CMYK palettes

---
 Tests/test_image_putpalette.py | 15 +++++++++++++++
 src/PIL/Image.py               | 11 ++++++++---
 src/libImaging/Pack.c          | 14 ++++++++++++++
 src/libImaging/Palette.c       |  3 ++-
 4 files changed, 39 insertions(+), 4 deletions(-)

diff --git a/Tests/test_image_putpalette.py b/Tests/test_image_putpalette.py
index 661764b608a..237de63305a 100644
--- a/Tests/test_image_putpalette.py
+++ b/Tests/test_image_putpalette.py
@@ -91,6 +91,21 @@ def test_rgba_palette(mode: str, palette: tuple[int, ...]) -> None:
     assert im.palette.colors == {(1, 2, 3, 4): 0}
 
 
+@pytest.mark.parametrize(
+    "mode, palette",
+    (
+        ("CMYK", (1, 2, 3, 4)),
+        ("CMYKX", (1, 2, 3, 4, 0)),
+    ),
+)
+def test_cmyk_palette(mode: str, palette: tuple[int, ...]) -> None:
+    im = Image.new("P", (1, 1))
+    im.putpalette(palette, mode)
+    assert im.getpalette() == [250, 249, 248]
+    assert im.palette is not None
+    assert im.palette.colors == {(1, 2, 3, 4): 0}
+
+
 def test_empty_palette() -> None:
     im = Image.new("P", (1, 1))
     assert im.getpalette() == []
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index cc431a86a5d..c9db9731996 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2145,8 +2145,8 @@ def putpalette(
         Alternatively, an 8-bit string may be used instead of an integer sequence.
 
         :param data: A palette sequence (either a list or a string).
-        :param rawmode: The raw mode of the palette. Either "RGB", "RGBA", or a mode
-           that can be transformed to "RGB" or "RGBA" (e.g. "R", "BGR;15", "RGBA;L").
+        :param rawmode: The raw mode of the palette. Either "RGB", "RGBA", "CMYK", or a
+           mode that can be transformed to one of those modes (e.g. "R", "RGBA;L").
         """
         from . import ImagePalette
 
@@ -2165,7 +2165,12 @@ def putpalette(
             palette = ImagePalette.raw(rawmode, data)
         self._mode = "PA" if "A" in self.mode else "P"
         self.palette = palette
-        self.palette.mode = "RGBA" if "A" in rawmode else "RGB"
+        if rawmode.startswith("CMYK"):
+            self.palette.mode = "CMYK"
+        elif "A" in rawmode:
+            self.palette.mode = "RGBA"
+        else:
+            self.palette.mode = "RGB"
         self.load()  # install new palette
 
     def putpixel(
diff --git a/src/libImaging/Pack.c b/src/libImaging/Pack.c
index fdf5a72aa9e..161d82f2e5f 100644
--- a/src/libImaging/Pack.c
+++ b/src/libImaging/Pack.c
@@ -325,6 +325,19 @@ ImagingPackXBGR(UINT8 *out, const UINT8 *in, int pixels) {
     }
 }
 
+void
+ImagingPackCMYK2RGB(UINT8 *out, const UINT8 *in, int xsize) {
+    int x, nk, tmp;
+    for (x = 0; x < xsize; x++) {
+        nk = 255 - in[3];
+        out[0] = CLIP8(nk - MULDIV255(in[0], nk, tmp));
+        out[1] = CLIP8(nk - MULDIV255(in[1], nk, tmp));
+        out[2] = CLIP8(nk - MULDIV255(in[2], nk, tmp));
+        out += 3;
+        in += 4;
+    }
+}
+
 void
 ImagingPackBGRA(UINT8 *out, const UINT8 *in, int pixels) {
     int i;
@@ -605,6 +618,7 @@ static struct {
     {IMAGING_MODE_CMYK, IMAGING_RAWMODE_M, 8, band1},
     {IMAGING_MODE_CMYK, IMAGING_RAWMODE_Y, 8, band2},
     {IMAGING_MODE_CMYK, IMAGING_RAWMODE_K, 8, band3},
+    {IMAGING_MODE_CMYK, IMAGING_RAWMODE_RGB, 24, ImagingPackCMYK2RGB},
 
     /* video (YCbCr) */
     {IMAGING_MODE_YCbCr, IMAGING_RAWMODE_YCbCr, 24, ImagingPackRGB},
diff --git a/src/libImaging/Palette.c b/src/libImaging/Palette.c
index 371ba644b50..b2dacf656b5 100644
--- a/src/libImaging/Palette.c
+++ b/src/libImaging/Palette.c
@@ -27,7 +27,8 @@ ImagingPaletteNew(const ModeID mode) {
     int i;
     ImagingPalette palette;
 
-    if (mode != IMAGING_MODE_RGB && mode != IMAGING_MODE_RGBA) {
+    if (mode != IMAGING_MODE_RGB && mode != IMAGING_MODE_RGBA &&
+        mode != IMAGING_MODE_CMYK) {
         return (ImagingPalette)ImagingError_ModeError();
     }
 

From 29509ffa753011d250e976e941a88a28a8277e12 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Mar 2026 20:21:53 +1100
Subject: [PATCH 2296/2374] Detect CMYK palette in JPEG2000 images

---
 Tests/test_file_jpeg2k.py    |  1 +
 src/PIL/Jpeg2KImagePlugin.py | 14 ++++++++++----
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 575d911def5..df686df3222 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -445,6 +445,7 @@ def test_pclr() -> None:
     ) as im:
         assert im.mode == "P"
         assert im.palette is not None
+        assert im.palette.mode == "CMYK"
         assert len(im.palette.colors) == 139
         assert im.palette.colors[(0, 0, 0, 0)] == 0
 
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index d6ec38d4310..e5d735c7328 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -176,6 +176,7 @@ def _parse_jp2_header(
     nc = None
     dpi = None  # 2-tuple of DPI info, or None
     palette = None
+    cmyk = False
 
     while header.has_next_box():
         tbox = header.next_box_type()
@@ -196,10 +197,11 @@ def _parse_jp2_header(
                 mode = "RGB"
             elif nc == 4:
                 mode = "RGBA"
-        elif tbox == b"colr" and nc == 4:
+        elif tbox == b"colr":
             meth, _, _, enumcs = header.read_fields(">BBBI")
-            if meth == 1 and enumcs == 12:
-                mode = "CMYK"
+            if cmyk := (meth == 1 and enumcs == 12):
+                if nc == 4:
+                    mode = "CMYK"
         elif tbox == b"pclr" and mode in ("L", "LA"):
             ne, npc = header.read_fields(">HB")
             assert isinstance(ne, int)
@@ -210,7 +212,11 @@ def _parse_jp2_header(
                 if bitdepth > max_bitdepth:
                     max_bitdepth = bitdepth
             if max_bitdepth <= 8:
-                palette = ImagePalette.ImagePalette("RGBA" if npc == 4 else "RGB")
+                if npc == 4:
+                    palette_mode = "CMYK" if cmyk else "RGBA"
+                else:
+                    palette_mode = "RGB"
+                palette = ImagePalette.ImagePalette(palette_mode)
                 for i in range(ne):
                     color: list[int] = []
                     for value in header.read_fields(">" + ("B" * npc)):

From 4f5802b6b17a3c463f734e3c5cc3484dca9b1d44 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Mar 2026 23:45:22 +1100
Subject: [PATCH 2297/2374] Do not use palette from grayscale or bilevel
 colorspace

---
 Tests/test_file_jpeg2k.py    |  7 +++++++
 src/PIL/Jpeg2KImagePlugin.py | 15 +++++++++++----
 2 files changed, 18 insertions(+), 4 deletions(-)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index 575d911def5..4f6376ed7e5 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -440,6 +440,13 @@ def test_pclr() -> None:
         assert len(im.palette.colors) == 256
         assert im.palette.colors[(255, 255, 255)] == 0
 
+    for enumcs in (0, 15, 17):
+        with open(f"{EXTRA_DIR}/issue104_jpxstream.jp2", "rb") as fp:
+            data = bytearray(fp.read())
+        data[114:115] = bytes([enumcs])
+        with Image.open(BytesIO(data)) as im:
+            assert im.mode == "L"
+
     with Image.open(
         f"{EXTRA_DIR}/147af3f1083de4393666b7d99b01b58b_signal_sigsegv_130c531_6155_5136.jp2"
     ) as im:
diff --git a/src/PIL/Jpeg2KImagePlugin.py b/src/PIL/Jpeg2KImagePlugin.py
index d6ec38d4310..b08c466e266 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -176,6 +176,7 @@ def _parse_jp2_header(
     nc = None
     dpi = None  # 2-tuple of DPI info, or None
     palette = None
+    colr = None
 
     while header.has_next_box():
         tbox = header.next_box_type()
@@ -196,11 +197,17 @@ def _parse_jp2_header(
                 mode = "RGB"
             elif nc == 4:
                 mode = "RGBA"
-        elif tbox == b"colr" and nc == 4:
+        elif tbox == b"colr":
             meth, _, _, enumcs = header.read_fields(">BBBI")
-            if meth == 1 and enumcs == 12:
-                mode = "CMYK"
-        elif tbox == b"pclr" and mode in ("L", "LA"):
+            if meth == 1:
+                if enumcs in (0, 15):
+                    colr = "1"
+                elif enumcs == 12:
+                    if nc == 4:
+                        mode = "CMYK"
+                elif enumcs == 17:
+                    colr = "L"
+        elif tbox == b"pclr" and mode in ("L", "LA") and colr not in ("1", "L"):
             ne, npc = header.read_fields(">HB")
             assert isinstance(ne, int)
             assert isinstance(npc, int)

From 6a06285bf8832a87cc5a1c8d4d850e90051a87dd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Mar 2026 23:52:33 +1100
Subject: [PATCH 2298/2374] Support reading JPEG2000 images with CMYK palettes

---
 src/libImaging/Jpeg2KDecode.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/libImaging/Jpeg2KDecode.c b/src/libImaging/Jpeg2KDecode.c
index 1b496f45ec0..1123d7bc915 100644
--- a/src/libImaging/Jpeg2KDecode.c
+++ b/src/libImaging/Jpeg2KDecode.c
@@ -601,6 +601,7 @@ j2ku_sycca_rgba(
 static const struct j2k_decode_unpacker j2k_unpackers[] = {
     {IMAGING_MODE_L, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_l},
     {IMAGING_MODE_P, OPJ_CLRSPC_SRGB, 1, 0, j2ku_gray_l},
+    {IMAGING_MODE_P, OPJ_CLRSPC_CMYK, 1, 0, j2ku_gray_l},
     {IMAGING_MODE_PA, OPJ_CLRSPC_SRGB, 2, 0, j2ku_graya_la},
     {IMAGING_MODE_I_16, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_i},
     {IMAGING_MODE_I_16B, OPJ_CLRSPC_GRAY, 1, 0, j2ku_gray_i},

From 8442a8541c486eb19a3bc3d940c43a45241f2e44 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 16 Mar 2026 22:12:58 +1100
Subject: [PATCH 2299/2374] Support saving images with non-RGB palettes as PNGs

---
 Tests/test_file_png.py    | 10 ++++++++++
 src/PIL/PngImagePlugin.py |  7 +++++--
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index 2e0af504183..3f08d1ad3aa 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -707,6 +707,16 @@ def test_plte_length(self, tmp_path: Path) -> None:
             assert reloaded.png.im_palette is not None
             assert len(reloaded.png.im_palette[1]) == 3
 
+    def test_plte_cmyk(self, tmp_path: Path) -> None:
+        im = Image.new("P", (1, 1))
+        im.putpalette((0, 100, 150, 200), "CMYK")
+
+        out = tmp_path / "temp.png"
+        im.save(out)
+
+        with Image.open(out) as reloaded:
+            assert reloaded.convert("CMYK").getpixel((0, 0)) == (200, 222, 232, 0)
+
     def test_getxmp(self) -> None:
         with Image.open("Tests/images/color_snakes.png") as im:
             if ElementTree is None:
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 572762e6c83..4e082a293ff 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1353,6 +1353,9 @@ def _save(
         mode = im.mode
 
     outmode = mode
+    palette = []
+    if im.palette:
+        palette = im.getpalette() or []
     if mode == "P":
         #
         # attempt to minimize storage requirements for palette images
@@ -1362,7 +1365,7 @@ def _save(
         else:
             # check palette contents
             if im.palette:
-                colors = max(min(len(im.palette.getdata()[1]) // 3, 256), 1)
+                colors = max(min(len(palette) // 3, 256), 1)
             else:
                 colors = 256
 
@@ -1435,7 +1438,7 @@ def _save(
 
     if im.mode == "P":
         palette_byte_number = colors * 3
-        palette_bytes = im.im.getpalette("RGB")[:palette_byte_number]
+        palette_bytes = bytes(palette[:palette_byte_number])
         while len(palette_bytes) < palette_byte_number:
             palette_bytes += b"\0"
         chunk(fp, b"PLTE", palette_bytes)

From e34c7bee9113dcf36ff1c40ce0d13a2611a02b54 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 17 Mar 2026 10:56:32 +1100
Subject: [PATCH 2300/2374] Updated Ghostscript to 10.7.0

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

diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index ed32be26d41..3bc70e337a8 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -98,8 +98,8 @@ jobs:
         choco install nasm --no-progress
         echo "C:\Program Files\NASM" >> $env:GITHUB_PATH
 
-        choco install ghostscript --version=10.6.0 --no-progress
-        echo "C:\Program Files\gs\gs10.06.0\bin" >> $env:GITHUB_PATH
+        choco install ghostscript --version=10.7.0 --no-progress
+        echo "C:\Program Files\gs\gs10.07.0\bin" >> $env:GITHUB_PATH
 
         # Install extra test images
         xcopy /S /Y Tests\test-images\* Tests\images

From e6bb8626c8e6a556e912c4c15bd46b1fb45f7de6 Mon Sep 17 00:00:00 2001
From: Zhiyuan Ouyang <tiancaioyzy@gmail.com>
Date: Tue, 17 Mar 2026 10:30:40 -0700
Subject: [PATCH 2301/2374] Add a ExifTag "FrameRate" to be supported in PIL.

Reference: https://exiftool.org/TagNames/EXIF.html
---
 src/PIL/ExifTags.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/PIL/ExifTags.py b/src/PIL/ExifTags.py
index c1c05cdba71..a9522e761b0 100644
--- a/src/PIL/ExifTags.py
+++ b/src/PIL/ExifTags.py
@@ -289,6 +289,7 @@ class Base(IntEnum):
     OpcodeList2 = 0xC741
     OpcodeList3 = 0xC74E
     NoiseProfile = 0xC761
+    FrameRate = 0xC764
 
 
 """Maps EXIF tags to tag names."""

From 98c149f0307e077d9aa0c2018710c9354afe6907 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 19 Mar 2026 09:26:58 +1100
Subject: [PATCH 2302/2374] Simplified code

---
 src/PIL/BmpImagePlugin.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 5ee61b35b17..00975624ae3 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -179,11 +179,8 @@ def _bitmap(self, header: int = 0, offset: int = 0) -> None:
 
         # ------- 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"])
-        )
+        if not file_info.get("colors", 0):
+            file_info["colors"] = 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"]

From 93de6a78d8cee9b2e9cdbe1f4d1da014d090ce8b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 19 Mar 2026 10:09:38 +1100
Subject: [PATCH 2303/2374] Generate test image programmatically

---
 Tests/images/pal8_offset.bmp | Bin 9254 -> 0 bytes
 Tests/test_file_bmp.py       |  12 +++++++-----
 2 files changed, 7 insertions(+), 5 deletions(-)
 delete mode 100644 Tests/images/pal8_offset.bmp

diff --git a/Tests/images/pal8_offset.bmp b/Tests/images/pal8_offset.bmp
deleted file mode 100644
index 24be65f22c3c7b77adb011ab4d635d95b31ee15d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 9254
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
T<(E}?03>_8_`3k(yk-3da10=X

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index 2e0394b3b2a..b61497812cb 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -42,7 +42,7 @@ 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")
+        assert_image_equal_tofile(im, "Tests/images/bmp/g/pal8.bmp")
 
 
 def test_save_to_bytes() -> None:
@@ -239,10 +239,12 @@ def test_unsupported_bmp_bitfields_layout() -> None:
 
 
 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:
-        assert_image_equal_tofile(im, "Tests/images/bmp/g/pal8.bmp")
+    # Exclude the palette size from the pixel data offset
+    with open("Tests/images/bmp/g/pal8.bmp", "rb") as fp:
+        data = fp.read()
+        data = data[:10] + o32(54) + data[14:]
+        with Image.open(io.BytesIO(data)) as im:
+            assert_image_equal_tofile(im, "Tests/images/bmp/g/pal8.bmp")
 
 
 def test_use_raw_alpha(monkeypatch: pytest.MonkeyPatch) -> None:

From 735d02584b4db8a1b923d546b7be94de28f0876a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 19 Mar 2026 10:38:28 +1100
Subject: [PATCH 2304/2374] Allow for different palette entry sizes when
 correcting offset

---
 Tests/test_file_bmp.py    | 16 ++++++++++++----
 src/PIL/BmpImagePlugin.py |  4 ++--
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/Tests/test_file_bmp.py b/Tests/test_file_bmp.py
index b61497812cb..c8ac4652434 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -238,13 +238,21 @@ def test_unsupported_bmp_bitfields_layout() -> None:
         Image.open(fp)
 
 
-def test_offset() -> None:
+@pytest.mark.parametrize(
+    "offset, path",
+    (
+        (26, "pal8os2.bmp"),
+        (54, "pal8.bmp"),
+    ),
+)
+def test_offset(offset: int, path: str) -> None:
+    image_path = "Tests/images/bmp/g/" + path
     # Exclude the palette size from the pixel data offset
-    with open("Tests/images/bmp/g/pal8.bmp", "rb") as fp:
+    with open(image_path, "rb") as fp:
         data = fp.read()
-        data = data[:10] + o32(54) + data[14:]
+        data = data[:10] + o32(offset) + data[14:]
         with Image.open(io.BytesIO(data)) as im:
-            assert_image_equal_tofile(im, "Tests/images/bmp/g/pal8.bmp")
+            assert_image_equal_tofile(im, image_path)
 
 
 def test_use_raw_alpha(monkeypatch: pytest.MonkeyPatch) -> None:
diff --git a/src/PIL/BmpImagePlugin.py b/src/PIL/BmpImagePlugin.py
index 00975624ae3..a6724cab437 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -181,9 +181,10 @@ def _bitmap(self, header: int = 0, offset: int = 0) -> None:
         assert isinstance(file_info["bits"], int)
         if not file_info.get("colors", 0):
             file_info["colors"] = 1 << file_info["bits"]
+        assert isinstance(file_info["palette_padding"], int)
         assert isinstance(file_info["colors"], int)
         if offset == 14 + file_info["header_size"] and file_info["bits"] <= 8:
-            offset += 4 * file_info["colors"]
+            offset += file_info["palette_padding"] * file_info["colors"]
 
         # ---------------------- Check bit depth for unusual unsupported values
         self._mode, raw_mode = BIT2MODE.get(file_info["bits"], ("", ""))
@@ -262,7 +263,6 @@ def _bitmap(self, header: int = 0, offset: int = 0) -> None:
                 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

From c3041861905e690b3f71901fd1cab4667a82c46a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 20 Mar 2026 10:02:14 +1100
Subject: [PATCH 2305/2374] Simplified code

---
 Tests/test_file_tga.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index bb8d3eefcc6..277515fd425 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -13,8 +13,6 @@
 _TGA_DIR_COMMON = os.path.join(_TGA_DIR, "common")
 
 
-_ORIGINS = ("tl", "bl")
-
 _ORIGIN_TO_ORIENTATION = {"tl": 1, "bl": -1}
 
 
@@ -29,7 +27,7 @@
         ("200x32", "RGBA"),
     ),
 )
-@pytest.mark.parametrize("origin", _ORIGINS)
+@pytest.mark.parametrize("origin", _ORIGIN_TO_ORIENTATION)
 @pytest.mark.parametrize("rle", (True, False))
 def test_sanity(
     size_mode: tuple[str, str], origin: str, rle: str, tmp_path: Path

From 3b1f70da61df02378594ba6f490e937da127d40f Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Sat, 21 Mar 2026 01:01:20 +1100
Subject: [PATCH 2306/2374] Simplify `setimage()` by always passing extents
 (#9395)

---
 src/PIL/Image.py |  4 ++--
 src/decode.c     | 15 +++++----------
 src/encode.c     | 15 +++++----------
 3 files changed, 12 insertions(+), 22 deletions(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index cc431a86a5d..01f49ccc03f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -885,7 +885,7 @@ def tobytes(self, encoder_name: str = "raw", *args: Any) -> bytes:
 
         # unpack data
         e = _getencoder(self.mode, encoder_name, encoder_args)
-        e.setimage(self.im)
+        e.setimage(self.im, (0, 0) + self.size)
 
         from . import ImageFile
 
@@ -956,7 +956,7 @@ def frombytes(
 
         # unpack data
         d = _getdecoder(self.mode, decoder_name, decoder_args)
-        d.setimage(self.im)
+        d.setimage(self.im, (0, 0) + self.size)
         s = d.decode(data)
 
         if s[0] >= 0:
diff --git a/src/decode.c b/src/decode.c
index 7ec461c0e2c..c5c9cf56f70 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -163,7 +163,7 @@ _setimage(ImagingDecoderObject *decoder, PyObject *args) {
     x0 = y0 = x1 = y1 = 0;
 
     /* FIXME: should publish the ImagingType descriptor */
-    if (!PyArg_ParseTuple(args, "O|(iiii)", &op, &x0, &y0, &x1, &y1)) {
+    if (!PyArg_ParseTuple(args, "O(iiii)", &op, &x0, &y0, &x1, &y1)) {
         return NULL;
     }
     im = PyImaging_AsImaging(op);
@@ -176,15 +176,10 @@ _setimage(ImagingDecoderObject *decoder, PyObject *args) {
     state = &decoder->state;
 
     /* Setup decoding tile extent */
-    if (x0 == 0 && x1 == 0) {
-        state->xsize = im->xsize;
-        state->ysize = im->ysize;
-    } else {
-        state->xoff = x0;
-        state->yoff = y0;
-        state->xsize = x1 - x0;
-        state->ysize = y1 - y0;
-    }
+    state->xoff = x0;
+    state->yoff = y0;
+    state->xsize = x1 - x0;
+    state->ysize = y1 - y0;
 
     if (state->xoff < 0 || state->xsize <= 0 ||
         state->xsize + state->xoff > (int)im->xsize || state->yoff < 0 ||
diff --git a/src/encode.c b/src/encode.c
index 01b3af13fa1..f2bb464fa27 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -232,7 +232,7 @@ _setimage(ImagingEncoderObject *encoder, PyObject *args) {
     x0 = y0 = x1 = y1 = 0;
 
     /* FIXME: should publish the ImagingType descriptor */
-    if (!PyArg_ParseTuple(args, "O|(nnnn)", &op, &x0, &y0, &x1, &y1)) {
+    if (!PyArg_ParseTuple(args, "O(nnnn)", &op, &x0, &y0, &x1, &y1)) {
         return NULL;
     }
     im = PyImaging_AsImaging(op);
@@ -248,15 +248,10 @@ _setimage(ImagingEncoderObject *encoder, PyObject *args) {
 
     state = &encoder->state;
 
-    if (x0 == 0 && x1 == 0) {
-        state->xsize = im->xsize;
-        state->ysize = im->ysize;
-    } else {
-        state->xoff = x0;
-        state->yoff = y0;
-        state->xsize = x1 - x0;
-        state->ysize = y1 - y0;
-    }
+    state->xoff = x0;
+    state->yoff = y0;
+    state->xsize = x1 - x0;
+    state->ysize = y1 - y0;
 
     if (state->xoff < 0 || state->xsize <= 0 ||
         state->xsize + state->xoff > im->xsize || state->yoff < 0 ||

From 4d0089141c3b0bacfff5f5a3e949866a1fe851bf Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Mar 2026 19:26:55 +1100
Subject: [PATCH 2307/2374] Fixed invalid test font

---
 Tests/fonts/fuzz_font-5203009437302784 | 6 +++---
 Tests/test_font_crash.py               | 3 ---
 2 files changed, 3 insertions(+), 6 deletions(-)

diff --git a/Tests/fonts/fuzz_font-5203009437302784 b/Tests/fonts/fuzz_font-5203009437302784
index 0465e48c204..fb401fea225 100644
--- a/Tests/fonts/fuzz_font-5203009437302784
+++ b/Tests/fonts/fuzz_font-5203009437302784
@@ -1,10 +1,10 @@
 STARTFONT
 FONT �
 SIZE 10
-FONTBOUNDINGBOX
-CHARS
+FONTBOUNDINGBOX 1 1 0 0
+CHARS 1
 STARTCHAR 
-ENCODING
+ENCODING 65
 BBX 2 5
 ENDCHAR
 ENDFONT
diff --git a/Tests/test_font_crash.py b/Tests/test_font_crash.py
index c3e62abf62e..72a0f353477 100644
--- a/Tests/test_font_crash.py
+++ b/Tests/test_font_crash.py
@@ -2,8 +2,6 @@
 
 from PIL import Image, ImageDraw, ImageFont
 
-from .helper import skip_unless_feature_version
-
 
 class TestFontCrash:
     def _fuzz_font(self, font: ImageFont.FreeTypeFont) -> None:
@@ -16,7 +14,6 @@ def _fuzz_font(self, font: ImageFont.FreeTypeFont) -> None:
             draw.multiline_textbbox((10, 10), "ABC\nAaaa", font, stroke_width=2)
             draw.text((10, 10), "Test Text", font=font, fill="#000")
 
-    @skip_unless_feature_version("freetype2", "2.12.0")
     def test_segfault(self) -> None:
         font = ImageFont.truetype("Tests/fonts/fuzz_font-5203009437302784")
         self._fuzz_font(font)

From 0d7f5077a75341b6af35636541e97299a1c5af69 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 21 Mar 2026 00:58:27 +1100
Subject: [PATCH 2308/2374] If v2 extension area specifies no alpha, fill alpha
 channel

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

diff --git a/Tests/test_file_tga.py b/Tests/test_file_tga.py
index 277515fd425..7ec562342e1 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -1,11 +1,12 @@
 from __future__ import annotations
 
 import os
+from io import BytesIO
 from pathlib import Path
 
 import pytest
 
-from PIL import Image, UnidentifiedImageError
+from PIL import Image, UnidentifiedImageError, _binary
 
 from .helper import assert_image_equal, assert_image_equal_tofile, hopper
 
@@ -92,6 +93,25 @@ def test_rgba_16() -> None:
         assert im.getpixel((1, 0)) == (0, 255, 82, 0)
 
 
+def test_v2_no_alpha() -> None:
+    test_file = "Tests/images/tga/common/200x32_rgba_tl_rle.tga"
+    with open(test_file, "rb") as fp:
+        data = fp.read()
+        data += (
+            b"\x00" * 495
+            + _binary.o32le(len(data))
+            + _binary.o32le(0)
+            + b"TRUEVISION-XFILE.\x00"
+        )
+    with Image.open(BytesIO(data)) as im:
+        with Image.open(test_file) as im2:
+            r, g, b = im2.split()[:3]
+        a = Image.new("L", im2.size, 255)
+        expected = Image.merge("RGBA", (r, g, b, a))
+
+        assert_image_equal(im, expected)
+
+
 def test_id_field() -> None:
     # tga file with id field
     test_file = "Tests/images/tga_id_field.tga"
diff --git a/src/PIL/TgaImagePlugin.py b/src/PIL/TgaImagePlugin.py
index 90d5b5cf4ee..b2989a4b764 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -17,11 +17,13 @@
 #
 from __future__ import annotations
 
+import os
 import warnings
 from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i16le as i16
+from ._binary import i32le as i32
 from ._binary import o8
 from ._binary import o16le as o16
 
@@ -157,6 +159,20 @@ def _open(self) -> None:
             pass  # cannot decode
 
     def load_end(self) -> None:
+        if self.mode == "RGBA":
+            assert self.fp is not None
+            self.fp.seek(-26, os.SEEK_END)
+            footer = self.fp.read(26)
+            if footer.endswith(b"TRUEVISION-XFILE.\x00"):
+                # version 2
+                extension_offset = i32(footer)
+                if extension_offset:
+                    self.fp.seek(extension_offset + 494)
+                    attributes_type = self.fp.read(1)
+                    if attributes_type == b"\x00":
+                        # No alpha
+                        self.im.fillband(3, 255)
+
         if self._flip_horizontally:
             self.im = self.im.transpose(Image.Transpose.FLIP_LEFT_RIGHT)
 

From fc0f65998fd5c6ddd37c4b3388d164314a4c68f1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Mon, 23 Mar 2026 21:21:51 +1100
Subject: [PATCH 2309/2374] Updated harfbuzz to 13.2.1 (#9461)

---
 .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 6f3a02f80d8..dbb7bc9773e 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -91,7 +91,7 @@ ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds.
 FREETYPE_VERSION=2.14.2
-HARFBUZZ_VERSION=13.0.1
+HARFBUZZ_VERSION=13.2.1
 LIBPNG_VERSION=1.6.55
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 95bb3e7d960..4a813820664 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -116,7 +116,7 @@ def cmd_msbuild(
     "BROTLI": "1.2.0",
     "FREETYPE": "2.14.2",
     "FRIBIDI": "1.0.16",
-    "HARFBUZZ": "13.0.1",
+    "HARFBUZZ": "13.2.1",
     "JPEGTURBO": "3.1.3",
     "LCMS2": "2.18",
     "LIBAVIF": "1.4.0",

From 4e85badfc1cf83418744386f5da26db5e309a207 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 23 Mar 2026 21:23:24 +1100
Subject: [PATCH 2310/2374] Updated freetype to 2.14.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 dbb7bc9773e..76498d5f3e3 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -90,7 +90,7 @@ fi
 ARCHIVE_SDIR=pillow-depends-main
 
 # Package versions for fresh source builds.
-FREETYPE_VERSION=2.14.2
+FREETYPE_VERSION=2.14.3
 HARFBUZZ_VERSION=13.2.1
 LIBPNG_VERSION=1.6.55
 JPEGTURBO_VERSION=3.1.3
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 4a813820664..4183d92b544 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -114,7 +114,7 @@ def cmd_msbuild(
 
 V = {
     "BROTLI": "1.2.0",
-    "FREETYPE": "2.14.2",
+    "FREETYPE": "2.14.3",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "13.2.1",
     "JPEGTURBO": "3.1.3",

From f0b5f56e9f9d095b52de995a94c8387f0b4230ad Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Tue, 24 Mar 2026 22:34:11 +1100
Subject: [PATCH 2311/2374] Updated libavif to 1.4.1 (#9479)

---
 .github/workflows/wheels-dependencies.sh | 2 +-
 depends/install_libavif.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 dbb7bc9773e..85ce69e0728 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -104,7 +104,7 @@ LIBWEBP_VERSION=1.6.0
 BZIP2_VERSION=1.0.8
 LIBXCB_VERSION=1.17.0
 BROTLI_VERSION=1.2.0
-LIBAVIF_VERSION=1.4.0
+LIBAVIF_VERSION=1.4.1
 
 function build_pkg_config {
     if [ -e pkg-config-stamp ]; then return; fi
diff --git a/depends/install_libavif.sh b/depends/install_libavif.sh
index 5c5c6f3f7c2..2c5687391a9 100755
--- a/depends/install_libavif.sh
+++ b/depends/install_libavif.sh
@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -eo pipefail
 
-version=1.4.0
+version=1.4.1
 
 if [[ "$GHA_LIBAVIF_CACHE_HIT" == "true" ]]; then
 
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 4a813820664..be72ae93b44 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -119,7 +119,7 @@ def cmd_msbuild(
     "HARFBUZZ": "13.2.1",
     "JPEGTURBO": "3.1.3",
     "LCMS2": "2.18",
-    "LIBAVIF": "1.4.0",
+    "LIBAVIF": "1.4.1",
     "LIBIMAGEQUANT": "4.4.1",
     "LIBPNG": "1.6.55",
     "LIBWEBP": "1.6.0",

From ffd32a861a690a0dcb49d62379c20c4184810f19 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Tue, 24 Mar 2026 21:14:16 +0000
Subject: [PATCH 2312/2374] Check all allocs in the Arrow tree

* handle alloc failure
* Ensure we're calling release so the refcount on the image is
decremented
* Ensure that release array/schema can handle partially allocated
children arrays.
---
 src/_imaging.c         |  3 ++
 src/libImaging/Arrow.c | 76 ++++++++++++++++++++++++------------------
 2 files changed, 46 insertions(+), 33 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index d2a195887fa..af836036857 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -286,6 +286,9 @@ PyObject *
 ExportArrowArrayPyCapsule(ImagingObject *self) {
     struct ArrowArray *array =
         (struct ArrowArray *)calloc(1, sizeof(struct ArrowArray));
+    if (!array) {
+        return ArrowError(IMAGING_CODEC_MEMORY);
+    }
     int err = export_imaging_array(self->image, array);
     if (err == 0) {
         return PyCapsule_New(array, "arrow_array", ReleaseArrowArrayPyCapsule);
diff --git a/src/libImaging/Arrow.c b/src/libImaging/Arrow.c
index de4d3568eda..3ca227d4f8e 100644
--- a/src/libImaging/Arrow.c
+++ b/src/libImaging/Arrow.c
@@ -10,8 +10,8 @@
 
 static void
 ReleaseExportedSchema(struct ArrowSchema *array) {
-    // This should not be called on already released array
-    // assert(array->release != NULL);
+    // TODO here: release and/or deallocate all data directly owned by
+    // the ArrowArray struct, such as the private_data.
 
     if (!array->release) {
         return;
@@ -30,31 +30,36 @@ ReleaseExportedSchema(struct ArrowSchema *array) {
     }
 
     // Release children
-    for (int64_t i = 0; i < array->n_children; ++i) {
-        struct ArrowSchema *child = array->children[i];
-        if (child->release != NULL) {
-            child->release(child);
-            child->release = NULL;
-        }
-        free(array->children[i]);
-    }
     if (array->children) {
+        for (int64_t i = 0; i < array->n_children; ++i) {
+            struct ArrowSchema *child = array->children[i];
+            if (child != NULL) {
+                if (child->release != NULL) {
+                    child->release(child);
+                    child->release = NULL;
+                }
+                free(array->children[i]);
+            }
+        }
         free(array->children);
+        array->children = NULL;
     }
 
     // Release dictionary
     struct ArrowSchema *dict = array->dictionary;
-    if (dict != NULL && dict->release != NULL) {
-        dict->release(dict);
-        dict->release = NULL;
+    if (dict != NULL) {
+        if (dict->release != NULL) {
+            dict->release(dict);
+            dict->release = NULL;
+        }
+        free(dict);
+        array->dictionary = NULL;
     }
 
-    // TODO here: release and/or deallocate all data directly owned by
-    // the ArrowArray struct, such as the private_data.
-
     // Mark array released
     array->release = NULL;
 }
+
 char *
 image_band_json(Imaging im) {
     char *format = "{\"bands\": [\"%s\", \"%s\", \"%s\", \"%s\"]}";
@@ -220,13 +225,19 @@ export_imaging_schema(Imaging im, struct ArrowSchema *schema) {
     // if it's not 1 band, it's an int32 at the moment. 4 uint8 bands.
     schema->n_children = 1;
     schema->children = calloc(1, sizeof(struct ArrowSchema *));
+    if (!schema->children) {
+        schema->release(schema);
+        return IMAGING_CODEC_MEMORY;
+    }
     schema->children[0] = (struct ArrowSchema *)calloc(1, sizeof(struct ArrowSchema));
+    if (!schema->children[0]) {
+        schema->release(schema);
+        return IMAGING_CODEC_MEMORY;
+    }
     retval = export_named_type(
         schema->children[0], im->arrow_band_format, getModeData(im->mode)->name
     );
     if (retval != 0) {
-        free(schema->children[0]);
-        free(schema->children);
         schema->release(schema);
         return retval;
     }
@@ -256,11 +267,12 @@ release_const_array(struct ArrowArray *array) {
         array->buffers = NULL;
     }
     if (array->children) {
-        // undone -- does arrow release all the children recursively?
         for (int i = 0; i < array->n_children; i++) {
-            if (array->children[i]->release) {
-                array->children[i]->release(array->children[i]);
-                array->children[i]->release = NULL;
+            if (array->children[i]) {
+                if (array->children[i]->release) {
+                    array->children[i]->release(array->children[i]);
+                    array->children[i]->release = NULL;
+                }
                 free(array->children[i]);
             }
         }
@@ -303,8 +315,11 @@ export_single_channel_array(Imaging im, struct ArrowArray *array) {
     };
 
     // Allocate list of buffers
-    array->buffers = (const void **)malloc(sizeof(void *) * array->n_buffers);
-    // assert(array->buffers != NULL);
+    array->buffers = (const void **)calloc(1, sizeof(void *) * array->n_buffers);
+    if (!array->buffers) {
+        array->release(array);
+        return IMAGING_CODEC_MEMORY;
+    }
     array->buffers[0] = NULL;  // no nulls, null bitmap can be omitted
 
     if (im->block) {
@@ -386,6 +401,9 @@ export_fixed_pixel_array(Imaging im, struct ArrowArray *array) {
 
     array->children[0]->buffers =
         (const void **)calloc(2, sizeof(void *) * array->n_buffers);
+    if (!array->children[0]->buffers) {
+        goto err;
+    }
 
     if (im->block) {
         array->children[0]->buffers[1] = im->block;
@@ -395,15 +413,7 @@ export_fixed_pixel_array(Imaging im, struct ArrowArray *array) {
     return 0;
 
 err:
-    if (array->children[0]) {
-        free(array->children[0]);
-    }
-    if (array->children) {
-        free(array->children);
-    }
-    if (array->buffers) {
-        free(array->buffers);
-    }
+    array->release(array);
     return IMAGING_CODEC_MEMORY;
 }
 

From 3a83d6abc3d2f51efc5b16e4f7d0351a1f9e877d Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 25 Mar 2026 01:54:16 +0200
Subject: [PATCH 2313/2374] Enable colour in CI logs (#9486)

---
 .github/workflows/cifuzz.yml               | 3 +++
 .github/workflows/release-drafter.yml      | 3 +++
 .github/workflows/stale.yml                | 3 +++
 .github/workflows/test-docker.yml          | 3 +++
 .github/workflows/test-mingw.yml           | 1 +
 .github/workflows/test-valgrind-memory.yml | 3 +++
 .github/workflows/test-valgrind.yml        | 3 +++
 .github/workflows/test-windows.yml         | 1 +
 8 files changed, 20 insertions(+)

diff --git a/.github/workflows/cifuzz.yml b/.github/workflows/cifuzz.yml
index 7e771f1b7d1..3f78c98b6f6 100644
--- a/.github/workflows/cifuzz.yml
+++ b/.github/workflows/cifuzz.yml
@@ -24,6 +24,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   Fuzzing:
     runs-on: ubuntu-latest
diff --git a/.github/workflows/release-drafter.yml b/.github/workflows/release-drafter.yml
index a8ddef22c86..12633284f49 100644
--- a/.github/workflows/release-drafter.yml
+++ b/.github/workflows/release-drafter.yml
@@ -14,6 +14,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   update_release_draft:
     permissions:
diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index 1b0c3c654e7..9d19028387d 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -12,6 +12,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   stale:
     if: github.repository_owner == 'python-pillow'
diff --git a/.github/workflows/test-docker.yml b/.github/workflows/test-docker.yml
index 8f24bef3d6a..08226738e11 100644
--- a/.github/workflows/test-docker.yml
+++ b/.github/workflows/test-docker.yml
@@ -26,6 +26,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   build:
 
diff --git a/.github/workflows/test-mingw.yml b/.github/workflows/test-mingw.yml
index e247414c8fc..808373a65a1 100644
--- a/.github/workflows/test-mingw.yml
+++ b/.github/workflows/test-mingw.yml
@@ -28,6 +28,7 @@ concurrency:
 
 env:
   COVERAGE_CORE: sysmon
+  FORCE_COLOR: 1
 
 jobs:
   build:
diff --git a/.github/workflows/test-valgrind-memory.yml b/.github/workflows/test-valgrind-memory.yml
index bd244aa5a57..87eace64376 100644
--- a/.github/workflows/test-valgrind-memory.yml
+++ b/.github/workflows/test-valgrind-memory.yml
@@ -26,6 +26,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   build:
 
diff --git a/.github/workflows/test-valgrind.yml b/.github/workflows/test-valgrind.yml
index 81cfb84566c..f14dab61623 100644
--- a/.github/workflows/test-valgrind.yml
+++ b/.github/workflows/test-valgrind.yml
@@ -24,6 +24,9 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+  FORCE_COLOR: 1
+
 jobs:
   build:
 
diff --git a/.github/workflows/test-windows.yml b/.github/workflows/test-windows.yml
index 3bc70e337a8..45392a689b1 100644
--- a/.github/workflows/test-windows.yml
+++ b/.github/workflows/test-windows.yml
@@ -28,6 +28,7 @@ concurrency:
 
 env:
   COVERAGE_CORE: sysmon
+  FORCE_COLOR: 1
 
 jobs:
   build:

From 47386d191ca5b3a82ff7c2fabb3a440db921c48c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Mar 2026 22:33:37 +1100
Subject: [PATCH 2314/2374] Set image pixels individually on 32-bit Windows

---
 src/libImaging/Paste.c | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index 25941ab3dbb..f01bce93388 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -352,16 +352,16 @@ ImagingPaste(
 
 static inline void
 fill(
-    Imaging imOut, const void *ink_, int dx, int dy, int xsize, int ysize, int pixelsize
+    Imaging imOut, const UINT8 *ink, int dx, int dy, int xsize, int ysize, int pixelsize
 ) {
     /* fill opaque region */
 
-    int x, y;
+    int x, y, i;
     UINT8 ink8 = 0;
     INT32 ink32 = 0L;
 
-    memcpy(&ink32, ink_, pixelsize);
-    memcpy(&ink8, ink_, sizeof(ink8));
+    memcpy(&ink32, ink, pixelsize);
+    memcpy(&ink8, ink, sizeof(ink8));
 
     if (imOut->image8 || ink32 == 0L) {
         dx *= pixelsize;
@@ -371,12 +371,24 @@ fill(
         }
 
     } else {
+#if defined _WIN32 && !defined _WIN64
+        dx *= pixelsize;
+        for (y = 0; y < ysize; y++) {
+            UINT8 *out = (UINT8 *)imOut->image[y + dy] + dx;
+            for (x = 0; x < xsize; x++) {
+                for (i = 0; i < pixelsize; i++) {
+                    *out++ = ink[i];
+                }
+            }
+        }
+#else
         for (y = 0; y < ysize; y++) {
             INT32 *out = imOut->image32[y + dy] + dx;
             for (x = 0; x < xsize; x++) {
                 out[x] = ink32;
             }
         }
+#endif
     }
 }
 

From 9a89944e735283ce4bbdf2dde1ea7c44798d9683 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 25 Mar 2026 14:00:18 +0200
Subject: [PATCH 2315/2374] Fix `_getxy` refcount leaks (#9487)

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

diff --git a/src/_imaging.c b/src/_imaging.c
index d2a195887fa..b8b8df5c2a1 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -1216,7 +1216,9 @@ _getxy(PyObject *xy, int *x, int *y) {
         PyObject *int_value = PyObject_CallMethod(value, "__int__", NULL);
         if (int_value != NULL && PyLong_Check(int_value)) {
             *x = PyLong_AS_LONG(int_value);
+            Py_DECREF(int_value);
         } else {
+            Py_XDECREF(int_value);
             goto badval;
         }
     }
@@ -1230,7 +1232,9 @@ _getxy(PyObject *xy, int *x, int *y) {
         PyObject *int_value = PyObject_CallMethod(value, "__int__", NULL);
         if (int_value != NULL && PyLong_Check(int_value)) {
             *y = PyLong_AS_LONG(int_value);
+            Py_DECREF(int_value);
         } else {
+            Py_XDECREF(int_value);
             goto badval;
         }
     }

From 93729a006271c5757dc706a67f3077817bdf32b4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Mar 2026 23:04:35 +1100
Subject: [PATCH 2316/2374] Removed unused code

---
 src/encode.c | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/encode.c b/src/encode.c
index f2bb464fa27..b9feb28d227 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -1343,8 +1343,6 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
 
     if (strcmp(format, "j2k") == 0) {
         codec_format = OPJ_CODEC_J2K;
-    } else if (strcmp(format, "jpt") == 0) {
-        codec_format = OPJ_CODEC_JPT;
     } else if (strcmp(format, "jp2") == 0) {
         codec_format = OPJ_CODEC_JP2;
     } else {

From 33d62fc8a1a15f26376bfdd9fc292449a4e0827e Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Mar 2026 23:11:59 +1100
Subject: [PATCH 2317/2374] Added error messages

---
 Tests/test_file_jpeg2k.py | 16 ++++++++++++++++
 src/decode.c              |  1 +
 src/encode.c              |  3 +++
 3 files changed, 20 insertions(+)

diff --git a/Tests/test_file_jpeg2k.py b/Tests/test_file_jpeg2k.py
index df686df3222..85851ddad2d 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -148,6 +148,22 @@ def test_prog_res_rt(card: ImageFile.ImageFile) -> None:
     assert_image_equal(im, card)
 
 
+def test_unknown_progression(tmp_path: Path) -> None:
+    outfile = tmp_path / "temp.jp2"
+
+    im = Image.new("1", (1, 1))
+    with pytest.raises(ValueError, match="unknown progression"):
+        im.save(outfile, progression="invalid")
+
+
+def test_unknown_cinema_mode(tmp_path: Path) -> None:
+    outfile = tmp_path / "temp.jp2"
+
+    im = Image.new("1", (1, 1))
+    with pytest.raises(ValueError, match="unknown cinema mode"):
+        im.save(outfile, cinema_mode="invalid")
+
+
 @pytest.mark.parametrize("num_resolutions", range(2, 6))
 def test_default_num_resolutions(
     card: ImageFile.ImageFile, num_resolutions: int
diff --git a/src/decode.c b/src/decode.c
index c5c9cf56f70..cda4ce7027f 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -905,6 +905,7 @@ PyImaging_Jpeg2KDecoderNew(PyObject *self, PyObject *args) {
     } else if (strcmp(format, "jp2") == 0) {
         codec_format = OPJ_CODEC_JP2;
     } else {
+        PyErr_SetString(PyExc_ValueError, "unknown codec format");
         return NULL;
     }
 
diff --git a/src/encode.c b/src/encode.c
index b9feb28d227..b268ad74141 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -1346,6 +1346,7 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
     } else if (strcmp(format, "jp2") == 0) {
         codec_format = OPJ_CODEC_JP2;
     } else {
+        PyErr_SetString(PyExc_ValueError, "unknown codec format");
         return NULL;
     }
 
@@ -1360,6 +1361,7 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
     } else if (strcmp(progression, "CPRL") == 0) {
         prog_order = OPJ_CPRL;
     } else {
+        PyErr_SetString(PyExc_ValueError, "unknown progression");
         return NULL;
     }
 
@@ -1372,6 +1374,7 @@ PyImaging_Jpeg2KEncoderNew(PyObject *self, PyObject *args) {
     } else if (strcmp(cinema_mode, "cinema4k-24") == 0) {
         cine_mode = OPJ_CINEMA4K_24;
     } else {
+        PyErr_SetString(PyExc_ValueError, "unknown cinema mode");
         return NULL;
     }
 

From 5b69607c35943f782cf854bb06596c34ca1a3628 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Wed, 25 Mar 2026 23:35:27 +1100
Subject: [PATCH 2318/2374] Skip build 1.4.1 for lint (#9491)

Co-authored-by: Andrew Murray <radarhere@users.noreply.github.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 tox.ini | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tox.ini b/tox.ini
index de18946efa7..37e2296fc1f 100644
--- a/tox.ini
+++ b/tox.ini
@@ -18,6 +18,7 @@ commands =
 [testenv:lint]
 skip_install = true
 deps =
+    build!=1.4.1 # pending https://github.com/pypa/build/pull/1003
     check-manifest
     prek
 pass_env =

From d4f78128abdc2ffd32e10f66024ee331241053ce Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 25 Mar 2026 22:47:22 +0200
Subject: [PATCH 2319/2374] Revert "Skip build 1.4.1 for lint" (#9495)

---
 tox.ini | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index 37e2296fc1f..de18946efa7 100644
--- a/tox.ini
+++ b/tox.ini
@@ -18,7 +18,6 @@ commands =
 [testenv:lint]
 skip_install = true
 deps =
-    build!=1.4.1 # pending https://github.com/pypa/build/pull/1003
     check-manifest
     prek
 pass_env =

From e4d72b53f5e885338ac55c570055d29e35c7c385 Mon Sep 17 00:00:00 2001
From: Sam Gross <colesbury@gmail.com>
Date: Wed, 25 Mar 2026 14:50:05 -0400
Subject: [PATCH 2320/2374] Use critical sections to protect FontObject

FreeType FT_Face objects are not thread-safe. Use per-object critical
sections to protect FontObject methods that access the underlying FT_Face
in the free-threaded build.

Fixes #9497
---
 src/_imagingft.c | 110 ++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 100 insertions(+), 10 deletions(-)

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 3be1bcb9a74..534dd028651 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -518,7 +518,7 @@ text_layout(
 }
 
 static PyObject *
-font_getlength(FontObject *self, PyObject *args) {
+font_getlength_impl(FontObject *self, PyObject *args) {
     int length;                   /* length along primary axis, in 26.6 precision */
     GlyphInfo *glyph_info = NULL; /* computed text layout */
     size_t i, count;              /* glyph_info index and length */
@@ -567,6 +567,15 @@ font_getlength(FontObject *self, PyObject *args) {
     return PyLong_FromLong(length);
 }
 
+static PyObject *
+font_getlength(FontObject *self, PyObject *args) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_getlength_impl(self, args);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
 static int
 bounding_box_and_anchors(
     FT_Face face,
@@ -746,7 +755,7 @@ bounding_box_and_anchors(
 }
 
 static PyObject *
-font_getsize(FontObject *self, PyObject *args) {
+font_getsize_impl(FontObject *self, PyObject *args) {
     int width, height, x_offset, y_offset;
     int load_flags; /* FreeType load_flags parameter */
     int error;
@@ -820,7 +829,16 @@ font_getsize(FontObject *self, PyObject *args) {
 }
 
 static PyObject *
-font_render(FontObject *self, PyObject *args) {
+font_getsize(FontObject *self, PyObject *args) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_getsize_impl(self, args);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
+static PyObject *
+font_render_impl(FontObject *self, PyObject *args) {
     int x, y;         /* pen position, in 26.6 precision */
     int px, py;       /* position of current glyph, in pixels */
     int x_min, y_max; /* text offset in 26.6 precision */
@@ -1233,6 +1251,15 @@ font_render(FontObject *self, PyObject *args) {
     return NULL;
 }
 
+static PyObject *
+font_render(FontObject *self, PyObject *args) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_render_impl(self, args);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
 static PyObject *
 font_getvarnames(FontObject *self) {
     int error;
@@ -1372,7 +1399,7 @@ font_getvaraxes(FontObject *self) {
 }
 
 static PyObject *
-font_setvarname(FontObject *self, PyObject *args) {
+font_setvarname_impl(FontObject *self, PyObject *args) {
     int error;
 
     int instance_index;
@@ -1389,7 +1416,16 @@ font_setvarname(FontObject *self, PyObject *args) {
 }
 
 static PyObject *
-font_setvaraxes(FontObject *self, PyObject *args) {
+font_setvarname(FontObject *self, PyObject *args) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_setvarname_impl(self, args);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
+static PyObject *
+font_setvaraxes_impl(FontObject *self, PyObject *args) {
     int error;
 
     PyObject *axes, *item;
@@ -1442,6 +1478,15 @@ font_setvaraxes(FontObject *self, PyObject *args) {
     Py_RETURN_NONE;
 }
 
+static PyObject *
+font_setvaraxes(FontObject *self, PyObject *args) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_setvaraxes_impl(self, args);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
 static void
 font_dealloc(FontObject *self) {
     if (self->face) {
@@ -1483,30 +1528,75 @@ font_getattr_style(FontObject *self, void *closure) {
 }
 
 static PyObject *
-font_getattr_ascent(FontObject *self, void *closure) {
+font_getattr_ascent_impl(FontObject *self, void *closure) {
     return PyLong_FromLong(PIXEL(self->face->size->metrics.ascender));
 }
 
 static PyObject *
-font_getattr_descent(FontObject *self, void *closure) {
+font_getattr_ascent(FontObject *self, void *closure) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_getattr_ascent_impl(self, closure);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
+static PyObject *
+font_getattr_descent_impl(FontObject *self, void *closure) {
     return PyLong_FromLong(-PIXEL(self->face->size->metrics.descender));
 }
 
 static PyObject *
-font_getattr_height(FontObject *self, void *closure) {
+font_getattr_descent(FontObject *self, void *closure) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_getattr_descent_impl(self, closure);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
+static PyObject *
+font_getattr_height_impl(FontObject *self, void *closure) {
     return PyLong_FromLong(PIXEL(self->face->size->metrics.height));
 }
 
 static PyObject *
-font_getattr_x_ppem(FontObject *self, void *closure) {
+font_getattr_height(FontObject *self, void *closure) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_getattr_height_impl(self, closure);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
+static PyObject *
+font_getattr_x_ppem_impl(FontObject *self, void *closure) {
     return PyLong_FromLong(self->face->size->metrics.x_ppem);
 }
 
 static PyObject *
-font_getattr_y_ppem(FontObject *self, void *closure) {
+font_getattr_x_ppem(FontObject *self, void *closure) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_getattr_x_ppem_impl(self, closure);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
+static PyObject *
+font_getattr_y_ppem_impl(FontObject *self, void *closure) {
     return PyLong_FromLong(self->face->size->metrics.y_ppem);
 }
 
+static PyObject *
+font_getattr_y_ppem(FontObject *self, void *closure) {
+    PyObject *result;
+    Py_BEGIN_CRITICAL_SECTION(self);
+    result = font_getattr_y_ppem_impl(self, closure);
+    Py_END_CRITICAL_SECTION();
+    return result;
+}
+
 static PyObject *
 font_getattr_glyphs(FontObject *self, void *closure) {
     return PyLong_FromLong(self->face->num_glyphs);

From f551ecdc430425846483b4a55bfc2956c8044b44 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Mar 2026 09:57:10 +1100
Subject: [PATCH 2321/2374] If Makernote is truncated, do not raise
 struct.error

---
 Tests/test_file_mpo.py |  35 +++++++++-
 src/PIL/Image.py       | 149 +++++++++++++++++++++--------------------
 2 files changed, 110 insertions(+), 74 deletions(-)

diff --git a/Tests/test_file_mpo.py b/Tests/test_file_mpo.py
index 4db62bd6d0a..7f35693f504 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -6,7 +6,14 @@
 
 import pytest
 
-from PIL import Image, ImageFile, JpegImagePlugin, MpoImagePlugin
+from PIL import (
+    Image,
+    ImageFile,
+    JpegImagePlugin,
+    MpoImagePlugin,
+    TiffImagePlugin,
+    _binary,
+)
 
 from .helper import (
     assert_image_equal,
@@ -145,6 +152,32 @@ def test_parallax() -> None:
         assert exif.get_ifd(0x927C)[0xB211] == -3.125
 
 
+def test_truncated_makernote() -> None:
+    def check(ifd: TiffImagePlugin.ImageFileDirectory_v2) -> None:
+        fp = BytesIO()
+        ifd.save(fp)
+
+        e = Image.Exif()
+        e.load(fp.getvalue())
+        assert e.get_ifd(37500) == {}
+
+    # Nintendo
+    ifd = TiffImagePlugin.ImageFileDirectory_v2()
+    ifd[271] = "Nintendo"
+    ifd[34665] = {37500: b" "}
+    check(ifd)
+
+    # Fujifilm
+    for data in (
+        b"FUJIFILM",
+        b"FUJIFILM" + _binary.o32le(50),
+        b"FUJIFILM" + _binary.o32le(0),
+    ):
+        ifd = TiffImagePlugin.ImageFileDirectory_v2()
+        ifd[34665] = {37500: data}
+        check(ifd)
+
+
 def test_reload_exif_after_seek() -> None:
     with Image.open("Tests/images/sugarshack.mpo") as im:
         exif = im.getexif()
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index f154cda2be8..bde335504e8 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -4234,80 +4234,83 @@ def get_ifd(self, tag: int) -> dict[int, Any]:
                 if tag == ExifTags.IFD.MakerNote:
                     from .TiffImagePlugin import ImageFileDirectory_v2
 
-                    if tag_data.startswith(b"FUJIFILM"):
-                        ifd_offset = i32le(tag_data, 8)
-                        ifd_data = tag_data[ifd_offset:]
-
-                        makernote = {}
-                        for i in range(struct.unpack("<H", ifd_data[:2])[0]):
-                            ifd_tag, typ, count, data = struct.unpack(
-                                "<HHL4s", ifd_data[i * 12 + 2 : (i + 1) * 12 + 2]
-                            )
-                            try:
-                                (
-                                    unit_size,
-                                    handler,
-                                ) = ImageFileDirectory_v2._load_dispatch[typ]
-                            except KeyError:
-                                continue
-                            size = count * unit_size
-                            if size > 4:
-                                (offset,) = struct.unpack("<L", data)
-                                data = ifd_data[offset - 12 : offset + size - 12]
-                            else:
-                                data = data[:size]
-
-                            if len(data) != size:
-                                warnings.warn(
-                                    "Possibly corrupt EXIF MakerNote data.  "
-                                    f"Expecting to read {size} bytes but only got "
-                                    f"{len(data)}. Skipping tag {ifd_tag}"
+                    try:
+                        if tag_data.startswith(b"FUJIFILM"):
+                            ifd_offset = i32le(tag_data, 8)
+                            ifd_data = tag_data[ifd_offset:]
+
+                            makernote = {}
+                            for i in range(struct.unpack("<H", ifd_data[:2])[0]):
+                                ifd_tag, typ, count, data = struct.unpack(
+                                    "<HHL4s", ifd_data[i * 12 + 2 : (i + 1) * 12 + 2]
+                                )
+                                try:
+                                    (
+                                        unit_size,
+                                        handler,
+                                    ) = ImageFileDirectory_v2._load_dispatch[typ]
+                                except KeyError:
+                                    continue
+                                size = count * unit_size
+                                if size > 4:
+                                    (offset,) = struct.unpack("<L", data)
+                                    data = ifd_data[offset - 12 : offset + size - 12]
+                                else:
+                                    data = data[:size]
+
+                                if len(data) != size:
+                                    warnings.warn(
+                                        "Possibly corrupt EXIF MakerNote data.  "
+                                        f"Expecting to read {size} bytes but only got "
+                                        f"{len(data)}. Skipping tag {ifd_tag}"
+                                    )
+                                    continue
+
+                                if not data:
+                                    continue
+
+                                makernote[ifd_tag] = handler(
+                                    ImageFileDirectory_v2(), data, False
+                                )
+                            self._ifds[tag] = dict(self._fixup_dict(makernote))
+                        elif self.get(0x010F) == "Nintendo":
+                            makernote = {}
+                            for i in range(struct.unpack(">H", tag_data[:2])[0]):
+                                ifd_tag, typ, count, data = struct.unpack(
+                                    ">HHL4s", tag_data[i * 12 + 2 : (i + 1) * 12 + 2]
                                 )
-                                continue
-
-                            if not data:
-                                continue
-
-                            makernote[ifd_tag] = handler(
-                                ImageFileDirectory_v2(), data, False
-                            )
-                        self._ifds[tag] = dict(self._fixup_dict(makernote))
-                    elif self.get(0x010F) == "Nintendo":
-                        makernote = {}
-                        for i in range(struct.unpack(">H", tag_data[:2])[0]):
-                            ifd_tag, typ, count, data = struct.unpack(
-                                ">HHL4s", tag_data[i * 12 + 2 : (i + 1) * 12 + 2]
-                            )
-                            if ifd_tag == 0x1101:
-                                # CameraInfo
-                                (offset,) = struct.unpack(">L", data)
-                                self.fp.seek(offset)
-
-                                camerainfo: dict[str, int | bytes] = {
-                                    "ModelID": self.fp.read(4)
-                                }
-
-                                self.fp.read(4)
-                                # Seconds since 2000
-                                camerainfo["TimeStamp"] = i32le(self.fp.read(12))
-
-                                self.fp.read(4)
-                                camerainfo["InternalSerialNumber"] = self.fp.read(4)
-
-                                self.fp.read(12)
-                                parallax = self.fp.read(4)
-                                handler = ImageFileDirectory_v2._load_dispatch[
-                                    TiffTags.FLOAT
-                                ][1]
-                                camerainfo["Parallax"] = handler(
-                                    ImageFileDirectory_v2(), parallax, False
-                                )[0]
-
-                                self.fp.read(4)
-                                camerainfo["Category"] = self.fp.read(2)
-
-                                makernote = {0x1101: camerainfo}
-                        self._ifds[tag] = makernote
+                                if ifd_tag == 0x1101:
+                                    # CameraInfo
+                                    (offset,) = struct.unpack(">L", data)
+                                    self.fp.seek(offset)
+
+                                    camerainfo: dict[str, int | bytes] = {
+                                        "ModelID": self.fp.read(4)
+                                    }
+
+                                    self.fp.read(4)
+                                    # Seconds since 2000
+                                    camerainfo["TimeStamp"] = i32le(self.fp.read(12))
+
+                                    self.fp.read(4)
+                                    camerainfo["InternalSerialNumber"] = self.fp.read(4)
+
+                                    self.fp.read(12)
+                                    parallax = self.fp.read(4)
+                                    handler = ImageFileDirectory_v2._load_dispatch[
+                                        TiffTags.FLOAT
+                                    ][1]
+                                    camerainfo["Parallax"] = handler(
+                                        ImageFileDirectory_v2(), parallax, False
+                                    )[0]
+
+                                    self.fp.read(4)
+                                    camerainfo["Category"] = self.fp.read(2)
+
+                                    makernote = {0x1101: camerainfo}
+                            self._ifds[tag] = makernote
+                    except struct.error:
+                        pass
                 else:
                     # Interop
                     ifd = self._get_ifd_dict(tag_data, tag)

From 67c0767b6487811f04498017f8c85fe45c510661 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 25 Mar 2026 09:53:27 +1100
Subject: [PATCH 2322/2374] If Photoshop blocks are truncated, do not raise
 struct.error

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

diff --git a/Tests/test_file_tiff.py b/Tests/test_file_tiff.py
index c6c8467d629..e442471d1ca 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -16,6 +16,7 @@
     TiffImagePlugin,
     TiffTags,
     UnidentifiedImageError,
+    _binary,
 )
 from PIL.TiffImagePlugin import RESOLUTION_UNIT, X_RESOLUTION, Y_RESOLUTION
 
@@ -941,6 +942,15 @@ def test_get_photoshop_blocks(self) -> None:
                 4001,
             ]
 
+    def test_truncated_photoshop_blocks(self) -> None:
+        with Image.open("Tests/images/hopper.tif") as im:
+            assert isinstance(im, TiffImagePlugin.TiffImageFile)
+            im.tag_v2[34377] = b"8BIM"
+            assert im.get_photoshop_blocks() == {}
+
+            im.tag_v2[34377] = b"8BIM" + _binary.o16be(0) + _binary.o8(2) + b" " * 5
+            assert im.get_photoshop_blocks() == {}
+
     def test_tiff_chunks(self, tmp_path: Path) -> None:
         tmpfile = tmp_path / "temp.tif"
 
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index de2ce066ebf..3eec94dca57 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1287,10 +1287,13 @@ def get_photoshop_blocks(self) -> dict[int, dict[str, bytes]]:
         blocks = {}
         val = self.tag_v2.get(ExifTags.Base.ImageResources)
         if val:
-            while val.startswith(b"8BIM"):
+            while val.startswith(b"8BIM") and len(val) >= 12:
                 id = i16(val[4:6])
                 n = math.ceil((val[6] + 1) / 2) * 2
-                size = i32(val[6 + n : 10 + n])
+                try:
+                    size = i32(val[6 + n : 10 + n])
+                except struct.error:
+                    break
                 data = val[10 + n : 10 + n + size]
                 blocks[id] = {"data": data}
 

From da729c832c26facdcc3afac52417cecc7641f232 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 08:43:32 +1100
Subject: [PATCH 2323/2374] Check if PyObject_CallMethod result is NULL (#9494)

---
 src/libImaging/SgiRleDecode.c | 13 ++++++++++---
 src/libImaging/codec_fd.c     | 15 ++++++++++++++-
 2 files changed, 24 insertions(+), 4 deletions(-)

diff --git a/src/libImaging/SgiRleDecode.c b/src/libImaging/SgiRleDecode.c
index a562f582cb0..2f5268b80b8 100644
--- a/src/libImaging/SgiRleDecode.c
+++ b/src/libImaging/SgiRleDecode.c
@@ -175,8 +175,15 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
 
     /* Get all data from File descriptor */
     c = (SGISTATE *)state->context;
-    _imaging_seek_pyFd(state->fd, 0L, SEEK_END);
+    if (_imaging_seek_pyFd(state->fd, 0L, SEEK_END) == -1) {
+        state->errcode = IMAGING_CODEC_UNKNOWN;
+        return -1;
+    }
     c->bufsize = _imaging_tell_pyFd(state->fd);
+    if (c->bufsize == -1) {
+        state->errcode = IMAGING_CODEC_UNKNOWN;
+        return -1;
+    }
     c->bufsize -= SGI_HEADER_SIZE;
 
     c->tablen = im->bands * im->ysize;
@@ -194,8 +201,8 @@ ImagingSgiRleDecode(Imaging im, ImagingCodecState state, UINT8 *buf, Py_ssize_t
         state->errcode = IMAGING_CODEC_MEMORY;
         return -1;
     }
-    _imaging_seek_pyFd(state->fd, SGI_HEADER_SIZE, SEEK_SET);
-    if (_imaging_read_pyFd(state->fd, (char *)ptr, c->bufsize) != c->bufsize) {
+    if (_imaging_seek_pyFd(state->fd, SGI_HEADER_SIZE, SEEK_SET) == -1 ||
+        _imaging_read_pyFd(state->fd, (char *)ptr, c->bufsize) != c->bufsize) {
         free(ptr);
         state->errcode = IMAGING_CODEC_UNKNOWN;
         return -1;
diff --git a/src/libImaging/codec_fd.c b/src/libImaging/codec_fd.c
index 5261681107b..dc85772983c 100644
--- a/src/libImaging/codec_fd.c
+++ b/src/libImaging/codec_fd.c
@@ -12,6 +12,9 @@ _imaging_read_pyFd(PyObject *fd, char *dest, Py_ssize_t bytes) {
     int bytes_result;
 
     result = PyObject_CallMethod(fd, "read", "n", bytes);
+    if (result == NULL) {
+        goto err;
+    }
 
     bytes_result = PyBytes_AsStringAndSize(result, &buffer, &length);
     if (bytes_result == -1) {
@@ -28,7 +31,7 @@ _imaging_read_pyFd(PyObject *fd, char *dest, Py_ssize_t bytes) {
     return length;
 
 err:
-    Py_DECREF(result);
+    Py_XDECREF(result);
     return -1;
 }
 
@@ -41,6 +44,10 @@ _imaging_write_pyFd(PyObject *fd, char *src, Py_ssize_t bytes) {
     result = PyObject_CallMethod(fd, "write", "O", byteObj);
 
     Py_DECREF(byteObj);
+    if (result == NULL) {
+        return -1;
+    }
+
     Py_DECREF(result);
 
     return bytes;
@@ -51,6 +58,9 @@ _imaging_seek_pyFd(PyObject *fd, Py_ssize_t offset, int whence) {
     PyObject *result;
 
     result = PyObject_CallMethod(fd, "seek", "ni", offset, whence);
+    if (result == NULL) {
+        return -1;
+    }
 
     Py_DECREF(result);
     return 0;
@@ -62,6 +72,9 @@ _imaging_tell_pyFd(PyObject *fd) {
     Py_ssize_t location;
 
     result = PyObject_CallMethod(fd, "tell", NULL);
+    if (result == NULL) {
+        return -1;
+    }
     location = PyLong_AsSsize_t(result);
 
     Py_DECREF(result);

From d305ee6a258a1c97b9187160553410c5610b75c4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 08:45:02 +1100
Subject: [PATCH 2324/2374] Check PyType_Ready return values (#9502)

---
 src/_imagingcms.c | 5 +++--
 src/_imagingft.c  | 4 +++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index ad3b27896fb..7db1baef0fb 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1447,8 +1447,9 @@ setup_module(PyObject *m) {
     int vn;
 
     /* Ready object types */
-    PyType_Ready(&CmsProfile_Type);
-    PyType_Ready(&CmsTransform_Type);
+    if (PyType_Ready(&CmsProfile_Type) < 0 || PyType_Ready(&CmsTransform_Type) < 0) {
+        return -1;
+    }
 
     Py_INCREF(&CmsProfile_Type);
     PyModule_AddObject(m, "CmsProfile", (PyObject *)&CmsProfile_Type);
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 3be1bcb9a74..8395eee2c0e 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -1545,7 +1545,9 @@ setup_module(PyObject *m) {
     d = PyModule_GetDict(m);
 
     /* Ready object type */
-    PyType_Ready(&Font_Type);
+    if (PyType_Ready(&Font_Type) < 0) {
+        return -1;
+    }
 
     if (FT_Init_FreeType(&library)) {
         return 0; /* leave it uninitialized */

From fcecc8c6c4b16a8dbb1b02e97be1f8d2f7d60965 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 08:45:40 +1100
Subject: [PATCH 2325/2374] Fixed AVIF and WEBP dealloc (#9501)

---
 src/_avif.c | 8 ++++----
 src/_webp.c | 2 ++
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/src/_avif.c b/src/_avif.c
index 5e8b9fe8e93..a9ae89f233b 100644
--- a/src/_avif.c
+++ b/src/_avif.c
@@ -425,7 +425,7 @@ AvifEncoderNew(PyObject *self_, PyObject *args) {
     return (PyObject *)self;
 }
 
-PyObject *
+void
 _encoder_dealloc(AvifEncoderObject *self) {
     if (self->encoder) {
         avifEncoderDestroy(self->encoder);
@@ -433,7 +433,7 @@ _encoder_dealloc(AvifEncoderObject *self) {
     if (self->image) {
         avifImageDestroy(self->image);
     }
-    Py_RETURN_NONE;
+    Py_TYPE(self)->tp_free(self);
 }
 
 PyObject *
@@ -687,13 +687,13 @@ AvifDecoderNew(PyObject *self_, PyObject *args) {
     return (PyObject *)self;
 }
 
-PyObject *
+void
 _decoder_dealloc(AvifDecoderObject *self) {
     if (self->decoder) {
         avifDecoderDestroy(self->decoder);
     }
     PyBuffer_Release(&self->buffer);
-    Py_RETURN_NONE;
+    Py_TYPE(self)->tp_free(self);
 }
 
 PyObject *
diff --git a/src/_webp.c b/src/_webp.c
index d065e329c6b..ea7e77133d4 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -219,6 +219,7 @@ _anim_encoder_dealloc(PyObject *self) {
     WebPAnimEncoderObject *encp = (WebPAnimEncoderObject *)self;
     WebPPictureFree(&(encp->frame));
     WebPAnimEncoderDelete(encp->enc);
+    Py_TYPE(self)->tp_free(self);
 }
 
 PyObject *
@@ -441,6 +442,7 @@ _anim_decoder_dealloc(PyObject *self) {
     WebPAnimDecoderObject *decp = (WebPAnimDecoderObject *)self;
     WebPDataClear(&(decp->data));
     WebPAnimDecoderDelete(decp->dec);
+    Py_TYPE(self)->tp_free(self);
 }
 
 PyObject *

From 92ccedea87cfbee4c40aac2a71ce3c1ede715c32 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 08:46:33 +1100
Subject: [PATCH 2326/2374] Release reference to encoder on error (#9500)

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

diff --git a/src/encode.c b/src/encode.c
index b268ad74141..1fc31404d9e 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -727,6 +727,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
     const RawModeID rawmode = findRawModeID(rawmode_name);
 
     if (get_packer(encoder, mode, rawmode) < 0) {
+        Py_DECREF(encoder);
         return NULL;
     }
 
@@ -742,6 +743,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
     for (pos = 0; pos < tags_size; pos++) {
         item = PyList_GetItemRef(tags, pos);
         if (item == NULL) {
+            Py_DECREF(encoder);
             return NULL;
         }
 
@@ -766,6 +768,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
         if (!is_core_tag) {
             PyObject *tag_type;
             if (PyDict_GetItemRef(types, key, &tag_type) < 0) {
+                Py_DECREF(encoder);
                 return NULL;  // Exception has been already set
             }
             if (tag_type) {
@@ -837,6 +840,7 @@ PyImaging_LibTiffEncoderNew(PyObject *self, PyObject *args) {
             if (key_int == TIFFTAG_COLORMAP) {
                 int stride = 256;
                 if (len != 768) {
+                    Py_DECREF(encoder);
                     PyErr_SetString(
                         PyExc_ValueError, "Requiring 768 items for Colormap"
                     );

From 9b7dccfe32dfa620afa54050e83d673903ce81e4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 08:47:58 +1100
Subject: [PATCH 2327/2374] Use PyModule_AddObjectRef (#9503)

---
 src/_imaging.c    | 25 +++++++++++++++----------
 src/_imagingcms.c |  9 ++++-----
 2 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/src/_imaging.c b/src/_imaging.c
index b8b8df5c2a1..697fe0ce5d0 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -4324,8 +4324,9 @@ setup_module(PyObject *m) {
 #else
     have_libjpegturbo = Py_False;
 #endif
-    Py_INCREF(have_libjpegturbo);
-    PyModule_AddObject(m, "HAVE_LIBJPEGTURBO", have_libjpegturbo);
+    if (PyModule_AddObjectRef(m, "HAVE_LIBJPEGTURBO", have_libjpegturbo) < 0) {
+        return -1;
+    }
 
     PyObject *have_mozjpeg;
 #ifdef JPEG_C_PARAM_SUPPORTED
@@ -4333,8 +4334,9 @@ setup_module(PyObject *m) {
 #else
     have_mozjpeg = Py_False;
 #endif
-    Py_INCREF(have_mozjpeg);
-    PyModule_AddObject(m, "HAVE_MOZJPEG", have_mozjpeg);
+    if (PyModule_AddObjectRef(m, "HAVE_MOZJPEG", have_mozjpeg) < 0) {
+        return -1;
+    }
 
     PyObject *have_libimagequant;
 #ifdef HAVE_LIBIMAGEQUANT
@@ -4348,8 +4350,9 @@ setup_module(PyObject *m) {
 #else
     have_libimagequant = Py_False;
 #endif
-    Py_INCREF(have_libimagequant);
-    PyModule_AddObject(m, "HAVE_LIBIMAGEQUANT", have_libimagequant);
+    if (PyModule_AddObjectRef(m, "HAVE_LIBIMAGEQUANT", have_libimagequant) < 0) {
+        return -1;
+    }
 
 #ifdef HAVE_LIBZ
     /* zip encoding strategies */
@@ -4377,8 +4380,9 @@ setup_module(PyObject *m) {
 #else
     have_zlibng = Py_False;
 #endif
-    Py_INCREF(have_zlibng);
-    PyModule_AddObject(m, "HAVE_ZLIBNG", have_zlibng);
+    if (PyModule_AddObjectRef(m, "HAVE_ZLIBNG", have_zlibng) < 0) {
+        return -1;
+    }
 
 #ifdef HAVE_LIBTIFF
     {
@@ -4395,8 +4399,9 @@ setup_module(PyObject *m) {
 #else
     have_xcb = Py_False;
 #endif
-    Py_INCREF(have_xcb);
-    PyModule_AddObject(m, "HAVE_XCB", have_xcb);
+    if (PyModule_AddObjectRef(m, "HAVE_XCB", have_xcb) < 0) {
+        return -1;
+    }
 
     PyObject *pillow_version = PyUnicode_FromString(version);
     PyDict_SetItemString(
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 7db1baef0fb..7b4fb00a470 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -1451,11 +1451,10 @@ setup_module(PyObject *m) {
         return -1;
     }
 
-    Py_INCREF(&CmsProfile_Type);
-    PyModule_AddObject(m, "CmsProfile", (PyObject *)&CmsProfile_Type);
-
-    Py_INCREF(&CmsTransform_Type);
-    PyModule_AddObject(m, "CmsTransform", (PyObject *)&CmsTransform_Type);
+    if (PyModule_AddObjectRef(m, "CmsProfile", (PyObject *)&CmsProfile_Type) < 0 ||
+        PyModule_AddObjectRef(m, "CmsTransform", (PyObject *)&CmsTransform_Type) < 0) {
+        return -1;
+    }
 
     d = PyModule_GetDict(m);
 

From f176f5dad642f16663da4c587a85aa671f00abba Mon Sep 17 00:00:00 2001
From: Andrew Murray <3112309+radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 08:57:45 +1100
Subject: [PATCH 2328/2374] Update libpng to 1.6.56 (#9499)

---
 .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 fd5b598703e..107eeae9b95 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -92,7 +92,7 @@ ARCHIVE_SDIR=pillow-depends-main
 # Package versions for fresh source builds.
 FREETYPE_VERSION=2.14.3
 HARFBUZZ_VERSION=13.2.1
-LIBPNG_VERSION=1.6.55
+LIBPNG_VERSION=1.6.56
 JPEGTURBO_VERSION=3.1.3
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.2
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index b82885e8efa..d958a459277 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -121,7 +121,7 @@ def cmd_msbuild(
     "LCMS2": "2.18",
     "LIBAVIF": "1.4.1",
     "LIBIMAGEQUANT": "4.4.1",
-    "LIBPNG": "1.6.55",
+    "LIBPNG": "1.6.56",
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",

From ef6951d1a5b7c0cb789a56cae16f06e8260a4587 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 27 Mar 2026 00:57:43 +0200
Subject: [PATCH 2329/2374] CI: Retry failed downloads (#9506)

---
 depends/download-and-extract.sh | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/depends/download-and-extract.sh b/depends/download-and-extract.sh
index 04bfbc7556b..52010475376 100755
--- a/depends/download-and-extract.sh
+++ b/depends/download-and-extract.sh
@@ -5,7 +5,10 @@ archive=$1
 url=$2
 
 if [ ! -f $archive.tar.gz ]; then
-    wget --no-verbose -O $archive.tar.gz $url
+    wget -O $archive.tar.gz $url \
+        --no-verbose \
+        --retry-connrefused \
+        --retry-on-http-error=429,503,504
 fi
 
 rmdir $archive

From 7672b19af4107748301187dae539c38d5126fa34 Mon Sep 17 00:00:00 2001
From: wiredfool <eric-github@soroos.net>
Date: Fri, 27 Mar 2026 04:23:01 +0000
Subject: [PATCH 2330/2374] Fix missing null dereference checks (#9489)

Co-authored-by: Andrew Murray <3112309+radarhere@users.noreply.github.com>
---
 src/_avif.c         | 16 ++++++++++++++++
 src/_imaging.c      |  6 ++++++
 src/_imagingft.c    |  7 ++++++-
 src/_imagingmorph.c | 11 +++++++++++
 src/_webp.c         |  3 +++
 5 files changed, 42 insertions(+), 1 deletion(-)

diff --git a/src/_avif.c b/src/_avif.c
index a9ae89f233b..1fe0cb98676 100644
--- a/src/_avif.c
+++ b/src/_avif.c
@@ -708,15 +708,27 @@ _decoder_get_info(AvifDecoderObject *self) {
 
     if (image->xmp.size) {
         xmp = PyBytes_FromStringAndSize((const char *)image->xmp.data, image->xmp.size);
+        if (!xmp) {
+            return NULL;
+        }
     }
 
     if (image->exif.size) {
         exif =
             PyBytes_FromStringAndSize((const char *)image->exif.data, image->exif.size);
+        if (!exif) {
+            Py_XDECREF(xmp);
+            return NULL;
+        }
     }
 
     if (image->icc.size) {
         icc = PyBytes_FromStringAndSize((const char *)image->icc.data, image->icc.size);
+        if (!icc) {
+            Py_XDECREF(xmp);
+            Py_XDECREF(exif);
+            return NULL;
+        }
     }
 
     ret = Py_BuildValue(
@@ -799,6 +811,7 @@ _decoder_get_frame(AvifDecoderObject *self, PyObject *args) {
 
     if (rgb.height > PY_SSIZE_T_MAX / rgb.rowBytes) {
         PyErr_SetString(PyExc_MemoryError, "Integer overflow in pixel size");
+        avifRGBImageFreePixels(&rgb);
         return NULL;
     }
 
@@ -806,6 +819,9 @@ _decoder_get_frame(AvifDecoderObject *self, PyObject *args) {
 
     bytes = PyBytes_FromStringAndSize((char *)rgb.pixels, size);
     avifRGBImageFreePixels(&rgb);
+    if (!bytes) {
+        return NULL;
+    }
 
     ret = Py_BuildValue(
         "SKKK",
diff --git a/src/_imaging.c b/src/_imaging.c
index 697fe0ce5d0..8ec9b14cd6c 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -2473,6 +2473,9 @@ _split(ImagingObject *self) {
     }
 
     list = PyTuple_New(self->image->bands);
+    if (!list) {
+        return NULL;
+    }
     for (i = 0; i < self->image->bands; i++) {
         imaging_object = PyImagingNew(bands[i]);
         if (!imaging_object) {
@@ -3769,6 +3772,9 @@ _ptr_destructor(PyObject *capsule) {
 static PyObject *
 _getattr_ptr(ImagingObject *self, void *closure) {
     PyObject *capsule = PyCapsule_New(self->image, IMAGING_MAGIC, _ptr_destructor);
+    if (!capsule) {
+        return NULL;
+    }
     Py_INCREF(self);
     PyCapsule_SetContext(capsule, self);
     return capsule;
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 8395eee2c0e..1ac9d95ee38 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -941,8 +941,13 @@ font_render(FontObject *self, PyObject *args) {
         return NULL;
     }
     PyObject *imagePtr = PyObject_GetAttrString(image, "ptr");
+    if (!imagePtr) {
+        PyMem_Del(glyph_info);
+        Py_DECREF(image);
+        return NULL;
+    }
     im = (Imaging)PyCapsule_GetPointer(imagePtr, IMAGING_MAGIC);
-    Py_XDECREF(imagePtr);
+    Py_DECREF(imagePtr);
 
     x_offset = round(x_offset - stroke_width);
     y_offset = round(y_offset - stroke_width);
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index 5995f9d429e..c1b772760fa 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -143,6 +143,9 @@ match(PyObject *self, PyObject *args) {
     }
 
     imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!imgin) {
+        return NULL;
+    }
 
     if (imgin->type != IMAGING_TYPE_UINT8 || imgin->bands != 1) {
         PyErr_SetString(PyExc_RuntimeError, "Unsupported image type");
@@ -185,6 +188,10 @@ match(PyObject *self, PyObject *args) {
                  (b6 << 6) | (b7 << 7) | (b8 << 8));
             if (lut[lut_idx]) {
                 PyObject *coordObj = Py_BuildValue("(nn)", col_idx, row_idx);
+                if (!coordObj) {
+                    Py_DECREF(ret);
+                    return NULL;
+                }
                 PyList_Append(ret, coordObj);
                 Py_XDECREF(coordObj);
             }
@@ -230,6 +237,10 @@ get_on_pixels(PyObject *self, PyObject *args) {
         for (col_idx = 0; col_idx < width; col_idx++) {
             if (row[col_idx]) {
                 PyObject *coordObj = Py_BuildValue("(nn)", col_idx, row_idx);
+                if (!coordObj) {
+                    Py_DECREF(ret);
+                    return NULL;
+                }
                 PyList_Append(ret, coordObj);
                 Py_XDECREF(coordObj);
             }
diff --git a/src/_webp.c b/src/_webp.c
index ea7e77133d4..a936e13d8c4 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -505,6 +505,9 @@ _anim_decoder_get_next(PyObject *self) {
     bytes = PyBytes_FromStringAndSize(
         (char *)buf, decp->info.canvas_width * 4 * decp->info.canvas_height
     );
+    if (!bytes) {
+        return NULL;
+    }
 
     ret = Py_BuildValue("Si", bytes, timestamp);
 

From 40400edd6229e9c26c22b0d3d4bcfa1cc7ec5cb0 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 15:26:25 +1100
Subject: [PATCH 2331/2374] Check PyCapsule_GetPointer return value

---
 src/_imaging.c           |  6 ++++++
 src/_imagingcms.c        |  6 ++++++
 src/_imagingft.c         |  5 +++++
 src/_imagingmath.c       | 21 +++++++++++++++++++++
 src/_imagingmorph.c      |  9 +++++++++
 src/_webp.c              |  6 ++++++
 src/libImaging/Storage.c |  6 ++++++
 7 files changed, 59 insertions(+)

diff --git a/src/_imaging.c b/src/_imaging.c
index 8ec9b14cd6c..ac0317f781f 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -254,6 +254,9 @@ void
 ReleaseArrowSchemaPyCapsule(PyObject *capsule) {
     struct ArrowSchema *schema =
         (struct ArrowSchema *)PyCapsule_GetPointer(capsule, "arrow_schema");
+    if (!schema) {
+        return;
+    }
     if (schema->release != NULL) {
         schema->release(schema);
     }
@@ -276,6 +279,9 @@ void
 ReleaseArrowArrayPyCapsule(PyObject *capsule) {
     struct ArrowArray *array =
         (struct ArrowArray *)PyCapsule_GetPointer(capsule, "arrow_array");
+    if (!array) {
+        return;
+    }
     if (array->release != NULL) {
         array->release(array);
     }
diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index 7b4fb00a470..469be05f4a3 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -558,7 +558,13 @@ cms_transform_apply(CmsTransformObject *self, PyObject *args) {
     }
 
     im = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!im) {
+        return NULL;
+    }
     imOut = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
+    if (!imOut) {
+        return NULL;
+    }
 
     return Py_BuildValue("i", pyCMSdoTransform(im, imOut, self->transform));
 }
diff --git a/src/_imagingft.c b/src/_imagingft.c
index 1ac9d95ee38..5d91eaad6c3 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -948,6 +948,11 @@ font_render(FontObject *self, PyObject *args) {
     }
     im = (Imaging)PyCapsule_GetPointer(imagePtr, IMAGING_MAGIC);
     Py_DECREF(imagePtr);
+    if (!im) {
+        PyMem_Del(glyph_info);
+        Py_DECREF(image);
+        return NULL;
+    }
 
     x_offset = round(x_offset - stroke_width);
     y_offset = round(y_offset - stroke_width);
diff --git a/src/_imagingmath.c b/src/_imagingmath.c
index 48c3959003e..c04361468ed 100644
--- a/src/_imagingmath.c
+++ b/src/_imagingmath.c
@@ -187,8 +187,17 @@ _unop(PyObject *self, PyObject *args) {
     }
 
     unop = (void *)PyCapsule_GetPointer(op, MATH_FUNC_UNOP_MAGIC);
+    if (!unop) {
+        return NULL;
+    }
     out = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!out) {
+        return NULL;
+    }
     im1 = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
+    if (!im1) {
+        return NULL;
+    }
 
     unop(out, im1);
 
@@ -219,9 +228,21 @@ _binop(PyObject *self, PyObject *args) {
     }
 
     binop = (void *)PyCapsule_GetPointer(op, MATH_FUNC_BINOP_MAGIC);
+    if (!binop) {
+        return NULL;
+    }
     out = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!out) {
+        return NULL;
+    }
     im1 = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
+    if (!im1) {
+        return NULL;
+    }
     im2 = (Imaging)PyCapsule_GetPointer(i2, IMAGING_MAGIC);
+    if (!im2) {
+        return NULL;
+    }
 
     binop(out, im1, im2);
 
diff --git a/src/_imagingmorph.c b/src/_imagingmorph.c
index c1b772760fa..b6f307c849e 100644
--- a/src/_imagingmorph.c
+++ b/src/_imagingmorph.c
@@ -53,7 +53,13 @@ apply(PyObject *self, PyObject *args) {
     }
 
     imgin = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!imgin) {
+        return NULL;
+    }
     imgout = (Imaging)PyCapsule_GetPointer(i1, IMAGING_MAGIC);
+    if (!imgout) {
+        return NULL;
+    }
     width = imgin->xsize;
     height = imgin->ysize;
 
@@ -223,6 +229,9 @@ get_on_pixels(PyObject *self, PyObject *args) {
     }
 
     img = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!img) {
+        return NULL;
+    }
     rows = img->image8;
     width = img->xsize;
     height = img->ysize;
diff --git a/src/_webp.c b/src/_webp.c
index a936e13d8c4..115141273f5 100644
--- a/src/_webp.c
+++ b/src/_webp.c
@@ -262,6 +262,9 @@ _anim_encoder_add(PyObject *self, PyObject *args) {
     }
 
     im = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!im) {
+        return NULL;
+    }
 
     // Setup config for this frame
     if (!WebPConfigInit(&config)) {
@@ -610,6 +613,9 @@ WebPEncode_wrapper(PyObject *self, PyObject *args) {
     }
 
     im = (Imaging)PyCapsule_GetPointer(i0, IMAGING_MAGIC);
+    if (!im) {
+        return NULL;
+    }
 
     // Setup config for this frame
     if (!WebPConfigInit(&config)) {
diff --git a/src/libImaging/Storage.c b/src/libImaging/Storage.c
index c09062c92e5..c8175612e35 100644
--- a/src/libImaging/Storage.c
+++ b/src/libImaging/Storage.c
@@ -677,9 +677,15 @@ ImagingNewArrow(
     Imaging im;
     struct ArrowSchema *schema =
         (struct ArrowSchema *)PyCapsule_GetPointer(schema_capsule, "arrow_schema");
+    if (!schema) {
+        return NULL;
+    }
 
     struct ArrowArray *external_array =
         (struct ArrowArray *)PyCapsule_GetPointer(array_capsule, "arrow_array");
+    if (!external_array) {
+        return NULL;
+    }
 
     if (xsize < 0 || ysize < 0) {
         return (Imaging)ImagingError_ValueError("bad image size");

From 20a9401971c46961f49091979b7c65dac0fae202 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Thu, 26 Mar 2026 21:21:22 +1100
Subject: [PATCH 2332/2374] Check PyBytes_FromStringAndSize return value

---
 src/display.c             | 3 +++
 src/libImaging/codec_fd.c | 3 +++
 2 files changed, 6 insertions(+)

diff --git a/src/display.c b/src/display.c
index 5b5853a3cb8..944c60b704a 100644
--- a/src/display.c
+++ b/src/display.c
@@ -480,6 +480,9 @@ PyImaging_GrabClipboardWin32(PyObject *self, PyObject *args) {
     GlobalUnlock(handle);
     CloseClipboard();
 
+    if (!result) {
+        return NULL;
+    }
     return Py_BuildValue("zN", format_names[format], result);
 }
 
diff --git a/src/libImaging/codec_fd.c b/src/libImaging/codec_fd.c
index dc85772983c..c5614e6039b 100644
--- a/src/libImaging/codec_fd.c
+++ b/src/libImaging/codec_fd.c
@@ -41,6 +41,9 @@ _imaging_write_pyFd(PyObject *fd, char *src, Py_ssize_t bytes) {
     PyObject *byteObj;
 
     byteObj = PyBytes_FromStringAndSize(src, bytes);
+    if (!byteObj) {
+        return -1;
+    }
     result = PyObject_CallMethod(fd, "write", "O", byteObj);
 
     Py_DECREF(byteObj);

From 27de86483d8c23d9375b071993c04c2ff8388ca3 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 21:54:45 +1100
Subject: [PATCH 2333/2374] Switch iOS back to macos-15-intel

---
 .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 ed49f15c0b8..af2f9b3e825 100644
--- a/.github/workflows/wheels.yml
+++ b/.github/workflows/wheels.yml
@@ -104,7 +104,7 @@ jobs:
             cibw_arch: arm64_iphonesimulator
           - name: "iOS x86_64 simulator"
             platform: ios
-            os: macos-26-intel
+            os: macos-15-intel
             cibw_arch: x86_64_iphonesimulator
     steps:
       - uses: actions/checkout@v6

From b337b33564da0b21d244b46c2b3e954ae6afc099 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 26 Mar 2026 17:45:59 +0200
Subject: [PATCH 2334/2374] PERF101

---
 pyproject.toml | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 6d9910ca140..4190f091ad0 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -139,21 +139,22 @@ exclude = "wheels/multibuild"
 exclude = [ "wheels/multibuild" ]
 fix = true
 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
-  "PIE",    # flake8-pie
-  "PT",     # flake8-pytest-style
-  "PYI",    # flake8-pyi
-  "RUF100", # unused noqa (yesqa)
-  "UP",     # pyupgrade
-  "W",      # pycodestyle warnings
-  "YTT",    # flake8-2020
+  "C4",      # flake8-comprehensions
+  "E",       # pycodestyle errors
+  "EM",      # flake8-errmsg
+  "F",       # pyflakes errors
+  "I",       # isort
+  "ISC",     # flake8-implicit-str-concat
+  "LOG",     # flake8-logging
+  "PERF101", # perflint: unnecessary-list-cast
+  "PGH",     # pygrep-hooks
+  "PIE",     # flake8-pie
+  "PT",      # flake8-pytest-style
+  "PYI",     # flake8-pyi
+  "RUF100",  # unused noqa (yesqa)
+  "UP",      # pyupgrade
+  "W",       # pycodestyle warnings
+  "YTT",     # flake8-2020
 ]
 lint.ignore = [
   "E203",   # Whitespace before ':'

From 624fc87d2d91f9bd763f3cd721f999f58a6752bb Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 26 Mar 2026 17:46:16 +0200
Subject: [PATCH 2335/2374] PERF102

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

diff --git a/pyproject.toml b/pyproject.toml
index 4190f091ad0..7178cb2deca 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -147,6 +147,7 @@ lint.select = [
   "ISC",     # flake8-implicit-str-concat
   "LOG",     # flake8-logging
   "PERF101", # perflint: unnecessary-list-cast
+  "PERF102", # perflint: incorrect-dict-iterator
   "PGH",     # pygrep-hooks
   "PIE",     # flake8-pie
   "PT",      # flake8-pytest-style

From b85b8534d7ca1132cfe4067ae2963c26f07b7811 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 26 Mar 2026 18:11:12 +0200
Subject: [PATCH 2336/2374] PERF401 and fixes

---
 pyproject.toml             | 1 +
 setup.py                   | 8 ++++----
 src/PIL/IcnsImagePlugin.py | 3 +--
 src/PIL/ImageDraw.py       | 4 +---
 src/PIL/ImageFile.py       | 6 ++++--
 winbuild/build_prepare.py  | 6 +++---
 6 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 7178cb2deca..ea43e9cb1cc 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -148,6 +148,7 @@ lint.select = [
   "LOG",     # flake8-logging
   "PERF101", # perflint: unnecessary-list-cast
   "PERF102", # perflint: incorrect-dict-iterator
+  "PERF401", # perflint: manual-list-comprehension
   "PGH",     # pygrep-hooks
   "PIE",     # flake8-pie
   "PT",      # flake8-pytest-style
diff --git a/setup.py b/setup.py
index 3d975950b6c..175aed25a02 100644
--- a/setup.py
+++ b/setup.py
@@ -1078,10 +1078,10 @@ def debug_build() -> bool:
 ]
 
 files: list[str | os.PathLike[str]] = ["src/_imaging.c"]
-for src_file in _IMAGING:
-    files.append("src/" + src_file + ".c")
-for src_file in _LIB_IMAGING:
-    files.append(os.path.join("src/libImaging", src_file + ".c"))
+files.extend("src/" + src_file + ".c" for src_file in _IMAGING)
+files.extend(
+    os.path.join("src/libImaging", src_file + ".c") for src_file in _LIB_IMAGING
+)
 ext_modules = [
     Extension("PIL._imaging", files),
     Extension("PIL._imagingft", ["src/_imagingft.c"]),
diff --git a/src/PIL/IcnsImagePlugin.py b/src/PIL/IcnsImagePlugin.py
index 023835fb71e..cb7a74c2e3b 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -80,8 +80,7 @@ def read_32(
                 if byte_int & 0x80:
                     blocksize = byte_int - 125
                     byte = fobj.read(1)
-                    for i in range(blocksize):
-                        data.append(byte)
+                    data.extend([byte] * blocksize)
                 else:
                     blocksize = byte_int + 1
                     data.append(fobj.read(blocksize))
diff --git a/src/PIL/ImageDraw.py b/src/PIL/ImageDraw.py
index eb108ac41ca..506bb3b43b0 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -597,9 +597,7 @@ def draw_text(ink: int, stroke_width: float = 0) -> None:
                 mode = self.fontmode
                 if stroke_width == 0 and embedded_color:
                     mode = "RGBA"
-                coord = []
-                for i in range(2):
-                    coord.append(int(xy[i]))
+                coord = [int(xy[i]) for i in range(2)]
                 start = (math.modf(xy[0])[0], math.modf(xy[1])[0])
                 try:
                     mask, offset = image_text.font.getmask2(  # type: ignore[union-attr,misc]
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 50e0075a29d..df2a82b7366 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -215,8 +215,10 @@ def get_child_images(self) -> list[ImageFile]:
             if subifd_offsets:
                 if not isinstance(subifd_offsets, tuple):
                     subifd_offsets = (subifd_offsets,)
-                for subifd_offset in subifd_offsets:
-                    ifds.append((exif._get_ifd_dict(subifd_offset), subifd_offset))
+                ifds = [
+                    (exif._get_ifd_dict(subifd_offset), subifd_offset)
+                    for subifd_offset in subifd_offsets
+                ]
         ifd1 = exif.get_ifd(ExifTags.IFD.IFD1)
         if ifd1 and ifd1.get(ExifTags.Base.JpegIFOffset):
             assert exif._info is not None
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index d958a459277..1438827cabb 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -544,11 +544,11 @@ def write_script(
 def get_footer(dep: dict[str, Any]) -> list[str]:
     lines = []
     for out in dep.get("headers", []):
-        lines.append(cmd_copy(out, "{inc_dir}"))
+        lines.append(cmd_copy(out, "{inc_dir}"))  # noqa: PERF401
     for out in dep.get("libs", []):
-        lines.append(cmd_copy(out, "{lib_dir}"))
+        lines.append(cmd_copy(out, "{lib_dir}"))  # noqa: PERF401
     for out in dep.get("bins", []):
-        lines.append(cmd_copy(out, "{bin_dir}"))
+        lines.append(cmd_copy(out, "{bin_dir}"))  # noqa: PERF401
     return lines
 
 

From 9a358fa289e87b849d08ead61a6dccabf5961121 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 26 Mar 2026 18:12:32 +0200
Subject: [PATCH 2337/2374] PERF402 and fixes

---
 Tests/test_file_container.py | 4 +---
 pyproject.toml               | 1 +
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/Tests/test_file_container.py b/Tests/test_file_container.py
index 597ab508342..c73f2a40cba 100644
--- a/Tests/test_file_container.py
+++ b/Tests/test_file_container.py
@@ -179,9 +179,7 @@ def test_iter(bytesmode: bool) -> None:
         container = ContainerIO.ContainerIO(fh, 0, 120)
 
         # Act
-        data = []
-        for line in container:
-            data.append(line)
+        data = list(container)
 
         # Assert
         if bytesmode:
diff --git a/pyproject.toml b/pyproject.toml
index ea43e9cb1cc..149dbbac5dd 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -149,6 +149,7 @@ lint.select = [
   "PERF101", # perflint: unnecessary-list-cast
   "PERF102", # perflint: incorrect-dict-iterator
   "PERF401", # perflint: manual-list-comprehension
+  "PERF402", # perflint: manual-list-copy
   "PGH",     # pygrep-hooks
   "PIE",     # flake8-pie
   "PT",      # flake8-pytest-style

From 090ca9461b1ce0e0f91644f6cc7a1d1416e7b915 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 26 Mar 2026 18:20:06 +0200
Subject: [PATCH 2338/2374] PERF403 and fixes

---
 pyproject.toml             |  1 +
 src/PIL/IptcImagePlugin.py | 11 ++---------
 2 files changed, 3 insertions(+), 9 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 149dbbac5dd..bda99c3bf43 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -150,6 +150,7 @@ lint.select = [
   "PERF102", # perflint: incorrect-dict-iterator
   "PERF401", # perflint: manual-list-comprehension
   "PERF402", # perflint: manual-list-copy
+  "PERF403", # perflint: manual-dict-comprehension
   "PGH",     # pygrep-hooks
   "PIE",     # flake8-pie
   "PT",      # flake8-pytest-style
diff --git a/src/PIL/IptcImagePlugin.py b/src/PIL/IptcImagePlugin.py
index 6fc824e4caa..9c8be8b4e36 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -185,13 +185,9 @@ def getiptcinfo(
 
     data = None
 
-    info: dict[tuple[int, int], bytes | list[bytes]] = {}
     if isinstance(im, IptcImageFile):
         # return info dictionary right away
-        for k, v in im.info.items():
-            if isinstance(k, tuple):
-                info[k] = v
-        return info
+        return {k: v for k, v in im.info.items() if isinstance(k, tuple)}
 
     elif isinstance(im, JpegImagePlugin.JpegImageFile):
         # extract the IPTC/NAA resource
@@ -227,7 +223,4 @@ class FakeImage:
     except (IndexError, KeyError):
         pass  # expected failure
 
-    for k, v in iptc_im.info.items():
-        if isinstance(k, tuple):
-            info[k] = v
-    return info
+    return {k: v for k, v in iptc_im.info.items() if isinstance(k, tuple)}

From 754c7ea3a0aa47429809a1675f249263de3eac7b Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Thu, 26 Mar 2026 18:28:11 +0200
Subject: [PATCH 2339/2374] PERF203 and fixes

---
 Tests/test_bmp_reference.py |  4 ++--
 Tests/test_file_libtiff.py  |  5 +----
 pyproject.toml              | 36 ++++++++++++++++--------------------
 setup.py                    |  2 +-
 src/PIL/GifImagePlugin.py   |  2 +-
 src/PIL/Image.py            |  2 +-
 src/PIL/ImageFont.py        |  2 +-
 src/PIL/ImagePalette.py     |  6 ++----
 src/PIL/JpegImagePlugin.py  |  4 ++--
 src/PIL/PcfFontFile.py      |  2 +-
 src/PIL/PngImagePlugin.py   |  2 +-
 11 files changed, 29 insertions(+), 38 deletions(-)

diff --git a/Tests/test_bmp_reference.py b/Tests/test_bmp_reference.py
index 8fbd737484d..ea0853100cc 100644
--- a/Tests/test_bmp_reference.py
+++ b/Tests/test_bmp_reference.py
@@ -56,7 +56,7 @@ def test_questionable() -> None:
                 im.load()
             if os.path.basename(f) not in supported:
                 print(f"Please add {f} to the partially supported bmp specs.")
-        except Exception:  # as msg:
+        except Exception:  # noqa: PERF203
             if os.path.basename(f) in supported:
                 raise
 
@@ -106,7 +106,7 @@ def get_compare(f: str) -> str:
 
                     assert_image_similar(im_converted, compare_converted, 5)
 
-        except Exception as msg:
+        except Exception as msg:  # noqa: PERF203
             # there are three here that are unsupported:
             unsupported = (
                 os.path.join(base, "g", "rgb32bf.bmp"),
diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index b453e3aa5c5..6f20900e490 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -224,10 +224,7 @@ def test_additional_metadata(
         with Image.open("Tests/images/hopper_g4.tif") as im:
             assert isinstance(im, TiffImagePlugin.TiffImageFile)
             for tag in im.tag_v2:
-                try:
-                    del core_items[tag]
-                except KeyError:
-                    pass
+                core_items.pop(tag, None)
             del core_items[320]  # colormap is special, tested below
 
             # Type codes:
diff --git a/pyproject.toml b/pyproject.toml
index bda99c3bf43..7eb9a3fbdde 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -139,26 +139,22 @@ exclude = "wheels/multibuild"
 exclude = [ "wheels/multibuild" ]
 fix = true
 lint.select = [
-  "C4",      # flake8-comprehensions
-  "E",       # pycodestyle errors
-  "EM",      # flake8-errmsg
-  "F",       # pyflakes errors
-  "I",       # isort
-  "ISC",     # flake8-implicit-str-concat
-  "LOG",     # flake8-logging
-  "PERF101", # perflint: unnecessary-list-cast
-  "PERF102", # perflint: incorrect-dict-iterator
-  "PERF401", # perflint: manual-list-comprehension
-  "PERF402", # perflint: manual-list-copy
-  "PERF403", # perflint: manual-dict-comprehension
-  "PGH",     # pygrep-hooks
-  "PIE",     # flake8-pie
-  "PT",      # flake8-pytest-style
-  "PYI",     # flake8-pyi
-  "RUF100",  # unused noqa (yesqa)
-  "UP",      # pyupgrade
-  "W",       # pycodestyle warnings
-  "YTT",     # flake8-2020
+  "C4",     # flake8-comprehensions
+  "E",      # pycodestyle errors
+  "EM",     # flake8-errmsg
+  "F",      # pyflakes errors
+  "I",      # isort
+  "ISC",    # flake8-implicit-str-concat
+  "LOG",    # flake8-logging
+  "PERF",   # perflint
+  "PGH",    # pygrep-hooks
+  "PIE",    # flake8-pie
+  "PT",     # flake8-pytest-style
+  "PYI",    # flake8-pyi
+  "RUF100", # unused noqa (yesqa)
+  "UP",     # pyupgrade
+  "W",      # pycodestyle warnings
+  "YTT",    # flake8-2020
 ]
 lint.ignore = [
   "E203",   # Whitespace before ':'
diff --git a/setup.py b/setup.py
index 175aed25a02..496c8cb1f0e 100644
--- a/setup.py
+++ b/setup.py
@@ -302,7 +302,7 @@ def _pkg_config(name: str) -> tuple[list[str], list[str]] | None:
                 subprocess.check_output(command_cflags).decode("utf8").strip(),
             )[::2][1:]
             return libs, cflags
-        except Exception:
+        except Exception:  # noqa: PERF203
             pass
     return None
 
diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 390b3b374ab..1ffb18b9c8f 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -167,7 +167,7 @@ def seek(self, frame: int) -> None:
         for f in range(self.__frame + 1, frame + 1):
             try:
                 self._seek(f)
-            except EOFError as e:
+            except EOFError as e:  # noqa: PERF203
                 self.seek(last_frame)
                 msg = "no more images in GIF file"
                 raise EOFError(msg) from e
diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index bde335504e8..6062857da06 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -488,7 +488,7 @@ def init() -> bool:
         try:
             logger.debug("Importing %s", plugin)
             __import__(f"{__spec__.parent}.{plugin}", globals(), locals(), [])
-        except ImportError as e:
+        except ImportError as e:  # noqa: PERF203
             logger.debug("Image: failed to import %s: %s", plugin, e)
 
     if OPEN or SAVE:
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index ea7f4dc5477..ec7c7cb0813 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -930,7 +930,7 @@ def load_path(filename: str | bytes) -> ImageFont:
     for directory in sys.path:
         try:
             return load(os.path.join(directory, filename))
-        except OSError:
+        except OSError:  # noqa: PERF203
             pass
     msg = f'cannot find font file "{filename}" in sys.path'
     if os.path.exists(filename):
diff --git a/src/PIL/ImagePalette.py b/src/PIL/ImagePalette.py
index 99ad2771b4b..2abbd46eaf1 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -198,13 +198,11 @@ def save(self, fp: str | IO[str]) -> None:
         try:
             fp.write("# Palette\n")
             fp.write(f"# Mode: {self.mode}\n")
+            palette_len = len(self.palette)
             for i in range(256):
                 fp.write(f"{i}")
                 for j in range(i * len(self.mode), (i + 1) * len(self.mode)):
-                    try:
-                        fp.write(f" {self.palette[j]}")
-                    except IndexError:
-                        fp.write(" 0")
+                    fp.write(f" {self.palette[j] if j < palette_len else 0}")
                 fp.write("\n")
         finally:
             if open_fp:
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index 2f11cbfe313..d5b67bba56c 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -153,7 +153,7 @@ def APP(self: JpegImageFile, marker: int) -> None:
                     photoshop[code] = data
                 offset += size
                 offset += offset & 1  # align
-            except struct.error:
+            except struct.error:  # noqa: PERF203
                 break  # insufficient data
 
     elif marker == 0xFFEE and s.startswith(b"Adobe"):
@@ -744,7 +744,7 @@ def validate_qtables(
                         msg = "Invalid quantization table"
                         raise TypeError(msg)
                     table_array = array.array("H", table)
-                except TypeError as e:
+                except TypeError as e:  # noqa: PERF203
                     msg = "Invalid quantization table"
                     raise ValueError(msg) from e
                 else:
diff --git a/src/PIL/PcfFontFile.py b/src/PIL/PcfFontFile.py
index a00e9b91984..b923293b06a 100644
--- a/src/PIL/PcfFontFile.py
+++ b/src/PIL/PcfFontFile.py
@@ -251,7 +251,7 @@ def _load_encoding(self) -> list[int | None]:
                 ]
                 if encoding_offset != 0xFFFF:
                     encoding[i] = encoding_offset
-            except UnicodeDecodeError:
+            except UnicodeDecodeError:  # noqa: PERF203
                 # character is not supported in selected encoding
                 pass
 
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index 4e082a293ff..d58426c5511 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -869,7 +869,7 @@ def seek(self, frame: int) -> None:
         for f in range(self.__frame + 1, frame + 1):
             try:
                 self._seek(f)
-            except EOFError as e:
+            except EOFError as e:  # noqa: PERF203
                 self.seek(last_frame)
                 msg = "no more images in APNG file"
                 raise EOFError(msg) from e

From 65c4f4ea8dc3ff6eaf663d85296ee9fdd71dbd0a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Mar 2026 13:19:27 +1100
Subject: [PATCH 2340/2374] Updated libjpeg-turbo to 3.1.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 107eeae9b95..97011f4a00f 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -93,7 +93,7 @@ ARCHIVE_SDIR=pillow-depends-main
 FREETYPE_VERSION=2.14.3
 HARFBUZZ_VERSION=13.2.1
 LIBPNG_VERSION=1.6.56
-JPEGTURBO_VERSION=3.1.3
+JPEGTURBO_VERSION=3.1.4.1
 OPENJPEG_VERSION=2.5.4
 XZ_VERSION=5.8.2
 ZSTD_VERSION=1.5.7
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index d958a459277..300cbf149f9 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ def cmd_msbuild(
     "FREETYPE": "2.14.3",
     "FRIBIDI": "1.0.16",
     "HARFBUZZ": "13.2.1",
-    "JPEGTURBO": "3.1.3",
+    "JPEGTURBO": "3.1.4.1",
     "LCMS2": "2.18",
     "LIBAVIF": "1.4.1",
     "LIBIMAGEQUANT": "4.4.1",

From 018801805f496245d3c3d85512809d8c0013b6fd Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Fri, 27 Mar 2026 23:03:51 +1100
Subject: [PATCH 2341/2374] Simplify setimage()

---
 src/PIL/ImageFile.py | 7 ++-----
 1 file changed, 2 insertions(+), 5 deletions(-)

diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index 50e0075a29d..5275496e827 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -799,16 +799,13 @@ def setimage(
 
         if extents:
             x0, y0, x1, y1 = extents
-        else:
-            x0, y0, x1, y1 = (0, 0, 0, 0)
 
-        if x0 == 0 and x1 == 0:
-            self.state.xsize, self.state.ysize = self.im.size
-        else:
             self.state.xoff = x0
             self.state.yoff = y0
             self.state.xsize = x1 - x0
             self.state.ysize = y1 - y0
+        else:
+            self.state.xsize, self.state.ysize = self.im.size
 
         if self.state.xsize <= 0 or self.state.ysize <= 0:
             msg = "Size must be positive"

From 9a7b91e5dbb6630ea4e3d5d6eccbf48f4463eda4 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Mar 2026 15:11:04 +1100
Subject: [PATCH 2342/2374] PERF203 fixes

---
 src/PIL/GifImagePlugin.py  | 12 ++++++------
 src/PIL/JpegImagePlugin.py | 22 ++++++++++------------
 src/PIL/PngImagePlugin.py  | 12 ++++++------
 3 files changed, 22 insertions(+), 24 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index 1ffb18b9c8f..b8db5d83284 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -164,13 +164,13 @@ def seek(self, frame: int) -> None:
             self._seek(0)
 
         last_frame = self.__frame
-        for f in range(self.__frame + 1, frame + 1):
-            try:
+        try:
+            for f in range(self.__frame + 1, frame + 1):
                 self._seek(f)
-            except EOFError as e:  # noqa: PERF203
-                self.seek(last_frame)
-                msg = "no more images in GIF file"
-                raise EOFError(msg) from e
+        except EOFError as e:
+            self.seek(last_frame)
+            msg = "no more images in GIF file"
+            raise EOFError(msg) from e
 
     def _seek(self, frame: int, update_image: bool = True) -> None:
         if isinstance(self._fp, DeferredError):
diff --git a/src/PIL/JpegImagePlugin.py b/src/PIL/JpegImagePlugin.py
index d5b67bba56c..46320eb3b5b 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -127,8 +127,8 @@ def APP(self: JpegImageFile, marker: int) -> None:
         # parse the image resource block
         offset = 14
         photoshop = self.info.setdefault("photoshop", {})
-        while s[offset : offset + 4] == b"8BIM":
-            try:
+        try:
+            while s[offset : offset + 4] == b"8BIM":
                 offset += 4
                 # resource code
                 code = i16(s, offset)
@@ -153,8 +153,8 @@ def APP(self: JpegImageFile, marker: int) -> None:
                     photoshop[code] = data
                 offset += size
                 offset += offset & 1  # align
-            except struct.error:  # noqa: PERF203
-                break  # insufficient data
+        except struct.error:
+            pass  # insufficient data
 
     elif marker == 0xFFEE and s.startswith(b"Adobe"):
         self.info["adobe"] = i16(s, 5)
@@ -738,17 +738,15 @@ def validate_qtables(
             if not (0 < len(qtables) < 5):
                 msg = "None or too many quantization tables"
                 raise ValueError(msg)
-            for idx, table in enumerate(qtables):
-                try:
+            try:
+                for idx, table in enumerate(qtables):
                     if len(table) != 64:
                         msg = "Invalid quantization table"
                         raise TypeError(msg)
-                    table_array = array.array("H", table)
-                except TypeError as e:  # noqa: PERF203
-                    msg = "Invalid quantization table"
-                    raise ValueError(msg) from e
-                else:
-                    qtables[idx] = list(table_array)
+                    qtables[idx] = list(array.array("H", table))
+            except TypeError as e:
+                msg = "Invalid quantization table"
+                raise ValueError(msg) from e
             return qtables
 
     if qtables == "keep":
diff --git a/src/PIL/PngImagePlugin.py b/src/PIL/PngImagePlugin.py
index d58426c5511..76a15bd0dc6 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -866,13 +866,13 @@ def seek(self, frame: int) -> None:
             self._seek(0, True)
 
         last_frame = self.__frame
-        for f in range(self.__frame + 1, frame + 1):
-            try:
+        try:
+            for f in range(self.__frame + 1, frame + 1):
                 self._seek(f)
-            except EOFError as e:  # noqa: PERF203
-                self.seek(last_frame)
-                msg = "no more images in APNG file"
-                raise EOFError(msg) from e
+        except EOFError as e:
+            self.seek(last_frame)
+            msg = "no more images in APNG file"
+            raise EOFError(msg) from e
 
     def _seek(self, frame: int, rewind: bool = False) -> None:
         assert self.png is not None

From 701b49adc5d3f64dfb9eb2c42f0411b3d8490fef Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Mar 2026 15:13:26 +1100
Subject: [PATCH 2343/2374] PERF401 fix

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

diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index 1438827cabb..466cca17696 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -542,14 +542,11 @@ def write_script(
 
 
 def get_footer(dep: dict[str, Any]) -> list[str]:
-    lines = []
-    for out in dep.get("headers", []):
-        lines.append(cmd_copy(out, "{inc_dir}"))  # noqa: PERF401
-    for out in dep.get("libs", []):
-        lines.append(cmd_copy(out, "{lib_dir}"))  # noqa: PERF401
-    for out in dep.get("bins", []):
-        lines.append(cmd_copy(out, "{bin_dir}"))  # noqa: PERF401
-    return lines
+    return (
+        [cmd_copy(out, "{inc_dir}") for out in dep.get("headers", [])]
+        + [cmd_copy(out, "{lib_dir}") for out in dep.get("libs", [])]
+        + [cmd_copy(out, "{bin_dir}") for out in dep.get("bins", [])]
+    )
 
 
 def build_env(prefs: dict[str, str], verbose: bool) -> None:

From 9f3f6de10982f46b3864adb6533326c87be6ab14 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Mar 2026 18:31:49 +1100
Subject: [PATCH 2344/2374] Allow None extents in C setimage

---
 Tests/test_imagefile.py | 21 +++++++++++++++++++++
 src/decode.c            | 35 +++++++++++++++++++++++++++++++----
 src/encode.c            | 37 +++++++++++++++++++++++++++++++------
 3 files changed, 83 insertions(+), 10 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 6656ee506ca..6cb0d36a3f8 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -170,6 +170,27 @@ def test_negative_tile_extents(self, xy: tuple[int, int]) -> None:
         with pytest.raises(SystemError, match="tile cannot extend outside image"):
             ImageFile._save(im, fp, [ImageFile._Tile("raw", xy + (1, 1), 0, "1")])
 
+    def test_extents_none(self) -> None:
+        with Image.open("Tests/images/hopper.jpg") as im:
+            im.tile = [im.tile[0]._replace(extents=None)]
+            im.load()
+
+        for extents in ("invalid", (0,), ("0", "0", "0", "0")):
+            with Image.open("Tests/images/hopper.jpg") as im:
+                im.tile = [im.tile[0]._replace(extents=extents)]  # type: ignore[arg-type]
+                with pytest.raises(ValueError, match="invalid extents"):
+                    im.load()
+
+        im2 = Image.new("L", (1, 1))
+        fp = BytesIO()
+        tile = ImageFile._Tile("jpeg", None, 0, "L")
+        ImageFile._save(im2, fp, [tile])
+
+        for extents in ("invalid", (0,), ("0", "0", "0", "0")):
+            tile = tile._replace(extents=extents)  # type: ignore[arg-type]
+            with pytest.raises(ValueError, match="invalid extents"):
+                ImageFile._save(im2, fp, [tile])
+
     def test_no_format(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
diff --git a/src/decode.c b/src/decode.c
index cda4ce7027f..71f8d73d29a 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -155,21 +155,48 @@ PyImaging_AsImaging(PyObject *op);
 
 static PyObject *
 _setimage(ImagingDecoderObject *decoder, PyObject *args) {
-    PyObject *op;
+    PyObject *op, *extents;
     Imaging im;
     ImagingCodecState state;
     int x0, y0, x1, y1;
 
-    x0 = y0 = x1 = y1 = 0;
-
     /* FIXME: should publish the ImagingType descriptor */
-    if (!PyArg_ParseTuple(args, "O(iiii)", &op, &x0, &y0, &x1, &y1)) {
+    if (!PyArg_ParseTuple(args, "OO", &op, &extents)) {
         return NULL;
     }
     im = PyImaging_AsImaging(op);
     if (!im) {
         return NULL;
     }
+    if (extents == Py_None) {
+        x0 = 0;
+        y0 = 0;
+        x1 = im->xsize;
+        y1 = im->ysize;
+    } else {
+        if (!PyTuple_Check(extents) || PyTuple_GET_SIZE(extents) != 4) {
+            PyErr_SetString(PyExc_ValueError, "invalid extents");
+            return NULL;
+        }
+        for (int i = 0; i < 4; i++) {
+            PyObject *extent = PyTuple_GetItem(extents, i);
+            if (!PyLong_Check(extent)) {
+                PyErr_SetString(PyExc_ValueError, "invalid extents");
+                return NULL;
+            }
+            int e = (int)PyLong_AsLong(extent);
+
+            if (i == 0) {
+                x0 = e;
+            } else if (i == 1) {
+                y0 = e;
+            } else if (i == 2) {
+                x1 = e;
+            } else {
+                y1 = e;
+            }
+        }
+    }
 
     decoder->im = im;
 
diff --git a/src/encode.c b/src/encode.c
index 1fc31404d9e..26b744935d3 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -222,23 +222,48 @@ PyImaging_AsImaging(PyObject *op);
 
 static PyObject *
 _setimage(ImagingEncoderObject *encoder, PyObject *args) {
-    PyObject *op;
+    PyObject *op, *extents;
     Imaging im;
     ImagingCodecState state;
     Py_ssize_t x0, y0, x1, y1;
 
-    /* Define where image data should be stored */
-
-    x0 = y0 = x1 = y1 = 0;
-
     /* FIXME: should publish the ImagingType descriptor */
-    if (!PyArg_ParseTuple(args, "O(nnnn)", &op, &x0, &y0, &x1, &y1)) {
+    if (!PyArg_ParseTuple(args, "OO", &op, &extents)) {
         return NULL;
     }
     im = PyImaging_AsImaging(op);
     if (!im) {
         return NULL;
     }
+    if (extents == Py_None) {
+        x0 = 0;
+        y0 = 0;
+        x1 = im->xsize;
+        y1 = im->ysize;
+    } else {
+        if (!PyTuple_Check(extents) || PyTuple_GET_SIZE(extents) != 4) {
+            PyErr_SetString(PyExc_ValueError, "invalid extents");
+            return NULL;
+        }
+        for (int i = 0; i < 4; i++) {
+            PyObject *extent = PyTuple_GetItem(extents, i);
+            if (!PyLong_Check(extent)) {
+                PyErr_SetString(PyExc_ValueError, "invalid extents");
+                return NULL;
+            }
+            Py_ssize_t e = (Py_ssize_t)PyLong_AsLong(extent);
+
+            if (i == 0) {
+                x0 = e;
+            } else if (i == 1) {
+                y0 = e;
+            } else if (i == 2) {
+                x1 = e;
+            } else {
+                y1 = e;
+            }
+        }
+    }
     if (im->xsize == 0 || im->ysize == 0) {
         PyErr_SetString(PyExc_ValueError, "cannot write empty image");
         return NULL;

From 1ed39726c57cd2d094f9a9a90be08814678f6190 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Mar 2026 13:23:30 +1100
Subject: [PATCH 2345/2374] Added release notes for #9419

---
 docs/releasenotes/12.2.0.rst | 63 ++++++++++++++++++++++++++++++++++++
 docs/releasenotes/index.rst  |  1 +
 2 files changed, 64 insertions(+)
 create mode 100644 docs/releasenotes/12.2.0.rst

diff --git a/docs/releasenotes/12.2.0.rst b/docs/releasenotes/12.2.0.rst
new file mode 100644
index 00000000000..aa1206cd09a
--- /dev/null
+++ b/docs/releasenotes/12.2.0.rst
@@ -0,0 +1,63 @@
+12.2.0
+------
+
+Security
+========
+
+TODO
+^^^^
+
+TODO
+
+:cve:`YYYY-XXXXX`: TODO
+^^^^^^^^^^^^^^^^^^^^^^^
+
+TODO
+
+Backwards incompatible changes
+==============================
+
+TODO
+^^^^
+
+TODO
+
+Deprecations
+============
+
+TODO
+^^^^
+
+TODO
+
+API changes
+===========
+
+TODO
+^^^^
+
+TODO
+
+API additions
+=============
+
+FontFile.to_imagefont()
+^^^^^^^^^^^^^^^^^^^^^^^
+
+:py:class:`~PIL.FontFile.FontFile` instances can now be directly converted to
+:py:class:`~PIL.ImageFont.ImageFont` instances::
+
+    >>> from PIL import PcfFontFile
+    >>> with open("Tests/fonts/10x20-ISO8859-1.pcf", "rb") as fp:
+    ...   pcffont = PcfFontFile.PcfFontFile(fp)
+    ...   pcffont.to_imagefont()
+    ...
+    <PIL.ImageFont.ImageFont object at 0x10457bb80>
+
+Other changes
+=============
+
+TODO
+^^^^
+
+TODO
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index 690be20729e..07687297933 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -15,6 +15,7 @@ expected to be backported to earlier versions.
   :maxdepth: 2
 
   versioning
+  12.2.0
   12.1.1
   12.1.0
   12.0.0

From ccf9863ba8595b5920ee3883ffc9aba01e92ff7f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 14 Mar 2026 13:23:44 +1100
Subject: [PATCH 2346/2374] Added release notes for #9394

---
 docs/releasenotes/12.2.0.rst | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/releasenotes/12.2.0.rst b/docs/releasenotes/12.2.0.rst
index aa1206cd09a..0bbb9b82473 100644
--- a/docs/releasenotes/12.2.0.rst
+++ b/docs/releasenotes/12.2.0.rst
@@ -33,10 +33,14 @@ TODO
 API changes
 ===========
 
-TODO
-^^^^
+Error when encoding an empty image
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+Attempting to encode an image with zero width or height would previously raise
+a :py:exc:`SystemError`. That has now been changed to a :py:exc:`ValueError`.
+
+This does not add any new errors. SGI, ICNS and ICO formats are still able to
+save (0, 0) images.
 
 API additions
 =============

From 3121c77cad919703c2d5c77116a03422ba744d7f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Mar 2026 19:19:48 +1100
Subject: [PATCH 2347/2374] Added release notes for #9456

---
 docs/releasenotes/12.2.0.rst | 23 ++++-------------------
 1 file changed, 4 insertions(+), 19 deletions(-)

diff --git a/docs/releasenotes/12.2.0.rst b/docs/releasenotes/12.2.0.rst
index 0bbb9b82473..66526592a6c 100644
--- a/docs/releasenotes/12.2.0.rst
+++ b/docs/releasenotes/12.2.0.rst
@@ -14,22 +14,6 @@ TODO
 
 TODO
 
-Backwards incompatible changes
-==============================
-
-TODO
-^^^^
-
-TODO
-
-Deprecations
-============
-
-TODO
-^^^^
-
-TODO
-
 API changes
 ===========
 
@@ -61,7 +45,8 @@ FontFile.to_imagefont()
 Other changes
 =============
 
-TODO
-^^^^
+Support reading JPEG2000 images with CMYK palettes
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+JPEG2000 images with CMYK palettes can now be read. This is the first integration of
+CMYK palettes into Pillow.

From 7ef54f6bfd3b8c3666781ea2d27e20509201097f Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 29 Mar 2026 19:40:16 +1100
Subject: [PATCH 2348/2374] Image will never be None

Co-authored-by: jorenham <jhammudoglu@gmail.com>
---
 Tests/test_pyarrow.py | 2 --
 src/PIL/ImageFont.py  | 2 +-
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/Tests/test_pyarrow.py b/Tests/test_pyarrow.py
index 7a161f2ac12..f282f2c0059 100644
--- a/Tests/test_pyarrow.py
+++ b/Tests/test_pyarrow.py
@@ -112,8 +112,6 @@ def test_to_array(mode: str, dtype: pyarrow.DataType, mask: list[int] | None) ->
 
     reloaded = Image.fromarrow(arr, mode, img.size)
 
-    assert reloaded
-
     assert_image_equal(img, reloaded)
 
 
diff --git a/src/PIL/ImageFont.py b/src/PIL/ImageFont.py
index ec7c7cb0813..06ea0359c45 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -110,7 +110,7 @@ def _load_pilfont(self, filename: str) -> None:
                 except Exception:
                     pass
                 else:
-                    if image and image.mode in ("1", "L"):
+                    if image.mode in ("1", "L"):
                         break
             else:
                 if image:

From 7c121637c9b0062694069f8f6d173e17dba8c46f Mon Sep 17 00:00:00 2001
From: Jeffrey 'Alex' Clark <aclark@aclark.net>
Date: Sun, 29 Mar 2026 10:05:18 -0400
Subject: [PATCH 2349/2374] Jeffrey A. Clark -> Jeffrey 'Alex' Clark

Follow up to 4197263dff19a79f13cd86f6cdc9a0ec6c06da92. People cannot figure out
my preferred name, hence this final (I hope!) update to my name in Pillow.
---
 LICENSE             | 2 +-
 README.md           | 2 +-
 docs/COPYING        | 2 +-
 docs/conf.py        | 4 ++--
 docs/index.rst      | 2 +-
 pyproject.toml      | 2 +-
 src/PIL/__init__.py | 2 +-
 7 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/LICENSE b/LICENSE
index 10dd42d9eda..c011511a4ab 100644
--- a/LICENSE
+++ b/LICENSE
@@ -5,7 +5,7 @@ The Python Imaging Library (PIL) is
 
 Pillow is the friendly PIL fork. It is
 
-    Copyright © 2010 by Jeffrey A. Clark and contributors
+    Copyright © 2010 by Jeffrey 'Alex' Clark and contributors
 
 Like PIL, Pillow is licensed under the open source MIT-CMU License:
 
diff --git a/README.md b/README.md
index 8585ef6cbd4..04c9ae8abd8 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
 
 ## Python Imaging Library (Fork)
 
-Pillow is the friendly PIL fork by [Jeffrey A. Clark and
+Pillow is the friendly PIL fork by [Jeffrey 'Alex' Clark and
 contributors](https://github.com/python-pillow/Pillow/graphs/contributors).
 PIL is the Python Imaging Library by Fredrik Lundh and contributors.
 As of 2019, Pillow development is
diff --git a/docs/COPYING b/docs/COPYING
index 17fba5b87ff..1852f9e4786 100644
--- a/docs/COPYING
+++ b/docs/COPYING
@@ -5,7 +5,7 @@ The Python Imaging Library (PIL) is
 
 Pillow is the friendly PIL fork. It is
 
-    Copyright © 2010 by Jeffrey A. Clark and contributors
+    Copyright © 2010 by Jeffrey 'Alex' 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 040301433f9..189758944d9 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -55,9 +55,9 @@
 project = "Pillow (PIL Fork)"
 copyright = (
     "1995-2011 Fredrik Lundh and contributors, "
-    "2010 Jeffrey A. Clark and contributors."
+    "2010 Jeffrey 'Alex' Clark and contributors."
 )
-author = "Fredrik Lundh (PIL), Jeffrey A. Clark (Pillow)"
+author = "Fredrik Lundh (PIL), Jeffrey 'Alex' 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
diff --git a/docs/index.rst b/docs/index.rst
index ee51621ac7a..8612f77a55d 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,7 +1,7 @@
 Pillow
 ======
 
-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 is the friendly PIL fork by `Jeffrey 'Alex' 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 7eb9a3fbdde..65e3b76591e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -18,7 +18,7 @@ keywords = [
 license = "MIT-CMU"
 license-files = [ "LICENSE" ]
 authors = [
-  { name = "Jeffrey A. Clark", email = "aclark@aclark.net" },
+  { name = "Jeffrey 'Alex' Clark", email = "aclark@aclark.net" },
 ]
 requires-python = ">=3.10"
 classifiers = [
diff --git a/src/PIL/__init__.py b/src/PIL/__init__.py
index 6e4c23f897f..faf3e76e0ae 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 and contributors.
+Pillow is the friendly PIL fork by Jeffrey 'Alex' Clark and contributors.
     https://github.com/python-pillow/Pillow/
 
 Pillow is forked from PIL 1.1.7.

From 07c180b21e9de56b9cec064306c149581fe2ca50 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Mar 2026 19:40:04 +1100
Subject: [PATCH 2350/2374] Simplify SAMPLEFORMAT when all values match for
 values other than 1

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

diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 3eec94dca57..f11b6ce9730 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1473,13 +1473,13 @@ def _setup(self) -> None:
         logger.debug("- size: %s", self.size)
 
         sample_format = self.tag_v2.get(SAMPLEFORMAT, (1,))
-        if len(sample_format) > 1 and max(sample_format) == min(sample_format) == 1:
+        if len(sample_format) > 1 and max(sample_format) == min(sample_format):
             # SAMPLEFORMAT is properly per band, so an RGB image will
             # be (1,1,1).  But, we don't support per band pixel types,
             # and anything more than one band is a uint8. So, just
             # take the first element. Revisit this if adding support
             # for more exotic images.
-            sample_format = (1,)
+            sample_format = (sample_format[0],)
 
         bps_tuple = self.tag_v2.get(BITSPERSAMPLE, (1,))
         extra_tuple = self.tag_v2.get(EXTRASAMPLES, ())

From 84cb30d7a7388ff984dcf284e32e7c4fb2abb44b Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Mar 2026 19:42:07 +1100
Subject: [PATCH 2351/2374] For separate planar configuration, ignore
 unspecified extra components

---
 Tests/images/separate_planar_extra_samples.tiff | Bin 0 -> 202 bytes
 Tests/test_file_libtiff.py                      |   4 ++++
 src/PIL/TiffImagePlugin.py                      |  14 ++++++++++----
 3 files changed, 14 insertions(+), 4 deletions(-)
 create mode 100644 Tests/images/separate_planar_extra_samples.tiff

diff --git a/Tests/images/separate_planar_extra_samples.tiff b/Tests/images/separate_planar_extra_samples.tiff
new file mode 100644
index 0000000000000000000000000000000000000000..be51a7570ee92e579e41d178e6646c645eed56e1
GIT binary patch
literal 202
zcmebD)MC(KU|^`2^Y-*YMg|5RCWZg?Rl5&lHTea_Ty9E~Xak~+Qv5qN-Hqm9U|?is
z04icI0%AraHWQG|1Qg={LT0Eq2awMOWrOqxGO~cx90IaMq2eGtVo)~7OmQF^B&Gty
XGDvEIplqNpLoieg6Idn4P6z-1gKZPS

literal 0
HcmV?d00001

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index 6f20900e490..ea0550a5fd9 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1055,6 +1055,10 @@ def test_strip_planar_16bit_RGBa(self) -> None:
         with Image.open("Tests/images/tiff_strip_planar_16bit_RGBa.tiff") as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGBa_target.png")
 
+    def test_separate_planar_extra_samples(self) -> None:
+        with Image.open("Tests/images/separate_planar_extra_samples.tiff") as im:
+            assert im.mode == "L"
+
     @pytest.mark.parametrize("compression", (None, "jpeg"))
     def test_block_tile_tags(self, compression: str | None, tmp_path: Path) -> None:
         im = hopper()
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index f11b6ce9730..669dc8a3e34 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1483,18 +1483,24 @@ def _setup(self) -> None:
 
         bps_tuple = self.tag_v2.get(BITSPERSAMPLE, (1,))
         extra_tuple = self.tag_v2.get(EXTRASAMPLES, ())
+        samples_per_pixel = self.tag_v2.get(
+            SAMPLESPERPIXEL,
+            3 if self._compression == "tiff_jpeg" and photo in (2, 6) else 1,
+        )
         if photo in (2, 6, 8):  # RGB, YCbCr, LAB
             bps_count = 3
         elif photo == 5:  # CMYK
             bps_count = 4
         else:
             bps_count = 1
+        if self._planar_configuration == 2 and extra_tuple and max(extra_tuple) == 0:
+            # If components are stored separately,
+            # then unspecified extra components at the end can be ignored
+            bps_tuple = bps_tuple[: -len(extra_tuple)]
+            samples_per_pixel -= len(extra_tuple)
+            extra_tuple = ()
         bps_count += len(extra_tuple)
         bps_actual_count = len(bps_tuple)
-        samples_per_pixel = self.tag_v2.get(
-            SAMPLESPERPIXEL,
-            3 if self._compression == "tiff_jpeg" and photo in (2, 6) else 1,
-        )
 
         if samples_per_pixel > MAX_SAMPLESPERPIXEL:
             # DOS check, samples_per_pixel can be a Long, and we extend the tuple below

From 007974d35b197030ee34ee8d959361263125ab6d Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Mar 2026 20:04:39 +1100
Subject: [PATCH 2352/2374] Ignore EXTRASAMPLES tag from separate planes image
 when saving

---
 Tests/test_file_libtiff.py | 7 ++++++-
 src/PIL/TiffImagePlugin.py | 6 ++++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index ea0550a5fd9..ca3c055f91a 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1055,10 +1055,15 @@ def test_strip_planar_16bit_RGBa(self) -> None:
         with Image.open("Tests/images/tiff_strip_planar_16bit_RGBa.tiff") as im:
             assert_image_equal_tofile(im, "Tests/images/tiff_16bit_RGBa_target.png")
 
-    def test_separate_planar_extra_samples(self) -> None:
+    def test_separate_planar_extra_samples(self, tmp_path: Path) -> None:
+        out = tmp_path / "temp.tif"
         with Image.open("Tests/images/separate_planar_extra_samples.tiff") as im:
             assert im.mode == "L"
 
+            im.save(out)
+        with Image.open(out) as reloaded:
+            assert reloaded.mode == "L"
+
     @pytest.mark.parametrize("compression", (None, "jpeg"))
     def test_block_tile_tags(self, compression: str | None, tmp_path: Path) -> None:
         im = hopper()
diff --git a/src/PIL/TiffImagePlugin.py b/src/PIL/TiffImagePlugin.py
index 669dc8a3e34..5094faa1325 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1768,6 +1768,12 @@ def _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
         legacy_ifd = im.tag.to_v2()
 
     supplied_tags = {**legacy_ifd, **getattr(im, "tag_v2", {})}
+    if supplied_tags.get(PLANAR_CONFIGURATION) == 2 and EXTRASAMPLES in supplied_tags:
+        # If the image used separate component planes,
+        # then EXTRASAMPLES should be ignored when saving contiguously
+        if SAMPLESPERPIXEL in supplied_tags:
+            supplied_tags[SAMPLESPERPIXEL] -= len(supplied_tags[EXTRASAMPLES])
+        del supplied_tags[EXTRASAMPLES]
     for tag in (
         # IFD offset that may not be correct in the saved image
         EXIFIFD,

From a03b7b52f9858f438a7ca86b4e4307a72c7d95ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Mon, 30 Mar 2026 22:57:51 +1100
Subject: [PATCH 2353/2374] Updated 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 74c63fb062f..7e6ad1e7790 100644
--- a/docs/installation/platform-support.rst
+++ b/docs/installation/platform-support.rst
@@ -23,7 +23,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Amazon Linux 2023                | 3.11                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Arch                             | 3.13                       | x86-64              |
+| Arch                             | 3.14                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | CentOS Stream 9                  | 3.10                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
@@ -37,7 +37,7 @@ These platforms are built and tested for every change.
 +----------------------------------+----------------------------+---------------------+
 | Fedora 43                        | 3.14                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
-| Gentoo                           | 3.12                       | x86-64              |
+| Gentoo                           | 3.13                       | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 | macOS 15 Sequoia                 | 3.11, 3.12, 3.13, 3.14,    | arm64               |
 |                                  | 3.15, PyPy3                |                     |
@@ -57,7 +57,7 @@ These platforms are built and tested for every change.
 | Windows Server 2025              | 3.11, 3.12, 3.13, 3.14,    | x86-64              |
 |                                  | 3.15, PyPy3                |                     |
 |                                  +----------------------------+---------------------+
-|                                  | 3.13 (MinGW)               | x86-64              |
+|                                  | 3.14 (MinGW)               | x86-64              |
 +----------------------------------+----------------------------+---------------------+
 
 

From f80de2152ccf84f430b2072362202ab0249b8c5f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Fri, 27 Mar 2026 19:45:15 +0200
Subject: [PATCH 2354/2374] Run tests in parallel via tox

---
 tox.ini | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/tox.ini b/tox.ini
index de18946efa7..aede5fcdc54 100644
--- a/tox.ini
+++ b/tox.ini
@@ -9,11 +9,16 @@ env_list =
 [testenv]
 deps =
     numpy
+    pytest-sugar
 extras =
     tests
 commands =
     {envpython} selftest.py
-    {envpython} -m pytest -W always {posargs}
+    {envpython} -m pytest \
+      --dist worksteal \
+      --numprocesses auto \
+      -W always \
+      {posargs}
 
 [testenv:lint]
 skip_install = true

From 73e1ed91e3556a1dad7eb81b43fe14b66c73f009 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Jun 2025 00:34:30 +1000
Subject: [PATCH 2355/2374] For DXT1, only check if 8 bytes are left

---
 src/libImaging/BcnEncode.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/libImaging/BcnEncode.c b/src/libImaging/BcnEncode.c
index 973a7a2faef..c6989dc1cc4 100644
--- a/src/libImaging/BcnEncode.c
+++ b/src/libImaging/BcnEncode.c
@@ -257,9 +257,9 @@ ImagingBcnEncode(Imaging im, ImagingCodecState state, UINT8 *buf, int bytes) {
 
     UINT8 *dst = buf;
 
+    int will_write = (n == 2 || n == 3 || n == 5) ? 16 : 8;
     for (;;) {
-        // Loop writes a max of 16 bytes per iteration
-        if (dst + 16 >= bytes + buf) {
+        if (dst + will_write >= bytes + buf) {
             break;
         }
         if (n == 5) {

From 228a85e56eacbd4b16184f2fbdaa162a23aeae42 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 31 Mar 2026 11:22:11 +0300
Subject: [PATCH 2356/2374] Safer test_file_spider teardown under pytest-xdist

---
 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 3b1953aac5d..df385208f02 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -15,7 +15,7 @@
 
 
 def teardown_module() -> None:
-    del Image.EXTENSION[".spider"]
+    Image.EXTENSION.pop(".spider", None)
 
 
 def test_sanity() -> None:

From 09c585dc2195e339566f488bc47000f038a6b5f1 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Tue, 31 Mar 2026 22:02:23 +1100
Subject: [PATCH 2357/2374] Cleanup .spider extension in the same test where it
 is added

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

diff --git a/Tests/test_file_spider.py b/Tests/test_file_spider.py
index df385208f02..71fb434ccf4 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -14,10 +14,6 @@
 TEST_FILE = "Tests/images/hopper.spider"
 
 
-def teardown_module() -> None:
-    Image.EXTENSION.pop(".spider", None)
-
-
 def test_sanity() -> None:
     with Image.open(TEST_FILE) as im:
         im.load()
@@ -67,6 +63,8 @@ def test_save(tmp_path: Path) -> None:
         assert im2.size == (128, 128)
         assert im2.format == "SPIDER"
 
+    del Image.EXTENSION[".spider"]
+
 
 @pytest.mark.parametrize("size", ((0, 1), (1, 0), (0, 0)))
 def test_save_zero(size: tuple[int, int]) -> None:

From 4bada07dc6c24319edd1eb76f1dd28d968d58207 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Feb 2026 22:24:03 +1100
Subject: [PATCH 2358/2374] Avoid overflow by not adding extents together

---
 Tests/images/psd-oob-write-overflow.psd | Bin 0 -> 496 bytes
 Tests/test_file_psd.py                  |   2 ++
 src/decode.c                            |  13 ++++++-------
 src/encode.c                            |  12 +++++-------
 4 files changed, 13 insertions(+), 14 deletions(-)
 create mode 100644 Tests/images/psd-oob-write-overflow.psd

diff --git a/Tests/images/psd-oob-write-overflow.psd b/Tests/images/psd-oob-write-overflow.psd
new file mode 100644
index 0000000000000000000000000000000000000000..c2bb10d614ed8a2130a28338f474b74f6e67d486
GIT binary patch
literal 496
zcmcC;3J7LkWPkt=%>~9Ba4{g4F$IVd7?>c6z$8Q!L|>YPlc#T9eo^j!gaWWk1BA~7
bHETJhx&}G`21d@^a4>k8z_6l2U^D;#tMlDs

literal 0
HcmV?d00001

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 3b145b13983..9964a68e18e 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -195,11 +195,13 @@ def test_layer_crashes(test_file: str) -> None:
         "Tests/images/psd-oob-write.psd",
         "Tests/images/psd-oob-write-x.psd",
         "Tests/images/psd-oob-write-y.psd",
+        "Tests/images/psd-oob-write-overflow.psd",
     ],
 )
 def test_bounds_crash(test_file: str) -> None:
     with Image.open(test_file) as im:
         assert isinstance(im, PsdImagePlugin.PsdImageFile)
+        im.load()
         im.seek(im.n_frames)
 
         with pytest.raises(ValueError):
diff --git a/src/decode.c b/src/decode.c
index cda4ce7027f..2268b353306 100644
--- a/src/decode.c
+++ b/src/decode.c
@@ -171,6 +171,12 @@ _setimage(ImagingDecoderObject *decoder, PyObject *args) {
         return NULL;
     }
 
+    if (x0 < 0 || y0 < 0 || x1 <= x0 || y1 <= y0 || x1 > (int)im->xsize ||
+        y1 > (int)im->ysize) {
+        PyErr_SetString(PyExc_ValueError, "tile cannot extend outside image");
+        return NULL;
+    }
+
     decoder->im = im;
 
     state = &decoder->state;
@@ -181,13 +187,6 @@ _setimage(ImagingDecoderObject *decoder, PyObject *args) {
     state->xsize = x1 - x0;
     state->ysize = y1 - y0;
 
-    if (state->xoff < 0 || state->xsize <= 0 ||
-        state->xsize + state->xoff > (int)im->xsize || state->yoff < 0 ||
-        state->ysize <= 0 || state->ysize + state->yoff > (int)im->ysize) {
-        PyErr_SetString(PyExc_ValueError, "tile cannot extend outside image");
-        return NULL;
-    }
-
     /* Allocate memory buffer (if bits field is set) */
     if (state->bits > 0) {
         if (!state->bytes) {
diff --git a/src/encode.c b/src/encode.c
index 1fc31404d9e..02356d5648b 100644
--- a/src/encode.c
+++ b/src/encode.c
@@ -244,6 +244,11 @@ _setimage(ImagingEncoderObject *encoder, PyObject *args) {
         return NULL;
     }
 
+    if (x0 < 0 || y0 < 0 || x1 <= x0 || y1 <= y0 || x1 > im->xsize || y1 > im->ysize) {
+        PyErr_SetString(PyExc_SystemError, "tile cannot extend outside image");
+        return NULL;
+    }
+
     encoder->im = im;
 
     state = &encoder->state;
@@ -253,13 +258,6 @@ _setimage(ImagingEncoderObject *encoder, PyObject *args) {
     state->xsize = x1 - x0;
     state->ysize = y1 - y0;
 
-    if (state->xoff < 0 || state->xsize <= 0 ||
-        state->xsize + state->xoff > im->xsize || state->yoff < 0 ||
-        state->ysize <= 0 || state->ysize + state->yoff > im->ysize) {
-        PyErr_SetString(PyExc_SystemError, "tile cannot extend outside image");
-        return NULL;
-    }
-
     /* Allocate memory buffer (if bits field is set) */
     if (state->bits > 0) {
         if (state->xsize > ((INT_MAX / state->bits) - 7)) {

From 591ce38ca56fa7516df4f4ee0525730dee049144 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 18 Feb 2026 23:24:05 +1100
Subject: [PATCH 2359/2374] Skip OverflowError on Windows Python 3.10

---
 Tests/test_file_psd.py | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index 9964a68e18e..a5223cacea7 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -1,12 +1,19 @@
 from __future__ import annotations
 
+import sys
 import warnings
 
 import pytest
 
 from PIL import Image, PsdImagePlugin
 
-from .helper import assert_image_equal_tofile, assert_image_similar, hopper, is_pypy
+from .helper import (
+    assert_image_equal_tofile,
+    assert_image_similar,
+    hopper,
+    is_pypy,
+    is_win32,
+)
 
 test_file = "Tests/images/hopper.psd"
 
@@ -195,11 +202,23 @@ def test_layer_crashes(test_file: str) -> None:
         "Tests/images/psd-oob-write.psd",
         "Tests/images/psd-oob-write-x.psd",
         "Tests/images/psd-oob-write-y.psd",
-        "Tests/images/psd-oob-write-overflow.psd",
     ],
 )
 def test_bounds_crash(test_file: str) -> None:
     with Image.open(test_file) as im:
+        assert isinstance(im, PsdImagePlugin.PsdImageFile)
+        im.seek(im.n_frames)
+
+        with pytest.raises(ValueError):
+            im.load()
+
+
+@pytest.mark.skipif(
+    is_win32() and sys.version_info < (3, 11),
+    reason="OverflowError on Windows Python 3.10",
+)
+def test_bounds_crash_overflow() -> None:
+    with Image.open("Tests/images/psd-oob-write-overflow.psd") as im:
         assert isinstance(im, PsdImagePlugin.PsdImageFile)
         im.load()
         im.seek(im.n_frames)

From b2a16f0dbe80d4add20294b3dca0618cfe2c1660 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Mar 2026 23:45:57 +1100
Subject: [PATCH 2360/2374] Copy offset check from C into Python

---
 Tests/test_imagefile.py | 49 +++++++++++++++++++++++++++++++++++++++--
 src/PIL/ImageFile.py    | 11 ++++-----
 2 files changed, 51 insertions(+), 9 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 6656ee506ca..2dcebc4b15f 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -308,7 +308,20 @@ def test_extents_none(self) -> None:
         assert MockPyDecoder.last.state.xsize == 200
         assert MockPyDecoder.last.state.ysize == 200
 
-    def test_negsize(self) -> None:
+    def test_negative_offset(self) -> None:
+        buf = BytesIO(b"\x00" * 255)
+
+        im = MockImageFile(buf)
+        im.tile = [ImageFile._Tile("MOCK", (-10, yoff, xsize, ysize), 32, None)]
+
+        with pytest.raises(ValueError):
+            im.load()
+
+        im.tile = [ImageFile._Tile("MOCK", (xoff, -10, xsize, ysize), 32, None)]
+        with pytest.raises(ValueError):
+            im.load()
+
+    def test_negative_size(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -386,7 +399,39 @@ def test_extents_none(self) -> None:
         assert MockPyEncoder.last.state.xsize == 200
         assert MockPyEncoder.last.state.ysize == 200
 
-    def test_negsize(self) -> None:
+    def test_negative_offset(self) -> None:
+        buf = BytesIO(b"\x00" * 255)
+
+        im = MockImageFile(buf)
+
+        fp = BytesIO()
+        MockPyEncoder.last = None
+        with pytest.raises(ValueError):
+            ImageFile._save(
+                im,
+                fp,
+                [
+                    ImageFile._Tile(
+                        "MOCK", (-10, yoff, xoff + xsize, yoff + ysize), 0, "RGB"
+                    )
+                ],
+            )
+        last: MockPyEncoder | None = MockPyEncoder.last
+        assert last
+        assert last.cleanup_called
+
+        with pytest.raises(ValueError):
+            ImageFile._save(
+                im,
+                fp,
+                [
+                    ImageFile._Tile(
+                        "MOCK", (xoff, -10, xoff + xsize, yoff + ysize), 0, "RGB"
+                    )
+                ],
+            )
+
+    def test_negative_size(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
diff --git a/src/PIL/ImageFile.py b/src/PIL/ImageFile.py
index b79f23f0d64..dd1116ab986 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -805,6 +805,10 @@ def setimage(
 
         if extents:
             x0, y0, x1, y1 = extents
+
+            if x0 < 0 or y0 < 0 or x1 > self.im.size[0] or y1 > self.im.size[1]:
+                msg = "Tile cannot extend outside image"
+                raise ValueError(msg)
         else:
             x0, y0, x1, y1 = (0, 0, 0, 0)
 
@@ -820,13 +824,6 @@ def setimage(
             msg = "Size must be positive"
             raise ValueError(msg)
 
-        if (
-            self.state.xsize + self.state.xoff > self.im.size[0]
-            or self.state.ysize + self.state.yoff > self.im.size[1]
-        ):
-            msg = "Tile cannot extend outside image"
-            raise ValueError(msg)
-
 
 class PyDecoder(PyCodec):
     """

From cc22efda7a296c3e6ca9b40a4a4eb4d1af1741ac Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sat, 28 Mar 2026 23:54:09 +1100
Subject: [PATCH 2361/2374] Parametrize tests

---
 Tests/test_imagefile.py | 168 ++++++++++------------------------------
 1 file changed, 42 insertions(+), 126 deletions(-)

diff --git a/Tests/test_imagefile.py b/Tests/test_imagefile.py
index 2dcebc4b15f..5f4ed2eb082 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -295,65 +295,38 @@ def test_setimage(self) -> None:
         with pytest.raises(ValueError):
             MockPyDecoder.last.set_as_raw(b"\x00")
 
-    def test_extents_none(self) -> None:
-        buf = BytesIO(b"\x00" * 255)
-
-        im = MockImageFile(buf)
-        im.tile = [ImageFile._Tile("MOCK", None, 32, None)]
-
-        im.load()
-
-        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_negative_offset(self) -> None:
+    @pytest.mark.parametrize(
+        "extents",
+        (
+            (-10, yoff, xoff + xsize, yoff + ysize),
+            (xoff, -10, xoff + xsize, yoff + ysize),
+            (xoff, yoff, -10, yoff + ysize),
+            (xoff, yoff, xoff + xsize, -10),
+            (xoff, yoff, xoff + xsize + 100, yoff + ysize),
+            (xoff, yoff, xoff + xsize, yoff + ysize + 100),
+        ),
+    )
+    def test_extents(self, extents: tuple[int, int, int, int]) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
-        im.tile = [ImageFile._Tile("MOCK", (-10, yoff, xsize, ysize), 32, None)]
-
-        with pytest.raises(ValueError):
-            im.load()
+        im.tile = [ImageFile._Tile("MOCK", extents, 32, None)]
 
-        im.tile = [ImageFile._Tile("MOCK", (xoff, -10, xsize, ysize), 32, None)]
         with pytest.raises(ValueError):
             im.load()
 
-    def test_negative_size(self) -> None:
-        buf = BytesIO(b"\x00" * 255)
-
-        im = MockImageFile(buf)
-        im.tile = [ImageFile._Tile("MOCK", (xoff, yoff, -10, yoff + ysize), 32, None)]
-
-        with pytest.raises(ValueError):
-            im.load()
-
-        im.tile = [ImageFile._Tile("MOCK", (xoff, yoff, xoff + xsize, -10), 32, None)]
-        with pytest.raises(ValueError):
-            im.load()
-
-    def test_oversize(self) -> None:
+    def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
-        im.tile = [
-            ImageFile._Tile(
-                "MOCK", (xoff, yoff, xoff + xsize + 100, yoff + ysize), 32, None
-            )
-        ]
+        im.tile = [ImageFile._Tile("MOCK", None, 32, None)]
 
-        with pytest.raises(ValueError):
-            im.load()
+        im.load()
 
-        im.tile = [
-            ImageFile._Tile(
-                "MOCK", (xoff, yoff, xoff + xsize, yoff + ysize + 100), 32, None
-            )
-        ]
-        with pytest.raises(ValueError):
-            im.load()
+        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_decode(self) -> None:
         decoder = ImageFile.PyDecoder("")
@@ -384,22 +357,18 @@ def test_setimage(self) -> None:
         assert MockPyEncoder.last.state.xsize == xsize
         assert MockPyEncoder.last.state.ysize == ysize
 
-    def test_extents_none(self) -> None:
-        buf = BytesIO(b"\x00" * 255)
-
-        im = MockImageFile(buf)
-        im.tile = [ImageFile._Tile("MOCK", None, 32, None)]
-
-        fp = BytesIO()
-        ImageFile._save(im, fp, [ImageFile._Tile("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
-        assert MockPyEncoder.last.state.ysize == 200
-
-    def test_negative_offset(self) -> None:
+    @pytest.mark.parametrize(
+        "extents",
+        (
+            (-10, yoff, xoff + xsize, yoff + ysize),
+            (xoff, -10, xoff + xsize, yoff + ysize),
+            (xoff, yoff, -10, yoff + ysize),
+            (xoff, yoff, xoff + xsize, -10),
+            (xoff, yoff, xoff + xsize + 100, yoff + ysize),
+            (xoff, yoff, xoff + xsize, yoff + ysize + 100),
+        ),
+    )
+    def test_extents(self, extents: tuple[int, int, int, int]) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
@@ -407,81 +376,28 @@ def test_negative_offset(self) -> None:
         fp = BytesIO()
         MockPyEncoder.last = None
         with pytest.raises(ValueError):
-            ImageFile._save(
-                im,
-                fp,
-                [
-                    ImageFile._Tile(
-                        "MOCK", (-10, yoff, xoff + xsize, yoff + ysize), 0, "RGB"
-                    )
-                ],
-            )
+            ImageFile._save(im, fp, [ImageFile._Tile("MOCK", extents, 0, "RGB")])
         last: MockPyEncoder | None = MockPyEncoder.last
         assert last
         assert last.cleanup_called
 
         with pytest.raises(ValueError):
-            ImageFile._save(
-                im,
-                fp,
-                [
-                    ImageFile._Tile(
-                        "MOCK", (xoff, -10, xoff + xsize, yoff + ysize), 0, "RGB"
-                    )
-                ],
-            )
-
-    def test_negative_size(self) -> None:
-        buf = BytesIO(b"\x00" * 255)
-
-        im = MockImageFile(buf)
+            ImageFile._save(im, fp, [ImageFile._Tile("MOCK", extents, 0, "RGB")])
 
-        fp = BytesIO()
-        MockPyEncoder.last = None
-        with pytest.raises(ValueError):
-            ImageFile._save(
-                im,
-                fp,
-                [ImageFile._Tile("MOCK", (xoff, yoff, -10, yoff + ysize), 0, "RGB")],
-            )
-        last: MockPyEncoder | None = MockPyEncoder.last
-        assert last
-        assert last.cleanup_called
-
-        with pytest.raises(ValueError):
-            ImageFile._save(
-                im,
-                fp,
-                [ImageFile._Tile("MOCK", (xoff, yoff, xoff + xsize, -10), 0, "RGB")],
-            )
-
-    def test_oversize(self) -> None:
+    def test_extents_none(self) -> None:
         buf = BytesIO(b"\x00" * 255)
 
         im = MockImageFile(buf)
+        im.tile = [ImageFile._Tile("MOCK", None, 32, None)]
 
         fp = BytesIO()
-        with pytest.raises(ValueError):
-            ImageFile._save(
-                im,
-                fp,
-                [
-                    ImageFile._Tile(
-                        "MOCK", (xoff, yoff, xoff + xsize + 100, yoff + ysize), 0, "RGB"
-                    )
-                ],
-            )
+        ImageFile._save(im, fp, [ImageFile._Tile("MOCK", None, 0, "RGB")])
 
-        with pytest.raises(ValueError):
-            ImageFile._save(
-                im,
-                fp,
-                [
-                    ImageFile._Tile(
-                        "MOCK", (xoff, yoff, xoff + xsize, yoff + ysize + 100), 0, "RGB"
-                    )
-                ],
-            )
+        assert MockPyEncoder.last
+        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_encode(self) -> None:
         encoder = ImageFile.PyEncoder("")

From 2696e962c2b145d7b354c12ac6ef1e4a95558fc9 Mon Sep 17 00:00:00 2001
From: Gareth Davidson <gaz@bitplane.net>
Date: Tue, 31 Mar 2026 21:03:12 +0100
Subject: [PATCH 2362/2374] Add loader plugins: AMOS abk, Atari Degas, 40+ more
 obscure formats via Netpbm (#9482)

Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
---
 docs/handbook/third-party-plugins.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/handbook/third-party-plugins.rst b/docs/handbook/third-party-plugins.rst
index 20086649906..51181a59663 100644
--- a/docs/handbook/third-party-plugins.rst
+++ b/docs/handbook/third-party-plugins.rst
@@ -8,12 +8,15 @@ itself.
 Here is a list of PyPI projects that offer additional plugins:
 
 * :pypi:`amigainfo`: Adds support for Amiga Workbench .info icon files.
+* :pypi:`amos-abk`: AMOS BASIC sprite and image banks.
 * :pypi:`DjvuRleImagePlugin`: Plugin for the DjVu RLE image format as defined in the DjVuLibre docs.
 * :pypi:`heif-image-plugin`: Simple HEIF/HEIC images plugin, based on the pyheif library.
 * :pypi:`jxlpy`: Introduces reading and writing support for JPEG XL.
+* :pypi:`pillow-degas`: Adds reading Atari ST Degas image files.
 * :pypi:`pillow-heif`: Python bindings to libheif for working with HEIF images.
 * :pypi:`pillow-jpls`: Plugin for the JPEG-LS codec, based on the Charls JPEG-LS implementation. Python bindings implemented using pybind11.
 * :pypi:`pillow-jxl-plugin`: Plugin for JPEG-XL, using Rust for bindings.
 * :pypi:`pillow-mbm`: Adds support for KSP's proprietary MBM texture format.
+* :pypi:`pillow-netpbm`: Adds .pam support, and loads images using `Netpbm <https://en.wikipedia.org/wiki/Netpbm>`__'s converter collection.
 * :pypi:`pillow-svg`: Implements basic SVG read support. Supports basic paths, shapes, and text.
 * :pypi:`raw-pillow-opener`: Simple camera raw opener, based on the rawpy library.

From 3cb814f33899b4d50eb04c316e66a737751c70a8 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 31 Mar 2026 23:15:06 +0300
Subject: [PATCH 2363/2374] Update 12.2.0 release notes

---
 docs/releasenotes/12.2.0.rst | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/docs/releasenotes/12.2.0.rst b/docs/releasenotes/12.2.0.rst
index 209fa782f83..d02d6541466 100644
--- a/docs/releasenotes/12.2.0.rst
+++ b/docs/releasenotes/12.2.0.rst
@@ -67,6 +67,11 @@ or scaling, optionally with a font size limit::
     text.wrap(58, 10, "grow")
     text.wrap(50, 50, ("grow", 12))
 
+EXIF tag FrameRate
+^^^^^^^^^^^^^^^^^^
+
+The EXIF tag ``FrameRate`` has been added.
+
 Other changes
 =============
 
@@ -75,3 +80,16 @@ Support reading JPEG2000 images with CMYK palettes
 
 JPEG2000 images with CMYK palettes can now be read. This is the first integration of
 CMYK palettes into Pillow.
+
+Lazy plugin loading
+^^^^^^^^^^^^^^^^^^^
+
+When opening or saving an image, Pillow now lazily loads only the required plugin
+based on the file extension, instead of importing all plugins upfront. This makes
+``open`` 2.3-15.6x faster and ``save`` 2.2-9x faster for common formats.
+
+Thread safety for free-threaded Python
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Critical sections are now used to protect FreeType font objects, improving thread
+safety when using fonts in the free-threaded build of Python.

From 3cb854e8b2bab43f40e342e665f9340d861aa628 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 1 Apr 2026 00:02:08 +0300
Subject: [PATCH 2364/2374] Only read as much data from gzip-decompressed data
 as necessary (#9521)

---
 src/PIL/FitsImagePlugin.py | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/src/PIL/FitsImagePlugin.py b/src/PIL/FitsImagePlugin.py
index a3fdc0efeec..e918407784d 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -128,17 +128,18 @@ class FitsGzipDecoder(ImageFile.PyDecoder):
 
     def decode(self, buffer: bytes | Image.SupportsArrayInterface) -> tuple[int, int]:
         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)
+        with gzip.open(self.fd) as fp:
+            value = fp.read(self.state.xsize * self.state.ysize * 4)
+
+            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
 

From 3bf614e4b8615d0ce1d5039efaf6db447fe7c468 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 1 Apr 2026 00:03:15 +0300
Subject: [PATCH 2365/2374] Raise an error if the trailer chain loops back on
 itself (#9519)

---
 Tests/images/trailer_loop.pdf | Bin 0 -> 1818 bytes
 Tests/test_pdfparser.py       |   5 +++++
 src/PIL/PdfParser.py          |  10 ++++++++--
 3 files changed, 13 insertions(+), 2 deletions(-)
 create mode 100644 Tests/images/trailer_loop.pdf

diff --git a/Tests/images/trailer_loop.pdf b/Tests/images/trailer_loop.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..7bf27ca370ec635039e274ddb65685fa147a2abc
GIT binary patch
literal 1818
zcmd5*OK;Oa5O!&W%HFuZg~MJVl|#E;zmlLThd2bHQZ=NJKp+l|y-l|`-m>2G!KuF-
znDL_tE}&kJn#A$$?9A+Z-#6154~DyZ&m%1wYY`cd(AhN|%QRJ&6wYX(<%Q71qc&Bu
zv;BR-rq}0!vM@4Hs^)}^qq)eb59bro>xnD@H-g*W+zT(lLbc2c<%Au`B&VOLgJJZ`
zDv&n=KOW7_L~IB<Ud~K$^JoD#681qR<`h%C6>@%BBpu4s2n}gj7>=gXVRSVRu}TD7
zz{=G)(hIy7aU9THi0-FR{B@LbYV;DahALeyvK;eH)Fr-qJq+(llaGZC)#6-bqQn5c
zN*|v`G0-s(7cv%abaYMFJCV(?G~R*W+yJc$a<gsSJh7~eO>4t~7d~t2M{DcNYP|(M
zkJs!^H@1qnZLmLEvp=uw=>KBP4qJ<W99038Fi3bM%tYjBsbdfi*%)gT9}9!zq3o<+
zxsT8*1qv^T+*1?@#l{~y6p4)b>Ix!l`0~B-fxu8@2B^xZTliOvgPnj~qmji%+n{4r
zT}7hjt~mUL$%{{Y(`pkhC@YH_DEgk<1s<$YPo+r(-TCp;Qr6Nkmh%#7#pahP8^8$A
zoxv-|b^_bAeTO@3-}?j}hbsB&;ceevX>meq+9qY4_)i1hcLRDtYa91qn2M9^*5-Ag
zzJ@LE@A}yuaNO{-JMBBRwg=4Cenv+!g&9VfCrTNL!#shBlHUcC%0}6VqR3C7X>KBI
z3LG7;O<JwjM?=V8%kuxZ<26rE{))RcOkx4Z=5_%6cQ0%mY-@2rx!d(Bm<Xi-lk>nW
zadsX8PUnv}E9_1e2KZjsyES%1S4xcVn%I$<LgVg3!0z4~d&P&pK1=`Xb8gp!teOEa
LHwg*6pd{oMe~`Qn

literal 0
HcmV?d00001

diff --git a/Tests/test_pdfparser.py b/Tests/test_pdfparser.py
index d85fb1212e3..cba6cd05390 100644
--- a/Tests/test_pdfparser.py
+++ b/Tests/test_pdfparser.py
@@ -125,3 +125,8 @@ 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()
+
+
+def test_trailer_loop() -> None:
+    with pytest.raises(PdfFormatError, match="trailer loop found"):
+        PdfParser("Tests/images/trailer_loop.pdf")
diff --git a/src/PIL/PdfParser.py b/src/PIL/PdfParser.py
index 2c9031469ad..f7f3a46431d 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -685,7 +685,9 @@ def read_trailer(self) -> None:
         if b"Prev" in self.trailer_dict:
             self.read_prev_trailer(self.trailer_dict[b"Prev"])
 
-    def read_prev_trailer(self, xref_section_offset: int) -> None:
+    def read_prev_trailer(
+        self, xref_section_offset: int, processed_offsets: list[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(
@@ -700,7 +702,11 @@ def read_prev_trailer(self, xref_section_offset: int) -> None:
         )
         trailer_dict = self.interpret_trailer(trailer_data)
         if b"Prev" in trailer_dict:
-            self.read_prev_trailer(trailer_dict[b"Prev"])
+            processed_offsets.append(xref_section_offset)
+            check_format_condition(
+                trailer_dict[b"Prev"] not in processed_offsets, "trailer loop found"
+            )
+            self.read_prev_trailer(trailer_dict[b"Prev"], processed_offsets)
 
     re_whitespace_optional = re.compile(whitespace_optional)
     re_name = re.compile(

From cf4a8ee0b955ee8039624a654d9cab2b75ce179a Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Apr 2026 08:26:13 +1100
Subject: [PATCH 2366/2374] Updated xz to 5.8.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 97011f4a00f..331eae2249b 100755
--- a/.github/workflows/wheels-dependencies.sh
+++ b/.github/workflows/wheels-dependencies.sh
@@ -95,7 +95,7 @@ HARFBUZZ_VERSION=13.2.1
 LIBPNG_VERSION=1.6.56
 JPEGTURBO_VERSION=3.1.4.1
 OPENJPEG_VERSION=2.5.4
-XZ_VERSION=5.8.2
+XZ_VERSION=5.8.3
 ZSTD_VERSION=1.5.7
 TIFF_VERSION=4.7.1
 LCMS2_VERSION=2.18
diff --git a/winbuild/build_prepare.py b/winbuild/build_prepare.py
index e2580f482fe..3b16da58aef 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -125,7 +125,7 @@ def cmd_msbuild(
     "LIBWEBP": "1.6.0",
     "OPENJPEG": "2.5.4",
     "TIFF": "4.7.1",
-    "XZ": "5.8.2",
+    "XZ": "5.8.3",
     "ZLIBNG": "2.3.3",
 }
 V["LIBPNG_XY"] = "".join(V["LIBPNG"].split(".")[:2])

From ec8272044d2adfc97a5f4b6e921c1a908318d9cb Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 1 Apr 2026 00:52:09 +0300
Subject: [PATCH 2367/2374] Use long for glyph position (#9518)

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

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 8e56c57ab2e..8330439f0b1 100644
--- a/src/_imagingft.c
+++ b/src/_imagingft.c
@@ -589,9 +589,9 @@ bounding_box_and_anchors(
     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 */
+    long position; /* pen position along primary axis, in 26.6 precision */
+    long advanced; /* pen position along primary axis, in pixels */
+    int px, py;    /* position of current glyph, in pixels */
     int x_min, x_max, y_min, y_max; /* text bounding box, in pixels */
     int x_anchor, y_anchor;         /* offset of point drawn at (0, 0), in pixels */
     int error;

From f5e893e46e869a9e275298207c70cf915173a072 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Apr 2026 09:46:09 +1100
Subject: [PATCH 2368/2374] Seek raises OverFlowError on 32-bit

---
 Tests/test_file_psd.py | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/Tests/test_file_psd.py b/Tests/test_file_psd.py
index a5223cacea7..538b1406b36 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -12,7 +12,6 @@
     assert_image_similar,
     hopper,
     is_pypy,
-    is_win32,
 )
 
 test_file = "Tests/images/hopper.psd"
@@ -213,15 +212,15 @@ def test_bounds_crash(test_file: str) -> None:
             im.load()
 
 
-@pytest.mark.skipif(
-    is_win32() and sys.version_info < (3, 11),
-    reason="OverflowError on Windows Python 3.10",
-)
 def test_bounds_crash_overflow() -> None:
     with Image.open("Tests/images/psd-oob-write-overflow.psd") as im:
         assert isinstance(im, PsdImagePlugin.PsdImageFile)
         im.load()
-        im.seek(im.n_frames)
-
-        with pytest.raises(ValueError):
-            im.load()
+        if sys.maxsize <= 2**32:
+            with pytest.raises(OverflowError):
+                im.seek(im.n_frames)
+        else:
+            im.seek(im.n_frames)
+
+            with pytest.raises(ValueError):
+                im.load()

From 4ef0ac611dd42602365c8b0506f796982c20fac2 Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Apr 2026 10:00:39 +1100
Subject: [PATCH 2369/2374] Resize tall images vertically first

---
 src/PIL/Image.py | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/src/PIL/Image.py b/src/PIL/Image.py
index 6062857da06..574980771f9 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2428,7 +2428,14 @@ def resize(
                     (box[3] - reduce_box[1]) / factor_y,
                 )
 
-        return self._new(self.im.resize(size, resample, box))
+        if self.size[1] > self.size[0] * 100 and size[1] < self.size[1]:
+            im = self.im.resize(
+                (self.size[0], size[1]), resample, (0, box[1], self.size[0], box[3])
+            )
+            im = im.resize(size, resample, (box[0], 0, box[2], size[1]))
+        else:
+            im = self.im.resize(size, resample, box)
+        return self._new(im)
 
     def reduce(
         self,

From 459bdf766fec2e6ed106c650e79d388284ead2eb Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Apr 2026 10:38:22 +1100
Subject: [PATCH 2370/2374] Move variable declaration inside define

---
 src/libImaging/Paste.c | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/libImaging/Paste.c b/src/libImaging/Paste.c
index f01bce93388..f4b72c5d814 100644
--- a/src/libImaging/Paste.c
+++ b/src/libImaging/Paste.c
@@ -356,7 +356,7 @@ fill(
 ) {
     /* fill opaque region */
 
-    int x, y, i;
+    int x, y;
     UINT8 ink8 = 0;
     INT32 ink32 = 0L;
 
@@ -372,6 +372,7 @@ fill(
 
     } else {
 #if defined _WIN32 && !defined _WIN64
+        int i;
         dx *= pixelsize;
         for (y = 0; y < ysize; y++) {
             UINT8 *out = (UINT8 *)imOut->image[y + dy] + dx;

From c4f7aa5dfb4dbd1242978ac235e01b9934ec6d3c Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Wed, 1 Apr 2026 16:49:20 +1100
Subject: [PATCH 2371/2374] Added security release notes

---
 docs/releasenotes/12.2.0.rst | 31 +++++++++++++++++++++++++------
 1 file changed, 25 insertions(+), 6 deletions(-)

diff --git a/docs/releasenotes/12.2.0.rst b/docs/releasenotes/12.2.0.rst
index d02d6541466..05d5dee2567 100644
--- a/docs/releasenotes/12.2.0.rst
+++ b/docs/releasenotes/12.2.0.rst
@@ -4,15 +4,34 @@
 Security
 ========
 
-TODO
-^^^^
+Prevent FITS decompression bomb
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+When decompressing GZIP data from a FITS image, Pillow did not limit the amount of data
+being read, meaning that it was vulnerable to GZIP decompression bombs. This was
+introduced in Pillow 10.3.0.
 
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
+The data being read is now limited to only the necessary amount.
+
+Fix OOB write with invalid tile extents
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Pillow 12.1.1 added improved checks for tile extents to prevent an OOB write from
+specially crafted PSD images in Pillow >= 10.3.0. However, these checks did not
+consider integer overflow. This has been corrected.
+
+Prevent PDF parsing trailer infinite loop
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+When parsing a PDF, if a trailer refers to itself, or a more complex cyclic loop
+exists, then an infinite loop occurs. Pillow now keeps a record of which trailers it
+has already processed. PdfParser was added in Pillow 4.2.0.
+
+Integer overflow when processing fonts
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+If a font advances for each glyph by an exceeding large amount, when Pillow keeps track
+of the current position, it may lead to an integer overflow. This has been fixed.
 
 API changes
 ===========

From cf6de8ca9b23e714aa5310e1c791eda66fc0b670 Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 1 Apr 2026 14:50:45 +0300
Subject: [PATCH 2372/2374] Reject non-numeric elements inside list coords
 (#9526)

---
 Tests/test_imagepath.py      | 29 +++++++++++++++++++++++++++++
 docs/releasenotes/12.2.0.rst | 10 ++++++++++
 src/path.c                   | 15 ++++++++++++++-
 3 files changed, 53 insertions(+), 1 deletion(-)

diff --git a/Tests/test_imagepath.py b/Tests/test_imagepath.py
index ad8acde4938..8d230eb564c 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -51,6 +51,7 @@ def test_path() -> None:
         [0.0, 1.0],
         ((0, 1),),
         [(0, 1)],
+        [[0, 1]],
         ((0.0, 1.0),),
         [(0.0, 1.0)],
         array.array("f", [0, 1]),
@@ -68,6 +69,34 @@ def test_path_constructors(
     assert list(p) == [(0.0, 1.0)]
 
 
+@pytest.mark.parametrize(
+    "coords, expected",
+    (
+        ([[0, 1], [2, 3]], [(0.0, 1.0), (2.0, 3.0)]),
+        ([[0.0, 1.0], [2.0, 3.0]], [(0.0, 1.0), (2.0, 3.0)]),
+    ),
+)
+def test_path_list_of_lists(
+    coords: list[list[float]], expected: list[tuple[float, float]]
+) -> None:
+    p = ImagePath.Path(coords)
+    assert list(p) == expected
+
+
+@pytest.mark.parametrize(
+    "coords, message",
+    (
+        ([[1, 2, 3]], "coordinate list must contain exactly 2 coordinates"),
+        ([[1]], "coordinate list must contain exactly 2 coordinates"),
+        ([[[1, 2], [3, 4]]], "coordinate list must contain numbers"),
+        ([["a", "b"]], "coordinate list must contain numbers"),
+    ),
+)
+def test_invalid_list_coords(coords: list[list[object]], message: str) -> None:
+    with pytest.raises(ValueError, match=message):
+        ImagePath.Path(coords)
+
+
 def test_invalid_path_constructors() -> None:
     # Arrange / Act
     with pytest.raises(ValueError, match="incorrect coordinate type"):
diff --git a/docs/releasenotes/12.2.0.rst b/docs/releasenotes/12.2.0.rst
index 05d5dee2567..b03afb6651f 100644
--- a/docs/releasenotes/12.2.0.rst
+++ b/docs/releasenotes/12.2.0.rst
@@ -33,6 +33,16 @@ Integer overflow when processing fonts
 If a font advances for each glyph by an exceeding large amount, when Pillow keeps track
 of the current position, it may lead to an integer overflow. This has been fixed.
 
+Heap buffer overflow with nested list coordinates
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Passing nested lists as coordinates to APIs that accept coordinates such as
+``ImagePath.Path``, :py:meth:`~PIL.ImageDraw.ImageDraw.polygon`
+and :py:meth:`~PIL.ImageDraw.ImageDraw.line` could cause a heap buffer overflow,
+as nested lists were recursively unpacked beyond the allocated buffer.
+Coordinate lists are now validated to contain exactly two numeric coordinates.
+This was introduced in Pillow 11.2.1.
+
 API changes
 ===========
 
diff --git a/src/path.c b/src/path.c
index 38300547c60..b88346d5f8f 100644
--- a/src/path.c
+++ b/src/path.c
@@ -118,14 +118,27 @@ assign_item_to_array(double *xy, Py_ssize_t j, PyObject *op) {
     } else if (PyNumber_Check(op)) {
         xy[j++] = PyFloat_AsDouble(op);
     } else if (PyList_Check(op)) {
+        if (PyList_GET_SIZE(op) != 2) {
+            PyErr_SetString(
+                PyExc_ValueError, "coordinate list must contain exactly 2 coordinates"
+            );
+            return -1;
+        }
         for (int k = 0; k < 2; k++) {
             PyObject *op1 = PyList_GetItemRef(op, k);
             if (op1 == NULL) {
                 return -1;
             }
-            j = assign_item_to_array(xy, j, op1);
+            if (PyFloat_Check(op1) || PyLong_Check(op1) || PyNumber_Check(op1)) {
+                j = assign_item_to_array(xy, j, op1);
+            } else {
+                j = -1;
+            }
             Py_DECREF(op1);
             if (j == -1) {
+                PyErr_SetString(
+                    PyExc_ValueError, "coordinate list must contain numbers"
+                );
                 return -1;
             }
         }

From 585b2f5a780722c8a5bfffb3a40f7f42e8a205be Mon Sep 17 00:00:00 2001
From: Andrew Murray <radarhere@users.noreply.github.com>
Date: Sun, 29 Mar 2026 18:11:36 +1100
Subject: [PATCH 2373/2374] Check calloc return value

---
 src/_imaging.c | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/_imaging.c b/src/_imaging.c
index 55d29d1bf77..980f827ae78 100644
--- a/src/_imaging.c
+++ b/src/_imaging.c
@@ -267,6 +267,9 @@ PyObject *
 ExportArrowSchemaPyCapsule(ImagingObject *self) {
     struct ArrowSchema *schema =
         (struct ArrowSchema *)calloc(1, sizeof(struct ArrowSchema));
+    if (!schema) {
+        return ArrowError(IMAGING_CODEC_MEMORY);
+    }
     int err = export_imaging_schema(self->image, schema);
     if (err == 0) {
         return PyCapsule_New(schema, "arrow_schema", ReleaseArrowSchemaPyCapsule);

From 3c41c095064200a02672d89cc5ff629eaf4b0d4f Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Wed, 1 Apr 2026 15:11:14 +0300
Subject: [PATCH 2374/2374] 12.2.0 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 96363e9f154..72d11ae9267 100644
--- a/src/PIL/_version.py
+++ b/src/PIL/_version.py
@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "12.2.0.dev0"
+__version__ = "12.2.0"