Migrate 25 crates to monorepo.

miette
mime
mio
mls-rs-codec
mls-rs-codec-derive
mls-rs-core
mockall
named-lock
nom
no-panic
num_cpus
num-integer
num-traits
oorandom
os_str_bytes
p9
p9_wire_format_derive
parking_lot
parking_lot_core
pathdiff
pdl-runtime
pest
pest_derive
pest_generator
pest_meta

Bug: 339424309
Test: treehugger
Change-Id: I760a8dc06ac55badd6569806a905f21d2c5eaec8
2 files changed
tree: 298ce4189e419baffd78abb4be1d766eb16394c8
  1. src/
  2. .cargo_vcs_info.json
  3. Android.bp
  4. Cargo.toml
  5. Cargo.toml.orig
  6. LICENSE
  7. METADATA
  8. MODULE_LICENSE_APACHE2
  9. OWNERS
  10. README.md
README.md

Packet Description Language (PDL)

Crate Build workflow GitHub contributors GitHub stars

PDL is a domain specific language for writing the definition of binary protocol packets. Parsing and validating packets from raw bytes is tedious and error prone in any language. PDL generates memory safe and tailored backends for multiple target languages:

- Rust
- C++
- Python

Historically PDL was developed as part of the Android Bluetooth stack (bluetooth_packetgen) as a way to generate the parser and serializer for Bluetooth packets, and reduce the number of memory safety issues that come with manipulating and validating raw data.

How to use PDL

  1. Write the protocol definition
  2. cargo run my-protocol.pdl --output-format rust > my-protocol.rs

Language specific instructions are provided for all supported backends:

  1. Rust generated code guide
  2. Python generated code guide
  3. C++ generated code guide

Supported Features

Full reference documentation

  • Scalar values
  • Enumerators
  • Arrays
  • Optional fields
  • Nested packets
  • Conditional packet derivation
  • Custom field definitions

Similar projects