Development Notes.md

Building PyPi package

Test build

1. Make sure to update the version number in setup.py first.
2. Install updated setuptools and twine in the virtual environment:

   pipenv shell
   pip install -U setuptools wheel twine
   

3. Build the distribution python -m setup sdist bdist_wheel.
4. Test it on test.pypi.org.
   1. Upload it (you will need an account on test.pypi.org): python -m twine upload --repository testpypi dist/*.
   2. Create a new virtual environment and test install into it:

      exit # to get out of the current environment
      cd <somewhere>
      mkdir <new virtual environment>
      cd <new directory>
      pipenv shell #creates the new environment and enters it.
      pip install -i https://test.pypi.org/..... # copy actual link from the
                                                 # repository on test.pypi.
      

      There are often install issues because sometimes only older versions of some of the required packages are available on test.pypi.org. If this is the only problem change the version to end in rc0 for release candidate and try it on the regular pypi.org as described below for releasing on PyPi.
   3. After install test by running a jupyter notebook in the virtual environment.

Releasing on PyPi

Proceed only if testing of the build is successful.

1. Double check the version number in setup.py.
2. Rebuild the release: python -m setup sdist bdist_wheel.
3. Upload it: python -m twine upload dist/*
4. Make sure it works by installing it in a clean virtual environment. This is the same as on test.pypi.org except without -i https://test.pypy.... If it does not work, pull the release.