.ci/requirements-mypy.txt

@@ -1,4 +1,4 @@
-mypy==1.19.1
+mypy==1.19.0
 arro3-compute
 arro3-core
 IceSpringPySideStubs-PyQt6
@@ -9,6 +9,7 @@ packaging
 pyarrow-stubs
 pybind11
 pytest
+sphinx
 types-atheris
 types-defusedxml
 types-olefile

.github/renovate.json

@@ -6,7 +6,6 @@
     "labels": [
         "Dependency"
     ],
-    "minimumReleaseAge": "7 days",
     "packageRules": [
         {
             "groupName": "github-actions",

.github/workflows/cifuzz.yml

@@ -44,13 +44,13 @@ jobs:
         language: python
         dry-run: false
     - name: Upload New Crash
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v5
       if: failure() && steps.build.outcome == 'success'
       with:
         name: artifacts
         path: ./out/artifacts
     - name: Upload Legacy Crash
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v5
       if: steps.run.outcome == 'success'
       with:
         name: crash

.github/workflows/docs.yml

@@ -49,7 +49,7 @@ jobs:
       run: python3 .github/workflows/system-info.py
 
     - name: Cache libimagequant
-      uses: actions/cache@v5
+      uses: actions/cache@v4
       id: cache-libimagequant
       with:
         path: ~/cache-libimagequant

.github/workflows/lint.yml

@@ -23,7 +23,7 @@ jobs:
           persist-credentials: false
       - uses: actions/setup-python@v6
         with:
-          python-version: "3.x"
+          python-version: "3.10"
       - name: Install uv
         uses: astral-sh/setup-uv@v7
       - name: Lint

.github/workflows/test-windows.yml

@@ -112,7 +112,7 @@ jobs:
 
     - name: Cache build
       id: build-cache
-      uses: actions/cache@v5
+      uses: actions/cache@v4
       with:
         path: winbuild\build
         key:
@@ -188,9 +188,8 @@ jobs:
     # trim ~150MB for each job
     - name: Optimize build cache
       if: steps.build-cache.outputs.cache-hit != 'true'
-      run: |
+      run: rmdir /S /Q winbuild\build\src
-        rm -rf winbuild\build\src
+      shell: cmd
-      shell: bash
 
     - name: Build Pillow
       run: |
@@ -207,7 +206,9 @@ jobs:
 
     - name: Test Pillow
       run: |
+        path %GITHUB_WORKSPACE%\winbuild\build\bin;%PATH%
         .ci\test.cmd
+      shell: cmd
 
     - name: Prepare to upload errors
       if: failure()
@@ -216,7 +217,7 @@ jobs:
       shell: bash
 
     - name: Upload errors
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v5
       if: failure()
       with:
         name: errors

.github/workflows/test.yml

@@ -92,7 +92,7 @@ jobs:
 
     - name: Cache libimagequant
       if: startsWith(matrix.os, 'ubuntu')
-      uses: actions/cache@v5
+      uses: actions/cache@v4
       id: cache-libimagequant
       with:
         path: ~/cache-libimagequant
@@ -143,7 +143,7 @@ jobs:
         mkdir -p Tests/errors
 
     - name: Upload errors
-      uses: actions/upload-artifact@v6
+      uses: actions/upload-artifact@v5
       if: failure()
       with:
         name: errors

.github/workflows/wheels-dependencies.sh

@@ -267,7 +267,7 @@ function build {
 
     build_simple xcb-proto 1.17.0 https://xorg.freedesktop.org/archive/individual/proto
     if [[ -n "$IS_MACOS" ]]; then
-        build_simple xorgproto 2025.1 https://www.x.org/pub/individual/proto
+        build_simple xorgproto 2024.1 https://www.x.org/pub/individual/proto
         build_simple libXau 1.0.12 https://www.x.org/pub/individual/lib
         build_simple libpthread-stubs 0.5 https://xcb.freedesktop.org/dist
     else

.github/workflows/wheels.yml

@@ -134,7 +134,7 @@ jobs:
           CIBW_MANYLINUX_X86_64_IMAGE: ${{ matrix.manylinux }}
           MACOSX_DEPLOYMENT_TARGET: ${{ matrix.macosx_deployment_target }}
 
-      - uses: actions/upload-artifact@v6
+      - uses: actions/upload-artifact@v5
         with:
           name: dist-${{ matrix.name }}
           path: ./wheelhouse/*.whl
@@ -186,18 +186,24 @@ jobs:
 
       - name: Build wheels
         run: |
-          for f in winbuild/build/license/*; do
+          setlocal EnableDelayedExpansion
-            name=$(basename "${f%.*}")
+          for %%f in (winbuild\build\license\*) do (
-            # Skip FriBiDi license, it is not included in the wheel.
+            set x=%%~nf
-            [[ $name == fribidi* ]] && continue
+            rem Skip FriBiDi license, it is not included in the wheel.
-            # Skip imagequant license, it is not included in the wheel.
+            set fribidi=!x:~0,7!
-            [[ $name == libimagequant* ]] && continue
+            if NOT !fribidi!==fribidi (
-            echo "" >> LICENSE
+              rem Skip imagequant license, it is not included in the wheel.
-            echo "===== $name =====" >> LICENSE
+              set libimagequant=!x:~0,13!
-            echo "" >> LICENSE
+              if NOT !libimagequant!==libimagequant (
-            cat "$f" >> LICENSE
+                echo. >> LICENSE
-          done
+                echo ===== %%~nf ===== >> LICENSE
-          cmd //c "winbuild\\build\\build_env.cmd && $pythonLocation\\python.exe -m cibuildwheel . --output-dir wheelhouse"
+                echo. >> LICENSE
+                type %%f >> LICENSE
+              )
+            )
+          )
+          call winbuild\\build\\build_env.cmd
+          %pythonLocation%\python.exe -m cibuildwheel . --output-dir wheelhouse
         env:
           CIBW_ARCHS: ${{ matrix.cibw_arch }}
           CIBW_BEFORE_ALL: "{package}\\winbuild\\build\\build_dep_all.cmd"
@@ -211,16 +217,16 @@ jobs:
             -e CI -e GITHUB_ACTIONS
             mcr.microsoft.com/windows/servercore:ltsc2022
             powershell C:\pillow\.github\workflows\wheels-test.ps1 %CD%\..\venv-test'
-        shell: bash
+        shell: cmd
 
       - name: Upload wheels
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v5
         with:
           name: dist-windows-${{ matrix.cibw_arch }}
           path: ./wheelhouse/*.whl
 
       - name: Upload fribidi.dll
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v5
         with:
           name: fribidi-windows-${{ matrix.cibw_arch }}
           path: winbuild\build\bin\fribidi*
@@ -240,7 +246,7 @@ jobs:
 
     - run: make sdist
 
-    - uses: actions/upload-artifact@v6
+    - uses: actions/upload-artifact@v5
       with:
         name: dist-sdist
         path: dist/*.tar.gz
@@ -250,7 +256,7 @@ jobs:
     runs-on: ubuntu-latest
     name: Count dists
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v6
         with:
           pattern: dist-*
           path: dist
@@ -269,13 +275,13 @@ jobs:
     runs-on: ubuntu-latest
     name: Upload wheels to scientific-python-nightly-wheels
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v6
         with:
           pattern: dist-!(sdist)*
           path: dist
           merge-multiple: true
       - name: Upload wheels to scientific-python-nightly-wheels
-        uses: scientific-python/upload-nightly-action@5748273c71e2d8d3a61f3a11a16421c8954f9ecf # 0.6.3
+        uses: scientific-python/upload-nightly-action@b36e8c0c10dbcfd2e05bf95f17ef8c14fd708dbf # 0.6.2
         with:
           artifacts_path: dist
           anaconda_nightly_upload_token: ${{ secrets.ANACONDA_ORG_UPLOAD_TOKEN }}
@@ -291,7 +297,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v7
+      - uses: actions/download-artifact@v6
         with:
           pattern: dist-*
           path: dist

.github/zizmor.yml

@@ -1,5 +1,7 @@
 # https://docs.zizmor.sh/configuration/
 rules:
+  obfuscation:
+    disable: true
   unpinned-uses:
     config:
       policies:

.pre-commit-config.yaml

@@ -1,12 +1,12 @@
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.14.10
+    rev: v0.14.7
     hooks:
       - id: ruff-check
         args: [--exit-non-zero-on-fix]
 
   - repo: https://github.com/psf/black-pre-commit-mirror
-    rev: 25.12.0
+    rev: 25.11.0
     hooks:
       - id: black
 
@@ -24,7 +24,7 @@ repos:
         exclude: (Makefile$|\.bat$|\.cmake$|\.eps$|\.fits$|\.gd$|\.opt$)
 
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v21.1.8
+    rev: v21.1.6
     hooks:
       - id: clang-format
         types: [c]
@@ -51,14 +51,14 @@ repos:
         exclude: ^\.github/.*TEMPLATE|^Tests/(fonts|images)/
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.36.0
+    rev: 0.35.0
     hooks:
       - id: check-github-workflows
       - id: check-readthedocs
       - id: check-renovate
 
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.19.0
+    rev: v1.18.0
     hooks:
       - id: zizmor
 
@@ -76,10 +76,10 @@ repos:
     rev: v0.24.1
     hooks:
       - id: validate-pyproject
-        additional_dependencies: [trove-classifiers>=2024.10.12]
+        additional_dependencies: [tomli, trove-classifiers>=2024.10.12]
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.7.1
+    rev: 1.7.0
     hooks:
       - id: tox-ini-fmt
 

Tests/test_file_psd.py

@@ -100,7 +100,7 @@ def test_seek_tell() -> None:
 
         im.seek(2)
         layer_number = im.tell()
-    assert layer_number == 2
+        assert layer_number == 2
 
 
 def test_seek_eoferror() -> None:
@@ -138,7 +138,7 @@ def test_icc_profile() -> None:
         assert "icc_profile" in im.info
 
         icc_profile = im.info["icc_profile"]
-    assert len(icc_profile) == 3144
+        assert len(icc_profile) == 3144
 
 
 def test_no_icc_profile() -> None:
@@ -158,16 +158,17 @@ def test_combined_larger_than_size() -> None:
 
 
 @pytest.mark.parametrize(
-    "test_file",
+    "test_file,raises",
     [
-        "Tests/images/timeout-c8efc3fded6426986ba867a399791bae544f59bc.psd",
+        ("Tests/images/timeout-c8efc3fded6426986ba867a399791bae544f59bc.psd", OSError),
-        "Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd",
+        ("Tests/images/timeout-dedc7a4ebd856d79b4359bbcc79e8ef231ce38f6.psd", OSError),
     ],
 )
-def test_crashes(test_file: str) -> None:
+def test_crashes(test_file: str, raises: type[Exception]) -> None:
-    with pytest.raises(OSError):
+    with open(test_file, "rb") as f:
-        with Image.open(test_file):
+        with pytest.raises(raises):
-            pass
+            with Image.open(f):
+                pass
 
 
 @pytest.mark.parametrize(
@@ -178,7 +179,8 @@ def test_crashes(test_file: str) -> None:
     ],
 )
 def test_layer_crashes(test_file: str) -> None:
-    with Image.open(test_file) as im:
+    with open(test_file, "rb") as f:
-        assert isinstance(im, PsdImagePlugin.PsdImageFile)
+        with Image.open(f) as im:
-        with pytest.raises(SyntaxError):
+            assert isinstance(im, PsdImagePlugin.PsdImageFile)
-            im.layers
+            with pytest.raises(SyntaxError):
+                im.layers

Tests/test_imagedraw.py

@@ -68,22 +68,10 @@ def test_sanity() -> None:
     draw.rectangle(list(range(4)))
 
 
-def test_new_color() -> None:
+def test_valueerror() -> None:
     with Image.open("Tests/images/chi.gif") as im:
         draw = ImageDraw.Draw(im)
-        assert im.palette is not None
-        assert len(im.palette.colors) == 249
-
-        # Test drawing a new color onto the palette
         draw.line((0, 0), fill=(0, 0, 0))
-        assert im.palette is not None
-        assert len(im.palette.colors) == 250
-        assert im.palette.dirty
-
-        # Test drawing another new color, now that the palette is dirty
-        draw.point((0, 0), fill=(1, 0, 0))
-        assert len(im.palette.colors) == 251
-        assert im.convert("RGB").getpixel((0, 0)) == (1, 0, 0)
 
 
 def test_mode_mismatch() -> None:

Tests/test_imagemorph.py

@@ -231,15 +231,15 @@ def test_negate() -> None:
 
 
 def test_incorrect_mode() -> None:
+    im = hopper()
     mop = ImageMorph.MorphOp(op_name="erosion8")
 
-    with hopper() as im:
+    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
-        with pytest.raises(ValueError, match="Image mode must be 1 or L"):
+        mop.apply(im)
-            mop.apply(im)
+    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
-        with pytest.raises(ValueError, match="Image mode must be 1 or L"):
+        mop.match(im)
-            mop.match(im)
+    with pytest.raises(ValueError, match="Image mode must be 1 or L"):
-        with pytest.raises(ValueError, match="Image mode must be 1 or L"):
+        mop.get_on_pixels(im)
-            mop.get_on_pixels(im)
 
 
 def test_add_patterns() -> None:

Tests/test_pyroma.py

@@ -6,15 +6,10 @@ import pytest
 
 from PIL import __version__
 
-TYPE_CHECKING = False
-
-if TYPE_CHECKING:
-    from importlib.metadata import PackageMetadata
-
 pyroma = pytest.importorskip("pyroma", reason="Pyroma not installed")
 
 
-def map_metadata_keys(md: PackageMetadata) -> dict[str, str | list[str] | None]:
+def map_metadata_keys(md):
     # Convert installed wheel metadata into canonical Core Metadata 2.4 format.
     # This was a utility method in pyroma 4.3.3; it was removed in 5.0.
     # This implementation is constructed from the relevant logic from
@@ -22,16 +17,16 @@ def map_metadata_keys(md: PackageMetadata) -> dict[str, str | list[str] | None]:
     # upstream to Pyroma as https://github.com/regebro/pyroma/pull/116,
     # so it may be possible to simplify this test in future.
     data = {}
-    for key in set(md):
+    for key in set(md.keys()):
         value = md.get_all(key)
         key = pyroma.projectdata.normalize(key)
 
-        if value is not None and len(value) == 1:
+        if len(value) == 1:
-            first_value = value[0]
+            value = value[0]
-            if first_value.strip() != "UNKNOWN":
+            if value.strip() == "UNKNOWN":
-                data[key] = first_value
+                continue
-        else:
+
-            data[key] = value
+        data[key] = value
     return data
 
 

docs/dater.py

@@ -11,7 +11,7 @@ import subprocess
 
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from typing import Any
+    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")
@@ -28,7 +28,7 @@ def get_date_for(git_version: str) -> str | None:
     return out.split()[0]
 
 
-def add_date(app: Any, doc_name: str, source: list[str]) -> 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)
 
@@ -43,6 +43,6 @@ def add_date(app: Any, doc_name: str, source: list[str]) -> None:
         source[0] = result
 
 
-def setup(app: Any) -> dict[str, bool]:
+def setup(app: Sphinx) -> dict[str, bool]:
     app.connect("source-read", add_date)
     return {"parallel_read_safe": True}

pyproject.toml

@@ -217,7 +217,6 @@ testpaths = [
 python_version = "3.10"
 pretty = true
 disallow_any_generics = true
-disallow_untyped_defs = true
 enable_error_code = "ignore-without-code"
 extra_checks = true
 follow_imports = "silent"

selftest.py

@@ -76,7 +76,7 @@ def testimage() -> None:
     ('R', 'G', 'B')
     >>> im.getbbox()
     (0, 0, 128, 128)
-    >>> len(im.get_flattened_data())
+    >>> len(im.getdata())
     16384
     >>> im.getextrema()
     ((0, 255), (0, 255), (0, 255))

setup.py

@@ -363,6 +363,7 @@ class pil_build_ext(build_ext):
             ("disable-platform-guessing", None, "Disable platform guessing"),
             ("debug", None, "Debug logging"),
         ]
+        + [("add-imaging-libs=", None, "Add libs to _imaging build")]
     )
 
     @staticmethod
@@ -373,6 +374,7 @@ class pil_build_ext(build_ext):
         self.disable_platform_guessing = self.check_configuration(
             "platform-guessing", "disable"
         )
+        self.add_imaging_libs = ""
         build_ext.initialize_options(self)
         for x in self.feature:
             setattr(self, f"disable_{x}", self.check_configuration(x, "disable"))
@@ -899,6 +901,7 @@ class pil_build_ext(build_ext):
         # core library
 
         libs: list[str | bool | None] = []
+        libs.extend(self.add_imaging_libs.split())
         defs: list[tuple[str, str | None]] = []
         if feature.get("tiff"):
             libs.append(feature.get("tiff"))

src/PIL/Image.py

@@ -892,9 +892,7 @@ class Image:
                 else:
                     self.im.putpalettealphas(self.info["transparency"])
                 self.palette.mode = "RGBA"
-            elif self.palette.mode != mode:
+            else:
-                # If the palette rawmode is different to the mode,
-                # then update the Python palette data
                 self.palette.palette = self.im.getpalette(
                     self.palette.mode, self.palette.mode
                 )

src/PIL/_version.py

@@ -1,4 +1,4 @@
 # Master version for Pillow
 from __future__ import annotations
 
-__version__ = "12.2.0.dev0"
+__version__ = "12.1.0"