Contributing to Ouroboros¶
If you experience problems with Ouroboros, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.
Setting up your development environment¶
The recommended way of setting up your development envrionment for Ouroboros
is to install a virtual environment, install the required dependencies and
start coding. Assuming that you are using virtualenvwrapper
, you only have
to run:
$ git clone git@github.com:pybee/ouroboros.git
$ cd ouroboros
$ mkvirtualenv -p `which python3` ouroboros
Ouroboros uses unittest
for its own test suite as well as additional helper
modules for testing. To install all the requirements for Ouroboros, you have to
run the following commands within your virutal envrionment:
$ pip install -e .
$ pip install -r requirements_dev.txt
A brief reminder that ouroboros is intended to work only on python versions 3.3 and above.
Now you are ready to start hacking! Have fun!
Running tests¶
Tests can be run using the following command from the project root:
$ python setup.py test