Release Pillow 9.1.0 on April 1, 2022

radarhere commented 2 years ago

Main Release

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

[x] Open a release ticket e.g. https://github.com/python-pillow/Pillow/issues/3154
[x] Develop and prepare release in main branch.
[x] Check GitHub Actions and AppVeyor to confirm passing tests in main branch.
[x] Check that all of the wheel builds Pillow Wheel Builder pass the tests in Travis CI and GitHub Actions.
[x] In compliance with PEP 440, update version identifier in src/PIL/_version.py
[x] Update CHANGES.rst.
[x] Run pre-release check via make release-test in a freshly cloned repo.

[x] Create branch and tag for release e.g.:

git branch 5.2.x
git tag 5.2.0
git push --all
git push --tags

[x] Create and check source distribution:
```
make sdist
twine check dist/*
```
[x] Create binary distributions
[x] Check and upload all binaries and source distributions e.g.:
```
twine check dist/*
twine upload dist/Pillow-5.2.0*
```
[x] Publish the release on GitHub
[x] In compliance with PEP 440, increment and append .dev0 to version identifier in src/PIL/_version.py

Binary Distributions

Windows

[x] Contact @cgohlke for Windows binaries via release ticket e.g. https://github.com/python-pillow/Pillow/issues/1174.
[x] Download and extract tarball from @cgohlke and copy into dist/

Mac and Linux

[x] Use the Pillow Wheel Builder:

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

[x] Download wheels from the Pillow Wheel Builder release and copy into dist/

Publicize Release

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

Documentation

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

Docker Images

[x] 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 commented 2 years ago

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 commented 2 years ago

PyPy 7.3.9 has now been merged in, with https://github.com/python-pillow/pillow-wheels/pull/272

hugovk commented 2 years ago

Okay, main is more or less ready for release.

Needed:

[x] https://github.com/python-pillow/Pillow/pull/6168
[x] https://github.com/python-pillow/pillow-wheels/pull/274
Anything else?

To consider:

[x] https://github.com/python-pillow/Pillow/pull/5500

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

hugovk commented 2 years ago

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

hugovk commented 2 years ago

@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 commented 2 years ago

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 commented 2 years ago

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:

hugovk commented 2 years ago

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 commented 2 years ago

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 commented 2 years ago

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