pyo3-prost

pyo3-prost将Rust protobuf结构体暴露给Python。

文档 []

# A simple decoding benchmark
Python:  14.008996680990094
Rust  :  0.5708326659951126

# A simple encoding benchmark
Python:  8.68384731200058
Rust  :  0.3029898940003477

===========
PythonTweet
===========
b'\n\x11Hi this is a text\x10\xfb\x99K"\x1b\n\x03Who\x12\x14https://example.com/*\x06@trump*\x06@obama'
===========
  RustTweet
===========
b'\n\x11Hi this is a text\x10\xfb\x99K"\x1b\n\x03Who\x12\x14https://example.com/*\x06@trump*\x06@obama'

您只需要在prost或tonic构建中添加一行

.type_attribute(".", "#[::pyo3_prost::pyclass_for_prost_struct]")

即可。

预期用途是当您的Python项目锁定为Protobuf时，您希望将部分迁移到Rust的本地模块。Python protobuf对象无法在Rust侧轻松处理。对于转换，Python protobuf对象应序列化和反序列化为Rust protobuf对象。使用pyo3-prost，您可以从Python中将字节解码为Rust结构体，并将其传递给本地模块。

工作原理

派生宏 pyclass_for_prost_struct 将添加

1. #[pyclass] 到prost生成的结构体
2. #[pyo3(get, set)] 为每个字段（除了oneof字段）。
3. #[pymethods] 与 encode() -> &PyBytes，decode(&PyBytes) -> Self，decode_merge(&mut self, &PyBytes)。
4. #[pyproto] 与 __str__ 和 __repr__ 以便于检查。