Struct Baseline 

pub struct Baseline {
    pub version: u32,
    pub source_path: PathBuf,
    pub rendered_hash: String,
    pub rendered_content: String,
    pub source_hash: String,
    pub context_hash: String,
    pub tracked_render: String,
    pub timestamp: u64,
}

One baseline record — the cached state of a single processed file.

Fields

version: u32

Schema version — see SCHEMA_VERSION.

source_path: PathBuf

Absolute path of the source file at expansion time. Captured so dodot transform check can re-find the template to patch without re-walking the pack tree, and so cache-only diagnostics can name the source even after pack reorganisation.

#[serde(default)] for forward compatibility with any v1 baseline written before this field existed (treated as empty; transform check will skip such entries until they’re rewritten by the next dodot up).

rendered_hash: String

SHA-256 of the rendered (visible, marker-free) output, hex-encoded.

rendered_content: String

The full rendered output verbatim. Stored so reverse-merge can diff the deployed file against the baseline byte-for-byte without re-rendering the template.

source_hash: String

SHA-256 of the source file’s bytes at the moment of expansion, hex-encoded. Used to distinguish “user edited the source” from “user edited the deployed file” (the 4-state matrix in the pipeline spec §6.1).

context_hash: String

SHA-256 of the rendering context (variables, dodot.* values), hex-encoded. Provided by the preprocessor; for templates this is the deterministic projection computed by compute_context_hash. May be empty if the preprocessor has no meaningful context concept.

tracked_render: String

Marker-annotated rendered output (burgertocow’s “tracked” stream). Empty when the preprocessor doesn’t produce one. Persisted so the clean filter can rehydrate a TrackedRender via burgertocow::TrackedRender::from_tracked_string and drive the reverse-diff without re-rendering — re-rendering at clean-filter time would re-trigger any secret-provider auth prompts on every git status.

timestamp: u64

Wall-clock unix timestamp (seconds) of when the baseline was written. Used by dodot transform status to show “deployed since …”. Not load-bearing for divergence detection.

Implementations

impl Baseline

pub fn build( source_path: &Path, rendered_content: &[u8], source_bytes: &[u8], tracked_render: Option<&str>, context_hash: Option<&[u8; 32]>, ) -> Self

Build a baseline from raw inputs. Hashes are computed here so callers don’t repeat the SHA setup; the optional tracked_render and context_hash come straight off the preprocessor’s ExpandedFile.

source_path is the absolute path of the source file inside the pack — recorded so reverse-merge knows where to write the patched template back to.

pub fn write( &self, fs: &dyn Fs, paths: &dyn Pather, pack: &str, handler: &str, filename: &str, ) -> Result<PathBuf>

Persist this baseline to its JSON path under the cache dir. Creates parent directories as needed. Overwrites any existing file at the target path.

pub fn load( fs: &dyn Fs, paths: &dyn Pather, pack: &str, handler: &str, filename: &str, ) -> Result<Option<Self>>

Load a baseline from its JSON path. Returns Ok(None) if the file does not exist (a file with no baseline is a normal state for a brand-new pack); returns an error for parse failures or unsupported schema versions so the caller can suggest a manual clear.

Trait Implementations

impl Clone for Baseline

fn clone(&self) -> Baseline

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Baseline

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Baseline

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Baseline

fn eq(&self, other: &Baseline) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Baseline

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Baseline

impl StructuralPartialEq for Baseline