Contributing

Few things to know before diving in the code.

Project Guidelines

Be pythonic, document and test your code. That’s all.

Dev Environment

To tinker with the code, it’s recommended that you install the library from the cloned folder with:

pip install --editable .

This will allow you to install ValveVMF from the folder. This way, you can modify ValveVMF as you develop your own project around it.

Documenting

The documentation is done with Sphinx. To build the Sphinx documentation, you need:

pip install -r docs/requirements.txt # one-time setup

sphinx-autobuild docs/source docs/build

The documentation pages will be served on http://127.0.0.1:8000 by default.

Testing

Tests can be ran from the root folder using:

pip install -r requirements.txt # one-time setup

pytest