Coverage for src / lexigram / contracts / infra / tasks / exceptions.py: 0%

1"""Task queue error types. 

2 

3These are the expected, recoverable failure types that task queue operations 

4can return as ``Err`` values inside ``Result[…, TaskQueueError]``. 

5 

6Infrastructure failures (broker connection lost, authentication broken) 

7must still be raised as exceptions — do not wrap them in ``Result``. 

8 

9Error hierarchy 

10--------------- 

11:: 

12 

13 TaskQueueError Base for all expected task queue failures 

14 ├── QueueFullError Queue has reached its capacity limit 

15 └── TaskNotFoundError (defined in lexigram-tasks; extends TaskQueueError) 

16""" 

17 

18from __future__ import annotations 

19 

20from lexigram.contracts.exceptions.domain import DomainError 

21 

22 

23class TaskQueueError(DomainError): 

24 """Base class for expected, recoverable task queue failures. 

25 

26 All subtypes indicate situations the caller is expected to handle 

27 gracefully (e.g. retry later, notify the user, fall back). 

28 """ 

29 

30 _code: str = "LEX_ERR_TASK_001" 

31 

32 

33__all__ = [ 

34 "TaskQueueError", 

35]