Coverage for faststream/_internal/logger/logger_proxy.py: 88%

25 statements  

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

1from abc import abstractmethod 

2from collections.abc import Mapping 

3from typing import Any, Optional 

4 

5from typing_extensions import override 

6 

7from faststream._internal.basic_types import LoggerProto 

8from faststream.exceptions import IncorrectState 

9 

10 

11class LoggerObject(LoggerProto): 

12 __slots__ = () 

13 

14 logger: Optional["LoggerProto"] 

15 

16 @abstractmethod 

17 def __bool__(self) -> bool: ... 

18 

19 

20class NotSetLoggerObject(LoggerObject): 

21 """Default logger proxy for state. 

22 

23 Raises an error if user tries to log smth before state setup. 

24 """ 

25 

26 __slots__ = ("logger",) 

27 

28 def __init__(self) -> None: 

29 self.logger = None 

30 

31 def __bool__(self) -> bool: 

32 return False 

33 

34 def __repr__(self) -> str: 

35 return f"{self.__class__.__name__}()" 

36 

37 @override 

38 def log( 

39 self, 

40 level: int, 

41 msg: Any, 

42 /, 

43 *, 

44 exc_info: Any = None, 

45 extra: Mapping[str, Any] | None = None, 

46 ) -> None: 

47 err_msg = ( 

48 "Logger object not set. Please, call `broker.connect()` or " 

49 "`_setup_logger_state` of parent broker state." 

50 ) 

51 raise IncorrectState(err_msg) 

52 

53 

54class EmptyLoggerObject(LoggerObject): 

55 """Empty logger proxy for state. 

56 

57 Will be used if user setup `logger=None`. 

58 """ 

59 

60 __slots__ = ("logger",) 

61 

62 def __init__(self) -> None: 

63 self.logger = None 

64 

65 def __bool__(self) -> bool: 

66 return True 

67 

68 def __repr__(self) -> str: 

69 return f"{self.__class__.__name__}()" 

70 

71 def log( 

72 self, 

73 level: int, 

74 msg: Any, 

75 /, 

76 *, 

77 exc_info: Any = None, 

78 extra: Mapping[str, Any] | None = None, 

79 ) -> None: 

80 pass 

81 

82 

83class RealLoggerObject(LoggerObject): 

84 """Empty logger proxy for state. 

85 

86 Will be used if user setup custom `logger` (.params_storage.ManualLoggerStorage) 

87 or in default logger case (.params_storage.DefaultLoggerStorage). 

88 """ 

89 

90 __slots__ = ("logger",) 

91 

92 logger: "LoggerProto" 

93 

94 def __init__(self, logger: "LoggerProto") -> None: 

95 self.logger = logger 

96 

97 def __bool__(self) -> bool: 

98 return True 

99 

100 def __repr__(self) -> str: 

101 return f"{self.__class__.__name__}(logger={self.logger})" 

102 

103 def log( 

104 self, 

105 level: int, 

106 msg: Any, 

107 /, 

108 *, 

109 exc_info: Any = None, 

110 extra: Mapping[str, Any] | None = None, 

111 ) -> None: 

112 self.logger.log( 

113 level, 

114 msg, 

115 extra=extra, 

116 exc_info=exc_info, 

117 )