Coverage for faststream/nats/subscriber/state.py: 0%

42 statements  

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

1from typing import TYPE_CHECKING, Protocol 

2 

3from faststream.exceptions import IncorrectState 

4 

5if TYPE_CHECKING: 

6 from nats.aio.client import Client 

7 from nats.js import JetStreamContext 

8 

9 from faststream.nats.broker.state import BrokerState 

10 from faststream.nats.helpers import KVBucketDeclarer, OSBucketDeclarer 

11 

12 

13class SubscriberState(Protocol): 

14 __slots__ = () 

15 

16 @property 

17 def client(self) -> "Client": ... 

18 

19 @property 

20 def js(self) -> "JetStreamContext": ... 

21 

22 kv_declarer: "KVBucketDeclarer" 

23 os_declarer: "OSBucketDeclarer" 

24 

25 

26class EmptySubscriberState(SubscriberState): 

27 __slots__ = () 

28 

29 @property 

30 def client(self) -> "Client": 

31 msg = "Connection is not available yet. Please, setup the subscriber first." 

32 raise IncorrectState(msg) 

33 

34 @property 

35 def js(self) -> "JetStreamContext": 

36 msg = "Stream is not available yet. Please, setup the subscriber first." 

37 raise IncorrectState(msg) 

38 

39 @property 

40 def kv_declarer(self) -> "KVBucketDeclarer": 

41 msg = "KeyValue is not available yet. Please, setup the subscriber first." 

42 raise IncorrectState(msg) 

43 

44 @kv_declarer.setter 

45 def kv_declarer(self, v: "KVBucketDeclarer") -> None: # ruff: ignore[no-self-use] 

46 msg = "Connection is not available yet. Please, setup the subscriber first." 

47 raise IncorrectState(msg) 

48 

49 @property 

50 def os_declarer(self) -> "OSBucketDeclarer": 

51 msg = "ObjectStorage is not available yet. Please, setup the subscriber first." 

52 raise IncorrectState(msg) 

53 

54 @os_declarer.setter 

55 def os_declarer(self, v: "OSBucketDeclarer") -> None: # ruff: ignore[no-self-use] 

56 msg = "Connection is not available yet. Please, setup the subscriber first." 

57 raise IncorrectState(msg) 

58 

59 

60class ConnectedSubscriberState(SubscriberState): 

61 __slots__ = ( 

62 "_parent_state", 

63 "kv_declarer", 

64 "os_declarer", 

65 ) 

66 

67 def __init__( 

68 self, 

69 *, 

70 parent_state: "BrokerState", 

71 kv_declarer: "KVBucketDeclarer", 

72 os_declarer: "OSBucketDeclarer", 

73 ) -> None: 

74 self._parent_state = parent_state 

75 self.kv_declarer = kv_declarer 

76 self.os_declarer = os_declarer 

77 

78 @property 

79 def client(self) -> "Client": 

80 return self._parent_state.connection 

81 

82 @property 

83 def js(self) -> "JetStreamContext": 

84 return self._parent_state.stream