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

1from __future__ import annotations 

2 

3from robot_dispatch.domain.enums import QUEUED_TASK_STATUSES, TaskStatus 

4 

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} 

31 

32CANCELLABLE_STATUSES = frozenset( 

33 {TaskStatus.PENDING, TaskStatus.RETRYING, TaskStatus.ASSIGNED} 

34) 

35 

36 

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}") 

42 

43 

44def can_transition(current: TaskStatus | str, target: TaskStatus | str) -> bool: 

45 return TaskStatus(target) in ALLOWED_TRANSITIONS[TaskStatus(current)] 

46 

47 

48def ensure_transition(current: TaskStatus | str, target: TaskStatus | str) -> TaskStatus: 

49 """Validate the transition and return the target status. 

50 

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) 

57 

58 

59def is_queued(status: TaskStatus | str) -> bool: 

60 return TaskStatus(status) in QUEUED_TASK_STATUSES 

61 

62 

63def is_cancellable(status: TaskStatus | str) -> bool: 

64 return TaskStatus(status) in CANCELLABLE_STATUSES