Struct Stager 

pub struct Stager { /* private fields */ }

Accumulates (relative_path, bytes) pairs and writes them to a fresh tempdir laid out as <tmp>/<relative_path>.

relative_path is the protoc-style import path the consuming .proto will use (bones/v1/pagination.proto, etc.). The returned tempfile::TempDir cleans up on drop — hold it until codegen finishes.

Examples

use proto_build_kit::Stager;

const FOO: &[u8] = b"syntax = \"proto3\"; package foo.v1; message Foo {}";

fn build() -> Result<(), Box<dyn std::error::Error>> {
    let staged = Stager::new()
        .add("foo/v1/foo.proto", FOO)
        .stage()?;
    // Use staged.path() on your protoc include path.
    Ok(())
}

Pair with a sibling *-protos crate that exposes files():

let staged = Stager::new()
    .with(some_protos::files())
    .with(other_protos::files())
    .stage()?;

Duplicate detection

Two entries with the same relative_path cause stage() to return Error::DuplicatePath. This protects against silent shadowing when two *-protos crates collide on a path — almost always a bug.

Implementations

impl Stager

pub fn new() -> Self

Construct an empty stager.

pub fn add(self, relative_path: &'static str, bytes: &'static [u8]) -> Self

Append a single (relative_path, bytes) entry.

pub fn with<I>(self, iter: I) -> Self

where I: IntoIterator<Item = (&'static str, &'static [u8])>,

Append every entry yielded by iter. Typically called with a *-protos crate’s files() accessor.

pub fn stage(self) -> Result<TempDir, Error>

Write every staged entry to a fresh tempdir and return the handle. Add tempdir.path() to your protoc include path.

Errors

• Error::DuplicatePath if two entries declare the same relative path.
• Error::Io if tempdir creation, directory creation, or file writes fail.

Trait Implementations

impl Default for Stager

fn default() -> Stager

Returns the “default value” for a type.