Releasing

Get latest sources:

$ git pull

Change version in mathics/version.py

Update __version__ in mathics_omnibus/version.py.

$ source mathics_omnibus/version.py # to set in POSIX shell
$ echo $__version__
$ git commit -m"Get ready for release $__version__" .

Update Changes

$ make ChangeLog

Update NEWS.md from ChangeLog.

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

http://rst.ninjs.org/ can be used for checking the RsT.

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.7.9
$ pip install -e git://github.com/mathics3/mathics-omnibus.git#egg=mathics_omnibus
$ mathicsscript --version
$ mathicsserver --version
$ dmathicsscript
$ dmathicsserver
$ pip uninstall mathics_omnibus
$ popd

Make packages and check

$ (cd ./admin-tools && bash ./make-dist.sh)
$ twine check dist/Mathics_omnibus-$__version__*

Release on Github

Goto https://github.com/Mathics3/mathics-omnibus/releases/new

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 new tag
$ pushd /tmp/gittest
$ pip install -e git://github.com/mathics3/mathics_omnibus.git@${__version__}#egg=mathics_omnibus
$ mathicsscript --version
$ mathicsserver --version
$ dmathicsscript
$ dmathicsserver
$ pip uninstall mathics_omnibus
$ popd

Upload the release to PyPI

Upload it to PyPI with twine

$ twine upload dist/Mathics_omnibus-${__version__}*

Move uploaded versiosn to dist/uploaded.

Post-Release

• Update docker setup
• Announce release on Google-Groups pages
  • https://groups.google.com/forum/#!forum/mathics-devel,
  • https://groups.google.com/forum/#!forum/mathics-users, and
  • https://groups.google.com/g/sage-develsage-users
• Update __version__ to NEXT_VERSION.dev0