RELEASE.md

PyPi

Preparation:

• run unit tests: tests/wekatests/all_tests.py

• increment version in setup.py

• increment versions/copyright in doc/source/conf.py

• increment CPU versions in doc/source/docker.rst (will be built later)

• update API documentation

  • cd python/weka
  • sphinx-apidoc -f -o ../../doc/source .
  • make sure that all modules are included in index.rst (apart from modules.rst)

• update package suggestions by generating list of packages/classes within weka-HEAD/trunk/packages:

  find -name "*.java" | grep -v "\/dist\/" | grep "src\/main" | \
      sed s/".*internal\/"//g | sed s/".*external\/"//g | \
      sed s/"\.java"//g | sed s/"\/src\/main\/java\/"/","/g | \
      sed s/"\/"/.""/g | grep -v "..weka," | grep -v "..wekaexamples," | sort -f > \
      /home/fracpete/development/projects/fracpete/python-weka-wrapper3/python/weka/lib/pkg_suggestions.csv

• add new changelog section in CHANGES.rst

• commit/push all changes

Commands for releasing on pypi.org (requires twine >= 1.8.0):

find -name "*~" -delete
rm dist/*
python3 setup.py clean
python3 setup.py sdist
twine upload dist/*

Commands for updating github pages (requires sphinx in venv and Java 8!):

find -name "*~" -delete
cd doc
make -e SPHINXBUILD=../venv/bin/sphinx-build clean
make -e SPHINXBUILD=../venv/bin/sphinx-build html
cd build/html
cp -R * ../../../../python-weka-wrapper3.gh-pages/
cd ../../../../python-weka-wrapper3.gh-pages/
git pull origin gh-pages
git add -A
git commit -a -m "updated documentation"
git rebase gh-pages
git push origin gh-pages
cd ../python-weka-wrapper3/
git pull

Github

Steps:

• start new release (version: vX.Y.Z)
• enter release notes, i.e., significant changes since last release
• upload python-weka-wrapper3-X.Y.Z.tar.gz previously generated with setup.py
• publish

Docker

Create new CPU docker image for this release and push it to docker hub.

Google Group

• post release on the Google Group: https://groups.google.com/forum/#!forum/python-weka-wrapper