| """ |
| 生成结果数据类 |
| |
| 定义文书生成操作的结果数据结构. |
| """ |
|
|
| from dataclasses import dataclass |
|
|
|
|
| @dataclass |
| class GenerationResult: |
| """ |
| 文书生成结果 |
| |
| 包含生成操作的成功状态、文件信息、错误信息和性能指标. |
| """ |
|
|
| success: bool |
| """生成是否成功""" |
|
|
| file_path: str | None = None |
| """生成文件的完整路径""" |
|
|
| file_name: str | None = None |
| """生成文件的文件名""" |
|
|
| error_message: str | None = None |
| """错误信息(失败时)""" |
|
|
| duration_ms: int = 0 |
| """生成耗时(毫秒)""" |
|
|
| def __post_init__(self) -> None: |
| """数据验证""" |
| if self.success and not self.file_path: |
| raise ValueError("成功的生成结果必须包含文件路径") |
|
|
| if not self.success and not self.error_message: |
| raise ValueError("失败的生成结果必须包含错误信息") |
|
|
| if self.duration_ms < 0: |
| raise ValueError("生成耗时不能为负数") |
|
|
