Struct TreeSnapshot 

pub struct TreeSnapshot {
    checksum: Checksum,
    entries: Vec<TreeEntry>,
    total_bytes: u64,
}

A deterministic snapshot of an explicitly reviewed set of regular files.

Entries are normalized and sorted by relative path. The checksum includes a format version, relative paths, lengths, and content checksums. Input order has no effect. Adding, deleting, renaming, or editing a file changes the checksum.

Fields

checksum: Checksum

entries: Vec<TreeEntry>

total_bytes: u64

Implementations

impl TreeSnapshot

pub fn capture<I, P>(root: &Path, paths: I) -> Result<Self>

where I: IntoIterator<Item = P>, P: AsRef<Path>,

Capture an explicit set of files beneath a lexical root.

Paths normally come from one of crate::walk’s reviewed traversal policies. Relative components must be valid UTF-8 for portable checksums.

Parent-directory symlinks are not resolved. This operation establishes cache identity, not a containment boundary. Use crate::containment first for paths originating from untrusted input.

Errors

Returns an error for invalid, duplicate, missing, non-regular, or unreadable paths.

pub const fn checksum(&self) -> Checksum

Return the checksum of the complete tree snapshot.

pub fn entries(&self) -> &[TreeEntry]

Return entries in normalized relative-path order.

pub fn file_count(&self) -> usize

Return the number of captured files.

pub const fn total_bytes(&self) -> u64

Return the sum of the captured file lengths.

Trait Implementations

impl Clone for TreeSnapshot

fn clone(&self) -> TreeSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TreeSnapshot

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

Formats the value using the given formatter.

impl PartialEq for TreeSnapshot

fn eq(&self, other: &TreeSnapshot) -> 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 TreeSnapshot

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 TreeSnapshot

impl StructuralPartialEq for TreeSnapshot