Initial commit
This commit is contained in:
@@ -0,0 +1,62 @@
|
||||
"""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)
|
||||
Reference in New Issue
Block a user