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
« 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
5from typing_extensions import override
7from faststream._internal.basic_types import LoggerProto
8from faststream.exceptions import IncorrectState
11class LoggerObject(LoggerProto):
12 __slots__ = ()
14 logger: Optional["LoggerProto"]
16 @abstractmethod
17 def __bool__(self) -> bool: ...
20class NotSetLoggerObject(LoggerObject):
21 """Default logger proxy for state.
23 Raises an error if user tries to log smth before state setup.
24 """
26 __slots__ = ("logger",)
28 def __init__(self) -> None:
29 self.logger = None
31 def __bool__(self) -> bool:
32 return False
34 def __repr__(self) -> str:
35 return f"{self.__class__.__name__}()"
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)
54class EmptyLoggerObject(LoggerObject):
55 """Empty logger proxy for state.
57 Will be used if user setup `logger=None`.
58 """
60 __slots__ = ("logger",)
62 def __init__(self) -> None:
63 self.logger = None
65 def __bool__(self) -> bool:
66 return True
68 def __repr__(self) -> str:
69 return f"{self.__class__.__name__}()"
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
83class RealLoggerObject(LoggerObject):
84 """Empty logger proxy for state.
86 Will be used if user setup custom `logger` (.params_storage.ManualLoggerStorage)
87 or in default logger case (.params_storage.DefaultLoggerStorage).
88 """
90 __slots__ = ("logger",)
92 logger: "LoggerProto"
94 def __init__(self, logger: "LoggerProto") -> None:
95 self.logger = logger
97 def __bool__(self) -> bool:
98 return True
100 def __repr__(self) -> str:
101 return f"{self.__class__.__name__}(logger={self.logger})"
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 )