Files
sjmusicsearch/sjaudiosearch/utils/logging.py
T
2026-11-16 16:29:32 +01:00

63 lines
1.8 KiB
Python

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