6 个版本

0.3.1 2024年7月15日
0.3.0 2024年5月24日
0.2.3 2023年11月13日
0.2.2 2023年10月30日
0.2.0 2023年9月29日

#387 in 解析器实现

Download history 446/week @ 2024-05-03 172/week @ 2024-05-10 108/week @ 2024-05-17 291/week @ 2024-05-24 188/week @ 2024-05-31 156/week @ 2024-06-07 76/week @ 2024-06-14 76/week @ 2024-06-21 17/week @ 2024-06-28 219/week @ 2024-07-05 398/week @ 2024-07-12 105/week @ 2024-07-19 102/week @ 2024-07-26 223/week @ 2024-08-02 320/week @ 2024-08-09 169/week @ 2024-08-16

845 每月下载次数
用于 3 crates

Apache-2.0

9KB
87

数据包描述语言 (PDL)

Crate Build workflow GitHub contributors GitHub stars

PDL 是一种特定领域语言,用于编写二进制协议数据包的定义。在任意语言中,从原始字节解析和验证数据包都是繁琐且容易出错的。PDL 为多种目标语言生成内存安全的定制后端。

- Rust
- C++
- Python

历史上,PDL 作为 Android 蓝牙栈(bluetooth_packetgen)的一部分被开发,作为生成蓝牙数据包解析器和序列化器的方式,以减少处理和验证原始数据时出现的内存安全问题。

如何使用 PDL

  1. 编写协议定义
  2. cargo run my-protocol.pdl --output-format rust > my-protocol.rs

为所有支持的后端提供了特定语言的说明

  1. Rust 生成代码指南
  2. Python 生成代码指南
  3. C++ 生成代码指南

支持的功能

完整参考文档

  • 标量值
  • 枚举类型
  • 数组
  • 可选字段
  • 嵌套数据包
  • 条件数据包推导
  • 自定义字段定义

类似项目

依赖项

~0.4–1MB
~20K SLoC