Ouroboros

A standalone, pure Python implementation of the Python Standard Library.

Documentation

Documentation for Ouroboros can be found on Read The Docs.

Community

Ouroboros is part of the BeeWare suite. You can talk to the community through:

Contents:

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

Ouroboros Roadmap

Ouroboros is a new project - we have lots of things that we’d like to do. If you’d like to contribute, providing a patch for one of these features:

  • Port to Python 3

Indices and tables