how to make a release

Table of Contents

• Get latest sources:
• Change version in trepan/version.py:
• Update ChangeLog:
• Update NEWS.md from ChangeLog:
• Make sure pyenv is running and check newer versions
• Switch to python-2.4, sync that up and build that first since it creates a tarball which we don't want.
• Check against older versions
• Make packages and tag
• Upload
• Push tags:

Get latest sources:

$ git pull

Change version in trepan/version.py:

$ emacs trepan/version.py
$ source trepan/version.py
$ echo $__version__
$ git commit -m"Get ready for release $__version__" .

Update ChangeLog:

$ make ChangeLog

Update NEWS.md from ChangeLog:

$ make check-short
$ git commit --amend .
$ git push # get CI testing going early

Make sure pyenv is running and check newer versions

$ pyenv local && source admin-tools/check-newer-versions.sh

Switch to python-2.4, sync that up and build that first since it creates a tarball which we don't want.

$ source admin-tools/setup-python-2.4.sh

$ git merge master
# Add and fix merge conflicts
$ git commit

Check against older versions

$ source admin-tools/check-older-versions.sh

Make packages and tag

$ . ./admin-tools/make-dist-older.sh
$ pyenv local 3.8.6 && twine check dist/trepan2-$__version__* && pyenv local 2.7.18
$ git tag release-python-2.4-$__version__
$ . ./admin-tools/make-dist-newer.sh
$ pyenv local 3.8.6 &&  twine check dist/trepan2-$__version__* && pyenv local 2.7.18

Check package on github

$ [[ ! -d /tmp/gittest ]] && mkdir /tmp/gittest; pushd /tmp/gittest
$ pyenv local 2.7.18
$ pip install -e git+https://github.com/rocky/python2-trepan.git#egg=trepan2
$ trepan2 --version
$ trepan2 trepan2
$ pip uninstall trepan2
$ popd

Release on github

Goto https://github.com/rocky/python2-trepan/releases/new

Get on PyPI

$ pyenv local 3.6.10 && twine upload dist/trepan2-${__version__}* && pyenv local 2.7.18

Push tags:

$ git pull --tags
$ git push --tags

Move dist files to uploaded

$ mv -v dist/trepan2-${__version__}* dist/uploaded