用途:在编写 Python 代码时统一错误处理方式,区分“预期失败”与“程序缺陷”。资料主张错误是值而非异常,预期失败用 rusty-results 的 Result[T, E] 表达,异常表示 bug。
主要能力:提供决策表——文件不存在、网络错误、输入非法、用户数据有误、第三方库抛错,均改用 Result[T, E];不变量被破坏或程序状态非法(bug)则 raise exception。第三方异常在边界处捕获并转换为 Result。
使用方式:从 rusty_results 导入 Result、Ok、Err,函数返回 Result[Config, str] 之类的类型;先处理错误分支,保持成功路径线性,例如先判断 result.is_err 并返回 Err,再 result.unwrap()。资料还给出三类错误边界:库层捕获第三方异常转 Result、组件层让每个子系统向调用方返回 Result、全局层由 UI/CLI 顶层兜底并输出用户提示。CLI 示例中 main 返回 int,出错时用 typer.echo(..., err=True) 并返回 1。
规则与限制:不得吞掉错误(禁止 except: pass、禁止忽略 Result);多步操作中途失败要清理部分状态;复杂领域可用 @dataclass 定义自定义错误类型(如 ConfigError 含 path、reason、line)。具体安装与依赖方式资料暂未提供。