Expand description
wp-model ↔ Apache Arrow 工具库:schema 映射、值/列转换、IPC 帧。
§定位(改映射前先读这段)
本 crate 是「wparse(sink 侧)↔ wfusion(接收侧)Arrow 列类型契约」的归属地。
契约的单一事实来源(规格表 + 已知差异登记)在
wp-reactor/docs/design/arrow-type-mapping.md,
本 crate 是它的实现落点。
§当前状态(2026-09,A-2 已完成 2a/2b/2c)
- 契约的两层都在本 crate 的
contract:列类型表(contract::wp_type_to_arrow,穷尽wp_model_core::model::DataType的 37 个变体)与值层(contract::value,DataRecord→ 列)。 - 生产路径:
wp-connector-utils的arrow::wp_type_to_arrow与arrow::record已改为转发到这里(公开路径与签名不变),经wf-runtime到达生产。 schema/convert(9 变体的类型化前端,Array→List、BigInt→Decimal256) 不是契约,仍不在生产路径上(全家族生产调用 0 处)。
⚠️ 不要用 schema / convert 的口径去判断线协议是否一致 —— 契约看 contract。
历史上 wp-labs/warp-fusion#102 正是「按自我声明找权威实现 → 找到类型化前端 →
报口径不一致」这一误判。
完整迁移记录见规格表 A-2 一节。
Re-exports§
pub use contract::wp_type_to_arrow;