95 lines
3.0 KiB
Python
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
|
|
|