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