buffa-reflect-build 0.2.0

Build-script integration that drives buffa-build and decorates generated code for reflection.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

//! Build-script integration for `buffa-reflect`.
//!
//! Drives [`buffa_build`] to compile `.proto` files, additionally:
//!
//! * emits `OUT_DIR/file_descriptor_set.bin` (a wire-compatible
//!   `google.protobuf.FileDescriptorSet`),
//! * decorates every generated message struct with `#[derive(::buffa_reflect::ReflectMessage)]` and
//!   a `#[buffa_reflect(...)]` attribute that wires it back to either a user-supplied descriptor
//!   pool or the embedded descriptor bytes.
//!
//! See the crate-level `Builder` type for the full surface.
//!
//! ## Why sync std I/O / `Command` here
//!
//! This crate runs from `build.rs`, which cargo invokes synchronously
//! without a tokio runtime. `tokio::fs` / `tokio::process::Command` would
//! force every consumer to spin up a runtime in their build script for no
//! benefit. The workspace clippy lint banning sync I/O is therefore
//! suppressed at this crate's root with full justification.

#![allow(
    clippy::disallowed_types,
    clippy::disallowed_methods,
    reason = "build scripts and codegen run synchronously; pulling in a tokio runtime here would \
              burden every downstream build.rs."
)]

mod builder;

pub use crate::builder::{Builder, Error};