Release Checklist

Main Release

Released quarterly on the first day of January, April, July, October.

Open a release ticket e.g. https://github.com/python-pillow/Pillow/issues/1174
Develop and prepare release in master branch.
Check Travis CI to confirm passing tests in master branch.
In compliance with https://www.python.org/dev/peps/pep-0440/, update version identifier in:

    PIL/__init__.py setup.py _imaging.c

Update CHANGES.rst.
Run pre-release check via make pre.
Create branch and tag for release e.g.:

    $ git branch 2.9.x
    $ git tag 2.9.0
    $ git push --all
    $ git push --tags

Create and upload source distributions e.g.:

    $ make sdistup

Create and upload binary distributions
Manually hide old versions on PyPI as needed, such that only the latest main release is visible when viewing https://pypi.python.org/pypi/Pillow

Point Release

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

Make necessary changes in master branch.
Update CHANGES.rst.
Cherry pick individual commits from master branch to release branch e.g. 2.9.x.
Check Travis CI to confirm passing tests in release branch e.g. 2.9.x.
Checkout release branch e.g.:

    git checkout -t remotes/origin/2.9.x

In compliance with https://www.python.org/dev/peps/pep-0440/, update version identifier in:

    PIL/__init__.py setup.py _imaging.c

Run pre-release check via make pre.
Create tag for release e.g.:

    $ git tag 2.9.1
    $ git push --tags

Create and upload source distributions e.g.:

    $ make sdistup

Create and upload binary distributions

Embargoed Release

Released as needed privately to individual vendors for critical security-related bug fixes.

Prepare patch for all versions that will get a fix. Test against local installations.
Commit against master, cherry pick to affected release branches.
Run local test matrix on each release & Python version.
Privately send to distros.
Run pre-release check via make pre
Amend any commits with the CVE #
On release date, tag and push to GitHub.

    git checkout 2.5.x
    git tag 2.5.3
    git push origin 2.5.x
    git push origin --tags

Create and upload source distributions e.g.:

    $ make sdistup

Create and upload binary distributions

Binary Distributions

Windows

Contact @cgohlke for Windows binaries via release ticket e.g. https://github.com/python-pillow/Pillow/issues/1174.
Download and extract tarball from @cgohlke and twine upload *.

OS X

Use the Pillow OS X Wheel Builder:

    $ git checkout https://github.com/python-pillow/pillow-wheels
    $ cd pillow-wheels
    $ git submodule init
    $ git submodule update
    $ cd Pillow
    $ git fetch --all
    $ git commit -a -m "Pillow -> 2.9.0"
    $ git push

Download distributions from the Pillow OS X Wheel Builder container and twine upload *.

Linux

Publicize Release

Announce release availability via Twitter e.g. https://twitter.com/aclark4life/status/583366798302691328.

3.5 KiB Raw Blame History