Release Tasks

A few notes on what to do during a release.

Things to check before a release

  1. synchronize module documentation (dry run):

    $ python3 script/sync_module_docs.py doc/src/ . -n

  2. regenerate gallery page and examples:

    $ python3 script/gen_gallery.py -l ../doc-devel
$ rm -rf doc/examples/
$ cp -a gallery/examples/ doc/

  3. create temporary/testing tarball:

    $ python3 setup.py sdist

  4. check in-place build:

    $ # unpack the tarball
$ # cd into

$ python3 setup.py build_ext --inplace
$ python3 test_install.py

  5. check that documentation can be built:

    $ # copy site_cfg.py
$ python3 setup.py htmldocs
$ firefox doc/_build/html/index.html

    or use:

    $ cd doc/
$ make html
$ firefox _build/html/index.html

    try also:

    $ # copy gallery/images
$ python3 setup.py pdfdocs

  6. check installed build:

    $ python3 -m pip install . --user
$ cd
$ python3 sfepy-run run_tests
$ rm -r output/

    then remove the installed files so that they do not interfere with the local build

  7. create final tarball

    • update doc/release_notes.rst, with the help of:

      $ python3 script/gen_release_notes.py 2019.2

    • update doc/news.rst, doc/archived_news.rst

    • change version number (sfepy/version.py) so that previous release tarball is not overwritten!

    • set is_release = True in site_cfg.py

    • update pdfdocs:

      $ python3 setup.py pdfdocs

    • create tarball:

      $ python3 setup.py sdist

  8. tag the release using:

    $ git tag release_XXXX.X

Useful Git commands

  • log

    git log --pretty=format:"%s%n%b%n" --topo-order --reverse release_2016.4..HEAD

  • who has contributed since <date>:

    git log --after=<date> | grep Author | sort | uniq
git log release_2012.1..HEAD | grep Author | sort -k3 | uniq
git shortlog -s -n release_2012.3..HEAD

git rev-list --committer="Name Surname" --since=6.months.ago HEAD | wc
git rev-list --author="Name Surname" --since=6.months.ago HEAD | wc
# ?no-merges

  • misc:

    git archive --format=tar HEAD | gzip > name.tar.gz

Web update and file uploading