summaryrefslogtreecommitdiffstats
path: root/Lib/traceback.py
diff options
context:
space:
mode:
Diffstat (limited to 'Lib/traceback.py')
-rw-r--r--Lib/traceback.py50
1 files changed, 38 insertions, 12 deletions
diff --git a/Lib/traceback.py b/Lib/traceback.py
index b25a729..5d83f85 100644
--- a/Lib/traceback.py
+++ b/Lib/traceback.py
@@ -5,6 +5,7 @@ import itertools
import linecache
import sys
import textwrap
+import warnings
from contextlib import suppress
__all__ = ['extract_stack', 'extract_tb', 'format_exception',
@@ -719,7 +720,8 @@ class TracebackException:
- :attr:`__suppress_context__` The *__suppress_context__* value from the
original exception.
- :attr:`stack` A `StackSummary` representing the traceback.
- - :attr:`exc_type` The class of the original traceback.
+ - :attr:`exc_type` (deprecated) The class of the original traceback.
+ - :attr:`exc_type_str` String display of exc_type
- :attr:`filename` For syntax errors - the filename where the error
occurred.
- :attr:`lineno` For syntax errors - the linenumber where the error
@@ -737,7 +739,7 @@ class TracebackException:
def __init__(self, exc_type, exc_value, exc_traceback, *, limit=None,
lookup_lines=True, capture_locals=False, compact=False,
- max_group_width=15, max_group_depth=10, _seen=None):
+ max_group_width=15, max_group_depth=10, save_exc_type=True, _seen=None):
# NB: we need to accept exc_traceback, exc_value, exc_traceback to
# permit backwards compat with the existing API, otherwise we
# need stub thunk objects just to glue it together.
@@ -754,12 +756,23 @@ class TracebackException:
_walk_tb_with_full_positions(exc_traceback),
limit=limit, lookup_lines=lookup_lines,
capture_locals=capture_locals)
- self.exc_type = exc_type
+
+ self._exc_type = exc_type if save_exc_type else None
+
# Capture now to permit freeing resources: only complication is in the
# unofficial API _format_final_exc_line
self._str = _safe_string(exc_value, 'exception')
self.__notes__ = getattr(exc_value, '__notes__', None)
+ self._is_syntax_error = False
+ self._have_exc_type = exc_type is not None
+ if exc_type is not None:
+ self.exc_type_qualname = exc_type.__qualname__
+ self.exc_type_module = exc_type.__module__
+ else:
+ self.exc_type_qualname = None
+ self.exc_type_module = None
+
if exc_type and issubclass(exc_type, SyntaxError):
# Handle SyntaxError's specially
self.filename = exc_value.filename
@@ -771,6 +784,7 @@ class TracebackException:
self.offset = exc_value.offset
self.end_offset = exc_value.end_offset
self.msg = exc_value.msg
+ self._is_syntax_error = True
elif exc_type and issubclass(exc_type, ImportError) and \
getattr(exc_value, "name_from", None) is not None:
wrong_name = getattr(exc_value, "name_from", None)
@@ -869,6 +883,24 @@ class TracebackException:
"""Create a TracebackException from an exception."""
return cls(type(exc), exc, exc.__traceback__, *args, **kwargs)
+ @property
+ def exc_type(self):
+ warnings.warn('Deprecated in 3.13. Use exc_type_str instead.',
+ DeprecationWarning, stacklevel=2)
+ return self._exc_type
+
+ @property
+ def exc_type_str(self):
+ if not self._have_exc_type:
+ return None
+ stype = self.exc_type_qualname
+ smod = self.exc_type_module
+ if smod not in ("__main__", "builtins"):
+ if not isinstance(smod, str):
+ smod = "<unknown>"
+ stype = smod + '.' + stype
+ return stype
+
def _load_lines(self):
"""Private API. force all lines in the stack to be loaded."""
for frame in self.stack:
@@ -901,18 +933,12 @@ class TracebackException:
"""
indent = 3 * _depth * ' '
- if self.exc_type is None:
+ if not self._have_exc_type:
yield indent + _format_final_exc_line(None, self._str)
return
- stype = self.exc_type.__qualname__
- smod = self.exc_type.__module__
- if smod not in ("__main__", "builtins"):
- if not isinstance(smod, str):
- smod = "<unknown>"
- stype = smod + '.' + stype
-
- if not issubclass(self.exc_type, SyntaxError):
+ stype = self.exc_type_str
+ if not self._is_syntax_error:
if _depth > 0:
# Nested exceptions needs correct handling of multiline messages.
formatted = _format_final_exc_line(