9a239a0a2e
This commit makes a set of small adjustments to examples. - Rework some of the comments to be more clear. - Add links to the original source tree file. - Rename some of the examples to make it clear the concept the example is intented to show. - Move some common example functionality to the example utility file. Change-Id: I858e0dbf72fe8cb40a05bfdbb0857720ffb71c7f
TaskFlow
A library to do [jobs, tasks, flows] in a highly available, easy to understand and declarative manner (and more!) to be used with OpenStack and other projects.
- More information can be found by referring to the developer documentation.
Join us
Testing and requirements
Requirements
Because TaskFlow has many optional (pluggable) parts like persistence
backends and engines, we decided to split our requirements into two
parts: - things that are absolutely required by TaskFlow (you can’t use
TaskFlow without them) are put to requirements.txt; -
things that are required by some optional part of TaskFlow (you can use
TaskFlow without them) are put to
optional-requirements.txt; if you want to use the feature
in question, you should add that requirements to your project or
environment; - as usual, things that required only for running tests are
put to test-requirements.txt.
Tox.ini
Our tox.ini file describes several test environments
that allow to test TaskFlow with different python versions and sets of
requirements installed.
To generate the tox.ini file, use the
toxgen.py script by first installing toxgen and then provide
that script as input the tox-tmpl.ini file to generate the
final tox.ini file.
For example:
$ toxgen.py -i tox-tmpl.ini -o tox.iniDeveloper documentation
We also have sphinx documentation in docs/source.
To build it, run:
$ python setup.py build_sphinx