Coverage for src/robot_dispatch/domain/state_machine.py: 95%
19 statements
« prev ^ index » next coverage.py v7.17.2, created at 2026-11-07 17:18 +0000
« prev ^ index » next coverage.py v7.17.2, created at 2026-11-07 17:18 +0000
1from __future__ import annotations
3from robot_dispatch.domain.enums import QUEUED_TASK_STATUSES, TaskStatus
5ALLOWED_TRANSITIONS: dict[TaskStatus, frozenset[TaskStatus]] = {
6 TaskStatus.PENDING: frozenset({TaskStatus.PENDING, TaskStatus.ASSIGNED, TaskStatus.CANCELLED}),
7 TaskStatus.RETRYING: frozenset({TaskStatus.RETRYING, TaskStatus.ASSIGNED, TaskStatus.CANCELLED}),
8 TaskStatus.ASSIGNED: frozenset(
9 {
10 TaskStatus.ASSIGNED,
11 TaskStatus.RUNNING,
12 TaskStatus.SUCCEEDED,
13 TaskStatus.FAILED,
14 TaskStatus.RETRYING,
15 TaskStatus.CANCELLED,
16 }
17 ),
18 TaskStatus.RUNNING: frozenset(
19 {
20 TaskStatus.RUNNING,
21 TaskStatus.SUCCEEDED,
22 TaskStatus.FAILED,
23 TaskStatus.RETRYING,
24 TaskStatus.CANCELLED,
25 }
26 ),
27 TaskStatus.SUCCEEDED: frozenset(),
28 TaskStatus.FAILED: frozenset(),
29 TaskStatus.CANCELLED: frozenset(),
30}
32CANCELLABLE_STATUSES = frozenset(
33 {TaskStatus.PENDING, TaskStatus.RETRYING, TaskStatus.ASSIGNED}
34)
37class InvalidTransition(Exception):
38 def __init__(self, current: TaskStatus | str, target: TaskStatus | str) -> None:
39 self.current = TaskStatus(current)
40 self.target = TaskStatus(target)
41 super().__init__(f"illegal task transition {self.current} -> {self.target}")
44def can_transition(current: TaskStatus | str, target: TaskStatus | str) -> bool:
45 return TaskStatus(target) in ALLOWED_TRANSITIONS[TaskStatus(current)]
48def ensure_transition(current: TaskStatus | str, target: TaskStatus | str) -> TaskStatus:
49 """Validate the transition and return the target status.
51 Every status change in the service goes through this guard, so an illegal
52 transition fails loudly instead of silently corrupting the task lifecycle.
53 """
54 if not can_transition(current, target):
55 raise InvalidTransition(current, target)
56 return TaskStatus(target)
59def is_queued(status: TaskStatus | str) -> bool:
60 return TaskStatus(status) in QUEUED_TASK_STATUSES
63def is_cancellable(status: TaskStatus | str) -> bool:
64 return TaskStatus(status) in CANCELLABLE_STATUSES