Release Pillow 9.1.0 on April 1, 2022

[radarhere]

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 5.2.x
  git tag 5.2.0
  git push --all
  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.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

• 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]

It has been pointed out that we should not use PyPy 7.3.8 for this release.

I'm hopeful that PyPy 7.3.9 will be released before April 1 though.

[radarhere]

PyPy 7.3.9 has now been merged in, with python-pillow/pillow-wheels#272

[hugovk]

Okay, main is more or less ready for release.

Needed:

• Add musllinux wheels to 9.1.0 release notes #6168
• Test with FriBiDi on Alpine pillow-wheels#274
• Anything else?

To consider:

• Add support for multiple component transformation to JPEG2000 #5500

@radarhere Please also merge anything else you think is good, and I'll start the release tomorrow (Finnish) morning. Thanks!

[hugovk]

@cgohlke Please could we have Windows binaries for 9.1.0? Thank you!

[hugovk]

@radarhere Thanks for bumping the docker-images, but I was a bit confused why this "Create release" job has been waiting for over 40 minutes for a runner and I guess it's because the CI capacity is tied up at docker-images :D

In general, it's probably best to hold off to keep the CI free in case of necessary re-runs (we're on the third so far), and the docker-images bump is the last thing on the checklist so I won't forget it. Thanks!

[radarhere]

I don't think it is because of that. I waited 20 minutes for it to start before I gave up and triggered docker-images :p

[hugovk]

Hmm, weird! I'll give it another 10 minutes and then cancel and start a fourth attempt!

Anyway, the docker-images update isn't for the actual release, so in the future let's wait until afterwards.

Relating to the first two failed attempts, I filed these for the timeout and "re-run failed" problems:

• curl: (28) Failed to connect to sourceware.org port 443: Operation timed out pillow-wheels#276
• Enable re-running failed jobs pillow-wheels#277

[hugovk]

Still waiting after an hour:

https://github.com/python-pillow/pillow-wheels/runs/5786245264?check_suite_focus=true

I'm curious to see if it'll timeout, so I've left it running and have triggered a new build on the tag:

https://github.com/python-pillow/pillow-wheels/actions/runs/2076994216

[radarhere]

While it would be good to eventually have the GitHub Release for pillow-wheels, if you get to the point where you just want the wheels, the wheels-latest artifact from a recent run of my pillow-wheels has that.

[hugovk]

Thanks! Will use those if it doesn't succeed by the time the Windows ones are available.

[cgohlke]

Please could we have Windows binaries for 9.1.0?

Here you go.

[hugovk]

Please could we have Windows binaries for 9.1.0?

Here you go.

Thanks!

---

Thanks! Will use those if it doesn't succeed by the time the Windows ones are available.

10th attempt had no timeouts but again the final Create Release job is still "Waiting for a runner to pick up this job...", so will use those.

https://github.com/python-pillow/pillow-wheels/runs/5789145831?check_suite_focus=true

[hugovk]

Released! 🚀

https://pypi.org/project/Pillow/9.1.0/

Thanks all!

(Tweet to come)

[hugovk]

🐦 🚀 https://twitter.com/PythonPillow/status/1509909935068491784

[aclark4life]

And pinned, thanks all!!

[radarhere]

@hugovk here are the aarch64 wheels from Travis CI, if it helps - aarch64.zip

[hugovk]

Thanks, uploaded!

https://pypi.org/project/Pillow/9.1.0/#files