Google Git
Sign in
android / platform / external / rust / crates / pdl-compiler / b83e8c5e6aae2434c2d3dc977f4954e8e2d7774b
commitb83e8c5e6aae2434c2d3dc977f4954e8e2d7774b[log] [tgz]
authorHenri Chataing <[email protected]>Mon Jul 15 22:02:47 2024 +0000
committerHenri Chataing <[email protected]>Mon Jul 15 22:26:48 2024 +0000
tree3c541b1366d419b9c78ca2779256960c25d932a4
parentbf618f8ed0f040e6917af22441eedfa877874361 [diff]
Remove patch to create scripts/Android.bp

scripts/Android.bp is now preserved by the crate updater tool

Change-Id: I44feb69c663ffd11dd128d38efa82bfb8a6ba39e
Test: TreeHugger
1 file changed
tree: 3c541b1366d419b9c78ca2779256960c25d932a4
  1. patches/
  2. scripts/
  3. src/
  4. tests/
  5. .cargo_vcs_info.json
  6. .gitignore
  7. Android.bp
  8. Cargo.toml
  9. Cargo.toml.orig
  10. cargo2android_toplevel.bp
  11. cargo_embargo.json
  12. LICENSE
  13. METADATA
  14. MODULE_LICENSE_APACHE2
  15. OWNERS
  16. 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