pb-calibration 0.1.2

PB 车辆配置/标定文件（vehicle_config.proto）反序列化校验、解析为 YAML、从 YAML 组装为 .pb.txt；含真实 pb 往返测试。V0.1.2 使用新 proto（VehicleInfo 新增 color/manufacturer 等）。

pb-calibration

当前版本：0.1.2

基于 vehicle_config.proto 的 PB 车辆配置/标定文件（.pb.txt）反序列化校验、解析为 YAML、从 YAML 按顺序组装为 .pb.txt。
V0.1.2 使用新 proto 定义：VehicleInfo 新增字段 color、manufacturer、manufacturer_date、engine_num、type、customer_vehicle_id；Point3D/Quaternion 保留在单文件内，无外部 import。

环境与安装

推荐使用 Conda 环境 py310，并在该环境中安装本包及依赖：

conda activate py310
pip install -e .   # 开发安装
# 或
pip install .      # 普通安装

若仅安装不开发，也可：

pip install pb-calibration

功能

1. 反序列化检查：检查 pb.txt 是否存在格式问题（能否正常解析）。
2. 解析为 YAML：将 pb.txt 解析为每个单独的 yaml 文件，输出到指定目录；该目录与后续「组合」时使用的目录一致。
3. 从 YAML 组装：按顺序将指定目录中的单独 yaml 文件组装成 pb.txt（输入目录与解析输出目录一致，可指定）。
4. YamlConfigManager：类，存储默认 YAML 路径；不缓存 YAML 内容，每次从默认路径读取，保证多程序共同维护时数据为最新。支持 read_yaml / update_yaml、read_order_manifest / update_order_manifest、rescan / get_cached / get。
5. 函数式 API：read_yaml、update_yaml、read_order_manifest、update_order_manifest（显式传路径，无状态）。

命令行

# 1. 检查 pb.txt 格式
pb-calibration check -i /path/to/vehicle_config.pb.txt

# 2. 解析 pb.txt 为 yaml，输出到指定目录（该目录即后续 build 的输入）
pb-calibration parse -i /path/to/vehicle_config.pb.txt -o /path/to/yaml_dir

# 3. 从指定目录按顺序组装为 pb.txt（目录与 parse 的 -o 一致）
pb-calibration build -i /path/to/yaml_dir -o /path/to/vehicle_config_out.pb.txt

测试

在项目根目录（V0.1.2）下执行：

conda activate py310
pip install -e .
pytest test/ -v

或单独运行：pytest test/test_roundtrip.py -v、pytest test/test_api.py -v、pytest test/test_yaml_manager.py -v。

依赖

• Python >= 3.10（推荐在 conda 环境 py310 下使用）
• PyYAML >= 6.0
• protobuf >= 4.21.0

License

MIT