Lib.rs

                                                               M. Tuddenham
                                                               August 2023

                               UDSV SerDe

1. 简介

这是一个用于UNIX分隔值（UDSV）文件格式的Rust serde库。

2. 记录与文件

record_to_str 和 record_from_str 仅处理一条记录。将来会有 to_str 和 from_str 来处理包含多条记录的整个文件。

3. 未指定的数据类型

虽然数字/枚举/结构体/元组不在原始规范中，但已尽力在此处进行最佳（反）序列化。

3.1 数字

待办。

3.2 枚举 枚举总是外部标记的。

3.3 结构体 结构体是扁平化的，字段由冒号分隔。结构体从不标记。

3.4 元组

元组与列表的序列化和反序列化方式相同。

3.5 选项

None 被序列化为空字符串，Some(x) 仅是序列化后的 x。选项是有损的，即无法区分 Some(())、Some("") 和 None。

3.6 布尔值

布尔值序列化为字符串 "true" 和 "false"。

4. 待办事项列表

• 允许（反）序列化多条记录，例如从文件中。
• 在测试中添加跟踪 https://docs.rs/tracing-test/latest/tracing_test/
• 更好的错误 - 在其错误类型中提供更多信息，例如错误发生的行和列、输入中的字节偏移量或正在处理的关键字。
• Ser
  • 不允许嵌套
• De
  • 允许derseriliasing到 &str - https://serde.rs/lifetimes.html
  • 不允许嵌套
  • 浮点数
  • 有符号整数
  • 整型/浮点数溢出