Workflow and tasks¶
A workflow in Dotflow is an ordered set of tasks built on a DotFlow instance. You register steps with workflow.task.add(...), then run them through start (one-shot execution) or schedule (recurring runs when a scheduler is configured).
Main pieces¶
| Piece | Role |
|---|---|
DotFlow |
Entry point: holds config, workflow_id, and the task builder. |
TaskBuilder |
Collects tasks in a queue before execution. |
Manager |
Runs the queue (sequential, background, or parallel) and coordinates storage and callbacks. |
| Action | A callable decorated with @action; Dotflow wraps it as a unit of work with context in/out. |
Each task consumes previous context from the prior step and can emit a new context for the next one. See Concept of context and the Initial context / Previous context how-tos.
Execution vs scheduling¶
startruns the workflow now (see Process Mode for how tasks are ordered and parallelized).scheduledelegates to the configured scheduler (for example cron); overlap between runs is controlled by overlap strategies.