Metadata-Version: 2.0
Name: taskflow
Version: 0.9.0
Summary: Taskflow structured state management library.
Home-page: https://launchpad.net/taskflow
Author: Taskflow Developers
Author-email: taskflow-dev@lists.launchpad.net
License: UNKNOWN
Keywords: reliable,tasks,execution,parallel,dataflow,workflows,distributed
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Distributed Computing
Requires-Dist: pbr (>=0.6,!=0.7,<1.0)
Requires-Dist: ordereddict
Requires-Dist: six (>=1.9.0)
Requires-Dist: enum34
Requires-Dist: networkx (>=1.8)
Requires-Dist: stevedore (>=1.3.0)
Requires-Dist: futures (>=2.1.6)
Requires-Dist: jsonschema (>=2.0.0,<3.0.0)
Requires-Dist: oslo.utils (>=1.4.0)
Requires-Dist: oslo.serialization (>=1.4.0)
Requires-Dist: debtcollector (>=0.3.0)

TaskFlow
========

.. image:: https://pypip.in/version/taskflow/badge.svg
    :target: https://pypi.python.org/pypi/taskflow/
    :alt: Latest Version

.. image:: https://pypip.in/download/taskflow/badge.svg?period=month
    :target: https://pypi.python.org/pypi/taskflow/
    :alt: Downloads

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.

* Free software: Apache license
* Documentation: http://docs.openstack.org/developer/taskflow
* Source: http://git.openstack.org/cgit/openstack/taskflow
* Bugs: http://bugs.launchpad.net/taskflow/

Join us
-------

- http://launchpad.net/taskflow

Testing and requirements
------------------------

Requirements
~~~~~~~~~~~~

Because this project has many optional (pluggable) parts like persistence
backends and engines, we decided to split our requirements into three
parts: - things that are absolutely required (you can't use the project
without them) are put into ``requirements-pyN.txt`` (``N`` being the
Python *major* version number used to install the package). The requirements
that are required by some optional part of this project (you can use the
project without them) are put into our ``tox.ini`` file (so that we can still
test the optional functionality works as expected). If you want to use the
feature in question (`eventlet`_ or the worker based engine that
uses `kombu`_ or the `sqlalchemy`_ persistence backend or jobboards which
have an implementation built using `kazoo`_ ...), you should add
that requirement(s) to your project or environment; - as usual, things that
required only for running tests are put into ``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.
Please refer to the `tox`_ documentation to understand how to make these test
environments work for you.

Developer documentation
-----------------------

We also have sphinx documentation in ``docs/source``.

*To build it, run:*

::

    $ python setup.py build_sphinx

.. _kazoo: http://kazoo.readthedocs.org/
.. _sqlalchemy: http://www.sqlalchemy.org/
.. _kombu: http://kombu.readthedocs.org/
.. _eventlet: http://eventlet.net/
.. _tox: http://tox.testrun.org/
.. _developer documentation: http://docs.openstack.org/developer/taskflow/



