Developer Documentation

Developer Install

If you wish to help with the development of Bluezero then the recommended way of installing for edit is as follows:

git clone https://github.com/ukBaz/python-bluezero.git
cd python-bluezero
pip3 install -e .[dev]

Release Checklist

  • Check Travis-tests are passing (run_local_tests.sh)
  • Update version info (see Update Version Info)
  • Build and publish PyPI package (see Build PyPI package)
  • Check PyPI page for obvious errors
  • git tag with version number
  • Check read the docs page

Update Version Info

Use bumpversion package to update all references at once. This library tries to use Semantic Versioning

Semantic version uses three numbers that represent major.minor.patch.

The bumpversion command allows you to choose which to update. In the following example the version is being updated for a patch.

bumpversion patch setup.py

Build PyPI package

Update version information in setup.py.

To upload to PyPI:

python3 setup.py bdist_wheel sdist
twine upload dist/*

Test Build of Documentation

Do a test build of the documentation and then a visual inspection. To do a local build of the documentation:

cd docs
make clean
make html
  • readthedocs gets update from GitHub
  • readthedocs versions are based on GitHub version tags