This the Python front end for the Puddle system.
You'll need Python 3.6 for this project. We use pipenv to manage dependencies. Make sure you have Git LFS installed before cloning.
Once you have Python 3.6 and pipenv, do the following to setup the project:
# clone and enter the repo
git clone [email protected]:uwmisl/puddle.git
cd puddle-python
# use pipenv to install requirements into a virtualenv
# --dev gets the development dependencies too
pipenv install --dev
# jump in the virtual environment
pipenv shell
# run all the tests
pytestpipenv shell starts a shell in the virtual environment.
You can use pipenv run ... instead to run individual commands without being in
the pipenv shell.
To run an example program, make sure you install the development dependencies
which include the puddle package itself. Then do the following:
PUDDLE_VIZ=1 python examples/simple.pyThe environment PUDDLE_VIZ controls whether the visualization server runs.
It's off by default.