Releasing

Look at the PyPI page for errors in documentation

Look at https://pypi.org/project/trepan3k/ and check over documentation.

Get the 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
$ head -n 500 ChangeLog | codespell -

Update NEWS.md from ChangeLog

$ emacs NEWS.md
$ make check
$ git commit --amend .
$ git push origin HEAD # get CI testing going early
$ ./admin-tools/check-newest-versions.sh

Make sure pyenv is running and check versions

$ admin-tools/check-newest-versions.sh

Python 3.11

$ ./admin-tools/merge-for-3.11.sh
$ git commit && git commit .
$ make check
$ ./admin-tools/check-3.11-versions.sh
$ git push origin HEAD

Python 3.6 to 3.10

$ ./admin-tools/merge-for-3.6.sh
$ git commit && git commit .
$ make check
$ ./admin-tools/check-3.6-3.10-versions.sh
$ git push origin HEAD

Python 3.3 to 3.5

$ ./admin-tools/merge-for-3.3.sh
$ make check
$ ./admin-tools/check-3.3-3.5-versions.sh
$ git push origin HEAD

Python 3.0 to 3.2

$ ./admin-tools/merge-for-3.0.sh
$ make check
$ admin-tools/check-3.0-3.2-versions.sh
$ git push origin HEAD

Check package from GitHub

Todo: turn this into a script in admin-tools

$ [[ ! -d /tmp/gittest ]] && mkdir /tmp/gittest; pushd /tmp/gittest
$ pyenv local 3.12.6  # or some other non-current version
$ pip install -e git+https://github.com/rocky/python3-trepan.git#egg=trepan3k
$ trepan3k --version
$ trepan3k trepan3k
$ pip uninstall trepan3k
$ popd

Make packages and install locally

$ ./admin-tools/make-dist-3.0-3.2.sh
$ (cd dist && pip install *tarball* )
$ ./admin-tools/make-dist-3.3-3.5.sh
$ (cd dist && pip install *tarball* )
$ ./admin-tools/make-dist-3.6-3.10.sh
$ (cd dist && pip install *tarball* )
$ ./admin-tools/make-dist-3.11.sh
$ (cd dist && pip install *tarball* )
$ ./admin-tools/make-dist-newest.sh
$ (cd dist && pip install *tarball* )

Check packages

$ twine check dist/trepan3k-$__version__*

Release on GitHub

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

Set the version, copy the NEWS.md item, and upload the binaries.

Pull tag:

$ git pull --tags

Now check the tagged release. (Checking the untagged release was previously done.)

Todo: turn this into a script in admin-tools

$ git pull # to pull down the new tag
$ pushd /tmp/gittest
$ pip install -e git+https://github.com/rocky/python3-trepan.git@${__version__}#egg=trepan3k
$ trepan3k --version
$ trepan3k trepan3k
$ pip uninstall trepan3k
$ popd

Get on PyPI

$ twine upload dist/trepan3k-${__version__}*.{whl,gz}

Check on https://pypi.org/project/trepan3k/

Move dist files to theuploaded directory

$ mkdir dist/uploaded/$__version__/
$ mv -v dist/trepan3k-${__version__}* dist/uploaded/$__version__/

Bump version to dev

In trepan/version.py, bump the number and add .dev0.