Coverage for faststream/mqtt/subscriber/factory.py: 83%

10 statements  

« prev     ^ index     » next       coverage.py v7.17.3, created at 2026-11-17 21:20 +0000

1from typing import TYPE_CHECKING, Any 

2 

3from zmqtt import QoS 

4 

5from faststream._internal.endpoint.subscriber.call_item import CallsCollection 

6from faststream.mqtt.path import build_mqtt_address 

7 

8from .config import MQTTSubscriberConfig, MQTTSubscriberSpecificationConfig 

9from .specification import MQTTSubscriberSpecification 

10from .usecase import MQTTConcurrentSubscriber, MQTTDefaultSubscriber 

11 

12if TYPE_CHECKING: 

13 from faststream.middlewares import AckPolicy 

14 from faststream.mqtt.broker.config import MQTTBrokerConfig 

15 

16SubscriberType = MQTTDefaultSubscriber | MQTTConcurrentSubscriber 

17 

18 

19def create_subscriber( 

20 *, 

21 topic: str, 

22 qos: QoS, 

23 shared: str | None, 

24 # Subscriber args 

25 ack_policy: "AckPolicy", 

26 no_reply: bool, 

27 config: "MQTTBrokerConfig", 

28 max_workers: int = 1, 

29 # AsyncAPI args 

30 title_: str | None = None, 

31 description_: str | None = None, 

32 include_in_schema: bool = True, 

33) -> SubscriberType: 

34 address = build_mqtt_address(topic) 

35 

36 subscriber_config = MQTTSubscriberConfig( 

37 address=address, 

38 qos=qos, 

39 shared=shared, 

40 no_reply=no_reply, 

41 _outer_config=config, 

42 _ack_policy=ack_policy, 

43 ) 

44 

45 specification_config = MQTTSubscriberSpecificationConfig( 

46 address=address, 

47 qos=qos, 

48 shared=shared, 

49 title_=title_, 

50 description_=description_, 

51 include_in_schema=include_in_schema, 

52 ) 

53 

54 calls = CallsCollection[Any]() 

55 

56 specification = MQTTSubscriberSpecification( 

57 config, 

58 specification_config, 

59 calls, 

60 ) 

61 

62 if max_workers > 1: 62 ↛ 63line 62 didn't jump to line 63 because the condition on line 62 was never true

63 return MQTTConcurrentSubscriber( 

64 subscriber_config, 

65 specification, 

66 calls, 

67 max_workers=max_workers, 

68 ) 

69 

70 return MQTTDefaultSubscriber(subscriber_config, specification, calls)