Cacahuate

The process virtual machine

This project defines storage for an abstract _process_ in a company, and implements a virtual machine that keeps track of the execution of instances of the process.

Develop

You will need the redis and mongo databases, and rabbitmq for this to work. I recommend using pipenv or virtualenv in your python projetcs ;)

clone the repo
install the requirements listed in requirements.txt
run the tests (pytest)

you can control your cacahuate installation using this three environment variables:

CACAHUATE_SETTINGS: absolute path to a settings file

FLASK_APP: import path to wsgi module (cacahuate.http.wsgi)

FLASK_DEBUG: set to 1 to turn on flask's debugging

Installation

pip install cacahuate

Cacahuated

This is the daemon in charge of moving pointers in the process, run with:

cacahuated

The Cacahuate REST API

In this same repository you will find a flask application that exposes a REST api for controling Cacahuate.

How to run

FLASK_APP=cacahuate.http.wsgi flask run

You can use any wsgi-compliant server, like gunicorn, to run this:

gunicorn cacahuate.http.wsgi:app

The docs

Docs are built using sphinx and published in https://tracsa.github.io/cacahuate/index.html. To build a local copy of the docs navigate to the docs/ directory and run: