To develop, it's best to NOT use pip install mousai
as you will not know which mousai you are running versus testing.
The easiest way is to:
Fork Mousai
Clone to your hard drive/computer
To work in developer mode, at the top level directory inside
mousai
at a terminal (or anaconda) prompt, type:$ pip install -e .
If you make minor changes, before submitting a pull request (most likely via github), please:
$ git pull origin
Then run tests (pytest
above), then push to your github repository.
After that, please submit your pull request.
Typing pytest
at the top of the directory structure will run all unit tests in docstrings.
To make a distribution. (not completely valid- pulled from Vibration Toolbox)
- Edit the version number in
mousai/__init__.py
- Use the Makefile,
make release
The conf.py
file for the documentation pulls the version from __init__.py
To make a wheel file to test before deployment:
>>> make wheel
To test before release:
>>> pip install --force-reinstall --upgrade --no-deps dist/mousai-0.5b9-py3-none-any.whl
See create_distro.rst
for explicit pypi
commands that may not be necessary.
See twine notes on modern pypi connectivity.
Once travis-ci checking is done, release checking will be unecessary. Still needs work on travis-ci.
Please avoid using print and instead use logging.
See the top of har_bal.py for the logging commands. The logging.debug should be used in place of a print statement.
Uncommenting the appropriately commentes line will turn off all debuging output. Please do this before commits to the main branch.