exceptionx

English | 中文

exceptionx 是一个灵活且便捷的Python异常处理库，允许你动态创建异常类，并提供多种异常处理机制。

exceptionx 的前身是 gqylpy-exception。

pip3 install exceptionx

动态创建异常

使用 exceptionx，你可以在需要时即时创建异常类，而无需提前定义。例如，如果你希望抛出一个名为 NotUnderstandError 的异常，只需导入库并以如下方式调用：

import exceptionx as ex

raise ex.NotUnderstandError(...)

在这里，NotUnderstandError 并不是 exceptionx 预先定义的，而是在你尝试访问 e.NotUnderstandError 时通过魔化方法 __getattr__ 动态创建的。这种灵活性意味着你可以根据需要创建任何名称的异常类。

此外，exceptionx 还确保不会重复创建相同的异常类。所有已创建的异常类都会被存储在 e.__history__ 字典中，以便后续快速访问。

还有一种用法，导入即创建：

from exceptionx import NotUnderstandError

raise NotUnderstandError(...)

强大的异常处理功能

exceptionx 还提供了一系列强大的异常处理工具：

• TryExcept: 装饰器，捕获被装饰的函数中引发的异常，并将异常信息输出到终端（不是抛出）。这有助于避免程序因未处理的异常而崩溃。
• Retry: 装饰器，同上，并会尝试重新执行，通过参数控制次数和每次重试之间的间隔时间，在达到最大次数后抛出异常。
• TryContext: 上下文管理器，使用 with 语句，你可以轻松捕获代码块中引发的异常，并将异常信息输出到终端。

使用 TryExcept 处理函数中引发的异常

from exceptionx import TryExcept

@TryExcept(ValueError)
def func():
    int('a')

默认的处理方案是将异常简要信息输出到终端，不会中断程序执行。当然，也可以输出到日志或做其它处理，通过参数控制。

根据 Python 编程规范，处理异常时应明确指定异常类型。因此，在使用 TryExcept 装饰器时，需要明确传递所处理的异常类型。

使用 Retry 重试函数中引发的异常

from exceptionx import Retry

@Retry(sleep=1, count=3)
def func():
    int('a')

若被装饰的函数中引发了异常，会尝试重新执行被装饰的函数，默认重试 Exception 及其所有子类的异常。像上面这样调用 Retry(sleep=1, count=3) 表示最大执行3次，每次间隔1秒。

Retry 可以配合 TryExcept 使用，将先重试异常，若重试无果，则在最后处理异常：

from exceptionx import TryExcept, Retry

@TryExcept(ValueError)
@Retry(sleep=1, count=3)
def func():
    int('a')

使用 TryContext 处理上下文中引发的异常

from exceptionx import TryContext

with TryContext(ValueError):
    int('a')

通过 exceptionx，你可以更加灵活和高效地处理Python程序中的异常，提升代码的健壮性和可靠性。