Crate buffa_codegen 

Shared code generation logic for buffa.

This crate takes protobuf descriptors (google.protobuf.FileDescriptorProto, decoded from binary FileDescriptorSet data) and emits Rust source code that uses the buffa runtime.

It is used by:

• protoc-gen-buffa (protoc plugin)
• buffa-build (build.rs integration)

Architecture

The code generator is intentionally decoupled from how descriptors are obtained. It receives fully-resolved FileDescriptorProtos and produces Rust source strings. This means:

• It doesn’t parse .proto files.
• It doesn’t invoke protoc.
• It doesn’t do import resolution or name linking.

All of that is handled upstream (by protoc, buf, or a future parser).

Modules

context

Code generation context and descriptor-to-Rust mapping state.

idents

Rust identifier and path construction helpers.

Structs

AliasConflict

One CamelCase collision: a target identifier and the proto value names that would all convert onto it.

CodeGenConfig

Configuration for code generation.

GeneratedFile

One generated output file.

Enums

CodeGenError

Code generation error.

CodeGenWarning

A non-fatal diagnostic produced during code generation.

GeneratedFileKind

Kind of GeneratedFile.

IncludeMode

How generate_module_tree emits include! paths.

ReflectMode

How much reflection support generated types get.

StringRepr

The Rust type a proto string field maps to in generated owned structs.

Constants

ALLOW_LINTS

Lints suppressed on generated code at module boundaries.

Functions

allow_lints_attr

Render ALLOW_LINTS as a #[allow(…)] attribute token stream.

apply_companions

Merge downstream Companion files into the per-package stitcher produced by generate.

generate

Generate Rust source files from a set of file descriptors.

generate_module_tree

Generate a module tree that assembles per-package .mod.rs files into nested pub mod blocks matching the protobuf package hierarchy.

generate_with_diagnostics

Like generate, but also returns the non-fatal CodeGenWarnings collected during generation (e.g. enums whose idiomatic CamelCase aliases were suppressed by a naming conflict).

package_to_filename

Convert a proto package name to its file_per_package output filename.

package_to_mod_filename

Convert a proto package name to its .mod.rs stitcher filename.

proto_path_to_stem

Convert a .proto file path to its content-file stem.