Build and Release

Build and Release#

This document describes how to build and release new wheels for DeepHyper.

First check the status of Python versions as it is important to know which becomes are currently supported and which are not. See https://devguide.python.org/versions/ for more information.

Then,

  1. Go to the develop branch: git checkout develop.

  2. Run unittests located at deephyper/tests/ with:

$ pytest --run fast,slow,hps,nas,ray,mpi tests

  1. Run doctests located at deephyper/docs/ with:

$ make doctest

  1. Check the deephyper/__version__.py, edit VERSION and __version_suffix__.

  2. Start the git flow release branch:

$ git flow release start <version>

  1. End the release:

$ EDITOR=vim git flow release finish <version>

  1. Push commits and tags:

$ git push origin --tags

  1. Make sure to be on the correct branch/tag

For final release only:

  1. build and publish the wheel to https://test.pypi.org/: python setup.py testupload

  2. try to install the wheel upload to Test PyPI: python setup.py testinstall

  3. build and publish the wheel to https://pypi.org/: python setup.py upload

  4. try to install the wheel upload to PyPI: pip install deephyper==$VERSION