63 lines
1.8 KiB
Python
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)
|