Source code for osprey_connectors.log_filter
"""Temporary suppression of a logger's low-level messages.
:func:`quiet_logger` raises one or more loggers to WARNING for the duration of
a ``with`` block and restores their levels afterwards.
"""
import logging
from collections.abc import Iterator
from contextlib import contextmanager
@contextmanager
def _suppress_logger_level(logger_name: str | list[str], level: int) -> Iterator[dict[str, int]]:
"""Context manager to temporarily raise logger level to suppress messages.
Args:
logger_name: Name of logger(s) to modify (string or list of strings).
level: Temporary log level; messages below this level are suppressed.
Yields:
Dictionary mapping logger names to their original levels.
"""
logger_names = [logger_name] if isinstance(logger_name, str) else logger_name
loggers = [logging.getLogger(name) for name in logger_names]
original_levels = {
name: logger.level for name, logger in zip(logger_names, loggers, strict=False)
}
for logger in loggers:
logger.setLevel(level)
try:
yield original_levels
finally:
for name, logger in zip(logger_names, loggers, strict=False):
logger.setLevel(original_levels[name])
[docs]
@contextmanager
def quiet_logger(logger_name: str | list[str]) -> Iterator[dict[str, int]]:
"""Context manager to temporarily suppress INFO-level messages from logger(s).
This is a convenience wrapper around _suppress_logger_level() that specifically
suppresses INFO and DEBUG messages while preserving WARNING, ERROR, and CRITICAL.
This is the most common use case for "quiet" operations.
Args:
logger_name: Name of logger(s) to quiet. Can be a single string
or list of strings for multiple loggers.
Yields:
Dictionary mapping logger names to their original levels
Examples:
Quiet a single logger::
>>> with quiet_logger('registry'):
... initialize_registry() # No INFO messages shown
Quiet multiple loggers::
>>> with quiet_logger(['registry', 'DATABASE']):
... do_something()
.. note::
This raises the level to ``logging.WARNING`` for the block.
"""
with _suppress_logger_level(logger_name, logging.WARNING) as levels:
yield levels
__all__ = [
"quiet_logger",
]