"""Logging-Setup fuer SjAudioSearch. Protokolliert in eine rotierende Logdatei und optional zusaetzlich auf die Konsole (Rich). Die CLI schaltet den Konsolen-Handler nur bei Bedarf ein. """ from __future__ import annotations import logging from logging.handlers import RotatingFileHandler from pathlib import Path from rich.logging import RichHandler LOGGER_NAME = "sjaudiosearch" _CONFIGURED = False def setup_logging(log_path: Path, level: str = "INFO", console: bool = False) -> logging.Logger: """Konfiguriert den Logger ``sjaudiosearch`` idempotent.""" global _CONFIGURED logger = logging.getLogger(LOGGER_NAME) numeric_level = getattr(logging, str(level).upper(), logging.INFO) logger.setLevel(numeric_level) if _CONFIGURED: return logger log_path = Path(log_path) log_path.parent.mkdir(parents=True, exist_ok=True) formatter = logging.Formatter( "%(asctime)s | %(levelname)-8s | %(name)s | %(message)s", datefmt="%Y-%m-%d %H:%M:%S", ) file_handler = RotatingFileHandler( log_path, maxBytes=5 * 1024 * 1024, backupCount=3, encoding="utf-8", ) file_handler.setFormatter(formatter) file_handler.setLevel(numeric_level) logger.addHandler(file_handler) if console: console_handler = RichHandler(show_path=False, rich_tracebacks=True, markup=False) console_handler.setLevel(max(numeric_level, logging.INFO)) logger.addHandler(console_handler) logger.propagate = False _CONFIGURED = True return logger def get_logger(name: str | None = None) -> logging.Logger: """Liefert einen Sub-Logger unterhalb von ``sjaudiosearch``.""" if name: return logging.getLogger(f"{LOGGER_NAME}.{name}") return logging.getLogger(LOGGER_NAME)