exceptionx
English | 中文
exceptionx 是一个灵活且便捷的Python异常处理库,允许你动态创建异常类,并提供多种异常处理机制。
exceptionx 的前身是 gqylpy-exception。
pip3 install exceptionx
动态创建异常
使用 exceptionx,你可以在需要时即时创建异常类,而无需提前定义。例如,如果你希望抛出一个名为 NotUnderstandError
的异常,只需导入库并以如下方式调用:
import exceptionx as exraise ex.NotUnderstandError(...)
在这里,NotUnderstandError
并不是 exceptionx 预先定义的,而是在你尝试访问 e.NotUnderstandError
时通过魔化方法 __getattr__
动态创建的。这种灵活性意味着你可以根据需要创建任何名称的异常类。
此外,exceptionx 还确保不会重复创建相同的异常类。所有已创建的异常类都会被存储在 e.__history__
字典中,以便后续快速访问。
还有一种用法,导入即创建:
from exceptionx import NotUnderstandErrorraise 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 TryContextwith TryContext(ValueError):int('a')
通过 exceptionx,你可以更加灵活和高效地处理Python程序中的异常,提升代码的健壮性和可靠性。