Release Pillow 10.0.0 on July 1, 2023

[hugovk]

Highlights:

• Adding Python 3.12 beta wheels: Add support for Python 3.12 #6941
• Dropping Python 3.7: Drop support for soon-EOL Python 3.7 #7058
• Removing deprecations: Remove deprecations for Pillow 10.0.0 #7059

Main Release

Released quarterly on January 2nd, April 1st, July 1st and October 15th.

• Open a release ticket e.g. Release Pillow 5.2.0 on July 1, 2018 #3154
• Develop and prepare release in main branch.
• Check GitHub Actions and AppVeyor to confirm passing tests in main branch.
• Check that all of the wheel builds Pillow Wheel Builder pass the tests in Travis CI and GitHub Actions.
• In compliance with PEP 440, update version identifier in src/PIL/_version.py
• Update CHANGES.rst.
• Run pre-release check via make release-test in a freshly cloned repo.
• Create branch and tag for release e.g.:

  git branch 10.0.x
  git tag 10.0.0
  git push --all
  git push --tags

• Create and check source distribution:

  make sdist

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

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

• Publish the release on GitHub
• In compliance with PEP 440, increment and append .dev0 to version identifier in src/PIL/_version.py

Binary Distributions

Windows

• Download the artifacts from the GitHub Actions "Test Windows" workflow 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 10.0.0

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

Publicize Release

• Announce release availability via Twitter and Mastodon 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 10.0.0

[hugovk]

The PyPI upload needs to be done using an API token:

• https://blog.pypi.org/posts/2023-06-01-2fa-enforcement-for-upload/
• https://pypi.org/help/#apitoken

(I'd like to automate releases using a Trusted Publisher, but that's another issue for another release.)

[radarhere]

Released! Thanks to all for helping make this milestone release.

https://twitter.com/PythonPillow/status/1675159474531880966
https://fosstodon.org/@pillow/110639450470725321

[rayzchen]

Are win32 wheels missing? My CI started failing on 32-bit machines since it was trying to install a sdist without the required dependencies.

[bigcat88]

@rayzchen #388

#6941 (comment)

[radarhere]

@rayzchen you will read in the release notes that it was a deliberate decision to not provide 32-bit wheels.

#6941 (comment)

I suggest we drop all the 32-bit wheels... If there's a lot of demand or very good reason, we can always add something back (e.g. 3.8 on Windows has a slightly larger percentage).

[cgohlke]

Here are two win_arm64 wheels: Pillow-10.0.0-win_arm64.zip

Pillow 10.0.0
Python 3.12.0b3 (tags/v3.12.0b3:f992a60, Jun 20 2023, 12:07:48) [MSC v.1936 64 bit (ARM64)]
--------------------------------------------------------------------
Python modules loaded from C:\Python312-arm64\Lib\site-packages\PIL
Binary modules loaded from C:\Python312-arm64\Lib\site-packages\PIL
--------------------------------------------------------------------
--- PIL CORE support ok, compiled for 10.0.0
--- TKINTER support ok, loaded 8.6
--- FREETYPE2 support ok, loaded 2.13.0
--- LITTLECMS2 support ok, loaded 2.15
--- WEBP support ok, loaded 1.3.1
--- WEBP Transparency support ok
--- WEBPMUX support ok
--- WEBP Animation support ok
--- JPEG support ok, compiled for libjpeg-turbo 3.0.0
--- OPENJPEG (JPEG2000) support ok, loaded 2.5.0
--- ZLIB (PNG/ZIP) support ok, loaded 1.2.13
--- LIBTIFF support ok, loaded 4.5.1
--- RAQM (Bidirectional Text) support ok, loaded 0.10.1, fribidi 1.0.12, harfbuzz 7.3.0
*** LIBIMAGEQUANT (Quantization method) support not installed
*** XCB (X protocol) support not installed
--------------------------------------------------------------------

rootdir: D:\Build\Pillow\Pillow-10.0.0
configfile: setup.cfg
plugins: hypothesis-6.79.0
collected 3235 items / 4 skipped

<snip>

== 3187 passed, 57 skipped, 3 xfailed, 1 xpassed, 7 warnings in 76.80s (0:01:16) ===

[radarhere]

Thanks, I've uploaded those to PyPI as well.

[MAKOMO]

I would have expected fixed v10.0.0 macOS binaries uploaded on PyPip replacing the broken ones like Pillow-10.0.0-cp312-cp312-win_arm64.whl got updated on Jul 8.

[radarhere]

To add some context, the prior comment is referring to #7250, where py2app raises an error when using Pillow 10.0.0 in Python 3.10 and 3.11. It has been fixed in main by python-pillow/pillow-wheels#394

[radarhere]

Pillow 10.0.1 has now been released, and the wheels for that include python-pillow/pillow-wheels#394