Struct TemplatePreprocessor 

pub struct TemplatePreprocessor { /* private fields */ }

Template rendering preprocessor. Generative (one-way) transform.

Holds the resolved dodot.* map, the user-defined variables, and a pre-computed context hash. Each expand call constructs a fresh Tracker, installs the namespaces, registers the source file as a named template, and renders. We don’t share the Tracker across renders because add_template requires &mut while Preprocessor:: expand runs through a &self trait method — a per-call tracker is the simplest way to keep the pipeline’s existing concurrency shape.

Implementations

impl TemplatePreprocessor

pub fn new( extensions: Vec<String>, user_vars: HashMap<String, String>, pather: &dyn Pather, ) -> Result<Self>

Construct a new template preprocessor.

Validates that no user-defined variable uses a reserved name (dodot or env). Resolves the dodot.* builtins from pather + system info and computes the context hash now so every subsequent expand reuses the same value.

Extensions are normalized at construction: a leading dot (e.g. ".tmpl") is stripped so both "tmpl" and ".tmpl" work.

pub fn with_secret_registry(self, registry: Arc<SecretRegistry>) -> Self

Wire a SecretRegistry into this preprocessor. Templates rendered through it can call {{ secret("op://Vault/Item/Field") }} (and other configured schemes); calls dispatch through the registry, populate the per-render sidecar, and refuse multi-line values per secrets.lex §3.4. Without a registry (the default), any secret(...) call in a template surfaces as a render error.

Trait Implementations

impl Debug for TemplatePreprocessor

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Preprocessor for TemplatePreprocessor

fn name(&self) -> &str

Unique name for this preprocessor (e.g. "template", "plist").

fn transform_type(&self) -> TransformType

The safety model for this transformation.

fn supports_reverse_merge(&self) -> bool

Whether this preprocessor participates in the reverse-merge pipeline. Reverse-merge is the cache-backed flow that lets dodot transform check propagate edits from the deployed file back into the source by writing a unified diff (and, for ambiguous edits, dodot-conflict marker blocks).

fn matches_extension(&self, filename: &str) -> bool

Whether this preprocessor handles a file with the given name.

fn stripped_name(&self, filename: &str) -> String

Strip the preprocessor extension to get the logical filename. e.g. "config.toml.tmpl" → "config.toml".

fn expand(&self, source: &Path, fs: &dyn Fs) -> Result<Vec<ExpandedFile>>

Expand the source file into one or more output files.