Skip to content

Releasing

Jump to bottom
rocky edited this page Feb 25, 2023 · 11 revisions

Table of Contents

Get latest sources:

$ git pull

Change version in mathics/version.py

Update __version__ in mathicsscript/version.py.

$ source mathicsscript/version.py # to set in POSIX shell
$ echo $__version__

Make release branch:

$ git checkout -b release-$__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

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.10.9
$ pip install -e git+https://github.com/mathics3/mathicsscript.git#egg=mathicsscript
$ mathicsscript --version
$ mathicsscript -c "1+2"
$ pip install -e git+https://github.com/mathics3/mathicsscript.git#egg=mathicsscript[full]
# Try out: Plot[Sin[x], {x, 0, 2 Pi}]
# Try out: Graphics3D[Sphere[]]
$ pip uninstall mathicsscript
$ popd

Make packages and check

$ ./admin-tools/check-versions.sh
$ ./admin-tools/make-dist.sh
$ twine check dist/mathicsscript-$__version__*

Release on Github

Goto https://github.com/mathics3/mathicsscript/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+https://github.com/mathics3/mathicsscript.git@${__version__}#egg=mathicsscript
$ mathicsscript --version
$ mathicsscript -c '1+2'
$ pip uninstall mathicsscript
$ popd

Upload the release to PyPI

Upload it to PyPI with twine

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

Move uploaded versions to dist/uploaded.

Post-Release

Clone this wiki locally