taskflow/doc/source/atoms.rst
Joshua Harlow f2c82f0929 Doc adjustments
- Cleanup some grammar and adjust some wording usage.
- Add more docs to utils about what should and should
  not be used.
- Add more engine docs about how each one is used and
  tips and notes about each.
- Line length adjustments (might as well keep it somewhat
  in the normal range of what openstack code expects)

Change-Id: Ice6711f00e2b50e0bee777388c0555d79cc6e1b0
2014-04-11 12:36:26 -07:00

31 lines
949 B
ReStructuredText

------------------------
Atoms, Tasks and Retries
------------------------
An atom is the smallest unit in taskflow which acts as the base for other
classes. Atoms have a name and a version (if applicable). An atom is expected
to name desired input values (requirements) and name outputs (provided
values), see :doc:`arguments_and_results` page for a complete reference
about these inputs and outputs.
.. automodule:: taskflow.atom
Task
=====
A task (derived from an atom) is the smallest possible unit of work that can
have an execute & rollback sequence associated with it.
.. automodule:: taskflow.task
Retry
=====
A retry (derived from an atom) is a special unit that handles flow errors,
controls flow execution and can retry atoms with another parameters if needed.
It is useful to allow for alternate ways of retrying atoms when they fail so
the whole flow can proceed even when a group of atoms fail.
.. automodule:: taskflow.retry