"""调试日志记录器:在运行时输出详细信息,遇到错误时调用错误日志记录器。""" from __future__ import annotations import time import traceback import logging import os from typing import Any, Dict, Optional import threading from .log_formatter import format_debug_log from .performance_tracker import PerformanceTracker from .error_logger import ErrorLogger _perf = PerformanceTracker() _err = ErrorLogger() # 初始化文件日志记录器 _debug_logger = logging.getLogger("debug_logger") if not _debug_logger.handlers: _debug_logger.setLevel(logging.DEBUG) # 添加控制台处理器 _console_handler = logging.StreamHandler() _debug_logger.addHandler(_console_handler) # 添加文件处理器,写入到 debug.log try: # 获取日志目录 log_dir = os.path.join(os.path.dirname(os.path.dirname(os.path.dirname(__file__))), "logs") os.makedirs(log_dir, exist_ok=True) debug_log_path = os.path.join(log_dir, "debug.log") # 创建轮转文件处理器 from logging.handlers import RotatingFileHandler _file_handler = RotatingFileHandler( debug_log_path, maxBytes=10*1024*1024, # 10MB backupCount=5, encoding='utf-8' ) _file_handler.setFormatter(logging.Formatter('%(asctime)s - %(message)s')) _debug_logger.addHandler(_file_handler) except Exception: # 如果文件处理器创建失败,至少保留控制台输出 pass class DebugLogger: def __init__(self, enabled: bool = True) -> None: self.enabled = enabled def log_function_entry(self, func_name: str, *args: Any, **kwargs: Any) -> None: if not self.enabled: return params = {"args": args, "kwargs": kwargs} line = format_debug_log(f"FunctionEntry: {func_name}", level="DEBUG", **params) _debug_logger.debug(line) def log_function_exit(self, func_name: str, retval: Any, elapsed: float) -> None: if not self.enabled: return line = format_debug_log(f"FunctionExit: {func_name}", level="DEBUG", elapsed_seconds=elapsed, return_value=retval) _debug_logger.debug(line) def log_variable(self, name: str, value: Any) -> None: if not self.enabled: return line = format_debug_log(f"VariableSnapshot: {name}=", level="DEBUG", value=value) _debug_logger.debug(line) def log_call_stack(self) -> None: if not self.enabled: return stack = traceback.format_stack() line = format_debug_log("CallStack", level="DEBUG", stack="".join(stack)) _debug_logger.debug(line) def log_exception(self, exc: BaseException, context: Optional[Dict[str, Any]] = None) -> None: if not self.enabled: return tb = traceback.format_exc() line = format_debug_log("Exception", level="ERROR", exception=type(exc).__name__, traceback=tb, context=context or {}) _debug_logger.error(line) _err.log_exception(exc, context=context) def log_step(self, name: str, start_time: float, end_time: Optional[float] = None) -> None: if not self.enabled: return t = (end_time if end_time is not None else time.time()) - start_time line = format_debug_log("StepTiming", level="DEBUG", step=name, elapsed_seconds=t) _debug_logger.debug(line) _perf.get_elapsed(name) # update internal stats if used def _get_debug_logger() -> DebugLogger: return DebugLogger(True) __all__ = ["DebugLogger", "_get_debug_logger"]