chore: import upstream snapshot with attribution

deeptutor/utils/error_utils.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python
+"""
+Error Utilities - Error formatting and handling utilities
+"""
+
+import json
+from typing import Optional
+
+
+def _find_json_block(message: str) -> Optional[str]:
+    """Extract potential JSON block from message by matching braces."""
+    start_idx = message.find("{")
+    if start_idx == -1:
+        return None
+
+    brace_count = 0
+    in_string = False
+    escape_next = False
+
+    for char_idx in range(start_idx, len(message)):
+        char = message[char_idx]
+
+        if escape_next:
+            escape_next = False
+            continue
+
+        if char == "\\":
+            escape_next = True
+            continue
+
+        if char == '"':
+            in_string = not in_string
+            continue
+
+        if not in_string:
+            if char == "{":
+                brace_count += 1
+            elif char == "}":
+                brace_count -= 1
+                if brace_count == 0:
+                    return message[start_idx : char_idx + 1]
+
+    return None
+
+
+def format_exception_message(exc: Exception) -> str:
+    """
+    Format exception message for better readability
+
+    Args:
+        exc: The exception to format
+
+    Returns:
+        Formatted error message
+    """
+    message = str(exc)
+
+    # Try to parse JSON error messages (common in API errors)
+    potential_json = _find_json_block(message)
+    if potential_json:
+        try:
+            error_data = json.loads(potential_json)
+
+            # Standard extraction logic
+            if isinstance(error_data, dict) and "error" in error_data:
+                error_info = error_data["error"]
+                if isinstance(error_info, dict):
+                    parts = []
+                    if "message" in error_info:
+                        parts.append(f"Message: {error_info['message']}")
+                    if "type" in error_info:
+                        parts.append(f"Type: {error_info['type']}")
+                    if "code" in error_info:
+                        parts.append(f"Code: {error_info['code']}")
+                    if parts:
+                        return " | ".join(parts)
+        except (json.JSONDecodeError, AttributeError):
+            pass
+
+    # Return original message if parsing fails
+    return message