diff options
author | Danny McClanahan <1305167+cosmicexplorer@users.noreply.github.com> | 2022-05-15 06:59:11 -0400 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-05-15 10:59:11 +0000 |
commit | a681fd7b42746480de76a348065e8ccce5cea6c9 (patch) | |
tree | d9e40ef4cbdbaa005b8347ac4a88a06a87c4abbd /lib/spack/llnl/util | |
parent | f40f1b5c7cbac0b7b9cb2ffe07badf52066db1de (diff) | |
download | spack-a681fd7b42746480de76a348065e8ccce5cea6c9.tar.gz spack-a681fd7b42746480de76a348065e8ccce5cea6c9.tar.bz2 spack-a681fd7b42746480de76a348065e8ccce5cea6c9.tar.xz spack-a681fd7b42746480de76a348065e8ccce5cea6c9.zip |
Introduce GroupedExceptionHandler and use it to simplify bootstrap error handling (#30192)
Diffstat (limited to 'lib/spack/llnl/util')
-rw-r--r-- | lib/spack/llnl/util/lang.py | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/lib/spack/llnl/util/lang.py b/lib/spack/llnl/util/lang.py index 3644ec11a7..b3236fa0e7 100644 --- a/lib/spack/llnl/util/lang.py +++ b/lib/spack/llnl/util/lang.py @@ -11,7 +11,9 @@ import inspect import os import re import sys +import traceback from datetime import datetime, timedelta +from typing import List, Tuple import six from six import string_types @@ -1009,3 +1011,64 @@ class TypedMutableSequence(MutableSequence): def __str__(self): return str(self.data) + + +class GroupedExceptionHandler(object): + """A generic mechanism to coalesce multiple exceptions and preserve tracebacks.""" + + def __init__(self): + self.exceptions = [] # type: List[Tuple[str, Exception, List[str]]] + + def __bool__(self): + """Whether any exceptions were handled.""" + return bool(self.exceptions) + + def forward(self, context): + # type: (str) -> GroupedExceptionForwarder + """Return a contextmanager which extracts tracebacks and prefixes a message.""" + return GroupedExceptionForwarder(context, self) + + def _receive_forwarded(self, context, exc, tb): + # type: (str, Exception, List[str]) -> None + self.exceptions.append((context, exc, tb)) + + def grouped_message(self, with_tracebacks=True): + # type: (bool) -> str + """Print out an error message coalescing all the forwarded errors.""" + each_exception_message = [ + '{0} raised {1}: {2}{3}'.format( + context, + exc.__class__.__name__, + exc, + '\n{0}'.format(''.join(tb)) if with_tracebacks else '', + ) + for context, exc, tb in self.exceptions + ] + return 'due to the following failures:\n{0}'.format( + '\n'.join(each_exception_message) + ) + + +class GroupedExceptionForwarder(object): + """A contextmanager to capture exceptions and forward them to a + GroupedExceptionHandler.""" + + def __init__(self, context, handler): + # type: (str, GroupedExceptionHandler) -> None + self._context = context + self._handler = handler + + def __enter__(self): + return None + + def __exit__(self, exc_type, exc_value, tb): + if exc_value is not None: + self._handler._receive_forwarded( + self._context, + exc_value, + traceback.format_tb(tb), + ) + + # Suppress any exception from being re-raised: + # https://docs.python.org/3/reference/datamodel.html#object.__exit__. + return True |