exceptiongroup 1.2.2

捕获异常

由于早期Python版本中缺乏由PEP 654引入的except*语法，您需要使用exceptiongroup.catch()来捕获可能嵌套在异常组中的异常。此函数返回一个上下文管理器，它为与唯一参数匹配的任何异常调用给定的处理程序。

catch()的参数必须是一个字典（或任何Mapping），其中每个键要么是异常类，要么是异常类的可迭代对象。每个值必须是一个接受单个位置参数的可调用对象。处理程序最多被调用一次，以异常组作为参数，该异常组将包含所有给定类型的异常或其子类。异常组可能包含包含更多匹配异常的嵌套组。

因此，以下Python 3.11+代码

try:
    ...
except* (ValueError, KeyError) as excgroup:
    for exc in excgroup.exceptions:
        print('Caught exception:', type(exc))
except* RuntimeError:
    print('Caught runtime error')

可以这样使用此回溯

from exceptiongroup import BaseExceptionGroup, catch

def value_key_err_handler(excgroup: BaseExceptionGroup) -> None:
    for exc in excgroup.exceptions:
        print('Caught exception:', type(exc))

def runtime_err_handler(exc: BaseExceptionGroup) -> None:
    print('Caught runtime error')

with catch({
    (ValueError, KeyError): value_key_err_handler,
    RuntimeError: runtime_err_handler
}):
    ...

注意：与except*一样，您不能使用catch()处理BaseExceptionGroup或ExceptionGroup。

抑制异常

此库包含Python 3.12.1中contextlib.suppress()上下文管理器的回溯。它允许您在选择性地忽略某些异常，即使它们在异常组内部

from exceptiongroup import suppress

with suppress(RuntimeError):
    raise ExceptionGroup("", [RuntimeError("boo")])

关于猴子补丁的说明

为了在打印未处理的异常组时使异常组正确渲染，当在小于3.11的任何Python版本中导入时，此包执行以下两项操作：

1. traceback.TracebackException类被猴子补丁以存储有关异常组的额外信息（在__init__()中）并正确格式化它们（在format()中）

2. 安装了异常钩子sys.excepthook，前提是没有其他钩子已经存在。此钩子会导致异常使用traceback.TracebackException而不是内置的渲染进行格式化。

如果导入exceptiongroup时发现sys.exceptionhook被设置为默认值以外的值，则不会进行任何猴子补丁。

要防止安装异常钩子和补丁，请设置环境变量EXCEPTIONGROUP_NO_PATCH为1。