Making a Mathics-Scanner Release

Look at https://pypi.org/project/Mathics-Scanner/ and https://github.com/Mathics3/mathics-scanner for broken links and corrections to text.

$ package="mathics_scanner"
$ github_top_dir="Mathics-Scanner"
# Edit ${package}/version.py
$ source ${package}/version.py # to set in POSIX shell
$ echo $__version__

Create a new Mathics3-Scanner branch

$ git checkout -b release-$__version__
$ git commit -m"Get ready for release $__version__" .

Update Mathics3 Scanner Changes

$ make ChangeLog

Update CHANGES.rst from ChangeLog

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

Check Mathics3 Scanner Python versions

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

Merge Mathics3 Scanner Release

Go to github and merge release into master.

Then… .. code:

$ git checkout master
$ git pull

Check Mathics3 Scanner package from github

TODO: turn this into a script in admin-tools

$ [[ ! -d /tmp/gittest ]] && mkdir /tmp/gittest; pushd /tmp/gittest
$ pyenv local python-3.12.6 # Use a version that is not the most recent
$ pip install -e git+https://github.com/Mathics3/${github_top_dir}.git#egg=${package}[full]
$ mathics-generate-json-table --version # See new version appear
$ pip uninstall ${github_top_dir}
$ popd

Make Mathics3 Scanner packages and check

$ python -m build
$ twine check dist/Mathics_Scanner-$__version__*
$ pip install dist/$package-$__version__*.whl

Go over what is in dist and remove unnecessary files in dist.

Release Mathics3 Scanner on Github

Go to https://github.com/Mathics3/mathics-scanner/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/${github_top_dir}.git@${__version__}#egg=${package}[full]
$ mathics-generate-json-table --version # See new verison appear
$ pip uninstall ${github_top_dir}
$ popd

Upload the Mathics3 Scanner release to PyPI

Upload it to PyPI with twine:

$ twine upload --verbose dist/Mathics_Scanner-${__version__}*{whl,gz}

Move Mathics3 Scanner dist files to uploaded

$ mv -v dist/Mathics_Scanner*{whl,gz,egg} dist/uploaded/

Post Mathics3 Scanner Release

Bump version in ${package}/version.py, and add dev0.