Making a Mathics3 Django Release¶
Note: This package depends on ``mathics-core``, so if that needs a release too, do that before this.
Look at https://pypi.org/project/Mathics-django/ and https://github.com/Mathics3/mathics-django for broken links and corrections to text. .. code:
$ PACKAGE="Mathics-Django"
$ github_top_dir="mathics_django"
# Edit mathics_django/version.py
$ source ${github_top_dir}/version.py # to set in POSIX shell
$ echo $__version__
Mathics Django Workflows update?¶
Check .github/workflows/*.yml
to make see if we are using
github versions (of mathics-core) for testing. If so adjust.
Create a new Mathics Django release branch¶
$ git checkout -b release-$__version__
$ git commit -m"Get ready for release $__version__" .
Update Changes to Mathics Django¶
$ make ChangeLog
Update CHANGES.rst
from ChangeLog
$ make check
$ git commit --amend .
$ git push -u origin HEAD # get CI testing going early
Check Python versions¶
$ ./admin-tools/check-versions.sh
Merge release¶
Go to github and merge release into master.
Then… .. code::
$ git checkout master
$ git pull
Check Mathics-Django 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 # Use a version that is not the most recent
$ pip install -e git+https://github.com/Mathics3/mathics-django.git#egg=${PACKAGE}[full]
$ python src/mathics-django/mathics_django/server.py --version # See version
$ python src/mathics-django/mathics_django/server.py # Try it
$ pip uninstall ${PACKAGE}
$ popd
Make packages and check¶
$ python -m build
$ twine check dist/Mathics{_,-}Django-$__version__*
Go over what is in dist and remove unnecessary files in dist
.
Release on Github¶
Go to https://github.com/Mathics3/mathics-django/releases/new
https://cloudconvert.com/rst-to-md can be used to change the CHANGES.rst section to markdown.
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/mathics-django.git@${__version__}#egg=${PACKAGE}[full]
$ python src/mathics-django/mathics_django/server.py --version # See version
$ popd
Upload the Mathics-Django release to PyPI¶
Upload it to PyPI with twine
:
$ twine upload --verbose dist/Mathics{_,-}Django-${__version__}*
Move Mathics-Django distributed files to uploaded¶
$ mv -v dist/$PACKAGE*{whl,gz} dist/uploaded/
Post Mathics-Django Release¶
Add 1 to release number of version in
${github_top_dir}/version.py
; also append “dev0”.