dev_notes.org

To make a release:

Increment version number

Currently the version number is hard-coded in the following locations:

./doc/conf.py ./setup.py ./skfmm/__init__.py ./README.txt

Tag the release

git tag v0.0.n git push –tags origin master

Build the documentation

To build the documentation you need Sphinx and the numpydoc Sphinx extension

make html

check that everything looks ok by opening build/html/index.html

the documentation should build automatically on RTD.

Check https://scikit-fmm.readthedocs.io/en/latest/ trigger a build if needed.

Upload to PyPI

make sure you have twine installed with `pip install twine`

Copy the build artifacts from AppVeyor to dist/

twine upload dist/*

Optionally build Windows Python2.7 wheeles

python setup.py bdist_wininst python setup.py bdist_wheel twine upload dist/*

Cython Wrapper for heap class

The binary min heap C++ class has a Cython wrapper to expose it to Python. Cython is not required to build this module as the c++ files created by Cython are checked into the git repo. If changes are made to skfmm/heap.h or skfmm/heap.cpp the Cython c++ file pheap.cpp needs to be updated. This is done with the command:

cython –cplus pheap.pyx

The updates pheap.cpp should also be checked into the git repo