14 个版本

0.3.1 2024年7月15日
0.2.3 2023年11月13日
0.1.5 2023年7月26日

#227解析实现

Download history 458/week @ 2024-05-03 175/week @ 2024-05-10 113/week @ 2024-05-17 305/week @ 2024-05-24 194/week @ 2024-05-31 156/week @ 2024-06-07 91/week @ 2024-06-14 85/week @ 2024-06-21 35/week @ 2024-06-28 280/week @ 2024-07-05 410/week @ 2024-07-12 119/week @ 2024-07-19 213/week @ 2024-07-26 242/week @ 2024-08-02 322/week @ 2024-08-09 174/week @ 2024-08-16

985 每月下载量
用于 4 个包 (3 个直接)

Apache-2.0

725KB
16K SLoC

Rust 12K SLoC // 0.1% comments Python 3K SLoC // 0.2% comments Pest 109 SLoC

数据包描述语言 (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++ 生成代码指南

支持的功能

完整的参考文档

  • 标量值
  • 枚举
  • 数组
  • 可选字段
  • 嵌套数据包
  • 条件数据包派生
  • 自定义字段定义

类似项目

依赖项

~3–11MB
~118K SLoC