utils.wrap module¶
- utils.wrap.return_on_except(value: R | Callable[[], R] | Callable[[E], R], exc_type: type[E] | tuple[type[E], ...], *listeners: Callable[[E, Callable, tuple[Any, ...], dict[str, Any]], None], merge_type: Literal[False] = False) Callable[[Callable[[P], R]], Callable[[P], R]][源代码]¶
- utils.wrap.return_on_except(value: R | Callable[[], R] | Callable[[E], R], exc_type: type[E] | tuple[type[E], ...], *listeners: Callable[[E, Callable, tuple[Any, ...], dict[str, Any]], None], merge_type: Literal[True] = False) Callable[[Callable[[P], RR]], Callable[[P], RR | R]]
提供包装器，当函数抛出指定异常时返回指定值
- 参数:
value (ExceptValue[R, E]) -- 当函数抛出异常时返回的值， 可以是值、工厂或异常处理函数
exc_type (type[E] | tuple[type[E], ...]) -- 指定的异常类型
*listeners (Callable[[E, tuple, dict], None]) -- 异常信号接收函数
- 关键字参数:
merge_type (bool) -- 合并返回值类型提示，默认要求返回值类型与原函数一致， 同类型如不同布尔值等则不会报错
- 返回:
处理指定异常的包装器
- 返回类型:
Callable[[Callable[P, R]], Callable[P, R]]
示例
返回常量是最常用的方法，用于检查是否失败:
@return_on_except(False, Exception) def func(): return True
可以使用工厂函数生成对象:
@return_on_except(list[str], KeyError) def get_args(content: dict) -> list[str]: return content['args'] >>> get_args({'args': ['a', 'b']}) ['a', 'b'] >>> get_args({}) []
也可使用异常处理函数，在提供的错误信息时格外有效 返回值如果和原函数有所区分，可以使用merge_type:
@return_on_except(str, AssertionError, merge_type=True) def api() -> None: ...
错误函数通常接受字符串而不是异常，可以使用``stringify_to``转化为异常处理函数:
from utils.global_messages import wrong, succeed @return_on_except(stringify_to(wrong), AssertionError) def msg_api(): return succeed('ok')
监听器可以用于记录日志:
@return_on_except(None, AssertionError, logger.listener()) def may_fail(): pass
- utils.wrap.stringify_to(value_func: Callable[[str], R]) Callable[[Exception], R][源代码]¶
将异常信息通过str转换为返回值的函数
进行检查后，将异常信息转换为字符串，再转换为返回值 主要用于捕获单参数异常，如``AssertionError``等
- 参数:
value_func (Callable[[str], R]) -- 将字符串转换为返回值的函数
- 返回:
- 将异常信息转换为返回值的函数，
当不传入异常信息或传入的异常信息不是恰好一个参数的异常时抛出异常
- 返回类型:
Callable[[Exception], R]