"""
API
"""
# TODO: probably to workflow.py, state.py, transition.py

"""
Example usage [STUB]:

class MyWorkflow(Workflow):
    def __init__(self, **kwargs):
        Workflow.__init__(self, **kwargs)
"""

class Workflow(object):
    """DG of all workflow"""

    def __init__(self, initial_state=None):
        """
        - initial_state: if settable
        """

    def state(self):
        """
        current state;
        returns the current state object
        """

class State(object):
    """a state"""

    def __init__(self, *transitions):

    def available():
        """avalable transitions"""

    def transit():
        """invoke a transition"""