Coverage for faststream/_internal/logger/params_storage.py: 89%
33 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
1import logging
2from abc import abstractmethod
3from typing import TYPE_CHECKING, Any, Optional, Protocol
4from weakref import WeakSet
6from typing_extensions import override
8from faststream._internal.constants import EMPTY
10if TYPE_CHECKING:
11 from faststream._internal.basic_types import LoggerProto
12 from faststream._internal.context import ContextRepo
15def make_logger_storage(
16 logger: Optional["LoggerProto"],
17 default_storage_cls: type["DefaultLoggerStorage"],
18) -> "LoggerParamsStorage":
19 if logger is EMPTY:
20 return default_storage_cls()
22 return EmptyLoggerStorage() if logger is None else ManualLoggerStorage(logger)
25class LoggerParamsStorage(Protocol):
26 __slots__ = ()
28 def register_subscriber(self, params: dict[str, Any]) -> None: ...
30 def get_logger(self, *, context: "ContextRepo") -> Optional["LoggerProto"]: ...
32 def set_level(self, level: int) -> None: ...
35class EmptyLoggerStorage(LoggerParamsStorage):
36 __slots__ = ()
38 def register_subscriber(self, params: dict[str, Any]) -> None:
39 pass
41 @override
42 def get_logger(self, *, context: "ContextRepo") -> None:
43 return None
45 def set_level(self, level: int) -> None:
46 pass
49class ManualLoggerStorage(LoggerParamsStorage):
50 __slots__ = ("__logger",)
52 def __init__(self, logger: "LoggerProto") -> None:
53 self.__logger = logger
55 def register_subscriber(self, params: dict[str, Any]) -> None:
56 pass
58 def get_logger(self, *, context: "ContextRepo") -> "LoggerProto":
59 return self.__logger
61 def set_level(self, level: int) -> None:
62 if getattr(self.__logger, "setLevel", None):
63 self.__logger.setLevel(level) # type: ignore[attr-defined]
66class DefaultLoggerStorage(LoggerParamsStorage):
67 __slots__ = (
68 "_logger_ref",
69 "logger_log_level",
70 )
72 def __init__(self) -> None:
73 # will be used to build logger in `get_logger` method
74 self.logger_log_level = logging.INFO
76 self._logger_ref = WeakSet[logging.Logger]()
78 @abstractmethod
79 def get_logger(self, *, context: "ContextRepo") -> "LoggerProto":
80 raise NotImplementedError
82 def _get_logger_ref(self) -> logging.Logger | None:
83 if self._logger_ref: 83 ↛ 84line 83 didn't jump to line 84 because the condition on line 83 was never true
84 return next(iter(self._logger_ref))
86 return None
88 def set_level(self, level: int) -> None:
89 if lg := self._get_logger_ref():
90 lg.setLevel(level)
92 self.logger_log_level = level