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 001/688] 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 68834045a..186a0efd3 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -6,7 +6,7 @@ import fuzzers
 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 c479c384a..360ae11b5 100644
--- a/Tests/test_file_eps.py
+++ b/Tests/test_file_eps.py
@@ -3,7 +3,7 @@ import io
 
 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 8b06ce2b1..d98f23356 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -3,7 +3,7 @@ import warnings
 
 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 8070fe10f1ccc346539f87c88fb65ea55d001b9a Mon Sep 17 00:00:00 2001
From: Nulano <nulano@nulano.eu>
Date: Sat, 23 Dec 2023 14:41:50 +0100
Subject: [PATCH 002/688] pass build config before setuptools command; add
 build_editable to custom build backend

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

diff --git a/.github/workflows/wheels.yml b/.github/workflows/wheels.yml
index 5adff7ec1..0c8a941de 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 d1537b809..0b183a587 100644
--- a/_custom_build/backend.py
+++ b/_custom_build/backend.py
@@ -11,41 +11,16 @@ backend_class = build_wheel.__self__.__class__
 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}")
 
-            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:]
+            sys.argv = sys.argv[:1] + params + sys.argv[1:]
         return super().run_setup(setup_script)
 
     def build_wheel(
@@ -54,5 +29,15 @@ class _CustomBuildMetaBackend(backend_class):
         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 da2537b21..d63e401af 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 1bf0bcff5..c74165fb7 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 @@ class pil_build_ext(build_ext):
         + [("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 @@ class pil_build_ext(build_ext):
                     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 @@ ext_modules = [
     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 003/688] 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 fbcfbb907..03011619f 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 004/688] 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 0b183a587..2c670ff0a 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 d63e401af..da2537b21 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 c74165fb7..686e8889f 100755
--- a/setup.py
+++ b/setup.py
@@ -339,7 +339,7 @@ class pil_build_ext(build_ext):
 
     @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 @@ class pil_build_ext(build_ext):
             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 @@ class pil_build_ext(build_ext):
                     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 @@ ext_modules = [
 # 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 005/688] 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 a8e4ebaa6..26d0da0a3 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 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 006/688] 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 5cff56413..9f7bf7829 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -185,14 +185,13 @@ def _layerinfo(fp, ct_bytes):
         # 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 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 007/688] 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 8b06ce2b1..e3c1f447a 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 9f7bf7829..d29bcf997 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -24,6 +24,7 @@ from ._binary import i8
 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 _layerinfo(fp, ct_bytes):
 
     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 0a07e8d0e..4594ccce3 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 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 008/688] 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 d2e60aa07..690fb3586 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -408,7 +408,7 @@ class EpsImageFile(ImageFile.ImageFile):
             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 1b22f8645..2b21d957f 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -339,7 +339,7 @@ class IcoImageFile(ImageFile.ImageFile):
 
             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 009/688] 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 0923979af..17b1b3203 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -328,7 +328,7 @@ class ImageFile(Image.Image):
     #     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 bf73c9bef..3125f8d52 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -103,7 +103,7 @@ class XpmImageFile(ImageFile.ImageFile):
 
         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 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 010/688] 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 ff3862110..9b6a4c5e6 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -777,6 +777,15 @@ class TestFilePng:
             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 823f12492..1248fb785 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -981,7 +981,13 @@ class PngImageFile(ImageFile.ImageFile):
             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 011/688] [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 9b6a4c5e6..3c285b077 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -777,7 +777,7 @@ class TestFilePng:
             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 @@ class TestFilePng:
             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 012/688] 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 3c285b077..aa2aac906 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -782,7 +782,7 @@ class TestFilePng:
         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 013/688] 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 aa2aac906..0884ddcc3 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -778,10 +778,14 @@ class TestFilePng:
         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 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 014/688] 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 26d0da0a3..f40982cd5 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 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 015/688] 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 f40982cd5..c980d9c75 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 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 016/688] 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 3ec314873..a30d0468c 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 df33ea493..3117065e8 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -143,9 +143,9 @@ DEPS = {
         "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 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 017/688] 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 4e29a856b..d29e9bcfc 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 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 018/688] 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 d29e9bcfc..5eea0c34d 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 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 019/688] 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 3ec314873..9013e8ae2 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 df33ea493..92cbcdf7a 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,9 +113,9 @@ ARCHITECTURES = {
 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 020/688] 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 8def9a435..5ba3a0c14 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 d2e60aa07..94b163bc4 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -356,14 +356,10 @@ class EpsImageFile(ImageFile.ImageFile):
 
                 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 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 021/688] 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 0884ddcc3..ec8794b30 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -778,7 +778,7 @@ class TestFilePng:
         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 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 022/688] 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 3f550fd11..263c897ef 100644
--- a/Tests/test_file_gif.py
+++ b/Tests/test_file_gif.py
@@ -1105,6 +1105,21 @@ def test_append_images(tmp_path: Path) -> None:
         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 57d87078b..935b95ca8 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 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 023/688] 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 a1b4dbc1a..4e7d41f11 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 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 024/688] 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 4e7d41f11..927d8dc3f 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 025/688] Corrected syntax

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

diff --git a/src/_webp.c b/src/_webp.c
index 927d8dc3f..47592547c 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 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 026/688] 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 db9d3586c..0399c6b67 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 dc842d7a3..73a5487d9 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 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 027/688] 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 c03122c11..4a801e5b0 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -138,6 +138,17 @@ class WindowsViewer(Viewer):
             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 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 028/688] 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 0399c6b67..6527d90de 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 73a5487d9..9368dd7e7 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 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 029/688] 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 487f53efe..e929b665e 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -32,7 +32,7 @@ import io
 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 @@ class PyCodecState:
 
 
 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 bb7e466a7..65cc70624 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -26,6 +26,7 @@ from __future__ import annotations
 
 import io
 import struct
+from typing import IO
 
 from . import Image, ImageFile
 from ._binary import i16le as i16
@@ -163,7 +164,7 @@ Image.register_decoder("MSP", MspDecoder)
 # 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 3e0968a83..026bfd9a0 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -28,6 +28,7 @@ from __future__ import annotations
 
 import io
 import logging
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i16le as i16
@@ -143,7 +144,7 @@ SAVE = {
 }
 
 
-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 3e45ba95c..6ac7a9bbc 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 @@ class PpmDecoder(ImageFile.PyDecoder):
 # --------------------------------------------------------------------
 
 
-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 ccf661ff1..7bd84ebd4 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -24,7 +24,7 @@ from __future__ import annotations
 
 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 @@ class SgiImageFile(ImageFile.ImageFile):
             ]
 
 
-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 584932d2c..828701342 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 @@ SAVE = {
 }
 
 
-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 0291e2858..eee727436 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 @@ class XbmImageFile(ImageFile.ImageFile):
         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 030/688] 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 bd8e522c7..87a59ff3d 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 584932d2c..5d4827525 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -85,7 +85,7 @@ class TgaImageFile(ImageFile.ImageFile):
             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 031/688] 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 87a59ff3d..75c592da2 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -7,7 +7,7 @@ from pathlib import Path
 
 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 test_sanity(mode, tmp_path: Path) -> 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 5d4827525..b6748c25e 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -128,6 +128,9 @@ class TgaImageFile(ImageFile.ImageFile):
                 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 032/688] 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 65f090931..e75561f69 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 1b22f8645..b558fdf34 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -329,6 +329,8 @@ class IcoImageFile(ImageFile.ImageFile):
         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 033/688] 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 654242148..4858d92e6 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -986,13 +986,7 @@ class TestFileJpeg:
             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 4c04e0da4..aae51eaa4 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -16,6 +16,7 @@ from PIL import (
     ExifTags,
     Image,
     ImageDraw,
+    ImageFile,
     ImagePalette,
     UnidentifiedImageError,
     features,
@@ -1038,25 +1039,20 @@ class TestImage:
             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 491409781..cf251c9ce 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 @@ class TestImageFile:
 
 
 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 @@ class MockImageFile(ImageFile.ImageFile):
 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 @@ class TestPyDecoder(CodecsTest):
 
         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 @@ class TestPyDecoder(CodecsTest):
 
         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 @@ class TestPyEncoder(CodecsTest):
             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 @@ class TestPyEncoder(CodecsTest):
         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 @@ class TestPyEncoder(CodecsTest):
         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 a770488b7..eba30537f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -229,8 +229,8 @@ 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] = {}
+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 034/688] 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 75fccf795..79a2e60b2 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 035/688] 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 a770488b7..ba81a22c7 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1430,7 +1430,7 @@ class Image:
             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 @@ class Image:
         """
         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 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
 
         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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
 
         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 @@ class Exif(_ExifBase):
 
         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 @@ class Exif(_ExifBase):
             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 ad59b0667..5fb80b753 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 a9e626b2b..6218c723f 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -21,6 +21,7 @@ from __future__ import annotations
 import functools
 import operator
 import re
+from typing import Protocol, Sequence, cast
 
 from . import ExifTags, Image, ImagePalette
 
@@ -28,7 +29,7 @@ from . import ExifTags, Image, ImagePalette
 # 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 2b6cecc61..770d10025 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 @@ class ImagePalette:
                 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 036/688] 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 205fcb9ab..a58ce9bcb 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 b875edf8e..3b8d2535f 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 037/688] 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 a58ce9bcb..c90ad481a 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 3b8d2535f..495926ca7 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 038/688] 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 73aaae6e7..da909c06c 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 ce7345572..2966f724f 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -8,7 +8,6 @@ from .helper import CachedProperty, assert_image_equal
 
 
 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 039/688] 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 de74e9c18..8d2d198ff 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -2,6 +2,7 @@ from __future__ import annotations
 
 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 3904d3bc5..1e2f20c40 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 c36466e02..1eaff0c7d 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -16,7 +16,7 @@ from .helper import (
 
 
 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 f932069b9..036965bf5 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 a2486be40..ab9f9663e 100644
--- a/Tests/test_file_pcx.py
+++ b/Tests/test_file_pcx.py
@@ -9,7 +9,7 @@ from PIL import Image, ImageFile, PcxImagePlugin
 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 65a93c138..d39a86565 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -6,6 +6,7 @@ import os.path
 import tempfile
 import time
 from pathlib import Path
+from typing import Any, Generator
 
 import pytest
 
@@ -14,7 +15,7 @@ from PIL import Image, PdfParser, features
 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 a16b76e19..0110948ae 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -4,6 +4,8 @@ import os
 import warnings
 from io import BytesIO
 from pathlib import Path
+from types import ModuleType
+from typing import Generator
 
 import pytest
 
@@ -20,6 +22,7 @@ from .helper import (
     is_win32,
 )
 
+ElementTree: ModuleType | None
 try:
     from defusedxml import ElementTree
 except ImportError:
@@ -156,7 +159,7 @@ class TestFileTiff:
         "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 @@ class TestFileTiff:
             ("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 @@ class TestFileTiff:
             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 @@ class TestFileTiff:
             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 @@ class TestFileTiff:
             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 @@ class TestFileTiff:
                 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 @@ class TestFileTiff:
             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 @@ class TestFileTiff:
         ],
     )
     @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 73aaae6e7..fe055bf4b 100644
--- a/Tests/test_format_hsv.py
+++ b/Tests/test_format_hsv.py
@@ -2,21 +2,22 @@ from __future__ import annotations
 
 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 94f57e066..7e2290c15 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 07a25b84b..3171eb9ae 100644
--- a/Tests/test_imagedraw2.py
+++ b/Tests/test_imagedraw2.py
@@ -5,6 +5,7 @@ import os.path
 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 9ce9cda82..6ebc61e1b 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 491409781..44521a8b3 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -31,7 +31,7 @@ SAFEBLOCK = ImageFile.SAFEBLOCK
 
 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 909026dc8..c79b36ca4 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -7,11 +7,13 @@ import shutil
 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 test_font_with_filelike(layout_engine) -> None:
     #   _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 test_find_font(monkeypatch, platform, font_directory) -> None:
     _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 50bf404ae..b320e79c1 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -14,7 +14,7 @@ from .helper import (
 
 
 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 03302e20f..519d79105 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 8ba745f21..bd600b177 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -3,6 +3,7 @@ from __future__ import annotations
 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 040/688] 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 48c59f2a1..e687f4bcf 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 8c818df7a..3ef011c9e 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 041/688] 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 e0e6804bf..8fc6bd0ad 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 6ca870166..9776c40e2 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 9ae7ae605..97289c91d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -326,7 +326,7 @@ linkcheck_allowed_redirects = {
     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 558369919..bf2feea9a 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 042/688] 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 c90ad481a..74021a218 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 495926ca7..db514068f 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 043/688] 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 26bf2f6d6..1ec2811f6 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 044/688] 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 000000000..ed3269460
--- /dev/null
+++ b/.ci/requirements-mypy.txt
@@ -0,0 +1 @@
+mypy==1.7.1
diff --git a/tox.ini b/tox.ini
index 8c818df7a..85800ff8d 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 045/688] 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 74021a218..9efb1316d 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 db514068f..e8bf33b60 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 046/688] Remove outdated installation warnings

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

diff --git a/docs/installation.rst b/docs/installation.rst
index 116bdcf2f..980bbd99d 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 047/688] 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 6ffc8f6f5..584d8f91d 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -20,7 +20,7 @@ from PIL import _deprecate
         ),
     ],
 )
-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 65f090931..f69a290fa 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 9c0969437..88c30d468 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 f9f81d114..b0964aabe 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 d4a634316..c51f56ce7 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -6,6 +6,7 @@ import warnings
 import zlib
 from io import BytesIO
 from pathlib import Path
+from types import ModuleType
 from typing import Any
 
 import pytest
@@ -23,6 +24,7 @@ from .helper import (
     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 7eca8d9b1..e60638b22 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 bd8e522c7..3c6da50c5 100644
--- a/Tests/test_file_tga.py
+++ b/Tests/test_file_tga.py
@@ -22,8 +22,8 @@ _ORIGIN_TO_ORIENTATION = {"tl": 1, "bl": -1}
 
 
 @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 bb6225d07..d7a18c725 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 83fc38ed3..21a0dd75b 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 c79b36ca4..05b5d4716 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -7,7 +7,7 @@ import shutil
 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 test_find_font(monkeypatch, platform, font_directory) -> None:
     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 235a2f993..e23adeb70 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -84,6 +84,7 @@ $bmp = New-Object Drawing.Bitmap 200, 200
     @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 @@ $bmp = New-Object Drawing.Bitmap 200, 200
     @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 @@ $ms = new-object System.IO.MemoryStream(, $bytes)
         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 @@ $ms = new-object System.IO.MemoryStream(, $bytes)
         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 bd600b177..9487560af 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 909f97167..88ad1f9ee 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 f7269d45b..8d741d94a 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 test_viewer_show(order) -> None:
     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 c7f633e62..f59ee7284 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -70,7 +70,7 @@ if is_win32():
     ]
     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 6ba95c2d7..9f4e6534e 100644
--- a/Tests/test_numpy.py
+++ b/Tests/test_numpy.py
@@ -14,7 +14,7 @@ TEST_IMAGE_SIZE = (10, 10)
 
 
 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 7d6c0a8cb..3cd323553 100644
--- a/Tests/test_qt_image_qapplication.py
+++ b/Tests/test_qt_image_qapplication.py
@@ -4,7 +4,7 @@ from pathlib import Path
 
 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 @@ if ImageQt.qt_is_installed:
             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 a222a7d71..6110be707 100644
--- a/Tests/test_qt_image_toqimage.py
+++ b/Tests/test_qt_image_toqimage.py
@@ -17,7 +17,7 @@ if ImageQt.qt_is_installed:
 
 
 @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 73e4acd55..197ef79ee 100644
--- a/Tests/test_util.py
+++ b/Tests/test_util.py
@@ -10,7 +10,7 @@ from PIL import _util
 @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 048/688] 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 21a0dd75b..a7bb31db5 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -6,6 +6,7 @@ import re
 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 049/688] 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 74021a218..9fd64fdaa 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 db514068f..b596a6ab2 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 050/688] 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 b596a6ab2..677438bc6 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 051/688] 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 943789923..32de33624 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 052/688] 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 4319cc8ff..92e860cb5 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 053/688] 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 8d2d198ff..3fffa032f 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 46259f1dc..e13e0c5e3 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 b14d6df13..7c5112ef6 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 054/688] 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 115f6135d..cfd576f35 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 055/688] 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 4c5a7f9ee..b0740b1ac 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 2615fb427..4526b9454 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 1c6d15b77..b4e479f12 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 79a2e60b2..d3d1eeaa3 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 19f4a6dae..643273e58 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 056/688] 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 a7bb31db5..6be29a70f 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -343,14 +343,14 @@ def test_extended_information() -> None:
         # 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 057/688] 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 cfd576f35..de1d14bb3 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 058/688] 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 395165b36..1b393a3ff 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 823f12492..203d962e3 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 059/688] 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 000000000..e69de29bb

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 060/688] Added "Typing :: Typed" classifier

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

diff --git a/pyproject.toml b/pyproject.toml
index e687f4bcf..58c2464bc 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 061/688] 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 fc524721c..f86fb8d09 100644
--- a/Tests/test_file_fli.py
+++ b/Tests/test_file_fli.py
@@ -4,7 +4,7 @@ import warnings
 
 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 @@ from .helper import assert_image_equal, assert_image_equal_tofile, is_pypy
 # 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 9769761fc..f9e4c731c 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -77,6 +77,7 @@ class FliImageFile(ImageFile.ImageFile):
         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 062/688] Fixed reading PNG iCCP compression method

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

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

literal 0
HcmV?d00001

diff --git a/Tests/test_file_png.py b/Tests/test_file_png.py
index c51f56ce7..38ffc4bd0 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -619,6 +619,10 @@ class TestFilePng:
         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 823f12492..d864fd201 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -392,8 +392,8 @@ class PngStream(ChunkStream):
         # 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 063/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index a8404260f..ce81f2060 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 064/688] 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 8772a382d..af31cdb74 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 065/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index ce81f2060..205ffa294 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 066/688] 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 d3d1eeaa3..c936be559 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 067/688] Turn off nullability warnings for macOS SDK

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

diff --git a/setup.py b/setup.py
index 1bbd2c05c..ce8f989ab 100644
--- a/setup.py
+++ b/setup.py
@@ -569,6 +569,9 @@ class pil_build_ext(build_ext):
             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 068/688] 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 26bf2f6d6..01f8ca9d4 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 df33ea493..91d4ca16a 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -224,9 +224,9 @@ DEPS = {
         "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 069/688] 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 205fcb9ab..46c8a0701 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 070/688] 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 46c8a0701..8877ccdeb 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 071/688] 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 4c04e0da4..ca4458f88 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -685,15 +685,18 @@ class TestImage:
         _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 072/688] 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 9776c40e2..f142ef563 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 62f3627de..b013d8288 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 bf2feea9a..f4e81e45d 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 58c2464bc..518facc34 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 073/688] 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 ca4458f88..cdcbc7072 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -686,7 +686,7 @@ class TestImage:
         _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 074/688] 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 cdcbc7072..2a4d453e2 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -693,7 +693,7 @@ class TestImage:
             ("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 075/688] 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 bf2feea9a..0c7fb690b 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 980bbd99d..000000000
--- 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 000000000..ff05e7f58
--- /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 000000000..051d51c22
--- /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 000000000..9e6e5eeec
--- /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 000000000..48f3f727d
--- /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 000000000..da98d4b9e
--- /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 000000000..ab075f254
--- /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 076/688] 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 97289c91d..0733e2938 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -36,6 +36,7 @@ extensions = [
     "sphinx_inline_tabs",
     "sphinx_removed_in",
     "sphinxext.opengraph",
+    "sphinx_reredirects",
 ]
 
 intersphinx_mapping = {"python": ("https://docs.python.org/3", None)}
@@ -350,3 +351,8 @@ ogp_image = (
     "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 58c2464bc..2107800d6 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 077/688] [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 0733e2938..874a077a3 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -353,6 +353,4 @@ ogp_image = (
 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 2107800d6..c3b469f10 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 078/688] 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 874a077a3..b7ad57084 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -353,4 +353,4 @@ ogp_image = (
 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 ff05e7f58..486e6863b 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 051d51c22..1f9715547 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 48f3f727d..445a70d4e 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 da98d4b9e..602941c3c 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 ab075f254..8d7db8d3a 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 079/688] 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 000000000..57659ba48
--- /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 080/688] 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 d7a18c725..8b816aa4f 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 3ba4de9d1..b59139f58 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -790,6 +790,8 @@ class ImageFileDirectory_v2(_IFDv2Base):
 
     @_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 081/688] 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 26bf2f6d6..cc8d7e085 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 4f4b81a62..8c2967bc2 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 980bbd99d..de812e3c4 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 df33ea493..2ee9872e6 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -308,21 +308,16 @@ DEPS = {
         "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 082/688] 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 475253078..051fdcfc9 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 6218c723f..33db8fa50 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 @@ class _SupportsGetMesh(Protocol):
 
 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 083/688] 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 ba81a22c7..34177c481 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3714,7 +3714,7 @@ class Exif(_ExifBase):
         # 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 @@ class Exif(_ExifBase):
         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 @@ class Exif(_ExifBase):
 
         # 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 @@ class Exif(_ExifBase):
             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 @@ class Exif(_ExifBase):
                         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 084/688] 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 2ee9872e6..ede161c44 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 @@ if __name__ == "__main__":
         "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 @@ if __name__ == "__main__":
 
     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 085/688] 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 ede161c44..fbd0276ed 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -109,13 +109,30 @@ ARCHITECTURES = {
     "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
                 "<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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 086/688] 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 fbd0276ed..efffbf5ac 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -109,30 +109,33 @@ ARCHITECTURES = {
     "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
                 "<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 @@ DEPS = {
     },
     "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 087/688] 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 3b4deb9bf..24fd05aa2 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 088/688] 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 b4e479f12..a07a27c46 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 089/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 205ffa294..a4e90cf5c 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 090/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index a4e90cf5c..7adcf1b40 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 091/688] 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 813b444db..1c1f58500 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 092/688] 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 890167039..231789ca0 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 d65ba6abc..63d6657bc 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 b98883946..9849bf655 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 1c1f58500..7f76fb47a 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 654242148..33f845402 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -6,7 +6,7 @@ import warnings
 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 @@ TEST_FILE = "Tests/images/hopper.jpg"
 
 @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 @@ class TestFileJpeg:
             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 @@ class TestFileJpeg:
         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 @@ class TestFileJpeg:
             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 @@ class TestFileJpeg:
         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 fab19e2ea..b7f8350c7 100644
--- a/Tests/test_file_jpeg2k.py
+++ b/Tests/test_file_jpeg2k.py
@@ -40,10 +40,8 @@ test_card.load()
 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 0994d9904..908464a11 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -27,7 +27,7 @@ from .helper import (
 
 @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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
                 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 @@ class TestFileLibTiff(LibTiffTestCase):
 
         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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 4fb00d699..f105428ca 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -2,11 +2,11 @@ from __future__ import annotations
 
 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 @@ test_files = ["Tests/images/sugarshack.mpo", "Tests/images/frozenpond.mpo"]
 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 334839f5c..379ef157b 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -7,7 +7,7 @@ import zlib
 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 75fef1dc6..fe71435cc 100644
--- a/Tests/test_file_spider.py
+++ b/Tests/test_file_spider.py
@@ -9,7 +9,7 @@ import pytest
 
 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 0110948ae..21d52462e 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -623,6 +623,7 @@ class TestFileTiff:
         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 2a4d453e2..b4e8e660c 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -138,13 +138,13 @@ class TestImage:
         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 380b89de8..8c42da57a 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -14,6 +14,7 @@ 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:
diff --git a/Tests/test_image_fromqimage.py b/Tests/test_image_fromqimage.py
index ea31a9de9..c20123a1b 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 @@ pytestmark = pytest.mark.skipif(
     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 2966f724f..d8f6b65e0 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -32,7 +32,7 @@ class TestImagingPaste:
     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 7090ff9cd..dbe193808 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -237,7 +237,7 @@ class TestCoreResampleConsistency:
         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 a64e4a846..64098f80f 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -154,7 +154,7 @@ class TestImagingCoreResize:
 
     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 46b473d7a..32615cf0e 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 b320e79c1..d6bdaf450 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -13,8 +13,12 @@ from .helper import (
 )
 
 
-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 test_exif_transpose() -> 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 test_exif_transpose() -> 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 test_exif_transpose() -> 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 test_exif_transpose() -> 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 519d79105..c15907a55 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 7280dded0..7f3a3d141 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 8d741d94a..4e9291fbb 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 903f7e0c6..1b01f95ce 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 f51e8b3a8..073e5415c 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 d2e60aa07..726359c67 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -38,7 +38,7 @@ from ._deprecate import deprecate
 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 ba81a22c7..b344e987e 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 e929b665e..a654dea27 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 093/688] Open 16-bit grayscale PNGs as I;16

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

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

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

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

literal 0
HcmV?d00001

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

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

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

literal 0
HcmV?d00001

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

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

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

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

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

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

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

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

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

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

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

literal 0
HcmV?d00001

diff --git a/Tests/test_file_mcidas.py b/Tests/test_file_mcidas.py
index 2c94fdc39..e11e6bb52 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 334839f5c..ddba4b5b4 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -102,7 +102,7 @@ class TestFilePng:
             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 @@ class TestFilePng:
         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 6e0fa32e4..6a0a5a445 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 6a10ae453..47f9ffa3d 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 f7aea3034..274753c6c 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 ba81a22c7..5d9a3fb21 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -978,7 +978,7 @@ class Image:
         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 1248fb785..35f38d67c 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -62,7 +62,7 @@ _MODES = {
     (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 @@ class PngStream(ChunkStream):
                 # 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 99d2a4ada..2654fd40d 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 094/688] 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 7c5112ef6..15ab6aa45 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 095/688] 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 cc8d7e085..9645e16ac 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 207ec1567..3fbf3be69 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 1140aaaad..e4008489b 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 096/688] 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 ed3269460..3673e1d81 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 097/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 7adcf1b40..44dfa65f7 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 098/688] 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 cc8d7e085..a8f212e68 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 099/688] 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 efffbf5ac..865e08c22 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -132,7 +132,7 @@ V["ZLIB_DOTLESS"] = V["ZLIB"].replace(".", "")
 # 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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 @@ DEPS = {
         "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 100/688] 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 865e08c22..657e2f6ec 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 101/688] 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 657e2f6ec..b9df8be63 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 102/688] 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 fe71435cc..9b82a962a 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 103/688] 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 9645e16ac..581c71253 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 104/688] 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 b7ad57084..40dd4d758 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -35,8 +35,8 @@ extensions = [
     "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 105/688] 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 33f845402..b66fda8dd 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -825,7 +825,7 @@ class TestFileJpeg:
         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 d0e64a35e..3aefa073c 100644
--- a/src/PIL/JpegPresets.py
+++ b/src/PIL/JpegPresets.py
@@ -37,7 +37,7 @@ You can get the subsampling of a JPEG with the
 :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 106/688] 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 de1d14bb3..25768061c 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 107/688] 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 25768061c..a895c55da 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 32de33624..043156e89 100644
--- a/src/PIL/__main__.py
+++ b/src/PIL/__main__.py
@@ -4,4 +4,4 @@ import sys
 
 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 15ab6aa45..a7384a0a0 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 108/688] 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 b9df8be63..0abf624b7 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -118,7 +118,6 @@ V = {
     "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 109/688] Mark file as orphan

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

diff --git a/docs/installation.rst b/docs/installation.rst
index 57659ba48..b4bf2fa00 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 110/688] 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 24fd05aa2..3b4deb9bf 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 40dd4d758..97289c91d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -35,7 +35,6 @@ extensions = [
     "sphinx_copybutton",
     "sphinx_inline_tabs",
     "sphinx_removed_in",
-    "sphinx_reredirects",
     "sphinxext.opengraph",
 ]
 
@@ -351,6 +350,3 @@ ogp_image = (
     "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 b09aa642c..518facc34 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 111/688] 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 486e6863b..01aae0406 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 8f4ef9e3e..4cb116a6a 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 112/688] 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 01aae0406..44e0f3052 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 113/688] 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 4cb116a6a..628acfc38 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 9e6e5eeec..a94204b6b 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 445a70d4e..000000000
--- 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 114/688] 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 44e0f3052..04d9aca02 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 628acfc38..6b24eeffa 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 602941c3c..9ae97d70a 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 8d7db8d3a..0b366a8cd 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 115/688] 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 04d9aca02..c2f889f0e 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 6b24eeffa..05e657272 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 116/688] 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 3adae91a5..973b4374f 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 8f4ef9e3e..bcb25adf3 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 117/688] 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 c2f889f0e..01981aa4f 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 05e657272..349d191a6 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 0b366a8cd..dd5765b6b 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 118/688] 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 0abf624b7..b87b828bf 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -255,7 +255,7 @@ DEPS = {
             ),
         ],
         "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 119/688] 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 cdb32ca5d..73f7ac45d 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 97289c91d..d1505078d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -167,7 +167,7 @@ html_static_path = ["resources"]
 # 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 000000000..1de4c484a
--- /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 120/688] 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 9ae97d70a..a380c9012 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 121/688] 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 73f7ac45d..9cfda53a4 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 122/688] 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 1de4c484a..000000000
--- 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 123/688] Wording

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

diff --git a/docs/about.rst b/docs/about.rst
index 9cfda53a4..3e717e798 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 124/688] 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 3e717e798..eb2832475 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 125/688] 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 d1505078d..97289c91d 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -167,7 +167,7 @@ html_static_path = ["resources"]
 # 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 126/688] Wording

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

diff --git a/docs/about.rst b/docs/about.rst
index eb2832475..ab1a3eb4a 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 127/688] Wording

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

diff --git a/docs/about.rst b/docs/about.rst
index ab1a3eb4a..58be7676b 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 128/688] [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 58be7676b..98cdd8e5a 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 129/688] 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 a380c9012..59fc312ab 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 130/688] 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 b87b828bf..99c7228fa 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 131/688] 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 2654fd40d..5cc39cd00 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 132/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 44dfa65f7..243c6b82a 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 133/688] 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 3673e1d81..6b0535fc1 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 134/688] 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 3fffa032f..3a528a7c8 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 e13e0c5e3..9ed7fa3d6 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -4,9 +4,15 @@ import os
 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 135/688] 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 000000000..d0fc52886
--- /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 000000000..d2815e845
--- /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 136/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 243c6b82a..20da811ed 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 137/688] 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 9849bf655..a7691f645 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 138/688] 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 d472bd7ea..3baf95810 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1042,6 +1042,90 @@ class TestImage:
             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 139/688] 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 3baf95810..f7fd664c0 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -33,36 +33,38 @@ from .helper import (
     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 @@ class TestImage:
 
 
 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 @@ class TestImageBytes:
         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 140/688] 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 f7fd664c0..780c843e2 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 141/688] 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 59f80a354..520e50793 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 142/688] 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 780c843e2..87a978861 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 @@ class TestImageBytes:
         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 143/688] 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 87a978861..8890db128 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1045,26 +1045,18 @@ class TestImage:
 
 
 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 @@ class TestImageBytes:
         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 144/688] 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 ccd6d87ed..45c2af975 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 145/688] 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 2b0ed6c9d..39669d869 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -25,7 +25,7 @@ from enum import IntEnum, IntFlag
 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 146/688] 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 b7f8350c7..bd114aa11 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 4b778a0d3..27f8fbbd0 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -19,7 +19,7 @@ import io
 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 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
             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 cff30e2d0..13f363422 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 147/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 20da811ed..b8b8869dd 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 148/688] 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 a95434624..c74452121 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 9a730f1f9..6a9337fa5 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 569ccb769..54f983b69 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 59556206a..c07abcaf9 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 47592547c..0a70e3357 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 149/688] 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 c936be559..0ab8def31 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 150/688] 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 4526b9454..c718e56de 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 151/688] 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 c718e56de..9674a4665 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 2e28c6868..ac3a53321 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -702,7 +702,7 @@ class Image:
                     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 152/688] 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 274753c6c..0a699e2ab 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 d4e000087..d3efe6486 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -336,6 +336,10 @@ class ImageDraw:
 
         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 153/688] 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    |  25 +++++--
 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, 570 insertions(+), 306 deletions(-)

diff --git a/docs/releasenotes/10.0.0.rst b/docs/releasenotes/10.0.0.rst
index 705ca0415..4be590edf 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 6ac30e7fc..0b75d2efa 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 c3947f64c..412995da5 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 5d60e116c..7d0fcbdf2 100644
--- a/docs/releasenotes/3.1.1.rst
+++ b/docs/releasenotes/3.1.1.rst
@@ -1,12 +1,19 @@
-
 3.1.1
-=====
+-----
 
-CVE-2016-0740 -- Buffer overflow in TiffDecode.c
-------------------------------------------------
+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`).
+Fix 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. 
 
 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
+^^^^^^^^^^^^^^^^^
 
-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`).
+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. 
 
 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 04325ad86..c8e24c8c2 100644
--- a/docs/releasenotes/3.1.2.rst
+++ b/docs/releasenotes/3.1.2.rst
@@ -1,13 +1,19 @@
-
 3.1.2
-=====
+-----
 
-CVE-2016-3076 -- Buffer overflow in Jpeg2KEncode.c
---------------------------------------------------
+Security
+========
 
-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`).
+Fix 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. 
 
 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 7daac1b19..cab01cfad 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 47692a3de..96bf04712 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 6e231464e..ac9701cae 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 f7a1cea65..eb995ebe1 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 69726e628..141489cb5 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 18d0a33f1..3e0843519 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 de50a3f1d..6d4baa2b6 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 452077f1a..7e647841e 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 e74880f6f..b0b016a08 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 3333d63a1..7e2007649 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 CVE-2021-23437
+^^^^^^^^^^^^^^^^^^
 
-* 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.
+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 090ec8024..b46932b24 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 acb92dc41..b8003e886 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 bab70f8f9..4ae596f3e 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 e86f8082b..e1ebd6509 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 440d04b1c..08dbead7f 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 154/688] 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 4be590edf..25e73bff6 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 0b75d2efa..ab0f98123 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 412995da5..38a31ebf4 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 7d0fcbdf2..153c12ab0 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 c8e24c8c2..fff93b8e4 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 cab01cfad..6dd65be9d 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 96bf04712..704ea6876 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 ac9701cae..da6595d5b 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 eb995ebe1..54ce40853 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 141489cb5..0fbf6ffe3 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 3e0843519..7f871bac1 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 6d4baa2b6..af60a862e 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 7e647841e..ea2d7b857 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 b0b016a08..e5f8e7996 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 7e2007649..3a2295e6a 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 b46932b24..2f74f3d70 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 b8003e886..392cf68af 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 4ae596f3e..85a1653cc 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 08dbead7f..3a89ca55e 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 155/688] 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 25e73bff6..7d7a22afa 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 38a31ebf4..5432343c7 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 153c12ab0..49427609e 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 fff93b8e4..5bf66650c 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 704ea6876..6f0d468db 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 54ce40853..263917922 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 0fbf6ffe3..b54259467 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 ea2d7b857..d60be7c01 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 e5f8e7996..e18dc48b2 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 3a2295e6a..6e393b94d 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 2f74f3d70..130db9ebf 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 392cf68af..9501e1eab 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 85a1653cc..3dd070d90 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 3a89ca55e..a602f3bbf 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 156/688] 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 000000000..ab5a05d5d
--- /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 157/688] [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 49427609e..d02f68aa3 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 5bf66650c..289430a71 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 263917922..c3909ac86 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 7f871bac1..7b56b838e 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 158/688] 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 ab5a05d5d..6bf65f5c7 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 159/688] 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 6bf65f5c7..cad00aa41 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 160/688] 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 6f0d468db..34d8d97ba 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 161/688] 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 6dd65be9d..ea1f310d7 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 162/688] 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 5432343c7..bec558ec9 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 163/688] 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 7d7a22afa..993ec4d5d 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 164/688] 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 a602f3bbf..656718081 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 165/688] 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 bec558ec9..63cbe8806 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 d02f68aa3..7f66ac344 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 289430a71..1a46d8e63 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 34d8d97ba..648d1d66d 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 c3909ac86..a492241d7 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 b54259467..909954a37 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 d60be7c01..adbabce3a 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 e18dc48b2..94ad37bb1 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 6e393b94d..679636564 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 130db9ebf..534209117 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 9501e1eab..ab6c6cbdd 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 3dd070d90..f8f1a802b 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 166/688] 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 993ec4d5d..adada6e01 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 ab0f98123..a260fc381 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 63cbe8806..0ffad2e8a 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 cad00aa41..2c7c8285a 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 000000000..a8ed32718
--- /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 000000000..77365ef3e
--- /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 7f66ac344..6e03382b2 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
-^^^^^^^^^^^^^^^^^
+: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.
+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 1a46d8e63..a96154977 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 ea1f310d7..9c504da0f 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 648d1d66d..a95ab1cce 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
-^^^^^^^^^^^^^^^^^
+: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 a PCX image. 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
-^^^^^^^^^^^^^^^^^
-
-.. 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 da6595d5b..e5e8b6a5a 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.
+:cve:`2020-11538`: Buffer overflow in SGI-RLE 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`
-
-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 a492241d7..29a28443f 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 909954a37..5c3993318 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 7b56b838e..84e9c8f86 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
-^^^^^^^^^^^^^^^^^^
+:cve:`2021-25290`: In ``TiffDecode.c``, there is a negative-offset ``memcpy`` with an invalid size
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-.. note:: More information about this vulnerability included in database record :cve:`2021-25290`
+: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
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-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.
-
-Fix CVE-2021-25293
-^^^^^^^^^^^^^^^^^^
-
-.. 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.
+: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 af60a862e..7d4a6c0be 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 adbabce3a..6e8fd5cde 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 94ad37bb1..3ef9bb9b3 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 679636564..34ba703f7 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 534209117..b22912baf 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 ab6c6cbdd..a25e3f5ac 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 f8f1a802b..d538e88c0 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 e1ebd6509..17a95c6f6 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 656718081..cfc7221a3 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 167/688] [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 2c7c8285a..4b58d0370 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 a8ed32718..646f7d43b 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 77365ef3e..7b360051e 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 a95ab1cce..941bda3a8 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 e5e8b6a5a..4c1f41a69 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 7d4a6c0be..986015e3e 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 168/688] 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 b22912baf..1c940904f 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 169/688] 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 6e8fd5cde..50fe9aa19 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 170/688] 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 986015e3e..e043bc191 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 171/688] 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 9c504da0f..fe0148060 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 172/688] 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 fe0148060..c34ba802d 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 173/688] 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 c34ba802d..c241a3a3b 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 174/688] 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 4b58d0370..6446ebccb 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 175/688] 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 e043bc191..de6ba605e 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 176/688] 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 646f7d43b..56398a974 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 7b360051e..4884f8db8 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 6e03382b2..8b7780e7e 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 177/688] 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 8b7780e7e..fc9029ce4 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 84e9c8f86..484b1de36 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 178/688] 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 fc9029ce4..f5fbd8711 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 179/688] 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  | 60 +++++++++++++++++++-----------------
 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, 178 insertions(+), 129 deletions(-)

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index af31cdb74..b5dbf16d4 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 0b3eeeb49..3b4d6e65d 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 4dbbc0bdd..5af2d70ba 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 e8eada73c..4ec71fa67 100644
--- a/docs/releasenotes/3.0.0.rst
+++ b/docs/releasenotes/3.0.0.rst
@@ -1,32 +1,8 @@
-
 3.0.0
-=====
+-----
 
-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``
-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,
-it now returns bare values where appropriate and tuples when the
-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
-TiffImagePlugin.ImageFileDirectory_v2 class.
-
-Deprecated Methods
-------------------
+Deprecations
+============
 
 Several methods that have been marked as deprecated for many releases
 have been removed in this release::
@@ -42,8 +18,34 @@ have been removed in this release::
     ImageWin.fromstring()
     ImageWin.tostring()
 
-LibJpeg and Zlib are Required by Default
-----------------------------------------
+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``
+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,
+it now returns bare values where appropriate and tuples when the
+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
+TiffImagePlugin.ImageFileDirectory_v2 class.
+
+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 3cdb6939d..a233b2b8f 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 c61774288..26a91db79 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 39ffdbb2e..35279d493 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 8845b976a..73156a65d 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 2bbafe741..05fa7e5e2 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 5778de26a..8b4b403a7 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 4d6598d8e..c57b1212f 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 1b5757015..8c04387d4 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 1e9637f1e..aade307d3 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 0730936fe..220cc79b6 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 2a4c64ac5..96d84f681 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 bbabd6520..e02ab9b31 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 2169e6a05..d0bf974ea 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 ec0063e79..211d9dbc1 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 6af2b37bf..c36aa09fb 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 180/688] 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 a260fc381..02189d514 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 b5dbf16d4..110126dc1 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 3b4d6e65d..82b59a6d8 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 a233b2b8f..78531ca37 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 26a91db79..b050e1942 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 8b4b403a7..34a59ab6a 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 c57b1212f..80ad9b9fb 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 96d84f681..f965e74a1 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 941bda3a8..44bb0ffe3 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 c36aa09fb..5f5f9ff29 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 0af5bc8ca..37f26a22c 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 181/688] 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 6446ebccb..d8c41d3ed 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 aade307d3..2590c2610 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 44bb0ffe3..f223b8f5a 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 3ef9bb9b3..9f46cc1e9 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 182/688] 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 4c1f41a69..2a7d2f1d2 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 183/688] 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 110126dc1..d16d45504 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 000000000..22e8c737b
--- /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 17a95c6f6..089d44b90 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 184/688] Update release notes for #7864

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

diff --git a/docs/releasenotes/10.3.0.rst b/docs/releasenotes/10.3.0.rst
index d16d45504..9b1ca1233 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:
+``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-2010: No CVEs
-- 2010-2019: A few CVEs
-- 2019-2024: Many CVEs
+- 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 185/688] 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 9b1ca1233..079cc220c 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 186/688] 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 6a0a5a445..1bfd0434e 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 6ac7a9bbc..bca3018c3 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -270,6 +270,9 @@ class PpmPlainDecoder(ImageFile.PyDecoder):
                     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 187/688] 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 21d52462e..8821fb46a 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -113,6 +113,10 @@ class TestFileTiff:
             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 b59139f58..3f00c4b3a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1166,6 +1166,9 @@ class TiffImageFile(ImageFile.ImageFile):
                 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 188/688] 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 f105428ca..a50188700 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 199a10090..ac9820bbf 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -24,14 +24,11 @@ import os
 import struct
 
 from . import (
-    ExifTags,
     Image,
-    ImageFile,
     ImageSequence,
     JpegImagePlugin,
     TiffImagePlugin,
 )
-from ._binary import i16be as i16
 from ._binary import o32le
 
 
@@ -109,7 +106,6 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
         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 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
         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.fp.seek(self.offset)
+        JpegImagePlugin.JpegImageFile._open(self)
+        if self.info.get("exif") != original_exif:
             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._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 189/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index b8b8869dd..663a6af7c 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 190/688] 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 079cc220c..b5dbf16d4 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 191/688] 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 | 26 +++++++++++++-------------
 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, 50 insertions(+), 91 deletions(-)

diff --git a/docs/releasenotes/2.3.1.rst b/docs/releasenotes/2.3.1.rst
index d8c41d3ed..e54065a0b 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 56398a974..c4504ee33 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 4884f8db8..a80b460a8 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 22e8c737b..84b0016d2 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 82b59a6d8..5d76830d2 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 5af2d70ba..2b9eed524 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 4ec71fa67..8bc477f70 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::
+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()
+* ``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 78531ca37..951819f19 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 b050e1942..3ed8fae57 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 35279d493..cd6f7e2f9 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 05fa7e5e2..8a5a7efe3 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 34a59ab6a..625f237e8 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 8c04387d4..8c8055bfa 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 2590c2610..bc2a45f02 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 220cc79b6..2061f6467 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 f965e74a1..c49376dee 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 e02ab9b31..bbabd6520 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 d0bf974ea..4afdb6645 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 211d9dbc1..63a4b7aad 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 5f5f9ff29..edcda3d61 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 192/688] 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 5d76830d2..e9b0995bb 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 193/688] 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 f5fbd8711..c81f96212 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 194/688] 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 c81f96212..4eabd1944 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 195/688] 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 c49376dee..4e3d10ac5 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 196/688] 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 1c940904f..6fe6b499d 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 197/688] 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 6fe6b499d..8d59aef30 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 198/688] 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 d538e88c0..746bec4d4 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 199/688] 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 e22808ed7..78600c6ed 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 5e144d598..43d710055 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ V = {
     "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 200/688] 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 484b1de36..690421c2a 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 201/688] 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 2a7d2f1d2..0dd8669a5 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 202/688] 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 f223b8f5a..85b0d0ba9 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 203/688] 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 c241a3a3b..b851c56fc 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 6400218f4..5b83d1e9c 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 359a87e6f..fe29f2e4f 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 16075ce95..e5987ce08 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 b1e982fcc..08e9ec2a4 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 204/688] 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 ca298fa70..372298fbc 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 205/688] 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 e61471e72..bdc8e8020 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 206/688] 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 8890db128..1c2b6d4b9 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -60,7 +60,7 @@ image_modes = (
     ("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 207/688] 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 a7691f645..9849bf655 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 5cc39cd00..de94ed159 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 208/688] 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 b0740b1ac..93ed3f2df 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 0ab8def31..40994c60a 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 209/688] 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 f154de123..569d06894 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 ac3a53321..c64a91eac 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -979,7 +979,7 @@ class Image:
         # 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 5cc39cd00..db874e5bb 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 210/688] 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 1c2b6d4b9..23f6b86de 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1045,10 +1045,6 @@ class TestImage:
 
 
 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 @@ class TestImageBytes:
         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 211/688] 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 23f6b86de..d1817d9bf 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1047,44 +1047,31 @@ class TestImage:
 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_bytes = bytes(range(2 * 2 * pixelsize))
+        im = 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
+        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 212/688] 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 d1817d9bf..44ff4527a 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -33,34 +33,34 @@ from .helper import (
     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 @@ class TestImageBytes:
         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 213/688] 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 44ff4527a..ab5ff640e 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1046,7 +1046,7 @@ class TestImage:
 
 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 @@ class TestImageBytes:
         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 @@ class TestImageBytes:
         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 214/688] 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 ab5ff640e..941ec40d9 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1064,8 +1064,9 @@ class TestImageBytes:
 
     @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 215/688] 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 873a9bb5d..da736d6ed 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 ac3a53321..59c5c36f3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1141,7 +1141,7 @@ class Image:
                        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 @@ class Image:
             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 398fbf6db..2582830c4 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 216/688] 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 908464a11..14504e589 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -12,7 +12,7 @@ from pathlib import Path
 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 @@ class TestFileLibTiff(LibTiffTestCase):
             )
         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 b59139f58..bcb3547eb 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -74,6 +74,7 @@ MM = b"MM"  # big-endian (Motorola style)
 # 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 217/688] 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 da736d6ed..e1aa6252b 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 218/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 663a6af7c..49f17db1f 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 219/688] 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 0069eb5bc..7990a6e57 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 f142ef563..823ea76d0 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 73af6d99c..d5ee19f81 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 97289c91d..ebb646803 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -54,9 +54,9 @@ master_doc = "index"
 # 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 @@ latex_documents = [
         master_doc,
         "PillowPILFork.tex",
         "Pillow (PIL Fork) Documentation",
-        "Jeffrey A. Clark (Alex)",
+        "Jeffrey A. Clark",
         "manual",
     )
 ]
@@ -302,7 +302,7 @@ texinfo_documents = [
         "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 1ed9266eb..3a12953f0 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 518facc34..29b784db7 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 63a45769b..09546fe63 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 220/688] [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 ebb646803..1312cac61 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -53,9 +53,7 @@ master_doc = "index"
 
 # 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 221/688] Add PYI (flake8-pyi) to Ruff

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

diff --git a/pyproject.toml b/pyproject.toml
index 518facc34..d1d9c82e4 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 222/688] 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 b0235555d..e27843e53 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 b0235555d..e27843e53 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 b0235555d..e27843e53 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 b0235555d..e27843e53 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 223/688] 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 b0235555d..e27843e53 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 b0235555d..e27843e53 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 224/688] 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 14504e589..6c32b5ad4 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -6,8 +6,8 @@ import itertools
 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 @@ class TestFileLibTiff(LibTiffTestCase):
         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 4c5101738..2542d4e91 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,7 @@ import os
 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 b94193931..3f2220c2a 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 225/688] 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 629a6dc7a..6a0e704b8 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -15,7 +15,7 @@ class TestLibPack:
         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 @@ class TestLibUnpack:
         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 226/688] 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 d1d9c82e4..2ef3fb2d1 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 227/688] 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 1312cac61..882e07668 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -53,7 +53,10 @@ master_doc = "index"
 
 # 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 228/688] 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 bd114aa11..00eeb0cf9 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 27f8fbbd0..925a9148c 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 229/688] [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 00eeb0cf9..ecdda104a 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 230/688] 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 b5dbf16d4..29ff6ffb7 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 231/688] 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 29ff6ffb7..b6df31825 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 232/688] 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 b6df31825..446ad211d 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 233/688] 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 925a9148c..d5734feac 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 234/688] 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 d5734feac..be000c351 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 235/688] 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 ecdda104a..81f75cc72 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 236/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 49f17db1f..64f41a6a3 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 237/688] 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 54f983b69..b49a41a0e 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 044aede62..5f2b6af7c 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 500096ef7..23544b613 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 59c5c36f3..24fc94de9 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -894,9 +894,8 @@ class Image:
         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 @@ class 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 035b83c4d..a6dab3f20 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -37,11 +37,10 @@ class BuiltinFilter(MultibandFilter):
 
 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 56d5d73f8..c7728770a 100644
--- a/src/_imagingcms.c
+++ b/src/_imagingcms.c
@@ -52,7 +52,7 @@ https://www.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 238/688] 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 a6dab3f20..2ae5b8a1a 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 239/688] 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 2ae5b8a1a..b2c4950d6 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 240/688] 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 569d06894..77ce4e7d5 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 c64a91eac..11a3459ed 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -979,7 +979,7 @@ class Image:
         # 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 db874e5bb..4db9eb700 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 241/688] 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 77ce4e7d5..2fb45854a 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 11a3459ed..5c2309ac3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -979,7 +979,7 @@ class Image:
         # 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 4db9eb700..0b84aa1ba 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 242/688] 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 78600c6ed..797f4613a 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 243/688] 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           |  96 ++++++-
 5 files changed, 459 insertions(+), 13 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 000000000..cf7acea4e
--- /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 cce0b05cd..1c1df0d98 100644
--- a/Tests/test_file_fits.py
+++ b/Tests/test_file_fits.py
@@ -6,7 +6,7 @@ import pytest
 
 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 54f983b69..35bc87bd9 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 e69890bab..071918925 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 @@ class FitsImageFile(ImageFile.ImageFile):
         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 @@ class FitsImageFile(ImageFile.ImageFile):
                 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"])
-        else:
-            self._size = int(headers[b"NAXIS1"]), int(headers[b"NAXIS2"])
 
-        number_of_bits = int(headers[b"BITPIX"])
+        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:
+            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)
+
+            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 244/688] 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 2ef3fb2d1..c660752c9 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 3f2220c2a..469d4def9 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -22,11 +22,11 @@ from typing import NamedTuple
 
 
 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 245/688] 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 469d4def9..89fad7033 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 246/688] Skip AppVeyor builds for irrelevant files

---
 .appveyor.yml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.appveyor.yml b/.appveyor.yml
index 93ed3f2df..6f35a0190 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 247/688] 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 c20123a1b..e214e58f9 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -16,13 +16,14 @@ pytestmark = pytest.mark.skipif(
     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 248/688] [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 e214e58f9..7bd94cde7 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 249/688] 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 7bd94cde7..1149e2964 100644
--- a/Tests/test_image_fromqimage.py
+++ b/Tests/test_image_fromqimage.py
@@ -16,7 +16,7 @@ pytestmark = pytest.mark.skipif(
     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 250/688] 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 9849bf655..dacce3fb9 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -11,6 +11,7 @@ import subprocess
 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 251/688] 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 e27843e53..9cfd9d191 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 252/688] 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 6be29a70f..c04d08806 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 c7728770a..7c7763653 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 253/688] =?UTF-8?q?=EF=BB=BFadd=20type=20hints=20for=20Ima?=
 =?UTF-8?q?geCms.{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 39669d869..ddfc77904 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,7 +23,7 @@ import operator
 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 @@ _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 @@ class ImageCmsProfile:
         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 @@ class ImageCmsTransform(Image.ImagePointHandler):
 
         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 @@ class ImageCmsTransform(Image.ImagePointHandler):
         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 254/688] =?UTF-8?q?=EF=BB=BFadd=20type=20hints=20to=20Imag?=
 =?UTF-8?q?eCms.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 c04d08806..6530dc160 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -4,13 +4,14 @@ import datetime
 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 ddfc77904..2f0f112a7 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,7 +23,7 @@ import operator
 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 @@ class ImageCmsTransform(Image.ImagePointHandler):
         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 255/688] =?UTF-8?q?=EF=BB=BFadd=20type=20hints=20to=20pyCm?=
 =?UTF-8?q?s=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 882e07668..af45e5579 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -121,7 +121,10 @@ nitpicky = True
 # 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 2f0f112a7..c76241912 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,7 +23,7 @@ import operator
 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 @@ buildTransformFromOpenProfiles = buildTransform
 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 256/688] 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 c76241912..022967025 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -29,13 +29,13 @@ from . import Image, __version__
 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 @@ class ImageCmsProfile:
             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 257/688] 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 6530dc160..821443e39 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -19,6 +19,7 @@ from .helper import (
     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 7c7763653..5ffb20a6a 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 258/688] 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 821443e39..c80fab75b 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 5ffb20a6a..b50c577d8 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 259/688] 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 b50c577d8..4d66dcc10 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 260/688] 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 c4484cbe2..96bd14dd3 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 261/688] 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 a895c55da..ea4c0e92b 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 262/688] 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 e6fd05167..740b0ebea 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 9cfd9d191..723f80481 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 263/688] 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 022967025..52937ce83 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -23,10 +23,11 @@ import operator
 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 @@ _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 264/688] 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 2c670ff0a..44ec6efe5 100644
--- a/_custom_build/backend.py
+++ b/_custom_build/backend.py
@@ -11,14 +11,12 @@ backend_class = build_wheel.__self__.__class__
 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 9eb957716..5effe657f 100644
--- a/setup.py
+++ b/setup.py
@@ -998,10 +998,9 @@ ext_modules = [
 
 
 # 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 265/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 64f41a6a3..f753bcdc1 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 266/688] Clarify comments

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

diff --git a/Tests/helper.py b/Tests/helper.py
index dacce3fb9..8baaf4c42 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 267/688] 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 797f4613a..0d45d5a20 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 43d710055..0d6da7754 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ V = {
     "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 268/688] 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 9849bf655..bdd195bf0 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 0b84aa1ba..75fdab820 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 269/688] 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 a7384a0a0..8a0b14004 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 270/688] 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 9ed7fa3d6..5ed3ecd7a 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -7,11 +7,12 @@ import sys
 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 d0fc52886..000000000
--- 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 271/688] 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 5ed3ecd7a..e9e12b24a 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -9,7 +9,7 @@ import pytest
 
 @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 272/688] 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 52937ce83..b6e5b9e8f 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 723f80481..036521b0e 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 273/688] 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 b6e5b9e8f..3a45572a1 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -297,7 +297,7 @@ class ImageCmsTransform(Image.ImagePointHandler):
         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 274/688] 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 75fdab820..7e60a960c 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 275/688] 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 af45e5579..483535f96 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -122,7 +122,9 @@ nitpicky = True
 # 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 276/688] 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 2ce9bdfaf..aa6fa2ba1 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 277/688] 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 446ad211d..36c5f5f5f 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 278/688] 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 f753bcdc1..9dae34a1f 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 1c8b84a2b..386c57cc0 100644
--- a/Tests/test_locale.py
+++ b/Tests/test_locale.py
@@ -19,7 +19,7 @@ from PIL import Image
 # 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 55d10a81a..6f75d8670 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 279/688] 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 36c5f5f5f..a73efcee4 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 280/688] 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 aa6fa2ba1..863bd87cf 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 281/688] 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 41981d77c..ccbfe2a6f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -55,6 +55,7 @@ from . import (
     _plugins,
 )
 from ._binary import i32le, o32be, o32le
+from ._typing import TypeGuard
 from ._util import DeferredError, is_path
 
 ElementTree: ModuleType | None
@@ -120,7 +121,7 @@ except ImportError:
     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 @@ class Image:
         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 @@ class Image:
                 self._close_fp()
             self.fp = None
 
-    def close(self):
+    def close(self) -> None:
         """
         Closes the file pointer, if possible.
 
@@ -589,7 +590,7 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
 
         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 @@ class Image:
         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 @@ class Image:
 
     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 @@ class 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 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
 
         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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
             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 @@ class 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 @@ class Image:
 
         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 @@ _fromarray_typemap = {
 }
 
 
-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(fp, mode="r", formats=None) -> Image:
 # 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 @@ class Exif(_ExifBase):
             }
         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 @@ class Exif(_ExifBase):
 
         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 @@ class Exif(_ExifBase):
             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 282/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 9dae34a1f..fd4a27d86 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 283/688] 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 6f730cfef..9947f439b 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -291,7 +291,8 @@ class BmpRleDecoder(ImageFile.PyDecoder):
         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 be17f4223..b89502d1f 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -497,7 +497,8 @@ class DdsRgbDecoder(ImageFile.PyDecoder):
 
         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 bca3018c3..94bf430b8 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -307,7 +307,8 @@ class PpmDecoder(ImageFile.PyDecoder):
         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 a7b9d4a9e..1a2a4d388 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -53,7 +53,8 @@ class QoiDecoder(ImageFile.PyDecoder):
 
         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 284/688] 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 f0fbc8cc2..95e807781 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -341,7 +341,7 @@ class BLP1Decoder(_BLPBaseDecoder):
             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 @@ class BLP2Decoder(_BLPBaseDecoder):
             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 b89502d1f..93c8e341d 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -506,7 +506,7 @@ class DdsRgbDecoder(ImageFile.PyDecoder):
                 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 1a2a4d388..e9fef37a9 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -98,7 +98,7 @@ class QoiDecoder(ImageFile.PyDecoder):
             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 285/688] Increase use of bytearrays to improve loading speed

---
 src/PIL/QoiImagePlugin.py | 38 +++++++++++++++++++++-----------------
 1 file changed, 21 insertions(+), 17 deletions(-)

diff --git a/src/PIL/QoiImagePlugin.py b/src/PIL/QoiImagePlugin.py
index e9fef37a9..f8aa720c1 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -11,7 +11,6 @@ import os
 
 from . import Image, ImageFile
 from ._binary import i32be as i32
-from ._binary import o8
 
 
 def _accept(prefix):
@@ -49,7 +48,7 @@ class QoiDecoder(ImageFile.PyDecoder):
     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 @@ class QoiDecoder(ImageFile.PyDecoder):
         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))
-                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 = self._previously_seen_pixels.get(
+                        op_index, bytearray((0, 0, 0, 0))
+                    )
+                elif op == 1:  # QOI_OP_DIFF
+                    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 @@ class QoiDecoder(ImageFile.PyDecoder):
                         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 286/688] 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 863bd87cf..5d477144d 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 287/688] 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 ccbfe2a6f..b92c0bb43 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -524,7 +524,7 @@ class Image:
     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 @@ class Image:
         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 @@ class Image:
             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 @@ class 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 288/688] 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 b92c0bb43..baef0aa11 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -524,7 +524,7 @@ class Image:
     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 @@ class Image:
         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 289/688] 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        |  60 +++-
 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, 868 insertions(+), 239 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 5d477144d..c1399e89b 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 33b33d6b7..fcf671daa 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 a21e2307d..000000000
--- 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 000000000..3915e64aa
--- /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 000000000..7b8a562d7
--- /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 ee07efa01..026c7cd9e 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
+            )
 
-            out = ImageMath.eval("convert(min(a, b), 'L')", a=im1, b=im2)
-            out.save("result.png")
+.. py:function:: lambda_eval(expression, environment)
 
-.. py:function:: eval(expression, environment)
+    Returns the result of an image function.
 
-    Evaluate expression in the given environment.
+    :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.
+
+.. 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.
 
     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 0ffad2e8a..1c6b78b08 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 8d59aef30..fee66b6d0 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 a25e3f5ac..f65e3bcc2 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 b8671068d..6b415d238 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 a7652f237..5ed9e08ad 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -18,9 +18,10 @@ from __future__ import annotations
 
 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 @@ ops = {
 }
 
 
-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 eval(expression: str, _dict: dict[str, Any] = {}, **kw: Any) -> Any:
         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 290/688] 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 026c7cd9e..5fd61f881 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 5ed9e08ad..2ffebbe71 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 291/688] 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 5fd61f881..703b2f5b9 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 292/688] 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 33bc14187..c3d1ba4f0 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 a73efcee4..607f0b262 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 293/688] [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 3915e64aa..5769c903e 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 2ffebbe71..5d83929dc 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -236,9 +236,11 @@ ops = {
 }
 
 
-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 294/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index fd4a27d86..5d08940ca 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 295/688] 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 c80fab75b..fbd78032e 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 4d66dcc10..84b8a7e71 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 296/688] 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 a73efcee4..e5a47b281 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 297/688] 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 5d83929dc..77472a24c 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -238,7 +238,7 @@ ops = {
 
 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 298/688]  Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 5d08940ca..d314ac4e9 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 299/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index d314ac4e9..86d1e349c 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 300/688] 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 86d1e349c..9fae613a5 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 0568943b5..dbed769ed 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 301/688] 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 fbd78032e..bf629fa79 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 302/688] 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 dbed769ed..12d7412ea 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 303/688] 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 3a45572a1..162db628c 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 304/688] 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 84b8a7e71..b0ef2469c 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 305/688] 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 036521b0e..f704047be 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 306/688] [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 c52fdcb55..7e3fd3e18 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 307/688] [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 c4ab3bdcc..1d66b6636 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 308/688] 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 1d66b6636..d2a08c07b 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 309/688] 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 7e3fd3e18..c7156d937 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 740b0ebea..3ce082fb9 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 310/688] 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 c7156d937..51625eb4c 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 311/688] 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 703b2f5b9..2535db711 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 312/688] 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 b0ef2469c..fd487d9da 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 313/688] 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 59fc312ab..bc60eeed4 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 314/688] 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 baef0aa11..0dfccd9b0 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 315/688] [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 0dfccd9b0..a2723756f 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 316/688] 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 a2723756f..c932f1932 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 317/688] [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 c932f1932..a4043c620 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 318/688] 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 a4043c620..245fadd6b 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 319/688] 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 f3f0499f0..c171705c2 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 320/688] 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 6f35a0190..57a8fa5a0 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 321/688] 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 cf85ee4fa..342bd8654 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -91,6 +91,16 @@ def test_fromarray() -> None:
         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 4281b182c..0d9b4d93d 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 245fadd6b..7e68ee3cb 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 322/688] 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 c171705c2..bff056b75 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 323/688] 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 baef0aa11..09ddc770f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 @@ from . import (
     _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(fp, mode="r", formats=None) -> Image:
                 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(fp, mode="r", formats=None) -> Image:
     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(fp, mode="r", formats=None) -> Image:
     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 324/688] 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 bff056b75..fbef08bce 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 325/688] 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 fbef08bce..06716255b 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 326/688] 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 06716255b..1ec972149 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 327/688] 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 09ddc770f..8bae2974c 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2374,7 +2374,9 @@ class Image:
             (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 @@ class Image:
                 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 328/688] 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 81f75cc72..a7cae563a 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 be000c351..51b29bca2 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 13f363422..78a09bb83 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 329/688] 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 162db628c..4af1b79e2 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 330/688] Corrected indentation

---
 src/_imagingcms.c | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index fd487d9da..f18d55a57 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 331/688] 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 8821fb46a..0bc1e2d0e 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -621,6 +621,19 @@ class TestFileTiff:
 
             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 8bfcd2907..c3683efb3 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 332/688] 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 ac27400be..9181b2409 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 333/688] 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 95e807781..8d351ce91 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 9947f439b..6643ac39b 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -48,7 +48,7 @@ BIT2MODE = {
 }
 
 
-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 60f3ec25b..1cbd50d19 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 5fb2b0193..b8790e209 100644
--- a/src/PIL/CurImagePlugin.py
+++ b/src/PIL/CurImagePlugin.py
@@ -25,7 +25,7 @@ from ._binary import i32le as i32
 # --------------------------------------------------------------------
 
 
-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 f7344df44..b24c16329 100644
--- a/src/PIL/DcxImagePlugin.py
+++ b/src/PIL/DcxImagePlugin.py
@@ -29,7 +29,7 @@ from .PcxImagePlugin import PcxImageFile
 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 93c8e341d..3032e4aec 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 523ffcbf7..ec6705742 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -195,7 +195,7 @@ class PSFile:
         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 f9e4c731c..7a233d015 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -27,7 +27,7 @@ from ._binary import o8
 # 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 75680a94e..cfaf86239 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -41,7 +41,7 @@ MODES = {
 # --------------------------------------------------------------------
 
 
-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 b4488e6ee..a746959a3 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -107,7 +107,7 @@ class FtexImageFile(ImageFile.ImageFile):
         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 6722fa2b1..62197e36c 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -29,7 +29,7 @@ from . import Image, ImageFile
 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 6b415d238..93be7fefb 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -60,7 +60,7 @@ LOADING_STRATEGY = LoadingStrategy.RGB_AFTER_FIRST
 # 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 f8106800c..a80fe0a23 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 65409e269..f50e6bf16 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 d877b4ecb..c2c950863 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 d66fbc287..82b190eb8 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 8bae2974c..3ae901060 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -223,7 +223,7 @@ OPEN: dict[
     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(
             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(
     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 be000c351..f28de5c4d 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -313,7 +313,7 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
         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 81b8749a3..e3c0083e9 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -344,7 +344,7 @@ 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 f4529d9ae..96de386a8 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -25,7 +25,7 @@ from . import Image, TiffImagePlugin
 # --------------------------------------------------------------------
 
 
-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 d922bacfb..8b81e54ea 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -689,7 +689,7 @@ class PngStream(ChunkStream):
 # 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 d29bcf997..b15918313 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -44,7 +44,7 @@ MODES = {
 # 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 f8aa720c1..2875b8d75 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -13,7 +13,7 @@ from . import Image, ImageFile
 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 8bfcd2907..10ac9ea3a 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -277,7 +277,7 @@ PREFIXES = [
 ]
 
 
-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 c07abcaf9..9c8d53336 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -23,7 +23,7 @@ _VP8_MODES_BY_IDENTIFIER = {
 }
 
 
-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 b5b8c69b1..7f045ec7d 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -65,7 +65,7 @@ if hasattr(Image.core, "drawwmf"):
 # 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 3125f8d52..a638547af 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -24,7 +24,7 @@ from ._binary import o8
 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 334/688] 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 9181b2409..dd3d70b34 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 335/688] 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 0b31f6081..b0c846553 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -16,24 +16,17 @@ from __future__ import annotations
 
 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 336/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 9fae613a5..e39031aea 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 337/688] ImageStat: use functools.cached_property and add type
 hints

---
 docs/reference/ImageStat.rst | 67 ++----------------------
 src/PIL/ImageStat.py         | 98 ++++++++++++++++++++++++------------
 2 files changed, 69 insertions(+), 96 deletions(-)

diff --git a/docs/reference/ImageStat.rst b/docs/reference/ImageStat.rst
index f61d12313..f69466382 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 13864e59c..07ea76e6f 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
+    @cached_property
+    def extrema(self) -> list[tuple[int, int]]:
+        """
+        Min/max values for each band in the image.
 
-    def _getextrema(self):
-        """Get 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):
+        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 @@ class Stat:
 
         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 @@ class Stat:
             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 @@ class Stat:
             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 @@ class Stat:
             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 338/688] 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 0b31f6081..f6524f44b 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -42,7 +42,6 @@ class ModeDescriptor:
 @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 339/688] 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 0ad496135..5398664b8 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 6643ac39b..dd8c06f4d 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 @@ class BmpImageFile(ImageFile.ImageFile):
 
         # --------------------------------------------- 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 @@ class BmpImageFile(ImageFile.ImageFile):
             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 340/688] 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 5398664b8..a5a4283e3 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 dd8c06f4d..82a9c47db 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 @@ class BmpImageFile(ImageFile.ImageFile):
 
         # --------------------------------------------- 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 341/688] 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 82a9c47db..ddc6b3fcc 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -83,8 +83,9 @@ class BmpImageFile(ImageFile.ImageFile):
         # 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 @@ class BmpImageFile(ImageFile.ImageFile):
             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 342/688] 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 ddc6b3fcc..fa337f6eb 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -184,9 +184,11 @@ class BmpImageFile(ImageFile.ImageFile):
                 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 @@ class BmpImageFile(ImageFile.ImageFile):
             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 6c7d52f58..a84dc0a6f 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 343/688] No more eggs

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index ad0a1adab..5547b2e3c 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 344/688] 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 b013d8288..9e6ec5dd4 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 345/688] 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 ed5252c44..661abcddb 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 346/688] 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 a5a4283e3..7f8487921 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 347/688] 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 fa337f6eb..9ce0fed88 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -123,8 +123,8 @@ class BmpImageFile(ImageFile.ImageFile):
             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 @@ class BmpImageFile(ImageFile.ImageFile):
                     # 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 348/688] 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 1eaff0c7d..c7c9b24e7 100644
--- a/Tests/test_file_bmp.py
+++ b/Tests/test_file_bmp.py
@@ -5,7 +5,7 @@ from pathlib import Path
 
 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 349/688] 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         |  30 ++++++++++++++---------------
 docs/reference/ImageOps.rst        |  30 ++++++++++++++---------------
 docs/releasenotes/9.2.0.rst        |   2 +-
 20 files changed, 34 insertions(+), 34 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 c3d1ba4f0..f530d5741 100644
--- a/docs/deprecations.rst
+++ b/docs/deprecations.rst
@@ -264,7 +264,7 @@ Previously, the ``size`` methods returned a ``height`` that included the vertica
 offset of the text, while the new ``bbox`` methods distinguish this as a ``top``
 offset.
 
-.. image:: ./example/size_vs_bbox.png
+.. image:: ./example/size_vs_bbox.webp
     :alt: In bbox methods, top measures the vertical distance above the text, while bottom measures that plus the vertical distance of the text itself. In size methods, height also measures the vertical distance above the text plus the vertical distance of the text itself.
     :align: center
 
diff --git a/docs/example/anchors.png b/docs/example/anchors.png
deleted file mode 100644
index 40476b0922b4494b8d154a81bf3788798b078d75..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 9726
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
Awg3PC

diff --git a/docs/example/anchors.py b/docs/example/anchors.py
index b5d76b4fe..2ee11103f 100644
--- a/docs/example/anchors.py
+++ b/docs/example/anchors.py
@@ -26,5 +26,5 @@ if __name__ == "__main__":
                 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
zcmV)lK%c*fP)<h;3K|Lk000e1NJLTq003kF003kN0ssI2|9}Dm002txNkl<Zc${^;
zca&t;aUWda-uGUo$!YUqa{v}OF@YdRilhKhv?P;Cw8Cc}OR|qXAIq}jD1Vl$Kq}c5
zsbB??R-h<RW)2`gf&{ThL|y=k%{x0e^>ljS-dpwk@p@)wA^9Dgox$6lo$l(Yy1)9>
zuc~ou{B3!j8G}hB@}ZaKS-rBCVW5|-u@PboAw+i2a4mPOEN=+}WE<HALF}@w!S3!!
z^Wk6rIcZ;L<TDqW?$vhVV}Jf|mXUPkZW+7sGe7-<zw~EcJwFHE{f_VdXCM606E|$H
z)iUpMhjeAJ`@w(yAF?pE_we1_-~$FlNlcBgo;%|;LrjA(aTE{&kQX6T=8ObP7$yS2
z0)ikSkU?Zc3<?1i6-bl>KsAs6A|k@Im#X5%eFRhi1hJMAYpi8NMN|b8RWB$Ch-3f&
zPytC5L`2k!ct9uWP?3}nNkM};Rj=RyMU_MYY9L|_FfcTH`t-Tio_+A1>!&{QC!cB$
zTp!27-A+oF)T=`ftoXzi^3?|)yL5W`4R`MQp&xqZk)sDI#*Wm@%?A&B<)LR*ZAC4w
zt*;Qc$Rv&Wh*A;{)@^-IqtP@(s=!1bjzJ6=5w9447!;5QkpK}00F?ntOCTr$f&vkV
zs;UA2UTZboxX)ymS;eVH2!Rb6MgT%YQe`9*Kq8~+5S54kFo>uKU;uQ2j(`;z)F>!m
zf#i__paKFBGMPL}6XtfO_k}NhwZSV<a-FEXbYW2pR-z%ML_9E7iZn(s1dTK2=FYtK
z?12N@_U%9N@E5-}Ff>vPxiqI|Us_J{-l0R+9XoPhcKY)CrI$KRsa}U<Y<TA#wef=#
z$UC)YRSNcyM6q)aG$1poA`${Af~o=ofr1DU04M+=5?yO75h;yDMCE-|1yDp32|+-F
z1dNIxq5!HY5+R}q;t&CWKpB;h2uTqIF#r+(sv1>Q6eI-@1W*9yT);evqfn#^3#&_W
zt8cn>N9H@3OOYqzBvJK6-WwUM<wd*GDL5L)LQ#t?No8Po{IPF8{U86sFXwsYio9yg
zcfIRvN3TEr^ixm0=iT>-7QgWuzy8Dj_ycJ5i(mTu?6aR9-*NNK{kNrBDcEX^O5{Wt
zBV-gT02qM)2-G70ga9Of3P8XJprC>Xc-5IoJNEy#j6w|>REPl(yaw{9Dx!j901*Hc
zl~4^pKwu)m@|^%s2nrri5CD`_NCiPfRV8Sd517<icDYjpA4FXcBr=MI$RvQ`TxvPk
zSkMR&cwZQcE~LSAdOm;R>rW*EgVU$y4j$b7Z-4%0@B6O%Dubi<U-|CkwdT-h<G=mR
zuf6F__l2zW{rA7=w?F(R-+J_EKVYuE`L0XLD=TR*wT1)hRGAo&KoO8oQI%D_sz*>o
zMMMAuK+wKJl}-epL|g{ohKnf@AxQuA19%^Na72U(h@^l-AP9yLRFweA2v=3{f)o@K
z5fIDJB|;W(Dh3b`2>?R~BAy6+5NqQQz>A2Ica$WCNE9TBFiYEckpmXSsKM~v54`)(
z^#^ai`}StHGrKhR_IKTfasH<t``u309X@jFiCgcgjx<KH;ZObP?|0W1r*=#oIlTYu
zxyvhyFMRjgf2cY*^3u8HQ>W(7&#f06xQsU-5D*|hL=;p84WIy2zIwDwn|47&A}%c=
zA|g`SkqA{lM2HZO1Vj}9kN^P?kpWOu4FrGa&~X4hckY5hKv5JW!@-AYVhM~ZL;`|Z
z@kD3=G<X3JfnW^z!h7{m-=?vKilG4w2>=pWW+Oovk<kqg)_>_g{^C2|dFS9zz13M;
zSe#~b4?XyWT736CZ@ncp^{1bHRgWB8zC7Ptn#)>icfaA*Zg26gKJ|^o)rIv=aqisN
zAN?mEIC4F_^)2ZW&(D7T%in4Bf+yp|DzYdbagad7fC>PDgusAU+NI3v<q0SvTT>V_
zg94&58&wezBm_cH&>#SUsHKTbaM|5=-E!#Au@8UfLvxF5Vlmdb+^ZJ^%(D(t#B4MK
z5MVOi7l>#GnZWyk7%L`G?_3ZKh(ZV!)F5~tf{I}_dDgt;?i)V*;a|Do`U3y~AZ@SB
zwN_@q=WEN|gkkUG@L+x9`0-njM~l$gvuEcWH{Mw^FXzgGjTn3mf@ja2^Pnm^F;aQ&
zz58$4KlO!&zw^zfUqh^cjWZ{~1GAMNq^xC<K~!LsuxXmor?wu5edvIo3jJh{pbDT$
zM6eOLstSN4A(xPT-~-=v$L+@t9oX@PyKXh8gp@>8Uu1_5?Lp{DXp0n4M8V}6Tx>{u
z&MeHTQaI<7NC5~XVnr+fgF+$bs<m3L*S_<vqks4Zzk0(Bd%<@*^Ou&-z0#h&khPZ7
zIoAu1Kl+{J#kE$eErm}zuG^v3nhOwCvi0dJ)AJXnrQ2<opxG+<EMa2rjTZZN(@(tr
z4d3^!J1f*P(nT$-HHGt{AX;YU@@$u&vYFdA4TMNUOvH$Uh|I){h>8Tvgv5ZXNP?tD
z095{vu^f8sCByC)f8l4Ao6FBU^TPSp{w{L?R86Gs{oZ$c_H&)nr!NwP!a3%`TI%)I
zqG~P6#4uTd;ynnsys#wJ=Gto^S^-C_-iNW#k^l0ae{9d*G0m<#^R34(y?XwI7oVG7
zn_XR*2dxLS>z&{ry1cNotF~)$&yEIzs-m`Z-e;~mHZ}grD~lTPSDrliwZHw?t#{r%
zG`S5-RfDToeD6DMSXo*5+R4)#kLMu+Dq(?;iXy5C0w9WLnVU)oAzPfQO!TNq03fQW
zfE&1sfuVnJVrgJ=?C8FCz3VN^`O#xL7naP&KK4i5PBStSPDny}@ZheuzU|hRUwNil
ztKM<@8)jyvpMCn7N)m^VO>EoI>2!-U5VJ@SuSS*0htLIWh<Zlsb^XmZ-7$IFjahT%
zQ=j<QlMkJI<~uL0G@FhUBb$0}P0}mE^z6*8Jrk(i^`)7?sU3*AaOSnVvo<_Zs}EL8
zY%NyKpMCAW{JVd<Z~v}$-T!@Wy6?MoUw4=jt(x%8dv1K;%*C1YGzgKcszbW^5<yW_
zbrUyio_A&PD(|SO2vGkAK(z0D<zvdTluBcL=tIA9%N;ivE2^&5UYeh~ObCXtmt}F)
z)vEB$ci!FZti0pC2O^Gs{@?t(jnst<IC|?nZ&;XLc;p-3U<gE{LJ+{9Az;D?L>1z~
z*Cw|eb2)zWfBxZL{ptVi&9B!6hf=}2@4Y#y4S)5kPXUH*x0zUf{jr_PSEi?@=hs*E
zcu}`HzhlR6Jj5Ye522MyTB*_vci#G~habCq<xl?ZuRe3{Ti@`u?|%2;8*d*StlxRd
z@lQYaT%}UagGW+OKtKW&P$-KTxCT9JSn4YDDr*=*6afW5B0!X&1b}_7LLxGs{OixX
za{A1>@4s(ia&l;3&pmIs|NN_;FS1U(mfd;x(eY8<yLa2I|LOnD^Z4KW``?(KU*)LQ
zYOdF-=J=th+pgd7oo|0;YHGqpBThQNjAVl#qYw!MTE~I;EdKJx|N4LZ>0d0(uHJF%
z#83b9PhPlks+lg;2M2FDwr}^2J&W@f)|<<J@uz=r`SKFd=*zEMYIk}^5AGfsp*!w6
zamSsv+<5bCODn5|Zw(ICZ@cNp*wExhe)o63{H2*^o_p%Yf9mJ%zV~~NZX4V)5LWUP
zgN;-wO0kE)7(j)TfhdTSpo@@7SP!MQmAD-c05`yXSt@OO570kFK^4^e*~k8F=dRJC
zCr&IZ7Qg#DA6;Bn4FPuS9QolNdH?r(&%KkAgCGS;_Sw&U{-LivL{x8Oy-Kxauvam?
zcieOL>OcG5oqP8G_1}JD@zMgIvSAOwV!>3X%9F2MeD6>Ei?!9+rIpoMqk3g!?Ul2q
zZn|mLV<#`(_nv#l$49!|?!NcEsnzPu&aeANpMCh@lNT;7h7fk`4)@*t?xWWqm>L^E
z^quZH`24{KAH4I<yYrs=&ENX3r%s*zwcq&Y+<*P`-x%D}oLgBv|DCh*ot;PDWTRaL
zuvaCc>H=s$H6?y5Gml7#15mYuvxrpw2V39;10qoWC@dWn5e!ldu+r+dhaP(H3txOt
zg)B6()Xy(0&&;k2506wU1L9!k_5&kBqpd5eq%cs|T~m|$_Us%PuH5_9H+=iC7hZbd
zm8pS5gNrO6IFtf4D|~Nltv5HfYOSI*nRD~YtH1aA|9h~3Q`^QCm-16DKKp?m{J^2<
z-rW4+*)!8;&P;cEP_2z7ak4z$Ir;UcS7+9aAKlk(uYBo?pP3jR%QE+o-}<@TyT(5F
zqd&fVY~L^Z;xB#j@4o!g|MF*+*4oSMo==8*SU+;pb_YSh11d41lpvxH<2T}Qvux~N
zuu;BjJVp^g`p}=C?~-7mxRDoh=FH3^-+02>T9y@=^UKZl@Bh)qKJ(enefUEky8Eu%
z&YwAd@W9PK_<<k&@b7%2F<80t&OPtF|K1yKINDxYT3uQB+fRS4+bN2~s&|Brp+HHC
ztR+P!NH4L(teL1sH73eM=bOdM(#)mVt}*sQzw>eDJ+UFOh1Vn=$a9I~2qk~vmDdbu
z95JD<)spZ1-a~JE!|iW<=lg!^H-G16e(pcrdfV--ym;}ov%PKziUB$8t<PRQzvu88
zRge@!0x1$%MMB1YC0Cwz{e*?8uwl3@`K$lU)zr3`;7s8;X!PYTf8*@=D@u_-FgA7q
zNo8blC3B(rjYppQ^<VqY!RwA3x&G!IJGNh*KK<hJ%N3LEo|rgx__`>n#g#f6?}LaG
zmK3!JzFp+&B#ziCNbbC;+T2Uwfz%*HYQkdEvjK#t5;uZM?t>z=i-Os<i;S3@D=JY$
zSpbmbwD;++d~13wtJmvYjMJ$4*+(7~L`5=G0RX_@y~LV#+spO1VaTYcC>kzf46oWk
zx2AR}?Se?<fmc4J<X`}lh_<pihHWKt@bojM8nwZ~brgEQs7Spm)T<+fi~jD@pFe+T
zX=b+b<a1|(q*>Ovcwu#YdGWpPd0=g7N2NOXeLwL2|N5(cl(|Ahs+CA2FEXc)GpUdW
zDiCE(z}OJTJ0TSt8RxtT7&4taGlr4C7|x2EOi<7w5E2*OqXIMKY5MBv^JmXbx4Ufs
zK;|NltwufwA%TQE&*I9Ugp4)Bh8!6MR5eIO`ygwBnd$RUC9K#;QiMoYCbEsR1w>a}
zt+bj^MFb9koJSkQnquKHYa>BMTYKz@7r%M(JDfBEnP$g%*Fj^{CAG#xr8e;g|LbqQ
z@TD(5@O|I2|H#4Vm!I<9#Yq&TQ;5U_fG8kAl*s~VP*Ol-6$oi?aT4cQDhNTudj$~5
zGBQ-;1t1Vxp9_MB7bY@<qT;+0K{6&NRO(6Ud=L^wM5tA&sdpM&WXKSB002T{gpzT>
zO$YghY8?brRRvWki7nuMm}(iMq@qAz1icqECKd$+1#lFxXdpHU{F%>vDR-#Ej11NQ
zL_TG&NnDvY^~&Ox9(?k`mDP{_@yF5D>K1xg3W!B;V2zM^6(7Ku$OrV^DFFj2Yaj;z
zozO9sJO<c!ZK|L|A^`wM1VBL58ZO^`QDub4#)SlB%8MXC0^q$GMCTlv1OXrj6C1?<
zgk+c^(E>n9PbnclKg|=CN2H1(mdv3N0udol3Ce<mGT$qz3K{}IU<3pqRT1x%iYTfe
za+>Ddjv#}vkrQDo{k4K7thI{2{F|>WtYlznonF^giYmDfyfH>W1vP-EDw{|_#fymv
z5wu8&MYRCbn2q`X!5g-vf%*VP5dawa2pctkDySG_(4dISMo<+E1FG{3WEg$$!3Xl8
zC<;Ry&}=YI{SyrlH%sLWhoUktm2@*(T}AfgABg=L8WaEwpa*4814<|;BC#P6@jk>6
zs{$JXzyMfQ0znxNm)BbD_JWNnO5NCCa0N!5P~*s!FHt~IH3T6*g8;#UxCkg#2ze0#
zSoX|BfE=K#d;u_chkZCGglI^akdO?s0Oro+L7exwsFGJ>K>;;jfQZO5=fQ>G*&v8W
z5JX`{Q9{%W_<l7KRgsyuV){)=e)B-wf;JEl4XQ`A7yy+43;`h`DyS+mt1=TK5Ta4Z
zG&s>bK*3xwapZ$%N_xGXwTJ;Qi28sUNC-&)AOvsF7*JG?;yIVGINCinIzBpFtyH2Y
zimXM|G)?ouIUhQmjsgOqjbmfDR*eT5)qzGOj$<UsowU2z!dmO{%>2yU;&N7~O)Oj0
zA_NZ{Ip=z54^WVR2~dSm0d<2uR#n)fNjHF1nceX99SsGbzH!U*5fKf7fP$8&ACZu}
z^Kle08W9XZEdT^0WmQ8Uh#8_NhOB5?Q<K2eqyiylA)^}d6x6FCr~qJMt>lIH5E(a+
znA>kW@`mF_ubUVd86J!*At)0tQ&HrFb3t`=ZA}7*sx_8L<Jb(;E7imhLGD};P|ya9
z7M7b&KKJ4yFP?jKVNHBy7z2uGQ1wNT0xA<Al@aWT%2KCayKEH5u<1}+(*0Jy)3Vyx
zG!_vVgU+Ccf&lcRQ+%JvP+=xw@_Arj045;9pdf&OOc5lqrs7;16iIDl6VSj2qK*X6
zlR_A&R4N*F@0fb)n{T<}`Wq+f6)d_aQg2ji)rv91j9HN*s*U4LCq*Qb^57IhU=u?G
zh0EKWP6+Bfc){V}vGJ)pue;&c!%w~X^i$8Id9Fwb%7)1@81gQZ^&Jor8Bp3vW-(vQ
z^qat)u0n?mbCv~A=}BcF{ieGPJn_W2h=;mG8rKnowI~49k`2BvNyUj*0@NG>AzIWJ
zp&%^`qoVpE5GT100Vx9nlLVJVmQgUm=+KTmH|*J&6s?<X-hK3jJ%a-=2WOZfj*W?!
zqR7N-4MpO74urL86xo=OoXe9W3L*4dkqk6YT)pn|cH6f*Avh03tr8Ay8ydX(<{L)s
zW6!_x?1dFEC_Wfl6EYt17%U(tDu5~k1w|?;=Fm?wWiJ5$v_z+y4%qiLBJ4vjWFkT&
z^RxfrhkyRchc3^|pSbC^i5;U~_|kbM0VxP0M5_)$2#Ok1Ek>Y-TIPF3U}6)vPyrJe
z2QHwXAtYni`oe9W7(IUAx&{=xMu&D!4pte+XNFBuuUeBt6cbn{TI4}Vfg)>d;qxr@
z2ml5{&!O|;!|c+PR-Uq<#2DY{1($<S1+frDDthyg9ZI^ApE)zXl-L1l837n0qb#Bn
zTU8X;(tO_FYPKeI1T5jgMo7}uR0RMfGiYwT`RE5fc>l$j_Iv-)Kly_{`D2&14(#2t
zclUv(PM#(~K^85777Ak6fCo`jF$fmGh!Pp&y)Y}PCk{b9knMKE#6W%9=!h2UT!G0Q
zdjd$O+clCnDO$4bJ-E~dr)*5EQJ<I^kK)KXkPs}Hpt`iS(y(!{vR<^h3(JcgaXl%j
z_1fgvSS4v>MOHY6hADR7!|pvhkF3jFbJeTXVor$tM%NI80Trpwb-wQ4+sx~r{epS(
zpxm0#HXmkO?tkb5-<Jk@>Y1~TJoLqgW#_h`pZaGXxb)gDFD<WniMH(=onPy?002IS
zFZ-+jtb##>P(__cDpUmDiy|XRCQc&e2;FdlCq^n5fd@s3G*=dJX}i7J$})#+YxSBZ
zpRR))8gKv-LQ)$DUZP6WT5E@PTe|7o<;%@H%~YaVHShZEJ9Y`hf#dnrmAD!KRoYp1
zaAb7b_>`<uEw-_VQuScin8<qvbWIN53g632R2qx0pVveLQ~-d9R1^RSv83pYC7TvG
zk^Mh^^H)CWV(^ySiR*WL;Qep?!WX~&-tYV2R@VK)Kl^h;1L_exqXLHDdLDWJnuXMB
zN>mu5gxc$Mtc^f*e0bo7!`C&Ef-MA&lA#F?nx=snS2LMeYxjD&VNTlJS~GUyK*~P3
zBy6oQ7A2Lem9|>VwT1Tj%+hip8Whf*pY0XjPDK~G?WsNc#>U3e=5jJR<+*Ms9;zn;
z0~G=RCNYEzs-;xpnnGt29^jVVH2ytK6%k9iqO2SV(Wn-+S}k{U_g!yz<dMg_vL?P~
zsP`j3`kuGm`^JHxT|fJ8{&SIL7&TCoQIwp9o+u7fN8==(Us@*(Or$|#vIa<li!E*+
ztxpYCdhJd#^Qm8*UGJ?gE>yZ<wbO2f!Z{B?K*DgXGBrHdOVe6Z**P^O;w>3ltpU1@
zWUKAvm(QJBPxJcJc4Lx>;jzJifz?hsRIIDVk9_Od_VoJl%>2-HYHUjes{>Wjm>d}h
zENr8~K<?9s4R0XzvY!a5%)Aw^Zy+q)uppMT7r<s1Dxiphxis_2<o3hOb-4fj_q}xL
z%xC}4U%l^pABYTAlQ`bL?e{+V7pGsofLcMZq#(Z7wQZP<sn_ZcJn$o5{>o#E3ztbe
z3Zk;lH6c?oIzC#t>FDlSB&%uf{FSBIm9w?Mf$r+!pbPJP;JriR<I~euI_*}iUKy;I
z>9en%J2lJcYJA&?y?gf-zSUY@T5m2-pTD@i-oE9wTc(%RuPm;gJ%9Pi<%P+ik*Qr%
zBaPaLH{RB1<)8oTHxKXG(<%z>wNC8cBT>B`$y&&hC{_X_MpY1Cq!OoJH9*Pd^&5k)
zqv~OU=j!_$l<j&1bN0gd?>u|y5B})0`wyPjv1@AE_U(=OU=VOw+FZ|{dg@8>%#a{N
zpn)Motasgc!;zy$vaEal?DH;fMM)fjpkY!2F6<f`I&pm0)KI0pFt;!}x3-$CuJmRX
zoBMW+z4vYR4%UV)Uz~aV`4_sqR`A)8{d?Yc>n$N&Gg_=KFU~Ny;MZGgo%PkU*&a=X
zJ4-8<&s@2<usVHZsTM^Gmo8npP}#9(;+e-Embh`_fr<9oT-s_4Rs7-o+b4Hk7bb_E
zn#&3t5D`YSCUP!-qQX@si?-(SvKhUl5-RzbO}{H2R;D&HJDa_9YW~8-&e`)%0`;7q
z|BFw4>gJn|ZQnK;Rp|Ra@cx%h|1ar<m@J5@hCJ;Vmb0&&dhFz@o%UKKPI6a7Nd<rr
z?LeiLNc+xXhle@urkU&J1Jzo*b8NY}cx>OEwWY<&mu9|m>P(tv&1N&QIIy(()H5%P
zB$S{GRQ4~;tXAsPdOT2YYq(Y)NCsayJyR>f&c?ucwO28k0M<D~oz~cJZF28;VeHyk
zCC^3&1{!0g_2M@^v;D+d$0zP?=ONAWTD_jTz=VKTLA<J#BA87`s?u)=ZDusxD4|Q}
zpsET16wJvdE}uKM5<)}S0BPaqndeU}uCyO|_~c5nbH^Lse(Z)rk3RN_#Q`GnL2Q&H
zaScFwy)@18q*^1;psJ{8Q82(*y*?gS=FXg{puPUkkqm4hpg5MbR#sM*ToxwCMI+U`
z5e*FuY#$%oF*;~`He5>>WWCisarf<9ug;y0*Jl?e2d6aS?Ngx*c+-i)t#-?I+EtQ~
zMy*ndcp#=mHQB#&`r_rz>Z)}-5{HY=JyE;+sF<OOje|!hq4~A4ziWxpQulZDeC(SL
zKtZV#U4e=ORW*-4ajw;I6xD#)3wxzXZLrx4AN%;1XXl!q{_Hbif~|7lb4$!N@<FDr
zEFL~`<bnIY|Ih#O^K0#tW9wC&28v9tmk!0Xg>#pCOY4*4Q<a#5<%0*WTU(i%zmhGV
zn=@IlJE6V%cieFEjnzhVZDlb68LA}P_wBiI>B8K~k`IB{3{UNHJ*_kbh9^9BJA0-k
z;%dE`#NCy(g_-H$p#iYmay^Ny7X&Z6#>Tg8-)1pNFLpDZI~J3~T_>he(URo(hm5u5
z)>R;eh){;1^c8N1NNfPWtTbC_3{oZlE@Vms6o281k6t*JR%*L1o^LtRRKwPi1V!Y9
z#nssd&wc0FS8hD<mcikvPO+H!E?N{2Fo=d$mX;SAwt+N0G`!MlhN6@B)>u`l6OEx%
z(^h9>bZF=PJ=>?o3h(kH$=d7D$gtXEt=ZYR>$<oy=u?R*LpjYYrJbpLJN)uOH(QNj
zX)dI`n+BJ*3tJl+;oPXOAlDm{vG|d(sfERMwT8Y@b;dXekk}L@QsoV309z2|HC97K
z&`l&!K7fc|qis<>(x?#;0T-eqQe=mAt(kx6tKT$9)rsfG2v$KL77XYL3_SpqxVO-q
zd-zd`8en7bIR+tuyw^e2<#uym_;}J=xo-O?ExOCI%hKvpW5&2TaA<7i!uk4O(#^WB
zT{zb(d=kg|j~yQ$8*a`_ueMt^9XSph8#V%NY{%}I^XG;YcOO31USI9D*4v?#`mBgK
zt{59fY1%2ez1$$FKmY25AQ}w}<6x2oi4rV47-Rrq1On00M*zz_-w!ba5fxS9Qj^+O
za%~!`JSsPhYXW-Wn8A{edJjQe4$VBb))I-+LIe|tY#_(Zn~(|Fs1CW3M$W4SZ{tLL
z9wF8f>jL%^qDEzEXf%n!`pN<eN+!m{0|WI|;h=79Bc9l?y*4tL435@DMl1?wwyu6`
z*N)1-K=8mxf{KG<W6jm|Uf0zJura*7F*Gs0W7qP^lFQP>nylSn@sSBD?Zwf`*u_qI
z<>K^pckE1dOlp!CR3B8F7)u7BB+RjNFI7Sm1yCso8}6f1++>`ujn1n#jg~(N%1{V8
zK`#W1To&O}9t8-B+J6%ij1UtuvhxxQpo)YXF?71!scl0)_Tz7S`(3v!zx;$J4G5Dv
zw_(Jq>&>BPlp~~=*V^mHwoeUScLbCnil9h+w>v#Evwz=yQ%%^Q_62!7H8Jtjw;od$
z#wW(8nt*^hVL+GVy-wG;(CoA+ipHm=ZoHZ1R_4|^sjuuzF)9Sn8f#+@0N`Jrrb^~`
zlkKBTOUY)f4gIc98I~KZFbPC}N<qLW<zz%P0D=O;h7*IT2MH=70zpZLJrHVSjYE&>
z42Qhv7NNNNt~dMY;mS~La_=s`Hn;t{oqP5lSectySY7~2G!XCIy|cZvwsiSQy)n+!
zp=@S;b#d;s*G^@5&+Jmk3La=knsLm4RH@bLmCEDae00z5U1bMkWPEsHa+C?uR&Ql>
z*(({FAoKR!+gG|v9&J-AIaYyVPz)+wCF0UFTY5QLEVY$KF4?Qi47Dk0-n6tqv}IR6
zKoPVMEkuKe5~*m(or0F+pbC|BC6EXZ1ECTG4H@{}J#V_>*4y@rI)kbabs<zL$@sQ7
zs>Y_CRH~KWioEN_>b3gt*zBb%7f)Yo)Q7XISe&2pK70E+?;9``$~|~xKyXgISEt7g
zABWVp*II+ag9uQwN#03|B6E2G#7Jap5&-8{7Haj%dR%L2HN}dM0k6btkqLrcL%r)}
zO4=*~uf<tVf-<_Mazuc>LI_n=C5XC!!i3P5z9E1p1Qk*As%1lo07#4qLy&@ucWLMN
zfgL~kkKea#e17)IDy#PzmRijni7|$Id6yF#C9(8U%eK|+j5kImcWql;Y1fka-~cz*
zmPf~j1n|=A%)sba6@WNS^KK}7ceR<fyJ;_7Uv1uS{MgXQuoJhuw$$!+6tq&U=2>ny
z>h!v3X=>+=r994Q(3^@Vf))@&plrC{W{<u!(5BavS1G{Va!EgBT@%1+)E8(-L~O)R
zAR{88_kp9n8dF4A07*cDq9{Q?@y-PWwvZK_y*tO=|GxVt8r8hpF)9|s`(mZFK8W?v
zp`li{J-@VoKGbXySL56ltG&)(ZTPwa`zujx`r^fvwUs;+pZxTvv*4z7?H(K-A7~5(
z?^>&COSAKfS7yhChSwIBh6d|LjvXyR5kRboJch*BNTj*iT<o@w?BBPZ7Mj$%xpBgV
z(OM#cAh4<3-;6s##4TeN^!H)cwb2Ltaz~A&09qJegUHA}C>ty_@5rToI~ZgGP=JI`
zkP$#qBOaU!{`%_=zW+UMJF#!4k#!P}DomQ^xs76qlIHsQYIC*7i;3Y;x7H%W#^6BS
z^NQN-wpN!`9)JAg#Kgpnx7_^POE0c>JB9PFz5L3;(rP8L`}gi085!BVeaG(YJHGPy
zFFbnkF<=@R8RWzUl(?QakVd^aG&tO8#|zDs!LhyV)G8+kgd(b51eiDkK<0j?7TF{}
zQ8k1BWqAmsg0O{96%p!-0deCd8rBwJbz)-o^4gr_F1E4Di%NwV12RcaMG7IP4*@bV
z$`Byr1~o|Wj(6Voz`Nfz7DL4X2B#q)Drz8rdTk)f-Nf*4wO$(@9+6hKkiYCg+K3W$
zxzBT-%h^}YTG8W&k3?kdxaIbs>On7Gx_s`!g~7qWy?gg0aU6UAA8x(#_6NW8rDvae
z?!ck__2Gf~a3dyE4M=9&#I|&JuosFRkFK^17(@^%bsnOq&~G-w)jvxlwIveEhN|{O
zl^Y%>BG?zdQ7H~LCys9)8Qxv3PCWFDSxcrUvTC)SX6uz0Q~&`~KtPF+fl$0fAF^I-
z?S1cj$NS#@eUVj@w?Zf+I8_k|KuU@d@Y3|$_|VYQ#C8BI64j_?V-zH|HtnR#vx~2u
ze)$b|y|GfQD55bocvrFU4abik-nXCGv^uTAIh(|)vS;7k>rY(&{Bti>8`bL?2@!QV
z9f(X+jg6`JEbAeiS@X@1piu)rKnMh-sbsT=-bhFru=Co8Q@Ey<E-iaCc>#d=g`fNJ
z>FLfVKJlgA`l_|$MZC)<C$_cQIU;nsg|$^glZS#CtPdvbPA18{Z+YvR-}2^)_r|DT
zz=(`S=vc4-i`JT6FTXH-rCy1XC_=Jd|N0Xm{@B4WWmXGf@$B@4`q*GJSeKaMY8{NN
zM}tuK#>fz=f^)<5+IqL+RRlEarMKLAOHt%muWOJApi-&igtK#t36Ez`%;cSQyQjy4
z8U#=Ru>ye#0tv!Dn3J{^J=kXkrED$gmQEQWf(8Nx1v4^&&pv%_Vdi4R+SH{3jr!eh
zdXp1<?6D^SjWH5}3#39~2_l3#(%!+Ln|JRX28u)!u<Ht{C(eTbQG*_|!mLW2ym;yK
zX$)?Ct@}5hedy4U1ABHg8ug?WS0K#>>-Dk0u?SIIXs)jIvOKmGEpq9lgY|l^)oQoa
z9STG?D{^BD8a{gD$lToQt{pp)Mp8&v>#V=}>Y10Gy?o@><H>=&>%B$~ssunPUO*5*
ziGa%y3EdF0;l_1Mg(xb0C(>(Lhno!!5JWODFa<9~8oU?rV<Y3+cT7I`(AS9|FLGoX
ze1U|7017V4>lK@1S@Z1Konu4sNG%T-8RLAe1nP)^z3-v=Br?{->+R;{#kERpv@$kv
zX>rM^h9a0a-Z8$tvuh0lu)xLF&c6EExh(gVV-gvvR)+@~t1C-RgJVd2hSm-YG{#5A
zCMPDZzy9#l)L1+3b=qBys-4uKH(Y6~_M{t3FcAZza;Xqi1SNzZ0JK%!x0RyVVB=qp
z@&7?zG$Yl$Z@8`Y%|}i@{+$;D3uXVp^Ut)_+Y*eiwO*F10ZU>O6jXs&VKBJWS6`5$
zJ4Hs()Dkr;&Hz+gHMkZ_mbRCg3o`@A7uGrtUOCk@jY2C?k*}<_$0`+P)g+Z2d#}52
z=KTDni%av%47_V<s#YDSR;sOLyPKwCle>0Zx4Sx6P17|p(8<$oo{K34hHGRqA6!wb
zt+zayx@}Zlr5+FMh7~}=nN(3D3jhF~Ab>Xv<rE$C0jHF5hqBwciBhpVFcr$YuUq<t
zTK1-i%<up4r)*q5e&emry?Un8PIvFxJv2P}!gHss9nNzX8ROLvcn}H{tYt*cz6k4S
zZ+>q4#8EFnRS1E7VDYLF46k=P&F13nVQVvc@zTspcYa`Oq+)1orIn2ipyrLb;RNbK
z@yO`zefxGswqiJ`CiQ{AQA7g@7(zGisR5uYO`ElPGB7^6y1G=U##z?sbczs<F0~eW
znvIQYbMa7G40wq}jc`N?Dh@SJzXG{h-;`GfLAOjil{$uNGyWEFF5+gjX#V_jUum~`
z`wtuv6Dx9Lqoaoof9vZ{WSOv{s;Dn0P6R^`XQf~f!|1y0#S0e>rkOUXDF`d7D?E0C
z357@=B#NLx>Hg#6`?i^rXI7qhbuG*A%B8u3JI5l{EL)4n3ZynRwqiT&PA~7Sb=GE<
z=Yn9j)AMO&;)r8TA{ieav`LbNpo*P#CwQOrT&vezTv-ei#m3-j9xrxW#v?YaDyV7@
zbfk(%3`8aCuqCONIA9Y=Y$$4Q(@5p*P0V$bqFG7<+3HK@E};gp(WBq~_CS4LWO#Uf
zz7<8b2!&x#76EUAOI%iGiVYKlmCMuJ%U6bm1{?~3dXbDEm&|0nI+}XSA$O#@f5aTR
zXV04sZTs>!&&*y}TRD{0qiA(;y;iG%vIq)OZE!Hp{OWpVad9!t3Irq{oVZG(GBH+9
zU9#5eM%BS;z20i4>O+=kN77CvwW&R;TI=SOo*e>H^C6G{p#VTAK*Au12mu3b$=TN0
z&0)jMw%FgNPd9C}sa!UmlTd`%#vyMbk}L9u9{vV%%_~R<0TdXEP>_U%_fy1EL>2@s
z7M<4gGtUoCOxWQBBXH`i2`DZO;(fq8XG91g<Q>e{w<p!R4{Uqsbm7{$`dYgvdfjHV
zQma%O-A+%XP@ti~k-gU)OsaJWL9$-v^E?!3cQv5YhX<7_F3pup;k_5mQeE%au{{TJ
zyS-yZ3RCr@fDQ<N2!H_$3y}s7(&zlHX|i6^Pu<M=n}_D>jMWcAQ9=SD5&-85rqJwm
zi~*&F52b8NK?=^(k)TH^)g9n9bcK*rXI^~y`WsHf@q{;#sAuifEn793ONC6Vnss|M
zMkgRX3`SfBS0mHQy@-ws4cf@$g|F2c;sl6mwZ{0iZHfp$=o?v)QDhLd6+X*@E-bg(
zS>anP5DGSq8pD;LisL<|vA4&Kf+GcQY{|Dr0*uOp$gDx7JnS|jtNf;v{cSXRsP8^~
zX7sAC4G}l-2B{B*SX`mOGZPS*IQGmAK$tv;YKXj>P(6?&JBS9H<J^%53qrel<;9md
z%UrM9Z8tIW24YCpmR-A5VT>&Scx3?wjCg2rw3&5hmlu<PdghCE)=i6St-0DuTY@=I
z-tI1~EMHE$%i=rD=6aqvL}rfCv}iWlt81<K#nr{;db=o^X_0d@G`Ux!NrywoLqJvH
zq<n9s)We}F1Vq?WD{oeXn+46*{M~;55fL$Sne|^sff=j75(oqcyoi$I!N;}47hL2;
z#A3ydA?%Bi9fk)(5d~KuI6y))#=Q2*sm6`F>-%>$Tk9J4Dz&JyGTrNdhC*$Ks<zu%
z9vo@}vdgJ-28Vavcym&(HZNXmciW>wLq*mD!jYlDwAXVIJOa1d8YoMtJ~*`2%ORvL
zr1Pt5SLT}+FJD2I#g*#ycisEa#ktcf3y1DJ;0g)ACaDIW2?W6$P>4K&3W5?}%e}zX
z7Z30{c(tMD`v*Hf0LG}0BC3c25(*JAqXKwWSFMPTCBM$vePoBhS#ZE&0zzODMZ(lv
zUzt98=7t^Pbwu@<YOlzadmTW+BxYeTm5Ab~>&@q$I#Wy>Iq|l4EuVgJU~ux;XP-$s
zXKIyb+vNCld-ukbiVr%!((I-^5w0YINvm)nlcFoGx3IE$VP<iDX|-PAH@^AU(D?Z3
z%QFvt^W;*nC+>bA#=$%j8#lbL0$TEjUNwlKm)Ai8fY+~cxXPfuuHOFp_A*d{bL}^S
zfLK+b$P-63=Nj7EUWbE8G@6Af6aa;gfRG?Nz@SdRFJHRomJcV9kI^eQZ>S*B!ZR`%
z+e{;8w}0-b*@s?g|Kz{Ed$HB(w9=uWiOI>`kDq@s%ksI!_UuX?C)IW@Uv0JppfNBM
znUzkbRph;@aa9Y%+-YZq?CrPSx@*sFr;@p%m$kq3?Jv(PHShhd9~zoC()A*$#wMUC
zfk#3m4zj^}{$D)nb#^J^aw~2qZ}*L*$ciAS9xy1NLPQh=jlCOk+5UR8w}$mROPm-g
zfSg0|5INuiFd_|^)0OqmZ1v*x?Nf23UiZ4(?)sXoriIDGufXKDA6@wTx31*L;PD%8
ze(A+0CVgk9-q?HHp4Db^eqq^(&a8BoR_0b(-8>+0M6}ANzQ|F+?(xdO-4pd{U8&f$
zXV<>ndkNSp5EEzspT73ex3jeO_6L4seD|@ywY*Tq7?c#i0XbDm{f6`F>_tScqaP4)
zV^&PB^{mZ?MY#wBz$*wKtD*?FVq0x!M>W|^>1fvWy$msqAP7Q+nuDeUV2J=~CepP|
zy4vgxW@;Ldt)nYkC-nnEi@oZ(<@6iRz4Ge3IvT3PgL`)Fz4X`@LsZzLqTO`oo^e}c
zp*Stj#mharp0%@{3q|29=wQ7z(x~j(F}7>xgcL5W$=L8{2tjf;xUEsI)m6!WHRLXx
zee5qjcIl1p`oX=2@2oYZVvf~O5xgR5$uWVx&QO~?UkSLbiu_<RWnI(D=o<^s88mqj
zxEyj7$K>C9*IoDQzkcb-C-KVJhWMORQ7zaYprSo?DN4+$&d17y%bV@CZ<t(%G9B*4
zBbT!)%ggg?g?;+;rB;B9D~e<|G{#42qoZpJXD1L0QG;!lkdwGxvnXnuBnqqEr)nxL
z3|Gx$Bic4xj|kf?8yIK|57oSe+R(_hBPUiKe9l80BO+>rFmKI&_0xYmwfp3r>y8~f
zaQ(jh$BZ>T_cn@yR}n31J1IFoMW#|$qlmzSssI>N36QDZ3{nZcPll;MWB@WGDWGKl
zYiw3@lNcX(*S-JvUGE<1xl=Q*Ezbk>Lh#-b2ClHi76?u5rHBL6z=R^?NX<fP)zRlK
zw3lC+d+;0QUpc?NlDU>Q5Y;8JqDtg2@f4G-*XK@mj&eov)i}slwcg4z1gHi#mDuV~
zJ#kq|GG<HzVSK1MR*Q<fL*zz=DlVi{t?xW`!jA8n?*vcQ1W$;7WI>H@FTD1|!uc0o
zeRlh{U59SI{Vn?rUhljoiUOc0s0IXzY$N~zva!lR5C92OfrwDcaWX-4NadsmAQGwp
zWdi~M14NwXS&;0mTW<QEcfWIdY+&J)vwLqmqHBw-S6}uNXUM6t4WQl|#}$Q&ja5ys
zoW}6f<@wnw7hay8NqtyP1uUx_AZr9H0T6hrK$)`+^NzcGX-;npqXUD>y^e<>X~f;0
z6Q3uQC>I&xXxGTV5D~h3Xs{7Q#`)f0y@HHt?ZEauBYTdt)wb5wP`v<eph!iO#Bc!L
zS(&@o?VWk~<*99Z?|joeyZ0Z7s&!)`2dFAOI3Sh)N=VdS_ynpd9*KYugcJmn46~?8
zD94FZH5kh_4c@DBP*f}&-M4$&a4k(+h1H=Q;|K1(<J9_EZ)U*;7BacTHshLL%LhcP
zTGP#nnYGqJYq3cXzyMdUN_nYYMM4k_!KfHSa?o4Ljvl`0<mW!y>*Rw5Iih$V5;8$B
zuEgF`A`*$2YBZ_@g^Qv%Hiif4)hIS`B~H~GKXNnHMmx>!!t}+6G4%ClePWYU4TFM$
z?=iWx+0&o@<k{iLorjN|ICSjT#MDk(sb^k9)e{06K=1)VP$ooV)xL-gluBKsTx|>i
zq8boXKo5Z<vO&;i=+Zc%XrPKwZP%?grLFc8pZO~1&=gq-`E1B%Bx{0tG``mf0euo>
z22%yARRRMjft@wvd;!55=<fr|oxb$)+56xA_ES%tJbn7ytw(n&c#cR#tChH@OS@Op
zFsUGnCo#B`Q7TDH1idV+)Q7uH8as9j?mXaaV_|u2X>K;MQCgNL3J5?7B!cRR)LIe=
zA`qLXy>Q{tnRBncaB|<FV|(@=-nnOgbznGv5d<$_Ab_z{3KSGXHz`w8MHSS()Kmb_
z<Uz?=Qc>qc@+4wpMIu|PYgDU^Y(MZ8{JTe=I6Hl*9b7Z`4nxmUV53R^q=e#?(ME=S
zo^ccr0jUQKhEzciFaUTF1bE@xxwpOjo`3X1KlVTV-M?CDwIgdnw-v`#Up81YR1zCY
zh*(`A5m7ZZ!lHmVau1`s-*AtQ8Xox3Z$H*AYl!-L1{9#|PpC2iK`8gop$3Z_C2@QC
z%2NwhPCfTzV`yw>eB1Wj`*!a=Ff=k&t<(TP6a$iils1xbBnnMmiHfKypkRbKh+<F+
zgsMew6h)a2wSi%4Yx8OT)ss&?x-hdSxi{eBC=iM$C@~Na7#pc70)^lzv8r~&D-((j
zfN0nT1rb#QYfV>OjySge$iX|_@c82o-goD*0q^p>V2l8T5m|*OC@b5DKq0u?<=w*1
zFE-!&z3&;`eV`SLG3N1;C%so7=u=gqTE0*~FpO+n5N0&7an4z0kvt-Ztp(q0&UaQ9
zXD**P^%$^?s(beBJAT8B<J+!l3{Q$m?uCepAXpB<qCpI0Yf)7V5>iluOoHmM2+#{s
ztq+`f_44D7KR-Xa^sR3_f|ditf`|(2AreJJLJR~!T>t=8A_4FKo{&)3pcO#{1E54k
zQFB*xI&C4&M8Er={Mgdsg^RPxdxshV0M^D))a_)wPNxe#plX3JVKNYBX>ny`{lwev
zzy6JH*JQ|gyfS_H%xkX+uqvPgLQ+%(0wh2a6g3DN6Oe-{ng~@bt5FK-R71k$RJ8}>
z(CM6hdgko&PmJw2aOnEmj$VIbV|XO@&HyObAc#Of3_$>eP>qUX08+JN(g04e+8CXl
zp8N0r{SQu`z65M2wh?e78ju3?hjLXVfG8koFbWh@K|G>RghGfB023l85C9<saT;WG
zaV|+BCt+~kz90M7KmX95{878LIx;ZU3(iCt8(_w@c9*NQv{wvNk|DJ7oqX5vTi*Tt
zpQw)S={TrV%~!tk`PnPeg2;r5a#gKP1c=B+0e!z+!Gr;|U-GajKmZj3;CukU#6~d&
z=X;BnPG7lv`NC^2+<y0)_Z>b)92edZV5!FvPy{7Vvgl9>@wsSFA{WpF{P-t6dGXS$
ziK-mOf*3>)i3Lch919JMuH--fNW`cZLBJRw0Zc?~P!=HoLtrrgdS%tiXU?8Gea1!=
zCp38I#M?jk|Fk6*QyUzesMc!(!-KhZNxgw=9hu7b<eG3ax%-3v>fhIP9FVAL;$*Ga
zeB$KEPOpQO6p_IoQn|1Z36#W(F9CbG(5cjE1jSJ1p?=bK7R8{5OTlLmg~5sr*y76B
z=Rf;5fA*(;_`6pwyb@ak6%bYF50;54Rmn5tWHnbG0D{x=XD&VY<g;iahf0>2RU=A`
zdV@&7&`+sl`7H_oDJROA1xS?zNKq9<SezDK3q>`Nv1HGkx$wx>ztL%}s~8Pt;OI?v
z{@@4CH`|%&)Xp7~JElf=Y}>tiU#&7QF*Owpjpo(SAN%*e7Vka^HW7d%rqi#UdFhqY
zNu^>KnHY#b36X&MgO|igB!<wSvh>+K0a9Q=7DPoXH=+gr0Td)fP@g8yty_nAbN=#c
zUw`lmlBW!U{rRxcXh1g|y3SysRvn2FiPwj}@{liz+<UG>UV>2xl6#h*9wbl@5=8}4
zBt=wGAW!58LA_CDFhlAob(DJ)JBVF@xdREtWF8)W?1|>`YRH37Bw+Wx`JS8KbN^Da
z1&q~!+O}OgMux_wMy95=O-}6D^MgP8^R-=v0gNCsfh+tszWK=IE3+n!nUsitY`GPT
zh=_zpBMXLwArN>{&nk#zswM>zAVCU<g{l_~$bu&I5_}<PvuZp_FCw=%clpd~rwsL%
zi~*1$Dxi7qd){{D;+fe_j}g7<+FEPj%5+|MQ?C~48I@HDA!s=ukA3}WzZUO{@l{n(
zB2oq?AYKE22&fOlXcUYBArP@Sd*NbpwYhDVAfgwt7#)B6dnD_vOrPC#;LxGLQO+sv
zWS3UwYTNe=Tz3S}I0aTfgr&umhaUbqFb9Q*$p-~wfX)6qA}T6Mke~%96EdLz1?`{x
zS}qJx5g<|k2_jH#yFiXG&pMHb0i5%lS5G~6?D(BdN=(xKVs1Kd=pApl?XUmt3&2sZ
zeD=b{^>!QL7(grl0ytqJG+0iBLw_0%K}9$B-O$EbPc7d@u;m>_KqZ25_YDy0mD%YF
zmo6PYaU%3QN36scj~spH4_-d|TH5V)e3)OIyLj%(|Ni7(thC$z^4!W#{`5~pkyQZ|
zIQjVF&p-EEC5ctM3!a!s1DUI9=0FjJxEx?rQcwU7ps+<wRLYFXRw_aXKeUkGkPJpD
ziqZquYc5>swwjoX0waPWR3tW_#T~btc=nlR&tID5sM=g#?>P@h8a$SR>g9-(lmgZM
znls$OH<lM61`q-wq_RroYX>}3MNkXTXJ2^!?eBbNEw&(pgn8~i`bQuC_{TpUykA>c
z^@R(eKt>||rT_1jSKGZ`__zNCne)8(#3w#MM9vk~5HkaUxjGxcptJ!Y5utpS%1w5p
z+Sj;mwklv_^(JTtA__pr9+=gWie>CHm!~gYICAs$X4*v~DnQ6oWZm66wtdh2@2S_S
z)^PA%B$QaMtWP(F`ZtKg4Jxe66Ibt-PjO2-0I)Ca*=kc&ed*<wJH4(=ED?$5hkpGx
zf9=<P_1w9$OUp~n73Cx|A$nIh=RW$8kNn<8K1vMV`qrb*JoAjT)*92_#iJWb)3&T+
z*yuG}y@^|{&F8FFug!eIDq50TgwXA^SC{8NbHkvb%#j2j2G1zB-h9KpJ-dQ0LdXeq
zW6##69j>9yw%*<PcU!;Td?MEvOM#eQJ$?G}%#8CA)c?va|H^Ov)^8ThRVtNUuNNTr
z;A|9u0ue`1)a~_t>$iUUZ$9;zPk!>RJDqN+Kno!NkiLHM88%xuTe~>kdl3m6mzJwY
zHweE?D{eSunb-t0zj)zPb9K&;q5u&iGO>CHdDiV5IdqUfgAbcR`OVFOs{QukRs+3G
z!@4Enu6@_Gyz>g`B&>Hj4?grYh4AaY_MzYX-TzV2yIGMFp>r;1$X($@R5gUa%$-j6
z7k}{=zy9^F13(l-y0I4eT1%Du=d}x4HzHx{8%}@kX9-J272s+Jsb#o)>GbO2v?Ylm
z8wxQdCeon3V3hIk5k_Fd;DZ1Hp!By<s&3Tco6fTN=4{$dH{^$#H@7<c<{e{9;fu#k
zp8TEP{-3}1kw0+W6-6N;gdixP+(BHfVMQdSGOAjwR<GAH#%Q^Sh)U<W8s@6yP}0>l
zYWWO92&$pa@<|CxuRhgHdud-aSyC9~w5Id<`nlI$5Z?m{OpMCLAdreBjx8Hz@D34z
zl-hA3VnR}opt!l7c&mZ7M&C8zx*^%weAvcgNJLJ(^73;pJnx+^(+e9T!84GJjYt?8
z8WI<xBuTTZ)9KkL0)TQiYf(5NCP3{AgkU3!_M`Bc_l5}-B&cfXsb%w-H+)D%`l@%_
zn3Dq(L}EZhiLIPH^TM0&`!0^FK<q&ckusq=Awn-chyrcsNy-s#6+r#_*7^Hk_<ze^
zh*&<?4Rf(~Ax*P#9D%L%-p7&snV<RTJMX-6YHAWdNvYH8&CbpL%76RS3l}c*4-YKY
zhSEkuVbezdfT+Y=h_L1G38Hv4!uk!=ayf`dd4`oQ3XuRrH?UawC2OzFFV9_>+%p~!
zkkFJbBLor9!h4`{-i(0&6jfA300H@$yuRr>TTQd&uW;+lt)3NB2*?LDYz$LmZI<>x
z_5S<s|A8O){zHckQAtq=co){1>u-6>w=YjmJMYRNK*SC4@kYF8e?!vdAj#D>eZM^c
zR|h3Z<;><Ge)R|{rK2Qe`G^4lJ!44o*7<X<?$~pSgMcUoR25JV)2s+V$V7oq5k#~<
zH-#lqk-z`S|G{e`E?}#1H+MRhvN7*n5=9|6QDNfok<okaxo7vzUBo0o0Du64531U1
zHof!xz2w+mIt~E+{i0Y((NIfX0Dzgx-xxyh!HEPW3mYjFH)bm~lGNtgE~2Hh96>Dr
zG6<mo$qF|0Hz;${my9X*VFfA+7$RC-T@zJN5bZPD{S)x&ijiw9viY>&+N`wo+B^sP
zQXWtVqM%Hqpm7w1ydcDT@44sZn{KMsYU%@)_|{8NxHD(YJpTAeVk$R_G8v}LUwZX)
zV`gT<Tz<o)MZEXHhkx+M?!(b7rc(5(LBaP!vJ?+VVNjZ@%SE0MA%K{2zcnDQtTq)<
z$|k-NV_BtKBf;7FD@z>QA5wVTY}FPEZXP<NX8<A~5pxIv5)|;>d*Akf54``ny?ZxZ
zu{^leTkD_vt52>hFI!^-h|0n6eqkj5KunuY5fC=Fzk@=Fs{o)>#9YOBTk^){87eBO
zT7KdQ0Dz(bfdVso(IU@U&1P-eFd<TK1%LuktJ769<wl+|HQ)xFT7o+OPz}bAh$qqz
zf`q_?Dggn?K_ANo`f=Z1-dsZJO=x47q{x{lNs^%O&Ud~0Cw}rLufO5?I7wimw}QZ}
zx#efRb@GWvzs+O-Kp>E1<g#}zs$Rh%if90YpdzROLDYNk;Jvy64I+vq1Sz%j<pdlF
zgE9tGML-bLpyCk`fEg?y0tQ9(WPmEDh9q>>mm^{XOC*6n0kPHXl^y)DGDj&Vn}Pxw
zYXB4>SVMW9Cb5;^Rb78umUE=S0OEXJ<Qg=JqEhy1jDc%v3zZNeYeEQlQJ5&X?!bZ3
ziLp3|$r6YVvk1)3EI#q=lb`?0=Vqp_AcAZz^8kfVHesZk*9~4EfHf8on1DdYdn$6y
zon}QOm;{ZzvS@&iiz^_MO&bY5h$m1(Kn%d7h@f2V?NU}Da%vH+xV+n1jf^3T4Ke#d
zgkZhZ5>;XbRgplduu(IM^Q`bw|MZ`3-?7t&&~CLaUc8v5X={DG+v%=1Th6;Y&jHYR
zpBF`^-HqZHRHZEOw}e0tiJ~aYa*iyiee%gC-*(TNyPa;WlAtjVU~y*dt6zKQ<YOlv
ze(K4BnUL8Sbq>9PP$@uGR#gy(Rj#TJ>Xk?UHE}Q)*qTTU=edh8mJk4>SHU^xVH9&N
zCM%dM0R|Qj@=iR9f=30^{^o-63lb5i55C=QA%Y<=K~zAC!u7IV`3W^5QnHS)QK?6f
zWu>vfk@tT01G^6$SYKHA#K%5Xuh*@OhKGh~)j9yQI_=f9)mEoHzp(JdFMs8=)2~%3
z6~ATQ>_+)Ph4aK5**JLr%BfQ?zxdMj(b4gdVer|){Nf{zeDj6po_*=uxs|kMqZkAw
z_YAC}WiShhB8n=34O;g7KvAs0A9&-NYp*Rd&<GN+0k4*##>DnB)y{7}`nP~+gs7CB
zss{<dRCDRO$3|_ZC8$&cg#dug<*oHq3AqRxAC%avt*m=5MC3)VPdbBc@Eut<-99!t
zF+R~*Z?_lMW-re~CPKj^ib0@Ab8Dla+F-p_%k%uufrBH1BY*O-Kf63VZ6e!OqL)CI
zkdT5GV<Qb<ZIq??6OTV}$IUmb%`G6v(~m!K@ywaA;n7Q%uP9Kt6D|}XGPdkX2tq&-
z)S#+_8bWNa@R`><Lca6x(d=S-q(D^=Yb}ArO1(B^w-+&Fki}I8Rmh9rfJKcss^kh4
zRa7lE8WEBbmfKhm$`9<(c55~3bs<iS0JDka=NDWMz;dp)q|dyn0I&i?Q8Y3#Iyg9N
zZG7d@WoshC5h9I_j5it$1n@pEqM$Id^X`^gZs}#&U;fo!PG7lV;^^uTiCC_pQq>?H
z0}|q?mtI<&pPw2XnZ0~@=JNDyx7_;WhaT=V*JBf*2m=yZR1gMW3MfHD5L6{l1{jQ&
zUE6lN>wyQta%*<6-5eY142^2$u<II8b*-09>=|CrD?j<Z_t|C?PcJ9Svpo)cXxsW^
za{h`w^~9^*rDDia$vmJCsR9xbkTv85I^9;cyFS>MFo=X~mR44s_kz4p^=-^jD*%9~
zCe`YxS6;2v2PVeHpLzDFW@~+DXlP++akbfuthL74$Vdo<E1Y*o=7!_P&)$B=%<L?P
zC=qNH+v*WmM3N+Ng^P??T3UMXg%|g1-+ub^=`2kzUbyhkgI{AGG~}wJ6ij5j1R|p(
zA^|}nQ4|H&8A82bbmx6<dfSiw^MAGW{JAfD_KV5Eq1xettMiN8?8T#_vfjiyj?R4Z
zr5||HTcRt4=&P7@x{{CW+n?Wd-PgXe_{zyMO)nH#>T{GERR@ChSIt7V+v;?hBP0gM
zc!8yrl`PLGt~)7tYT=D#5s0V&7q3iz@he|_@Zqlq=Z1!d$3{nOWNVdrc{S?wY9+D8
zSjz%{7|PGyC`ke=nbuO9g2+UOnCArnI_I*i`}EUKA3b#N$)}$5UY3_vXJ_ZQl6Vmn
zL83xciG+gpg#m~aDfh9+IO~b=p%atacCEITzVOK6g#}&d)b>sq6vsJ?V%xNG)0tae
zMlZA9d0}#u29_4Nvl@GsJ@;J7-SmnpLKY&c{q-sgr5L2_t`e18fXnk<uT7*TC}f3i
zwz@9pwff7l>@2gLuC6ziS671s1SB?w*;pH~VP<1Y9L2GXs!3#-lUg-NDoM3={=x+)
z^Pk8@0CK;!Qvm=`Bn&39&%f|OwVJH2t!8O){^Dg}a^QvfgZ@B(3<7~rjiN1FO>nYO
zf5X9T?|a+z1A`Ouk6(J}!@tq34DWo)-N_wCzxBd1wMOmsJMKL7?UOSX&fRwS20OgH
z_3UGVGj1?X#pOV-c6r_pR~MFD3vwYOA_=fT8=@eBr~rrtYol)3b$P~&Mie@|?&?~z
zTyU{5d?Ba;KnmFZC@2CVW;6iMS8O`xoYPXR0>FS6yolI1axRcDxRKX4=3+p#Pe)>@
zE`vUiwAOAtdh+Cfeft*IR-2s;L?(j()c@!kBqTyh1RgZ^q%c^iZ5tcgwri}hce0J9
z*T8n@buh`aGiH2SG6=NXTJt1mNQ=~`dEuaAO)K+7LP->LL1IW!az4`FgF#~A&AlS!
zr~MIPxe>nTW!^bZF+rfU-s$#w#+b5~OGt=9+DBT5iiALfy7{47p#)%r%xud+1ymrz
z#<26A3|1<YUYc&uMF{11XizEtB?W*`A{%BzqE42cyL73SJ29wKZr@N)AXN&=sDctC
z0H_%1s=KtZwD9!eS1+FHq&cq#+m<}*re9t4PkdvxvmQ`BWnzYqXT?{adj?wTwX74o
zQzM0>H6YD`T)w!%k%&f>3Lt?;08tSIMn*ss5JnUi2sq1n-WLX$nyr@09We(~1ria0
ztL3jyAYc%6zUbG_n`>LjQmPcrfr^TFWy6Zv>Gjw!BFeRMFaTu;5|p1I*I$eVgxKu1
zMTv|pLQq9Qh=gKdLW4lLcn6p>s)Ey^S>&<?uGzD|k+seOhm^a{<>U=YkgkScF!dRy
zX%tjyjrAfeNSN#EPK*KXeW7a6iz@)F!KkdYbmNm!${|HBfjL@UTy$Axh&jztCms+*
zfEfG3=zXUk-6&Q!7Mk^&DjS94<_;17q#z<*nXR#giNXdSqMK|J0zlXpEkz_CL=Bp|
z!bVY%dxL09gbYR?L5$Rhm)toAL1IKhg{T0=mI31s$SSooxC%CMfe;)B2Ci`|xi}SJ
z%UB?rX6nR52<#jM5hkQqL)NxTfe?^Xw4B!kp#JtT(SQMf5pij0$vgM|1I`s1KY8JU
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
zd|-e7=YQ@q=gz<W;R6qS?316JTU`2+Z+yeMf>2|_k%|z+*(@>$%p7^DRYHW$d+#d7
z8YQ9-ilo+P!eTr@L`_)N4oDXJ-D8LL&E;5CLk8tpz$T{EN2BYq#)wE18Aq%(ybR0W
zTtoz;bYj379g9jfwgs@$$`K`oAX?aX(rKo(un!Q6P)_S<Sx(30cq(CiGTy#*8<i%d
zwK9nHv>H_*c%(an&58HR`wtyGe(Kuo(e|AiX{((rrQWuaq%9G0oAkPEV@V`LQO$4(
zFEMfikY?D+z5Z9&1!X3hM7uIN^JsPh{rgoe00G@2#1ZeY12g`<`FtIGY4Z%VMrG#b
z79V}|(Hl4JOvYmZ=1`aAD9_>jA9&=K{);a>`tbWsKl1dKzVeN?-gvF5N@csv|BE1m
z0u-4YNCgp<R;?7Zwv!@^CJrztg#;jx6)39=vS_7>;81*~%|bU_=%o~<66&f{bx>f-
zf`_gy-C)#3TNl+h`f;d>s&Zu&gNU#p?4;>@x0@LpkH?yHrcJNY1;ZesK`UjH)#xQC
zmRJ?#WMi<kw!Ss4>Y5bhZKIR9-rUl{Vkgh55Jy!}fgCb$ZGC-nYg&3$PTZ9ngLXT#
zVxG<$W70gyEu{<nZacM10w|<ZP*Agr(Hk;a(N1st1Hd$?47#Tz_dvThOSLDEXndJH
zxHg%P9fb=30<1kxQ<G<uPm6H)@bO>%<zG2>?vijE4cx)~s|)kp>12?n$=~?vKex74
zo<H~2AAjjfZ@uvjQ7Vi;)VQGn(P~Joc6E#-tE+Pd4je2CzJ9AJOJNp;1OgHz)IlO<
zNoEyES$A9Z!0Oz-#ZJp&?IQw=C*{^?aP{UOK-}8in67Q)E{57enn|KaDMbnaVhjY*
zGRhM6Tgk!IrIcX4Ws|vHp0x#{5HdyphEQNA*;iFP8BPZ4+go1n!13cpkDVM3i)vbT
zvpi4Jl`Olvy^-`<AOFH<hpzhP|NLM7@gM)`^1@1H@))6*7MM&DZ4Rz1SCI}Z^n0l)
zHMm40SV!X7i-0mp0ZEAPF1Mv&+IG{2y9!ix=+C_u-zSYbPV57|4D4_>`jyvSeEPW$
zk0&^pLVs@G%JTkS{^ei!C;#{#t*k74{_{Wn{D(e_!sF3aU<6FR^3^Y2yl^Ek-O4M3
zw3$v}3>9Uuyp*1L==j|`7e(Y}e&(l7pMLgte)lV9&b)4rir}<XF@Q#mphL~<W3F{O
zrIwYWhZc_=UTG;DZx+Mhcw;y{fB7!iR&Tyf%IGvN#v6a}Cw}5HpZg0*mfyO0`}UpN
z<MCK2Twa=Qr}o<A^Vcq(oo=naa{U5STchopr%#{i&-b18lku7l^<*^M+S<By_2#sW
zCy$@{^k=^C=DCY&qv`Md!Iy5|T0@3Tk}b5m-Cp<fqo-<LeEko8@8M^j{Mj#j_WYSE
zzUD_x9xuvjP?gG+i@o;3{ITt6vCz*(lg((fG0Qc31Wt?&qJ={QrFICh-KPuys;R4w
z42{{_li=Os#O#&7U62GDVUb<#=Dy4HwVOANpPu~2Z+`VpzWP$9yL|eQCr+O}@xluq
zedp~TDl!UnS(bro5Vf&AdiB*G-n?-Wq>rQ}g3=0rf!QcR46Te_`0#Ucb93)|_VI6j
z^TpR+eX*)WNIFX_bC?ak0*!*v2MzJqfdfl@eRz4!VywpFVl<o#$FAaHTDxi38ct%Y
zkMCdn`Ct6YJ)2#+aCvikc>eswn>VkQbs-YGuTCC0{GsQb`q)Q5I@q|)q3q@fNgQr(
z244$e<?HROP4?ArV=Fh*N?YY{`1(sPZ%*p3zxdMp^1gODEvBV0$#A$m+}<dQ!QyJ4
zuklOY`?eE(aG_mQapTU_t?jLetGf#e``UVCsrT5)NAiOQ*JFNmUGCP?Jf9;8E_jV(
ztz`!G0d^W89uTbETBZkN?cHqZ-mJymB=BDUXa-?X!q#?m{`{SD=kID;y!yuVmDTyl
z<nCaw_R=e_oH~8@u}4m(I$?nxCyzh*`1PCBt=pAGEu@V~LabwS%&{t_gRS+Whq}Q{
zUVrW7mtX$=#`+zjfI&EVL^Q^TCj`uF*3H`#V<Pe7!NZ4^=X7wJn_C-eYnz)RC&_`;
z177szXe&vQXP<gf6M7Eku3S5R_1g8Dw~OhN*((LED)9QP5W~qs2lg-bL(QATXmxeb
z6+GIyTe=DrRn?TF-riVSoLlbXo$(}W+`jwvxl1c~XSBX~^UgNMXoV?yLom2|BgfKa
z+A8Vw`n`h->s!O^%}HCQpxa9;%cqYlEwpI;#@P_-xr2`^Ci$qAAY4|JCeo<|Mq$1e
z7s7)|uZi7v*^q`colRGK??RaeS@OM^$mW|KkMZS~&tJK^Rn<1Zv?z<==voLHER%12
z=f&g44n6eH={#vorscxY{O7;$Qx`6eE?)g^WY)HA3=%00q6n?gMk`~~WHS2x58inD
z?dx?VS=tUvMO7GUwbG2LcEJZ}r7eSCVmy85;J*1}y0O->cBwx<o`!zbo75@@3a4p`
z3CWf7=k_hHUc7wc+ReLOL|L`Hz8$>ux~9|ZCP})sw!V4mTH9(%xY+NH!$fJdw6N0d
zw0*2bgEfuVvaM8QZZc8MKYaKI+w9iXHmW29pI}4|nZ{g0H?et^<h^`uWx2DuxX{sZ
zXrZd=vZ@uKaof(1FTMG;f9LJTKdRFHqp8X!KB5a`Y=Wk6H4A8?`8`@haSsf;7{2T4
zZeC(`>|P+aD|SuT2)pde^_#`H^JllWBVfC#Nt-sHc45Gvu3o=+<JR5LxH^CS>Wkm|
z!Rdz|KX&S|C!c=u)i*9)zPhfk#UQANLo;eorAe-Jk|aW;r_-XSu-$G0p;Edj$3a9N
z*@b|JmT<n+TFBdexV?RQ4SZalUldAB-r3xqsw83P)#Y%ybvF*C17RL*cQKmOqQcDO
z#^(Kgx__yEV0lrqtA;S&Z6ylx#NJ+8n_phofA~<kFb|>1?<7@GwDVp!>0;FE(WI@l
z@nmsj;dBVoVp>%tSCxU-PE5<{JhwKprk$o5^kTQypWoWt+S=GG$Kx>GRPElu<^C&g
zTv)$yL7hAx*b?B(Bmq%Elf$2lk$e|~_ater+Pp7Wzw;G$Wo;In&@8~8O^@b#Zmx(v
zcW!MouBQc%O3OMJ(l$+@P9&57$|SAr?dmsw>np$Y#ou}Ok*A*j*e4?3z5^>a?rb*Y
z-U<<j0&|SSj8z#ro%t7@|KwmGZ@qn`sDsjI)5OORIG{vSBnYmqA;#7D#d<i|x_Nc`
z?%iIe)1Au?tSo!M<+-{3LO;an?yYOXjdd_kZm#tax-G4ZYIob6lLuG#?+YQ+<+RsM
z7W<2Bd!*aRwN?Uh@ydm?NWdUi4L0x0FM2+2lDylWGb*(<+Z+s6miqZzpAkch9DO~W
zx?&8$FZ8=vp4P!lLnXoIX_{z-!dha-npT?3_2&-kJ8<jzS}Z1hGWMBgEoq)k>sW_C
zHbDZB_@4MZ0OY%c6z|`;2RZDdDP|$a4B&>@)R(VrOo}piWs-KQ(_)N)YZs$LZfET@
z>8`C!e(?QwnEU6>uK)1$U+d20phYEGfNNhHZLBtw<VayKDz03+wX(veP91sv`Hz>S
zdFR44rFCQ`ts_g2h#E;N=e?_fReJ08-C}Fl%Q`Fb%M4Np$GSXxU~y@ov%Ou`8TOX?
zw}-bhi1(F7nCrHW96xyC^y#_9`N~zp?JbA_gIB-{{hnP~oZem2S_x8cQR*6u(XH<B
z(~s4|Nfo2XvoIV{N(YY|h`>pfcRL-0SdS*7?XA1FZq3j4^G>_;wQ(gF?EzdJnF%8F
zvi6}v2gsO>^}#}~V-iy;1f@KP1`!2L*l1D&F~s-mi{A_012q<~!@0n_l`YHy$!6~X
z#s>iOU^r4n>x4iD2Zi&FxfBp2WzuYIWBA<{Uw`w>n{)jGn%cmlt*uGGG61w%B#6T7
zMNn`!D#m9v-a0dBwc1ZTIXrUY;okg8nr<nh$JH>=Rul*^Xi|w)R>dG|H*cq97AKST
z;$kbwx5on~wJ{*o&_XhoL2PSEEiClwagBM}>9!YEm-ihyu)4a$AZgOEgrn{4;do>T
zt;xV<o123??JTeCYjx*<vT9OfNs_d>*RI?soj-Zv_@PdE{pO9!H_orFE_Y1g%i(lV
zxM@)rC9^AB4U&4J1X5$t7$j<wca)z5O_1lk-r`(YGb)`VS;$&qtrv{mqp?EZFe*Xy
zBZ55KQ*!YhX8~}h(|#{@@5cT?2vuTza0E(x#ehj_nN4&mfQqbMdF3suujknus=Tb(
z=)4*6sD)kS(zFH4q4q=&nY@n>(M9*-_g{Ve%yl1>NpnU<Woj2dp(d(bHJOe9*d#D2
zCaoi@#dN4aRu>nRmil*xn^&%%cWvv2me9AX2E-F5j!m{F<L!;P`ChA?6~%acV{KBF
z<MCuT8YsYH$BrC*=#-RIar5T28#g-rg{7taNES$^SzeZ9dvPW0-7L#$b2PMxJ@VvZ
z%iCMGZ(h54?Q&g|t|&8|Or{egT@1GtJ2vZfJ<D(~LDIGIA%u3j8;7Hd=dK(^uxVQ*
znaW!cAwbl|L|1FA6-p2QnT_;(PpIBgg*Mwx<qYm72>0fgX0#69hvF=>4^m+>MjW+O
zS_AngC`h8Cr<=F7Kqg|cAQcltjuD~)V}OX2jZkwC6+N?OiKvy%eSkWKi5r4SNm&63
zOvWf^YK3A{>;a$(aA$iX?>r5YtlhG69W$I1T$f6yg_dg8+O%z_6qj|nRq%co9rz4m
zRh7k^J4`BwtQ<VLx_@<kbx|7~Tv<dn_4U%?;a0aNpiyNgb&??_c5&bSyVq|FM&;3?
z%L<crd*R@t3tX3OJf4h4#dPYkL@U*9x7)oAB6(zsF|bDj<WP>MYnN_Tb(wWKt;OZ;
z{=;KsrXlJC4Kfh14@O(92tkk;rCG!RaJQ}So*%hGk|FLcW`GDpv@`nRK2G3%S-ig+
z0{{RtV<a@dh@cfJU>1%bi~<~?W)=y`L=Yz^K|BiskOnfS6$45H;sERrMHz)8%rO!v
zD?;7}RFtGCNC1f%AW<qyZCS)Y0V)+IA@8>4<~wPETieBGdkX_Ygir;Y+AM2<PQjQ8
zLek5#PM&w${k(1Ro^5q>nz#G?Rx3jZ5-RNX1~+fatt|Ez7RZ<wqh<h;5-9d=Zh5sV
zT(LcHb<9Y>W|=i$vR2m4`*XwbFr7{nLYi2JTona-pITLgur^rh_vch%B+6tkTEDxN
zF0OP|4-~NrX{NLy5fTU?A_@p2-Cy)_Z*F%}u!Kz{u+u|7BVTYQP4R%pKB!3d1RnPw
zY^viLLFCyW;V2TCeg#4WsG7_b&sJBFW;Qp@hV%&w%Piz11f@{{l0p?3IR*krb32_B
zMxj=y8hV1D+e<$5{D)3FbSiAzOl^!1P}8KCBw4Pk_Ax*$DltitRv>6KE2*P1nLTjy
zXui0Qw1p&tBmwWFnqp!h;@z#y1N-;4=lWy~5&}m^Qi#kxnlzc8U#N!TYgewFIDT9k
z4MhcnV63rVY!#eSgdC$Q%5qw8WQDq{s@hjdsil?0aLBv53^7d0Qe|@_eNkydVnzT|
zN+D6)nI`n^sBoq&iFik<cCXptPVY(G-s|s2^?~z^6vA${pBVrl2n4|>&Dt@ufP|Wy
zqaxgCgTtmBiJ6;<d}2TbjR1_s7><k}3K4)MdX6=c7KzhxGMP?#bN!FK@c2*u^yi;A
za`4tWuZ8W~0fdQcE8l<MK!3hp3<u+45|MN4Mvd)mUW{Zo87)?oO;hT$!7&I!2p|kf
z`MO-YdU<Pm`{?oG%4pO|87smPJb@^!AxbOHt<vwDIjaQr?OU~pr7RIfUlsMFjFnT?
zFmv=Vgcw68gC9<&d8>!Ybm!*G30sE%&OkB08d4gKi?X{^fhnVMfB^|KDP=)xW(E*|
z2=8SDA1DIed(Dn*n?bl+jks&`_LR@;BDn*hFbE<r%!W*30Q7)DB+!id25g4JG*Rn}
z<YQrB0BqWJo309KipH6h5C<l$5~Do(;L9}8C?WWAG%9LeKY8+mUU+J5uIG_E3v)>u
zp&CtZ7Ke`?K6>PMqVPslOtv?DjG$FaFiGvHV<$#i16S7D>+4HthmsaB@o3<t)4H0h
z-M#tR>#yZ$5(`&PN`;9s04!lVwXFoLZC1@`<(YTxJKy^DV~;$#xHwNnH`ZNS({ATk
zD<hBswR3(lDQX{4Tdj@O1_-+g{R4*%T)lhEC{>9mFm;$P8X$ur48k#bjtW7kdoIbl
zna>Aw<GXp(-Q@7Q--DeC?n6<7XaL>Jj$()cA!1<gfE*<N2O^8jOn=&GJcU`qFat9*
z^9_XrQ3x1;F}MIgnzSGQM39hYrWj2+Epzhp!9zz5)vnU24ICNS5j$U}5*Jn%AZ_)R
z=IXkTM3GTV#b3otB;DSes={zEy?g1ZO#H&~eq)lgJ9pOZ+*w<@v%Y>ukv#h7V{>Uc
zWzrEq6dG%zK#bs`IFF>3_8ofuL(jkQ$}6|7-&ntWYg!g%UFGfkz@hyI4jqsXw4oS$
zsC`vCw5d_#IeO1Aa;S^JWEeSgJKZvx38Xb;qAh`LIv0sZq0qaO=w9z}FMhiq%?|Eq
zf!dw;HLKvhUw7`o6#+mKDMD)6r9@abFb9?Zz|?Sc(ln<uU33D#v$1Zo;%{zNrxHX(
zghGPC07{cU<S3d%IF5%SBjF<-{@^D+c69$fs%wePWlc3<X6p$kz*e_6sl5vh2+~%b
zw_8xT=tGncf=0l(ULOM8zPonj&9jKQmA9fGv21N^RCV#OkG^nd^`H-dLzKEkQ$eC2
zdWZysBEq#37pyj?PMm)0&DW0{IWpJp2M&PP?zOd5qtRe8u7o8D8*9+m!qsUnPxDp)
z9t^gNa(d+Oku8QoOo2%aCI~epqZ*M24H}eYRkjE7g@1lfC?Y5i9(+K}zK1k6aUlZT
zdv#buMS;i|p;?B3nnoQG-1W0$=Vgi_Gf!v6=^+9jBalK+5X1wDLJ90C)(@RJ_NkA3
z__0Sisk`o76{@LL7$J^}X)zwp8)~;&(>fG&p{-U{YincaBt&hMQZ$&1dReEpyZ}jJ
z@)m*av^t1XOp6ffw&eQ{9~@7o<8o@VJOQwT1|+!Pipn`>N!OF29FMhN@S&U(n|Ie2
z=jN7{mjMw7%en~O*HtaTL@LYjDmJw)$|lKpI;niMvVXNV*S|YPF*&QYP%5OEQ8)xa
z0*(R-NvZdG;O~_ux*rX^-^+oW2man4vU^qo3t-cxiLlcY(L^pg6~!ddxH>!a#v;ff
zQ3Qlz0M)G8g@P<3OcEdpppXaz365j6x-|F6k3WCn&;jD@7=uQ@7?dy}j;538WRka2
z$FV;@SA{A{3>;&OAgGPDsUd`MF-6qfwrTgf-Tp$7wDL5o%j&}Ui<4p+qJR6``OU3O
z54^Cvl6Si{YqdKa0mbaSbJO8?v^CgXUmtC4x6{_8v*$;HLATq^(!?f-XI~T(LT!w7
zu2xD>lGa7pq=If-yV25SX>l&Kc4K>N@>S<-#oD6+Awocfv(CcU^q##(Vpe87q_oqY
zc0Ydi#|-a6@j=M<ZaVr}Cn*So=*dW866XO$lv0|ML=M3xNsCA^$DKvlL;;b2M(~85
znIR$wDvZD$0)a$n)~N_6e&6ciM?UcM`=5NGWw4%%2^<J$(uBess=BUX2m*Bo3{;iX
z?dx}|qDX?I+GwqeF=#1xuDsKAm73fpI!SDZVSRo5>eVY{UCl2pT)J}g?1ghe)L)!$
zcY9g8+v)W*X_n|~HyMtm!}0dUMm;SbI(3?Xuid!O>2|EOy?!r3EbB6BwGaqqvl@*K
zJ{9)fuiv@r+IcIpF8DG^)TyhL2Ni`#fJl@=jUotyv!2lza`(?cz-G8igW|4f+;vlb
zR3LKSx%*V>jv^JW&@x1nsFAGJjoy^NI;9vfgn$VUkqB}W=7<QINE2!Th2UH>SV548
z85jc+MigeYmJY7&|JeJV{^<Lko^R(yrUn6-If_vRQL3s!0IdxggQ)J_y~_}<U%#Gb
zdAGe_6|;9Bk|YTr1;;^H2+C^eU7U`mZ@&4)?b|m`oI3gRbI+Z>c;W8Gx{JX(zrD4!
zH5l>r8?|%5Y?NMFSky-M`~Cf=AAaKT$NTNpx4!YMv**v7)Eqo`&}P;L2TIkUMh#k%
zKqQ6TPP=kpacL>~>ekwwH0>-NICW>j%`$GYvUy<<jxho;5g`Bz?=;uKuKeBeUz%)#
z>{){cfSCzZvs_XG(%#m4xIdiO>k0vY?zD{eMX0gW>KaSK;hH8z#*QabkgAn+tWI2A
zfY-)SL(Pat2p)t&ReLD`nWzczBO&EkQq@(n%*C<e2S4{?AN}Ct4{29wj3@ylHog-g
z12ZsYX$D!&tN^Lo?@g!U54`^aomQ78Zu`dFiQ7`l974O*o=Pdqn$XpuD7PoW@#e<b
z;^M;bqsQ_jIeqff@na`g0Sm5gZd|x{>Fn7HH*c*i&Ua5e@%WJ=M|z!(0+c8Ku(WS=
zW&g_cYuDd7dsZ7Wzc6PKJ)KTjOKKAY^dZI=v#fRG@bRK3Sn4{|MU9em$}t8}EFi$m
zdVvH0%?uiDLi-=7^!5f7yeCXV#9d5hXLl+s?n@}{N%!v_)S=qcI?39-xw$SWnoc$c
z!|lAI`@LRWL0wPN)VA7|P>V!h3DVRZV)NesFhEoYia<DU2pToAhsZzn>Cb-Q3!m+`
z)5-d+gY!Kr5kr(1MVLiMA##9-X_9(ntE#T7o$t*hNs_nnEXlzj)>u?UWT%uiq!Mj>
z<;uxaF^$&OFPyuWqB?Qt=t8$&PYWM7$?~EqO=9;iEcepZ@dJm3<B_#?X?dBMNtl$X
zz1td$<`?GQ_n{9u=hoKNE?hXjzua&0q}}hfdhKR<1SxEm%$ZJ#JZo)^rj>BExNog6
z+m5|bgrY!ZLlv4dZ8MeuXG<$R5Jl|bx4S(EFY>IOZI5fZd)dxTlZm9g8daY>v2yFi
z+VdZJYHoi2>u<eH2;EM*sK;FUZhMZ|l*JHIMlvymW`tV^kvXbn^Z+Pkr<gUdaP)PJ
z6mq5h(qH<E&wuPA-A)I&nxE^J)g;#@M$a4tm?JmSPJ}^`_AYL1ZVCJ4rNyOA+c~GT
z1yZaNRyIu(DaA;nlmM1x5nZ@(>&CSkSKt5K2Ub>>qcET{iPlCNHcg#Qk|e!Ox11KO
zcDt;~vaSR`D`h&JS{swtmDQCa#}5w&gIl-P+TBh^!D4C?YhCSX@6f0SkmWYdI(6lM
zG#R~7x+|MJ<_>Ej;AVUm0U!ntwVROrQS$ddX#XIB4NEGxmzQ~f)7hIf-2GAi+|PVw
zIIQOShu?bZ^37`(#XA8usC{%*RUk%EDsoNWMc8=|QHm6zicOO~A+eBnbU{Ve(rRIT
z;koy{|G7sVna?tU7&&MKDzPjP6)B}4V3Y`isF9dRs4S|r_08zq(SwIln*b1^Uf&#E
zym8ZLYjT>Dlew(TnnY6+ym8~sm0Q>Iey26p#Z(84)>xBgfhA445~J2S%Q9_jEDNn|
zIUdE>npRcmYO8h9>!5%!>Y>vQv5%K7T^fx>X`a+oWvo#~Cs~TtjH_~5RyIkIlEG-a
zJ(+Ha9!amJb`*kHudVE~IRG@VbyI!u-Z;L8Xzrp#axa+yFr%PhXMvb|w=_Bz;?63=
zqCfKdlbf59D_4f=cW;gdTYzM(ijkXnGz*LUJa2ETZ%2;Cs^NHwVv{5npb%L&7!s{e
zN1@=Y@PYZcryhIkh4;O$)oN2+B{l`4d{rPa8KsR?K?9>8Fo`JCN+Dob`|a_hF3Y#i
zoj-Zxa64}gN9*5t@s%@Y&OiD1>9p0)(+stS5R^5}*Msq}^3|h{JWf^z;5;#)lui;?
z*X?#YI)?%#O;py>ia?+Z9bitZEu15*0>|Ke0O-y2Po6p%g4^6&pYQk6Bu%VMvQ#uR
z>f-vvE3vfm3(K3+(PpeeZzW`NWym5BG9xmx#Ab-SG>=;~vDv$6vp;9si6~@ewcT00
z%<O|6xL9`9!+;qZp!19;Hr%*+Ztc!BtCTbZOz_=q=je$O2M!*dOp49THSfJi+M1X-
z#uy@!5X8s^K_M7G1JG7_wbOm<(BTeZ3kd;<88y~1dhoj4V~<|gAOH~)L=ml<`9tKR
zY!#ymmoF3ZT(5uS>dmiz^Tpe1+Y77n3-hMeTZ|!EWlT!-WSnZfIJdBWdBrM{5FtwK
zE9b(rs@TO)JLD+Nb$Wo_g}V0M)n&;dXmto&R+Welk&mI<?;bvU*tu$Dd8OU!*xYKX
zr>-i?vMB3|7q8s9Iyi9XXlH*XUF?mL_B5mgq=cGSn)1PBePr1gJJ7IPKcep9&-HX3
z(80p6heo-VwckUJHY>pD@p#iJwQ={x#@a1S28hPR1Vj!UIPl>Qen5!6|AUu&D4lae
zV5|yGye}haG#V5k33~>Kxl&!DlgL;U#ofDet<0#b4l#1niiAlBT@36!iXaga_~5io
zh|pSNOj=FHwR6{R-yV#nm#$pf9v7mM;k59~Wm#LKPMW8w#a3sjztA;#Mmo_Jd>CwO
z4n~vVXzYBnI^p28$b7H2Z)rKvYHM?2Toj|}m^JA%i6~K68$I8j=NOIB^YinEj~s5d
zTXX$hMD`pI0D+3K+8&L^97U&3omkBmR&H#|$fHA(k|My_=&PpN8W2DMk?`(v6Zfgj
zKbN+?mr%Tipu7i5u=l1}g(8CPW&M$>=K6E}PWSe7;J8jx6RIN3Oznz`m#?0A>#Zzr
z_uBbrI<ZL>C89E^HD&D*ON8j0)9fix86u2^Yv<2*4aQ>5b`xb%A+VqvS4A=DXl1p9
zf|QVw7(xM(ps*oIjUF=$M^hlXcwpt=BlEXw_4YgG&R@Inp=VDKkwzV3OiU|Z-Z$DD
z`6LU>hGjaQ+`6-V>GHL~Xq2Zd0)>dkG10o)>ROFk8|#hyMU=u<RjAW64IJke7w7x^
z`T6<9h51JwIhm&E{6c4QG#U*iB{QY1w9PI^yVE{&;&`Cs@~y35oHuz3f)Y{y8bzxn
z&xhEM{LolK-YY8aErsvqOYapPJ_yy1_K^SpKp$RyWZR5C{9L?tX>jw__q8!K7mjNr
ze&?Mtch|RCt#(~Q6lk>;CezZh7$YD)Bd`K7L{yq1GE1)29OCAMw@)5k4%02~bLeO!
zv1p)1OF|q?FgD~dIvac{j_b)_<5sb~WtmmL!DM=CyZXV!t)SDgj+N~e-fwIT`&OyE
zWliFRv`r45Jo)w;Z^pX5aqI5Z`sQGJ7y|EKUQUy?)+SF|L{v<R$zW8JzTI2ee_-{%
zk;68#({kuS*~+sZT)1j9ooK5?1s|uY^ZlY4h+%A{F;L}cF!XtAp7Nv+pP95fzf$<l
z-HoA5mc2I-4T4q8D15<4zz9(Sp(q7At(^@vGt>}4DPm?3o^h8uhEqfk3DiBA6W;Mf
zXRAZ*ES}cP0^F$$21NbsZ@<><&9Ce``tYNVzk24}osIRhle<aP?R5pIuBxIat?95w
zU$atLn#IzA6$mg02`VC`2n9JR3CdN)+8sK!&mg;IekOxLA^`$Xf`*Z!AfQrE)#dhZ
zvz%;q4XXLp8|QD_T(56V0a|&h)3KyTV_EuU3gKir5e|B8&Ln1Gd1<)4y=<2j7UqB<
zv5C={(WaGm+wCp@Ri$I*G_i(M9V(k8HnVfk4fUk*(@9w-iC*rkRKAYv`}2!2R#D<~
zQm|>E&dX{#u1Z#<T4}Tv)1KJ*=nW~1fdg3)OM(JIzyLx5j7>WyKIlX4qS8zx+~G(c
zsBV&XWhx$!-CYQGL~}<9zxvJZojrU0<mpEjmsTHt>gly_e7&rFJ8wVw@S{G)>sN2x
znyx3E4zPq!>%@ql#0XjdRTPfG2m%TT88`y7mbh{2=F#!VghfQ0KooAAHjELX6Rep+
zBvp|bhcGOrJ`{6_UddA(=D4~(o<LcROcJe5*zxAtM!DFv$caX35nx@ErAZl;Tj=)*
z$W=~jYjlQ43IQ#&^Sr;*k5NK!78Fh;qLi+xt7$pi_OT$P+P$tyTVb&6s#+l_rKiK8
z_Z*lV`bjZaAKa0IZMThSyN0Zss_hX7v=9<P9T7oTBt~ggiA6+ILOY62-ZM=fW84Mf
z-Ra+VBlkdl@jWlo-+KAAv+taH`^xQ;ryi=EL!B_!ii}cfd3oi)>i(-2Z%T|xC^o}3
zLI8{kZ8J)g#ghc!fXF0*!WiRlZEdu+zFb!MT)zPpsae&FnO%fBDhaIWD2@e)5{sD*
zJ<HFXUS90VvAf~it<Bq8lX6tm1~>0+jt}i`rDRnMzHqfch+0dC6{wIVnFv-@;er!J
z7918sV^UPw)xMZcAw*zNsTBf_wWiSSWJ#7Pt78l?G6>eSV`g6m=eVT05FU-kgL0@_
zEzEPLvtdPpN!Tt7=NVC^h(s8WrI`TP=*d~22D?h~Jq7Ur82&TEk3TO{asI{~+gn&0
zP1auep)n>RDP`)adg-MfeE37pFD)*%+wJHD5t78RFmoUcNEkRGGD*bfRB#5sTBArn
zLMYwl&D)2zw&qut141PtP3X!TAR=*q$N|LHTA-C^pBR!NhH9?Y>K$J>c@$4xPu@H~
zx^$x)jjN42gTYp{*v*2H$z+0n{Z3a{0MYxv7LqI#R8{37g9~vw7>p-XS-Th_hZt)I
z07)xN@}%9eOY@z)oeSZ3I%Uv^q_ru^+7CxYo2qb5+amCIQlL$f{#=Px*kVQFr~;%!
zNmJj1#LWsLC;&nrKteO~NB2GVy+H1E`R<jiog?pEe(_%K0qoQ?3L@$nG?M|V5Fnz2
z*c24ucfb3+)TY+td7e+kULsgyDpwJSQY6HTL4jysB_Zd~63PfP2%uPn+qZ8IuH9Tb
za3E==9ywBMQWOC|6u98QM;mJ;Duc+#ED&OJbseUIUN`;7>6IrAufBP4{X0Lne*I>(
zy-^P5(!?Zzc|4dZFxy+BEbVAzYZsK#d8=bAdmni^<*5@u(weLxpaiijrlJ4{grJUY
zdpuxZ=Ou0T(^k%PT~?JwnoKI^B9ba5^>AFbddsH2G_Etx8FJ=L$7EfPDu#gA6fiVP
zh$>_NM#bvh)5Uv?+Fk)tN;T`EKOk5lvZtTvJ+}L4w)>?}Ofq%BkR^an7aT)smDQPW
zeDke$5}Sv>(hMHs7-y?0O9-Apl(3C47nnnuBWeK>N<dDvDF)l?m#?fIJd_<;Q3-((
z&=i<~SRsQ86v;FLg}rCzgjj2>5dg)H2Vpu8$_{jrXHFilVT?Z1(;63YB3ss#U*8&y
z#s~Kw$kMbZiqU8&JWA7?1pw6Y>dMJ(zt!#lqN{81t}3Sy#YbP3V^@tQ#l)sryWdkL
zLsX&^3-mhO?d{v55+YknC)>k%eqmW>tD>@K=Og7FEh^(<6k<e%M%u86BosB1MVOnq
zlU-Z*9@+UFL%3H28!3Eu$gy{4S0eXvZ2+Ljq@frK#delvN!L|a6~nq3=UKY8v96R&
zvYue#nZXAy0*XWe$3P_LU5jCf^nOcAid!53LNfseS+=j;+&FvjSg)g777`TF3=t$~
z@q%E%=s@g*ycoe0(TEh|0z+WMC>Wd%MNoB}$0~KzeCuHFFexUARIigSFSP+pWNf#4
zz1|{+Sk*2>o^N#*mX?yN#gTpRy3-}_-q)Z>5JRY9D3KtF0P4ZiZEugn`%If#Ya1rd
zCljxQRMKMV*0N~KYLd*wbfLz)20{r@yh$`e1Z-wm6Nmy)1gJ!ah=Eyncly%<DDI67
z_Ts9P+SR{1XuXI0?c8-=0f(+jmu5Lcjy^>3^|T<uyqzO})*4W`7?oD6AtEsmVgzJF
zHq5FjGRCDmTh+-tM2uyP5eYbQru1ZeV{r9`dHi9mS*!&h1QDqb>dauYMlqn{1eF+L
zFhu7(xZG$`!osMi-Ab3{v$b}prxRmz1aTp@vcv`Mc6-Hi5~5Gj6sp=gpSRk|2tpM0
zL`+&KL#Px)<-Ly)RH8DQ3+uqXtZE<?A_oCxtR|D~jm^cy6=jovl=bFT4z&tB7jY4j
z1qW%s6m$ZJ2yr&_S9nJrW|Q2BklsaVJ^)n{Q8X5j`QF+DO;EA><1Vf9o)vEoLI})A
z3K4;$gg`ry2Lo%ZglvcyB7;(~S;U=L5gUotxp`#{BznczIgvd05WQCsn+d}#nt8IZ
zar?sM{?jL2Re20`H8FAAYx!>89&JoY97L}m_(V~vP3<B8qed1+g~&)oxB6MlcW>Rf
zb8IwRonN*P%DMuQQ857tRZ++25@S#UPypuIRg*FJP#Bw}X(p_yN$H(OV+<;76bC7)
zYFbo+emtIz#?!hi!*r5lSsB9AMIi@SuQNXvVwbVQ*anp;N*GB{ltyMpnnYNHS(t!j
zHYTkp0h<-r!+ULe_2FJ#W=B}}+_l>Z^Bz3TJwX%^tpFf~W=OK2D20vN2?T*7C?sQ<
ziK7Tdl!(YmIA!h#tXR8h>^ws5gAD<g6$m4cATU@m)o6V6{JH$(3Sy!x*3(H0Bh`uR
zOmjV$RO=j7s3w-U855Ca$+X<miu1h1ph8eFu~VW-Yt!yzozA$N3@0Oo7NE4Uq^Qae
zobGkg#QIQq?|tw<Q2Ejr<9(Y0jz^`|smT<ht7?&0l~rAqby54ls9fLJ8jpq+K&cXG
zoX_u5Ho3XJd26Z;J$7odBIksy5;TYgfH^Rdk`Nh0gb^4q;%tEVPK)4=ro-NC8Xq{n
zd-H!zq|t0zi4cmKt%A8TVOaqnM2-r;Cf0l9T}==TfkH77yTbcyvW(aT$t5NdG%$l`
z!N^E}&48G?uJ7EwHGlKQ(y7A<=0oqJD?pSsOi)e6wX4CErO9+;5n!EJKdA}DBwYqO
z^?awO?nHU$g%=K-e$=We3Ra%0jjd^(ck-+(r&cS{mXu*;=c12{E>ILH>e0m2b@Vm1
zT4W-|$uxvoi38&CwAdVuwnpWhyPLzoAW={h)0O=P_C2&1vhMj;UwQ4)+NTdb>eamH
z7()~Ur3?c^jsg%w7#R@>1tB)EAQLeW|EQEM06<fM^d4E?2SxBlWES5W!lp5Y8YgO2
zevi@&nkJ>R0s#n73uj6t7>U`kUqC!)?Occ*<U|-T3NeBx0c2EY6d6>?`D!}ax^d;o
z;^9^0d<x)zIR*jGGOa6Ll~`Ba=*%W03hGd`+BrzAtcg+G986w1KYe{|@GJlIFLaDA
zHm<fi^TT0z?ee8*ajTtXT0xp6Rn3vLwU*IFQK68ko>p}&jNY>~t->p1>kysyB}IqG
zqse%4dvtqaYil?yib-_k^6K(|!$<myi+4*L7L&7=-tk}l?Povqx%t(WRe1o8o=I7g
z_Nr<E(Dc*CW?>p(20;e)qW^r^dAH9A@6wPDxTEimK;8u*%!=ijIZh3KhoGALSM))A
z#SU%cRHBKMlCp1j)u!`EU5q(L1s*X7iAeK~VbezAgjoS1tX;qA$B!vRDUmiBc*4G9
z@j%j01hsP+CpJry4A#b*tyXKq>3VI?-Hl&;X+7JwaO|n4ZoK-PVp6tS{eHi`Y1cNc
z-MloslclQDP6vbOXzF|2Ic1FtVOrLs(YUUiHi<E5mI`c5Lkux`;F`FG=*qgPYQHs@
ztZ$E8?e?wopLzP(g~cUi2+T}Sxa!K)bGJ5!ANtr&oH+dfvNkY+h+|A_7UHaV5FjE*
z<4ZP$Bn<B^%YG2T2eA2HBxv46t=-R&3O2MJibxdTW;7lG5`qAU7!(CyIA-4GQgtow
zYbE<_nwKGq(NItl1OiiJ0b#|cxLF{Hn`X99Z4auo^)yL<Dx+dbLJ%oUovIz#nmG|=
zP?4YyQbwzj)xs?N>C4xC<7+o#lK#Z!KfgBExO(k+T1=B}JF)rEBgb7G-Wa?y9LL%h
zQ-|AyWZAIxTst?O)@9|0RNiW5c}6s-t70;p1Xo)Od5SHg605bfNGeT|mBoeUo_S(r
zWd)5vMWrjMx>6(|R^!c^U;cyNc;CkMb07Nj{Nk~x^NwjUo~D^bGEL&XnUgJAu@K8_
z=Jubzy&JFxLVMgvJpJd;Z+fOPfdo+yd1pRs!(AI7!=Pg@zHUogNzHO6Sxl%Ez4qQP
zD+q`|nnj*~7%2iWswkicKqS<zqmuF3`qF{@qjG9(og^uyNtS12Jt`}79xzWM*wJ*7
zgHoLXx6Aa~-@EXg*KTb(?sl_BpLk|8*uHW7%7M&Mze9xmx!&O;hqkr{Wmz){3y#V#
zn2y&sw@Vl5AW?wG(4Z!T3M54DD#tN)5?Gl_+e>-YYHMu*)UEd1v7?6$?mrZqZ@0S)
zAk5lmM68RcvMpC`{qXx=^Ugi{;ZH9eJc$mIEcYP@Frh&N5k^5qWTC)JO-tT?wny`x
zcJVzqfxSQ7FNM&oPA&ozfg<dTt7+&yju;^Y)z)TSVA<+bC23VcRZ+Brpd}J;BoUMV
z5&#3DSEQ7(3ROTYkTHyJt?8$vDoR0CrlnNcPU}!i{UpSSxYH}@<jxQm+lxOud-=_)
zx6a=huTLmKrfmPvfg>oz`r3`9eT!MPe_BR~E^nIyhgYU$?OA+~+DlQzI2wCK2ND<~
zqbuqdy+W{>jM6qqvbOCn^p;l_+DRI{N0p|nR=3>+X04Q~YO;B!-Okb^gqUV&?V~2H
zr)#hM@K3gex1adHCr>>3KAq?~coC(^C{PSRn4#$kli7+!KguiJ8xQP_|K1D5dkKvn
z`8qTZHuaB9fj9%OpzP>&6b23!ak0}|F}7Px=D6%cXT9^@10X1+L3S2Kf&k!v9ihXR
zXstvvU~W@%VX(I0Yv;Tt(L%YfH6{%{a8NF42Ps1L%GRA%@80?0*;|+Hgql*a9VQX6
z{r*CW(xRN!J~dWI#mJR0I6vQo!B9wpvXzIH=ORWkt+yvdEMr8DqEMqS>qO^S(#g`r
zZoaVC>viWWVG$=;ruw~JmZr|RtlcVWw|{P-s6+%skkBZI2$57M#<$*iYkN=(Hb+~F
z`%Ww_9nG??A*+ExB;Pc7Au3d}Ow+qc=y$Lo5JAG-hI$ccGEe|;e`U;Uqh>83=ABny
z)}nh4!X~UC!6+<|Nr<Ic=Q{#~UZ?xe{v(g=Kiczg@XncJGEF&TC{9t$Oh_6C5m^GT
zM39<-1CE526nl>`B-%*ylW8$6N*~c+=B4F1uZf*$4J2-radU0N1AguL<dt`>MMKVJ
zH5(L)Dg+EVPZ#=al_t~LmEHr9B2vm^S{V^S)QL?j<&moSI>j;ipkqB{P>E86+PTcC
zcA|Qz>Sv~xCx*~F=Yvnuq~Faut*ojGR!ZmjzT>BFT)H)^0aRMMV69<^%pp&;mw5Bi
zTX*l?J$U4ihaP!$Zeex4w>aNlNYXYDRxv6-tu2Uf46}TD!<+8r-2q5wcWKI<HSL5N
z&AEsBY#5uJpPE_Gdl!46y<aszsZeXOb<OBvl4=(mFaw5m%Rc?YiJ$!VXC6OzbmN_O
zzIpz&RC5vlyptG6Wkdj?i3J6fprH2@JqA(=pfW7V1?M?U(f~YhfmP~+whLS7<mzC2
z$G6U{t=(ELZfsoJoIo@-rg>B*2t`69&*)SeAtlPwq}Lz2(V!@eNl{AlwQ+IYW}bz8
zAZ;Mj^9o60+Rn=?83ex>st`h3>ztrtxohHF3jNF^B;#^SBzbO<1fx^|JZ9<2;Zy1I
z!Q#qrBuTAOjTnMQf@XHI0?8F~J-GhP_piMA?QCx4_^HPpd*a!n#~;Z%b4r*+YXL#!
z5hDW&Ypt3jv@nY_?X*BU#ZJt;ySmt{hI<Agf)MO>1J0JxWD!PT07OtY6GsJrS_ubN
z0|^q?)F_R_;)7qD&wk=_pZe5CUpUa~7aLp7O^zHpuzhYC>#0H|!qd96#%f9vBt@iv
zjDR8!!l81Q=v0}+DE48ya&@9dj@8oKz;A!|%^Ta3(d%a}z4FG^)<isk19Zv)<*^x^
zj{v|*F-8FhAgoA<(!)trmZ3Y>9s7+~RGF~~Xjn|VuarUv4t<?#t*oFE2NX?`*w(zY
zCWK5;ua(X9JBg;Mo^Yt!?Y!U30YV+HJ+}~)KKA%iroXs7t%lP=a5hYU7z9yR5I_Md
zsud{7jpE7WcYb)`oi}^)D~~<(f#=@$;rYeYaWM^%v`t9?2t|o81OOtXbYe&u7ra0-
zO;|O{QwhhNX0=(#8lu8`O}n!i93l{C(&{o>lWA6Qg&G(oGLwL&7{&WKM4u+~!RMZR
z?x`pCuP)grTcP4qoqGE5bLC`sp^)feYFHpB<5{Bs#HP?56o6q!lU5dV^x|3RBr`4R
zG`@D_`kf1-^S5rT52ulMQiN$OWDsqp&=3=&B2WNL38iR(7#OQSHK&-2Hb;{?>w~Sq
za=W)Yzc`FM84o7)7!#FiTe%Qp2+^CwMi330Mlss<`<;#e*Oewn(<HG8A_+&MD9;lH
zW<;B$kmmc2p4OdtKwFiSD+}Tvq_`=n-b*(#AVvaJl@k$@<XvA5fAFn8{lRy>ed5H!
zPrvVdM~**aEEaXmQLHtf4GYB>eeDG*RK!s{0I6o2x&mr46%@P|VQe!0h$zkc;3l_C
zL|UMcZ3MyDbRvl&s1>Sa0YgFY;zKMAaVs(Jf9i?D`&Zakl?wr5tzhoZzWtjg;&@oE
z0forUv5;@vC#7~eyR|S+oIq+-D+R&rP_J(f)}bnj?QQYHs;UArX$BKD1VQnL&5Qw5
z2*@!a$7a1_2!LKf;fzYG%_mbgnbwK20cz%u=1Gm-0}FzRq#FyVO^9HaTMCphEA5sI
zK{Sa-v*MlB)XKBWsyt7$Rzeh2V!KO+9(i(F$0UW(Xk3nlrdi?-VbApQd!_Oul4}j9
zfrFopd=Lh6?ZWHZ8#nt4%li%=KXv+%ef#!%cExlGq_s`RV2Esu@fhPyupXksCWsbn
zCW|yvPa3+V@v8PP+D*sBjuShh(nM?00ogN0U?wIFsn!PlTqo^i8YFo1kPu`>^;#>Z
zPS)em&8jZ%Y@|_Z(VDanIfMz(P+*H=fe;841{DepJaKOL|L^QgpDjC%`@meP&T{Wt
z`}KxKvw>~`O#&bY0$fCDAxPUKMTIC^GZW((#cZEuf`7t9C?;&_6BU||6AsHCCdP`e
z<cQH?i4-N0mPDFZ2s8k8V{P>MUN3Lo?t0Ft%FOvt=ic{vf$W$QK;z;rr%zQ@Wo7>I
zmzl8|INcizMqrAL*aLcE1_BWSY9V=1VFWWlP(orLKmx<w?#Lp2{p-K+XX_g`Z{B_W
z+><$y^E_@U%D|H|U{jR>>M}=k&MZeQjLR%PnrG}-97Y9h+ui{HW$Zjt(J6<55%|f+
zp3E1HkH_jM-`v>T+uF!I2Q@%an8xnfsU$N7GZh6x(~Pnra|$Y>-HqPP_QsvHJ2!7!
ze*5&9$Im_S#3PTMDZ8Zs)FPl}p#n2PCUTfkHWd?jnA&bX1PNrB<WsbPqt;(Puy>}C
zb*UDSf(a-fc+Z{{H9)K_RNfKhj2RaTv$4qLKKAJ2s-ymBb8Ei@henk_CDI4kv9PUS
zTk3(CIu|8KP>B`+By*7ao`psYA!o=Cn2`)rNr(ZNL_&}nh%oiRq}1YwVziaptDpMB
z`7eL%*Osqb{@~@GtgPJq_~~QB7^NYHX<g=-H-V<i>u4UBIP(B=Sw7>OnKYnC<h{$i
zR||DLE;1(P8im?$;mEOLk9~X`$(6H%I&Q3Q3<vwO^G5<qd!QYd@F^_}RZWeMn9z|R
zKoCI#&Ky8J*k0YZyL|iRhg+*R&pvT}>BOnoxy8=xeA%5<OC9UXP*fF735=MS5wtxG
zt#vlQQa{1=FHAXsts0m-jsl=-q5=~WDu61esaQqM7%hg1&~s6u_vL&MvV3l)^Vr<t
za4^2IvbwguqpHKu^kTiQVIN`-wGU8%ih?Q-5oS&_^<9RD8G0sT&~yxFl$g3u0wS0a
zs+keBDOwRM0*r!OzJC3M=Rfnwr_O%)pZsdQx%uIZ8%vAbG!(|fqXN&qLG;d5p>~cP
zkvA=K_K0<CAk`6bSY&?Ogb*5^6_91y{ZZ%m>9bEg>t`4DYAo~o+SSY3Tib+ys#6!t
z4px5K=Q(xbX2(bf62%%+BVxxGtSX%A6lK)r^4o8`|L)HhmX4o!{M_T`o?JTqNYR;d
zMVS{}@)-l6At$3mgTbVr7EGAJW`|h%sicLbx26<g0CX|6nju70P&J9cYF}ho=CeE}
zMn&{lp@z|AR?g;~PJZh2{(Ses^7X(rk}y)K&>BW@EJTXLoJojLfPo~b9F1948e*tx
zk?8Y`J#z}YfPyKYWu8nF5mf*IqgpU?1S=aGy%@$-c=FljSKfc``<LHY+ub{TVg^Q7
z4=b1XEX!g<6EQQ@nCAsVB~>O%Ua!x*Bg&lf4nqKPtS%cg8hvr{-1#%-pB^cL%No@S
z7cOjUZsx8KRhV>hzBk_ip~aI8L>yvjgsCcOQDZXt1)?xgnWLzU_BP(XwDbPk7b(jY
zkDNSq^5p3=XOEwJbZ&mJC_9<Y%qT=5$_%+JRRNgta1AU~Q%2;8oo6uZLTLtI&K#+M
zL^Ux7=-E*KLL1d%^iIv1CKTP7s#4#X(W1D$yZ_piE3Yr#T#-5=MF%nS!lZ}-rV1jK
z5r_gI0{hG}Av8^s<-V>e&*q9uHHKyk0FJ3G0tUeB5&)H=sQ^To%Q{7+F`MZ$YUSL*
z>1Uoj^5~h@-+g~!{?iLbj*WUe9t{nn=S);mqO4~&Gc!d7AaKsNeP1QiW38GhL~ZJ@
zwYT=EFMj##r=HWiYw8U+%d#t1uB@+ZKr$0S5hxiI$qP?%WB@?Se9r95tO*ebvMghO
zrfCo<b0`u;i~!j==G+iNY+@DmHt!7fHm<$@t{C{NIClJzC(b|l#QF2bPMj8%Ml5ym
zOu7215Dk(-Lvqk&zRA?MNn6no`xqNa$7$-~Yh*x;T4UxM6EKp`OSj)2-@JMEN8kUO
zmtT5mchIlNM@+F6Of9$A%o%{9YfOOw!Bis}AVh|7tc}Hy0!GBhY+#i16(XvlMeupv
z#K?rAZ3JahRikQ%%;P5JP5Aip&%gMsZ~b52`JI)GoyU&Nb+Q?&q^X2Tot>Gjw)ZpV
zV$<~Y_cFF)OAEbfOu}J2DodBUOf*(i6%cPMubzA1^B;fi3rnY;(5x$CNwutQT)Vcn
zyHC!?sK$nvs@YHTKvP_v)vS&}3QUCTfiNloDmtIaXfXmgG($DDSOFjd6Cywbv2n;`
z5QoD%*LF8<efai;mpU_xPd)efPd@Yf?EK=mu49OZ-uq1I#t{*56qy8_7!<%Xg(na#
z6`vvkKp-L}p{P*RQIV=39iJD)%*x8<zx~5M9t@kNk!#nk_6EJ~%#2u=BxR-MP)1;+
zNd*A4wd6Fh0T2vK2rMy14a8ESEHWCAAt5S2Y}5?MdFKEC#1u?-cX!wmIIfzoFk3$N
zD=+?!y>GwzSAVw9Dakv}MN+**krNFhjM!(WI;ci#TU%xZku%O@RApsWbjo^fe`RyK
zJo@MtzxvI`KKY#buAnbEMI4UbxbWKg`dSlXMi~+T2!c#nN=~uqL^ote{VZG36Gcog
zizV}wQW^A?@dW@#Xn;%@MHLJgokJ9}FqU3D80>EM2ZImZd-v?w^G`qf?2+Tghod@%
z$V7?skLU~-+6+-^Yh$FwAF6?f5*^nOA+i8fO#pI5Ia`!7D=T;Z=#T&8l~-OLjsucc
zHkTJs6aNy8QPC2y8PR~uR9g!Lpp~lus!?)O0W>v?N}r$yNPV7@p_VAS%!s05YHYB(
zxj`yLQ9ulh;mqmNU-|WKb-=E^@w2StquqI@VXRRQoo8fl49w8P*strdEUQX})$quC
zSJ@AmxZg<hop1f-KY!xc&y|ZOD|1mH^B!#Y*Wdr%#@Z?%XmX}a5*Cd(&6jR%QY31N
znoW}nQ-M!3POapywH(Q&KNUh?G|;F5#7fNI(TS=?4Z6F!vbnalx4Ay-ZJvGd{A1^y
z%=5Als6)#A)s`v;kOC6Z@S;PA4mnCNF>n9~>^Mkm=!(wV?tbs@fBe$l{P6GQ=Z;p*
z*ob`Y05pVHf<rS^l!Lpeq8X#90=BRpnvnvlvYDDiVnJsB2%KCjOGUx}(V(qXnsOte
zq6rc9ceXcISC20qFN?w)2}yb4(HH-_|DhfX_pV(XN1UHuBn!RaAS<$tbSy}S5r}+I
zBIknDDAXrrW~no~wzb(8{>nH1*%$xuH?4a_eTTq7(=?$Oj`}aZ^wRFm7BLwiq!7Ur
zwQM~xN?wJb85&wUaBNL|G%!q2^NCANlXgA`hG49$ri6eXiS@=NNpE!=N09#R-Afm?
z?%uhvv%R*k^vKeQQ+a0rk)kS2xZ-*ctuO;4kHQd9qgjX+!~}?<KopB&Z~gr3zx(_D
z<g+3wL<4kARf9w$Py*rBEyHOEHUL9ZOwp@0mAS<dT6M&L-oOJmKxal~sFwOnC;QY=
zIi55trdkchufF{1`q~;G5|AiCIR}f!Ui`2Ad3NOFdT*pIpI=<ci?TaAGq*5L%n>aw
z%h{Rvs)@mD;n?wf;YeR`MET>N{@geJm;V(yi&)Ns%gB+>TvgRquU@}%=S~n|$G~P_
zfT@!xCjctJUWr#ECZ;mAQ`?V|hBGw4)&{Z(7u1rwr>a6|Oo*VWK_q|*Bjg!%GAKEE
zt7Fx>vvTFTfBx_P;!pqhgLf~6YT&tzb)ZckQUHKd7TTyJL9K~}oEd1NB7mkQja0+x
z#?_lQZmi7AE$sC7g&-?4pD{C_qne>fQsk7a&{E1L>khyY?qG%>L=9pf5=v{16*19F
z(uy`TL91gEtx-@wWXIllRFoip^Zg&JuihOFdZW=e^Bq$H;r#s5FZ|lC^V0FlcUFf{
z%9)vkBMS?Q^WBBnxg$rGj-6OsSVClCckapaJTrG=V}I%Kr~c>v{a?buNyuk`UCPES
zau=ih-QWIw9mHihIbtM6O4S0|79Z)*Z(9Z?fheM;&fcj8O<IX9Hg0G@2BerqY6_r0
zQ9*$eAVn<<PyvCE&@5It$8IJb>&)tohf#m)t=C^(y|r90^F(x$k~66WEGU9IwlKT7
zwH-k*%S0hIf?&*^fZuri&G+B?Kn=Ebb{3Bwt?Dos4H-4}Y=n&p0GS%4hn=pAY4ag$
z^@pbalBK{2s9;+;MJHh}1Oh~0PA95FGe$~>x%b)o?|pFn>h*JH&$4r)VU-u2GY3+C
z>{q@ztg1^t{O+x_^~X=2obS%}`}^oU`+~sD%`Bd(&37}%=*IHhUwHAKeD%NopP+k0
zE1|M%xwi-au;1JN!H<3zMZNc$&T@7JU}zv}K+u|hkfMFw5fTF+LE9tJRJAQfn1GAP
z38)4DM%Ln<fTEfdD`3msZB#>DV{A+$D~h>pXH>@+#gT5@zOj7c%IPy7XFqFzWT>ry
zaZrnozVw-Ak1x&;ib51NBM<~YtjEpO53a7?S?iW1JHOZO398S1?wv`~RD)E1E7ikA
zQ&M43R716tc}_}`{BtrxK~h8nV-SbIVIZs!E5OQdWH?r;F^}e>a0nI~mBv(v&=*zE
zx8A(CvAUl79D#_rRx-}e;E7-SrRTr?ji|P<wK*6L>QIxTqFZ|Bt%@^Q;T^MgzwzJv
zx4--wzv;S1Vq_{yAQS-vAcWoR-s`Wwe&gm!G*cubBmxFNVnYYW0EBG}2$2lQQkPi*
z0gGnAEPx4_QfdX8Hf(CngJ6heq=pJ83IZsAVyH$6BtX%yj#3m^;f<{#tzt8<IL;ig
zqdRw2R+g_j2C_-uJ~<QVQGnc6zx<_}D>qiRx0~1?GZC0sjMD25@7!M9*xFRiT*r%=
zCa=Jh0o8GBhB##mAhy-I4_}8^I;QPukLCaf%}~HnX?C5cd6EW*9Vi)+VoU9-qfnOL
zSYF=W+asW6+?3rM2^zr+*w4;C{=zR<HGb>IKgtCcmQJ0RoA<78(Q&{K8_Dt3?#|<%
ze7ZREaS$ehh=dBQQ3<fMwe|Nu{&5<KsOF9cEJg)zlTpCLUIDOnpa$tQOy@l!G9fTx
z+qxdwU_<&h**lWzfVM{osHrC33eh<qC8TWkx*9Rk{7l)eM~=(wjXSG%R-StLg%AN+
zw9h8&90LG%?(C^w`qF1tH&<`2u5(_9ni;Tj*KXXnyRq3QkS7B0Od^79$0ufVF4-!H
zv}mBv5*QPN2ra~JhlW2bm6U`{ZF7`V^iwU_3CZA_Fei<WOd~U`tSoPAZJVm8N>FAJ
zBVZ4z*}};uzW9&*?6K}lRu*M<W|n;(2ld|iPH%VnC$IjecduRj+0EUr|JU~17rsbo
zIRPMoDwx^w^72oA`qRw&^ys2-5@Xd?+aV<vZ>qWwT+1+OHywe2fdbMrH|<cWVM2CN
zCxJ9MEpaAUK&f_pEs+TrSOtk4T12UlY`7PCI~yj!lnoS}GZg?OGL4Evj!A#v^Phh2
z{Y%@Mt4%X<<i)^c`PJ(;_If?eOZ03afZ!5#XBf>ufSEMm1TZy8;Gh`ey})83s-l?z
zPRhqmo2nR@nE_ks<Io;D$%joAplMv++_-h;_Ha0ynVXAMWbd3uQvzUQk8`Kosp`(g
z+HiXin!T#3cDHsmSJyYTH^2A&@2zib0=@kH?d|{V+wj>heBOD6BtL+Sjjh)&T)2Jf
zR=3+F1Y`<P&CofQn9M{76HfvrZFJEnxfsxjf+mo(0wz9$PO@Z@Dl%0wvq>Y^mNDHT
z>1qO^0Aj?zOwK^-YV6Qd#}JxPZ+mBRJ)b#&&ddZLA|<5?%;aLMJB54psZZQqzIEmL
zGG>&H`2GH1975Y65w-PRC&r4V1m$)!A2`0P%6Mq<Kfn|MZNnuAhHQz^t&&PVpV-c*
zEox6-x_s-_oz=TfA6Yb26(Pr};2bs~yz|ZnfADYq;N7?1QI+0aZ+~yMu4^<C2`<lk
zXTE8g|MyS-{O<bZ|M4&W<>x;4xh!WhV~6j)`}TkQkAGVfMF@c@MH}3N?r>=10YVCu
zw|oegDz)}&h|`AG&|=Z|XQm;db1u0V2^MZOt*L-wOOhc##AHF4Fp&4q+uONu_3AS(
zJmNAptj5R+XsSx=h=@X6G2<sb@#OO_Ja^*wF%`+!d+*29D24!&!VJ?(Cf)NM<Umfp
zLzC;Fv}K#{7!LooB^x}9GnuGE2(WVN*469Rn-G{OE4>6|1~I+x+MB=gJOAR}|M4Ha
ze&My7%Qv^SH%8+T68bD7$1#M^)SYf;et!PKg$uv^+rNGN`gIW%(cz$e>#d6yFaF$n
z&&&WwL_|Do*Lv@DNS=wCHW}mLZ%p4md@(aKKltT|IL$Pjst5hHZ9;-$=3amI&YhK+
zPEN@jX*&fGlNT`p3)OINbaCN}U-<m<&pnH(?1(0nhab2ODq$WT%zdvPGUx|pWGd0a
zFH%{S`vi%t|6v=O8(Ujj&N*LXU_g$M@kc-S+u!}&-~I8Ae+&RiOG|0S%CgLS7D5n_
zZnvwZd%Ju4`}+W}yuAGFZ-4vNt-D#yZ@lrwYp=Z)V@$LRZtJ4kJ&NUF>n};=@G?ys
z%UW;yp;HF{Ad~CxFeg*Oh-^SpK)}qvln9!-+TY(68IMMN=ZU~njmSCYLlDY6$53UC
z&YV8=#1rQh7v@Z*Zbo2AZGEwOClvl6@f;SU9ZDyEsL1b|m;1zd-&%3b-(6k1di{ED
zFc^-i5QIJchd=+z-~avJf92Iz0WmKMRUHfl<9Zw<1ZfPl)9r>3m|anpGu^IpzSrx$
z^Ugcp`Ofcctna-3`h_>&e2a*ub1EVUUQyEr7ve)#;i1=weyh_f-FAA}1K0gGY~A<v
zQ#AuqFg30B_tvj|_%35ZXr@8{L~Mpk><Gjmm^5NMKRfgInKSQQz24Lf<@vM~5VYZz
zgTYuUp>_<@smG5dncpYK$&=on;B#n3?zxAWjjQU)wQCnIUHbBiFZzQ2!=L@dAN=co
zbLrA0L}ccsY0y$VWQY<|*i=<R2#9DPh$x~#b$)*SyWjn8w>$Ip+n08Bc8JJ(A7doM
zX*p#$RJIjclLV&=>+l$-3pY{dZE_G!2le2<AAASx{v~_x1yd#)4fifxeEnNbJP{!h
zB9SwND3WC*X>1rF#(FsHWuDJ`>~!0kNp&J5{HVKs)b(H;|Np}4-Vq))XfaAe=G%Ag
z{QT0TEO)QG^4h=pSAX!zt3Ml86*H@9(=<TfyaTYL8x?F^SM7b1cnI^NXqskkZ|_h4
z^iM8dzMPJ|JkQhY6BB$yAG5>PM`_EcP;ruGJsnrlx`*GnXDdVMu5`$-IC!B<CSkO)
ze5D@uQ3De&ktwK{bDltjKr{xBSeE(1!knq(d9EU@)dT<u%sh18!`tLOiv}iz0H)(S
zESLw?=3xyyz2Twb9H%A$AZ%@Iz5Cv~7v6a5_rCLgzVYUpA%-M85dj2ZL;^{=%&hID
zftZYfbUEj$sw&HJFc>sV<D5$?fQUr3?JJ|2s^omsT6}Os2ij8a8Q_Cw#Dg<%&$6)l
zjeGzDizd~0w6}cYipI*3sfqzIdsU!}2tiS`@V;9XOo*nOj!aD?$N$U)_pZu^D$+xm
z^PXQF{sJDde(!x7i73zW7~_7gck$xI?|kPwKm6ej%&aJiWP_wS;VROqO|xXn<XM&u
zB`^b`CWg^)xUjH*2+W)|D-n*zW3z;|w35RIO!33d_27v({Ve5ROpZcPP5<0;-FL@!
z><9BB2lj^ngMmfRhOPea{fjY-3C%<ZG4nn~b&O!5Oe|3(G(O|9)7jo1I`07~s9Fkm
z5`q~LVya^dDYSc!@X~mubsFw_|GqtE4=5rtbI#rSTQh6bvM3<AEb|*%o7Zk!cbWHj
zHX07iEYI^K4<;a_JkLW2B4K7`W_EVA8di?E=yr$WYJYFf6b8c)rZjoNv|&?*Y@X);
zsmGDp{k;P*^$AJH(SrhT&KYR((x<C>x``1Fq&}4(w5KLcCk9$;IQ6K6gvtVf2PCE_
z^{tg_5{8bBGLa%0fPy(7^A4k0x*Y+=7}5qzAiO~W->2~~lQvi5U~e5Z&+e1oM_p63
zd7n}`^t!!MLNqW1gUyoC3n7S#gqV3RB6VFe(YUF8>$iUEx#ylcb?Vg8(vdvR>blNd
zUf1<tH175LFTMQozx#K81OUt&ny55+a%*pXa0uSN``UW3gnam!@7;@dxL3$Wjru+t
z=g|FAX0^3s!^A0V0hFkqW>Sy#_qR67&M|WHhN!8jk6B8NnyeUvIy8Eac|nBKVqS*>
zm}odzr1#11q4K!r=)T|5d&qC^yUa|Z7!d=Q7!xBymSvcON(4Y(6h!nZzw%4p{N^{G
zd+yUmk1lmO9U>ADGD_C$xT>=(zj*QOD_1^jVh|J5gJT#04$u`m;E!6noeV$`$sX{a
z?iuf7cJ33~bT%HkUX${~#Gu9L?oQ;ncJyEZq}6c$&Yk7?r8C`y1p|#5If2)Jq?%-C
zViuwhQUV1JyAlU~Wm+ouk<0DBa2Gy!qTs_WnBaCqsFq>~?ML2w0E{t;NS0+^``Xve
zojdo)Bah54F8C}XqO8cB^I4YVc~KO_v17;1o;{0*B9eUb2cLYxFL=m<J#+{MLsk`)
z`_4Ig;QEO9nLu_np)e$@T*(v>&=C-bNOSkja$Su*GqlkPb!LW0W@3n9&@_#xAbBEE
zL_lbn#j0)mx<xuMad7@&IsN~*@KC1t;c*g^0g3^67KZ5v8hGywA;w6A&N&rv%%3=a
z{^?IXb>i6ZEYAQEJ5{Mgk}+k{ip2f>y_iZFVnUp8!Wx;51p$yID|Aw?m!L)753si>
zG;`p}TPieh(ETn+Yr17q=d_2eZ)+L((lSNW0kqXI5f#Z)(KBqWug0cgrW8z86L&Ck
zgdu9bKh%5NL7YCw1cL^|w(nwlhCE=ErPJ%MMSl3a{0FXoc<&~K#)!;JjzSYu)HCNk
zJ9g~YS6}?f(WRxMOH0nV#64r@R0N4Mwyw_V>gqf1ydxss<smePNW@5OEFPwF-TLo3
zo%e|dErnH>`S7SG)~A>$lY3BaO<#YM`~bjAk_gRoI{Ap0ijSnupP9q{?p|Gw0hEvk
zK}`q|lk-GGAvAk?dx;{UYN?0R{eRWH8s?$b6yAMMJpb7<?~uZ|$CpYDfO9U{GKiSx
zIjB~nQCXIs`qZaB^W1YwOH1q>n3=?B!8#QgkE^C>u3x|Y+Uu{cudfqPmifs}dWb%M
z*l-_y*<p|H;F&-2fd9xN<}d~9pdnYnH?fT`TSTyNH5v|jF$SbITIY14WRS24q1PKA
zVVrU^4BIFf0_Y^fb!dL4Dgq8Iy88}^`(8YBc!$4s-$$5m6CxtV>_DYy8bU(@39%@O
z7oLCqpZ&%^J$v@ClP69jlYqPjFfh@m?7c!g8joLn_0^yJ<R{4k5fSfwdwXi*F>vUt
z!h7MBL(hEZgr1l>sY>j`r6QshY)i)Tg9E=$kY=Wq7^yZ<rzuqy4>;9;L@25VGT84`
z<B^*!&4h@ZnMjOkjEphH;b?@&Kt$wpQX!MlvP#IsWSA5E(+;OyGeBl?SO$lmc)Ahq
zH`?wU;e#S1L?jnN5Q$|`%*@Onz-TlmJDsn5`ODw>)~`SFsb`KIJLbFxMu`CdC<Twa
z52LVkcdgg!fB63U*RNcinVloY!@<}UnE`?cC40M#TTV^~VkVx-sb!2BwFS<S05mBp
zH8TZaAVj3Z;YZSh7~??#HcSOS5nW0I)ye!IAWlkfnHhji+KrIoi~%GVlN*gkp{}!8
z08yljq^=wS5h8Ik7>uiEgy^EE8Bl7fXlg2ElZwQIfS?*gqH|o=V?@jI%uGY5nNc-{
z&`4}jYkLWy9hj-ahyb0uph*z{Q%(EJRHs2Tfct}8Oh}3J=Uf_}D174^zxr$6`qq=@
z&mTW=VqtMnC4w2TLrx4;f&ja#8#b)}_Iuxd^Oe`iydc65Ln;MN4#|<CB@!2;ZqyP@
z1x(fAxE>prng)rYYG_eHh>d~<2__Lku-Ifprl>^V5Xe+x6PnsmH4*~K88cEcMKdym
zl+v3>!-}Y&5fO+|Vha&w2t;HpJD$+U3uIB4(0RnFzgLfXo+<MkQ+B9|NT3RcqBa~?
zlI)R|jBA!mG0@haF+>1jV$R3o(P-F5#JaA=;}IejMNw5_A_rh-$izelrio5V%mS)W
zYp9cb<h>{2rfEdAEXyb|-K_WNACbU}L?j`I89Seq<^1B}!s234mPo{fv#4OL!)gFc
z9s9d`S3bDBvAX{H>lg0cT_q$@wWLu%p)DWSCQ1WNs8}#{#?-`|bE&m0f_X=+zEver
zjFDBsc<cZ(1O{MYHLWCO9Y1a=Py`?XWI$}eCP}*<0T{p%8<nQ?TWp;}P#{bxDoO-E
z2EfFoR*m|h9y$U7hX#%vho~xQ&O(&ocw}vcehQlzn37E_YM2PrOhp~h)1P{JadEM(
z>)~LerdgJy$ZCwC9yc+>5Q2#|b(5xrkQJb5nq*LDR9|EO5M#s#LNjpaXpAAIcCd9-
zp>sg&vwV4FWqp19W2YaDO(RWYq^W`qO|!Ya`Qha&AH4VO+ZW%yvb<c0C>W@5<}tBx
z!O(ydK>-O22#~c+Sw%D|TnPf4x@?$$2_k6|C_-*2^%mLOU{H69PHJ6&5W&;|7^t~a
zEfi4{)ff<vK;a<g#L!d?OcNbtV)$a>pH8_gY2Jy+P{D?yQ3wqof+>@CNUW-&0ESHn
zgW(8Lq9TzQn5Lw}2WD1HG&0h!edAZpoH;W$w*W-_UVqr{U%!66ZkncPhJ(R)G_LEW
z-yfJ+Q`dFVq$v(D#u%%r+TPw(5q8dJSzXuDb2V89Ho-?=0w=0j6v@0-RgLlL)vGse
z-hAp4=c`U9jA|}2a1PWo%HGz_<@Y{#?Trg->uayS_s-p&?Z{I`1v4tDV%s$<b;H&K
z1}Ec96-l5hJ5o1RTPoEFsD?J<eMeyie9E^n!+KN~d67Z_5*x~$&g54I>zEU;V_+WF
z)HEI)5F((U8Ug}|Kok{LvsS&?0laX?m}*@H1~ot&3<phJ6A^$ifwPv(i7MLEb=?RR
z-db-^&5YWC;*_6eW?AND%Fh1oZWz}m7LR`67k_!_)Nue9@9h8Kzx~6cQGMoTIy3Wg
zv&@-uZZH^(#-p9x-Cn;pYU;Js)t%klS6=zq%F0R(Ff-E~SM}kwG6hM}|E6G&nz3`4
z^Fb{(;m)nw*RNf>d;3o5{nEk$bh{8^ted^Py{lKRzJ2M^jhi=i_WK+A`!!gCa!esM
zk(JEM^f2g0ikgx`6L(IOOdX;DiDOoXQMFrUFMj5;{?^W11%>nJydor314{@hA361i
zob3MIU;N)<78}hl!zkX=dm4wz2u%Z$17aZ*BX$OiF@m+;gux;3Yl=cnj3FJ5`r~S7
z8cofRT@X_RB3Fel7?09qMYWcx{V>oL5knpJtNO&z6WwyAC^{et3eB*-^1+pj_01zk
zjyRSWBvhdqRzAyTXJ?6ces-bTnQ0`b$&+W#apq1Qf8_gr{r#)guI=vZI_Eg^?R-uR
zIe^6AB%lPX`7B3bk7%UTxLLlreB;`+(<e^!_V>Ga7MiNp>%V{b@`X3vymM#u_|ao;
zz5Bs%TnQ2=uo)TFRg?Lgfm*eV2!M)aKuRfH9XRuyZg<!pS!mc{nPq5DjR)NfzVg}6
z4hC;6?u^O+5~DeUA~Q2zTPL3xHFR|Lbmx<2|Mg%0KLe~BX5QF4Wt0fDFGxVOZopzh
zuE^J7g$Xo*=m<G!p%yJdn51NzLIh(}Rb{D1!@>Tz8Y*<vf>Q-UBFDqMQE#`$gvexK
z);dOJrr4Uo)ATkpGl){=#mSQ=0bqS~O+^t<qC9c#<Go%l_u0(MOrGb?Ig7@CF+@~L
zT=y7+kv#D;Pd&Z2vm2Ul`_3Kb9H<$kWrs>rM;Q^3k<BD6$fjwSedZlx<;wEPwd>b@
z`Ac8gSYIuOfNc5Z&FfdM#=1W9=;;PvZEY>Y$m~%pc~@YNiUI+oT?d9JpskIV$_c9U
z#y#)cT&LTNN25_+K_DuN9i5r4DO0TwFlRC%RX}hVC`Dy-KFirrkuwd)6bQyu0oLVM
zH{%+VJP|0c11d2RDSBjNYwI%rAligDkQ^*S1Og^7bf}1;HXaSC;lRz#20*8YOisSv
z?{Dqxpyz}kwfIiE3*=tt!I*ibEN5ru%d&Iy=y7&#ZFS8#ckI~l%O89ggE;oHvvadE
zvss==R740>LrlmRHP%fdB2nUFXFg`|i$?g;OFzAK{d!Rp2hheucfiC`Bx+GERYg=0
zam>B_-p%Vb*4Ea}J$5>Tu)Do^{mRv9G=B1lCyS!<Cx7{u&8Tt;o*?B-vr*1I!Dwm1
zfK%WN)KX4a>JlB%p)^$(0mXRc^yz0m^W2H~#myTlD>v49Ww|;N7H8*Y^0FF?GNUkR
zmX0lM@Aq_OCLS%rc>7b&eDaG+v${*T({%d1Vz^h=qoz~1<8z}07?t^M&n@5R-??+w
zg&{Hoz{J}jfP?bd2WuEm&3kWP(O@tb3<mp07f+=!dO$?LG#HM1y#WzRYdW;l*JL<B
z>Q8hiJV8v0M~-Z6ZSCytoH=u5Zf<UGZ~yX#AKqPC1Asa-z5bwXLY8?z%$$!QdgsWI
zsz``p+B6N3TUtEw`Oki~X`0p5Rh{_I0D$*~LR2+%V=>h%%gvx^nj+7=_nRA=@4xrn
zljk1W+1a^!_wH~w1T`ia4M(rO{4%S?s3{FjRfH^aE=p{px~UNmq`r}sUXrOwLl{f2
z1<sBiIrjVuFMR!<{^q&U=Pv!=$2YFrEI;=6PO&-nv5&#*{Pwk*$NbFB?X}a-Jv+F5
zt$g%E_3=mEz4rR!A3OcEU-`xD_cvg5z_;(<8oIf;9kk=;&&TtN``zNh8$;Q-vUT&e
zO7ta33g9Kidn-a{?f(f7gvsu*I2`u-{rzKTjOK`3P-Wubc)Yu}-$Dd!ri3BfODJuF
z6R4n3#1L+-+(LGvQMI_Ru)DkW;fEipX;GG<Iv5T{;}NrC<|4}gDf12hVvMRWs)$Hk
z2Nhd7vh?_4k9RxW{&3LxpZ5fD3^7%}p5Q>!;EsrMZfk4n=WqS|*T3<#-M#(Ww{EYl
zu6D}K?OV4lz5U*u+jq*@c{0&xsmY*$5mKrt$c#oHCT4<W4uC|HKaCQcj8B%`bF)j2
zpLpz-&pq{}PdqpC=oxzZ&g%QOjvP6@F|KA$o>(}3^zPnHK6^y#{kd}|T(wy|cHEs>
z+IxR|(!29Vj;_yEwkO7<7E8pkt{xHLqBC4tY<B&-&NG-ID$=3-H${g5F_{9E>bfLE
z7Lmu*us`ep2mm=^C$T1=!Em&@x6=YLYS9!dCG$?UotaFJf551E>+T&uUR~dO`Q=w*
z2zj0@E*@E2TpU&7z5V?x%kw<Xy!YN`KFjkw^Uh37lpO_$fCy?LN+uyREmC}_E@yj^
zo0*ws2Vkj6XI)o_j)_7D3^p1Mu3o*myt2YbH*Q{k@4XM6c;d+r<$HhiS6P;W88eBf
zrI;;QqX7sFL7k~-i~-FuLJx#NQ8Y*E8XO__#O&;oOGlTo^61`JuH5Qv$KlOY9yYNz
z>ag<&8XL;2%A4|$?ryy)JRa%Ts)6@j_J<oEd?@P!zdLZ_0faG)>m?vvxm6XFhR19#
z)Pn&Kg7*!Y9x`GkeiTl%C;_!VE|_=R)YWJ>ATl*`(G-d6CRF1(1eH|r0E~#H90Y=d
zrA&G1WTvCKx_R^F^75@1C2=*p_hng@WtnAJmSsgzcFRtu+nwol)1O6_&2-9{nQorv
zM8w`PIbx?^d;9xQ1pp?tlePL_ikh}NP$A`DLOK!6%<?QBkH>%Z=YR3p&pdbK+O?hC
z-J2`7`n|zmIO@#K22wRMPSs;HZSWLE3b8R20&_$Tk!!&aykQ6Jc)`y+GW*o&M;2%1
zU8UD9ytH=VQm3<YeQV#A=6n6^bI+U~kzBrUxq;9R{WDLTx%lQ=O%uzqvr~<+4q>bJ
z#*co|U5_WCTWAJ2=xH-%Uu-WgukGH<hQs9@y}ojNtc{wq<PuAVRYJ#r5F?<fVaonj
zGgD?#!>SrLRpp6A!9_7Z8jh;{{;+DIx(oo-lmJs1Q^M9=Nib9@;sA&)^Pr}toRQ0m
zv~Pk+Gw3^Z=_oVRHY+QU*eTHjjexv&MYrQ!?(?kE?G8tys;Xe>$WJU9oJ3Y91&?6T
zYP!whS5QRg_4_aX?A0dLd;7gCFIR5gUR_(m%rz#BnqX?YK<%m^O+{c3fs9Cu6fg#g
zS|S}Ox<@<t`BTNOe(CXNpE|2~r`e0kKe)8})|JMs&o9iM`sAmp^QUK@KKp~8{P^09
z8~^AlFFy9@sn0(1?9YDq!=3f*&p-C$;~zi2$JC7beEsIpG0l&ImqyWHUKnR;ksCdd
z%@jpF;>KnQ(2*k_q;=^JQ&<!3hi!=xQB~(Ni7*-tMx%jq40Uv>226v|V1LjH5zw^`
z<RrkL6TY<qxRwrpW@aj}jl0m{$O9sxs7!E{NeCz5NRmLp7(?`#ABCoAf~vCjgw$@q
z2V7B`GRa#hCIl*t))358B}Ul~7cX8sdGZnO-S*zzZf{U_I-}S$Fd^W9qCwl_rNwMh
zV+{cj6Lm<PET5m7Tbk`0JJww|c|1QhzattN(+)#M!Wc5!uJ$|mnS8dKJ9cDYu#dUh
zANFgh7LOiroXyV7FaU}eI><^lpVe6P>rvp$<)!1S0dXD1V%9RF(o5CE7@{e&V`7A9
z>#md$M*xu0zKLi$HKA!@6H;?$7sZI6-yaT#LxZ+#$OPg_W~t(IOTfhOMr39rNEvHW
z)+`YbPHU~Sp&1}(b9Mj{PVaK>ybm#mS(fLB7($4u#I346EI&v9;^e^~otJGK#te)Q
ziKvmdxx1ScrKk<63K(k%<Q<^2_tUm+1gNI|XJ9I(Ajz%AbU-#C?2SfOHk#(=SC8D?
z*cuFFX!X@~84l3Jo(|)s;CAokZ@>BBt(CRyjrXr!&JBO|%1<x8cd;4QHwODfJ~P@}
zhmAY=V9*s}(O{#-MvPE0H$la5IT$Vn?T`9m;PQ;wnL*1LoJ3?N@h3zCOO+RGQUKpf
zq%D}?3_u0?{r+fNF#!=JtFuiuJ_z5XoIfy2cpDg`q5zYv*iNyTSzBHQrl%>i+R+Sw
z37HVt`>L+ZlAdhSVbc=1e;2A+qLHLTzNt~#qV5y-QBVLjwzumh7!qZ^u7mS#`sAP~
z^B>6&jTlhGB*9PsL>PcZCN>)Ejr8_F-q~5>oJXUYjorvxtq@`pTo@1H#_h(@UZ`pf
zckkYDL9br^U^p5g0&Q+W1gh)29u<tkrUnPb8Z>a!S$1(83?TOVW6mNG0CM305EZ9e
zunkfs+k+@U@+rzEQ2>~ULTCp4K637eD5&-agSx7j6QpBE)UJ0^HO1uZLaVxzlM6#4
zlEV8$#N7Jbrl}er9>h){1zHl53e6;nk$1>UhIP{<zagbh!o#n$^l(Bdf!1wmbA?R-
z*m*!0R^t$&^Eo*O&O(Sr2-p^YcR;?a`{<z!6QZI4Kn;LkVmg+Hq8cSO6irzn_ejX*
z(KNCsfds_>W{w;&24%y3e;k=a6{I3DZ-#l!WicEN8;IZt5S)St0tz9Hs!9}nmNl_4
ziK58lCvg^=4D)d4o01VABE~?7)o8rEy>;y5#~eEzS79_7#}E=rEUF@MI%MF$h-lBd
z*4iZ^B2^HLBARv~C-em-WaoR&v#EEQID;<F&~fInaaF0BcaE9kq|fbrvP5i4jwR@O
zs$N?B-2e=XD8_~zGq`BNz%I}0reY)j&Hz1-M{=ona>|SbOQCo}P_+syfO$ej2bddY
z5H%ymOch9Nfum-PctAyRxhKF7B18f3W!bIBs%l`WIiVodLK;CiH+3pV<cw%o)sBiR
z^F*adV-`K4#7Mv?U}*<lF-?Q}Es84w%r?m_9u5av8ylxiKkkSbtO+4R6--r|QlzO>
zq(lg4fJli@Vl90SLI{Z9CMECEMB~Jjc~A!JS|VcR5CWK0<1v=xn8|x0s_UBCI+O<s
z;6Rld0LbCB*&Y%A%#3E^@t6rb`=$|@)D6jeDpn6(!5KOvR#H{b7)%=!VKCp8DUsw%
zr5G(ZQ8eYC5JY<rG_%>#lOTWv30g-m%3WS|JN2*`^@k&em}kzAR6Mg)u-_X|>B;4w
z7^6i6c6l_=pnx3JL_$`$28_Lrk<60+2LSDpNFpBt0D_1BPr2k+)zyBl$ISm9s6gfO
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
zcmbqa<y#a^7u{W!2HB+rq)S3Nlv-d(>FzG+5SDImX%K-QT_Q_&H_{-8(k<N`(y#x+
zJI^ySU*^-DJ9E!H_uMEo6*+ty3LF3cfUh7A*Z8+v{hO&+pnq%eLMs#icz><{m(=pk
zI_j`Zw4U{(ZtY#!$;y0(P*tT?deKeG!VCc`BoVVlr&?)D;!M1GU;BQ-T0b>wwayA%
zW4KWsojtK0BooE!0gxnQL`u@TQz+%+jPG45vmAEJ`bvx+<xs0t`d%DNmt|<9_6E`y
zf8PY!o-}k_Rk*7C$$0D%xO=|Ce|R3Q4DlrK!Y?nYb}%!JFh)CIJEYLlHJ|Nn#c9Ks
z(Vi2iuI&B4kC4a5bumrwS#p=a#V^lA%XF`~@h)q%1*OXA!iQc^RBlzKY;lGJJ2EWN
zB8_JR=9U}!{ZD6uOcr)1ZZB`Y`4uhy9m)+77?pol*A#1fH=ldk^L%M*DlUS%`q+5#
z%p!4JIOsB`Q)a!g^J4Fp)Xm`2Ue{>vT#hsX5k^2x%)}!w;Cmc9i^qfC+oul0f|-P?
zrSlPToBxLe#>EOn!Z4CZcv!(&TD0nffN2;AiTs<PT3Om0_zI{EkSyQoqi}es4%G(A
zOyfp_=wAW=S}+ZCDD;Y+`e)QTEk-7|#?L&JX?AazI@4q@1yT<U4-Y?A)MtCTn5KE>
zZkXV4m}LQNcJR!#DVdP@Y99h-7e9;ezYURlla=MWob4C1`)MWc?@&l|4TGo0MaZM6
z?`a8%q55c<!zlO-uR@`C!I!=;PeYn1JAV8mHf|`=5+W_z$BsdZfzBw!2m^y)*4>2I
zU>TSiExo$7HlUkb{rA;@Qe?VzR&+RIF3%iH3un}pl>##ImcCGr!UBXLqX8H&mR&5p
zB+0l?5UD)%YXBQ9gf4lwj^ErF;hTH^kVe@~#WWkWfV)H5XU0Tfq1cCJStM^sEd5j1
z)8=}rO!Z{7%k!l3yXoVDE=HtmDP7w3)EMsj4=W<xr>%vbZYGqBv)WFj247DfB*x;O
zG#3g627`QxNh=h4s6VrMy$HpylGTPw(aNZ4o6)L4BtZal7`%YJhcJndgPyIbj4hbH
zKpqQ3&uFFvhN7!!Ct*RAA)m0Yz$2(wxO_A#5|{{3n?{uu(7q0)4F(DCfVS1CBIvVo
zP4%;keZE&L@~sXVMYl7l5Nexlb|g(2nAD48hZcr#5I4+y*20J!q`93*etuegbkDJ^
z94edfpA}hg-@LO_6+i21Tk*-YJEQD6JCJxFSWVE8c#fDD7kwN)I}$pXLl~B(gjNio
z;3{8uq-1+Q!BDJVm>B4vSAkFfa4Z0a4H=w9rWs}V95iZ-k_^M)0ff%NsI_IZ67gt3
zc?E=}KrAdJxZVmjAR=!KiVlS7M`%H`w6sH0pMn)CtkXoaPbH_&CFu+8kV+ud@uJkQ
zIP^G3$W27et`vn)@y^9y=QW&{TiDb6x;w=9`Hn2`xbvj7idWe8x#+~i!0APt;M3^I
z!vf`stLc!zYS1%f;C)!o`HxSzmuTB}nJ2B)_3c?0nhwI%Dk)J=Y+@ibiMIZ9nJ-vd
z3l4?>z(-stcPNk*nnvjw5cQgnPX74<&6~#G6&{X*{2C0W#fpS#r2s}=RhF)!zh-5n
zr%g3X!_x0AA&0>j0eEysZ~9Bg@;GS#7ro+&`e$-_^+eWQ4yPTN7kcD{7~c_H_t}_L
z60Y~lO+szi>HYIfog3n@7ZQ&{Ctj_`KmQmetorJDe&zX$AGEF-)YaC=-4bwqnjcU+
zVPs_DecZNsCq3PhL^jT!>+N=YcxccQGWv)C27$mxWavm9kT`fmH6ir_8X25%oe&Cz
zCK1ZfYXPBjQZPb@HW&s1!{8V&Z2`zbPuL*f?^wDA4p2t@3mzs-X%rK8B?KGGzMm)`
z{pT7w3>?a{iF-0F7ocQ`Pa=&*K?q>1ACnE`r7xtUE`Kf#dVcQ`be|n2eWhdT8E76o
zDfYK}$Np^jru{Z`ZYtORoJ7puY;WDj!%fhkV&$>bu&pDa>#lE>OlN!cU4J@XanL1A
z$Mfmc>9$Z&f|$s~JXc`bG;U5TQQ1&IaGxXyipB=OA_SpXM7`ge9VJqO3$}6FV4%aT
z1xxAa<*~vG@+1LZ_4i0+*ZF0{vis@UBthUBS{<&F1<y?DQW+U|tnP(opCdmQV#d2d
zhP1;<@4gQuXJ=MFF@oSDrLah+XuWAdqs;|<X4<!oDaHTxn6~`6djtS!ovOwgQ*FC<
z%HA)Bn@^<v>A4%Kv23DGAkA;`yNMTZZm+X58B4*W<oQblR?U68A*ub*;_G>i-_3Hp
z%ejZ?<F!zZKS>RS;CL38U`!`8u{Ko&Lp?;h7lS{bwSEtFsEG;I-WBl!YXh|DL$9*S
zN&)hO?$~?xtIx)WrNG0rr=zO21D!BMc?GR28L!<n=kUt#MtP_Vu~B7De`MdzSZ_I7
zgojELaj+V_P9KPyl{mE0pzO-`NaW<*`KO@MGNGkvO#dc6g!$gs=ux_dzJq$UN5|>z
z_f-=EJ*S2RjlcC9t*`7WS^?&74KrK$1rULXt;><v85M~Wgv{3~b~P?!kDK=<HvuQj
zby8vs##6lpn!;Q-1x1KA6JFSCl$`-+v~YS0dRa!e6|)Uoi_wgk5yMJ`kWmJdcm64M
z>!$-3g;&>Qj6~a%k?(%V&Uoh?A{{r+o<3mWrt|1`?p~ItPYx^bI1ky3MpYAqwu3%%
z<S+&CiDdUy1XGRRtO@QUj<Cg*cx+t!gX#0xAmZfZ@55i3tNxe0?6$dnPw6ew=_y-p
zfBLGm&0xPMh`ERnaS&-bTv;(w)1FElza8@&WF9mP^pTW)I^SUFJa3|Dxf*Z#)aZz=
zIlab4x_Z$_nVOc?<-X21xZyJttY|>{wE$Tf3P92u+<p5jHT11t`<<^A69A&E-R)^I
z(EU?FxCT5&C02X$>cpGKBXDy!{#NE9Dd9oA>38f{IML@sYT@dOA1*CdMQOREGo^^7
zr`El_lHy$d($9T#Rz!wPh<D5M_<bCNeP!y_=X4(>DGPF-e#Su;$_U4nqk;0bk5LH$
zn`fA+qE|;dX_?A{(Mif3P0V{F=JqzeJIB~l#|!J1Ynxv1Y>6xT75!J#CDWMf%#Eb%
zwyIrsL64b19f;L&#L{zsOY=#amoWlKRFQFd?dR-&JaxO*z>k$wQ7YZ~0F_kN_6!qp
z%t91huvMW-vDBV1Vf9^iBeP#@U#FM_tf6(ekG>Lm$zEDHZIYGQA&(VVlV<HUJzaWw
z-L$%V%+Yn!iIAgu?CrWkr!2vJ>3X^CXCfpa^!#(SYaD`<kDv{fl<p3PBH8*Ps+{J1
zr?&q7d4Bp7bXELZC)A`vNu`K>(s{Fu5`5U=k^qvoF56f<UdbUij5GcXL&KFLndOnC
z>!a^ykWY@B;W}?V6e$WV`5Xv!-3|4>4?0H#U6uH)KD0LZ--r+_d*APxJ&qg32b_o4
zvZeS^i+&CTfe2B-QZL84Ne<0lm5ff6#hPQOgNXrA0QFEpz_l(3Vbbki)1d9G<l+^d
z=KvzZMm+q(&K>2O+<>h*nVFK=T9FfRUhxsXYsZc&iHBSt>gUX$drA)vcB*NE9}T|K
zR3gGYi&u+Xj}@xQDk^h!eF~WWB{@Q@i0MOM4#M1N{iYAQrq2lyk1_q}DI)RI&*{0h
zB_3%ej^ARgdU`VBkCz()ZhDtm8n%C#KJ1wqwKpUA?|zMvEo84Gp|wTI?#8#pue$AU
z3a$7ruAeLZF$@d4T6BIVDp<cI-F4q)`p|o+IU#yRB=LBGSiSF%YkYA`jWv2(+at?H
zQZy%RhL<Nb0wabi{*sYrs`%vIkkbAN0+<~Re92Z3MDSBWMv`ReVP5XZd2oD^VK8BW
zi@57vgvR7QQ*2=43Hj|G8lTl0|A~%&W(g%`oiCQSn8)mTpjGckxni5n=rQTPT=AM%
zW`ExFLmaN$%m&?GMc`fpk3@=rW6(A8*%G>ZpTs0?Cv<deNYixf<MxZTrqfirynic;
z(7bhf>O?Gyh>QO^^1A7~!LQJ9v2p$(@o=fz<-5Lg8v*GZH~!Pvw(7Ha_n2&nhV1-p
zjFu~L+Kq--@j<M3bln<0-}aNKJ}tQTdtXaD-?`u&JCDDq%6h!sYZ;GcaH*ag2hEjz
zR`&$*=Vg4BNX?P^x(P%X{L+WBJ%=e@h616eAmUV95-6Sqe)X^YW=tCYHILjNSOf=u
z?bO5%F69Xh0)hlBcC>Y~!Nx}h>B5Tl>|eRnX0wwGua8%Fc#T?aepKDhFidouE{!Im
zMPZQX!(3U>?REaH?AyC|dG#B}IPmUlr|JZr+&u4?p|Lc@b8>8Ri9cW72c14*7W>wD
z;1;VYXTKAeK9Xz@%;+2bWwg^bn`4x2BIae~($?`1F%e{M;m<L;^eOOQ2XRDoUqka4
z<z(p>be8t?d+_-<M&e>3$jhyvW9s<Us`=B^cOfSa2(f4$A%mg<{T+W`fP`~+TtL{>
zsr92kG}f=;C-5T^Hghzkk7Timvc%=pV0neLe$v~nDaYq0nt)Bs+@~>2iPMm_lh&id
zk~+-m)rYW?=ShO6@lO<CDIzCJk2&`z9cPgYN7MZ&TU%X^o3^dl1@h&-a=YX>U+RYp
zG(Lu2622eHi1O94EHL_5sjtMPV*1}6g{8!)2#x0o5hcB$xAJ<3Xqs@m+WC%2;B?{u
zl<3ZY^LFJ#?C;&|^3!%x*G*I41tRcz=lOd@)AGtl%#Nwp@<C)CdE)Ptg|Ys+Hi8Nb
zbOlMqMEWFcMyo?P_bs1UgdPg#pxf!(^wH%_TO&TEEzX2wAy?qpLGgr%Ml?9IriMtK
zjRAKw9e27);&QC&c>(i<5#sOZm5|G7=h6Dq@J_CA>3<(*`}!uOXJynmE2rkYY2aV0
zzoKMLkLXPq-1<x;-FK9yw@q*ezGA%AAR^7k!Ka0%G()xAX^2aViN_j^t@<{N)T8J}
zK*1bE9jbwQnVMz#9VRChS+dir5|`DqY@hT0WxW_DOf&6^CZ&V;(y}r#lddg;r@W-C
z^9}E#aOqPpO>Q$Z!hmY@3+4OdjVWV2$*LW5D16e&!k=ieGW*u~Ca+!_T_SQH4(D-W
ze)DAy=DvN!_@j3G)`Q*QJ?@FmY@04ilWwVD=LzP@O>WRt0<SJgzJV}mQ)ZjkotcDC
z61`vyo17Bl!}8UFVIxZyDE%$jc7U6Z{JVZqGB%C@SZcl3Ps{9^sIuu>pX<x{60atF
zz>pERc6tbtjxjNDN8jk>m&BULxkQG-;8KiXyIiXZcD?|y(yt^3D$x+^_i~NLjlsL;
z8tm$PrO0l&#0$GZJxvZH8z;sgJBI|(>jxnf|IB1r+TVx5C-3ZHTfffyhnix3S_^vk
zvD10lj|f`5ITZ0X+b?2iN4OE9?-A4U0BLdLA=b4piZ8?vee{1oKda9t6-NqkW&(uQ
z#^RCq0I~XJc0y^_Bckx~QNkzi#8_;c6yMM9Xu`vxQ2P}7{cH@fm%LzVKrrNGzE+m2
zWynK7%?nUzX=v$}UQ*YfO#2oE1(}d;EMG2rB@P@MoHbU9Nth$?U(MWGsbjUMmoLkK
zNdFO&<YwNp^-)|?@3k|JG#&AWK^hsuGQ(Z#*R-TPAp%nS+Wr7bdYYep#b7*Cc?cEY
zqtu|@Il0+mT}dcm6c|7Y1pu`jn%nOSMzE6NaIr_ekVyuEyZr=^<8KAAK`;ojU^EbG
zm|La*J@^ZI(N{o#kg6Va5?iz$+b2aVcsPvdH7=oIP!)>J4htLtg@kL#wCl1JphAZ}
zWFSOB@djj7!fTAGNchbgv>&!s{jCGvqG=vnwl->L4M(iS@!+tbfN<@3I1ZbMk`gjc
zMv<cwJ#WBq3KMIkniIHBL?r_-+vRhd0+i-iBua+S^HNG`^W&k$`4Y`9doXE+J{7Ry
zxxwlxMXyx(;Y(O4vt-06l$r`c?bFsarcWVr3Hg%1Zh)^EhCp6;C_N!1A@oF=s)nta
z2Y?rB%?SAdbo<aS?L4uFDwvAH$Ivy~#1@EmyoI6@YfD2w{8$iCWK6I{L?Rhou=Ruz
zcnCN$L<R^$%oT@8AtS$FV-IuVnjITa_xa?;u=xm(604zMAd#XT)J9l2_@PL!B(V)K
z6WqA?Bn?r(#(QC-(nUAyLWRtn!=Nvayh4$p<?#m7(Zb>A+SWGOHWpwheztTBmJCeR
z|Ja%1{ZEw?s%Gm*c>oydG-_zrbl8CKHGB%R=zVq39bQtowgK5exld&&io`NW4XBK7
zA54UIq>F#6!)WW>9PwsL&tQe`exmx^V&N^xUP76sPR3a|nK{OKBRCCF)@26aYat9f
zMqEcg971kjDK}eQ<>+834khp2yBf9*%1*(;e83cDlPC>zk`{~AZukz0JuE^a2Q7s5
zK&C)2n1+r3IP^cdXp5ofMgakABV{&-J1K7|ovLI9TPO~Ic}CF$Ns#1*7S-}N@V!dJ
zYqK>fDd|to5Md}UkdH*hM3_uVS4WpA7-e9Y&L95+)}f({2i+Ve0iru~+Xa@~{^gsH
zxO_<0-PY~5jpWHgVQ8BYzs}<YYP5ujslVL6v`o7Kyc8szVn%fNEPr@;<QOaiAIRfl
zEuaNFF2C-qvO;ka@!X1Xa|4JV=4y~`*f%UfeNDGY{OGTOwb*uMV0Agrt^!@G78?nE
zTcc{{ZCulm+hd&JJ_$!FtA>k~!*n!HU#xx-LuuTG3X2Tmm-97ZX)_{eaKz|hwhGq1
zn0L>gKQ(8=B2{gFc6D>Tw}x4A6fcaDh`-<`TXSz3vu=pcGV<ot>yKG<9_|StMU20_
zIB-n`s<nI`f!*OFj)D$r_@D%yG5nPbSPtrdQYK1&^Uu*lRbbRx45@k)kCdbVxvb2U
z46TYg4M+n6iy8Y(3`e0^_+-yfo6B4W!)pVf<@SRi{5DKXix=bEGE|gAJTgg9^Ayp2
zw^UdT)2y{T3~$p|6o{pETj*cf<u&^*?;JI{Af#NWqYap-=HBsp-~14YU69KOxZU#@
zwNUftZe+F+-Q>}Osc8YUv2dcb6vy&UY(|Vg0J~uoAyTuT2B>*%C>;@$K0Wu|R^kCS
zP2APZ_xP`Jld>bt;}Y38FSfiSIh}zgL`rQc&z=V)Gxckg4@8vN9f9-TkgzKd9iQ&y
z_Zc$h#lGE|$60~Axwr4?9Y)PkLi}y!7_UkN6yQ7|o&_@0Ux-<2XGp~-G!g)2+?Q1E
zxWvaeOzgK_Q!2)uWt+IZCD(@Fntv@2qFJf@I(l28=@Aq4syY=K%)>iEuUMlk6QVr4
z<5^)-rzzL{`AxZt!op!GAWsY9M}-j0Z4FJ^^TWq`vFA0K$DZ7Wn)inHH-{^A4$nj^
zDxdRcV@M@&(Rm!Z!&pnn!MJAdsMs@;|462ZKIKsld9|5a<aK&}gvSU}cBdY-p~)97
z3VarRZBV-{);xt-?5I?sp8FqF!upU%B7`G7ueG^#soJfkU8lbF;yvywH?h~HR|}~%
zHHyE6qRU-h;A<Xse==@EP?;ppZ%6A^^k+ftugdAL(AYFg5Bz`hH2s;Cya!$kNVd!u
zI<=2AFFpUf@8ZJ0?9(i!@jbnOj>cC=OFXKs1pS#dH8C<cBXnBkdDpby1_by+Ot<xc
zdgx&|`O)u^v`|=`WHPc}l(OJs(AGZ~s<B$!AcAP(50xD2zr6g4QmkLh&+H4RiW{Se
z@UH<F!@mkb+TkgvhJ_bLjURu{$B<?EWR$=g>{qT98&8O%(FQ%(N8JQKrS)~kYeTy;
zXA1g-29B0QMf*L~JV`e%c5!Gr(>v30P~e#AlUX=e3lJQoMGU~M`LY|wlu7zF>CrUk
zLRb92;xu*X>;TdEFAscL+UdH=Il2F%GxPXe;@$&}wht981Vyg-Qu_ijBBmS^wa5#@
z7Y;nj<6xft-fNN4vjU$(Il=Lt^RWpszJ<Kh<xMwny76r>S6Ns#;PYCCjfl1|I#%$I
zGNqKKG#dPvzP(<!T-TtZARf=k-XmF6l-X%J8eaAr92oe$t-<?luf>^_x|9VCjRXW_
z<_X6uwJsST2^q%_>sD_0@bE&J1p2<EAeIVy5=Gizz=`;HV_fC8n=jW^%hqX&x?zyG
zs}x$jzYEFFmbj^UvP`le7f}16{v|6ihxLV)+y-Ngp%DYV(pO1~S`7KH7*1!(3e^|7
zzDFv27bT|Y`Ue%9W4f*8MZcXRd*2dB!g^gRc;AZ7z5i{XHP7?*^*ZNE!wO()ycPRV
zQQCNx{`-r&O+m}gQGaTBLPAnhM6}Aw1_=T#_O7QEeqAp86ts6##wbJ6{yoRb3(=dC
zjR;vPhEkf??pupPwbFg~OigX|TH|R`Ysk6>1hrsLbPw~pEzZRk0<&vR_pA54F~#DK
zT~GTRtM|u4W&%+g0fs>*--F!Fi#$*y#P4y|W3mlD&Hv|H@pO!M9wO_y9O`|LAxsEG
z9eOAaO~uA1=s3TtEh8OPToCd5;AV6C(aANht(JSY*Kg%9C;#lMq~v|JSD8)~p3d0R
zp6+<N@b^7M|HU&gziZ;oX#)czhd0XEVqJ|hom-8D-$-ZQaF%C_`<?yjzvYx>NETs{
zqiEQu>Z<rXB5}XxLbcG*rcJ!y@M^Wmu)tUB^K>GMdO27=wv@J8o=LR}4_2~sMHE(*
zv~O;_vtRX=_4gIl_GL@mYT#Wj&BJ8z%`4%~fSt`5r$vgZ9@@3q`j%9Qv%Zb>bUH~S
z3{4uTchY(h`CaaXt^Up7o~`jp^k-qP<oB-_MssfkKR(Qj59cfT1$qVAczH4z>L35$
z;J-Ph@|!R`epQZdEGqGMSU2J6SFu+2{obqVX~s~h)xKWO(BMBC*Pf~d9T5li4|QT0
zcnH!ouAJ77fq~ZhzbrVTx4Dd(T`Ow?Zu&G60=3r%;_g`%%IZFp322>tx^`Nu-Ds`0
z-i?|s?*>B6;STgWAXYXbom#s(F0SOsO!|C{+<863)~MpFjg3t$nMsxiqSNE<a04c`
zv-7mRk=uN`UAWj7FH3UwbklVbk^C&}OUH~`@GoflMQ&Y|af!RHr>OWf5VEwe7kmYE
zBfau8-hU0)nUwyXh4?+@c@bjIxx&*pWhC5+xY=Lt?Z^GS8hECaVf({|uU5Fa`Mgha
zB98G(9-h`Ur%IL9{<N>CnyW*z4vjp9srXxC_TKn`Zi5D0o(#auTX^=&oU7Al&ROr=
z^t575+zUMZ0i}c6sv!HtGob|4rR8zyjGYEwF+>P9kSp0+n={5tkhMfng0BA0<VUga
zHzi@EY+yBR7V0+d?J;*Od~39?5rxG$0dD3kk88TB96}<9_NNLt7vaCB3|xj(wDdH6
zvI>N=fcn|@zd2M(1wi<v(HW%ZXtC1=8*bLuQzbYH2L#mP-K3ysOMM3)AL~hL^H3vx
zjUSYgKYw;Np7k6Rh7H($ZwQy1F*w@z$6sCT9}asv*_e;6eYI(K;;jd|ybDB4JKw6b
zDf0e8Y1=~y`le9K_g+fbU32>SHSu!mu21QM_6Qm%pH_|ADHfAJSMA}6;-C8R`!;{^
zYdWx+8e2>yOeVB6Lykt|_r7qnefMERhena$oMU8y|78qc-4E5kyVpEDIxVLyOg5Ca
zw3=z8FJ6g19N%|6PduO3l^uPtJkZX@h*qjfd(q!;%SYxH<6t<z!p?&^`Y*3+Y84eh
zyf%Et=TK{*E9H0X)b(eZvMg?Y|6B^ptEJF*v>dS4+cLi;Lj$ULnX|O#Yw!UNPu2U-
z%S%<IZ`xNNs%^CF;<x5^X*9EzEnh-IE-VwT_&As4#%YT$IVU#a2oC0`HWj6!f}){|
zn~;XRU)J=INHu5aJ>6zH`WhghZpks9M?M|UocJ25_RumR;eV`TP;&GxsBue46W{PX
zA#u_UnT`#$@WoNFY3JGBOpH$~BK=bPZFcIgZdwY1e<99p4&&F~pQr9sFQZk~4K1}x
zRQMw`lnt|!Ci7q2d%0v%vA2&VGdfhsFnqU9p0=?a96wke$x~%2#oOX<`_GH{#`)&`
z#j+z)bkW<~J7)@`g*T2)cHtg{y`e@fj#2#yvC89I^<@H=DW!Y^3c-EfSd-YQG|}ez
zxT|3JB$7h^!EZtTDDZljTg5_IIM@jJSw892!nDm(1Xs{^Ms1cH1_nL!5IycZcJ51n
z*7}M+;<}7La|%EiGr@xe-RyW#`=%ii?fc;8m2=NU*$+L&S^A%KiYfR8rbEIkfA5UX
zU?w}y1Y9kpoBT-@UO`;W{hf35@U<^mZrwZOS(~edx>_zGlyk-S%9{^<PF^o4HZ{z=
zsF<>q8FTBO6IT4KGI_Lxq3}4bJB~hSXGV^h%rF1N>`xCZ8iWCYOmzTPUtT<NM$#4(
zC>qUty=HF_>}E?C!FN@LsZ#Oj5o(;!p+@u5cV-Oe-3*Xspd|dwIUgckI?8D}-CsjK
z(`!yys0oHXUkl^z9H}Xk(u+7|bv?rzTgl<R|GdreR@kVfDxCU=7MrGJ8yUk28<L<g
zpp1$Vn#Gn5UT%n}>*u`nwK+Wx>xx;=E1)Buivyl=tjlUkefw@Le+{z(LeJl-*WJ&&
zp4Y20+2oys=khC&&qs#*3V5XiY$~x#VQM(rdT+S2rHIkhUZYbU*J&=PWmPR@r*Tnm
z1`&SAhkOh*!6I+L>n#z*fe<$Y5fR5ii1=zR2=Vfw!>M>awk{9<gG*0DRY3>FO`IK<
z|FPg>8G1SPBXwsoq$gSB<aw$ZXXBkSsoIaZS*3|3lkS`m_P)NWD*@j!swI!eHqSQu
z`iNHj;l|{-<c0Pi(0(}3IQ8b8@s3p8?{BOWxmoRJHW|h_#z$W}YZ>}c5V%8moERWD
zs3MasWdpw<K``-ioF3(!ey+P=WpOVf1jvRCEdG)Vod#gx;2p$}Yl+FLL7`ZRQimaG
z3=UMjTDHQQGEG?h%ZQFiT>|Y$d&BF)%d)z~%EcPL)u*lbz1t$6YB<_ij<Lu>Oj!&W
z*EHpZ(W{YfJ36E`rU6&|94G17Z2CQD_zHaSFB91sd^<FJE-494RvPNYf@5O|R2^Sh
zht^LUn&_V^4lob3JIyw39T&(gPASG~uaOgnMe9a2hudhru_e;T^xV|wSU6Rql=(p^
zPYE})xk4kB#GRDlN3teGr!Ks<d;OwR?WHa#3cv$lll++&a<Y68DdODWl#Aj+QK*wi
z6@89%i7T{s+*c?vz^)u>b1pY2BS`pR)co;j^Hw%Mcr-eqMgOF(sq?WDsF}YMri%gI
zney}Wz5K}|AK=#@AS{Xm2xM+%*R%4bk-=i&1I$2IXP-`;s`CDZZ#tUgST9c%$4Jv@
zcS(M=IX8ce<33f)L1%hh$WAW@-qpp*FD(VDld1g&xhrzPqQ#MvA?~nGSEC0I7WP8E
z(ry?pylo7+Pk8!%<NPW&v!%Xwzaz3=$HUJe_K(TR*1x#H(J@u)<SDWdm&7U3RLRlg
zpb+31oLTn1a6=m8ZEoXh_OToXMpf)1MBLf-Yix13KCQBX-$mH#qn*`Ul%avKBSHkn
zphV|_Lx{@L*SMa)#q!>QdWU~kS>~S^vFO#9ja(VzOhNTE_KNJdu0rXT#xo?8dU1Ck
z{3v7`IgS+^ektxcRW(2iC4~|G%wtuAsI_}YhHzTR*iOXP+;rSLMac@Bc*RDepLOav
zSKwO&e6&MNJ56wo7ZM0$_Du`l^ea~J=}~q%KX)o>Wxfjv^znR4&_5_~JIv8MoZW^o
zIEYCh-P1NRvcEpI)LWEZlmBP>wm-k;?oXjyv>F)VK%YRzBS`q6lAo;g===S3Wl;q4
zm9ukJwRwFik`~Kx>e%H_M5<5OiR?1F{$OMo^U+l<t_Wa2ZWcB)B+g37;jof4dUs@&
zhz|o2N=eEB6ym&H-~2tOk~r-|bZq@yc_lj|FIvj|A!kQ0`n6()g9H1I6nZY^NV#SE
z7zkw;n$HBgebb_WzER-iB+<ViwBmlj$0gb|b3{De^{*&#5yPG`bi7z+Yh`6M+j!L0
z==A){R^sL~N-p?=omC<crP{jhI*j6K|L2-(@v8};G|a*4dd;#dT1Yg?7izW+0i@sO
z7+6U^z^5UgFMsF~aeA30wc#jJJmdk{WOXA}84*!is*Wuaq9)GRM2l^VJW(N(O#@3Z
z04p&`JrY1Cgp!PI>Uiu#bX{;-@@R3Gxl(`%3NS#ZS&Z5xWjq4igN8qUpdTVUZr{K8
z8po=hb}xF<k`=gBPa@{E>k8kFH*_W_rM_H`h_M~drlg`;s<TB94)$Q4{+SVR30nKd
z@7<-_Uehe;(omxage;_{gRL4>9F;#|`sMGQ?JAB2OM>%j$EAr$?uKoeA8d!e3Lf?G
z=9fMej9ihh(9dxN7S;+cQAsp9S$XR=ygOT)wdF`J7%H9i&8X0}Py>S1fIuc$45>5H
zfFa+ShMSH@r;~uy8yOwt6`cIUH7yxN!0XqF-ME@{8`9FrM2moGd9A{XIQ7K2h5F<-
zKRDXm&x>Z4ukI8Z3XlVHYsUQpLR2DNb|>OCzxV5Lb{q-IMvgoDDkTCR>n21^owTYP
z7~xZUA8C2j1q8pX*Oh<zXg@6^9V&|t0MbFes13_PI*t=(KJ283sQii6YlUCeUVs1>
zF%r*2nwr@O0f)F94I~c3G2UrT>2nLtJIJ3$q%%5DWojIoYVrT-+n5xN1Ab?&{{1GT
z(=H^7jwWlxFEtp7u2(;E>3iE!^8QLO3l9DKxG+mibS6g-`?}5m5>s3}K0Sz0*wfla
ztb1VQC`J+9D<m7KMv_HYIXlz(s){~OpQ~eQ#xR<G!q+%V36P@5#FCY6EblEEX7TQ%
ze12JsdWtrf5J`fi1(An5ndH{L-R<e*Wwo|f7qT9KK=~outp6oJ{qKhPE`IN@&wP9H
z%5Lf;@H=JJE<=Lo3%l4Ph!HIb;d=<(RMIuxi{*BQS#CAPf?#7^H8D48JS4?s9*K?i
z{$@Wei>igIL)miI?PVAy!O3bz-6V>op&9f+P_HThKVAm8F6Ciel(tn<VVCrt>s9%z
zUxiLv!?qf2t$q@v<<HZk@1JaKZM~dVbND|?_1fDWrRb`3oL=^SZ=!yGeWHIL;H$<2
z&^QByVkv@+8s&F=c_=FvNuUL&OR^-Bq<2g5uEDgQqe5PLzy7t>fux~)x!M>oibfC^
zhjmUb*VscQFOQYCR@-h;qmU|~n!CayNSrWr9-PE8zN45IPd;}~U8+iNsoXx}Y+|HW
zF(u1xNkm3Unr+V-8ntn>vG`6zmj{5G6?ApUUX?TK?(&v7Dc|1HJFlj;eV1Q2a>~~3
zs2gVK|Iu-@FZJL5!T<K{%(!2+S6ZPxi{~!BE(N>T9tM$8UpLA~2gw#nC<Os57_Btv
z7wGG5n2w%3uQb@nmin0>438)Yvi&a?C$LFJo?2{k?JF9X$SoZ@ICRlc`&d~~pqgGY
zSN1AV7CA3uY(WW=y<Qd&)oky|nabhBCAd?JnK)75McsU9G0Trr0hj4)|3zJ<m8G4m
z)p*i!yi`)>K{n1c&dGB+K0IvTnP*Vam~rHs5$`nLa?xr$-D96o`8h--$LqpKiHF;W
zA@g=E+TN*RYjVn|aG&kU+m4I_jbi+3G=)9@a0&*to3pm<=BWx7aUfXhDkwQfM$t6$
zFYjAlyP&L{Glm|XXo7kNt}KOC?#9@Q-yMCN9XFQ#UN|A<@oV9aC?bi+<W&e}KCH(;
z_VO^MI`w+nW-x)~j8H2AGKWc8#ny9b(Dd8!%^^jjVBHRvk}6^cV?dTIQYX!DeivZB
zf}&K(6DLlHJzi)-$XT&RCfjS!kW<O<=LOS!yvU&djQpzCFJnR5C}d}kNwLqe&Q>YL
zI@`5y$S<Cs8`2>oDC!SR)0@JQ`<l0|hIYk}IC`f1feySpb*44LW3+cBM6yHg43F8K
zkhm!FDr<6imgK3SmlJ&Fe)?0W>sl`ro4qvpE_5Bv4R+JPA?1m!Tr?3z9K$j`6lR20
z7qs?T3jL>s+>|W9qWE$wBG`#2d+TO@TcWE|hsS07pIEgehsBTDX=FLf-qMo2@%QoN
z`LVsNr|$<rEH4qUTpQ+i;cdpxXJ?X`j32N{=RP1pZ}cY`e3v7(BGl9!@hUgZqz0`;
zEjIoYWiTY=N|Ajqt<o2nS-!()g8%jT%HTT(YniO98Kp60^z$cHbh>VX>}e^*9x7b$
zr!ZwBKkaNAs9VLTkz-gxPX(L%tUbTYaZBoT3Qu=<f3UOb&WE7LhOyj-m1fEcO9rXj
z<x1~m$9nv{y8f)qa0PBmjkQc~g?$i<)*+p-Z=hg}$>W~Jz`Pi%D)%HMCH++ngPr$8
zmGQF?Szb*sm3264y(*tMsPHNkw@UY7JhIZrT<R!ja5mYSr{fl&0lkFa0K!3xc%euL
z_ZoAqQ^m5K;F5eyK(T*o$fWF6?O9eheV^b9AIc=7B#FP%ReZDUq2Ul%NDUUcf}OX7
zf~bO(<WGyq56WU!ho^nvuT;1}#VZ-X>+7^Dm}4HY;Si~n9)Bl8jSj!(88Q{p%IvbL
zhM0m`Cmr?%#fHhFOD!C93JR)ukL8fB25At+18eaK=_D^*kYa$hTFd$`qhaC|zdsz)
z4LPqCJ0zMG-`RZS)>g&Y4F(_q<lWVf52v&NKTe_<4@hpO@T<Dq>^d>Zp9G1S7-{K&
zuAOE$Kb!~2)$ISOr8>Qq@9}v@c<EZy`l>y$5>mT=dBJ5I^!-dY=aiZ7s=TAsx=hxi
zBr!_6&bew}7u@%$2YIk&Z{^!UHkp(!Ntxb$+Tbgl1#qjFAzy9Ph61qy7}$BE@p@-^
zZGC>;7I}%V`<J0h^$e(6HuGw^wJ-8tUpA||eqD>>yt<YTR!@hd3!uJyS{@i@>v}!<
zG?OegWhx$Eed%saN$-4$uR()X(<~Kc%S_Abc9{MunA-<34e=4mZ<SDJB*GUSY+-<s
zhI`%oy5Mq4Z82$Dbhg;V?@O$F)8bXuOKu1{9RcBypZ!dow3*4)H;~8JPv=_D7vij)
z-d5yt!rq4Yw6!(2f8;rO6LrF$>EN>sNq?*OyI|h2s=RTVREIRf;i$mwo6Pv+&r~rA
zCpY16QLq-1%7`DkwHQ^Y6f8W>ek%^;%8)mI*mciEOHXg}rsK(hk=v3)4-^6jAyfY>
z`nNgtZ)i+AQm_0kPk4uV?eeJ^Yrz^07*ifO@Sm<}V2#^G<z45iA2S&P9g3X$9I99E
z^77Rv3rdf?QZYVJgdA$HW%vAfCA5+?RrcdzXL0#@_orIYRj{j-9rw{y7C52%s1ajC
zqm<x9#kD(D3GUv~$bM1F_H9hsPiwa#-$&z{PS?Qe&GUyIk()LtP_;s7k1a@&8<Utm
zAulwqPuHHS`u00od!$Ll?8RfpOIm=XmONA&4#bYYN>>NAmzC-C4SqJYJu<2NzQ!SJ
z#sj3Qj-ofWujEwC7We#qefF;4PN_lH>V3xxT64m>>i-nsZc|s=e5zS&%r9tyMnzIp
z#KpOrxAuy26-A2eQ|t~>&kn8+qu5DkK03F|EBnzKDPSb){E=do(KT`j^x0av>|I({
z?C7lu+L-*uex{^-qxm}!)o+%t`glx^d7<REblQt!H_YHWO&e`uB8?3&5gGqe8+w=F
zeJ^sxtM=LBh$SpoPdk5zNKRmfVqsC|6Pf~lMg$u%AR;k1kyfNTPo<m7SokFM1yfSO
zB)hN+iuPA8AMeXWB?jB3fbFPsOjEn(sjhav{OSGrU-|h_oQ7UvzSn0QqqbxVe4{>D
zT8kb2Mf0S=1Kny?sUq1rNjIef+ME!N;_R2TO{=~K<I8PXirdj9GygOYox&Y+?Kf?K
zc6RHovoR=&%;0ZeYU~u@q1NNuE`9x~o}#6+Odn~V7J^iI_Ru`v?z~_es5&wKweyhm
z{r+SQ#mohVn*|Es{-R%cGZ?oU$#12SHY-&(9W&dgJdonMe4x>G;Lw;s%1qRSXV`gl
z`e57T^I8=nVcGivcS54E9}&49CpLRz@<DKCJ1uMX(jDRE<JB_#0}UhxXOG>Fp<+6u
zsG^z^P_LRviOz0A{F5+!3hn^$gkYTRm2vsAzxQ(qxJigTc}LNlN;X0s_8BBhTWnvF
z>l%n}0>7lV1wv>2`Y%UP8j`A6F+%{}=s+uNVxX>L1-?@ia~tcc9}AsnbOTVZ<dB-j
z&o2NDDC`HkbwNQlW4T93nW5J6W5mJNKr_31U9q|^fsg5Frs<k;(kb4qH}PU*)VKaf
zoJ_6y%;PyR=Q0lBV)Rz;65H8YuNjYg)-3dYI8Bx!C3|tu>-fLK-hP3Xl+^fi^2ZoW
zg8L1vY%i-Lmm+>AJoL-GX@7bp(Y*6ByJ5g;tmYkCs4kpSfcfVvpdtSvCH%lWiN>+H
zoZbCpKs6*=GMOx7lv&qJ=_wAe>^aeSKt>Zp#g*-hoKPT{4#fwtEm)=%^p)@Xmm4*=
z&pY2o4tuix{$nEQ&eK+3&);M)$D(Rthd$I?ARj4h>Hk&mUF*9bUr-N3V9pEsZPbB4
zOu>LcLG^k->9_S>*J;NOaKldrQ1eA=G_<%s`5Cinloa#6fB&ANO?V?M;qVH`c0~(U
z(0Kw2B6}`ic@piuYPIbIRWq=&BI|a_R$%SOQnXz>q%||mO3$6o2Efn;S?#lgX@#D|
znA<~M2IDE<*uCtg$Rt^296)q!tOWgyN4&UNiuqmj<_GXf>U4z&qq2H{6ifNI2#Ge;
z9ZtU~|3k`QdeU~HA<g8!fVG2v9SCiWSuLqTkZGpc0>w@4GvefmSzA@FcvqS8e_pKD
zurk62Mqvo0&+Y%i-1>^VHcDvb{-}34G12YPo3fE?Z@y|(oCy0a#h+vyfK_L}s>om~
z$vBsZuDiL1`5hA<-^H11Oqb3_Wj_L=lXjM9P#!A^103zh2msZJk4QoQ*jgb-wNWo#
z$&d2Z#aOie#O2m#ARrn%Yezrvu+q@^E(g&W;O}VmwDsH1S+u+iw?fzCoY;1#q!vGK
zg>sN2B05f6xjJj$w6DJ<{r!$fMutj&-g|V8vRAYYU=AR}y9}0I_u?YH&D&hZ1+Ne-
z?0rZ4C;AV4%Q-~3EGevHFW2pMhPolpR)4!{sLa6aidjc!to>1U<1#}VLDO`jj;?wK
zpsG$@=1ZR|U{yayZ1pJHcdux;!tdDsyI9-xtN2n+OL|Nco47D-DnL<wismo4l#Mzn
z7!pnl{(@JBQe<6>(h?va6~tdD^H9^`pqg)UIB?}uHjJ3gKiarI>D=gVm|nST$LFwe
zk8v8%?nxy;>NR}JB>7!daXTZGOdAZWG)p<J4J5&q<Odg8K!zn<1Vr3-zY*o$eymC+
zpx8vNhsY0sdzuOTRHNh>ZE7b`gv4*6*XPKoQM!e5eJR4)9*3tt^eB(`+b%SB7zTb;
z$sOQkmfMpP6Z<C&SBz&p91f}yxXiol?w*CoC8#JJSEu-H%V>$wRRh5^v|wu~xXuw-
zO^Aj*+3PeS>EM4CNb*y94e1EEeA&t$&q{%^&|364Q2tQ%I9J>`_Lg5JRa%_r{KIfY
z9(CM_rxYv~p5CL?W1rFuP&Bi}e`^Xm#kjlZb}!~?|9JP*)Opp<qVi8sygkFvMl34#
zwP0G&XsT$L-Tpr<$Uri=(Fkh_BXg)ps?Pp*W0tt1MNGuuO(Rbif19uf(L5`sG%-4u
z7M)P?3U1FC1%@J(r*i($9GB_3IU+STYm>|OFOKFqs@`!^bz_B+aYMTG*l>x7;X;g>
zS~4V4fh8q?yy39V4POh!V>T7~hN9t(I<qJp%K64;<-Z652`}G$DUoKI(^ru>McuL~
z0D0_w_QE*4d(jP6dXNSI1zt%gtr_5y9_w@|ozKPR;9nK}Q{Y3_KS^)RoW0ykxHEfv
zS*KF99g0yf6;jhGMPFd=7%l_!*rb+4bRARE2#B73U-kV;GXuHW!DEG`=c-wQL)FIf
zrSVDMDz0DuDq`8@>i9dh5tm<+e^#;Rb+p`I`~36Y!_+_ntK-SzXjm{>zbDQJWMV5Q
z4Gx8F(?&~jLP|+{)QPRdr!XQbDt;8*rm2cPojzQKZmt9;6v9{w^7>#fGsmx`Sj3@a
zeWeS~DkWBNK!G_WF<c8;E@15Wc73k%JLa+Xa$$nF>uR<fX8Y(xC=ZBO){3McuiTLV
z6tU)>hQO6*`su%M)9K(n`=rA?@SmJ&)~QKI9+!5M{jDUhhr8BO^1sQxfw#8lGUrIz
zMpFN#x3l{C|8;ur_sa!4X)SjkPHHHfsaAcBExlt<n<mI+tWawP4vIdtZ=~AOv~=hK
zLyRcu7(fT@^j&vMm68ADr0tFkY1i$KPe0xB^dRaXV(<c#JTin9g$u}2WCT!m6A|K2
z*3+ZR0AGe!?T@2XiaGnzcM;EpG^R$vh(MbU6Kc|c?gioK*6i}xy^lSZTAbX>N*L=L
zoNqX*UIiUI&UQUjWZ>y1q<wpn<9nqI)It9OlaDTi1%vHE3oy(rLGEfYMERxG0*aE^
z_VUe#rPsk!@3NCsRdNHbYif?}2~2_(lMY-Q@e(#yUINf5!B8wD9abKsRNV~^R+_3r
z(fwM7vQSgA?)j?gsb@HuEEvCE5EKtb(+CdKtSkjX&>8V%Lqge*a>UVUSUeyzDKI*S
z_A9MQSUJZSv%)4L-tqGN#`8HD^+U3ReUpwX#(-~6I;$nxSo6ZMdqe7VbciBvxL0NJ
ziKy48$m&h<^x5(&%#_mGUu5DU9v>7T>1yh4bjyf<^tI}+RaISXbJ)=*(Q+IJtREmu
z1K_SvkL|f#>5WKEdt)Mcv+vQg`Z&<>DV}gJ0s+>WvBYK#C1lnA$Qtq2h@UkHcNY|R
zX-OjyWIh1bj<=M=qeu3EzG^i_V94s)(*hVRv|?$^@Dc&c1%j+GkYKuMazIDze!ph%
zM3$&^VKfnisP{vK#C1?T6R9R8RW@qI0quKO3qqkI#PL=7$lp}$KX#*)H1}lBjg0|a
zaBU)%vLD-)EGi#;U)6s_;$b9>gv80`F`D=*%#DVqSZB+s;T6&Bi#XY;<3%?U`;)4Z
zm+uC1zR3=}{vC8-8+7-n%WrRKv_?h^sGbsNnU2y(5tUZa@wfug3XA#e_iiLe#0k2i
ztkU%b3Z_s(NHAVNnnC1h0VL7AAWJ`3OFx)cTRpu0!=DB<Euxq2ug6L}2m+1{vS%`)
zC(SV8mp<+gJk8D9h-hXn)dY-Q4^JK$B90ae%kY$xRAi+KeLOD*pO32g+v0<j!L(6(
zo9x9V-nUj7CFHWq81!mVjCp|@Of`g2bo?le08iCmV!cFkb?9gm3J3$BD?q1;u|FQn
zn6G5D{oS9X{+qS=I?Sv~q8yCB`z>ttCC5}LgF5}$-87fjZVdfR4tr9XnO5j#4igF!
zn>ZY<9zv`DO(7m4@{v+=nR+>v=&Sf@i@N`Xg|68#ER-kxlN^mtc}qRvIV~~voR~}d
z&NgDXYt9j9>6zE)xpSSAUo)IEJX~SO>~-?glY1YrFfI*{O-%15c{*72-d!(xNi?XW
z2!}Oh;mE?_QeTtMzxP70L`!T*`hICAgRm26(fg#PV=$~FlYOx}6YKQ_sEf#w4FBu!
z-k&DJzxoslOr&Sa^O<N{ao>L^NmogLcI@xlJ3Rf;GV#`|BHe$PqK!>wH&2`JcsCu$
zvBEW=t1S~H|1vAs8y`TQCk`o8=f(+#_5G7ET>MDcp2-eHnhaTdJghkRT;3$=>AUk3
zhKVWnwzxgnSTDW8X;I8|*&Mb(tOtaWlBLo-?9T?jWrZt=v(lnDZtg(U)zw46oUrsn
zY<yO`=fhcdvww|-Ng#Phi2DM%d$`X`loH-r)=B&MI-gv^^4`}?#z(I0ZyT7a*WVVO
z?oPxpsnAD@C$dc)n&{$zeIVLkB4(*DYhB^Xwlj#<N6QubiiE4FbHPx~DsB)P^h=#f
zuo~A7rR+A>KXYdr`8#hdm<GHzhZciQ*Y|XPJ2!27Um7{Q<x6|o8GN>AS$^8FO%2+&
z4SW|}j)UrslA{T@PPb)KC|@@|?Ng!{GNR_gjAre#Ml1W*OW_TOP~L)Dr>mzc%CPQz
zA|<5y+#@fe?z`su;}&;WhbURy4DK2p-G@=%ypg)0Dsgo=kIP4;o$25pwgXfM8?06D
za7_AK3u}<r#uM6$D}q`8=xC+b3bi_Gd!)6&4UmAl7TeXk>!w)?Tq*hgcAmZmT}~zh
zUKaM;Pj8W!HbZc%7}uXKgPzY7+iqf>?@Z}Da>!`z=LV5OExi;LHZblqKL+wIGp`xx
zzaUDotmH}`DQ@Dl(9086!1$7IAl5uuov%hsZ1(oAsauavE-N!iZFX>Utn}#eHi!F}
zla^=WD}!l@7b`L0pAS;b_Ix#;TN9h#M5F|+pI@DGIxAuVu4DWJElW$e+AlSVXB(oJ
z=%J6@RnOa1j|){fZ#{h7K1{Y099l8MPjGgYK1p2WuipRs6!j-_)&FlvaZc@wf#qGD
z_s0Ocg>OlC2Q87KWNyh$?Y13`luzN>^~6nB`HK!!96v(0BPC_h8L(k^IqJ?Gw~-xf
z2n^HkM56t>tO|Up%EWO&)8z+5X4k4WgKlsUY^>@Z(sA=$@WI{>+DZ%B5(+vH!rfs@
zQLLK9h4{M)M#Dmog{=G6zFk*_U5`S!f2Rf|o@TREn#y6gbb!Rp#*3GN8p4@%!Yh7I
z?1OJxtiL>aT+sTjBJ|%00)I^8`qi}XI>@UBBcbVfV&S3(UN2}wVR=2D;-qflhC@pq
zFE?z0O*Fr^ei$_NnH602LH8t_d6$hz{SYnn_saCX`{e03h<$6hd?@PYTQdI5%2WDM
z3MsQ~mE!yNU6=1o?-ynPw9)j&G`Imw8bwb&Tir8P+10m^zYz}{<|QbQ(TbG)%Qq&%
zEw$X%3I#)vQn67{{3tGRYk&W6C^^qx+F$_d<A*P$2Q_~OEascvQqJx9-u@Zr|A8C0
z5zX`Mw4Z@R<zd|A`R3nU&<LMI7eJs=|EeG3v~LEh=?OJk$_y%Ws%H5H?A{`gBmJH}
znPsWU3TeMlTOxRLsL0L{7ADS)2OXi)UxCwBug$+KXN>PS*qQ{W_!BU4^RQ8d!PruT
z8y)}a5rJcA%)}Exi9Uyd`{T~~GJy;2_my*%2TUTAT!umTQA06YU6*4X6TUm|Z+Zvh
zPw}iQ83-dIBl{v)6@GCXeDoEJ2IOV^Fd&XcVyoSwOI07s+_#-Z`+X0`A=GLxDzQFK
zpPfyNzARgD>rj2628jYfnHt^iraWBQPuhelK{c2H@R9KSaIB8Mv^e!9sv3>nWq^G|
z!A17sY0yp=q{hGMz_kWJr(9S2Dx~6SWiaV+KKC(Q<fPrh-5odh^FNQyOwYbgc|I@O
z8P7hTq1KDXFS-iv9iRXL3O;+#^?v)#f?VHvHKUrB`dtz}!dL#Fh6K~Lj`xpn>HAqb
zf4KgYy1W4dVk_VBNI`&{?U-!$Kgh9Q>N473NMhCL0i}a2AAjZ(j*#h6du=EV@HQ_p
z&OEyO$1iHsO3?G8#3|Zp(CJS}HYPUUNw2-fk+RF(On=Gi9pia0vf0GHz0<T_g6>0M
z(x!VxXKv2iWmbHxyUhlq%O9LlRLE%k7YPK4S;}9`%=1+_t_H+}1+!vkk*Gm_mt#o|
z!9&!b@cLDu2qw*>lZVZqs)`fbIlSWmrT^7(9{x~23>^PDj<X7Bh&X3thWHsN-CZZ+
zC|5^EHfKi}kt5EibJ=@jWaQ3@ID2=vkUbJfvMGB!`Qh<;{)gwk_^kJ5@uOQWAq9nj
z+{32&1=#OQ6aGxl?5-;5@c_`)nb0ED48!$+plcd?ucMjaLCsRh1x}QLYd~x7ya$))
z!3+wN5bl#gUTr$1AY6V`zi~1(i_W<K2!ss?CQeW}I}^9dK}k$pyrm^2<RU53UefPl
zcE1;N#(9!kqkQd<?33y!uN<pxW*G#3Vg$cRbZ+d$Fu(O%`%?kKhNEVNfvxdB{G~a3
zS4OBhBDW9*^Y$3YPgR>}g>3iUUboa9k6IL+AQEsuh*{IR@|`6q_YpTobBjdJtf(}X
zz89X#P=>MaJnXAsotsa357SShKeCm}OO(}rs(R8L&$gezZ#n#!#@-fnr_fv=7@|uT
z3JGQbH||f@G@cx-H@Np_MHS$L&0R}rF(;#4DJjV%N+1;8&hK_P9{_zHRRe(t4*x*B
zn==NCOz7qdFEak^>=clZDKgXAWC7q9BAl4k<P_(4x)QGTN#&8Q1;L4w(Pf!*PuTtC
z%TF!t$$!2AP+0AB>F1mw2&6SKDHy=##o(Eb0)L21n?G3LcCky%XQWB##pi77`8IA}
z4O%HIYx((CUC;VfO-O6$L_uNmi`k0TEgkj%92$$CyY73f$g)k8>;#16z$hTZ2w`)k
zsUE})BTKMIyDs;fQRidDb5Y2_Pzs_$3<fCUkStu}mCt~&5x3q_iM%!)lB^3Nf^3T?
zWt9)`_R$ZXtAfEQV}KO0{MFV?LtELl;`-w%xkcS@Ci;IG8UHx(YvU)1l~~J2@>nFP
zgk5w_+a`Ce{^(HWYUixDBpQnBg(<2vZG5e{7qIs*J1wg|4DwN_mzf`#78du>O3jZ5
zjNwq$Adu)fm7(FAem>5cPi3z=mkD{TEZ9i$iTD9D3(n1?1SG&hJT+?2rr`{#cGc{b
zyQ{?YSBk3iHBR0Tnh6>kA%N8eQQQ4{<@zey@1Oh%YJ75dMg-X~sugq`kp8}uMsqK0
z7<1ED-@3^LUktS5&wQ>%wlhk)PXAE_4$<Y;c24%P*ZX~{S&x$m(_epkyC$(j5dqHO
zN~`1U(5u24o1<5S6;j#LqA-gCvXCS&qq~S>w!GVT7tzGWo+EjNmHF{G>S+_k+sOwC
z-jPw~ycKEN*I^G%kZ5fMA*Ul8F&mWNZ`tNXFA*@%Zd=Wy{At}JN#bzA)LM?oW*dpY
z3RWPiasK?KCYJ?;UiAC65XRe%T(^5f4jDQtyY;lejRB)lGqzxp!lsY)Ln~E_3yZf;
zIux4xw?_2~X4SrASe(60d770fCdjsK^>VW#B`e5ga%t&+p?Ki-(*5VV*Ug(#%J*BI
zo-P@`Rbse8;t8xKgPzKqWEfe7$ZfW81jm%LiTE7}x_;<W8-VbYGkr+T?W9*f9PRVC
z{claMQy4|=mhoA>5b7zaDZE;dnVkQCmmdV&NU0e!5uby(1sK^@);BIR@x)zhYhL22
zFY~qk?mhW+iGF}`Ed6eY%dAtsk_G`MNU;)OUrM81xrFYT$@g!E9-fWlivIVr&hgsp
zNMeLr3ty9XeOMTO<0V07z%@_qiwI$-Lest3+2^@1A}e60V!QBO6nBhet)CvTJMHN^
zNL&Tp63GLK&tWx|7~!!E4exJU;N8l69c{ljDF!YI!MU=_nXJ(C8cIo`p>kz6C`d~d
zHaQnMM&c2LlIx-|NQzB7O}j#jw90iROOr~*!_}2Qy^`q}8NLXhr+NB;)^-u7m4ion
zkil4*nJK4j7I0oHjo{KDsoc0e?WDrfde}+|Y47c8c<f$Rkb)2T&!Zp>pXK<7ydE8K
zTMe?lai|}cE=i$zqrH7<YHo?q+wo@jVxfD({Fs8)!KkH|yecnQ5n7=QwgKJ;^PyM}
z#vpufo8Ls8&!Oh@(Vy~>bW<m_uFe~G^3pZd>hEGLeixi;c)hqgbiZl8sal}pA^P)>
zK@79VRDHFC20<^|Z|(g01Eo1CR@jJyWnyP%T;2j@x))Dc2)Y?uLLpV(^vL!R5SB52
z#|YH(034g(vfGhjb;?gmc6Md^|BY~Ped6Tg^zxZa!9-*Ut@9g07ZNV})>n7om0j1p
zA1}LhdbvnaylyO$E4(;Vy!f;5H<701<^jibi@qL{&$s42%Nh1(Ywpi5TiJ-H%oXMH
z8`w9o!1BalOb8f;A3QFAY_jq03iR;ni8&q)s`$H>)*twH`!n&~w|C64UYt{F9eH^l
z$LN~T20_2VMf^Tx<f6luWK(_W<70k*Px<lu`=jQjjjf1>h6?<qE3S#F7`Bi-oiE6m
z$rbN(F>zLgAF*S8UanudOjFv&<>#&qFNp#yDi{VHqpe=f6kBojadV%IiHiQl7?ar@
zy1eU8i^tiO;F;iD^Ob7)aR9o2R$_>-hoO46Lx4;#)3Ly<&sSrFZf+c$iy<hW(Xz_Q
zmF9YlBr+89t_X!}J8TE&<itaq{oCDxgMm%?$G&A%7jN$mwAa0`_%pKSrX&^Zb*ZD;
zdH%g}Lv@&?L-Wy8^7+d+^O-*VHH*DoWoh4GbQ#2yRI=AqteDsV#XnD?jDXCu_Whs0
z{y~V!22_svAU>3|$bIS?nq2NS^K!;Z=)&Q)cBxS`UO@-dPC7<tl9G-})}R_E<i}%O
z9s4swhfX3&Jm7!2p39ty%dj@o-o#>7u}K1LG)YdrFRMk$;7p@Y%b*A(76CoYQmVp>
z+1;rlR=(D&gdd(qtuyqgyo;6xGalZupEReveLcJ4Jhb+)rI?1JXicks$0C-!9Njg&
zL$6Ga`Tvb;b5=_&ob`m_n$#Cx7jL7>z;!%)aV)qLZVV3s3!p-27`5N^H|_3<ab#Nh
z;%TO5YH=RTJXj_uc<nX^IhZ8C4eZFOW_tBGo0fuFgD*9bzN&j(i&d)qGd_N33#TdQ
z*qU0f28ue<zWX20BaR6B*GkG%G_Q~hSeYm%OM>F!NHmME%6`5gj{4+^;AFj5NrfX?
z(C`EC_rR)kyt8BPLA5=P6P322HxPS)dVjke(UoqpaB6d;Rzm2p`EvpJZET@*x}cYK
zci|DQtp;!N5`J34NC}Zc8(ZG<?@Ya(g4QJ=zd4$b$YJoX`ptn-BR)l>Lp44RBok|6
z_w~hnR@o$d1;g=qSlGu~DwM>Nco1AFjawOpxr**LuN~;gyo8l0^pKK@l>y_i2zEXI
z%jGj_fwO!Y<oUB_vEO^>?Rdx&be7Ms!iR&dX02gUPN{4~r8|tu*`EHJ;8L2|82dCe
z4mor=)&X%X%W6Rvm8TDmZ50cqkU(N$P!5O~nUm!${?<BYsKFPLp84oh<|0r8q-}oV
zkra<2>4w$Luf?bedAyYIg+3yg?1%qE{<ggPRT0*m6sQQyUl5nd79AIfWDWbeR;?Wo
zDUUSLMv}s8ZIPkyIzP5l<)V<`T+_La9Ay)gt#PzI(Cfs8zWF(B{n)Zs){46Vh0gp~
zmna%cUN?2s^<E^?df+>k!8fu%X&WVy=6$3mjZer;X%&)}m#dXiroVNdo;yo|!6T0x
zc8+tQ7H3Vy+0u6tWLAm4I=T3Od??H^t+e7*M0>q(uAs{~5FF<ruPqKmai=%5-^Iic
zLY)l4xb8v`kt3v(DGfG+E$U7<1?Ws>`o+VLp{dkzsCp84gdnVC&*bXV&)f9ipcxJ;
zbQEMw2+S*)kGnHgZ9wFS#a6A2gL95|lm>&Df_a}kdp4-KpD8grz82&<p0!8#zdvC8
d??>xc#8*WqJ4=4h?DPZ-(9^z$DnnX_{1?F%SKt5u

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 3a9572ab2..48de4bc95 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 523e2ad74..6cb1e2639 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")
+        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.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``                            |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|                | :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 051fdcfc9..fcaa3c8f6 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")
+        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.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``                            |
-+----------------+-------------------------------------------+--------------------------------------------+------------------------------------------+----------------------------------------+----------------------------------------+
++----------------+--------------------------------------------+---------------------------------------------+-------------------------------------------+-----------------------------------------+-----------------------------------------+
+|                | :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 fe29f2e4f..6e0647343 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 350/688] 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 d47344245..f3b714215 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 351/688] 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 dbe193808..9b3bdf330 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -284,7 +284,7 @@ class TestCoreResampleAlphaCorrect:
             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 352/688] 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 0d45d5a20..0cf5c58ab 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 6f867ab37..c47fb35f1 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 0d6da7754..7ff645fc9 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -117,7 +117,7 @@ V = {
     "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 353/688] dist directory is no longer created

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index 5547b2e3c..477d92609 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 354/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index e39031aea..196f8ed20 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 355/688] 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 f6adae3e6..7cbc1a266 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -3,10 +3,12 @@ from __future__ import annotations
 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)
+@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)
 
-    for libtiff in methods:
-        TiffImagePlugin.WRITE_LIBTIFF = libtiff
+    TiffImagePlugin.WRITE_LIBTIFF = libtiff
+    im.save(out, dpi=(res, res), compression="raw")
+    TiffImagePlugin.WRITE_LIBTIFF = False
 
-        im = hopper()
-        out = str(tmp_path / "temp.tiff")
-        res = IFDRational(301, 1)
-        im.save(out, dpi=(res, res), compression="raw")
-
-        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 356/688] 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 f40286fe4..4b8041f9d 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 bc60eeed4..5b52105d2 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 357/688] 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 4b8041f9d..70426d7b5 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 5b52105d2..af205a4e8 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 358/688] 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 c1399e89b..213d99427 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 941ec40d9..ed80be503 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -66,7 +66,11 @@ image_mode_names = [name for name, _ in image_modes]
 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 @@ class TestImageBytes:
         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 @@ class TestImageBytes:
         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 8c42da57a..8bb90710a 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -229,7 +229,11 @@ class TestImageGetPixel(AccessTest):
         ),
     )
     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 73145faac..dad26ef14 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 6a0e704b8..f80c5b78c 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -359,11 +359,14 @@ class TestLibUnpack:
         )
 
     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 c3d1ba4f0..da4e9e597 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 e0975a121..5094dbf3f 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 3ae901060..26be42779 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -55,6 +55,7 @@ from . import (
     _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 @@ class Image:
         :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 5e05c5f43..7bd2afcf2 100644
--- a/src/PIL/ImageMode.py
+++ b/src/PIL/ImageMode.py
@@ -18,6 +18,8 @@ import sys
 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 359/688] 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 823ea76d0..b4c6d2987 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 ac401dde7..7d8e1c1ee 100644
--- a/setup.py
+++ b/setup.py
@@ -1018,7 +1018,7 @@ The headers or library files could not be found for {str(err)},
 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 360/688] 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 0d45d5a20..2d5e174ce 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 361/688] 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 2d5e174ce..e140665fe 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 362/688] 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 b64133cbc..c65cf3850 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 363/688] 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 07ea76e6f..2cb841eef 100644
--- a/src/PIL/ImageStat.py
+++ b/src/PIL/ImageStat.py
@@ -51,10 +51,7 @@ class Stat:
         :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 364/688] 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 2cb841eef..8bc504526 100644
--- a/src/PIL/ImageStat.py
+++ b/src/PIL/ImageStat.py
@@ -52,9 +52,9 @@ class Stat:
         """
         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 365/688] 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 483535f96..8b879d1e4 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -22,7 +22,7 @@ import PIL
 # -- 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 @@ nitpicky = True
 # 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 3ce082fb9..328088e05 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 366/688] 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 4e505f2ee..f60b1e11e 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -199,7 +199,7 @@ class UnixViewer(Viewer):
 
     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 367/688] 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 3b4deb9bf..6495e5866 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 8b879d1e4..392cf317e 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -34,7 +34,6 @@ extensions = [
     "sphinx.ext.viewcode",
     "sphinx_copybutton",
     "sphinx_inline_tabs",
-    "sphinx_removed_in",
     "sphinxext.opengraph",
 ]
 
diff --git a/pyproject.toml b/pyproject.toml
index 328088e05..20e87ad32 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 368/688] 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 57a8fa5a0..dfa548548 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 369/688] 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 6c32b5ad4..4db0bfed5 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -185,7 +185,9 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
             # 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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
         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 @@ class TestFileLibTiff(LibTiffTestCase):
         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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
                 # 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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
                     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 @@ class TestFileLibTiff(LibTiffTestCase):
         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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
         # 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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 @@ class TestFileLibTiff(LibTiffTestCase):
 
             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 @@ class TestFileLibTiff(LibTiffTestCase):
         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 7f3a3d141..18070377f 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 7cbc1a266..ae80b98b8 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 370/688] 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 4db0bfed5..71f1b6f1d 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -735,24 +735,31 @@ class TestFileLibTiff(LibTiffTestCase):
             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)
+    @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)
 
-            with Image.open("Tests/images/hopper.iccprofile.tif") as img:
-                icc_profile = img.info["icc_profile"]
+        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"]
-
-        libtiffs = [False]
-        if Image.core.libtiff_support_custom_tags:
-            libtiffs.append(True)
-
-        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 371/688] 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 18070377f..9b37435eb 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 372/688] 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 941ec40d9..779785c53 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,7 +8,7 @@ import sys
 import tempfile
 import warnings
 from pathlib import Path
-from typing import IO
+from typing import IO, NamedTuple
 
 import pytest
 
@@ -33,34 +33,39 @@ from .helper import (
     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 @@ class TestImageBytes:
         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 373/688] 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 c1399e89b..32ea99fdd 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -13,7 +13,7 @@ import sysconfig
 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 @@ elif "GITHUB_ACTIONS" in os.environ:
     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 779785c53..5654307f1 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,7 +8,7 @@ import sys
 import tempfile
 import warnings
 from pathlib import Path
-from typing import IO, NamedTuple
+from typing import IO
 
 import pytest
 
@@ -23,51 +23,20 @@ from PIL import (
 )
 
 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 374/688] 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 8c42da57a..96afc87a4 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -10,7 +10,7 @@ import pytest
 
 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 @@ class TestImageGetPixel(AccessTest):
         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 @@ class TestImageGetPixel(AccessTest):
             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 @@ class TestImageGetPixel(AccessTest):
             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 375/688] 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 091c84e18..04618df09 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 376/688] 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 6a0e704b8..f34ff7d02 100644
--- a/Tests/test_lib_pack.py
+++ b/Tests/test_lib_pack.py
@@ -216,7 +216,10 @@ class TestLibPack:
             )
 
     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 377/688] 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 32ea99fdd..f0bb8af00 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -13,7 +13,7 @@ import sysconfig
 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 @@ elif "GITHUB_ACTIONS" in os.environ:
     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 5654307f1..8b20de0a9 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -23,14 +23,12 @@ from PIL import (
 )
 
 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 @@ class TestImageBytes:
         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 378/688] 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 8b20de0a9..090b80f87 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1036,17 +1036,7 @@ class TestImageBytes:
 
     @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 379/688] 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 f0bb8af00..5d206f644 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -29,7 +29,7 @@ elif "GITHUB_ACTIONS" in os.environ:
     uploader = "github_actions"
 
 
-image_mode_names = (
+modes = (
     "1",
     "L",
     "LA",
diff --git a/Tests/test_image.py b/Tests/test_image.py
index 090b80f87..9985f2346 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -28,15 +28,15 @@ from .helper import (
     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 @@ class TestImage:
 
 
 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 @@ class TestImageBytes:
         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 @@ class TestImageBytes:
         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 96afc87a4..50afb2a23 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -10,7 +10,7 @@ import pytest
 
 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 @@ class TestImageGetPixel(AccessTest):
         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 380/688] 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 9985f2346..4a056df40 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -28,6 +28,7 @@ from .helper import (
     assert_image_similar_tofile,
     assert_not_all_same,
     hopper,
+    is_big_endian,
     is_win32,
     mark_if_feature_version,
     modes,
@@ -1036,6 +1037,8 @@ class TestImageBytes:
 
     @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 381/688] 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 4613e40b6..6463572f5 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -78,7 +78,7 @@ OPEN = {
     "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 10ac9ea3a..e37140590 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -200,12 +200,12 @@ OPEN_INFO = {
     (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 @@ OPEN_INFO = {
     (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 a84dc0a6f..f15769c43 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 382/688] 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 10ac9ea3a..106f09c2d 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -244,6 +244,7 @@ OPEN_INFO = {
     (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 a84dc0a6f..e351aa2f1 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 383/688] 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 4af1b79e2..5f5c5df54 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 384/688] 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 c65cf3850..8efaf8b78 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 385/688] 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 c1399e89b..680825d4b 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 386/688] 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 000000000..468aef8a9
--- /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 1565612f8..ad4d3e937 100644
--- a/src/PIL/MpegImagePlugin.py
+++ b/src/PIL/MpegImagePlugin.py
@@ -53,6 +53,10 @@ class BitStream:
         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 @@ class MpegImageFile(ImageFile.ImageFile):
 # --------------------------------------------------------------------
 # 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 387/688] 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 c3d1ba4f0..91bc150b3 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 10ac9ea3a..13bcf5d86 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -56,6 +56,7 @@ 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 .TiffTags import TYPES
 
 logger = logging.getLogger(__name__)
@@ -276,6 +277,9 @@ PREFIXES = [
     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 388/688] 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 71f1b6f1d..e1867cffb 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -741,7 +741,7 @@ class TestFileLibTiff(LibTiffTestCase):
             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 389/688] Parametrized test

---
 Tests/test_file_libtiff.py | 93 ++++++++++++++++++++------------------
 1 file changed, 50 insertions(+), 43 deletions(-)

diff --git a/Tests/test_file_libtiff.py b/Tests/test_file_libtiff.py
index e1867cffb..11883ad24 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -242,7 +242,24 @@ class TestFileLibTiff(LibTiffTestCase):
 
             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 TestFileLibTiff(LibTiffTestCase):
             )
         }
 
-        libtiffs = [False]
-        if Image.core.libtiff_support_custom_tags:
-            libtiffs.append(True)
+        def check_tags(
+            tiffinfo: TiffImagePlugin.ImageFileDirectory_v2 | dict[int, str]
+        ) -> None:
+            im = hopper()
 
-        for libtiff in libtiffs:
-            TiffImagePlugin.WRITE_LIBTIFF = libtiff
+            out = str(tmp_path / "temp.tif")
+            im.save(out, tiffinfo=tiffinfo)
 
-            def check_tags(
-                tiffinfo: TiffImagePlugin.ImageFileDirectory_v2 | dict[int, str]
-            ) -> None:
-                im = hopper()
+            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
 
-                out = str(tmp_path / "temp.tif")
-                im.save(out, tiffinfo=tiffinfo)
+                    assert reloaded_value == value
 
-                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
+        # 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)
 
-                        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
+        # 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 390/688] 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 91bc150b3..7882ec5ee 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 391/688] 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 13bcf5d86..82ac47647 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -278,7 +278,7 @@ PREFIXES = [
 ]
 
 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 392/688] 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 000000000..0c2926732
--- /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 089d44b90..6ee5fb6c8 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 393/688] 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 392cf317e..f12b30e65 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -28,6 +28,7 @@ needs_sphinx = "7.3"
 # 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 000000000..d9e583547
--- /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 394/688] Fetch tags on Read the Docs

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

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 0c8f935d5..b83ba05b1 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 395/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 196f8ed20..85dc0b43c 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 396/688] 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 520e50793..9b521f552 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 397/688] remove unused variable

---
 src/display.c | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/display.c b/src/display.c
index ef2ff3754..6b66ddafb 100644
--- a/src/display.c
+++ b/src/display.c
@@ -427,7 +427,6 @@ error:
 
 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 398/688] 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 182eb62a7..ec7f4d93e 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 399/688] 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 7e60a960c..64840d08c 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 400/688] 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 643273e58..4573fde90 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 401/688] 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 36bb54050..b2fbd3140 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 402/688] 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 d9e583547..04855956b 100644
--- a/docs/dater.py
+++ b/docs/dater.py
@@ -7,7 +7,6 @@ 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
@@ -22,11 +21,10 @@ 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()
+        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 403/688] 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 3a528a7c8..2d402ca91 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -37,6 +37,8 @@ def test_version() -> 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 30fb14c44..19462dcb5 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -85,7 +85,9 @@ class TestFilePng:
 
     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 404/688] 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 70426d7b5..8f4a4d090 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 af205a4e8..c08a53a43 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 405/688] 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 0c2926732..3150bf4e0 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 406/688] 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 6b0535fc1..a0dcb92d2 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 407/688] 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 4a056df40..8e7e40c05 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1037,8 +1037,8 @@ class TestImageBytes:
 
     @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 408/688] 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 04855956b..f9fb0c1da 100644
--- a/docs/dater.py
+++ b/docs/dater.py
@@ -6,7 +6,6 @@ Based on https://github.com/jaraco/rst.linker, with thanks to Jason R. Coombs.
 
 from __future__ import annotations
 
-import datetime as dt
 import re
 import subprocess
 from typing import TYPE_CHECKING
@@ -18,24 +17,23 @@ 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:
+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 409/688] Combined conditions

---
 src/_imagingcms.c | 41 ++++++++++++++++++++++-------------------
 1 file changed, 22 insertions(+), 19 deletions(-)

diff --git a/src/_imagingcms.c b/src/_imagingcms.c
index f18d55a57..63d78f84d 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) {
+    }
+    if (
+        strcmp(PILmode, "YCCA") == 0 ||
+        strcmp(PILmode, "YCC") == 0
+    ) {
         return TYPE_YCbCr_8;
-    } else if (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 410/688] 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 51625eb4c..f81f03da1 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 411/688] [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    | 318 ++++++++++++++++++----------------
 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, 608 insertions(+), 493 deletions(-)

diff --git a/src/Tk/tkImaging.c b/src/Tk/tkImaging.c
index bd3cafe95..ef1c00a94 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 9b521f552..c565c21bb 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 63d78f84d..ba8c81005 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 6e24fcf95..e83ddfec1 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 @@ bad_anchor:
 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 c7dd51015..442b5d04f 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 091c84e18..97d21034a 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 5e4296eeb..72f478d8d 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 adf425d0d..4ea9c7717 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 64840d08c..fcb5f7ad9 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 0ccf22d58..133696dd8 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 4dcd368ca..85de77fcb 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 d6e4ea0ff..debe7ddd8 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 0c5915792..cf3bc9979 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 86c687ca0..bd2a2778c 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 5d7e2bdaa..8edfbc2ed 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 e37301df7..831ce432c 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;
+        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_IN1;
-            return GLZW_NO_INPUT_AVAIL;
-        }
-        st->head = *in_ptr++;
-        (*in_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_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;
             }
-            st->entry_state = LZW_TRY_IN2;
-            return GLZW_NO_INPUT_AVAIL;
-        }
-        st->tail = *in_ptr++;
-        (*in_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;
+            /* 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;
+                    }
                 }
             }
-        }
-        /* 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->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;
+            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;
+                    }
+                    *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;
+            }
+
+        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)--;
+            }
+            st->entry_state = LZW_FINISHED;
+            return GLZW_OK;
+
+        case LZW_FINISHED:
+            return GLZW_OK;
+
         default:
             return GLZW_INTERNAL_ERROR;
-        }
-
-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)--;
-        }
-        st->entry_state = LZW_FINISHED;
-        return GLZW_OK;
-
-    case LZW_FINISHED:
-        return GLZW_OK;
-
-    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 afcd2229b..1f2c03e93 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 0c0c1eda9..714458ad0 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 78a09bb83..dd066c10b 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 3295373fd..7f1aeaddb 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 00f3d5f74..bcbe65aa4 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 6684b11ef..a018225b2 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 8883578cb..dd06f3940 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 2582830c4..cdc614536 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 5e79bce35..1331a30ad 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 60928d2bc..61566f0c5 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 cf79d8a4e..59c27b3f4 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 4eef44ba5..89dedb525 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 b1b03c515..b27195a35 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 e3b81590e..858de9332 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 @@ decodergba_err:
 }
 
 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 02454ba03..212b7dee6 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 e351aa2f1..1b84cd68f 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 cc0698c4d..6bc90abed 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 412/688] 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 ed80be503..e8339424d 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -63,14 +63,19 @@ image_modes = (
 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 @@ class TestImageBytes:
         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 413/688] 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 50afb2a23..2cd2e0c34 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -33,7 +33,7 @@ except ImportError:
 
 
 class AccessTest:
-    # initial value
+    # Initial value
     _init_cffi_access = Image.USE_CFFI_ACCESS
     _need_cffi_access = False
 
@@ -151,7 +151,7 @@ class TestImageGetPixel(AccessTest):
             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 @@ class TestImageGetPixel(AccessTest):
             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 @@ class TestImageGetPixel(AccessTest):
             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 @@ class TestImageGetPixel(AccessTest):
             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 @@ class TestImageGetPixel(AccessTest):
             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 @@ class TestImageGetPixel(AccessTest):
     @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 @@ class TestCffi(AccessTest):
                 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 @@ class TestCffi(AccessTest):
         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 @@ class TestCffi(AccessTest):
             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 @@ int main(int argc, char* argv[])
         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 414/688] 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 ba8c81005..dbf7057c5 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 415/688] [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 dbf7057c5..1a18525d0 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 416/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 85dc0b43c..c5df1f8f7 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 417/688] 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 60a4d9774..39b4aa552 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 418/688] 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 b7f814080..e1490d6a0 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -1050,7 +1050,7 @@ class TestImageBytes:
 
     @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 419/688] 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 973b4374f..9dd7742ed 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 961312b14..7f7dfa6ff 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 420/688] 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 be32e6d1a..3199e330b 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 831ce432c..9e91944fe 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 bcbe65aa4..ba8353c2d 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 421/688] 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 9e91944fe..45b67616d 100644
--- a/src/libImaging/GifEncode.c
+++ b/src/libImaging/GifEncode.c
@@ -116,8 +116,8 @@ encode_loop:
                     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 858de9332..e6b57e0a7 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 422/688] 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 debe7ddd8..6b2518d35 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 423/688] Removed direct invocation of setup.py

---
 Makefile | 1 -
 1 file changed, 1 deletion(-)

diff --git a/Makefile b/Makefile
index 477d92609..1f9b4a370 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 424/688] 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 8f4a4d090..c53f23a9f 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 59bb958ec..63aec586b 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 c08a53a43..888966c51 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 425/688] 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 c08a53a43..02c409356 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 426/688] 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 a17edfa39..33b3da9a6 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 @@ class Image:
                     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 @@ class Image:
 
         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 @@ class Image:
         """
         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 0283fa2fd..27885e654 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -163,7 +163,7 @@ class ImageFile(Image.Image):
         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 e3c0083e9..715a358a3 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -424,13 +424,15 @@ class JpegImageFile(ImageFile.ImageFile):
 
         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 8b81e54ea..012e0b61b 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -783,7 +783,7 @@ class PngImageFile(ImageFile.ImageFile):
                 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 427/688] 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 4ccfacae7..e7339ecbe 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 04d6f5dcd..026f488d8 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 ed58ca3a5..04b2a47ee 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 a17edfa39..c1b8a2b2f 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
                 if self.pyaccess:
                     return self.pyaccess
             return self.im.pixel_access(self.readonly)
+        return None
 
     def verify(self):
         """
@@ -1485,7 +1511,7 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
 
         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 @@ class Image:
             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 @@ class Image:
                 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 @@ class Image:
         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 @@ class Image:
                 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 d3efe6486..5c179000c 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 3f3be706d..f52dd301d 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -22,11 +22,17 @@ import shutil
 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 2c831913d..af9595666 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -22,6 +22,7 @@ from __future__ import annotations
 
 import logging
 import sys
+from typing import TYPE_CHECKING
 
 from ._deprecate import deprecate
 
@@ -50,7 +51,7 @@ logger = logging.getLogger(__name__)
 
 
 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 @@ class PyAccess:
         # 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 @@ class PyAccess:
                 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 @@ class PyAccess:
     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 @@ class _PyAccessI32_Swap(PyAccess):
         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 @@ else:
     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 428/688] 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 af9595666..cc8e2e359 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -49,6 +49,9 @@ except ImportError as ex:
 
 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 429/688] 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 f52dd301d..f16e95544 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 430/688] 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 9674a4665..7972730ca 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 c53f23a9f..6afed74db 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 a07a27c46..a773ca453 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 40994c60a..9edc15173 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 4573fde90..aa5646caf 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 431/688] 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 7972730ca..1269ef8cb 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 432/688] 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 8d351ce91..bdf54baae 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 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
 
 
 class BLP1Decoder(_BLPBaseDecoder):
-    def _load(self):
+    def _load(self) -> None:
         if self._blp_compression == Format.JPEG:
             self._decode_jpeg_stream()
 
@@ -418,7 +418,7 @@ class BLP2Decoder(_BLPBaseDecoder):
 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 9ce0fed88..c5d1cd40d 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -283,7 +283,7 @@ class BmpImageFile(ImageFile.ImageFile):
             )
         ]
 
-    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 b24c16329..1c455b032 100644
--- a/src/PIL/DcxImagePlugin.py
+++ b/src/PIL/DcxImagePlugin.py
@@ -63,7 +63,7 @@ class DcxImageFile(PcxImageFile):
         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 @@ class DcxImageFile(PcxImageFile):
         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 3032e4aec..59ee0f8a0 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 ec6705742..b57daca56 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -178,7 +178,7 @@ class PSFile:
         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 7a233d015..eea2c0c95 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -123,7 +123,7 @@ class FliImageFile(ImageFile.ImageFile):
                 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 @@ class FliImageFile(ImageFile.ImageFile):
 
         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 93be7fefb..26e595819 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 @@ class GifImageFile(ImageFile.ImageFile):
                 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 @@ class GifImageFile(ImageFile.ImageFile):
                     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 @@ class GifImageFile(ImageFile.ImageFile):
             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 @@ class GifImageFile(ImageFile.ImageFile):
 
         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 @@ class GifImageFile(ImageFile.ImageFile):
         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 f50e6bf16..afbfd1639 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 c2c950863..0a86ba883 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 82b190eb8..eacffbae6 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 4613e40b6..0de7d6492 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -278,7 +278,7 @@ class ImImageFile(ImageFile.ImageFile):
     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 @@ class ImImageFile(ImageFile.ImageFile):
 
         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 33b3da9a6..0f2e146bb 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1298,7 +1298,10 @@ class 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 @@ class Image:
 
         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 27885e654..b93e2ad2c 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -311,7 +311,7 @@ class ImageFile(Image.Image):
 
         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 @@ class ImageFile(Image.Image):
         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 @@ class PyCodec:
         """
         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 b2c4950d6..fa9ebd9de 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 75910d2d9..2c439038d 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -204,7 +204,7 @@ class Window:
     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 @@ class Window:
     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 96de386a8..5aef94dfb 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 @@ class MicImageFile(TiffImagePlugin.TiffImageFile):
     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 ac9820bbf..fb6620e75 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -127,7 +127,7 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
     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 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
         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 012e0b61b..39faa0f78 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -800,7 +800,7 @@ class PngImageFile(ImageFile.ImageFile):
             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 @@ class PngImageFile(ImageFile.ImageFile):
         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 @@ class PngImageFile(ImageFile.ImageFile):
 
         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 b15918313..86c1a6763 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 @@ class PsdImageFile(ImageFile.ImageFile):
         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 86582fb12..01a39e97c 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 @@ class SpiderImageFile(ImageFile.ImageFile):
         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 c78c223b3..1be717de1 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1143,7 +1143,7 @@ class TiffImageFile(ImageFile.ImageFile):
             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 @@ class TiffImageFile(ImageFile.ImageFile):
         self.__frame = frame
         self._setup()
 
-    def tell(self):
+    def tell(self) -> int:
         """Return the current frame number"""
         return self.__frame
 
@@ -1237,7 +1237,7 @@ class TiffImageFile(ImageFile.ImageFile):
             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 @@ class AppendingTiffWriter:
         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 @@ class AppendingTiffWriter:
         self.skipIFDs()
         self.goToEnd()
 
-    def finalize(self):
+    def finalize(self) -> None:
         if self.isFirst:
             return
 
@@ -1990,7 +1990,7 @@ class AppendingTiffWriter:
         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 @@ class AppendingTiffWriter:
         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 @@ class AppendingTiffWriter:
         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 @@ class AppendingTiffWriter:
             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 c5bf3e04c..fbd7be6ed 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 9c8d53336..61ae9eae5 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -109,7 +109,7 @@ class WebPImageFile(ImageFile.ImageFile):
         """
         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 @@ class WebPImageFile(ImageFile.ImageFile):
     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 433/688] 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 3032e4aec..2496088af 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 4613e40b6..77b396387 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -196,7 +196,7 @@ class ImImageFile(ImageFile.ImageFile):
                     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 33b3da9a6..2184ef8ea 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 @@ class Image:
     ) -> str:
         suffix = ""
         if format:
-            suffix = "." + format
+            suffix = f".{format}"
 
         if not file:
             f, filename = tempfile.mkstemp(suffix)
@@ -2180,7 +2180,7 @@ class 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 @@ class Image:
                     (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 @@ _fromarray_typemap = {
     ((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 77472a24c..6664434ea 100644
--- a/src/PIL/ImageMath.py
+++ b/src/PIL/ImageMath.py
@@ -61,7 +61,7 @@ class _Operand:
             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 @@ class _Operand:
             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 7bd2afcf2..92a08d2cb 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 534c6291a..6ee8c4f25 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -84,7 +84,7 @@ class LutBuilder:
                 ],
             }
             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 75910d2d9..f6ea138bc 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -196,7 +196,7 @@ class Window:
         )
 
     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 65be7fef7..85f9fe1bf 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 2542d4e91..d6f2ebd44 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -145,7 +145,7 @@ class XrefTable:
             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 @@ class PdfParser:
         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 012e0b61b..ff8f5fcc9 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -189,7 +189,7 @@ class ChunkStream:
         """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 86582fb12..69b27dc9d 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 @@ if __name__ == "__main__":
         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 c78c223b3..13069ce75 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 @@ ImageFileDirectory_v2._load_dispatch = _load_dispatch
 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 @@ class AppendingTiffWriter:
 
     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 8a0b14004..95c6c84cc 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 434/688] 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 d6f2ebd44..1485cafe0 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -225,7 +225,7 @@ class PdfName:
         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 435/688] [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 1485cafe0..c1ed78797 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -144,9 +144,7 @@ class XrefTable:
         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 436/688] [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 51625eb4c..1272913c9 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 437/688] 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 d01884f96..1c21aa8ca 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 661abcddb..9e049367e 100755
--- a/selftest.py
+++ b/selftest.py
@@ -165,9 +165,9 @@ if __name__ == "__main__":
     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 409609434..73df83bfb 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 c1ed78797..65db70e13 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -825,8 +825,9 @@ class PdfParser:
                 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 438/688] 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 02c75073a..f37ae6096 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -415,7 +415,9 @@ class TestEmbeddable:
 
 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 @@ int main(int argc, char* argv[])
     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 439/688] 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 2184ef8ea..f81e95695 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 @@ class Image:
             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 @@ class Image:
             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 @@ class 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 @@ class Image:
 
     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 @@ class Image:
         """
         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 @@ class Image:
 
     # FIXME: the different transform methods need further explanation
     # instead of bloating the method docs, add a separate chapter.
+    @overload
     def transform(
         self,
-        size,
-        method,
-        data=None,
-        resample=Resampling.NEAREST,
-        fill=1,
-        fillcolor=None,
+        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: 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 d3efe6486..579489fde 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,10 +34,11 @@ from __future__ import annotations
 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 @@ class ImageDraw:
             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 @@ class ImageDraw:
                     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 @@ class ImageDraw:
 
     def text(
         self,
-        xy,
+        xy: tuple[int, int],
         text,
         fill=None,
         font=None,
@@ -591,7 +592,7 @@ class ImageDraw:
 
     def multiline_text(
         self,
-        xy,
+        xy: tuple[int, int],
         text,
         fill=None,
         font=None,
@@ -678,15 +679,15 @@ class ImageDraw:
 
     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 256c581df..536ee5fe6 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -33,12 +33,15 @@ import sys
 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 @@ except ImportError as ex:
     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 @@ class ImageFont:
         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 @@ class ImageFont:
         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 @@ class FreeTypeFont:
         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 @@ class FreeTypeFont:
         """
         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 @@ class FreeTypeFont:
 
     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 @@ class TransposedFont:
         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 truetype(font=None, size=10, index=0, encoding="", layout_engine=None):
         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 e27843e53..2c2ea9a54 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 440/688] [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 f81e95695..9f55ea924 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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
 
         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 @@ class Image:
         """
         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 536ee5fe6..fb7e1d8b6 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -158,7 +158,9 @@ class ImageFont:
         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 @@ class FreeTypeFont:
         """
         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 2c2ea9a54..987e7fd6f 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 441/688] 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 9f55ea924..f6f070fee 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 @@ class Image:
     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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
     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 @@ class Image:
     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 @@ class Image:
 
         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 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
         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 fb7e1d8b6..a1b722765 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -40,7 +40,7 @@ from ._typing import StrOrBytesPath
 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 442/688] 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 f6f070fee..9b0c24ec0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 @@ class Image:
 
     # 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 @@ class Image:
         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 @@ class ImageTransformHandler:
         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 @@ class Exif(_ExifBase):
             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 579489fde..ec8a9a67d 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -118,7 +118,7 @@ class ImageDraw:
             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 @@ class ImageDraw:
                     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 @@ class ImageDraw:
 
     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 @@ class ImageDraw:
                 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 @@ class ImageDraw:
                 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 @@ class ImageDraw:
 
     def multiline_text(
         self,
-        xy: tuple[int, int],
+        xy: tuple[float, float],
         text,
         fill=None,
         font=None,
@@ -625,7 +625,7 @@ class ImageDraw:
             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 @@ class ImageDraw:
             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 a1b722765..9eca3bc98 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -35,11 +35,14 @@ from enum import IntEnum
 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 @@ class ImageFont:
 class FreeTypeFont:
     """FreeType font wrapper (requires _imagingft service)"""
 
+    font: Font
+
     def __init__(
         self,
         font: StrOrBytesPath | BinaryIO | None = None,
@@ -261,7 +266,7 @@ class FreeTypeFont:
         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 6aa82dadd..80a6116b7 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 @@ class Transform(Image.ImageTransformHandler):
         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 e27843e53..d85eb84fa 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 443/688] 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 65db70e13..c43f2da7b 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -823,12 +823,10 @@ class PdfParser:
             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 444/688] 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 f37ae6096..e55a4d9c1 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -409,15 +409,14 @@ class TestEmbeddable:
         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 @@ int main(int argc, char* argv[])
     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 445/688] 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 9b0c24ec0..31e6fdb83 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2204,7 +2204,7 @@ class Image:
             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 446/688] 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 31e6fdb83..ed1621e62 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 @@ class Image:
     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 447/688] 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 ed1621e62..8348ea257 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2210,7 +2210,7 @@ class Image:
         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 @@ class Image:
         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 448/688] 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 8348ea257..f39580996 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2775,7 +2775,7 @@ class Image:
         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 449/688] 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 0d45d5a20..930289c2a 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 0d6da7754..9875d71e7 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -114,7 +114,7 @@ V = {
     "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 450/688] 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 f39580996..154862a6f 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 @@ class Image:
     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 451/688] 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 0d9b4d93d..c0d9095cd 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 452/688] 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 7d8e1c1ee..abdd87ea2 100644
--- a/setup.py
+++ b/setup.py
@@ -23,8 +23,7 @@ from setuptools.command.build_ext import build_ext
 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 453/688] 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 1cbd50d19..271db7258 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 b8790e209..85e2145e7 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 cfaf86239..4ba93bb39 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -237,7 +237,7 @@ class FpxImageFile(ImageFile.ImageFile):
 
         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 a746959a3..7fcf81376 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 62197e36c..93e89b1e6 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 a80fe0a23..13bdfa616 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 9c16159e9..a325f8552 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 10b2cc69a..2f9d7f505 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -128,7 +128,7 @@ class PhotoImage:
         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 @@ class BitmapImage:
             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 697bad221..81ef32253 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 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
             )
         ]
 
-    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 715a358a3..7a3c99b6c 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -462,7 +462,7 @@ class JpegImageFile(ImageFile.ImageFile):
         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 fb6620e75..eba35fb4d 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 848fc2f71..49c06ce13 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -54,7 +54,7 @@ class PSDraw:
         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 c43f2da7b..077c9ec8b 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -409,28 +409,28 @@ class PdfParser:
         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 @@ class PdfParser:
         )
         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 @@ class PdfParser:
         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 @@ class PdfParser:
             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 1547edde5..76e0abc31 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -179,7 +179,7 @@ class ChunkStream:
     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 @@ class PngStream(ChunkStream):
             )
             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 2c831913d..a9da90613 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -70,7 +70,7 @@ class PyAccess:
         # 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 2875b8d75..cea8b60da 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 61ae9eae5..052f253cf 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 7f045ec7d..b0328657b 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 a638547af..88d14e9c2 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 454/688] 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 c0d9095cd..d917a3c92 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 455/688] 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 9eca3bc98..f2936bae6 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -35,13 +35,12 @@ from enum import IntEnum
 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 456/688] 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 154862a6f..53f38f0b2 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3802,7 +3802,7 @@ class Exif(_ExifBase):
             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 457/688] 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 1297c1c43..5fd4fe332 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -29,33 +29,6 @@ elif "GITHUB_ACTIONS" in os.environ:
     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 e1490d6a0..742d0dfe4 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -31,7 +31,6 @@ from .helper import (
     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 @@ class TestImage:
 
 
 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 @@ class TestImageBytes:
             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 @@ class TestImageBytes:
         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 e55a4d9c1..9d6006679 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -10,7 +10,7 @@ import pytest
 
 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 @@ class TestImageGetPixel(AccessTest):
         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 458/688] 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 45c2af975..8d39ea9bb 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 459/688] 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 eea2c0c95..dceb83927 100644
--- a/src/PIL/FliImagePlugin.py
+++ b/src/PIL/FliImagePlugin.py
@@ -132,7 +132,7 @@ class FliImageFile(ImageFile.ImageFile):
         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 26e595819..eede41549 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -82,7 +82,7 @@ class GifImageFile(ImageFile.ImageFile):
             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 @@ class GifImageFile(ImageFile.ImageFile):
 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 a3109ebaa..2274f1a8b 100644
--- a/src/PIL/GimpPaletteFile.py
+++ b/src/PIL/GimpPaletteFile.py
@@ -53,5 +53,5 @@ class GimpPaletteFile:
 
         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 a325f8552..8e949ebaf 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -271,11 +271,11 @@ class ImImageFile(ImageFile.ImageFile):
             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 d3efe6486..42f2ee8c7 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,7 +34,7 @@ from __future__ import annotations
 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 @@ class ImageDraw:
             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 fa9ebd9de..678bd29a2 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -544,7 +544,7 @@ class Color3DLUT(MultibandFilter):
             _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 770d10025..ae5c5dec0 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -66,7 +66,7 @@ class ImagePalette:
     def colors(self, colors):
         self._colors = colors
 
-    def copy(self):
+    def copy(self) -> ImagePalette:
         new = ImagePalette()
 
         new.mode = self.mode
@@ -77,7 +77,7 @@ class ImagePalette:
 
         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 @@ class ImagePalette:
             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 2f9d7f505..6e2e7db1e 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -136,7 +136,7 @@ class PhotoImage:
         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 @@ class PhotoImage:
         """
         return str(self.__photo)
 
-    def width(self):
+    def width(self) -> int:
         """
         Get the width of the image.
 
@@ -154,7 +154,7 @@ class PhotoImage:
         """
         return self.__size[0]
 
-    def height(self):
+    def height(self) -> int:
         """
         Get the height of the image.
 
@@ -227,7 +227,7 @@ class BitmapImage:
         except Exception:
             pass  # ignore internal errors
 
-    def width(self):
+    def width(self) -> int:
         """
         Get the width of the image.
 
@@ -235,7 +235,7 @@ class BitmapImage:
         """
         return self.__size[0]
 
-    def height(self):
+    def height(self) -> int:
         """
         Get the height of the image.
 
@@ -243,7 +243,7 @@ class BitmapImage:
         """
         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 81ef32253..ce6342bdb 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -63,12 +63,12 @@ class BoxReader:
         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 077c9ec8b..68501d625 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 @@ class IndirectReference(IndirectReferenceTuple):
 
 
 class IndirectObjectDef(IndirectReference):
-    def __str__(self):
+    def __str__(self) -> str:
         return f"{self.object_id} {self.generation} obj"
 
 
@@ -150,7 +150,7 @@ class XrefTable:
     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 @@ class PdfName:
         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 @@ class PdfName:
     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 @@ class PdfName:
 
     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 @@ class PdfName:
 
 
 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 @@ class PdfDict(_DictBase):
                 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 21509b2d9..5b8ad47f0 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,6 +37,7 @@ from __future__ import annotations
 import os
 import struct
 import sys
+from typing import TYPE_CHECKING
 
 from . import Image, ImageFile
 
@@ -157,11 +158,11 @@ class SpiderImageFile(ImageFile.ImageFile):
         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 @@ class SpiderImageFile(ImageFile.ImageFile):
         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 a7a7e28bd..54faa59c5 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -381,7 +381,7 @@ class IFDRational(Rational):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         self._next = None
         self._offset = None
 
-    def __str__(self):
+    def __str__(self) -> str:
         return str(dict(self))
 
     def named(self):
@@ -617,7 +617,7 @@ class ImageFileDirectory_v2(_IFDv2Base):
             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 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
         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 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
     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 @@ class TiffImageFile(ImageFile.ImageFile):
         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 @@ class AppendingTiffWriter:
             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 052f253cf..4b8cfe65c 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -144,7 +144,7 @@ class WebPImageFile(ImageFile.ImageFile):
         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 460/688] 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
zhvQP0LZD=IG+1d1v9^|65IT|CjQq+<zA1pRytt9DM<YBDOnF9BDv{4Q9Vu93<*~OJ
z{AsA)y#<sJ_2_CPkg46iA~Wfc`qawFASVMGv4A-g#K{TgprWD~R*)CZJZ6eqq}=$y
z%Wmj8;;G4!=OFNZ8o4k(H~aNjgKj@C`?dDgKQT;VV+-<%lhovNqzZR-=qXzwKfF58
zV&W!xbfp9Ues8Tu{{VdSqa&V2N|R!2{Iv0$kC<n7dWYzHcc%g}dF@ir6O8pNew8R;
z^72O&R35!*Ku<glwJi-Y>bKqGRKVjOHhHQl-*>JsYGC7P@l#>kzKn7P+Omu|$?aLl
z+^^2nWf%k3H7yjGryG33=RGT8&P-e(-_Tb$9A$auHGT&mug%WxDq1(EJ2TdFdBa;k
zL42=JO?MX8E#$US+Ps5BoPD|lGB5;z*1bl^gBl&fg~_Ozc0GzUE|IqrJBB%MGt#bq
z%QPE%R2Id2mipDU#v{fv<sOyAQU`2iKmwP+ZlA42!AzVpeeU&ZXb8L}cGO@GnB_X~
zJJ$tBowVjYFaS@Kb*X!vrka7a=LhI2bxcT{cILU{Z5ANT#o*+env^N>80W1A?&qGk
z7^y)5+C2U>CETxv4l*;7+N4meb&NWJ5baXrYzG61VFalnTx9c9h`AF0Ws@i{7~-Oo
z$F#SUI&oGw+@P&TjnlvGumR&VF{WlPZ#a_^0M%qGd6t~y6g6s9%g2;EQap6-Y8N{q
zL$$HH@}+XGa<gvxRD=Q!;sC2F7&h@P=r?5b{{R|?A*9Grz@ba|&PV_T?M1{g;S6Qd
z%tBp27(6KNnyey2HIk8lGRGapYU`qyfo`XzR}NNWQy1gk^QuB-a}`+c@=i>QFh^|E
z4oBIv@#dYzVo5c2@ekW_T#(U%PAZ~+(?=Tt!QIH|TBc2htFULphZybNoTT|#1pV*Q
zp+LmX`=AQ1LslCC7`{*m6)dQeJ2#PRGs$e`oY?cB$j`k-aLXUgyOnwa)KWSB0FQiU
znSYgLY>B+K+@vDmqwH!?^2FS)PzSX_8Gh3XZs{Nd1KOXtTIq%e8;=x|0(WIGvlUg^
zn8@O?m&}(^U8X`eZCs9kRMR*hpeKWhyK5fJI5AU}1P(yJ?rCnzS|SPa<;5D~<vmC1
zPCz`D$ZVLv=}RIvkfbcQG8{9WTbgtu{T5a$f@8q?_p3;jIhk1P4{)jzEJ5q-Rn#G!
z*?|LRLFrGx5%T9Og#Hxpq<LHez$T@RBtY=Q!rMcP^V*<~<+RjfDlj5ppF-U#&B+UB
zgJ=cLFg*ok$YgYeFv<bB$>O22Sgi||_-i;&M&(4ij(uxNFop)obZn1fP}{~9+zr_I
zd8_CXC<0&socA@XB63xo-h!e9ff<mJ(sVwQsv`#AkZ=Yted@yJ?9U;N922zxJ^e@0
zsj~k7q^Hi`Go0krv!3@XAe+l}OJo410d8_V1w$Z*%(~wSvw2%`4^O9Rl365Yh;Bfs
zY^tGp04fq2%^=7=Y;+wlND>&amtqC60arLtRBr?ZG8TE2gJ7?g03V3!THD<%?juQ}
z+|mHVjzGt6t!7H8_Ku%7mCg?WgII23$f~d$Pq>EXj+LJ=Q#fHE1IQUCiq?@W#P@*Q
z%*B@{YVnHAMTxGWXKSGtl>Nm7oPBCexT3o-`%RHpW*}P}s}7{pFC4yO6^k3cgl4oR
z@{Qs0;>XTT=~xnf!|<pxH`=8C07+m00F>jWzhBCWmvOkbR0|~W1^X{5>Nf#Yh>PtU
z-A1dPxXno*hwTz?Yydv?Nn`ocC>7;9RFFHK)iPxyFe)^Pe7P`NBO?`c8NS_Qr9fXa
zU<!ssb!hUflDWn^RFEI^n^Nwr`|*lMQrOa&m(0uW<L>RM>*l*IOM$khmj-EBqfWd4
zI0BdyvY;)2k;ko3fm%hz<y09Y@+z~S$Imn8-=%7@ksd^A(yF@t?{Q@vbDE?pnDUkR
z!lDzN2&xRSZp%9;^v7D(kzCxVOLSjWBC}^k7cLka?V`n*(goVYLj8Kx2}5~qFa}TO
zS}vr?Ao=lB=85)_W?XTBpGveQidPWA*4D4~Rv0)fzd0k=*D<MCLgCpU1ZR-E9&4}&
zG69vy^7>}8?hprWlOQ+n`qidn)sH09wCNGuys3dajGWggG&pC<r_#N<QnoT!oIvCE
zT!Z~P*AsiEL@jO!RxD!3^cAXh5$3F^w16bWdSa`zWq}(==DHh;eX>3vbI+$*&1mJ`
zayI<j3feME&QLMlH44Ck)~YgO@S`5Jyzz~vaTQ8c<b{a!^y^o17XuOE7;HwTnyk=*
zTjd{iwwXR-@}5U(Xp7`IjE};tNWxG#(`>ts$bPu0GC=Ea;0%n{Sn;=)#6#+8l(053
zLW-p$2~s)jjh4iPSWpI4!$v-&R+B@CW#FD^qCA$$_N%#*fs)Yv@vy@*!xEMt<Q(;_
zHjRTe6_3r<m=G2jh;*mSPbr$v5fQ=2$7+biGMo{STOv6F0;Hd6Pc07M&>%grPnbCj
zNg`vk_M|Waw*`mGTV6rifDhgDrul2J@()AWj$q_5{E`tyRN!_LEGxD5ASWJ`s<E%l
z%XBn(N(bK0K9qA0kjL_d8;%cZMuB!W9jjHN!#~U3no)8-_ewc~*_cKwI^joOO0cmh
z0F^x|`$m9+vAR^KpDO%=?@`Pgg)tOmMqzF`REr9bN0u{+wpF)d98|jqDs#c5%u<0x
zVr`B#bRLwk#t!e@w_4FvPd+oSk(!aBVIvh$hCL}c6rg8$M```rb*HRnXWeXftsxwl
zjDiOp>QftSA0~2pQgSUops^{8V49U<`9}k%rCbUC1IouWVPndI0)d`tIg3y;#A9|g
z9!I50v7Ol3D)zy<K3J(dwf^9vn56=kMg#8*W~B;pK2!I4)s>I^hU-=p6D#tHPDLn{
zQ5!3iHF7jwKX=}xR2ln+tyxt4*!e|Ek*a|brvv7x!jG5bUX?1R$}+vGRb0Q^J!=;t
z)C5H3F&fo{kLDk_ZoTSg(Cr^9ed@myPQ?D_o}DW<BWS>>97MEuOq0cH+u6GVn9hEc
zcFxd=VkQYXgPQB@EkAUGq3Sw{&B(i0<>Rt(BxlP!9+<7`NXoQh%IJCGx5cvK{yn+J
zV@MR8by$<{+lNPv?v!pAh%`*PLvoBprKAKT{L<av7%@P=(K$ltM(HuSC6z`%Kt_q6
zzjyE7JDwfS@$A_B+}Cw~uJiPc&NnFkJAI9CeFvH9P<hFb;E}-kGADg%t)+y`LhYox
z-HFd7O2{^QL^!z#R-8j=(&){_eFPCcJVP&6pn?0!BKBD*Q~9XcqqS(s=vsdh`%6o*
zSnyG*D*y;YUYAO)C{?`d?Qdd_nHJem&2SRGx_*I&_Nl65-FSLcXPBtbgzhX%k`+`r
z)A+k!iN9^NhckIGOVPHJ9>frOk#w*)X*%G2Em%rbD8H9(vFk~Rq0P+My<a`Ks`dN0
z@@lOvtMl=9&hNINlBBokl+*5=1y6eP`LWVt<kJ3r2Av~npE6VfwUyYrInMhr75wkG
zdaP5(bA{O9xHvlTW`@RLmE<zAqGx(t&vb<mw69bqpkdS0zXxs6%iPW`?)maYE!2E*
z4{M~q=XiOD!kn8|cnZAp%}CqWf);F&<2N~I>JdM<TolY=7a8w9uwrg2pyJDu*3l^m
z1TZpWteaUJT!gh<Z+_Ct38qe_1Jttjxm9WX7C781xx3HtxiyO1jgNEjind-#?=1Lb
zHq`;bA@h|6`ZbA!4oCLZC!rIZ0HHr?ix_h)lM+iHO_4K(GOd$N2Qv_1gu1R6h?0aS
zKF<P`L5uEMHS&m}&r8o46LvDjptp=3zRy62+a|qy=J$$bcna&6wC4Dc(+m=1^?IDw
zHVUbFqrn+;CJpxQejcaixwwk1;OeP4yl+7`)AETCSCl(JwQYONqb=ghr3k<IDvS0@
z7m6-?UUjpHM@0VhX56|0G;px8=lnV7UE&&Z!d1;p7uhJOsf(kDZAdsb=O*f%AHT60
zJ!g)6S_1}ri%Q`Vro<?Npy^VgiZv>UmD$O$Ou-YVKNbm66yAmJNqq6poH^nzogAIl
z*OwDXCMD`_L)Ia)XF4xl3Zt?!dtggJbU>$uX|Sv_`TM`yLM1gTH7|RMimnC9Y8><@
zXtar@_XSPW*rACMSh<ZSU;EU?G$k%S$UNd129J_n<L0&S)4o7FP~yul2^@7v`)<!k
zx+7>`Eguh^Ct+f1&br-wX;}z;LQ<&uNXr3$e&7FN2wcZFe%i{-O&w($lNTNN>I9<t
z2P2hqepCBJq%g)qQbUA<dRm`AxyF0-O?Pl<?BTiJRSlLRnqy_kOw-tS8v!$qN=ekU
zWl_l3UW`@tkdmDA0%eel2mM!)VSe@rKf6%`j=Zj!q3~6xG8%iCqy$4OXIf0q*@y_R
z`c1r@_88ca8!w4f+gkwboN>A`aZ^2oU+tJ+CfsC}u#EtqO4}1W-~>W1S6+cIgF4c~
z-`bA}e1sz^)L4H$;E!Tvkx7_d`1-3PQ{d${Zs6|(9fFTRq#)mmWM&Dv2(&CG`Pg?!
z02L8|Vf@4d(fdrpZ+cujLL33cnbg{*!FxNU7Ma1=uV=f}GK~KJ0n_uaAv@W3@1zoh
zeqGhX<S;g6vFdn2o%fnHir@Zq$9LpbAcXyyv&e&Qy*<&kNNK_v4!u8Ft|Nj3oZI5w
zavi{P3r0SneU8_s=@a7eKBQaMe?3|KdHvviR#N_<&Z*UYx1{HYk!L!Yp*b;kI`(Eo
zCiD46^Y1T|UrU!{NDeN<@WkBKpufs|E|#ox5Cm3p9IKgN#%i~4b?#Fr@}YMgKVoR{
z8l}FiP}_g`wWCsjKH;!Wk7+3}Bw)F|d^<_GdkGNf<y=yocyxtw_bBk(+PWM#wQ@up
z+Ba?2aoGQo54EV-xT}%p>M?iL8~fS1I{ti6oh#hoYyHuCw$?E{qE1${=dTkmTcCW+
zUCY<`zGrI1Pqp$80_I9ZZS*Twjcu|`M>Ga1)A=a_fVZ~uy2Q$pD~iNK0fCqJxx2o{
z3Jn#$6VuYoT_8>*t9Kp)o+h2HZI(i(jvK3T8b2T;%6G9IJ(=v{`+BAZK4vgn1IP*9
zW#pqxt!EATkHcdt{R3jY%k^#lhqR`L@)*c=<O^zp6urR!$l)PSsM5v5kNVqaFn+8b
zi!us4HXR}}Z_MHxEfSqJjsgm?JP51FeVWvr((Brg3WKQlE8v#yK%opR7Z$VVUb1?t
zTOUJRpP@U*dp4`XLs<!dhJLxN?Wb;x@}N;`%e58qNp$6thc<Qi^=r@MGo6jdb8e{r
zle6;h|8^QADI#6@fjrceS`!C`XvaI#rRWMBg#ppo`-O4FmNkm7Jbb^kLX1dRdBgIL
z*`0Or;`6}Ti&(J^nuOI~Y@CU$S`ND06dUl^vNgHpknk7;+W6{>IDAa0W<8Ll-2~Uq
zt)(;kDLrQV+HC3D38$5FYRLre^UbDMNhE>szE&Nr;Es7Kg{(CZiBObADAYP#+#=Cr
zyTFOrx)NdqzCv|1YaKgZvgAMI*)q>*BASc|)ls7eE2yoEmoJp==qRb``5$1okHI*P
zPbgKJU!U~x(_emHK8m`kinUfG3B&!0q|a?~O|zh9;q1k48eW&7KCmSY!!AxN7(^sn
zp0;l|;27^LmV$F?KGocR=poyN`*0F#3_rZO&0xBYWYeo>?G=Afsjee#YGE(uCGifg
z(-whdbA{N5{)VrF$MgIZP@R7WAV4ifOU%9#+)o(wG!Y_gulKcCpXcQ@5bz)R&0uAl
z{W#od6lm-6q2O2#VsY>W`Kjd8){NI@^dCM2btv~ov}I*Z%3xvB<qAC{8o=)2b5$Bj
zozomuX>hF6Hi0~hv0K^hTy}~aFH?d=LRX~((^<x581{iv5vai?!d+C&9#5oGt=+hy
z6)U>$*(0q|HR$65myt}EOVJX&l-LC-OX&`o70kKxxZ6Z5h{A_2Rd|*;5cfbvYxQPb
zf7Kh)7yve>aru*!R~>AxQ<!GGHkiZcq+Ux|Sq7Jz34WLG@%ibwcS~_G@TfHmKblcT
z(!#}wLUgZ@+t095XEe~s<BfH{&iYFcU%$>c<Prr@Oj14<9n$S{M4jQs$Jc^H$=LU~
z*JrvNo(=4Nvh{FHxc&=iWK^0FJbs)yj_g1RzZ5fLi{j&0T?39kwS31j)IPEwJmWc)
zsotr^FC=sz`?z4hzUD-9Vhk<osxYV-J*}*FV)eKI)0wevAjT1Kge}YU60O+?4MK@b
zl&U#^2USA$kO*_F%)gav<L`Ja&W(APB;;ZPzRJ`vOn#_59^&R)9CL+xuN{~!U%DX~
zRCf)@?kg1(2z|>d#U@cIkVEd0y_zXYkLO*NALAS-C!!^<7<J?X#pJg{Bf_9m^rwJ)
z{kx}ubr1rE<$+vcV(y?%;rCE!eqL7|af#=F(Hs8C9%Wu`Q^m52&ebf8#s2avCV8am
zv492}jdyOV#S!R&DTInwIYHj2asU(}+?+1b2;8<P5E9;XzB;#3c|K2rj2o-jMDiA<
zjmc`bY7P?23@63K6qNmz_;l9K?GQ8HUP1MehvbiiV2aW@atc2VabDoAgIi(r+6VKo
ziN;Zt4jXH)kgX2*(l9Gq2#>S7g`FS;d(m#6n_=(AA4!x0vQ`4+)8}60Dn5@*fJ#)N
znZ3>3_?Aq2k(Y5NFVMI!H&cIFb%rPzcEQ(izYDN;Ic4kQmVqHBQp_$ct`2SBcVkxr
za-4iw6ys%@S6!_d<3M{JRCW|rq%&PQ$P-dsdph|U?horu@yFk99_=V~??3e`*a&;e
zvPpg@`@9_Q%VOhU>YU!VsT6;T??zE4n+c<>UQ#xJ?)q|vp{M-+06hb;FZ9ZJ;Fk-X
zBeIGt<3JUM^uvCi_$8rtfNjN_j|dFD9KP1!m(cnPar6)cV!7443s&Ob<<NyqB!64u
z^6p6v!6)AKy@X!GB^>nSeR7v5($8X2mj}@lN1YQ>xt`Uf{@XGRl&uyTw`i_ZO*Tvu
zQl4j@Ak9VuVW0QX(AjrH2JSR$|7C~P0&@v;z&O9SibhPdO9sQmTB)SU_20$3k=KN*
zUhI$LI=HJM|G!om3)ay!gc^}@)8aLhbE!8aaU2mE?PntTm1_>Uc&0H7arHu64U#nH
zZwf!(nizZ!&K?|c1PY>(CBb*pww@X{E_kGx(S3>wgCZSjj+nom$D?77m7U*6|J5Xb
zUm;WXK!7sFm;7%}QgfggeSbkK>6CL(w2*oSS}YEeVke?jn@k~2hCG}vYHA!Mm3^xt
z{qNHWq(1ytVXcpC4AM!c=AZZys0t64joXpzWQY9Rf|1#e2s1KL&Fq_txdm;epDhlM
zAgXauzT+=Jf7ilspTU9&K&oWE>Y4pq3HEDp>DkvPCc($ICbqZ>bLOa7W;W|kkFr!=
zZeO9Cl3@|JpvoUD{W05V$YZT(?7GmcTXm%oh4ITXyqVA?y^vGe+}z|Drqk7LPetl0
zMIVhYJZ@Mm1m+sE1b(cYFcEMT<R)P!u(h=G6HapB8kVv<x6-HV#Fy@Ld4w6?@tSCF
z9`=vi`|nKDNtgtN->|s!+lorxZ05z&rL<b=O<DGSC{1)-@_JF<QFsaC7$nlfU_q@C
zu)g+wf_2-kAa_C+%&+Z2$mf6Uvk8YX`Sjjf#%B^_!UMk5wmQ0OrxTa9yh4>SO|6K9
zLf4t^aoERF`tW`_Pb||Ko|4arku+G%Sp?u43h^cTRh`<ZhRt(E{#hiJJRs=n4y<;x
z4m~7CMluQ$!Z$tW6~P?1>kAnU6KZw*nPmN;VV9X}4UF~x+Tg2-=RLR-A|BQkeNm;)
zJP806MTpqYyDQcjeGCy9F-XOa#R90+H)aWV$*d{lH-Caw^!i^(Wpok3!Y3n?QKix5
z`-A1GBi|XWt=2|ja44!!aV8FINU)tAl=fOC`f02J>miPM?+}8)f_G)51z%B&ccC|@
zJ^3MgYQCi3B9uYn-lI`#>`plrhN4*2@3_b$ApnsHF>_M7OUak$JY)<H(Z<uuc3v+Y
zZJw1xu(Ff&5Xk49Tsr$0DQ3*M3a1q8f0!U?pB%~i1*rY<V~UT-!<QL`m)bnZk*_@w
z@)`!aD7Hm$lk;sm^Kk?~#$yE_Mect$Vl@1UuBBU8vc;H=%kS%!Yw+(3bNLozl~e+Z
z{e(?b`xgEO_-e4<nY)x1ZxM3|^RrqQhYNoW6gNjwCC#I%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 a50188700..39b9c60b7 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 7a3c99b6c..10940179a 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 461/688] 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 0d45d5a20..c5b279a33 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 0d6da7754..b654ee8da 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -113,7 +113,7 @@ V = {
     "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 462/688] 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 b2ddbe44f..1575f2d88 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -472,7 +472,7 @@ class DdsImageFile(ImageFile.ImageFile):
         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 b57daca56..5a44baa49 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -42,7 +42,7 @@ gs_binary: str | bool | None = None
 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 @@ class EpsImageFile(ImageFile.ImageFile):
             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 7fcf81376..5acbb4912 100644
--- a/src/PIL/FtexImagePlugin.py
+++ b/src/PIL/FtexImagePlugin.py
@@ -103,7 +103,7 @@ class FtexImageFile(ImageFile.ImageFile):
         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 eacffbae6..cea093f9c 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -341,7 +341,7 @@ class IcoImageFile(ImageFile.ImageFile):
 
             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 b93e2ad2c..33467fc4f 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -324,11 +324,11 @@ class ImageFile(Image.Image):
         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 7a3c99b6c..909911dfe 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -408,7 +408,7 @@ class JpegImageFile(ImageFile.ImageFile):
                 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 eba35fb4d..766e1290c 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -124,7 +124,7 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
         # 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 76e0abc31..c74cbccf1 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,6 +39,7 @@ import struct
 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 @@ class ChunkStream:
 
         return cid, pos, length
 
-    def __enter__(self):
+    def __enter__(self) -> ChunkStream:
         return self
 
     def __exit__(self, *args):
@@ -182,7 +184,8 @@ class ChunkStream:
     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 @@ class ChunkStream:
         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 @@ class ChunkStream:
             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 @@ class ChunkStream:
             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 @@ class PngStream(ChunkStream):
 
         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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
             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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
             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 @@ class PngStream(ChunkStream):
 
         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 @@ class PngStream(ChunkStream):
 
         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 @@ class PngStream(ChunkStream):
 
         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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
         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 @@ class PngImageFile(ImageFile.ImageFile):
         #
         # 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 @@ class PngImageFile(ImageFile.ImageFile):
         # 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 @@ class PngImageFile(ImageFile.ImageFile):
         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 @@ class PngImageFile(ImageFile.ImageFile):
 
     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 @@ class _idat:
         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 @@ class _fdat:
         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 4b8cfe65c..cae124e9f 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -171,7 +171,7 @@ class WebPImageFile(ImageFile.ImageFile):
 
         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 88d14e9c2..8d56331e6 100644
--- a/src/PIL/XpmImagePlugin.py
+++ b/src/PIL/XpmImagePlugin.py
@@ -103,16 +103,13 @@ class XpmImageFile(ImageFile.ImageFile):
 
         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 95c6c84cc..16c749f14 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -18,7 +18,7 @@ modules = {
 }
 
 
-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 @@ codecs = {
 }
 
 
-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 @@ features = {
 }
 
 
-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 463/688] 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 742d0dfe4..7ec4195e5 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -116,6 +116,17 @@ class TestImage:
                 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 0d9b4d93d..f25c9cd9d 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 958b95e3b..89c649981 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(
                 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(
 
     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 464/688] 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 63d78f84d..4b0e21d7a 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 6b66ddafb..abf94f1e1 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 1b5bfe132..5194bfca3 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 e3b81590e..4874dd26a 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 465/688] 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 89c649981..514a543c2 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -3371,7 +3371,6 @@ def open(
             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 466/688] 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 7ec4195e5..a03e5eced 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -116,16 +116,14 @@ class TestImage:
                 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 467/688] 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 047990f1c..e59c7311a 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 bdf54baae..782e28cf5 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 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
             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 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
         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 @@ class BLP1Decoder(_BLPBaseDecoder):
             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 271db7258..826e89daf 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -15,7 +15,7 @@ from . import Image, ImageFile
 _handler = None
 
 
-def register_handler(handler):
+def register_handler(handler: ImageFile.StubHandler) -> None:
     """
     Install application-specific BUFR image handler.
 
@@ -54,7 +54,7 @@ class BufrStubImageFile(ImageFile.StubImageFile):
         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 1c455b032..f67f27d73 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 @@ class DcxImageFile(PcxImageFile):
             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 2274f1a8b..4cad0ebee 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 @@ class GimpPaletteFile:
                 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 13bdfa616..c27cffab6 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -15,7 +15,7 @@ from . import Image, ImageFile
 _handler = None
 
 
-def register_handler(handler):
+def register_handler(handler: ImageFile.StubHandler) -> None:
     """
     Install application-specific GRIB image handler.
 
@@ -54,7 +54,7 @@ class GribStubImageFile(ImageFile.StubImageFile):
         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 afbfd1639..c8d7866a3 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 @@ class HDF5StubImageFile(ImageFile.StubImageFile):
         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 958b95e3b..38ff0bfe4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1948,7 +1948,9 @@ class Image:
 
         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 33467fc4f..f0e492387 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 @@ class ImageFile(Image.Image):
         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 678bd29a2..43e700b7b 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -18,6 +18,7 @@ from __future__ import annotations
 
 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 256c581df..5446bc0c0 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -261,7 +261,7 @@ class FreeTypeFont:
         """
         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 @@ class FreeTypeFont:
             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 ae5c5dec0..057ccd1d7 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 @@ class ImagePalette:
             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 77e57a415..6c29e2590 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 @@ class Dib:
             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 @@ class Dib:
         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 @@ class Dib:
 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 909911dfe..9fea4e7d1 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -42,6 +42,7 @@ import subprocess
 import sys
 import tempfile
 import warnings
+from typing import Any
 
 from . import Image, ImageFile
 from ._binary import i16be as i16
@@ -54,7 +55,7 @@ from .JpegPresets import presets
 # 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 @@ class JpegImageFile(ImageFile.ImageFile):
 
         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 @@ class JpegImageFile(ImageFile.ImageFile):
         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 49c06ce13..4e2b9788e 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 @@ class PSDraw:
                 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 @@ class PSDraw:
         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 @@ class PSDraw:
         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 @@ class PSDraw:
         """
         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 @@ class PSDraw:
         """
         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 68501d625..a6c24e671 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -13,7 +13,7 @@ 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
 # 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 @@ class IndirectReference(IndirectReferenceTuple):
     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 @@ class PdfName:
             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 @@ class PdfParser:
         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 @@ class PdfParser:
     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 c74cbccf1..f7ccc8381 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,7 +39,7 @@ import struct
 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 @@ class PngImageFile(ImageFile.ImageFile):
                 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 @@ class PngImageFile(ImageFile.ImageFile):
 
         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 a9da90613..f476713ca 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -22,6 +22,7 @@ from __future__ import annotations
 
 import logging
 import sys
+from typing import TYPE_CHECKING
 
 from ._deprecate import deprecate
 
@@ -48,9 +49,12 @@ except ImportError as ex:
 
 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 @@ class PyAccess:
     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 54faa59c5..f3fa3c24c 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1202,7 +1202,7 @@ class TiffImageFile(ImageFile.ImageFile):
         """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 cae124e9f..ff7402dca 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 @@ class WebPImageFile(ImageFile.ImageFile):
         # 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 b0328657b..fab3e26c5 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -28,7 +28,7 @@ from ._binary import si32le as _long
 _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 @@ class WmfStubImageFile(ImageFile.StubImageFile):
         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 468/688] 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 f2936bae6..747c0c050 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -61,7 +61,7 @@ except ImportError as ex:
     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 469/688] 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 5194bfca3..269be1058 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 8b4d7aeac..abffdeabc 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 470/688] 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 abf94f1e1..990f4b0a5 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 471/688] 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 5d2157651..c895c3a8d 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -943,6 +943,7 @@ class TestFileJpeg:
                 ):
                     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 19462dcb5..eb2c8a5f1 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -683,6 +683,7 @@ class TestFilePng:
                 ):
                     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 8821fb46a..56b9148d1 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -759,6 +759,7 @@ class TestFileTiff:
                 ):
                     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 875941240..c3df4ad7b 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 742d0dfe4..042c0dccb 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -897,6 +897,10 @@ class TestImage:
                     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 0d9b4d93d..767c833b3 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 9f46cc1e9..4ef914f64 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 958b95e3b..7d54b124b 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1439,7 +1439,14 @@ class Image:
             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 @@ class Image:
         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 33db8fa50..48bde39fe 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 909911dfe..be6b6959a 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 @@ class JpegImageFile(ImageFile.ImageFile):
     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 c74cbccf1..14622349b 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -606,6 +606,8 @@ class PngStream(ChunkStream):
                     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 @@ class PngImageFile(ImageFile.ImageFile):
 
         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 54faa59c5..7ba71b58e 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1192,6 +1192,10 @@ class TiffImageFile(ImageFile.ImageFile):
             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 @@ class TiffImageFile(ImageFile.ImageFile):
         """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 cae124e9f..43e1410c7 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -100,15 +100,6 @@ class WebPImageFile(ImageFile.ImageFile):
             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 472/688] 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 8d39ea9bb..7e257b75c 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 473/688] 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 3fbf3be69..a3376ac92 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 b2fbd3140..3d6099c1c 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 474/688] 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 3150bf4e0..41f33102f 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 475/688] Use @cached_property

---
 src/PIL/GifImagePlugin.py | 37 ++++++++++++++++++-------------------
 1 file changed, 18 insertions(+), 19 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index eede41549..962a92834 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -30,6 +30,7 @@ import math
 import os
 import subprocess
 from enum import IntEnum
+from functools import cached_property
 
 from . import (
     Image,
@@ -112,8 +113,7 @@ class GifImageFile(ImageFile.ImageFile):
 
         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 @@ class GifImageFile(ImageFile.ImageFile):
             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
+    @cached_property
+    def is_animated(self) -> bool:
+        if self._n_frames is not None:
+            return self._n_frames != 1
 
-                    self.seek(current)
-        return self._is_animated
+        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 476/688] 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 cc7cf58f0..75d9d2fc1 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 1575f2d88..285e4b9db 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -379,6 +379,7 @@ class DdsImageFile(ImageFile.ImageFile):
         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 eede41549..151feb17d 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -429,7 +429,7 @@ class GifImageFile(ImageFile.ImageFile):
             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 958b95e3b..7a957e769 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -873,7 +873,7 @@ class Image:
         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 @@ class Image:
                     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 @@ class Image:
             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 @@ class Image:
         # 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 c565c21bb..d2d29bfdf 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 477/688] 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 484a1be8f..91539e0e4 100644
--- a/Tests/test_file_psd.py
+++ b/Tests/test_file_psd.py
@@ -4,7 +4,7 @@ import warnings
 
 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 86c1a6763..edf698bf0 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 @@ class PsdImageFile(ImageFile.ImageFile):
         #
         # 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 @@ class PsdImageFile(ImageFile.ImageFile):
         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 478/688] add mypy task to makefile

---
 Makefile | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Makefile b/Makefile
index 1f9b4a370..94f7565d8 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 479/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index c5df1f8f7..8a531d1e2 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 480/688] 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 57a8fa5a0..6470dbc4c 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 9edc15173..ee265774b 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 481/688] 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 256c581df..ad5f75459 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -160,10 +160,6 @@ class ImageFont:
         .. 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 482/688] 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 c74cbccf1..31706cef9 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 483/688] 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 31706cef9..0d5751962 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1050,22 +1050,22 @@ class PngImageFile(ImageFile.ImageFile):
 # 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 484/688] 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 4ccfacae7..6987adc88 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 42f2ee8c7..4b42b32d0 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -181,6 +181,15 @@ class ImageDraw:
         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 485/688] [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 4b42b32d0..03f2637ae 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -184,7 +184,7 @@ class ImageDraw:
     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 486/688] 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 3b1c14b4e..acbaecab2 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -9,51 +9,54 @@ from PIL import Image, ImageDraw, ImageFont, _util, features
 
 from .helper import assert_image_equal_tofile
 
-original_core = ImageFont.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 setup_module() -> None:
-    if features.check_module("freetype2"):
-        ImageFont.core = _util.DeferredError(ImportError)
-
-
-def teardown_module() -> None:
-    ImageFont.core = original_core
-
-
-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 6edf4b05c..edbdd9a32 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 ad5f75459..87ff8315e 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 @@ AAAAAAQAAAADa3tfFAAAAANAan9kAAAAA4QodoQ==
             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 487/688] 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 19462dcb5..55db5ef85 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -655,11 +655,12 @@ class TestFilePng:
             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 0d5751962..6b6c01d1b 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1104,7 +1104,7 @@ class _fdat:
         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 488/688] 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 6987adc88..51d5965db 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 489/688] 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 03f2637ae..b270cc6ba 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -183,12 +183,8 @@ class ImageDraw:
 
     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 490/688] 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 41f33102f..3c4258801 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 491/688] 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 51d5965db..ed762c8d6 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 492/688] [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 ed762c8d6..4996acf71 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 493/688] 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 4996acf71..c4ce76cc0 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 494/688] 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 b270cc6ba..17c176430 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -181,7 +181,9 @@ class ImageDraw:
         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 495/688] 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 c4ce76cc0..1404869ca 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 3c4258801..e0d695a8b 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 496/688] 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 0a699e2ab..69d09e03d 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -2,6 +2,7 @@ from __future__ import annotations
 
 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 497/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 8a531d1e2..dc4016d76 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 498/688] 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 5fd4fe332..fe337c09f 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 @@ class PillowLeakTestCase:
         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 6a9337fa5..ba931f864 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 test_write_animation_RGB(tmp_path: Path) -> 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 bf629fa79..8d2029c21 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 ddcae80d6..c9dba2943 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -202,6 +202,8 @@ class TestImageFile:
 
 
 class MockPyDecoder(ImageFile.PyDecoder):
+    last: MockPyDecoder
+
     def __init__(self, mode: str, *args: Any) -> None:
         MockPyDecoder.last = self
 
@@ -213,6 +215,8 @@ class MockPyDecoder(ImageFile.PyDecoder):
 
 
 class MockPyEncoder(ImageFile.PyEncoder):
+    last: MockPyEncoder | None
+
     def __init__(self, mode: str, *args: Any) -> None:
         MockPyEncoder.last = self
 
@@ -315,6 +319,7 @@ class TestPyEncoder(CodecsTest):
             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 @@ class TestPyEncoder(CodecsTest):
         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 05b5d4716..4398f8a30 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -34,7 +34,9 @@ pytestmark = skip_unless_feature("freetype2")
 
 
 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_find_font(
             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 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 499/688] 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 58d0213e8..90eb8713a 100644
--- a/Tests/oss-fuzz/test_fuzzers.py
+++ b/Tests/oss-fuzz/test_fuzzers.py
@@ -12,8 +12,9 @@ from Tests.helper import skip_unless_feature
 
 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 2d402ca91..59fb49809 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 5d2157651..f24faecaa 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -70,7 +70,9 @@ class TestFileJpeg:
 
     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 a7cae563a..5a208739f 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 11883ad24..6c13999a5 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -52,7 +52,9 @@ class LibTiffTestCase:
 
 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 19462dcb5..c7c9f6fab 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -85,9 +85,9 @@ class TestFilePng:
 
     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 249846da4..e2de84c71 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -49,7 +49,9 @@ class TestFileWebp:
     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 e1aa6252b..2daaf5c3c 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 fcf671daa..f6609a1a0 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 c15907a55..104c620de 100644
--- a/Tests/test_imageops_usm.py
+++ b/Tests/test_imageops_usm.py
@@ -4,11 +4,11 @@ from typing import Generator
 
 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 500/688] 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 08a0e7431..3fb92a62e 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 742d0dfe4..c7694a0ef 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -99,10 +99,18 @@ class TestImage:
         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 @@ class TestImage:
 
     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 @@ class TestImage:
     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 8d2029c21..082eb8162 100644
--- a/Tests/test_imagecms.py
+++ b/Tests/test_imagecms.py
@@ -7,7 +7,7 @@ import shutil
 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 test_extended_information() -> None:
                 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 b1c1306c1..0dfbc5a2a 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 501/688] 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 48c70db8a..4e790926b 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 f24faecaa..33f9ce00e 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -154,7 +154,7 @@ class TestFileJpeg:
             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 @@ class TestFileJpeg:
         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 6c13999a5..22bcd2856 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -668,7 +668,8 @@ class TestFileLibTiff(LibTiffTestCase):
             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 c7694a0ef..d6a739c79 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -25,6 +25,7 @@ from PIL import (
 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 @@ class TestImage:
         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 342bd8654..d7e6c562c 100644
--- a/Tests/test_image_array.py
+++ b/Tests/test_image_array.py
@@ -86,8 +86,8 @@ def test_fromarray() -> None:
     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 d095364ba..07fec2e64 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 test_wide_crop() -> None:
 
     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 47f9ffa3d..1f0644471 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 a5b974459..de5956f3e 100644
--- a/Tests/test_image_getextrema.py
+++ b/Tests/test_image_getextrema.py
@@ -6,7 +6,7 @@ from .helper import hopper
 
 
 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 082eb8162..55f72c3b9 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 assert_aux_channel_preserved(
     )
 
     # 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 69d09e03d..c221fe008 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 502/688] 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 5f5c5df54..5915cc944 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 503/688] 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 5915cc944..ec9471f84 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 504/688] 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 ec9471f84..19a79facc 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 f704047be..2abd6d0f7 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 505/688] 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 c02c7d6b6..2ea26877d 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 @@ class Image:
         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 @@ class Image:
 
     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 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
 
         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 @@ class Image:
                 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 @@ class Image:
         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 @@ class ImageTransformHandler:
         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 1887a3933..0663d9ddf 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -456,14 +456,12 @@ class ImageDraw:
                 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 @@ class ImageDraw:
         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 @@ class ImageDraw:
     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 @@ class ImageDraw:
     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 747c0c050..a9925483e 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -33,11 +33,11 @@ import sys
 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 @@ except ImportError as ex:
     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 @@ class ImageFont:
             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 @@ class ImageFont:
         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 @@ class ImageFont:
         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 @@ class FreeTypeFont:
     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 @@ class FreeTypeFont:
 
     def getmask2(
         self,
-        text,
+        text: str,
         mode="",
         direction=None,
         features=None,
@@ -641,7 +643,7 @@ class FreeTypeFont:
             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 @@ class FreeTypeFont:
             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 @@ class TransposedFont:
             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 909911dfe..e1c61f991 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -425,7 +425,7 @@ class JpegImageFile(ImageFile.ImageFile):
         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 d85eb84fa..1fe954417 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 987e7fd6f..b023efe01 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 506/688] 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 958b95e3b..dd6984020 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1511,7 +1511,7 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
         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 17c176430..8fe179dd5 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 a9da90613..fe12cb641 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -22,6 +22,7 @@ from __future__ import annotations
 
 import logging
 import sys
+from typing import TYPE_CHECKING
 
 from ._deprecate import deprecate
 
@@ -48,9 +49,12 @@ except ImportError as ex:
 
 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 @@ class PyAccess:
         """
         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 @@ class PyAccess:
 
         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 @@ class PyAccess:
     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 @@ class _PyAccessI32_Swap(PyAccess):
         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 @@ else:
     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 507/688] [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 e848eb670..6a76e8c00 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 508/688] 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 1b393a3ff..e95850212 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 0d5751962..dde45e587 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1105,7 +1105,7 @@ class _fdat:
 
 
 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 509/688] 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 782e28cf5..2db115ccc 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -35,6 +35,7 @@ import os
 import struct
 from enum import IntEnum
 from io import BytesIO
+from typing import IO
 
 from . import Image, ImageFile
 
@@ -448,7 +449,7 @@ class BLPEncoder(ImageFile.PyEncoder):
         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 5a44baa49..d24a2ba80 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -228,7 +228,7 @@ class EpsImageFile(ImageFile.ImageFile):
         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 4ba93bb39..b3e6c6e36 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -70,7 +70,7 @@ class FpxImageFile(ImageFile.ImageFile):
 
         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 @@ class FpxImageFile(ImageFile.ImageFile):
         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 @@ class FpxImageFile(ImageFile.ImageFile):
 
         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 93a50d2a2..d7e99a968 100644
--- a/src/PIL/ImageEnhance.py
+++ b/src/PIL/ImageEnhance.py
@@ -23,7 +23,10 @@ from . import Image, ImageFilter, ImageStat
 
 
 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 43e700b7b..02288e135 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -18,7 +18,8 @@ from __future__ import annotations
 
 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 @@ class Color3DLUT(MultibandFilter):
         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 @@ class Color3DLUT(MultibandFilter):
         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 6ee8c4f25..6a43983d3 100644
--- a/src/PIL/ImageMorph.py
+++ b/src/PIL/ImageMorph.py
@@ -200,7 +200,7 @@ class MorphOp:
         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 @@ class MorphOp:
         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 @@ class MorphOp:
             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 ce6342bdb..e6395b1cb 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -34,7 +34,7 @@ class BoxReader:
         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 @@ class BoxReader:
         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 @@ class BoxReader:
         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 dc3175402..eaed5367c 100644
--- a/src/PIL/PaletteFile.py
+++ b/src/PIL/PaletteFile.py
@@ -48,5 +48,5 @@ class PaletteFile:
 
         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 cea8b60da..f2cf06d0d 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -38,7 +38,7 @@ class QoiImageFile(ImageFile.ImageFile):
 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 5b8ad47f0..e5242395f 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 ff7402dca..463d6a623 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -117,7 +117,7 @@ class WebPImageFile(ImageFile.ImageFile):
         # 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 510/688] 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 c5d1cd40d..2df1d8d33 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 @@ SAVE = {
 }
 
 
-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 826e89daf..6f52204b8 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 @@ class BufrStubImageFile(ImageFile.StubImageFile):
         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 1575f2d88..a3efadb03 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -16,6 +16,7 @@ import io
 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 @@ class DdsRgbDecoder(ImageFile.PyDecoder):
         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 962a92834..e62852db3 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -31,6 +31,7 @@ import os
 import subprocess
 from enum import IntEnum
 from functools import cached_property
+from typing import IO
 
 from . import (
     Image,
@@ -336,14 +337,13 @@ class GifImageFile(ImageFile.ImageFile):
                         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 c27cffab6..b24dcded2 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 @@ class GribStubImageFile(ImageFile.StubImageFile):
         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 cea093f9c..af94e5a2e 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -25,6 +25,7 @@ from __future__ import annotations
 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 @@ from ._binary import o32le as o32
 _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 @@ class IcoFile:
         """
         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 @@ class IcoFile:
         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 8e949ebaf..c98cfb098 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -28,6 +28,7 @@ from __future__ import annotations
 
 import os
 import re
+from typing import IO, Any
 
 from . import Image, ImageFile, ImagePalette
 
@@ -103,7 +104,7 @@ for j in range(2, 33):
 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 @@ SAVE = {
 }
 
 
-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 6385f204b..8cb4b7e32 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2875,7 +2875,7 @@ class 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 766e1290c..6716722f2 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -22,6 +22,7 @@ from __future__ import annotations
 import itertools
 import os
 import struct
+from typing import IO
 
 from . import (
     Image,
@@ -32,7 +33,7 @@ from . import (
 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 1777f1f20..ccd28f343 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -25,6 +25,7 @@ import io
 import math
 import os
 import time
+from typing import IO
 
 from . import Image, ImageFile, ImageSequence, PdfParser, __version__, features
 
@@ -39,7 +40,7 @@ from . import Image, ImageFile, ImageSequence, PdfParser, __version__, features
 #  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 e5242395f..98dd91c0e 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,7 +37,7 @@ from __future__ import annotations
 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 f3fa3c24c..04f36744b 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1995,7 +1995,7 @@ class AppendingTiffWriter:
         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 @@ class AppendingTiffWriter:
             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 fab3e26c5..25a4545db 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 @@ class WmfStubImageFile(ImageFile.StubImageFile):
         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 511/688] 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 d2a08c07b..c7d105836 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 59fb49809..de418115e 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 c7c9b24e7..2ff4160bd 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 3dd24533a..939e82e77 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 096a5b88b..86a9064fc 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -5,7 +5,7 @@ from typing import IO
 
 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 f871e2eff..ee1544c51 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 33f9ce00e..18dc752d8 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -171,7 +171,7 @@ class TestFileJpeg:
         [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 e2de84c71..1caf032f6 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -198,7 +198,9 @@ class TestFileWebp:
         (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 ba931f864..882dccb32 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 b43e3f296..79e707263 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 9d6006679..8abb1f69f 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -259,6 +259,7 @@ class TestCffi(AccessTest):
         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 @@ class TestCffi(AccessTest):
         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 @@ class TestCffi(AccessTest):
         # 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 @@ class TestCffi(AccessTest):
             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 c10c96da6..252a15db7 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 2ca1d2cfc..1593eaaf7 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 104c620de..dbdd5b317 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 3cd323553..28f66891c 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 6f52204b8..7388a2b8a 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -17,7 +17,7 @@ from . import Image, ImageFile
 _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 b24dcded2..d3655f4dd 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -17,7 +17,7 @@ from . import Image, ImageFile
 _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 c8d7866a3..b789c215f 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -17,7 +17,7 @@ from . import Image, ImageFile
 _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 25a4545db..a68f705a0 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -30,7 +30,7 @@ from ._binary import si32le as _long
 _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 512/688] 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 6495e5866..8f13f1aea 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 513/688] 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 22bcd2856..20c0bae92 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -685,13 +685,18 @@ class TestFileLibTiff(LibTiffTestCase):
             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 04f36744b..ab5934816 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 514/688] 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 0d6da7754..7ec1eaa82 100644
--- a/winbuild/build_prepare.py
+++ b/winbuild/build_prepare.py
@@ -112,7 +112,7 @@ ARCHITECTURES = {
 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 515/688] 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 c221fe008..505bba80c 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 a018225b2..dc67cb41d 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 516/688] 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 2ea26877d..d9eb73e45 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1719,7 +1719,7 @@ class Image:
 
     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 517/688] 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 c10c96da6..252a15db7 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 5094dbf3f..7da1078c1 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 d917a3c92..1c095a114 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 d9eb73e45..13d374345 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2303,8 +2303,8 @@ class Image:
     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 @@ class Image:
 
     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 @@ class ImageTransformHandler:
         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 0663d9ddf..9796189bb 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -95,7 +95,9 @@ class ImageDraw:
     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 @@ class ImageDraw:
 
     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 a9925483e..87261f519 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -361,7 +361,7 @@ class FreeTypeFont:
         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 b023efe01..6e0ddd2f1 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 518/688] 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 611d6960d..f61acc1d3 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2883,7 +2883,7 @@ class Image:
         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 c565c21bb..f398c6c7c 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 519/688] 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 611d6960d..1e46c4ee4 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2305,7 +2305,7 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
             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 520/688] 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 5fb80b753..9a15a8eb7 100644
--- a/src/PIL/ImageColor.py
+++ b/src/PIL/ImageColor.py
@@ -25,7 +25,7 @@ from . import Image
 
 
 @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 521/688] Added type hints

---
 src/PIL/GifImagePlugin.py    | 15 +++++++++----
 src/PIL/GimpGradientFile.py  | 41 ++++++++++++++++++++++++++++--------
 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, 60 insertions(+), 27 deletions(-)

diff --git a/src/PIL/GifImagePlugin.py b/src/PIL/GifImagePlugin.py
index e62852db3..f41bc2b32 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 2d8c78ea9..92068b904 100644
--- a/src/PIL/GimpGradientFile.py
+++ b/src/PIL/GimpGradientFile.py
@@ -21,6 +21,7 @@ See the GIMP distribution for more information.)
 from __future__ import annotations
 
 from math import log, pi, sin, sqrt
+from typing import IO, Callable
 
 from ._binary import o8
 
@@ -28,7 +29,7 @@ EPSILON = 1e-10
 """"""  # 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 @@ SEGMENTS = [linear, curved, sine, sphere_increasing, sphere_decreasing]
 
 
 class GradientFile:
-    gradient = None
+    gradient: (
+        list[
+            tuple[
+                float,
+                float,
+                float,
+                list[float],
+                list[float],
+                Callable[[float, float], float],
+            ]
+        ]
+        | None
+    ) = None
 
-    def getpalette(self, entries=256):
+    def getpalette(self, entries: int = 256) -> tuple[bytes, str]:
+        assert self.gradient is not None
         palette = []
 
         ix = 0
@@ -101,7 +115,7 @@ class GradientFile:
 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 @@ class GimpGradientFile(GradientFile):
 
         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 f61acc1d3..f6ffac8a7 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2470,7 +2470,7 @@ class Image:
 
         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 35ee5834e..b42f5d9ea 100644
--- a/src/PIL/ImageDraw2.py
+++ b/src/PIL/ImageDraw2.py
@@ -30,7 +30,7 @@ from . import Image, ImageColor, ImageDraw, ImageFont, ImagePath
 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 @@ class Pen:
 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 @@ class Draw:
         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 6e2e7db1e..90defdbbc 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -37,7 +37,7 @@ from . import Image
 _pilbitmap_ok = None
 
 
-def _pilbitmap_check():
+def _pilbitmap_check() -> int:
     global _pilbitmap_ok
     if _pilbitmap_ok is None:
         try:
@@ -162,7 +162,7 @@ class PhotoImage:
         """
         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 @@ class BitmapImage:
         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 e6395b1cb..5a0ef0d01 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,6 +18,7 @@ from __future__ import annotations
 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 eaed5367c..81652e5ee 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 @@ class PaletteFile:
                 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 04f36744b..0b9601755 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -50,7 +50,7 @@ import warnings
 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 @@ class AppendingTiffWriter:
                 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 522/688] 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 9c21efa45..c140156f9 100644
--- a/Tests/test_decompression_bomb.py
+++ b/Tests/test_decompression_bomb.py
@@ -12,7 +12,7 @@ ORIGINAL_LIMIT = Image.MAX_IMAGE_PIXELS
 
 
 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 18dc752d8..8e4d694c1 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -443,7 +443,9 @@ class TestFileJpeg:
         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 @@ class TestFileJpeg:
         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 8821fb46a..06591a29a 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -113,7 +113,7 @@ class TestFileTiff:
             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 8e94aafc5..20d3a160e 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 2daaf5c3c..2d461d985 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 f6609a1a0..6771b46b0 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 1593eaaf7..1606d8939 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -16,7 +16,7 @@ from .helper import (
 
 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 c221fe008..51543d785 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 4398f8a30..73cad513e 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 d6bdaf450..27a6090c5 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 f59ee7284..e6c312a0c 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -70,7 +70,7 @@ if is_win32():
     ]
     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 e9e12b24a..2582dbee3 100644
--- a/Tests/test_main.py
+++ b/Tests/test_main.py
@@ -11,7 +11,7 @@ import pytest
     "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 523/688] 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 1606d8939..bdbf09c40 100644
--- a/Tests/test_image_thumbnail.py
+++ b/Tests/test_image_thumbnail.py
@@ -16,7 +16,7 @@ from .helper import (
 
 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 524/688] 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 92068b904..220eac57e 100644
--- a/src/PIL/GimpGradientFile.py
+++ b/src/PIL/GimpGradientFile.py
@@ -128,16 +128,7 @@ class GimpGradientFile(GradientFile):
 
         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 @@ class GimpGradientFile(GradientFile):
                 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 525/688] 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 c221fe008..61d7b5c6a 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 b2cd968fe..8a03d858c 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 e0d695a8b..8c49e0842 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 73ed3d4a9..ec15b535f 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -37,6 +37,7 @@ import struct
 from typing import TYPE_CHECKING, AnyStr, Sequence, cast
 
 from . import Image, ImageColor
+from ._deprecate import deprecate
 from ._typing import Coords
 
 """
@@ -902,26 +903,17 @@ except AttributeError:
 
 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 526/688] 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 2db115ccc..003fa9b24 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -31,6 +31,7 @@ BLP files come in many different flavours:
 
 from __future__ import annotations
 
+import abc
 import os
 import struct
 from enum import IntEnum
@@ -276,7 +277,7 @@ class BlpImageFile(ImageFile.ImageFile):
 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 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
             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 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
             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 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
             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 @@ class BLPEncoder(ImageFile.PyEncoder):
             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 @@ class BLPEncoder(ImageFile.PyEncoder):
         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 2df1d8d33..45c1ea941 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -395,12 +395,12 @@ SAVE = {
 }
 
 
-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 7388a2b8a..0ee2f653b 100644
--- a/src/PIL/BufrStubImagePlugin.py
+++ b/src/PIL/BufrStubImagePlugin.py
@@ -60,7 +60,7 @@ class BufrStubImageFile(ImageFile.StubImageFile):
         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 a3efadb03..861a1eca0 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -511,7 +511,7 @@ class DdsRgbDecoder(ImageFile.PyDecoder):
         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 f41bc2b32..a540595b8 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 d3655f4dd..e9aa084b2 100644
--- a/src/PIL/GribStubImagePlugin.py
+++ b/src/PIL/GribStubImagePlugin.py
@@ -60,7 +60,7 @@ class GribStubImageFile(ImageFile.StubImageFile):
         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 b789c215f..cc9e73deb 100644
--- a/src/PIL/Hdf5StubImagePlugin.py
+++ b/src/PIL/Hdf5StubImagePlugin.py
@@ -60,7 +60,7 @@ class HDF5StubImageFile(ImageFile.StubImageFile):
         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 0a86ba883..2a89d498c 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -22,6 +22,7 @@ import io
 import os
 import struct
 import sys
+from typing import IO
 
 from . import Image, ImageFile, PngImagePlugin, features
 
@@ -312,7 +313,7 @@ class IcnsImageFile(ImageFile.ImageFile):
         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 af94e5a2e..227fcf35c 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -40,7 +40,7 @@ from ._binary import o32le as o32
 _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 c98cfb098..015c2febe 100644
--- a/src/PIL/ImImagePlugin.py
+++ b/src/PIL/ImImagePlugin.py
@@ -326,7 +326,7 @@ SAVE = {
 }
 
 
-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 f6ffac8a7..af1748610 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -626,7 +626,7 @@ class Image:
             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 @@ class Image:
 
         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 @@ class ImageTransformHandler:
 # 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 73ed3d4a9..01f99c119 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -219,7 +219,9 @@ class ImageDraw:
                         # 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 _compute_regular_polygon_vertices(
     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 f0e492387..6bef681e9 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 5a0ef0d01..72c2cb85e 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 4d0b75e77..0c8a67888 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -42,7 +42,7 @@ import subprocess
 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 _save(im, fp, filename):
     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 6716722f2..152e19e23 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -33,7 +33,7 @@ from . import (
 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 65cc70624..0a75c868b 100644
--- a/src/PIL/MspImagePlugin.py
+++ b/src/PIL/MspImagePlugin.py
@@ -164,7 +164,7 @@ Image.register_decoder("MSP", MspDecoder)
 # 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 026bfd9a0..dd42003b5 100644
--- a/src/PIL/PcxImagePlugin.py
+++ b/src/PIL/PcxImagePlugin.py
@@ -144,7 +144,7 @@ SAVE = {
 }
 
 
-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 ccd28f343..f0da1e047 100644
--- a/src/PIL/PdfImagePlugin.py
+++ b/src/PIL/PdfImagePlugin.py
@@ -40,7 +40,7 @@ from . import Image, ImageFile, ImageSequence, PdfParser, __version__, features
 #  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 a6c24e671..52e835801 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 @@ class IndirectReference(IndirectReferenceTuple):
     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 76ffdef3f..9aaadb47d 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 94bf430b8..16c9ccbba 100644
--- a/src/PIL/PpmImagePlugin.py
+++ b/src/PIL/PpmImagePlugin.py
@@ -328,7 +328,7 @@ class PpmDecoder(ImageFile.PyDecoder):
 # --------------------------------------------------------------------
 
 
-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 f2cf06d0d..202ef52d0 100644
--- a/src/PIL/QoiImagePlugin.py
+++ b/src/PIL/QoiImagePlugin.py
@@ -37,6 +37,8 @@ class QoiImageFile(ImageFile.ImageFile):
 
 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 @@ class QoiDecoder(ImageFile.PyDecoder):
         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 @@ class QoiDecoder(ImageFile.PyDecoder):
         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 @@ class QoiDecoder(ImageFile.PyDecoder):
                     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 @@ class QoiDecoder(ImageFile.PyDecoder):
                             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 @@ class QoiDecoder(ImageFile.PyDecoder):
                         )
                     )
                     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 7bd84ebd4..50d979109 100644
--- a/src/PIL/SgiImagePlugin.py
+++ b/src/PIL/SgiImagePlugin.py
@@ -125,7 +125,7 @@ class SgiImageFile(ImageFile.ImageFile):
             ]
 
 
-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 98dd91c0e..a6cc00019 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 401a83f9f..f16f075df 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -178,7 +178,7 @@ SAVE = {
 }
 
 
-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 0b9601755..08ee506b1 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -387,7 +387,7 @@ class IFDRational(Rational):
     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 @@ class AppendingTiffWriter:
                 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 463d6a623..97debc2ed 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 @@ class WebPImageFile(ImageFile.ImageFile):
         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 a68f705a0..3d5cddcc8 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -163,7 +163,7 @@ class WmfStubImageFile(ImageFile.StubImageFile):
         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 eee727436..6d11bbfcf 100644
--- a/src/PIL/XbmImagePlugin.py
+++ b/src/PIL/XbmImagePlugin.py
@@ -70,7 +70,7 @@ class XbmImageFile(ImageFile.ImageFile):
         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 527/688] 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 8a03d858c..627672e1f 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 8c49e0842..44727efd4 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 528/688] 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 ec15b535f..23d7e6973 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 529/688] 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 de418115e..b7eefa09a 100644
--- a/Tests/test_features.py
+++ b/Tests/test_features.py
@@ -38,7 +38,9 @@ def test_version() -> 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 530/688] 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 18dc752d8..342c9e47b 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -870,7 +870,7 @@ class TestFileJpeg:
 
     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 4d0b75e77..a9a89e58b 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 @@ class JpegImageFile(ImageFile.ImageFile):
                 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 @@ class JpegImageFile(ImageFile.ImageFile):
     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 531/688] Added type hints

---
 Tests/test_file_gif.py    |   9 +-
 src/PIL/GifImagePlugin.py | 204 +++++++++++++++++++++++---------------
 src/PIL/Image.py          |  20 ++--
 src/PIL/ImageOps.py       |   2 +-
 src/PIL/ImagePalette.py   |  13 ++-
 5 files changed, 153 insertions(+), 95 deletions(-)

diff --git a/Tests/test_file_gif.py b/Tests/test_file_gif.py
index 4e790926b..e19c88a47 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 a540595b8..a305e8de6 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -29,9 +29,10 @@ import itertools
 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 i16le as i16
 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 @@ class GifImageFile(ImageFile.ImageFile):
         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 @@ class GifImageFile(ImageFile.ImageFile):
                 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 @@ class GifImageFile(ImageFile.ImageFile):
             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 @@ class GifImageFile(ImageFile.ImageFile):
                 #
                 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 @@ class GifImageFile(ImageFile.ImageFile):
                         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 @@ class GifImageFile(ImageFile.ImageFile):
             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
+        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
-                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:
                     # 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 af1748610..bdd869ccc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -41,7 +41,7 @@ import warnings
 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 @@ class Image:
         """
         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 33db8fa50..cbe189cc9 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 057ccd1d7..1ff05a3ef 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 @@ class ImagePalette:
                 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 @@ class ImagePalette:
                 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 532/688] 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 22bcd2856..fe9d017c0 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 533/688] 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 7e257b75c..bf1d1315b 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 534/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index dc4016d76..d7231ebea 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 535/688] 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 003fa9b24..59246c6e2 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 45c1ea941..ef2045337 100644
--- a/src/PIL/BmpImagePlugin.py
+++ b/src/PIL/BmpImagePlugin.py
@@ -301,7 +301,8 @@ class BmpImageFile(ImageFile.ImageFile):
 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 861a1eca0..e74727007 100644
--- a/src/PIL/DdsImagePlugin.py
+++ b/src/PIL/DdsImagePlugin.py
@@ -480,7 +480,8 @@ class DdsImageFile(ImageFile.ImageFile):
 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 d24a2ba80..380b1cf0e 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -27,6 +27,7 @@ import re
 import subprocess
 import sys
 import tempfile
+from typing import IO
 
 from . import Image, ImageFile
 from ._binary import i32le as i32
@@ -236,7 +237,7 @@ class EpsImageFile(ImageFile.ImageFile):
                 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 @@ class EpsImageFile(ImageFile.ImageFile):
                 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 @@ class EpsImageFile(ImageFile.ImageFile):
 # --------------------------------------------------------------------
 
 
-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 071918925..a169b6083 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -122,7 +122,7 @@ class FitsImageFile(ImageFile.ImageFile):
 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 b3e6c6e36..c1927bd26 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -241,7 +241,7 @@ class FpxImageFile(ImageFile.ImageFile):
         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 6bef681e9..5d67409ea 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -487,7 +487,7 @@ class Parser:
     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 72c2cb85e..60f3bff0a 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,7 +18,7 @@ from __future__ import annotations
 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 @@ class BoxReader:
             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 @@ class BoxReader:
         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 5aef94dfb..ed2ea2849 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -93,7 +93,7 @@ class MicImageFile(TiffImagePlugin.TiffImageFile):
         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 152e19e23..f21570661 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 4e2b9788e..673eae1d1 100644
--- a/src/PIL/PSDraw.py
+++ b/src/PIL/PSDraw.py
@@ -138,7 +138,7 @@ class PSDraw:
             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 85f9fe1bf..fc83918b5 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 @@ _Palm8BitColormapValues = (
 
 
 # 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 @@ _COMPRESSION_TYPES = {"none": 0xFF, "rle": 0x01, "scanline": 0x00}
 # (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 52e835801..9e2231347 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -404,9 +404,8 @@ class PdfParser:
     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 9aaadb47d..ba9598065 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -178,7 +178,7 @@ class ChunkStream:
     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 7470663b4..cba26d4b0 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 @@ class TarIO(ContainerIO.ContainerIO[bytes]):
     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 08ee506b1..702d8f33b 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -717,7 +717,7 @@ class ImageFileDirectory_v2(_IFDv2Base):
             # 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 @@ class TiffImageFile(ImageFile.ImageFile):
 
         super().__init__(fp, filename)
 
-    def _open(self):
+    def _open(self) -> None:
         """Open the first image in a TIFF file"""
 
         # Header
@@ -1123,8 +1123,8 @@ class TiffImageFile(ImageFile.ImageFile):
         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 @@ class AppendingTiffWriter:
     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 @@ class AppendingTiffWriter:
     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 @@ class AppendingTiffWriter:
             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 536/688] 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 fa5608e6c..163bb7006 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -837,12 +837,19 @@ def truetype(
             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 537/688] 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 4398f8a30..3cba726d6 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -564,6 +564,7 @@ def test_find_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 538/688] 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 e3eda4fe9..bc1416c74 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 e74fab9fb..41a3eb0cb 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,12 +34,16 @@ from __future__ import annotations
 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 @@ class ImageDraw:
             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 @@ class ImageDraw:
         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 @@ except AttributeError:
     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 1ff05a3ef..6473c4577 100644
--- a/src/PIL/ImagePalette.py
+++ b/src/PIL/ImagePalette.py
@@ -54,7 +54,7 @@ class ImagePalette:
         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 @@ class ImagePalette:
         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 @@ class ImagePalette:
     # 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 ed2ea2849..07239887f 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -63,7 +63,7 @@ class MicImageFile(TiffImagePlugin.TiffImageFile):
             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 @@ class MicImageFile(TiffImagePlugin.TiffImageFile):
 
         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 ba9598065..927d6c0cf 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,7 +39,7 @@ import struct
 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 o8
 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 @@ class PngInfo:
 
         """
 
-        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 @@ class PngInfo:
         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 @@ class PngInfo:
 
         """
         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 @@ class PngStream(ChunkStream):
             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 @@ class PngStream(ChunkStream):
         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 @@ class PngImageFile(ImageFile.ImageFile):
                 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 @@ class PngImageFile(ImageFile.ImageFile):
         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 @@ class PngImageFile(ImageFile.ImageFile):
             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 702d8f33b..833e12d2b 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -50,7 +50,7 @@ import warnings
 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 @@ class IFDRational(Rational):
     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 @@ class ImageFileDirectory_v2(_IFDv2Base):
             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 @@ class ImageFileDirectory_v2(_IFDv2Base):
     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 @@ class AppendingTiffWriter:
             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 @@ class AppendingTiffWriter:
                 # 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 1fe954417..b233eb34d 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 16c749f14..13908c4eb 100644
--- a/src/PIL/features.py
+++ b/src/PIL/features.py
@@ -4,6 +4,7 @@ import collections
 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 539/688] 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 55f72c3b9..dbbd46dcf 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 627672e1f..e6566eae2 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 44727efd4..96300c008 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 19a79facc..ec10230f1 100644
--- a/src/PIL/ImageCms.py
+++ b/src/PIL/ImageCms.py
@@ -299,6 +299,31 @@ class ImageCmsTransform(Image.ImagePointHandler):
         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 2b9612db7..590e1b983 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 540/688] Use latest Ubuntu

---
 .readthedocs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index b83ba05b1..def6282dd 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 541/688] 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 163bb7006..235a76325 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 542/688] 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 44727efd4..0a54cc7a3 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 543/688] 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 da61ef4dd..5416524c0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1933,8 +1933,7 @@ class Image:
         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 544/688] 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 5416524c0..faf70b718 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2074,9 +2074,8 @@ class Image:
             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 f16e95544..96a28bb35 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 cc8e2e359..5663a7e48 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -107,9 +107,8 @@ class PyAccess:
             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 545/688] 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 76ea48510..6dee3fe23 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1128,7 +1128,10 @@ class Image:
                 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 @@ class Image:
         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 546/688] 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 6dee3fe23..9c60bbb7a 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1676,7 +1676,7 @@ class Image:
         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 @@ class Image:
         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 5663a7e48..d41f00aea 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -77,7 +77,11 @@ class PyAccess:
     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 @@ class PyAccess:
 
         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 547/688] [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 9c60bbb7a..5619915ea 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -48,7 +48,6 @@ from typing import (
     Literal,
     Protocol,
     Sequence,
-    SupportsInt,
     Tuple,
     cast,
 )

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 548/688] 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 0a54cc7a3..36c2758f9 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 549/688] 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 36c2758f9..00506a094 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 550/688] 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 00506a094..1678b460c 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 551/688] 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 d41f00aea..3be1ccace 100644
--- a/src/PIL/PyAccess.py
+++ b/src/PIL/PyAccess.py
@@ -148,7 +148,9 @@ class PyAccess:
     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 552/688] Corrected Ghostscript path

---
 .appveyor.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.appveyor.yml b/.appveyor.yml
index 92a04a021..6ce5200b6 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 553/688] 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 28124d7f7..f8f191d38 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 554/688] 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 4398f8a30..4ca882aab 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 fa5608e6c..ac85f48be 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -279,7 +279,7 @@ class FreeTypeFont:
         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 @@ class FreeTypeFont:
 
     def getbbox(
         self,
-        text: str,
+        text: str | bytes,
         mode: str = "",
         direction: str | None = None,
         features: list[str] | None = None,
@@ -511,7 +511,7 @@ class FreeTypeFont:
 
     def getmask2(
         self,
-        text: str,
+        text: str | bytes,
         mode="",
         direction=None,
         features=None,
@@ -730,7 +730,7 @@ class TransposedFont:
             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 6e0ddd2f1..5e97b40b2 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 e83ddfec1..ba36cc72c 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 555/688] 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 abdd87ea2..0abfaaddc 100644
--- a/setup.py
+++ b/setup.py
@@ -37,7 +37,9 @@ IMAGEQUANT_ROOT = None
 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 @@ class pil_build_ext(build_ext):
             "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 556/688] 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 235a76325..cc00cdfb6 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -848,13 +848,15 @@ def truetype(
                 # 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 557/688] 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 bf1d1315b..0d0f81fbf 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 558/688] 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 3cba726d6..4e6ec86d9 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -564,7 +564,7 @@ def test_find_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 559/688] 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 1678b460c..44727efd4 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 560/688] 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 a169b6083..4846054b1 100644
--- a/src/PIL/FitsImagePlugin.py
+++ b/src/PIL/FitsImagePlugin.py
@@ -115,7 +115,11 @@ class FitsImageFile(ImageFile.ImageFile):
         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 a305e8de6..541d97f8c 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -458,6 +458,8 @@ class GifImageFile(ImageFile.ImageFile):
             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 bdd869ccc..472581127 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 @@ class Image:
         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 @@ class Image:
             )
         )
 
-    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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
         :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 @@ class Image:
             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 @@ class Image:
             ]
         )
 
-    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 @@ class Image:
         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 @@ class Image:
             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 @@ class 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 @@ class 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 @@ class Image:
         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 @@ class Image:
                 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 @@ class Image:
         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 @@ class Image:
         """
 
         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 @@ class Image:
         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 @@ class Image:
                 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 @@ class Image:
             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 60f3bff0a..39eb1c203 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 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
                 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 fc83918b5..1735070f8 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 1fe954417..3467eeb45 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 561/688] 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 8e4d694c1..1459a87eb 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -701,7 +701,7 @@ class TestFileJpeg:
     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 5a208739f..ed7ea4fcf 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 d6a739c79..0d7d03480 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -152,7 +152,7 @@ class TestImage:
 
     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 dad26ef14..5e57e4c4c 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 9f4e6534e..36cdb3682 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 PIL import Image
 
 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 2a072fd44..dd4fc46c3 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 @@ class TestShellInjection:
         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 562/688] 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 d9593c60f..8b55df992 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 41a3eb0cb..91f898838 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -35,15 +35,24 @@ import math
 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 @@ class ImageDraw:
         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 @@ class ImageDraw:
         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 @@ class ImageDraw:
 
                     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 @@ class ImageDraw:
                             ]
                         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 @@ class ImageDraw:
                 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 @@ class ImageDraw:
             # 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 @@ class ImageDraw:
                 )
             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 @@ class ImageDraw:
                 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 _compute_regular_polygon_vertices(
             ),
         )
 
-    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 dda06b5a1..2bfe421e6 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 563/688] 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 026f488d8..1ac3d034b 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 5619915ea..26849707e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -227,7 +227,7 @@ if hasattr(core, "DEFAULT_STRATEGY"):
 # 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 @@ class Image:
             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 1fe954417..1a0184069 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 564/688] 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 c8886a779..00c8995b0 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -354,10 +354,10 @@ class TestColorLut3DCoreAPI:
 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 1f0644471..412ab44c3 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 36cdb3682..32d2cf985 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 @@ TEST_IMAGE_SIZE = (10, 10)
 
 
 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 899e4966f..e4cb17c4d 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 02288e135..e18b4a446 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -19,12 +19,16 @@ from __future__ import annotations
 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 @@ class RankFilter(Filter):
         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 @@ class BoxBlur(MultibandFilter):
             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 @@ class UnsharpMask(MultibandFilter):
         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 @@ class Color3DLUT(MultibandFilter):
                 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 @@ class Color3DLUT(MultibandFilter):
 
             # 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 @@ class Color3DLUT(MultibandFilter):
                             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 @@ class Color3DLUT(MultibandFilter):
         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 @@ class Color3DLUT(MultibandFilter):
             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 @@ class Color3DLUT(MultibandFilter):
         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 @@ class Color3DLUT(MultibandFilter):
             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 @@ class Color3DLUT(MultibandFilter):
             _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 @@ class Color3DLUT(MultibandFilter):
             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 7075e8672..09ece18fa 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -2,7 +2,14 @@ from __future__ import annotations
 
 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 @@ else:
     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 565/688] 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 88ad1f9ee..22cd674ce 100644
--- a/Tests/test_imageqt.py
+++ b/Tests/test_imageqt.py
@@ -41,18 +41,13 @@ def test_rgb() -> 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 293ba4941..7819ae9c1 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 566/688] 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 fe337c09f..605a214d4 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -18,7 +18,7 @@ from typing import Any, Callable, Sequence
 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 @@ class PillowLeakTestCase:
 # 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 02d0b29d8..dbd917517 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -1033,8 +1033,10 @@ class TestFileJpeg:
 
     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 46714a0f0..0f0976802 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -535,8 +535,10 @@ class TestFilePng:
 
     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 @@ class TestFilePng:
     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 TestFilePng:
         # 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 1bfd0434e..0a61830a4 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 @@ def test_save_stdout(buffer: bool) -> None:
     # 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 17dab25e9..08ff334ac 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -120,7 +120,7 @@ class TestFileTiff:
     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 3fb92a62e..ab8a7f9ec 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 35a7a49a8..a8f61d677 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -393,13 +393,13 @@ class TestImage:
 
         # 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 1ce1a7cd8..c9d8c93f3 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 d8f6b65e0..01cb880cb 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -338,3 +338,8 @@ class TestImagingPaste:
 
         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 05f209351..a5d5a15db 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 5e57e4c4c..dad26ef14 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 9b3bdf330..d6055b577 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -445,7 +445,7 @@ class TestCoreResampleBox:
         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 55f72c3b9..8a25460d3 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 assert_aux_channel_preserved(
             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 8b55df992..a24aa16ca 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 3171eb9ae..35fe0cf40 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 c9dba2943..00cdec952 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -381,7 +381,7 @@ class TestPyEncoder(CodecsTest):
     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 73cad513e..9f5c3984b 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 3b1c14b4e..c4a39d1fa 100644
--- a/Tests/test_imagefontpil.py
+++ b/Tests/test_imagefontpil.py
@@ -14,7 +14,7 @@ original_core = ImageFont.core
 
 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 8e2db15aa..17f68710a 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 64dfb2c95..c3afa9089 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 @@ def test_stdout(buffer: bool) -> None:
     # 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 57da58522..6e2f38650 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1168,7 +1168,7 @@ class Image:
     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 @@ class Image:
         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 @@ class Image:
     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 @@ class Image:
         :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 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
             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 91f898838..a471a7ffd 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -62,7 +62,9 @@ directly.
 
 
 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 fa5608e6c..61e7a7abe 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -33,11 +33,12 @@ import sys
 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 @@ class FreeTypeFont:
     ) -> 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 293ba4941..a0c16b765 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -196,7 +196,7 @@ if qt_is_installed:
                 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 80a6116b7..ffd791674 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 7a32f1cde..9d6811cb7 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -428,7 +428,7 @@ class JpegImageFile(ImageFile.ImageFile):
         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 89fad7033..e318c8739 100644
--- a/src/PIL/TiffTags.py
+++ b/src/PIL/TiffTags.py
@@ -89,7 +89,7 @@ DOUBLE = 12
 IFD = 13
 LONG8 = 16
 
-TAGS_V2 = {
+_tags_v2 = {
     254: ("NewSubfileType", LONG, 1),
     255: ("SubfileType", SHORT, 1),
     256: ("ImageWidth", LONG, 1),
@@ -425,9 +425,11 @@ TAGS = {
     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 567/688] 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 380b1cf0e..c7f9625c9 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -230,6 +230,11 @@ class EpsImageFile(ImageFile.ImageFile):
         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 @@ class EpsImageFile(ImageFile.ImageFile):
             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 @@ class EpsImageFile(ImageFile.ImageFile):
                 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 568/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index d7231ebea..ec3073446 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 569/688] 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 939e82e77..77ee5b0ea 100644
--- a/Tests/test_file_bufrstub.py
+++ b/Tests/test_file_bufrstub.py
@@ -64,6 +64,9 @@ def test_handler(tmp_path: Path) -> None:
             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 test_handler(tmp_path: Path) -> 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 86a9064fc..aba473d24 100644
--- a/Tests/test_file_gribstub.py
+++ b/Tests/test_file_gribstub.py
@@ -64,6 +64,9 @@ def test_handler(tmp_path: Path) -> None:
             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 test_handler(tmp_path: Path) -> 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 ee1544c51..8275bd0d8 100644
--- a/Tests/test_file_hdf5stub.py
+++ b/Tests/test_file_hdf5stub.py
@@ -66,6 +66,9 @@ def test_handler(tmp_path: Path) -> None:
             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 test_handler(tmp_path: Path) -> 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 0f0976802..a8b50a6d4 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -775,7 +775,7 @@ class TestFilePng:
 
         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 0a61830a4..d6451ec18 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -373,7 +373,7 @@ def test_save_stdout(buffer: bool) -> None:
 
     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 484a1be8f..ddae8f235 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 8b816aa4f..1e0310001 100644
--- a/Tests/test_file_tiff_metadata.py
+++ b/Tests/test_file_tiff_metadata.py
@@ -11,7 +11,11 @@ from PIL.TiffImagePlugin import IFDRational
 
 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 1caf032f6..cbc905de4 100644
--- a/Tests/test_file_webp.py
+++ b/Tests/test_file_webp.py
@@ -5,6 +5,7 @@ import re
 import sys
 import warnings
 from pathlib import Path
+from typing import Any
 
 import pytest
 
@@ -70,7 +71,9 @@ class TestFileWebp:
             # 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 a8f61d677..5b1ba6289 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,7 +8,7 @@ import sys
 import tempfile
 import warnings
 from pathlib import Path
-from typing import IO
+from typing import IO, Any
 
 import pytest
 
@@ -175,11 +175,19 @@ class TestImage:
     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 d7e6c562c..bb6064882 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 @@ numpy = pytest.importorskip("numpy", reason="NumPy not installed")
 
 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 00cdec952..a269b846a 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -351,7 +351,9 @@ class TestPyEncoder(CodecsTest):
             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 c3906de24..e50198087 100644
--- a/Tests/test_imagefont.py
+++ b/Tests/test_imagefont.py
@@ -548,7 +548,7 @@ def test_find_font(
 
             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 e6c312a0c..c23a5c690 100644
--- a/Tests/test_imagewin_pointers.py
+++ b/Tests/test_imagewin_pointers.py
@@ -45,21 +45,22 @@ if is_win32():
     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 c3afa9089..130ffa863 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -59,7 +59,7 @@ def test_stdout(buffer: bool) -> None:
 
     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 570/688] 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 35fe0cf40..c80aa739c 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 b42f5d9ea..600e140e1 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 571/688] 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 9b82a962a..66c88e9d8 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 a269b846a..68b28ef07 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -209,7 +209,7 @@ class MockPyDecoder(ImageFile.PyDecoder):
 
         super().__init__(mode, *args)
 
-    def decode(self, buffer):
+    def decode(self, buffer: bytes) -> tuple[int, int]:
         # eof
         return -1, 0
 
@@ -222,7 +222,7 @@ class MockPyEncoder(ImageFile.PyEncoder):
 
         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 dbdd5b317..c8e2c0467 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 17f68710a..6cf0079dd 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 59246c6e2..b9cefafdd 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 @@ class BLPEncoder(ImageFile.PyEncoder):
         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 600e140e1..e89a78be4 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 @@ class Brush:
 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 5d67409ea..69e7ee548 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -65,7 +65,7 @@ Dict of known error codes returned from :meth:`.PyDecoder.decode`,
 # 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 @@ class ImageFile(Image.Image):
                 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 @@ class StubImageFile(ImageFile):
         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 @@ class PyCodecState:
         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 @@ class PyCodec:
         """
         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 @@ class PyDecoder(PyCodec):
         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 @@ class PyEncoder(PyCodec):
         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 @@ class PyEncoder(PyCodec):
             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 6473c4577..ed38285dc 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 @@ class ImagePalette:
         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 @@ class 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 @@ class ImagePalette:
 
     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 @@ class ImagePalette:
             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 @@ class ImagePalette:
 # 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 6c29e2590..978c5a9d1 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 a6cc00019..f5a09c3ef 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,12 +37,12 @@ from __future__ import annotations
 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 @@ iforms = [1, 3, -11, -12, -21, -22]
 # 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 @@ class SpiderImageFile(ImageFile.ImageFile):
         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 @@ class SpiderImageFile(ImageFile.ImageFile):
 
 
 # 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 572/688] 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 c7f9625c9..f31b1c1a2 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -231,9 +231,9 @@ class EpsImageFile(ImageFile.ImageFile):
 
         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 573/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index ec3073446..9c731fe94 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 574/688] 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 96a28bb35..aa53abd20 100644
--- a/src/PIL/ImageGrab.py
+++ b/src/PIL/ImageGrab.py
@@ -22,7 +22,6 @@ import shutil
 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 575/688] 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 e23adeb70..5dfa51697 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -89,6 +89,7 @@ $bmp = New-Object Drawing.Bitmap 200, 200
         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 @@ $ms = new-object System.IO.MemoryStream(, $bytes)
         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 @@ $ms = new-object System.IO.MemoryStream(, $bytes)
         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 576/688] 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 aa53abd20..e27ca7e50 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 577/688] 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 ed7ea4fcf..c6f1e0f52 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 578/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 9c731fe94..6375f5c63 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 579/688] 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 c2eac31c7..e9cf7cebc 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1113,7 +1113,7 @@ class Image:
             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 @@ class Image:
             # 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 580/688] 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 f16f075df..ebf9a1b80 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -36,7 +36,7 @@ MODES = {
     (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 581/688] "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 ebf9a1b80..6a6bceaca 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -36,7 +36,7 @@ MODES = {
     (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 @@ class TgaImageFile(ImageFile.ImageFile):
             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 582/688] 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 6a6bceaca..9bc483fc5 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -120,6 +120,7 @@ class TgaImageFile(ImageFile.ImageFile):
                 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 583/688] 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 ff6dab00d..15c7bbdb8 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 9bc483fc5..d158fe492 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -117,9 +117,11 @@ class TgaImageFile(ImageFile.ImageFile):
             # 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 584/688] 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 d158fe492..c41b31d68 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -118,18 +118,18 @@ class TgaImageFile(ImageFile.ImageFile):
             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 585/688] 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 39eb1c203..e50cd7799 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -97,7 +97,7 @@ class BoxReader:
         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 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
                 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 586/688] 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 ed7ea4fcf..95b9b967b 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 587/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 6375f5c63..20bc34152 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 588/688] 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 589/688] 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 c41b31d68..39104aece 100644
--- a/src/PIL/TgaImagePlugin.py
+++ b/src/PIL/TgaImagePlugin.py
@@ -36,7 +36,7 @@ MODES = {
     (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 @@ class TgaImageFile(ImageFile.ImageFile):
         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 @@ class TgaImageFile(ImageFile.ImageFile):
             # 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 063bcbbcc..eaa4374e3 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 590/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 20bc34152..cfb987beb 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 591/688] 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 5b1ba6289..c5cf5b383 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -8,6 +8,7 @@ import sys
 import tempfile
 import warnings
 from pathlib import Path
+from types import ModuleType
 from typing import IO, Any
 
 import pytest
@@ -35,6 +36,12 @@ from .helper import (
     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 @@ class TestImage:
         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 e9fb55d6b..cbeefa189 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1511,7 +1511,7 @@ class Image:
             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 b7d0d24f2..ada529153 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 592/688] 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 15c7bbdb8..a03a6a6e1 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 593/688] 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 27a6090c5..64ef929c4 100644
--- a/Tests/test_imageops.py
+++ b/Tests/test_imageops.py
@@ -432,6 +432,16 @@ def test_exif_transpose() -> 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 6d2814345..a84c08345 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 594/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index cfb987beb..3de9ef65b 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 595/688] 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 a0dcb92d2..6dd432488 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 596/688] 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 a9a89e58b..59259b719 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -487,18 +487,13 @@ class JpegImageFile(ImageFile.ImageFile):
                 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 597/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 3de9ef65b..a6f2bc12c 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 598/688] 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 4e9291fbb..0bff43896 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 96300c008..8d3706be6 100644
--- a/docs/releasenotes/10.4.0.rst
+++ b/docs/releasenotes/10.4.0.rst
@@ -4,21 +4,16 @@
 Security
 ========
 
-TODO
-^^^^
+ImageShow.WindowsViewer.show_file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-TODO
+If an attacker has control over the ``path`` passed to
+``ImageShow.WindowsViewer.show_file()``, they may be able to
+execute arbitrary shell commands.
 
-:cve:`YYYY-XXXXX`: TODO
-^^^^^^^^^^^^^^^^^^^^^^^
-
-TODO
-
-Backwards Incompatible Changes
-==============================
-
-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 f60b1e11e..037d6f492 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -118,6 +118,8 @@ class Viewer:
         """
         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 @@ class WindowsViewer(Viewer):
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(
             self.get_command(path, **options),
             shell=True,
@@ -171,6 +175,8 @@ class MacViewer(Viewer):
         """
         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 @@ class XDGViewer(UnixViewer):
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(["xdg-open", path])
         return 1
 
@@ -237,6 +245,8 @@ class DisplayViewer(UnixViewer):
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         args = ["display"]
         title = options.get("title")
         if title:
@@ -259,6 +269,8 @@ class GmDisplayViewer(UnixViewer):
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(["gm", "display", path])
         return 1
 
@@ -275,6 +287,8 @@ class EogViewer(UnixViewer):
         """
         Display given file.
         """
+        if not os.path.exists(path):
+            raise FileNotFoundError
         subprocess.Popen(["eog", "-n", path])
         return 1
 
@@ -299,6 +313,8 @@ class XVViewer(UnixViewer):
         """
         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 599/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index a6f2bc12c..641aa8803 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 600/688] 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 641aa8803..d071f3214 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 12d7412ea..cebfd868c 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 601/688] 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 1c21aa8ca..3181fc204 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 0f996a94b..b7c15ff63 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 000000000..e04ae9fd6
--- /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 08e9ec2a4..501479bb6 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 6ee5fb6c8..641cda4ef 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 f31b1c1a2..71e869045 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -31,7 +31,6 @@ from typing import IO
 
 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 602/688] 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 cebfd868c..c4a72ad7e 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 603/688] 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 584d8f91d..82ff14181 100644
--- a/Tests/test_deprecate.py
+++ b/Tests/test_deprecate.py
@@ -9,9 +9,9 @@ from PIL import _deprecate
     "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 604/688] 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 30b64349d..c6e166171 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 018cc1cbf..a94a25678 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 f8f191d38..ae346e8b6 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 1269ef8cb..97422d569 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 a773ca453..e5e1ec32e 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 c7d105836..000000000
--- 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 8abb1f69f..52ffef5e8 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -12,19 +12,6 @@ from PIL import Image
 
 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 @@ except ImportError:
     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 @@ class TestImagePutPixel(AccessTest):
         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 @@ class TestImageGetPixel(AccessTest):
         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 @@ class TestImageGetPixel(AccessTest):
         # 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 @@ class TestImageGetPixel(AccessTest):
 
         # 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 @@ class TestImageGetPixel(AccessTest):
         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 1ea7974eb..8646576bb 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 b7c15ff63..792fd1c70 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 04b2a47ee..000000000
--- 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 82c75e373..effcd3c46 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 e04ae9fd6..bde791b1e 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 284128c77..8018e25dc 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -331,7 +331,6 @@ class GifImageFile(ImageFile.ImageFile):
                     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 227fcf35c..086c87b1a 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -329,7 +329,6 @@ class IcoImageFile(ImageFile.ImageFile):
         # 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 d41c06523..dbdb3b132 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -125,14 +125,6 @@ except ImportError as v:
     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 @@ if hasattr(core, "DEFAULT_STRATEGY"):
 # Registries
 
 if TYPE_CHECKING:
-    from . import ImageFile, PyAccess
+    from . import ImageFile
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -549,7 +541,6 @@ class Image:
         self.palette = None
         self.info = {}
         self.readonly = 0
-        self.pyaccess = None
         self._exif = None
 
     @property
@@ -631,7 +622,6 @@ class Image:
     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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
                 )
 
         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 @@ class Image:
         """
 
         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 @@ class Image:
                         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 @@ class Image:
             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 @@ class Image:
             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 a84c08345..55335872d 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 d2834929b..34ea77c5e 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -851,8 +851,6 @@ class PngImageFile(ImageFile.ImageFile):
                 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 @@ class PngImageFile(ImageFile.ImageFile):
                     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 3be1ccace..000000000
--- 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 85a2020d6..d225a3106 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 605/688] 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 33a0e07b3..83952b397 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 606/688] 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 adada6e01..2ea973c5c 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 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 607/688] 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 6afed74db..d18ab9729 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 ed25d33a6..cde00c76d 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 608/688] 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 f12b30e65..41f9c0e38 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -338,7 +338,7 @@ linkcheck_allowed_redirects = {
 # 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 609/688] [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 6a76e8c00..659409de4 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 610/688] 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 09ece18fa..435c67f04 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -7,8 +7,8 @@ from typing import Any, Protocol, Sequence, TypeVar, Union
 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 611/688] [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci
---
 pyproject.toml | 105 ++++++++++++++++++++++++++-----------------------
 1 file changed, 56 insertions(+), 49 deletions(-)

diff --git a/pyproject.toml b/pyproject.toml
index 20e87ad32..6f47f360b 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
+  "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 ','
+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 612/688] 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 435c67f04..db1e80e2f 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -2,14 +2,15 @@ from __future__ import annotations
 
 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 613/688] 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 00c8995b0..0d9c0b419 100644
--- a/Tests/test_color_lut.py
+++ b/Tests/test_color_lut.py
@@ -321,6 +321,7 @@ class TestColorLut3DCoreAPI:
                                   -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 @@ class TestColorLut3DCoreAPI:
                                   -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 ab9f9663e..b3f38c3e5 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 93f9b9833..07161fcfa 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -575,6 +575,7 @@ class TestImage:
         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 52ffef5e8..c860771dc 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -47,6 +47,8 @@ class TestImagePutPixel:
         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 @@ class TestImagePutPixel:
         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 @@ class TestImagePutPixel:
     @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 2fb45854a..5b63ceec3 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 0605821e0..4f1d63b8f 100644
--- a/Tests/test_image_load.py
+++ b/Tests/test_image_load.py
@@ -12,9 +12,10 @@ from .helper import hopper
 
 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 01cb880cb..2cff6c893 100644
--- a/Tests/test_image_paste.py
+++ b/Tests/test_image_paste.py
@@ -14,6 +14,7 @@ class TestImagingPaste:
         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 @@ class TestImagingPaste:
     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 @@ class TestImagingPaste:
     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 2d461d985..9f8aa601c 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 d6055b577..58de812ef 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -74,6 +74,7 @@ class TestImagingCoreResampleAccuracy:
         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 @@ class TestImagingCoreResampleAccuracy:
     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 @@ class TestImagingCoreResampleAccuracy:
 
     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 @@ class TestCoreResampleConsistency:
         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 @@ class TestCoreResampleAlphaCorrect:
 
     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 @@ class TestCoreResampleAlphaCorrect:
     ) -> 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 @@ class TestCoreResampleAlphaCorrect:
 
     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 @@ class TestCoreResampleCoefficients:
             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 64ef929c4..3598df830 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 b607b8c43..e5869892e 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 1b01f95ce..e26f5d283 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 32d2cf985..a082e5a4d 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 c1927bd26..93eef48d2 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 @@ class FpxImageFile(ImageFile.ImageFile):
             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 @@ class FpxImageFile(ImageFile.ImageFile):
 
         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 dbdb3b132..005b4cc9e 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -221,7 +221,7 @@ if hasattr(core, "DEFAULT_STRATEGY"):
 # Registries
 
 if TYPE_CHECKING:
-    from . import ImageFile
+    from . import ImageFile, ImagePalette
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -1167,7 +1167,7 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
 
         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 @@ class Image:
             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 55335872d..d47b86a75 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 90defdbbc..6aa70ced3 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -28,8 +28,9 @@ from __future__ import annotations
 
 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 @@ class PhotoImage:
                     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 07239887f..5f23a34b9 100644
--- a/src/PIL/MicImagePlugin.py
+++ b/src/PIL/MicImagePlugin.py
@@ -70,7 +70,7 @@ class MicImageFile(TiffImagePlugin.TiffImageFile):
         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 614/688] 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 0d0f81fbf..a2bf2a7b0 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 615/688] 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 e21caf520..7f4730df4 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 bde791b1e..0b18fe01a 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 6f47f360b..a1cc7554f 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 d225a3106..912d7167c 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 616/688] 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 0abfaaddc..b26852b0b 100644
--- a/setup.py
+++ b/setup.py
@@ -43,7 +43,7 @@ WEBP_ROOT = None
 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 617/688] 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 7f4730df4..028a2018f 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 618/688] 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 c6e166171..fc5ff0064 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 ae346e8b6..d35cfcd31 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 a3376ac92..3fbf3be69 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 619/688] 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 6ce5200b6..e12987a5f 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 fc5ff0064..1eb098be9 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 97422d569..8e2827099 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 d18ab9729..21e1275e7 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 ee265774b..5b34d6703 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 aa5646caf..0972459b0 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 3d6099c1c..4eb907bcd 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 605a214d4..7abc495b6 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -11,9 +11,10 @@ import subprocess
 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 3181fc204..b54238132 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 e19c88a47..79a2ec0ab 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 d39a86565..02f07a565 100644
--- a/Tests/test_file_pdf.py
+++ b/Tests/test_file_pdf.py
@@ -5,8 +5,9 @@ import os
 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 c06d110a7..93a9f9e6a 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -2,10 +2,10 @@ from __future__ import annotations
 
 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 58de812ef..92ba1553c 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 64098f80f..3ef05a25f 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -4,9 +4,9 @@ Tests for resize functionality.
 
 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 1466ab1ba..1ff3fea2a 100644
--- a/Tests/test_imagedraw.py
+++ b/Tests/test_imagedraw.py
@@ -2,7 +2,7 @@ from __future__ import annotations
 
 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 c8e2c0467..920012d86 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 9487560af..cda2584e7 100644
--- a/Tests/test_imagepath.py
+++ b/Tests/test_imagepath.py
@@ -3,7 +3,7 @@ from __future__ import annotations
 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 01981aa4f..989f72ddd 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 028a2018f..19816af58 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 cde00c76d..1d449a036 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 0b18fe01a..964423ae0 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 a1cc7554f..700d5e7fe 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 8018e25dc..bf74f9356 100644
--- a/src/PIL/GifImagePlugin.py
+++ b/src/PIL/GifImagePlugin.py
@@ -32,7 +32,7 @@ import subprocess
 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 005b4cc9e..b4ef62510 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -38,7 +38,7 @@ import struct
 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 @@ from typing import (
     Any,
     Literal,
     Protocol,
-    Sequence,
-    Tuple,
     cast,
 )
 
@@ -1097,7 +1095,7 @@ class Image:
             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 244d3d5f0..2b3620e71 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -34,8 +34,9 @@ from __future__ import annotations
 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 @@ except AttributeError:
 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 e18b4a446..8b0974b2c 100644
--- a/src/PIL/ImageFilter.py
+++ b/src/PIL/ImageFilter.py
@@ -18,8 +18,9 @@ from __future__ import annotations
 
 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 d47b86a75..44aad0c3c 100644
--- a/src/PIL/ImageOps.py
+++ b/src/PIL/ImageOps.py
@@ -21,7 +21,8 @@ from __future__ import annotations
 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 ed38285dc..8ccecbd07 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 ffd791674..a3d8f441a 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 73df83bfb..f9d5b75f0 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 e50cd7799..c8a57567a 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -18,7 +18,7 @@ from __future__ import annotations
 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 @@ class BoxReader:
         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 9e2231347..622dc7de9 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,7 @@ import os
 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 @@ class PdfName:
         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 f5a09c3ef..a07101e54 100644
--- a/src/PIL/SpiderImagePlugin.py
+++ b/src/PIL/SpiderImagePlugin.py
@@ -37,7 +37,7 @@ from __future__ import annotations
 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 @@ class SpiderImageFile(ImageFile.ImageFile):
     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 db1e80e2f..b6bb8d89a 100644
--- a/src/PIL/_typing.py
+++ b/src/PIL/_typing.py
@@ -2,7 +2,8 @@ from __future__ import annotations
 
 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 912d7167c..189415237 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 7e81abcb0..c8048bcc9 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 d0be2943e..96b8803b4 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 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 620/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index d071f3214..856458aa9 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 621/688] 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 3ef05a25f..c9e304512 100644
--- a/Tests/test_image_resize.py
+++ b/Tests/test_image_resize.py
@@ -285,14 +285,14 @@ class TestReducingGapResize:
 
 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 b4ef62510..3c7a3735c 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -2203,7 +2203,7 @@ class Image:
 
     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 @@ class Image:
         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 622/688] 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 a082e5a4d..312e32e0c 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 3c7a3735c..8e595eedf 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -63,7 +63,6 @@ from . import (
 )
 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 @@ if hasattr(core, "DEFAULT_STRATEGY"):
 
 if TYPE_CHECKING:
     from . import ImageFile, ImagePalette
+    from ._typing import NumpyArray, StrOrBytesPath, TypeGuard
 ID: list[str] = []
 OPEN: dict[
     str,
@@ -2203,7 +2203,7 @@ class Image:
 
     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 @@ class Image:
         """
         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 623/688] 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 1eb098be9..0dc738ed8 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 0972459b0..75165909c 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 624/688] 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 75165909c..d858dcfff 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 625/688] 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 d858dcfff..fc8be6ced 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 626/688] 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 0dc738ed8..e1274f41c 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 627/688] 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 1d449a036..f2ef9cacb 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 628/688] 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 4eb907bcd..f8dff3a3e 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 629/688] 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 fc8be6ced..702841814 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 630/688] 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 0bff43896..a4f7e5cc5 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 71e869045..59bb8594d 100644
--- a/src/PIL/EpsImagePlugin.py
+++ b/src/PIL/EpsImagePlugin.py
@@ -338,7 +338,7 @@ class EpsImageFile(ImageFile.ImageFile):
             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 @@ class EpsImageFile(ImageFile.ImageFile):
 
         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 dceb83927..52d1fce31 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 @@ class FliImageFile(ImageFile.ImageFile):
         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 @@ class FliImageFile(ImageFile.ImageFile):
                 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 @@ class FliImageFile(ImageFile.ImageFile):
         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 93eef48d2..386e37233 100644
--- a/src/PIL/FpxImagePlugin.py
+++ b/src/PIL/FpxImagePlugin.py
@@ -231,7 +231,7 @@ class FpxImageFile(ImageFile.ImageFile):
         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 93e89b1e6..3c8feea5f 100644
--- a/src/PIL/GbrImagePlugin.py
+++ b/src/PIL/GbrImagePlugin.py
@@ -88,7 +88,7 @@ class GbrImageFile(ImageFile.ImageFile):
         # 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 2a89d498c..8729f7643 100644
--- a/src/PIL/IcnsImagePlugin.py
+++ b/src/PIL/IcnsImagePlugin.py
@@ -34,11 +34,13 @@ MAGIC = b"icns"
 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 @@ class IcnsFile:
                 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 @@ class IcnsFile:
                     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 @@ class IcnsFile:
                 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 @@ class IcnsImageFile(ImageFile.ImageFile):
         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 @@ class IcnsImageFile(ImageFile.ImageFile):
             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 086c87b1a..650f5e4f1 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 @@ class IcoFile:
         # 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 @@ class IcoImageFile(ImageFile.ImageFile):
             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 @@ class IcoImageFile(ImageFile.ImageFile):
             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 b4ef62510..c9bb008b0 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1395,7 +1395,7 @@ class Image:
 
     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 @@ class Image:
         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 037d6f492..d62893d9c 100644
--- a/src/PIL/ImageShow.py
+++ b/src/PIL/ImageShow.py
@@ -26,7 +26,7 @@ from . import Image
 _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 f9d5b75f0..a04616fbd 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -148,7 +148,7 @@ class IptcImageFile(ImageFile.ImageFile):
         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 @@ class IptcImageFile(ImageFile.ImageFile):
         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 c8a57567a..992b9ccaf 100644
--- a/src/PIL/Jpeg2KImagePlugin.py
+++ b/src/PIL/Jpeg2KImagePlugin.py
@@ -299,7 +299,7 @@ class Jpeg2KImageFile(ImageFile.ImageFile):
     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 ac5b63c1b..b89144803 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -1232,7 +1232,7 @@ class TiffImageFile(ImageFile.ImageFile):
                 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 fbd7be6ed..895d5616a 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -50,7 +50,7 @@ class WalImageFile(ImageFile.ImageFile):
         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 59be5bf9d..530b88c8b 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -144,7 +144,7 @@ class WebPImageFile(ImageFile.ImageFile):
         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 631/688] 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         | 26 ++++++++++--------
 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, 156 insertions(+), 69 deletions(-)

diff --git a/Tests/helper.py b/Tests/helper.py
index 7abc495b6..d6a93a803 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 f491f9875..8707311dc 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -1048,7 +1048,11 @@ class TestFileLibTiff(LibTiffTestCase):
         ],
     )
     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 882dccb32..e0d7999e3 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 test_write_animation_RGB(tmp_path: Path) -> 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 07161fcfa..8e6f63fac 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -372,8 +372,9 @@ class TestImage:
         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 @@ class TestImage:
 
         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 c860771dc..854c79dae 100644
--- a/Tests/test_image_access.py
+++ b/Tests/test_image_access.py
@@ -27,7 +27,9 @@ class TestImagePutPixel:
         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 @@ class TestImagePutPixel:
         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 @@ class TestImagePutPixel:
         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 @@ class TestImagePutPixel:
         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 @@ class TestImagePutPixel:
         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 @@ class TestImagePutPixelError:
         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 @@ class TestImagePutPixelError:
             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 5b63ceec3..ebb7f2822 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 8f8870f4f..8dbe82b29 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 dad26ef14..27cb7c59d 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 9f8aa601c..903cd8550 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 92ba1553c..ce6209c0d 100644
--- a/Tests/test_image_resample.py
+++ b/Tests/test_image_resample.py
@@ -237,13 +237,13 @@ class TestImagingCoreResampleAccuracy:
 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 @@ class TestCoreResampleConsistency:
     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 @@ class TestCoreResampleAlphaCorrect:
         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 @@ class TestCoreResampleAlphaCorrect:
         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 638d12247..7e83396de 100644
--- a/Tests/test_image_transform.py
+++ b/Tests/test_image_transform.py
@@ -192,8 +192,9 @@ class TestImageTransform:
 
         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 7e2290c15..4fc28cdb9 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)
+                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, 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, 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)
+    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 c51f1155d..5ee5fcedf 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 1ff3fea2a..e397978cb 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 68b28ef07..bb686bb3b 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -305,7 +305,7 @@ class TestPyDecoder(CodecsTest):
     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 32615cf0e..4363f456e 100644
--- a/Tests/test_imagemorph.py
+++ b/Tests/test_imagemorph.py
@@ -41,11 +41,15 @@ A = string_to_img(
 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 3598df830..e33e6d4c8 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 e5869892e..f84c6c03a 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 ae80b98b8..9d06a9332 100644
--- a/Tests/test_tiff_ifdrational.py
+++ b/Tests/test_tiff_ifdrational.py
@@ -11,7 +11,11 @@ from PIL.TiffImagePlugin import IFDRational
 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 632/688] 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 622dc7de9..7cb2d241b 100644
--- a/src/PIL/PdfParser.py
+++ b/src/PIL/PdfParser.py
@@ -8,7 +8,7 @@ import os
 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 @@ PDFDocEncoding = {
 }
 
 
-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 @@ class IndirectReference(IndirectReferenceTuple):
         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 @@ class IndirectObjectDef(IndirectReference):
 
 
 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 @@ class XrefTable:
         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 @@ class XrefTable:
             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 @@ class XrefTable:
             | 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 @@ class XrefTable:
                     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 @@ class XrefTable:
 
 
 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 @@ class PdfName:
     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 @@ class PdfName:
         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 @@ else:
 
 
 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 @@ class PdfDict(_DictBase):
 
 
 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 @@ class PdfBinary:
 
 
 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 @@ class PdfParser:
             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 @@ class PdfParser:
             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 @@ class PdfParser:
         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 @@ class PdfParser:
             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 @@ class PdfParser:
                 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 @@ class PdfParser:
             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 @@ class PdfParser:
             + 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 @@ class PdfParser:
         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 @@ class PdfParser:
                 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 @@ class PdfParser:
         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 @@ class PdfParser:
         # 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 @@ class PdfParser:
         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 @@ class PdfParser:
             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 @@ class PdfParser:
         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 @@ class PdfParser:
     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 @@ class PdfParser:
             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 @@ class PdfParser:
     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 @@ class PdfParser:
     )
 
     @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 @@ class PdfParser:
                 == 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 @@ class PdfParser:
         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 @@ class PdfParser:
     }
 
     @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 @@ class PdfParser:
     )
     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 @@ class PdfParser:
             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 @@ class PdfParser:
                         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 @@ class PdfParser:
         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 633/688] 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 79a2ec0ab..85b017d29 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 8707311dc..d5dbeeb6f 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -92,11 +92,22 @@ class TestFileLibTiff(LibTiffTestCase):
     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 @@ class TestFileLibTiff(LibTiffTestCase):
             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 02f07a565..3729ca58b 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 93a9f9e6a..8cad25272 100644
--- a/Tests/test_file_tiff.py
+++ b/Tests/test_file_tiff.py
@@ -78,6 +78,7 @@ class TestFileTiff:
 
     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 @@ class TestFileTiff:
     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 @@ class TestFileTiff:
     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 @@ class TestFileTiff:
     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 8e6f63fac..4fdc41791 100644
--- a/Tests/test_image.py
+++ b/Tests/test_image.py
@@ -704,7 +704,7 @@ class TestImage:
             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 5dfa51697..5cd510751 100644
--- a/Tests/test_imagegrab.py
+++ b/Tests/test_imagegrab.py
@@ -60,6 +60,8 @@ class TestImageGrab:
     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 @@ $bmp = New-Object Drawing.Bitmap 200, 200
 [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 @@ $bmp = New-Object Drawing.Bitmap 200, 200
                     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 700d5e7fe..cd7248669 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 dbb72ed6a..565abe71d 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -1886,7 +1886,7 @@ class Image:
 
     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 @@ class Image:
 
     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 189415237..c1bc3b17d 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 634/688] 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 3729ca58b..1d5001b1a 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 635/688] 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 e1274f41c..8e65f64c4 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 702841814..6e63333b0 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 636/688] 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 39b9c60b7..5402fcb44 100644
--- a/Tests/test_file_mpo.py
+++ b/Tests/test_file_mpo.py
@@ -2,11 +2,11 @@ from __future__ import annotations
 
 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 @@ test_files = ["Tests/images/sugarshack.mpo", "Tests/images/frozenpond.mpo"]
 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 bb686bb3b..b996860ce 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -90,6 +90,7 @@ class TestImageFile:
             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 @@ class TestImageFile:
                 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 @@ class TestPyEncoder(CodecsTest):
         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 f84c6c03a..4484dca10 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 b9cefafdd..6d71049a9 100644
--- a/src/PIL/BlpImagePlugin.py
+++ b/src/PIL/BlpImagePlugin.py
@@ -313,6 +313,7 @@ class _BLPBaseDecoder(ImageFile.PyDecoder):
         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 ef2045337..48bdd9830 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 @@ class BmpImageFile(ImageFile.ImageFile):
             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 @@ class BmpImageFile(ImageFile.ImageFile):
             )
             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 @@ class BmpImageFile(ImageFile.ImageFile):
                     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 @@ class BmpImageFile(ImageFile.ImageFile):
         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 @@ class BmpImageFile(ImageFile.ImageFile):
                     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 @@ class BmpImageFile(ImageFile.ImageFile):
             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 @@ class BmpImageFile(ImageFile.ImageFile):
                 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 @@ class BmpImageFile(ImageFile.ImageFile):
 
         # ---------------------------- 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 69e7ee548..99d7e73f1 100644
--- a/src/PIL/ImageFile.py
+++ b/src/PIL/ImageFile.py
@@ -485,7 +485,7 @@ class Parser:
 
                 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 @@ class PyCodec:
         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 @@ class PyCodec:
         """
         pass
 
-    def setfd(self, fd):
+    def setfd(self, fd) -> None:
         """
         Called from ImageFile to set the Python file-like object
 
@@ -793,7 +793,7 @@ class PyEncoder(PyCodec):
             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 6aa70ced3..6b13e57a0 100644
--- a/src/PIL/ImageTk.py
+++ b/src/PIL/ImageTk.py
@@ -28,7 +28,7 @@ from __future__ import annotations
 
 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 992b9ccaf..eeec41686 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 @@ class BoxReader:
         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 b15bf06d2..4916727be 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 @@ class JpegImageFile(ImageFile.ImageFile):
 
         # Create attributes
         self.bits = self.layers = 0
+        self._exif_offset = 0
 
         # JPEG specifics (internal)
         self.layer = []
@@ -498,17 +500,17 @@ class JpegImageFile(ImageFile.ImageFile):
         ):
             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 @@ samplings = {
 # 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 f21570661..5ed9f56a1 100644
--- a/src/PIL/MpoImagePlugin.py
+++ b/src/PIL/MpoImagePlugin.py
@@ -22,7 +22,7 @@ from __future__ import annotations
 import itertools
 import os
 import struct
-from typing import IO
+from typing import IO, Any, cast
 
 from . import (
     Image,
@@ -101,8 +101,11 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
         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 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
         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 @@ class MpoImageFile(JpegImagePlugin.JpegImageFile):
         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 34ea77c5e..fa117d19a 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -230,6 +230,7 @@ class ChunkStream:
 
         cids = []
 
+        assert self.fp is not None
         while True:
             try:
                 cid, pos, length = self.read()
@@ -407,6 +408,7 @@ class PngStream(ChunkStream):
 
     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 @@ class PngStream(ChunkStream):
 
     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 @@ class PngStream(ChunkStream):
 
     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 @@ class PngStream(ChunkStream):
 
     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 @@ class PngStream(ChunkStream):
 
     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 @@ class PngStream(ChunkStream):
         # 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 @@ class PngStream(ChunkStream):
         # 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 @@ class PngStream(ChunkStream):
 
     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 @@ class PngStream(ChunkStream):
 
     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 @@ class PngStream(ChunkStream):
             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 @@ class PngStream(ChunkStream):
             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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
         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 @@ class PngStream(ChunkStream):
         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 edf698bf0..31dfd4d12 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 530b88c8b..011de9c6a 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -115,7 +115,7 @@ class WebPImageFile(ImageFile.ImageFile):
         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 3d5cddcc8..68f8a74f5 100644
--- a/src/PIL/WmfImagePlugin.py
+++ b/src/PIL/WmfImagePlugin.py
@@ -152,7 +152,7 @@ class WmfStubImageFile(ImageFile.StubImageFile):
     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 000000000..e27843e53
--- /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 637/688] 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 ddc8d2885..03e10e547 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 590e1b983..628662b30 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 ba36cc72c..1bef876e1 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 067c165b2..a2ddc91b9 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 8815c2b7e..a95ce75bf 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 efa7fc1b6..c70d044bb 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 0a70e3357..dfa24da41 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 638/688] 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 442b5d04f..72ad3fa07 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 000000000..51e8c0de7
--- /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 639/688] 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 72ad3fa07..620774f67 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 640/688] 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 1bef876e1..468f16884 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 641/688] 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 468f16884..ddcf28f97 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 642/688] 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 3fbf3be69..023a33824 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 f8dff3a3e..e32f14529 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 643/688] 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 dfe8f9e99..e2913e944 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -41,7 +41,7 @@ MAGIC = PngImagePlugin._MAGIC
 
 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 b996860ce..44a6e6a42 100644
--- a/Tests/test_imagefile.py
+++ b/Tests/test_imagefile.py
@@ -127,7 +127,7 @@ class TestImageFile:
     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 @@ class TestPyDecoder(CodecsTest):
             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 @@ class TestPyEncoder(CodecsTest):
             )
 
     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 99d7e73f1..6b2953451 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 @@ class ImageFile(Image.Image):
             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 @@ class ImageFile(Image.Image):
     # 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 @@ class StubImageFile(ImageFile):
         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 @@ class StubImageFile(ImageFile):
         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 @@ class Parser:
         """
         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 @@ class 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 @@ class Parser:
 # --------------------------------------------------------------------
 
 
-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 @@ class PyCodecState:
 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 @@ class PyCodec:
         """
         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 2c1850276..a6fc340d5 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 4916727be..54f756014 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 f0da1e047..e0f732199 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 fa117d19a..6990b6d05 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 @@ class ChunkStream:
         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 @@ _OUTMODES = {
 }
 
 
-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 @@ class _idat:
 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 @@ def getchunks(im, **params):
         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 b89144803..253f64852 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 @@ class ImageFileDirectory_v2(_IFDv2Base):
             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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
 
         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 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
     """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 @@ class ImageFileDirectory_v1(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 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
     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 @@ class TiffImageFile(ImageFile.ImageFile):
         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 @@ class TiffImageFile(ImageFile.ImageFile):
 
         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 @@ class TiffImageFile(ImageFile.ImageFile):
                     # 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 @@ class AppendingTiffWriter:
     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 895d5616a..ec5c74900 100644
--- a/src/PIL/WalImageFile.py
+++ b/src/PIL/WalImageFile.py
@@ -24,8 +24,11 @@ and has been tested with a few sample files found using google.
 """
 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 @@ class WalImageFile(ImageFile.ImageFile):
         return Image.Image.load(self)
 
 
-def open(filename):
+def open(filename: StrOrBytesPath | IO[bytes]) -> WalImageFile:
     """
     Load texture from a Quake2 WAL texture file.
 

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 644/688] 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 ddcf28f97..eb04945f0 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 620774f67..82aed7783 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 645/688] 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 03e10e547..ac6310a44 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 eb04945f0..6c2885c61 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 82aed7783..2c95b7ebc 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 6bc90abed..f8a99eb5b 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 646/688] Add include

---
 src/path.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/path.c b/src/path.c
index f8a99eb5b..bd6ad2259 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 647/688] Added type hints

---
 Tests/test_imagewin.py     |  3 ++
 src/PIL/EpsImagePlugin.py  |  2 +-
 src/PIL/IcoImagePlugin.py  | 84 ++++++++++++++++++++------------------
 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, 138 insertions(+), 92 deletions(-)

diff --git a/Tests/test_imagewin.py b/Tests/test_imagewin.py
index b43c31b52..a836bb90b 100644
--- a/Tests/test_imagewin.py
+++ b/Tests/test_imagewin.py
@@ -57,6 +57,9 @@ class TestImageWinDib:
         # 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 59bb8594d..7a73d1f69 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 650f5e4f1..8be1bd316 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -25,7 +25,7 @@ from __future__ import annotations
 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 @@ class IcoFile:
         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
+            width = s[0] or 256
+            height = s[1] or 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
+            # 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 @@ class IcoFile:
 
         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 @@ class IcoFile:
             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 @@ class IcoFile:
                 # 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 565abe71d..9d901e028 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 @@ class Exif(_ExifBase):
         # 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 @@ class Exif(_ExifBase):
             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 @@ class Exif(_ExifBase):
             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 6b2953451..e4a7dba44 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 @@ class PyCodec:
         """
         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 35a37760c..346fe49d3 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -19,11 +19,14 @@ from __future__ import annotations
 
 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 978c5a9d1..4f9956087 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 @@ class Dib:
             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 @@ class Dib:
         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 @@ class Window:
             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 @@ class Window:
 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 a04616fbd..16a18ddfa 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -18,6 +18,7 @@ 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
@@ -184,7 +185,7 @@ Image.register_open(IptcImageFile.format, IptcImageFile)
 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 54f756014..af24faa5d 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 _save(im: Image.Image, fp: IO[bytes], filename: str | bytes) -> None:
                     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 6990b6d05..247f908ed 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -39,7 +39,7 @@ import struct
 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 @@ class _fdat:
         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 648/688] Simplified code

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

diff --git a/src/_imagingft.c b/src/_imagingft.c
index 6c2885c61..c6d20fe45 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 649/688] 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 8be1bd316..c891024f5 100644
--- a/src/PIL/IcoImagePlugin.py
+++ b/src/PIL/IcoImagePlugin.py
@@ -229,7 +229,7 @@ class IcoFile:
             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 650/688] 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 e32f14529..3013f0c37 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 651/688] 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 3013f0c37..191eaffeb 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 652/688] 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 191eaffeb..4501802cb 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 653/688] 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 4501802cb..fa1825e45 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 654/688] 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 3199e330b..143dde82c 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 655/688] [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 68247bc47..a260fa0d1 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 ef1c00a94..727ee6bed 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 ac6310a44..5c2f7b4b6 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 628662b30..bafe787a7 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 c6d20fe45..da03e3ba9 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 a2ddc91b9..550a10903 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 a95ce75bf..614dfbe7f 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 dfa24da41..e686ec820 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 ea2f3af80..51d0aced2 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 990f4b0a5..b4e2e3899 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 2c95b7ebc..f711865d5 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 3a5e918e8..bf7db281e 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 72f478d8d..9a41febc7 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 4ea9c7717..51cb7e102 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 f9c005efe..f326d402f 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 aee7cda06..5559de689 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 fcb5f7ad9..c8f234261 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 142f065e5..285b43327 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 269be1058..c69e9e552 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 133696dd8..f1c8ffcff 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 5b6bfb89c..8fb481e7e 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 85de77fcb..fbd6b425f 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 cf3bc9979..2bfeed7b6 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 bd2a2778c..c61a27d3b 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 45b67616d..203fb9d0a 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 bd16cdbe1..e26c0e9b3 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 1f2c03e93..b1c3aed41 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 dd066c10b..5b3d7ffc4 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 7f1aeaddb..cb21a186c 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 6f75d8670..30c64f235 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 ba8353c2d..4372d51d5 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 7dd432b91..52f1ac502 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 dc67cb41d..86085942a 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 c95ffc869..942c8dc22 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 549614bfd..625cf7ffa 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 dd06f3940..6a4060b4b 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 cdc614536..197f9f3ee 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 ea75d6037..bf2f29fde 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 fc1a99003..0462cfd49 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 1331a30ad..7e02ebf65 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 7a36300e4..a2258c3a2 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 d65e42590..ae96a52f3 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 73a6baecb..899b1fd3a 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 24abe4804..80ed0d688 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 50de8d982..5e60e1106 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 61566f0c5..022daa000 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 59c27b3f4..222d6bca4 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 89dedb525..a8db11740 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 b27195a35..9dc133b0f 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 9d8e1292a..d3231ad90 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 95ae9b622..fbf29452c 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 aa7e7b96d..dde476614 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 abffdeabc..18a54f633 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 212b7dee6..22361210d 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 eaa4374e3..c23d5d889 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 0b177bdd4..35b0c3b69 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 2853ce903..e714749ef 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 eec4c0d84..65cc3c633 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 874967834..d964ff2ca 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 edbce3682..44f2629cc 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 c298bd148..c66702981 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 bd6ad2259..b96e8b78a 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 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 656/688] 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 eb73fc6a7..033ff98ce 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 657/688] 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 7f76fb47a..237045acc 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 cd7248669..b76f3c24d 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 0035296a4..ec9e66c71 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 @@ class ContainerIO(Generic[AnyStr]):
     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 @@ class ContainerIO(Generic[AnyStr]):
         :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 @@ class ContainerIO(Generic[AnyStr]):
         # 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 @@ class ContainerIO(Generic[AnyStr]):
         """
         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 @@ class ContainerIO(Generic[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 @@ class ContainerIO(Generic[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 cba26d4b0..779288b1c 100644
--- a/src/PIL/TarIO.py
+++ b/src/PIL/TarIO.py
@@ -55,13 +55,3 @@ class TarIO(ContainerIO.ContainerIO[bytes]):
 
         # 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 658/688] 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 5769c903e..360325780 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 @@ 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}
+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 7b8a562d7..b7ac84691 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 @@ 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}
+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 792fd1c70..2f5800e07 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 2535db711..a72ca92d0 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 964423ae0..bb6179de8 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 6664434ea..e79eb3ec9 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 659/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index 856458aa9..a2e02fe62 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 660/688] 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 fa1825e45..10e37f343 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 661/688] 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 10e37f343..087d2bd56 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 662/688] 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 a72ca92d0..f4e1081e6 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 e79eb3ec9..191cc2a5f 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 663/688] 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 087d2bd56..ffd1abd95 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 664/688] Update CHANGES.rst [ci skip]

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

diff --git a/CHANGES.rst b/CHANGES.rst
index a2e02fe62..bd8d3af03 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 665/688] 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
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rebanded_hopper.jpg b/docs/handbook/rebanded_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..324f7ef14e1e2ec5c1268a2b060bbeb79310a5ce
GIT binary patch
literal 4743
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/rolled_hopper.jpg b/docs/handbook/rolled_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..b2220f39cbe11fa43e25b698a0dae49a4fadc39f
GIT binary patch
literal 4651
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
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/transformed_hopper.jpg b/docs/handbook/transformed_hopper.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..33afe67e62be8f3e2922c5cfa5c0018774ac0b5c
GIT binary patch
literal 3608
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 6cb1e2639..b612bde90 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 666/688] 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 b612bde90..2840377e3 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 667/688] 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 2840377e3..6c4e3ad59 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 668/688] 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 6c4e3ad59..e19da47a5 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 669/688] 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
zcmV;34|niVNk&G14*&pHMM6+kP&goT4*&qrI{=*lDu4ih06uLjl0~E<p`xyqtpI=x
ziDCf0z583fnSOK5F3tX*g=F4#|DB&mdw4wG`Jj4X-pt;bw7lg9={z;@sp_9>KeqGI
z>2ESWnSJ~HSNDHyAJ6~5@c-iupkBiNL%xy#KSchg|1;CK=RDT&0{u$=iR=G<|C@UO
ze=Ppt|9kFd>MQ&I{yt{@q5swXf8am)&-ZS&zqfwQ-?$2NOpqnAhZr9435z)xTD?aD
zh^8@W=v$FBfgu3r3V<p|a!LFN^17S00EP=MqZtog6oCrXPq${7>P+G3KXrsq1s<sV
zaq^CZdes^j$J$IIr=X@_9SvCDqhDQHq5|^|bk+#73qH$~>px48b5d9nzXa1LN)7JT
z;<a-h)fX)!J?-shcXv%RqK2K+qbZ<4IZc@?0AQ4k+s6`j&XRUu1DjR8PQp)9wNaLN
z<Jo|+p_pU=O-AGTLX5~V8h{ul=uw>!eVriL2t7Hq4I31^W(seE9FyZmJFiO^_p%W-
zj3=Y+RCbfpybx<eIkgB>0~g7n&mKrKp1lf_QUvgdfn@2kAypiX@P2rM+p^@I@7`D>
zw`rpYrG!1WaisWS*0c}vLwj(7&-9g-XLe-1M&jkRtt;StF7t)$9y6Qoaex5+>-vUT
z(@9Hf?Y%Ggl3#N_3~X=n{<qj&VTx>NFH*1aiQjCC?Dxi78}0k+F451xWFYewhwz);
z&1H_(o?tnn1;i?IN3`{VhjMlZ_v`G9QWUR@k!8FB_+-3gZ~u`>V8_ClrQ=($PpdW~
zyA``U_EE5@a`9OJO)8l9=awpINmfHFaPIe+9AmAw*=Yn<kUYclU>#9bZ6-MOyJ(gG
zMB6@(+c1x>7yO*!oUl&$BD%N69m0`T5*jLzBI!k1=IPutC5Y-db}hsX7KQWD+%6~R
zX>aWLiyA1v70eYsmGs8T^K~*G)}<C-Ano0}YCC;WAtNC4f%tsZ&dK#RCMwV${&(!Z
za(IrL)=xR*g_xq4iJ%lAt|t5{b*#{`4$UZXjzx!de+F;;^IwMepu7Ihhwp~_y`IwE
z_$*<D_J;V$nkqHAqPyJuCirT;1M0tkkwg93o^-4S;Jq@s`}nGjZ<B%e^RiU=p_EHT
zH!l6pZBn3C6!0Pbb5d591&`p-3LehK_Sq4;++TU;rEV^r<msZ2`C%}HjU$Kz6-$V5
z*MFPEyv0mh<3N*sy&ulSkmygI=^ckBFDMKra9_6zGy^0cTuq<_7~mw#PyJ0WVkUR`
z{7O7-BSwKJ^Qp}Kum7xYO4Z6MWfA&veWJ{W=C}^GEG*vJbcC$Jr_i$LHyM&_5Ifiz
z)qG~*+%naG{VWQnAmBOF;*tDI--~r-l&9$sw)Yo6F4^-zA>Tb3fPUxybn*x`(7)U4
z<Jfu|6u?9mf|ZG}O~>MmIh2+H`|}ueZMxl3v)EVW+rR!p{)gm4h}*4?K7B-d@T~Nj
zA^P^;?N=ib=Lh|QrSHh0$S3Rarp&&{1JPd{km;5`gV*==RF|(wA$35)KY~vnh2iMn
zb&GdTfu-6u9Ie-fjPo>MTHCG*<Dn@)kbbHM|K-bpflgKYbW-(mF`K>Cr-x11k*_q|
z0ikCYCa^#GuZ6jk8?&objFXa2|8wV-7(Jb|2SV$|q{}AzO^ZTDK+{9(aAV|Fei{N9
zg0!CX2@eK9CawH@?TPvxTvHGZJw9Wd1y`z)2)iy(N!%9nqaEVc8qMNd>@YP42ltCw
zrOa{1IPlkJVpYs`cjk+U9nGgaGHl?I?c6BwB8B$oQ;hu94%jzt**h4-bAR#T2bosT
zI_m#cTe~qd7zk~`R20sfTva6i!G?~oK1A2m{a2Bp##POf-n&d6{^0}c5B8_U!+ZZv
zc#nG~e_p+tgx}Bm)N@wv6bCvD<%o9sJ6?et5G<@PJ-KJ*FUZTNE_}xE+9^!{gmZ2u
zd=Y=FD9rqa^!5Q_G{H=nGx4lE8_O2F^WSxCsX#Cj9SB`0FkmmS`~ns@cKQ`0%^+s;
zL|J(mB{DVO71Mc8l*Bps?+dgqL2*SX`{$Ovv5sx)!LBkF>*6e6J%-*COKzR_spu|A
z5_n8PCQJbYq4^r3T_5bF`Nj@6xjr{FOTlfrCT$Lr=ATtS4WPe|9!u1E$L@AIuQ`jA
zNZ8x$;Sj7(wWC%s54N7zZ&v9EV%Z^{Zh_ua(iol15_~lL{v$>`5o6tLsRaJBa(;v&
z7ZsQu>zM=ho$K#k9^P0ONqCf7(g8pA7uDZ5fsXR$bj`*!%kOVEM$@PN5EKd2WWa|*
zDXqM#qrEEXU-wJ?BtvQSzowf^vh;!uF_U(49A+jb!+nnfcRM_2G-Ka%^F(6VPGH5r
zphe;c?U^$Pp-G_)q!Ali9ZclnI7E-V-4B_sU7+e!Nz6le2U2{36|T80XtQ!$%KI(;
zB`1HLwy-Ji1n)22YAjbDbGQa(L-NsjzZI`zA&=^cjPcd~Jw#;Ne2wt$c+q1G9if@f
z+pE8?f8LIVaDra?uCJ#f1kj|~oMb1*@X#4W5*9vWUh4{+Wmd)OL!!X8#>4>>w*kK}
z3cbwC{>YZ``l<l)U#jEAbiK!=cs`}HeJs-aBYSb`y+!K62%C!<xGvTtlZ$DMq*Dom
zIeM8OAwi^*SO`P(5~4r!mcY*XcHYq-Xcg`L#{Iy%)}4k-0zHkYup99!cc(Sf(jQwC
zQYcaWTUS)~pjRDYE?CSkmUPo{nnr83?x9ZK-XGxZ`WY@Wp3L(;ulC4eO~-0$b)N^R
zzyIb{KRZMiJs**pOgKunOHk8d3d9}*3=jFD;fWSR85`h(`jAKy(=J_IG*`n-D8+R*
z``yzPvM10IQ=r_uRU<=2vSY_;hfS5wg*qPGfy7yumR;OUz)i0q{%jvAPz)S$<J>=o
ztnVcF-|XK53%vz*Jxe!8gui|X(m<vDO2J@0IfN?NKD}L7MCaM9%cw-mJstoi2z}7>
zt<g`np6A9X$fV`2CGY)P$8{x7UkBqCKrT}i<ngqKCGPIsW_hsP_dPe}y|nE!Dbv*!
z(Yh-qkeNJ1o0ZZ(iDHX4Xp%pd;*m)Pf&Gpd7jDtjF)w!mybWuC>VPiVc;+gp9Yw>Z
zAg378bcWjG^(#h|FDBq}Z+^A$enOmnfKholB|&IoU?28o6risosq$9ufNm6peLhXz
z>DMT$?Hf$C6ed!C=*C53<naRyko}($gn%Z@ZI^g;5WaqE^Zy#AhXlSCP@F*M{<+0u
z<N3RFSK=V;ppJXuQ5WV$iHs!*!QC(-Yaiaec+cPOXHuN~)Y;Rk*=7)PCngzAOCe+8
zRHyW^Do;}vsgTGM9ed~0`4BfRMU$y5mK`y_=o^tAZX4N@is-UpT;d_!bd;pBsO@o|
zU`i%NYUoPudo@8=RcJJrC!R;Xz?Y^zpw0scDbRBat9!|gVW-;^qXPg1R>566O7)gG
zLo!z}LV*D@)54bnKMGY7+1W%;^Cx=phlGN^Hx)*;sk+FPomv7*|D~}w`6nRK%VWsC
zV#RM-=_qV>?%(}Eh;b(yPIrj3hW9Lf(Tk_Ny@xmHfqCj9crlPw{g9J#6ePq-wbA16
z6TTsEh>SAilhroQ!<ynZf-~Q<q2uR`I^^MMlhaBolQI`kr1G272?+luwsXW<n;w)-
zQ+EFEG;sm_EBqZ5hNb^bx3^O)Cwq(%L!JL)icxf|ZedSEBNu^Sadn*#bb#r~f6KYc
zRTZ_{g+CV5j4@rFv@Ll$6m09hZtdQFW#MfFj~3qU_?tKw5iHhj$5>acIzVOhU9_Au
zL0imgk4}v$$V8KhluA(`ah{ksBi#`*+8V*zIFLc8LG$D+&3>tDa>rlMur{(#!_i(r
zIU@>S{}V#hX-X!uH=AGDcM`%mo@7otD>~Sqa3~ZG`UHAnvO?ofW%=sr>GPhtc>cze
z_1jG|KhBu#1B6!B#dD_;Nw=o{9OKBxoCWh>kWak3F`2~q538TpHr0PBh(`Z&Rg984
zUK5ygKskS!T;^0gz`L9sayDP<;eHtsjP|px=%$3bG)tS(tGW@Md@aT`o0ZH1fvjce
zJIKyuf2Ujk`-X$mPz*;#Y*7|h7=xzRDe<VICZRx~ftG}ftxjHnjFQKBa2UF}sS;>C
zO(G2uW};<kE4`J6=WW{LWA*Yv>FFmh?*84m8Z1KlUibxZA@p!3;cwCMNqg8-2oxqI
zILs2f;<nwAuOHARf7L~0ox{HB=kGrmmK--`D#^M*3~<h)sLPa)j10)3j06)y3JhQr
zD@W~;PVZG0LG0BF_J#dgv+8D7Ovs?}x?XSPuBa3}GmF|psRT{2G@vwjf;GiLPQ{r=
zwmbpD)t7lk=}bh)vEMoWfo%tVj|b#Xw%!s*5tCmL;{C~9+foJ^*Q}!O^K^R8ckXjX
z4;!JE{IXEuH&!lLd(6Vo{_wHJOH<&=2LW_1{CBp(x}|Xn61Nr75ANkmv#};BbxA}2
z;vE)glc)~QL=`b>YjiScAMc9!%Q2|ziz<{O`<zpOR0I5K?(`hWcfP|z9ncTrf@(v4
zj)t*|qSzlS1!9_XnfLmFhE5PY-?7#c9il`Ee!sRNSxiB@tn0eh<<n79R!oKzmtP2K
zUik<!4b=7A|KkeY@vNzdLoqvnE<`<G^isU~EJVb-Ds{S1Q}ip_cSYJCU1-WGsvH_P
z(g!tK_JZjUHbuiqpZNr5LB=RTL;DRSb482h60*8V;}D_ky!tpy7n&09aO`t-w3&k=
zRuj+>9#%)*E|1y2|8eix^kXdlKb%hi9}$-S+uHqE*x7(7N51cuz$Fbn&gP&!7Izt<
z)_x1YMKe7b$?b{`*F@okl^5A$r&-QmFN6OhI~UM&lUJ?sO`2(WNEQtb!5U^?K#0@f
z!uJn@`8;HPQCPLw-{BCM2caQBxv~sWo{DoZHK+pMzm#rioUS$Z1fmoC=|#y?WsjC4
z$s&H;7>MkLQrL@0>LR3nch&<=r0KB#NGZ1D(bD{2m}h3dvjj7So($3n(Q8H#?NCU)
zgu|Hgr5dTDF+B2w+x_(!Vm3PX(94X`ym7fvnKqU}RNmZZloJsMbQs=cX<+Ye4tXed
z^!<Tdb?4@g0Qg-9LGn(zaT3Z-O`Gn|Bu5}2tKHCGx@*(t%Wim5P)m_(Xw_LaO+!Vw
i6PcYK+myY5m3iKFX2%j*M%)bzxwVr@d{;aDfB*nQGusIO

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
zcmV-056|#YNk&E}4*&pHMM6+kP&gnQ4*&qrIslykDu4ih06uLll0~E<p_dD8j6ep&
zu{G_hM}fE8G_R-ghPA(<;aNA9(Em;9*Kenq-`cNNuQ*NmE$O=WFUELJ<QLWc-G5!@
z84_;H|5fXQ`9A*sGHM0uU-CQawmZ-x+%K<x!2a*-Q}MoJeVO(E{af+3@J00RU@y|%
zh+p`BrSwDfSM3kLck}P;zxF#Ae&hQ=e$pe_^u{vf^+At13wRzekjN~=1MT)6^1pVu
zqNa|_6I@o=b6|_W%yYU$IzA*3&mG9;#p$L>HSZk7)3n3gbK$TISR>t6^SW0uzjuVW
z=~g&~b(HXUH4^hSHi|-+w2xn>wL?<6xjuR7E48MK7*F)jXGyLus@BhbbcR-n((qe`
zSrLY-8@V>b;_NSR+F5n4qBp5lI2xRx;_*Rg^2REYT;p{y;{tpY6ggqphX;PTY(Td`
zram9(&TV%)6<_yqLP5V@5wC~!tzmCpfd`<1+LS#&kK*m7Z^X?Ng`}`7I{^LDF1{mc
zINrupWn_}e9Nc13Q4ep2(@5}ri}X!g$sK5!mF!-9PR~KX|BdQwQy{~<px}s4+HFxg
z8I#RYU8r(m!^nE$Tr)LGZO!RR_I>+}2<h1Tc>PGBT9nlquz&#mZhRggE^Buq60aBe
zl3#N_3~X=n{=wpq582jz-ly^Oo*4!{esl+TS5)2C3i|3Sd7VOCfkyD0!5owGcvZBh
zwW_Z8Z1K(GZctzR5X;|)^(*P+r4~?G_{i}LH<&k6ZWNH3q!$}*d-?6qIkfF6^H^ib
zv5bOb^vj7~p*kTuW~$o0`|?kqMNHWL>L5>bFk``-vGM76F?5fD7DEu^rk`FTTAE3N
zECJwa&@#AM%PZd|ZAj(+pG4a-Y`%w?_5q$yk21}wocGFS9z!V%y78*ZP=}BOp=6YW
zgY@c^MZ5NdH&LDtbi@hx#2z)kiek&2z&mu6ONtlWh2|rbj=_QF%_7$BMxN$-b$^X!
z1vK^HjCiFzmFL$89zOYu8WEv;I+X+UlFz7*SyX`Z2vC2$RQEI#Gix0c4wA@&;g+sM
zBERz}{Ul*Wv){8Q;OC<5slOxrf4rU_djcJ2Qyr|M2AZYy#9`n66PK}RlKqgAdOYGC
z(|m}X+tmaA1heL}6BzjLPEM?dnU3MU$H{WnId~^7nfgeVyLJPfX);na<J9BQZQdhl
zg}y*rHe8G;(CW#CR1ur5++RdFC3}hu)a1rUA1*DX^m}nT;Hj>9keY<seQbi`<|DY2
zPjAHExWZxd64B>QVj0`C>0I*}H&VgAfD}3YI?C)`CT~r5CZA+LIl_>USHdy+-Y|BG
zC2)Bg`p}FoAos;9CUaNJ66e$YVJi(^I0@lTR<uhR&lso$`gnH=B(LD;mlf3vn&0jM
zz@}rsNdOTQhQpHTYq@TKa!j-m@M1OPY{ae@YZKeT5iD7*77iXep`5Epkf9TJ795lg
z2?>UV`VtWsPs<s+WBHJ%>`M!a`x4v9Ju-)>d6!kP1o!dyG)WLr1=?ih5|kJCv)zJX
zj(|qB-tz8H_+?c5pwb!d*Q7yq>lPMgbX9*L$u&;@I8|o}K}`zN!dowM(PZ(NZA#6E
zRyui&<`4P*@D4-9mD&wxNI{*i#z1~HME4$oIb)J#T}%PDQPQ3-8Y7yT=O}1!5VW#|
z#3kQ#0#_;KG0|mczl^&r=cheMf>T~9@9Utx6%r@-i`Z}hyXY8EJySV+|N0o1rYIh}
z!yY`>bYsK%sQcY!H?kJApT;lQ0h$PEpJV6nu{@1%Tufb6Pye{6|6C8D-`2_O#!(Ua
zdds9>MV=q?2q4Ob3T^wIwE^aDotGPi2&qgb@bM`@-3*ntn&->v3qp1$LyJaFBKRk=
zy}-x%!7DAak)IpXel5NVmF<H?W6sC_xNYil*=tY+)r<fJbKqdqX{{YRjm<bzIS@pg
zslxSbNw$5&K0M_3=d`pF*fVwk>0PwF;Hp2;y1R0HN&~c~YSJ+Hud&^ok`=UZ1aY;P
z_DBmt{SePhw;ZG%>sVkctF3?(4c^OU`t|rzav&1U*;8qIooA7<;`njmE)^0QFouRW
z`JG3$CYGLAJp}KIYr5m=>?tGz#HIGK>S$@W`6-@Rltpo-wi_ZI?(A0A8TR?+S@<9h
zO_PqLp^LDlU$hg09d+ZyxLZHQ!xdKXm#ao4nLh?zKg$(ZW{1Xd&=eJCHo=uEC>j%}
zoJ)#e@4qXJk57t5gzX$1^}pk4LS*z`XszQ#{`Ie$69-656^kEr<P&}*Ns29KKzLv3
zK}9Zrgn~*ng}Ob^Mg9DL#sasP23O2Lp$_D4J)^+KH>h*40nZg8OKdCQM>hQ>UGt8`
zkMb+~hynQ711%g=<;j&9eslmb*R;j1f@?$Rg67~$ZU8hwewD%(si@54ex=6~x;!+(
z<I@e@CE$;X@nkiPIluCsXBg0S|5_h*9Q<SkB<WhW`s$jpr;oKO7Mn-=AEBJMng`JL
zDU_1p;)Y9w<p#H8%|5^#y$e0N;blN}YM`F%gF;!nLALGarT3_1s(QAxnCQq;c%HZT
zkk;GvT0CD&%vPEHZa?~P4Ig0I7{b$93Jv;IZR$%)K>vW@Y9M$2;nN1dLuxqJ4rz+*
zBj_fBCf=*ZQdZQ-SW$iY?b?2Y0#cU-1(ilgNa-CpTcSW~R6x&K>&L7-<7ub)`~Y1@
zE-e&Noc_drUW6-~9NqCaB245KoAKG(xabvNRd{CuwCX-F(%N>zY#enUDYssF+@pyF
z#kJ^^wE)yxyALyepCjHP^_I(v7k6i{=?=elB(0;@c=8%3$QJJ8=@=TMp@vAELWFM7
z_UN*&Sfc7gyeSRkb<G;o`GRbCqNK=d92H;w`6O;WZH)2TM+`}8jp3kjg5lRgaQoxN
zOqr9!5}-{KVmhRDd(@23^hVoo4rA+sb@vji3H`Qc#@+&7*?GD|G1!`bgyxnxs~=#U
zqBZ#`<^@;hb(VGba>sr?depD<=bdiUIUrmhs+d35Q-D<il>ZC@?IsvX!h`K&;7jrE
z<4|ZTHY=U$SQ(E!%O!E)Mj2kheN?|H*!QrgrOl;ZAuM%U*std^n+KQP7eN`aN)<=S
z#I+Dt<92V(kJYLJuVF^=ZKYq?%eFM;<Y$>a!sjYrotHFM*kftasRwOPmt8BZnlwRE
zGFabqQ^m3?yPx|niV@`gqLenG;hLT>B)<-g&zk;aobHGe=!n2fcwbL+oo3SiJuPI=
z)y4G1?0p)qV<Rmia}<P()dv04aax#n3W=aBTzvt}RY3H{{PIQyNadLsJAe@iuv&F~
z1j~S~H#8QXZvb(cSy589L(}f<p;_6%X_a8xbGwM}xPs93!yVZN!hrE^j*SI*pnzVW
zNQkDN@Iv{u)xLU89)l@8S_}4*(hB+=%5(9VyrqQx$dq!_XUe_CZbl=kl?;bqQl$7c
zRY~8Dfe1q>h1znxCgm-2@*q>KH9vP<7sM(U(QZ!}PWS?iyT46Qg#?F@w+OhY^UPsO
z6g)R;jf_%{=%Ef^SDeV{DyzVv=ddtAA3Ltt>FN#-*Q)UtD{HB?Wp5Nc3?%UUr{@r}
z_<-y)!|&KE_>QR&Eeo`e45?5#^h}Jk$Yi9~S|)yWTUV{*?yYz^3IA=tEI@-8kZAcK
zlhzR3Z2h#(?*v!f0rJ4LmT4kk%yoyuYV!uayNHRa!@$rl#3*Y05uU?WID}g;<UA0B
z*X9V`2z&^vDD`z)G?GTtGO)s9b{wRt?|`7iwy<)(<s%Xr3Nvq3vc%dy=>ybzN=h_8
zfwnI%Ei**40KdPDkf&aI?c?abxmmEmY1t(-x!$e48I;)z=rb#urGRMC=TJN@R3a>Z
z^q<k<Nd!N5j;E0sb4sgD2g!bM_ym}X)TVxOcp7<7h_Nwm!#4I~M~it`!OKLE=Xk)X
z(#6?=N{@<Khhlh3B&&Bp)-Uifb$=+x&+&AB<c4myQKNPrc5J(Ya?c5kj%+0Y?*L(g
zyhrD8{9FL39J2X0NFVYJEw4AP_Q|G;aT)D#br`+dYh*P)k+K(&69Kd8BB==p_&B<)
z%vgac`h^3}6a^~izYf8pVZZu4vOi<S0ZZ>mCyvK^)X!5(KToe1Q^+aJ<=YQbSF?f=
zvm$cAVUlCzU&+^B{Dn391=ot6wcHRJ9r5-sYu=)3uSQ?D+?Q~Ks)(bQX1?Ih8=#H+
ze#Tf1=cYGRG9+>hT)=YeFuUF8K3bsB9iJCH?dTDrN4uhU+<((}$0bZVaLhjNa6|b|
zoI8yP)XL#6$hrUePLk&ytAE%jykWPeX773*s0n30s|$!^Z`uZR7KM>e;~BEm{V1zQ
zG}L|DG}rI8+J+UL(1b*hJA*+D+UwEDntwg6iG%pxf0HkXR;3Fy;dEZ7f=b=IB`2Ka
zbkYf9uJ3pMrsA2shoqu0{-VDMw8+Wgs7_gEk^|d9>Tt!`g>hRYd;@$E`oC`6xo_^b
z(EcF(9<QaBZTV2>K+o5^DRMG33-`VQbsiml;g;nO|DX6+7g}hB)!d2!390;Svi;Pq
zTfhvV%3c<SgKTfw6$)W}aTqBG3DOipyxt5WLoAFG2>%WmlD4Nj9c!w#Z!h1Zv){_b
zYd=LPYuAkgEi}l)LH7iIqi3r}@_I}e7IEfd1<l$$AzRMB#y&REK;GH-6x$PMH~2&-
zNl`Z6N(tb5ikNHlBSGJEJtg6`YU3pzZ823~!)^zZ_y>D2q8isKg?6v(P%pm=altYi
zYGP6I@ch;3K(#ule7=&yZi9t@^2fXCViJIbYe-$EBp$~Hs@v&@=V=mNH1GWdNzm?o
zN%1Xv9c*)?+6O2u;At0Qy^~_+lZ}iMrafFMR#?m>9Rn%}wOyQ$tAjX$9Mt{g5b#r-
zPk!%bD)!m6tdyIbp!M%e{)?vcGZ}xoNdb&UQs(e4vw$k9%F+N1KgAL-k~-4v!$_p-
zfmkA79Outxi^<ScVkn~_S!$k{ND2#!c<cg@XwcYi#-wo-p9<{IN99B`KMOazmU0J(
y=e>ihHO%wx`X04Ln#|`LjgYWmSe0R99ub4DRltdZb7pPwWT1nD2^|#ehyVa4_`Em(

literal 0
HcmV?d00001

diff --git a/docs/handbook/show_hopper.png b/docs/handbook/show_hopper.png
deleted file mode 100644
index 1f2e6f243858d8a9944c4db0b1c0758111cc45ce..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 56122
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
F{{xhz)w2Kq

diff --git a/docs/handbook/show_hopper.webp b/docs/handbook/show_hopper.webp
new file mode 100644
index 0000000000000000000000000000000000000000..5cb73325b35ec9a322dfd02568f13bd124dddf69
GIT binary patch
literal 6548
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

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index e19da47a5..402f57f69 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 670/688] 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 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 671/688] 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 402f57f69..ffa8fa019 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 672/688] 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 f711865d5..529982dad 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 673/688] 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 d5dbeeb6f..58ac705c9 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -240,10 +240,11 @@ class TestFileLibTiff(LibTiffTestCase):
 
             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 e59c7311a..fdfeb60f9 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 4f9956087..6fc7cfaf5 100644
--- a/src/PIL/ImageWin.py
+++ b/src/PIL/ImageWin.py
@@ -90,7 +90,7 @@ class Dib:
             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 @@ class Dib:
         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 @@ class Dib:
         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 @@ class Dib:
 
         :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 @@ class Window:
             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 @@ class Window:
 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 31dfd4d12..cc99cd6d8 100644
--- a/src/PIL/PsdImagePlugin.py
+++ b/src/PIL/PsdImagePlugin.py
@@ -19,6 +19,7 @@ from __future__ import annotations
 
 import io
 from functools import cached_property
+from typing import IO
 
 from . import Image, ImageFile, ImagePalette
 from ._binary import i8
@@ -142,7 +143,9 @@ class PsdImageFile(ImageFile.ImageFile):
         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 @@ class PsdImageFile(ImageFile.ImageFile):
         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 _layerinfo(fp, ct_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 _layerinfo(fp, ct_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 _layerinfo(fp, ct_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 253f64852..1dab0d50b 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -445,7 +445,7 @@ class IFDRational(Rational):
         __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 _register_loader(idx, size):
     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 _register_writer(idx):
     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 @@ class ImageFileDirectory_v2(_IFDv2Base):
     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 @@ class ImageFileDirectory_v2(_IFDv2Base):
     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 @@ class ImageFileDirectory_v2(_IFDv2Base):
     )
 
     @_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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         )
 
     @_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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
     """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 @@ class ImageFileDirectory_v1(ImageFileDirectory_v2):
     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 @@ class TiffImageFile(ImageFile.ImageFile):
         """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 @@ class TiffImageFile(ImageFile.ImageFile):
         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 e318c8739..86adaa458 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 @@ DOUBLE = 12
 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 @@ _tags_v2 = {
     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 @@ TAGS_V2_GROUPS = {
 
 # 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 @@ TAGS = {
 }
 
 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 674/688] 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 6dd432488..776bb0dbb 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 675/688] 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 e2913e944..4958b2222 100644
--- a/Tests/test_file_png.py
+++ b/Tests/test_file_png.py
@@ -776,7 +776,7 @@ class TestFilePng:
 
         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 d6451ec18..0a61830a4 100644
--- a/Tests/test_file_ppm.py
+++ b/Tests/test_file_ppm.py
@@ -373,7 +373,7 @@ def test_save_stdout(buffer: bool) -> None:
 
     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 130ffa863..c3afa9089 100644
--- a/Tests/test_psdraw.py
+++ b/Tests/test_psdraw.py
@@ -59,7 +59,7 @@ def test_stdout(buffer: bool) -> None:
 
     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 676/688] 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 5402fcb44..e0f42a266 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 af24faa5d..d83d60b7b 100644
--- a/src/PIL/JpegImagePlugin.py
+++ b/src/PIL/JpegImagePlugin.py
@@ -468,7 +468,7 @@ class JpegImageFile(ImageFile.ImageFile):
 
         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 @@ class JpegImageFile(ImageFile.ImageFile):
         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 247f908ed..58db7777c 100644
--- a/src/PIL/PngImagePlugin.py
+++ b/src/PIL/PngImagePlugin.py
@@ -1054,7 +1054,7 @@ class PngImageFile(ImageFile.ImageFile):
                 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 011de9c6a..cec796340 100644
--- a/src/PIL/WebPImagePlugin.py
+++ b/src/PIL/WebPImagePlugin.py
@@ -96,7 +96,7 @@ class WebPImageFile(ImageFile.ImageFile):
         # 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 677/688] 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
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
Ve?A}dZ4dkJs-dYt`Q>|${uf4b-edp(

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index ffa8fa019..bc4339928 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")
 
-        ps = PSDraw.PSDraw()  # default is sys.stdout or sys.stdout.buffer
-        ps.begin_document(title)
+    # Create a PSDraw object
+    ps = PSDraw.PSDraw(ps_file)
 
-        # draw the image (75 dpi)
-        ps.image(box, im, 75)
-        ps.rectangle(box)
+    # Start the document
+    ps.begin_document()
 
-        # draw title
-        ps.setfont("HelveticaNarrow-Bold", 36)
-        ps.text((3 * 72, 4 * 72), title)
+    # Set the text to be drawn
+    text = "Hopper"
 
-        ps.end_document()
+    # 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
+
+    # 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
+
+    # 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))
+
+        # 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::
+
+    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 678/688] 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 58ac705c9..62f8719af 100644
--- a/Tests/test_file_libtiff.py
+++ b/Tests/test_file_libtiff.py
@@ -241,10 +241,10 @@ class TestFileLibTiff(LibTiffTestCase):
             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 679/688] 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 ffd1abd95..3ed1b5926 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 680/688] 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 bc4339928..4e7477143 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 681/688] 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
zcmV<K3la2ENk&HI3jhFDMM6+kP&gpk3jhFcDgd1UDu4ih06uLplt-i^A|WT0TR?yf
ziDV7GWr4H5Wqh59OHaT5p>47rU_WC$SpVgEoc{Of0sZ6qmsq#%cd!TR$EP>$N5N<J
zkNY3C{{dgK-~au9KmYoGUfSfmF2-60y=waR`maDP^l>@%W1vs=z7c+7>;e3%`zN6G
zbe^RD+3pGa-}?`yf3ct34`UzI&;6#dw)W68P0Rp`-FS!=yX>SZ55O~H(&xay;@j^M
zEbR3|e8TI{QBvNmok0bY($y#lFsvv|9^n}@i-L@rON4J4LwYj070r(|?ym@>p6)iL
zgayMKR`;0u!3T13LfwppG4vBn1Xg51G>!n0gx^r|^zR*gi=VfvIeR@7Ijzbw^3G?;
z!g&~M_+blkf**QNehC_UC8RpC4dIW8xzrq;5Y=W-*IMw1<A}y(%9GNh-+s$oo1z-x
zxEEMDhxkbjUM&Cs{`{6*2`k++XNSB^;^LysUt_Mqa!69}eescUz%C<ELhVFeJAxi4
zGY9><Y!6N**;9#;^WO5K^RBvKrWs7XVA?E2m3wo+`+n@N^YJoEvE0JG29Ku5p7f{-
z?+|#P2jdobe&=V1{YI%#9Xb@|=gW?_rjI%`*Dbg%5KY#tya*PDj!Zy(=o$3rK|RKr
z0w`d1iMg1uYk~P!GhM=l;3wwE2u*SS+FcjnSYdo<jFcD&tD(%|=%<DT2!2`Z<MN9G
zg3Zw_fR?6JeH9=`V0T6u_vuaMd}n>JAkEDf!ZuS~@hF3FfvO|!MWHq&qgScV{v8o1
zcaIeZLFU@egB`1l%UKVS!A?tVIPpolIWK+<2YWlb@&qEn!|hcLiT8^^A0tdHCThCA
z09S`Sx}EU?@B)0{d%JN|G}G`oV>#%lp!+o}FR2I(Wo3m~=Q3YBn!h@ppmLhW;^^}x
zE>b0+dY?^V00gmK?N9{_?az*LU2k$INR`3V+BUUdoKmGZc-w;fx=h(OSir_*&tE2#
zMGD|WI2=o7hiO+?+f&WQ&#Y7zxQ6Z?*ZqgUfXpwUCSHiOU}1ar*!{2Pw&SXvH9ab0
z1GzPRM-@JhJQe^jb1ArXnO}1}$-S9C98$=4Cy$NAG5BEI&t~ZAkN2ji9k(V`>l*?&
zX!!5pfnkzyMUTmg>1Ri;STniC;xsY&Pppcr3xG}#^ZNVTFOZx*!}`fIuTk>5^xuK|
zYb><PRIVBI(5mX-kD{MFhapG>eTf0TV0mOeuDKZK;r(^1Y&%6f3qKkbjKnFO=rB%Y
zjU>1NX+jU1ceo7iVJPm|i400BN4!H6*gC^#O!>_uKwN`Q28m3yoTkD&x3#?mM@}za
z{}hrKU16Hs9Z7p0VdNin^M<y5iQb|SUS%eF>1qy>VYDkLlyV-2$ku|rF7LkDqBdAL
zk6o8zGYM;@sW1raZSBEHjJgZnQCd5qpEU{BZ^;QwXZ=p~A<UjQ(vC*RF*`D@^1`p=
zB`5;#*w3U1rgj@zssQ9047yyu(B`N5!#1QkyhGd5fQUd{Q5+|@5*A;up9a8ipZzn(
zSn-kcnn<35g+c(<?f(!~1;Q|2A)L~gZaX?K%?iY=@|mCEVzz4mW3WJdysU+b2OYh*
za@<?zvcMm%OP@<z9anqOE+bDl?i9}tjhg>KJdOIkG@5+gT+OT0WMfwm%?>e$|I3<&
z0u(S7;_<9Ktp*#U<3;XITVpT9PU$S@MlYQ1tb>$586T__XDxTJ@pN;a>}Zl;tdO8;
zHb&zTEO&~+yO`5iK8>Js(D$^d7VpC1?dG+EWVo;sNKN4S)dUwCpNPR2udjQmkoaSf
zuk)_32yajiN<HZDnQRmfxdil6Oe?V1?Cb*iOr^B>E+(j?xeGJe0W-U8!^Zo$O3-T8
zT}4MElV81LM@c%!F8w~NWn3jl>$U2=$>kDaD)&o~pKk?twAEBI01u+g%OFx=#Owdw
z^=E0By`&nT?dIn7LO|kTSx0EWP+2Y#V%%Xug9l>PRkl|FnErYWd~ev|P%RJA0!d5W
zovCz1opC%!VYu*;GDK5WUY^N}|4EytjQ3HmpN~U`3Qrmw24ZD88Fb@Ve_O07nqD6m
zG}E%U+X|JQ;^%a;i@sOkE)Z6l^-7tWqvY5B@QYIE0HbFDBIj-e5@-qw@t(8SMV#?}
zc_&bRLk?2kywoCN0I<tk0GRVS^ynMRDz?1=f5S`hd(h0mZFD}S16j~!w{L<O1SjBs
z2nyYIWZN{+X3XHOnhWW+MLe@Ujt|n^01h>4672g#yHSDMAI<?wB`dGIKlW5@XFW?!
z?7!f#x?Vx8m*H=>d^Oy-z_BpS&anA5w|xV%xUVPTApftj7sk#|hO|rdhp<^vw!M<e
zDq~bFrYFW$7WAVVdTv-MZu~M0UB>I^Wyx0p`-^*DP+6^ocG(fo)RRL<b92=|X}<AQ
z;e8aFeos3BN09$--%;oCv?$D=BgvG$ZY9{A^pmpYyhLY7_crT>%G5+RYsE@Slkz;|
z7LZQ|kj`0R3G-z%8p{%ji&B9t-yV!B)zWPq5UF^~^q&~qSOINQb+p0OPJy@yXV-NE
zGSoz5PbaG%crWh@>M-0R!@P9PefSa-a&_|mY}MY1>t~e&eLJkFgrZSoz~uho04x0W
zp=hSgSou2wSFH`4onyeGDAqkB%Me9BT1?I`s1Y64fQ?R%(FF*DPwjR3GgcDnvrpKY
zPZUFinVQo7=<{la0<~Q;jAUZ#Ys{rp#yy)hVSTa3+oe1<wue_}i}>aALt;k%@25J5
zjm7O!{8XOvFb912H5nFF%3T0rM!X{JcWcv0rgOwB#^c0YejD#*?xQ(MTy(yMEHM?$
zp3+F~)W{6z11;Z?YZvnDMyz|Y`a{WfKM-3V5F!(wcB~-X#pmXf*47E?6CejH1Uk-N
zJ%%kKcr-**RE0;y#VX$jTJ(5&;-B~d#<wf(hYv88#<opU=O5@yuKhovi;Qv@<9FoM
z(J<sdA47a%=r8-*^9R$m2Pkz{!Rpt4Hl1E{K7}<p_qYlhC!k7ZyG`{&*(zF;I#65w
z*Z^Nte4es%4YP)JD@9hxt)f8dK8n#V{ou6i;RQNe<@wrtwWUMn<U#rd_yj<V8IWfq
zR~uVjA>@cIq3MVLv$(MPzDEjCS&UD>#c22t^tw?0%=#{6>x9zz61(U3`PuI6`E?a6
zBMZokz^el(F`QW40EQVcU0x(Hz8}Y7x#Hr@Iq0)`Uc&FtcjG1=M)>@Gz&%1+X<2PY
z>~Cq8>yK6^kHXmACQ@y(aTudq^ZisW>nnx*vjC6veN!y0H43kLSbs?~K4>gN1b+)y
znSCr!z{QiaVlG#2<aH(&Y8%7&gcloonn(N`^&MkUNB_z3%>;Go26Z)uTN7IzQV^!q
z<hl~YZ~->#s}m6{Wo|+!H;VN&RtY?HHpGN597E=gZn~7{6Ih}DT$&5ISe@YGho?o;
znnCMGtt%Yw<{m@&^@;(&+z=*j1z1%wf}j0JB^EDxd#??UH4dZ?vj^65%h~=)#^Rjq
zFK$So_>TC+{jVz~q{}1DcLBW%n#{D8_FVdZJtsbhkDSLo2V=I^fpU57`k5tLV3ii_
z05VwOE>9|T^hxkuQm@E|plOjDhXDp=_YvfT1>nifJVwTj_GX@BteACxhr+vBv)3;k
zB<$5j@Lr5b#F=&RL^6QAQE)-BXR4!=$Wz%JEQ#Qbr0{RAexuQzz&aUT<C@xp+qM0z
zztd@g^_<^J@+)ra>Wlpiz~~6O{uC#^Gr?8;x`_VL$G3XsTve!DXWJ5ns{U$;X{rrc
zxG)D=uHj8t+R%py;yFE<`u?u;DhPHQWoBQ*ERWl%xEp-jI>ng|{aONgB1gJ;dA!`y
zTsS7ADg06`xE!Y^gHZ5;Vqv9mBeEKGwIP=K+BkwDFuZolUT%mN1WpE%Ef{wJ&2@>)
w5c-9pVY9~3bgEKt8x~>OZ~cTe$M@JyGI$PomYcJ|=A5qQ6_mLXx&QzG0KmWb@c;k-

literal 0
HcmV?d00001

diff --git a/docs/handbook/tutorial.rst b/docs/handbook/tutorial.rst
index 4e7477143..d8a1ae9c9 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 682/688] 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 d8a1ae9c9..fead6fb21 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 683/688] 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 fead6fb21..c36011362 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 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 684/688] 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 2b3620e71..ce8e66571 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -623,7 +623,7 @@ class ImageDraw:
                 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 @@ class ImageDraw:
                     )
                 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 685/688] 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 197ef79ee..9eaabf18a 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 6bc762816..8ef0d36f7 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 686/688] 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 68705094b..9660e2828 100644
--- a/Tests/test_file_jpeg.py
+++ b/Tests/test_file_jpeg.py
@@ -829,7 +829,7 @@ class TestFileJpeg:
         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 3aefa073c..d0e64a35e 100644
--- a/src/PIL/JpegPresets.py
+++ b/src/PIL/JpegPresets.py
@@ -37,7 +37,7 @@ You can get the subsampling of a JPEG with the
 :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 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 687/688] 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 997809e46..567ddaf13 100644
--- a/Tests/test_font_pcf.py
+++ b/Tests/test_font_pcf.py
@@ -2,6 +2,7 @@ from __future__ import annotations
 
 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 9cb420371..340cc4742 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 edbdd9a32..d9d9cac6e 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 e4cb17c4d..2fb4ff8c0 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 b76f3c24d..0940664f3 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 9d901e028..aa5eeabb2 100644
--- a/src/PIL/Image.py
+++ b/src/PIL/Image.py
@@ -218,6 +218,8 @@ if hasattr(core, "DEFAULT_STRATEGY"):
 # 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 @@ ENCODERS: dict[str, type[ImageFile.PyEncoder]] = {}
 _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 @@ class _E:
         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 @@ class _E:
     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 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
             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 @@ class Image:
 
     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 @@ class Image:
 
         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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
             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 @@ class Image:
         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 @@ class Image:
         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 @@ class Image:
             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 @@ class Exif(_ExifBase):
             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 @@ class Exif(_ExifBase):
             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 @@ class Exif(_ExifBase):
         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 ce8e66571..6f56d0236 100644
--- a/src/PIL/ImageDraw.py
+++ b/src/PIL/ImageDraw.py
@@ -36,7 +36,7 @@ import numbers
 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 @@ class ImageDraw:
     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 @@ class ImageDraw:
     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 @@ class ImageDraw:
                 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 @@ class ImageDraw:
     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 @@ class ImageDraw:
 
     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 @@ class ImageDraw:
 
     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 @@ class ImageDraw:
 
     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 @@ class ImageDraw:
         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 d260eef69..24490348c 100644
--- a/src/PIL/ImageFont.py
+++ b/src/PIL/ImageFont.py
@@ -34,7 +34,7 @@ import warnings
 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 @@ if TYPE_CHECKING:
     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 @@ class ImageFont:
 
         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 @@ class FreeTypeFont:
 
         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 @@ class FreeTypeFont:
         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 @@ class FreeTypeFont:
 
     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 @@ class FreeTypeFont:
     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 @@ class FreeTypeFont:
         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 @@ class FreeTypeFont:
         )
 
     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 @@ class FreeTypeFont:
             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 @@ class FreeTypeFont:
 
         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 @@ class FreeTypeFont:
 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 @@ class TransposedFont:
         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 @@ class TransposedFont:
             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 8cccd3ac7..998bc52eb 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 5e97b40b2..9cc9822f5 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 688/688] 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 88c30d468..b0ea2bf42 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 aa5eeabb2..72d167a8a 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 e89a78be4..c0d89e4aa 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 @@ class Draw:
             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 @@ class Draw:
             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 @@ class Draw:
         """
         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 @@ class Draw:
         """
         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 @@ class Draw:
         """
         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 @@ class Draw:
         """
         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 @@ class Draw:
         """
         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 @@ class Draw:
         """
         self.render("polygon", xy, *options)
 
-    def rectangle(self, xy, *options):
+    def rectangle(self, xy: Coords, *options) -> None:
         """
         Draws a rectangle.
 
@@ -172,18 +175,21 @@ class Draw:
         """
         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 @@ class Draw:
         .. 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 346fe49d3..a2d946714 100644
--- a/src/PIL/ImageQt.py
+++ b/src/PIL/ImageQt.py
@@ -58,7 +58,7 @@ else:
     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 16a18ddfa..17243e705 100644
--- a/src/PIL/IptcImagePlugin.py
+++ b/src/PIL/IptcImagePlugin.py
@@ -185,7 +185,9 @@ Image.register_open(IptcImageFile.format, IptcImageFile)
 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 1dab0d50b..ad050ffe4 100644
--- a/src/PIL/TiffImagePlugin.py
+++ b/src/PIL/TiffImagePlugin.py
@@ -584,8 +584,10 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
     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 @@ class ImageFileDirectory_v2(_IFDv2Base):
     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 @@ class ImageFileDirectory_v2(_IFDv2Base):
     )
 
     @_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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         )
 
     @_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 @@ class ImageFileDirectory_v2(_IFDv2Base):
         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):