用途:在建筑数据交换场景中,对 API 载荷、文件导入和 BIM 导出进行结构校验,确保数据符合预期格式后再进入后续处理。
主要能力:提供基于 Python 数据类的模式校验框架,包含 SchemaType 枚举(string、number、integer、boolean、array、object、date、datetime、csi_code、currency、guid)、SchemaField 与 Schema 定义,以及 SchemaValidator 校验器。支持必填字段、可空性、类型检查、字符串长度、数值最小/最大值、枚举取值、正则模式、数组元素模式、嵌套对象属性,以及 CSI 编码、GUID、货币、日期等自定义格式校验。校验结果以 SchemaValidationResult 返回,可生成包含路径、期望值与实际值的文本报告。
内置模式示例:资料给出成本估算(CostEstimate)、项目进度(ProjectSchedule)、BIM 元素(BIMElement)和 RFI 四类建筑数据模式定义,涵盖项目标识、估算类型、日期、面积、行项目、任务、IFC 类名、分类、工程量、状态与优先级等字段。
使用方式:定义 Schema 与字段后,调用 validate(data, schema) 得到校验结果,再通过 to_report() 输出报告。资料未提供安装命令或独立 CLI 用法。
适用场景:建筑项目数据管道入口校验、API 请求/响应结构检查、导入文件与 BIM 导出数据合规性检查。
限制:资料未说明支持的平台、性能、收费或价格;示例代码为 Python 实现,未提供完整运行环境说明;额外字段仅作忽略处理,未实现警告逻辑。