DEVELOPER GUIDE¶
Project Setup¶
Create Python virtual environment using your favourite
venv
tool orconda
Setup project like so:
pip install ".[dev,test]" .
Recommend to use PyCharm IDE
4 spaces, no tab for indentation
Running Test Suite¶
To run unit test suite:
python -m unittest
To run a specific test case:
python -m unittest tests.test_cli.CLIUnitTests.test_upload
To run with
pytest
:py.test
Documentation¶
Use Sphinx and reStructuredText
Document sources are in
sphinx/source/*.rst
Build doc like so:
(cd sphinx && make clean) (cd sphinx && make html)
Browse doc locally in
sphinx/build/html/index.html
Build for github page:
(cd sphinx && make github)
If everything looks good, make all docs:
make doc