Struct StreamingExpand 

pub struct StreamingExpand { /* private fields */ }

Streaming template expansion state machine.

Processes input bytes incrementally, expanding {{ env:KEY }} placeholders. At most MAX_PLACEHOLDER_SCAN bytes are held in buffer. Plain text streams flush immediately with zero buffering.

Implementations

impl StreamingExpand

pub fn new( overrides: &[(String, String)], env: &HashMap<String, String>, ) -> Self

Create with env vars and optional explicit overrides. Overrides take precedence over env vars.

pub fn with_vars(self, vars: &HashMap<String, Value>) -> Self

Create with env vars, structured variables, and optional explicit overrides. Enables key-path evaluation in template tags (e.g., {{ pkg.package.name }}).

pub fn process_bytes( &mut self, input: &[u8], out: &mut Vec<u8>, ) -> Result<usize>

Process a chunk of input bytes, writing expanded output to out. Returns early on empty input to preserve pending boundary state.

pub fn flush(self, out: &mut Vec<u8>) -> Result<()>

Flush remaining buffer. Incomplete placeholders are treated as literals.

pub fn expand_string(self, input: &str) -> Result<String>

Process a complete string (convenience for short command arguments).