Coverage for src / zmqtt / _internal / routing.py: 100%

13 statements  

« prev     ^ index     » next       coverage.py v7.13.4, created at 2026-11-12 08:49 +0000

1"""Application routing contracts for incoming MQTT messages.""" 

2 

3from dataclasses import dataclass 

4from typing import Protocol 

5 

6from zmqtt._internal.subscription_index import SubscriptionEntry 

7from zmqtt._internal.types.message import Message 

8 

9 

10class RequestClaim(Protocol): 

11 """An exclusively claimed request response awaiting delivery.""" 

12 

13 def deliver(self) -> None: ... 

14 

15 

16class RequestRouter(Protocol): 

17 """Select a pending request as the recipient for a message.""" 

18 

19 def claim(self, message: Message) -> RequestClaim | None: ... 

20 

21 

22@dataclass(slots=True) 

23class InboundRecipient: 

24 """The single application recipient selected for an incoming PUBLISH.""" 

25 

26 message: Message 

27 request: RequestClaim | None = None 

28 subscription: tuple[str, SubscriptionEntry] | None = None 

29 

30 @property 

31 def auto_ack(self) -> bool: 

32 return self.request is not None or self.subscription is None or self.subscription[1].auto_ack