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

1import logging 

2from abc import abstractmethod 

3from typing import TYPE_CHECKING, Any, Optional, Protocol 

4from weakref import WeakSet 

5 

6from typing_extensions import override 

7 

8from faststream._internal.constants import EMPTY 

9 

10if TYPE_CHECKING: 

11 from faststream._internal.basic_types import LoggerProto 

12 from faststream._internal.context import ContextRepo 

13 

14 

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() 

21 

22 return EmptyLoggerStorage() if logger is None else ManualLoggerStorage(logger) 

23 

24 

25class LoggerParamsStorage(Protocol): 

26 __slots__ = () 

27 

28 def register_subscriber(self, params: dict[str, Any]) -> None: ... 

29 

30 def get_logger(self, *, context: "ContextRepo") -> Optional["LoggerProto"]: ... 

31 

32 def set_level(self, level: int) -> None: ... 

33 

34 

35class EmptyLoggerStorage(LoggerParamsStorage): 

36 __slots__ = () 

37 

38 def register_subscriber(self, params: dict[str, Any]) -> None: 

39 pass 

40 

41 @override 

42 def get_logger(self, *, context: "ContextRepo") -> None: 

43 return None 

44 

45 def set_level(self, level: int) -> None: 

46 pass 

47 

48 

49class ManualLoggerStorage(LoggerParamsStorage): 

50 __slots__ = ("__logger",) 

51 

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

53 self.__logger = logger 

54 

55 def register_subscriber(self, params: dict[str, Any]) -> None: 

56 pass 

57 

58 def get_logger(self, *, context: "ContextRepo") -> "LoggerProto": 

59 return self.__logger 

60 

61 def set_level(self, level: int) -> None: 

62 if getattr(self.__logger, "setLevel", None): 

63 self.__logger.setLevel(level) # type: ignore[attr-defined] 

64 

65 

66class DefaultLoggerStorage(LoggerParamsStorage): 

67 __slots__ = ( 

68 "_logger_ref", 

69 "logger_log_level", 

70 ) 

71 

72 def __init__(self) -> None: 

73 # will be used to build logger in `get_logger` method 

74 self.logger_log_level = logging.INFO 

75 

76 self._logger_ref = WeakSet[logging.Logger]() 

77 

78 @abstractmethod 

79 def get_logger(self, *, context: "ContextRepo") -> "LoggerProto": 

80 raise NotImplementedError 

81 

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)) 

85 

86 return None 

87 

88 def set_level(self, level: int) -> None: 

89 if lg := self._get_logger_ref(): 

90 lg.setLevel(level) 

91 

92 self.logger_log_level = level