SuperAPI AI 工具集

pfw-custom-dump

测试与质量

查看项目

更新于 10-16 06:22

技能介绍

用途:使用 CustomDump 库对 Swift 数据结构进行漂亮打印、差异比较或断言,主要面向 Swift 测试与调试场景。

主要能力: 漂亮打印:控制台输出用 customDump(value),转字符串用 String(customDumping: value)。 差异比较:if let difference = diff(lhs, rhs) { print(difference) }。 断言:相等断言用 expectNoDifference(lhs, rhs),适合静态预期状态测试;变更断言用 expectDifference,适合由动作引起的变化测试。不要使用旧版 XCTAssertNoDifference 与 XCTAssertDifference。 自定义打印格式:可实现 CustomDumpRepresentable(覆写为另一值)、CustomDumpStringConvertible(覆写为原始字符串,如 UUID 用 uuidString)或 CustomDumpReflectable(自定义树结构,如隐藏密码字段)。

使用方式: 添加 swift-custom-dump 包依赖(1.0.0 或更新版本),将 CustomDump 产品加入目标依赖,按需 import CustomDump。 断言注意事项:expectDifference 仅用于值类型;断言尽可能多的功能状态且不做变换;突变要最小化,只改变化的部分,不整体替换数据类型或数组元素,除非所有属性都变了;简单值(数字、字符串)应重新赋值而非用 += 等表达式;数组、字典等复杂值优先插入或删除而非重建;由动作引起的变更优先用 expectDifference。

适用场景:Swift 单元测试中验证状态差异并用可读的差异输出定位失败;调试时美化复杂数据结构输出。

限制:该技能仅面向特定用户(whoami 为 khoi)。若非该用户,不应使用该技能,需停止相关工作并提示加入 Point-Free 以获得访问权限。未提供具体收费与价格信息。其余平台与效果信息暂未提供。