#protobuf #codegen #pure #proto #customize #input #args

build protobuf-codegen-pure

Pure-rust codegen for protobuf using protobuf-parser crate WIP

66 stable releases

3.0.0-alpha.2 Nov 1, 2021
2.28.0 Sep 26, 2022
2.27.1 Feb 5, 2022
2.25.2 Oct 24, 2021
1.6.0 May 11, 2018

#1769 in Development tools

Download history 17797/week @ 2023-12-12 15656/week @ 2023-12-19 10017/week @ 2023-12-26 17614/week @ 2024-01-02 16959/week @ 2024-01-09 18649/week @ 2024-01-16 19293/week @ 2024-01-23 18510/week @ 2024-01-30 15972/week @ 2024-02-06 17892/week @ 2024-02-13 18953/week @ 2024-02-20 22914/week @ 2024-02-27 23282/week @ 2024-03-05 23240/week @ 2024-03-12 23653/week @ 2024-03-19 16938/week @ 2024-03-26

92,727 downloads per month
Used in fewer than 33 crates

MIT license

2MB
40K SLoC

API to generate .rs files

API to generate .rs files to be used e. g. from build.rs.

Example code:

With stable rust-protobuf:

extern crate protobuf_codegen_pure;

protobuf_codegen_pure::run(protobuf_codegen_pure::Args {
    out_dir: "src/protos",
    input: &["protos/a.proto", "protos/b.proto"],
    includes: &["protos"],
    customize: protobuf_codegen_pure::Customize {
      ..Default::default()
    },
}).expect("protoc");

With rust-protobuf from master:

extern crate protobuf_codegen_pure;

protobuf_codegen_pure::Args::new()
    .out_dir("src/protos")
    .inputs(&["protos/a.proto", "protos/b.proto"])
    .include("protos")
    .run()
    .expect("protoc");

And in Cargo.toml:

[build-dependencies]
protobuf-codegen-pure = "2.3"

The alternative is to use protoc-rust crate, which relies on protoc command to parse descriptors. Both crates should produce the same result, otherwise please file a bug report.

Dependencies

~2–12MB
~137K SLoC