Release Pillow 8.3.2 on September 2, 2021

[hugovk]

Point release to include Python 3.10 wheels (#5569) and some regressions (#5569 (comment)).

Point Release

Released as needed for security, installation or critical bug fixes.

• Make necessary changes in master branch.
• Update CHANGES.rst.
• Check out release branch e.g.:

  git checkout -t remotes/origin/5.2.x

• Cherry pick individual commits from master branch to release branch e.g. 5.2.x, then git push.
• Check GitHub Actions and AppVeyor to confirm passing tests in release branch e.g. 5.2.x.
• In compliance with PEP 440, update version identifier in src/PIL/_version.py
• Run pre-release check via make release-test.
• Create tag for release e.g.:

  git tag 5.2.1
  git push
  git push --tags

• Create and check source distribution:

  make sdist
  twine check dist/*

• Create binary distributions
• Check and upload all binaries and source distributions e.g.:

  twine check dist/*
  twine upload dist/Pillow-5.2.1*

• Publish the release on GitHub

Binary Distributions

Windows

• Contact @cgohlke for Windows binaries via release ticket e.g. Release 2.9.0 on July 1, 2015 #1174.
• Download and extract tarball from @cgohlke and copy into dist/

Mac and Linux

• Use the Pillow Wheel Builder:

  git clone https://github.com/python-pillow/pillow-wheels
  cd pillow-wheels
  ./update-pillow-tag.sh [[release tag]]

• Download wheels from the Pillow Wheel Builder release
  and copy into dist/

Publicize Release

• Announce release availability via Twitter e.g. https://twitter.com/PythonPillow/status/1013789184354603010

Documentation

• Make sure the default version for Read the Docs is up-to-date with the release changes

Docker Images

• Update Pillow in the Docker Images repository

  git clone https://github.com/python-pillow/docker-images
  cd docker-images
  ./update-pillow-tag.sh [[release tag]]

[radarhere]

For the purposes of https://pillow.readthedocs.io/en/latest/installation.html#python-support, I presume that Pillow 8.3.2 doesn't support 3.10, right?

[hugovk]

Good question!

We'll have wheels and the 3.10 classifier and updated Windows exit warning from #5570.

We could do: Python 3.10 isn't officially out yet, we don't support it until 3.10 final and Pillow 8.4.0.

I suggest we do: 3.10 is in RC, we support it in 8.3.2, in the rare case that 3.10 final isn't ABI compatible with the RC, we'll make an update for 8.4.0.

So update the table like this?

• Pillow >= 8.3.2 supports 3.10
• Pillow 8.0 - 8.3.1 doesn't support 3.10

[hugovk]

Plan: I'm going to update the branches today (1st September) and tag and release tomorrow (2nd September).

[hugovk]

CIFuzz is failing on the 8.3.x branch, but is also failing on master, both pre- and post release changes, so I think this is unrelated to the release changes and will continue the release. Let's follow up later.

• https://github.com/python-pillow/Pillow/actions/workflows/cifuzz.yml

[hugovk]

@cgohlke Please could we have Windows binaries, including for Python 3.10 RC1?

[cgohlke]

could we have Windows binaries, including for Python 3.10 RC1?

The tests quit unexpectedly at 76% TestImageFont::test_variation_set_by_name. Need some time to investigate...

[wiredfool]

CI fuzz is failing, there's an issue in the oss-fuzz project. I can't reproduce locally, so I'm not sure what's up.

[cgohlke]

Has this release been tested with FreeType 2.11.0? I get a segfault in TestImageFont::test_variation_set_by_axes at

Pillow/src/_imagingft.c

Line 618 in 8013f13

error = FT_Load_Glyph(face, glyph_info[i].index, load_flags);

[0x0]   _imagingft_cp39_win_amd64!FT_Stream_Open + 0x7d07   
[0x1]   _imagingft_cp39_win_amd64!FT_Stream_Open + 0xd10   
[0x2]   _imagingft_cp39_win_amd64!FT_Load_Glyph + 0x30c   
[0x3]   _imagingft_cp39_win_amd64!font_getsize + 0x2dd

[hugovk]

We're currently testing against FreeType 2.10.4:

Pillow/winbuild/build_prepare.py

Line 188 in 8013f13

"filename": "freetype-2.10.4.tar.gz",

[nulano]

This is a known issue in FreeType 2.11.0 (found by @radarhere): https://gitlab.freedesktop.org/freetype/freetype/-/issues/1075

[cgohlke]

could we have Windows binaries, including for Python 3.10 RC1?

Here you go.

[hugovk]

Thanks!

And released!

• https://pypi.org/project/Pillow/8.3.2/
• https://pypi.org/project/Pillow/8.3.2/#files
• https://pillow.readthedocs.io/en/stable/releasenotes/8.3.2.html

$ python3.10 -m pip install -U pillow
Requirement already satisfied: pillow in /Users/hugo/.pyenv/versions/3.10-dev/lib/python3.10/site-packages (8.3.1)
Collecting pillow
  Downloading Pillow-8.3.2-cp310-cp310-macosx_10_10_universal2.whl (3.0 MB)
     |████████████████████████████████| 3.0 MB 5.1 MB/s
Installing collected packages: pillow
  Attempting uninstall: pillow
    Found existing installation: Pillow 8.3.1
    Uninstalling Pillow-8.3.1:
      Successfully uninstalled Pillow-8.3.1
Successfully installed pillow-8.3.2

Will tweet a bit later.

[hugovk]

🚀 https://twitter.com/PythonPillow/status/1433517261118185473

[hugovk]

I just spotted Pillow-8.3.2-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl failed to download yesterday from https://github.com/python-pillow/pillow-wheels/releases so didn't go to PyPI.

Now uploaded:

• https://pypi.org/project/Pillow/8.3.2/#files

[hugovk]

For reference, noting we uploaded some manylinux1 and manylinux2010 wheels too: #5701.