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