Release Pillow 9.3.0 on October 29, 2022

[hugovk]

Main Release

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

Will add support for Python 3.11.

Edit: The Python 3.11.0 release date has been delayed until 2022-10-24, so we're now targeting 2022-10-25 for the Pillow release.

---

• 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 5.2.x
  git tag 5.2.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.:

  python3 -m twine check --strict dist/*
  python3 -m twine upload dist/Pillow-5.2.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 [[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]]

[hugovk]

Python 3.11.0 RC2 is released today, and notes 3.11.0 final is delayed by three weeks from the original 2022-10-03 to 2022-10-24:

Modification of the final release

Due to the fact that we needed to delay the last release candidate by a week and because of personal scheduling problems I am delaying the final release to 2022-10-24 (three weeks from the original date).

The Pillow release was planned for 2022-10-15, with a 10-day buffer following 3.11.0 final for other things to get ready (multibuild, CIs, etc).

The new final date is a week and a weekend after our planned release.

What should we do?

• Keep 2022-10-15 and release against RC2, and put out a point release if needed when final is out?
• Wait until final is out, and release as soon as the other things are in place?
• Something else?

[radarhere]

Hmm. I vote for waiting. I don't think there's anything particularly pressing in the pipeline, and I think it's neater for the minor version numbers to match Python version support.

[madebylydia]

Nothing wrong in waiting a bit more for Python 3.11 release first, better not have an unexpected breakage :)

[aclark4life]

@hugovk @radarhere My strong preference is to consistently provide quarterly releases NO MATTER WHAT, unless SOMETHING BIG HAPPENS to prevent the quarterly release from happening. That said, in this case, it sounds like waiting for final release of a new Python version is reasonable since it's less than 2 weeks from our normal quarterly release date 👍

[hugovk]

Sounds good, shall we target 2022-10-25, = 3.11.0 release date + 1 day, and put the release out as soon as all the pieces are ready, which I think we can do pretty quickly?

I created #6575 to track what's needed to support 3.11, can discuss those details in there.

[hugovk]

Python 3.11 is all set for release on Monday! Let's join in the release party here!

• https://twitter.com/gvanrossum/status/1583561788204806144

That means we're all set for release on Tuesday, or very soon after! (See #6575 for the necessary jigsaw pieces.)

I'm travelling tomorrow (Sunday), so might not get the chance to review all the PRs in the backlog before our release day. If there's something that needs prioritising for this release, please drop links here (and add to the milestone if you can). Also reviews welcome on others' PRs you'd like including.

Thank you!

[nulano]

As noted in #6369, this will be the first release using wheels built using GitHub Actions. I'm not sure whether warrants mentioning in the release notes.

I previously noticed that the tag for 9.2.0 did not trigger a build likely because it was pushed together with an extra commit updating the main branch, so I would suggest making sure the two are pushed separately.

I would suggest including #6562 if possible to mirror #4907 (comment) and #6554 (comment) in the GHA-built Windows wheels.