"""Shared structured-logger module. Every new backend module uses get_logger(__name__).""" import logging import os import sys __all__ = ["get_logger"] def get_logger(name: str) -> logging.Logger: """Factory that returns a module-level logger. Level is controlled by the LOG_LEVEL env var (default INFO). Handler is added only once to avoid duplicate log lines. """ logger = logging.getLogger(name) if not logger.handlers: handler = logging.StreamHandler(sys.stderr) handler.setFormatter( logging.Formatter("%(asctime)s [%(levelname)s] %(name)s: %(message)s") ) logger.addHandler(handler) log_level = os.environ.get("LOG_LEVEL", "INFO").upper() logger.setLevel(getattr(logging, log_level, logging.INFO)) return logger