workflows.services.executors.approval

Approval step executor.

Module Contents

class workflows.services.executors.approval.ApprovalExecutor

Bases: workflows.services.executors.factory.AbstractStepExecutor

Approval step executor.

First encounter (no signal) → AWAITING (AwaitingApproval).

• On “reject” → REJECTED (terminal).

• On “approve”:

  • If this is the last Approval step → APPROVED.

  • Otherwise → PASSED.

do_execute(instance, signal)

Execute the approval step and return the resulting state.

Parameters:

• instance (workflows.models.WorkflowInstance) – Workflow instance being processed.

• signal (str | None) – External decision signal such as approve or reject.

Returns:

ExecutorResult describing the new workflow state and step context.

Return type:

workflows.services.types.ExecutorResult