Files
MDHelper/mdhelper/logging_config.py
T
2026-06-14 09:51:16 +08:00

95 lines
3.0 KiB
Python

from __future__ import annotations
import logging
import os
import sys
import tempfile
from logging.handlers import RotatingFileHandler
from pathlib import Path
from types import TracebackType
from PySide6.QtCore import qInstallMessageHandler
def _create_file_handler(project_root: Path, formatter: logging.Formatter) -> tuple[RotatingFileHandler, Path]:
errors: list[OSError] = []
for log_dir in _log_dir_candidates(project_root):
try:
log_dir.mkdir(parents=True, exist_ok=True)
log_path = log_dir / "mdhelper.log"
handler = RotatingFileHandler(
log_path,
maxBytes=1_000_000,
backupCount=3,
encoding="utf-8",
)
handler.setFormatter(formatter)
return handler, log_path
except OSError as exc:
errors.append(exc)
raise OSError(f"无法创建日志文件,已尝试 {len(errors)} 个位置。")
def _log_dir_candidates(project_root: Path) -> list[Path]:
candidates: list[Path] = []
configured = os.environ.get("MDHELPER_LOG_DIR")
if configured:
candidates.append(Path(configured).expanduser())
local_app_data = os.environ.get("LOCALAPPDATA") or os.environ.get("APPDATA")
if local_app_data:
candidates.append(Path(local_app_data) / "MDHelper" / "logs")
candidates.extend(
[
Path.home() / ".mdhelper" / "logs",
project_root / "logs",
Path(tempfile.gettempdir()) / "MDHelper" / "logs",
]
)
unique: list[Path] = []
for candidate in candidates:
resolved_key = str(candidate)
if resolved_key not in {str(item) for item in unique}:
unique.append(candidate)
return unique
def setup_logging(project_root: Path) -> Path:
root_logger = logging.getLogger()
root_logger.setLevel(logging.INFO)
root_logger.handlers.clear()
formatter = logging.Formatter(
fmt="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
datefmt="%Y-%m-%d %H:%M:%S",
)
file_handler, log_path = _create_file_handler(project_root, formatter)
root_logger.addHandler(file_handler)
console_handler = logging.StreamHandler()
console_handler.setFormatter(formatter)
root_logger.addHandler(console_handler)
def handle_exception(
exc_type: type[BaseException],
exc_value: BaseException,
exc_traceback: TracebackType | None,
) -> None:
logging.getLogger("mdhelper").exception(
"Unhandled exception",
exc_info=(exc_type, exc_value, exc_traceback),
)
sys.__excepthook__(exc_type, exc_value, exc_traceback)
def handle_qt_message(mode: object, context: object, message: str) -> None:
logging.getLogger("qt").warning("%s", message)
sys.excepthook = handle_exception
qInstallMessageHandler(handle_qt_message)
logging.getLogger("mdhelper").info("Logging initialized: %s", log_path)
return log_path