Struct CodegenBuilder 

pub struct CodegenBuilder { /* private fields */ }

Builder for generating a decoder with type mappings and dispatch strategy control.

Use this when you need to map chipi type names to Rust wrapper types (replacing the removed import/as syntax) or control the dispatch strategy per decoder.

Example (build.rs)

chipi::CodegenBuilder::new("src/gcdsp.chipi")
    .type_map("reg5", "crate::dsp::DspReg")
    .decoder_dispatch("GcDsp", chipi::Dispatch::FnPtrLut)
    .decoder_dispatch("GcDspExt", chipi::Dispatch::JumpTable)
    .output("src/generated/gcdsp.rs")
    .run();

Implementations

impl CodegenBuilder

pub fn new(input: impl Into<String>) -> Self

Create a new builder targeting the given .chipi spec file.

pub fn type_map(self, chipi_type: &str, rust_path: &str) -> Self

Map a chipi type name to a Rust type path.

Fields declared with this type name in the .chipi file will use the given Rust type in generated code. The codegen emits a use statement for paths containing ::.

Example

.type_map("reg5", "crate::dsp::DspReg")

pub fn decoder_dispatch(self, decoder_name: &str, strategy: Dispatch) -> Self

Set the dispatch strategy for a specific decoder or sub-decoder.

Defaults: JumpTable for sub-decoders, decision tree for main decoders.

pub fn output(self, path: &str) -> Self

Set the output file path.

pub fn run(&self) -> Result<(), Box<dyn Error>>

Run the full pipeline: parse, validate, and generate code.

Trait Implementations

impl Default for CodegenBuilder

fn default() -> CodegenBuilder

Returns the “default value” for a type.