Crate tonin_build

Expand description

build.rs helper that wraps tonic-build with tonin conventions.

Call compile from a service crate’s build.rs with the protos to compile and the include paths to resolve import statements against. Both gRPC client and server stubs are generated; the output lands in OUT_DIR and is pulled in with tonic::include_proto!("<package>").

§Example

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Skip codegen if protoc is unavailable so the workspace still
    // `cargo check`s without system protoc installed.
    // Set TONIN_SKIP_PROTOC=1 to skip.
    if std::env::var("TONIN_SKIP_PROTOC").is_ok() {
        return Ok(());
    }
    tonin_build::compile(&["proto/greeter.proto"], &["proto"])
}

§Cargo.toml

[build-dependencies]
tonin-build = "0.1"

Today every call to compile routes through tonic-build (prost). TONIN_CODEC=buffa is reserved for a future protoc-gen-micro codegen plugin; setting it today logs a notice to stderr and falls back to prost so scaffolds keep working unchanged. TONIN_CODEC=prost (or unset) is the explicit / default path.