| # Copyright (c) 2024-present, Yumeow. Licensed under the MIT License. | |
| import traceback | |
| from .tag2ansi import tag2ansi | |
| def log_exception(e: Exception, with_traceback=True) -> str: | |
| """Format an exception (and optional traceback) as a concise diagnostic string for logging. | |
| Args: | |
| e: Exception instance to format. | |
| with_traceback: Whether to include the formatted traceback lines. | |
| Returns: | |
| str: Formatted exception summary. | |
| """ | |
| return tag2ansi( | |
| f"[red bold]{type(e).__name__}[reset]: " | |
| f"[red]{str(e)}[reset]" | |
| f"\n[gray]{traceback.format_exc() if with_traceback else ''}[reset]" | |
| ) | |